Mercurial > p > roundup > code
annotate roundup/backends/rdbms_common.py @ 1415:6883852e9b15
mysql backend passes all tests (at last!)
| author | Andrey Lebedev <kedder@users.sourceforge.net> |
|---|---|
| date | Sat, 08 Feb 2003 15:31:28 +0000 |
| parents | 8dc60d87ab42 |
| children | 472c21af7f69 |
| rev | line source |
|---|---|
|
1415
6883852e9b15
mysql backend passes all tests (at last!)
Andrey Lebedev <kedder@users.sourceforge.net>
parents:
1409
diff
changeset
|
1 # $Id: rdbms_common.py,v 1.31 2003-02-08 15:31:28 kedder Exp $ |
|
1244
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
2 ''' Relational database (SQL) backend common code. |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
3 |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
4 Basics: |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
5 |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
6 - map roundup classes to relational tables |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
7 - automatically detect schema changes and modify the table schemas |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
8 appropriately (we store the "database version" of the schema in the |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
9 database itself as the only row of the "schema" table) |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
10 - multilinks (which represent a many-to-many relationship) are handled through |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
11 intermediate tables |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
12 - journals are stored adjunct to the per-class tables |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
13 - table names and columns have "_" prepended so the names can't clash with |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
14 restricted names (like "order") |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
15 - retirement is determined by the __retired__ column being true |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
16 |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
17 Database-specific changes may generally be pushed out to the overridable |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
18 sql_* methods, since everything else should be fairly generic. There's |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
19 probably a bit of work to be done if a database is used that actually |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
20 honors column typing, since the initial databases don't (sqlite stores |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
21 everything as a string, and gadfly stores anything that's marsallable). |
|
8dd4f736370b
merge from maintenance branch
Richard Jones <richard@users.sourceforge.net>
parents:
1222
diff
changeset
|
22 ''' |
| 1165 | 23 |
| 24 # standard python modules | |
| 25 import sys, os, time, re, errno, weakref, copy | |
| 26 | |
| 27 # roundup modules | |
| 28 from roundup import hyperdb, date, password, roundupdb, security | |
| 29 from roundup.hyperdb import String, Password, Date, Interval, Link, \ | |
| 30 Multilink, DatabaseError, Boolean, Number | |
|
1333
80d27b7d6db5
implemented whole-database locking
Richard Jones <richard@users.sourceforge.net>
parents:
1304
diff
changeset
|
31 from roundup.backends import locking |
| 1165 | 32 |
| 33 # support | |
| 34 from blobfiles import FileStorage | |
| 35 from roundup.indexer import Indexer | |
| 36 from sessions import Sessions | |
| 37 | |
|
1173
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
38 # number of rows to keep in memory |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
39 ROW_CACHE_SIZE = 100 |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
40 |
| 1165 | 41 class Database(FileStorage, hyperdb.Database, roundupdb.Database): |
|
1173
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
42 ''' Wrapper around an SQL database that presents a hyperdb interface. |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
43 |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
44 - some functionality is specific to the actual SQL database, hence |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
45 the sql_* methods that are NotImplemented |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
46 - we keep a cache of the latest ROW_CACHE_SIZE row fetches. |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
47 ''' |
| 1165 | 48 def __init__(self, config, journaltag=None): |
| 49 ''' Open the database and load the schema from it. | |
| 50 ''' | |
| 51 self.config, self.journaltag = config, journaltag | |
| 52 self.dir = config.DATABASE | |
| 53 self.classes = {} | |
| 54 self.indexer = Indexer(self.dir) | |
| 55 self.sessions = Sessions(self.config) | |
| 56 self.security = security.Security(self) | |
| 57 | |
| 58 # additional transaction support for external files and the like | |
| 59 self.transactions = [] | |
| 60 | |
|
1173
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
61 # keep a cache of the N most recently retrieved rows of any kind |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
62 # (classname, nodeid) = row |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
63 self.cache = {} |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
64 self.cache_lru = [] |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
65 |
|
1333
80d27b7d6db5
implemented whole-database locking
Richard Jones <richard@users.sourceforge.net>
parents:
1304
diff
changeset
|
66 # database lock |
|
80d27b7d6db5
implemented whole-database locking
Richard Jones <richard@users.sourceforge.net>
parents:
1304
diff
changeset
|
67 self.lockfile = None |
|
80d27b7d6db5
implemented whole-database locking
Richard Jones <richard@users.sourceforge.net>
parents:
1304
diff
changeset
|
68 |
| 1165 | 69 # open a connection to the database, creating the "conn" attribute |
| 70 self.open_connection() | |
| 71 | |
|
1181
49aebf5a8691
some speedups, some fixes to the benchmarking
Richard Jones <richard@users.sourceforge.net>
parents:
1176
diff
changeset
|
72 def clearCache(self): |
|
49aebf5a8691
some speedups, some fixes to the benchmarking
Richard Jones <richard@users.sourceforge.net>
parents:
1176
diff
changeset
|
73 self.cache = {} |
|
49aebf5a8691
some speedups, some fixes to the benchmarking
Richard Jones <richard@users.sourceforge.net>
parents:
1176
diff
changeset
|
74 self.cache_lru = [] |
|
49aebf5a8691
some speedups, some fixes to the benchmarking
Richard Jones <richard@users.sourceforge.net>
parents:
1176
diff
changeset
|
75 |
| 1165 | 76 def open_connection(self): |
| 77 ''' Open a connection to the database, creating it if necessary | |
| 78 ''' | |
| 79 raise NotImplemented | |
| 80 | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
81 def sql(self, sql, args=None): |
| 1165 | 82 ''' Execute the sql with the optional args. |
| 83 ''' | |
| 84 if __debug__: | |
| 85 print >>hyperdb.DEBUG, (self, sql, args) | |
| 86 if args: | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
87 self.cursor.execute(sql, args) |
| 1165 | 88 else: |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
89 self.cursor.execute(sql) |
| 1165 | 90 |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
91 def sql_fetchone(self): |
| 1165 | 92 ''' Fetch a single row. If there's nothing to fetch, return None. |
| 93 ''' | |
| 94 raise NotImplemented | |
| 95 | |
|
1170
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
96 def sql_stringquote(self, value): |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
97 ''' Quote the string so it's safe to put in the 'sql quotes' |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
98 ''' |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
99 return re.sub("'", "''", str(value)) |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
100 |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
101 def save_dbschema(self, schema): |
| 1165 | 102 ''' Save the schema definition that the database currently implements |
| 103 ''' | |
| 104 raise NotImplemented | |
| 105 | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
106 def load_dbschema(self): |
| 1165 | 107 ''' Load the schema definition that the database currently implements |
| 108 ''' | |
| 109 raise NotImplemented | |
| 110 | |
| 111 def post_init(self): | |
| 112 ''' Called once the schema initialisation has finished. | |
| 113 | |
| 114 We should now confirm that the schema defined by our "classes" | |
| 115 attribute actually matches the schema in the database. | |
| 116 ''' | |
| 117 # now detect changes in the schema | |
|
1168
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
118 save = 0 |
| 1165 | 119 for classname, spec in self.classes.items(): |
| 120 if self.database_schema.has_key(classname): | |
| 121 dbspec = self.database_schema[classname] | |
|
1168
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
122 if self.update_class(spec, dbspec): |
|
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
123 self.database_schema[classname] = spec.schema() |
|
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
124 save = 1 |
| 1165 | 125 else: |
| 126 self.create_class(spec) | |
| 127 self.database_schema[classname] = spec.schema() | |
|
1168
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
128 save = 1 |
| 1165 | 129 |
| 130 for classname in self.database_schema.keys(): | |
| 131 if not self.classes.has_key(classname): | |
| 132 self.drop_class(classname) | |
| 133 | |
| 134 # update the database version of the schema | |
|
1168
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
135 if save: |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
136 self.sql('delete from schema') |
|
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
137 self.save_dbschema(self.database_schema) |
| 1165 | 138 |
| 139 # reindex the db if necessary | |
| 140 if self.indexer.should_reindex(): | |
| 141 self.reindex() | |
| 142 | |
| 143 # commit | |
| 144 self.conn.commit() | |
| 145 | |
|
1176
bd3b57859c37
On second thought, that last checkin was dumb.
Richard Jones <richard@users.sourceforge.net>
parents:
1175
diff
changeset
|
146 # figure the "curuserid" |
|
bd3b57859c37
On second thought, that last checkin was dumb.
Richard Jones <richard@users.sourceforge.net>
parents:
1175
diff
changeset
|
147 if self.journaltag is None: |
|
bd3b57859c37
On second thought, that last checkin was dumb.
Richard Jones <richard@users.sourceforge.net>
parents:
1175
diff
changeset
|
148 self.curuserid = None |
|
bd3b57859c37
On second thought, that last checkin was dumb.
Richard Jones <richard@users.sourceforge.net>
parents:
1175
diff
changeset
|
149 elif self.journaltag == 'admin': |
|
bd3b57859c37
On second thought, that last checkin was dumb.
Richard Jones <richard@users.sourceforge.net>
parents:
1175
diff
changeset
|
150 # admin user may not exist, but always has ID 1 |
|
bd3b57859c37
On second thought, that last checkin was dumb.
Richard Jones <richard@users.sourceforge.net>
parents:
1175
diff
changeset
|
151 self.curuserid = '1' |
|
bd3b57859c37
On second thought, that last checkin was dumb.
Richard Jones <richard@users.sourceforge.net>
parents:
1175
diff
changeset
|
152 else: |
|
bd3b57859c37
On second thought, that last checkin was dumb.
Richard Jones <richard@users.sourceforge.net>
parents:
1175
diff
changeset
|
153 self.curuserid = self.user.lookup(self.journaltag) |
|
bd3b57859c37
On second thought, that last checkin was dumb.
Richard Jones <richard@users.sourceforge.net>
parents:
1175
diff
changeset
|
154 |
| 1165 | 155 def reindex(self): |
| 156 for klass in self.classes.values(): | |
| 157 for nodeid in klass.list(): | |
| 158 klass.index(nodeid) | |
| 159 self.indexer.save_index() | |
| 160 | |
| 161 def determine_columns(self, properties): | |
| 162 ''' Figure the column names and multilink properties from the spec | |
| 163 | |
| 164 "properties" is a list of (name, prop) where prop may be an | |
| 165 instance of a hyperdb "type" _or_ a string repr of that type. | |
| 166 ''' | |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
167 cols = ['_activity', '_creator', '_creation'] |
| 1165 | 168 mls = [] |
| 169 # add the multilinks separately | |
| 170 for col, prop in properties: | |
| 171 if isinstance(prop, Multilink): | |
| 172 mls.append(col) | |
| 173 elif isinstance(prop, type('')) and prop.find('Multilink') != -1: | |
| 174 mls.append(col) | |
| 175 else: | |
| 176 cols.append('_'+col) | |
| 177 cols.sort() | |
| 178 return cols, mls | |
| 179 | |
| 180 def update_class(self, spec, dbspec): | |
| 181 ''' Determine the differences between the current spec and the | |
| 182 database version of the spec, and update where necessary | |
| 183 ''' | |
| 184 spec_schema = spec.schema() | |
| 185 if spec_schema == dbspec: | |
|
1168
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
186 # no save needed for this one |
|
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
187 return 0 |
| 1165 | 188 if __debug__: |
| 189 print >>hyperdb.DEBUG, 'update_class FIRING' | |
| 190 | |
| 191 # key property changed? | |
| 192 if dbspec[0] != spec_schema[0]: | |
| 193 if __debug__: | |
| 194 print >>hyperdb.DEBUG, 'update_class setting keyprop', `spec[0]` | |
| 195 # XXX turn on indexing for the key property | |
| 196 | |
| 197 # dict 'em up | |
| 198 spec_propnames,spec_props = [],{} | |
| 199 for propname,prop in spec_schema[1]: | |
| 200 spec_propnames.append(propname) | |
| 201 spec_props[propname] = prop | |
| 202 dbspec_propnames,dbspec_props = [],{} | |
| 203 for propname,prop in dbspec[1]: | |
| 204 dbspec_propnames.append(propname) | |
| 205 dbspec_props[propname] = prop | |
| 206 | |
| 207 # now compare | |
| 208 for propname in spec_propnames: | |
| 209 prop = spec_props[propname] | |
| 210 if dbspec_props.has_key(propname) and prop==dbspec_props[propname]: | |
| 211 continue | |
| 212 if __debug__: | |
| 213 print >>hyperdb.DEBUG, 'update_class ADD', (propname, prop) | |
| 214 | |
| 215 if not dbspec_props.has_key(propname): | |
| 216 # add the property | |
| 217 if isinstance(prop, Multilink): | |
| 218 # all we have to do here is create a new table, easy! | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
219 self.create_multilink_table(spec, propname) |
| 1165 | 220 continue |
| 221 | |
| 222 # no ALTER TABLE, so we: | |
| 223 # 1. pull out the data, including an extra None column | |
| 224 oldcols, x = self.determine_columns(dbspec[1]) | |
| 225 oldcols.append('id') | |
| 226 oldcols.append('__retired__') | |
| 227 cn = spec.classname | |
| 228 sql = 'select %s,%s from _%s'%(','.join(oldcols), self.arg, cn) | |
| 229 if __debug__: | |
| 230 print >>hyperdb.DEBUG, 'update_class', (self, sql, None) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
231 self.cursor.execute(sql, (None,)) |
|
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
232 olddata = self.cursor.fetchall() |
| 1165 | 233 |
| 234 # 2. drop the old table | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
235 self.cursor.execute('drop table _%s'%cn) |
| 1165 | 236 |
| 237 # 3. create the new table | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
238 cols, mls = self.create_class_table(spec) |
| 1165 | 239 # ensure the new column is last |
| 240 cols.remove('_'+propname) | |
| 241 assert oldcols == cols, "Column lists don't match!" | |
| 242 cols.append('_'+propname) | |
| 243 | |
| 244 # 4. populate with the data from step one | |
| 245 s = ','.join([self.arg for x in cols]) | |
| 246 scols = ','.join(cols) | |
| 247 sql = 'insert into _%s (%s) values (%s)'%(cn, scols, s) | |
| 248 | |
| 249 # GAH, nothing had better go wrong from here on in... but | |
| 250 # we have to commit the drop... | |
| 251 # XXX this isn't necessary in sqlite :( | |
| 252 self.conn.commit() | |
| 253 | |
| 254 # do the insert | |
| 255 for row in olddata: | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
256 self.sql(sql, tuple(row)) |
| 1165 | 257 |
| 258 else: | |
| 259 # modify the property | |
| 260 if __debug__: | |
| 261 print >>hyperdb.DEBUG, 'update_class NOOP' | |
| 262 pass # NOOP in gadfly | |
| 263 | |
| 264 # and the other way - only worry about deletions here | |
| 265 for propname in dbspec_propnames: | |
| 266 prop = dbspec_props[propname] | |
| 267 if spec_props.has_key(propname): | |
| 268 continue | |
| 269 if __debug__: | |
| 270 print >>hyperdb.DEBUG, 'update_class REMOVE', `prop` | |
| 271 | |
| 272 # delete the property | |
| 273 if isinstance(prop, Multilink): | |
| 274 sql = 'drop table %s_%s'%(spec.classname, prop) | |
| 275 if __debug__: | |
| 276 print >>hyperdb.DEBUG, 'update_class', (self, sql) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
277 self.cursor.execute(sql) |
| 1165 | 278 else: |
| 279 # no ALTER TABLE, so we: | |
| 280 # 1. pull out the data, excluding the removed column | |
| 281 oldcols, x = self.determine_columns(spec.properties.items()) | |
| 282 oldcols.append('id') | |
| 283 oldcols.append('__retired__') | |
| 284 # remove the missing column | |
| 285 oldcols.remove('_'+propname) | |
| 286 cn = spec.classname | |
| 287 sql = 'select %s from _%s'%(','.join(oldcols), cn) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
288 self.cursor.execute(sql, (None,)) |
| 1165 | 289 olddata = sql.fetchall() |
| 290 | |
| 291 # 2. drop the old table | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
292 self.cursor.execute('drop table _%s'%cn) |
| 1165 | 293 |
| 294 # 3. create the new table | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
295 cols, mls = self.create_class_table(self, spec) |
| 1165 | 296 assert oldcols != cols, "Column lists don't match!" |
| 297 | |
| 298 # 4. populate with the data from step one | |
| 299 qs = ','.join([self.arg for x in cols]) | |
| 300 sql = 'insert into _%s values (%s)'%(cn, s) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
301 self.cursor.execute(sql, olddata) |
|
1168
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
302 return 1 |
| 1165 | 303 |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
304 def create_class_table(self, spec): |
| 1165 | 305 ''' create the class table for the given spec |
| 306 ''' | |
| 307 cols, mls = self.determine_columns(spec.properties.items()) | |
| 308 | |
| 309 # add on our special columns | |
| 310 cols.append('id') | |
| 311 cols.append('__retired__') | |
| 312 | |
| 313 # create the base table | |
| 314 scols = ','.join(['%s varchar'%x for x in cols]) | |
| 315 sql = 'create table _%s (%s)'%(spec.classname, scols) | |
| 316 if __debug__: | |
| 317 print >>hyperdb.DEBUG, 'create_class', (self, sql) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
318 self.cursor.execute(sql) |
| 1165 | 319 |
| 320 return cols, mls | |
| 321 | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
322 def create_journal_table(self, spec): |
| 1165 | 323 ''' create the journal table for a class given the spec and |
| 324 already-determined cols | |
| 325 ''' | |
| 326 # journal table | |
| 327 cols = ','.join(['%s varchar'%x | |
| 328 for x in 'nodeid date tag action params'.split()]) | |
| 329 sql = 'create table %s__journal (%s)'%(spec.classname, cols) | |
| 330 if __debug__: | |
| 331 print >>hyperdb.DEBUG, 'create_class', (self, sql) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
332 self.cursor.execute(sql) |
| 1165 | 333 |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
334 def create_multilink_table(self, spec, ml): |
| 1165 | 335 ''' Create a multilink table for the "ml" property of the class |
| 336 given by the spec | |
| 337 ''' | |
| 338 sql = 'create table %s_%s (linkid varchar, nodeid varchar)'%( | |
| 339 spec.classname, ml) | |
| 340 if __debug__: | |
| 341 print >>hyperdb.DEBUG, 'create_class', (self, sql) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
342 self.cursor.execute(sql) |
| 1165 | 343 |
| 344 def create_class(self, spec): | |
| 345 ''' Create a database table according to the given spec. | |
| 346 ''' | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
347 cols, mls = self.create_class_table(spec) |
|
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
348 self.create_journal_table(spec) |
| 1165 | 349 |
| 350 # now create the multilink tables | |
| 351 for ml in mls: | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
352 self.create_multilink_table(spec, ml) |
| 1165 | 353 |
| 354 # ID counter | |
| 355 sql = 'insert into ids (name, num) values (%s,%s)'%(self.arg, self.arg) | |
| 356 vals = (spec.classname, 1) | |
| 357 if __debug__: | |
| 358 print >>hyperdb.DEBUG, 'create_class', (self, sql, vals) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
359 self.cursor.execute(sql, vals) |
| 1165 | 360 |
| 361 def drop_class(self, spec): | |
| 362 ''' Drop the given table from the database. | |
| 363 | |
| 364 Drop the journal and multilink tables too. | |
| 365 ''' | |
| 366 # figure the multilinks | |
| 367 mls = [] | |
| 368 for col, prop in spec.properties.items(): | |
| 369 if isinstance(prop, Multilink): | |
| 370 mls.append(col) | |
| 371 | |
| 372 sql = 'drop table _%s'%spec.classname | |
| 373 if __debug__: | |
| 374 print >>hyperdb.DEBUG, 'drop_class', (self, sql) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
375 self.cursor.execute(sql) |
| 1165 | 376 |
| 377 sql = 'drop table %s__journal'%spec.classname | |
| 378 if __debug__: | |
| 379 print >>hyperdb.DEBUG, 'drop_class', (self, sql) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
380 self.cursor.execute(sql) |
| 1165 | 381 |
| 382 for ml in mls: | |
| 383 sql = 'drop table %s_%s'%(spec.classname, ml) | |
| 384 if __debug__: | |
| 385 print >>hyperdb.DEBUG, 'drop_class', (self, sql) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
386 self.cursor.execute(sql) |
| 1165 | 387 |
| 388 # | |
| 389 # Classes | |
| 390 # | |
| 391 def __getattr__(self, classname): | |
| 392 ''' A convenient way of calling self.getclass(classname). | |
| 393 ''' | |
| 394 if self.classes.has_key(classname): | |
| 395 if __debug__: | |
| 396 print >>hyperdb.DEBUG, '__getattr__', (self, classname) | |
| 397 return self.classes[classname] | |
| 398 raise AttributeError, classname | |
| 399 | |
| 400 def addclass(self, cl): | |
| 401 ''' Add a Class to the hyperdatabase. | |
| 402 ''' | |
| 403 if __debug__: | |
| 404 print >>hyperdb.DEBUG, 'addclass', (self, cl) | |
| 405 cn = cl.classname | |
| 406 if self.classes.has_key(cn): | |
| 407 raise ValueError, cn | |
| 408 self.classes[cn] = cl | |
| 409 | |
| 410 def getclasses(self): | |
| 411 ''' Return a list of the names of all existing classes. | |
| 412 ''' | |
| 413 if __debug__: | |
| 414 print >>hyperdb.DEBUG, 'getclasses', (self,) | |
| 415 l = self.classes.keys() | |
| 416 l.sort() | |
| 417 return l | |
| 418 | |
| 419 def getclass(self, classname): | |
| 420 '''Get the Class object representing a particular class. | |
| 421 | |
| 422 If 'classname' is not a valid class name, a KeyError is raised. | |
| 423 ''' | |
| 424 if __debug__: | |
| 425 print >>hyperdb.DEBUG, 'getclass', (self, classname) | |
| 426 try: | |
| 427 return self.classes[classname] | |
| 428 except KeyError: | |
| 429 raise KeyError, 'There is no class called "%s"'%classname | |
| 430 | |
| 431 def clear(self): | |
| 432 ''' Delete all database contents. | |
| 433 | |
| 434 Note: I don't commit here, which is different behaviour to the | |
| 435 "nuke from orbit" behaviour in the *dbms. | |
| 436 ''' | |
| 437 if __debug__: | |
| 438 print >>hyperdb.DEBUG, 'clear', (self,) | |
| 439 for cn in self.classes.keys(): | |
| 440 sql = 'delete from _%s'%cn | |
| 441 if __debug__: | |
| 442 print >>hyperdb.DEBUG, 'clear', (self, sql) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
443 self.cursor.execute(sql) |
| 1165 | 444 |
| 445 # | |
| 446 # Node IDs | |
| 447 # | |
| 448 def newid(self, classname): | |
| 449 ''' Generate a new id for the given class | |
| 450 ''' | |
| 451 # get the next ID | |
| 452 sql = 'select num from ids where name=%s'%self.arg | |
| 453 if __debug__: | |
| 454 print >>hyperdb.DEBUG, 'newid', (self, sql, classname) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
455 self.cursor.execute(sql, (classname, )) |
|
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
456 newid = self.cursor.fetchone()[0] |
| 1165 | 457 |
| 458 # update the counter | |
| 459 sql = 'update ids set num=%s where name=%s'%(self.arg, self.arg) | |
| 460 vals = (int(newid)+1, classname) | |
| 461 if __debug__: | |
| 462 print >>hyperdb.DEBUG, 'newid', (self, sql, vals) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
463 self.cursor.execute(sql, vals) |
| 1165 | 464 |
| 465 # return as string | |
| 466 return str(newid) | |
| 467 | |
| 468 def setid(self, classname, setid): | |
| 469 ''' Set the id counter: used during import of database | |
| 470 ''' | |
| 471 sql = 'update ids set num=%s where name=%s'%(self.arg, self.arg) | |
|
1171
8784a11f8c2f
fix to setid
Richard Jones <richard@users.sourceforge.net>
parents:
1170
diff
changeset
|
472 vals = (setid, classname) |
| 1165 | 473 if __debug__: |
| 474 print >>hyperdb.DEBUG, 'setid', (self, sql, vals) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
475 self.cursor.execute(sql, vals) |
| 1165 | 476 |
| 477 # | |
| 478 # Nodes | |
| 479 # | |
| 480 | |
| 481 def addnode(self, classname, nodeid, node): | |
| 482 ''' Add the specified node to its class's db. | |
| 483 ''' | |
| 484 if __debug__: | |
| 485 print >>hyperdb.DEBUG, 'addnode', (self, classname, nodeid, node) | |
| 486 # gadfly requires values for all non-multilink columns | |
| 487 cl = self.classes[classname] | |
| 488 cols, mls = self.determine_columns(cl.properties.items()) | |
| 489 | |
|
1189
23b8d1e87fe3
import fixes
Richard Jones <richard@users.sourceforge.net>
parents:
1187
diff
changeset
|
490 # we'll be supplied these props if we're doing an import |
|
23b8d1e87fe3
import fixes
Richard Jones <richard@users.sourceforge.net>
parents:
1187
diff
changeset
|
491 if not node.has_key('creator'): |
|
23b8d1e87fe3
import fixes
Richard Jones <richard@users.sourceforge.net>
parents:
1187
diff
changeset
|
492 # add in the "calculated" properties (dupe so we don't affect |
|
23b8d1e87fe3
import fixes
Richard Jones <richard@users.sourceforge.net>
parents:
1187
diff
changeset
|
493 # calling code's node assumptions) |
|
23b8d1e87fe3
import fixes
Richard Jones <richard@users.sourceforge.net>
parents:
1187
diff
changeset
|
494 node = node.copy() |
|
23b8d1e87fe3
import fixes
Richard Jones <richard@users.sourceforge.net>
parents:
1187
diff
changeset
|
495 node['creation'] = node['activity'] = date.Date() |
|
23b8d1e87fe3
import fixes
Richard Jones <richard@users.sourceforge.net>
parents:
1187
diff
changeset
|
496 node['creator'] = self.curuserid |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
497 |
| 1165 | 498 # default the non-multilink columns |
| 499 for col, prop in cl.properties.items(): | |
| 500 if not isinstance(col, Multilink): | |
| 501 if not node.has_key(col): | |
| 502 node[col] = None | |
| 503 | |
|
1173
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
504 # clear this node out of the cache if it's in there |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
505 key = (classname, nodeid) |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
506 if self.cache.has_key(key): |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
507 del self.cache[key] |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
508 self.cache_lru.remove(key) |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
509 |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
510 # make the node data safe for the DB |
| 1165 | 511 node = self.serialise(classname, node) |
| 512 | |
| 513 # make sure the ordering is correct for column name -> column value | |
| 514 vals = tuple([node[col[1:]] for col in cols]) + (nodeid, 0) | |
| 515 s = ','.join([self.arg for x in cols]) + ',%s,%s'%(self.arg, self.arg) | |
| 516 cols = ','.join(cols) + ',id,__retired__' | |
| 517 | |
| 518 # perform the inserts | |
| 519 sql = 'insert into _%s (%s) values (%s)'%(classname, cols, s) | |
| 520 if __debug__: | |
| 521 print >>hyperdb.DEBUG, 'addnode', (self, sql, vals) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
522 self.cursor.execute(sql, vals) |
| 1165 | 523 |
| 524 # insert the multilink rows | |
| 525 for col in mls: | |
| 526 t = '%s_%s'%(classname, col) | |
| 527 for entry in node[col]: | |
| 528 sql = 'insert into %s (linkid, nodeid) values (%s,%s)'%(t, | |
| 529 self.arg, self.arg) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
530 self.sql(sql, (entry, nodeid)) |
| 1165 | 531 |
| 532 # make sure we do the commit-time extra stuff for this node | |
| 533 self.transactions.append((self.doSaveNode, (classname, nodeid, node))) | |
| 534 | |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
535 def setnode(self, classname, nodeid, values, multilink_changes): |
| 1165 | 536 ''' Change the specified node. |
| 537 ''' | |
| 538 if __debug__: | |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
539 print >>hyperdb.DEBUG, 'setnode', (self, classname, nodeid, values) |
|
1173
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
540 |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
541 # clear this node out of the cache if it's in there |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
542 key = (classname, nodeid) |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
543 if self.cache.has_key(key): |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
544 del self.cache[key] |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
545 self.cache_lru.remove(key) |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
546 |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
547 # add the special props |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
548 values = values.copy() |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
549 values['activity'] = date.Date() |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
550 |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
551 # make db-friendly |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
552 values = self.serialise(classname, values) |
| 1165 | 553 |
| 554 cl = self.classes[classname] | |
| 555 cols = [] | |
| 556 mls = [] | |
| 557 # add the multilinks separately | |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
558 props = cl.getprops() |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
559 for col in values.keys(): |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
560 prop = props[col] |
| 1165 | 561 if isinstance(prop, Multilink): |
| 562 mls.append(col) | |
| 563 else: | |
| 564 cols.append('_'+col) | |
| 565 cols.sort() | |
| 566 | |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
567 # if there's any updates to regular columns, do them |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
568 if cols: |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
569 # make sure the ordering is correct for column name -> column value |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
570 sqlvals = tuple([values[col[1:]] for col in cols]) + (nodeid,) |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
571 s = ','.join(['%s=%s'%(x, self.arg) for x in cols]) |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
572 cols = ','.join(cols) |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
573 |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
574 # perform the update |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
575 sql = 'update _%s set %s where id=%s'%(classname, s, self.arg) |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
576 if __debug__: |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
577 print >>hyperdb.DEBUG, 'setnode', (self, sql, sqlvals) |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
578 self.cursor.execute(sql, sqlvals) |
| 1165 | 579 |
| 580 # now the fun bit, updating the multilinks ;) | |
| 581 for col, (add, remove) in multilink_changes.items(): | |
| 582 tn = '%s_%s'%(classname, col) | |
| 583 if add: | |
| 584 sql = 'insert into %s (nodeid, linkid) values (%s,%s)'%(tn, | |
| 585 self.arg, self.arg) | |
| 586 for addid in add: | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
587 self.sql(sql, (nodeid, addid)) |
| 1165 | 588 if remove: |
| 589 sql = 'delete from %s where nodeid=%s and linkid=%s'%(tn, | |
| 590 self.arg, self.arg) | |
| 591 for removeid in remove: | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
592 self.sql(sql, (nodeid, removeid)) |
| 1165 | 593 |
| 594 # make sure we do the commit-time extra stuff for this node | |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
595 self.transactions.append((self.doSaveNode, (classname, nodeid, values))) |
| 1165 | 596 |
| 597 def getnode(self, classname, nodeid): | |
| 598 ''' Get a node from the database. | |
| 599 ''' | |
| 600 if __debug__: | |
| 601 print >>hyperdb.DEBUG, 'getnode', (self, classname, nodeid) | |
|
1173
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
602 |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
603 # see if we have this node cached |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
604 key = (classname, nodeid) |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
605 if self.cache.has_key(key): |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
606 # push us back to the top of the LRU |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
607 self.cache_lru.remove(key) |
|
1185
3b0735ef8207
fix to LRU cache
Richard Jones <richard@users.sourceforge.net>
parents:
1183
diff
changeset
|
608 self.cache_lru.insert(0, key) |
|
1173
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
609 # return the cached information |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
610 return self.cache[key] |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
611 |
| 1165 | 612 # figure the columns we're fetching |
| 613 cl = self.classes[classname] | |
| 614 cols, mls = self.determine_columns(cl.properties.items()) | |
| 615 scols = ','.join(cols) | |
| 616 | |
| 617 # perform the basic property fetch | |
| 618 sql = 'select %s from _%s where id=%s'%(scols, classname, self.arg) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
619 self.sql(sql, (nodeid,)) |
| 1165 | 620 |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
621 values = self.sql_fetchone() |
| 1165 | 622 if values is None: |
| 623 raise IndexError, 'no such %s node %s'%(classname, nodeid) | |
| 624 | |
| 625 # make up the node | |
| 626 node = {} | |
| 627 for col in range(len(cols)): | |
| 628 node[cols[col][1:]] = values[col] | |
| 629 | |
| 630 # now the multilinks | |
| 631 for col in mls: | |
| 632 # get the link ids | |
| 633 sql = 'select linkid from %s_%s where nodeid=%s'%(classname, col, | |
| 634 self.arg) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
635 self.cursor.execute(sql, (nodeid,)) |
| 1165 | 636 # extract the first column from the result |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
637 node[col] = [x[0] for x in self.cursor.fetchall()] |
| 1165 | 638 |
|
1173
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
639 # un-dbificate the node data |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
640 node = self.unserialise(classname, node) |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
641 |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
642 # save off in the cache |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
643 key = (classname, nodeid) |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
644 self.cache[key] = node |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
645 # update the LRU |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
646 self.cache_lru.insert(0, key) |
|
1185
3b0735ef8207
fix to LRU cache
Richard Jones <richard@users.sourceforge.net>
parents:
1183
diff
changeset
|
647 if len(self.cache_lru) > ROW_CACHE_SIZE: |
|
3b0735ef8207
fix to LRU cache
Richard Jones <richard@users.sourceforge.net>
parents:
1183
diff
changeset
|
648 del self.cache[self.cache_lru.pop()] |
|
1173
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
649 |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
650 return node |
| 1165 | 651 |
| 652 def destroynode(self, classname, nodeid): | |
| 653 '''Remove a node from the database. Called exclusively by the | |
| 654 destroy() method on Class. | |
| 655 ''' | |
| 656 if __debug__: | |
| 657 print >>hyperdb.DEBUG, 'destroynode', (self, classname, nodeid) | |
| 658 | |
| 659 # make sure the node exists | |
| 660 if not self.hasnode(classname, nodeid): | |
| 661 raise IndexError, '%s has no node %s'%(classname, nodeid) | |
| 662 | |
|
1173
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
663 # see if we have this node cached |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
664 if self.cache.has_key((classname, nodeid)): |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
665 del self.cache[(classname, nodeid)] |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
666 |
| 1165 | 667 # see if there's any obvious commit actions that we should get rid of |
| 668 for entry in self.transactions[:]: | |
| 669 if entry[1][:2] == (classname, nodeid): | |
| 670 self.transactions.remove(entry) | |
| 671 | |
| 672 # now do the SQL | |
| 673 sql = 'delete from _%s where id=%s'%(classname, self.arg) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
674 self.sql(sql, (nodeid,)) |
| 1165 | 675 |
| 676 # remove from multilnks | |
| 677 cl = self.getclass(classname) | |
| 678 x, mls = self.determine_columns(cl.properties.items()) | |
| 679 for col in mls: | |
| 680 # get the link ids | |
| 681 sql = 'delete from %s_%s where nodeid=%s'%(classname, col, self.arg) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
682 self.cursor.execute(sql, (nodeid,)) |
| 1165 | 683 |
| 684 # remove journal entries | |
| 685 sql = 'delete from %s__journal where nodeid=%s'%(classname, self.arg) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
686 self.sql(sql, (nodeid,)) |
| 1165 | 687 |
| 688 def serialise(self, classname, node): | |
| 689 '''Copy the node contents, converting non-marshallable data into | |
| 690 marshallable data. | |
| 691 ''' | |
| 692 if __debug__: | |
| 693 print >>hyperdb.DEBUG, 'serialise', classname, node | |
| 694 properties = self.getclass(classname).getprops() | |
| 695 d = {} | |
| 696 for k, v in node.items(): | |
| 697 # if the property doesn't exist, or is the "retired" flag then | |
| 698 # it won't be in the properties dict | |
| 699 if not properties.has_key(k): | |
| 700 d[k] = v | |
| 701 continue | |
| 702 | |
| 703 # get the property spec | |
| 704 prop = properties[k] | |
| 705 | |
|
1252
209a47ede743
allow blank passwords again [SF#619714]
Richard Jones <richard@users.sourceforge.net>
parents:
1249
diff
changeset
|
706 if isinstance(prop, Password) and v is not None: |
| 1165 | 707 d[k] = str(v) |
| 708 elif isinstance(prop, Date) and v is not None: | |
| 709 d[k] = v.serialise() | |
| 710 elif isinstance(prop, Interval) and v is not None: | |
| 711 d[k] = v.serialise() | |
| 712 else: | |
| 713 d[k] = v | |
| 714 return d | |
| 715 | |
| 716 def unserialise(self, classname, node): | |
| 717 '''Decode the marshalled node data | |
| 718 ''' | |
| 719 if __debug__: | |
| 720 print >>hyperdb.DEBUG, 'unserialise', classname, node | |
| 721 properties = self.getclass(classname).getprops() | |
| 722 d = {} | |
| 723 for k, v in node.items(): | |
| 724 # if the property doesn't exist, or is the "retired" flag then | |
| 725 # it won't be in the properties dict | |
| 726 if not properties.has_key(k): | |
| 727 d[k] = v | |
| 728 continue | |
| 729 | |
| 730 # get the property spec | |
| 731 prop = properties[k] | |
| 732 | |
| 733 if isinstance(prop, Date) and v is not None: | |
| 734 d[k] = date.Date(v) | |
| 735 elif isinstance(prop, Interval) and v is not None: | |
| 736 d[k] = date.Interval(v) | |
|
1252
209a47ede743
allow blank passwords again [SF#619714]
Richard Jones <richard@users.sourceforge.net>
parents:
1249
diff
changeset
|
737 elif isinstance(prop, Password) and v is not None: |
| 1165 | 738 p = password.Password() |
| 739 p.unpack(v) | |
| 740 d[k] = p | |
|
1415
6883852e9b15
mysql backend passes all tests (at last!)
Andrey Lebedev <kedder@users.sourceforge.net>
parents:
1409
diff
changeset
|
741 elif (isinstance(prop, Boolean) or isinstance(prop, Number)) and v is not None: |
|
6883852e9b15
mysql backend passes all tests (at last!)
Andrey Lebedev <kedder@users.sourceforge.net>
parents:
1409
diff
changeset
|
742 d[k]=float(v) |
| 1165 | 743 else: |
| 744 d[k] = v | |
| 745 return d | |
| 746 | |
| 747 def hasnode(self, classname, nodeid): | |
| 748 ''' Determine if the database has a given node. | |
| 749 ''' | |
| 750 sql = 'select count(*) from _%s where id=%s'%(classname, self.arg) | |
| 751 if __debug__: | |
| 752 print >>hyperdb.DEBUG, 'hasnode', (self, sql, nodeid) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
753 self.cursor.execute(sql, (nodeid,)) |
|
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
754 return int(self.cursor.fetchone()[0]) |
| 1165 | 755 |
| 756 def countnodes(self, classname): | |
| 757 ''' Count the number of nodes that exist for a particular Class. | |
| 758 ''' | |
| 759 sql = 'select count(*) from _%s'%classname | |
| 760 if __debug__: | |
| 761 print >>hyperdb.DEBUG, 'countnodes', (self, sql) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
762 self.cursor.execute(sql) |
|
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
763 return self.cursor.fetchone()[0] |
| 1165 | 764 |
| 765 def getnodeids(self, classname, retired=0): | |
| 766 ''' Retrieve all the ids of the nodes for a particular Class. | |
| 767 | |
| 768 Set retired=None to get all nodes. Otherwise it'll get all the | |
| 769 retired or non-retired nodes, depending on the flag. | |
| 770 ''' | |
| 771 # flip the sense of the flag if we don't want all of them | |
| 772 if retired is not None: | |
| 773 retired = not retired | |
| 774 sql = 'select id from _%s where __retired__ <> %s'%(classname, self.arg) | |
| 775 if __debug__: | |
| 776 print >>hyperdb.DEBUG, 'getnodeids', (self, sql, retired) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
777 self.cursor.execute(sql, (retired,)) |
|
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
778 return [x[0] for x in self.cursor.fetchall()] |
| 1165 | 779 |
| 780 def addjournal(self, classname, nodeid, action, params, creator=None, | |
| 781 creation=None): | |
| 782 ''' Journal the Action | |
| 783 'action' may be: | |
| 784 | |
| 785 'create' or 'set' -- 'params' is a dictionary of property values | |
| 786 'link' or 'unlink' -- 'params' is (classname, nodeid, propname) | |
| 787 'retire' -- 'params' is None | |
| 788 ''' | |
| 789 # serialise the parameters now if necessary | |
| 790 if isinstance(params, type({})): | |
| 791 if action in ('set', 'create'): | |
| 792 params = self.serialise(classname, params) | |
| 793 | |
| 794 # handle supply of the special journalling parameters (usually | |
| 795 # supplied on importing an existing database) | |
| 796 if creator: | |
| 797 journaltag = creator | |
| 798 else: | |
|
1176
bd3b57859c37
On second thought, that last checkin was dumb.
Richard Jones <richard@users.sourceforge.net>
parents:
1175
diff
changeset
|
799 journaltag = self.curuserid |
| 1165 | 800 if creation: |
| 801 journaldate = creation.serialise() | |
| 802 else: | |
| 803 journaldate = date.Date().serialise() | |
| 804 | |
| 805 # create the journal entry | |
| 806 cols = ','.join('nodeid date tag action params'.split()) | |
| 807 | |
| 808 if __debug__: | |
| 809 print >>hyperdb.DEBUG, 'addjournal', (nodeid, journaldate, | |
| 810 journaltag, action, params) | |
| 811 | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
812 self.save_journal(classname, cols, nodeid, journaldate, |
| 1165 | 813 journaltag, action, params) |
| 814 | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
815 def save_journal(self, classname, cols, nodeid, journaldate, |
| 1165 | 816 journaltag, action, params): |
| 817 ''' Save the journal entry to the database | |
| 818 ''' | |
| 819 raise NotImplemented | |
| 820 | |
| 821 def getjournal(self, classname, nodeid): | |
| 822 ''' get the journal for id | |
| 823 ''' | |
| 824 # make sure the node exists | |
| 825 if not self.hasnode(classname, nodeid): | |
| 826 raise IndexError, '%s has no node %s'%(classname, nodeid) | |
| 827 | |
| 828 cols = ','.join('nodeid date tag action params'.split()) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
829 return self.load_journal(classname, cols, nodeid) |
| 1165 | 830 |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
831 def load_journal(self, classname, cols, nodeid): |
| 1165 | 832 ''' Load the journal from the database |
| 833 ''' | |
| 834 raise NotImplemented | |
| 835 | |
| 836 def pack(self, pack_before): | |
| 837 ''' Delete all journal entries except "create" before 'pack_before'. | |
| 838 ''' | |
| 839 # get a 'yyyymmddhhmmss' version of the date | |
| 840 date_stamp = pack_before.serialise() | |
| 841 | |
| 842 # do the delete | |
| 843 for classname in self.classes.keys(): | |
| 844 sql = "delete from %s__journal where date<%s and "\ | |
| 845 "action<>'create'"%(classname, self.arg) | |
| 846 if __debug__: | |
| 847 print >>hyperdb.DEBUG, 'pack', (self, sql, date_stamp) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
848 self.cursor.execute(sql, (date_stamp,)) |
| 1165 | 849 |
| 850 def sql_commit(self): | |
| 851 ''' Actually commit to the database. | |
| 852 ''' | |
| 853 self.conn.commit() | |
| 854 | |
| 855 def commit(self): | |
| 856 ''' Commit the current transactions. | |
| 857 | |
| 858 Save all data changed since the database was opened or since the | |
| 859 last commit() or rollback(). | |
| 860 ''' | |
| 861 if __debug__: | |
| 862 print >>hyperdb.DEBUG, 'commit', (self,) | |
| 863 | |
| 864 # commit the database | |
| 865 self.sql_commit() | |
| 866 | |
| 867 # now, do all the other transaction stuff | |
| 868 reindex = {} | |
| 869 for method, args in self.transactions: | |
| 870 reindex[method(*args)] = 1 | |
| 871 | |
| 872 # reindex the nodes that request it | |
| 873 for classname, nodeid in filter(None, reindex.keys()): | |
| 874 print >>hyperdb.DEBUG, 'commit.reindex', (classname, nodeid) | |
| 875 self.getclass(classname).index(nodeid) | |
| 876 | |
| 877 # save the indexer state | |
| 878 self.indexer.save_index() | |
| 879 | |
| 880 # clear out the transactions | |
| 881 self.transactions = [] | |
| 882 | |
| 883 def rollback(self): | |
| 884 ''' Reverse all actions from the current transaction. | |
| 885 | |
| 886 Undo all the changes made since the database was opened or the last | |
| 887 commit() or rollback() was performed. | |
| 888 ''' | |
| 889 if __debug__: | |
| 890 print >>hyperdb.DEBUG, 'rollback', (self,) | |
| 891 | |
| 892 # roll back | |
| 893 self.conn.rollback() | |
| 894 | |
| 895 # roll back "other" transaction stuff | |
| 896 for method, args in self.transactions: | |
| 897 # delete temporary files | |
| 898 if method == self.doStoreFile: | |
| 899 self.rollbackStoreFile(*args) | |
| 900 self.transactions = [] | |
| 901 | |
| 902 def doSaveNode(self, classname, nodeid, node): | |
| 903 ''' dummy that just generates a reindex event | |
| 904 ''' | |
| 905 # return the classname, nodeid so we reindex this content | |
| 906 return (classname, nodeid) | |
| 907 | |
| 908 def close(self): | |
| 909 ''' Close off the connection. | |
| 910 ''' | |
| 911 self.conn.close() | |
|
1333
80d27b7d6db5
implemented whole-database locking
Richard Jones <richard@users.sourceforge.net>
parents:
1304
diff
changeset
|
912 if self.lockfile is not None: |
|
80d27b7d6db5
implemented whole-database locking
Richard Jones <richard@users.sourceforge.net>
parents:
1304
diff
changeset
|
913 locking.release_lock(self.lockfile) |
|
80d27b7d6db5
implemented whole-database locking
Richard Jones <richard@users.sourceforge.net>
parents:
1304
diff
changeset
|
914 if self.lockfile is not None: |
|
80d27b7d6db5
implemented whole-database locking
Richard Jones <richard@users.sourceforge.net>
parents:
1304
diff
changeset
|
915 self.lockfile.close() |
|
80d27b7d6db5
implemented whole-database locking
Richard Jones <richard@users.sourceforge.net>
parents:
1304
diff
changeset
|
916 self.lockfile = None |
| 1165 | 917 |
| 918 # | |
| 919 # The base Class class | |
| 920 # | |
| 921 class Class(hyperdb.Class): | |
| 922 ''' The handle to a particular class of nodes in a hyperdatabase. | |
| 923 | |
| 924 All methods except __repr__ and getnode must be implemented by a | |
| 925 concrete backend Class. | |
| 926 ''' | |
| 927 | |
| 928 def __init__(self, db, classname, **properties): | |
| 929 '''Create a new class with a given name and property specification. | |
| 930 | |
| 931 'classname' must not collide with the name of an existing class, | |
| 932 or a ValueError is raised. The keyword arguments in 'properties' | |
| 933 must map names to property objects, or a TypeError is raised. | |
| 934 ''' | |
| 935 if (properties.has_key('creation') or properties.has_key('activity') | |
| 936 or properties.has_key('creator')): | |
| 937 raise ValueError, '"creation", "activity" and "creator" are '\ | |
| 938 'reserved' | |
| 939 | |
| 940 self.classname = classname | |
| 941 self.properties = properties | |
| 942 self.db = weakref.proxy(db) # use a weak ref to avoid circularity | |
| 943 self.key = '' | |
| 944 | |
| 945 # should we journal changes (default yes) | |
| 946 self.do_journal = 1 | |
| 947 | |
| 948 # do the db-related init stuff | |
| 949 db.addclass(self) | |
| 950 | |
| 951 self.auditors = {'create': [], 'set': [], 'retire': []} | |
| 952 self.reactors = {'create': [], 'set': [], 'retire': []} | |
| 953 | |
| 954 def schema(self): | |
| 955 ''' A dumpable version of the schema that we can store in the | |
| 956 database | |
| 957 ''' | |
| 958 return (self.key, [(x, repr(y)) for x,y in self.properties.items()]) | |
| 959 | |
| 960 def enableJournalling(self): | |
| 961 '''Turn journalling on for this class | |
| 962 ''' | |
| 963 self.do_journal = 1 | |
| 964 | |
| 965 def disableJournalling(self): | |
| 966 '''Turn journalling off for this class | |
| 967 ''' | |
| 968 self.do_journal = 0 | |
| 969 | |
| 970 # Editing nodes: | |
| 971 def create(self, **propvalues): | |
| 972 ''' Create a new node of this class and return its id. | |
| 973 | |
| 974 The keyword arguments in 'propvalues' map property names to values. | |
| 975 | |
| 976 The values of arguments must be acceptable for the types of their | |
| 977 corresponding properties or a TypeError is raised. | |
| 978 | |
| 979 If this class has a key property, it must be present and its value | |
| 980 must not collide with other key strings or a ValueError is raised. | |
| 981 | |
| 982 Any other properties on this class that are missing from the | |
| 983 'propvalues' dictionary are set to None. | |
| 984 | |
| 985 If an id in a link or multilink property does not refer to a valid | |
| 986 node, an IndexError is raised. | |
| 987 ''' | |
| 988 if propvalues.has_key('id'): | |
| 989 raise KeyError, '"id" is reserved' | |
| 990 | |
| 991 if self.db.journaltag is None: | |
| 992 raise DatabaseError, 'Database open read-only' | |
| 993 | |
| 994 if propvalues.has_key('creation') or propvalues.has_key('activity'): | |
| 995 raise KeyError, '"creation" and "activity" are reserved' | |
| 996 | |
| 997 self.fireAuditors('create', None, propvalues) | |
| 998 | |
| 999 # new node's id | |
| 1000 newid = self.db.newid(self.classname) | |
| 1001 | |
| 1002 # validate propvalues | |
| 1003 num_re = re.compile('^\d+$') | |
| 1004 for key, value in propvalues.items(): | |
| 1005 if key == self.key: | |
| 1006 try: | |
| 1007 self.lookup(value) | |
| 1008 except KeyError: | |
| 1009 pass | |
| 1010 else: | |
| 1011 raise ValueError, 'node with key "%s" exists'%value | |
| 1012 | |
| 1013 # try to handle this property | |
| 1014 try: | |
| 1015 prop = self.properties[key] | |
| 1016 except KeyError: | |
| 1017 raise KeyError, '"%s" has no property "%s"'%(self.classname, | |
| 1018 key) | |
| 1019 | |
| 1020 if value is not None and isinstance(prop, Link): | |
| 1021 if type(value) != type(''): | |
| 1022 raise ValueError, 'link value must be String' | |
| 1023 link_class = self.properties[key].classname | |
| 1024 # if it isn't a number, it's a key | |
| 1025 if not num_re.match(value): | |
| 1026 try: | |
| 1027 value = self.db.classes[link_class].lookup(value) | |
| 1028 except (TypeError, KeyError): | |
| 1029 raise IndexError, 'new property "%s": %s not a %s'%( | |
| 1030 key, value, link_class) | |
| 1031 elif not self.db.getclass(link_class).hasnode(value): | |
| 1032 raise IndexError, '%s has no node %s'%(link_class, value) | |
| 1033 | |
| 1034 # save off the value | |
| 1035 propvalues[key] = value | |
| 1036 | |
| 1037 # register the link with the newly linked node | |
| 1038 if self.do_journal and self.properties[key].do_journal: | |
| 1039 self.db.addjournal(link_class, value, 'link', | |
| 1040 (self.classname, newid, key)) | |
| 1041 | |
| 1042 elif isinstance(prop, Multilink): | |
| 1043 if type(value) != type([]): | |
| 1044 raise TypeError, 'new property "%s" not a list of ids'%key | |
| 1045 | |
| 1046 # clean up and validate the list of links | |
| 1047 link_class = self.properties[key].classname | |
| 1048 l = [] | |
| 1049 for entry in value: | |
| 1050 if type(entry) != type(''): | |
| 1051 raise ValueError, '"%s" multilink value (%r) '\ | |
| 1052 'must contain Strings'%(key, value) | |
| 1053 # if it isn't a number, it's a key | |
| 1054 if not num_re.match(entry): | |
| 1055 try: | |
| 1056 entry = self.db.classes[link_class].lookup(entry) | |
| 1057 except (TypeError, KeyError): | |
| 1058 raise IndexError, 'new property "%s": %s not a %s'%( | |
| 1059 key, entry, self.properties[key].classname) | |
| 1060 l.append(entry) | |
| 1061 value = l | |
| 1062 propvalues[key] = value | |
| 1063 | |
| 1064 # handle additions | |
| 1065 for nodeid in value: | |
| 1066 if not self.db.getclass(link_class).hasnode(nodeid): | |
| 1067 raise IndexError, '%s has no node %s'%(link_class, | |
| 1068 nodeid) | |
| 1069 # register the link with the newly linked node | |
| 1070 if self.do_journal and self.properties[key].do_journal: | |
| 1071 self.db.addjournal(link_class, nodeid, 'link', | |
| 1072 (self.classname, newid, key)) | |
| 1073 | |
| 1074 elif isinstance(prop, String): | |
|
1383
f19dde90e473
applied unicode patch
Andrey Lebedev <kedder@users.sourceforge.net>
parents:
1365
diff
changeset
|
1075 if type(value) != type('') and type(value) != type(u''): |
| 1165 | 1076 raise TypeError, 'new property "%s" not a string'%key |
| 1077 | |
| 1078 elif isinstance(prop, Password): | |
| 1079 if not isinstance(value, password.Password): | |
| 1080 raise TypeError, 'new property "%s" not a Password'%key | |
| 1081 | |
| 1082 elif isinstance(prop, Date): | |
| 1083 if value is not None and not isinstance(value, date.Date): | |
| 1084 raise TypeError, 'new property "%s" not a Date'%key | |
| 1085 | |
| 1086 elif isinstance(prop, Interval): | |
| 1087 if value is not None and not isinstance(value, date.Interval): | |
| 1088 raise TypeError, 'new property "%s" not an Interval'%key | |
| 1089 | |
| 1090 elif value is not None and isinstance(prop, Number): | |
| 1091 try: | |
| 1092 float(value) | |
| 1093 except ValueError: | |
| 1094 raise TypeError, 'new property "%s" not numeric'%key | |
| 1095 | |
| 1096 elif value is not None and isinstance(prop, Boolean): | |
| 1097 try: | |
| 1098 int(value) | |
| 1099 except ValueError: | |
| 1100 raise TypeError, 'new property "%s" not boolean'%key | |
| 1101 | |
| 1102 # make sure there's data where there needs to be | |
| 1103 for key, prop in self.properties.items(): | |
| 1104 if propvalues.has_key(key): | |
| 1105 continue | |
| 1106 if key == self.key: | |
| 1107 raise ValueError, 'key property "%s" is required'%key | |
| 1108 if isinstance(prop, Multilink): | |
| 1109 propvalues[key] = [] | |
| 1110 else: | |
| 1111 propvalues[key] = None | |
| 1112 | |
| 1113 # done | |
| 1114 self.db.addnode(self.classname, newid, propvalues) | |
| 1115 if self.do_journal: | |
|
1304
61ad556cfc8d
working toward 0.5.2 release
Richard Jones <richard@users.sourceforge.net>
parents:
1295
diff
changeset
|
1116 self.db.addjournal(self.classname, newid, 'create', {}) |
| 1165 | 1117 |
| 1118 self.fireReactors('create', newid, None) | |
| 1119 | |
| 1120 return newid | |
| 1121 | |
| 1122 def export_list(self, propnames, nodeid): | |
| 1123 ''' Export a node - generate a list of CSV-able data in the order | |
| 1124 specified by propnames for the given node. | |
| 1125 ''' | |
| 1126 properties = self.getprops() | |
| 1127 l = [] | |
| 1128 for prop in propnames: | |
| 1129 proptype = properties[prop] | |
| 1130 value = self.get(nodeid, prop) | |
| 1131 # "marshal" data where needed | |
| 1132 if value is None: | |
| 1133 pass | |
| 1134 elif isinstance(proptype, hyperdb.Date): | |
| 1135 value = value.get_tuple() | |
| 1136 elif isinstance(proptype, hyperdb.Interval): | |
| 1137 value = value.get_tuple() | |
| 1138 elif isinstance(proptype, hyperdb.Password): | |
| 1139 value = str(value) | |
| 1140 l.append(repr(value)) | |
| 1141 return l | |
| 1142 | |
| 1143 def import_list(self, propnames, proplist): | |
| 1144 ''' Import a node - all information including "id" is present and | |
| 1145 should not be sanity checked. Triggers are not triggered. The | |
| 1146 journal should be initialised using the "creator" and "created" | |
| 1147 information. | |
| 1148 | |
| 1149 Return the nodeid of the node imported. | |
| 1150 ''' | |
| 1151 if self.db.journaltag is None: | |
| 1152 raise DatabaseError, 'Database open read-only' | |
| 1153 properties = self.getprops() | |
| 1154 | |
| 1155 # make the new node's property map | |
| 1156 d = {} | |
| 1157 for i in range(len(propnames)): | |
| 1158 # Use eval to reverse the repr() used to output the CSV | |
| 1159 value = eval(proplist[i]) | |
| 1160 | |
| 1161 # Figure the property for this column | |
| 1162 propname = propnames[i] | |
| 1163 prop = properties[propname] | |
| 1164 | |
| 1165 # "unmarshal" where necessary | |
| 1166 if propname == 'id': | |
| 1167 newid = value | |
| 1168 continue | |
| 1169 elif value is None: | |
| 1170 # don't set Nones | |
| 1171 continue | |
| 1172 elif isinstance(prop, hyperdb.Date): | |
| 1173 value = date.Date(value) | |
| 1174 elif isinstance(prop, hyperdb.Interval): | |
| 1175 value = date.Interval(value) | |
| 1176 elif isinstance(prop, hyperdb.Password): | |
| 1177 pwd = password.Password() | |
| 1178 pwd.unpack(value) | |
| 1179 value = pwd | |
| 1180 d[propname] = value | |
| 1181 | |
|
1187
84e40c9bcd99
import fixes
Richard Jones <richard@users.sourceforge.net>
parents:
1185
diff
changeset
|
1182 # add the node and journal |
|
84e40c9bcd99
import fixes
Richard Jones <richard@users.sourceforge.net>
parents:
1185
diff
changeset
|
1183 self.db.addnode(self.classname, newid, d) |
|
84e40c9bcd99
import fixes
Richard Jones <richard@users.sourceforge.net>
parents:
1185
diff
changeset
|
1184 |
| 1165 | 1185 # extract the extraneous journalling gumpf and nuke it |
| 1186 if d.has_key('creator'): | |
| 1187 creator = d['creator'] | |
| 1188 del d['creator'] | |
|
1187
84e40c9bcd99
import fixes
Richard Jones <richard@users.sourceforge.net>
parents:
1185
diff
changeset
|
1189 else: |
|
84e40c9bcd99
import fixes
Richard Jones <richard@users.sourceforge.net>
parents:
1185
diff
changeset
|
1190 creator = None |
| 1165 | 1191 if d.has_key('creation'): |
| 1192 creation = d['creation'] | |
| 1193 del d['creation'] | |
|
1187
84e40c9bcd99
import fixes
Richard Jones <richard@users.sourceforge.net>
parents:
1185
diff
changeset
|
1194 else: |
|
84e40c9bcd99
import fixes
Richard Jones <richard@users.sourceforge.net>
parents:
1185
diff
changeset
|
1195 creation = None |
| 1165 | 1196 if d.has_key('activity'): |
| 1197 del d['activity'] | |
|
1304
61ad556cfc8d
working toward 0.5.2 release
Richard Jones <richard@users.sourceforge.net>
parents:
1295
diff
changeset
|
1198 self.db.addjournal(self.classname, newid, 'create', {}, creator, |
| 1165 | 1199 creation) |
| 1200 return newid | |
| 1201 | |
| 1202 _marker = [] | |
| 1203 def get(self, nodeid, propname, default=_marker, cache=1): | |
| 1204 '''Get the value of a property on an existing node of this class. | |
| 1205 | |
| 1206 'nodeid' must be the id of an existing node of this class or an | |
| 1207 IndexError is raised. 'propname' must be the name of a property | |
| 1208 of this class or a KeyError is raised. | |
| 1209 | |
| 1210 'cache' indicates whether the transaction cache should be queried | |
| 1211 for the node. If the node has been modified and you need to | |
| 1212 determine what its values prior to modification are, you need to | |
| 1213 set cache=0. | |
| 1214 ''' | |
| 1215 if propname == 'id': | |
| 1216 return nodeid | |
| 1217 | |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1218 # get the node's dict |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1219 d = self.db.getnode(self.classname, nodeid) |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1220 |
| 1165 | 1221 if propname == 'creation': |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1222 if d.has_key('creation'): |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1223 return d['creation'] |
| 1165 | 1224 else: |
| 1225 return date.Date() | |
| 1226 if propname == 'activity': | |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1227 if d.has_key('activity'): |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1228 return d['activity'] |
| 1165 | 1229 else: |
| 1230 return date.Date() | |
| 1231 if propname == 'creator': | |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1232 if d.has_key('creator'): |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1233 return d['creator'] |
| 1165 | 1234 else: |
|
1176
bd3b57859c37
On second thought, that last checkin was dumb.
Richard Jones <richard@users.sourceforge.net>
parents:
1175
diff
changeset
|
1235 return self.db.curuserid |
| 1165 | 1236 |
| 1237 # get the property (raises KeyErorr if invalid) | |
| 1238 prop = self.properties[propname] | |
| 1239 | |
| 1240 if not d.has_key(propname): | |
| 1241 if default is self._marker: | |
| 1242 if isinstance(prop, Multilink): | |
| 1243 return [] | |
| 1244 else: | |
| 1245 return None | |
| 1246 else: | |
| 1247 return default | |
| 1248 | |
| 1249 # don't pass our list to other code | |
| 1250 if isinstance(prop, Multilink): | |
| 1251 return d[propname][:] | |
| 1252 | |
| 1253 return d[propname] | |
| 1254 | |
| 1255 def getnode(self, nodeid, cache=1): | |
| 1256 ''' Return a convenience wrapper for the node. | |
| 1257 | |
| 1258 'nodeid' must be the id of an existing node of this class or an | |
| 1259 IndexError is raised. | |
| 1260 | |
| 1261 'cache' indicates whether the transaction cache should be queried | |
| 1262 for the node. If the node has been modified and you need to | |
| 1263 determine what its values prior to modification are, you need to | |
| 1264 set cache=0. | |
| 1265 ''' | |
| 1266 return Node(self, nodeid, cache=cache) | |
| 1267 | |
| 1268 def set(self, nodeid, **propvalues): | |
| 1269 '''Modify a property on an existing node of this class. | |
| 1270 | |
| 1271 'nodeid' must be the id of an existing node of this class or an | |
| 1272 IndexError is raised. | |
| 1273 | |
| 1274 Each key in 'propvalues' must be the name of a property of this | |
| 1275 class or a KeyError is raised. | |
| 1276 | |
| 1277 All values in 'propvalues' must be acceptable types for their | |
| 1278 corresponding properties or a TypeError is raised. | |
| 1279 | |
| 1280 If the value of the key property is set, it must not collide with | |
| 1281 other key strings or a ValueError is raised. | |
| 1282 | |
| 1283 If the value of a Link or Multilink property contains an invalid | |
| 1284 node id, a ValueError is raised. | |
| 1285 ''' | |
| 1286 if not propvalues: | |
| 1287 return propvalues | |
| 1288 | |
| 1289 if propvalues.has_key('creation') or propvalues.has_key('activity'): | |
| 1290 raise KeyError, '"creation" and "activity" are reserved' | |
| 1291 | |
| 1292 if propvalues.has_key('id'): | |
| 1293 raise KeyError, '"id" is reserved' | |
| 1294 | |
| 1295 if self.db.journaltag is None: | |
| 1296 raise DatabaseError, 'Database open read-only' | |
| 1297 | |
| 1298 self.fireAuditors('set', nodeid, propvalues) | |
| 1299 # Take a copy of the node dict so that the subsequent set | |
| 1300 # operation doesn't modify the oldvalues structure. | |
| 1301 # XXX used to try the cache here first | |
| 1302 oldvalues = copy.deepcopy(self.db.getnode(self.classname, nodeid)) | |
| 1303 | |
| 1304 node = self.db.getnode(self.classname, nodeid) | |
| 1305 if self.is_retired(nodeid): | |
| 1306 raise IndexError, 'Requested item is retired' | |
| 1307 num_re = re.compile('^\d+$') | |
| 1308 | |
| 1309 # if the journal value is to be different, store it in here | |
| 1310 journalvalues = {} | |
| 1311 | |
| 1312 # remember the add/remove stuff for multilinks, making it easier | |
| 1313 # for the Database layer to do its stuff | |
| 1314 multilink_changes = {} | |
| 1315 | |
| 1316 for propname, value in propvalues.items(): | |
| 1317 # check to make sure we're not duplicating an existing key | |
| 1318 if propname == self.key and node[propname] != value: | |
| 1319 try: | |
| 1320 self.lookup(value) | |
| 1321 except KeyError: | |
| 1322 pass | |
| 1323 else: | |
| 1324 raise ValueError, 'node with key "%s" exists'%value | |
| 1325 | |
| 1326 # this will raise the KeyError if the property isn't valid | |
| 1327 # ... we don't use getprops() here because we only care about | |
| 1328 # the writeable properties. | |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1329 try: |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1330 prop = self.properties[propname] |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1331 except KeyError: |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1332 raise KeyError, '"%s" has no property named "%s"'%( |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1333 self.classname, propname) |
| 1165 | 1334 |
| 1335 # if the value's the same as the existing value, no sense in | |
| 1336 # doing anything | |
|
1304
61ad556cfc8d
working toward 0.5.2 release
Richard Jones <richard@users.sourceforge.net>
parents:
1295
diff
changeset
|
1337 current = node.get(propname, None) |
|
61ad556cfc8d
working toward 0.5.2 release
Richard Jones <richard@users.sourceforge.net>
parents:
1295
diff
changeset
|
1338 if value == current: |
| 1165 | 1339 del propvalues[propname] |
| 1340 continue | |
|
1304
61ad556cfc8d
working toward 0.5.2 release
Richard Jones <richard@users.sourceforge.net>
parents:
1295
diff
changeset
|
1341 journalvalues[propname] = current |
| 1165 | 1342 |
| 1343 # do stuff based on the prop type | |
| 1344 if isinstance(prop, Link): | |
| 1345 link_class = prop.classname | |
| 1346 # if it isn't a number, it's a key | |
| 1347 if value is not None and not isinstance(value, type('')): | |
| 1348 raise ValueError, 'property "%s" link value be a string'%( | |
| 1349 propname) | |
| 1350 if isinstance(value, type('')) and not num_re.match(value): | |
| 1351 try: | |
| 1352 value = self.db.classes[link_class].lookup(value) | |
| 1353 except (TypeError, KeyError): | |
| 1354 raise IndexError, 'new property "%s": %s not a %s'%( | |
| 1355 propname, value, prop.classname) | |
| 1356 | |
| 1357 if (value is not None and | |
| 1358 not self.db.getclass(link_class).hasnode(value)): | |
| 1359 raise IndexError, '%s has no node %s'%(link_class, value) | |
| 1360 | |
| 1361 if self.do_journal and prop.do_journal: | |
| 1362 # register the unlink with the old linked node | |
| 1363 if node[propname] is not None: | |
| 1364 self.db.addjournal(link_class, node[propname], 'unlink', | |
| 1365 (self.classname, nodeid, propname)) | |
| 1366 | |
| 1367 # register the link with the newly linked node | |
| 1368 if value is not None: | |
| 1369 self.db.addjournal(link_class, value, 'link', | |
| 1370 (self.classname, nodeid, propname)) | |
| 1371 | |
| 1372 elif isinstance(prop, Multilink): | |
| 1373 if type(value) != type([]): | |
| 1374 raise TypeError, 'new property "%s" not a list of'\ | |
| 1375 ' ids'%propname | |
| 1376 link_class = self.properties[propname].classname | |
| 1377 l = [] | |
| 1378 for entry in value: | |
| 1379 # if it isn't a number, it's a key | |
| 1380 if type(entry) != type(''): | |
| 1381 raise ValueError, 'new property "%s" link value ' \ | |
| 1382 'must be a string'%propname | |
| 1383 if not num_re.match(entry): | |
| 1384 try: | |
| 1385 entry = self.db.classes[link_class].lookup(entry) | |
| 1386 except (TypeError, KeyError): | |
| 1387 raise IndexError, 'new property "%s": %s not a %s'%( | |
| 1388 propname, entry, | |
| 1389 self.properties[propname].classname) | |
| 1390 l.append(entry) | |
| 1391 value = l | |
| 1392 propvalues[propname] = value | |
| 1393 | |
| 1394 # figure the journal entry for this property | |
| 1395 add = [] | |
| 1396 remove = [] | |
| 1397 | |
| 1398 # handle removals | |
| 1399 if node.has_key(propname): | |
| 1400 l = node[propname] | |
| 1401 else: | |
| 1402 l = [] | |
| 1403 for id in l[:]: | |
| 1404 if id in value: | |
| 1405 continue | |
| 1406 # register the unlink with the old linked node | |
| 1407 if self.do_journal and self.properties[propname].do_journal: | |
| 1408 self.db.addjournal(link_class, id, 'unlink', | |
| 1409 (self.classname, nodeid, propname)) | |
| 1410 l.remove(id) | |
| 1411 remove.append(id) | |
| 1412 | |
| 1413 # handle additions | |
| 1414 for id in value: | |
| 1415 if not self.db.getclass(link_class).hasnode(id): | |
| 1416 raise IndexError, '%s has no node %s'%(link_class, id) | |
| 1417 if id in l: | |
| 1418 continue | |
| 1419 # register the link with the newly linked node | |
| 1420 if self.do_journal and self.properties[propname].do_journal: | |
| 1421 self.db.addjournal(link_class, id, 'link', | |
| 1422 (self.classname, nodeid, propname)) | |
| 1423 l.append(id) | |
| 1424 add.append(id) | |
| 1425 | |
| 1426 # figure the journal entry | |
| 1427 l = [] | |
| 1428 if add: | |
| 1429 l.append(('+', add)) | |
| 1430 if remove: | |
| 1431 l.append(('-', remove)) | |
| 1432 multilink_changes[propname] = (add, remove) | |
| 1433 if l: | |
| 1434 journalvalues[propname] = tuple(l) | |
| 1435 | |
| 1436 elif isinstance(prop, String): | |
|
1383
f19dde90e473
applied unicode patch
Andrey Lebedev <kedder@users.sourceforge.net>
parents:
1365
diff
changeset
|
1437 if value is not None and type(value) != type('') and type(value) != type(u''): |
| 1165 | 1438 raise TypeError, 'new property "%s" not a string'%propname |
| 1439 | |
| 1440 elif isinstance(prop, Password): | |
| 1441 if not isinstance(value, password.Password): | |
| 1442 raise TypeError, 'new property "%s" not a Password'%propname | |
| 1443 propvalues[propname] = value | |
| 1444 | |
| 1445 elif value is not None and isinstance(prop, Date): | |
| 1446 if not isinstance(value, date.Date): | |
| 1447 raise TypeError, 'new property "%s" not a Date'% propname | |
| 1448 propvalues[propname] = value | |
| 1449 | |
| 1450 elif value is not None and isinstance(prop, Interval): | |
| 1451 if not isinstance(value, date.Interval): | |
| 1452 raise TypeError, 'new property "%s" not an '\ | |
| 1453 'Interval'%propname | |
| 1454 propvalues[propname] = value | |
| 1455 | |
| 1456 elif value is not None and isinstance(prop, Number): | |
| 1457 try: | |
| 1458 float(value) | |
| 1459 except ValueError: | |
| 1460 raise TypeError, 'new property "%s" not numeric'%propname | |
| 1461 | |
| 1462 elif value is not None and isinstance(prop, Boolean): | |
| 1463 try: | |
| 1464 int(value) | |
| 1465 except ValueError: | |
| 1466 raise TypeError, 'new property "%s" not boolean'%propname | |
| 1467 | |
| 1468 # nothing to do? | |
| 1469 if not propvalues: | |
| 1470 return propvalues | |
| 1471 | |
| 1472 # do the set, and journal it | |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1473 self.db.setnode(self.classname, nodeid, propvalues, multilink_changes) |
| 1165 | 1474 |
| 1475 if self.do_journal: | |
|
1304
61ad556cfc8d
working toward 0.5.2 release
Richard Jones <richard@users.sourceforge.net>
parents:
1295
diff
changeset
|
1476 self.db.addjournal(self.classname, nodeid, 'set', journalvalues) |
| 1165 | 1477 |
| 1478 self.fireReactors('set', nodeid, oldvalues) | |
| 1479 | |
| 1480 return propvalues | |
| 1481 | |
| 1482 def retire(self, nodeid): | |
| 1483 '''Retire a node. | |
| 1484 | |
| 1485 The properties on the node remain available from the get() method, | |
| 1486 and the node's id is never reused. | |
| 1487 | |
| 1488 Retired nodes are not returned by the find(), list(), or lookup() | |
| 1489 methods, and other nodes may reuse the values of their key properties. | |
| 1490 ''' | |
| 1491 if self.db.journaltag is None: | |
| 1492 raise DatabaseError, 'Database open read-only' | |
| 1493 | |
|
1345
618aa9c37d65
fire auditors and reactors in rdbms retire (thanks Sheila King)
Richard Jones <richard@users.sourceforge.net>
parents:
1333
diff
changeset
|
1494 self.fireAuditors('retire', nodeid, None) |
|
618aa9c37d65
fire auditors and reactors in rdbms retire (thanks Sheila King)
Richard Jones <richard@users.sourceforge.net>
parents:
1333
diff
changeset
|
1495 |
|
1222
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1496 # use the arg for __retired__ to cope with any odd database type |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1497 # conversion (hello, sqlite) |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1498 sql = 'update _%s set __retired__=%s where id=%s'%(self.classname, |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1499 self.db.arg, self.db.arg) |
| 1165 | 1500 if __debug__: |
| 1501 print >>hyperdb.DEBUG, 'retire', (self, sql, nodeid) | |
|
1222
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1502 self.db.cursor.execute(sql, (1, nodeid)) |
| 1165 | 1503 |
|
1345
618aa9c37d65
fire auditors and reactors in rdbms retire (thanks Sheila King)
Richard Jones <richard@users.sourceforge.net>
parents:
1333
diff
changeset
|
1504 self.fireReactors('retire', nodeid, None) |
|
618aa9c37d65
fire auditors and reactors in rdbms retire (thanks Sheila King)
Richard Jones <richard@users.sourceforge.net>
parents:
1333
diff
changeset
|
1505 |
| 1165 | 1506 def is_retired(self, nodeid): |
| 1507 '''Return true if the node is rerired | |
| 1508 ''' | |
| 1509 sql = 'select __retired__ from _%s where id=%s'%(self.classname, | |
| 1510 self.db.arg) | |
| 1511 if __debug__: | |
| 1512 print >>hyperdb.DEBUG, 'is_retired', (self, sql, nodeid) | |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
1513 self.db.cursor.execute(sql, (nodeid,)) |
|
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
1514 return int(self.db.sql_fetchone()[0]) |
| 1165 | 1515 |
| 1516 def destroy(self, nodeid): | |
| 1517 '''Destroy a node. | |
| 1518 | |
| 1519 WARNING: this method should never be used except in extremely rare | |
| 1520 situations where there could never be links to the node being | |
| 1521 deleted | |
| 1522 WARNING: use retire() instead | |
| 1523 WARNING: the properties of this node will not be available ever again | |
| 1524 WARNING: really, use retire() instead | |
| 1525 | |
| 1526 Well, I think that's enough warnings. This method exists mostly to | |
| 1527 support the session storage of the cgi interface. | |
| 1528 | |
| 1529 The node is completely removed from the hyperdb, including all journal | |
| 1530 entries. It will no longer be available, and will generally break code | |
| 1531 if there are any references to the node. | |
| 1532 ''' | |
| 1533 if self.db.journaltag is None: | |
| 1534 raise DatabaseError, 'Database open read-only' | |
| 1535 self.db.destroynode(self.classname, nodeid) | |
| 1536 | |
| 1537 def history(self, nodeid): | |
| 1538 '''Retrieve the journal of edits on a particular node. | |
| 1539 | |
| 1540 'nodeid' must be the id of an existing node of this class or an | |
| 1541 IndexError is raised. | |
| 1542 | |
| 1543 The returned list contains tuples of the form | |
| 1544 | |
|
1409
8dc60d87ab42
Fixed a backlog of bug reports, and worked on python 2.3 compatibility:
Richard Jones <richard@users.sourceforge.net>
parents:
1383
diff
changeset
|
1545 (nodeid, date, tag, action, params) |
| 1165 | 1546 |
| 1547 'date' is a Timestamp object specifying the time of the change and | |
| 1548 'tag' is the journaltag specified when the database was opened. | |
| 1549 ''' | |
| 1550 if not self.do_journal: | |
| 1551 raise ValueError, 'Journalling is disabled for this class' | |
| 1552 return self.db.getjournal(self.classname, nodeid) | |
| 1553 | |
| 1554 # Locating nodes: | |
| 1555 def hasnode(self, nodeid): | |
| 1556 '''Determine if the given nodeid actually exists | |
| 1557 ''' | |
| 1558 return self.db.hasnode(self.classname, nodeid) | |
| 1559 | |
| 1560 def setkey(self, propname): | |
| 1561 '''Select a String property of this class to be the key property. | |
| 1562 | |
| 1563 'propname' must be the name of a String property of this class or | |
| 1564 None, or a TypeError is raised. The values of the key property on | |
| 1565 all existing nodes must be unique or a ValueError is raised. | |
| 1566 ''' | |
| 1567 # XXX create an index on the key prop column | |
| 1568 prop = self.getprops()[propname] | |
| 1569 if not isinstance(prop, String): | |
| 1570 raise TypeError, 'key properties must be String' | |
| 1571 self.key = propname | |
| 1572 | |
| 1573 def getkey(self): | |
| 1574 '''Return the name of the key property for this class or None.''' | |
| 1575 return self.key | |
| 1576 | |
| 1577 def labelprop(self, default_to_id=0): | |
| 1578 ''' Return the property name for a label for the given node. | |
| 1579 | |
| 1580 This method attempts to generate a consistent label for the node. | |
| 1581 It tries the following in order: | |
| 1582 1. key property | |
| 1583 2. "name" property | |
| 1584 3. "title" property | |
| 1585 4. first property from the sorted property name list | |
| 1586 ''' | |
| 1587 k = self.getkey() | |
| 1588 if k: | |
| 1589 return k | |
| 1590 props = self.getprops() | |
| 1591 if props.has_key('name'): | |
| 1592 return 'name' | |
| 1593 elif props.has_key('title'): | |
| 1594 return 'title' | |
| 1595 if default_to_id: | |
| 1596 return 'id' | |
| 1597 props = props.keys() | |
| 1598 props.sort() | |
| 1599 return props[0] | |
| 1600 | |
| 1601 def lookup(self, keyvalue): | |
| 1602 '''Locate a particular node by its key property and return its id. | |
| 1603 | |
| 1604 If this class has no key property, a TypeError is raised. If the | |
| 1605 'keyvalue' matches one of the values for the key property among | |
| 1606 the nodes in this class, the matching node's id is returned; | |
| 1607 otherwise a KeyError is raised. | |
| 1608 ''' | |
| 1609 if not self.key: | |
| 1610 raise TypeError, 'No key property set for class %s'%self.classname | |
| 1611 | |
|
1222
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1612 # use the arg to handle any odd database type conversion (hello, |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1613 # sqlite) |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1614 sql = "select id from _%s where _%s=%s and __retired__ <> %s"%( |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1615 self.classname, self.key, self.db.arg, self.db.arg) |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1616 self.db.sql(sql, (keyvalue, 1)) |
| 1165 | 1617 |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1618 # see if there was a result that's not retired |
|
1203
735adcbfc665
fix to SQL lookup() and retirement
Richard Jones <richard@users.sourceforge.net>
parents:
1195
diff
changeset
|
1619 row = self.db.sql_fetchone() |
|
735adcbfc665
fix to SQL lookup() and retirement
Richard Jones <richard@users.sourceforge.net>
parents:
1195
diff
changeset
|
1620 if not row: |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1621 raise KeyError, 'No key (%s) value "%s" for "%s"'%(self.key, |
|
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1622 keyvalue, self.classname) |
| 1165 | 1623 |
| 1624 # return the id | |
|
1203
735adcbfc665
fix to SQL lookup() and retirement
Richard Jones <richard@users.sourceforge.net>
parents:
1195
diff
changeset
|
1625 return row[0] |
| 1165 | 1626 |
| 1627 def find(self, **propspec): | |
| 1628 '''Get the ids of nodes in this class which link to the given nodes. | |
| 1629 | |
|
1222
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1630 'propspec' consists of keyword args propname=nodeid or |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1631 propname={nodeid:1, } |
| 1165 | 1632 'propname' must be the name of a property in this class, or a |
| 1633 KeyError is raised. That property must be a Link or Multilink | |
| 1634 property, or a TypeError is raised. | |
| 1635 | |
| 1636 Any node in this class whose 'propname' property links to any of the | |
| 1637 nodeids will be returned. Used by the full text indexing, which knows | |
| 1638 that "foo" occurs in msg1, msg3 and file7, so we have hits on these | |
| 1639 issues: | |
| 1640 | |
| 1641 db.issue.find(messages={'1':1,'3':1}, files={'7':1}) | |
| 1642 ''' | |
| 1643 if __debug__: | |
| 1644 print >>hyperdb.DEBUG, 'find', (self, propspec) | |
|
1222
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1645 |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1646 # shortcut |
| 1165 | 1647 if not propspec: |
| 1648 return [] | |
|
1222
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1649 |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1650 # validate the args |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1651 props = self.getprops() |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1652 propspec = propspec.items() |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1653 for propname, nodeids in propspec: |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1654 # check the prop is OK |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1655 prop = props[propname] |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1656 if not isinstance(prop, Link) and not isinstance(prop, Multilink): |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1657 raise TypeError, "'%s' not a Link/Multilink property"%propname |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1658 |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1659 # first, links |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1660 where = [] |
| 1165 | 1661 allvalues = () |
|
1222
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1662 a = self.db.arg |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1663 for prop, values in propspec: |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1664 if not isinstance(props[prop], hyperdb.Link): |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1665 continue |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1666 if type(values) is type(''): |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1667 allvalues += (values,) |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1668 where.append('_%s = %s'%(prop, a)) |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1669 else: |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1670 allvalues += tuple(values.keys()) |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1671 where.append('_%s in (%s)'%(prop, ','.join([a]*len(values)))) |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1672 tables = [] |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1673 if where: |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1674 tables.append('select id as nodeid from _%s where %s'%( |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1675 self.classname, ' and '.join(where))) |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1676 |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1677 # now multilinks |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1678 for prop, values in propspec: |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1679 if not isinstance(props[prop], hyperdb.Multilink): |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1680 continue |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1681 if type(values) is type(''): |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1682 allvalues += (values,) |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1683 s = a |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1684 else: |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1685 allvalues += tuple(values.keys()) |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1686 s = ','.join([a]*len(values)) |
| 1165 | 1687 tables.append('select nodeid from %s_%s where linkid in (%s)'%( |
|
1222
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1688 self.classname, prop, s)) |
|
bc3bc3248dd1
added Class.find() unit test, fixed implementations
Richard Jones <richard@users.sourceforge.net>
parents:
1212
diff
changeset
|
1689 sql = '\nunion\n'.join(tables) |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
1690 self.db.sql(sql, allvalues) |
|
1195
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1691 l = [x[0] for x in self.db.sql_fetchall()] |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1692 if __debug__: |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1693 print >>hyperdb.DEBUG, 'find ... ', l |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1694 return l |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1695 |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1696 def stringFind(self, **requirements): |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1697 '''Locate a particular node by matching a set of its String |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1698 properties in a caseless search. |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1699 |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1700 If the property is not a String property, a TypeError is raised. |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1701 |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1702 The return is a list of the id of all nodes that match. |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1703 ''' |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1704 where = [] |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1705 args = [] |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1706 for propname in requirements.keys(): |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1707 prop = self.properties[propname] |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1708 if isinstance(not prop, String): |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1709 raise TypeError, "'%s' not a String property"%propname |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1710 where.append(propname) |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1711 args.append(requirements[propname].lower()) |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1712 |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1713 # generate the where clause |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1714 s = ' and '.join(['_%s=%s'%(col, self.db.arg) for col in where]) |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1715 sql = 'select id from _%s where %s'%(self.classname, s) |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1716 self.db.sql(sql, tuple(args)) |
|
e0032f4ab334
added missing stringFind to sql backends
Richard Jones <richard@users.sourceforge.net>
parents:
1189
diff
changeset
|
1717 l = [x[0] for x in self.db.sql_fetchall()] |
| 1165 | 1718 if __debug__: |
| 1719 print >>hyperdb.DEBUG, 'find ... ', l | |
| 1720 return l | |
| 1721 | |
| 1722 def list(self): | |
| 1723 ''' Return a list of the ids of the active nodes in this class. | |
| 1724 ''' | |
| 1725 return self.db.getnodeids(self.classname, retired=0) | |
| 1726 | |
|
1249
6c24a86a12ae
Fixes for SourceForge tracker bugs.
Richard Jones <richard@users.sourceforge.net>
parents:
1244
diff
changeset
|
1727 def filter(self, search_matches, filterspec, sort=(None,None), |
|
6c24a86a12ae
Fixes for SourceForge tracker bugs.
Richard Jones <richard@users.sourceforge.net>
parents:
1244
diff
changeset
|
1728 group=(None,None)): |
| 1165 | 1729 ''' Return a list of the ids of the active nodes in this class that |
| 1730 match the 'filter' spec, sorted by the group spec and then the | |
| 1731 sort spec | |
| 1732 | |
| 1733 "filterspec" is {propname: value(s)} | |
| 1734 "sort" and "group" are (dir, prop) where dir is '+', '-' or None | |
| 1735 and prop is a prop name or None | |
| 1736 "search_matches" is {nodeid: marker} | |
|
1170
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1737 |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1738 The filter must match all properties specificed - but if the |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1739 property value to match is a list, any one of the values in the |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1740 list may match for that property to match. |
| 1165 | 1741 ''' |
|
1205
0df08772f166
fix to SQL filtering
Richard Jones <richard@users.sourceforge.net>
parents:
1203
diff
changeset
|
1742 # just don't bother if the full-text search matched diddly |
|
0df08772f166
fix to SQL filtering
Richard Jones <richard@users.sourceforge.net>
parents:
1203
diff
changeset
|
1743 if search_matches == {}: |
|
0df08772f166
fix to SQL filtering
Richard Jones <richard@users.sourceforge.net>
parents:
1203
diff
changeset
|
1744 return [] |
|
0df08772f166
fix to SQL filtering
Richard Jones <richard@users.sourceforge.net>
parents:
1203
diff
changeset
|
1745 |
| 1165 | 1746 cn = self.classname |
| 1747 | |
| 1748 # figure the WHERE clause from the filterspec | |
| 1749 props = self.getprops() | |
| 1750 frum = ['_'+cn] | |
| 1751 where = [] | |
| 1752 args = [] | |
|
1168
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
1753 a = self.db.arg |
| 1165 | 1754 for k, v in filterspec.items(): |
| 1755 propclass = props[k] | |
|
1170
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1756 # now do other where clause stuff |
| 1165 | 1757 if isinstance(propclass, Multilink): |
| 1758 tn = '%s_%s'%(cn, k) | |
| 1759 frum.append(tn) | |
| 1760 if isinstance(v, type([])): | |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1761 s = ','.join([a for x in v]) |
| 1165 | 1762 where.append('id=%s.nodeid and %s.linkid in (%s)'%(tn,tn,s)) |
| 1763 args = args + v | |
| 1764 else: | |
|
1170
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1765 where.append('id=%s.nodeid and %s.linkid = %s'%(tn, tn, a)) |
| 1165 | 1766 args.append(v) |
|
1365
4884fb0860f9
fixed rdbms searching by ID [SF#666615]
Richard Jones <richard@users.sourceforge.net>
parents:
1351
diff
changeset
|
1767 elif k == 'id': |
|
4884fb0860f9
fixed rdbms searching by ID [SF#666615]
Richard Jones <richard@users.sourceforge.net>
parents:
1351
diff
changeset
|
1768 if isinstance(v, type([])): |
|
4884fb0860f9
fixed rdbms searching by ID [SF#666615]
Richard Jones <richard@users.sourceforge.net>
parents:
1351
diff
changeset
|
1769 s = ','.join([a for x in v]) |
|
4884fb0860f9
fixed rdbms searching by ID [SF#666615]
Richard Jones <richard@users.sourceforge.net>
parents:
1351
diff
changeset
|
1770 where.append('%s in (%s)'%(k, s)) |
|
4884fb0860f9
fixed rdbms searching by ID [SF#666615]
Richard Jones <richard@users.sourceforge.net>
parents:
1351
diff
changeset
|
1771 args = args + v |
|
4884fb0860f9
fixed rdbms searching by ID [SF#666615]
Richard Jones <richard@users.sourceforge.net>
parents:
1351
diff
changeset
|
1772 else: |
|
4884fb0860f9
fixed rdbms searching by ID [SF#666615]
Richard Jones <richard@users.sourceforge.net>
parents:
1351
diff
changeset
|
1773 where.append('%s=%s'%(k, a)) |
|
4884fb0860f9
fixed rdbms searching by ID [SF#666615]
Richard Jones <richard@users.sourceforge.net>
parents:
1351
diff
changeset
|
1774 args.append(v) |
|
1170
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1775 elif isinstance(propclass, String): |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1776 if not isinstance(v, type([])): |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1777 v = [v] |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1778 |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1779 # Quote the bits in the string that need it and then embed |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1780 # in a "substring" search. Note - need to quote the '%' so |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1781 # they make it through the python layer happily |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1782 v = ['%%'+self.db.sql_stringquote(s)+'%%' for s in v] |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1783 |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1784 # now add to the where clause |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1785 where.append(' or '.join(["_%s LIKE '%s'"%(k, s) for s in v])) |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1786 # note: args are embedded in the query string now |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1787 elif isinstance(propclass, Link): |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1788 if isinstance(v, type([])): |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1789 if '-1' in v: |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1790 v.remove('-1') |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1791 xtra = ' or _%s is NULL'%k |
|
1173
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
1792 else: |
|
58f1a2c174ed
simple LRU cache for SQL databases
Richard Jones <richard@users.sourceforge.net>
parents:
1172
diff
changeset
|
1793 xtra = '' |
|
1295
9c3459cb8ab6
work-around for sqlite bug
Richard Jones <richard@users.sourceforge.net>
parents:
1252
diff
changeset
|
1794 if v: |
|
9c3459cb8ab6
work-around for sqlite bug
Richard Jones <richard@users.sourceforge.net>
parents:
1252
diff
changeset
|
1795 s = ','.join([a for x in v]) |
|
9c3459cb8ab6
work-around for sqlite bug
Richard Jones <richard@users.sourceforge.net>
parents:
1252
diff
changeset
|
1796 where.append('(_%s in (%s)%s)'%(k, s, xtra)) |
|
9c3459cb8ab6
work-around for sqlite bug
Richard Jones <richard@users.sourceforge.net>
parents:
1252
diff
changeset
|
1797 args = args + v |
|
9c3459cb8ab6
work-around for sqlite bug
Richard Jones <richard@users.sourceforge.net>
parents:
1252
diff
changeset
|
1798 else: |
|
9c3459cb8ab6
work-around for sqlite bug
Richard Jones <richard@users.sourceforge.net>
parents:
1252
diff
changeset
|
1799 where.append('_%s is NULL'%k) |
|
1170
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1800 else: |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1801 if v == '-1': |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1802 v = None |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1803 where.append('_%s is NULL'%k) |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1804 else: |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1805 where.append('_%s=%s'%(k, a)) |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1806 args.append(v) |
|
1351
d1bfb479e527
fixed searching on date / interval fields [SF#658157]
Richard Jones <richard@users.sourceforge.net>
parents:
1345
diff
changeset
|
1807 elif isinstance(propclass, Date): |
|
d1bfb479e527
fixed searching on date / interval fields [SF#658157]
Richard Jones <richard@users.sourceforge.net>
parents:
1345
diff
changeset
|
1808 if isinstance(v, type([])): |
|
d1bfb479e527
fixed searching on date / interval fields [SF#658157]
Richard Jones <richard@users.sourceforge.net>
parents:
1345
diff
changeset
|
1809 s = ','.join([a for x in v]) |
|
d1bfb479e527
fixed searching on date / interval fields [SF#658157]
Richard Jones <richard@users.sourceforge.net>
parents:
1345
diff
changeset
|
1810 where.append('_%s in (%s)'%(k, s)) |
|
d1bfb479e527
fixed searching on date / interval fields [SF#658157]
Richard Jones <richard@users.sourceforge.net>
parents:
1345
diff
changeset
|
1811 args = args + [date.Date(x).serialise() for x in v] |
|
d1bfb479e527
fixed searching on date / interval fields [SF#658157]
Richard Jones <richard@users.sourceforge.net>
parents:
1345
diff
changeset
|
1812 else: |
|
d1bfb479e527
fixed searching on date / interval fields [SF#658157]
Richard Jones <richard@users.sourceforge.net>
parents:
1345
diff
changeset
|
1813 where.append('_%s=%s'%(k, a)) |
|
d1bfb479e527
fixed searching on date / interval fields [SF#658157]
Richard Jones <richard@users.sourceforge.net>
parents:
1345
diff
changeset
|
1814 args.append(date.Date(v).serialise()) |
|
d1bfb479e527
fixed searching on date / interval fields [SF#658157]
Richard Jones <richard@users.sourceforge.net>
parents:
1345
diff
changeset
|
1815 elif isinstance(propclass, Interval): |
|
d1bfb479e527
fixed searching on date / interval fields [SF#658157]
Richard Jones <richard@users.sourceforge.net>
parents:
1345
diff
changeset
|
1816 if isinstance(v, type([])): |
|
d1bfb479e527
fixed searching on date / interval fields [SF#658157]
Richard Jones <richard@users.sourceforge.net>
parents:
1345
diff
changeset
|
1817 s = ','.join([a for x in v]) |
|
d1bfb479e527
fixed searching on date / interval fields [SF#658157]
Richard Jones <richard@users.sourceforge.net>
parents:
1345
diff
changeset
|
1818 where.append('_%s in (%s)'%(k, s)) |
|
d1bfb479e527
fixed searching on date / interval fields [SF#658157]
Richard Jones <richard@users.sourceforge.net>
parents:
1345
diff
changeset
|
1819 args = args + [date.Interval(x).serialise() for x in v] |
|
d1bfb479e527
fixed searching on date / interval fields [SF#658157]
Richard Jones <richard@users.sourceforge.net>
parents:
1345
diff
changeset
|
1820 else: |
|
d1bfb479e527
fixed searching on date / interval fields [SF#658157]
Richard Jones <richard@users.sourceforge.net>
parents:
1345
diff
changeset
|
1821 where.append('_%s=%s'%(k, a)) |
|
d1bfb479e527
fixed searching on date / interval fields [SF#658157]
Richard Jones <richard@users.sourceforge.net>
parents:
1345
diff
changeset
|
1822 args.append(date.Interval(v).serialise()) |
| 1165 | 1823 else: |
| 1824 if isinstance(v, type([])): | |
|
1168
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
1825 s = ','.join([a for x in v]) |
| 1165 | 1826 where.append('_%s in (%s)'%(k, s)) |
| 1827 args = args + v | |
| 1828 else: | |
|
1168
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
1829 where.append('_%s=%s'%(k, a)) |
| 1165 | 1830 args.append(v) |
| 1831 | |
| 1832 # add results of full text search | |
| 1833 if search_matches is not None: | |
| 1834 v = search_matches.keys() | |
|
1168
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
1835 s = ','.join([a for x in v]) |
| 1165 | 1836 where.append('id in (%s)'%s) |
| 1837 args = args + v | |
| 1838 | |
|
1170
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1839 # "grouping" is just the first-order sorting in the SQL fetch |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1840 # can modify it...) |
| 1165 | 1841 orderby = [] |
| 1842 ordercols = [] | |
|
1170
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1843 if group[0] is not None and group[1] is not None: |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1844 if group[0] != '-': |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1845 orderby.append('_'+group[1]) |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1846 ordercols.append('_'+group[1]) |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1847 else: |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1848 orderby.append('_'+group[1]+' desc') |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1849 ordercols.append('_'+group[1]) |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1850 |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1851 # now add in the sorting |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1852 group = '' |
| 1165 | 1853 if sort[0] is not None and sort[1] is not None: |
|
1168
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
1854 direction, colname = sort |
|
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
1855 if direction != '-': |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1856 if colname == 'id': |
|
1170
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1857 orderby.append(colname) |
|
1168
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
1858 else: |
|
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
1859 orderby.append('_'+colname) |
|
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
1860 ordercols.append('_'+colname) |
| 1165 | 1861 else: |
|
1174
8e318dfaf479
Verify contents of tracker module when the tracker is opened
Richard Jones <richard@users.sourceforge.net>
parents:
1173
diff
changeset
|
1862 if colname == 'id': |
|
1170
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1863 orderby.append(colname+' desc') |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1864 ordercols.append(colname) |
|
1168
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
1865 else: |
|
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
1866 orderby.append('_'+colname+' desc') |
|
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
1867 ordercols.append('_'+colname) |
| 1165 | 1868 |
| 1869 # construct the SQL | |
| 1870 frum = ','.join(frum) | |
|
1170
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1871 if where: |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1872 where = ' where ' + (' and '.join(where)) |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1873 else: |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1874 where = '' |
| 1165 | 1875 cols = ['id'] |
| 1876 if orderby: | |
| 1877 cols = cols + ordercols | |
| 1878 order = ' order by %s'%(','.join(orderby)) | |
| 1879 else: | |
| 1880 order = '' | |
| 1881 cols = ','.join(cols) | |
|
1170
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1882 sql = 'select %s from %s %s%s%s'%(cols, frum, where, group, order) |
| 1165 | 1883 args = tuple(args) |
| 1884 if __debug__: | |
|
1168
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
1885 print >>hyperdb.DEBUG, 'filter', (self, sql, args) |
|
1183
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
1886 self.db.cursor.execute(sql, args) |
|
08a13a84ed43
Some speedups - both of the SQL backends can handle using only one cursor.
Richard Jones <richard@users.sourceforge.net>
parents:
1181
diff
changeset
|
1887 l = self.db.cursor.fetchall() |
| 1165 | 1888 |
|
1170
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1889 # return the IDs (the first column) |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1890 # XXX The filter(None, l) bit is sqlite-specific... if there's _NO_ |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1891 # XXX matches to a fetch, it returns NULL instead of nothing!?! |
|
af104fa52746
Added some words to the installation doc about choosing backends.
Richard Jones <richard@users.sourceforge.net>
parents:
1168
diff
changeset
|
1892 return filter(None, [row[0] for row in l]) |
|
1168
94620e088e3a
fixes to the rdbms backends
Richard Jones <richard@users.sourceforge.net>
parents:
1165
diff
changeset
|
1893 |
| 1165 | 1894 def count(self): |
| 1895 '''Get the number of nodes in this class. | |
| 1896 | |
| 1897 If the returned integer is 'numnodes', the ids of all the nodes | |
| 1898 in this class run from 1 to numnodes, and numnodes+1 will be the | |
| 1899 id of the next node to be created in this class. | |
| 1900 ''' | |
| 1901 return self.db.countnodes(self.classname) | |
| 1902 | |
| 1903 # Manipulating properties: | |
| 1904 def getprops(self, protected=1): | |
| 1905 '''Return a dictionary mapping property names to property objects. | |
| 1906 If the "protected" flag is true, we include protected properties - | |
| 1907 those which may not be modified. | |
| 1908 ''' | |
| 1909 d = self.properties.copy() | |
| 1910 if protected: | |
| 1911 d['id'] = String() | |
| 1912 d['creation'] = hyperdb.Date() | |
| 1913 d['activity'] = hyperdb.Date() | |
|
1176
bd3b57859c37
On second thought, that last checkin was dumb.
Richard Jones <richard@users.sourceforge.net>
parents:
1175
diff
changeset
|
1914 d['creator'] = hyperdb.Link('user') |
| 1165 | 1915 return d |
| 1916 | |
| 1917 def addprop(self, **properties): | |
| 1918 '''Add properties to this class. | |
| 1919 | |
| 1920 The keyword arguments in 'properties' must map names to property | |
| 1921 objects, or a TypeError is raised. None of the keys in 'properties' | |
| 1922 may collide with the names of existing properties, or a ValueError | |
| 1923 is raised before any properties have been added. | |
| 1924 ''' | |
| 1925 for key in properties.keys(): | |
| 1926 if self.properties.has_key(key): | |
| 1927 raise ValueError, key | |
| 1928 self.properties.update(properties) | |
| 1929 | |
| 1930 def index(self, nodeid): | |
| 1931 '''Add (or refresh) the node to search indexes | |
| 1932 ''' | |
| 1933 # find all the String properties that have indexme | |
| 1934 for prop, propclass in self.getprops().items(): | |
| 1935 if isinstance(propclass, String) and propclass.indexme: | |
| 1936 try: | |
| 1937 value = str(self.get(nodeid, prop)) | |
| 1938 except IndexError: | |
| 1939 # node no longer exists - entry should be removed | |
| 1940 self.db.indexer.purge_entry((self.classname, nodeid, prop)) | |
| 1941 else: | |
| 1942 # and index them under (classname, nodeid, property) | |
| 1943 self.db.indexer.add_text((self.classname, nodeid, prop), | |
| 1944 value) | |
| 1945 | |
| 1946 | |
| 1947 # | |
| 1948 # Detector interface | |
| 1949 # | |
| 1950 def audit(self, event, detector): | |
| 1951 '''Register a detector | |
| 1952 ''' | |
| 1953 l = self.auditors[event] | |
| 1954 if detector not in l: | |
| 1955 self.auditors[event].append(detector) | |
| 1956 | |
| 1957 def fireAuditors(self, action, nodeid, newvalues): | |
| 1958 '''Fire all registered auditors. | |
| 1959 ''' | |
| 1960 for audit in self.auditors[action]: | |
| 1961 audit(self.db, self, nodeid, newvalues) | |
| 1962 | |
| 1963 def react(self, event, detector): | |
| 1964 '''Register a detector | |
| 1965 ''' | |
| 1966 l = self.reactors[event] | |
| 1967 if detector not in l: | |
| 1968 self.reactors[event].append(detector) | |
| 1969 | |
| 1970 def fireReactors(self, action, nodeid, oldvalues): | |
| 1971 '''Fire all registered reactors. | |
| 1972 ''' | |
| 1973 for react in self.reactors[action]: | |
| 1974 react(self.db, self, nodeid, oldvalues) | |
| 1975 | |
| 1976 class FileClass(Class): | |
| 1977 '''This class defines a large chunk of data. To support this, it has a | |
| 1978 mandatory String property "content" which is typically saved off | |
| 1979 externally to the hyperdb. | |
| 1980 | |
| 1981 The default MIME type of this data is defined by the | |
| 1982 "default_mime_type" class attribute, which may be overridden by each | |
| 1983 node if the class defines a "type" String property. | |
| 1984 ''' | |
| 1985 default_mime_type = 'text/plain' | |
| 1986 | |
| 1987 def create(self, **propvalues): | |
| 1988 ''' snaffle the file propvalue and store in a file | |
| 1989 ''' | |
| 1990 content = propvalues['content'] | |
| 1991 del propvalues['content'] | |
| 1992 newid = Class.create(self, **propvalues) | |
| 1993 self.db.storefile(self.classname, newid, None, content) | |
| 1994 return newid | |
| 1995 | |
| 1996 def import_list(self, propnames, proplist): | |
| 1997 ''' Trap the "content" property... | |
| 1998 ''' | |
| 1999 # dupe this list so we don't affect others | |
| 2000 propnames = propnames[:] | |
| 2001 | |
| 2002 # extract the "content" property from the proplist | |
| 2003 i = propnames.index('content') | |
| 2004 content = eval(proplist[i]) | |
| 2005 del propnames[i] | |
| 2006 del proplist[i] | |
| 2007 | |
| 2008 # do the normal import | |
| 2009 newid = Class.import_list(self, propnames, proplist) | |
| 2010 | |
| 2011 # save off the "content" file | |
| 2012 self.db.storefile(self.classname, newid, None, content) | |
| 2013 return newid | |
| 2014 | |
| 2015 _marker = [] | |
| 2016 def get(self, nodeid, propname, default=_marker, cache=1): | |
| 2017 ''' trap the content propname and get it from the file | |
| 2018 ''' | |
| 2019 | |
| 2020 poss_msg = 'Possibly a access right configuration problem.' | |
| 2021 if propname == 'content': | |
| 2022 try: | |
| 2023 return self.db.getfile(self.classname, nodeid, None) | |
| 2024 except IOError, (strerror): | |
| 2025 # BUG: by catching this we donot see an error in the log. | |
| 2026 return 'ERROR reading file: %s%s\n%s\n%s'%( | |
| 2027 self.classname, nodeid, poss_msg, strerror) | |
| 2028 if default is not self._marker: | |
| 2029 return Class.get(self, nodeid, propname, default, cache=cache) | |
| 2030 else: | |
| 2031 return Class.get(self, nodeid, propname, cache=cache) | |
| 2032 | |
| 2033 def getprops(self, protected=1): | |
| 2034 ''' In addition to the actual properties on the node, these methods | |
| 2035 provide the "content" property. If the "protected" flag is true, | |
| 2036 we include protected properties - those which may not be | |
| 2037 modified. | |
| 2038 ''' | |
| 2039 d = Class.getprops(self, protected=protected).copy() | |
| 2040 d['content'] = hyperdb.String() | |
| 2041 return d | |
| 2042 | |
| 2043 def index(self, nodeid): | |
| 2044 ''' Index the node in the search index. | |
| 2045 | |
| 2046 We want to index the content in addition to the normal String | |
| 2047 property indexing. | |
| 2048 ''' | |
| 2049 # perform normal indexing | |
| 2050 Class.index(self, nodeid) | |
| 2051 | |
| 2052 # get the content to index | |
| 2053 content = self.get(nodeid, 'content') | |
| 2054 | |
| 2055 # figure the mime type | |
| 2056 if self.properties.has_key('type'): | |
| 2057 mime_type = self.get(nodeid, 'type') | |
| 2058 else: | |
| 2059 mime_type = self.default_mime_type | |
| 2060 | |
| 2061 # and index! | |
| 2062 self.db.indexer.add_text((self.classname, nodeid, 'content'), content, | |
| 2063 mime_type) | |
| 2064 | |
| 2065 # XXX deviation from spec - was called ItemClass | |
| 2066 class IssueClass(Class, roundupdb.IssueClass): | |
| 2067 # Overridden methods: | |
| 2068 def __init__(self, db, classname, **properties): | |
| 2069 '''The newly-created class automatically includes the "messages", | |
| 2070 "files", "nosy", and "superseder" properties. If the 'properties' | |
| 2071 dictionary attempts to specify any of these properties or a | |
| 2072 "creation" or "activity" property, a ValueError is raised. | |
| 2073 ''' | |
| 2074 if not properties.has_key('title'): | |
| 2075 properties['title'] = hyperdb.String(indexme='yes') | |
| 2076 if not properties.has_key('messages'): | |
| 2077 properties['messages'] = hyperdb.Multilink("msg") | |
| 2078 if not properties.has_key('files'): | |
| 2079 properties['files'] = hyperdb.Multilink("file") | |
| 2080 if not properties.has_key('nosy'): | |
| 2081 # note: journalling is turned off as it really just wastes | |
| 2082 # space. this behaviour may be overridden in an instance | |
| 2083 properties['nosy'] = hyperdb.Multilink("user", do_journal="no") | |
| 2084 if not properties.has_key('superseder'): | |
| 2085 properties['superseder'] = hyperdb.Multilink(classname) | |
| 2086 Class.__init__(self, db, classname, **properties) | |
| 2087 |