Project

General

Profile

1
#!/usr/bin/env python
2
# Maps one datasource to another, using a map spreadsheet if needed
3
# For outputting an XML file to a PostgreSQL database, use the general format of
4
# http://vegbank.org/vegdocs/xml/vegbank_example_ver1.0.2.xml
5

    
6
import os.path
7
import sys
8
import xml.dom.minidom as minidom
9

    
10
sys.path.append(os.path.dirname(__file__)+"/../lib")
11

    
12
import exc
13
import opts
14
import Parser
15
import sql
16
import strings
17
import term
18
import util
19
import xml_dom
20
import xml_func
21

    
22
def metadata_value(name):
23
    if util.is_str(name) and name.startswith(':'): return name[1:]
24
    else: return None
25

    
26
def main_():
27
    ex_tracker = exc.ExTracker()
28
    
29
    env_names = []
30
    def usage_err():
31
        raise SystemExit('Usage: '+opts.env_usage(env_names, True)+' '
32
            +sys.argv[0]+' [map_path...] [<input] [>output]')
33
    
34
    # Get db config from env vars
35
    db_config_names = ['engine', 'host', 'user', 'password', 'database']
36
    def get_db_config(prefix):
37
        return opts.get_env_vars(db_config_names, prefix, env_names)
38
    in_db_config = get_db_config('in')
39
    out_db_config = get_db_config('out')
40
    in_is_db = 'engine' in in_db_config
41
    out_is_db = 'engine' in out_db_config
42
    
43
    # Get other config from env vars
44
    end = util.cast(int, opts.get_env_var('n', None, env_names))
45
    start = util.cast(int, opts.get_env_var('start', '0', env_names))
46
    if end != None: end += start
47
    test = opts.env_flag('test', False, env_names)
48
    commit = opts.env_flag('commit', False, env_names) and not test
49
        # never commit in test mode
50
    redo = opts.env_flag('redo', test, env_names) and not commit
51
        # never redo in commit mode (manually run `make empty_db` instead)
52
    debug = opts.env_flag('debug', False, env_names)
53
    sql.run_raw_query.debug = debug
54
    verbose = debug or opts.env_flag('verbose', False, env_names)
55
    opts.get_env_var('profile_to', None, env_names) # add to env_names
56
    
57
    # Logging
58
    def log(msg, on=verbose):
59
        if on: sys.stderr.write(msg)
60
    def log_start(action, on=verbose): log(action+'...\n', on)
61
    
62
    # Parse args
63
    map_paths = sys.argv[1:]
64
    if map_paths == []:
65
        if in_is_db or not out_is_db: usage_err()
66
        else: map_paths = [None]
67
    
68
    def connect_db(db_config):
69
        log_start('Connecting to '+sql.db_config_str(db_config))
70
        db = sql.connect(db_config)
71
        return db
72
    
73
    out_is_xml_ref = [False]
74
    
75
    def process_input(root, row_ready, map_path):
76
        '''Inputs datasource to XML tree, mapping if needed'''
77
        # Load map header
78
        in_is_xpaths = True
79
        out_is_xpaths = True
80
        out_label = None
81
        if map_path != None:
82
            import copy
83
            import csv
84
            
85
            import xpath
86
            
87
            metadata = []
88
            mappings = []
89
            stream = open(map_path, 'rb')
90
            reader = csv.reader(stream)
91
            in_label, out_label = reader.next()[:2]
92
            def split_col_name(name):
93
                name, sep, root = name.partition(':')
94
                return name, sep != '', root
95
            in_label, in_is_xpaths, in_root = split_col_name(in_label)
96
            out_label, out_is_xpaths, out_root = split_col_name(out_label)
97
            has_types = out_root.startswith('/*s/') # outer elements are types
98
            for row in reader:
99
                in_, out = row[:2]
100
                if out != '':
101
                    if out_is_xpaths: out = xpath.parse(out_root+out)
102
                    mappings.append((in_, out))
103
            stream.close()
104
            
105
            root.ownerDocument.documentElement.tagName = out_label
106
        in_is_xml = in_is_xpaths and not in_is_db
107
        out_is_xml_ref[0] = out_is_xpaths and not out_is_db
108
        
109
        if in_is_xml:
110
            doc0 = minidom.parse(sys.stdin)
111
            if out_label == None: out_label = doc0.documentElement.tagName
112
        
113
        def process_rows(process_row, rows):
114
            '''Processes input rows
115
            @param process_row(in_row, i)
116
            '''
117
            i = -1 # in case for loop does not execute
118
            for i, row in enumerate(rows):
119
                if i < start: continue
120
                if end != None and i >= end: break
121
                process_row(row, i)
122
                row_ready(i, row)
123
            sys.stderr.write('Processed '+str(i-start+1)+' input rows\n')
124
        
125
        def map_rows(get_value, rows):
126
            '''Maps input rows
127
            @param get_value(in_, row):str
128
            '''
129
            def process_row(row, i):
130
                row_id = str(i)
131
                for in_, out in mappings:
132
                    value = metadata_value(in_)
133
                    if value == None:
134
                        log_start('Getting '+str(in_), debug)
135
                        value = get_value(in_, row)
136
                    if value != None: xpath.put_obj(root, out, row_id,
137
                        has_types, strings.cleanup(value))
138
            process_rows(process_row, rows)
139
        
140
        if map_path == None:
141
            iter_ = xml_dom.NodeElemIter(doc0.documentElement)
142
            util.skip(iter_, xml_dom.is_text) # skip metadata
143
            process_rows(lambda row, i: root.appendChild(row), iter_)
144
        elif in_is_db:
145
            assert in_is_xpaths
146
            
147
            import db_xml
148
            
149
            in_root_xml = xpath.path2xml(in_root)
150
            for i, mapping in enumerate(mappings):
151
                in_, out = mapping
152
                if metadata_value(in_) == None:
153
                    mappings[i] = (xpath.path2xml(in_root+'/'+in_), out)
154
            
155
            in_db = connect_db(in_db_config)
156
            in_pkeys = {}
157
            def get_value(in_, row):
158
                pkey, = row
159
                in_ = in_.cloneNode(True) # don't modify orig value!
160
                xml_dom.set_id(xpath.get(in_, in_root)[0], pkey)
161
                value = sql.value_or_none(db_xml.get(in_db, in_, in_pkeys))
162
                if value != None: return str(value)
163
                else: return None
164
            map_rows(get_value, sql.rows(db_xml.get(in_db, in_root_xml,
165
                in_pkeys, end, 0)))
166
            in_db.close()
167
        elif in_is_xml:
168
            def get_value(in_, row):
169
                nodes = xpath.get(row, in_)
170
                if nodes != []: return xml_dom.value(nodes[0])
171
                else: return None
172
            rows = xpath.get(doc0.documentElement, in_root, limit=end)
173
            if rows == []: raise SystemExit('Map error: Root "'+in_root
174
                +'" not found in input')
175
            map_rows(get_value, rows)
176
        else: # input is CSV
177
            map_ = dict(mappings)
178
            reader = csv.reader(sys.stdin)
179
            cols = reader.next()
180
            col_idxs = dict([(value, idx) for idx, value in enumerate(cols)])
181
            for i, mapping in enumerate(mappings):
182
                in_, out = mapping
183
                if metadata_value(in_) == None:
184
                    try: mappings[i] = (col_idxs[in_], out)
185
                    except KeyError: pass
186
            
187
            def get_value(in_, row):
188
                value = row[in_]
189
                if value != '': return value
190
                else: return None
191
            map_rows(get_value, reader)
192
    
193
    def process_inputs(root, row_ready):
194
        for map_path in map_paths: process_input(root, row_ready, map_path)
195
    
196
    # Output XML tree
197
    doc = xml_dom.create_doc()
198
    root = doc.documentElement
199
    if out_is_db:
200
        import db_xml
201
        
202
        out_db = connect_db(out_db_config)
203
        out_pkeys = {}
204
        try:
205
            if redo: sql.empty_db(out_db)
206
            row_ct_ref = [0]
207
            
208
            def row_ready(row_num, input_row):
209
                def on_error(e):
210
                    exc.add_msg(e, term.emph('row #:')+' '+str(row_num))
211
                    exc.add_msg(e, term.emph('input row:')+'\n'+str(input_row))
212
                    exc.add_msg(e, term.emph('output row:')+'\n'+str(root))
213
                    ex_tracker.track(e)
214
                
215
                xml_func.process(root, on_error)
216
                if not xml_dom.is_empty(root):
217
                    assert xml_dom.has_one_child(root)
218
                    try:
219
                        sql.with_savepoint(out_db, lambda: db_xml.put(out_db,
220
                            root.firstChild, out_pkeys, row_ct_ref, on_error))
221
                        if commit: out_db.commit()
222
                    except sql.DatabaseErrors, e: on_error(e)
223
                root.clear()
224
            
225
            process_inputs(root, row_ready)
226
            sys.stdout.write('Inserted '+str(row_ct_ref[0])+
227
                ' new rows into database\n')
228
        finally:
229
            out_db.rollback()
230
            out_db.close()
231
    else:
232
        def on_error(e): ex_tracker.track(e)
233
        def row_ready(row_num, input_row): pass
234
        process_inputs(root, row_ready)
235
        xml_func.process(root, on_error)
236
        if out_is_xml_ref[0]:
237
            doc.writexml(sys.stdout, **xml_dom.prettyxml_config)
238
        else: # output is CSV
239
            raise NotImplementedError('CSV output not supported yet')
240

    
241
def main():
242
    try: main_()
243
    except Parser.SyntaxException, e: raise SystemExit(str(e))
244

    
245
if __name__ == '__main__':
246
    profile_to = opts.get_env_var('profile_to', None)
247
    if profile_to != None:
248
        import cProfile
249
        cProfile.run(main.func_code, profile_to)
250
    else: main()
(13-13/23)