schema_dev 1.4.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2cb7062449c508b64eba10f96d4654c25c01b1e7
-  data.tar.gz: bc5dbd89355222666cd98f462e7740348be9be82
+  metadata.gz: f1ea08cf350172c2ab73709dd71a577f961aae09
+  data.tar.gz: f96afa1f7bbe6224735327391fe49bb9e21cb9a1
 SHA512:
-  metadata.gz: 4f126d36df88514c8760faca2fb606797a7e039d6f04369ef381558ee0d14183f85c37598b12c252a14f274369e246e97087fe914fb9e39151c8147d46601bb3
-  data.tar.gz: 395d6081c0853eda0f040fcf16352918a11d5204e8e72e6cb55f0be053f873b4e4316a05f292d83ad9b8f7c1193036b895043d5dd408d0b0653ef97fba16cf3c
+  metadata.gz: 18f9f21f9becb8ec1a5f1fdea351f79b87625451ea173ccbf5abe6fca244675fcd0452872cb0025d83588dfa2526215f9053287cf8575b610f2eec6b6b944231
+  data.tar.gz: 714b246726fcbec24ffa397c39e980f604597302c721e86d17201f7f14d220a5f7e70ba293f3d373adcc25b8689cb6b997d156b5f0f73e3b03f3879100531ae8

data/README.md

@@ -8,15 +8,19 @@ Development tools for the SchemaPlus family of gems.
 
 Provides support for working with multiple ruby versions, rails adapaters, and db versions.  In particular provides a command `schema_dev` for running rspec (or whatever) on the matrix or  a slice or element of it.  It also auto-generates the `.travis.yml` file for [travis-ci](https://travis-ci.org) testing.
 
-## Installation
+## Creating a new gem for the SchemaPlus family
 
-Include this as a development dependency in the client gem's `<ame>.gemfile`:
+The `schema_dev` script has a generator for new gems:
 
-    s.add_development_dependency "schema_dev"
+	$ gem install schema_dev
+	$ schema_dev gem new_gem_name
+	
+Similar to `bundle gem`, this creates a skeleton structure for a new gem.  The structure includes appropriate dependencies on [schema_monkey](https://github.com/SchemaPlus/schema_monkey) and on `schema_dev` itself, and creates an initial `schema_dev.yml` file, etc.
+	
 
-## Setup
+## Usage
 
-#### `schema_dev.yml`
+### schema_dev.yml
 
 The client gem needs a file `schema_dev.yml` in it's root, which specifies the testing matrix among other things.
 
@@ -25,39 +29,7 @@ The client gem needs a file `schema_dev.yml` in it's root, which specifies the t
 * `db`:  A single db adapter, or a list of db adapters.
 * `quick`: (Optional) Hash listing the version of ruby, rails, and db to use with `--quick` option.  If not specified, the default is to use the last entry in each list.
 
-If you change this file, it's a good idea to run `schema_dev refresh` to update the auto-generated `gemfiles` and `.travis.yml` (see below).
-
-#### Gemfiles
-
-The client gem must contain a "gemfiles" directory containing the matrix of
-possible gemfiles; It will be generated/updated automatically by the `schema_dev` script whenever you run a matrix command.  You can also generate it explicitly by running
-
-        $ schema_dev gemfiles
-
-This directory should be checked in to the git repo.
-
-`schema_dev gemfiles` only generates gemfiles for the versions of rails &
-db listed in `schema_dev.yml`.  If you change the listed versions you'll
-need to re-generate.
-
-Note that generating the gemfiles blows away any previous files.  If you had made
-local changes for some reason, you'll need to rely on git to recover them.
-
-    
-#### Rspec
-
-The client gem should include this in its `spec/spec_helper`
-
-    require 'schema_dev/rspec'
-    SchemaDev::Rspec.setup_db
-    
-This will take care of connecting to the test database appropriately, and will set up logging to a file specific to the test matrix cell.
-
-#### Rake
-
-The client gem should include this in its `Rakefile`:
-
-    require 'schema_dev/tasks'
+If you change this file, it's a good idea to run `schema_dev freshen`
 
 ### Ruby selection
 
@@ -112,8 +84,49 @@ For more info, see
     $ schema_dev help
     $ schema_dev help rspec   # etc.
 
-## Generating `.travis.yml`
+## Auto-generated/updated files
+
+Whenever you run a `schema_dev` matrix command, it first freshens the various generated files; you can also run `schema_dev freshen` manually.
 
-To keep things in sync `.travis.yml` gets automatically updated whenever you run `schema_dev matrix` or any of its shorthands.  There's also a command to just explicitly update `.travis.yml`
+### gemfiles
 
-    $ schema_dev travis
+The client gem will contain a "gemfiles" subdirectory tree containing the matrix of
+possible gemfiles; this entire tree gets created/updated automatically, and should be checked into the git repo.
+
+Note that freshening the gemfiles happens automatically whenever you run a schema_dev matrix command, and blows away any previous files.  So you should not attempt to change any files in `gemfiles/*`  
+
+If you need to include extra specifications in the Gemfile (e.g. to specify a path for a gem), you can create a file `Gemfile.local` in the project root, and its contents will be included in the Gemfile.
+
+### .travis.yml
+
+The `.travis.yml` file gets created automatically.  Don't edit it by hand.
+
+### README.md
+
+`schema_dev` generates markdown describing the text matrix, and inserts it into the README.md, in a block guarded by markdown comments
+
+    [//]: # SCHEMA_DEV: MATRIX  
+    .
+    .
+    .
+    [//]: # SCHEMA_DEV: MATRIX
+
+
+## Behind-the-scenes
+
+#### Rspec
+
+The client gem's`spec/spec_helper` includes this
+
+    require 'schema_dev/rspec'
+    SchemaDev::Rspec.setup
+    
+This will take care of starting up `schema_monkey`, connecting to the test database appropriately, and and setting up logging to a file specific to the test matrix cell.
+
+#### Rake
+
+The client gem's `Rakefile` includes:
+
+    require 'schema_dev/tasks'
+    
+Which defines the rake task `create_databases` and also a task for travis-ci

data/bin/schema_dev

@@ -3,6 +3,7 @@
 require 'active_support/core_ext/hash'
 require 'thor'
 require_relative '../lib/schema_dev/config'
+require_relative '../lib/schema_dev/gem'
 require_relative '../lib/schema_dev/runner'
 require_relative '../lib/schema_dev/version'
 
@@ -23,19 +24,11 @@ class CLI < Thor
     method_option :db, type: :string, desc: "Only execute for the specified database"
   end
 
-  desc "travis", "create/update .travis.yml based on schema_dev.yml values"
-  def travis
-    runner.travis
-  end
-
-  desc "gemfiles", "create/update gemfiles/* hierarchy based on schema_dev.yml values"
-  def gemfiles
-    runner.gemfiles
-  end
+  default_task :rspec
 
-  desc "refresh", "shorthand for runnin both '#{$cmd} travis' and '#{$cmd} gemfiles'"
-  def refresh
-      runner.refresh
+  desc "freshen", "update files that depend on schema_dev.yml: .travis, gemfiles/, README.md"
+  def freshen
+      runner.freshen
   end
 
   desc "matrix", "run a command over the matrix"
@@ -62,11 +55,15 @@ class CLI < Thor
     runner.run('bundle', 'exec', 'rspec', args, **options.to_h.symbolize_keys)
   end
 
-end
+  desc "gem", "create a new SchemaPlus gem"
+  def gem(name)
+      SchemaDev::Gem.build(name)
+  end
 
-if ARGV[0] == "--version"
-    puts "SchemaDev #{SchemaDev::VERSION}"
-    exit
 end
 
-CLI.start(ARGV)
+case
+when ARGV.empty? then CLI.start(["--help"])
+when ARGV[0] == "--version" then puts "SchemaDev #{SchemaDev::VERSION}"
+else CLI.start(ARGV)
+end

data/lib/schema_dev/config.rb

@@ -16,8 +16,12 @@ module SchemaDev
 
     def self._reset ; @@config = nil end  # for use by rspec
 
+    def self.read
+      new((YAML.load Pathname.new(CONFIG_FILE).read).symbolize_keys)
+    end
+
     def self.load
-      @@config ||= new((YAML.load Pathname.new(CONFIG_FILE).read).symbolize_keys)
+      @@config ||= read
     end
 
     def initialize(opts={}) # once we no longer support ruby 1.9.3, can switch to native keyword args

data/lib/schema_dev/gem.rb

@@ -0,0 +1,122 @@
+require 'faraday'
+require 'fileutils'
+require 'pathname'
+require 'active_support/core_ext/string'
+
+require_relative 'templates'
+
+module SchemaDev
+  class Gem
+    def self.build(name)
+      new(name).build
+    end
+
+    attr_accessor :gem_name, :gem_module, :gem_root, :fullname, :email
+
+    def initialize(name)
+      self.gem_name = name.underscore
+      self.gem_module = gem_name.camelize
+      self.gem_root = Pathname.new(gem_name)
+    end
+
+    def build
+      ensure_not_in_git
+      ensure_doesnt_exist
+      get_fullname_and_email
+      copy_template
+      self.gem_root = self.gem_root.realpath
+      rename_files
+      substitute_keys
+      freshen
+      git_init
+      puts <<-END.strip_heredoc
+
+         Created #{gem_name}.  Your recommended next steps are:
+
+                $ cd #{gem_name}
+                $ bundle install
+                $ schema_dev bundle install
+                $ schema_dev rspec
+      END
+    end
+
+    def die(msg)
+      abort "schema_dev: #{msg}"
+    end
+
+    def ensure_not_in_git
+      if system("git rev-parse >& /dev/null")
+        die "Cannot create new gem inside existing git worktree; please cd elsewhere"
+      end
+    end
+
+    def ensure_doesnt_exist
+      if gem_root.exist?
+        die "Cannot create new gem: '#{gem_root}' already exists"
+      end
+    end
+
+    def get_fullname_and_email
+      {'fullname' => 'name', 'email' => 'email' }.each do |myattr, gitattr|
+        if (self.send myattr+"=", `git config user.#{gitattr}`.strip).blank?
+          die "Who are you?  Please run 'git config --global user.#{gitattr} <your-#{gitattr}>'"
+        end
+      end
+    end
+
+    def copy_template
+      FileUtils.cp_r Templates.root + "gem", gem_root
+    end
+
+    def rename_files
+      Dir.glob(gem_root + "**/*GEM_NAME*").each do |path|
+        FileUtils.mv path, path.gsub(/GEM_NAME/, gem_name)
+      end
+    end
+
+    def substitute_keys
+      gem_root.find.each do |path|
+        next unless path.file?
+        path.write subs(path.read)
+      end
+    end
+
+    def subs(s)
+      s = s.gsub('%GEM_NAME%', gem_name)
+      s = s.gsub('%GEM_MODULE%', gem_module)
+      s = s.gsub('%FULLNAME%', fullname)
+      s = s.gsub('%EMAIL%', email)
+      s = s.gsub('%SCHEMA_MONKEY_DEPENDENCY%', dependency(schema_monkey_version))
+      s = s.gsub('%SCHEMA_DEV_DEPENDENCY%', dependency(SchemaDev::VERSION))
+      s = s.gsub('%YEAR%', Time.now.strftime("%Y"))
+    end
+
+    def dependency(v)
+      major, minor, patch = v.split('.')
+      dep = %Q{"~> #{major}.#{minor}"}
+      dep += %Q{, ">= #{v}"} if patch != "0"
+      dep
+    end
+
+    def schema_monkey_version
+      @monkey_version ||= begin
+                            gems = JSON.parse Faraday.get('https://rubygems.org/api/v1/versions/schema_monkey.json').body
+                            gems.reject(&it["prerelease"]).sort_by{|g| Time.new(g["built_at"])}.last["number"]
+                          end
+    end
+
+    def freshen
+      Dir.chdir gem_root do 
+        Runner.new(Config.read).freshen(quiet:true)
+      end
+    end
+
+    def git_init
+      Dir.chdir gem_name do 
+        system "git init"
+        system "git add #{gem_root.find.select(&:exist?).join(' ')}"
+        system "git commit -m 'Initial skeleton generated by `schema_dev gem #{gem_name}`'"
+      end
+    end
+  end
+end

data/lib/schema_dev/gemfiles.rb

@@ -1,15 +1,15 @@
 require 'pathname'
 
+require_relative 'templates'
+
 module SchemaDev
 
   module Gemfiles
     extend self
 
-    TEMPLATES_ROOT = Pathname.new(__FILE__).dirname.parent.parent + "templates"
-
     def build(config)
       Dir.mktmpdir do |tmpdir|
-        @src_root = TEMPLATES_ROOT
+        @src_root = Templates.root
         @dst_root = Pathname.new(tmpdir).realpath
 
         relpath = Pathname.new("gemfiles")

data/lib/schema_dev/readme.rb

@@ -0,0 +1,46 @@
+require 'pathname'
+
+module SchemaDev
+  class Readme
+    def self.update(config)
+      new(config.matrix).update
+    end
+
+    attr_accessor :matrix, :readme
+
+    def initialize(matrix)
+      self.matrix = matrix
+      self.readme = Pathname.new('README.md')
+    end
+
+    def update
+      return false unless readme.exist?
+      lines = readme.readlines
+      newlines = sub_matrix(lines)
+      if lines != newlines
+        readme.write newlines.join
+        return true
+      end
+    end
+
+    def sub_matrix(lines)
+      pattern = %r{^\[//\]: # SCHEMA_DEV: MATRIX}
+      before = lines.take_while(&it !~ pattern)
+
+      return lines if before == lines
+
+      after = lines.reverse.take_while(&it !~ pattern).reverse
+
+      contents = []
+      contents << "[//]: # SCHEMA_DEV: MATRIX - begin\n"
+      contents << "[//]: # These lines are auto-generated by schema_dev based on schema_dev.yml\n"
+      self.matrix.group_by(&it.slice(:ruby, :rails)).each do |pair, items|
+        contents << "* ruby **#{pair[:ruby]}** with rails **#{pair[:rails]}**, using #{items.map{|item| "**#{item[:db]}**"}.to_sentence(last_word_connector: ' or ')}\n"
+      end
+      contents << "\n"
+      contents << "[//]: # SCHEMA_DEV: MATRIX - end\n"
+
+      before + contents + after
+    end
+  end
+end

data/lib/schema_dev/rspec.rb

@@ -3,10 +3,16 @@ require_relative 'rspec/db'
 module SchemaDev
   module Rspec
 
-    def self.setup_db
+    def self.setup
+      SchemaMonkey.insert
       Db.setup
     end
 
+    def self.setup_db
+      ActiveSupport::Deprecation.warn "SchemaDev::Rspec.setup_db is deprecated.  Use SchemaDev::Rspec.setup"
+      self.setup
+    end
+
     def self.db_configuration
       Db.configuration
     end

data/lib/schema_dev/runner.rb

@@ -3,6 +3,7 @@ require 'shellwords'
 require_relative 'matrix_executor'
 require_relative 'travis'
 require_relative 'gemfiles'
+require_relative 'readme'
 
 module SchemaDev
   class Runner
@@ -10,21 +11,32 @@ module SchemaDev
       @config = config
     end
 
-    def travis
-      Travis.update(@config) and puts "* Updated #{Travis::TRAVIS_FILE}"
+    def travis(quiet: false)
+      if Travis.update(@config)
+        puts "* Updated #{Travis::TRAVIS_FILE}" unless quiet
+      end
     end
 
-    def gemfiles
-      Gemfiles.build(@config) and puts "* Updated gemfiles"
+    def gemfiles(quiet: false)
+      if Gemfiles.build(@config)
+        puts "* Updated gemfiles" unless quiet
+      end
     end
 
-    def refresh
-      self.travis
-      self.gemfiles
+    def readme(quiet: false)
+      if Readme.update(@config)
+        puts "* Updated README" unless quiet
+      end
+    end
+
+    def freshen(quiet: false)
+      self.travis(quiet: quiet)
+      self.gemfiles(quiet: quiet)
+      self.readme(quiet: quiet)
     end
 
     def run(*args, dry_run: false, quick: false, ruby: nil, rails: nil, db: nil, freshen: true)
-      self.refresh if freshen
+      self.freshen if freshen
 
       matrix = MatrixExecutor.new @config.matrix(quick: quick, ruby: ruby, rails: rails, db: db)
 

data/lib/schema_dev/templates.rb

@@ -0,0 +1,9 @@
+require 'pathname'
+
+module SchemaDev
+  module Templates
+    def self.root
+      @root ||= Pathname.new(__FILE__).dirname.parent.parent + "templates"
+    end
+  end
+end

data/lib/schema_dev/version.rb

@@ -1,3 +1,3 @@
 module SchemaDev
-  VERSION = "1.4.0"
+  VERSION = "2.0.0"
 end

data/lib/schema_dev.rb

@@ -1,5 +1 @@
 require "schema_dev/version"
-
-module SchemaDev
-  # Your code goes here...
-end

data/schema_dev.gemspec

@@ -20,6 +20,7 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency "activesupport"
   spec.add_dependency "coveralls"
+  spec.add_dependency "faraday"
   spec.add_dependency "fastandand"
   spec.add_dependency "hash_keyword_args"
   spec.add_dependency "its-it"
@@ -30,4 +31,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "rspec", "~> 3.0"
   spec.add_development_dependency "simplecov"
+  spec.add_development_dependency "webmock"
 end

data/spec/gem_spec.rb

@@ -0,0 +1,52 @@
+require 'schema_dev/gem'
+
+describe SchemaDev::Gem do
+  before(:each) do
+    stub_request(:get, 'https://rubygems.org/api/v1/versions/schema_monkey.json').to_return body: JSON.generate([{ built_at: Time.now, number: "0.1.2"}])
+  end
+
+  around(:each) do |example|
+    silence_stream(STDOUT) do
+      example.run
+    end
+  end
+
+  it "creates gemspec" do
+    in_tmpdir do
+      expect{SchemaDev::Gem.build("NewGem")}.not_to raise_error
+      gemspec = File.read "new_gem/new_gem.gemspec"
+      expect(gemspec).to include %q{"schema_monkey", "~> 0.1", ">= 0.1.2"}
+    end
+  end
+
+  context "complains" do
+
+    around(:each) do |example|
+      silence_stream(STDERR) do
+        example.run
+      end
+    end
+
+    it "when no git user.name" do
+      in_tmpdir do
+        expect_any_instance_of(SchemaDev::Gem).to receive(:`).with("git config user.name").and_return ""
+        expect{SchemaDev::Gem.build("NewGem")}.to raise_error SystemExit, /who are you/i
+      end
+    end
+
+    it "when in git worktree" do
+      in_tmpdir do
+        system('git init')
+        expect{SchemaDev::Gem.build("NewGem")}.to raise_error SystemExit, /\bgit\b/
+      end
+    end
+
+    it "when gem directory exists" do
+      in_tmpdir do
+        FileUtils.touch "new_gem"
+        expect{SchemaDev::Gem.build("NewGem")}.to raise_error SystemExit, /exists/
+      end
+    end
+  end
+
+end

data/spec/gemfiles_spec.rb

@@ -19,7 +19,7 @@ describe SchemaDev::Gemfiles do
   end
 
   def relevant_diff(config, dir)
-    src = SchemaDev::Gemfiles::TEMPLATES_ROOT + dir
+    src = SchemaDev::Templates.root + dir
     diff = `diff -rq #{src} #{dir} 2>&1`.split("\n")
 
     # expect copy not to have entry for rails not in config

data/spec/spec_helper.rb

@@ -2,6 +2,7 @@ require 'simplecov'
 SimpleCov.start
 
 require 'tmpdir'
+require 'webmock/rspec'
 
 require 'schema_dev/config'
 

data/templates/gem/.gitignore

@@ -0,0 +1,8 @@
+/coverage
+/tmp
+/pkg
+
+*.lock
+*.log
+*.sqlite3
+!gemfiles/**/*.sqlite3

data/templates/gem/GEM_NAME.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require '%GEM_NAME%/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "%GEM_NAME%"
+  spec.version       = %GEM_MODULE%::VERSION
+  spec.authors       = ["%FULLNAME%"]
+  spec.email         = ["%EMAIL%"]
+  spec.summary       = %q{TODO: Write a short summary. Required.}
+  spec.description   = %q{TODO: Write a longer description. Optional.}
+  spec.homepage      = "https://github.com/SchemaPlus/%GEM_NAME%"
+  spec.license       = "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_dependency "activerecord", "~> 4.2"
+  spec.add_dependency "schema_monkey", %SCHEMA_MONKEY_DEPENDENCY%
+
+  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0.0"
+  spec.add_development_dependency "schema_dev", %SCHEMA_DEV_DEPENDENCY%
+  spec.add_development_dependency "simplecov"
+  spec.add_development_dependency "simplecov-gem-profile"
+end

data/templates/gem/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/templates/gem/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) %YEAR% %FULLNAME% 
+
+MIT License
+
+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/templates/gem/README.md

@@ -0,0 +1,62 @@
+[![Gem Version](https://badge.fury.io/rb/%GEM_NAME%.svg)](http://badge.fury.io/rb/%GEM_NAME%)
+[![Build Status](https://secure.travis-ci.org/SchemaPlus/%GEM_NAME%.svg)](http://travis-ci.org/SchemaPlus/%GEM_NAME%)
+[![Coverage Status](https://img.shields.io/coveralls/SchemaPlus/%GEM_NAME%.svg)](https://coveralls.io/r/SchemaPlus/%GEM_NAME%)
+[![Dependency Status](https://gemnasium.com/lomba/%GEM_NAME%.svg)](https://gemnasium.com/SchemaPlus/%GEM_NAME%)
+
+# %GEM_NAME%
+
+TODO: Write a gem description
+
+%GEM_NAME% is part of the [SchemaPlus](https://github.com/SchemaPlus/) family of Ruby on Rails extension gems.
+
+## Installation
+
+In your application's Gemfile
+
+```ruby
+gem "%GEM_NAME%"
+```
+## Compatibility
+
+%GEM_NAME% is tested on
+
+[//]: # SCHEMA_DEV: MATRIX
+
+## Usage
+
+TODO: Write usage instructions here
+
+
+## History
+
+*   See [CHANGELOG](CHANGELOG.md) for per-version release notes.
+
+## Development & Testing
+
+Are you interested in contributing to %GEM_NAME%?  Thanks!  Please follow
+the standard protocol: fork, feature branch, develop, push, and issue pull request.
+
+Some things to know about to help you develop and test:
+
+* **schema_dev**:  %GEM_NAME% uses [schema_dev](https://github.com/SchemaPlus/schema_dev) to
+  facilitate running rspec tests on the matrix of ruby, rails, and database
+  versions that the gem supports, both locally and on
+  [travis-ci](http://travis-ci.org/SchemaPlus/%GEM_NAME%)
+
+  To to run rspec locally on the full matrix, do:
+
+        $ schema_dev bundle install
+        $ schema_dev rspec
+
+  You can also run on just one configuration at a time;  For info, see `schema_dev --help` or the
+  [schema_dev](https://github.com/SchemaPlus/schema_dev) README.
+
+  The matrix of configurations is specified in `schema_dev.yml` in
+  the project root.
+
+* **schema_monkey**: %GEM_NAME% extends ActiveRecord using
+  [schema_monkey](https://github.com/SchemaPlus/schema_monkey)'s extension
+  API and protocols -- see its README for details.  If your contribution needs any additional monkey patching
+  that isn't already supported by
+  [schema_monkey](https://github.com/SchemaPlus/schema_monkey), please head
+  over there and submit a PR.

data/templates/gem/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'schema_dev/tasks'
+
+task :default => :spec
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)

data/templates/gem/lib/GEM_NAME/version.rb

@@ -0,0 +1,3 @@
+module %GEM_MODULE%
+  VERSION = "0.1.0"
+end

data/templates/gem/lib/GEM_NAME.rb

@@ -0,0 +1,39 @@
+require 'schema_monkey'
+
+# Load any mixins to ActiveRecord modules, such as:
+#
+#   require_relative '%GEM_NAME%/active_record/base'
+#   require_relative '%GEM_NAME%/active_record/connection_adapters/abstract_adapter'
+#
+# Any modules named %GEM_MODULE%::ActiveRecord::<remainder-of-submodule-path>
+# will be automatically #include'd in their counterparts in ::ActiveRecord
+
+
+# Load any middleware, such as:
+#
+#   require_relative '%GEM_NAME%/middleware/model'
+#
+# Any modules named %GEM_MODULE%::Middleware::<submodule-path> will
+# automatically have their .insert method called.
+
+# Database adapter-specific mixin, if any, will automatically #include'd in
+# its counterpart depending on which database adapter is in use.
+module %GEM_MODULE%
+  module ActiveRecord
+    module ConnectionAdapters
+      # autoload :MysqlAdapter, 'schema_plus_tables/active_record/connection_adapters/mysql_adapter'
+      # autoload :PostgresqlAdapter, 'schema_plus_tables/active_record/connection_adapters/postgresql_adapter'
+      # autoload :Sqlite3Adapter, 'schema_plus_tables/active_record/connection_adapters/sqlite3_adapter'
+    end
+  end
+end
+
+
+
+# Extra load-time initialization can go here.  You can delete this if you don't have any.
+module %GEM_MODULE%
+  def self.insert
+  end
+end
+
+SchemaMonkey.register(%GEM_MODULE%)

data/templates/gem/schema_dev.yml

@@ -0,0 +1,9 @@
+ruby:
+    - 1.9.3
+    - 2.1.5
+rails:
+    - 4.2
+db:
+    - mysql2
+    - sqlite3
+    - postgresql

data/templates/gem/spec/sanity_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+
+# A basic sanity check to have as a spec when first starting.  Feel free to delete this
+# once you've got real content.
+
+describe "Sanity Check" do
+
+  it "database is connected" do
+    expect(ActiveRecord::Base).to be_connected
+  end
+
+end

data/templates/gem/spec/spec_helper.rb

@@ -0,0 +1,22 @@
+require 'simplecov'
+require 'simplecov-gem-profile'
+SimpleCov.start "gem"
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'rspec'
+require 'active_record'
+require '%GEM_NAME%'
+require 'schema_dev/rspec'
+
+SchemaDev::Rspec.setup
+
+Dir[File.dirname(__FILE__) + "/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  config.warnings = true
+end
+
+SimpleCov.command_name "[ruby #{RUBY_VERSION} - ActiveRecord #{::ActiveRecord::VERSION::STRING} - #{ActiveRecord::Base.connection.adapter_name}]"
+

data/templates/gemfiles/Gemfile.base

@@ -4,3 +4,5 @@ gemspec :path => File.expand_path('..', __FILE__)
 platform :ruby do
     gem "byebug" if RUBY_VERSION > "2"
 end
+
+File.exist?(gemfile_local = File.expand_path('../Gemfile.local', __FILE__)) and eval File.read(gemfile_local), binding, gemfile_local

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: schema_dev
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 2.0.0
 platform: ruby
 authors:
 - ronen barzel
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-01-14 00:00:00.000000000 Z
+date: 2015-01-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -38,6 +38,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: fastandand
   requirement: !ruby/object:Gem::Requirement
@@ -164,6 +178,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  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: SchemaPlus development tools
 email:
 - ronen@barzel.org
@@ -183,9 +211,11 @@ files:
 - lib/schema_dev.rb
 - lib/schema_dev/config.rb
 - lib/schema_dev/executor.rb
+- lib/schema_dev/gem.rb
 - lib/schema_dev/gemfile_selector.rb
 - lib/schema_dev/gemfiles.rb
 - lib/schema_dev/matrix_executor.rb
+- lib/schema_dev/readme.rb
 - lib/schema_dev/rspec.rb
 - lib/schema_dev/rspec/db.rb
 - lib/schema_dev/ruby_selector.rb
@@ -193,15 +223,28 @@ files:
 - lib/schema_dev/tasks.rb
 - lib/schema_dev/tasks/coveralls.rb
 - lib/schema_dev/tasks/dbms.rb
+- lib/schema_dev/templates.rb
 - lib/schema_dev/travis.rb
 - lib/schema_dev/version.rb
 - schema_dev.gemspec
 - spec/config_spec.rb
+- spec/gem_spec.rb
 - spec/gemfile_sepector_spec.rb
 - spec/gemfiles_spec.rb
 - spec/runner_spec.rb
 - spec/spec_helper.rb
 - spec/travis_spec.rb
+- templates/gem/.gitignore
+- templates/gem/GEM_NAME.gemspec
+- templates/gem/Gemfile
+- templates/gem/LICENSE.txt
+- templates/gem/README.md
+- templates/gem/Rakefile
+- templates/gem/lib/GEM_NAME.rb
+- templates/gem/lib/GEM_NAME/version.rb
+- templates/gem/schema_dev.yml
+- templates/gem/spec/sanity_spec.rb
+- templates/gem/spec/spec_helper.rb
 - templates/gemfiles/Gemfile.base
 - templates/gemfiles/rails-3.2/Gemfile.base
 - templates/gemfiles/rails-3.2/Gemfile.mysql
@@ -250,6 +293,7 @@ specification_version: 4
 summary: SchemaPlus development tools
 test_files:
 - spec/config_spec.rb
+- spec/gem_spec.rb
 - spec/gemfile_sepector_spec.rb
 - spec/gemfiles_spec.rb
 - spec/runner_spec.rb