group :test do

gem 'capybara', '2.4.4'

gem 'html-proofer', '~> 2.6'

gem 'rspec', '3.1'

gem 'selenium-webdriver', '2.45.0'

gem 'jsonlint', '0.1.0'

addressable (2.3.8)

awesome_print (1.6.1)

builder (3.2.2)

capybara (2.4.4)

mime-types (>= 1.16)

nokogiri (>= 1.3.3)

rack (>= 1.0.0)

rack-test (>= 0.5.4)

xpath (~> 2.0)

childprocess (0.5.8)

ffi (~> 1.0, >= 1.0.11)

colorator (0.1)

colored (1.2)

cri (2.7.0)

colored (~> 1.2)

diff-lcs (1.2.5)

dotenv (2.0.2)

ethon (0.8.0)

ffi (>= 1.3.0)

activesupport

html-pipeline (>= 1.11)

rouge (~> 1.8)

html-proofer (2.6.1)

activesupport (~> 4.2)

addressable (~> 2.3)

colored (~> 1.2)

mercenary (~> 0.3.2)

jekyll-watch (1.3.0)

listen (~> 3.0)

json (1.8.3)

jsonlint (0.1.0)

oj (~> 2)

kramdown (1.9.0)

liquid (3.0.6)

listen (3.0.5)

rb-fsevent (>= 0.9.3)

rb-inotify (>= 0.9)

mercenary (0.3.5)

mime-types (3.0)

mime-types-data (~> 3.2015)

mime-types-data (3.2015.1120)

mini_portile2 (2.0.0)

minitest (5.8.3)

multi_json (1.11.2)

multipart-post (2.0.0)

nanoc (4.0.2)

cri (~> 2.3)

mini_portile2 (~> 2.0.0.rc2)

octokit (4.2.0)

sawyer (~> 0.6.0, >= 0.5.3)

oj (2.14.1)

page-toc-filter (0.0.1)

html-pipeline (~> 2.0)

nokogiri (~> 1.6.4)

rack-protection (1.5.3)

rack

rack-ssl-enforcer (0.2.9)

rack-test (0.6.3)

rack (>= 1.0)

rake (10.3.2)

rb-fsevent (0.9.6)

rb-inotify (0.9.5)

ffi (>= 0.5.0)

rouge (1.10.1)

rspec (3.1.0)

rspec-core (~> 3.1.0)

rspec-expectations (~> 3.1.0)

rspec-mocks (~> 3.1.0)

rspec-core (3.1.7)

rspec-support (~> 3.1.0)

rspec-expectations (3.1.2)

diff-lcs (>= 1.2.0, < 2.0)

rspec-support (~> 3.1.0)

rspec-mocks (3.1.3)

rspec-support (~> 3.1.0)

rspec-support (3.1.2)

rubyzip (1.1.7)

safe_yaml (1.0.4)

sass (3.4.19)

sawyer (0.6.0)

addressable (~> 2.3.5)

faraday (~> 0.8, < 0.10)

selenium-webdriver (2.45.0)

childprocess (~> 0.5)

multi_json (~> 1.0)

rubyzip (~> 1.0)

websocket (~> 1.0)

sinatra (1.4.6)

rack (~> 1.4)

rack-protection (~> 1.4)

activesupport (> 3.0)

octokit (> 2.1.0)

warden (> 1.0)

websocket (1.2.2)

xpath (2.0.0)

nokogiri (~> 1.3)

yell (2.0.5)

awesome_print (= 1.6.1)

builder (~> 3.2)

capybara (= 2.4.4)

extended-markdown-filter (~> 0.4)

gemoji (= 2.1.0)

github-markdown (= 0.6.9)

html-pipeline-rouge_filter (~> 1.0)

html-proofer (~> 2.6)

jekyll-auth (~> 2.0)

jsonlint (= 0.1.0)

nanoc (~> 4.0)

nanoc-conref-fs (~> 0.5)

nanoc-html-pipeline (= 0.3.3)

nokogiri (~> 1.6.0)

page-toc-filter (~> 0.0.1)

rake (= 10.3.2)

rspec (= 3.1)

selenium-webdriver (= 2.45.0)

1.10.6

desc "Test the output"

task :test => [:remove_tmp_dir, :remove_output_dir, :build] do

Rake::Task['spec'].invoke

Rake::Task['run_proofer'].invoke

desc "Run Rspec"

task :spec do

require 'rspec/core/rake_task'

RSpec::Core::RakeTask.new(:rspec)

Rake::Task['rspec'].invoke

desc "Run the HTML-Proofer"

task :run_proofer do

title: GitHub Developer

layout: overview

hide_from_search: true

<div class="wrapper feature">

[

<% @items.select { |item| !item.attributes[:hide_from_search] }.each do |item| %>

<% next if item[:filename].nil? || !item[:filename].end_with?('.md') %>

<% @path = item[:filename].split('/')[1..-1].join('/')[0..-4] %>

<% @path.chomp!('/index') if @path.end_with?('/index') %>

{

"title": "<%= clean_for_json(item[:title]) %>",

<%# Split off the directory name, join, then remove the '.md' extension %>

"url": "/<%= @path %>/",

"body": "<%= clean_for_json(item.compiled_content) %>"

},

<% end %>

echo "PATH: ${PATH}"

echo ""

script/test

set -e

cd "$(dirname "$0")/.."

[ -z "$DEBUG" ] || set -x

export RACK_ROOT=$(cd "$(dirname $0)"/.. && pwd)

export RAILS_ENV="test" RACK_ENV="test"

script/bootstrap

echo "===> Running tests..."

if [ -n "$JANKY_ID" ]; then

xvfb-run -a bundle exec rake test

bundle exec rake test

This folder contains (almost) our entire test suite. We split these tests into different subfolders in this directory.

In addition, we use [HTML-Proofer](https://github.com/gjtorikian/html-proofer) to validate our built site. More on this below.

The tests in this directory include:

* The *content* folder contains tests which are run over our Markdown and YAML files before they are built. These tests include:

* Ensuring that reusables are written correctly.

* Ensuring that there are no Liquid errors.

* Ensuring that there are no search errors.

* The *features* folder contains tests that deal with how the site functions. These tests include:

* Whether the search links are valid.

* Whether the sidebar is working.

* Whether redirects are working.

There are two more types of tests that are controlled by HTML-Proofer:

* HTML-Proofer validates that our *internal* content is working. That means that internal links are working, our images have alt tags, etc.

* HTML-Proofer also validates our *external* content. That means URLs to external websites, external images, etc.

require 'spec_helper'

describe 'Validity' do

it 'has no Liquid errors' do

failed_files = []

Dir.glob('output/**/*.html').each do |html_path|

html = File.read(html_path)

failed_files.push(html_path) if html =~ /Liquid error/

end

unless failed_files.empty?

fail "Found files with broken Liquid syntax!\n\nThe following files are broken:\n #{failed_files.join("\n")}"

end

end

it 'has no unresolved conrefs' do

failed_files = []

Dir.glob('output/**/*.html').each do |html_path|

html = File.read(html_path)

failed_files.push(html_path) if html =~ /{{ site.data/

end

unless failed_files.empty?

fail "Found #{failed_files.length} files with unresolved conrefs! These are conrefs that still say `{{ site.data` in the output.\n\nThe following files are not resolving: #{failed_files.join("\n")}"

end

end

it 'has a working search' do

output = `jsonlint output/search/search-index.json`

fail output unless output.empty?

end