nd-enum 0.1.0 → 0.2.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.
- checksums.yaml +4 -4
- data/.rspec +6 -0
- data/CHANGELOG.md +18 -0
- data/Gemfile +13 -0
- data/Gemfile.lock +91 -0
- data/Guardfile +70 -0
- data/LICENSE.txt +21 -0
- data/README.md +236 -0
- data/Rakefile +8 -0
- data/lib/nd/enum/base.rb +41 -0
- data/lib/nd/enum/configuration.rb +17 -0
- data/lib/nd/enum/i18n.rb +94 -0
- data/lib/nd/enum/version.rb +7 -0
- data/lib/nd/enum.rb +90 -0
- data/nd-enum.gemspec +37 -0
- data/sig/nd/enum.rbs +6 -0
- metadata +47 -4
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 1319016da965b32314532d641038f67316c07087b03f8a0a195786d783307c08
|
|
4
|
+
data.tar.gz: e88397852614473313ba633c1d3029de0cad1466b9ddfa0787b54e5cc7133eb8
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 65596f68728490a34c575fac8191438d85b4490268a5938c725f5ed7c0fbe3e0616679b332971dd8991f0989c34bd41c51b89bdaf1153f822f6446a0714613fc
|
|
7
|
+
data.tar.gz: c583f3f1e8a655bcf9ba604ef3851cbb27dba1acc7743ea5c158a763c33792e3cd2dc826659b7e53c1ae3380ac045aef60e53e6fd1bff3b9d8e83b315bd37b5f
|
data/.rspec
ADDED
data/CHANGELOG.md
ADDED
data/Gemfile
ADDED
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
source 'https://rubygems.org'
|
|
4
|
+
|
|
5
|
+
# Specify your gem's dependencies in nd-enum.gemspec
|
|
6
|
+
gemspec
|
|
7
|
+
|
|
8
|
+
gem 'rake', '~> 13.0'
|
|
9
|
+
gem 'rspec', '~> 3.0'
|
|
10
|
+
gem 'mocha', '~> 1.13'
|
|
11
|
+
gem 'pry', '~> 0.13'
|
|
12
|
+
gem 'guard', '~> 2.18'
|
|
13
|
+
gem 'guard-rspec', '~> 4.7', require: false
|
data/Gemfile.lock
ADDED
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
PATH
|
|
2
|
+
remote: .
|
|
3
|
+
specs:
|
|
4
|
+
nd-enum (0.2.0)
|
|
5
|
+
activerecord (>= 6.0.0)
|
|
6
|
+
activesupport (>= 6.0.0)
|
|
7
|
+
|
|
8
|
+
GEM
|
|
9
|
+
remote: https://rubygems.org/
|
|
10
|
+
specs:
|
|
11
|
+
activemodel (7.0.3.1)
|
|
12
|
+
activesupport (= 7.0.3.1)
|
|
13
|
+
activerecord (7.0.3.1)
|
|
14
|
+
activemodel (= 7.0.3.1)
|
|
15
|
+
activesupport (= 7.0.3.1)
|
|
16
|
+
activesupport (7.0.3.1)
|
|
17
|
+
concurrent-ruby (~> 1.0, >= 1.0.2)
|
|
18
|
+
i18n (>= 1.6, < 2)
|
|
19
|
+
minitest (>= 5.1)
|
|
20
|
+
tzinfo (~> 2.0)
|
|
21
|
+
coderay (1.1.3)
|
|
22
|
+
concurrent-ruby (1.1.10)
|
|
23
|
+
diff-lcs (1.5.0)
|
|
24
|
+
ffi (1.15.5)
|
|
25
|
+
formatador (1.1.0)
|
|
26
|
+
guard (2.18.0)
|
|
27
|
+
formatador (>= 0.2.4)
|
|
28
|
+
listen (>= 2.7, < 4.0)
|
|
29
|
+
lumberjack (>= 1.0.12, < 2.0)
|
|
30
|
+
nenv (~> 0.1)
|
|
31
|
+
notiffany (~> 0.0)
|
|
32
|
+
pry (>= 0.13.0)
|
|
33
|
+
shellany (~> 0.0)
|
|
34
|
+
thor (>= 0.18.1)
|
|
35
|
+
guard-compat (1.2.1)
|
|
36
|
+
guard-rspec (4.7.3)
|
|
37
|
+
guard (~> 2.1)
|
|
38
|
+
guard-compat (~> 1.1)
|
|
39
|
+
rspec (>= 2.99.0, < 4.0)
|
|
40
|
+
i18n (1.12.0)
|
|
41
|
+
concurrent-ruby (~> 1.0)
|
|
42
|
+
listen (3.7.1)
|
|
43
|
+
rb-fsevent (~> 0.10, >= 0.10.3)
|
|
44
|
+
rb-inotify (~> 0.9, >= 0.9.10)
|
|
45
|
+
lumberjack (1.2.8)
|
|
46
|
+
method_source (1.0.0)
|
|
47
|
+
minitest (5.16.2)
|
|
48
|
+
mocha (1.14.0)
|
|
49
|
+
nenv (0.3.0)
|
|
50
|
+
notiffany (0.1.3)
|
|
51
|
+
nenv (~> 0.1)
|
|
52
|
+
shellany (~> 0.0)
|
|
53
|
+
pry (0.14.1)
|
|
54
|
+
coderay (~> 1.1)
|
|
55
|
+
method_source (~> 1.0)
|
|
56
|
+
rake (13.0.6)
|
|
57
|
+
rb-fsevent (0.11.1)
|
|
58
|
+
rb-inotify (0.10.1)
|
|
59
|
+
ffi (~> 1.0)
|
|
60
|
+
rspec (3.11.0)
|
|
61
|
+
rspec-core (~> 3.11.0)
|
|
62
|
+
rspec-expectations (~> 3.11.0)
|
|
63
|
+
rspec-mocks (~> 3.11.0)
|
|
64
|
+
rspec-core (3.11.0)
|
|
65
|
+
rspec-support (~> 3.11.0)
|
|
66
|
+
rspec-expectations (3.11.0)
|
|
67
|
+
diff-lcs (>= 1.2.0, < 2.0)
|
|
68
|
+
rspec-support (~> 3.11.0)
|
|
69
|
+
rspec-mocks (3.11.1)
|
|
70
|
+
diff-lcs (>= 1.2.0, < 2.0)
|
|
71
|
+
rspec-support (~> 3.11.0)
|
|
72
|
+
rspec-support (3.11.0)
|
|
73
|
+
shellany (0.0.1)
|
|
74
|
+
thor (1.2.1)
|
|
75
|
+
tzinfo (2.0.5)
|
|
76
|
+
concurrent-ruby (~> 1.0)
|
|
77
|
+
|
|
78
|
+
PLATFORMS
|
|
79
|
+
x86_64-darwin-21
|
|
80
|
+
|
|
81
|
+
DEPENDENCIES
|
|
82
|
+
guard (~> 2.18)
|
|
83
|
+
guard-rspec (~> 4.7)
|
|
84
|
+
mocha (~> 1.13)
|
|
85
|
+
nd-enum!
|
|
86
|
+
pry (~> 0.13)
|
|
87
|
+
rake (~> 13.0)
|
|
88
|
+
rspec (~> 3.0)
|
|
89
|
+
|
|
90
|
+
BUNDLED WITH
|
|
91
|
+
2.3.12
|
data/Guardfile
ADDED
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
# A sample Guardfile
|
|
2
|
+
# More info at https://github.com/guard/guard#readme
|
|
3
|
+
|
|
4
|
+
## Uncomment and set this to only include directories you want to watch
|
|
5
|
+
# directories %w(app lib config test spec features) \
|
|
6
|
+
# .select{|d| Dir.exist?(d) ? d : UI.warning("Directory #{d} does not exist")}
|
|
7
|
+
|
|
8
|
+
## Note: if you are using the `directories` clause above and you are not
|
|
9
|
+
## watching the project directory ('.'), then you will want to move
|
|
10
|
+
## the Guardfile to a watched dir and symlink it back, e.g.
|
|
11
|
+
#
|
|
12
|
+
# $ mkdir config
|
|
13
|
+
# $ mv Guardfile config/
|
|
14
|
+
# $ ln -s config/Guardfile .
|
|
15
|
+
#
|
|
16
|
+
# and, you'll have to watch "config/Guardfile" instead of "Guardfile"
|
|
17
|
+
|
|
18
|
+
# Note: The cmd option is now required due to the increasing number of ways
|
|
19
|
+
# rspec may be run, below are examples of the most common uses.
|
|
20
|
+
# * bundler: 'bundle exec rspec'
|
|
21
|
+
# * bundler binstubs: 'bin/rspec'
|
|
22
|
+
# * spring: 'bin/rspec' (This will use spring if running and you have
|
|
23
|
+
# installed the spring binstubs per the docs)
|
|
24
|
+
# * zeus: 'zeus rspec' (requires the server to be started separately)
|
|
25
|
+
# * 'just' rspec: 'rspec'
|
|
26
|
+
|
|
27
|
+
guard :rspec, cmd: "bundle exec rspec" do
|
|
28
|
+
require "guard/rspec/dsl"
|
|
29
|
+
dsl = Guard::RSpec::Dsl.new(self)
|
|
30
|
+
|
|
31
|
+
# Feel free to open issues for suggestions and improvements
|
|
32
|
+
|
|
33
|
+
# RSpec files
|
|
34
|
+
rspec = dsl.rspec
|
|
35
|
+
watch(rspec.spec_helper) { rspec.spec_dir }
|
|
36
|
+
watch(rspec.spec_support) { rspec.spec_dir }
|
|
37
|
+
watch(rspec.spec_files)
|
|
38
|
+
|
|
39
|
+
# Ruby files
|
|
40
|
+
ruby = dsl.ruby
|
|
41
|
+
dsl.watch_spec_files_for(ruby.lib_files)
|
|
42
|
+
|
|
43
|
+
# Rails files
|
|
44
|
+
rails = dsl.rails(view_extensions: %w(erb haml slim))
|
|
45
|
+
dsl.watch_spec_files_for(rails.app_files)
|
|
46
|
+
dsl.watch_spec_files_for(rails.views)
|
|
47
|
+
|
|
48
|
+
watch(rails.controllers) do |m|
|
|
49
|
+
[
|
|
50
|
+
rspec.spec.call("routing/#{m[1]}_routing"),
|
|
51
|
+
rspec.spec.call("controllers/#{m[1]}_controller"),
|
|
52
|
+
rspec.spec.call("acceptance/#{m[1]}")
|
|
53
|
+
]
|
|
54
|
+
end
|
|
55
|
+
|
|
56
|
+
# Rails config changes
|
|
57
|
+
watch(rails.spec_helper) { rspec.spec_dir }
|
|
58
|
+
watch(rails.routes) { "#{rspec.spec_dir}/routing" }
|
|
59
|
+
watch(rails.app_controller) { "#{rspec.spec_dir}/controllers" }
|
|
60
|
+
|
|
61
|
+
# Capybara features specs
|
|
62
|
+
watch(rails.view_dirs) { |m| rspec.spec.call("features/#{m[1]}") }
|
|
63
|
+
watch(rails.layouts) { |m| rspec.spec.call("features/#{m[1]}") }
|
|
64
|
+
|
|
65
|
+
# Turnip features and steps
|
|
66
|
+
watch(%r{^spec/acceptance/(.+)\.feature$})
|
|
67
|
+
watch(%r{^spec/acceptance/steps/(.+)_steps\.rb$}) do |m|
|
|
68
|
+
Dir[File.join("**/#{m[1]}.feature")][0] || "spec/acceptance"
|
|
69
|
+
end
|
|
70
|
+
end
|
data/LICENSE.txt
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
The MIT License (MIT)
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2022 Romain Clavel
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in
|
|
13
|
+
all copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
21
|
+
THE SOFTWARE.
|
data/README.md
ADDED
|
@@ -0,0 +1,236 @@
|
|
|
1
|
+
# ND::Enum
|
|
2
|
+
|
|
3
|
+
This gem allows you to create and use enums easily and quickly in your Rails project.
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
Install the gem and add to the application's Gemfile by executing:
|
|
8
|
+
|
|
9
|
+
$ bundle add nd-enum
|
|
10
|
+
|
|
11
|
+
If bundler is not being used to manage dependencies, install the gem by executing:
|
|
12
|
+
|
|
13
|
+
$ gem install nd-enum
|
|
14
|
+
|
|
15
|
+
## Usage
|
|
16
|
+
|
|
17
|
+
- [Basic usage](#basic-usage)
|
|
18
|
+
- [Configuration](#configuration)
|
|
19
|
+
- [I18n](#i18n)
|
|
20
|
+
- [Validate translations presence](#validate-translations-presence)
|
|
21
|
+
- [Enforce translations presence](#enforce-translations-presence)
|
|
22
|
+
- [ActiveRecord Enum](#activerecord-enum)
|
|
23
|
+
|
|
24
|
+
### Basic usage
|
|
25
|
+
|
|
26
|
+
Define your enum in an ActiveRecord model:
|
|
27
|
+
|
|
28
|
+
```ruby
|
|
29
|
+
class User < ApplicationRecord
|
|
30
|
+
nd_enum(role: %i(user admin))
|
|
31
|
+
end
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
It creates a module for your enum that contains one constant per enum value. Say goodbye to [magic strings](https://en.wikipedia.org/wiki/Magic_string)!
|
|
35
|
+
|
|
36
|
+
In our example, the module is `User::Role`, and the constants are `User::Role::USER` and `User::Role::ADMIN`.
|
|
37
|
+
|
|
38
|
+
```ruby
|
|
39
|
+
irb(main)> User::Role::USER
|
|
40
|
+
=> "user"
|
|
41
|
+
|
|
42
|
+
irb(main)> User::Role::ADMIN
|
|
43
|
+
=> "admin"
|
|
44
|
+
|
|
45
|
+
irb(main)> User::Role.all
|
|
46
|
+
=> ["user", "admin"]
|
|
47
|
+
|
|
48
|
+
irb(main)> User::Role.length
|
|
49
|
+
=> 2
|
|
50
|
+
|
|
51
|
+
irb(main)> User::Role[1]
|
|
52
|
+
=> "admin"
|
|
53
|
+
|
|
54
|
+
irb(main)> User::Role[:user]
|
|
55
|
+
=> "user"
|
|
56
|
+
|
|
57
|
+
irb(main)> User::Role.include?('foobar')
|
|
58
|
+
=> false
|
|
59
|
+
|
|
60
|
+
irb(main)> User::Role.include?('user')
|
|
61
|
+
=> true
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
ND::Enum inheritates from [`Enumerable`](https://ruby-doc.org/core-3.1.2/Enumerable.html), so it is possible to use all `Enumerable` methods on the enum module: `each`, `map`, `find`...
|
|
65
|
+
|
|
66
|
+
### Configuration
|
|
67
|
+
|
|
68
|
+
Fine-tune `ND::Enum` behaviour by creating an initializer (for example: `config/initializers/nd_enum.rb`).
|
|
69
|
+
The values shown in the example below are the default values.
|
|
70
|
+
|
|
71
|
+
```ruby
|
|
72
|
+
ND::Enum.configure do |c|
|
|
73
|
+
c.default_i18n_scope = :base
|
|
74
|
+
c.default_i18n_validation_mode = :ignore # Allowed values: ignore, log, enforce
|
|
75
|
+
end
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### I18n
|
|
79
|
+
|
|
80
|
+
Allows to translate your enum values.
|
|
81
|
+
Add to your locale files:
|
|
82
|
+
|
|
83
|
+
```yaml
|
|
84
|
+
en:
|
|
85
|
+
users: # Model.table_name
|
|
86
|
+
role: # attribute
|
|
87
|
+
base: # default scope
|
|
88
|
+
user: User
|
|
89
|
+
admin: Admin
|
|
90
|
+
foobar: # custom scope
|
|
91
|
+
user: The user
|
|
92
|
+
admin: The admin
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
Then call `t` (or `translate`) method:
|
|
96
|
+
|
|
97
|
+
```ruby
|
|
98
|
+
irb(main)> User::Role.t(:user) # Or `translate` method (alias)
|
|
99
|
+
=> "translation missing: en.users.role.base.user"
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Use a different scope to have several translations for a single value, depending on context:
|
|
103
|
+
|
|
104
|
+
```ruby
|
|
105
|
+
irb(main)> User::Role.t(:user, :foobar)
|
|
106
|
+
=> "translation missing: en.users.role.foobar.user"
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
Please note that the default scope (`base`) can be configured using the `default_i18n_scope` initializer option.
|
|
110
|
+
|
|
111
|
+
#### Validate translations presence
|
|
112
|
+
|
|
113
|
+
Validate that your enum are translated. By default, this feature is disabled.
|
|
114
|
+
|
|
115
|
+
```ruby
|
|
116
|
+
class User < ApplicationRecord
|
|
117
|
+
nd_enum(role: %i(user admin), i18n: { mode: :log })
|
|
118
|
+
end
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
It will log the missing translations for each scope & locale. For example:
|
|
122
|
+
|
|
123
|
+
```
|
|
124
|
+
I, [2022-08-10T21:17:53.931669 #67401] INFO -- : ND::Enum: User#role scopes=[:base, :short]
|
|
125
|
+
I, [2022-08-10T21:17:53.931669 #67401] INFO -- : ND::Enum: User#role locale=en missing_keys=[]
|
|
126
|
+
I, [2022-08-10T21:17:53.931669 #67401] INFO -- : ND::Enum: User#role locale=nl missing_keys=["users.role.base.user", "users.role.short.user"]
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
This mode can be used as default with the `c.default_i18n_validation_mode = :log` initializer option.
|
|
130
|
+
|
|
131
|
+
#### Enforce translations presence
|
|
132
|
+
|
|
133
|
+
Raise an exception when some translations are missing.
|
|
134
|
+
|
|
135
|
+
```ruby
|
|
136
|
+
class User < ApplicationRecord
|
|
137
|
+
nd_enum(role: %i(user admin), i18n: { mode: :enforce })
|
|
138
|
+
end
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
```
|
|
142
|
+
(irb):1:in `<main>': One or several translations are missing (ND::Enum::MissingTranslationError)
|
|
143
|
+
from bin/console:15:in `<main>'
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
This mode can be used as default with the `c.default_i18n_validation_mode = :enforce` initializer option.
|
|
147
|
+
|
|
148
|
+
### `ActiveRecord` Enum
|
|
149
|
+
|
|
150
|
+
Add a wrapper to [`ActiveRecord` Enum](https://api.rubyonrails.org/classes/ActiveRecord/Enum.html) by specifying the `db: true` option.
|
|
151
|
+
|
|
152
|
+
```ruby
|
|
153
|
+
class User < ApplicationRecord
|
|
154
|
+
nd_enum(role: %i(user admin), db: true)
|
|
155
|
+
end
|
|
156
|
+
|
|
157
|
+
# It does exactly the same thing than below, but shorter:
|
|
158
|
+
|
|
159
|
+
class User < ApplicationRecord
|
|
160
|
+
nd_enum(role: %i(user admin))
|
|
161
|
+
enum(role: User::Role.to_h) # Or `enum(role: { user: 'user', admin: 'admin '})`
|
|
162
|
+
end
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
It allows to use these methods:
|
|
166
|
+
|
|
167
|
+
```ruby
|
|
168
|
+
user.admin!
|
|
169
|
+
user.admin? # => true
|
|
170
|
+
user.role # => "admin"
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
And these scopes:
|
|
174
|
+
|
|
175
|
+
```ruby
|
|
176
|
+
User.admin
|
|
177
|
+
User.not_admin
|
|
178
|
+
|
|
179
|
+
User.user
|
|
180
|
+
User.not_user
|
|
181
|
+
|
|
182
|
+
# ...
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
Disable scope definition by setting `scopes: false` to your enum:
|
|
186
|
+
|
|
187
|
+
```ruby
|
|
188
|
+
class User < ApplicationRecord
|
|
189
|
+
nd_enum(role: %i(user admin), db: { scopes: false })
|
|
190
|
+
end
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
Set the default enum:
|
|
194
|
+
|
|
195
|
+
```ruby
|
|
196
|
+
class User < ApplicationRecord
|
|
197
|
+
nd_enum(role: %i(user admin), db: { default: :admin })
|
|
198
|
+
end
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
Add a `prefix` or `suffix` option when you need to define multiple enums with same values. If the passed value is true, the methods are prefixed/suffixed with the name of the enum. It is also possible to supply a custom value:
|
|
202
|
+
|
|
203
|
+
```ruby
|
|
204
|
+
class User < ApplicationRecord
|
|
205
|
+
nd_enum(role: %i(user admin), db: { prefix: true })
|
|
206
|
+
|
|
207
|
+
# Scopes: `User.role_admin`, `User.role_user` ...
|
|
208
|
+
# Methods: `User.role_admin!`, `User.role_user!` ...
|
|
209
|
+
|
|
210
|
+
nd_enum(role: %i(user admin), db: { suffix: true })
|
|
211
|
+
|
|
212
|
+
# Scopes: `User.admin_role`, `User.user_role` ...
|
|
213
|
+
# Methods: `User.admin_role!`, `User.user_role!` ...
|
|
214
|
+
|
|
215
|
+
nd_enum(role: %i(user admin), db: { prefix: 'foobar' })
|
|
216
|
+
|
|
217
|
+
# Scopes: `User.foobar_admin`, `User.foobar_user` ...
|
|
218
|
+
# Methods: `User.foobar_admin!`, `User.foobar_user!` ...
|
|
219
|
+
end
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
## Development
|
|
223
|
+
|
|
224
|
+
After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
|
|
225
|
+
|
|
226
|
+
Guard is also installed: `bundle exec guard`.
|
|
227
|
+
|
|
228
|
+
To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, run `gem bump` (or manually update the version number in `version.rb`), and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
|
|
229
|
+
|
|
230
|
+
## Contributing
|
|
231
|
+
|
|
232
|
+
Bug reports and pull requests are welcome on GitHub at https://github.com/rclavel/nd-enum.
|
|
233
|
+
|
|
234
|
+
## License
|
|
235
|
+
|
|
236
|
+
The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
|
data/Rakefile
ADDED
data/lib/nd/enum/base.rb
ADDED
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
require 'forwardable'
|
|
4
|
+
require 'active_support'
|
|
5
|
+
|
|
6
|
+
module ND::Enum::Base
|
|
7
|
+
extend ActiveSupport::Concern
|
|
8
|
+
|
|
9
|
+
included do
|
|
10
|
+
class << self
|
|
11
|
+
include Enumerable
|
|
12
|
+
extend Forwardable
|
|
13
|
+
|
|
14
|
+
def_delegators :all, :size, :length, :[], :empty?, :last, :index
|
|
15
|
+
|
|
16
|
+
def each(&block)
|
|
17
|
+
all.each(&block)
|
|
18
|
+
end
|
|
19
|
+
|
|
20
|
+
def to_h
|
|
21
|
+
all.map { |value| [value.to_sym, value] }.to_h
|
|
22
|
+
end
|
|
23
|
+
|
|
24
|
+
def [](value)
|
|
25
|
+
value.is_a?(Integer) ? all[value] : to_h[value.to_sym]
|
|
26
|
+
end
|
|
27
|
+
|
|
28
|
+
def t(value, scope = nil)
|
|
29
|
+
scope ||= configuration.default_i18n_scope
|
|
30
|
+
::I18n.t(value, scope: "#{model.table_name}.#{attribute}.#{scope}")
|
|
31
|
+
end
|
|
32
|
+
alias_method :translate, :t
|
|
33
|
+
|
|
34
|
+
private
|
|
35
|
+
|
|
36
|
+
def configuration
|
|
37
|
+
ND::Enum.configuration
|
|
38
|
+
end
|
|
39
|
+
end
|
|
40
|
+
end
|
|
41
|
+
end
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
module ND::Enum::Configuration
|
|
4
|
+
Configuration = Struct.new(:default_i18n_validation_mode, :default_i18n_scope)
|
|
5
|
+
DEFAULT_CONFIGURATION = {
|
|
6
|
+
default_i18n_validation_mode: :ignore,
|
|
7
|
+
default_i18n_scope: :base,
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
def configuration
|
|
11
|
+
@_configuration ||= Configuration.new(*DEFAULT_CONFIGURATION.values_at(*Configuration.members))
|
|
12
|
+
end
|
|
13
|
+
|
|
14
|
+
def configure
|
|
15
|
+
yield(configuration)
|
|
16
|
+
end
|
|
17
|
+
end
|
data/lib/nd/enum/i18n.rb
ADDED
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
module ND::Enum::I18n
|
|
4
|
+
class << self
|
|
5
|
+
# TODO: Transform into a nd_enum
|
|
6
|
+
module Mode
|
|
7
|
+
LOG = 'log'
|
|
8
|
+
ENFORCE = 'enforce'
|
|
9
|
+
IGNORE = 'ignore'
|
|
10
|
+
|
|
11
|
+
def self.all
|
|
12
|
+
[LOG, ENFORCE, IGNORE]
|
|
13
|
+
end
|
|
14
|
+
end
|
|
15
|
+
|
|
16
|
+
def validate!(options)
|
|
17
|
+
mode = get_mode_from_options(options)
|
|
18
|
+
return if mode == Mode::IGNORE
|
|
19
|
+
|
|
20
|
+
i18n_scope = build_i18n_scope(options)
|
|
21
|
+
scopes = get_scopes_from_translations(i18n_scope)
|
|
22
|
+
missing_keys_by_locale = get_missing_keys_by_locale(options, i18n_scope, scopes)
|
|
23
|
+
|
|
24
|
+
log_missing_keys(options, scopes, missing_keys_by_locale)
|
|
25
|
+
|
|
26
|
+
if mode == Mode::ENFORCE && missing_keys_by_locale.values.any?(&:present?)
|
|
27
|
+
raise ND::Enum::MissingTranslationError
|
|
28
|
+
end
|
|
29
|
+
end
|
|
30
|
+
|
|
31
|
+
private
|
|
32
|
+
|
|
33
|
+
def get_mode_from_options(options)
|
|
34
|
+
case options.dig(:i18n, :validate)
|
|
35
|
+
when 'log', :log then Mode::LOG
|
|
36
|
+
when 'enforce', :enforce then Mode::ENFORCE
|
|
37
|
+
else
|
|
38
|
+
default_mode = configuration.default_i18n_validation_mode&.to_s
|
|
39
|
+
Mode.all.include?(default_mode) ? default_mode : Mode::IGNORE
|
|
40
|
+
end
|
|
41
|
+
end
|
|
42
|
+
|
|
43
|
+
def build_i18n_scope(options)
|
|
44
|
+
"#{options[:model].table_name}.#{options[:attribute]}"
|
|
45
|
+
end
|
|
46
|
+
|
|
47
|
+
def get_scopes_from_translations(i18n_scope)
|
|
48
|
+
scopes = %i(base)
|
|
49
|
+
|
|
50
|
+
I18n.available_locales.each do |locale|
|
|
51
|
+
configuration = I18n.t(i18n_scope, locale: locale, default: {})
|
|
52
|
+
configuration.each_key do |scope|
|
|
53
|
+
scopes << scope.to_sym unless scopes.include?(scope.to_sym)
|
|
54
|
+
end
|
|
55
|
+
end
|
|
56
|
+
|
|
57
|
+
scopes
|
|
58
|
+
end
|
|
59
|
+
|
|
60
|
+
def get_missing_keys_by_locale(options, i18n_scope, scopes)
|
|
61
|
+
I18n.available_locales.each_with_object({}) do |locale, missing_keys_by_locale|
|
|
62
|
+
missing_keys = []
|
|
63
|
+
|
|
64
|
+
scopes.each do |scope|
|
|
65
|
+
options[:values].each do |value|
|
|
66
|
+
value_i18n_scope = "#{i18n_scope}.#{scope}.#{value}"
|
|
67
|
+
next if I18n.exists?(value_i18n_scope, locale: locale)
|
|
68
|
+
|
|
69
|
+
missing_keys << value_i18n_scope
|
|
70
|
+
end
|
|
71
|
+
end
|
|
72
|
+
|
|
73
|
+
missing_keys_by_locale[locale] = missing_keys
|
|
74
|
+
end
|
|
75
|
+
end
|
|
76
|
+
|
|
77
|
+
def log_missing_keys(options, scopes, missing_keys_by_locale)
|
|
78
|
+
prefix = "ND::Enum: #{options[:model_name]}##{options[:attribute]}"
|
|
79
|
+
logger.info("#{prefix} scopes=#{scopes}")
|
|
80
|
+
|
|
81
|
+
missing_keys_by_locale.each do |locale, missing_keys|
|
|
82
|
+
logger.info("#{prefix} locale=#{locale} missing_keys=#{missing_keys}")
|
|
83
|
+
end
|
|
84
|
+
end
|
|
85
|
+
|
|
86
|
+
def logger
|
|
87
|
+
@_logger ||= Logger.new(STDOUT)
|
|
88
|
+
end
|
|
89
|
+
|
|
90
|
+
def configuration
|
|
91
|
+
ND::Enum.configuration
|
|
92
|
+
end
|
|
93
|
+
end
|
|
94
|
+
end
|
data/lib/nd/enum.rb
ADDED
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
require 'active_record'
|
|
4
|
+
require 'active_record/enum.rb'
|
|
5
|
+
|
|
6
|
+
require 'active_support'
|
|
7
|
+
require 'active_support/core_ext/string/inflections.rb'
|
|
8
|
+
|
|
9
|
+
require_relative 'enum/version'
|
|
10
|
+
require_relative 'enum/base'
|
|
11
|
+
require_relative 'enum/configuration'
|
|
12
|
+
require_relative 'enum/i18n'
|
|
13
|
+
|
|
14
|
+
module ND::Enum
|
|
15
|
+
extend ActiveSupport::Concern
|
|
16
|
+
|
|
17
|
+
included do
|
|
18
|
+
def self.nd_enum(db: false, i18n: {}, model: self, model_name: nil, **configuration)
|
|
19
|
+
options = ND::Enum.set_options(binding, model, model_name)
|
|
20
|
+
enum_module = ND::Enum.define_module(options)
|
|
21
|
+
|
|
22
|
+
ND::Enum.define_db_enum(options, enum_module) if options[:db]
|
|
23
|
+
ND::Enum::I18n.validate!(options)
|
|
24
|
+
|
|
25
|
+
const_set(options[:attribute].to_s.camelize, enum_module)
|
|
26
|
+
end
|
|
27
|
+
end
|
|
28
|
+
|
|
29
|
+
class Error < StandardError; end
|
|
30
|
+
class MissingTranslationError < Error
|
|
31
|
+
def message
|
|
32
|
+
'One or several translations are missing'
|
|
33
|
+
end
|
|
34
|
+
end
|
|
35
|
+
|
|
36
|
+
class << self
|
|
37
|
+
include ND::Enum::Configuration
|
|
38
|
+
|
|
39
|
+
def set_options(caller_binding, caller_class, caller_class_name)
|
|
40
|
+
options = caller_class.method(:nd_enum).parameters.each_with_object({}) do |(_, name), options|
|
|
41
|
+
options[name.to_sym] = caller_binding.local_variable_get(name)
|
|
42
|
+
end
|
|
43
|
+
options[:attribute], options[:values] = options.delete(:configuration).to_a.first
|
|
44
|
+
options[:model] = caller_class
|
|
45
|
+
options[:model_name] = caller_class_name
|
|
46
|
+
|
|
47
|
+
options
|
|
48
|
+
end
|
|
49
|
+
|
|
50
|
+
def define_module(options)
|
|
51
|
+
Module.new do
|
|
52
|
+
include ND::Enum::Base
|
|
53
|
+
|
|
54
|
+
# Public methods
|
|
55
|
+
|
|
56
|
+
define_singleton_method(:all) { options[:values] }
|
|
57
|
+
|
|
58
|
+
# Private methods
|
|
59
|
+
|
|
60
|
+
define_singleton_method(:options) { options }
|
|
61
|
+
options.each_key do |name|
|
|
62
|
+
define_singleton_method(name) { options[name] }
|
|
63
|
+
end
|
|
64
|
+
|
|
65
|
+
[:options, *options.keys].each do |method_name|
|
|
66
|
+
singleton_class.class_eval { private method_name.to_sym }
|
|
67
|
+
end
|
|
68
|
+
|
|
69
|
+
# Constants
|
|
70
|
+
|
|
71
|
+
options[:values].map do |value|
|
|
72
|
+
const_set(value.to_s.upcase, value.to_s)
|
|
73
|
+
end
|
|
74
|
+
end
|
|
75
|
+
end
|
|
76
|
+
|
|
77
|
+
def define_db_enum(options, enum_module)
|
|
78
|
+
enum_options = options[:db].is_a?(Hash) ? options[:db] : {}
|
|
79
|
+
|
|
80
|
+
enum_options[:_prefix] = enum_options.delete(:prefix) if enum_options.key?(:prefix)
|
|
81
|
+
enum_options[:_suffix] = enum_options.delete(:suffix) if enum_options.key?(:suffix)
|
|
82
|
+
|
|
83
|
+
options[:model].enum(options[:attribute] => enum_module.to_h, **enum_options)
|
|
84
|
+
end
|
|
85
|
+
end
|
|
86
|
+
end
|
|
87
|
+
|
|
88
|
+
class ActiveRecord::Base
|
|
89
|
+
include ND::Enum
|
|
90
|
+
end
|
data/nd-enum.gemspec
ADDED
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
require_relative 'lib/nd/enum/version'
|
|
4
|
+
|
|
5
|
+
Gem::Specification.new do |spec|
|
|
6
|
+
spec.name = 'nd-enum'
|
|
7
|
+
spec.version = ND::Enum::VERSION
|
|
8
|
+
spec.authors = ['Romain Clavel']
|
|
9
|
+
spec.email = ['romain@clavel.io']
|
|
10
|
+
|
|
11
|
+
spec.summary = 'Powerful enum for Rails models.'
|
|
12
|
+
spec.homepage = 'https://github.com/rclavel/nd-enum'
|
|
13
|
+
spec.license = 'MIT'
|
|
14
|
+
spec.required_ruby_version = '>= 2.6.0'
|
|
15
|
+
|
|
16
|
+
spec.metadata['homepage_uri'] = spec.homepage
|
|
17
|
+
spec.metadata['source_code_uri'] = 'https://github.com/rclavel/nd-enum'
|
|
18
|
+
spec.metadata['changelog_uri'] = 'https://github.com/rclavel/nd-enum/blob/master/CHANGELOG.md'
|
|
19
|
+
|
|
20
|
+
# Specify which files should be added to the gem when it is released.
|
|
21
|
+
# The `git ls-files -z` loads the files in the RubyGem that have been added into git.
|
|
22
|
+
spec.files = Dir.chdir(__dir__) do
|
|
23
|
+
`git ls-files -z`.split("\x0").reject do |f|
|
|
24
|
+
(f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
|
|
25
|
+
end
|
|
26
|
+
end
|
|
27
|
+
spec.bindir = 'exe'
|
|
28
|
+
spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
|
|
29
|
+
spec.require_paths = ['lib']
|
|
30
|
+
|
|
31
|
+
# Uncomment to register a new dependency of your gem
|
|
32
|
+
spec.add_dependency 'activesupport', '>= 6.0.0'
|
|
33
|
+
spec.add_dependency 'activerecord', '>= 6.0.0'
|
|
34
|
+
|
|
35
|
+
# For more information and examples about making a new gem, check out our
|
|
36
|
+
# guide at: https://bundler.io/guides/creating_gem.html
|
|
37
|
+
end
|
data/sig/nd/enum.rbs
ADDED
metadata
CHANGED
|
@@ -1,22 +1,65 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: nd-enum
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.2.0
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Romain Clavel
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: exe
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2022-08-
|
|
12
|
-
dependencies:
|
|
11
|
+
date: 2022-08-10 00:00:00.000000000 Z
|
|
12
|
+
dependencies:
|
|
13
|
+
- !ruby/object:Gem::Dependency
|
|
14
|
+
name: activesupport
|
|
15
|
+
requirement: !ruby/object:Gem::Requirement
|
|
16
|
+
requirements:
|
|
17
|
+
- - ">="
|
|
18
|
+
- !ruby/object:Gem::Version
|
|
19
|
+
version: 6.0.0
|
|
20
|
+
type: :runtime
|
|
21
|
+
prerelease: false
|
|
22
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
23
|
+
requirements:
|
|
24
|
+
- - ">="
|
|
25
|
+
- !ruby/object:Gem::Version
|
|
26
|
+
version: 6.0.0
|
|
27
|
+
- !ruby/object:Gem::Dependency
|
|
28
|
+
name: activerecord
|
|
29
|
+
requirement: !ruby/object:Gem::Requirement
|
|
30
|
+
requirements:
|
|
31
|
+
- - ">="
|
|
32
|
+
- !ruby/object:Gem::Version
|
|
33
|
+
version: 6.0.0
|
|
34
|
+
type: :runtime
|
|
35
|
+
prerelease: false
|
|
36
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
37
|
+
requirements:
|
|
38
|
+
- - ">="
|
|
39
|
+
- !ruby/object:Gem::Version
|
|
40
|
+
version: 6.0.0
|
|
13
41
|
description:
|
|
14
42
|
email:
|
|
15
43
|
- romain@clavel.io
|
|
16
44
|
executables: []
|
|
17
45
|
extensions: []
|
|
18
46
|
extra_rdoc_files: []
|
|
19
|
-
files:
|
|
47
|
+
files:
|
|
48
|
+
- ".rspec"
|
|
49
|
+
- CHANGELOG.md
|
|
50
|
+
- Gemfile
|
|
51
|
+
- Gemfile.lock
|
|
52
|
+
- Guardfile
|
|
53
|
+
- LICENSE.txt
|
|
54
|
+
- README.md
|
|
55
|
+
- Rakefile
|
|
56
|
+
- lib/nd/enum.rb
|
|
57
|
+
- lib/nd/enum/base.rb
|
|
58
|
+
- lib/nd/enum/configuration.rb
|
|
59
|
+
- lib/nd/enum/i18n.rb
|
|
60
|
+
- lib/nd/enum/version.rb
|
|
61
|
+
- nd-enum.gemspec
|
|
62
|
+
- sig/nd/enum.rbs
|
|
20
63
|
homepage: https://github.com/rclavel/nd-enum
|
|
21
64
|
licenses:
|
|
22
65
|
- MIT
|