spec_views 1.0.1 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 327822c86f6aac9cd2d8e9c31e06465df710a3b4806d42c5899cbbf6e6a59a02
-  data.tar.gz: 99f42b68d14679146f5b2a7c9e01bad4e9c9a0a1b241d1880a223bb560004126
+  metadata.gz: 3184a08acda31e87ed515d6f32819e70183e5ae887f430e3d21b8e84828a66fe
+  data.tar.gz: 7a852a0f05d557cef81590cea27faf5db52a4c82726a384823985b4a3ebf2cb2
 SHA512:
-  metadata.gz: c02702e4aa11e099daf606f54bedae303f330a6e5135e786835ff7c5483d329a9ac6218e1e584e76aa9f74feb69d64bfb29a38bd9087cc5c9141917e004aa8d5
-  data.tar.gz: 186aa286db5f8d583f747a39a46ac8531036156715308468d1eb07847626e8337260583d48e084a5063b2200dc1ae1e29e9e1f3cc06221037cd46a82b96b93c7
+  metadata.gz: 19c5aeeef63e2db2b68073076fca8217631241a1aa65e45f94ebacf45d141135e93f9f001c882aff5b9f2b2e62aeaa0bcf3afd38a890682256b1dfad8e53daec
+  data.tar.gz: 1bb5e90a3fe9fad27653d439bc6b91d140f18c0be9500125f8a2bda0573fb7f68aca301c0fef0f545a6bf6fa9e5e4f5698c91fcbd02c0ce3a4b89c86bf782f25

data/README.md

@@ -1,18 +1,5 @@
 # SpecViews
-Render views from controller specs for comparision
-
-## Usage
-Replace selected RSpec `it` methods with `render`:
-
-```ruby
-RSpec.describe HomeController, type: :controller do
-  describe 'GET #show' do
-    render 'homepage' do
-      get :show
-    end
-  end
-end
-```
+Save views from request and controller specs for comparision.
 
 ## Installation
 Add this line to your application's Gemfile:
@@ -26,16 +13,114 @@ And this to RSpec's rails_helper.rb:
 require 'spec_views/support'
 ```
 
-And then execute:
+Then execute:
 ```bash
 $ bundle
 ```
 
 Ignore some generated files in your .gitignore:
 ```bash
-/spec/fixtures/views/*/challenger.html
+/spec/fixtures/views/*/challenger.*
 /spec/fixtures/views/*/last_run.txt
 ```
 
+## Usage
+Use the `match_html_fixture` matcher in your spec:
+
+```ruby
+RSpec.describe "Articles", type: :request do
+  describe 'GET /articles' do
+    it 'renders the listing' do
+      get articles_path
+      expect(response).to match_html_fixture
+    end
+  end
+end
+```
+
+Run this spec to see it failing. Open SpecView UI [http://localhost:3000/spec_views](http://localhost:3000/spec_views) on Rails development server to accept the new view. When rerunning the spec it compares its rendering with the reference view. Use SpecView UI to review, accept or reject changed views.
+
+### it_renders
+You can also use the shortcut to skip the matcher and the word "renders" from your description:
+
+```ruby
+RSpec.describe "Articles", type: :request do
+  describe 'GET /articles' do
+    it_renders 'the listing' do
+      get articles_path
+    end
+  end
+end
+```
+
+### Different response status
+By default only status 200 responses are compared. Tell the matcher if your response has another one:
+
+```ruby
+RSpec.describe "Articles", type: :request do
+  describe 'GET /articles' do
+    it 'renders the listing' do
+      get articles_path
+      expect(response).to match_html_fixture.for_status(:not_found) # or 404
+    end
+  end
+end
+```
+
+### PDF matching
+If your request responds with a PDF you can compare it as well:
+
+```ruby
+RSpec.describe "Articles", type: :request do
+  describe 'GET /articles/1/download' do
+    it 'downloads as PDF' do
+      get article_path(1, format: :pdf)
+      expect(response).to match_pdf_fixture
+    end
+  end
+end
+```
+
+### Mailer specs
+Compare HTML mailers. `match_html_fixture` tries to find the HTML part of your mail automatically:
+
+```ruby
+RSpec.describe NotificationsMailer, :type => :mailer do
+  describe '#notify' do
+    let(:mail) { NotificationsMailer.signup }
+
+    it 'renders the body' do
+      expect(mail).to match_html_fixture
+    end
+  end
+end
+```
+
+### Controller specs
+Prefer request specs over controller specs. If you still want to use controller specs enable the `render_views` feature:
+
+```ruby
+RSpec.describe HomeController, type: :controller do
+  describe 'GET #show' do
+    render_views
+
+    it 'renders the homepage' do
+      get :show
+      expect(response).to match_html_fixture
+    end
+  end
+end
+```
+
+The `it_renders` shortcuts enables `render_views` automatically.
+
+## Configuration
+Configure SpecView by adding and modifying lines to `config/environments/test.rb` and `config/environments/development.rb`:
+
+```ruby
+config.spec_views.directory = 'spec/fixtures/views'
+config.spec_views.ui_url = 'http://localhost:3000/spec_views'
+```
+
 ## License
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 begin
   require 'bundler/setup'
 rescue LoadError
@@ -14,7 +16,7 @@ RDoc::Task.new(:rdoc) do |rdoc|
   rdoc.rdoc_files.include('lib/**/*.rb')
 end
 
-APP_RAKEFILE = File.expand_path("test/dummy/Rakefile", __dir__)
+APP_RAKEFILE = File.expand_path('spec/dummy/Rakefile', __dir__)
 load 'rails/tasks/engine.rake'
 
 load 'rails/tasks/statistics.rake'

data/app/assets/config/spec_views_manifest.js

@@ -0,0 +1 @@
+//= link spec_views/diff.js

data/app/assets/javascripts/spec_views/diff.js

@@ -0,0 +1,60 @@
+//= require spec_views/jsdiff
+
+var a = document.getElementById('diff-champion');
+var b = document.getElementById('diff-challenger');
+var result = document.getElementById('diff-result');
+
+function changed() {
+	var diff = JsDiff[window.diffType](a.textContent, b.textContent);
+	var fragment = document.createDocumentFragment();
+	for (var i=0; i < diff.length; i++) {
+
+		if (diff[i].added && diff[i + 1] && diff[i + 1].removed) {
+			var swap = diff[i];
+			diff[i] = diff[i + 1];
+			diff[i + 1] = swap;
+		}
+
+		var node;
+		if (diff[i].removed) {
+			node = document.createElement('del');
+			node.appendChild(document.createTextNode(diff[i].value));
+		} else if (diff[i].added) {
+			node = document.createElement('ins');
+			node.appendChild(document.createTextNode(diff[i].value));
+		} else {
+			node = document.createTextNode(diff[i].value);
+		}
+		fragment.appendChild(node);
+	}
+
+	result.textContent = '';
+	result.appendChild(fragment);
+}
+
+window.onload = function() {
+	onDiffTypeChange(document.querySelector('#diff-settings [name="diff_type"]:checked'));
+	changed();
+};
+
+a.onpaste = a.onchange =
+b.onpaste = b.onchange = changed;
+
+if ('oninput' in a) {
+	a.oninput = b.oninput = changed;
+} else {
+	a.onkeyup = b.onkeyup = changed;
+}
+
+function onDiffTypeChange(radio) {
+	window.diffType = radio.value;
+	document.title = "Diff " + radio.value.slice(4);
+}
+
+var radio = document.getElementsByName('diff_type');
+for (var i = 0; i < radio.length; i++) {
+	radio[i].onchange = function(e) {
+		onDiffTypeChange(e.target);
+		changed();
+	}
+}