roda-monads 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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
- SHA1:
3
- metadata.gz: d32c5507cf9f2449bc36e21d29f1eeb087217928
4
- data.tar.gz: 9f4d68448df122254a7ddab8eff885ad37abd2b5
2
+ SHA256:
3
+ metadata.gz: dcb1258ede01bcd6c407276d0f610205d390d462407f184cf08b620e2d4226b1
4
+ data.tar.gz: 33f9686b70e5cb2373f546cf58171f512fa0fd97761623c9f481164db14ce6fa
5
5
  SHA512:
6
- metadata.gz: 4610b2553db33325da092ff3748692a2432677669e97b737ec39524cb2c13423be509c7b980c0441fb019a75131c311b4df0e2db1733bd799fbfd96d73fb208f
7
- data.tar.gz: eea560dca3c96ac5365b19386230a04a2dd355c3abf26cdbd61947c4b57c65f2854491893a33498a169a965d91d6cb4e818e64727a29b8ea7c9d56db264b984e
6
+ metadata.gz: 6770812d24035cc1860cea8ef7da931d66f9d297027f1438a6b72a8df7670a1a9e380fccdce6f49ab9cb33b307098eea5780aa9876c0a84e0bd0a31725286e24
7
+ data.tar.gz: 53ce5f6bad43d4aa7ed7a2881ac2dca0be5737ce0c3e0fd860d88bc7cae129c304d661e91f18d3ca9d77631094ae0fc454c85a3368680b6c55dbc79f5a717489
data/Gemfile CHANGED
@@ -1,4 +1,5 @@
1
1
  # frozen_string_literal: true
2
+
2
3
  source 'https://rubygems.org'
3
4
 
4
5
  # Specify your gem's dependencies in roda-monads.gemspec
data/README.md CHANGED
@@ -1,9 +1,5 @@
1
1
  # Roda::Monads
2
2
 
3
- Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/roda/monads`. To experiment with that code, run `bin/console` for an interactive prompt.
4
-
5
- TODO: Delete this and the text above, and describe your gem
6
-
7
3
  ## Installation
8
4
 
9
5
  Add this line to your application's Gemfile:
@@ -14,28 +10,78 @@ gem 'roda-monads'
14
10
 
15
11
  And then execute:
16
12
 
17
- $ bundle
13
+ ```bash
14
+ bundle
15
+ ```
18
16
 
19
17
  Or install it yourself as:
20
18
 
21
- $ gem install roda-monads
19
+ ```bash
20
+ gem install roda-monads
21
+ ```
22
22
 
23
23
  ## Usage
24
24
 
25
- TODO: Write usage instructions here
25
+ ```ruby
26
+ require 'bundler/inline'
27
+
28
+ gemfile do
29
+ gem 'roda-monads'
30
+ end
31
+
32
+ class App < Roda
33
+ plugin :monads
34
+
35
+ route do |r|
36
+ r.on 'value' do
37
+ Success('Alright')
38
+ end
39
+
40
+ r.on 'status' do
41
+ Failure(:unauthorized)
42
+ end
43
+
44
+ r.on 'rack' do
45
+ r.on 'symbol' do
46
+ r.on 'right' do
47
+ Success([:ok, {}, 'OK'])
48
+ end
49
+
50
+ r.on 'left' do
51
+ Failure([:found, { 'Location' => '/rack_right' }, nil])
52
+ end
53
+ end
54
+
55
+ r.on 'right' do
56
+ Success([200, {}, 'OK'])
57
+ end
58
+
59
+ r.on 'left' do
60
+ Failure([:unauthorized, {}, nil])
61
+ end
62
+ end
63
+
64
+ r.on 'neither' do
65
+ 'neither'
66
+ end
67
+ end
68
+ end
69
+ ```
26
70
 
27
71
  ## Development
28
72
 
29
73
  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.
30
74
 
31
- To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, 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 tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
75
+ To install this gem onto your local machine, run `bin/rake install`. To release a new version, update the version number in `version.rb`, and then run `bin/rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
32
76
 
33
77
  ## Contributing
34
78
 
35
- Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/roda-monads. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
79
+ Bug reports and pull requests are welcome on GitHub at https://gitlab.com/alsemyonov/roda-monads. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
36
80
 
37
81
 
38
82
  ## License
39
83
 
40
84
  The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
41
85
 
86
+
87
+ © [Alex Semyonov](https://alex.semyonov.us/), <[alex@semyonov.us](mailto:alex@semyonov.us?subject=roda-monads)> 2017
data/Rakefile CHANGED
@@ -1,4 +1,5 @@
1
1
  # frozen_string_literal: true
2
+
2
3
  require 'bundler/setup'
3
4
 
4
- task default: %i(spec cop bundle:audit doc)
5
+ task default: %i[spec cop bundle:audit doc]
data/bin/rake CHANGED
@@ -1,5 +1,6 @@
1
1
  #!/usr/bin/env ruby
2
2
  # frozen_string_literal: true
3
+
3
4
  #
4
5
  # This file was generated by Bundler.
5
6
  #
data/bin/rspec CHANGED
@@ -1,5 +1,6 @@
1
1
  #!/usr/bin/env ruby
2
2
  # frozen_string_literal: true
3
+
3
4
  #
4
5
  # This file was generated by Bundler.
5
6
  #
@@ -1,5 +1,6 @@
1
1
  #!/usr/bin/env ruby
2
2
  # frozen_string_literal: true
3
+
3
4
  #
4
5
  # This file was generated by Bundler.
5
6
  #
data/bin/yard CHANGED
@@ -1,5 +1,6 @@
1
1
  #!/usr/bin/env ruby
2
2
  # frozen_string_literal: true
3
+
3
4
  #
4
5
  # This file was generated by Bundler.
5
6
  #
data/bin/yardoc CHANGED
@@ -1,5 +1,6 @@
1
1
  #!/usr/bin/env ruby
2
2
  # frozen_string_literal: true
3
+
3
4
  #
4
5
  # This file was generated by Bundler.
5
6
  #
data/bin/yri CHANGED
@@ -1,5 +1,6 @@
1
1
  #!/usr/bin/env ruby
2
2
  # frozen_string_literal: true
3
+
3
4
  #
4
5
  # This file was generated by Bundler.
5
6
  #
@@ -1,4 +1,5 @@
1
1
  # frozen_string_literal: true
2
+
2
3
  require 'roda/monads/version'
3
4
  require 'roda'
4
5
  require 'roda/plugins/monads'
@@ -2,6 +2,6 @@
2
2
 
3
3
  class Roda
4
4
  module Monads
5
- VERSION = '0.1.0'
5
+ VERSION = '0.2.0'
6
6
  end
7
7
  end
@@ -6,8 +6,8 @@ require 'dry-monads'
6
6
  class Roda
7
7
  # Module containing `Roda` plugins.
8
8
  module RodaPlugins
9
- # Makes `Roda` understand `Dry::Monads::Either` monad and provide results
10
- # based on `Right` or `Left` monad handler.
9
+ # Makes `Roda` understand `Dry::Monads::Result` monad and provide results
10
+ # based on `Success` or `Failure` monad handler.
11
11
  #
12
12
  # @see Monads::RequestMethods
13
13
  # @see Monads::InstanceMethods
@@ -16,17 +16,17 @@ class Roda
16
16
  # plugin :monads
17
17
  # route do |r|
18
18
  # r.on '/right' do
19
- # Right('Alright!')
19
+ # Success('Alright!')
20
20
  # end
21
21
  # r.on '/left' do
22
- # Left('Wrong!')
22
+ # Failure('Wrong!')
23
23
  # end
24
24
  # r.on '/rack' do
25
25
  # r.on '/right' do
26
- # Right([:ok, {}, ['Alright!']])
26
+ # Success([:ok, {}, ['Alright!']])
27
27
  # end
28
28
  # r.on '/left' do
29
- # Left('Wrong!')
29
+ # Failure('Wrong!')
30
30
  # end
31
31
  # end
32
32
  # end
@@ -38,11 +38,11 @@ class Roda
38
38
  app.plugin :symbol_status
39
39
  end
40
40
 
41
- # Extends `app` with `Dry::Monads::Either::Mixin` to create monads easily
41
+ # Extends `app` with `Dry::Monads::Result::Mixin` to create monads easily
42
42
  # @param [Roda] app
43
43
  def self.configure(app, *)
44
- app.extend Dry::Monads::Either::Mixin
45
- app.include Dry::Monads::Either::Mixin
44
+ app.extend Dry::Monads::Result::Mixin
45
+ app.include Dry::Monads::Result::Mixin
46
46
  app.either_matcher(:right,
47
47
  aliases: [:value]) { |either| match_right(either) }
48
48
  app.either_matcher(:left,
@@ -66,8 +66,8 @@ class Roda
66
66
  end
67
67
 
68
68
  # Extends {Roda::RodaRequest#block_result}’s with an ability to respond to
69
- # `Dry::Monads::Either` or compatible object (that responds to
70
- # `#to_either` method, returning `Dry::Monads::Either`).
69
+ # `Dry::Monads::Result` or compatible object (that responds to
70
+ # `#to_either` method, returning `Dry::Monads::Result`).
71
71
  module RequestMethods
72
72
  # Handle match block return values. By default, if a string is given
73
73
  # and the response is empty, use the string as the response body.
@@ -78,7 +78,7 @@ class Roda
78
78
 
79
79
  private
80
80
 
81
- # @param [Dry::Monads::Either, #to_either] either
81
+ # @param [Dry::Monads::Result, #to_either] either
82
82
  def match_either(either)
83
83
  either = either.to_either if respond_to?(:to_either)
84
84
  matcher = if rack_either?(either)
@@ -91,31 +91,32 @@ class Roda
91
91
  instance_exec(either, &roda_class.either_matcher(matcher))
92
92
  end
93
93
 
94
- # @param [Dry::Monads::Either::Right] either
94
+ # @param [Dry::Monads::Result::Success] either
95
95
  def match_right(either)
96
96
  return false unless either.right?
97
- populate_body(either.value)
97
+ populate_body(either.success)
98
98
  true
99
99
  end
100
100
 
101
- # @param [Dry::Monads::Either::Left] either
101
+ # @param [Dry::Monads::Result::Failure] either
102
102
  def match_left(either)
103
103
  return false unless either.left?
104
- response.status, body = either.value
104
+ response.status, body = either.failure
105
105
  populate_body(body)
106
106
  true
107
107
  end
108
108
 
109
109
  def match_rack_either(either)
110
- response.status, headers, body = either.value
110
+ response.status, headers, body = either.value_or(&:itself)
111
111
  headers.each { |header, value| response.headers[header] = value }
112
112
  populate_body(body)
113
113
  true
114
114
  end
115
115
 
116
- # @param [Dry::Monads::Either] either
116
+ # @param [Dry::Monads::Result] either
117
117
  def rack_either?(either)
118
- either.value.is_a?(Array) && either.value.size == 3
118
+ value = either.value_or(&:itself)
119
+ value.is_a?(Array) && value.size == 3
119
120
  end
120
121
 
121
122
  # @param [String, Object] body
@@ -123,7 +124,7 @@ class Roda
123
124
  response.write block_result_body(body) if response.empty?
124
125
  end
125
126
 
126
- # @param [Dry::Monads::Either, #to_either] either
127
+ # @param [Dry::Monads::Result, #to_either] either
127
128
  # @return [void]
128
129
  def respond_with_either(either)
129
130
  instance_exec either, &roda_class.either_matcher(:either)
@@ -1,4 +1,5 @@
1
1
  # frozen_string_literal: true
2
+
2
3
  require 'bundler/audit/task'
3
4
 
4
5
  Bundler::Audit::Task.new
@@ -1,2 +1,3 @@
1
1
  # frozen_string_literal: true
2
+
2
3
  require 'bundler/gem_tasks'
@@ -1,4 +1,5 @@
1
1
  # frozen_string_literal: true
2
+
2
3
  require 'rspec/core/rake_task'
3
4
 
4
5
  RSpec::Core::RakeTask.new :spec do |t|
@@ -1,4 +1,5 @@
1
1
  # frozen_string_literal: true
2
+
2
3
  require 'rubocop/rake_task'
3
4
  require 'rubocop'
4
5
 
@@ -1,4 +1,5 @@
1
1
  # frozen_string_literal: true
2
+
2
3
  require 'yard'
3
4
  require 'yard/rake/yardoc_task'
4
5
 
@@ -1,6 +1,6 @@
1
- # coding: utf-8
2
1
  # frozen_string_literal: true
3
- lib = File.expand_path('../lib', __FILE__)
2
+
3
+ lib = File.expand_path('lib', __dir__)
4
4
  $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
5
5
  require 'roda/monads/version'
6
6
 
@@ -12,7 +12,7 @@ Gem::Specification.new do |spec|
12
12
 
13
13
  spec.summary = 'Roda matchers for DRY::Monads'
14
14
  spec.description = 'Reuse business logic operations in Roda'
15
- spec.homepage = 'http://alsemyonov.gitlab.com/pages/'
15
+ spec.homepage = 'http://alsemyonov.gitlab.com/roda-monads/'
16
16
  spec.license = 'MIT'
17
17
 
18
18
  spec.files = `git ls-files -z`.split("\x0").reject do |f|
@@ -22,16 +22,15 @@ Gem::Specification.new do |spec|
22
22
  spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
23
23
  spec.require_paths = ['lib']
24
24
 
25
- spec.add_runtime_dependency 'roda', '~> 2.21.0'
26
- spec.add_runtime_dependency 'dry-monads', '~> 0.2.1'
25
+ spec.add_runtime_dependency 'dry-monads', '~> 0.4.0'
26
+ spec.add_runtime_dependency 'roda', '>= 2.21'
27
27
 
28
28
  spec.add_development_dependency 'bundler', '~> 1.13'
29
29
  spec.add_development_dependency 'bundler-audit', '~> 0.5.0'
30
30
  spec.add_development_dependency 'rack-test', '~> 0.6.3'
31
31
  spec.add_development_dependency 'rake', '~> 12.0'
32
- spec.add_development_dependency 'rspec', '~> 3.5'
33
- spec.add_development_dependency 'rspec-its', '~> 1.2.0'
34
- spec.add_development_dependency 'rubocop', '~> 0.47.0'
32
+ spec.add_development_dependency 'rspec-roda', '~> 0.1.0'
33
+ spec.add_development_dependency 'rubocop', '~> 0.57'
35
34
  spec.add_development_dependency 'simplecov', '~> 0.12.0'
36
35
  spec.add_development_dependency 'yard', '~> 0.9.5'
37
36
  end
metadata CHANGED
@@ -1,43 +1,43 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: roda-monads
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.1.0
4
+ version: 0.2.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Alex Semyonov
8
8
  autorequire:
9
9
  bindir: exe
10
10
  cert_chain: []
11
- date: 2017-01-31 00:00:00.000000000 Z
11
+ date: 2018-06-20 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
- name: roda
14
+ name: dry-monads
15
15
  requirement: !ruby/object:Gem::Requirement
16
16
  requirements:
17
17
  - - "~>"
18
18
  - !ruby/object:Gem::Version
19
- version: 2.21.0
19
+ version: 0.4.0
20
20
  type: :runtime
21
21
  prerelease: false
22
22
  version_requirements: !ruby/object:Gem::Requirement
23
23
  requirements:
24
24
  - - "~>"
25
25
  - !ruby/object:Gem::Version
26
- version: 2.21.0
26
+ version: 0.4.0
27
27
  - !ruby/object:Gem::Dependency
28
- name: dry-monads
28
+ name: roda
29
29
  requirement: !ruby/object:Gem::Requirement
30
30
  requirements:
31
- - - "~>"
31
+ - - ">="
32
32
  - !ruby/object:Gem::Version
33
- version: 0.2.1
33
+ version: '2.21'
34
34
  type: :runtime
35
35
  prerelease: false
36
36
  version_requirements: !ruby/object:Gem::Requirement
37
37
  requirements:
38
- - - "~>"
38
+ - - ">="
39
39
  - !ruby/object:Gem::Version
40
- version: 0.2.1
40
+ version: '2.21'
41
41
  - !ruby/object:Gem::Dependency
42
42
  name: bundler
43
43
  requirement: !ruby/object:Gem::Requirement
@@ -95,47 +95,33 @@ dependencies:
95
95
  - !ruby/object:Gem::Version
96
96
  version: '12.0'
97
97
  - !ruby/object:Gem::Dependency
98
- name: rspec
99
- requirement: !ruby/object:Gem::Requirement
100
- requirements:
101
- - - "~>"
102
- - !ruby/object:Gem::Version
103
- version: '3.5'
104
- type: :development
105
- prerelease: false
106
- version_requirements: !ruby/object:Gem::Requirement
107
- requirements:
108
- - - "~>"
109
- - !ruby/object:Gem::Version
110
- version: '3.5'
111
- - !ruby/object:Gem::Dependency
112
- name: rspec-its
98
+ name: rspec-roda
113
99
  requirement: !ruby/object:Gem::Requirement
114
100
  requirements:
115
101
  - - "~>"
116
102
  - !ruby/object:Gem::Version
117
- version: 1.2.0
103
+ version: 0.1.0
118
104
  type: :development
119
105
  prerelease: false
120
106
  version_requirements: !ruby/object:Gem::Requirement
121
107
  requirements:
122
108
  - - "~>"
123
109
  - !ruby/object:Gem::Version
124
- version: 1.2.0
110
+ version: 0.1.0
125
111
  - !ruby/object:Gem::Dependency
126
112
  name: rubocop
127
113
  requirement: !ruby/object:Gem::Requirement
128
114
  requirements:
129
115
  - - "~>"
130
116
  - !ruby/object:Gem::Version
131
- version: 0.47.0
117
+ version: '0.57'
132
118
  type: :development
133
119
  prerelease: false
134
120
  version_requirements: !ruby/object:Gem::Requirement
135
121
  requirements:
136
122
  - - "~>"
137
123
  - !ruby/object:Gem::Version
138
- version: 0.47.0
124
+ version: '0.57'
139
125
  - !ruby/object:Gem::Dependency
140
126
  name: simplecov
141
127
  requirement: !ruby/object:Gem::Requirement
@@ -201,7 +187,7 @@ files:
201
187
  - rakelib/rubocop.rake
202
188
  - rakelib/yard.rake
203
189
  - roda-monads.gemspec
204
- homepage: http://alsemyonov.gitlab.com/pages/
190
+ homepage: http://alsemyonov.gitlab.com/roda-monads/
205
191
  licenses:
206
192
  - MIT
207
193
  metadata: {}
@@ -221,7 +207,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
221
207
  version: '0'
222
208
  requirements: []
223
209
  rubyforge_project:
224
- rubygems_version: 2.6.10
210
+ rubygems_version: 2.7.6
225
211
  signing_key:
226
212
  specification_version: 4
227
213
  summary: Roda matchers for DRY::Monads