38eacc7dc352d583ba4878a88c38e2e20f9c0c9d
[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   :templateDirectory => nil,
38   :outputDirectory => nil,
39   :templates => []
40 }
41 optparse = OptionParser.new do |opts|
42   opts.banner = "Usage: #{File.basename($0)} --input file"
43
44   opts.separator ""
45
46   opts.on("--frontend input", "frontend to generate preferences for (WebKit, WebKitLegacy)") { |frontend| options[:frontend] = frontend }
47   opts.on("--base input", "file to generate preferences from") { |basePreferences| options[:basePreferences] = basePreferences }
48   opts.on("--debug input", "file to generate debug preferences from") { |debugPreferences| options[:debugPreferences] = debugPreferences }
49   opts.on("--experimental input", "file to generate experimental preferences from") { |experimentalPreferences| options[:experimentalPreferences] = experimentalPreferences }
50   opts.on("--internal input", "file to generate internal preferences from") { |internalPreferences| options[:internalPreferences] = internalPreferences }
51   opts.on("--template input", "template to use for generation (may be specified multiple times)") { |template| options[:templates] << template }
52   opts.on("--templateDir input", "directory to look for templates in") { |templateDir| options[:templateDirectory] = templateDir }
53   opts.on("--outputDir output", "directory to generate file in") { |outputDir| options[:outputDirectory] = outputDir }
54 end
55
56 optparse.parse!
57
58 if !options[:frontend] || !options[:basePreferences] || !options[:debugPreferences] || !options[:experimentalPreferences] || !options[:internalPreferences] || !options[:templateDirectory]
59   puts optparse
60   exit -1
61 end
62
63 if !options[:outputDirectory]
64   options[:outputDirectory] = Dir.getwd
65 end
66
67 FileUtils.mkdir_p(options[:outputDirectory])
68
69 def load(path)
70   parsed = begin
71     YAML.load_file(path)
72   rescue ArgumentError => e
73     puts "ERROR: Could not parse input file: #{e.message}"
74     exit(-1)
75   end
76   if parsed
77     previousName = nil
78     parsed.keys.each do |name|
79       if previousName != nil and previousName > name
80         puts "ERROR: Input file #{path} is not sorted. First out of order name found is '#{name}'."
81         exit(-1)
82       end
83       previousName = name
84     end
85   end
86   parsed
87 end
88
89 parsedBasePreferences = load(options[:basePreferences])
90 parsedDebugPreferences = load(options[:debugPreferences])
91 parsedExperimentalPreferences = load(options[:experimentalPreferences])
92 parsedInternalPreferences = load(options[:internalPreferences])
93
94
95 class Preference
96   attr_accessor :name
97   attr_accessor :opts
98   attr_accessor :type
99   attr_accessor :humanReadableName
100   attr_accessor :humanReadableDescription
101   attr_accessor :webcoreBinding
102   attr_accessor :condition
103   attr_accessor :hidden
104   attr_accessor :defaultValues
105
106   def initialize(name, opts, frontend)
107     @name = name
108     @opts = opts
109     @type = opts["type"]
110     @humanReadableName = '"' + (opts["humanReadableName"] || "") + '"'
111     @humanReadableDescription = '"' + (opts["humanReadableDescription"] || "") + '"'
112     @getter = opts["getter"]
113     @webcoreBinding = opts["webcoreBinding"]
114     @webcoreName = opts["webcoreName"]
115     @condition = opts["condition"]
116     @hidden = opts["hidden"] || false
117     @defaultValues = opts["defaultValue"][frontend]
118   end
119
120   def nameLower
121     if @getter
122       @getter
123     elsif @name.start_with?("VP")
124       @name[0..1].downcase + @name[2..@name.length]
125     elsif @name.start_with?("CSS", "XSS", "FTP", "DOM", "DNS", "PDF", "ICE")
126       @name[0..2].downcase + @name[3..@name.length]
127     elsif @name.start_with?("HTTP")
128       @name[0..3].downcase + @name[4..@name.length]
129     else
130       @name[0].downcase + @name[1..@name.length]
131     end
132   end
133
134   def webcoreNameUpper
135     if @webcoreName
136       @webcoreName[0].upcase + @webcoreName[1..@webcoreName.length]
137     else
138       @name
139     end
140   end
141
142   def typeUpper
143     if @type == "uint32_t"
144       "UInt32"
145     else
146       @type.capitalize
147     end
148   end
149
150
151   # WebKitLegacy specific helpers.
152
153   def preferenceKey
154     if @opts["webKitLegacyPreferenceKey"]
155       @opts["webKitLegacyPreferenceKey"]
156     else
157       "WebKit#{@name}"
158     end
159   end
160   
161   def preferenceAccessor
162     case @type
163     when "bool"
164       "_boolValueForKey"
165     when "uint32_t"
166       "_integerValueForKey"
167     when "double"
168      "_floatValueForKey"
169     when "String"
170       "_stringValueForKey"
171     else
172       raise "Unknown type: #{@type}"
173     end
174   end
175 end
176
177 class Preferences
178   attr_accessor :preferences
179
180   def initialize(parsedBasePreferences, parsedDebugPreferences, parsedExperimentalPreferences, parsedInternalPreferences, frontend)
181     @frontend = frontend
182
183     @preferences = []
184     @preferencesNotDebug = initializeParsedPreferences(parsedBasePreferences)
185     @preferencesDebug = initializeParsedPreferences(parsedDebugPreferences)
186     @experimentalFeatures = initializeParsedPreferences(parsedExperimentalPreferences)
187     @internalFeatures = initializeParsedPreferences(parsedInternalPreferences)
188
189     @preferences.sort! { |x, y| x.name <=> y.name }
190     @preferencesNotDebug.sort! { |x, y| x.name <=> y.name }
191     @preferencesDebug.sort! { |x, y| x.name <=> y.name }
192     @experimentalFeatures.sort! { |x, y| x.name <=> y.name }.sort! { |x, y| x.humanReadableName <=> y.humanReadableName }
193     @internalFeatures.sort! { |x, y| x.name <=> y.name }.sort! { |x, y| x.humanReadableName <=> y.humanReadableName }
194
195     @preferencesBoundToSetting = @preferences.select { |p| !p.webcoreBinding }
196     @preferencesBoundToDeprecatedGlobalSettings = @preferences.select { |p| p.webcoreBinding == "DeprecatedGlobalSettings" }
197     @preferencesBoundToRuntimeEnabledFeatures = @preferences.select { |p| p.webcoreBinding == "RuntimeEnabledFeatures" }
198
199     @warning = "THIS FILE WAS AUTOMATICALLY GENERATED, DO NOT EDIT."
200   end
201
202   def initializeParsedPreferences(parsedPreferences)
203     result = []
204     if parsedPreferences
205       parsedPreferences.each do |name, options|
206         if !options["exposed"] or options["exposed"].include?(@frontend)
207           preference = Preference.new(name, options, @frontend)
208           @preferences << preference
209           result << preference
210         end
211       end
212     end
213     result
214   end
215
216   def renderTemplate(templateDirectory, template, outputDirectory)
217     templateFile = File.join(templateDirectory, template + ".erb")
218
219     output = ERB.new(File.read(templateFile), 0, "-").result(binding)
220     File.open(File.join(outputDirectory, template), "w+") do |f|
221       f.write(output)
222     end
223   end
224 end
225
226 preferences = Preferences.new(parsedBasePreferences, parsedDebugPreferences, parsedExperimentalPreferences, parsedInternalPreferences, options[:frontend])
227
228 options[:templates].each do |template|
229   preferences.renderTemplate(options[:templateDirectory], template, options[:outputDirectory])
230 end