← Back to branch summary

~ntt-pf-lab/nova/monkey_patch_notification

« back to all changes in this revision

Viewing changes to vendor/boto/boto/mapreduce/partitiondb.py

  • Committer: Jesse Andrews
  • Date: 2010-05-28 06:05:26 UTC
  • Revision ID: git-v1:bf6e6e718cdc7488e2da87b21e258ccc065fe499
initial commit

Show diffs side-by-side

added added

removed removed

Lines of Context:
vendor/boto/boto/mapreduce/partitiondb.py
 
1
# Copyright (c) 2006-2008 Mitch Garnaat http://garnaat.org/
 
2
#
 
3
# Permission is hereby granted, free of charge, to any person obtaining a
 
4
# copy of this software and associated documentation files (the
 
5
# "Software"), to deal in the Software without restriction, including
 
6
# without limitation the rights to use, copy, modify, merge, publish, dis-
 
7
# tribute, sublicense, and/or sell copies of the Software, and to permit
 
8
# persons to whom the Software is furnished to do so, subject to the fol-
 
9
# lowing conditions:
 
10
#
 
11
# The above copyright notice and this permission notice shall be included
 
12
# in all copies or substantial portions of the Software.
 
13
#
 
14
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
 
15
# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
 
16
# ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
 
17
# SHALL THE AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 
 
18
# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 
19
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
 
20
# IN THE SOFTWARE.
 
21
#
 
22
 
 
23
import random
 
24
import os
 
25
import datetime
 
26
from boto.sdb.persist.object import SDBObject
 
27
from boto.sdb.persist.property import StringProperty, ObjectProperty, DateTimeProperty, ObjectListProperty, S3KeyProperty
 
28
 
 
29
 
 
30
HEX_DIGITS = '0123456789abcdef'
 
31
 
 
32
class Identifier(object):
 
33
 
 
34
    @staticmethod
 
35
    def gen(prefix):
 
36
        suffix = ''
 
37
        for i in range(0,8):
 
38
            suffix += random.choice(HEX_DIGITS)
 
39
        return prefix + '-' + suffix
 
40
 
 
41
 
 
42
class Version(SDBObject):
 
43
 
 
44
    name = StringProperty()
 
45
    pdb = ObjectProperty(ref_class=SDBObject)
 
46
    date = DateTimeProperty()
 
47
    
 
48
    def __init__(self, id=None, manager=None):
 
49
        SDBObject.__init__(self, id, manager)
 
50
        if id == None:
 
51
            self.name = Identifier.gen('v')
 
52
            self.date = datetime.datetime.now()
 
53
            print 'created Version %s' % self.name
 
54
 
 
55
    def partitions(self):
 
56
        """
 
57
        Return an iterator containing all Partition objects related to this Version.
 
58
 
 
59
        :rtype: iterator of :class:`boto.mapreduce.partitiondb.Partition`
 
60
        :return: The Partitions in this Version
 
61
        """
 
62
        return self.get_related_objects('version', Partition)
 
63
 
 
64
    def add_partition(self, name=None):
 
65
        """
 
66
        Add a new Partition to this Version.
 
67
 
 
68
        :type name: string
 
69
        :param name: The name of the new Partition (optional)
 
70
 
 
71
        :rtype: :class:`boto.mapreduce.partitiondb.Partition`
 
72
        :return: The new Partition object
 
73
        """
 
74
        p = Partition(manager=self.manager, name=name)
 
75
        p.version = self
 
76
        p.pdb = self.pdb
 
77
        p.save()
 
78
        return p
 
79
 
 
80
    def get_s3_prefix(self):
 
81
        if not self.pdb:
 
82
            raise ValueError, 'pdb attribute must be set to compute S3 prefix'
 
83
        return self.pdb.get_s3_prefix() + self.name + '/'
 
84
 
 
85
class PartitionDB(SDBObject):
 
86
 
 
87
    name = StringProperty()
 
88
    bucket_name = StringProperty()
 
89
    versions = ObjectListProperty(ref_class=Version)
 
90
 
 
91
    def __init__(self, id=None, manager=None, name='', bucket_name=''):
 
92
        SDBObject.__init__(self, id, manager)
 
93
        if id == None:
 
94
            self.name = name
 
95
            self.bucket_name = bucket_name
 
96
 
 
97
    def get_s3_prefix(self):
 
98
        return self.name + '/'
 
99
 
 
100
    def add_version(self):
 
101
        """
 
102
        Add a new Version to this PartitionDB.  The newly added version becomes the
 
103
        current version.
 
104
 
 
105
        :rtype: :class:`boto.mapreduce.partitiondb.Version`
 
106
        :return: The newly created Version object.
 
107
        """
 
108
        v = Version()
 
109
        v.pdb = self
 
110
        v.save()
 
111
        self.versions.append(v)
 
112
        return v
 
113
 
 
114
    def revert(self):
 
115
        """
 
116
        Revert to the previous version of this PartitionDB.  The current version is removed from the
 
117
        list of Versions and the Version immediately preceeding it becomes the current version.
 
118
        Note that this method does not delete the Version object or any Partitions related to the
 
119
        Version object.
 
120
 
 
121
        :rtype: :class:`boto.mapreduce.partitiondb.Version`
 
122
        :return: The previous current Version object.
 
123
        """
 
124
        v = self.current_version()
 
125
        if v:
 
126
            self.versions.remove(v)
 
127
        return v
 
128
 
 
129
    def current_version(self):
 
130
        """
 
131
        Get the currently active Version of this PartitionDB object.
 
132
 
 
133
        :rtype: :class:`boto.mapreduce.partitiondb.Version`
 
134
        :return: The current Version object or None if there are no Versions associated
 
135
                 with this PartitionDB object.
 
136
        """
 
137
        if self.versions:
 
138
            if len(self.versions) > 0:
 
139
                return self.versions[-1]
 
140
        return None
 
141
 
 
142
class Partition(SDBObject):
 
143
 
 
144
    def __init__(self, id=None, manager=None, name=None):
 
145
        SDBObject.__init__(self, id, manager)
 
146
        if id == None:
 
147
            self.name = name
 
148
 
 
149
    name = StringProperty()
 
150
    version = ObjectProperty(ref_class=Version)
 
151
    pdb = ObjectProperty(ref_class=PartitionDB)
 
152
    data = S3KeyProperty()
 
153
 
 
154
    def get_key_name(self):
 
155
        return self.version.get_s3_prefix() + self.name
 
156
 
 
157
    def upload(self, path, bucket_name=None):
 
158
        if not bucket_name:
 
159
            bucket_name = self.version.pdb.bucket_name
 
160
        s3 = self.manager.get_s3_connection()
 
161
        bucket = s3.lookup(bucket_name)
 
162
        directory, filename = os.path.split(path)
 
163
        self.name = filename
 
164
        key = bucket.new_key(self.get_key_name())
 
165
        key.set_contents_from_filename(path)
 
166
        self.data = key
 
167
        self.save()
 
168
 
 
169
    def delete(self):
 
170
        if self.data:
 
171
            self.data.delete()
 
172
        SDBObject.delete(self)
 
173
        
 
174
        
 
175