backhoe 0.10.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 779de972f23a178e054d789eb0f09c70b7200b87468a4c85d14b53de9eddcfb8
-  data.tar.gz: 9621e4f611daa56dc8d34abc4285b9e86dbc79d3391b0463b39cdb663b02eee2
+  metadata.gz: abfe37e5c43ef24a835955e044c32bef198a37d007372ec45a9ade0a6ea76b67
+  data.tar.gz: 451090a75bf1b09d2c22f6e8b4a952a2c7fa531e6b11f49e0f3ffcb3d32fbad9
 SHA512:
-  metadata.gz: f1ee8947074606e2d4e4eca671883cd0c3ceab65de25dfd2228eada96888c316cd756dac556c3dd0a5ee16442dee8163155cb14498917355de67201bc505a8f5
-  data.tar.gz: e050249511d82941b33713b915399f51264608f32a40ae9cbf7bd58dd592eafe45a9ee99e22ec6e9c80df372211ee57534b6dcf831ca6ab4c29a3d305e7968e3
+  metadata.gz: 8be5bb5fdc1dab88f907b60a36e168d6ee0b613ab135e2b2e4b7dad7fab89cbaae2df8dd0422879f7f3a0b3d4f7d9d6f8d1f17d5a5e1b1671d9c3c627b3fc045
+  data.tar.gz: d8b73ba874184015ff2fc59a79fb011b25b4b0ba7773938cb169fd3da5373e8701f36f62b5477f84dbd188c29a2daa29cc06a64d1f8fb2e575dcc6ffa35820d6

data/.github/workflows/ci.yml

@@ -5,8 +5,8 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        gemfile: [ activerecord_6.0, activerecord_6.1, activerecord_7.0, activerecord_7.1 ]
-        ruby: [ '3.0', 3.1, 3.2, 3.3 ]
+        gemfile: [ activerecord_7.2, activerecord_8.0, activerecord_8.1 ]
+        ruby: [ 3.3, 3.4, "4.0" ]
 
     runs-on: ubuntu-22.04
     env: # $BUNDLE_GEMFILE must be set at the job level, so it is set for all steps

data/Appraisals

@@ -1,16 +1,12 @@
-appraise "activerecord-6.0" do
-  gem "activerecord", "~>6.0.0"
+appraise "activerecord-7.2" do
+  gem "activerecord", "~>7.2.0"
 end
 
-appraise "activerecord-6.1" do
-  gem "activerecord", "~>6.1.0"
+appraise "activerecord-8.0" do
+  gem "activerecord", "~>8.0.0"
 end
 
-appraise "activerecord-7.0" do
-  gem "activerecord", "~>7.0.0"
-end
-
-appraise "activerecord-7.1" do
-  gem "activerecord", "~>7.1.0"
+appraise "activerecord-8.1" do
+  gem "activerecord", "~>8.1.0"
 end
 

data/CLAUDE.md

@@ -0,0 +1,36 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project
+
+Backhoe is a Ruby gem for dumping and loading ActiveRecord database contents to/from files. Supports MySQL, PostgreSQL, and SQLite adapters with gzip compression and remote HTTP PUT.
+
+## Commands
+
+```bash
+bundle exec rake          # Run full test suite (RSpec)
+bundle exec rspec         # Run all specs
+bundle exec rspec spec/backhoe/dump_spec.rb  # Run a single spec file
+bundle exec rspec spec/backhoe/dump_spec.rb:15  # Run a single example by line
+```
+
+Tests require running MySQL and PostgreSQL services. Test database config is in `spec/support/database.yml`.
+
+## Architecture
+
+The gem has two public methods: `Backhoe.dump(path, **options)` and `Backhoe.load(path, **options)`.
+
+Three core classes implement the functionality:
+
+- **Backhoe::Database** (`lib/backhoe/database.rb`) - Reads ActiveRecord connection config, detects the adapter type (`mysql?`, `postgresql?`, `sqlite?`), and builds CLI options for database tools.
+- **Backhoe::Dump** (`lib/backhoe/dump.rb`) - Runs `mysqldump`, `pg_dump`, or file copy depending on adapter. Handles gzip, table skipping, column sanitization (via temp tables), and HTTP PUT for remote storage. Uses `Rake::DSL#sh` for shell commands.
+- **Backhoe::Load** (`lib/backhoe/load.rb`) - Runs `mysql`, `psql`, or file copy to restore. Supports gzip decompression and optional drop/create database.
+
+Shell commands use `set -o pipefail` in bash to catch piping errors.
+
+## Testing
+
+The test suite uses Appraisals to test against ActiveRecord 7.0, 7.1, and 7.2. CI runs on GitHub Actions across Ruby 3.1–3.3 with that matrix.
+
+Test support files in `spec/support/` include a `Database` helper class for creating/destroying test databases and fixture SQL files for both MySQL and PostgreSQL.

data/README.md

@@ -1,5 +1,5 @@
 # Backhoe
-[![CI Status](https://github.com/botandrose/backhoe/workflows/CI/badge.svg?branch=master)](https://github.com/botandrose/backhoe/actions?query=workflow%3ACI+branch%3Amaster)
+[![CI Status](https://github.com/botandrose/backhoe/actions/workflows/ci.yml/badge.svg)](https://github.com/botandrose/backhoe/actions/workflows/ci.yml)
 
 Dump and load current ActiveRecord database to and from a file.
 

data/backhoe.gemspec

@@ -28,6 +28,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "appraisal"
   spec.add_development_dependency "mysql2"
   spec.add_development_dependency "pg"
+  spec.add_development_dependency "sqlite3"
   spec.add_development_dependency "byebug"
   spec.add_development_dependency "timecop"
   spec.add_development_dependency "webrick"

data/gemfiles/{activerecord_6.0.gemfile → activerecord_7.2.gemfile}

@@ -2,6 +2,6 @@
 
 source "https://rubygems.org"
 
-gem "activerecord", "~>6.0.0"
+gem "activerecord", "~>7.2.0"
 
 gemspec path: "../"

data/gemfiles/{activerecord_6.1.gemfile → activerecord_8.0.gemfile}

@@ -2,6 +2,6 @@
 
 source "https://rubygems.org"
 
-gem "activerecord", "~>6.1.0"
+gem "activerecord", "~>8.0.0"
 
 gemspec path: "../"

data/gemfiles/{activerecord_7.0.gemfile → activerecord_8.1.gemfile}

@@ -2,6 +2,6 @@
 
 source "https://rubygems.org"
 
-gem "activerecord", "~>7.0.0"
+gem "activerecord", "~>8.1.0"
 
 gemspec path: "../"

data/lib/backhoe/database.rb

@@ -38,6 +38,15 @@ module Backhoe
       %w[mysql2 trilogy].include?(config["adapter"])
     end
 
+    def sqlite?
+      config["adapter"] == "sqlite3"
+    end
+
+    def path
+      raise unless sqlite?
+      config["database"]
+    end
+
     private
 
     def load_config

data/lib/backhoe/dump.rb

@@ -29,14 +29,24 @@ module Backhoe
 
     def dump
       if database.mysql?
-        sh "#{mysqldump} --no-create-db --single-transaction --quick -e #{skip_table_options} #{database.to_mysql_options} #{database.name} | #{pipe} #{target}"
+        bash_sh "#{mysqldump} --no-create-db --single-transaction --quick -e #{skip_table_options} #{database.to_mysql_options} #{database.name} | #{pipe} #{target}"
       elsif database.postgresql?
-        sh "#{pg_dump} --column-inserts #{database.name} | #{pipe} #{target}"
+        bash_sh "#{pg_dump} --column-inserts #{database.name} | #{pipe} #{target}"
+      elsif database.sqlite?
+        bash_sh "cat #{database.path} | #{pipe} #{target}"
       else
         raise "don't know how to dump #{database.adapter}"
       end
     end
 
+    def bash_sh(command)
+      sh <<~EOS
+        /bin/bash -xeu <<'BASH'
+        set -o pipefail && #{command}
+        BASH
+      EOS
+    end
+
     private
 
     def target

data/lib/backhoe/load.rb

@@ -5,11 +5,12 @@ module Backhoe
     include Rake::DSL
 
     def call
-      case database.adapter
-      when "mysql2", "trilogy"
+      if database.mysql?
         sh mysql_command
-      when "postgresql"
+      elsif database.postgresql?
         sh psql_command
+      elsif database.sqlite?
+        sh sqlite_command
       else
         raise "don't know how to load #{database.adapter}"
       end
@@ -35,6 +36,10 @@ module Backhoe
       cmd
     end
 
+    def sqlite_command
+      "#{cat} #{path} > #{database.path}"
+    end
+
     def cat
       path =~ /\.gz$/ ? "zcat" : "cat"
     end

data/lib/backhoe/version.rb

@@ -1,3 +1,3 @@
 module Backhoe
-  VERSION = "0.10.0"
+  VERSION = "0.11.0"
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: backhoe
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.11.0
 platform: ruby
 authors:
 - Micah Geisel
-autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-08-15 00:00:00.000000000 Z
+date: 2026-02-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -94,6 +93,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  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: byebug
   requirement: !ruby/object:Gem::Requirement
@@ -147,6 +160,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - Appraisals
+- CLAUDE.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -155,10 +169,9 @@ files:
 - bin/console
 - bin/setup
 - gemfiles/.bundle/config
-- gemfiles/activerecord_6.0.gemfile
-- gemfiles/activerecord_6.1.gemfile
-- gemfiles/activerecord_7.0.gemfile
-- gemfiles/activerecord_7.1.gemfile
+- gemfiles/activerecord_7.2.gemfile
+- gemfiles/activerecord_8.0.gemfile
+- gemfiles/activerecord_8.1.gemfile
 - lib/backhoe.rb
 - lib/backhoe/database.rb
 - lib/backhoe/dump.rb
@@ -168,7 +181,6 @@ homepage: https://github.com/botandrose/backhoe
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -183,8 +195,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.1
-signing_key: 
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Dump and load current database to and from a file.
 test_files: []

data/gemfiles/activerecord_7.1.gemfile

@@ -1,7 +0,0 @@
-# This file was generated by Appraisal
-
-source "https://rubygems.org"
-
-gem "activerecord", "~>7.1.0"
-
-gemspec path: "../"