site_prism.vcr 0.1.2 → 0.2.0

checksums.yaml

@@ -1,15 +1,7 @@
 ---
-!binary "U0hBMQ==":
-  metadata.gz: !binary |-
-    NjBjNmM0Nzk1NjIxZmU2NGQ4OGQ0M2U3MDkwNDU3YWIxNDUxMjM5ZQ==
-  data.tar.gz: !binary |-
-    NGVkNTk1MDVlMTNlN2Y5ZTgwMTRjYWM4MzdjMDFlMjYzY2FkZTFlOA==
+SHA1:
+  metadata.gz: b27bc15efc9ef02cdac9c19415638b241c327929
+  data.tar.gz: 051ad78469fee6ab6d34d7a27c687edf15c31aa6
 SHA512:
-  metadata.gz: !binary |-
-    ZjQyYmM5Y2M5ZGM3ZTY1NWQyNDY3ZTEwYjQ4ODkzNDcwY2Y2Y2M0ODY5NjA1
-    ZGNjNGUyZGEzYTQyYjZhYTNiZjA4NmM3Yzc3OWZhZTYxNWY2NTdlYTZiZTdm
-    NzVlMGM4ZjJlNThjMWQwMzNhZWE0NDFjNTcxYzY3MjMwZjUwYmY=
-  data.tar.gz: !binary |-
-    MGFiMGI5YTk0OGRjYWIyMDRlMGUyNDU3YTI0MmNhNjY2ZjkyYWMyNTFhODIw
-    ZGIyMDAzMDY2M2MxNGQwZTJjNDY2NjQ1YTE3ZDY2YjQxZDkwNzRlMDNiMjgz
-    ODY5MGIwM2QwOTRkZTdmYjg1YTVkYzE5ZDhmYjIxZDRhNzZiNWE=
+  metadata.gz: ff5719ce35f903b3cf9146f9dba1f293f7bfdd7f081750333ec1dafb13c85dd3e799e6d66c14f8740a63c0577ba7f2bae8364dfc1a5d2ec1823805d4db8659d9
+  data.tar.gz: 0c0b1d6d25328740b32f1a5bc577189e100e7cbf35871a4d36744274fdfcaa5c22bcf8a2111e97567c696a758687e6ba260c7c6f58cc349c2147c5b75baae725

data/.travis.yml

@@ -1,5 +1,10 @@
 language: ruby
 rvm:
+  - 2.2.0
+  - 2.1.5
+  - 2.1.4
+  - 2.1.3
+  - 2.1.2
   - 2.1.1
   - 2.1.0
   - 2.0.0

data/CHANGELOG.md

@@ -1,12 +1,59 @@
+# 0.2.0
+
+  * fixed code for ejecting cassettes from Vcr. Now SitePrism.Vcr ejects only cassettes injected by itself, any other cassettes which are injected outside of this library won't be touched.
+  * added a new functionality to alter default cassettes defined in a parent class page. Now if additional cassettes should be added to a default cassettes list, it can be done with the `adjust_parent_vcr_options` method (waiter can be replaced as well).
+
+  ```ruby
+    class BasePage < SitePrism::Page
+      vcr_options_for_load do
+        fixtures ['cars', 'products']
+
+        waiter &:wait_for_cars_list
+      end
+    end
+
+    class CarsPage < BasePage
+      adjust_parent_vcr_options do
+        fixtures ['features']
+
+        waiter &:wait_for_cars_and_features_list
+
+        union # if it is omitted, the fixtures list defined in this block will
+        # replace the fixtures list defined in the parent page class
+      end
+    end
+  ```
+
+  * added `shortcut_path` helper method to use it while pointing a path to cassettes. Before this change only one shortcut (the shortcut for the home path `~/`) could be defined, now any path to cassettes can be defined as a shortcut.
+
+  ```ruby
+    self.some_link.click_and_apply_vcr do
+      home_path 'cars'
+
+      shortcut_path 'ferrari', 'cars/f1/ferrari'
+
+      fixtures [
+        '~/ford_fiesta',
+        ':ferrari/f13t',
+        ':ferrari/f14t',
+        ':ferrari/f15t'
+      ]
+    end
+  ```
+
+# 0.1.2
+
+  * fixed the issue with storing a fixture into a correct sub directory if it is provided along with a fixture name (It happened only for `path` helper method which used with a home path symbol).
+
 # 0.1.1
 
   * fixed the issue with using replace and union actions in one block.
 
   ```ruby
     self.some_link.click_and_apply_vcr do
-      fixtures ['test', 'test2']
+      fixtures ['ford', 'ferrari']
       union
-      fixtures ['test3']
+      fixtures ['jeep']
       replace
     end
   ```
@@ -18,9 +65,9 @@
 
   ```ruby
     self.some_link.click_and_apply_vcr do
-      home_path 'custom'
+      home_path 'cars'
 
-      fixtures ['~/../test'] # '~' indicates a home path which is defined above in this block
+      fixtures ['~/../ford'] # '~' indicates a home path which is defined above in this block
     end
   ```
 

data/Gemfile

@@ -5,10 +5,9 @@ gemspec
 
 gem 'sinatra'
 gem 'httpi'
-gem 'capybara-firebug'
+gem 'capybara', '~> 2.4'
 gem 'sandi_meter'
 
-gem 'rspec', '~> 2.14.1'
-gem 'rspec-fire'
-gem 'selenium-webdriver', '~> 2.41.0'
+gem 'rspec', '~> 3'
+gem 'selenium-webdriver', '~> 2'
 gem 'coveralls', require: false

data/README.md

@@ -1,6 +1,6 @@
 # SitePrism.Vcr
 
-[![Code Climate](https://codeclimate.com/github/nestd/site_prism.vcr.png)](https://codeclimate.com/github/nestd/site_prism.vcr)
+[![Code Climate](https://codeclimate.com/github/dnesteryuk/site_prism.vcr.png)](https://codeclimate.com/github/dnesteryuk/site_prism.vcr)
 [![Build Status](https://secure.travis-ci.org/dnesteryuk/site_prism.vcr.png?branch=master)](https://travis-ci.org/dnesteryuk/site_prism.vcr)
 [![Coverage Status](https://coveralls.io/repos/dnesteryuk/site_prism.vcr/badge.png)](https://coveralls.io/r/dnesteryuk/site_prism.vcr)
 [![Dependency Status](https://gemnasium.com/dnesteryuk/site_prism.vcr.png)](https://gemnasium.com/dnesteryuk/site_prism.vcr)
@@ -15,7 +15,7 @@ Such integration allows you to write acceptance tests more easily since you rece
   * Links VCR cassettes with SitePrism pages.
   * Applies VCR cassettes on any event (click, change, blur etc).
   * Applies VCR cassettes on page loading.
-  * Defines a waiter which will be used for waiting until an expected element is on a page or until an expected element has disappeared from a page (It is very helpful when a few external API requests are being executed after raising an event).
+  * Defines a waiter to wait on a result of an action.
   * Allows to redefine default VCR cassettes (cassettes which were specified while describing a SitePrism element or a SitePrism page).
   * Allows to redefine a default waiter (a waiter which was specified while describing a SitePrism element or a SitePrism page).
 
@@ -51,7 +51,7 @@ end
 
 `fixtures` helper method is used for defining VCR cassettes. All cassettes are taken from a path which you have defined in `cassette_library_dir` configuration option of VCR. Please, refer to [documentation](https://relishapp.com/vcr/vcr/v/2-5-0/docs/configuration/cassette-library-dir) of VCR to get more info about configuration options.
 
-You can specify cassettes for already defined elements, for example, your page inherits another one:
+You can specify cassettes for already defined elements, if your page inherits another one:
 
 ```ruby
 class TransportPage < SitePrism::Page
@@ -67,7 +67,7 @@ end
 
 #### Path helper method
 
-In case you have a lot of cassettes which are stored in some subdirectory, there is more better way for defining cassettes:
+In case you have a lot of cassettes which are stored in some subdirectory, you can use `path` helper method to specify a list of such cassettes:
 
 ```ruby
 class ProductsPage < SitePrism::Page
@@ -115,7 +115,7 @@ class ProductsPage < SitePrism::Page
 end
 ```
 
-If some cassette name begins with `~/`, it means that a defined home path will be applied to find such cassette. The previous example is identical to this one:
+Here `~` points to `cars/small` directory, all cassettes will be taken from this directory. The previous example is identical to this one:
 
 ```ruby
 class ProductsPage < SitePrism::Page
@@ -161,6 +161,26 @@ class ProductsPage < SitePrism::Page
 end
 ```
 
+#### Shortcut path helper method
+
+The home path helper method helps you to avoid duplication while specifing cassettes. There is a `shortcut_path` method which does the same, but it can be used to define shorcuts for any path:
+
+```ruby
+class ProductsPage < SitePrism::Page
+  element_with_vcr \
+    :car_details_link,
+    '#car_details' do
+      shortcut_path 'cars', 'cars/small'
+
+      fixture [':cars/ford']
+    end
+end
+```
+
+Here `:cars` points to the `cars/small` directory.
+
+Everything described for the `home_path` helper method works for the `shortcut_path` method as well.
+
 ### Applying VCR cassettes on click
 
 Cassettes can be applied on a click event:
@@ -230,7 +250,7 @@ Home path can be defined while applying Vcr:
 end
 ```
 
-#### Exchange default fixtures
+#### Exchange default cassettes
 
 There may be a situation when you need to exchange some default cassette for one specific test. It is a very easy to do:
 
@@ -353,7 +373,7 @@ The block which is passed to `shift_event` method is executed in a context of an
 
 ### Linking and applying VCR cassettes with SitePrism pages
 
-External HTTP interactions may be done on page loading as well. This gem supports capability to apply Vcr cassettes on page loading. To define default cassettes you have to use `vcr_options_for_load` class method:
+External HTTP interactions may be done on page loading as well. This gem supports capability to apply Vcr cassettes on page loading. To define default cassettes you have to use the `vcr_options_for_load` class method:
 
 ```ruby
 class ProductsPage < SitePrism::Page
@@ -365,7 +385,7 @@ end
 
 Everything described above about defining cassettes for SitePrism elements is true for defining cassettes for pages.
 
-Applying cassettes is almost the same as you saw for a click event:
+Applying cassettes is almost the same as it is shown for SitePrism elements:
 
 ```ruby
 page.load_and_apply_vcr do
@@ -375,7 +395,7 @@ page.load_and_apply_vcr do
 end
 ```
 
-All arguments passed to `load_and_apply_vcr` method will be passed to `load` method of SitePrism. It allows you to change an url of the being loaded page.
+All arguments passed to the `load_and_apply_vcr` method will be passed to the `load` method of SitePrism. It allows to change an url of the being loaded page:
 
 ```ruby
 page.load_and_apply_vcr(cat: 'tom') do
@@ -391,6 +411,65 @@ In this case, SitePrism will alter an url and it will look like:
 http://localhost/cats/tom
 ```
 
+#### Altering default cassettes in sub-classes of pages
+
+There is a possibility to alter default cassettes defined for a parent page class. It can be done with the `adjust_parent_vcr_options` method:
+
+```ruby
+  class BasePage < SitePrism::Page
+    vcr_options_for_load do
+      fixtures ['cars', 'products']
+
+      waiter &:wait_for_cars_list
+    end
+  end
+
+  class CarsPage < BasePage
+    adjust_parent_vcr_options do
+      fixtures ['features']
+
+      waiter &:wait_for_cars_and_features_list
+
+      union # if it is omitted, the cassettes defined in this block will
+      # replace the cassettes defined in the parent page class
+    end
+  end
+```  
+
+In this case `cars`, `products`, `features` cassettes will be applied while loading the cars page. 
+
+Any helper methods can be used in a block passed to the `adjust_parent_vcr_options` method.
+
+### Applying VCR cassettes in sections
+
+There isn't any method which you can use to apply VCR cassettes with sections. Actually, it is needless, because usually we do actions over elements. But, if you need such functionality for sections, you already have such possibility:
+
+```ruby
+  class ListSection < SitePrism::Section
+    # elements here
+
+    def initialize(parent, element)
+      super
+
+      @applier = SPV::Applier.new(self)
+    end
+
+    def show_more
+      @applier.shift_event{
+        self.scroll_down
+      }.apply_vcr do
+        fixtures ["storages/more_storages"]
+
+        waiter { self.wait_until_loading_indicator_invisible }
+      end
+    end
+  end
+```
+
+In this example we apply VCR cassettes after scrolling down the content in a section. 
+
+It may be useful to stub the API request produced by an event which isn't directly related to any element rather it related to overall elements in a section.
+
 ### Using Vcr options for cassettes
 
 Vcr provides number of options which can be used for cassettes. For example, you may [pass ERB into cassettes](https://relishapp.com/vcr/vcr/v/2-5-0/docs/cassettes/dynamic-erb-cassettes). This gem doesn't bother you use any options for Vcr cassettes. If you want to do so, you have to use a hash instead of a cassette name:
@@ -427,6 +506,5 @@ The simple example of using this gem you can find [here](https://github.com/dnes
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create new Pull Request
 
-
 [![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/nestd/site_prism.vcr/trend.png)](https://bitdeli.com/free "Bitdeli Badge")
 

data/TODO.md

@@ -1,28 +1,37 @@
 # TODO
 
-## Release 0.1.2
-
-1. Think how to avoid monkey patching to add stuffs to SitePrism
-2. Change code to use DI with build (http://solnic.eu/2013/12/17/the-world-needs-another-post-about-dependency-injection-in-ruby.html)
-3. Think about using something like:
+## Release 0.3.0
 
+1. Add code not to remove one specific cassete from VCR
+2. Find better names for `vcr_options_for_load` and `adjust_parent_vcr_options` methods.
+3. Think about using DCI:
   ```ruby
-    ~/../bundle_offerings
+    class SPV:Page < SitePrism:Page
+      def load_and_apply_vcr(*args, &block)
+        shift_event { load(*args) }.apply_vcr(&block)
+      end
+    
+      def shift_event(&block)
+        vcr_applier.shift_event(&block)
+      end
+    end
+  ```
+4. Add possibility to get a defined cassettes for a page or section:
+  ```ruby
+    @dashboard_page.vcr_cassettes # returns a defined cassetted for this page
+    @form_section.vcr_cassettes # returns a defined cassetted for this section
   ```
 
-when define a path to a fixture, for that we can use a standard class Pathname of Ruby.
-
-## Release 0.2.0
-
-1. Pages and elements should inherit fixtures defined for their parents
-2. When we eject fixtures from Vcr we should eject only fixtures inserted into Vcr by one specific fixtures manager (See SPV#eject)
-3. Make this gem working on JRuby (since we eject all VCR cassettes, it may be not thread safe)
-4. Think about creating set of fixtures which can be exchanged by a name of set. It will be very helpful when you have to exchange a set of fixtures.
-5. Add code to not remove one specific cassete from VCR
-
-## Should be implemented?
+## Things to think over
 
-1. Create possibility to define fixtures without the click action:
+1. Should we add the integration tests for page load to make sure 2 HTTP requests will be handled properly?
+2. Should we add own integration tests to test the path helper method?
+3. Should we add a test for testing to HTTP requests on page load?
+4. Should be Options class immutable?
+5. Think about renaming current integration tests on acceptance tests and create new integration tests which will test integration between classes without involving a browser. It will solve a lot of issues with shared tests to check the same things for pages and elements. In acceptance tests we will test very basic stuffs.
+6. May be SPV::Fixtures::TmpKeeper is redundant and SPV::Fixtures can be used as a tmp keeper of fixtures?
+7. Elements should inherit fixtures defined for their parents
+8. Create possibility to define fixtures without the click action (it can be done with `alter_fixtures` method from the applier, but it is not accessible outside of the applier):
 
     ```ruby
     self.confirm_btn.vcr do
@@ -40,16 +49,5 @@ when define a path to a fixture, for that we can use a standard class Pathname o
     ```
 
   will use previously defined fixtures
-
-
-## Things to think over
-
-1. Should we add the integration tests for page load to make sure 2 HTTP requests will be handled properly?
-2. Should we add own integration tests to test the path helper method?
-3. Should we add a test for testing to HTTP requests on page load?
-4. Should be Options class immutable?
-5. May be it makes sense to separately keep path from the name of a fixture? See SPV::Fixture class
-6. Think about renaming current integration tests on acceptance tests and create new integration tests which will test integration between classes without involving a browser. It will solve a lot of issues with shared tests to check the same things for pages and elements. In acceptance tests we will test very basic stuffs.
-7. May be SPV::Fixtures::TmpKeeper is redundant and SPV::Fixtures can be used as a tmp keeper of fixtures?
-
-
+  
+9. Think about creating set of fixtures which can be exchanged by a name of set. It will be very helpful when you have to exchange a set of fixtures.

data/lib/site_prism_vcr/applier.rb

@@ -13,16 +13,44 @@ module SPV
       end
 
       @fixtures = adjuster.prepare_fixtures
-
-      @fixtures_manager = Fixtures::Manager.new(@options)
     end
 
+    # Stores a block with an action (click, scroll down, mouse over etc)
+    # VCR should be applied on.
+    #
+    # This block will be called over an object VCR linked to.
+    #
+    #  Example:
+    #    @my_element.shift_event do
+    #      self.click
+    #    end
+    #
+    # @param block [Proc]
+    #
+    # @return [SPV::Applier] The current applier object.
+    #
+    # @api public
     def shift_event(&block)
       @event_action = block
 
       self
     end
 
+    # Alters default fixtures and options.
+    #
+    # @param adjusting_block [Proc] It allows to
+    #  change fixtures through DSL (@see SPV::DSL::InitialAdjuster
+    #  and @see SPV::DSL::Adjuster)
+    #
+    # @return [void]
+    #
+    # @api public
+    def alter_fixtures(&block)
+      @fixtures = adjust_fixtures(
+        @options, &block
+      )
+    end
+
     # Applies fixtures to be used for stubbing HTTP interactions
     # caused by an event (click on an element or page loading).
     #
@@ -34,27 +62,26 @@ module SPV
     #  and @see SPV::DSL::Adjuster)
     #
     # @return [void]
-    def apply_vcr(&block)
+    #
+    # @api public
+   def apply_vcr(&block)
       verify_define_event!
 
-      options = @options.clone_options
-
-      adjuster = DSL::Adjuster.new(
-        options,
-        @fixtures
-      )
+      fixtures, options = @fixtures, @options.clone_options
 
       if block_given?
-        adjuster.instance_eval &block
+        fixtures = adjust_fixtures(options, &block)
       end
 
-      @fixtures_manager.inject(adjuster.prepare_fixtures)
+      fixtures_manager = Fixtures::Manager.inject(
+        fixtures, options
+      )
 
       @event_action.call
 
       Waiter.wait(
         @node,
-        @fixtures_manager,
+        fixtures_manager,
         options
       )
     end
@@ -62,8 +89,19 @@ module SPV
     private
       def verify_define_event!
         raise EventError.new(
-          'Event is not shifted, before applying Vcr you have to shift event with "shift_event" method'
+          'Event is not shifted, before applying VCR you have to shift event with "shift_event" method'
         ) if @event_action.nil?
       end
+
+      def adjust_fixtures(options, &block)
+        adjuster = DSL::Adjuster.new(
+          options,
+          @fixtures
+        )
+
+        adjuster.instance_eval &block
+
+        adjuster.prepare_fixtures
+      end
   end # class Applier
 end # module SPV

data/lib/site_prism_vcr/dsl/adjuster.rb

@@ -61,7 +61,7 @@ module SPV
       #
       # @api public
       def exchange(old_fixtures, new_fixtures)
-        home_path_modifier = Fixtures::Modifiers::HomePath.new(@options)
+        home_path_modifier = Fixtures::Modifiers::ShortcutPath.new(@options)
 
         old_fixtures = [old_fixtures] unless old_fixtures.is_a?(Array)
         new_fixtures = [new_fixtures] unless new_fixtures.is_a?(Array)

data/lib/site_prism_vcr/dsl/initial_adjuster.rb

@@ -20,7 +20,7 @@ module SPV
         prepared_fixtures = @fixtures_handler.handle_raw(
           list,
           [
-            Fixtures::Modifiers::HomePath.new(@options),
+            Fixtures::Modifiers::ShortcutPath.new(@options),
             Fixtures::Modifiers::RelativePath.new(@options)
           ]
         )
@@ -28,9 +28,12 @@ module SPV
         @tmp_keeper.add_fixtures(prepared_fixtures)
       end
 
-      # Defines path to fixtures. Later this path
-      # can be used for defining fixtures. It is especially
-      # useful when you use deep subdirectories structure for storing fixtures.
+      # Defines a home path to fixtures. Later this path
+      # can be used for defining fixtures.
+      #
+      # Example:
+      #   home_path 'cassettes/cars/ford'
+      #   fixtures['~/car']
       #
       # @param path [String] Path to fixtures.
       #
@@ -38,7 +41,24 @@ module SPV
       #
       # @api public
       def home_path(path)
-        @options.home_path = path
+        @options.add_shortcut_path('~', path)
+      end
+
+      # Defines a shortcut path to fixtures. Later this path
+      # can be used for defining fixtures.
+      #
+      # Example:
+      #   shortcut_path 'ford', 'cassettes/cars/ford'
+      #   fixtures[':ford/car']
+      #
+      # @param name [String] Shortcut name to be used while defining a path to fixtures..
+      # @param path [String] Path to fixtures.
+      #
+      # @return [void]
+      #
+      # @api public
+      def shortcut_path(name, path)
+        @options.add_shortcut_path(name, path)
       end
 
       # Applies a given path to list of fixtures and defines
@@ -57,7 +77,7 @@ module SPV
         options_with_path.path = path
 
         path_modifier      = Fixtures::Modifiers::Path.new(options_with_path)
-        home_path_modifier = Fixtures::Modifiers::HomePath.new(options_with_path)
+        home_path_modifier = Fixtures::Modifiers::ShortcutPath.new(options_with_path)
 
         prepared_fixtures = @fixtures_handler.handle_raw(
           fixture_names,

data/lib/site_prism_vcr/fixture.rb

@@ -26,12 +26,15 @@ module SPV
       self.path = Pathname.new(val) + self.path
     end
 
-    def set_home_path(home_path)
-      self.path = self.path.to_path.gsub(/\A(\~\/|\~)/, home_path)
+    def set_home_path(path_to)
+      self.path = self.path.to_path.gsub(
+        /\A(\:#{self.shortcut_path}\/|:#{self.shortcut_path}|\~\/|\~)/,
+        path_to
+      )
     end
 
-    def has_link_to_home_path?
-      self.name[0..1] == '~/'
+    def shortcut_path
+      res = (self.name.match(/:(\w+)\//) || self.name.match(/(~)\//)) and res[1]
     end
 
     # Returns a name without a link to a home path

data/lib/site_prism_vcr/fixtures/manager.rb

@@ -3,35 +3,54 @@ module SPV
     # Takes cares about inserting and ejecting fixtures
     # from Vcr.
     class Manager
-      def initialize(options)
-        @options = options
+      # Initializes a new instance of the fixtures manager class,
+      # injects given fixtures into VCR,
+      # returns an instance of the fixtures manager class
+      #
+      # @param fixtures [SPV::Fixtures] List of fixtures.
+      # @param options [SPV::Options] An object with all options.
+      #
+      # @return [SPV::Fixtures::Manager]
+      def self.inject(fixtures, options)
+        manager = new(fixtures, options)
+        manager.inject
+        manager
       end
 
-      # Injects given fixtures to Vcr.
+      # Initializes a new instance
       #
       # @param fixtures [SPV::Fixtures] List of fixtures.
+      # @param options [SPV::Options] An object with all options.
+      #
+      # @return [void]
+      def initialize(fixtures, options)
+        @fixtures, @options = fixtures, options
+      end
+
+      # Injects given fixtures to Vcr.
       #
       # @return [void]
       #
       # @raise [ArgumentError] If a list of fixtures is empty.
-      def inject(fixtures)
+      def inject
         raise ArgumentError.new(
           'No fixtures were specified to insert them into VCR'
-        ) if fixtures.size == 0
+        ) if @fixtures.size == 0
 
-        fixtures.each do |fixture|
+        @fixtures.each do |fixture|
           VCR.insert_cassette fixture.name, fixture.options
         end
       end
 
-      # Ejects all fixtures from Vcr.
-      # Now it doesn't care which fixtures were inserted by
-      # an instance of this class. After calling this method
-      # Vcr will have no inserted fixtures at all.
+      # Ejects only fixtures from Vcr which are injected
+      # by this instance of the fixtures manager class.
       #
       # @return [void]
       def eject
-        SPV::Helpers.eject_all_cassettes
+        inserted_names = @fixtures.map(&:name)
+
+        # TODO: find better way, may be some pull request to the VCR?
+        VCR.send(:cassettes).delete_if{|cassette| inserted_names.include?(cassette.name) }
       end
     end # class Manager
   end # class Fixtures

data/lib/site_prism_vcr/fixtures/modifiers/path.rb

@@ -6,12 +6,12 @@ module SPV
       # It takes a fixture and adds a path to it.
       class Path < Base
         def modify(fixture)
-          if fixture.has_link_to_home_path?
-            raise HomePathError.new(
-              "You cannot use the home path while listing fixtures in the 'path' method. " <<
+          if shortcut = fixture.shortcut_path
+            raise ShortcutPathError.new(
+              "You cannot use a shortcut path while listing fixtures in the 'path' method. " <<
               "Please, use 'fixtures' method for '#{fixture.clean_name}' fixture or " <<
-              "you can additionally use the 'path' method where you will specify a home path as a path name." <<
-              "Example: path('~/', ['#{fixture.clean_name}'])"
+              "you can additionally use the 'path' method where you will specify a shortcut path as a path name." <<
+              "Example: path(':#{shortcut}', ['#{fixture.clean_name}'])"
             )
           else
             path = @options.path
@@ -21,7 +21,7 @@ module SPV
           end
         end
 
-        class HomePathError < ArgumentError; end
+        class ShortcutPathError < ArgumentError; end
       end
     end
   end