raamen 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 31023fc5e442be1d7d1f7346a40bb53355847fcb
-  data.tar.gz: f4fe204f88692a72324501ab003627b4c37b43af
+  metadata.gz: 52786c2ccabef8c2b68a15f3b9da71d13c2ade12
+  data.tar.gz: 76987cdb2b1e66b9b30a99385483401a771a5c1a
 SHA512:
-  metadata.gz: 3b37d65b71beafcab9e9ce8e25c8b10a0f1523c7ba2441c44d2a0354a105866ba20627ec5adf918c1a592dd04c3b62bbe8a40df8d3daa85e90747dc1c685356f
-  data.tar.gz: 03b2e0b4b29254475fd02eeceee34237296fc71cad2a6af1cbc0bfaa7252d7af1aabc68b624d7d3bae7577b87d59eebca337295d6d9ef536e9c6075823a1a5d7
+  metadata.gz: 3cc111150e47cbdbcfc5f5fee64cbc7ef75ad9c430c716dc9960c037828efb54958f37e9f0e5e1248fadb03bd6475c0b985dd9f295a0eb592e0a6529a31fc918
+  data.tar.gz: 83d634295027b157461b4488ff87ac39b0884bfb01095feb9a0badfb0cc342f80d688cd33f65f0f9e7f7536d0a85eec39024cc3b082cf5c6a973aae11e0d2646

data/Gemfile

@@ -2,3 +2,5 @@ source 'https://rubygems.org'
 
 # Specify your gem's dependencies in raamen.gemspec
 gemspec
+gem 'pry'
+gem 'sqlite3'

data/README.md

@@ -1,8 +1,14 @@
 # Raamen
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/raamen`. To experiment with that code, run `bin/console` for an interactive prompt.
+[Raamen](http://rubygems.org/gems/raamen) is a Rack and SQLite based MVC web framework. It contains modules to provide basic and necessary features of web app components as well as helpful Rack middleware, cookie manipulation, and CLI to make the development process faster and easier.
 
-TODO: Delete this and the text above, and describe your gem
+#### contents
+- SQLObject
+- ControllerBase
+- Routing
+- Cookies
+- Middleware
+- Command Line Interface
 
 ## Installation
 
@@ -22,13 +28,355 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+### SQLObject
 
-## Development
+```ruby
+class Cat < Raamen::SQLObject
+  belongs_to :owner,
+    class_name: 'Human',
+    foreign_key: :owner_id
+
+  self.finalize!
+end
+```
+
+### ControllerBase
+
+```ruby
+class CatsController < Raamen::ControllerBase
+  def index
+    @cats = Cat.all
+    render :index
+  end
+
+  def new
+    @cat = Cat.new
+    render :new
+  end
+
+  def create
+    cat = Cat.new(cat_params)
+    cat.save
+    redirect_to '/cats'
+  end
+
+  private
+
+  def cat_params
+    params['cat']
+  end
+end
+
+```
+
+### Routing
+
+```ruby
+router = Raamen::Router.new
+router.draw do
+  get Regexp.new("^/cats$"), CatsController, :index
+  get Regexp.new("^/cats/new$"), CatsController, :new
+  post Regexp.new("^/cats$"), CatsController, :create
+end
+```
+
+### Cookies
+
+```ruby
+class MyController < ControllerBase
+  def go
+    session["count"] ||= 0
+    session["count"] += 1
+    render :counting_show
+  end
+end
+
+```
+
+```ruby
+class DogsController < ControllerBase
+  def create
+    @dog = Dog.new(params["dog"])
+    if @dog.save
+      flash[:notice] = "Saved dog successfully"
+      redirect_to "/dogs"
+    else
+      flash.now[:errors] = @dog.errors
+      render :new
+    end
+  end
+end
+```
+
+### Middleware
+
+```ruby
+app = Rack::Builder.new do
+  use Raamen::ShowExceptions
+  use Raamen::Static
+  run app
+end.to_app
+
+```
+
+### Command Line Interface
+
+To start a new project:
+
+```
+$ raamen n/new cats
+```
+
+To generate a new component:
+
+```
+$ raamen g/generate controller CatsController
+```
+
+To start server:
+
+```
+$ raamen s/start
+```
+
+To start console:
+
+```
+$ raamen c/console
+```
+
+## Implementation
+
+#### SQLObject modules:
+
+```ruby
+module Associatable
+  def belongs_to(name, options = {})
+    self.assoc_options[name] = BelongsToOptions.new(name, options)
+
+    define_method(name) do
+      options = self.class.assoc_options[name]
+      key_val = self.send(options.foreign_key)
+      options.model_class.where(options.primary_key => key_val).first
+    end
+  end
+
+  def has_many(name, options = {})
+    self.assoc_options[name] = HasManyOptions.new(name, self.name, options)
+
+    define_method(name) do
+      options = self.class.assoc_options[name]
+      key_val = self.send(options.primary_key)
+      options.model_class.where(options.foreign_key => key_val)
+    end
+  end
+end
+```
+
+```ruby
+module Searchable
+  def where(params)
+    where_line = params.keys.map do |col|
+      "#{col}= ?"
+    end.join(" AND ")
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+    parse_all(DBConnection.execute(<<-SQL, *params.values))
+      SELECT
+        *
+      FROM
+        #{self.table_name}
+      where
+        #{where_line}
+    SQL
+  end
+end
+```
+
+#### Template rendering:
+
+```ruby
+def render_content(content, content_type)
+  raise "double render" if already_built_response?
+  self.res["Content-Type"] = content_type
+  self.res.write(content)
+  self.session.store_session(res)
+  self.flash.store_flash(res)
+  self.already_built_response = true
+end
+
+def render(template_name)
+  template_path = File.join(
+    Dir.pwd,
+    "app",
+    "views",
+    "#{self.class.name.underscore}",
+    "#{template_name}.html.erb"
+    )
+  template_content = File.read(template_path)
+  render_content(ERB.new(template_content).result(binding), "text/html")
+end
+```
+
+#### Redirecting:
+
+```ruby
+def redirect_to(url)
+  raise "double render" if already_built_response?
+  self.res["location"] = url
+  self.res.status = 302
+  self.session.store_session(res)
+  self.flash.store_flash(res)
+  self.already_built_response = true
+end
+```
+
+#### Cross-Site Request Forgery protection:
+
+```ruby
+def form_authenticity_token
+  self.res.set_cookie(
+    "authenticity_token",
+    {path: "/", value: self.authenticity_token}
+  )
+  self.authenticity_token
+end
+
+def self.protect_from_forgery
+  @@protect_from_forgery = true
+end
+
+private
+
+def generate_authenticity_token
+  SecureRandom.urlsafe_base64(16)
+end
+
+def check_authenticity_token
+  cookie = self.req.cookies["authenticity_token"]
+  unless cookie && cookie == params["authenticity_token"]
+    raise "Invalid authenticity token"
+  end
+end
+```
+
+#### Adding new routes:
+
+```ruby
+def add_route(pattern, method, controller_class, action_name)
+  self.routes.push(Route.new(pattern, method, controller_class, action_name))
+end
+
+def draw(&proc)
+  self.instance_eval(&proc)
+end
+
+[:get, :post, :put, :delete].each do |http_method|
+  define_method(http_method) do |pattern, controller_class, action_name|
+    add_route(pattern, http_method, controller_class, action_name)
+  end
+end
+```
+
+#### Flash cookies:
+
+```ruby
+class Flash
+  attr_reader :flash, :now
+
+  def initialize(req)
+    flash = req.cookies["_rails_lite_app_flash"]
+    @now = flash ? Now.new(JSON.parse(flash)) : Now.new({})
+    @flash = {}
+  end
+
+  def [](key)
+    self.now[key.to_sym] || self.flash[key.to_sym]
+  end
+
+  def []=(key, val)
+    self.flash[key.to_sym] = val
+  end
+
+  def store_flash(res)
+    res.set_cookie("_rails_lite_app_flash", {path: "/", value: self.flash.to_json})
+  end
+end
+```
+
+#### Sesssion Cookies:
+
+```ruby
+class Session
+  attr_reader :cookies
+
+  def initialize(req)
+    cookies = req.cookies["_rails_lite_app"]
+    cookies = Hash[JSON.parse(cookies).map{ |k,v| [k.to_sym, v] }] if cookies
+    @cookies = cookies || {}
+  end
+
+  def [](key)
+    self.cookies[key.to_sym]
+  end
+
+  def []=(key, val)
+    self.cookies[key.to_sym] = val
+  end
+
+  def store_session(res)
+    res.set_cookie("_rails_lite_app", {path: "/", value: self.cookies.to_json})
+  end
+end
+```
+
+#### Show exceptions middleware:
+
+```ruby
+class ShowExceptions
+  attr_reader :app
+
+  def initialize(app)
+    @app = app
+  end
+
+  def call(env)
+    begin
+      self.app.call(env)
+    rescue Exception => e
+      render_exception(e)
+    end
+  end
+end
+```
+
+#### Static assets middleware:
+
+```ruby
+class Static
+  attr_reader :app, :root, :file_server
+
+  def initialize(app)
+    @app = app
+    @root = :public
+    @file_server = FileServer.new(self.root)
+  end
+
+  def call(env)
+    req = Rack::Request.new(env)
+    path = req.path
+
+    if path.include?("/#{self.root}")
+      res = self.file_server.call(env)
+    else
+      res = self.app.call(env)
+    end
+
+    res
+  end
+end
+
+```
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
 
@@ -38,4 +386,3 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/[USERN
 ## License
 
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
-

data/bin/console

@@ -7,8 +7,5 @@ require "raamen"
 # with your gem easier. You can also use a different console, if you like.
 
 # (If you use this, don't forget to add pry to your Gemfile!)
-# require "pry"
-# Pry.start
-
-require "irb"
-IRB.start(__FILE__)
+require "pry"
+Pry.start

data/bin/raamen

@@ -0,0 +1,104 @@
+#!/usr/bin/env ruby
+require 'thor'
+require 'pry'
+require 'active_support'
+require 'active_support/core_ext'
+require_relative '../lib/raamen/file_contents/db_connection_content'
+require_relative '../lib/raamen/file_contents/app_content'
+require_relative '../lib/raamen/file_contents/gem_file_content'
+require_relative '../lib/raamen/file_contents/controller_content'
+require_relative '../lib/raamen/file_contents/model_content'
+
+class RaamenCLI < Thor
+
+  desc "new", "creates new project directory"
+  def new(app_name)
+    system "mkdir", "#{app_name}"
+    system "touch", "#{app_name}/Gemfile"
+    system "touch", "#{app_name}/.gitignore"
+    system "mkdir", "#{app_name}/public"
+    system "mkdir", "#{app_name}/app"
+    system "touch", "#{app_name}/app/#{app_name}.rb"
+    system "touch", "#{app_name}/app/db_connection.rb"
+    system "mkdir", "#{app_name}/db"
+    system "touch", "#{app_name}/db/#{app_name}.sql"
+    system "mkdir", "#{app_name}/app/models"
+    system "mkdir", "#{app_name}/app/controllers"
+    system "mkdir", "#{app_name}/app/views"
+    system "mkdir", "#{app_name}/app/assets"
+    system "mkdir", "#{app_name}/app/assets/images"
+    system "mkdir", "#{app_name}/app/assets/javascripts"
+    system "mkdir", "#{app_name}/app/assets/stylesheets"
+    File.open("#{app_name}/app/db_connection.rb", "w") do |file|
+      file_content = FileContent::db_connection_content(app_name)
+      file.write(file_content)
+    end
+    File.open("#{app_name}/app/#{app_name}.rb", "w") do |file|
+      file_content = FileContent::app_content
+      file.write(file_content)
+    end
+    File.open("#{app_name}/Gemfile", "w") do |file|
+      file_content = FileContent::gem_file_content
+      file.write(file_content)
+    end
+  end
+
+  desc "generate", "generates app components"
+  def generate(component, name)
+    file_name = name.underscore
+    case component
+    when "controller"
+      system "touch", "#{Dir.pwd}/app/controllers/#{file_name}.rb"
+      system "mkdir", "#{Dir.pwd}/app/views/#{file_name}"
+      File.open("#{Dir.pwd}/app/controllers/#{file_name}.rb", "w") do |file|
+        file_content = FileContent::controller_content(name)
+        file.write(file_content)
+      end
+    when "model"
+      system "touch", "#{Dir.pwd}/app/models/#{file_name}.rb"
+      File.open("#{Dir.pwd}/app/models/#{file_name}.rb", "w") do |file|
+        file_content = FileContent::model_content(name)
+        file.write(file_content)
+      end
+    else
+      puts "Use 'raamen generate component name' to generate app components."
+    end
+  end
+
+  desc "console", "opens app console"
+  def console
+    require_relative "#{Dir.pwd}/app/#{Dir.pwd.split('/').last}.rb"
+    Pry.start app, prompt: [proc{ ">> " }]
+  end
+
+  desc "start", "starts app server"
+  def start
+    require_relative "#{Dir.pwd}/app/#{Dir.pwd.split('/').last}.rb"
+    Rack::Server.start(
+     app: app,
+     Port: 3000
+    )
+  end
+
+  desc "n", "short for 'new'"
+  def n(app_name)
+    new(app_name)
+  end
+
+  desc "g", "short for 'generate'"
+  def g(component, name)
+    generate(component, name)
+  end
+
+  desc "c", "short for 'console'"
+  def c
+    console
+  end
+
+  desc "s", "short for 'start'"
+  def s
+    start
+  end
+end
+
+RaamenCLI.start

data/lib/raamen/controller_base.rb

@@ -1,6 +1,7 @@
 require 'active_support'
 require 'active_support/core_ext'
 require 'erb'
+require 'json'
 require_relative 'session'
 require_relative 'flash'
 
@@ -44,8 +45,8 @@ module Raamen
 
     def render(template_name)
       template_path = File.join(
-        File.dirname(__FILE__),
-        "..",
+        Dir.pwd,
+        "app",
         "views",
         "#{self.class.name.underscore}",
         "#{template_name}.html.erb"

data/lib/raamen/file_contents/app_content.rb

@@ -0,0 +1,27 @@
+class FileContent
+  def self.app_content
+"require 'raamen'
+require 'rack'
+
+def app()
+  router = Raamen::Router.new
+  router.draw do
+    # Add routes here, example:
+    # get Regexp.new(\"^/cats$\"), CatsController, :index
+  end
+
+  app = Proc.new do |env|
+    req = Rack::Request.new(env)
+    res = Rack::Response.new
+    router.run(req, res)
+    res.finish
+  end
+
+  app = Rack::Builder.new do
+    use Raamen::ShowExceptions
+    use Raamen::Static
+    run app
+  end.to_app
+end"
+  end
+end

data/lib/raamen/file_contents/controller_content.rb

@@ -0,0 +1,7 @@
+class FileContent
+  def self.controller_content(name)
+"class #{name} < Raamen::ControllerBase
+
+end"
+  end
+end

data/lib/raamen/file_contents/db_connection_content.rb

@@ -0,0 +1,62 @@
+class FileContent
+  def self.db_connection_content(app_name)
+"require 'sqlite3'
+
+PRINT_QUERIES = ENV['PRINT_QUERIES'] == 'true'
+# https://tomafro.net/2010/01/tip-relative-paths-with-file-expand-path
+ROOT_FOLDER = Dir.pwd
+SQL_FILE = File.join(ROOT_FOLDER, 'db', '#{app_name}.sql')
+DB_FILE = File.join(ROOT_FOLDER, 'db', '#{app_name}.db')
+
+class DBConnection
+  def self.open(db_file_name)
+    @db = SQLite3::Database.new(db_file_name)
+    @db.results_as_hash = true
+    @db.type_translation = true
+
+    @db
+  end
+
+  def self.reset
+    return DBConnection.open(DB_FILE) if File.exist?(DB_FILE)
+
+    commands = [\"cat '\#{SQL_FILE}' | sqlite3 '\#{DB_FILE}'\"]
+    commands.each { |command| `\#{command}` }
+    DBConnection.open(DB_FILE)
+  end
+
+  def self.instance
+    reset if @db.nil?
+
+    @db
+  end
+
+  def self.execute(*args)
+    print_query(*args)
+    instance.execute(*args)
+  end
+
+  def self.execute2(*args)
+    print_query(*args)
+    instance.execute2(*args)
+  end
+
+  def self.last_insert_row_id
+    instance.last_insert_row_id
+  end
+
+  private
+
+  def self.print_query(query, *interpolation_args)
+    return unless PRINT_QUERIES
+
+    puts '--------------------'
+    puts query
+    unless interpolation_args.empty?
+      puts \"interpolate: \#{interpolation_args.inspect}\"
+    end
+    puts '--------------------'
+  end
+end"
+  end
+end

data/lib/raamen/file_contents/gem_file_content.rb

@@ -0,0 +1,6 @@
+class FileContent
+  def self.gem_file_content
+"gem 'raamen'
+gem 'rack'"
+  end
+end

data/lib/raamen/file_contents/model_content.rb

@@ -0,0 +1,8 @@
+class FileContent
+  def self.model_content(name)
+"class #{name} < Raamen::SQLObject
+
+  self.finalize!
+end"
+  end
+end

data/lib/raamen/flash.rb

@@ -1,5 +1,3 @@
-require 'json'
-
 module Raamen
   class Flash
     attr_reader :flash, :now

data/lib/raamen/session.rb

@@ -1,5 +1,3 @@
-require 'json'
-
 module Raamen
   class Session
     attr_reader :cookies

data/lib/raamen/show_exceptions.rb

@@ -1,5 +1,3 @@
-require 'erb'
-
 module Raamen
   class ShowExceptions
     attr_reader :app

data/lib/raamen/sql_object.rb

@@ -1,4 +1,4 @@
-require_relative 'db_connection'
+require_relative "#{Dir.pwd}/app/db_connection" 
 require_relative 'sql_object_modules/searchable'
 require_relative 'sql_object_modules/associatable'
 require 'active_support/inflector'

data/lib/raamen/static.rb

@@ -37,8 +37,7 @@ module Raamen
       req = Rack::Request.new(env)
       res = Rack::Response.new
       file_path = File.join(
-        File.dirname(__FILE__),
-        "..",
+	      Dir.pwd,
         req.path
       )
 

data/lib/raamen/version.rb

@@ -1,3 +1,3 @@
 module Raamen
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

data/raamen.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |spec|
   spec.email         = ["yuangaonyc@gmail.com"]
 
   spec.summary       = "A rack based web framework"
-  spec.description   = ""
+  spec.description   = "Raamen is a Rack and SQLite based MVC web framework. It contains modules to provide basic and necessary features of web app components as well as helpful Rack middleware, cookie manipulation, and CLI to make the development process faster and easier."
   spec.homepage      = "https://github.com/yuangaonyc/raamen"
   spec.license       = "MIT"
 
@@ -26,8 +26,8 @@ Gem::Specification.new do |spec|
   spec.files         = `git ls-files -z`.split("\x0").reject do |f|
     f.match(%r{^(test|spec|features)/})
   end
-  spec.bindir        = "exe"
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+
+  spec.executables   = ["raamen"]
   spec.require_paths = ["lib"]
 
   spec.add_development_dependency "bundler", "~> 1.14"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: raamen
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Yuan Gao
 autorequire: 
-bindir: exe
+bindir: bin
 cert_chain: []
-date: 2017-06-05 00:00:00.000000000 Z
+date: 2017-06-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -52,10 +52,14 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
-description: ''
+description: Raamen is a Rack and SQLite based MVC web framework. It contains modules
+  to provide basic and necessary features of web app components as well as helpful
+  Rack middleware, cookie manipulation, and CLI to make the development process faster
+  and easier.
 email:
 - yuangaonyc@gmail.com
-executables: []
+executables:
+- raamen
 extensions: []
 extra_rdoc_files: []
 files:
@@ -68,12 +72,15 @@ files:
 - README.md
 - Rakefile
 - bin/console
+- bin/raamen
 - bin/setup
 - lib/raamen.rb
 - lib/raamen/controller_base.rb
-- lib/raamen/db/sqlite3.db
-- lib/raamen/db/sqlite3.sql
-- lib/raamen/db_connection.rb
+- lib/raamen/file_contents/app_content.rb
+- lib/raamen/file_contents/controller_content.rb
+- lib/raamen/file_contents/db_connection_content.rb
+- lib/raamen/file_contents/gem_file_content.rb
+- lib/raamen/file_contents/model_content.rb
 - lib/raamen/flash.rb
 - lib/raamen/router.rb
 - lib/raamen/session.rb

data/lib/raamen/db/sqlite3.sql

@@ -1,43 +0,0 @@
-CREATE TABLE cats (
-  id INTEGER PRIMARY KEY,
-  name VARCHAR(255) NOT NULL,
-  owner_id INTEGER,
-
-  FOREIGN KEY(owner_id) REFERENCES human(id)
-);
-
-CREATE TABLE humans (
-  id INTEGER PRIMARY KEY,
-  fname VARCHAR(255) NOT NULL,
-  lname VARCHAR(255) NOT NULL,
-  house_id INTEGER,
-
-  FOREIGN KEY(house_id) REFERENCES human(id)
-);
-
-CREATE TABLE houses (
-  id INTEGER PRIMARY KEY,
-  address VARCHAR(255) NOT NULL
-);
-
-INSERT INTO
-  houses (id, address)
-VALUES
-  (1, "26th and Guerrero"), (2, "Dolores and Market");
-
-INSERT INTO
-  humans (id, fname, lname, house_id)
-VALUES
-  (1, "Devon", "Watts", 1),
-  (2, "Matt", "Rubens", 1),
-  (3, "Ned", "Ruggeri", 2),
-  (4, "Catless", "Human", NULL);
-
-INSERT INTO
-  cats (id, name, owner_id)
-VALUES
-  (1, "Breakfast", 1),
-  (2, "Earl", 2),
-  (3, "Haskell", 3),
-  (4, "Markov", 3),
-  (5, "Stray Cat", NULL);

data/lib/raamen/db_connection.rb

@@ -1,62 +0,0 @@
-require 'sqlite3'
-
-module Raamen
-  PRINT_QUERIES = ENV['PRINT_QUERIES'] == 'true'
-  # https://tomafro.net/2010/01/tip-relative-paths-with-file-expand-path
-  ROOT_FOLDER = File.join(File.dirname(__FILE__), '..')
-  SQL_FILE = File.join(ROOT_FOLDER, 'db', 'sqlite3.sql')
-  DB_FILE = File.join(ROOT_FOLDER, 'db', 'sqlite3.db')
-
-  class DBConnection
-    def self.open(db_file_name)
-      @db = SQLite3::Database.new(db_file_name)
-      @db.results_as_hash = true
-      @db.type_translation = true
-
-      @db
-    end
-
-    def self.reset
-      commands = [
-        "rm '#{DB_FILE}'",
-        "cat '#{SQL_FILE}' | sqlite3 '#{DB_FILE}'"
-      ]
-
-      commands.each { |command| `#{command}` }
-      DBConnection.open(DB_FILE)
-    end
-
-    def self.instance
-      reset if @db.nil?
-
-      @db
-    end
-
-    def self.execute(*args)
-      print_query(*args)
-      instance.execute(*args)
-    end
-
-    def self.execute2(*args)
-      print_query(*args)
-      instance.execute2(*args)
-    end
-
-    def self.last_insert_row_id
-      instance.last_insert_row_id
-    end
-
-    private
-
-    def self.print_query(query, *interpolation_args)
-      return unless PRINT_QUERIES
-
-      puts '--------------------'
-      puts query
-      unless interpolation_args.empty?
-        puts "interpolate: #{interpolation_args.inspect}"
-      end
-      puts '--------------------'
-    end
-  end
-end