summaryrefslogtreecommitdiffstats
path: root/ipc/ipdl/test/gtest/IPDLUnitTest.h
blob: a5fb72e2fe20a07c2cb147f553a38e59ef1aee25 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim: set ts=8 sts=2 et sw=2 tw=80: */
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this file,
 * You can obtain one at http://mozilla.org/MPL/2.0/. */

#ifndef mozilla__ipdltest_IPDLUnitTest_h
#define mozilla__ipdltest_IPDLUnitTest_h

#include "mozilla/_ipdltest/IPDLUnitTestChild.h"
#include "mozilla/_ipdltest/IPDLUnitTestParent.h"
#include "mozilla/ipc/ProtocolUtils.h"

namespace mozilla::_ipdltest {

// Should be called from static constructors to register a child actor
// constructor so that it can be called from the child process.
const char* RegisterAllocChildActor(
    const char* aName, mozilla::ipc::IToplevelProtocol* (*aFunc)());

// Internal helper type used to declare IPDL tests.
class IPDLTestHelper {
 public:
  void TestWrapper(bool aCrossProcess);
  virtual const char* GetName() = 0;
  virtual ipc::IToplevelProtocol* GetActor() = 0;
  virtual void TestBody() = 0;
};

#define IPDL_TEST_CLASS_NAME_(actorname) IPDL_TEST_##actorname

#define IPDL_TEST_HEAD_(actorname)                                        \
  class IPDL_TEST_CLASS_NAME_(actorname)                                  \
      : public ::mozilla::_ipdltest::IPDLTestHelper {                     \
   public:                                                                \
    IPDL_TEST_CLASS_NAME_(actorname)() : mActor(new actorname##Parent) {} \
                                                                          \
   private:                                                               \
    void TestBody() override;                                             \
    const char* GetName() override { return sName; };                     \
    actorname##Parent* GetActor() override { return mActor; };            \
                                                                          \
    actorname##Parent* mActor;                                            \
    static const char* sName;                                             \
  };                                                                      \
  const char* IPDL_TEST_CLASS_NAME_(actorname)::sName =                   \
      ::mozilla::_ipdltest::RegisterAllocChildActor(                      \
          #actorname, []() -> ::mozilla::ipc::IToplevelProtocol* {        \
            return new actorname##Child;                                  \
          });

#define IPDL_TEST_DECL_(testgroup, actorname, crossprocess) \
  TEST(testgroup, actorname)                                \
  {                                                         \
    IPDL_TEST_CLASS_NAME_(actorname) test;                  \
    test.TestWrapper(crossprocess);                         \
  }

#define IPDL_TEST_BODY_SEGUE_(actorname) \
  void IPDL_TEST_CLASS_NAME_(actorname)::TestBody()

// Declare a basic IPDL unit test which will be run in both both cross-thread
// and cross-process configurations. The actor `actorname` will be instantiated
// by default-constructing the parent & child actors in the relevant processes,
// and the test block will be executed, with `mActor` being a pointer to the
// parent actor. The test is asynchronous, and will end when the IPDL connection
// between the created actors is destroyed.
//
// GTest assertions fired in the child process will be relayed to the parent
// process, and should generally function correctly.
#define IPDL_TEST(actorname)                              \
  IPDL_TEST_HEAD_(actorname)                              \
  IPDL_TEST_DECL_(IPDLTest_CrossProcess, actorname, true) \
  IPDL_TEST_DECL_(IPDLTest_CrossThread, actorname, false) \
  IPDL_TEST_BODY_SEGUE_(actorname)

}  // namespace mozilla::_ipdltest

#endif  // mozilla__ipdltest_IPDLUnitTest_h