fm 0.0.2 → 0.0.3.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f65eb48c6ca670fb90fbdf816381ff87bf72952c
-  data.tar.gz: 6217ce69bb16183e8a6fb73abb17a00f0bf382ef
+  metadata.gz: c4b7a3d871b0e74198e25ed52f8201aeec1447d7
+  data.tar.gz: 91ed6d0a626b604827f91ec956ecf1af5257dc5a
 SHA512:
-  metadata.gz: 155faf79df27ffa1a79ee767622e5d600a8db246ff01e61c9004a93c9af8a0de7ee7b7f88547ba35b7f7f80876cd0b4f8df7d907e49e898fee844a62d0cd7b9e
-  data.tar.gz: d170cac39c565eca7097b51d1cc565a59622c819b3f10c2b49a46b2b5d7ceecce4351eef9b180072980d1cac6773ea925c3fb473055be3be4c79f8bfb52ae239
+  metadata.gz: b2f77a2ef3b9bc7e0c575392da9c7a48a5e20dbe386e5239e0f0c8cc95d7e64742101805e875ac7f4cf63cd059eec3097b2982b6d902d6307a73e7839640b6c7
+  data.tar.gz: 031bdf753e0b43b4a98f7f05179a9d16d43364f18bf58a39de1d70d7c80c13a22e780209284d1859b3a1851e1c8dccfc595d9be2bf50111df35e28d6ab428e9e

data/COPYING

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015 SpeedGo Computing
+Copyright (c) 2015-2017 SpeedGo Computing
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/bin/fm

@@ -1,5 +1,29 @@
 #!/usr/bin/env ruby
 
+
+# The MIT License (MIT)
+#
+# Copyright (c) 2015-2017 SpeedGo Computing
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+
 require 'fm'
 
 
@@ -10,7 +34,8 @@ fm #{FM::VERSION}
 usage: fm <command> [args]
 
 Available fm commands:
-    index       Update index of the storage.
+    index       Create or update the index on the folder.
+    find        Find files on the folder from the DB.
 EOS
 end
 
@@ -22,8 +47,28 @@ end
 
 cmd = ARGV.shift
 case cmd
+when "find"
+    FM.cmd_find(ARGV.clone)
 when "index"
     FM.cmd_index(ARGV.clone)
+when "update"
+when "init"
+when "config"
+when "storage"
+when "status"
+when "log"
+when "version"
+when "help"
+when "rm"
+when "trash"
+when "clean"
+when "recover"
+when "grep"
+when "locate"
+when "diff"
+when "search"
+when "tag"
+when "active"
 else
     $stderr << "fm: '#{cmd}' is not a fm command.\n"
     exit

data/fm.gemspec

@@ -4,23 +4,23 @@ require 'fm/version'
 
 
 Gem::Specification.new do |spec|
-    spec.name           = 'fm'
-    spec.version        = FM::VERSION
-    spec.summary        = %q{Managing files over multiple storage resources.}
-    spec.description    = %q{FM indexes folders, searches for duplicated files, replicates files for backup.}
+    spec.name          = 'fm'
+    spec.version       = FM::VERSION
+    spec.summary       = %q{Compute and record file checksum. Verify file content integrity using checksum. Identify duplicated files or backup locations.}
+    spec.description   = %q{Manage files scattered over multiple physical storages. Using file checksum, it's possible to verify content integrity of your backups, look up locations of the backups at various storages.}
 
-    spec.authors            = ['ShinYee']
-    spec.email              = ['shinyee@speedgocomputing.com']
-    spec.homepage           = 'http://github.com/xman/ruby-fm'
-    spec.licenses           = ['MIT']
-
-    spec.required_ruby_version      = '>= 2.0.0'
+    spec.authors       = ['ShinYee']
+    spec.email         = ['shinyee@speedgocomputing.com']
+    spec.homepage      = 'http://github.com/xman/ruby-fm'
+    spec.licenses      = ['MIT']
 
     spec.files         = `git ls-files`.split($/)
     spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
     spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
     spec.require_paths = ["lib"]
 
+    spec.required_ruby_version = '>= 2.0.0'
+
     spec.add_development_dependency "bundler", "~> 1.9"
     spec.add_development_dependency "rake", "~> 10.1"
 end

data/lib/fm/db.rb

@@ -0,0 +1,26 @@
+# The MIT License (MIT)
+#
+# Copyright (c) 2015-2017 SpeedGo Computing
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+
+module FM
+    DBFILE = ENV['HOME'] + '/.fm/fdata.db'
+end

data/lib/fm/file.rb

@@ -1,3 +1,26 @@
+# The MIT License (MIT)
+#
+# Copyright (c) 2015-2017 SpeedGo Computing
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+
 module FM
 
     class FMFile

data/lib/fm/find.rb

@@ -0,0 +1,133 @@
+# The MIT License (MIT)
+#
+# Copyright (c) 2015-2017 SpeedGo Computing
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+
+require 'digest/md5'
+require 'fileutils'
+require 'optparse'
+require 'yaml'
+
+require 'fm/db'
+require 'fm/file'
+require 'fm/match'
+
+
+module FM
+
+    def cmd_find(argv)
+
+        #### Parse options.
+
+        banner = "usage: fm find [options] <PATH>"
+        options = {
+            dbfile: DBFILE,
+        }
+        OptionParser.new do |opts|
+            opts.banner = banner
+
+            opts.on "-h", "--help", "Show this message." do
+                puts opts
+                exit
+            end
+        end.parse!(argv)
+
+        if argv.size != 1
+            $stderr << "#{banner}\n"
+            exit
+        end
+
+
+        #### Load DB file.
+
+        puts "Loading DB #{options[:dbfile]} ..."
+        t0 = Time.now
+        h = {}
+        if File.exists?(options[:dbfile])
+            obj = YAML::load(File.read(options[:dbfile]))
+            if obj.is_a?(Hash)
+                h = obj
+            end
+        end
+        t1 = Time.now
+        puts "Loaded DB in #{(t1-t0).round(2)}s."
+
+
+        ####
+
+        indexpath = argv[0]
+        indexabspath = File.realpath(indexpath)
+        earr = []   # List of files exists in DB.
+        nearr = []  # List of files not exists in DB.
+        nfailfiles = 0
+        t0 = Time.now
+
+
+        #### Find files in the path recursively.
+
+        # FIXME: Configurable file patterns to be excluded.
+        for fpath in Dir.glob("#{indexpath}/**/*", File::FNM_DOTMATCH).select { |e| e.force_encoding("binary"); File.ftype(e) == "file" && has_folder?(".git", e) == false && has_folder?(".hg", e) == false }
+            begin
+                fpath = File.realpath(fpath).force_encoding("binary")
+                ftype = File.ftype(fpath)
+                fsize = File.size(fpath)
+                fmtime = File.mtime(fpath)
+                # last index time.
+                # storage type: raw or compressed?
+                # content type: text or binary?
+                # hash type.
+                # hash value.
+                digest = Digest::MD5.hexdigest(File.read(fpath))
+                fmfile = FMFile.new(fsize, fpath, digest, fmtime)
+
+                if h[fsize] && h[fsize][digest]
+                    earr.push(fmfile)
+                else
+                    nearr.push(fmfile)
+                end
+
+            rescue StandardError => e
+                nfailfiles += 1
+                puts "[FAIL]: file=\"#{fpath}\" #{e.message}"
+            end
+        end
+
+
+        #### Report.
+
+        nearr.sort! { |a,b| a.path <=> b.path }
+
+        puts "Number of files found: #{earr.size}"
+
+        puts "Number of files not found: #{nearr.size}"
+        nearr.each do |f|
+            puts "    #{f.path}"
+        end
+
+        t1 = Time.now
+        puts "Find completed in #{(t1-t0).round(2)}s."
+
+    end
+
+
+    module_function :cmd_find
+
+end

data/lib/fm/index.rb

@@ -1,18 +1,40 @@
+# The MIT License (MIT)
+#
+# Copyright (c) 2015-2017 SpeedGo Computing
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+
 require 'digest/md5'
 require 'fileutils'
 require 'optparse'
 require 'yaml'
 
+require 'fm/db'
 require 'fm/file'
 require 'fm/match'
 
 
-DBFILE = ENV['HOME'] + '/.fm/fdata.db'
-
-
 module FM
 
     def cmd_index(argv)
+        #### Parse options.
 
         banner = "usage: fm index [options] <PATH>"
         options = {
@@ -33,33 +55,43 @@ module FM
         end
 
 
+        #### Load DB file.
+
         puts "Loading DB #{options[:dbfile]} ..."
         t0 = Time.now
         h = {}
-        needupdate = true
         if File.exists?(options[:dbfile])
             obj = YAML::load(File.read(options[:dbfile]))
             if obj.is_a?(Hash)
                 h = obj
-                needupdate = false
             end
         end
         t1 = Time.now
         puts "Loaded DB in #{(t1-t0).round(2)}s."
 
+
+        ####
+
         indexpath = argv[0]
+        indexabspath = File.realpath(indexpath)
         nnewfiles = 0
         nskipfiles = 0
         ndupfiles = 0
         nfailfiles = 0
+        nupdatefiles = 0
+        nremovefiles = 0
         duplist = {}
+        needupdate = false
         puts "Indexing #{indexpath} ..."
         t0 = Time.now
 
+
+        #### Remove non-existing files and update modified files in the index path from the DB.
+
         dlist = []
         h.each do |skey, svalue|
             h[skey].each do |dkey, dvalue|
-                h[skey][dkey].each do |f|
+                h[skey][dkey].select { |s| s.path.start_with?(indexabspath) }.each do |f|
                     fsize = -1
                     digest = ""
                     fe = File.exists?(f.path)
@@ -68,39 +100,46 @@ module FM
                         next
                     end
 
+                    dlist.push(f)
+
                     if fe
-                        fsize = File.size(f.path)
-                        digest = Digest::MD5.hexdigest(File.read(f.path))
-                    end
-                    if fsize != f.fsize || digest != f.digest
-                        dlist.push(f)
+                        nupdatefiles += 1
+                        puts "[UPD]: #{f.path} #{f.digest}"
+                    else
+                        nremovefiles += 1
+                        puts "[RMV]: #{f.path} #{f.digest}"
                     end
                 end
             end
         end
 
         dlist.each do |f|
-            fsize = f.fsize
-            path = f.path
-            digest = f.digest
-
-            h[fsize][digest].delete_if { |v| v.path == path }
-            if h[fsize][digest].size == 0
-                h[fsize].delete(digest)
-                if h[fsize].size == 0
-                    h.delete(fsize)
+            h[f.fsize][f.digest].delete_if { |v| v.path == f.path }
+            if h[f.fsize][f.digest].size == 0
+                h[f.fsize].delete(f.digest)
+                if h[f.fsize].size == 0
+                    h.delete(f.fsize)
                 end
             end
 
             needupdate = true
         end
-        dlist = nil
 
+
+        #### Index the path recursively.
+
+        # FIXME: Configurable file patterns to be excluded.
         for fpath in Dir.glob("#{indexpath}/**/*", File::FNM_DOTMATCH).select { |e| e.force_encoding("binary"); File.ftype(e) == "file" && has_folder?(".git", e) == false && has_folder?(".hg", e) == false }
             begin
                 fpath = File.realpath(fpath).force_encoding("binary")
+                ftype = File.ftype(fpath)
                 fsize = File.size(fpath)
                 fmtime = File.mtime(fpath)
+                # last index time.
+                # storage type: raw or compressed?
+                # content type: text or binary?
+                # hash type.
+                # hash value.
 
                 if fsize == 0
                     nskipfiles += 1
@@ -108,7 +147,7 @@ module FM
                     next
                 end
 
-                # Lazy index the file.
+                # Lazily index the file.
                 if h[fsize].nil?
                     digest = Digest::MD5.hexdigest(File.read(fpath))
                     h[fsize] = { digest => [ FMFile.new(fsize, fpath, digest, fmtime) ] }
@@ -116,12 +155,17 @@ module FM
                     nnewfiles += 1
                     puts "[NEW]: #{fpath} #{digest}"
                 else
-
+                    # Skip if the file had been indexed.
+                    is_indexed = false
                     h[fsize].values.each do |v|
                         if v.any? { |f| f.mtime == fmtime && f.path == fpath }
-                            next
+                            is_indexed = true
+                            break
                         end
                     end
+                    if is_indexed
+                        next
+                    end
 
                     digest = Digest::MD5.hexdigest(File.read(fpath))
                     if h[fsize][digest].nil?
@@ -130,6 +174,10 @@ module FM
                         nnewfiles += 1
                         puts "[NEW]: #{fpath} #{digest}"
                     elsif h[fsize][digest].size == 1 && h[fsize][digest].first.path == fpath
+                        h[fsize][digest] = [ FMFile.new(fsize, fpath, digest, fmtime) ]
+                        needupdate = true
+                        nupdatefiles += 1
+                        puts "[UPD]: #{fpath} #{digest}"
                     else
                         ndupfiles += 1
                         if duplist[digest].nil?
@@ -156,12 +204,17 @@ module FM
             end
         end
 
+
+        #### Report and update DB.
+
         t1 = Time.now
         puts "Indexing completed in #{(t1-t0).round(2)}s."
 
         puts "Indexed:"
         puts "     NEW: #{nnewfiles}"
         puts "     DUP: #{ndupfiles}"
+        puts "     UPD: #{nupdatefiles}"
+        puts "     RMV: #{nremovefiles}"
         puts "    SKIP: #{nskipfiles}"
         puts "    FAIL: #{nfailfiles}"
 

data/lib/fm/match.rb

@@ -1,3 +1,26 @@
+# The MIT License (MIT)
+#
+# Copyright (c) 2015-2017 SpeedGo Computing
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+
 module FM
 
     def has_folder?(folder, path)

data/lib/fm/version.rb

@@ -1,3 +1,26 @@
+# The MIT License (MIT)
+#
+# Copyright (c) 2015-2017 SpeedGo Computing
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+
 module FM
-    VERSION = '0.0.2'
+    VERSION = '0.0.3.rc1'
 end

data/lib/fm.rb

@@ -1,2 +1,26 @@
+# The MIT License (MIT)
+#
+# Copyright (c) 2015-2017 SpeedGo Computing
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+
 require 'fm/version'
+require 'fm/find'
 require 'fm/index'

data/test/index/test_cmd_index.rb

@@ -1,3 +1,26 @@
+# The MIT License (MIT)
+#
+# Copyright (c) 2015-2017 SpeedGo Computing
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+
 require 'test/unit'
 
 require 'fm'

data/test/test_fm.rb

@@ -1,3 +1,26 @@
+# The MIT License (MIT)
+#
+# Copyright (c) 2015-2017 SpeedGo Computing
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+
 require 'test/unit'
 
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fm
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3.rc1
 platform: ruby
 authors:
 - ShinYee
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-06-30 00:00:00.000000000 Z
+date: 2017-02-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -38,8 +38,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '10.1'
-description: FM indexes folders, searches for duplicated files, replicates files for
-  backup.
+description: Manage files scattered over multiple physical storages. Using file checksum,
+  it's possible to verify content integrity of your backups, look up locations of
+  the backups at various storages.
 email:
 - shinyee@speedgocomputing.com
 executables:
@@ -54,7 +55,9 @@ files:
 - bin/fm
 - fm.gemspec
 - lib/fm.rb
+- lib/fm/db.rb
 - lib/fm/file.rb
+- lib/fm/find.rb
 - lib/fm/index.rb
 - lib/fm/match.rb
 - lib/fm/version.rb
@@ -75,15 +78,16 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 2.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 2.6.8
 signing_key: 
 specification_version: 4
-summary: Managing files over multiple storage resources.
+summary: Compute and record file checksum. Verify file content integrity using checksum.
+  Identify duplicated files or backup locations.
 test_files:
 - test/index/test_cmd_index.rb
 - test/test_fm.rb