Add [ActiveDOMObject] to IDLs of ActiveDOMObjects
[WebKit-https.git] / Source / WebCore / bindings / scripts / InFilesParser.pm
1 #!/usr/bin/env perl
2
3 # Copyright (C) 2008 Julien Chaffraix <jchaffraix@webkit.org>
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. ``AS IS'' AND ANY
15 # EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
17 # PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE INC. OR
18 # CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
19 # EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
20 # PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
21 # PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
22 # OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
24 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
25 #
26
27 use strict;
28 use warnings;
29
30 package InFilesParser;
31
32 my $isParsingCommonParameters;
33 my $hasStartedParsing;
34
35 # Helper functions
36
37 sub trimComment
38 {   
39     my $string = shift;
40     $string =~ s/#.+$//;
41     chomp($string);
42     return $string;
43 }
44
45 sub trimWS
46 {
47     my $string = shift;
48     $string =~ s/^\s+//;
49     $string =~ s/\s+$//;
50     chomp($string);
51     return $string;
52 }
53
54 sub trimQuoteAndWS
55 {
56     my $string = shift;
57     $string =~ s/\"([^\"]+)\"/$1/;
58     return trimWS($string);
59 }
60
61 # Default constructor
62
63 sub new
64 {
65     my $object = shift;
66     my $reference = { };
67
68     # Initialize the parser.
69     $isParsingCommonParameters = 1;
70     $hasStartedParsing = 0;
71
72     bless($reference, $object);
73     return $reference;
74 }
75
76 # parse take 3 attributes:
77 # - the filestream to read from (the caller has to open / close it).
78 # - the commonParameterHandler called when parsing the first part of the file with the parameter and the value.
79 # - the perTagHandler called for each optional parameter with the element name, the parameter and its value.
80 #   If no parameter were provided, it is called once with an empty parameter and value.
81 sub parse($)
82 {
83     my $object = shift;
84     my $fileStream = shift; # IO::File only
85     my $commonParameterHandler = shift;
86     my $perTagHandler = shift;
87
88     foreach (<$fileStream>) {
89         # Ignore whitespace, in case the .in files have the wrong EOL
90         # markers and those are getting treated as whitespace.
91         $_ = trimWS($_);
92
93         # Empty line, change from common parameter part
94         # to per tag part if we have started parsing.
95         if (/^$/) {
96             if ($hasStartedParsing) {
97                 $isParsingCommonParameters = 0;
98             }
99             next;
100         }
101
102         # There may be a few empty lines at the beginning of the file
103         # so detect the first non empty line which starts the common
104         # parameters part.
105         $hasStartedParsing = 1;
106
107         if (/^#/) {
108             next;
109         }
110
111         $_ = trimComment($_);
112
113         if ($isParsingCommonParameters) {
114             my ($name, $value) = split '=', $_;
115
116             $name = trimWS($name);
117             if (defined($value)) {
118                 $value = trimQuoteAndWS($value);
119             } else {
120                 # We default to 1 as it eases the syntax.
121                 $value = "1";
122             }
123
124             &$commonParameterHandler($name, $value);
125         } else {
126             # Parsing per-tag parameters.
127
128             # Split the tag name ($1) from the optionnal parameter(s) ($2)
129             /^(\S+)\s*(.*)$/;
130             my $elementName = $1;
131
132             if ($2) {
133                 my @options = split "," , $2;
134                 my ($option, $value);
135                 for (my $i = 0; $i < @options; ++$i) {
136                     ($option, $value) = split "=", $options[$i];
137                     $option = trimWS($option);
138                     if (defined($value)) {
139                         $value = trimQuoteAndWS($value);
140                     } else {
141                         # We default to 1 as it eases the syntax.
142                         $value = "1";
143                     }
144
145                     &$perTagHandler($elementName, $option, $value);
146                 }
147             } else {
148                 # No parameter was given so call it with empty strings.
149                 &$perTagHandler($elementName, "", "");
150             }
151         }
152     }
153 }
154
155 1;