jekyll-app-engine 0.1.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    MTA0NWU4YTkxMDBlODhlOGE1YzRlMzNmZTg4MjE3MTM3ZTJlMDcyZA==
+  data.tar.gz: !binary |-
+    YTRlNjQwYzAxNzRmYTNjN2RmNWIzN2M0MTNjMzExZWMyM2RlOTlkMg==
+SHA512:
+  metadata.gz: !binary |-
+    ZDQ5N2M2OTZkMzVhMDcxMzk0MDhiOWZiMjE0NWM3NmVkNTUwOTliNDZhM2Ji
+    ZTFiOWI4ZmU5ZTBlNmM1MDcyNGFhM2JkN2U0ZTZjYjBiZDdlOTBiMDNkYTM2
+    ZDNkNTE4Y2ZlZTA5OWVlNjc3OWYwZTQxOTRmZWI1OWRkMTNlZGM=
+  data.tar.gz: !binary |-
+    ZjU5OThlMTU2MjU2NDQzNjdmMDhlYzU2MTI3MTM4NDlmZDM1Yzg3MjhjM2Yw
+    Y2JmMDQyNGZlNzI0ZjM2MTAzOGJiOTJhYjBjNDU0NmJhZjRhM2Q1N2M4YWQ4
+    MDg1ODdhZGUwMzJhZGY5ZmZjMWUwNjU5MGMzNzA2YzMzM2I3YTI=

data/.gitignore

@@ -0,0 +1,24 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/dest/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/.simplecov

@@ -0,0 +1,3 @@
+SimpleCov.start do
+  add_filter "/lib/google-yaml.rb"
+end

data/.travis.yml

@@ -0,0 +1,12 @@
+language: ruby
+rvm:
+- 2.2.3
+script:
+- rake
+deploy:
+  provider: rubygems
+  gemspec: jekyll-app-engine.gemspec
+  api_key:
+    secure: gEbhxtKjKEz7JIez+hljl1IJMq8fyUOGKIXJWTWJnF4U3NZPHTq+Wv1AQKsgI80NpqTpCDTOfbiCPJ0Iti8XObkNjtfa7k9CNs/2MvQYcIWaDWP6ibgHTKZptiLh3IP+lkK3z2ZRvl4vaP/v2qKC16oaazqoli7Um0gj9dbX2A2PjxN9BZGMfgV1C3U1Igri7OWu37vVapuPvQ8NgeXOO8wWjP5tlJ2oOl0yHVXOVkw5Dwv8jpiFF0srz+lH+2FRG7yAZ95850okpNsyka+AOA1dJzBGZpyAwN3WCPQU0bsirijjDBdWpI0sxtSQFPA7z4up0PUv4/x34k9EtYjs31Xm4rtpItUiE7bgC8MVc4Li0gxhKuSQmAXozJHErM5GQZzeUUaaZffVbtKZsZUS2BX0zuRUO+22Jjfeh/nUkNiDPKVIIp5n7e2UPuGSruBy9t6GlR17KmLJ1uFV+a6WxTPlAUwS82WIuVdTzn2XrWc0WNLAHHfO3wJqFhwtGlowgmS7c7RTvc7MNkNk25e6P/p8TrEhameOxEjl6x7+lHXNZY6ssPwazGPagy2T39kSS/alCNYLuAIEkcFArM/c7tXPoajbYxpDdRJzmQm0ipKZ/xUp/Ij2GG3hF+Oq/9vBBF6/7oCLrC6Gynq7rXUlTaZURTkY3AzZQXlvmmYK4Ww=
+  on:
+    tags: true

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+gemspec
+
+if ENV["JEKYLL_VERSION"]
+  gem "jekyll", "~> #{ENV["JEKYLL_VERSION"]}"
+end

data/History.markdown

@@ -0,0 +1,7 @@
+## 0.1.0 / 2016-03-06
+
+  * Birthday!
+
+## 0.0.0 / 2016-02-24
+
+  * Initial alpha and experimentation

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 James Ramsay
+
+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,97 @@
+# Jekyll App Engine: easy deployments to Google App Engine
+
+[![Build Status](https://img.shields.io/travis/jamesramsay/jekyll-app-engine/master.svg)](https://travis-ci.org/jamesramsay/jekyll-app-engine)
+[![Version](https://img.shields.io/gem/v/jekyll-app-engine.svg)](https://rubygems.org/gems/jekyll-app-engine)
+[![Coverage Status](https://img.shields.io/codecov/c/github/jamesramsay/jekyll-app-engine/master.svg)](https://codecov.io/github/jamesramsay/jekyll-app-engine)
+
+Jekyll App Engine (`jekyll-app-engine`) makes it easy to deploy your [Jekyll](http://jekyll.com) static site to [Google App Engine](https://appengine.google.com) by generating your `app.yaml` handlers.
+
+Hosting your static site on Google App Engine gives you greater flexibility than using Github Pages and may potentially be cheaper and more configurable than Amazon AWS.
+Using Google App Engine allows:
+
+- fine grained HTTP cache control for pages and assets,
+- HTTP/2 support including server push `Link: "</assets/style.css>; rel=preload; as=style,"`, and
+- custom jekyll plugins not permitted by Github Pages, such as [`jekyll-assets`](http://github.com/jekyll/jekyll-assets)
+
+Using Google App Engine has some challenges:
+
+- Customising handling of 404 errors can only be done by running an application instance, which may be costly.
+
+## Get Started
+
+These instructions assume you already have a [Google App Engine account](https://console.cloud.google.com/).
+
+### 1. Install jekyll-app-engine
+
+Add `gem jekyll-app-engine` to your `Gemfile`.
+
+```
+source 'https://rubygems.org'
+gem 'github-pages'
+gem 'jekyll-app-engine'
+```
+
+Add to your `config.yml`.
+
+```yaml
+gems:
+  - jekyll-app-engine
+```
+
+### 2. Basic configuration
+
+Specify a basic configuration in the file `_app.yaml` or using the `app_engine` option configurations to your Jekyll `_config.yml`.
+
+```yaml
+app_engine:
+  # Insert your configuration here or within _app.yaml
+  # You need to specify a runtime for App Engine
+  runtime: go
+  api_version: go1
+  default_expiration: 300s
+```
+
+### 3. Create an empty 'app'
+
+App Engine expects all apps to have some sort of application.
+Create a file called `init.go`.
+
+```go
+// Included to enable deployment to Google App Engine
+package hello
+
+import (
+)
+
+func init() {
+}
+```
+
+You can put this anywhere, for example in a folder `_app/init.go` to keep your root tidy.
+
+### 4. Test and Deploy
+
+Build your jekyll site, and you should notice the file `app.yaml` in the output directory.
+Before deploying you will need to move this file to the projects root directory, where your `config.yml` file is located.
+
+Automatic deployment using Travis: https://docs.travis-ci.com/user/deployment/google-app-engine
+
+Manual deployment using the Google App Engine tools: todo
+
+## Documentation
+
+### Basic Configuration
+
+jekyll-app-engine can be configured by creating a file `_app.yaml` in the source directory or by providing the configuration in the Jekyll config `_config.yml`.
+The `handlers` option allows you to specify custom http headers and other feature supported by Google App Engine by Jekyll content type. The supported content types are:
+
+- `posts`
+- `pages`
+- `collections`
+- `static`
+
+If you provide an Array or a `url` option, the configuration for the content type will be inserted directly as a handler, instead of generating a handler per item within the content type.
+
+### Document Specific Overrides
+
+Each document can specify overrides within the document's YAML frontmatter.

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/jekyll-app-engine.gemspec

@@ -0,0 +1,22 @@
+# coding: utf-8
+
+Gem::Specification.new do |spec|
+  spec.name        = "jekyll-app-engine"
+  spec.summary     = "Generator for Google App Engine Handlers."
+  spec.version     = "0.1.0"
+  spec.authors     = ["James Ramsay"]
+  spec.email       = "git@jwr.vc"
+  spec.homepage    = "http://github.com/jamesramsay/jekyll-app-engine"
+  spec.licenses    = ["MIT"]
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "jekyll", ">= 2.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "codecov"
+end

data/lib/app.yaml

@@ -0,0 +1 @@
+{{ content }}

data/lib/google-yaml.rb

@@ -0,0 +1,42 @@
+# Google App Engine doesn't support achors and alias feature of YAML
+# Psych doesn't provide an option to disable achors/alias YAML features
+#
+# HACK: subclass the native YAMLTree, and bypass logic which checks for aliases
+# ../psych/vistors/yaml_tree.rb
+class GoogleYAMLTree < Psych::Visitors::YAMLTree
+  def accept target
+    # HACK: disabled alias lookup
+    # return any aliases we find
+    # if @st.key? target
+    #   oid         = @st.id_for target
+    #   node        = @st.node_for target
+    #   anchor      = oid.to_s
+    #   node.anchor = anchor
+    #   return @emitter.alias anchor
+    # end
+
+    if target.respond_to?(:to_yaml)
+      begin
+        loc = target.method(:to_yaml).source_location.first
+        if loc !~ /(syck\/rubytypes.rb|psych\/core_ext.rb)/
+          unless target.respond_to?(:encode_with)
+            if $VERBOSE
+              warn "implementing to_yaml is deprecated, please implement \"encode_with\""
+            end
+
+            target.to_yaml(:nodump => true)
+          end
+        end
+      rescue
+        # public_method or source_location might be overridden,
+        # and it's OK to skip it since it's only to emit a warning
+      end
+    end
+
+    if target.respond_to?(:encode_with)
+      dump_coder target
+    else
+      send(@dispatch_cache[target.class], target)
+    end
+  end
+end

data/lib/jekyll-app-engine.rb

@@ -0,0 +1,171 @@
+require 'fileutils'
+require 'google-yaml'
+
+module Jekyll
+
+  class PageWithoutAFile < Page
+    def read_yaml(*)
+      @data ||= {}
+    end
+  end
+
+  class JekyllAppEngine < Jekyll::Generator
+    safe true
+    priority :lowest
+
+    # Main plugin action, called by Jekyll-core
+    def generate(site)
+      @site = site
+      @app_engine = source_config
+
+      unless app_yaml_exists?
+        unless @app_engine
+          raise "App engine base configration not found"
+        end
+
+        @app_engine["handlers"] ||= {}
+
+        write
+        @site.keep_files ||= []
+        @site.keep_files << "app.yaml"
+      end
+    end
+
+    def source_config
+      if @site.config.has_key?("app_engine")
+        @site.config["app_engine"]
+      elsif source_partial_exists?
+        YAML.load_file(source_path)
+      end
+    end
+
+    # Checks if a optional _app.yaml partial already exists
+    def source_partial_exists?
+      if @site.respond_to?(:in_source_dir)
+        File.exists? @site.in_source_dir("_app.yaml")
+      else
+        File.exists? Jekyll.sanitized_path(@site.source, "_app.yaml")
+      end
+    end
+
+    # Path to optional _app.yaml partial
+    def source_path
+      if @site.respond_to?(:in_source_dir)
+        @site.in_source_dir("_app.yaml")
+      else
+        Jekyll.sanitized_path(@site.source, "_app.yaml")
+      end
+    end
+
+    # Destination for app.yaml file within the site source directory
+    def destination_path
+      if @site.respond_to?(:in_dest_dir)
+        @site.in_dest_dir("app.yaml")
+      else
+        Jekyll.sanitized_path(@site.dest, "app.yaml")
+      end
+    end
+
+    def write
+      FileUtils.mkdir_p File.dirname(destination_path)
+      File.open(destination_path, 'w') { |f| f.write(app_yaml_content) }
+    end
+
+    def app_yaml_content
+      # HACK: use sub-classed YAML implementation which disables anchors and aliases
+      builder = GoogleYAMLTree.create
+      builder << generate_app_engine_yaml
+
+      app_yaml = PageWithoutAFile.new(@site, File.dirname(__FILE__), "", "app.yaml")
+      app_yaml.content = builder.tree.yaml
+      app_yaml.data["layout"] = nil
+      app_yaml.render({}, @site.site_payload)
+      return app_yaml.output
+    end
+
+    def output_collection?(label)
+      @site.config["collections"]["#{label}"]["output"]
+    end
+
+    def page_types
+      page_types_array = [
+        {
+          "content_type" => "posts",
+          "content_collection" => @site.posts.docs
+        },
+        {
+          "content_type" => "pages",
+          "content_collection" => @site.pages
+        },
+        {
+          "content_type" => "static",
+          "content_collection" => @site.static_files
+        },
+      ]
+
+      @site.collections.each_pair do |label, collection|
+        if label != "posts" and output_collection?(label)
+          page_types_array << {
+            "content_type" => "collections",
+            "content_collection" => collection.docs
+          }
+        end
+      end
+
+      return page_types_array
+    end
+
+    def generate_app_engine_yaml
+      app_yaml = @app_engine.dup
+      generated_handlers = []
+
+      page_types.each do |content|
+        generate_handlers(content).each { |handler| generated_handlers << handler }
+      end
+
+      app_yaml["handlers"] = generated_handlers
+
+      return app_yaml
+    end
+
+    def generate_handlers(content)
+      content_type = content["content_type"]
+      content_collection = content["content_collection"]
+      handlers = []
+
+      handler_template = @app_engine["handlers"][content_type] || {}
+      if handler_template.kind_of?(Array) or handler_template.has_key?("url")
+        handlers << handler_template
+      else
+        content_collection.each do |doc|
+          handler = {
+            "url" => doc.url,
+            "static_files" => doc.destination("").sub("#{Dir.pwd}/", ""),
+            "upload" => doc.destination("").sub("#{Dir.pwd}/", "")
+          }
+          handlers << handler.merge!(handler_template.dup).merge!(document_overrides(doc))
+        end
+      end
+
+      return handlers
+    end
+
+    # Document specific app.yaml configuration provided in yaml frontmatter
+    def document_overrides(document)
+      if document.respond_to?(:data) and document.data.has_key?("app_engine")
+        document.data.fetch("app_engine")
+      else
+        {}
+      end
+    end
+
+    # Checks if a app.yaml already exists in the site source
+    def app_yaml_exists?
+      if @site.respond_to?(:in_source_dir)
+        File.exists? @site.in_source_dir("app.yaml")
+      else
+        File.exists? Jekyll.sanitized_path(@site.source, "app.yaml")
+      end
+    end
+  end
+end

data/script/bootstrap

@@ -0,0 +1,3 @@
+#!/bin/sh
+
+bundle install

data/script/cibuild

@@ -0,0 +1,4 @@
+#!/bin/sh
+set -e
+
+bundle exec rspec

data/script/console

@@ -0,0 +1,34 @@
+#! /usr/bin/env ruby
+
+def relative_to_root(path)
+  File.expand_path(path, File.dirname(File.dirname(__FILE__)))
+end
+
+require 'jekyll'
+require relative_to_root('lib/jekyll-app-engine.rb')
+require 'pry-debugger'
+
+SOURCE_DIR = relative_to_root('spec/fixtures')
+DEST_DIR   = relative_to_root('spec/dest')
+
+def source_dir(*files)
+  File.join(SOURCE_DIR, *files)
+end
+
+def dest_dir(*files)
+  File.join(DEST_DIR, *files)
+end
+
+def config(overrides = {})
+  Jekyll.configuration({
+    "source"      => source_dir,
+    "destination" => dest_dir,
+    "url"         => "http://example.org"
+  }).merge(overrides)
+end
+
+def site(configuration = config)
+  Jekyll::Site.new(configuration)
+end
+
+binding.pry

data/script/release

@@ -0,0 +1,7 @@
+#!/bin/sh
+# Tag and push a release.
+
+set -e
+
+script/cibuild
+bundle exec rake release

data/spec/fixtures/_app.yaml

@@ -0,0 +1,11 @@
+runtime: go
+api_version: go1
+default_expiration: 300s
+
+handlers:
+  posts:
+    http_headers:
+      Link: "</static/css/style.css>; rel=preload; as=style"
+  post-static:
+    url: /images/
+    static_dir: spec/dest/images

data/spec/fixtures/_config.yml

@@ -0,0 +1,9 @@
+timezone: UTC
+
+defaults:
+  -
+    scope:
+      path: ""
+      type: page
+    values:
+      layout: some_default

data/spec/fixtures/_layouts/some_default.html

@@ -0,0 +1,4 @@
+---
+---
+THIS IS MY LAYOUT
+{{ content }}

data/spec/fixtures/_my_collection/custom_permalink.md

@@ -0,0 +1,5 @@
+---
+permalink: /permalink/
+---
+
+# Custom permalink

data/spec/fixtures/_my_collection/custom_permalink_2.md

@@ -0,0 +1,5 @@
+---
+permalink: /permalink/unique_name.html
+---
+
+# Unique html name

data/spec/fixtures/_my_collection/test.html

@@ -0,0 +1,4 @@
+---
+---
+
+This is just a test.

data/spec/fixtures/_my_collection/this-has-non-standard-chars.md

@@ -0,0 +1,5 @@
+---
+permalink: this url has an ümlaut
+---
+
+# URL contains characters that need to be URI encoded

data/spec/fixtures/_other_things/test2.html

@@ -0,0 +1,4 @@
+---
+---
+
+This file shouldn't show up in the app.yaml.

data/spec/fixtures/_posts/2013-12-12-dec-the-second.md

@@ -0,0 +1,4 @@
+---
+---
+
+December the twelfth, actually.

data/spec/fixtures/_posts/2014-03-02-march-the-second.md

@@ -0,0 +1,4 @@
+---
+---
+
+March the second!

data/spec/fixtures/_posts/2014-03-04-march-the-fourth.md

@@ -0,0 +1,4 @@
+---
+---
+
+March the fourth!

data/spec/fixtures/_posts/2015-01-18-jekyll-last-modified-at.md

@@ -0,0 +1,4 @@
+---
+---
+
+Please don't modify this file. It's modified time is important.

data/spec/fixtures/feeds/atom.xml

@@ -0,0 +1,6 @@
+---
+---
+
+<?xml version="1.0" encoding="utf-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom">
+</feed>

data/spec/fixtures/index.html

@@ -0,0 +1,7 @@
+---
+app_engine:
+  http_headers:
+    Cache-Control: "max-age=3600"
+---
+
+HERE IS MY SITE I AM SO EXCITED TO BE USING GITHUB PAGES

data/spec/fixtures/jekyll-last-modified-at/page.html

@@ -0,0 +1,4 @@
+---
+---
+
+This is a page with a modified time.

data/spec/fixtures/some-subfolder/htm.htm

@@ -0,0 +1 @@
+This file has an .htm extension, and should be included in the app.yaml

data/spec/fixtures/some-subfolder/test_index.html

@@ -0,0 +1,4 @@
+---
+---
+
+The permalink of this page does not end with a '/', but with a filename

data/spec/fixtures/some-subfolder/this-is-a-subpage.html

@@ -0,0 +1,4 @@
+---
+---
+
+This is a subpage!

data/spec/fixtures/some-subfolder/xhtml.xhtml

@@ -0,0 +1 @@
+This file has an .xhtml extension, and should be included in the app.yaml

data/spec/jekyll-app-engine_spec.rb

@@ -0,0 +1,131 @@
+# encoding: UTF-8
+
+require 'spec_helper'
+
+describe(Jekyll::JekyllAppEngine) do
+  let(:overrides) do
+    {
+      "source"      => source_dir,
+      "destination" => dest_dir,
+      "url"         => "http://example.org",
+      "collections" => {
+        "my_collection" => { "output" => true },
+        "other_things"  => { "output" => false }
+      }
+    }
+  end
+  let(:config) do
+    Jekyll.configuration(overrides)
+  end
+  let(:site)     { Jekyll::Site.new(config) }
+  let(:contents) { File.read(dest_dir("app.yaml")) }
+  let(:app_yaml) { YAML.load_file(dest_dir("app.yaml")) }
+  let(:handlers) { app_yaml["handlers"] }
+  before(:each) do
+    site.process
+  end
+
+  it "has no layout" do
+    expect(contents).not_to match(/\ATHIS IS MY LAYOUT/)
+  end
+
+  it "creates an app.yaml file" do
+    expect(File.exist?(dest_dir("app.yaml"))).to be_truthy
+  end
+
+  it "doesn't have multiple new lines or trailing whitespace" do
+    expect(contents).to_not match /\s+\n/
+    expect(contents).to_not match /\n{2,}/
+  end
+
+  it "puts all the pages in the app.yaml file" do
+    expect(handlers).to include({
+      "url"          => "/",
+      "static_files" => "spec/dest/index.html",
+      "upload"       => "spec/dest/index.html",
+      "http_headers" => {
+        "Cache-Control" => "max-age=3600"
+      }
+    })
+    expect(handlers).to include({
+      "url"          => "/some-subfolder/this-is-a-subpage.html",
+      "static_files" => "spec/dest/some-subfolder/this-is-a-subpage.html",
+      "upload"       => "spec/dest/some-subfolder/this-is-a-subpage.html"
+    })
+  end
+
+  it "only strips 'index.html' from end of permalink" do
+    expect(handlers).to include({
+      "url"          => "/some-subfolder/test_index.html",
+      "static_files" => "spec/dest/some-subfolder/test_index.html",
+      "upload"       => "spec/dest/some-subfolder/test_index.html"
+    })
+  end
+
+  it "puts all the posts in the app.yaml file" do
+    expect(handlers).to include({
+      "url"          => "/2013/12/12/dec-the-second.html",
+      "static_files" => "spec/dest/2013/12/12/dec-the-second.html",
+      "upload"       => "spec/dest/2013/12/12/dec-the-second.html",
+      "http_headers" => {
+              "Link" => "</static/css/style.css>; rel=preload; as=style"
+      }
+    })
+    expect(handlers).to include({
+      "url"          => "/2014/03/02/march-the-second.html",
+      "static_files" => "spec/dest/2014/03/02/march-the-second.html",
+      "upload"       => "spec/dest/2014/03/02/march-the-second.html",
+      "http_headers" => {
+              "Link" => "</static/css/style.css>; rel=preload; as=style"
+      }
+    })
+    expect(handlers).to include({
+      "url"          => "/2014/03/04/march-the-fourth.html",
+      "static_files" => "spec/dest/2014/03/04/march-the-fourth.html",
+      "upload"       => "spec/dest/2014/03/04/march-the-fourth.html",
+      "http_headers" => {
+              "Link" => "</static/css/style.css>; rel=preload; as=style"
+      }
+    })
+  end
+
+  describe "collections" do
+    it "puts all the `output:true` into app.yaml" do
+      expect(handlers).to include({
+        "url"          => "/my_collection/test.html",
+        "static_files" => "spec/dest/my_collection/test.html",
+        "upload"       => "spec/dest/my_collection/test.html"
+      })
+    end
+
+    it "doesn't put all the `output:false` into app.yaml" do
+      expect(contents).to_not match /\/other_things\/test2\.html/
+    end
+  end
+
+  it "puts all the static HTML files in the app.yaml file" do
+    expect(handlers).to include({
+      "url"          => "/some-subfolder/this-is-a-subfile.html",
+      "static_files" => "spec/dest/some-subfolder/this-is-a-subfile.html",
+      "upload"       => "spec/dest/some-subfolder/this-is-a-subfile.html"
+    })
+  end
+
+  it "includes the correct number of items" do
+    expect(handlers.length).to eql 17
+  end
+
+  context "with a base in _config.yml" do
+    let(:config) do
+      config_override = { "app_engine" => {
+        "runtime" => "python27",
+        "api_version" => 1
+      } }
+      Jekyll.configuration(Jekyll::Utils.deep_merge_hashes(overrides, config_override))
+    end
+
+    it "correctly uses _config.yml runtime" do
+      expect(app_yaml["runtime"]).to eql "python27"
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,28 @@
+require 'simplecov'
+
+if ENV['CI'] == 'true'
+  require 'codecov'
+  SimpleCov.formatter = SimpleCov::Formatter::Codecov
+end
+
+require 'jekyll'
+require File.expand_path('../lib/jekyll-app-engine', File.dirname(__FILE__))
+
+Jekyll.logger.log_level = :error
+
+RSpec.configure do |config|
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+  config.order = 'random'
+
+  SOURCE_DIR = File.expand_path("../fixtures", __FILE__)
+  DEST_DIR   = File.expand_path("../dest",     __FILE__)
+
+  def source_dir(*files)
+    File.join(SOURCE_DIR, *files)
+  end
+
+  def dest_dir(*files)
+    File.join(DEST_DIR, *files)
+  end
+end

metadata

@@ -0,0 +1,175 @@
+--- !ruby/object:Gem::Specification
+name: jekyll-app-engine
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- James Ramsay
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-03-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: jekyll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: codecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email: git@jwr.vc
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .simplecov
+- .travis.yml
+- Gemfile
+- History.markdown
+- LICENSE
+- README.md
+- Rakefile
+- jekyll-app-engine.gemspec
+- lib/app.yaml
+- lib/google-yaml.rb
+- lib/jekyll-app-engine.rb
+- script/bootstrap
+- script/cibuild
+- script/console
+- script/release
+- spec/fixtures/_app.yaml
+- spec/fixtures/_config.yml
+- spec/fixtures/_layouts/some_default.html
+- spec/fixtures/_my_collection/custom_permalink.md
+- spec/fixtures/_my_collection/custom_permalink_2.md
+- spec/fixtures/_my_collection/test.html
+- spec/fixtures/_my_collection/this-has-non-standard-chars.md
+- spec/fixtures/_other_things/test2.html
+- spec/fixtures/_posts/2013-12-12-dec-the-second.md
+- spec/fixtures/_posts/2014-03-02-march-the-second.md
+- spec/fixtures/_posts/2014-03-04-march-the-fourth.md
+- spec/fixtures/_posts/2015-01-18-jekyll-last-modified-at.md
+- spec/fixtures/feeds/atom.xml
+- spec/fixtures/images/hubot.png
+- spec/fixtures/index.html
+- spec/fixtures/jekyll-last-modified-at/page.html
+- spec/fixtures/some-subfolder/htm.htm
+- spec/fixtures/some-subfolder/test_index.html
+- spec/fixtures/some-subfolder/this-is-a-subfile.html
+- spec/fixtures/some-subfolder/this-is-a-subpage.html
+- spec/fixtures/some-subfolder/xhtml.xhtml
+- spec/jekyll-app-engine_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/jamesramsay/jekyll-app-engine
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Generator for Google App Engine Handlers.
+test_files:
+- spec/fixtures/_app.yaml
+- spec/fixtures/_config.yml
+- spec/fixtures/_layouts/some_default.html
+- spec/fixtures/_my_collection/custom_permalink.md
+- spec/fixtures/_my_collection/custom_permalink_2.md
+- spec/fixtures/_my_collection/test.html
+- spec/fixtures/_my_collection/this-has-non-standard-chars.md
+- spec/fixtures/_other_things/test2.html
+- spec/fixtures/_posts/2013-12-12-dec-the-second.md
+- spec/fixtures/_posts/2014-03-02-march-the-second.md
+- spec/fixtures/_posts/2014-03-04-march-the-fourth.md
+- spec/fixtures/_posts/2015-01-18-jekyll-last-modified-at.md
+- spec/fixtures/feeds/atom.xml
+- spec/fixtures/images/hubot.png
+- spec/fixtures/index.html
+- spec/fixtures/jekyll-last-modified-at/page.html
+- spec/fixtures/some-subfolder/htm.htm
+- spec/fixtures/some-subfolder/test_index.html
+- spec/fixtures/some-subfolder/this-is-a-subfile.html
+- spec/fixtures/some-subfolder/this-is-a-subpage.html
+- spec/fixtures/some-subfolder/xhtml.xhtml
+- spec/jekyll-app-engine_spec.rb
+- spec/spec_helper.rb