spec_views 1.1.1 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0c7f8a52383504378eddee951cba9a8fc6a47f255da78ed1a130eee0fa814ada
-  data.tar.gz: c8fabfb166786ccb35a9ecb3b195851b04c73bea7b6fe3a0a823a3e72b963469
+  metadata.gz: 3184a08acda31e87ed515d6f32819e70183e5ae887f430e3d21b8e84828a66fe
+  data.tar.gz: 7a852a0f05d557cef81590cea27faf5db52a4c82726a384823985b4a3ebf2cb2
 SHA512:
-  metadata.gz: 838f2fc2cb3002b3e8b3d8274ba1f1e14ea0d3fcea5d54a6ff6bdf8e9919ab37f1c3f3b8a90594ff1911bb588230d513d78a444b838452f9115120eaf71d8dc8
-  data.tar.gz: f3fb138e0899c4a448fe2b8c3121420b6b86162a6ef3f4b5b9a81fed764e6ca3aad89c311f66381aff4d4b4a5024f87fa5c01010fb92e8621007f80fc2cb1c37
+  metadata.gz: 19c5aeeef63e2db2b68073076fca8217631241a1aa65e45f94ebacf45d141135e93f9f001c882aff5b9f2b2e62aeaa0bcf3afd38a890682256b1dfad8e53daec
+  data.tar.gz: 1bb5e90a3fe9fad27653d439bc6b91d140f18c0be9500125f8a2bda0573fb7f68aca301c0fef0f545a6bf6fa9e5e4f5698c91fcbd02c0ce3a4b89c86bf782f25

data/README.md

@@ -1,5 +1,5 @@
 # SpecViews
-Render views from controller specs for comparision.
+Save views from request and controller specs for comparision.
 
 ## Installation
 Add this line to your application's Gemfile:
@@ -13,7 +13,7 @@ And this to RSpec's rails_helper.rb:
 require 'spec_views/support'
 ```
 
-And then execute:
+Then execute:
 ```bash
 $ bundle
 ```
@@ -25,19 +25,102 @@ Ignore some generated files in your .gitignore:
 ```
 
 ## Usage
-Replace selected RSpec `it` methods with `render`:
+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 'homepage' do
+    render_views
+
+    it 'renders the homepage' do
       get :show
+      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.
+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();
+	}
+}