dumpcar 0.1.0.2 → 0.1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 10d345ae8e6b891eb9706770254feecac90a4440ddb94a38afe43863a381e6db
-  data.tar.gz: 1785b183972b7b3441647b3fc272a09168ee023f49de87b8befdd2c671807def
+  metadata.gz: ed119cf17a409f818d9dd8f069a5e7220311915609c84a89e1e4cee24708ec1b
+  data.tar.gz: f3537224213f96e745edfcdccbc56e3906f0b32fdb349ce725425a41f9d78887
 SHA512:
-  metadata.gz: e377f5ca42759745881c2942961bd0d2963f5c1ab0fa34b137598416143f989f286b1e3a8abd221a79bd3340e197ae969cd52fec85b07db4a36cf6794ddd42fd
-  data.tar.gz: '08a48d141f71ab6a4b01b964a6456a6a58d34a3c16966beb32aaf48dd50ad1cafb8caed661e2393b6ddd2608f62dbe40dee02c037dddc7eddb5695a9aaa4ed40'
+  metadata.gz: 14c5f0ba07c1618d401a9b3f8d5b7345b7c70b1c484bdbe0179f75e7c8f7995e5316470a4e6b0986f7b4ff02701f012df80d9c60b8b9a31f1519144efb309908
+  data.tar.gz: 5bfad0956996b9fd3f9937728b179f9144af7ba65cbe8f33ee60156dfdb7820852675ef12d8286a3faad5f0d01eaa22d4314886c8dc4774e66d85f6c99ef39c8

data/README.md

@@ -1,30 +1,45 @@
-# Rails::Db::Dump
+# Dumpcar
 
-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/dumpcar`. To experiment with that code, run `bin/console` for an interactive prompt.
+Rake tasks for dumping and restoring the contents of the PostgreSQL database for your Rails application.
 
-## Installation
+* Dump (`rails dumpcar:dump`) and restore your last dump (`rails dumpcar:restore`) with a single command
+* Uses your Rails database credentials for your environment
 
-TODO: Replace `Dumpcar` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
+## Installation
 
-Install the gem and add to the application's Gemfile by executing:
+Install the gem executing:
 
 ```bash
 bundle add Dumpcar
+rails g dumpcar # creates db/dumps folder, adds it to .gitignore and commits
 ```
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+## Usage
 
 ```bash
-gem install Dumpcar
+rails dumpcar:dump # creates a postgresql dump based on current time like db/dumps/20250601022124.dump
+rails dumpcar:restore # restores the last dump made chronologically from the db/dumps directory
 ```
 
-## Usage
+## Compatibility
 
-TODO: Write usage instructions here
+Outside of the `rails dumpcar:dump` and `rails dumpcar:restore` commands, don't expect any compatibility guarantees for now.
+
+## Longer term feature goals
+
+* Support other Rails database (MySQL and SQLite)
+* Support other Rails environments than the current one
+* Ability to clean your db/dumps directory of all dumps before a given time
+* Add support for naming a dump (you can manually do this now but not via the rake task)
+* Restoring a specific dump via filepath
+* Restoring a specific dump by timestamp
+* Restoring a specific dump by name
+* Restoring a specific dump made before or after a given time
+* Extension points for other ways to get a database (Easily get a dump from Heroku's Postgres backups, for example)
 
 ## Development
 
-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.
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You should run `bin/appraisal rspec` to run all of the tests on all of the supported Rails versions. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
 ## Contributing
 
@@ -36,4 +51,9 @@ The gem is available as open source under the terms of the [LGPL-3.0-or-later li
 
 ## Code of Conduct
 
-Everyone interacting in the Rails::Db::Dump project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/wwahammy/dumpcar/blob/main/CODE_OF_CONDUCT.md).
+Everyone interacting in the Dumpcar project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/wwahammy/dumpcar/blob/main/CODE_OF_CONDUCT.md).
+
+## Releasing
+
+1. Update the version in the `lib/dumpcar/version.rb`
+2. Run the Push Gem workflow

data/gemfiles/rails_6.0.gemfile

@@ -5,6 +5,7 @@ source "https://rubygems.org"
 gem "irb"
 gem "rake", "~> 13.0"
 gem "rspec", "~> 3.0"
+gem "rspec-github", require: false
 gem "shoulda-matchers"
 gem "standard", "~> 1.3"
 gem "combustion"

data/gemfiles/rails_6.1.gemfile

@@ -5,6 +5,7 @@ source "https://rubygems.org"
 gem "irb"
 gem "rake", "~> 13.0"
 gem "rspec", "~> 3.0"
+gem "rspec-github", require: false
 gem "shoulda-matchers"
 gem "standard", "~> 1.3"
 gem "combustion"

data/gemfiles/rails_7.0.gemfile

@@ -5,6 +5,7 @@ source "https://rubygems.org"
 gem "irb"
 gem "rake", "~> 13.0"
 gem "rspec", "~> 3.0"
+gem "rspec-github", require: false
 gem "shoulda-matchers"
 gem "standard", "~> 1.3"
 gem "combustion"

data/gemfiles/rails_7.1.gemfile

@@ -5,6 +5,7 @@ source "https://rubygems.org"
 gem "irb"
 gem "rake", "~> 13.0"
 gem "rspec", "~> 3.0"
+gem "rspec-github", require: false
 gem "shoulda-matchers"
 gem "standard", "~> 1.3"
 gem "combustion"

data/gemfiles/rails_7.2.gemfile

@@ -5,6 +5,7 @@ source "https://rubygems.org"
 gem "irb"
 gem "rake", "~> 13.0"
 gem "rspec", "~> 3.0"
+gem "rspec-github", require: false
 gem "shoulda-matchers"
 gem "standard", "~> 1.3"
 gem "combustion"

data/gemfiles/rails_8.0.gemfile

@@ -5,6 +5,7 @@ source "https://rubygems.org"
 gem "irb"
 gem "rake", "~> 13.0"
 gem "rspec", "~> 3.0"
+gem "rspec-github", require: false
 gem "shoulda-matchers"
 gem "standard", "~> 1.3"
 gem "combustion"

data/gemfiles/rails_edge.gemfile

@@ -5,6 +5,7 @@ source "https://rubygems.org"
 gem "irb"
 gem "rake", "~> 13.0"
 gem "rspec", "~> 3.0"
+gem "rspec-github", require: false
 gem "shoulda-matchers"
 gem "standard", "~> 1.3"
 gem "combustion"

data/lib/dumpcar/location.rb

@@ -11,7 +11,7 @@ module Dumpcar
 
     def dumps
       prepare_base!
-      Dir.glob(base.join(TIMESTAMP_FILE_GLOB))
+      base.glob(TIMESTAMP_FILE_GLOB)
     end
 
     def first
@@ -19,6 +19,10 @@ module Dumpcar
       dumps.first
     end
 
+    def search(query)
+      dumps.first { |file| file.basename.starts_with(query) }
+    end
+
     def last
       prepare_base!
       dumps.last

data/lib/dumpcar/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Dumpcar
-  VERSION = "0.1.0.2"
+  VERSION = "0.1.0.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dumpcar
 version: !ruby/object:Gem::Version
-  version: 0.1.0.2
+  version: 0.1.0.4
 platform: ruby
 authors:
 - Eric Schultz
@@ -84,5 +84,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.7
 specification_version: 4
-summary: We're getting there
+summary: Rake tasks for dumping and restoring Rails PostgreSQL database contents
 test_files: []