filedepot 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d3adae8af29b5bf23fca9832843d431f9ecac1a3a185309185858109de26c9ea
-  data.tar.gz: 180afd3e6ad41a51a63c3ddd8ecfa5920519c9135180c74ea1cc10de631dd629
+  metadata.gz: 2e67db1d2be17a3af457047eb147926143e85ce7a41f398ff818fc83c404dcfa
+  data.tar.gz: 3a6616e9a4925732d04d78f55fb716127c115d63220b673165795beba8b9d9c7
 SHA512:
-  metadata.gz: 2324d4048ddc0d01ad140393850b36c4615cf6104d60251d868563171499b6f5505f761ed1b225a0aa9851fcfadc7b9c6aed1bc9b6ddb068f51d4b9eee6c4d40
-  data.tar.gz: aea6ac1df0926cff12f09f9547126cb6c449343e62c91f40c1615397396c80608c531c4c2a02faf957f885e18357c92982abf9510f8e7a22c8e3589a3d41627c
+  metadata.gz: 42946b05448b6bf6c3db84b7a8c372a8f5e61688ed63defa263401ac67273d74ef647b0642e52277515d1ae2910c17fcda810b5f7da965eb5b2855bbf2913409
+  data.tar.gz: d11483ddbf5f480956a7ae334e5bd238ff701e77e198d259b825db077ae1961c844cbd71e50a8cc04ac6cb39899884ad37688e598fcd91bc534d9bc1baec6872

data/README.md

@@ -30,17 +30,65 @@ sources:
     base_path: /Users/user/filedepot
 ```
 
+Optional `public_base_path` for public URLs (shown in info and after push):
+
+```yaml
+sources:
+  - name: test
+    ssh: ssh
+    host: 127.0.0.1
+    base_path: /data/filedepot
+    public_base_path: https://example.com/files
+```
+
+When `default_source` does not match any source name, the first source is used.
+
 ## Commands
 
 | Command | Description |
 |---------|-------------|
 | `filedepot` | Show current source and available commands |
 | `filedepot config` | Open config file with $EDITOR |
-| `filedepot push HANDLE` | Send file to current storage |
-| `filedepot pull HANDLE [VERSION]` | Get file from storage |
+| `filedepot push HANDLE FILE` | Send file to current storage |
+| `filedepot pull HANDLE [--path PATH] [--version N]` | Get file from storage |
 | `filedepot versions HANDLE` | List all versions of a handle |
+| `filedepot info HANDLE` | Show info for a handle |
 | `filedepot delete HANDLE [VERSION]` | Delete file(s) after confirmation |
 
+### Push
+
+```bash
+filedepot push test test.txt
+```
+
+Sends `test.txt` to storage with handle `test`. Each push creates a new version. When `public_base_path` is configured, the URL is shown after upload.
+
+### Pull
+
+```bash
+filedepot pull test
+filedepot pull test --path ./output/file.txt
+filedepot pull test --version 2
+filedepot pull test --version 2 --path ./output/file.txt
+```
+
+Gets the latest version by default, or a specific version with `--version`. Use `--path` to specify the local destination. Prompts before creating directories or overwriting files.
+
+### Versions
+
+Lists versions in descending order with creation datetime. Shows at most 10, with a summary if more exist.
+
+### Info
+
+Shows handle, remote base path, current version, updated-at datetime, and latest version URL (when `public_base_path` is set).
+
+## Testing
+
+```bash
+bundle install
+bundle exec rake test
+```
+
 ## License
 
 MIT

data/lib/filedepot/cli.rb

@@ -35,19 +35,9 @@ module Filedepot
           filedepot pull test --version 2
           filedepot pull test --version 2 --path ./test/file.txt
       HELP
-      versions: <<~HELP,
-        Usage:
-          filedepot versions HANDLE
-
-        List all versions of a handle. Each version has an integer ID from 1 to n.
-      HELP
-      delete: <<~HELP
-        Usage:
-          filedepot delete HANDLE [VERSION]
-
-        After confirmation, deletes all versions of a file.
-        If VERSION is specified, deletes only that specific version.
-      HELP
+      versions: "Usage: filedepot versions HANDLE\n\nList all versions of a handle. Each version has an integer ID from 1 to n.",
+      delete: "Usage: filedepot delete HANDLE [VERSION]\n\nAfter confirmation, deletes all versions of a file.\nIf VERSION is specified, deletes only that specific version.",
+      info: "Usage: filedepot info HANDLE\n\nShow info for a handle: remote base path and current version."
     }.freeze
 
     desc "config", "Open the config file using $EDITOR"
@@ -60,6 +50,20 @@ module Filedepot
 
     desc "push HANDLE FILE", "Send a file to the current storage with a specific handle"
     def push(handle, file_path)
+      if handle.to_s.strip.empty?
+        puts "Error: Handle is required."
+        return
+      end
+      if file_path.to_s.strip.empty?
+        puts "Error: File path is required."
+        return
+      end
+      path = File.expand_path(file_path)
+      unless File.file?(path)
+        puts "Error: File not found: #{path}"
+        return
+      end
+
       source = Config.current_source
       if source.nil?
         puts "Error: No storage source configured. Run 'filedepot config' to set up."
@@ -67,8 +71,13 @@ module Filedepot
       end
 
       storage = Storage::Base.for(source)
-      storage.push(handle, file_path)
-      puts "Pushed #{file_path} as #{handle} (version #{storage.current_version(handle)})"
+      storage.push(handle, path)
+      version = storage.current_version(handle)
+      puts "Pushed #{file_path} as #{handle} (version #{version})"
+      uploaded_url = storage.url(handle, version, File.basename(path))
+      puts uploaded_url if uploaded_url
+    rescue RuntimeError => e
+      puts "Error: #{e.message}"
     end
 
     desc "pull HANDLE", "Get file from storage"
@@ -93,6 +102,8 @@ module Filedepot
       info = storage.pull_info(handle, version, local_path)
       target_path = info[:target_path]
 
+      puts "Pulling #{handle} (version #{info[:version_num]})"
+
       parent_dir = File.dirname(target_path)
       unless parent_dir == "." || File.directory?(parent_dir)
         return unless confirm?("create local directory #{parent_dir}, y/n?")
@@ -104,7 +115,9 @@ module Filedepot
       end
 
       storage.pull(handle, version, target_path)
-      puts "Pulled #{handle} (version #{info[:version_num]}) to #{target_path}"
+      puts "pulled to #{target_path}"
+    rescue RuntimeError => e
+      puts "Error: #{e.message}"
     end
 
     desc "versions HANDLE", "List all versions of a handle (each version has an integer from 1 to n)"
@@ -123,7 +136,7 @@ module Filedepot
       storage = Storage::Base.for(source)
       versions_list = storage.versions(handle)
       if versions_list.empty?
-        puts "No versions found for handle: #{handle}"
+        puts "Error: Handle '#{handle}' not found."
       else
         max_display = 10
         to_show = versions_list.first(max_display)
@@ -135,14 +148,81 @@ module Filedepot
       end
     end
 
+    desc "info HANDLE", "Show info for a handle"
+    def info(handle = nil)
+      if handle.nil?
+        puts COMMAND_HELP[:info]
+        return
+      end
+
+      source = Config.current_source
+      if source.nil?
+        puts "Error: No storage source configured. Run 'filedepot config' to set up."
+        return
+      end
+
+      storage = Storage::Base.for(source)
+      versions_list = storage.versions(handle)
+      if versions_list.empty?
+        puts "Error: Handle '#{handle}' not found."
+        return
+      end
+
+      data = storage.info(handle)
+
+      puts "handle: #{data[:handle]}"
+      puts "remote_base_path: #{data[:remote_base_path]}"
+      puts "current version: #{data[:current_version]}"
+      puts "updated at: #{data[:updated_at]}" if data[:updated_at]
+      puts "latest version url: #{data[:latest_version_url]}" if data[:latest_version_url]
+    end
+
     desc "delete HANDLE [VERSION]", "After confirmation, delete all versions of a file; or only a specific version if specified"
     def delete(handle = nil, version = nil)
       if handle.nil?
         puts COMMAND_HELP[:delete]
         return
       end
+
+      source = Config.current_source
+      if source.nil?
+        puts "Error: No storage source configured. Run 'filedepot config' to set up."
+        return
+      end
+
+      storage = Storage::Base.for(source)
+      versions_list = storage.versions(handle)
+      if versions_list.empty?
+        puts "Error: Handle '#{handle}' not found."
+        return
+      end
+      if version
+        version_nums = versions_list.map(&:first)
+        unless version_nums.include?(version.to_i)
+          puts "Error: Version #{version} not found for handle '#{handle}'."
+          return
+        end
+      end
+
       version_str = version ? " version #{version}" : " all versions"
-      puts "delete: would delete file '#{handle}'#{version_str} after confirmation (not implemented)"
+      puts "This will delete '#{handle}'#{version_str}."
+      begin
+        print "Type the handle name to confirm: "
+        input = $stdin.gets&.strip
+      rescue Interrupt
+        puts
+        return
+      end
+
+      unless input == handle
+        puts "Aborted (handle name did not match)."
+        return
+      end
+
+      storage.delete(handle, version)
+      puts "Deleted #{handle}#{version ? " version #{version}" : ""}."
+    rescue RuntimeError => e
+      puts "Error: #{e.message}"
     end
 
     default_task :default
@@ -166,6 +246,7 @@ module Filedepot
       puts "  filedepot push HANDLE FILE    Send file to current storage"
       puts "  filedepot pull HANDLE [--path PATH] [--version N]  Get file from storage"
       puts "  filedepot versions HANDLE     List all versions of a handle"
+      puts "  filedepot info HANDLE         Show info for a handle"
       puts "  filedepot delete HANDLE [VER] Delete file(s) after confirmation"
       puts ""
       puts "Use 'filedepot help COMMAND' for more information on a command."

data/lib/filedepot/storage/base.rb

@@ -52,10 +52,35 @@ module Filedepot
         raise "not implemented"
       end
 
+      def versions_data(handle)
+        raise "not implemented"
+      end
+
       def delete(handle, version = nil)
         raise "not implemented"
       end
 
+      def info(handle)
+        data = versions_data(handle)
+        latest = data.first
+        result = {
+          handle: handle,
+          remote_base_path: remote_base_path,
+          current_version: current_version(handle)
+        }
+        result[:updated_at] = latest[:datetime] if latest
+        result[:latest_version_url] = latest[:url] if latest && latest[:url]
+        result
+      end
+
+      def url(handle, version, filename)
+        base = @source["public_base_path"].to_s.sub(%r{/+$}, "")
+        return nil if base.empty? || filename.nil? || filename.empty?
+
+        path = [handle, version, filename].join("/")
+        "#{base}/#{path}"
+      end
+
       protected
 
       def remote_base_path

data/lib/filedepot/storage_ssh.rb

@@ -27,7 +27,7 @@ module Filedepot
 
       def push(handle, local_path)
         path = File.expand_path(local_path)
-        raise "File not found: #{local_path}" unless File.file?(path)
+        raise "File not found: #{path}" unless File.file?(path)
 
         push_path = next_version_path(handle)
 
@@ -57,14 +57,14 @@ module Filedepot
       def pull(handle, version = nil, local_path = nil)
         ssh_session do |ssh|
           versions_list = versions_for(ssh, handle)
-          raise "No versions found for handle: #{handle}" if versions_list.empty?
+          raise "Handle '#{handle}' not found" if versions_list.empty?
 
           version_num = version ? version.to_i : versions_list.max
-          raise "Version #{version} not found" unless versions_list.include?(version_num)
+          raise "Version #{version} not found for handle '#{handle}'" unless versions_list.include?(version_num)
 
           version_dir = File.join(remote_handle_path(handle), version_num.to_s)
           remote_file = first_file_in_dir(ssh, version_dir)
-          raise "No file found in version #{version_num}" if remote_file.nil?
+          raise "No file found in version #{version_num} for handle '#{handle}'" if remote_file.nil?
 
           remote_filename = File.basename(remote_file)
           target_path = resolve_local_path(local_path, remote_filename)
@@ -77,14 +77,14 @@ module Filedepot
       def pull_info(handle, version = nil, local_path = nil)
         ssh_session do |ssh|
           versions_list = versions_for(ssh, handle)
-          raise "No versions found for handle: #{handle}" if versions_list.empty?
+          raise "Handle '#{handle}' not found" if versions_list.empty?
 
           version_num = version ? version.to_i : versions_list.max
-          raise "Version #{version} not found" unless versions_list.include?(version_num)
+          raise "Version #{version} not found for handle '#{handle}'" unless versions_list.include?(version_num)
 
           version_dir = File.join(remote_handle_path(handle), version_num.to_s)
           remote_file = first_file_in_dir(ssh, version_dir)
-          raise "No file found in version #{version_num}" if remote_file.nil?
+          raise "No file found in version #{version_num} for handle '#{handle}'" if remote_file.nil?
 
           remote_filename = File.basename(remote_file)
           target_path = resolve_local_path(local_path, remote_filename)
@@ -93,18 +93,31 @@ module Filedepot
         end
       end
 
-      def versions(handle)
+      def versions_data(handle)
         ssh_session do |ssh|
           versions_list = versions_for(ssh, handle).sort.reverse
           versions_list.map do |v|
             version_dir = File.join(remote_handle_path(handle), v.to_s)
             epoch = stat_mtime(ssh, version_dir)
-            date_str = epoch ? Time.at(epoch).to_s : ""
-            [v, date_str]
+            remote_file = first_file_in_dir(ssh, version_dir)
+            path = remote_file || version_dir
+            filename = remote_file ? File.basename(remote_file) : nil
+            {
+              version: v,
+              datetime: epoch ? Time.at(epoch) : nil,
+              path: path,
+              handle: handle,
+              filename: filename,
+              url: url(handle, v, filename)
+            }
           end
         end
       end
 
+      def versions(handle)
+        versions_data(handle).map { |d| [d[:version], d[:datetime] ? d[:datetime].to_s : ""] }
+      end
+
       def delete(handle, version = nil)
         ssh_session do |ssh|
           handle_dir = remote_handle_path(handle)

data/lib/filedepot/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Filedepot
-  VERSION = "0.2.0"
+  VERSION = "0.2.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: filedepot
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - Filedepot
@@ -51,6 +51,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
 description: Command-line tool to sync files on remote storage via SSH
 email:
 - ''