redis-dump 0.3.1 → 0.3.2

data/CHANGES.txt

@@ -1,10 +1,14 @@
 REDIS-DUMP, CHANGES
 
+#### 0.3.2 (2012-01-05) ###############################
+
+* ADDED: Support setting redis URI via REDIS_URI environment variable
+
 #### 0.3.1 (2012-01-05) ###############################
 
 * ADDED: New global option for redis-dump: -f
 
-#### 0.3.0 (2012-01-05) ###############################
+#### 0.3.0 (2012-01-04) ###############################
 
 * ADDED: Redis::Dump.dump_strings
 * ADDED: New global options for redis-dump: -c, -O

data/README.rdoc

@@ -13,8 +13,15 @@ There are two executables: <tt>redis-dump</tt> and <tt>redis-load</tt>.
     $ redis-dump -u 127.0.0.1:6371 > db_full.json
     $ redis-dump -u 127.0.0.1:6371 -d 15 > db_db15.json
     
-    $ < db_full.json redis-load 
+    $ < db_full.json redis-load
     $ < db_db15.json redis-load -d 15
+    # OR
+    $ cat db_full | redis-load
+    $ cat db_db15.json | redis-load -d 15
+    
+    # You can specify the redis URI via an environment variable
+    $ export REDIS_URI=127.0.0.1:6371
+    $ redis-dump
     
 == Output format
 
@@ -39,6 +46,23 @@ Here are examples of each datatype:
 One of the purposes of redis-dump is the ability to restore the database to a known state. When you restore a redis database from a redis-dump file, <em>the expires are reset to their values at the time the dump was created</em>. This is different from restoring from Redis' native .rdb or .aof files (expires are stored relative to the actual time they were set). 
 
 
+== Output directly to an encrypted file
+
+For most sensitive data, you should consider encrypting the data directly without writing first to a temp file. You can do this using the power of [gpg](http://www.gnupg.org/) and file descriptors. Here are a couple examples:
+  
+    # Encrypt the data (interactive)
+    $ redis-dump -u 127.0.0.1:6371 -d 15 | gpg --force-mdc -v -c > path/2/backup-db15.json.gpg
+    
+    # Encrypt the data (automated)
+    $ redis-dump -u 127.0.0.1:6371 -d 15 | 3</path/2/passphrase.txt gpg --force-mdc -v -c --passphrase-fd 3 > path/2/backup-db15.json.gpg
+    
+    # Decrypt the file (interactive)
+    $ gpg path/2/backup-db15.json.gpg
+    Enter passphrase: *******
+    
+    # Decrypt the file (automated)
+    $  3</path/2/passphrase.txt gpg --passphrase-fd 3 path/2/backup-db15.json.gpg
+    
 == Installation
 
     $ gem install redis-dump

data/VERSION.yml

@@ -1,5 +1,4 @@
 --- 
 :MAJOR: 0
 :MINOR: 3
-:PATCH: 1
-:BUILD: '000'
+:PATCH: 2

data/bin/redis-dump

@@ -32,7 +32,7 @@ class Redis::Dump::CLI
   global :f, :filter, String, "Filter selected keys (passed directly to redis' KEYS command)"
   global :O, :without_optimizations, "Disable run time optimizations"
   global :V, :version, "Display version" do 
-    puts "Version: #{Redis::Dump::VERSION.to_s}"
+    puts "redis-dump v#{Redis::Dump::VERSION.to_s}"
     exit 0
   end
   global :D, :debug do
@@ -43,13 +43,14 @@ class Redis::Dump::CLI
   end
   
   before do |obj|
+    obj.global.uri ||= ENV['REDIS_URI']
     obj.global.uri ||= 'redis://%s:%s' % [Redis::Dump.host, Redis::Dump.port]
     obj.global.uri = 'redis://' << obj.global.uri unless obj.global.uri.match(/^redis:\/\//)
     obj.global.database &&= obj.global.database.to_i
     obj.global.database ||= (0..15)
     Redis::Dump.with_optimizations = false if obj.global.without_optimizations
     Redis::Dump.chunk_size = obj.global.count if obj.global.count
-    Redis::Dump.ld " redis_uri: #{obj.global.uri} (#{obj.global.database})"
+    Redis::Dump.ld "redis_uri: #{obj.global.uri} (#{obj.global.database})"
     Redis::Dump.ld "Process: #{$$}; Memory: #{Redis::Dump.memory_usage}" if Redis::Dump.debug
   end
   

data/bin/redis-load

@@ -29,7 +29,7 @@ class Redis::Dump::CLI
   global :d, :database, Integer, "Redis database (e.g. -d 15)"
   global :s, :sleep, Integer, "Sleep for S seconds after dumping (for debugging)"
   global :V, :version, "Display version" do 
-    puts "Version: #{Redis::Dump::VERSION.to_s}"
+    puts "redis-dump v#{Redis::Dump::VERSION.to_s}"
     exit 0
   end
   global :D, :debug do
@@ -40,11 +40,12 @@ class Redis::Dump::CLI
   end
   
   before do |obj|
+    obj.global.uri ||= ENV['REDIS_URI']
     obj.global.uri ||= 'redis://%s:%s' % [Redis::Dump.host, Redis::Dump.port]
     obj.global.uri = 'redis://' << obj.global.uri unless obj.global.uri.match(/^redis:\/\//)
     obj.global.database &&= obj.global.database.to_i
     obj.global.database ||= (0..15)
-    Redis::Dump.ld " redis_uri: #{obj.global.uri} (#{obj.global.database})"
+    Redis::Dump.ld "redis_uri: #{obj.global.uri} (#{obj.global.database})"
     Redis::Dump.ld "Process: #{$$}; Memory: #{Redis::Dump.memory_usage}" if Redis::Dump.debug
   end
   

data/bin/redis-report

@@ -33,7 +33,7 @@ class Redis::Dump::CLI
     @verbose += 1
   end
   global :V, :version, "Display version" do 
-    puts "Version: #{Redis::Dump::VERSION.to_s}"
+    puts "redis-dump v#{Redis::Dump::VERSION.to_s}"
     exit 0
   end
   global :D, :debug do
@@ -44,11 +44,12 @@ class Redis::Dump::CLI
   end
   
   before do |obj|
+    obj.global.uri ||= ENV['REDIS_URI']
     obj.global.uri ||= 'redis://%s:%s' % [Redis::Dump.host, Redis::Dump.port]
     obj.global.uri = 'redis://' << obj.global.uri unless obj.global.uri.match(/^redis:\/\//)
     obj.global.database &&= obj.global.database.to_i
     obj.global.database ||= (0..15)
-    Redis::Dump.ld " redis_uri: #{obj.global.uri} (#{obj.global.database})"
+    Redis::Dump.ld "redis_uri: #{obj.global.uri} (#{obj.global.database})"
     Redis::Dump.ld "Process: #{$$}; Memory: #{Redis::Dump.memory_usage}" if Redis::Dump.debug
   end
   

data/lib/redis/dump.rb

@@ -244,7 +244,7 @@ class Redis
         @info[:OWNER]
       end
       def self.to_s
-        [@info[:MAJOR], @info[:MINOR], @info[:PATCH], @info[:BUILD]].join('.')
+        [@info[:MAJOR], @info[:MINOR], @info[:PATCH]].join('.')
       end
       def self.path
         File.join(RD_HOME, 'VERSION.yml')

data/redis-dump.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = "redis-dump"
-  s.version = "0.3.1"
+  s.version = "0.3.2"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Delano Mandelbaum"]

metadata

@@ -2,7 +2,7 @@
 name: redis-dump
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.3.1
+  version: 0.3.2
 platform: ruby
 authors: 
 - Delano Mandelbaum