0
@@ -1,5 +1,7 @@
0
 === *unreleased*
0
 
0
+* Custom properties on Download instances [Jamis Buck]
0
+
0
 * Add #abort! method to Upload and Download operations [Jamis Buck]
0
 
0
 * More complete support for file-type detection in protocol versions 1-3 [Jamis Buck]

0
@@ -132,6 +132,9 @@ module Net; module SFTP; module Operations
0
     # The SFTP session instance that drives this download.
0
     attr_reader :sftp
0
 
0
+    # The properties hash for this object
0
+    attr_reader :properties
0
+
0
     # Instantiates a new downloader process on top of the given SFTP session.
0
     # +local+ is either an IO object that should receive the data, or a string
0
     # identifying the target file or directory on the local host. +remote+ is
0
@@ -147,6 +150,7 @@ module Net; module SFTP; module Operations
0
       @progress = progress || options[:progress]
0
       @options = options
0
       @active = 0
0
+      @properties = {}
0
 
0
       self.logger = sftp.logger
0
 
0
@@ -183,6 +187,18 @@ module Net; module SFTP; module Operations
0
       self
0
     end
0
 
0
+    # Returns the property with the given name. This allows Download instances
0
+    # to store their own state when used as part of a state machine.
0
+    def [](name)
0
+      @properties[name.to_sym]
0
+    end
0
+
0
+    # Sets the given property to the given name. This allows Download instances
0
+    # to store their own state when used as part of a state machine.
0
+    def []=(name, value)
0
+      @properties[name.to_sym] = value
0
+    end
0
+
0
     private
0
 
0
       # A simple struct for encapsulating information about a single remote