reverse_coverage 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8289c5962409f6180efde37d89d711d8eaa9ef2b
+  data.tar.gz: 462039269712ca381a1cd9441666fbb341666ab4
+SHA512:
+  metadata.gz: 3d1c17a176cebda761722d7d572063e941ff4565055a3c9b97545a0fcdf5b920dc611572c02d39059de9f1d9d247717ec564ea2e4ea0a3cfb8a79b9fe8f336bf
+  data.tar.gz: '084b29ff09e618bdf9ff28af26e8a7d04332a5b409a43b5d46f6f00a0544824f395ce58a1336ef106b89948a2d7252e654b1755b6704f76abd75e6010f47e973'

data/.gitignore

@@ -0,0 +1,56 @@
+*.rbc
+capybara-*.html
+.rspec
+.rspec_status
+.rubocop-*
+/log
+/tmp
+/db/*.sqlite3
+/db/*.sqlite3-journal
+/public/system
+/coverage/
+/spec/tmp
+*.orig
+rerun.txt
+pickle-email-*.html
+
+# TODO Comment out this rule if you are OK with secrets being uploaded to the repo
+config/initializers/secret_token.rb
+config/master.key
+
+# Only include if you have production secrets in this file, which is no longer a Rails default
+# config/secrets.yml
+
+# dotenv
+# TODO Comment out this rule if environment variables can be committed
+.env
+
+## Environment normalization:
+/.bundle
+/vendor/bundle
+
+# these should all be checked in to normalize the environment:
+# Gemfile.lock, .ruby-version, .ruby-gemset
+Gemfile.lock
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+# if using bower-rails ignore default bower_components path bower.json files
+/vendor/assets/bower_components
+*.bowerrc
+bower.json
+
+# Ignore pow environment settings
+.powenv
+
+# Ignore Byebug command history file.
+.byebug_history
+
+# Ignore node_modules
+node_modules/
+
+# Others
+spec/faked_project/tmp/reverse_coverage.yml
+
+tmp/

data/.rubocop.yml

@@ -0,0 +1,19 @@
+require:
+  - rubocop-rspec
+
+inherit_from:
+  - https://relaxed.ruby.style/rubocop.yml
+
+Metrics/BlockLength:
+  Exclude:
+    - config/routes.rb
+    - db/seeds/**/*
+    - spec/**/*
+
+RSpec/MultipleExpectations:
+  Max: 5
+  # Default is 1
+
+RSpec/ExampleLength:
+  Max: 20
+  # Default is 5

data/Gemfile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in reverse_coverage.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Nebulab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 Nebulab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,70 @@
+[![Gem Version](https://badge.fury.io/rb/reverse_coverage.svg)](https://badge.fury.io/rb/reverse_coverage)
+
+# ReverseCoverage
+
+The goal of this component is to find what RSpec examples "cover" one or more lines of code of a Ruby project.
+
+This is useful for example when you override methods of a parent product and you want to check what/how the specs treat the original lines.
+
+## Installation
+
+Add `gem 'reverse_coverage'` to your application's Gemfile and execute `bundle`.
+
+Put the following code under you specs configuration:
+
+```ruby
+require 'reverse_coverage'
+
+RSpec.configure do |config|
+  config.before(:suite) do
+    ReverseCoverage::Main.start
+  end
+
+  config.around do |e|
+    e.run
+    ReverseCoverage::Main.add(e)
+  end
+
+  config.after(:suite) do
+    ReverseCoverage::Main.save_results
+    coverage_matrix = ReverseCoverage::Main.coverage_matrix
+    ReverseCoverage::Formatters::HTML::Formatter.new.format(coverage_matrix)
+  end
+end
+```
+
+## Usage
+
+Run your specs, inspect the `'tmp/reverse_coverage.yml'` file or open `'tmp/index.html'` file.
+
+To configure the base URL used to open a specific spec edit the generated `'tmp/settings.js'` file. Without changes, the default behavior is to open files locally.
+
+## Options
+
+- `file_filter`: allows to set a lambda to filter what files belongs to the project. Example (to add before `ReverseCoverage::Main.start` line): `ReverseCoverage::Main.config[:file_filter] = ->(file_path) { file_path.include? 'faked_project' }`
+
+## Testing
+
+Execute `bundle exec rspec` on the component root path, specs are based on an internal fake project.
+
+## HTML output screenshot
+
+Here it is a screenshot of the generated HTML interface:
+
+![Reverse Coverage screenshot](extra/screenshot.jpg)
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/nebulab/reverse_coverage. 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.
+
+## License
+
+ReverseCoverage is copyright © 2019 [Nebulab](http://nebulab.it/). It is free software, and may be redistributed under the terms specified in the [license](LICENSE.txt).
+
+## About
+
+![Nebulab](http://nebulab.it/assets/images/public/logo.svg)
+
+ReverseCoverage is funded and maintained by the [Nebulab](http://nebulab.it/) team.
+
+We firmly believe in the power of open-source. [Contact us](http://nebulab.it/contact-us/) if you like our work and you need help with your project design or development.

data/Rakefile

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec
+
+namespace :assets do
+  desc "Compiles all assets"
+  task :compile do
+    puts "Compiling assets"
+    require "sprockets"
+    base_path = 'lib/reverse_coverage/formatters/html'
+    assets = Sprockets::Environment.new
+    assets.append_path "#{base_path}/assets/javascripts"
+    assets.append_path "#{base_path}/assets/stylesheets"
+    assets["application.js"].write_to("#{base_path}/public/application.js")
+    assets["settings.js"].write_to("#{base_path}/public/settings.js")
+    assets["application.css"].write_to("#{base_path}/public/application.css")
+  end
+end

data/lib/reverse_coverage.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'coverage'
+require 'singleton'
+require 'yaml'
+
+require_relative 'reverse_coverage/version'
+require_relative 'reverse_coverage/main'
+require_relative 'reverse_coverage/formatters/html/formatter'

data/lib/reverse_coverage/formatters/html/assets/javascripts/application.js

@@ -0,0 +1,204 @@
+//= require_directory ./libraries/
+//= require_directory ./plugins/
+//= require treeview.js
+//= require_self
+
+$(document).ready(function() {
+  // Configuration for fancy sortable tables for source file groups
+  $('.file_list').dataTable({
+    "aaSorting": [[ 0, "asc" ]],
+    "bPaginate": false,
+    "bJQueryUI": true,
+    "aoColumns": [
+      null,
+      null,
+      null
+    ]
+  });
+
+  // Syntax highlight all files up front - deactivated
+  // $('.source_table pre code').each(function(i, e) {hljs.highlightBlock(e, '  ')});
+
+  // Syntax highlight source files on first toggle of the file view popup
+  $("a.src_link").click(function() {
+    // Get the source file element that corresponds to the clicked element
+    var source_table = $($(this).attr('href'));
+
+    // If not highlighted yet, do it!
+    if (!source_table.hasClass('highlighted')) {
+      source_table.find('pre code').each(function(i, e) {hljs.highlightBlock(e, '  ')});
+      source_table.addClass('highlighted');
+    };
+  });
+
+  var prev_anchor;
+  var curr_anchor;
+
+  // Set-up of popup for source file views
+  $("a.src_link").colorbox({
+    transition: "none",
+    inline: true,
+    opacity: 1,
+    width: "95%",
+    height: "95%",
+    onLoad: function() {
+      prev_anchor = curr_anchor ? curr_anchor : jQuery.url.attr('anchor');
+      curr_anchor = this.href.split('#')[1];
+      window.location.hash = curr_anchor;
+    },
+    onCleanup: function() {
+      if (prev_anchor && prev_anchor != curr_anchor) {
+        $('a[href="#'+prev_anchor+'"]').click();
+        curr_anchor = prev_anchor;
+      } else {
+        $('.group_tabs a:first').click();
+        prev_anchor = curr_anchor;
+        curr_anchor = "#_AllFiles";
+      }
+      window.location.hash = curr_anchor;
+    }
+  });
+
+  window.onpopstate = function(event){
+    if (location.hash.substring(0,2) == "#_") {
+      $.colorbox.close();
+      curr_anchor = jQuery.url.attr('anchor');
+    } else {
+      if ($('#colorbox').is(':hidden')) {
+        $('a.src_link[href="'+location.hash+'"]').colorbox({ open: true });
+      }
+    }
+  };
+
+  // Hide src files and file list container after load
+  $('.source_files').hide();
+  $('.file_list_container').hide();
+
+  // Add tabs based upon existing file_list_containers
+  $('.file_list_container h2').each(function(){
+    var container_id = $(this).parent().attr('id');
+    var group_name = $(this).find('.group_name').first().html();
+
+    $('.group_tabs').append('<li><a href="#' + container_id + '">' + group_name + '</a></li>');
+  });
+
+  $('.group_tabs a').each( function() {
+    $(this).addClass($(this).attr('href').replace('#', ''));
+  });
+
+  // Make sure tabs don't get ugly focus borders when active
+  $('.group_tabs a').live('focus', function() { $(this).blur(); });
+
+  var favicon_path = $('link[rel="icon"]').attr('href');
+  $('.group_tabs a').live('click', function(){
+    if (!$(this).parent().hasClass('active')) {
+      $('.group_tabs a').parent().removeClass('active');
+      $(this).parent().addClass('active');
+      $('.file_list_container').hide();
+      $(".file_list_container" + $(this).attr('href')).show();
+      window.location.href = window.location.href.split('#')[0] + $(this).attr('href').replace('#', '#_');
+
+      // Force favicon reload - otherwise the location change containing anchor would drop the favicon...
+      // Works only on firefox, but still... - Anyone know a better solution to force favicon on local file?
+      $('link[rel="shortcut icon"]').remove();
+      $('head').append('<link rel="shortcut icon" type="image/png" href="'+ favicon_path +'" />');
+    };
+    return false;
+  });
+
+  if (jQuery.url.attr('anchor')) {
+    var anchor = jQuery.url.attr('anchor')
+    if (anchor.length == 40) {
+      $('a.src_link[href=#' + anchor + ']').click();
+    } else {
+      $('.group_tabs a.'+anchor.replace('_', '')).click();
+    }
+  } else {
+    $('.group_tabs a:first').click();
+  };
+
+  $("abbr.timeago").timeago();
+  $('#loading').fadeOut();
+  $('#wrapper').show();
+  $('.dataTables_filter input').focus();
+
+  // https://stackoverflow.com/a/34430701
+  window.getAbsoluteUrl = function (base, relative) {
+    var hashPosition = base.indexOf('#');
+    if (hashPosition > 0){
+      base = base.slice(0, hashPosition);
+    }
+
+    var stack = base.split("/"),
+        parts = relative.split("/");
+    stack.pop();
+    for (var i=0; i<parts.length; i++) {
+      if (parts[i] == ".")
+        continue;
+      if (parts[i] == "..")
+        stack.pop();
+      else
+        stack.push(parts[i]);
+    }
+    return stack.join("/");
+  }
+
+  window.traverseTreeData = function(treeData, paths) {
+    if(paths.length == 0) { return []; }
+
+    const currentNode = paths[0];
+
+    let nodeIndex = treeData.findIndex(function(node) { return node.name == currentNode.name });
+    if(nodeIndex == -1) {
+      let node = {
+        name: currentNode.name,
+        example: currentNode.example,
+        expanded: true,
+        children: traverseTreeData([], paths.slice(1))
+      };
+      treeData.push(node);
+
+    } else {
+      let node = treeData[nodeIndex];
+      node.children = traverseTreeData(node.children, paths.slice(1));
+      node.expanded = (node.children.length > 1) ? false : true;
+      treeData[nodeIndex] = node;
+    }
+
+    return treeData;
+  };
+
+  $('.source_table.highlighted li.covered').live('click', function() {
+    const exampleRefs = $(this).children('.reverse_coverage')[0].dataset.exampleRefs.split(",");
+    if(!$(this).children('.reverse_coverage').is(':visible')){
+      let treeData = [];
+      const self = this;
+      exampleRefs.forEach(function(ref) {
+        const example = window.examples[ref]
+        const treeNodes = []
+        example["file_path"].split('/').slice(1).forEach(function(node_path){
+          treeNodes.push({ name: node_path })
+        });
+        treeNodes.push({ example: example, name: example['full_description'] });
+
+        treeData = traverseTreeData(treeData, treeNodes)
+      })
+
+      const domElement = self.querySelector('.reverse_coverage');
+
+      let tree = new TreeView(treeData, domElement);
+      tree.on('select', function (node) {
+        const example = node.data.example;
+        const url = getAbsoluteUrl('', `${window.base_url}${example.file_path}#L${example.line_number}`);
+        window.open(url, '_blank');
+      });
+      $(this).children('.reverse_coverage').show();
+    } else {
+      $(this).children('.reverse_coverage').html('');
+      $(this).children('.reverse_coverage').hide();
+    }
+  });
+  $('.source_table.highlighted li.covered .reverse_coverage').live('click', function(event) {
+    event.stopPropagation();
+  });
+});