From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id EF0BF138247 for ; Fri, 27 Dec 2013 00:12:44 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 78EA3E0AA0; Fri, 27 Dec 2013 00:12:43 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 0D263E0AA8 for ; Fri, 27 Dec 2013 00:12:42 +0000 (UTC) Received: from flycatcher.gentoo.org (flycatcher.gentoo.org [81.93.255.6]) (using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 1386833F23A for ; Fri, 27 Dec 2013 00:12:42 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by flycatcher.gentoo.org (Postfix) with ESMTP id C4F0E2001A for ; Fri, 27 Dec 2013 00:12:40 +0000 (UTC) From: "Brian Dolbec" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Brian Dolbec" Message-ID: <1388103037.09e075daf36042e7ea411ec550b86041b21990fe.dol-sen@gentoo> Subject: [gentoo-commits] proj/api:master commit in: files/gentoo-keys/seeds/ X-VCS-Repository: proj/api X-VCS-Files: files/gentoo-keys/seeds/README X-VCS-Directories: files/gentoo-keys/seeds/ X-VCS-Committer: dol-sen X-VCS-Committer-Name: Brian Dolbec X-VCS-Revision: 09e075daf36042e7ea411ec550b86041b21990fe X-VCS-Branch: master Date: Fri, 27 Dec 2013 00:12:40 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: b988c537-784d-4cda-8c2e-3cfccab1b6e4 X-Archives-Hash: aefdff92c3c4579cc8c9b8c9aedac3f4 commit: 09e075daf36042e7ea411ec550b86041b21990fe Author: Brian Dolbec gentoo org> AuthorDate: Fri Dec 27 00:10:37 2013 +0000 Commit: Brian Dolbec gmail com> CommitDate: Fri Dec 27 00:10:37 2013 +0000 URL: http://sources.gentoo.org/gitweb/?p=proj/api.git;a=commit;h=09e075da Add a README with seed file field descriptions --- files/gentoo-keys/seeds/README | 58 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 58 insertions(+) diff --git a/files/gentoo-keys/seeds/README b/files/gentoo-keys/seeds/README new file mode 100644 index 0000000..9bf5301 --- /dev/null +++ b/files/gentoo-keys/seeds/README @@ -0,0 +1,58 @@ + + +This README is to describle the current form of the seed files +and the fields data they contain. + +CAUTION: These specs are not to be considered stable and +are likely to change in the future. + +============================================================ +Python file excerpt of the GKEY named tuple class used to +represent the data in the seed file. +============================================================= + + +# some constants used in gkeyldap/actions.py +# they map the index values of the GKEY input data fields +NICK = 0 +NAME = 1 +KEYID = 2 +LONGKEYID = 3 +KEYDIR = 4 +FINGERPRINT = 5 + +# set some defaults +KEY_LEN = { + 'keyid': 8, + 'longkeyid': 16, +} + + +class GKEY(namedtuple('GKEY', ['nick', 'name', 'keyid', 'longkeyid', + 'keydir', 'fingerprint'])): + '''Class to hold the relavent info about a key''' + + field_types = {'nick': str, 'name': str, 'keyid': list, + 'longkeyid': list, 'keydir': str, 'fingerprint': list} + field_separator = "|" + list_separator = ":" + __slots__ = () + + +============================================================= + +Current fileds data in the seed files are: + +============================================================= + +field-0|field-1|field-2|filed-3|field-4|field-5 + +['nick', 'name', 'keyid', 'longkeyid', 'keydir', 'fingerprint'] + +fields2,3,5 may be lists with a ":" separating list members. +This is going to change to use a "," as the list separator. + +Also, the keyid and longkeyid fileds are likely to be dropped, as version 3 +gpg key types will not be used/allowed. +Therefore since the keyid and longkeyid are just substrings of the fingerprint. +They do not need to be tracked.