net-sftp-backports 4.0.0.backports

data/lib/net/sftp/version.rb

@@ -0,0 +1,68 @@
+module Net
+  module SFTP
+    # A class for describing the current version of a library. The version
+    # consists of three parts: the +major+ number, the +minor+ number, and the
+    # +tiny+ (or +patch+) number.
+    #
+    # Two Version instances may be compared, so that you can test that a version
+    # of a library is what you require:
+    #
+    #   require 'net/sftp/version'
+    #
+    #   if Net::SFTP::Version::CURRENT < Net::SFTP::Version[2,1,0]
+    #     abort "your software is too old!"
+    #   end
+    class Version
+      include Comparable
+
+      # A convenience method for instantiating a new Version instance with the
+      # given +major+, +minor+, and +tiny+ components.
+      def self.[](major, minor, tiny, pre = nil)
+        new(major, minor, tiny, pre)
+      end
+
+      attr_reader :major, :minor, :tiny
+
+      # Create a new Version object with the given components.
+      def initialize(major, minor, tiny, pre = nil)
+        @major, @minor, @tiny, @pre = major, minor, tiny, pre
+      end
+
+      # Compare this version to the given +version+ object.
+      def <=>(version)
+        to_i <=> version.to_i
+      end
+
+      # Converts this version object to a string, where each of the three
+      # version components are joined by the '.' character. E.g., 2.0.0.
+      def to_s
+        @to_s ||= [@major, @minor, @tiny, @pre].compact.join(".")
+      end
+
+      # Converts this version to a canonical integer that may be compared
+      # against other version objects.
+      def to_i
+        @to_i ||= @major * 1_000_000 + @minor * 1_000 + @tiny
+      end
+
+      # The major component of this version of the Net::SFTP library
+      MAJOR = 4
+
+      # The minor component of this version of the Net::SFTP library
+      MINOR = 0
+
+      # The tiny component of this version of the Net::SFTP library
+      TINY  = 0
+
+      # The prerelease component of this version of the Net::SFTP library
+      # nil allowed
+      PRE   = "backports"
+
+      # The current version of the Net::SFTP library as a Version instance
+      CURRENT = new(*[MAJOR, MINOR, TINY, PRE].compact)
+
+      # The current version of the Net::SFTP library as a String
+      STRING = CURRENT.to_s
+    end
+  end
+end

data/lib/net/sftp.rb

@@ -0,0 +1,78 @@
+require 'net/ssh'
+require 'net/sftp/session'
+
+module Net
+
+  # Net::SFTP is a pure-Ruby module for programmatically interacting with a
+  # remote host via the SFTP protocol (that's SFTP as in "Secure File Transfer
+  # Protocol" produced by the Secure Shell Working Group, not "Secure FTP"
+  # and certainly not "Simple FTP").
+  #
+  # See Net::SFTP#start for an introduction to the library. Also, see
+  # Net::SFTP::Session for further documentation.
+  module SFTP
+    # A convenience method for starting a standalone SFTP session. It will
+    # start up an SSH session using the given arguments (see the documentation
+    # for Net::SSH::Session for details), and will then start a new SFTP session
+    # with the SSH session. This will block until the new SFTP is fully open
+    # and initialized before returning it.
+    #
+    #   sftp = Net::SFTP.start("localhost", "user")
+    #   sftp.upload! "/local/file.tgz", "/remote/file.tgz"
+    #
+    # If a block is given, it will be passed to the SFTP session and will be
+    # called once the SFTP session is fully open and initialized. When the
+    # block terminates, the new SSH session will automatically be closed.
+    #
+    #   Net::SFTP.start("localhost", "user") do |sftp|
+    #     sftp.upload! "/local/file.tgz", "/remote/file.tgz"
+    #   end
+    #
+    # Extra parameters can be passed:
+    # - The Net::SSH connection options (see Net::SSH for more information)
+    # - The Net::SFTP connection options (only :version is supported, to let you 
+    #   set the SFTP protocol version to be used)
+    def self.start(host, user, ssh_options={}, sftp_options={}, &block)
+      session = Net::SSH.start(host, user, ssh_options)
+      # We only use a single option here, but this leaves room for more later
+      # without breaking the external API.
+      version = sftp_options.fetch(:version, nil)
+      sftp = Net::SFTP::Session.new(session, version, &block).connect!
+
+      if block_given?
+        sftp.loop
+        session.close
+        return nil
+      end
+
+      sftp
+    rescue Object => anything
+      begin
+        session.shutdown!
+      rescue ::Exception
+        # swallow exceptions that occur while trying to shutdown
+      end
+
+      raise anything
+    end
+  end
+
+end
+
+class Net::SSH::Connection::Session
+  # A convenience method for starting up a new SFTP connection on the current
+  # SSH session. Blocks until the SFTP session is fully open, and then
+  # returns the SFTP session.
+  #
+  #   Net::SSH.start("localhost", "user", :password => "password") do |ssh|
+  #     ssh.sftp.upload!("/local/file.tgz", "/remote/file.tgz")
+  #     ssh.exec! "cd /some/path && tar xf /remote/file.tgz && rm /remote/file.tgz"
+  #   end
+  def sftp(wait=true)
+    @sftp ||= begin
+      sftp = Net::SFTP::Session.new(self)
+      sftp.connect! if wait
+      sftp
+    end
+  end
+end

data/net-sftp-public_cert.pem

@@ -0,0 +1,20 @@
+-----BEGIN CERTIFICATE-----
+MIIDQDCCAiigAwIBAgIBATANBgkqhkiG9w0BAQsFADAlMSMwIQYDVQQDDBpuZXRz
+c2gvREM9c29sdXRpb3VzL0RDPWNvbTAeFw0yMjA5MjIxMTUwMDJaFw0yMzA5MjIx
+MTUwMDJaMCUxIzAhBgNVBAMMGm5ldHNzaC9EQz1zb2x1dGlvdXMvREM9Y29tMIIB
+IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxieE22fR/qmdPKUHyYTyUx2g
+wskLwrCkxay+Tvc97ZZUOwf85LDDDPqhQaTWLvRwnIOMgQE2nBPzwalVclK6a+pW
+x/18KDeZY15vm3Qn5p42b0wi9hUxOqPm3J2hdCLCcgtENgdX21nVzejn39WVqFJO
+lntgSDNW5+kCS8QaRsmIbzj17GKKkrsw39kiQw7FhWfJFeTjddzoZiWwc59KA/Bx
+fBbmDnsMLAtAtauMOxORrbx3EOY7sHku/kSrMg3FXFay7jc6BkbbUij+MjJ/k82l
+4o8o0YO4BAnya90xgEmgOG0LCCxRhuXQFnMDuDjK2XnUe0h4/6NCn94C+z9GsQID
+AQABo3sweTAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQUBfKiwO2e
+M4NEiRrVG793qEPLYyMwHwYDVR0RBBgwFoEUbmV0c3NoQHNvbHV0aW91cy5jb20w
+HwYDVR0SBBgwFoEUbmV0c3NoQHNvbHV0aW91cy5jb20wDQYJKoZIhvcNAQELBQAD
+ggEBABI2ORK5kzUL7uOF0EHI4ECMWxQMiN+pURyGp9u7DU0H8eSdZN52jbUGHzSB
+j7bB6GpqElEWjOe0IbH3vR52IVXq2bOF4P4vFchGAb4OuzJD8aJmrC/SPLHbWBuV
+2GpbRQRJyYPWN6Rt/4EHOxoFnhXOBEB6CGIy0dt7YezycVbzqtHoiI2Qf/bIFJQZ
+mpJAAUBkRiWksE7zrsE5DGK8kL2GVos7f8kdM71zT8p7VBwkMdY277T29TG2xD0D
+66Oev0C3/x89NXqCHkl1JElSzEFbOoxan16z7xNEf2MKcBKGhsYfzWVNyEtJm785
+g+97rn/AuO6dcxJnW2qBGYQa7pQ=
+-----END CERTIFICATE-----

data/net-sftp.gemspec

@@ -0,0 +1,48 @@
+require_relative 'lib/net/sftp/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "net-sftp-backports"
+  spec.version       = Net::SFTP::Version::STRING
+  spec.authors       = ["Jamis Buck", "Delano Mandelbaum", "Mikl\u{f3}s Fazekas"]
+  spec.email         = ["net-ssh@solutious.com"]
+
+  if ENV['NET_SSH_BUILDGEM_SIGNED']
+    spec.cert_chain = ["net-sftp-public_cert.pem"]
+    spec.signing_key = "/mnt/gem/net-ssh-private_key.pem"
+  end
+
+  spec.summary       = %q{A pure Ruby implementation of the SFTP client protocol.}
+  spec.description   = %q{A pure Ruby implementation of the SFTP client protocol}
+  spec.homepage      = "https://github.com/net-ssh/net-sftp"
+  spec.license       = "MIT"
+  spec.required_rubygems_version = Gem::Requirement.new(">= 0") if spec.respond_to? :required_rubygems_version=
+
+  spec.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  if spec.respond_to? :specification_version then
+    spec.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      spec.add_runtime_dependency(%q<net-ssh-backports>, [">= 6.0.0", "< 7.0.0"])
+      spec.add_development_dependency(%q<minitest>, [">= 5"])
+      spec.add_development_dependency(%q<mocha>, [">= 0"])
+    else
+      spec.add_dependency(%q<net-ssh>, [">= 5.0.0", "< 8.0.0"])
+      spec.add_dependency(%q<minitest>, [">= 5"])
+      spec.add_dependency(%q<mocha>, [">= 0"])
+    end
+  else
+    spec.add_dependency(%q<net-ssh>, [">= 5.0.0", "< 8.0.0"])
+    spec.add_dependency(%q<minitest>, [">= 5"])
+    spec.add_dependency(%q<test-unit>, [">= 0"])
+    spec.add_dependency(%q<mocha>, [">= 0"])
+  end
+end