1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
|
# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License"). You
# may not use this file except in compliance with the License. A copy of
# the License is located at
#
# http://aws.amazon.com/apache2.0/
#
# or in the "license" file accompanying this file. This file is
# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
# ANY KIND, either express or implied. See the License for the specific
# language governing permissions and limitations under the License.
require 'set'
module AWS
# AWS::Record is an ORM built on top of AWS services.
module Record
autoload :AbstractBase, 'aws/record/abstract_base'
autoload :Attributes, 'aws/record/attributes'
autoload :Base, 'aws/record/model'
autoload :Conversion, 'aws/record/conversion'
autoload :DirtyTracking, 'aws/record/dirty_tracking'
autoload :Errors, 'aws/record/errors'
autoload :HashModel, 'aws/record/hash_model'
autoload :Model, 'aws/record/model'
autoload :Naming, 'aws/record/naming'
autoload :Scope, 'aws/record/scope'
autoload :Validations, 'aws/record/validations'
# errors
autoload :RecordNotFound, 'aws/record/exceptions'
autoload :InvalidRecordError, 'aws/record/exceptions'
autoload :EmptyRecordError, 'aws/record/exceptions'
autoload :UndefinedAttributeError, 'aws/record/exceptions'
# validators
autoload :AcceptanceValidator, 'aws/record/validators/acceptance'
autoload :BlockValidator, 'aws/record/validators/block'
autoload :ConfirmationValidator, 'aws/record/validators/confirmation'
autoload :CountValidator, 'aws/record/validators/count'
autoload :ExclusionValidator, 'aws/record/validators/exclusion'
autoload :FormatValidator, 'aws/record/validators/format'
autoload :InclusionValidator, 'aws/record/validators/inclusion'
autoload :LengthValidator, 'aws/record/validators/length'
autoload :MethodValidator, 'aws/record/validators/method'
autoload :NumericalityValidator, 'aws/record/validators/numericality'
autoload :PresenceValidator, 'aws/record/validators/presence'
autoload :Validator, 'aws/record/validator'
# Sets a prefix to be applied to all SimpleDB domains associated with
# AWS::Record::Base classes.
#
# AWS::Record.domain_prefix = 'production_'
#
# class Product < AWS::Record::Base
# set_shard_name 'products'
# end
#
# p = Product.new
# p.shard #=> 'products'
# p.save # the product is persisted to the 'production-products' domain
#
# @param [String] prefix A prefix to append to all domains. This is useful
# for grouping domains used by one application with a single prefix.
#
def self.domain_prefix= prefix
@domain_prefix = prefix
end
# @return [String,nil] The string that is prepended to all domain names.
def self.domain_prefix
@domain_prefix
end
# Sets a prefix to be applied to all DynamoDB tables associated
# with {AWS::Record::HashModel} and {AWS::Record::ListModel}
# classes.
#
# AWS::Record.table_prefix = 'production_'
#
# class Product < AWS::Record::HashModel
# set_shard_name 'products'
# end
#
# p = Product.new
# p.shard #=> 'products'
# p.save # the product is persisted to the 'production-products' table
#
# @param [String] prefix A prefix to append to all tables. This is
# useful for grouping tables used by one application with a
# single prefix.
#
def self.table_prefix= prefix
@table_prefix = prefix
end
# @return [String,nil] The string that is prepended to all table names.
def self.table_prefix
@table_prefix
end
# A utility method for casting values into an array.
#
# * nil is returned as an empty array, []
# * Arrays are returned unmodified
# * Everything else is returned as the sole element of an array
#
# @param [Object] value
# @return [Array] The value cast into an array
# @api private
def self.as_array value
case value
when nil then []
when Set then value.to_a
when Array then value
else [value]
end
end
# A utility method for casting values into
#
# * Sets are returned unmodified
# * everything else is passed through #{as_array} and then into a new Set
#
# @param [Object] value
# @return [Set] The value cast into a Set.
# @api private
def self.as_set value
case value
when Set then value
else Set.new(as_array(value))
end
end
end
end
|
