net/test/spawned_test_server/remote_test_server_config.h

// Copyright 2017 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 NET_TEST_SPAWNED_TEST_SERVER_REMOTE_TEST_SERVER_CONFIG_H_
#define NET_TEST_SPAWNED_TEST_SERVER_REMOTE_TEST_SERVER_CONFIG_H_

#include <string>

#include "base/macros.h"
#include "net/base/ip_address.h"

class GURL;

namespace net {

// RemoteTestServerConfig is responsible for loading test server configuration
// from a file. Expected config location depends on platform:
//   - Android: DIR_ANDROID_EXTERNAL_STORAGE/net-test-server-config
//   - Fuchsia: /system/net-test-server-config
//   - other platforms: DIR_TEMP/net-test-server-config
//
// If the config file doesn't exist then the default configuration is used. By
// default the server is started on 127.0.0.1.
//
// If the config file exists then it must be stored in the following format:
//   {
//     'address': '127.0.0.1',
//     'spawner_url_base': 'http://localhost:5000'
//   }
//
// 'spawner_url_base' specifies base URL to connect to the test server spawner
// responsible for starting and stopping test server. Currently spawner is used
// only on Android and Fuchsia. 'address' specifies IP address for the test
// server.
class RemoteTestServerConfig {
 public:
  RemoteTestServerConfig();
  ~RemoteTestServerConfig();

  RemoteTestServerConfig(const RemoteTestServerConfig& other);
  RemoteTestServerConfig& operator=(const RemoteTestServerConfig&);

  // Returns current test server configuration, loading it from a file if the
  // file exists.
  static RemoteTestServerConfig Load();

  // IP address to use used to connect to the testserver.
  const IPAddress& address() const { return address_; }

  // GURL for the test server spawner.
  GURL GetSpawnerUrl(const std::string& command) const;

 private:
  // Defaults that can be overridden with a config file.
  IPAddress address_ = {127, 0, 0, 1};

  std::string spawner_url_base_;
};

}  // namespace net

#endif  // NET_TEST_SPAWNED_TEST_SERVER_REMOTE_TEST_SERVER_CONFIG_H_