filedepot 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b2297095fcd44cd4bc54bf159dba4db6b67eb01097b81d7b568fbdd09b508394
-  data.tar.gz: 5057493bcdc4ad7e83dbd6f6b1469b38b9317003674ecfd291c3c2c3c1e6b243
+  metadata.gz: d3adae8af29b5bf23fca9832843d431f9ecac1a3a185309185858109de26c9ea
+  data.tar.gz: 180afd3e6ad41a51a63c3ddd8ecfa5920519c9135180c74ea1cc10de631dd629
 SHA512:
-  metadata.gz: 0f88deafeeed98b2b9ddcb4b47179b9da164c583f7e1b8690ac92976fd551e475ae73511b66eef239c59e735a31d878c5c074dd2802543503bd8d0dfc1a5b64a
-  data.tar.gz: b8b7726ae00b0c3fd64faf4bf97112f6ff8b3183c5c9ea82f8f6a67b95bbdfb51bc776594dd2f5e181e439b3a6fc422c82a6b90dbded855cb2eedd77fd6700b1
+  metadata.gz: 2324d4048ddc0d01ad140393850b36c4615cf6104d60251d868563171499b6f5505f761ed1b225a0aa9851fcfadc7b9c6aed1bc9b6ddb068f51d4b9eee6c4d40
+  data.tar.gz: aea6ac1df0926cff12f09f9547126cb6c449343e62c91f40c1615397396c80608c531c4c2a02faf957f885e18357c92982abf9510f8e7a22c8e3589a3d41627c

data/lib/filedepot/cli.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "fileutils"
 require "thor"
 
 module Filedepot
@@ -15,16 +16,24 @@ 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.
+          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: <<~HELP,
         Usage:
@@ -49,23 +58,53 @@ 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)
+      puts "Pushed #{file_path} as #{handle} (version #{storage.current_version(handle)})"
     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]
+
+      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 #{handle} (version #{info[:version_num]}) to #{target_path}"
     end
 
     desc "versions HANDLE", "List all versions of a handle (each version has an integer from 1 to n)"
@@ -74,7 +113,26 @@ 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 "delete HANDLE [VERSION]", "After confirmation, delete all versions of a file; or only a specific version if specified"
@@ -105,8 +163,8 @@ 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 delete HANDLE [VER] Delete file(s) after confirmation"
       puts ""
@@ -116,5 +174,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,71 @@
+# 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 delete(handle, version = nil)
+        raise "not implemented"
+      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,176 @@
+# 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(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]
+          end
+        end
+      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.0"
 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.0
 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
@@ -37,6 +64,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 +73,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 +87,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: []