1 from PLC.Faults import *
2 from PLC.Parameter import Parameter
3 from PLC.Storage.AlchemyObj import AlchemyObj
4 from PLC.Filter import Filter
5 from PLC.AddressTypes import AddressType, AddressTypes
7 class Address(AlchemyObj):
9 Representation of a row in the addresses table. To use, instantiate
10 with a dict of values.
13 tablename = 'addresses'
14 join_tables = ['address_address_type', 'site_address']
16 'address_id': Parameter(int, "Address identifier", primary_key=True),
17 'line1': Parameter(str, "Address line 1", max = 254),
18 'line2': Parameter(str, "Address line 2", max = 254, nullok = True),
19 'line3': Parameter(str, "Address line 3", max = 254, nullok = True),
20 'city': Parameter(str, "City", max = 254),
21 'state': Parameter(str, "State or province", max = 254),
22 'postalcode': Parameter(str, "Postal code", max = 64),
23 'country': Parameter(str, "Country", max = 128),
24 'address_type_ids': Parameter([int], "Address type identifiers", joined=True),
25 'address_types': Parameter([str], "Address types", joined=True),
28 def add_address_type(self, address_type, commit = True):
30 Add address type to existing address.
33 assert 'address_id' in self
34 assert isinstance(address_type, AddressType)
35 assert 'address_type_id' in address_type
37 address_id = self['address_id']
38 address_type_id = address_type['address_type_id']
40 if address_type_id not in self['address_type_ids']:
41 assert address_type['name'] not in self['address_types']
43 self.api.db.do("INSERT INTO address_address_type (address_id, address_type_id)" \
44 " VALUES(%(address_id)d, %(address_type_id)d)",
50 self['address_type_ids'].append(address_type_id)
51 self['address_types'].append(address_type['name'])
53 def remove_address_type(self, address_type, commit = True):
55 Add address type to existing address.
58 assert 'address_id' in self
59 assert isinstance(address_type, AddressType)
60 assert 'address_type_id' in address_type
62 address_id = self['address_id']
63 address_type_id = address_type['address_type_id']
65 if address_type_id in self['address_type_ids']:
66 assert address_type['name'] in self['address_types']
68 self.api.db.do("DELETE FROM address_address_type" \
69 " WHERE address_id = %(address_id)d" \
70 " AND address_type_id = %(address_type_id)d",
76 self['address_type_ids'].remove(address_type_id)
77 self['address_types'].remove(address_type['name'])
79 def sync(self, insert=False, validate=True):
80 AlchemyObj.sync(self, insert, validate)
81 if insert == True or 'id' not in self:
82 AlchemyObj.insert(self, dict(self))
84 AlchemyObj.update(self, {'address_id': self['address_id']}, dict(self))
86 def delete(self, commit=True):
87 AlchemyObj.delete(self, dict(self))
89 class Addresses(list):
91 Representation of row(s) from the addresses table in the
95 def __init__(self, api, address_filter = None, columns = None):
96 if address_filter is None:
97 addresses = Address().select()
98 elif isinstance(address_filter, (list, tuple, set, int, long)):
99 addresses = Address().select(filter={'address_id': address_filter})
100 elif isinstance(address_filter, dict):
101 addresses = Address().select(filter=address_filter)
103 raise PLCInvalidArgument, "Wrong address filter %s" % address_filter
105 for address in addresses: