[headless] Initial skeleton of headless/public/

headless/public/headless_browser.h

+// Copyright 2015 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 HEADLESS_PUBLIC_HEADLESS_BROWSER_H_
+#define HEADLESS_PUBLIC_HEADLESS_BROWSER_H_
+
+#include "base/callback.h"
+#include "base/memory/ref_counted.h"
+#include "base/memory/scoped_ptr.h"
+#include "headless/public/headless_export.h"
+
+namespace base {
+class SingleThreadTaskRunner;
+}
+
+namespace gfx {
+class Size;
+}
+
+namespace headless {
+class WebContents;
+
+class HEADLESS_EXPORT HeadlessBrowser {
+ public:
+  static HeadlessBrowser* Get();
+
+  // Create a new browser tab.
+  virtual scoped_ptr<WebContents> CreateWebContents(const gfx::Size& size) = 0;
+
+  virtual scoped_refptr<base::SingleThreadTaskRunner> browser_main_thread() = 0;
+  virtual scoped_refptr<base::SingleThreadTaskRunner>
+  renderer_main_thread() = 0;
+
+  // Main routine for running browser.
+  // Takes command line args and callback to run as soon as browser starts.
+  // Should be called from main in the following manner:
+  // int main(int argc, const char** argv) {
+  //   return headless::HeadlessBrowser::Get()->Run(
+  //     argc, argv, base::Bind(function_to_be_run_on_browser_start));
+  // }
+  virtual int Run(
+      int argc,
+      const char** argv,
+      const base::Closure& on_browser_start_callback);

[Sami, 2015/11/19 16:24:39]

Pure virtual.

+
+  // Requests browser to stop as soon as possible.
+  virtual void Stop() = 0;
+
+ protected:
+  virtual ~HeadlessBrowser() {}
+};
+
+}  // namespace headless
+
+#endif  // HEADLESS_PUBLIC_HEADLESS_BROWSER_H_