hydra_attribute 0.4.0.rc2 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/CHANGELOG.md +5 -0
- data/README.md +12 -20
- data/lib/hydra_attribute/version.rb +1 -1
- metadata +8 -5
data/CHANGELOG.md
CHANGED
@@ -1,3 +1,8 @@
|
|
1
|
+
**0.4.0 (September 13, 2012)**
|
2
|
+
* Add attribute sets
|
3
|
+
* Add helper methods for attributes and attribute sets
|
4
|
+
* Remove `use_hydra_attributes` method from `ActiveRecord::Base`. Module `HydraAttribute::ActiveRecord` should be included instead
|
5
|
+
|
1
6
|
**0.3.2 (July 31, 2012)**
|
2
7
|
* Add `white_list` option which allows to add attribute to white list for entity during creation
|
3
8
|
|
data/README.md
CHANGED
@@ -37,7 +37,7 @@ class CreateHydraAttributeTables < ActiveRecord::Migration
|
|
37
37
|
end
|
38
38
|
```
|
39
39
|
|
40
|
-
**or if we have
|
40
|
+
**or if we have the entity table already**
|
41
41
|
|
42
42
|
```ruby
|
43
43
|
class CreateHydraAttributeTables < ActiveRecord::Migration
|
@@ -59,14 +59,7 @@ rails generate model Product type:string name:string --migration=false
|
|
59
59
|
rake db:migrate
|
60
60
|
```
|
61
61
|
|
62
|
-
and
|
63
|
-
```ruby
|
64
|
-
class Product < ActiveRecord::Base
|
65
|
-
use_hydra_attributes
|
66
|
-
end
|
67
|
-
```
|
68
|
-
|
69
|
-
**Starting from version 0.4.0 `use_hydra_attributes` method will be removed.**
|
62
|
+
and include `HydraAttribute::ActiveRecord` to Product class
|
70
63
|
```ruby
|
71
64
|
class Product < ActiveRecord::Base
|
72
65
|
include HydraAttribute::ActiveRecord
|
@@ -81,10 +74,10 @@ Product.hydra_attributes.create(name: 'total', backend_type: 'integer', default_
|
|
81
74
|
```
|
82
75
|
|
83
76
|
Creating method accepts the following options:
|
84
|
-
* **name**. The **required** parameter.
|
85
|
-
* **backend_type**. The **required** parameter.
|
86
|
-
* **default_value**. The **optional** parameter.
|
87
|
-
* **white_list**. The **optional** parameter. Should be `true` or `flase`.
|
77
|
+
* **name**. The **required** parameter. Any string is allowed.
|
78
|
+
* **backend_type**. The **required** parameter. One of the following strings is allowed: `string`, `text`, `integer`, `float`, `boolean` and `datetime`.
|
79
|
+
* **default_value**. The **optional** parameter. Any value is allowed. `nil` is default.
|
80
|
+
* **white_list**. The **optional** parameter. Should be `true` or `flase`. `false` is default. If `white_list: true` is passed, this attribute will be added to white list and will be allowed for mass-assignment. This parameter is in black list for creation by default so if you want to pass it, you have to pass the role `as: :admin` too.
|
88
81
|
|
89
82
|
```ruby
|
90
83
|
Product.hydra_attributes.create({name: 'title', backend_type: 'string', white_list: true}, as: :admin)
|
@@ -108,7 +101,7 @@ Product.create(title: 'car', price: 2.50)
|
|
108
101
|
```
|
109
102
|
|
110
103
|
### Create hydra set
|
111
|
-
**Hydra set** allows set unique attribute list for each entity.
|
104
|
+
**Hydra set** allows to set the unique attribute list for each entity.
|
112
105
|
|
113
106
|
```ruby
|
114
107
|
hydra_set = Product.hydra_sets.create(name: 'Default')
|
@@ -119,7 +112,7 @@ Product.create(color: 'black', title: 'ipod', price: 49.95, total: 5) do |produc
|
|
119
112
|
end
|
120
113
|
#<Product id: 5, hydra_set_id: 1, created_at: ..., updated_at: ..., color: "black", title: "ipod", price: 49.95>
|
121
114
|
```
|
122
|
-
**Notice:** the `total` attribute
|
115
|
+
**Notice:** the `total` attribute has been skipped because it doesn't exist in hydra set.
|
123
116
|
|
124
117
|
### Obtain data
|
125
118
|
```ruby
|
@@ -131,8 +124,7 @@ Product.where(color: 'green', price: nil)
|
|
131
124
|
#<Product id: 3, hydra_set_id: nil, created_at: ..., updated_at: ..., color: "green", title: "book", price: 0.0, total: 2>
|
132
125
|
# ]
|
133
126
|
```
|
134
|
-
**Notice**: the attribute `price`
|
135
|
-
so they matched this condition `where(price: nil)`
|
127
|
+
**Notice**: the attribute `price` has been added in runtime. Records that had been created before this attribute don't have it therefore they satisfy the following condition: `where(price: nil)`
|
136
128
|
|
137
129
|
### Order data
|
138
130
|
```ruby
|
@@ -153,7 +145,7 @@ Product.select([:color, :title])
|
|
153
145
|
#<Product id: 5, hydra_set_id: 1, color: "black", title: "ipod">
|
154
146
|
# ]
|
155
147
|
```
|
156
|
-
**Notice:** `id` and `hydra_set_id` attributes are
|
148
|
+
**Notice:** `id` and `hydra_set_id` attributes are forcibly added because they are important for correct work.
|
157
149
|
|
158
150
|
### Group by attribute
|
159
151
|
```ruby
|
@@ -168,11 +160,11 @@ Product.group(:color).count
|
|
168
160
|
* [Query methods](https://github.com/kostyantyn/hydra_attribute/wiki/Query-methods)
|
169
161
|
* [Database schema](https://github.com/kostyantyn/hydra_attribute/wiki/Database-schema)
|
170
162
|
* [Helper methods](https://github.com/kostyantyn/hydra_attribute/wiki/Helper-methods)
|
163
|
+
* [Migrate from 0.3.2 to 0.4.0](https://github.com/kostyantyn/hydra_attribute/wiki/Migrate-from-0.3.2-to-0.4.0)
|
171
164
|
|
172
165
|
## Notice
|
173
166
|
|
174
|
-
The each new minor version doesn't guarantee back compatibility with previous one
|
175
|
-
until the first major version will be released.
|
167
|
+
The each new minor version doesn't guarantee back compatibility with previous one until the first major version is released.
|
176
168
|
|
177
169
|
## Contributing
|
178
170
|
|
metadata
CHANGED
@@ -1,15 +1,15 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: hydra_attribute
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.4.0
|
5
|
-
prerelease:
|
4
|
+
version: 0.4.0
|
5
|
+
prerelease:
|
6
6
|
platform: ruby
|
7
7
|
authors:
|
8
8
|
- Kostyantyn Stepanyuk
|
9
9
|
autorequire:
|
10
10
|
bindir: bin
|
11
11
|
cert_chain: []
|
12
|
-
date: 2012-09-
|
12
|
+
date: 2012-09-12 00:00:00.000000000 Z
|
13
13
|
dependencies:
|
14
14
|
- !ruby/object:Gem::Dependency
|
15
15
|
name: activerecord
|
@@ -217,9 +217,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
|
|
217
217
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
218
218
|
none: false
|
219
219
|
requirements:
|
220
|
-
- - ! '
|
220
|
+
- - ! '>='
|
221
221
|
- !ruby/object:Gem::Version
|
222
|
-
version:
|
222
|
+
version: '0'
|
223
|
+
segments:
|
224
|
+
- 0
|
225
|
+
hash: -1684889592311729317
|
223
226
|
requirements: []
|
224
227
|
rubyforge_project:
|
225
228
|
rubygems_version: 1.8.24
|