Source code for unit.config.dateformatparser

# Copyright (C) 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018  Rickard Lindberg, Roger Lindberg
#
# This file is part of Timeline.
#
# Timeline is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# Timeline is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with Timeline.  If not, see <http://www.gnu.org/licenses/>.



"""
Tests for the DateFormatParser class.

:doc:`Source is found here <timelinelib_config_dateformatparser>`.
"""


from timelinelib.config.dateformatparser import DateFormatParser
from timelinelib.config.dateformatparser import YEAR, MONTH, DAY
from timelinelib.test.cases.unit import UnitTestCase



[docs]class describe_date_fromat_parser(UnitTestCase):


[docs]    def test_valid_parse_returns_separator_tuple(self):
        """ """
        data = (
            ("yyyy-mm/dd", ("-", "/")),
            ("yyyy-dd/mm", ("-", "/")),
            ("dd-yyyy/mm", ("-", "/")),
            ("dd-mm/yyyy", ("-", "/")),
            ("mm-yyyy/dd", ("-", "/")),
            ("mm-dd/yyyy", ("-", "/")),
            ("yyyy-mmm/dd", ("-", "/")),
            ("yyyy-dd/mmm", ("-", "/")),
            ("dd-yyyy/mmm", ("-", "/")),
            ("dd-mmm/yyyy", ("-", "/")),
            ("mmm-yyyy/dd", ("-", "/")),
            ("mmm-dd/yyyy", ("-", "/")),
        )
        for format_string, expected_separator_tuple in data:
            parser_result = self.parser.parse(format_string)
            self.assertEqual(expected_separator_tuple,
                             parser_result.get_separators())



[docs]    def test_parse_recognizes_muliple_char_separators(self):
        """ """
        self.parser.parse("yyyy-mm-xx-dd")
        self.assertEqual(self.parser.get_separators(), ("-", "-xx-"))



[docs]    def test_parse_recognizes_month_names_format(self):
        """ """
        self.parser.parse("yyyy-mmm-dd")
        self.assertEqual(self.parser.get_separators(), ("-", "-"))



[docs]    def test_valid_formats(self):
        """ """
        formats = ("yyyy-mm-dd",
                   "yyyy-dd-mm",
                   "mm-yyyy-dd",
                   "mm-dd-yyyy",
                   "dd-yyyy-mm",
                   "dd-mm-yyyy",
                   "mm-dd-yyyy",
                   "dd-yyyy-mm",
                   "yyyy-dd-mm",
                   "dd-mm-yyyy",
                   "mm-yyyy-dd",
                   "yyyy-xx-mm-dd",
                   )
        for fmt in formats:
            self.assertTrue(self.parser.is_valid(fmt))



[docs]    def test_invalid_formats(self):
        """ """
        formats = ("yyyy-mm",
                   "mm-dd-",
                   "xxxxxxxxxx",
                   "yyyy-xxxxx",
                   "yyyy-mm-xx",
                   "yyyy-mm-mm-dd",
                   "-yyyy-xx-mm-dd",
                   "yyyy-mm-dd-",
                   )
        for fmt in formats:
            self.assertFalse(self.parser.is_valid(fmt))



[docs]    def test_parse_regions(self):
        """ """
        self.parser.parse("yyyy-mm-dd")
        self.assertEqual(self.parser.regions, [[0, 4, "", YEAR], [5, 2, "-", MONTH], [8, 2, "-", DAY]])



[docs]    def test_can_parse_region_order(self):
        """ """
        self.parser.parse("yyyy-mm-dd")
        self.assertEqual(self.parser.get_region_order(), (0, 1, 2))



[docs]    def test_can_parse_different_region_order(self):
        """ """
        self.parser.parse("dd-yyyy-mm")
        self.assertEqual(self.parser.get_region_order(), (1, 2, 0))



[docs]    def test_can_detect_usage_of_abbreviated_month_names(self):
        """ """
        self.parser.parse("dd-yyyy-mmm")
        self.assertEqual(self.parser.use_abbreviated_month_names(), True)



[docs]    def setUp(self):
        UnitTestCase.setUp(self)
        self.parser = DateFormatParser()