edtf 4.1.1 → 5.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +40 -0
- data/README.md +448 -260
- data/UPGRADING.md +227 -0
- data/lib/edtf/bitmask.rb +277 -0
- data/lib/edtf/builder.rb +177 -0
- data/lib/edtf/date.rb +435 -284
- data/lib/edtf/date_time.rb +285 -11
- data/lib/edtf/epoch.rb +107 -67
- data/lib/edtf/grammar.rb +118 -0
- data/lib/edtf/interval.rb +124 -254
- data/lib/edtf/iso.rb +1136 -0
- data/lib/edtf/iso.y +490 -0
- data/lib/edtf/legacy.rb +1888 -0
- data/lib/edtf/legacy.y +625 -0
- data/lib/edtf/parser.rb +249 -1985
- data/lib/edtf/period.rb +199 -0
- data/lib/edtf/season.rb +160 -146
- data/lib/edtf/set.rb +180 -56
- data/lib/edtf/version.rb +1 -1
- data/lib/edtf.rb +43 -30
- metadata +15 -28
- data/lib/edtf/compatibility.rb +0 -6
- data/lib/edtf/extensions.rb +0 -11
- data/lib/edtf/parser.y +0 -666
- data/lib/edtf/uncertainty.rb +0 -100
- data/lib/edtf/unknown.rb +0 -25
data/lib/edtf/parser.y
DELETED
|
@@ -1,666 +0,0 @@
|
|
|
1
|
-
# -*- racc -*-
|
|
2
|
-
|
|
3
|
-
class EDTF::Parser
|
|
4
|
-
|
|
5
|
-
token T Z E X U UNKNOWN OPEN LONGYEAR UNMATCHED DOTS UA PUA
|
|
6
|
-
|
|
7
|
-
expect 0
|
|
8
|
-
|
|
9
|
-
rule
|
|
10
|
-
|
|
11
|
-
edtf : level_0_expression
|
|
12
|
-
| level_1_expression
|
|
13
|
-
| level_2_expression
|
|
14
|
-
;
|
|
15
|
-
|
|
16
|
-
# ---- Level 0 / ISO 8601 Rules ----
|
|
17
|
-
|
|
18
|
-
# NB: level 0 intervals are covered by the level 1 interval rules
|
|
19
|
-
level_0_expression : date
|
|
20
|
-
| date_time
|
|
21
|
-
;
|
|
22
|
-
|
|
23
|
-
date :
|
|
24
|
-
year { result = Date.gregorian(val[0]).year_precision! }
|
|
25
|
-
| year_month { result = Date.gregorian(*val.flatten).month_precision! }
|
|
26
|
-
| year_month_day { result = Date.gregorian(*val.flatten).day_precision! }
|
|
27
|
-
;
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
date_time : date T time {
|
|
31
|
-
result = DateTime.new(val[0].year, val[0].month, val[0].day, *val[2])
|
|
32
|
-
result.skip_timezone = (val[2].length == 3)
|
|
33
|
-
}
|
|
34
|
-
|
|
35
|
-
time : base_time
|
|
36
|
-
| base_time zone_offset { result = val.flatten }
|
|
37
|
-
|
|
38
|
-
base_time : hour ':' minute ':' second { result = val.values_at(0, 2, 4) }
|
|
39
|
-
| midnight
|
|
40
|
-
|
|
41
|
-
midnight : '2' '4' ':' '0' '0' ':' '0' '0' { result = [24, 0, 0] }
|
|
42
|
-
|
|
43
|
-
zone_offset : Z { result = 0 }
|
|
44
|
-
| '-' zone_offset_hour { result = -1 * val[1] }
|
|
45
|
-
| '+' positive_zone_offset { result = val[1] }
|
|
46
|
-
;
|
|
47
|
-
|
|
48
|
-
positive_zone_offset : zone_offset_hour
|
|
49
|
-
| '0' '0' ':' '0' '0' { result = 0 }
|
|
50
|
-
;
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
zone_offset_hour : d01_13 ':' minute { result = Rational(val[0] * 60 + val[2], 1440) }
|
|
54
|
-
| '1' '4' ':' '0' '0' { result = Rational(840, 1440) }
|
|
55
|
-
| '0' '0' ':' d01_59 { result = Rational(val[3], 1440) }
|
|
56
|
-
;
|
|
57
|
-
|
|
58
|
-
year : positive_year
|
|
59
|
-
| '-' positive_year {
|
|
60
|
-
result = -val[1]
|
|
61
|
-
deprecate :negative_zero if result.zero?
|
|
62
|
-
}
|
|
63
|
-
|
|
64
|
-
positive_year : digit digit digit digit {
|
|
65
|
-
result = val.zip([1000,100,10,1]).reduce(0) { |s,(a,b)| s += a * b }
|
|
66
|
-
}
|
|
67
|
-
|
|
68
|
-
month : d01_12
|
|
69
|
-
day : d01_31
|
|
70
|
-
|
|
71
|
-
year_month : year '-' month { result = [val[0], val[2]] }
|
|
72
|
-
|
|
73
|
-
# We raise an exception if there are too many days for the month, but
|
|
74
|
-
# do not consider leap years, as the EDTF BNF did not either.
|
|
75
|
-
# NB: an exception will be raised regardless, because the Ruby Date
|
|
76
|
-
# implementation calculates leap years.
|
|
77
|
-
year_month_day : year_month '-' day {
|
|
78
|
-
result = val[0] << val[2]
|
|
79
|
-
if result[2] > 31 || (result[2] > 30 && [2,4,6,9,11].include?(result[1])) || (result[2] > 29 && result[1] == 2)
|
|
80
|
-
raise ArgumentError, "invalid date (invalid days #{result[2]} for month #{result[1]})"
|
|
81
|
-
end
|
|
82
|
-
}
|
|
83
|
-
|
|
84
|
-
hour : d00_23
|
|
85
|
-
minute : d00_59
|
|
86
|
-
second : d00_59
|
|
87
|
-
|
|
88
|
-
# Completely covered by level_1_interval
|
|
89
|
-
# level_0_interval : date '/' date { result = Interval.new(val[0], val[1]) }
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
# ---- Level 1 Extension Rules ----
|
|
93
|
-
|
|
94
|
-
# NB: Uncertain/approximate Dates are covered by the Level 2 rules
|
|
95
|
-
level_1_expression : unknown | unspecified | level_1_interval | long_year_simple | season
|
|
96
|
-
|
|
97
|
-
unknown : U U U U {
|
|
98
|
-
result = EDTF::Unknown.new
|
|
99
|
-
deprecate :unknown_date
|
|
100
|
-
}
|
|
101
|
-
|
|
102
|
-
# uncertain_or_approximate_date : date UA { result = uoa(val[0], val[1]) }
|
|
103
|
-
|
|
104
|
-
unspecified : unspecified_year
|
|
105
|
-
{
|
|
106
|
-
result = Date.gregorian(val[0][0]).year_precision!
|
|
107
|
-
result.unspecified.year[2,2] = val[0][1]
|
|
108
|
-
}
|
|
109
|
-
| unspecified_month
|
|
110
|
-
| unspecified_day
|
|
111
|
-
| unspecified_day_and_month
|
|
112
|
-
;
|
|
113
|
-
|
|
114
|
-
unspecified_year : positive_unspecified_year
|
|
115
|
-
| '-' positive_unspecified_year
|
|
116
|
-
{
|
|
117
|
-
result = val[1]
|
|
118
|
-
result[0] = -result[0]
|
|
119
|
-
}
|
|
120
|
-
|
|
121
|
-
positive_unspecified_year :
|
|
122
|
-
digit digit digit U
|
|
123
|
-
{
|
|
124
|
-
result = [val[0,3].zip([1000,100,10]).reduce(0) { |s,(a,b)| s += a * b }, [false,true]]
|
|
125
|
-
}
|
|
126
|
-
| digit digit U U
|
|
127
|
-
{
|
|
128
|
-
result = [val[0,2].zip([1000,100]).reduce(0) { |s,(a,b)| s += a * b }, [true, true]]
|
|
129
|
-
}
|
|
130
|
-
|
|
131
|
-
unspecified_month : year '-' U U {
|
|
132
|
-
result = Date.gregorian(val[0]).unspecified!(:month)
|
|
133
|
-
result.precision = :month
|
|
134
|
-
}
|
|
135
|
-
|
|
136
|
-
unspecified_day : year_month '-' U U {
|
|
137
|
-
result = Date.gregorian(*val[0]).unspecified!(:day)
|
|
138
|
-
}
|
|
139
|
-
|
|
140
|
-
unspecified_day_and_month : year '-' U U '-' U U {
|
|
141
|
-
result = Date.gregorian(val[0]).unspecified!([:day,:month])
|
|
142
|
-
}
|
|
143
|
-
|
|
144
|
-
level_1_interval : level_1_interval_closed | level_1_interval_open | level_1_interval_unknown
|
|
145
|
-
|
|
146
|
-
level_1_interval_closed : level_1_start '/' level_1_end {
|
|
147
|
-
result = Interval.new(val[0], val[2])
|
|
148
|
-
}
|
|
149
|
-
|
|
150
|
-
level_1_interval_open : level_1_interval_open_start | level_1_interval_open_end
|
|
151
|
-
|
|
152
|
-
level_1_interval_open_start : open_start_or_end '/' level_1_end {
|
|
153
|
-
result = Interval.new(:open, val[2])
|
|
154
|
-
}
|
|
155
|
-
|
|
156
|
-
level_1_interval_open_end : level_1_start '/' open_start_or_end {
|
|
157
|
-
result = Interval.new(val[0], :open)
|
|
158
|
-
}
|
|
159
|
-
|
|
160
|
-
open_start_or_end : OPEN | DOTS
|
|
161
|
-
|
|
162
|
-
level_1_interval_unknown : level_1_interval_empty_start | level_1_interval_empty_end | level_1_interval_unknown_start | level_1_interval_unknown_end
|
|
163
|
-
|
|
164
|
-
level_1_interval_empty_start : '/' level_1_end {
|
|
165
|
-
result = Interval.new(:unknown, val[1])
|
|
166
|
-
}
|
|
167
|
-
|
|
168
|
-
level_1_interval_empty_end : level_1_start '/' {
|
|
169
|
-
result = Interval.new(val[0], :unknown)
|
|
170
|
-
}
|
|
171
|
-
|
|
172
|
-
level_1_interval_unknown_start : UNKNOWN '/' level_1_end {
|
|
173
|
-
result = Interval.new(:unknown, val[2])
|
|
174
|
-
}
|
|
175
|
-
|
|
176
|
-
level_1_interval_unknown_end : level_1_start '/' UNKNOWN {
|
|
177
|
-
result = Interval.new(val[0], :unknown)
|
|
178
|
-
}
|
|
179
|
-
|
|
180
|
-
level_1_start : date | partial_uncertain_or_approximate | unspecified | partial_unspecified
|
|
181
|
-
|
|
182
|
-
level_1_end : level_1_start
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
long_year_simple :
|
|
186
|
-
LONGYEAR long_year
|
|
187
|
-
{
|
|
188
|
-
result = Date.gregorian(val[1])
|
|
189
|
-
result.precision = :year
|
|
190
|
-
}
|
|
191
|
-
| LONGYEAR '-' long_year
|
|
192
|
-
{
|
|
193
|
-
result = Date.gregorian(-1 * val[2])
|
|
194
|
-
result.precision = :year
|
|
195
|
-
}
|
|
196
|
-
;
|
|
197
|
-
|
|
198
|
-
long_year :
|
|
199
|
-
positive_digit digit digit digit digit {
|
|
200
|
-
result = val.zip([10000,1000,100,10,1]).reduce(0) { |s,(a,b)| s += a * b }
|
|
201
|
-
}
|
|
202
|
-
| long_year digit { result = 10 * val[0] + val[1] }
|
|
203
|
-
;
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
season : year '-' season_number ua {
|
|
207
|
-
result = Season.new(val[0], val[2])
|
|
208
|
-
val[3].each { |ua| result.send(ua) }
|
|
209
|
-
}
|
|
210
|
-
|
|
211
|
-
season_number : '2' '1' { result = 21 }
|
|
212
|
-
| '2' '2' { result = 22 }
|
|
213
|
-
| '2' '3' { result = 23 }
|
|
214
|
-
| '2' '4' { result = 24 }
|
|
215
|
-
;
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
# ---- Level 2 Extension Rules ----
|
|
219
|
-
|
|
220
|
-
# NB: Level 2 Intervals are covered by the Level 1 Interval rules.
|
|
221
|
-
level_2_expression : season_qualified
|
|
222
|
-
| partial_uncertain_or_approximate
|
|
223
|
-
| partial_unspecified
|
|
224
|
-
| choice_list
|
|
225
|
-
| inclusive_list
|
|
226
|
-
| masked_precision
|
|
227
|
-
| date_and_calendar
|
|
228
|
-
| long_year_scientific
|
|
229
|
-
;
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
season_qualified : season '^' { result = val[0]; result.qualifier = val[1] }
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
long_year_scientific :
|
|
236
|
-
long_year_simple E integer
|
|
237
|
-
{
|
|
238
|
-
result = Date.gregorian(val[0].year * 10 ** val[2]).year_precision!
|
|
239
|
-
}
|
|
240
|
-
| LONGYEAR int1_4 E integer
|
|
241
|
-
{
|
|
242
|
-
result = Date.gregorian(val[1] * 10 ** val[3]).year_precision!
|
|
243
|
-
}
|
|
244
|
-
| LONGYEAR '-' int1_4 E integer
|
|
245
|
-
{
|
|
246
|
-
result = Date.gregorian(-1 * val[2] * 10 ** val[4]).year_precision!
|
|
247
|
-
}
|
|
248
|
-
;
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
date_and_calendar : date '^' { result = val[0]; result.calendar = val[1] }
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
masked_precision :
|
|
255
|
-
digit digit digit X
|
|
256
|
-
{
|
|
257
|
-
d = val[0,3].zip([1000,100,10]).reduce(0) { |s,(a,b)| s += a * b }
|
|
258
|
-
result = EDTF::Decade.new(d)
|
|
259
|
-
}
|
|
260
|
-
| digit digit X X
|
|
261
|
-
{
|
|
262
|
-
d = val[0,2].zip([1000,100]).reduce(0) { |s,(a,b)| s += a * b }
|
|
263
|
-
result = EDTF::Century.new(d)
|
|
264
|
-
}
|
|
265
|
-
;
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
choice_list : '[' list ']' { result = val[1].choice! }
|
|
269
|
-
|
|
270
|
-
inclusive_list : '{' list '}' { result = val[1] }
|
|
271
|
-
|
|
272
|
-
list : earlier { result = EDTF::Set.new(val[0]).earlier! }
|
|
273
|
-
| earlier ',' list_elements ',' later { result = EDTF::Set.new([val[0]] + val[2] + [val[4]]).earlier!.later! }
|
|
274
|
-
| earlier ',' list_elements { result = EDTF::Set.new([val[0]] + val[2]).earlier! }
|
|
275
|
-
| earlier ',' later { result = EDTF::Set.new([val[0]] + [val[2]]).earlier!.later! }
|
|
276
|
-
| list_elements ',' later { result = EDTF::Set.new(val[0] + [val[2]]).later! }
|
|
277
|
-
| list_elements { result = EDTF::Set.new(*val[0]) }
|
|
278
|
-
| later { result = EDTF::Set.new(val[0]).later! }
|
|
279
|
-
;
|
|
280
|
-
|
|
281
|
-
list_elements : list_element { result = [val[0]].flatten }
|
|
282
|
-
| list_elements ',' list_element { result = val[0] + [val[2]].flatten }
|
|
283
|
-
;
|
|
284
|
-
|
|
285
|
-
list_element : atomic
|
|
286
|
-
| consecutives
|
|
287
|
-
;
|
|
288
|
-
|
|
289
|
-
atomic : date
|
|
290
|
-
| partial_uncertain_or_approximate
|
|
291
|
-
| unspecified
|
|
292
|
-
;
|
|
293
|
-
|
|
294
|
-
earlier : DOTS date { result = val[1] }
|
|
295
|
-
|
|
296
|
-
later : year_month_day DOTS { result = Date.gregorian(*val[0]).day_precision! }
|
|
297
|
-
| year_month DOTS { result = Date.gregorian(*val[0]).month_precision! }
|
|
298
|
-
| year DOTS { result = Date.gregorian(val[0]).year_precision! }
|
|
299
|
-
;
|
|
300
|
-
|
|
301
|
-
consecutives : year_month_day DOTS year_month_day { result = (Date.gregorian(*val[0]).day_precision! .. Date.gregorian(*val[2]).day_precision!) }
|
|
302
|
-
| year_month DOTS year_month { result = (Date.gregorian(*val[0]).month_precision! .. Date.gregorian(*val[2]).month_precision!) }
|
|
303
|
-
| year DOTS year { result = (Date.gregorian(val[0]).year_precision! .. Date.gregorian(val[2]).year_precision!) }
|
|
304
|
-
;
|
|
305
|
-
|
|
306
|
-
partial_unspecified :
|
|
307
|
-
unspecified_year '-' month '-' day
|
|
308
|
-
{
|
|
309
|
-
result = Date.gregorian(val[0][0], val[2], val[4])
|
|
310
|
-
result.unspecified.year[2,2] = val[0][1]
|
|
311
|
-
}
|
|
312
|
-
| unspecified_year '-' month
|
|
313
|
-
{
|
|
314
|
-
result = Date.gregorian(val[0][0], val[2], 1)
|
|
315
|
-
result.month_precision!
|
|
316
|
-
result.unspecified.year[2,2] = val[0][1]
|
|
317
|
-
}
|
|
318
|
-
| unspecified_year '-' U U '-' day
|
|
319
|
-
{
|
|
320
|
-
result = Date.gregorian(val[0][0], 1, val[5])
|
|
321
|
-
result.unspecified.year[2,2] = val[0][1]
|
|
322
|
-
result.unspecified!(:month)
|
|
323
|
-
}
|
|
324
|
-
| unspecified_year '-' U U '-' U U
|
|
325
|
-
{
|
|
326
|
-
result = Date.gregorian(val[0][0], 1, 1)
|
|
327
|
-
result.unspecified.year[2,2] = val[0][1]
|
|
328
|
-
result.unspecified!([:month, :day])
|
|
329
|
-
}
|
|
330
|
-
| unspecified_year '-' month '-' U U
|
|
331
|
-
{
|
|
332
|
-
result = Date.gregorian(val[0][0], val[2], 1)
|
|
333
|
-
result.unspecified.year[2,2] = val[0][1]
|
|
334
|
-
result.unspecified!(:day)
|
|
335
|
-
}
|
|
336
|
-
| year '-' U U '-' day
|
|
337
|
-
{
|
|
338
|
-
result = Date.gregorian(val[0], 1, val[5])
|
|
339
|
-
result.unspecified!(:month)
|
|
340
|
-
}
|
|
341
|
-
;
|
|
342
|
-
|
|
343
|
-
partial_uncertain_or_approximate : pua_base
|
|
344
|
-
| '(' pua_base ')' UA { result = uoa(val[1], val[3]) }
|
|
345
|
-
|
|
346
|
-
pua_base :
|
|
347
|
-
pua_year { result = val[0].year_precision! }
|
|
348
|
-
| pua_year_month { result = val[0][0].month_precision! }
|
|
349
|
-
| pua_year_month_day { result = val[0].day_precision! }
|
|
350
|
-
|
|
351
|
-
pua_year : year UA { result = uoa(Date.gregorian(val[0]), val[1], :year) }
|
|
352
|
-
|
|
353
|
-
pua_year_month :
|
|
354
|
-
pua_year '-' month ua {
|
|
355
|
-
result = [uoa(val[0].change(:month => val[2]), val[3], [:month, :year])]
|
|
356
|
-
}
|
|
357
|
-
| year '-' month UA {
|
|
358
|
-
result = [uoa(Date.gregorian(val[0], val[2]), val[3], [:year, :month])]
|
|
359
|
-
}
|
|
360
|
-
| year '-(' month ')' UA {
|
|
361
|
-
result = [uoa(Date.gregorian(val[0], val[2]), val[4], [:month]), true]
|
|
362
|
-
}
|
|
363
|
-
| pua_year '-(' month ')' UA {
|
|
364
|
-
result = [uoa(val[0].change(:month => val[2]), val[4], [:month]), true]
|
|
365
|
-
}
|
|
366
|
-
;
|
|
367
|
-
|
|
368
|
-
pua_year_month_day :
|
|
369
|
-
pua_year_month '-' day ua {
|
|
370
|
-
result = uoa(val[0][0].change(:day => val[2]), val[3], val[0][1] ? [:day] : nil)
|
|
371
|
-
}
|
|
372
|
-
| pua_year_month '-(' day ')' UA {
|
|
373
|
-
result = uoa(val[0][0].change(:day => val[2]), val[4], [:day])
|
|
374
|
-
}
|
|
375
|
-
| year '-(' month ')' UA day ua {
|
|
376
|
-
result = uoa(uoa(Date.gregorian(val[0], val[2], val[5]), val[4], :month), val[6], :day)
|
|
377
|
-
}
|
|
378
|
-
| year_month '-' day UA {
|
|
379
|
-
result = uoa(Date.gregorian(val[0][0], val[0][1], val[2]), val[3])
|
|
380
|
-
}
|
|
381
|
-
| year_month '-(' day ')' UA {
|
|
382
|
-
result = uoa(Date.gregorian(val[0][0], val[0][1], val[2]), val[4], [:day])
|
|
383
|
-
}
|
|
384
|
-
| year '-(' month '-' day ')' UA {
|
|
385
|
-
result = uoa(Date.gregorian(val[0], val[2], val[4]), val[6], [:month, :day])
|
|
386
|
-
}
|
|
387
|
-
| year '-(' month '-(' day ')' UA ')' UA {
|
|
388
|
-
result = Date.gregorian(val[0], val[2], val[4])
|
|
389
|
-
result = uoa(result, val[6], [:day])
|
|
390
|
-
result = uoa(result, val[8], [:month, :day])
|
|
391
|
-
}
|
|
392
|
-
| pua_year '-(' month '-' day ')' UA {
|
|
393
|
-
result = val[0].change(:month => val[2], :day => val[4])
|
|
394
|
-
result = uoa(result, val[6], [:month, :day])
|
|
395
|
-
}
|
|
396
|
-
| pua_year '-(' month '-(' day ')' UA ')' UA {
|
|
397
|
-
result = val[0].change(:month => val[2], :day => val[4])
|
|
398
|
-
result = uoa(result, val[6], [:day])
|
|
399
|
-
result = uoa(result, val[8], [:month, :day])
|
|
400
|
-
}
|
|
401
|
-
# | '(' pua_year '-(' month ')' UA ')' UA '-' day ua {
|
|
402
|
-
# result = val[1].change(:month => val[3], :day => val[9])
|
|
403
|
-
# result = uoa(result, val[5], [:month])
|
|
404
|
-
# result = [uoa(result, val[7], [:year]), true]
|
|
405
|
-
# }
|
|
406
|
-
;
|
|
407
|
-
|
|
408
|
-
ua : { result = [] } | UA
|
|
409
|
-
|
|
410
|
-
# ---- Auxiliary Rules ----
|
|
411
|
-
|
|
412
|
-
digit : '0' { result = 0 }
|
|
413
|
-
| positive_digit
|
|
414
|
-
;
|
|
415
|
-
|
|
416
|
-
positive_digit : '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9'
|
|
417
|
-
|
|
418
|
-
d01_12 : '0' positive_digit { result = val[1] }
|
|
419
|
-
| '1' '0' { result = 10 }
|
|
420
|
-
| '1' '1' { result = 11 }
|
|
421
|
-
| '1' '2' { result = 12 }
|
|
422
|
-
;
|
|
423
|
-
|
|
424
|
-
d01_13 : d01_12
|
|
425
|
-
| '1' '3' { result = 13 }
|
|
426
|
-
;
|
|
427
|
-
|
|
428
|
-
d01_23 : '0' positive_digit { result = val[1] }
|
|
429
|
-
| '1' digit { result = 10 + val[1] }
|
|
430
|
-
| '2' '0' { result = 20 }
|
|
431
|
-
| '2' '1' { result = 21 }
|
|
432
|
-
| '2' '2' { result = 22 }
|
|
433
|
-
| '2' '3' { result = 23 }
|
|
434
|
-
;
|
|
435
|
-
|
|
436
|
-
d00_23 : '0' '0'
|
|
437
|
-
| d01_23
|
|
438
|
-
;
|
|
439
|
-
|
|
440
|
-
d01_29 : d01_23
|
|
441
|
-
| '2' '4' { result = 24 }
|
|
442
|
-
| '2' '5' { result = 25 }
|
|
443
|
-
| '2' '6' { result = 26 }
|
|
444
|
-
| '2' '7' { result = 27 }
|
|
445
|
-
| '2' '8' { result = 28 }
|
|
446
|
-
| '2' '9' { result = 29 }
|
|
447
|
-
;
|
|
448
|
-
|
|
449
|
-
d01_30 : d01_29
|
|
450
|
-
| '3' '0' { result = 30 }
|
|
451
|
-
;
|
|
452
|
-
|
|
453
|
-
d01_31 : d01_30
|
|
454
|
-
| '3' '1' { result = 31 }
|
|
455
|
-
;
|
|
456
|
-
|
|
457
|
-
d01_59 : d01_29
|
|
458
|
-
| '3' digit { result = 30 + val[1] }
|
|
459
|
-
| '4' digit { result = 40 + val[1] }
|
|
460
|
-
| '5' digit { result = 50 + val[1] }
|
|
461
|
-
;
|
|
462
|
-
|
|
463
|
-
d00_59 : '0' '0'
|
|
464
|
-
| d01_59
|
|
465
|
-
;
|
|
466
|
-
|
|
467
|
-
int1_4 : positive_digit { result = val[0] }
|
|
468
|
-
| positive_digit digit { result = 10 * val[0] + val[1] }
|
|
469
|
-
| positive_digit digit digit
|
|
470
|
-
{
|
|
471
|
-
result = val.zip([100,10,1]).reduce(0) { |s,(a,b)| s += a * b }
|
|
472
|
-
}
|
|
473
|
-
| positive_digit digit digit digit
|
|
474
|
-
{
|
|
475
|
-
result = val.zip([1000,100,10,1]).reduce(0) { |s,(a,b)| s += a * b }
|
|
476
|
-
}
|
|
477
|
-
;
|
|
478
|
-
|
|
479
|
-
integer : positive_digit { result = val[0] }
|
|
480
|
-
| integer digit { result = 10 * val[0] + val[1] }
|
|
481
|
-
;
|
|
482
|
-
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
---- header
|
|
486
|
-
require 'strscan'
|
|
487
|
-
|
|
488
|
-
---- inner
|
|
489
|
-
|
|
490
|
-
@defaults = {
|
|
491
|
-
:level => 2,
|
|
492
|
-
:debug => false,
|
|
493
|
-
:warn => true
|
|
494
|
-
}.freeze
|
|
495
|
-
|
|
496
|
-
# Input that EDTF-Ruby 5.0 parses differently.
|
|
497
|
-
# Legacy syntax will be accepted only in legacy mode;
|
|
498
|
-
# lossy legacy syntax has no ISO 8601-2 equivalent.
|
|
499
|
-
LEGACY = {
|
|
500
|
-
combined_qualifier: '`?~` is legacy syntax, use `%`',
|
|
501
|
-
parentheses: 'parentheses are legacy syntax, ' \
|
|
502
|
-
'EDTF-Ruby 5.0 qualifies parts from the left instead, e.g. `2004-?06-11`',
|
|
503
|
-
open: '`open` is legacy syntax, use `..`',
|
|
504
|
-
unknown: '`unknown` is legacy syntax, leave the interval end empty',
|
|
505
|
-
unspecified: '`u` is legacy syntax, use `X`',
|
|
506
|
-
masked: 'masked precision (`198x`) is legacy syntax, ' \
|
|
507
|
-
'EDTF-Ruby 5.0 reads it as a decade (`198`) or century (`19`)',
|
|
508
|
-
lowercase_y: '`y` is legacy syntax, use `Y`',
|
|
509
|
-
lowercase_e: '`e` is legacy syntax, use `E`',
|
|
510
|
-
negative_zero: '`-0000` is legacy syntax, use `0000`',
|
|
511
|
-
whitespace: 'spaces around `,` and `..` are legacy syntax, remove them',
|
|
512
|
-
caret: 'calendars and season qualifiers (`^…`) are legacy syntax, ' \
|
|
513
|
-
'EDTF-Ruby 5.0 converts hemispheres to seasons, e.g. `2001-21^southern` ' \
|
|
514
|
-
'to `2001-29`, and drops the rest'
|
|
515
|
-
}.freeze
|
|
516
|
-
|
|
517
|
-
CHANGED = {
|
|
518
|
-
unknown_date: 'EDTF-Ruby 5.0 parses this as a date ' \
|
|
519
|
-
'with an unspecified year instead of EDTF::Unknown'
|
|
520
|
-
}.freeze
|
|
521
|
-
|
|
522
|
-
class << self; attr_reader :defaults; end
|
|
523
|
-
|
|
524
|
-
attr_reader :options, :deprecations
|
|
525
|
-
|
|
526
|
-
def initialize(options = {})
|
|
527
|
-
@options = Parser.defaults.merge(options)
|
|
528
|
-
end
|
|
529
|
-
|
|
530
|
-
def debug?
|
|
531
|
-
!!(options[:debug] || ENV['DEBUG'])
|
|
532
|
-
end
|
|
533
|
-
|
|
534
|
-
def parse(input)
|
|
535
|
-
parse!(input)
|
|
536
|
-
rescue => e
|
|
537
|
-
warn e.message if debug?
|
|
538
|
-
nil
|
|
539
|
-
end
|
|
540
|
-
|
|
541
|
-
def parse!(input)
|
|
542
|
-
@yydebug = debug?
|
|
543
|
-
@src = StringScanner.new(input)
|
|
544
|
-
@deprecations = []
|
|
545
|
-
result = do_parse
|
|
546
|
-
@deprecations.uniq!
|
|
547
|
-
warn_deprecations(input) if options[:warn]
|
|
548
|
-
result
|
|
549
|
-
end
|
|
550
|
-
|
|
551
|
-
# Returns true if the last successful parse used legacy syntax.
|
|
552
|
-
def legacy?
|
|
553
|
-
deprecations.any? { |d| LEGACY.key?(d) }
|
|
554
|
-
end
|
|
555
|
-
|
|
556
|
-
def on_error(tid, value, stack)
|
|
557
|
-
raise ArgumentError,
|
|
558
|
-
"failed to parse date: unexpected '#{value}' at #{stack.inspect}"
|
|
559
|
-
end
|
|
560
|
-
|
|
561
|
-
def deprecate(name)
|
|
562
|
-
@deprecations << name
|
|
563
|
-
end
|
|
564
|
-
|
|
565
|
-
def warn_deprecations(input)
|
|
566
|
-
return if deprecations.empty?
|
|
567
|
-
messages = deprecations.map { |d| LEGACY[d] || CHANGED[d] }
|
|
568
|
-
warn "EDTF #{input.inspect}: #{messages.join('; ')}", category: :deprecated
|
|
569
|
-
end
|
|
570
|
-
|
|
571
|
-
def apply_uncertainty(date, uncertainty, scope = nil)
|
|
572
|
-
uncertainty.each do |u|
|
|
573
|
-
scope.nil? ? date.send(u) : date.send(u, scope)
|
|
574
|
-
end
|
|
575
|
-
date
|
|
576
|
-
end
|
|
577
|
-
|
|
578
|
-
alias uoa apply_uncertainty
|
|
579
|
-
|
|
580
|
-
def next_token
|
|
581
|
-
case
|
|
582
|
-
when @src.eos?
|
|
583
|
-
nil
|
|
584
|
-
# when @src.scan(/\s+/)
|
|
585
|
-
# ignore whitespace
|
|
586
|
-
when @src.scan(/\(/)
|
|
587
|
-
deprecate :parentheses
|
|
588
|
-
['(', @src.matched]
|
|
589
|
-
# when @src.scan(/\)\?~-/)
|
|
590
|
-
# [:PUA, [:uncertain!, :approximate!]]
|
|
591
|
-
# when @src.scan(/\)\?-/)
|
|
592
|
-
# [:PUA, [:uncertain!]]
|
|
593
|
-
# when @src.scan(/\)~-/)
|
|
594
|
-
# [:PUA, [:approximate!]]
|
|
595
|
-
when @src.scan(/\)/)
|
|
596
|
-
[')', @src.matched]
|
|
597
|
-
when @src.scan(/\[/)
|
|
598
|
-
['[', @src.matched]
|
|
599
|
-
when @src.scan(/\]/)
|
|
600
|
-
[']', @src.matched]
|
|
601
|
-
when @src.scan(/\{/)
|
|
602
|
-
['{', @src.matched]
|
|
603
|
-
when @src.scan(/\}/)
|
|
604
|
-
['}', @src.matched]
|
|
605
|
-
when @src.scan(/T/)
|
|
606
|
-
[:T, @src.matched]
|
|
607
|
-
when @src.scan(/Z/)
|
|
608
|
-
[:Z, @src.matched]
|
|
609
|
-
when @src.scan(/\?~/)
|
|
610
|
-
deprecate :combined_qualifier
|
|
611
|
-
[:UA, [:uncertain!, :approximate!]]
|
|
612
|
-
when @src.scan(/%/)
|
|
613
|
-
[:UA, [:uncertain!, :approximate!]]
|
|
614
|
-
when @src.scan(/\?/)
|
|
615
|
-
[:UA, [:uncertain!]]
|
|
616
|
-
when @src.scan(/~/)
|
|
617
|
-
[:UA, [:approximate!]]
|
|
618
|
-
when @src.scan(/open/i)
|
|
619
|
-
deprecate :open
|
|
620
|
-
[:OPEN, :open]
|
|
621
|
-
when @src.scan(/unkn?own/i) # matches 'unkown' typo too
|
|
622
|
-
deprecate :unknown
|
|
623
|
-
[:UNKNOWN, :unknown]
|
|
624
|
-
when @src.scan(/u/)
|
|
625
|
-
deprecate :unspecified
|
|
626
|
-
[:U, @src.matched]
|
|
627
|
-
when @src.scan(/X/)
|
|
628
|
-
[:U, @src.matched]
|
|
629
|
-
when @src.scan(/x/)
|
|
630
|
-
deprecate :masked
|
|
631
|
-
[:X, @src.matched]
|
|
632
|
-
when @src.scan(/y/i)
|
|
633
|
-
deprecate :lowercase_y if @src.matched == 'y'
|
|
634
|
-
[:LONGYEAR, @src.matched]
|
|
635
|
-
when @src.scan(/e/i)
|
|
636
|
-
deprecate :lowercase_e if @src.matched == 'e'
|
|
637
|
-
[:E, @src.matched]
|
|
638
|
-
when @src.scan(/\+/)
|
|
639
|
-
['+', @src.matched]
|
|
640
|
-
when @src.scan(/-\(/)
|
|
641
|
-
deprecate :parentheses
|
|
642
|
-
['-(', @src.matched]
|
|
643
|
-
when @src.scan(/-/)
|
|
644
|
-
['-', @src.matched]
|
|
645
|
-
when @src.scan(/:/)
|
|
646
|
-
[':', @src.matched]
|
|
647
|
-
when @src.scan(/\//)
|
|
648
|
-
['/', @src.matched]
|
|
649
|
-
when @src.scan(/\s*\.\.\s*/)
|
|
650
|
-
deprecate :whitespace if @src.matched.length > 2
|
|
651
|
-
[:DOTS, '..']
|
|
652
|
-
when @src.scan(/\s*,\s*/)
|
|
653
|
-
deprecate :whitespace if @src.matched.length > 1
|
|
654
|
-
[',', ',']
|
|
655
|
-
when @src.scan(/\^\w+/)
|
|
656
|
-
deprecate :caret
|
|
657
|
-
['^', @src.matched[1..-1]]
|
|
658
|
-
when @src.scan(/\d/)
|
|
659
|
-
[@src.matched, @src.matched.to_i]
|
|
660
|
-
else @src.scan(/./)
|
|
661
|
-
[:UNMATCHED, @src.rest]
|
|
662
|
-
end
|
|
663
|
-
end
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
# -*- racc -*-
|