aboutsummaryrefslogtreecommitdiffstats
path: root/lang/python (follow)
Commit message (Collapse)AuthorAgeFilesLines
* doc: python bindings howtoBen McGinnes2018-03-151-17/+60
| | | | * Added c.get_key instructions and examples.
* doc: python bindings howtoBen McGinnes2018-03-151-0/+21
| | | | * Added text for verifying signatures.
* doc: python bindings howtoBen McGinnes2018-03-141-19/+116
| | | | * Added 4 signature verification methods and partial text for them.
* doc: python bindings howtoBen McGinnes2018-03-141-11/+35
| | | | * Added description for detached signatures.
* doc: python bindings howtoBen McGinnes2018-03-141-28/+45
| | | | | * Fixed multiple sample code examples of writing output to a file. * Added the description of detached signatures.
* doc: python bindings todoBen McGinnes2018-03-141-2/+2
| | | | * minor phrasing fix.
* doc: python bindings howtoBen McGinnes2018-03-141-0/+66
| | | | * Added recommended method of single encryption with description.
* doc: python binding howtoBen McGinnes2018-03-131-1/+12
| | | | | | | | * Clarified which English dialects this is written in. * Translating to American can happen *after* it's done. ** The Yank version would probably want to change some of the examples anyway. * Began the description for normal/default signing.
* doc: python bindings howtoBen McGinnes2018-03-131-1/+60
| | | | | | | | * Added a section on key selection. * Included recommendation for using fingerprint when selecting one specific key. * Also included the most ironically amusing example of multiple key selection in a GPG guide. Hey, it's public data ... (heh).
* doc: python bindings howtoBen McGinnes2018-03-131-13/+44
| | | | | | | * Added explanation of the ascendance of Python 3 over Python 2 in the guide to the intro. * Expanded key selection description so people know what not to include regarding key IDs with this key selection method.
* doc: python bindings howtoBen McGinnes2018-03-131-8/+17
| | | | * Added key selection for specifying signing key or keys.
* doc: python bindings howtoBen McGinnes2018-03-131-52/+91
| | | | | | | * During the course of working out the updated signature methods, determined that key selection (including counting) will beed to be presented before the basic functions. * Moved "working with keys" up.
* doc: python bindings howtoBen McGinnes2018-03-131-6/+5
| | | | | | * Signatures have changed as a result of the recent update from Justus. * Sample code updated. * Text to follow later.
* doc: python bindings howtoBen McGinnes2018-03-131-4/+14
| | | | * Added text description for the decryption example.
* doc: python bindings howtoBen McGinnes2018-03-121-0/+50
| | | | | | | | * Added a miscellaneous work-arounds section at the end. * Included code in said miscellaneous section for accessing the groups specified in a gpg.conf file. * It's a bit ugly since it does require subprocess (but not call, Popen or shell access and only accesses one command).
* doc: python bindings howtoBen McGinnes2018-03-121-2/+3
| | | | * Fixed a spelling error in the key counting text.
* doc: python bindings howtoBen McGinnes2018-03-121-1/+19
| | | | | | | * updated multi-encryption final example to be complete. * second example shows most likely method of reading plaintext. * updated example filenames to stick with running gag (i.e. secret_plans.txt).
* doc: python bindings howtoBen McGinnes2018-03-121-6/+7
| | | | | | | * error corrections. * multiple typesetting fixes only required due to certain archaic eccentricities of LaTeX. * a couple of minor python PEP8 compliance corrections.
* doc: python bindings howtoBen McGinnes2018-03-121-1/+3
| | | | * Fixed an error in the encryption try/except statement.
* doc: python bindings howtoBen McGinnes2018-03-121-3/+83
| | | | | | | * Added a more complicated encryption example with a few variations on the encryption method to account for untrusted recipient keys, signing or not signing, including or excluding default keys and so on.
* doc: python bindings howtoBen McGinnes2018-03-121-3/+13
| | | | | | | | * Switched from links to some external docs to using footnotes where necessary. * Ideally the howto should be as stand alone as possible. * Also it makes it difficult to convert to another format for proof-reading if there are links that the conversion can't find.
* doc: python bindings HOWTOBen McGinnes2018-03-091-0/+33
| | | | | * Added instructions and code to count the number of public and secret keys available since it was quick and easy.
* doc: python TODO listBen McGinnes2018-03-091-1/+1
| | | | * Slightly tweaked one heading to make it clear it wasn't a duplicate.
* doc: python bindings howtoBen McGinnes2018-03-091-7/+53
| | | | | | | * Wrote the text description explaining each step in the most basic encryption operation. * Will need to include additional examples for encrypting to multiple recipients using Context().encrypt instead of Context().op_encrypt.
* doc: python bindings TODO listBen McGinnes2018-03-091-2/+5
| | | | | * Updated to reflect the most recent work on the HOWTO for the Python bindings.
* doc: python bindings howtoBen McGinnes2018-03-091-18/+41
| | | | * Added example for verifying both detached and "in-line" signatures.
* docs: python bindings howto update.Ben McGinnes2018-03-081-0/+90
| | | | | | | * Added all four signing code examples that are most likely to be used: armoured, clearsigned, detached armoured and detached binary. * May remove some examples and just discuss the differences, but it depends on the way the text is filled out.
* doc: python bindings howto updateBen McGinnes2018-03-081-2/+36
| | | | | | * Added example of decryption. * included some quick notes for myself regarding aspects to explain when I flesh out the explanatory text.
* doc: Basic operation of the python bindingsBen McGinnes2018-03-081-0/+51
| | | | | | | | | | | | * Added sample code for encrypting some text to a single key. * Basically I'm just lifting existing production code and changing the key IDs from mine to "0x12345678DEADBEEF" for these first few examples. * I'll fill in the text description after. * Note: due to my regional location, I might split some tasks into more commits in order to be sure no work gets lost in case of emergency (or to put it another way: I know Telstra too well to trust them).
* doc-howto: fundamental aspects of GPGME vs PythonBen McGinnes2018-03-081-1/+55
| | | | | | | | | * Added a section for those pythonistas who are too used to web programming. Stressed that it's not simply not RESTful, it's not even REST-like. * Letting me move on to drawing a very loose parallel between a session and a context. The differences should become obvious in the subsequent sections.
* doc: Added multiple TODOs for inclusion in the HOWTOBen McGinnes2018-03-081-1/+43
| | | | | | | | | | | | | | * Some instructions to include are fairly obvious; as with encryption, decryption and signature verification. * Some are a little less obvious. * This includes the requests received to specifically include subkey management (adding and revoking subkeys on a primary key that's being retained. * Added the UID equivalents to the list, as well as key selection matters (and may or may not include something for handling group lines since that involves wrapping a CLI binary). * Key control documentation and examples requested by Mike Ingle of confidantmail.org.
* GPL compatible license for documentationBen McGinnes2018-03-071-3/+9
| | | | | * Added the same, slightly modified GPL based license that is used in other parts of GnuPG.
* HOWTO updateBen McGinnes2018-03-071-5/+5
| | | | | | | | * removed one bit of whitespace. * Marked up references to gpgme.h. * Fixed one spelling error. * Removed py2.6 from python search order since even if it is supported, it shouldn't be encouraged.
* GPGME Python bindings HOWTOBen McGinnes2018-03-071-0/+221
| | | | | | | * Started work on the GPGME Python bindings HOWTO. * 1,050 words to begin with at approx. 7.5KB. * Got as far as installation. * Includes instruction not to use PyPI for this.
* TODO - HOWTOBen McGinnes2018-03-071-1/+2
| | | | | * Added suv-entry for the new HOWTO being started and, since it has been started, checked it off.
* TODOBen McGinnes2018-03-071-0/+6
| | | | * Slightly expanded the list.
* WS removalBen McGinnes2018-02-261-1/+1
| | | | * Whitespace removal.
* LaTeX headersben/python-docs-01Ben McGinnes2018-02-262-0/+8
| | | | | | | * Set LaTeX headers to enable ligatures and a 12pt font by default. * Paper size left for regional defaults. * Using XeLaTeX for easier font control. * Using default LaTeX font of Latin Main, but that's easy enough to change.
* Renaming ad infinitum ...Ben McGinnes2018-02-191-0/+0
| | | | * Dropped the .txt from the end of the file ...
* Text conversionBen McGinnes2018-02-191-0/+77
| | | | | * Exported from Org Mode to UTF-8 text. * Removed my name from just under the title.
* Title fixBen McGinnes2018-02-191-1/+1
| | | | * Fixed title.
* Conflict with Phabricator filesBen McGinnes2018-02-191-0/+0
| | | | | | | | | | | | | | | | | | | | | * The developers of Phabricator, the web front-end on dev.gnupg.org have not implemented renderers for Markdown, Org-Mode or any other common markdown like language. * They also refuse to do so. * Instead they re-invented the wheel and implemented their own version of Markdown-like thing which is incompatible with everything else. It is called Remarkup. * The developers of Phabricator and Remarkup have refused to provide conversion tools to move files to/from any format to/from Remarkup. * They expect everyone to learn their new favourite pet project. * Remarkup may or may not display Org Mode files, but if so then it is likely to only want to do so as plain text. * There is an unaffiliated and unofficial project to convert Github Markdown to Remarkup via Pandoc. This might be adapted for our use, but requires testing. * Until then exporting from Org Mode to UTF-8 text is likely the least worst plan. * Which means renaming this file to README.org first.
* Schizophrenic file typesBen McGinnes2018-02-191-2/+2
| | | | | | * Removed Markdown style heading underlining. * Removed in-line file type declaration (which is not correctly parsed by the web interface on dev.gnupg.org).
* History pathBen McGinnes2018-02-161-7/+10
| | | | | | * Fixed a typo in a filepath reference. * Moved conjecture regarding the first version of Python used to a footnote.
* Merge branch 'master' of /Users/ben/dev/hgit/mine/gnupg/gpgme/master into ↵Ben McGinnes2018-02-151-12/+9
|\ | | | | | | ben/python-docs-01
| * tests: Makefile portability.NIIBE Yutaka2018-02-151-6/+4
| | | | | | | | | | | | | | | | | | | | | | | | * tests/gpg/Makefile.am: Don't use "export" directive. * tests/gpgsm/Makefile.am: Ditto. * lang/qt/tests/Makefile.am: Ditto. * lang/python/tests/Makefile.am: Ditto. -- GnuPG-bug-id: 3056 Signed-off-by: NIIBE Yutaka <[email protected]>
| * build: More Makefile fix.NIIBE Yutaka2018-02-151-6/+5
| | | | | | | | | | | | * lang/python/tests/Makefile.am: Avoid target with '/'. Signed-off-by: NIIBE Yutaka <[email protected]>
* | LaTeX marginsBen McGinnes2018-02-152-0/+67
| | | | | | | | | | * Added LaTeX header for 1 inch margins in the quite likely event that all PDF output ultimately uses LaTeX.
* | TODO DocumentationBen McGinnes2018-02-151-1/+2
| | | | | | | | * Checked off the decision to stick with Org Mode.
* | TODOBen McGinnes2018-02-151-7/+34
| | | | | | | | | | * Beginning to turn the first part of this into something kind of like an actual TODO list as Org Mode uses it (maybe).