import collections
import re
import sys
from webkit import parser
from webkit.model import BUILTIN_ATTRIBUTE, ASYNC_ATTRIBUTE, SYNCHRONOUS_ATTRIBUTE
_license_header = """/*
* Copyright (C) 2010-2021 Apple Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS BE LIABLE FOR
* ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
"""
WANTS_CONNECTION_ATTRIBUTE = 'WantsConnection'
WANTS_DISPATCH_MESSAGE_ATTRIBUTE = 'WantsDispatchMessage'
WANTS_ASYNC_DISPATCH_MESSAGE_ATTRIBUTE = 'WantsAsyncDispatchMessage'
LEGACY_RECEIVER_ATTRIBUTE = 'LegacyReceiver'
NOT_REFCOUNTED_RECEIVER_ATTRIBUTE = 'NotRefCounted'
def receiver_enumerator_order_key(receiver_name):
if receiver_name == 'IPC':
return 1
elif receiver_name == 'AsyncReply':
return 2
return 0
class MessageEnumerator(object):
def __init__(self, receiver, messages):
self.receiver = receiver
self.messages = messages
def __str__(self):
if self.messages[0].has_attribute(BUILTIN_ATTRIBUTE):
return self.messages[0].name
if self.receiver.name == 'AsyncReply':
return self.messages[0].name
return '%s_%s' % (self.receiver.name, self.messages[0].name)
@classmethod
def sort_key(cls, obj):
return obj.messages[0].has_attribute(SYNCHRONOUS_ATTRIBUTE), receiver_enumerator_order_key(obj.receiver.name), str(obj)
def get_message_enumerators(receivers):
enumerators = []
for receiver in receivers:
receiver_enumerators = {}
for message in receiver.messages:
if message.name not in receiver_enumerators:
receiver_enumerators[message.name] = MessageEnumerator(receiver, messages=[message])
else:
receiver_enumerators[message.name].messages.append(message)
enumerators += receiver_enumerators.values()
assert(len(enumerators) == len(set(enumerators)))
return sorted(enumerators, key=MessageEnumerator.sort_key)
def get_receiver_enumerators(receivers):
return sorted((r.name for r in receivers), key=lambda n: (receiver_enumerator_order_key(n), n))
def messages_header_filename(receiver):
return '%sMessages.h' % receiver.name
def surround_in_condition(string, condition):
if not condition:
return string
return '#if %s\n%s#endif\n' % (condition, string)
def function_parameter_type(type, kind):
builtin_types = frozenset([
'bool',
'float',
'double',
'uint8_t',
'uint16_t',
'uint32_t',
'uint64_t',
'int8_t',
'int16_t',
'int32_t',
'int64_t',
])
if type in builtin_types:
return type
if kind.startswith('enum:'):
return type
return 'const %s&' % type
def reply_parameter_type(type):
return '%s&' % type
def move_type(type):
return '%s&&' % type
def arguments_type(message):
return 'std::tuple<%s>' % ', '.join(function_parameter_type(parameter.type, parameter.kind) for parameter in message.parameters)
def reply_type(message):
return 'std::tuple<%s>' % (', '.join(reply_parameter_type(parameter.type) for parameter in message.reply_parameters))
def reply_arguments_type(message):
return 'std::tuple<%s>' % (', '.join(parameter.type for parameter in message.reply_parameters))
def message_to_reply_forward_declaration(message):
result = []
if message.reply_parameters != None and (message.has_attribute(SYNCHRONOUS_ATTRIBUTE) or message.has_attribute(ASYNC_ATTRIBUTE)):
send_parameters = [(function_parameter_type(x.type, x.kind), x.name) for x in message.reply_parameters]
completion_handler_parameters = '%s' % ', '.join([' '.join(x) for x in send_parameters])
if message.has_attribute(ASYNC_ATTRIBUTE):
result.append('using %sAsyncReply' % message.name)
else:
result.append('using %sDelayedReply' % message.name)
result.append(' = CompletionHandler<void(%s)>;\n' % completion_handler_parameters)
if not result:
return None
return surround_in_condition(''.join(result), message.condition)
def message_to_struct_declaration(receiver, message):
result = []
function_parameters = [(function_parameter_type(x.type, x.kind), x.name) for x in message.parameters]
result.append('class %s {\n' % message.name)
result.append('public:\n')
result.append(' using Arguments = %s;\n' % arguments_type(message))
result.append('\n')
result.append(' static IPC::MessageName name() { return IPC::MessageName::%s_%s; }\n' % (receiver.name, message.name))
result.append(' static const bool isSync = %s;\n' % ('false', 'true')[message.reply_parameters != None and not message.has_attribute(ASYNC_ATTRIBUTE)])
result.append('\n')
if message.reply_parameters != None:
send_parameters = [(function_parameter_type(x.type, x.kind), x.name) for x in message.reply_parameters]
completion_handler_parameters = '%s' % ', '.join([' '.join(x) for x in send_parameters])
if message.has_attribute(ASYNC_ATTRIBUTE):
move_parameters = ', '.join([move_type(x.type) for x in message.reply_parameters])
result.append(' static void callReply(IPC::Decoder&, CompletionHandler<void(%s)>&&);\n' % move_parameters)
result.append(' static void cancelReply(CompletionHandler<void(%s)>&&);\n' % move_parameters)
result.append(' static IPC::MessageName asyncMessageReplyName() { return IPC::MessageName::%s_%sReply; }\n' % (receiver.name, message.name))
result.append(' using AsyncReply = %sAsyncReply;\n' % message.name)
elif message.has_attribute(SYNCHRONOUS_ATTRIBUTE):
result.append(' using DelayedReply = %sDelayedReply;\n' % message.name)
if message.has_attribute(SYNCHRONOUS_ATTRIBUTE) or message.has_attribute(ASYNC_ATTRIBUTE):
result.append(' static void send(std::unique_ptr<IPC::Encoder>&&, IPC::Connection&')
if len(send_parameters):
result.append(', %s' % completion_handler_parameters)
result.append(');\n')
result.append(' using Reply = %s;\n' % reply_type(message))
result.append(' using ReplyArguments = %s;\n' % reply_arguments_type(message))
if len(function_parameters):
result.append(' %s%s(%s)' % (len(function_parameters) == 1 and 'explicit ' or '', message.name, ', '.join([' '.join(x) for x in function_parameters])))
result.append('\n : m_arguments(%s)\n' % ', '.join([x[1] for x in function_parameters]))
result.append(' {\n')
result.append(' }\n\n')
result.append(' const Arguments& arguments() const\n')
result.append(' {\n')
result.append(' return m_arguments;\n')
result.append(' }\n')
result.append('\n')
result.append('private:\n')
result.append(' Arguments m_arguments;\n')
result.append('};\n')
return surround_in_condition(''.join(result), message.condition)
def forward_declaration(namespace, kind_and_type):
kind, type = kind_and_type
qualified_name = '%s::%s' % (namespace, type)
if kind == 'struct':
return 'struct %s' % type
elif kind.startswith('enum:'):
return 'enum class %s : %s' % (type, kind[5:])
else:
return 'class %s' % type
def forward_declarations_for_namespace(namespace, kind_and_types):
result = []
result.append('namespace %s {\n' % namespace)
result += ['%s;\n' % forward_declaration(namespace, x) for x in sorted(kind_and_types)]
result.append('}\n')
return ''.join(result)
def types_that_cannot_be_forward_declared():
return frozenset([
'IPC::DataReference',
'IPC::FontReference',
'MachSendRight',
'MediaTime',
'String',
'WebCore::ColorSpace',
'WebCore::DictationContext',
'WebCore::DisplayList::FlushIdentifier',
'WebCore::DisplayList::ItemBufferIdentifier',
'WebCore::DragApplicationFlags',
'WebCore::DocumentIdentifier',
'WebCore::DocumentOrWorkerIdentifier',
'WebCore::FetchIdentifier',
'WebCore::FrameIdentifier',
'WebCore::GraphicsContextGLAttributes',
'WebCore::LibWebRTCSocketIdentifier',
'WebCore::PlaybackTargetClientContextIdentifier',
'WebCore::MediaPlayerIdentifier',
'WebCore::MediaSessionIdentifier',
'WebCore::NativeImageReference',
'WebCore::PageIdentifier',
'WebCore::PluginLoadClientPolicy',
'WebCore::PointerID',
'WebCore::ProcessIdentifier',
'WebCore::RealtimeMediaSourceIdentifier',
'WebCore::RenderingResourceIdentifier',
'WebCore::RenderingMode',
'WebCore::ServiceWorkerIdentifier',
'WebCore::ServiceWorkerJobIdentifier',
'WebCore::ServiceWorkerOrClientData',
'WebCore::ServiceWorkerOrClientIdentifier',
'WebCore::ServiceWorkerRegistrationIdentifier',
'WebCore::SharedStringHash',
'WebCore::SleepDisablerIdentifier',
'WebCore::SourceBufferAppendMode',
'WebCore::SpeechRecognitionConnectionClientIdentifier',
'WebCore::SWServerConnectionIdentifier',
'WebCore::WebSocketIdentifier',
'WebKit::ActivityStateChangeID',
'WebKit::AudioMediaStreamTrackRendererIdentifier',
'WebKit::ContentWorldIdentifier',
'WebKit::DisplayLinkObserverID',
'WebKit::DownloadID',
'WebKit::GeolocationIdentifier',
'WebKit::GraphicsContextGLIdentifier',
'WebKit::ImageBufferBackendHandle',
'WebKit::LayerHostingContextID',
'WebKit::LegacyCustomProtocolID',
'WebKit::LibWebRTCResolverIdentifier',
'WebKit::MDNSRegisterIdentifier',
'WebKit::MediaRecorderIdentifier',
'WebKit::PDFPluginIdentifier',
'WebKit::PlaybackSessionContextIdentifier',
'WebKit::RemoteAudioDestinationIdentifier',
'WebKit::RemoteAudioSessionIdentifier',
'WebKit::RemoteCDMIdentifier',
'WebKit::RemoteCDMInstanceIdentifier',
'WebKit::RemoteCDMInstanceSessionIdentifier',
'WebKit::RemoteLegacyCDMIdentifier',
'WebKit::RemoteLegacyCDMSessionIdentifier',
'WebKit::RemoteMediaResourceIdentifier',
'WebKit::RemoteMediaSourceIdentifier',
'WebKit::RemoteSourceBufferIdentifier',
'WebKit::RenderingBackendIdentifier',
'WebKit::RTCDecoderIdentifier',
'WebKit::RTCEncoderIdentifier',
'WebKit::SampleBufferDisplayLayerIdentifier',
'WebKit::StorageAreaIdentifier',
'WebKit::StorageAreaImplIdentifier',
'WebKit::StorageNamespaceIdentifier',
'WebKit::TrackPrivateRemoteIdentifier',
'WebKit::TransactionID',
'WebKit::UserContentControllerIdentifier',
'WebKit::WebPageProxyIdentifier',
])
def conditions_for_header(header):
conditions = {
'"InputMethodState.h"': ["PLATFORM(GTK)", "PLATFORM(WPE)"],
'"LayerHostingContext.h"': ["PLATFORM(COCOA)", ],
'"GestureTypes.h"': ["PLATFORM(IOS_FAMILY)"],
}
if not header in conditions:
return None
return conditions[header]
def forward_declarations_and_headers(receiver):
types_by_namespace = collections.defaultdict(set)
headers = set([
'"ArgumentCoders.h"',
'"Connection.h"',
'"MessageNames.h"',
'<wtf/Forward.h>',
'<wtf/ThreadSafeRefCounted.h>',
'"%sMessagesReplies.h"' % receiver.name,
])
non_template_wtf_types = frozenset([
'MachSendRight',
'MediaType',
'String',
])
no_forward_declaration_types = types_that_cannot_be_forward_declared()
for parameter in receiver.iterparameters():
kind = parameter.kind
type = parameter.type
if type.find('<') != -1 or type in no_forward_declaration_types:
headers.update(headers_for_type(type))
continue
split = type.split('::')
if split[0] in non_template_wtf_types:
split.insert(0, 'WTF')
if len(split) == 2:
namespace = split[0]
inner_type = split[1]
types_by_namespace[namespace].add((kind, inner_type))
elif len(split) > 2:
headers.update(headers_for_type(type))
forward_declarations = '\n'.join([forward_declarations_for_namespace(namespace, types) for (namespace, types) in sorted(types_by_namespace.items())])
header_includes = []
for header in sorted(headers):
conditions = conditions_for_header(header)
if conditions and not None in conditions:
header_include = '#if %s\n' % ' || '.join(sorted(set(conditions)))
header_include += '#include %s\n' % header
header_include += '#endif\n'
header_includes.append(header_include)
else:
header_includes.append('#include %s\n' % header)
return (forward_declarations, header_includes)
def forward_declarations_and_headers_for_replies(receiver):
types_by_namespace = collections.defaultdict(set)
headers = set([
'<wtf/Forward.h>',
'"MessageNames.h"',
])
non_template_wtf_types = frozenset([
'MachSendRight',
'MediaTime',
'String',
])
no_forward_declaration_types = types_that_cannot_be_forward_declared()
for message in receiver.messages:
if message.reply_parameters == None or not (message.has_attribute(SYNCHRONOUS_ATTRIBUTE) or message.has_attribute(ASYNC_ATTRIBUTE)):
continue
for parameter in message.reply_parameters:
kind = parameter.kind
type = parameter.type
if type.find('<') != -1 or type in no_forward_declaration_types:
headers.update(headers_for_type(type))
continue
split = type.split('::')
if split[0] in non_template_wtf_types:
split.insert(0, 'WTF')
if len(split) == 2:
namespace = split[0]
inner_type = split[1]
types_by_namespace[namespace].add((kind, inner_type))
elif len(split) > 2:
headers.update(headers_for_type(type))
forward_declarations = '\n'.join([forward_declarations_for_namespace(namespace, types) for (namespace, types) in sorted(types_by_namespace.items())])
header_includes = []
for header in sorted(headers):
conditions = conditions_for_header(header)
if conditions and not None in conditions:
header_include = '#if %s\n' % ' || '.join(sorted(set(conditions)))
header_include += '#include %s\n' % header
header_include += '#endif\n'
header_includes.append(header_include)
else:
header_includes.append('#include %s\n' % header)
return (forward_declarations, header_includes)
def generate_messages_reply_header(receiver):
result = []
result.append(_license_header)
result.append('#pragma once\n')
result.append('\n')
if receiver.condition:
result.append('#if %s\n\n' % receiver.condition)
forward_declarations, headers = forward_declarations_and_headers_for_replies(receiver)
result += headers
result.append('\n')
result.append(forward_declarations)
result.append('\n')
result.append('namespace Messages {\nnamespace %s {\n' % receiver.name)
result.append('\n')
result.append('\n'.join(filter(None, [message_to_reply_forward_declaration(x) for x in receiver.messages])))
result.append('\n')
result.append('} // namespace %s\n} // namespace Messages\n' % receiver.name)
if receiver.condition:
result.append('\n#endif // %s\n' % receiver.condition)
return ''.join(result)
def generate_messages_header(receiver):
result = []
result.append(_license_header)
result.append('#pragma once\n')
result.append('\n')
if receiver.condition:
result.append('#if %s\n\n' % receiver.condition)
forward_declarations, headers = forward_declarations_and_headers(receiver)
result += headers
result.append('\n')
result.append(forward_declarations)
result.append('\n')
result.append('namespace Messages {\nnamespace %s {\n' % receiver.name)
result.append('\n')
result.append('static inline IPC::ReceiverName messageReceiverName()\n')
result.append('{\n')
result.append(' return IPC::ReceiverName::%s;\n' % receiver.name)
result.append('}\n')
result.append('\n')
result.append('\n'.join([message_to_struct_declaration(receiver, x) for x in receiver.messages]))
result.append('\n')
result.append('} // namespace %s\n} // namespace Messages\n' % receiver.name)
if receiver.condition:
result.append('\n#endif // %s\n' % receiver.condition)
return ''.join(result)
def handler_function(receiver, message):
if message.name.find('URL') == 0:
return '%s::%s' % (receiver.name, 'url' + message.name[3:])
return '%s::%s' % (receiver.name, message.name[0].lower() + message.name[1:])
def async_message_statement(receiver, message):
dispatch_function_args = ['decoder', 'this', '&%s' % handler_function(receiver, message)]
dispatch_function = 'handleMessage'
if message.has_attribute(ASYNC_ATTRIBUTE):
dispatch_function += 'Async'
dispatch_function_args.insert(0, 'connection')
if message.has_attribute(WANTS_CONNECTION_ATTRIBUTE):
if message.has_attribute(ASYNC_ATTRIBUTE):
dispatch_function += 'WantsConnection'
else:
dispatch_function_args.insert(0, 'connection')
result = []
result.append(' if (decoder.messageName() == Messages::%s::%s::name()) {\n' % (receiver.name, message.name))
result.append(' IPC::%s<Messages::%s::%s>(%s);\n' % (dispatch_function, receiver.name, message.name, ', '.join(dispatch_function_args)))
result.append(' return;\n')
result.append(' }\n')
return surround_in_condition(''.join(result), message.condition)
def sync_message_statement(receiver, message):
dispatch_function = 'handleMessage'
if message.has_attribute(SYNCHRONOUS_ATTRIBUTE):
dispatch_function += 'Synchronous'
if message.has_attribute(WANTS_CONNECTION_ATTRIBUTE):
dispatch_function += 'WantsConnection'
if message.has_attribute(ASYNC_ATTRIBUTE):
dispatch_function += 'Async'
wants_connection = message.has_attribute(SYNCHRONOUS_ATTRIBUTE) or message.has_attribute(WANTS_CONNECTION_ATTRIBUTE)
result = []
result.append(' if (decoder.messageName() == Messages::%s::%s::name()) {\n' % (receiver.name, message.name))
result.append(' IPC::%s<Messages::%s::%s>(%sdecoder, %sreplyEncoder, this, &%s);\n' % (dispatch_function, receiver.name, message.name, 'connection, ' if wants_connection else '', '' if message.has_attribute(SYNCHRONOUS_ATTRIBUTE) or message.has_attribute(ASYNC_ATTRIBUTE) else '*', handler_function(receiver, message)))
result.append(' return;\n')
result.append(' }\n')
return surround_in_condition(''.join(result), message.condition)
def class_template_headers(template_string):
template_string = template_string.strip()
class_template_types = {
'WebCore::RectEdges': {'headers': ['<WebCore/RectEdges.h>'], 'argument_coder_headers': ['"ArgumentCoders.h"']},
'Expected': {'headers': ['<wtf/Expected.h>'], 'argument_coder_headers': ['"ArgumentCoders.h"']},
'HashMap': {'headers': ['<wtf/HashMap.h>'], 'argument_coder_headers': ['"ArgumentCoders.h"']},
'HashSet': {'headers': ['<wtf/HashSet.h>'], 'argument_coder_headers': ['"ArgumentCoders.h"']},
'Optional': {'headers': ['<wtf/Optional.h>'], 'argument_coder_headers': ['"ArgumentCoders.h"']},
'OptionSet': {'headers': ['<wtf/OptionSet.h>'], 'argument_coder_headers': ['"ArgumentCoders.h"']},
'Vector': {'headers': ['<wtf/Vector.h>'], 'argument_coder_headers': ['"ArgumentCoders.h"']},
'std::pair': {'headers': ['<utility>'], 'argument_coder_headers': ['"ArgumentCoders.h"']},
'IPC::ArrayReference': {'headers': ['"ArrayReference.h"'], 'argument_coder_headers': ['"ArgumentCoders.h"']},
}
match = re.match('(?P<template_name>.+?)<(?P<parameter_string>.+)>', template_string)
if not match:
return {'header_infos': [], 'types': [template_string]}
template_name = match.groupdict()['template_name']
if template_name not in class_template_types:
sys.stderr.write("Error: no class template type is defined for '%s'\n" % (template_string))
sys.exit(1)
header_infos = [class_template_types[template_name]]
types = []
for parameter in parser.split_parameters_string(match.groupdict()['parameter_string']):
parameter_header_infos_and_types = class_template_headers(parameter)
header_infos += parameter_header_infos_and_types['header_infos']
types += parameter_header_infos_and_types['types']
return {'header_infos': header_infos, 'types': types}
def argument_coder_headers_for_type(type):
header_infos_and_types = class_template_headers(type)
special_cases = {
'String': '"ArgumentCoders.h"',
'WebKit::ScriptMessageHandlerHandle': '"WebScriptMessageHandler.h"',
}
headers = []
for header_info in header_infos_and_types['header_infos']:
headers += header_info['argument_coder_headers']
for type in header_infos_and_types['types']:
if type in special_cases:
headers.append(special_cases[type])
continue
split = type.split('::')
if len(split) < 2:
continue
if split[0] == 'WebCore':
headers.append('"WebCoreArgumentCoders.h"')
return headers
def headers_for_type(type):
header_infos_and_types = class_template_headers(type)
special_cases = {
'MachSendRight': ['<wtf/MachSendRight.h>'],
'JSC::MessageLevel': ['<JavaScriptCore/ConsoleTypes.h>'],
'JSC::MessageSource': ['<JavaScriptCore/ConsoleTypes.h>'],
'Inspector::InspectorTargetType': ['<JavaScriptCore/InspectorTarget.h>'],
'Inspector::FrontendChannel::ConnectionType': ['<JavaScriptCore/InspectorFrontendChannel.h>'],
'WebCore::DisplayList::FlushIdentifier': ['<WebCore/DisplayList.h>'],
'WebCore::DisplayList::ItemBufferIdentifier': ['<WebCore/DisplayList.h>'],
'MediaTime': ['<wtf/MediaTime.h>'],
'MonotonicTime': ['<wtf/MonotonicTime.h>'],
'Seconds': ['<wtf/Seconds.h>'],
'WallTime': ['<wtf/WallTime.h>'],
'String': ['<wtf/text/WTFString.h>'],
'PAL::SessionID': ['<pal/SessionID.h>'],
'WebCore::AutoplayEventFlags': ['<WebCore/AutoplayEvent.h>'],
'WebCore::DOMPasteAccessResponse': ['<WebCore/DOMPasteAccess.h>'],
'WebCore::DocumentOrWorkerIdentifier': ['<WebCore/ServiceWorkerTypes.h>'],
'WebCore::DragApplicationFlags': ['<WebCore/DragData.h>'],
'WebCore::DragHandlingMethod': ['<WebCore/DragActions.h>'],
'WebCore::DragOperation': ['<WebCore/DragActions.h>'],
'WebCore::DragSourceAction': ['<WebCore/DragActions.h>'],
'WebCore::ExceptionDetails': ['<WebCore/JSDOMExceptionHandling.h>'],
'WebCore::FileChooserSettings': ['<WebCore/FileChooser.h>'],
'WebCore::ShareDataWithParsedURL': ['<WebCore/ShareData.h>'],
'WebCore::FontChanges': ['<WebCore/FontAttributeChanges.h>'],
'WebCore::FrameLoadType': ['<WebCore/FrameLoaderTypes.h>'],
'WebCore::EventMakesGamepadsVisible': ['<WebCore/GamepadProviderClient.h>'],
'WebCore::GenericCueData': ['<WebCore/InbandGenericCue.h>'],
'WebCore::GrammarDetail': ['<WebCore/TextCheckerClient.h>'],
'WebCore::HasInsecureContent': ['<WebCore/FrameLoaderTypes.h>'],
'WebCore::IncludeSecureCookies': ['<WebCore/CookieJar.h>'],
'WebCore::IndexedDB::ObjectStoreOverwriteMode': ['<WebCore/IndexedDB.h>'],
'WebCore::InputMode': ['<WebCore/InputMode.h>'],
'WebCore::InspectorOverlay::Highlight': ['<WebCore/InspectorOverlay.h>'],
'WebCore::KeyframeValueList': ['<WebCore/GraphicsLayer.h>'],
'WebCore::KeypressCommand': ['<WebCore/KeyboardEvent.h>'],
'WebCore::LegacyCDMSessionClient::MediaKeyErrorCode': ['<WebCore/LegacyCDMSession.h>'],
'WebCore::LockBackForwardList': ['<WebCore/FrameLoaderTypes.h>'],
'WebCore::MessagePortChannelProvider::HasActivity': ['<WebCore/MessagePortChannelProvider.h>'],
'WebCore::MouseEventPolicy': ['<WebCore/DocumentLoader.h>'],
'WebCore::NetworkTransactionInformation': ['<WebCore/NetworkLoadInformation.h>'],
'WebCore::PasteboardCustomData': ['<WebCore/Pasteboard.h>'],
'WebCore::PasteboardImage': ['<WebCore/Pasteboard.h>'],
'WebCore::PasteboardURL': ['<WebCore/Pasteboard.h>'],
'WebCore::PasteboardWebContent': ['<WebCore/Pasteboard.h>'],
'WebCore::PaymentAuthorizationResult': ['<WebCore/ApplePaySessionPaymentRequest.h>'],
'WebCore::PixelFormat': ['<WebCore/ImageBufferBackend.h>'],
'WebCore::PlatformTextTrackData': ['<WebCore/PlatformTextTrack.h>'],
'WebCore::PluginInfo': ['<WebCore/PluginData.h>'],
'WebCore::PluginLoadClientPolicy': ['<WebCore/PluginData.h>'],
'WebCore::PolicyAction': ['<WebCore/FrameLoaderTypes.h>'],
'WebCore::PreserveResolution': ['<WebCore/ImageBufferBackend.h>'],
'WebCore::ShouldContinuePolicyCheck': ['<WebCore/FrameLoaderTypes.h>'],
'WebCore::PolicyCheckIdentifier': ['<WebCore/FrameLoaderTypes.h>'],
'WebCore::ProcessIdentifier': ['<WebCore/ProcessIdentifier.h>'],
'WebCore::RecentSearch': ['<WebCore/SearchPopupMenu.h>'],
'WebCore::RequestStorageAccessResult': ['<WebCore/DocumentStorageAccess.h>'],
'WebCore::RouteSharingPolicy': ['<WebCore/AudioSession.h>'],
'WebCore::SWServerConnectionIdentifier': ['<WebCore/ServiceWorkerTypes.h>'],
'WebCore::SelectionDirection': ['<WebCore/VisibleSelection.h>'],
'WebCore::ServiceWorkerJobIdentifier': ['<WebCore/ServiceWorkerTypes.h>'],
'WebCore::ServiceWorkerOrClientData': ['<WebCore/ServiceWorkerTypes.h>', '<WebCore/ServiceWorkerClientData.h>', '<WebCore/ServiceWorkerData.h>'],
'WebCore::ServiceWorkerOrClientIdentifier': ['<WebCore/ServiceWorkerTypes.h>', '<WebCore/ServiceWorkerClientIdentifier.h>'],
'WebCore::ServiceWorkerRegistrationIdentifier': ['<WebCore/ServiceWorkerTypes.h>'],
'WebCore::ServiceWorkerRegistrationState': ['<WebCore/ServiceWorkerTypes.h>'],
'WebCore::ServiceWorkerState': ['<WebCore/ServiceWorkerTypes.h>'],
'WebCore::ShippingContactUpdate': ['<WebCore/ApplePaySessionPaymentRequest.h>'],
'WebCore::ShippingMethodUpdate': ['<WebCore/ApplePaySessionPaymentRequest.h>'],
'WebCore::ShouldAskITP': ['<WebCore/NetworkStorageSession.h>'],
'WebCore::ShouldNotifyWhenResolved': ['<WebCore/ServiceWorkerTypes.h>'],
'WebCore::ShouldSample': ['<WebCore/DiagnosticLoggingClient.h>'],
'WebCore::SourceBufferAppendMode': ['<WebCore/SourceBufferPrivate.h>'],
'WebCore::StorageAccessPromptWasShown': ['<WebCore/DocumentStorageAccess.h>'],
'WebCore::StorageAccessScope': ['<WebCore/DocumentStorageAccess.h>'],
'WebCore::StorageAccessWasGranted': ['<WebCore/DocumentStorageAccess.h>'],
'WebCore::SupportedPluginIdentifier': ['<WebCore/PluginData.h>'],
'WebCore::SystemPreviewInfo': ['<WebCore/FrameLoaderTypes.h>'],
'WebCore::TextCheckingRequestData': ['<WebCore/TextChecking.h>'],
'WebCore::TextCheckingResult': ['<WebCore/TextCheckerClient.h>'],
'WebCore::TextCheckingType': ['<WebCore/TextChecking.h>'],
'WebCore::TextIndicatorData': ['<WebCore/TextIndicator.h>'],
'WebCore::ThirdPartyCookieBlockingMode': ['<WebCore/NetworkStorageSession.h>'],
'WebCore::SameSiteStrictEnforcementEnabled': ['<WebCore/NetworkStorageSession.h>'],
'WebCore::FirstPartyWebsiteDataRemovalMode': ['<WebCore/NetworkStorageSession.h>'],
'WebCore::UsedLegacyTLS': ['<WebCore/ResourceResponseBase.h>'],
'WebCore::ViewportAttributes': ['<WebCore/ViewportArguments.h>'],
'WebCore::WebGLLoadPolicy': ['<WebCore/FrameLoaderTypes.h>'],
'WebCore::WillContinueLoading': ['<WebCore/FrameLoaderTypes.h>'],
'WebCore::SelectionRect': ['"EditorState.h"'],
'WebKit::ActivityStateChangeID': ['"DrawingAreaInfo.h"'],
'WebKit::AllowOverwrite': ['"DownloadID.h"'],
'WebKit::BackForwardListItemState': ['"SessionState.h"'],
'WebKit::CallDownloadDidStart': ['"DownloadManager.h"'],
'WebKit::ContentWorldIdentifier': ['"ContentWorldShared.h"'],
'WebKit::DocumentEditingContextRequest': ['"DocumentEditingContext.h"'],
'WebKit::FindOptions': ['"WebFindOptions.h"'],
'WebKit::GestureRecognizerState': ['"GestureTypes.h"'],
'WebKit::GestureType': ['"GestureTypes.h"'],
'WebKit::InspectorExtensionError': ['"InspectorExtensionTypes.h"'],
'WebKit::LayerHostingContextID': ['"LayerHostingContext.h"'],
'WebKit::LayerHostingMode': ['"LayerTreeContext.h"'],
'WebKit::PageState': ['"SessionState.h"'],
'WebKit::PaymentSetupConfiguration': ['"PaymentSetupConfigurationWebKit.h"'],
'WebKit::PaymentSetupFeatures': ['"ApplePayPaymentSetupFeaturesWebKit.h"'],
'WebKit::RespectSelectionAnchor': ['"GestureTypes.h"'],
'WebKit::SelectionFlags': ['"GestureTypes.h"'],
'WebKit::SelectionTouch': ['"GestureTypes.h"'],
'WebCore::MediaEngineSupportParameters': ['<WebCore/MediaPlayer.h>'],
'WebCore::ISOWebVTTCue': ['<WebCore/ISOVTTCue.h>'],
'struct WebCore::Cookie': ['<WebCore/Cookie.h>'],
'struct WebCore::ElementContext': ['<WebCore/ElementContext.h>'],
'struct WebKit::WebUserScriptData': ['"WebUserContentControllerDataTypes.h"'],
'struct WebKit::WebUserStyleSheetData': ['"WebUserContentControllerDataTypes.h"'],
'struct WebKit::WebScriptMessageHandlerData': ['"WebUserContentControllerDataTypes.h"'],
'webrtc::WebKitEncodedFrameInfo': ['<webrtc/sdk/WebKit/WebKitEncoder.h>', '<WebCore/LibWebRTCEnumTraits.h>'],
}
headers = []
for header_info in header_infos_and_types['header_infos']:
headers += header_info['headers']
for type in header_infos_and_types['types']:
if type in special_cases:
headers += special_cases[type]
continue
split = type.split('::')
if len(split) < 2:
continue
if split[0] == 'WebKit' or split[0] == 'IPC':
headers.append('"%s.h"' % split[1])
else:
headers.append('<%s/%s.h>' % tuple(split[0:2]))
return headers
def collect_header_conditions_for_receiver(receiver, header_conditions):
type_conditions = {}
for parameter in receiver.iterparameters():
if not parameter.type in type_conditions:
type_conditions[parameter.type] = []
if not parameter.condition in type_conditions[parameter.type]:
type_conditions[parameter.type].append(parameter.condition)
for parameter in receiver.iterparameters():
type = parameter.type
conditions = type_conditions[type]
argument_encoder_headers = argument_coder_headers_for_type(type)
if argument_encoder_headers:
for header in argument_encoder_headers:
if header not in header_conditions:
header_conditions[header] = []
header_conditions[header].extend(conditions)
type_headers = headers_for_type(type)
for header in type_headers:
if header not in header_conditions:
header_conditions[header] = []
header_conditions[header].extend(conditions)
for message in receiver.messages:
if message.reply_parameters is not None:
for reply_parameter in message.reply_parameters:
type = reply_parameter.type
argument_encoder_headers = argument_coder_headers_for_type(type)
if argument_encoder_headers:
for header in argument_encoder_headers:
if header not in header_conditions:
header_conditions[header] = []
header_conditions[header].append(message.condition)
type_headers = headers_for_type(type)
for header in type_headers:
if header not in header_conditions:
header_conditions[header] = []
header_conditions[header].append(message.condition)
return header_conditions
def generate_header_includes_from_conditions(header_conditions):
result = []
for header in sorted(header_conditions):
if header_conditions[header] and not None in header_conditions[header]:
result.append('#if %s\n' % ' || '.join(sorted(set(header_conditions[header]))))
result += ['#include %s\n' % header]
result.append('#endif\n')
else:
result += ['#include %s\n' % header]
return result
def generate_message_handler(receiver):
header_conditions = {
'"%s"' % messages_header_filename(receiver): [None],
'"HandleMessage.h"': [None],
'"Decoder.h"': [None],
}
collect_header_conditions_for_receiver(receiver, header_conditions)
result = []
result.append(_license_header)
result.append('#include "config.h"\n')
if receiver.condition:
result.append('#if %s\n' % receiver.condition)
result.append('#include "%s.h"\n\n' % receiver.name)
result += generate_header_includes_from_conditions(header_conditions)
result.append('\n')
delayed_or_async_messages = []
for message in receiver.messages:
if message.reply_parameters != None and (message.has_attribute(SYNCHRONOUS_ATTRIBUTE) or message.has_attribute(ASYNC_ATTRIBUTE)):
delayed_or_async_messages.append(message)
if delayed_or_async_messages:
result.append('namespace Messages {\n\nnamespace %s {\n\n' % receiver.name)
for message in delayed_or_async_messages:
send_parameters = [(function_parameter_type(x.type, x.kind), x.name) for x in message.reply_parameters]
if message.condition:
result.append('#if %s\n\n' % message.condition)
if message.has_attribute(ASYNC_ATTRIBUTE):
move_parameters = message.name, ', '.join([move_type(x.type) for x in message.reply_parameters])
result.append('void %s::callReply(IPC::Decoder& decoder, CompletionHandler<void(%s)>&& completionHandler)\n{\n' % move_parameters)
for x in message.reply_parameters:
result.append(' Optional<%s> %s;\n' % (x.type, x.name))
result.append(' decoder >> %s;\n' % x.name)
result.append(' if (!%s) {\n ASSERT_NOT_REACHED();\n cancelReply(WTFMove(completionHandler));\n return;\n }\n' % x.name)
result.append(' completionHandler(')
if len(message.reply_parameters):
result.append('WTFMove(*%s)' % ('), WTFMove(*'.join(x.name for x in message.reply_parameters)))
result.append(');\n}\n\n')
result.append('void %s::cancelReply(CompletionHandler<void(%s)>&& completionHandler)\n{\n completionHandler(' % move_parameters)
result.append(', '.join(['IPC::AsyncReplyError<' + x.type + '>::create()' for x in message.reply_parameters]))
result.append(');\n}\n\n')
result.append('void %s::send(std::unique_ptr<IPC::Encoder>&& encoder, IPC::Connection& connection' % (message.name))
if len(send_parameters):
result.append(', %s' % ', '.join([' '.join(x) for x in send_parameters]))
result.append(')\n{\n')
result += [' *encoder << %s;\n' % x.name for x in message.reply_parameters]
result.append(' connection.sendSyncReply(WTFMove(encoder));\n')
result.append('}\n')
result.append('\n')
if message.condition:
result.append('#endif\n\n')
result.append('} // namespace %s\n\n} // namespace Messages\n\n' % receiver.name)
result.append('namespace WebKit {\n\n')
async_messages = []
sync_messages = []
for message in receiver.messages:
if message.reply_parameters is not None and not message.has_attribute(ASYNC_ATTRIBUTE):
sync_messages.append(message)
else:
async_messages.append(message)
if async_messages or receiver.has_attribute(WANTS_DISPATCH_MESSAGE_ATTRIBUTE) or receiver.has_attribute(WANTS_ASYNC_DISPATCH_MESSAGE_ATTRIBUTE):
result.append('void %s::didReceive%sMessage(IPC::Connection& connection, IPC::Decoder& decoder)\n' % (receiver.name, receiver.name if receiver.has_attribute(LEGACY_RECEIVER_ATTRIBUTE) else ''))
result.append('{\n')
if not receiver.has_attribute(NOT_REFCOUNTED_RECEIVER_ATTRIBUTE):
result.append(' auto protectedThis = makeRef(*this);\n')
result += [async_message_statement(receiver, message) for message in async_messages]
if receiver.has_attribute(WANTS_DISPATCH_MESSAGE_ATTRIBUTE) or receiver.has_attribute(WANTS_ASYNC_DISPATCH_MESSAGE_ATTRIBUTE):
result.append(' if (dispatchMessage(connection, decoder))\n')
result.append(' return;\n')
if (receiver.superclass):
result.append(' %s::didReceiveMessage(connection, decoder);\n' % (receiver.superclass))
else:
result.append(' UNUSED_PARAM(connection);\n')
result.append(' UNUSED_PARAM(decoder);\n')
result.append(' ASSERT_NOT_REACHED();\n')
result.append('}\n')
if sync_messages or receiver.has_attribute(WANTS_DISPATCH_MESSAGE_ATTRIBUTE):
result.append('\n')
result.append('void %s::didReceiveSync%sMessage(IPC::Connection& connection, IPC::Decoder& decoder, std::unique_ptr<IPC::Encoder>& replyEncoder)\n' % (receiver.name, receiver.name if receiver.has_attribute(LEGACY_RECEIVER_ATTRIBUTE) else ''))
result.append('{\n')
if not receiver.has_attribute(NOT_REFCOUNTED_RECEIVER_ATTRIBUTE):
result.append(' auto protectedThis = makeRef(*this);\n')
result += [sync_message_statement(receiver, message) for message in sync_messages]
if receiver.has_attribute(WANTS_DISPATCH_MESSAGE_ATTRIBUTE):
result.append(' if (dispatchSyncMessage(connection, decoder, replyEncoder))\n')
result.append(' return;\n')
result.append(' UNUSED_PARAM(connection);\n')
result.append(' UNUSED_PARAM(decoder);\n')
result.append(' UNUSED_PARAM(replyEncoder);\n')
result.append(' ASSERT_NOT_REACHED();\n')
result.append('}\n')
result.append('\n} // namespace WebKit\n')
if receiver.condition:
result.append('\n#endif // %s\n' % receiver.condition)
return ''.join(result)
def generate_message_names_header(receivers):
result = []
result.append(_license_header)
result.append('#pragma once\n')
result.append('\n')
result.append('#include <wtf/EnumTraits.h>\n')
result.append('\n')
result.append('namespace IPC {\n')
result.append('\n')
result.append('enum class ReceiverName : uint8_t {')
result.append('\n ')
enums = ['%s = %d' % (e, v) for v, e in enumerate(get_receiver_enumerators(receivers), 1)]
result.append('\n , '.join(enums))
result.append('\n , Invalid = %d' % (len(enums) + 1))
result.append('\n};\n')
result.append('\n')
message_enumerators = get_message_enumerators(receivers)
result.append('enum class MessageName : uint16_t {')
result.append('\n ')
result.append('\n , '.join(str(e) for e in message_enumerators))
result.append('\n , Last = %s' % message_enumerators[-1])
result.append('\n};\n')
result.append('\n')
result.append('ReceiverName receiverName(MessageName);\n')
result.append('const char* description(MessageName);\n')
result.append('bool isValidMessageName(MessageName);\n')
result.append('constexpr bool messageIsSync(MessageName name)\n')
result.append('{\n')
first_synchronous = next((e for e in message_enumerators if e.messages[0].has_attribute(SYNCHRONOUS_ATTRIBUTE)), None)
if first_synchronous:
result.append(' return name >= MessageName::%s;\n' % first_synchronous)
else:
result.append(' UNUSED_PARAM(name);\n')
result.append(' return false;\n')
result.append('}\n')
result.append('\n')
result.append('} // namespace IPC\n')
result.append('\n')
result.append('namespace WTF {\n')
result.append('\n')
result.append('template<>\n')
result.append('struct EnumTraits<IPC::MessageName> {\n')
result.append(' template<typename T>\n')
result.append(' static std::enable_if_t<sizeof(T) == sizeof(IPC::MessageName) && std::is_unsigned_v<T>, bool> isValidEnum(T messageName)\n')
result.append(' {\n')
result.append(' if (messageName > WTF::enumToUnderlyingType(IPC::MessageName::Last))\n')
result.append(' return false;\n')
result.append(' return IPC::isValidMessageName(static_cast<IPC::MessageName>(messageName));\n')
result.append(' }\n')
result.append('};\n')
result.append('\n')
result.append('} // namespace WTF\n')
return ''.join(result)
def generate_message_names_implementation(receivers):
result = []
result.append(_license_header)
result.append('#include "config.h"\n')
result.append('#include "MessageNames.h"\n')
result.append('\n')
result.append('namespace IPC {\n')
result.append('\n')
result.append('const char* description(MessageName name)\n')
result.append('{\n')
result.append(' switch (name) {\n')
message_enumerators = get_message_enumerators(receivers)
for enumerator in message_enumerators:
result.append(' case MessageName::%s:\n' % enumerator)
result.append(' return "%s";\n' % enumerator)
result.append(' }\n')
result.append(' ASSERT_NOT_REACHED();\n')
result.append(' return "<invalid message name>";\n')
result.append('}\n')
result.append('\n')
result.append('ReceiverName receiverName(MessageName messageName)\n')
result.append('{\n')
result.append(' switch (messageName) {\n')
prev_enumerator = None
for enumerator in message_enumerators:
if prev_enumerator and prev_enumerator.receiver != enumerator.receiver:
result.append(' return ReceiverName::%s;\n' % prev_enumerator.receiver.name)
result.append(' case MessageName::%s:\n' % enumerator)
prev_enumerator = enumerator
if prev_enumerator:
result.append(' return ReceiverName::%s;\n' % prev_enumerator.receiver.name)
result.append(' }\n')
result.append(' ASSERT_NOT_REACHED();\n')
result.append(' return ReceiverName::Invalid;\n')
result.append('}\n')
result.append('\n')
result.append('bool isValidMessageName(MessageName messageName)\n')
result.append('{\n')
for enumerator in message_enumerators:
for message in enumerator.messages:
if message.condition:
result.append('#if %s\n' % message.condition)
result.append(' if (messageName == IPC::MessageName::%s)\n' % enumerator)
result.append(' return true;\n')
if message.condition:
result.append('#endif\n')
result.append(' return false;\n')
result.append('};\n')
result.append('\n')
result.append('} // namespace IPC\n')
return ''.join(result)
def generate_js_value_conversion_function(result, receivers, function_name, argument_type, predicate=lambda message: True):
result.append('Optional<JSC::JSValue> %s(JSC::JSGlobalObject* globalObject, MessageName name, Decoder& decoder)\n' % function_name)
result.append('{\n')
result.append(' switch (name) {\n')
for receiver in receivers:
if receiver.has_attribute(BUILTIN_ATTRIBUTE):
continue
if receiver.condition:
result.append('#if %s\n' % receiver.condition)
previous_message_condition = None
for message in receiver.messages:
if not predicate(message):
continue
if previous_message_condition != message.condition:
if previous_message_condition:
result.append('#endif\n')
if message.condition:
result.append('#if %s\n' % message.condition)
previous_message_condition = message.condition
result.append(' case MessageName::%s_%s:\n' % (receiver.name, message.name))
result.append(' return jsValueForDecodedArguments<Messages::%s::%s::%s>(globalObject, decoder);\n' % (receiver.name, message.name, argument_type))
if previous_message_condition:
result.append('#endif\n')
if receiver.condition:
result.append('#endif\n')
result.append(' default:\n')
result.append(' break;\n')
result.append(' }\n')
result.append(' return WTF::nullopt;\n')
result.append('}\n')
def generate_js_argument_descriptions(receivers, function_name, arguments_from_message):
result = []
result.append('Optional<Vector<ArgumentDescription>> %s(MessageName name)\n' % function_name)
result.append('{\n')
result.append(' switch (name) {\n')
for receiver in receivers:
if receiver.has_attribute(BUILTIN_ATTRIBUTE):
continue
if receiver.condition:
result.append('#if %s\n' % receiver.condition)
previous_message_condition = None
for message in receiver.messages:
if message.has_attribute(BUILTIN_ATTRIBUTE):
continue
argument_list = arguments_from_message(message)
if argument_list is None:
continue
if previous_message_condition != message.condition:
if previous_message_condition:
result.append('#endif\n')
if message.condition:
result.append('#if %s\n' % message.condition)
previous_message_condition = message.condition
result.append(' case MessageName::%s_%s:\n' % (receiver.name, message.name))
if not len(argument_list):
result.append(' return Vector<ArgumentDescription> { };\n')
continue
result.append(' return Vector<ArgumentDescription> {\n')
for argument in argument_list:
argument_type = argument.type
enum_type = None
is_optional = False
if argument.kind.startswith('enum:'):
enum_type = '"%s"' % argument_type
argument_type = argument.kind[5:]
if argument_type.startswith('Optional<') and argument_type.endswith('>'):
argument_type = argument_type[9:-1]
is_optional = True
result.append(' {"%s", "%s", %s, %s},\n' % (argument.name, argument_type, enum_type or 'nullptr', 'true' if is_optional else 'false'))
result.append(' };\n')
if previous_message_condition:
result.append('#endif\n')
if receiver.condition:
result.append('#endif\n')
result.append(' default:\n')
result.append(' break;\n')
result.append(' }\n')
result.append(' return WTF::nullopt;\n')
result.append('}\n')
return result
def generate_message_argument_description_implementation(receivers, receiver_headers):
header_conditions = {
'"JSIPCBinding.h"': [None]
}
for receiver in receivers:
if receiver.has_attribute(BUILTIN_ATTRIBUTE):
continue
header_conditions['"%s"' % messages_header_filename(receiver)] = [None]
collect_header_conditions_for_receiver(receiver, header_conditions)
result = []
result.append(_license_header)
result.append('#include "config.h"\n')
result.append('#include "MessageArgumentDescriptions.h"\n')
result.append('\n')
result.append('#if ENABLE(IPC_TESTING_API)\n')
result.append('\n')
result += generate_header_includes_from_conditions(header_conditions)
result.append('\n')
result.append('namespace IPC {\n')
result.append('\n')
generate_js_value_conversion_function(result, receivers, 'jsValueForArguments', 'Arguments')
result.append('\n')
generate_js_value_conversion_function(result, receivers, 'jsValueForReplyArguments', 'ReplyArguments', lambda message: message.reply_parameters is not None and (message.has_attribute(SYNCHRONOUS_ATTRIBUTE) or message.has_attribute(ASYNC_ATTRIBUTE)))
result.append('\n')
result += generate_js_argument_descriptions(receivers, 'messageArgumentDescriptions', lambda message: message.parameters)
result.append('\n')
result += generate_js_argument_descriptions(receivers, 'messageReplyArgumentDescriptions', lambda message: message.reply_parameters if message.has_attribute(SYNCHRONOUS_ATTRIBUTE) or message.has_attribute(ASYNC_ATTRIBUTE) else None)
result.append('\n')
result.append('} // namespace WebKit\n')
result.append('\n')
result.append('#endif\n')
return ''.join(result)