1 |
# CFDataFile.py - CFData classes
|
2 |
#
|
3 |
# Copyright (C) 2004 Todd Mitchell
|
4 |
#
|
5 |
# This program is free software; you can redistribute it and/or modify
|
6 |
# it under the terms of the GNU General Public License as published by
|
7 |
# the Free Software Foundation; either version 2 of the License, or
|
8 |
# (at your option) any later version.
|
9 |
#
|
10 |
# This program is distributed in the hope that it will be useful,
|
11 |
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
12 |
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
13 |
# GNU General Public License for more details.
|
14 |
#
|
15 |
# You should have received a copy of the GNU General Public License
|
16 |
# along with this program; if not, write to the Free Software
|
17 |
# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
18 |
#
|
19 |
|
20 |
import os
|
21 |
import string
|
22 |
import Crossfire
|
23 |
|
24 |
class CFDataFile:
|
25 |
'''Plain text storage for Crossfire data'''
|
26 |
|
27 |
def __init__(self, datafile_name):
|
28 |
'''make datafile paths for datafile 'object'
|
29 |
- these all go in ../var/crossfire/datafiles to keep the local dir clean'''
|
30 |
self.datafile_name = datafile_name
|
31 |
self.filename = os.path.join((Crossfire.LocalDirectory()),'datafiles',datafile_name)
|
32 |
|
33 |
def exists(self):
|
34 |
'''checks for datafile - no need to load it yet'''
|
35 |
if os.path.isfile(self.filename):
|
36 |
return 1
|
37 |
else:
|
38 |
return 0
|
39 |
|
40 |
def make_file(self, header):
|
41 |
'''creates a datafile, making the column header from a list passed in'''
|
42 |
try:
|
43 |
file = open(self.filename,'wb')
|
44 |
except:
|
45 |
print "Can't create datafile %s" % self.datafile_name
|
46 |
else:
|
47 |
temp = []
|
48 |
for item in header:
|
49 |
temp.append(str(item))
|
50 |
contents = '#|%s\n' %(string.join(temp,'|'))
|
51 |
file.write(contents)
|
52 |
file.close()
|
53 |
print "New datafile created: %s" % self.datafile_name
|
54 |
|
55 |
def getData(self):
|
56 |
'''Gets the formatted file as a dictionary
|
57 |
The # key contains the column headers for the file and indicates the 'primary' key'''
|
58 |
try:
|
59 |
file = open(self.filename,'rb')
|
60 |
except:
|
61 |
raise 'Unable to read %s' % self.filename
|
62 |
else:
|
63 |
temp = file.read().split('\n')
|
64 |
file.close()
|
65 |
contents = temp[:-1]
|
66 |
DF = {}
|
67 |
templist = []
|
68 |
for list in contents:
|
69 |
templist = list.split('|')
|
70 |
DF[templist[0]] = templist[1:]
|
71 |
return DF
|
72 |
|
73 |
def putData(self, dic):
|
74 |
'''Writes dictionary to formatted file - uses | character as a delimiter'''
|
75 |
try:
|
76 |
file = open(self.filename,'w')
|
77 |
except:
|
78 |
raise 'Unable to open %s for writing' % self.datafile_name
|
79 |
else:
|
80 |
header = dic['#']
|
81 |
del dic['#']
|
82 |
index = dic.keys()
|
83 |
index.sort()
|
84 |
contents = '#|%s\n' %(string.join(header,'|'))
|
85 |
file.write(contents)
|
86 |
for entry in index:
|
87 |
tmp = []
|
88 |
stringlist = dic[entry]
|
89 |
for item in stringlist:
|
90 |
tmp.append(str(item))
|
91 |
temp = '%s|%s\n' %(entry, (string.join(tmp,'|')))
|
92 |
file.write(temp)
|
93 |
file.close()
|
94 |
|
95 |
class CFData:
|
96 |
'''CFData Object is basically a dictionary parsed from the datafile -
|
97 |
serves to pass back and forth a dictionary containing the datafile header
|
98 |
and the desired record to the caller - easier to read the '''
|
99 |
|
100 |
def __init__(self, filename, header):
|
101 |
self.header = header
|
102 |
self.datafile = CFDataFile(filename)
|
103 |
|
104 |
if self.datafile.exists():
|
105 |
self.datadb = self.datafile.getData()
|
106 |
if self.datadb['#'] != self.header:
|
107 |
# see if header in calling object matches header in file
|
108 |
# raise an alert but do nothing yet -
|
109 |
# indicates possible upgrade of caller, will flesh this out later
|
110 |
raise 'Header does not match! You may need to fix the object or the datafile.'
|
111 |
else:
|
112 |
self.datafile.make_file(self.header)
|
113 |
self.datadb = self.datafile.getData()
|
114 |
|
115 |
def remove_record(self, name):
|
116 |
if self.datadb.has_key(name):
|
117 |
del self.datadb[name]
|
118 |
self.datafile.putData(self.datadb)
|
119 |
return 1
|
120 |
else:
|
121 |
return 0
|
122 |
|
123 |
def exist(self, name):
|
124 |
'''checks if a record exists given the primary key as "name"'''
|
125 |
if self.datadb.has_key(name):
|
126 |
return 1
|
127 |
else:
|
128 |
return 0
|
129 |
|
130 |
def get_record(self, name):
|
131 |
'''returns a small dictionary of the header and the record by "name"'''
|
132 |
if self.exist(name):
|
133 |
record = {}
|
134 |
for header, item in zip(self.header,self.datadb[name]):
|
135 |
record[header]=item
|
136 |
record['#'] = name
|
137 |
return record
|
138 |
else:
|
139 |
return 0
|
140 |
|
141 |
def put_record(self, record):
|
142 |
'''adds an line entry to the datafile'''
|
143 |
name = record['#']
|
144 |
del record['#']
|
145 |
temp = []
|
146 |
for item in self.header:
|
147 |
temp.append(record[item])
|
148 |
self.datadb[name]=temp
|
149 |
self.datafile.putData(self.datadb)
|
150 |
|
151 |
def get_keys(self):
|
152 |
'''returns a sorted list of the primary keys (usually names) in the datafile'''
|
153 |
keys = self.datadb.keys()
|
154 |
keys.remove('#')
|
155 |
keys.sort()
|
156 |
return keys
|
157 |
|