u-case 3.0.0.rc6 → 3.1.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (17) hide show
  1. checksums.yaml +4 -4
  2. data/.travis.sh +8 -4
  3. data/Gemfile +9 -1
  4. data/README.md +160 -113
  5. data/README.pt-BR.md +181 -134
  6. data/lib/micro/case.rb +20 -15
  7. data/lib/micro/case/config.rb +16 -4
  8. data/lib/micro/case/error.rb +3 -1
  9. data/lib/micro/case/result.rb +54 -49
  10. data/lib/micro/case/result/transitions.rb +20 -0
  11. data/lib/micro/case/safe.rb +2 -2
  12. data/lib/micro/case/utils.rb +1 -0
  13. data/lib/micro/case/version.rb +1 -1
  14. data/lib/micro/case/with_activemodel_validation.rb +3 -1
  15. data/lib/micro/cases/flow.rb +18 -14
  16. data/lib/micro/cases/safe/flow.rb +1 -1
  17. metadata +5 -4
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 1a1e5c36bfc65522732f2e00f8b57a2fe84bbe59a730cb85287f56de7850dea0
4
- data.tar.gz: 22bf46677b24e2f8fb6f3b060ba6bc348a7a8025556d1f3cf6ddf81d0e204279
3
+ metadata.gz: d3472991bd5b3d6198cb7455044ac8144445b61c860ce76ca191eba1f6e09aac
4
+ data.tar.gz: eebefecaa4a27d98f3a558aa17a1731de6639a69cc5011fc6acdf430a7e1f52b
5
5
  SHA512:
6
- metadata.gz: a6276a81c7e006d07922b2b30de0a066e1a9a2bc0856586287a35263e21f9c353d571fbf666a08348988c6f42ea893730008e77ea42f65867c801aa24bf19299
7
- data.tar.gz: 47e3482b444c3b9730a3cc5e37ca78bc26556454c1155045663e9b1c597203fc11584dbc7e6716fefaf093cfb8dbcd5f7db63b84b04d8bd5598e94b00c2dfb7c
6
+ metadata.gz: e8cc6cc9994b30bc71b3a5485123dcd41a5583c195bba9969da41e85efb6ebb964f4ee5e39d02f86e324a2cbea24b420f1a9fa67d1dca410c8a60539873d80b9
7
+ data.tar.gz: 48b7f05a0473dba7885d1907d794b503c44030de29b53e0fd757f71597e37c8d0248db980b071ae8f2492e207bfddb0616b25dd9acbefd219318114f72b73339
data/.travis.sh CHANGED
@@ -3,17 +3,21 @@
3
3
  ruby_v=$(ruby -v)
4
4
 
5
5
  ACTIVEMODEL_VERSION='3.2' bundle update
6
- ACTIVEMODEL_VERSION='3.2' bundle exec rake test
6
+ ACTIVEMODEL_VERSION='3.2' ENABLE_TRANSITIONS='false' bundle exec rake test
7
+ ACTIVEMODEL_VERSION='3.2' ENABLE_TRANSITIONS='true' bundle exec rake test
7
8
 
8
9
  if [[ ! $ruby_v =~ '2.2.0' ]]; then
9
10
  ACTIVEMODEL_VERSION='5.2' bundle update
10
- ACTIVEMODEL_VERSION='5.2' bundle exec rake test
11
+ ACTIVEMODEL_VERSION='5.2' ENABLE_TRANSITIONS='false' bundle exec rake test
12
+ ACTIVEMODEL_VERSION='5.2' ENABLE_TRANSITIONS='true' bundle exec rake test
11
13
  fi
12
14
 
13
15
  if [[ $ruby_v =~ '2.5.' ]] || [[ $ruby_v =~ '2.6.' ]] || [[ $ruby_v =~ '2.7.' ]]; then
14
16
  ACTIVEMODEL_VERSION='6.0' bundle update
15
- ACTIVEMODEL_VERSION='6.0' bundle exec rake test
17
+ ACTIVEMODEL_VERSION='6.0' ENABLE_TRANSITIONS='false' bundle exec rake test
18
+ ACTIVEMODEL_VERSION='6.0' ENABLE_TRANSITIONS='true' bundle exec rake test
16
19
  fi
17
20
 
18
21
  bundle update
19
- bundle exec rake test
22
+ ENABLE_TRANSITIONS='false' bundle exec rake test
23
+ ENABLE_TRANSITIONS='true' bundle exec rake test
data/Gemfile CHANGED
@@ -15,9 +15,17 @@ if activemodel_version < '6.1.0'
15
15
  gem 'activesupport', activemodel, require: false
16
16
  end
17
17
 
18
+ simplecov_version =
19
+ case RUBY_VERSION
20
+ when /\A2.[23]/ then '~> 0.17.1'
21
+ when /\A2.4/ then '~> 0.18.5'
22
+ else '~> 0.19'
23
+ end
24
+
18
25
  group :test do
19
26
  gem 'minitest', activemodel_version < '4.1' ? '~> 4.2' : '~> 5.0'
20
- gem 'simplecov', require: false
27
+
28
+ gem 'simplecov', simplecov_version, require: false
21
29
  end
22
30
 
23
31
  pry_byebug_version =
data/README.md CHANGED
@@ -1,12 +1,29 @@
1
- ![Ruby](https://img.shields.io/badge/ruby-2.2+-ruby.svg?colorA=99004d&colorB=cc0066)
2
- [![Gem](https://img.shields.io/gem/v/u-case.svg?style=flat-square)](https://rubygems.org/gems/u-case)
3
- [![Build Status](https://travis-ci.com/serradura/u-case.svg?branch=main)](https://travis-ci.com/serradura/u-case)
4
- [![Maintainability](https://api.codeclimate.com/v1/badges/5c3c8ad1b0b943f88efd/maintainability)](https://codeclimate.com/github/serradura/u-case/maintainability)
5
- [![Test Coverage](https://api.codeclimate.com/v1/badges/5c3c8ad1b0b943f88efd/test_coverage)](https://codeclimate.com/github/serradura/u-case/test_coverage)
1
+ <p align="center">
2
+ <img src="./assets/ucase_logo_v1.png" alt="u-case - Create simple and powerful use cases as Ruby objects.">
6
3
 
7
- <img src="./assets/ucase_logo_v1.png" alt="u-case - Create simple and powerful use cases as Ruby objects.">
4
+ <p align="center"><i>Create simple and powerful use cases as Ruby objects.</i></p>
5
+ <br>
6
+ </p>
8
7
 
9
- Create simple and powerful use cases as Ruby objects.
8
+ <p align="center">
9
+ <img src="https://img.shields.io/badge/ruby-2.2+-ruby.svg?colorA=99004d&colorB=cc0066" alt="Ruby">
10
+
11
+ <a href="https://rubygems.org/gems/u-case">
12
+ <img alt="Gem" src="https://img.shields.io/gem/v/u-case.svg?style=flat-square">
13
+ </a>
14
+
15
+ <a href="https://travis-ci.com/serradura/u-case">
16
+ <img alt="Build Status" src="https://travis-ci.com/serradura/u-case.svg?branch=main">
17
+ </a>
18
+
19
+ <a href="https://codeclimate.com/github/serradura/u-case/maintainability">
20
+ <img alt="Maintainability" src="https://api.codeclimate.com/v1/badges/5c3c8ad1b0b943f88efd/maintainability">
21
+ </a>
22
+
23
+ <a href="https://codeclimate.com/github/serradura/u-case/test_coverage">
24
+ <img alt="Test Coverage" src="https://api.codeclimate.com/v1/badges/5c3c8ad1b0b943f88efd/test_coverage">
25
+ </a>
26
+ </p>
10
27
 
11
28
  The main project goals are:
12
29
  1. Easy to use and easy to learn (input **>>** process **>>** output).
@@ -21,7 +38,7 @@ The main project goals are:
21
38
 
22
39
  Version | Documentation
23
40
  --------- | -------------
24
- 3.0.0.rc5 | https://github.com/serradura/u-case/blob/main/README.md
41
+ 3.1.0 | https://github.com/serradura/u-case/blob/main/README.md
25
42
  2.6.0 | https://github.com/serradura/u-case/blob/v2.x/README.md
26
43
  1.1.0 | https://github.com/serradura/u-case/blob/v1.x/README.md
27
44
 
@@ -60,15 +77,15 @@ Version | Documentation
60
77
  - [`Kind::Validator`](#kindvalidator)
61
78
  - [`Micro::Case.config`](#microcaseconfig)
62
79
  - [Benchmarks](#benchmarks)
63
- - [`Micro::Case` (v3.0.0)](#microcase-v300)
80
+ - [`Micro::Case`](#microcase)
64
81
  - [Success results](#success-results)
65
82
  - [Failure results](#failure-results)
66
- - [`Micro::Cases::Flow` (v3.0.0)](#microcasesflow-v300)
83
+ - [`Micro::Cases::Flow`](#microcasesflow)
67
84
  - [Comparisons](#comparisons)
68
85
  - [Examples](#examples)
69
- - [1️⃣ Rails App (API)](#1️⃣-rails-app-api)
70
- - [2️⃣ CLI calculator](#2️⃣-cli-calculator)
71
- - [3️⃣ Users creation](#3️⃣-users-creation)
86
+ - [1️⃣ Users creation](#1️⃣-users-creation)
87
+ - [2️⃣ Rails App (API)](#2️⃣-rails-app-api)
88
+ - [3️⃣ CLI calculator](#3️⃣-cli-calculator)
72
89
  - [4️⃣ Rescuing exceptions inside of the use cases](#4️⃣-rescuing-exceptions-inside-of-the-use-cases)
73
90
  - [Development](#development)
74
91
  - [Contributing](#contributing)
@@ -79,7 +96,7 @@ Version | Documentation
79
96
 
80
97
  | u-case | branch | ruby | activemodel |
81
98
  | -------------- | ------- | -------- | ------------- |
82
- | 3.0.0.rc5 | main | >= 2.2.0 | >= 3.2, < 6.1 |
99
+ | 3.1.0 | main | >= 2.2.0 | >= 3.2, < 6.1 |
83
100
  | 2.6.0 | v2.x | >= 2.2.0 | >= 3.2, < 6.1 |
84
101
  | 1.1.0 | v1.x | >= 2.2.0 | >= 3.2, < 6.1 |
85
102
 
@@ -102,7 +119,7 @@ Version | Documentation
102
119
  Add this line to your application's Gemfile:
103
120
 
104
121
  ```ruby
105
- gem 'u-case', '~> 3.0.0.rc5'
122
+ gem 'u-case', '~> 3.1.0'
106
123
  ```
107
124
 
108
125
  And then execute:
@@ -1060,7 +1077,7 @@ class Multiply < Micro::Case
1060
1077
  validates :a, :b, presence: true, numericality: true
1061
1078
 
1062
1079
  def call!
1063
- return Failure :validation_error, result: { errors: self.errors } if invalid?
1080
+ return Failure :invalid_attributes, result: { errors: self.errors } if invalid?
1064
1081
 
1065
1082
  Success result: { number: a * b }
1066
1083
  end
@@ -1170,48 +1187,48 @@ end
1170
1187
 
1171
1188
  ## Benchmarks
1172
1189
 
1173
- ### `Micro::Case` (v3.0.0)
1190
+ ### `Micro::Case`
1174
1191
 
1175
1192
  #### Success results
1176
1193
 
1177
1194
  | Gem / Abstraction | Iterations per second | Comparison |
1178
1195
  | ----------------- | --------------------: | ----------------: |
1179
- | Dry::Monads | 139037.7 | _**The Fastest**_ |
1180
- | **Micro::Case** | 101497.3 | 1.37x slower |
1181
- | Interactor | 30694.2 | 4.53x slower |
1182
- | Trailblazer::Operation | 14580.8 | 9.54x slower |
1183
- | Dry::Transaction | 5728.0 | 24.27x slower |
1196
+ | Dry::Monads | 141730.1 | _**The Fastest**_ |
1197
+ | **Micro::Case** | 103541.3 | 1.37x slower |
1198
+ | Interactor | 29100.8 | 4.87x slower |
1199
+ | Trailblazer::Operation | 15031.4 | 9.43x slower |
1200
+ | Dry::Transaction | 5674.0 | 24.98x slower |
1184
1201
 
1185
1202
  <details>
1186
1203
  <summary>Show the full <a href="https://github.com/evanphx/benchmark-ips">benchmark/ips</a> results.</summary>
1187
1204
 
1188
1205
  ```ruby
1189
1206
  # Warming up --------------------------------------
1190
- # Interactor 3.056k i/100ms
1191
- # Trailblazer::Operation 1.480k i/100ms
1192
- # Dry::Monads 14.316k i/100ms
1193
- # Dry::Transaction 576.000 i/100ms
1194
- # Micro::Case 10.388k i/100ms
1195
- # Micro::Case::Strict 8.223k i/100ms
1196
- # Micro::Case::Safe 10.057k i/100ms
1207
+ # Interactor 2.915k i/100ms
1208
+ # Trailblazer::Operation 1.543k i/100ms
1209
+ # Dry::Monads 14.288k i/100ms
1210
+ # Dry::Transaction 571.000 i/100ms
1211
+ # Micro::Case 10.418k i/100ms
1212
+ # Micro::Case::Strict 8.296k i/100ms
1213
+ # Micro::Case::Safe 10.254k i/100ms
1197
1214
 
1198
1215
  # Calculating -------------------------------------
1199
- # Interactor 30.694k (± 2.3%) i/s - 155.856k in 5.080475s
1200
- # Trailblazer::Operation 14.581k (± 3.9%) i/s - 74.000k in 5.083091s
1201
- # Dry::Monads 139.038k (± 3.0%) i/s - 701.484k in 5.049921s
1202
- # Dry::Transaction 5.728k (± 3.6%) i/s - 28.800k in 5.034599s
1203
- # Micro::Case 100.712k (± 3.4%) i/s - 509.012k in 5.060139s
1204
- # Micro::Case::Strict 81.513k (± 3.4%) i/s - 411.150k in 5.049962s
1205
- # Micro::Case::Safe 101.497k (± 3.1%) i/s - 512.907k in 5.058463s
1216
+ # Interactor 29.101k (± 2.1%) i/s - 145.750k in 5.010660s
1217
+ # Trailblazer::Operation 15.031k (± 2.0%) i/s - 75.607k in 5.032071s
1218
+ # Dry::Monads 141.730k (± 3.1%) i/s - 714.400k in 5.045546s
1219
+ # Dry::Transaction 5.674k (± 1.9%) i/s - 28.550k in 5.033564s
1220
+ # Micro::Case 103.541k (± 1.6%) i/s - 520.900k in 5.032077s
1221
+ # Micro::Case::Strict 83.045k (± 2.4%) i/s - 423.096k in 5.098031s
1222
+ # Micro::Case::Safe 101.662k (± 1.5%) i/s - 512.700k in 5.044386s
1206
1223
 
1207
1224
  # Comparison:
1208
- # Dry::Monads: 139037.7 i/s
1209
- # Micro::Case::Safe: 101497.3 i/s - 1.37x (± 0.00) slower
1210
- # Micro::Case: 100711.6 i/s - 1.38x (± 0.00) slower
1211
- # Micro::Case::Strict: 81512.9 i/s - 1.71x (± 0.00) slower
1212
- # Interactor: 30694.2 i/s - 4.53x (± 0.00) slower
1213
- # Trailblazer::Operation: 14580.8 i/s - 9.54x (± 0.00) slower
1214
- # Dry::Transaction: 5728.0 i/s - 24.27x (± 0.00) slower
1225
+ # Dry::Monads: 141730.1 i/s
1226
+ # Micro::Case: 103541.3 i/s - 1.37x (± 0.00) slower
1227
+ # Micro::Case::Safe: 101662.2 i/s - 1.39x (± 0.00) slower
1228
+ # Micro::Case::Strict: 83044.6 i/s - 1.71x (± 0.00) slower
1229
+ # Interactor: 29100.8 i/s - 4.87x (± 0.00) slower
1230
+ # Trailblazer::Operation: 15031.4 i/s - 9.43x (± 0.00) slower
1231
+ # Dry::Transaction: 5674.0 i/s - 24.98x (± 0.00) slower
1215
1232
  ```
1216
1233
  </details>
1217
1234
 
@@ -1221,42 +1238,42 @@ https://github.com/serradura/u-case/blob/main/benchmarks/use_case/with_success_r
1221
1238
 
1222
1239
  | Gem / Abstraction | Iterations per second | Comparison |
1223
1240
  | ----------------- | --------------------: | ----------------: |
1224
- | **Micro::Case** | 94619.6 | _**The Fastest**_ |
1225
- | Dry::Monads | 70250.6 | 1.35x slower |
1226
- | Trailblazer::Operation | 14786.1 | 6.40x slower |
1227
- | Interactor | 13770.0 | 6.87x slower |
1228
- | Dry::Transaction | 4994.4 | 18.95x slower |
1241
+ | **Micro::Case** | 98820.8 | _**The Fastest**_ |
1242
+ | Dry::Monads | 71329.7 | 1.39x slower |
1243
+ | Trailblazer::Operation | 15034.9 | 6.57x slower |
1244
+ | Interactor | 13958.7 | 7.08x slower |
1245
+ | Dry::Transaction | 5067.5 | 19.50x slower |
1229
1246
 
1230
1247
  <details>
1231
1248
  <summary>Show the full <a href="https://github.com/evanphx/benchmark-ips">benchmark/ips</a> results.</summary>
1232
1249
 
1233
1250
  ```ruby
1234
1251
  # Warming up --------------------------------------
1235
- # Interactor 1.408k i/100ms
1236
- # Trailblazer::Operation 1.492k i/100ms
1237
- # Dry::Monads 7.224k i/100ms
1238
- # Dry::Transaction 501.000 i/100ms
1239
- # Micro::Case 9.664k i/100ms
1240
- # Micro::Case::Strict 7.823k i/100ms
1241
- # Micro::Case::Safe 9.464k i/100ms
1252
+ # Interactor 1.324k i/100ms
1253
+ # Trailblazer::Operation 1.525k i/100ms
1254
+ # Dry::Monads 7.126k i/100ms
1255
+ # Dry::Transaction 499.000 i/100ms
1256
+ # Micro::Case 9.919k i/100ms
1257
+ # Micro::Case::Strict 7.837k i/100ms
1258
+ # Micro::Case::Safe 9.762k i/100ms
1242
1259
 
1243
1260
  # Calculating -------------------------------------
1244
- # Interactor 13.770k (± 4.3%) i/s - 68.992k in 5.020330s
1245
- # Trailblazer::Operation 14.786k (± 5.3%) i/s - 74.600k in 5.064700s
1246
- # Dry::Monads 70.251k (± 6.7%) i/s - 353.976k in 5.063010s
1247
- # Dry::Transaction 4.994k (± 4.0%) i/s - 25.050k in 5.023997s
1248
- # Micro::Case 94.620k (± 3.8%) i/s - 473.536k in 5.012483s
1249
- # Micro::Case::Strict 76.059k (± 3.0%) i/s - 383.327k in 5.044482s
1250
- # Micro::Case::Safe 91.719k (± 5.6%) i/s - 463.736k in 5.072552s
1261
+ # Interactor 13.959k (± 2.5%) i/s - 70.172k in 5.030240s
1262
+ # Trailblazer::Operation 15.035k (± 2.2%) i/s - 76.250k in 5.074108s
1263
+ # Dry::Monads 71.330k (± 2.4%) i/s - 363.426k in 5.097993s
1264
+ # Dry::Transaction 5.068k (± 1.9%) i/s - 25.449k in 5.023922s
1265
+ # Micro::Case 98.821k (± 2.9%) i/s - 495.950k in 5.023421s
1266
+ # Micro::Case::Strict 79.936k (± 3.1%) i/s - 399.687k in 5.005435s
1267
+ # Micro::Case::Safe 98.695k (± 1.9%) i/s - 497.862k in 5.046246s
1251
1268
 
1252
1269
  # Comparison:
1253
- # Micro::Case: 94619.6 i/s
1254
- # Micro::Case::Safe: 91719.4 i/s - same-ish: difference falls within error
1255
- # Micro::Case::Strict: 76058.7 i/s - 1.24x (± 0.00) slower
1256
- # Dry::Monads: 70250.6 i/s - 1.35x (± 0.00) slower
1257
- # Trailblazer::Operation: 14786.1 i/s - 6.40x (± 0.00) slower
1258
- # Interactor: 13770.0 i/s - 6.87x (± 0.00) slower
1259
- # Dry::Transaction: 4994.4 i/s - 18.95x (± 0.00) slower
1270
+ # Micro::Case: 98820.8 i/s
1271
+ # Micro::Case::Safe: 98695.0 i/s - same-ish: difference falls within error
1272
+ # Micro::Case::Strict: 79935.9 i/s - 1.24x (± 0.00) slower
1273
+ # Dry::Monads: 71329.7 i/s - 1.39x (± 0.00) slower
1274
+ # Trailblazer::Operation: 15034.9 i/s - 6.57x (± 0.00) slower
1275
+ # Interactor: 13958.7 i/s - 7.08x (± 0.00) slower
1276
+ # Dry::Transaction: 5067.5 i/s - 19.50x (± 0.00) slower
1260
1277
  ```
1261
1278
  </details>
1262
1279
 
@@ -1264,15 +1281,16 @@ https://github.com/serradura/u-case/blob/main/benchmarks/use_case/with_failure_r
1264
1281
 
1265
1282
  ---
1266
1283
 
1267
- ### `Micro::Cases::Flow` (v3.0.0)
1284
+ ### `Micro::Cases::Flow`
1268
1285
 
1269
1286
  | Gems / Abstraction | [Success results](https://github.com/serradura/u-case/blob/main/benchmarks/flow/with_success_result.rb#L40) | [Failure results](https://github.com/serradura/u-case/blob/main/benchmarks/flow/with_failure_result.rb#L40) |
1270
1287
  | ------------------------------------------- | ----------------: | ----------------: |
1271
1288
  | Micro::Case internal flow (private methods) | _**The Fastest**_ | _**The Fastest**_ |
1272
- | Micro::Case `then` method | 1.48x slower | 0x slower |
1273
- | Micro::Cases.flow | 1.62x slower | 1.16x slower |
1274
- | Micro::Cases.safe_flow | 1.64x slower | 1.16x slower |
1275
- | Interactor::Organizer | 1.95x slower | 6.17x slower |
1289
+ | Micro::Case internal flow (through lambdas) | 1.03x slower | 1.04x slower |
1290
+ | Micro::Case `then` method | 1.49x slower | 0x slower |
1291
+ | Micro::Cases.flow | 1.53x slower | 1.04x slower |
1292
+ | Micro::Cases.safe_flow | 1.54x slower | 1.04x slower |
1293
+ | Interactor::Organizer | 2.05x slower | 6.27x slower |
1276
1294
 
1277
1295
  \* The `Dry::Monads`, `Dry::Transaction`, `Trailblazer::Operation` gems are out of this analysis because all of them doesn't have this kind of feature.
1278
1296
 
@@ -1281,25 +1299,40 @@ https://github.com/serradura/u-case/blob/main/benchmarks/use_case/with_failure_r
1281
1299
 
1282
1300
  ```ruby
1283
1301
  # Warming up --------------------------------------
1284
- # Interactor::Organizer 5.219k i/100ms
1285
- # Micro::Cases.flow([]) 6.451k i/100ms
1286
- # Micro::Cases::safe_flow([]) 6.421k i/100ms
1287
- # Micro::Case flow using `then` method 7.139k i/100ms
1288
- # Micro::Case flow using private methods 10.355k i/100ms
1302
+ # Interactor::Organizer
1303
+ # 4.837k i/100ms
1304
+ # Micro::Cases.flow([])
1305
+ # 6.755k i/100ms
1306
+ # Micro::Cases::safe_flow([])
1307
+ # 6.809k i/100ms
1308
+ # Micro::Case flow using `then` method
1309
+ # 6.968k i/100ms
1310
+ # Micro::Case flow using private methods
1311
+ # 10.362k i/100ms
1312
+ # Micro::Case flow using private methods through lambdas
1313
+ # 10.258k i/100ms
1289
1314
 
1290
1315
  # Calculating -------------------------------------
1291
- # Interactor::Organizer 52.959k (± 1.7%) i/s - 266.169k in 5.027332s
1292
- # Micro::Cases.flow([]) 63.947k (± 1.7%) i/s - 322.550k in 5.045597s
1293
- # Micro::Cases::safe_flow([]) 63.047k (± 3.1%) i/s - 321.050k in 5.097228s
1294
- # Micro::Case flow using `then` method 69.644k (± 4.0%) i/s - 349.811k in 5.031120s
1295
- # Micro::Case flow using private methods 103.297k (± 1.4%) i/s - 517.750k in 5.013254s
1316
+ # Interactor::Organizer
1317
+ # 50.731k (± 1.6%) i/s - 256.361k in 5.054694s
1318
+ # Micro::Cases.flow([])
1319
+ # 67.757k (± 1.6%) i/s - 344.505k in 5.085681s
1320
+ # Micro::Cases::safe_flow([])
1321
+ # 67.613k (± 1.6%) i/s - 340.450k in 5.036562s
1322
+ # Micro::Case flow using `then` method
1323
+ # 69.483k (± 1.5%) i/s - 348.400k in 5.015351s
1324
+ # Micro::Case flow using private methods
1325
+ # 103.788k (± 1.0%) i/s - 528.462k in 5.092240s
1326
+ # Micro::Case flow using private methods through lambdas
1327
+ # 101.081k (± 1.2%) i/s - 512.900k in 5.074904s
1296
1328
 
1297
1329
  # Comparison:
1298
- # Micro::Case flow using private methods: 103297.4 i/s
1299
- # Micro::Case flow using `then` method: 69644.0 i/s - 1.48x (± 0.00) slower
1300
- # Micro::Cases.flow([]): 63946.7 i/s - 1.62x (± 0.00) slower
1301
- # Micro::Cases::safe_flow([]): 63047.2 i/s - 1.64x (± 0.00) slower
1302
- # Interactor::Organizer: 52958.9 i/s - 1.95x (± 0.00) slower
1330
+ # Micro::Case flow using private methods: 103787.5 i/s
1331
+ # Micro::Case flow using private methods through lambdas: 101080.6 i/s - 1.03x (± 0.00) slower
1332
+ # Micro::Case flow using `then` method: 69483.3 i/s - 1.49x (± 0.00) slower
1333
+ # Micro::Cases.flow([]): 67757.2 i/s - 1.53x (± 0.00) slower
1334
+ # Micro::Cases::safe_flow([]): 67613.3 i/s - 1.54x (± 0.00) slower
1335
+ # Interactor::Organizer: 50730.8 i/s - 2.05x (± 0.00) slower
1303
1336
  ```
1304
1337
  </details>
1305
1338
 
@@ -1308,25 +1341,39 @@ https://github.com/serradura/u-case/blob/main/benchmarks/use_case/with_failure_r
1308
1341
 
1309
1342
  ```ruby
1310
1343
  # Warming up --------------------------------------
1311
- # Interactor::Organizer 2.381k i/100ms
1312
- # Micro::Cases.flow([]) 12.003k i/100ms
1313
- # Micro::Cases::safe_flow([]) 12.771k i/100ms
1314
- # Micro::Case flow using `then` method 15.085k i/100ms
1315
- # Micro::Case flow using private methods 14.254k i/100ms
1316
-
1344
+ # Interactor::Organizer
1345
+ # 2.299k i/100ms
1346
+ # Micro::Cases.flow([])
1347
+ # 14.187k i/100ms
1348
+ # Micro::Cases::safe_flow([])
1349
+ # 13.609k i/100ms
1350
+ # Micro::Case flow using `then` method
1351
+ # 14.578k i/100ms
1352
+ # Micro::Case flow using private methods
1353
+ # 14.101k i/100ms
1354
+ # Micro::Case flow using private methods through lambdas
1355
+ # 13.670k i/100ms
1317
1356
  # Calculating -------------------------------------
1318
- # Interactor::Organizer 23.579k (± 3.2%) i/s - 119.050k in 5.054410s
1319
- # Micro::Cases.flow([]) 124.072k (± 3.4%) i/s - 624.156k in 5.036618s
1320
- # Micro::Cases::safe_flow([]) 124.894k (± 3.6%) i/s - 625.779k in 5.017494s
1321
- # Micro::Case flow using `then` method 145.370k (± 4.8%) i/s - 739.165k in 5.096972s
1322
- # Micro::Case flow using private methods 139.753k (± 5.6%) i/s - 698.446k in 5.015207s
1357
+ # Interactor::Organizer
1358
+ # 23.306k (± 2.1%) i/s - 117.249k in 5.033171s
1359
+ # Micro::Cases.flow([])
1360
+ # 140.111k (± 1.6%) i/s - 709.350k in 5.064041s
1361
+ # Micro::Cases::safe_flow([])
1362
+ # 139.927k (± 1.7%) i/s - 707.668k in 5.058971s
1363
+ # Micro::Case flow using `then` method
1364
+ # 146.073k (± 2.0%) i/s - 743.478k in 5.091741s
1365
+ # Micro::Case flow using private methods
1366
+ # 142.092k (± 1.5%) i/s - 719.151k in 5.062298s
1367
+ # Micro::Case flow using private methods through lambdas
1368
+ # 140.791k (± 1.2%) i/s - 710.840k in 5.049584s
1323
1369
 
1324
1370
  # Comparison:
1325
- # Micro::Case flow using `then` method: 145369.7 i/s
1326
- # Micro::Case flow using private methods: 139753.4 i/s - same-ish: difference falls within error
1327
- # Micro::Cases::safe_flow([]): 124893.7 i/s - 1.16x (± 0.00) slower
1328
- # Micro::Cases.flow([]): 124071.8 i/s - 1.17x (± 0.00) slower
1329
- # Interactor::Organizer: 23578.7 i/s - 6.17x (± 0.00) slower
1371
+ # Micro::Case flow using `then` method: 146073.0 i/s
1372
+ # Micro::Case flow using private methods: 142091.7 i/s - same-ish: difference falls within error
1373
+ # Micro::Case flow using private methods through lambdas: 140791.1 i/s - 1.04x (± 0.00) slower
1374
+ # Micro::Cases.flow([]): 140110.8 i/s - 1.04x (± 0.00) slower
1375
+ # Micro::Cases::safe_flow([]): 139926.6 i/s - 1.04x (± 0.00) slower
1376
+ # Interactor::Organizer: 23305.9 i/s - 6.27x (± 0.00) slower
1330
1377
  ```
1331
1378
  </details>
1332
1379
 
@@ -1343,24 +1390,24 @@ Check it out implementations of the same use case with different gems/abstractio
1343
1390
 
1344
1391
  ## Examples
1345
1392
 
1346
- ### 1️⃣ Rails App (API)
1393
+ ### 1️⃣ Users creation
1394
+
1395
+ > An example of a flow that defines steps to sanitize, validate, and persist its input data. It has all possible approaches to represent use cases using the `u-case` gem.
1396
+ >
1397
+ > Link: https://github.com/serradura/u-case/blob/main/examples/users_creation
1398
+
1399
+ ### 2️⃣ Rails App (API)
1347
1400
 
1348
1401
  > This project shows different kinds of architecture (one per commit), and in the last one, how to use the `Micro::Case` gem to handle the application business logic.
1349
1402
  >
1350
1403
  > Link: https://github.com/serradura/from-fat-controllers-to-use-cases
1351
1404
 
1352
- ### 2️⃣ CLI calculator
1405
+ ### 3️⃣ CLI calculator
1353
1406
 
1354
1407
  > Rake tasks to demonstrate how to handle user data, and how to use different failure types to control the program flow.
1355
1408
  >
1356
1409
  > Link: https://github.com/serradura/u-case/tree/main/examples/calculator
1357
1410
 
1358
- ### 3️⃣ Users creation
1359
-
1360
- > An example of a use case flow that defines steps to sanitize, validate, and persist its input data.
1361
- >
1362
- > Link: https://github.com/serradura/u-case/blob/main/examples/users_creation.rb
1363
-
1364
1411
  ### 4️⃣ Rescuing exceptions inside of the use cases
1365
1412
 
1366
1413
  > Link: https://github.com/serradura/u-case/blob/main/examples/rescuing_exceptions.rb