Sitespec

Generate static site from your rack application & test files.

• Provides the same way to create both dynamic & static website
• Generates static website from your existing dynamic website
• Sitespec can be executable specification, good documentation, and well-tested implementation

# Gemfile
gem "sitespec"

# spec/spec_helper.rb
require "sitespec/rspec"

Note: rack/test is automatically enabled in the example groups that have :sitespec.

# spec/site_spec.rb
describe "Sitespec" do
  let(:app) do
    MyRackApp
  end

  %w[
    /
    /2000/01/01/hello
    /stylesheets/all.css
  ].each do |path|
    describe "GET #{path}", :sitespec do
      it "returns 200" do
        expect(get(path).status).to eq 200
      end
    end
  end
end

Note: only successful examples generate static files.

$ bundle exec rspec

Example application
  GET /
    returns 200
  GET /2000/01/01/hello
    returns 200
  GET /stylesheets/all.css
    returns 200

Sitespec generated 3 files into build directory.

Finished in 0.08302 seconds (files took 0.79161 seconds to load)
3 examples, 0 failures

• Sitespec.configuration.auto_complete_html_path - Autocomplete .html (default: true)
• Sitespec.configuration.build_path - Where to locate files (default: build)
• Sitespec.configuration.enabled - Enable sitespec (default: true)

Sitespec is excellent with GitHub Pages. r7kamura/r7kamura.github.io is a working example that uses Sitespec to build static files from Rack application. It uses TravisCI to build and push files to GitHub repo's master branch. See .travis.yml for more information about how to to it.