# HG changeset patch
# User Brian Neal <bgneal@gmail.com>
# Date 1370485410 18000
# Node ID e242ef3b5a840b7b7e25f647b6d5404c129c88ea
# Parent  778f0bd51818784a0fb064f856afcfdc6e79a5ec
Working on reading key lists. Started on config file format.

diff -r 778f0bd51818 -r e242ef3b5a84 m209/keylist/config.py
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/m209/keylist/config.py	Wed Jun 05 21:23:30 2013 -0500
@@ -0,0 +1,63 @@
+# Copyright (C) 2013 by Brian Neal.
+# This file is part of m209, the M-209 simulation.
+# m209 is released under the MIT License (see LICENSE.txt).
+
+"""This module contains routes to read & write key lists in config (aka INI)
+file format.
+
+In the config file format, multiple key lists are stored in one file. Each key
+list is stored in a section named for its indicator. In this example, the file
+contains settings for 2 key lists, one with indicator AA and one with indicator
+YL.
+
+[AA]
+lugs = 0-4 0-5*4 0-6*6 1-0*5 1-2 1-5*4 3-0*3 3-4 3-6 5-6
+wheel1 = FGIKOPRSUVWYZ
+wheel2 = DFGKLMOTUY
+wheel3 = ADEFGIORTUVX
+wheel4 = ACFGHILMRSU
+wheel5 = BCDEFJKLPS
+wheel6 = EFGHIJLMNP
+check = QLRRN TPTFU TRPTN MWQTV JLIJE J
+
+[YL]
+lugs = 1-0 2-0*4 0-3 0-4*3 0-5*2 0-6*11 2-5 2-6 3-4 4-5
+wheel1 = BFJKLOSTUWXZ
+wheel2 = ABDJKLMORTUV
+wheel3 = EHJKNPQRSX
+wheel4 = ABCHIJLMPQR
+wheel5 = BCDGJLNOPQS
+wheel6 = AEFHIJP
+check = OZGPK AFVAJ JYRZW LRJEG MOVLU M
+
+"""
+
+import configparser
+from .key_list import KeyList
+
+WHEELS = ['wheel{}'.format(n) for n in range(1, 7)]
+
+
+def read_key_list(fp, indicator):
+    """Reads from fp, which must be an iterable that yields unicode strings.
+
+    Searches the config file for the key list with the given indicator. If
+    found, returns a KeyList object. Returns None if not found.
+
+    """
+    config = configparser.ConfigParser(interpolation=None)
+    config.read_file(fp)
+
+    if indicator not in config.sections():
+        return None
+
+    section = config[indicator]
+    return KeyList(
+            indicator=indicator,
+            lugs=section['lugs'],
+            pin_list=[section[w] for w in WHEELS],
+            letter_check=section['check'])
+
+
+def write_key_list(fp, key_list):
+    pass
diff -r 778f0bd51818 -r e242ef3b5a84 m209/keylist/key_list.py
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/m209/keylist/key_list.py	Wed Jun 05 21:23:30 2013 -0500
@@ -0,0 +1,10 @@
+# Copyright (C) 2013 by Brian Neal.
+# This file is part of m209, the M-209 simulation.
+# m209 is released under the MIT License (see LICENSE.txt).
+
+"""key_list.py - This module defines the KeyList class."""
+
+import collections
+
+KeyList = collections.namedtuple('KeyList',
+                ['indicator', 'lugs', 'pin_list', 'letter_check'])