[chromedriver] Add command for uploading a file to a remote ChromeDriver server,

chrome/test/webdriver/webdriver_util.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROME_TEST_WEBDRIVER_WEBDRIVER_UTIL_H_
 #define CHROME_TEST_WEBDRIVER_WEBDRIVER_UTIL_H_
 #pragma once
 
 #include <string>
 #include <vector>
 
 #include "base/basictypes.h"
 #include "base/compiler_specific.h"
 #include "base/values.h"
 #include "chrome/test/automation/value_conversion_traits.h"
 #include "chrome/test/webdriver/webdriver_error.h"
 
 class AutomationId;
 class FilePath;
 class WebViewId;
 
 namespace webdriver {
 
 // Generates a random, 32-character hexidecimal ID.
 std::string GenerateRandomID();
 
+// Decodes the given base64-encoded string, after removing any newlines,
+// which are required in some base64 standards.
+// Returns true on success.
+bool Base64Decode(const std::string& base64, std::string* bytes);
+
+// Unzip the given zip archive, after base64 decoding, into the given directory.
+// Returns true on success.
+bool Base64DecodeAndUnzip(const FilePath& unzip_dir,
+                          const std::string& base64,
+                          std::string* error_msg);
+
+// Unzips the sole file contained in the given zip data |bytes| into
+// |unzip_dir|. The zip data may be a normal zip archive or a single zip file
+// entry. If the unzip successfully produced one file, returns true and sets
+// |file| to the unzipped file.
+// TODO(kkania): Remove the ability to parse single zip file entries when
+// the current versions of all WebDriver clients send actual zip files.
+bool UnzipSoleFile(const FilePath& unzip_dir,
+                   const std::string& bytes,
+                   FilePath* file,
+                   std::string* error_msg);
+
 // Returns the equivalent JSON string for the given value.
 std::string JsonStringify(const base::Value* value);
 
 // Returns the JSON string for the given value, with the exception that
 // long strings are shortened for easier display.
 std::string JsonStringifyForDisplay(const base::Value* value);
 
 // Returns the string representation of the given type, for display purposes.
 const char* GetJsonTypeName(base::Value::Type type);
 
@@ skipping 64 matching lines @@
 
 // Value conversion traits for SkipParsing, which just return true.
 template <>
 struct ValueConversionTraits<webdriver::SkipParsing> {
   static bool SetFromValue(const base::Value* value,
                            const webdriver::SkipParsing* t);
   static bool CanConvert(const base::Value* value);
 };
 
 #endif  // CHROME_TEST_WEBDRIVER_WEBDRIVER_UTIL_H_