1"""PyUnit testing against strptime"""
2
3import unittest
4import time
5import locale
6import re
7import os
8import sys
9from test import support
10from test.support import skip_if_buggy_ucrt_strfptime
11from datetime import date as datetime_date
12
13import _strptime
14
15class getlang_Tests(unittest.TestCase):
16    """Test _getlang"""
17    def test_basic(self):
18        self.assertEqual(_strptime._getlang(), locale.getlocale(locale.LC_TIME))
19
20class LocaleTime_Tests(unittest.TestCase):
21    """Tests for _strptime.LocaleTime.
22
23    All values are lower-cased when stored in LocaleTime, so make sure to
24    compare values after running ``lower`` on them.
25
26    """
27
28    def setUp(self):
29        """Create time tuple based on current time."""
30        self.time_tuple = time.localtime()
31        self.LT_ins = _strptime.LocaleTime()
32
33    def compare_against_time(self, testing, directive, tuple_position,
34                             error_msg):
35        """Helper method that tests testing against directive based on the
36        tuple_position of time_tuple.  Uses error_msg as error message.
37
38        """
39        strftime_output = time.strftime(directive, self.time_tuple).lower()
40        comparison = testing[self.time_tuple[tuple_position]]
41        self.assertIn(strftime_output, testing,
42                      "%s: not found in tuple" % error_msg)
43        self.assertEqual(comparison, strftime_output,
44                         "%s: position within tuple incorrect; %s != %s" %
45                         (error_msg, comparison, strftime_output))
46
47    def test_weekday(self):
48        # Make sure that full and abbreviated weekday names are correct in
49        # both string and position with tuple
50        self.compare_against_time(self.LT_ins.f_weekday, '%A', 6,
51                                  "Testing of full weekday name failed")
52        self.compare_against_time(self.LT_ins.a_weekday, '%a', 6,
53                                  "Testing of abbreviated weekday name failed")
54
55    def test_month(self):
56        # Test full and abbreviated month names; both string and position
57        # within the tuple
58        self.compare_against_time(self.LT_ins.f_month, '%B', 1,
59                                  "Testing against full month name failed")
60        self.compare_against_time(self.LT_ins.a_month, '%b', 1,
61                                  "Testing against abbreviated month name failed")
62
63    def test_am_pm(self):
64        # Make sure AM/PM representation done properly
65        strftime_output = time.strftime("%p", self.time_tuple).lower()
66        self.assertIn(strftime_output, self.LT_ins.am_pm,
67                      "AM/PM representation not in tuple")
68        if self.time_tuple[3] < 12: position = 0
69        else: position = 1
70        self.assertEqual(self.LT_ins.am_pm[position], strftime_output,
71                         "AM/PM representation in the wrong position within the tuple")
72
73    @unittest.skipIf(
74        support.is_emscripten, "musl libc issue on Emscripten, bpo-46390"
75    )
76    def test_timezone(self):
77        # Make sure timezone is correct
78        timezone = time.strftime("%Z", self.time_tuple).lower()
79        if timezone:
80            self.assertTrue(timezone in self.LT_ins.timezone[0] or
81                            timezone in self.LT_ins.timezone[1],
82                            "timezone %s not found in %s" %
83                            (timezone, self.LT_ins.timezone))
84
85    def test_date_time(self):
86        # Check that LC_date_time, LC_date, and LC_time are correct
87        # the magic date is used so as to not have issues with %c when day of
88        #  the month is a single digit and has a leading space.  This is not an
89        #  issue since strptime still parses it correctly.  The problem is
90        #  testing these directives for correctness by comparing strftime
91        #  output.
92        magic_date = (1999, 3, 17, 22, 44, 55, 2, 76, 0)
93        strftime_output = time.strftime("%c", magic_date)
94        self.assertEqual(time.strftime(self.LT_ins.LC_date_time, magic_date),
95                         strftime_output, "LC_date_time incorrect")
96        strftime_output = time.strftime("%x", magic_date)
97        self.assertEqual(time.strftime(self.LT_ins.LC_date, magic_date),
98                         strftime_output, "LC_date incorrect")
99        strftime_output = time.strftime("%X", magic_date)
100        self.assertEqual(time.strftime(self.LT_ins.LC_time, magic_date),
101                         strftime_output, "LC_time incorrect")
102        LT = _strptime.LocaleTime()
103        LT.am_pm = ('', '')
104        self.assertTrue(LT.LC_time, "LocaleTime's LC directives cannot handle "
105                                    "empty strings")
106
107    def test_lang(self):
108        # Make sure lang is set to what _getlang() returns
109        # Assuming locale has not changed between now and when self.LT_ins was created
110        self.assertEqual(self.LT_ins.lang, _strptime._getlang())
111
112
113class TimeRETests(unittest.TestCase):
114    """Tests for TimeRE."""
115
116    def setUp(self):
117        """Construct generic TimeRE object."""
118        self.time_re = _strptime.TimeRE()
119        self.locale_time = _strptime.LocaleTime()
120
121    def test_pattern(self):
122        # Test TimeRE.pattern
123        pattern_string = self.time_re.pattern(r"%a %A %d")
124        self.assertTrue(pattern_string.find(self.locale_time.a_weekday[2]) != -1,
125                        "did not find abbreviated weekday in pattern string '%s'" %
126                         pattern_string)
127        self.assertTrue(pattern_string.find(self.locale_time.f_weekday[4]) != -1,
128                        "did not find full weekday in pattern string '%s'" %
129                         pattern_string)
130        self.assertTrue(pattern_string.find(self.time_re['d']) != -1,
131                        "did not find 'd' directive pattern string '%s'" %
132                         pattern_string)
133
134    def test_pattern_escaping(self):
135        # Make sure any characters in the format string that might be taken as
136        # regex syntax is escaped.
137        pattern_string = self.time_re.pattern(r"\d+")
138        self.assertIn(r"\\d\+", pattern_string,
139                      "%s does not have re characters escaped properly" %
140                      pattern_string)
141
142    @skip_if_buggy_ucrt_strfptime
143    def test_compile(self):
144        # Check that compiled regex is correct
145        found = self.time_re.compile(r"%A").match(self.locale_time.f_weekday[6])
146        self.assertTrue(found and found.group('A') == self.locale_time.f_weekday[6],
147                        "re object for '%A' failed")
148        compiled = self.time_re.compile(r"%a %b")
149        found = compiled.match("%s %s" % (self.locale_time.a_weekday[4],
150                               self.locale_time.a_month[4]))
151        self.assertTrue(found,
152            "Match failed with '%s' regex and '%s' string" %
153             (compiled.pattern, "%s %s" % (self.locale_time.a_weekday[4],
154                                           self.locale_time.a_month[4])))
155        self.assertTrue(found.group('a') == self.locale_time.a_weekday[4] and
156                         found.group('b') == self.locale_time.a_month[4],
157                        "re object couldn't find the abbreviated weekday month in "
158                         "'%s' using '%s'; group 'a' = '%s', group 'b' = %s'" %
159                         (found.string, found.re.pattern, found.group('a'),
160                          found.group('b')))
161        for directive in ('a','A','b','B','c','d','G','H','I','j','m','M','p',
162                          'S','u','U','V','w','W','x','X','y','Y','Z','%'):
163            compiled = self.time_re.compile("%" + directive)
164            found = compiled.match(time.strftime("%" + directive))
165            self.assertTrue(found, "Matching failed on '%s' using '%s' regex" %
166                                    (time.strftime("%" + directive),
167                                     compiled.pattern))
168
169    def test_blankpattern(self):
170        # Make sure when tuple or something has no values no regex is generated.
171        # Fixes bug #661354
172        test_locale = _strptime.LocaleTime()
173        test_locale.timezone = (frozenset(), frozenset())
174        self.assertEqual(_strptime.TimeRE(test_locale).pattern("%Z"), '',
175                         "with timezone == ('',''), TimeRE().pattern('%Z') != ''")
176
177    def test_matching_with_escapes(self):
178        # Make sure a format that requires escaping of characters works
179        compiled_re = self.time_re.compile(r"\w+ %m")
180        found = compiled_re.match(r"\w+ 10")
181        self.assertTrue(found, r"Escaping failed of format '\w+ 10'")
182
183    def test_locale_data_w_regex_metacharacters(self):
184        # Check that if locale data contains regex metacharacters they are
185        # escaped properly.
186        # Discovered by bug #1039270 .
187        locale_time = _strptime.LocaleTime()
188        locale_time.timezone = (frozenset(("utc", "gmt",
189                                            "Tokyo (standard time)")),
190                                frozenset("Tokyo (daylight time)"))
191        time_re = _strptime.TimeRE(locale_time)
192        self.assertTrue(time_re.compile("%Z").match("Tokyo (standard time)"),
193                        "locale data that contains regex metacharacters is not"
194                        " properly escaped")
195
196    def test_whitespace_substitution(self):
197        # When pattern contains whitespace, make sure it is taken into account
198        # so as to not allow subpatterns to end up next to each other and
199        # "steal" characters from each other.
200        pattern = self.time_re.pattern('%j %H')
201        self.assertFalse(re.match(pattern, "180"))
202        self.assertTrue(re.match(pattern, "18 0"))
203
204
205class StrptimeTests(unittest.TestCase):
206    """Tests for _strptime.strptime."""
207
208    def setUp(self):
209        """Create testing time tuple."""
210        self.time_tuple = time.gmtime()
211
212    def test_ValueError(self):
213        # Make sure ValueError is raised when match fails or format is bad
214        self.assertRaises(ValueError, _strptime._strptime_time, data_string="%d",
215                          format="%A")
216        for bad_format in ("%", "% ", "%e"):
217            try:
218                _strptime._strptime_time("2005", bad_format)
219            except ValueError:
220                continue
221            except Exception as err:
222                self.fail("'%s' raised %s, not ValueError" %
223                            (bad_format, err.__class__.__name__))
224            else:
225                self.fail("'%s' did not raise ValueError" % bad_format)
226
227        # Ambiguous or incomplete cases using ISO year/week/weekday directives
228        # 1. ISO week (%V) is specified, but the year is specified with %Y
229        # instead of %G
230        with self.assertRaises(ValueError):
231            _strptime._strptime("1999 50", "%Y %V")
232        # 2. ISO year (%G) and ISO week (%V) are specified, but weekday is not
233        with self.assertRaises(ValueError):
234            _strptime._strptime("1999 51", "%G %V")
235        # 3. ISO year (%G) and weekday are specified, but ISO week (%V) is not
236        for w in ('A', 'a', 'w', 'u'):
237            with self.assertRaises(ValueError):
238                _strptime._strptime("1999 51","%G %{}".format(w))
239        # 4. ISO year is specified alone (e.g. time.strptime('2015', '%G'))
240        with self.assertRaises(ValueError):
241            _strptime._strptime("2015", "%G")
242        # 5. Julian/ordinal day (%j) is specified with %G, but not %Y
243        with self.assertRaises(ValueError):
244            _strptime._strptime("1999 256", "%G %j")
245
246
247    def test_strptime_exception_context(self):
248        # check that this doesn't chain exceptions needlessly (see #17572)
249        with self.assertRaises(ValueError) as e:
250            _strptime._strptime_time('', '%D')
251        self.assertIs(e.exception.__suppress_context__, True)
252        # additional check for IndexError branch (issue #19545)
253        with self.assertRaises(ValueError) as e:
254            _strptime._strptime_time('19', '%Y %')
255        self.assertIs(e.exception.__suppress_context__, True)
256
257    def test_unconverteddata(self):
258        # Check ValueError is raised when there is unconverted data
259        self.assertRaises(ValueError, _strptime._strptime_time, "10 12", "%m")
260
261    def helper(self, directive, position):
262        """Helper fxn in testing."""
263        strf_output = time.strftime("%" + directive, self.time_tuple)
264        strp_output = _strptime._strptime_time(strf_output, "%" + directive)
265        self.assertTrue(strp_output[position] == self.time_tuple[position],
266                        "testing of '%s' directive failed; '%s' -> %s != %s" %
267                         (directive, strf_output, strp_output[position],
268                          self.time_tuple[position]))
269
270    def test_year(self):
271        # Test that the year is handled properly
272        for directive in ('y', 'Y'):
273            self.helper(directive, 0)
274        # Must also make sure %y values are correct for bounds set by Open Group
275        for century, bounds in ((1900, ('69', '99')), (2000, ('00', '68'))):
276            for bound in bounds:
277                strp_output = _strptime._strptime_time(bound, '%y')
278                expected_result = century + int(bound)
279                self.assertTrue(strp_output[0] == expected_result,
280                                "'y' test failed; passed in '%s' "
281                                "and returned '%s'" % (bound, strp_output[0]))
282
283    def test_month(self):
284        # Test for month directives
285        for directive in ('B', 'b', 'm'):
286            self.helper(directive, 1)
287
288    def test_day(self):
289        # Test for day directives
290        self.helper('d', 2)
291
292    def test_hour(self):
293        # Test hour directives
294        self.helper('H', 3)
295        strf_output = time.strftime("%I %p", self.time_tuple)
296        strp_output = _strptime._strptime_time(strf_output, "%I %p")
297        self.assertTrue(strp_output[3] == self.time_tuple[3],
298                        "testing of '%%I %%p' directive failed; '%s' -> %s != %s" %
299                         (strf_output, strp_output[3], self.time_tuple[3]))
300
301    def test_minute(self):
302        # Test minute directives
303        self.helper('M', 4)
304
305    def test_second(self):
306        # Test second directives
307        self.helper('S', 5)
308
309    def test_fraction(self):
310        # Test microseconds
311        import datetime
312        d = datetime.datetime(2012, 12, 20, 12, 34, 56, 78987)
313        tup, frac, _ = _strptime._strptime(str(d), format="%Y-%m-%d %H:%M:%S.%f")
314        self.assertEqual(frac, d.microsecond)
315
316    def test_weekday(self):
317        # Test weekday directives
318        for directive in ('A', 'a', 'w', 'u'):
319            self.helper(directive,6)
320
321    def test_julian(self):
322        # Test julian directives
323        self.helper('j', 7)
324
325    def test_offset(self):
326        one_hour = 60 * 60
327        half_hour = 30 * 60
328        half_minute = 30
329        (*_, offset), _, offset_fraction = _strptime._strptime("+0130", "%z")
330        self.assertEqual(offset, one_hour + half_hour)
331        self.assertEqual(offset_fraction, 0)
332        (*_, offset), _, offset_fraction = _strptime._strptime("-0100", "%z")
333        self.assertEqual(offset, -one_hour)
334        self.assertEqual(offset_fraction, 0)
335        (*_, offset), _, offset_fraction = _strptime._strptime("-013030", "%z")
336        self.assertEqual(offset, -(one_hour + half_hour + half_minute))
337        self.assertEqual(offset_fraction, 0)
338        (*_, offset), _, offset_fraction = _strptime._strptime("-013030.000001", "%z")
339        self.assertEqual(offset, -(one_hour + half_hour + half_minute))
340        self.assertEqual(offset_fraction, -1)
341        (*_, offset), _, offset_fraction = _strptime._strptime("+01:00", "%z")
342        self.assertEqual(offset, one_hour)
343        self.assertEqual(offset_fraction, 0)
344        (*_, offset), _, offset_fraction = _strptime._strptime("-01:30", "%z")
345        self.assertEqual(offset, -(one_hour + half_hour))
346        self.assertEqual(offset_fraction, 0)
347        (*_, offset), _, offset_fraction = _strptime._strptime("-01:30:30", "%z")
348        self.assertEqual(offset, -(one_hour + half_hour + half_minute))
349        self.assertEqual(offset_fraction, 0)
350        (*_, offset), _, offset_fraction = _strptime._strptime("-01:30:30.000001", "%z")
351        self.assertEqual(offset, -(one_hour + half_hour + half_minute))
352        self.assertEqual(offset_fraction, -1)
353        (*_, offset), _, offset_fraction = _strptime._strptime("+01:30:30.001", "%z")
354        self.assertEqual(offset, one_hour + half_hour + half_minute)
355        self.assertEqual(offset_fraction, 1000)
356        (*_, offset), _, offset_fraction = _strptime._strptime("Z", "%z")
357        self.assertEqual(offset, 0)
358        self.assertEqual(offset_fraction, 0)
359
360    def test_bad_offset(self):
361        with self.assertRaises(ValueError):
362            _strptime._strptime("-01:30:30.", "%z")
363        with self.assertRaises(ValueError):
364            _strptime._strptime("-0130:30", "%z")
365        with self.assertRaises(ValueError):
366            _strptime._strptime("-01:30:30.1234567", "%z")
367        with self.assertRaises(ValueError):
368            _strptime._strptime("-01:30:30:123456", "%z")
369        with self.assertRaises(ValueError) as err:
370            _strptime._strptime("-01:3030", "%z")
371        self.assertEqual("Inconsistent use of : in -01:3030", str(err.exception))
372
373    @skip_if_buggy_ucrt_strfptime
374    @unittest.skipIf(
375        support.is_emscripten, "musl libc issue on Emscripten, bpo-46390"
376    )
377    def test_timezone(self):
378        # Test timezone directives.
379        # When gmtime() is used with %Z, entire result of strftime() is empty.
380        # Check for equal timezone names deals with bad locale info when this
381        # occurs; first found in FreeBSD 4.4.
382        strp_output = _strptime._strptime_time("UTC", "%Z")
383        self.assertEqual(strp_output.tm_isdst, 0)
384        strp_output = _strptime._strptime_time("GMT", "%Z")
385        self.assertEqual(strp_output.tm_isdst, 0)
386        time_tuple = time.localtime()
387        strf_output = time.strftime("%Z")  #UTC does not have a timezone
388        strp_output = _strptime._strptime_time(strf_output, "%Z")
389        locale_time = _strptime.LocaleTime()
390        if time.tzname[0] != time.tzname[1] or not time.daylight:
391            self.assertTrue(strp_output[8] == time_tuple[8],
392                            "timezone check failed; '%s' -> %s != %s" %
393                             (strf_output, strp_output[8], time_tuple[8]))
394        else:
395            self.assertTrue(strp_output[8] == -1,
396                            "LocaleTime().timezone has duplicate values and "
397                             "time.daylight but timezone value not set to -1")
398
399    @unittest.skipUnless(
400        hasattr(time, "tzset"), "time module has no attribute tzset"
401        )
402    def test_bad_timezone(self):
403        # Explicitly test possibility of bad timezone;
404        # when time.tzname[0] == time.tzname[1] and time.daylight
405        tz_name = time.tzname[0]
406        if tz_name.upper() in ("UTC", "GMT"):
407            self.skipTest('need non-UTC/GMT timezone')
408
409        with support.swap_attr(time, 'tzname', (tz_name, tz_name)), \
410             support.swap_attr(time, 'daylight', 1), \
411             support.swap_attr(time, 'tzset', lambda: None):
412            time.tzname = (tz_name, tz_name)
413            time.daylight = 1
414            tz_value = _strptime._strptime_time(tz_name, "%Z")[8]
415            self.assertEqual(tz_value, -1,
416                    "%s lead to a timezone value of %s instead of -1 when "
417                    "time.daylight set to %s and passing in %s" %
418                    (time.tzname, tz_value, time.daylight, tz_name))
419
420    def test_date_time(self):
421        # Test %c directive
422        for position in range(6):
423            self.helper('c', position)
424
425    def test_date(self):
426        # Test %x directive
427        for position in range(0,3):
428            self.helper('x', position)
429
430    def test_time(self):
431        # Test %X directive
432        for position in range(3,6):
433            self.helper('X', position)
434
435    def test_percent(self):
436        # Make sure % signs are handled properly
437        strf_output = time.strftime("%m %% %Y", self.time_tuple)
438        strp_output = _strptime._strptime_time(strf_output, "%m %% %Y")
439        self.assertTrue(strp_output[0] == self.time_tuple[0] and
440                         strp_output[1] == self.time_tuple[1],
441                        "handling of percent sign failed")
442
443    def test_caseinsensitive(self):
444        # Should handle names case-insensitively.
445        strf_output = time.strftime("%B", self.time_tuple)
446        self.assertTrue(_strptime._strptime_time(strf_output.upper(), "%B"),
447                        "strptime does not handle ALL-CAPS names properly")
448        self.assertTrue(_strptime._strptime_time(strf_output.lower(), "%B"),
449                        "strptime does not handle lowercase names properly")
450        self.assertTrue(_strptime._strptime_time(strf_output.capitalize(), "%B"),
451                        "strptime does not handle capword names properly")
452
453    def test_defaults(self):
454        # Default return value should be (1900, 1, 1, 0, 0, 0, 0, 1, 0)
455        defaults = (1900, 1, 1, 0, 0, 0, 0, 1, -1)
456        strp_output = _strptime._strptime_time('1', '%m')
457        self.assertTrue(strp_output == defaults,
458                        "Default values for strptime() are incorrect;"
459                        " %s != %s" % (strp_output, defaults))
460
461    def test_escaping(self):
462        # Make sure all characters that have regex significance are escaped.
463        # Parentheses are in a purposeful order; will cause an error of
464        # unbalanced parentheses when the regex is compiled if they are not
465        # escaped.
466        # Test instigated by bug #796149 .
467        need_escaping = r".^$*+?{}\[]|)("
468        self.assertTrue(_strptime._strptime_time(need_escaping, need_escaping))
469
470    def test_feb29_on_leap_year_without_year(self):
471        time.strptime("Feb 29", "%b %d")
472
473    def test_mar1_comes_after_feb29_even_when_omitting_the_year(self):
474        self.assertLess(
475                time.strptime("Feb 29", "%b %d"),
476                time.strptime("Mar 1", "%b %d"))
477
478class Strptime12AMPMTests(unittest.TestCase):
479    """Test a _strptime regression in '%I %p' at 12 noon (12 PM)"""
480
481    def test_twelve_noon_midnight(self):
482        eq = self.assertEqual
483        eq(time.strptime('12 PM', '%I %p')[3], 12)
484        eq(time.strptime('12 AM', '%I %p')[3], 0)
485        eq(_strptime._strptime_time('12 PM', '%I %p')[3], 12)
486        eq(_strptime._strptime_time('12 AM', '%I %p')[3], 0)
487
488
489class JulianTests(unittest.TestCase):
490    """Test a _strptime regression that all julian (1-366) are accepted"""
491
492    def test_all_julian_days(self):
493        eq = self.assertEqual
494        for i in range(1, 367):
495            # use 2004, since it is a leap year, we have 366 days
496            eq(_strptime._strptime_time('%d 2004' % i, '%j %Y')[7], i)
497
498class CalculationTests(unittest.TestCase):
499    """Test that strptime() fills in missing info correctly"""
500
501    def setUp(self):
502        self.time_tuple = time.gmtime()
503
504    @skip_if_buggy_ucrt_strfptime
505    def test_julian_calculation(self):
506        # Make sure that when Julian is missing that it is calculated
507        format_string = "%Y %m %d %H %M %S %w %Z"
508        result = _strptime._strptime_time(time.strftime(format_string, self.time_tuple),
509                                    format_string)
510        self.assertTrue(result.tm_yday == self.time_tuple.tm_yday,
511                        "Calculation of tm_yday failed; %s != %s" %
512                         (result.tm_yday, self.time_tuple.tm_yday))
513
514    @skip_if_buggy_ucrt_strfptime
515    def test_gregorian_calculation(self):
516        # Test that Gregorian date can be calculated from Julian day
517        format_string = "%Y %H %M %S %w %j %Z"
518        result = _strptime._strptime_time(time.strftime(format_string, self.time_tuple),
519                                    format_string)
520        self.assertTrue(result.tm_year == self.time_tuple.tm_year and
521                         result.tm_mon == self.time_tuple.tm_mon and
522                         result.tm_mday == self.time_tuple.tm_mday,
523                        "Calculation of Gregorian date failed; "
524                         "%s-%s-%s != %s-%s-%s" %
525                         (result.tm_year, result.tm_mon, result.tm_mday,
526                          self.time_tuple.tm_year, self.time_tuple.tm_mon,
527                          self.time_tuple.tm_mday))
528
529    @skip_if_buggy_ucrt_strfptime
530    def test_day_of_week_calculation(self):
531        # Test that the day of the week is calculated as needed
532        format_string = "%Y %m %d %H %S %j %Z"
533        result = _strptime._strptime_time(time.strftime(format_string, self.time_tuple),
534                                    format_string)
535        self.assertTrue(result.tm_wday == self.time_tuple.tm_wday,
536                        "Calculation of day of the week failed; "
537                         "%s != %s" % (result.tm_wday, self.time_tuple.tm_wday))
538
539    if support.is_android:
540        # Issue #26929: strftime() on Android incorrectly formats %V or %G for
541        # the last or the first incomplete week in a year.
542        _ymd_excluded = ((1905, 1, 1), (1906, 12, 31), (2008, 12, 29),
543                        (1917, 12, 31))
544        _formats_excluded = ('%G %V',)
545    else:
546        _ymd_excluded = ()
547        _formats_excluded = ()
548
549    @unittest.skipIf(sys.platform.startswith('aix'),
550                     'bpo-29972: broken test on AIX')
551    def test_week_of_year_and_day_of_week_calculation(self):
552        # Should be able to infer date if given year, week of year (%U or %W)
553        # and day of the week
554        def test_helper(ymd_tuple, test_reason):
555            for year_week_format in ('%Y %W', '%Y %U', '%G %V'):
556                if (year_week_format in self._formats_excluded and
557                        ymd_tuple in self._ymd_excluded):
558                    return
559                for weekday_format in ('%w', '%u', '%a', '%A'):
560                    format_string = year_week_format + ' ' + weekday_format
561                    with self.subTest(test_reason,
562                                      date=ymd_tuple,
563                                      format=format_string):
564                        dt_date = datetime_date(*ymd_tuple)
565                        strp_input = dt_date.strftime(format_string)
566                        strp_output = _strptime._strptime_time(strp_input,
567                                                               format_string)
568                        msg = "%r: %s != %s" % (strp_input,
569                                                strp_output[7],
570                                                dt_date.timetuple()[7])
571                        self.assertEqual(strp_output[:3], ymd_tuple, msg)
572        test_helper((1901, 1, 3), "week 0")
573        test_helper((1901, 1, 8), "common case")
574        test_helper((1901, 1, 13), "day on Sunday")
575        test_helper((1901, 1, 14), "day on Monday")
576        test_helper((1905, 1, 1), "Jan 1 on Sunday")
577        test_helper((1906, 1, 1), "Jan 1 on Monday")
578        test_helper((1906, 1, 7), "first Sunday in a year starting on Monday")
579        test_helper((1905, 12, 31), "Dec 31 on Sunday")
580        test_helper((1906, 12, 31), "Dec 31 on Monday")
581        test_helper((2008, 12, 29), "Monday in the last week of the year")
582        test_helper((2008, 12, 22), "Monday in the second-to-last week of the "
583                                    "year")
584        test_helper((1978, 10, 23), "randomly chosen date")
585        test_helper((2004, 12, 18), "randomly chosen date")
586        test_helper((1978, 10, 23), "year starting and ending on Monday while "
587                                        "date not on Sunday or Monday")
588        test_helper((1917, 12, 17), "year starting and ending on Monday with "
589                                        "a Monday not at the beginning or end "
590                                        "of the year")
591        test_helper((1917, 12, 31), "Dec 31 on Monday with year starting and "
592                                        "ending on Monday")
593        test_helper((2007, 1, 7), "First Sunday of 2007")
594        test_helper((2007, 1, 14), "Second Sunday of 2007")
595        test_helper((2006, 12, 31), "Last Sunday of 2006")
596        test_helper((2006, 12, 24), "Second to last Sunday of 2006")
597
598    def test_week_0(self):
599        def check(value, format, *expected):
600            self.assertEqual(_strptime._strptime_time(value, format)[:-1], expected)
601        check('2015 0 0', '%Y %U %w', 2014, 12, 28, 0, 0, 0, 6, 362)
602        check('2015 0 0', '%Y %W %w', 2015, 1, 4, 0, 0, 0, 6, 4)
603        check('2015 1 1', '%G %V %u', 2014, 12, 29, 0, 0, 0, 0, 363)
604        check('2015 0 1', '%Y %U %w', 2014, 12, 29, 0, 0, 0, 0, 363)
605        check('2015 0 1', '%Y %W %w', 2014, 12, 29, 0, 0, 0, 0, 363)
606        check('2015 1 2', '%G %V %u', 2014, 12, 30, 0, 0, 0, 1, 364)
607        check('2015 0 2', '%Y %U %w', 2014, 12, 30, 0, 0, 0, 1, 364)
608        check('2015 0 2', '%Y %W %w', 2014, 12, 30, 0, 0, 0, 1, 364)
609        check('2015 1 3', '%G %V %u', 2014, 12, 31, 0, 0, 0, 2, 365)
610        check('2015 0 3', '%Y %U %w', 2014, 12, 31, 0, 0, 0, 2, 365)
611        check('2015 0 3', '%Y %W %w', 2014, 12, 31, 0, 0, 0, 2, 365)
612        check('2015 1 4', '%G %V %u', 2015, 1, 1, 0, 0, 0, 3, 1)
613        check('2015 0 4', '%Y %U %w', 2015, 1, 1, 0, 0, 0, 3, 1)
614        check('2015 0 4', '%Y %W %w', 2015, 1, 1, 0, 0, 0, 3, 1)
615        check('2015 1 5', '%G %V %u', 2015, 1, 2, 0, 0, 0, 4, 2)
616        check('2015 0 5', '%Y %U %w', 2015, 1, 2, 0, 0, 0, 4, 2)
617        check('2015 0 5', '%Y %W %w', 2015, 1, 2, 0, 0, 0, 4, 2)
618        check('2015 1 6', '%G %V %u', 2015, 1, 3, 0, 0, 0, 5, 3)
619        check('2015 0 6', '%Y %U %w', 2015, 1, 3, 0, 0, 0, 5, 3)
620        check('2015 0 6', '%Y %W %w', 2015, 1, 3, 0, 0, 0, 5, 3)
621        check('2015 1 7', '%G %V %u', 2015, 1, 4, 0, 0, 0, 6, 4)
622
623        check('2009 0 0', '%Y %U %w', 2008, 12, 28, 0, 0, 0, 6, 363)
624        check('2009 0 0', '%Y %W %w', 2009, 1, 4, 0, 0, 0, 6, 4)
625        check('2009 1 1', '%G %V %u', 2008, 12, 29, 0, 0, 0, 0, 364)
626        check('2009 0 1', '%Y %U %w', 2008, 12, 29, 0, 0, 0, 0, 364)
627        check('2009 0 1', '%Y %W %w', 2008, 12, 29, 0, 0, 0, 0, 364)
628        check('2009 1 2', '%G %V %u', 2008, 12, 30, 0, 0, 0, 1, 365)
629        check('2009 0 2', '%Y %U %w', 2008, 12, 30, 0, 0, 0, 1, 365)
630        check('2009 0 2', '%Y %W %w', 2008, 12, 30, 0, 0, 0, 1, 365)
631        check('2009 1 3', '%G %V %u', 2008, 12, 31, 0, 0, 0, 2, 366)
632        check('2009 0 3', '%Y %U %w', 2008, 12, 31, 0, 0, 0, 2, 366)
633        check('2009 0 3', '%Y %W %w', 2008, 12, 31, 0, 0, 0, 2, 366)
634        check('2009 1 4', '%G %V %u', 2009, 1, 1, 0, 0, 0, 3, 1)
635        check('2009 0 4', '%Y %U %w', 2009, 1, 1, 0, 0, 0, 3, 1)
636        check('2009 0 4', '%Y %W %w', 2009, 1, 1, 0, 0, 0, 3, 1)
637        check('2009 1 5', '%G %V %u', 2009, 1, 2, 0, 0, 0, 4, 2)
638        check('2009 0 5', '%Y %U %w', 2009, 1, 2, 0, 0, 0, 4, 2)
639        check('2009 0 5', '%Y %W %w', 2009, 1, 2, 0, 0, 0, 4, 2)
640        check('2009 1 6', '%G %V %u', 2009, 1, 3, 0, 0, 0, 5, 3)
641        check('2009 0 6', '%Y %U %w', 2009, 1, 3, 0, 0, 0, 5, 3)
642        check('2009 0 6', '%Y %W %w', 2009, 1, 3, 0, 0, 0, 5, 3)
643        check('2009 1 7', '%G %V %u', 2009, 1, 4, 0, 0, 0, 6, 4)
644
645
646class CacheTests(unittest.TestCase):
647    """Test that caching works properly."""
648
649    def test_time_re_recreation(self):
650        # Make sure cache is recreated when current locale does not match what
651        # cached object was created with.
652        _strptime._strptime_time("10", "%d")
653        _strptime._strptime_time("2005", "%Y")
654        _strptime._TimeRE_cache.locale_time.lang = "Ni"
655        original_time_re = _strptime._TimeRE_cache
656        _strptime._strptime_time("10", "%d")
657        self.assertIsNot(original_time_re, _strptime._TimeRE_cache)
658        self.assertEqual(len(_strptime._regex_cache), 1)
659
660    def test_regex_cleanup(self):
661        # Make sure cached regexes are discarded when cache becomes "full".
662        try:
663            del _strptime._regex_cache['%d']
664        except KeyError:
665            pass
666        bogus_key = 0
667        while len(_strptime._regex_cache) <= _strptime._CACHE_MAX_SIZE:
668            _strptime._regex_cache[bogus_key] = None
669            bogus_key += 1
670        _strptime._strptime_time("10", "%d")
671        self.assertEqual(len(_strptime._regex_cache), 1)
672
673    def test_new_localetime(self):
674        # A new LocaleTime instance should be created when a new TimeRE object
675        # is created.
676        locale_time_id = _strptime._TimeRE_cache.locale_time
677        _strptime._TimeRE_cache.locale_time.lang = "Ni"
678        _strptime._strptime_time("10", "%d")
679        self.assertIsNot(locale_time_id, _strptime._TimeRE_cache.locale_time)
680
681    def test_TimeRE_recreation_locale(self):
682        # The TimeRE instance should be recreated upon changing the locale.
683        locale_info = locale.getlocale(locale.LC_TIME)
684        try:
685            locale.setlocale(locale.LC_TIME, ('en_US', 'UTF8'))
686        except locale.Error:
687            self.skipTest('test needs en_US.UTF8 locale')
688        try:
689            _strptime._strptime_time('10', '%d')
690            # Get id of current cache object.
691            first_time_re = _strptime._TimeRE_cache
692            try:
693                # Change the locale and force a recreation of the cache.
694                locale.setlocale(locale.LC_TIME, ('de_DE', 'UTF8'))
695                _strptime._strptime_time('10', '%d')
696                # Get the new cache object's id.
697                second_time_re = _strptime._TimeRE_cache
698                # They should not be equal.
699                self.assertIsNot(first_time_re, second_time_re)
700            # Possible test locale is not supported while initial locale is.
701            # If this is the case just suppress the exception and fall-through
702            # to the resetting to the original locale.
703            except locale.Error:
704                self.skipTest('test needs de_DE.UTF8 locale')
705        # Make sure we don't trample on the locale setting once we leave the
706        # test.
707        finally:
708            locale.setlocale(locale.LC_TIME, locale_info)
709
710    @support.run_with_tz('STD-1DST,M4.1.0,M10.1.0')
711    def test_TimeRE_recreation_timezone(self):
712        # The TimeRE instance should be recreated upon changing the timezone.
713        oldtzname = time.tzname
714        tm = _strptime._strptime_time(time.tzname[0], '%Z')
715        self.assertEqual(tm.tm_isdst, 0)
716        tm = _strptime._strptime_time(time.tzname[1], '%Z')
717        self.assertEqual(tm.tm_isdst, 1)
718        # Get id of current cache object.
719        first_time_re = _strptime._TimeRE_cache
720        # Change the timezone and force a recreation of the cache.
721        os.environ['TZ'] = 'EST+05EDT,M3.2.0,M11.1.0'
722        time.tzset()
723        tm = _strptime._strptime_time(time.tzname[0], '%Z')
724        self.assertEqual(tm.tm_isdst, 0)
725        tm = _strptime._strptime_time(time.tzname[1], '%Z')
726        self.assertEqual(tm.tm_isdst, 1)
727        # Get the new cache object's id.
728        second_time_re = _strptime._TimeRE_cache
729        # They should not be equal.
730        self.assertIsNot(first_time_re, second_time_re)
731        # Make sure old names no longer accepted.
732        with self.assertRaises(ValueError):
733            _strptime._strptime_time(oldtzname[0], '%Z')
734        with self.assertRaises(ValueError):
735            _strptime._strptime_time(oldtzname[1], '%Z')
736
737
738if __name__ == '__main__':
739    unittest.main()
740