headless: Initial headless embedder API implementation

headless/public/headless_network.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_NETWORK_H_
-#define HEADLESS_PUBLIC_NETWORK_H_
+#ifndef HEADLESS_PUBLIC_HEADLESS_NETWORK_H_
+#define HEADLESS_PUBLIC_HEADLESS_NETWORK_H_
 
 #include <base/macros.h>
 #include <base/memory/ref_counted.h>
 #include <base/memory/scoped_ptr.h>
 
 namespace net {
 class URLRequestContextGetter;
 class ClientSocketFactory;
 class HttpTransactionFactory;
 }
 
 namespace headless {
 
-class Network {
+// Provides helpers for integrating with various types of networking stacks.
+class HeadlessNetwork {
  public:
   static scoped_refptr<net::URLRequestContextGetter>

[pfeldman, 2016/02/09 19:49:51]

I wonder if there is room for the platform API that embedder provides to
headless chrome vs the client API that automation and diverse clients are using.
This clearly is a part of the platform, while OpenURL is clearly a client. And I
think you should use remote debugging approach for the client API - that way you
insulate the caller from the content/ and net/ abstractions, deliver a stable
and maintainable API.

[Sami, 2016/02/09 21:40:51]

I think the client can be isolated from content/ and net/, while the embedder
API might need to touch at least net to provide the level of integration needed.

   CreateURLRequestContextGetterUsingSocketFactory(
       scoped_ptr<net::ClientSocketFactory> socket_factory);
 
   static scoped_refptr<net::URLRequestContextGetter>
   CreateURLRequestContextGetterUsingHttpTransactionFactory(
       scoped_ptr<net::HttpTransactionFactory> http_transaction_factory);
 
  private:
-  Network() = delete;
+  HeadlessNetwork() = delete;
 };
 
 }  // namespace headless
 
-#endif  // HEADLESS_PUBLIC_NETWORK_H_
+#endif  // HEADLESS_PUBLIC_HEADLESS_NETWORK_H_