[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;

[alex clarke (OOO till 29th), 2015/11/19 18:17:54]

Is the idea that inside of the closure passed to Run() we'd call
HeadlessBrowser::Get()->CreateWebContents()?

If so it might make sense to sketch this out in the comment block below.

[altimin, 2015/11/19 18:36:24]

That's one of the uses, yes, but it's not the only one.
For example, in the scenario when we will want to load several web pages in
order, we will end calling CreateWebContents() from
Observer::OnDocumentLoadCompleted().
  

+
+  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) = 0;
+
+  // Requests browser to stop as soon as possible.
+  virtual void Stop() = 0;
+
+ protected:
+  virtual ~HeadlessBrowser() {}
+};
+
+}  // namespace headless
+
+#endif  // HEADLESS_PUBLIC_HEADLESS_BROWSER_H_