ardb 0.28.1 → 0.29.2

checksums.yaml

@@ -1,7 +1,7 @@
---- 
-SHA512: 
-  metadata.gz: 3a33083aa8a07a009733067aef0a4ccf2d54f59a9a8ef0bb928e54239930fbfa8ff9a5338fdfc1a872104dd3d1d96dbf628802467b5c1ff60f4c6230b87b0e47
-  data.tar.gz: 63c06b03761b7e1e38fed261aa4168db133019130a5dc8170b908605a7b3594292bb05dd099b5ad779cea0d645703ef20379b5a1babff7a83b4ba3ee4a8ccfb5
-SHA1: 
-  metadata.gz: c1b302324ad7f7951179fd764b611ac576aabae6
-  data.tar.gz: 51d0ce79158fb332dcf788e4d1c7625c19389800
+---
+SHA256:
+  metadata.gz: 49a5b06420fd7d8b670267fd508d46efe7d600838a5808c33d25e166739e453d
+  data.tar.gz: cee5d9470ee881423fb3783b5607a9be982b45a34637f936a39590912241ce79
+SHA512:
+  metadata.gz: 1f3581d3e82f86af6b6dfcb79adab4560c577c907ac3c908febdf1b1216b7bfd473715053b87790083e4db7b44e7a0a6e0c35b0e512cdb652e75fec8c846d1e0
+  data.tar.gz: a63b4a6eef47151c9e22edff4177b25dce35e4a9be4914ad2a49cba22a7d785e8ac42d19e7eb0e51615d549c0f52d6a290a46e8847fd3701789261d1b10b7252

data/.l.yml

@@ -0,0 +1,8 @@
+# https://github.com/redding/l.rb
+
+linters:
+  - name: "Rubocop"
+    cmd: "bundle exec rubocop"
+    extensions:
+      - ".rb"
+    cli_abbrev: "u"

data/.rubocop.yml

@@ -0,0 +1,3 @@
+inherit_gem:
+  much-style-guide:
+    - "lib/much-style-guide/rubocop.yml"

data/.t.yml

@@ -0,0 +1,6 @@
+# https://github.com/redding/t.rb
+
+default_cmd: bundle exec assert
+test_dir: test
+test_file_suffixes:
+  - "_tests.rb"

data/Gemfile

@@ -1,13 +1,26 @@
+# frozen_string_literal: true
+
 source "https://rubygems.org"
 
-gemspec
+ruby "~> 2.5"
 
-gem 'pg',  "~> 0.17.1"
-gem 'pry', "~> 0.9.0"
+gemspec
 
-# Lock down gem versions because they require a newer version of ruby
-gem 'i18n', "< 0.7"
+# Uncomment one of these and run:
+#
+#     bundle update activerecord activesupport
+#
+# to test a specific version.
+#
+# Rails 6.1
+gem "activerecord",  "~> 6.1"
+gem "activesupport", "~> 6.1"
+# Rails 6.0
+# gem "activerecord",  "~> 6.0.3"
+# gem "activesupport", "~> 6.0.3"
+# Rails 5.2
+# gem "activerecord",  "~> 5.2.4"
+# gem "activesupport", "~> 5.2.4"
 
-platform :ruby_18 do
-  gem 'json', '~> 1.8'
-end
+gem "pg", "~> 1.1.4"
+gem "pry"

data/README.md

@@ -1,16 +1,265 @@
 # Ardb
 
-Activerecord database tools.
+Tools for using ActiveRecord with or without Rails.
 
 ## Usage
 
-TODO: Write code samples and usage instructions here
+Given configured database connection parameters, Ardb provides a CLI and assorted tools for working with an ActiveRecord database. Ardb is designed to be used with or without Rails.
+
+### Configuration
+
+By default, Ardb looks for database configuration in the `config/db.rb` file. You can override this using the `ENV["ARDB_DB_FILE"]` env var.
+
+The configuration includes typical database configuration parameters:
+
+```ruby
+# in config/db.rb
+require "ardb"
+
+Ardb.configure do |c|
+  c.logger Logger.new($stdout)
+  c.root_path File.expand_path("../..", __FILE__)
+
+  c.db.adapter      "postgresql"
+  c.db.encoding     "unicode"
+  c.db.min_messages "WARNING"
+  c.db.url          "localhost:5432"
+  c.db.username     "testuser"
+  c.db.password     "secret"
+  c.db.database     "testdb"
+end
+```
+
+#### Rails configuration
+
+If using Ardb with Rails, add a `config/db.rb` file to have Ardb use Rails's configuration settings:
+
+```ruby
+# in config/db.rb
+require_relative "./environment"
+require "ardb"
+
+# This Ardb configuration matches Rails's settings.
+Ardb.configure do |c|
+  rails_db_config    = Rails.application.config_for("database")
+  c.root_path        = Rails.root
+  c.logger           = Rails.logger
+  c.schema_format    = Rails.application.config.active_record.schema_format || :ruby
+  c.default_timezone = :utc
+  c.adapter          = rails_db_config["adapter"]
+  c.host             = rails_db_config["host"]
+  c.port             = rails_db_config["port"]
+  c.username         = rails_db_config["username"]
+  c.password         = rails_db_config["password"]
+  c.database         = rails_db_config["database"]
+  c.encoding         = rails_db_config["encoding"]
+  c.min_messages     = rails_db_config["min_messages"]
+
+  c.migrations_path = "db/migrate"
+  c.schema_path = "db/schema"
+end
+```
+
+### CLI
+
+```
+$ ardb --help
+Usage: ardb [COMMAND] [options]
+
+Options:
+        --version
+        --help
+
+Commands:
+  connect            Connect to the configured DB
+  create             Create the configured DB
+  drop               Drop the configured DB
+  generate-migration Generate a MIGRATION-NAME migration file
+  migrate            Migrate the configured DB
+  migrate-up         Migrate the configured DB up
+  migrate-down       Migrate the configured DB down
+  migrate-forward    Migrate the configured DB forward
+  migrate-backward   Migrate the configured DB backward
+```
+
+#### `connect` command
+
+```
+$ ardb connect --help
+Usage: ardb connect [options]
+
+Options:
+        --version
+        --help
+
+Description:
+  Connect to the configured DB
+$ ardb connect
+error: database "some_database" does not exist
+$ ardb create
+created postgresql db "some_database"
+$ ardb connect
+connected to postgresql db "some_database"
+```
+
+Use this command to verify the connection parameter configuration is correct.
+
+#### `create` command
+
+```
+$ ardb create --help
+Usage: ardb create [options]
+
+Options:
+        --version
+        --help
+
+Description:
+  Create the configured DB
+$ ardb create
+created postgresql db "some_database"
+$ ardb create
+error: database "some_database" already exists
+```
+
+#### `drop` command
+
+```
+$ ardb drop --help
+Usage: ardb drop [options]
+
+Options:
+        --version
+        --help
+
+Description:
+  Drop the configured DB
+$ ardb drop
+dropped postgresql db "some_database"
+$ ardb drop
+error: database "some_database" does not exist
+```
+
+#### `generate-migration` command
+
+```
+$ ardb generate-migration add_projects --help
+Usage: ardb generate-migration MIGRATION-NAME [options]
+
+Options:
+        --version
+        --help
+
+Description:
+  Generate a MIGRATION-NAME migration file
+$ ardb generate-migration add_projects
+generated /path/to/app/db/migrate/20191222074043_add_projects.rb
+```
+
+#### `migrate` command
+
+```
+$ ardb migrate --help
+Usage: ardb migrate [options]
+
+Options:
+        --version
+        --help
+
+Description:
+  Migrate the configured DB
+$ ardb migrate
+== 20191222074043 AddProjects: migrating ======================================
+-- create_table(:projects)
+   -> 0.0276s
+== 20191222074043 AddProjects: migrated (0.0277s) =============================
+```
+
+#### `migrate-up` command
+
+```
+$ ardb migrate-up --help
+Usage: ardb migrate-up [options]
+
+Options:
+    -t, --target-version VALUE       version to migrate to
+        --version
+        --help
+
+Description:
+  Migrate the configured DB up
+$ ardb migrate-up
+== 20191222074043 AddProjects: migrating ======================================
+-- create_table(:projects)
+   -> 0.0510s
+== 20191222074043 AddProjects: migrated (0.0511s) =============================
+```
+
+#### `migrate-down` command
+
+```
+$ ardb migrate-down --help
+Usage: ardb migrate-down [options]
+
+Options:
+    -t, --target-version VALUE       version to migrate to
+        --version
+        --help
+
+Description:
+  Migrate the configured DB down
+$ ardb migrate-down
+== 20191222074043 AddProjects: reverting ======================================
+-- drop_table(:projects)
+   -> 0.0092s
+== 20191222074043 AddProjects: reverted (0.0132s) =============================
+```
+
+#### `migrate-forward` command
+
+```
+$ ardb migrate-forward --help
+Usage: ardb migrate-forward [options]
+
+Options:
+    -s, --steps VALUE                number of migrations to migrate
+        --version
+        --help
+
+Description:
+  Migrate the configured DB forward
+$ ardb migrate-forward
+== 20191222074043 AddProjects: migrating ======================================
+-- create_table(:projects)
+   -> 0.0510s
+== 20191222074043 AddProjects: migrated (0.0511s) =============================
+```
+
+#### `migrate-backward` command
+
+```
+$ ardb migrate-backward --help
+Usage: ardb migrate-backward [options]
+
+Options:
+    -s, --steps VALUE                number of migrations to migrate
+        --version
+        --help
+
+Description:
+  Migrate the configured DB backward
+$ ardb migrate-backward
+== 20191222074043 AddProjects: reverting ======================================
+-- drop_table(:projects)
+   -> 0.0092s
+== 20191222074043 AddProjects: reverted (0.0132s) =============================
+```
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
-    gem 'ardb'
+    gem "ardb"
 
 And then execute:
 

data/ardb.gemspec

@@ -1,5 +1,7 @@
 # -*- encoding: utf-8 -*-
-lib = File.expand_path('../lib', __FILE__)
+# frozen_string_literal: true
+
+lib = File.expand_path("../lib", __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require "ardb/version"
 
@@ -8,21 +10,23 @@ Gem::Specification.new do |gem|
   gem.version     = Ardb::VERSION
   gem.authors     = ["Kelly Redding", "Collin Redding"]
   gem.email       = ["kelly@kellyredding.com", "collin.redding@me.com"]
-  gem.summary     = %q{Activerecord database tools.}
-  gem.description = %q{Activerecord database tools.}
+  gem.summary     = "Activerecord database tools."
+  gem.description = "Activerecord database tools."
   gem.homepage    = "http://github.com/redding/ardb"
-  gem.license     = 'MIT'
+  gem.license     = "MIT"
 
-  gem.files         = `git ls-files`.split($/)
+  gem.files = `git ls-files`.split($INPUT_RECORD_SEPARATOR)
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.require_paths = ["lib"]
 
-  gem.add_development_dependency("assert", ["~> 2.16.1"])
+  gem.required_ruby_version = "~> 2.5"
 
-  gem.add_dependency('activerecord',  ["~> 3.2"])
-  gem.add_dependency('activesupport', ["~> 3.2"])
-  gem.add_dependency('much-plugin',   ["~> 0.2.0"])
-  gem.add_dependency('scmd',          ["~> 3.0.2"])
+  gem.add_development_dependency("much-style-guide", ["~> 0.6.0"])
+  gem.add_development_dependency("assert",           ["~> 2.19.3"])
 
+  gem.add_dependency("activerecord",  ["> 5.0", "< 7.0"])
+  gem.add_dependency("activesupport", ["> 5.0", "< 7.0"])
+  gem.add_dependency("much-mixin",    ["~> 0.2.4"])
+  gem.add_dependency("scmd",          ["~> 3.0.4"])
 end

data/bin/ardb

@@ -1,7 +1,9 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
+
 #
 # Copyright (c) 2013-Present Kelly Redding and Collin Redding
 #
 
-require 'ardb/cli'
+require "ardb/cli"
 Ardb::CLI.run ARGV

data/lib/ardb.rb

@@ -1,89 +1,105 @@
-require 'active_record'
-require 'logger'
+# frozen_string_literal: true
 
-require 'ardb/version'
+require "active_record"
+require "logger"
 
-ENV['ARDB_DB_FILE'] ||= 'config/db'
+require "ardb/version"
 
-module Ardb
+ENV["ARDB_DB_FILE"] ||= "config/db"
 
+module Ardb
   def self.config
     @config ||= Config.new
   end
 
   def self.configure(&block)
-    self.config.tap(&block)
+    config.tap(&block)
+  end
+
+  def self.adapter
+    @adapter || raise(NotInitializedError.new(caller))
   end
 
-  def self.adapter; @adapter; end
+  def self.reset_adapter
+    @adapter = nil
+  end
 
   def self.init(establish_connection = true)
-    require 'ardb/require_autoloaded_active_record_files'
+    require "ardb/require_autoloaded_active_record_files"
     begin
       require_db_file
-    rescue InvalidDBFileError => exception
-      raise exception.tap{ |e| e.set_backtrace(caller) }
+    rescue InvalidDBFileError => ex
+      ex.set_backtrace(caller)
+      raise ex
     end
 
-    self.config.validate!
-    @adapter = Adapter.new(self.config)
+    config.validate!
+    @adapter = Adapter.new(config)
 
     # setup AR
-    ActiveRecord::Base.logger = self.config.logger
-    self.adapter.connect_db if establish_connection
+    ActiveRecord::Base.default_timezone = config.default_timezone
+    ActiveRecord::Base.logger = config.logger
+    adapter.connect_db if establish_connection
   end
 
   def self.escape_like_pattern(pattern, escape_char = nil)
-    self.adapter.escape_like_pattern(pattern, escape_char)
+    adapter.escape_like_pattern(pattern, escape_char)
+  rescue NotInitializedError => ex
+    ex.set_backtrace(caller)
+    raise ex
   end
 
-  private
-
   # try requiring the db file via the load path or as an absolute path, if
   # that fails it tries requiring relative to the current working directory
   def self.require_db_file
     begin
-      require ENV['ARDB_DB_FILE']
+      begin
+        require ENV["ARDB_DB_FILE"]
+      rescue LoadError
+        require File.expand_path(ENV["ARDB_DB_FILE"], ENV["PWD"])
+      end
     rescue LoadError
-      require File.expand_path(ENV['ARDB_DB_FILE'], ENV['PWD'])
+      raise(
+        InvalidDBFileError,
+        "can't require `#{ENV["ARDB_DB_FILE"]}`, check that the ARDB_DB_FILE "\
+        "env var is set to the file path of your db file",
+      )
     end
-  rescue LoadError
-    raise InvalidDBFileError, "can't require `#{ENV['ARDB_DB_FILE']}`, " \
-                              "check that the ARDB_DB_FILE env var is set to " \
-                              "the file path of your db file"
   end
 
   class Config
-
-    ACTIVERECORD_ATTRS = [
-      :adapter,
-      :database,
-      :encoding,
-      :host,
-      :port,
-      :username,
-      :password,
-      :pool,
-      :checkout_timeout,
-      :min_messages
-    ].freeze
-    DEFAULT_MIGRATIONS_PATH = 'db/migrations'.freeze
-    DEFAULT_SCHEMA_PATH     = 'db/schema'.freeze
-    RUBY_SCHEMA_FORMAT      = :ruby.freeze
-    SQL_SCHEMA_FORMAT       = :sql.freeze
+    ACTIVERECORD_ATTRS =
+      [
+        :adapter,
+        :database,
+        :encoding,
+        :host,
+        :port,
+        :username,
+        :password,
+        :pool,
+        :checkout_timeout,
+        :min_messages,
+      ].freeze
+
+    DEFAULT_MIGRATIONS_PATH = "db/migrations"
+    DEFAULT_SCHEMA_PATH     = "db/schema"
+    RUBY_SCHEMA_FORMAT      = :ruby
+    SQL_SCHEMA_FORMAT       = :sql
     VALID_SCHEMA_FORMATS    = [RUBY_SCHEMA_FORMAT, SQL_SCHEMA_FORMAT].freeze
 
-    attr_accessor *ACTIVERECORD_ATTRS
-    attr_accessor :logger, :root_path
+    attr_accessor(*ACTIVERECORD_ATTRS)
+    attr_accessor :default_timezone, :logger, :root_path
     attr_reader :schema_format
     attr_writer :migrations_path, :schema_path
 
     def initialize
-      @logger          = Logger.new(STDOUT)
-      @root_path       = ENV['PWD']
-      @migrations_path = DEFAULT_MIGRATIONS_PATH
-      @schema_path     = DEFAULT_SCHEMA_PATH
-      @schema_format   = RUBY_SCHEMA_FORMAT
+      @default_timezone = :utc
+      @logger           = Logger.new(STDOUT)
+      @root_path        = ENV["PWD"]
+      @migrations_path  = DEFAULT_MIGRATIONS_PATH
+      @schema_path      = DEFAULT_SCHEMA_PATH
+      @schema_format    = RUBY_SCHEMA_FORMAT
     end
 
     def migrations_path
@@ -95,88 +111,102 @@ module Ardb
     end
 
     def schema_format=(new_value)
-      @schema_format = begin
-        new_value.to_sym
-      rescue NoMethodError
-        raise ArgumentError, "schema format must be a `Symbol`", caller
-      end
+      @schema_format =
+        begin
+          new_value.to_sym
+        rescue NoMethodError
+          raise ArgumentError, "schema format must be a `Symbol`", caller
+        end
     end
 
     def activerecord_connect_hash
       ACTIVERECORD_ATTRS.inject({}) do |h, attr_name|
-        value = self.send(attr_name)
+        value = send(attr_name)
         !value.nil? ? h.merge!(attr_name.to_s => value) : h
       end
     end
 
     def validate!
-      if self.adapter.to_s.empty? || self.database.to_s.empty?
+      if adapter.to_s.empty? || database.to_s.empty?
         raise ConfigurationError, "an adapter and database must be provided"
-      elsif !VALID_SCHEMA_FORMATS.include?(self.schema_format)
+      end
+
+      unless VALID_SCHEMA_FORMATS.include?(schema_format)
         raise ConfigurationError, "schema format must be one of: " \
-                                  "#{VALID_SCHEMA_FORMATS.join(', ')}"
+                                  "#{VALID_SCHEMA_FORMATS.join(", ")}"
       end
+
       true
     end
 
     def ==(other)
-      if other.kind_of?(self.class)
-        self.activerecord_connect_hash == other.activerecord_connect_hash &&
-        self.logger                    == other.logger           &&
-        self.root_path                 == other.root_path        &&
-        self.schema_format             == other.schema_format    &&
-        self.migrations_path           == other.migrations_path  &&
-        self.schema_path               == other.schema_path
+      if other.is_a?(self.class)
+        activerecord_connect_hash == other.activerecord_connect_hash &&
+        default_timezone          == other.default_timezone          &&
+        logger                    == other.logger                    &&
+        root_path                 == other.root_path                 &&
+        schema_format             == other.schema_format             &&
+        migrations_path           == other.migrations_path           &&
+        schema_path               == other.schema_path
       else
         super
       end
     end
-
   end
 
   module Adapter
-
     VALID_ADAPTERS = [
-      'sqlite',
-      'sqlite3',
-      'postgresql',
-      'postgres',
-      'mysql',
-      'mysql2'
+      "sqlite",
+      "sqlite3",
+      "postgresql",
+      "postgres",
+      "mysql",
+      "mysql2",
     ].freeze
 
     def self.new(config)
-      if !VALID_ADAPTERS.include?(config.adapter)
+      unless VALID_ADAPTERS.include?(config.adapter)
         raise InvalidAdapterError, "invalid adapter: `#{config.adapter}`"
       end
-      self.send(config.adapter, config)
+      send(config.adapter, config)
     end
 
     def self.sqlite(config)
-      require 'ardb/adapter/sqlite'
+      require "ardb/adapter/sqlite"
       Adapter::Sqlite.new(config)
     end
 
-    def self.sqlite3(config); self.sqlite(config); end
+    def self.sqlite3(config)
+      sqlite(config)
+    end
 
     def self.postgresql(config)
-      require 'ardb/adapter/postgresql'
+      require "ardb/adapter/postgresql"
       Adapter::Postgresql.new(config)
     end
 
-    def self.postgres(config); self.postgresql(config); end
+    def self.postgres(config)
+      postgresql(config)
+    end
 
     def self.mysql(config)
-      require 'ardb/adapter/mysql'
+      require "ardb/adapter/mysql"
       Adapter::Mysql.new(config)
     end
 
-    def self.mysql2(config); self.mysql(config); end
-
+    def self.mysql2(config)
+      mysql(config)
+    end
   end
 
   InvalidDBFileError  = Class.new(ArgumentError)
   ConfigurationError  = Class.new(ArgumentError)
   InvalidAdapterError = Class.new(RuntimeError)
 
+  class NotInitializedError < RuntimeError
+    def initialize(backtrace)
+      super("ardb hasn't been initialized yet, run `Ardb.init`")
+      set_backtrace(backtrace)
+    end
+  end
 end