rspec-let_as 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f97eedd83f7c6a9241c9f3759a1807d9ff7b3edfd170e7a4320a4a1d292e91d7
+  data.tar.gz: 6c53d48ead218f4876595920e43802749c769ca542aadfde28fc454cb0368beb
+SHA512:
+  metadata.gz: 1c83622024411b5fa628cf5d7aac028c3633ab3e3c804823952ad9b6d1122a9ddf1d4c19fa5030bd8e4eb65e503cec9c16d7869ee1740f937bbcbf1de7f09694
+  data.tar.gz: 92dcf8380c701f334bb30c78a36239814e9903dd62e3b10e50ece457b5ed838b15ddd929b5bd8ac64a77fe630f09ad7c8c2520277679f8c8f084d163b0b55c33

data/README.md

@@ -0,0 +1,106 @@
+# RSpec::LetAs
+
+Right assignment extension for RSpec
+
+``` ruby
+using RSpec::LetAs
+
+RSpec.describe 'answer' do
+  before do
+    42.let_as :answer
+  end
+
+  example do
+    expect(answer).to eq(42)
+  end
+end
+```
+
+## Motivation
+
+When testing Rails applications with RSpec, I am often faced with the need to arrange large object graph. And since I also need to be able to access specific nodes in the graph, I have to create edges one by one.
+
+``` ruby
+RSpec.describe MyApp do
+  let(:user)      { create(:user) }
+  let(:post)      { create(:post, user: user) }
+  let(:comment_1) { create(:comment, post: post) }
+  let(:comment_2) { create(:comment, post: post) }
+
+  # ...
+end
+```
+
+It is often difficult to imagine the resulting graph from such code. So RSpec::LetAs makes it possible to export the necessary references while building the graph hierarchically.
+
+``` ruby
+using RSpec::LetAs
+
+RSpec.describe MyApp do
+  before do
+    create(:user, posts: [
+      build(:post, comments: [
+        build(:comment).let_as(:comment_1),
+        build(:comment).let_as(:comment_2)
+      ]).let_as(:post)
+    ]).let_as(:user)
+  end
+
+  # ...
+end
+```
+
+## Usage
+
+It is implemented as a refinement and should be passed as an argument to `Module#using`.
+
+``` ruby
+using RSpec::LetAs
+```
+
+Then `Object#let_as` will be defined in the scope of the file or class. It can be used in example group (`describe` / `context`) or example (`example` / `it` / `before` / `let` / etc.).
+
+``` ruby
+using RSpec::LetAs
+
+RSpec.describe 'let_as' do
+  1.let_as :one
+
+  before do
+    2.let_as :two
+  end
+
+  let(:three) { 3.let_as(:three_2) }
+
+  example do
+    four_2 = 4.let_as(:four)
+
+    expect(one).to     eq(1)
+    expect(two).to     eq(2)
+    expect(three).to   eq(3)
+    expect(three_2).to eq(3)
+    expect(four).to    eq(4)
+    expect(four_2).to  eq(4)
+  end
+end
+```
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+``` ruby
+gem 'rspec-let_as'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install rspec-let_as
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/rspec/let_as/version.rb

@@ -0,0 +1,5 @@
+module RSpec
+  module LetAs
+    VERSION = '0.1.0'
+  end
+end

data/lib/rspec/let_as.rb

@@ -0,0 +1,36 @@
+require 'binding_of_caller'
+require 'rspec/core/example_group'
+
+require_relative 'let_as/version'
+
+module RSpec
+  module LetAs
+    class Error < StandardError; end
+
+    refine Object do
+      def let_as(name)
+        example_group = binding.callers.lazy.map(&:receiver).find {|receiver|
+          receiver.is_a?(Class) && receiver.ancestors.include?(RSpec::Core::ExampleGroup)
+        }
+
+        raise Error, <<~EOS unless example_group
+          must be called from an example group or from within:
+
+              RSpec.describe 'answer' do
+                before do
+                  42.let_as :answer
+                end
+
+                example do
+                  expect(answer).to eq(42)
+                end
+              end
+        EOS
+
+        tap {|val|
+          example_group.let(name) { val }
+        }
+      end
+    end
+  end
+end

data/lib/rspec-let_as.rb

@@ -0,0 +1 @@
+require 'rspec/let_as'

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification
+name: rspec-let_as
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Keita Urashima
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2021-11-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: binding_of_caller
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description:
+email:
+- ursm@ursm.jp
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/rspec-let_as.rb
+- lib/rspec/let_as.rb
+- lib/rspec/let_as/version.rb
+homepage: https://github.com/ursm/rspec-let_as
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/ursm/rspec-let_as
+  source_code_uri: https://github.com/ursm/rspec-let_as.git
+  changelog_uri: https://github.com/ursm/rspec-let_as/releases
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.31
+signing_key:
+specification_version: 4
+summary: Right assignment extension for RSpec
+test_files: []