Updating to persist a params snippets variable

app/controllers/search_controller.rb

@@ -5,6 +5,7 @@ class SearchController < ApplicationController
     @project = Project.find_by(id: params[:project_id]) if params[:project_id].present?
     @group = Group.find_by(id: params[:group_id]) if params[:group_id].present?
     @scope = params[:scope]
+    @show_snippets = params[:snippets].eql? 'true'
 
     @search_results = if @project
                         return access_denied! unless can?(current_user, :download_code, @project)
@@ -14,7 +15,7 @@ class SearchController < ApplicationController
                         end
 
                         Search::ProjectService.new(@project, current_user, params).execute
-                      elsif params[:snippets].eql? 'true'
+                      elsif @show_snippets
                         unless %w(snippet_blobs snippet_titles).include?(@scope)
                           @scope = 'snippet_blobs'
                         end

app/helpers/application_helper.rb

@@ -178,7 +178,7 @@ module ApplicationHelper
   def search_placeholder
     if @project && @project.persisted?
       "Search in this project"
-    elsif @snippet || @snippets || (params && params[:snippets] == 'true')
+    elsif @snippet || @snippets || @show_snippets
       'Search snippets'
     elsif @group && @group.persisted?
       "Search in this group"

app/views/search/_filter.html.haml

-- unless params[:snippets]
-  .dropdown.inline
+.dropdown.inline
   %a.dropdown-toggle.btn.btn-small{href: '#', "data-toggle" => "dropdown"}
     %i.icon-tags
     %span.light Group:
@@ -17,7 +16,7 @@
         = link_to search_filter_path(group_id: group.id, project_id: nil) do
           = group.name
 
-  .dropdown.inline.prepend-left-10.project-filter
+.dropdown.inline.prepend-left-10.project-filter
   %a.dropdown-toggle.btn.btn-small{href: '#', "data-toggle" => "dropdown"}
     %i.icon-tags
     %span.light Project:

app/views/search/_results.html.haml

 %h4
   #{@search_results.total_count} results found
-  - unless params[:snippets].eql? 'true'
+  - unless @show_snippets
     - if @project
       for #{link_to @project.name_with_namespace, @project}
     - elsif @group
@@ -12,7 +12,7 @@
   .col-sm-3
     - if @project
       = render "project_filter"
-    - elsif params[:snippets].eql? 'true'
+    - elsif @show_snippets
       = render 'snippet_filter'
     - else
       = render "global_filter"

app/views/search/show.html.haml

@@ -9,6 +9,7 @@
         = submit_tag 'Search', class: "btn btn-create"
     .form-group
       .col-sm-2
+      - unless params[:snippets].eql? 'true'
         .col-sm-10
           = render 'filter', f: f
       = hidden_field_tag :project_id, params[:project_id]

features/snippet_search.feature

+@dashboard
+Feature: Snippet Search
+  Background:
+    Given I sign in as a user
+    And I have public "Personal snippet one" snippet
+    And I have private "Personal snippet private" snippet
+    And I have a public many lined snippet
+
+  Scenario: I should see my public and private snippets
+    When I search for "snippet" in snippet titles
+    Then I should see "Personal snippet one" in results
+    And I should see "Personal snippet private" in results
+
+  Scenario: I should see three surrounding lines on either side of a matching snippet line
+    When I search for "line seven" in snippet contents
+    Then I should see "line four" in results
+    And I should see "line seven" in results
+    And I should see "line ten" in results
+    And I should not see "line three" in results
+    And I should not see "line eleven" in results

features/steps/shared/search.rb

+module SharedSearch
+  include Spinach::DSL
+
+  def search_snippet_contents(query)
+    visit "/search?search=#{URI::encode(query)}&snippets=true&scope=snippet_blobs"
+  end
+
+  def search_snippet_titles(query)
+    visit "/search?search=#{URI::encode(query)}&snippets=true&scope=snippet_titles"
+  end
+end

features/steps/shared/snippet.rb

@@ -18,4 +18,12 @@ module SharedSnippet
            private: true,
            author: current_user)
   end
+  And 'I have a public many lined snippet' do
+    create(:personal_snippet,
+           title: "Many lined snippet",
+           content: "line one\nline two\nline three\nline four\nline five\nline six\nline seven\nline eight\nline nine\nline ten\nline eleven\nline twelve\nline thirteen\nline fourteen",
+           file_name: "many_lined_snippet.rb",
+           private: true,
+           author: current_user)
+  end
 end

features/steps/snippet_search.rb

+class Spinach::Features::SnippetSearch < Spinach::FeatureSteps
+  include SharedAuthentication
+  include SharedPaths
+  include SharedSnippet
+  include SharedUser
+  include SharedSearch
+
+  step 'I search for "snippet" in snippet titles' do
+    search_snippet_titles "snippet"
+  end
+
+  step 'I search for "snippet private" in snippet titles' do
+    search_snippet_titles "snippet private"
+  end
+
+  step 'I search for "line seven" in snippet contents' do
+    search_snippet_contents "line seven"
+  end
+
+  step 'I should see "line seven" in results' do
+    page.should have_content "line seven"
+  end
+
+  step 'I should see "line four" in results' do
+    page.should have_content "line four"
+  end
+
+  step 'I should see "line ten" in results' do
+    page.should have_content "line ten"
+  end
+
+  step 'I should not see "line eleven" in results' do
+    page.should_not have_content "line eleven"
+  end
+
+  step 'I should not see "line three" in results' do
+    page.should_not have_content "line three"
+  end
+
+  Then 'I should see "Personal snippet one" in results' do
+    page.should have_content "Personal snippet one"
+  end
+
+  And 'I should see "Personal snippet private" in results' do
+    page.should have_content "Personal snippet private"
+  end
+
+  Then 'I should not see "Personal snippet one" in results' do
+    page.should_not have_content "Personal snippet one"
+  end
+
+  And 'I should not see "Personal snippet private" in results' do
+    page.should_not have_content "Personal snippet private"
+  end
+
+end

lib/gitlab/snippet_search_results.rb

@@ -48,53 +48,84 @@ module Gitlab
       'snippet_blobs'
     end
 
-    def bounded_line_numbers(line, min, max, surrounding_lines)
+    # Get an array of line numbers surrounding a matching
+    # line, bounded by min/max.
+    #
+    # @returns Array of line numbers
+    def bounded_line_numbers(line, min, max)
       lower = line - surrounding_lines > min ? line - surrounding_lines : min
       upper = line + surrounding_lines < max ? line + surrounding_lines : max
       (lower..upper).to_a
     end
 
-    def chunk_snippet(snippet)
-      surrounding_lines = 3
+    # Returns a sorted set of lines to be included in a snippet preview.
+    # This ensures matching adjacent lines do not display duplicated
+    # surrounding code.
+    #
+    # @returns Array, unique and sorted.
+    def matching_lines(lined_content)
       used_lines = []
-      lined_content = snippet.content.split("\n")
       lined_content.each_with_index do |line, line_number|
         used_lines.concat bounded_line_numbers(
           line_number,
           0,
-          lined_content.size,
-          surrounding_lines
+          lined_content.size
         ) if line.include?(query)
       end
 
-      used_lines = used_lines.uniq.sort
+      used_lines.uniq.sort
+    end
+
+    # 'Chunkify' entire snippet.  Splits the snippet data into matching lines +
+    # surrounding_lines() worth of unmatching lines.
+    #
+    # @returns a hash with {snippet_object, snippet_chunks:{data,start_line}}
+    def chunk_snippet(snippet)
+      lined_content = snippet.content.split("\n")
+      used_lines = matching_lines(lined_content)
 
       snippet_chunk = []
       snippet_chunks = []
       snippet_start_line = 0
       last_line = -1
+
+      # Go through each used line, and add consecutive lines as a single chunk
+      # to the snippet chunk array.
       used_lines.each do |line_number|
         if last_line < 0
+          # Start a new chunk.
           snippet_start_line = line_number
           snippet_chunk << lined_content[line_number]
         elsif last_line == line_number - 1
+          # Consecutive line, continue chunk.
           snippet_chunk << lined_content[line_number]
         else
+          # Non-consecutive line, add chunk to chunk array.
           snippet_chunks << {
             data: snippet_chunk.join("\n"),
             start_line: snippet_start_line + 1
           }
+
+          # Start a new chunk.
           snippet_chunk = [lined_content[line_number]]
           snippet_start_line = line_number
         end
         last_line = line_number
       end
+      # Add final chunk to chunk array
       snippet_chunks << {
         data: snippet_chunk.join("\n"),
         start_line: snippet_start_line + 1
       }
 
+      # Return snippet with chunk array
       { snippet_object: snippet, snippet_chunks: snippet_chunks }
     end
+
+    # Defines how many unmatching lines should be
+    # included around the matching lines in a snippet
+    def surrounding_lines
+      3
+    end
   end
 end