e26e60df1f7528975c00f54f7c5cecbe178c5129
[WebKit-https.git] / Source / WTF / Scripts / GeneratePreferences.rb
1 #!/usr/bin/env ruby
2 #
3 # Copyright (c) 2017, 2020 Apple Inc. All rights reserved.
4 #
5 # Redistribution and use in source and binary forms, with or without
6 # modification, are permitted provided that the following conditions
7 # are met:
8 # 1. Redistributions of source code must retain the above copyright
9 #    notice, this list of conditions and the following disclaimer.
10 # 2. Redistributions in binary form must reproduce the above copyright
11 #    notice, this list of conditions and the following disclaimer in the
12 #    documentation and/or other materials provided with the distribution.
13 #
14 # THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS''
15 # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
16 # THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
17 # PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS
18 # BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
19 # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
20 # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
21 # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
22 # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
23 # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
24 # THE POSSIBILITY OF SUCH DAMAGE.
25
26 require "fileutils"
27 require 'erb'
28 require 'optparse'
29 require 'yaml'
30
31 options = {
32   :frontend => nil,
33   :basePreferences => nil,
34   :debugPreferences => nil,
35   :experimentalPreferences => nil,
36   :internalPreferences => nil,
37   :outputDirectory => nil,
38   :templates => []
39 }
40 optparse = OptionParser.new do |opts|
41   opts.banner = "Usage: #{File.basename($0)} --input file"
42
43   opts.separator ""
44
45   opts.on("--frontend input", "frontend to generate preferences for (WebKit, WebKitLegacy)") { |frontend| options[:frontend] = frontend }
46   opts.on("--base input", "file to generate preferences from") { |basePreferences| options[:basePreferences] = basePreferences }
47   opts.on("--debug input", "file to generate debug preferences from") { |debugPreferences| options[:debugPreferences] = debugPreferences }
48   opts.on("--experimental input", "file to generate experimental preferences from") { |experimentalPreferences| options[:experimentalPreferences] = experimentalPreferences }
49   opts.on("--internal input", "file to generate internal preferences from") { |internalPreferences| options[:internalPreferences] = internalPreferences }
50   opts.on("--template input", "template to use for generation (may be specified multiple times)") { |template| options[:templates] << template }
51   opts.on("--outputDir output", "directory to generate file in") { |outputDir| options[:outputDirectory] = outputDir }
52 end
53
54 optparse.parse!
55
56 if !options[:frontend] || !options[:basePreferences] || !options[:debugPreferences] || !options[:experimentalPreferences] || !options[:internalPreferences]
57   puts optparse
58   exit -1
59 end
60
61 if !options[:outputDirectory]
62   options[:outputDirectory] = Dir.getwd
63 end
64
65 FileUtils.mkdir_p(options[:outputDirectory])
66
67 def load(path)
68   parsed = begin
69     YAML.load_file(path)
70   rescue ArgumentError => e
71     puts "ERROR: Could not parse input file: #{e.message}"
72     exit(-1)
73   end
74   if parsed
75     previousName = nil
76     parsed.keys.each do |name|
77       if previousName != nil and previousName > name
78         puts "ERROR: Input file #{path} is not sorted. First out of order name found is '#{name}'."
79         exit(-1)
80       end
81       previousName = name
82     end
83   end
84   parsed
85 end
86
87 parsedBasePreferences = load(options[:basePreferences])
88 parsedDebugPreferences = load(options[:debugPreferences])
89 parsedExperimentalPreferences = load(options[:experimentalPreferences])
90 parsedInternalPreferences = load(options[:internalPreferences])
91
92
93 class Preference
94   attr_accessor :name
95   attr_accessor :opts
96   attr_accessor :type
97   attr_accessor :humanReadableName
98   attr_accessor :humanReadableDescription
99   attr_accessor :webcoreBinding
100   attr_accessor :condition
101   attr_accessor :hidden
102   attr_accessor :defaultValues
103
104   def initialize(name, opts, frontend)
105     @name = name
106     @opts = opts
107     @type = opts["type"]
108     @humanReadableName = '"' + (opts["humanReadableName"] || "") + '"'
109     @humanReadableDescription = '"' + (opts["humanReadableDescription"] || "") + '"'
110     @getter = opts["getter"]
111     @webcoreBinding = opts["webcoreBinding"]
112     @webcoreName = opts["webcoreName"]
113     @condition = opts["condition"]
114     @hidden = opts["hidden"] || false
115     @defaultValues = opts["defaultValue"][frontend]
116   end
117
118   def nameLower
119     if @getter
120       @getter
121     elsif @name.start_with?("VP")
122       @name[0..1].downcase + @name[2..@name.length]
123     elsif @name.start_with?("CSS", "DOM", "DNS", "FTP", "ICE", "IPC", "PDF", "XSS")
124       @name[0..2].downcase + @name[3..@name.length]
125     elsif @name.start_with?("HTTP")
126       @name[0..3].downcase + @name[4..@name.length]
127     else
128       @name[0].downcase + @name[1..@name.length]
129     end
130   end
131
132   def webcoreNameUpper
133     if @webcoreName
134       @webcoreName[0].upcase + @webcoreName[1..@webcoreName.length]
135     else
136       @name
137     end
138   end
139
140   def typeUpper
141     if @type == "uint32_t"
142       "UInt32"
143     else
144       @type.capitalize
145     end
146   end
147
148
149   # WebKitLegacy specific helpers.
150
151   def preferenceKey
152     if @opts["webKitLegacyPreferenceKey"]
153       @opts["webKitLegacyPreferenceKey"]
154     else
155       "WebKit#{@name}"
156     end
157   end
158   
159   def preferenceAccessor
160     case @type
161     when "bool"
162       "_boolValueForKey"
163     when "uint32_t"
164       "_integerValueForKey"
165     when "double"
166      "_floatValueForKey"
167     when "String"
168       "_stringValueForKey"
169     else
170       raise "Unknown type: #{@type}"
171     end
172   end
173 end
174
175 class Preferences
176   attr_accessor :preferences
177
178   def initialize(parsedBasePreferences, parsedDebugPreferences, parsedExperimentalPreferences, parsedInternalPreferences, frontend)
179     @frontend = frontend
180
181     @preferences = []
182     @preferencesNotDebug = initializeParsedPreferences(parsedBasePreferences)
183     @preferencesDebug = initializeParsedPreferences(parsedDebugPreferences)
184     @experimentalFeatures = initializeParsedPreferences(parsedExperimentalPreferences)
185     @internalFeatures = initializeParsedPreferences(parsedInternalPreferences)
186
187     @preferences.sort! { |x, y| x.name <=> y.name }
188     @preferencesNotDebug.sort! { |x, y| x.name <=> y.name }
189     @preferencesDebug.sort! { |x, y| x.name <=> y.name }
190     @experimentalFeatures.sort! { |x, y| x.name <=> y.name }.sort! { |x, y| x.humanReadableName <=> y.humanReadableName }
191     @internalFeatures.sort! { |x, y| x.name <=> y.name }.sort! { |x, y| x.humanReadableName <=> y.humanReadableName }
192
193     @preferencesBoundToSetting = @preferences.select { |p| !p.webcoreBinding }
194     @preferencesBoundToDeprecatedGlobalSettings = @preferences.select { |p| p.webcoreBinding == "DeprecatedGlobalSettings" }
195     @preferencesBoundToRuntimeEnabledFeatures = @preferences.select { |p| p.webcoreBinding == "RuntimeEnabledFeatures" }
196
197     @warning = "THIS FILE WAS AUTOMATICALLY GENERATED, DO NOT EDIT."
198   end
199
200   def initializeParsedPreferences(parsedPreferences)
201     result = []
202     if parsedPreferences
203       parsedPreferences.each do |name, options|
204         if !options["webcoreBinding"] && options["defaultValue"].size != 3
205           raise "ERROR: Preferences bound to WebCore::Settings must have default values for all frontends: #{name}"
206         end
207         if !options["exposed"] or options["exposed"].include?(@frontend)
208           preference = Preference.new(name, options, @frontend)
209           @preferences << preference
210           result << preference
211         end
212       end
213     end
214     result
215   end
216
217   def renderTemplate(templateFile, outputDirectory)
218     puts "Generating output for template file: #{templateFile}"
219
220     resultFile = File.join(outputDirectory, File.basename(templateFile, ".erb"))
221     tempResultFile = resultFile + ".tmp"
222
223     output = ERB.new(File.read(templateFile), 0, "-").result(binding)
224     File.open(tempResultFile, "w+") do |f|
225       f.write(output)
226     end
227     if (!File.exist?(resultFile) || IO::read(resultFile) != IO::read(tempResultFile))
228       FileUtils.move(tempResultFile, resultFile)
229     else
230       FileUtils.remove_file(tempResultFile)
231       FileUtils.uptodate?(resultFile, [templateFile]) or FileUtils.touch(resultFile)
232     end
233   end
234 end
235
236 preferences = Preferences.new(parsedBasePreferences, parsedDebugPreferences, parsedExperimentalPreferences, parsedInternalPreferences, options[:frontend])
237
238 options[:templates].each do |template|
239   preferences.renderTemplate(template, options[:outputDirectory])
240 end