filedepot 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b2297095fcd44cd4bc54bf159dba4db6b67eb01097b81d7b568fbdd09b508394
-  data.tar.gz: 5057493bcdc4ad7e83dbd6f6b1469b38b9317003674ecfd291c3c2c3c1e6b243
+  metadata.gz: 3323f568d221fde7de4cd30f7450b46444f48bcfe71b2e0dd16acfe84d97fd14
+  data.tar.gz: 39318899de695422ef75292f4e5c5a8cf3271b91ef0d474fdc1305ebfd78dead
 SHA512:
-  metadata.gz: 0f88deafeeed98b2b9ddcb4b47179b9da164c583f7e1b8690ac92976fd551e475ae73511b66eef239c59e735a31d878c5c074dd2802543503bd8d0dfc1a5b64a
-  data.tar.gz: b8b7726ae00b0c3fd64faf4bf97112f6ff8b3183c5c9ea82f8f6a67b95bbdfb51bc776594dd2f5e181e439b3a6fc422c82a6b90dbded855cb2eedd77fd6700b1
+  metadata.gz: 37f23733b8942db6547ab12960cef9308717f1836ff4c1ae6959c3a1196c00195508f4a5d996d8b9efd10a7ac93552799d633fa11e475f6575ddccee690985ee
+  data.tar.gz: 70f21d4037d84be1cc71c12032eb7e31253b304511af80e8d6fb7e397823e87a9c4718db35466bfe746ca3cfc249a089bc65e534d1e3330240196a5dc703c8a0

data/lib/filedepot/cli.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "fileutils"
 require "thor"
 
 module Filedepot
@@ -15,30 +16,28 @@ module Filedepot
       HELP
       push: <<~HELP,
         Usage:
-          filedepot push HANDLE
+          filedepot push HANDLE FILE
 
-        Send a file with a specific handle to the current storage.
+        Send a file to the current storage with a specific handle.
+        Example: filedepot push test test.txt
       HELP
       pull: <<~HELP,
         Usage:
-          filedepot pull HANDLE [VERSION]
-
-        Get the latest version of file with a specific handle from the current storage.
-        VERSION is optional; if omitted, retrieves the latest version.
-      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.
+          filedepot pull HANDLE [--path PATH] [--version VERSION]
+
+        Get a file from storage. By default gets the latest version and saves to current directory.
+        Options:
+          --path PATH    Save to this local path (e.g. ./test/file.txt)
+          --version N   Get specific version (default: latest)
+        Examples:
+          filedepot pull test
+          filedepot pull test --path ./test/file.txt
+          filedepot pull test --version 2
+          filedepot pull test --version 2 --path ./test/file.txt
       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"
@@ -49,23 +48,58 @@ module Filedepot
       exec(editor, config_path)
     end
 
-    desc "push HANDLE", "Send a file with a specific handle to the current storage"
-    def push(handle = nil)
-      if handle.nil?
-        puts COMMAND_HELP[:push]
+    desc "push HANDLE FILE", "Send a file to the current storage with a specific handle"
+    def push(handle, file_path)
+      source = Config.current_source
+      if source.nil?
+        puts "Error: No storage source configured. Run 'filedepot config' to set up."
         return
       end
-      puts "push: would send file with handle '#{handle}' to current storage (not implemented)"
+
+      storage = Storage::Base.for(source)
+      storage.push(handle, file_path)
+      version = storage.current_version(handle)
+      puts "Pushed #{file_path} as #{handle} (version #{version})"
+      uploaded_url = storage.url(handle, version, File.basename(file_path))
+      puts uploaded_url if uploaded_url
     end
 
-    desc "pull HANDLE [VERSION]", "Get the latest version of file with a specific handle from the current storage"
-    def pull(handle = nil, version = nil)
+    desc "pull HANDLE", "Get file from storage"
+    method_option :path, type: :string, desc: "Local path to save the file"
+    method_option :version, type: :string, desc: "Version number to pull (default: latest)"
+    def pull(handle = nil)
       if handle.nil?
         puts COMMAND_HELP[:pull]
         return
       end
-      version_str = version ? " version #{version}" : " latest version"
-      puts "pull: would get file '#{handle}'#{version_str} from current storage (not implemented)"
+
+      source = Config.current_source
+      if source.nil?
+        puts "Error: No storage source configured. Run 'filedepot config' to set up."
+        return
+      end
+
+      local_path = options[:path]
+      version = (options[:version].nil? || options[:version].empty?) ? nil : options[:version].to_i
+
+      storage = Storage::Base.for(source)
+      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?")
+        FileUtils.mkdir_p(parent_dir)
+      end
+
+      if File.exist?(target_path)
+        return unless confirm?("overwrite local #{target_path}, y/n?")
+      end
+
+      storage.pull(handle, version, target_path)
+      puts "pulled to #{target_path}"
     end
 
     desc "versions HANDLE", "List all versions of a handle (each version has an integer from 1 to n)"
@@ -74,7 +108,49 @@ module Filedepot
         puts COMMAND_HELP[:versions]
         return
       end
-      puts "versions: would list all versions of handle '#{handle}' (not implemented)"
+
+      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 "No versions found for handle: #{handle}"
+      else
+        max_display = 10
+        to_show = versions_list.first(max_display)
+        to_show.each { |v, date_str| puts date_str.empty? ? v.to_s : "#{v} - #{date_str}" }
+        if versions_list.size > max_display
+          remaining = versions_list.size - max_display
+          puts "... and #{remaining} other ones for a total of #{versions_list.size} versions"
+        end
+      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)
+      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"
@@ -105,9 +181,10 @@ module Filedepot
       puts ""
       puts "Available commands:"
       puts "  filedepot config              Open config file using $EDITOR"
-      puts "  filedepot push HANDLE         Send file to current storage"
-      puts "  filedepot pull HANDLE [VER]   Get file from storage (version optional)"
+      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."
@@ -116,5 +193,16 @@ module Filedepot
     def self.exit_on_failure?
       true
     end
+
+    private
+
+    def confirm?(prompt)
+      print "#{prompt} "
+      input = $stdin.gets&.strip&.downcase
+      input == "y" || input == "yes"
+    rescue Interrupt
+      puts
+      false
+    end
   end
 end

data/lib/filedepot/config.rb

@@ -36,7 +36,10 @@ module Filedepot
         config = load
         default = config["default_source"]
         sources = config["sources"] || []
-        sources.find { |s| s["name"] == default }
+        return nil if sources.empty?
+
+        source = sources.find { |s| (s["name"] || s[:name]) == default }
+        source || sources.first
       end
     end
   end

data/lib/filedepot/storage/base.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+module Filedepot
+  module Storage
+    class Base
+      def self.for(source)
+        if source["ssh"]
+          SshStorage.new(source)
+        else
+          raise ArgumentError, "Unknown storage type for source: #{source["name"]}"
+        end
+      end
+
+      def initialize(source)
+        @source = source
+      end
+
+      def current_version(handle)
+        path = current_version_path(handle)
+        path.nil? || path.to_s.empty? ? 0 : File.basename(path).to_i
+      end
+
+      def next_version(handle)
+        current_version(handle) + 1
+      end
+
+      def next_version_path(handle)
+        File.join(remote_handle_path(handle), next_version(handle).to_s)
+      end
+
+      def current_version_path(handle)
+        raise "not implemented"
+      end
+
+      def test
+        raise "not implemented"
+      end
+
+      def ls
+        raise "not implemented"
+      end
+
+      def push(handle, local_path)
+        raise "not implemented"
+      end
+
+      def pull(handle, version = nil, local_path = nil)
+        raise "not implemented"
+      end
+
+      def versions(handle)
+        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?
+
+        [base, handle, version, filename].join("/").gsub(%r{/+}, "/")
+      end
+
+      protected
+
+      def remote_base_path
+        @source["base_path"] || "/tmp/filedepot"
+      end
+
+      def remote_handle_path(handle)
+        safe_handle = handle.to_s.gsub(%r{[^\w\-./]}, "_")
+        File.join(remote_base_path, safe_handle)
+      end
+    end
+  end
+end

data/lib/filedepot/storage_ssh.rb

@@ -0,0 +1,189 @@
+# frozen_string_literal: true
+
+require "shellwords"
+require "net/ssh"
+require "net/scp"
+
+module Filedepot
+  module Storage
+    class SshStorage < Base
+      def test
+        ssh_session do |ssh|
+          result = ssh.exec!("echo ok")
+          raise "Connection failed" unless result&.include?("ok")
+        end
+      end
+
+      def ls
+        handles = []
+        ssh_session do |ssh|
+          result = ssh.exec!("ls -1 #{shell_escape(remote_base_path)} 2>/dev/null || true")
+          return [] if result.nil? || result.strip.empty?
+
+          handles = result.strip.split("\n").select { |line| !line.empty? }
+        end
+        handles
+      end
+
+      def push(handle, local_path)
+        path = File.expand_path(local_path)
+        raise "File not found: #{local_path}" unless File.file?(path)
+
+        push_path = next_version_path(handle)
+
+        ssh_session do |ssh|
+          ssh.exec!("mkdir -p #{shell_escape(push_path)}")
+          # Upload to directory - SCP places file with original name inside
+          ssh.scp.upload!(path, push_path)
+        end
+      end
+
+      def current_version_path(handle)
+        ssh_session do |ssh|
+          handle_dir = remote_handle_path(handle)
+          ssh.exec!("mkdir -p #{shell_escape(handle_dir)}")
+
+          result = ssh.exec!("ls -1 #{shell_escape(handle_dir)} 2>/dev/null || true")
+          versions = parse_versions(result)
+
+          if versions.empty?
+            nil
+          else
+            File.join(handle_dir, versions.max.to_s)
+          end
+        end
+      end
+
+      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?
+
+          version_num = version ? version.to_i : versions_list.max
+          raise "Version #{version} not found" 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?
+
+          remote_filename = File.basename(remote_file)
+          target_path = resolve_local_path(local_path, remote_filename)
+
+          ssh.scp.download!(remote_file, target_path)
+          target_path
+        end
+      end
+
+      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?
+
+          version_num = version ? version.to_i : versions_list.max
+          raise "Version #{version} not found" 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?
+
+          remote_filename = File.basename(remote_file)
+          target_path = resolve_local_path(local_path, remote_filename)
+
+          { remote_filename: remote_filename, version_num: version_num, target_path: target_path }
+        end
+      end
+
+      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)
+            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)
+
+          if version
+            version_dir = File.join(handle_dir, version.to_s)
+            ssh.exec!("rm -rf #{shell_escape(version_dir)}")
+            versions_remaining = versions_for(ssh, handle)
+            ssh.exec!("rmdir #{shell_escape(handle_dir)} 2>/dev/null || true") if versions_remaining.empty?
+          else
+            ssh.exec!("rm -rf #{shell_escape(handle_dir)}")
+          end
+        end
+      end
+
+      private
+
+      def shell_escape(path)
+        Shellwords.shellescape(path.to_s)
+      end
+
+      def ssh_session
+        host = @source["host"] || "localhost"
+        user = @source["username"].to_s.strip
+        user = ENV["USER"] if user.empty?
+
+        Net::SSH.start(host, user) do |ssh|
+          yield ssh
+        end
+      end
+
+      def versions_for(ssh, handle)
+        remote_dir = remote_handle_path(handle)
+        result = ssh.exec!("ls -1 #{shell_escape(remote_dir)} 2>/dev/null || true")
+        parse_versions(result)
+      end
+
+      def parse_versions(ls_result)
+        return [] if ls_result.nil? || ls_result.strip.empty?
+
+        ls_result.strip.split("\n").map(&:to_i).select { |v| v.positive? }
+      end
+
+      def first_file_in_dir(ssh, dir)
+        result = ssh.exec!("ls -1 #{shell_escape(dir)} 2>/dev/null || true")
+        return nil if result.nil? || result.strip.empty?
+
+        first = result.strip.split("\n").first
+        first ? File.join(dir, first) : nil
+      end
+
+      def stat_mtime(ssh, path)
+        # Linux: stat -c %Y; macOS: stat -f %m
+        result = ssh.exec!("stat -c %Y #{shell_escape(path)} 2>/dev/null || stat -f %m #{shell_escape(path)} 2>/dev/null")
+        result&.strip&.to_i
+      end
+
+      def resolve_local_path(local_path_param, remote_filename)
+        if local_path_param.nil? || local_path_param.empty?
+          File.join(Dir.pwd, remote_filename)
+        elsif local_path_param.end_with?("/") || (File.exist?(local_path_param) && File.directory?(local_path_param))
+          File.join(File.expand_path(local_path_param), remote_filename)
+        else
+          File.expand_path(local_path_param)
+        end
+      end
+    end
+  end
+end

data/lib/filedepot/version.rb

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

data/lib/filedepot.rb

@@ -2,6 +2,8 @@
 
 require "filedepot/version"
 require "filedepot/config"
+require "filedepot/storage/base"
+require "filedepot/storage_ssh"
 require "filedepot/cli"
 
 module Filedepot

metadata

@@ -1,15 +1,42 @@
 --- !ruby/object:Gem::Specification
 name: filedepot
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Filedepot
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-13 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: net-scp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: net-ssh
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
@@ -24,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:
 - ''
@@ -37,6 +92,8 @@ files:
 - lib/filedepot.rb
 - lib/filedepot/cli.rb
 - lib/filedepot/config.rb
+- lib/filedepot/storage/base.rb
+- lib/filedepot/storage_ssh.rb
 - lib/filedepot/version.rb
 homepage: https://github.com/filedepot/filedepot
 licenses:
@@ -44,7 +101,6 @@ licenses:
 metadata:
   homepage_uri: https://github.com/filedepot/filedepot
   source_code_uri: https://github.com/filedepot/filedepot
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -59,8 +115,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Sync files on remote storage
 test_files: []