lib/rapidshare-base/utils.rb in rapidshare-ext-0.0.6 vs lib/rapidshare-base/utils.rb in rapidshare-ext-0.1.0

@@ -1,12 +1,51 @@
 module Rapidshare
+
+  # Contains utility methods which can be called both as class and instance methods
+  #
   module Utils
+
+    # From historical purposes GET and POST methods a distinguished.
+    # They will be merged in a future release
     def post(url, params)
       params[:filecontent] = File.new(params[:filecontent])
       ::RestClient.post(url, params)
     end
 
     def get(url)
       ::RestClient.get(url)
+    end
+
+    # Convert file status code (returned by checkfiles method) to +:ok+ or +:error+ symbol.
+    #
+    def decode_file_status(status_code)
+      # TODO in checkfiles, return both file_status as is and decoded file status
+      # or just boolean value if file is OK and can be downloaded
+
+      case status_code
+        when 0 then :error # File not found
+        when 1 then :ok # File OK
+        when 3 then :error # Server down
+        when 4 then :error # File marked as illegal
+        else :error # unknown status, this shouldn't happen
+      end
+    end
+
+    # Extracts file id and file name from Rapidshare url. Returns both in array.
+    #
+    # Example:
+    #   https://rapidshare.com/files/829628035/HornyRhinos.jpg -> [ '829628035', 'HornyRhinos.jpg' ]
+    #
+    def fileid_and_filename(url)
+      url.split('/').slice(-2,2) || ['', '']
+    end
+
+    # Converts rapidshare response (which is just a text in specific format) to hash.
+    #
+    # Example:
+    #   "key1=value1\nkey1=value2" -> { :key1 => 'value1', :key2 => 'value2' }
+    #
+    def text_to_hash(response)
+      Hash[ response.strip.split(/\s*\n\s*/).map { |param| param.split('=') } ].symbolize_keys
     end
   end
 end
\ No newline at end of file