persiantools 4.1.0__tar.gz → 4.1.2__tar.gz

{persiantools-4.1.0/persiantools.egg-info → persiantools-4.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: persiantools
-Version: 4.1.0
+Version: 4.1.2
 Summary: Jalali date and datetime with other tools
 Home-page: https://github.com/majiidd/persiantools
 Author: Majid Hajiloo

{persiantools-4.1.0 → persiantools-4.1.2}/persiantools/__init__.py

@@ -7,7 +7,7 @@
 
 __title__ = "persiantools"
 __url__ = "https://github.com/majiidd/persiantools"
-__version__ = "4.1.0"
+__version__ = "4.1.2"
 __build__ = __version__
 __author__ = "Majid Hajiloo"
 __author_email__ = "majid.hajiloo@gmail.com"

{persiantools-4.1.0 → persiantools-4.1.2}/persiantools/jdatetime.py

@@ -129,6 +129,12 @@ _MONTH_COUNT = [
     [29, 30, 336],  # esfand
 ]
 
+_FRACTION_CORRECTION = [100000, 10000, 1000, 100, 10]
+
+
+def _is_ascii_digit(c):
+    return c in "0123456789"
+
 
 class JalaliDate:
     """
@@ -558,12 +564,20 @@ class JalaliDate:
         if not isinstance(date_string, str):
             raise TypeError("fromisoformat: argument must be str")
 
-        return cls(*cls._parse_isoformat_date(digits.fa_to_en(date_string)))
+        if len(date_string) not in (7, 8, 10):
+            raise ValueError(f"Invalid isoformat string: {date_string!r}")
+
+        try:
+            return cls(*cls._parse_isoformat_date(digits.fa_to_en(date_string)))
+        except Exception:
+            raise ValueError(f"Invalid isoformat string: {date_string!r}")
 
     @classmethod
     def _parse_isoformat_date(cls, dtstr):
         # It is assumed that this function will only be called with a
         # string of length exactly 10, and (though this is not used) ASCII-only
+        assert len(dtstr) in (7, 8, 10)
+
         year = int(dtstr[0:4])
         if dtstr[4] != "-":
             raise ValueError("Invalid date separator: %s" % dtstr[4])
@@ -952,7 +966,7 @@ class JalaliDateTime(JalaliDate):
 
     @classmethod
     def utcfromtimestamp(cls, t):
-        return cls(dt.utcfromtimestamp(t))
+        return cls(dt.fromtimestamp(t, tz=timezone.utc))
 
     def date(self):
         return JalaliDate(self.year, self.month, self.day).to_gregorian()
@@ -1025,7 +1039,187 @@ class JalaliDateTime(JalaliDate):
 
     @classmethod
     def utcnow(cls):
-        return cls(dt.utcnow())
+        return cls(dt.now(tz=timezone.utc))
+
+    @classmethod
+    def fromisoformat(cls, date_string):
+        """Construct a datetime from a string in one of the ISO 8601 formats."""
+        if not isinstance(date_string, str):
+            raise TypeError("fromisoformat: argument must be str")
+
+        if len(date_string) < 7:
+            raise ValueError(f"Invalid isoformat string: {date_string!r}")
+
+        # Split this at the separator
+        try:
+            separator_location = cls._find_isoformat_datetime_separator(date_string)
+            dstr = date_string[0:separator_location]
+            tstr = date_string[(separator_location + 1) :]
+
+            date_components = cls._parse_isoformat_date(dstr)
+        except ValueError:
+            raise ValueError(f"Invalid isoformat string: {date_string!r}") from None
+
+        if tstr:
+            try:
+                time_components = cls._parse_isoformat_time(tstr)
+            except ValueError:
+                raise ValueError(f"Invalid isoformat string: {date_string!r}") from None
+        else:
+            time_components = [0, 0, 0, 0, None]
+
+        return cls(*(date_components + time_components))
+
+    @classmethod
+    def _find_isoformat_datetime_separator(cls, dtstr):
+        # See the comment in _datetimemodule.c:_find_isoformat_datetime_separator
+        len_dtstr = len(dtstr)
+        if len_dtstr == 7:
+            return 7
+
+        assert len_dtstr > 7
+        date_separator = "-"
+        week_indicator = "W"
+
+        if dtstr[4] == date_separator:
+            if dtstr[5] == week_indicator:
+                if len_dtstr < 8:
+                    raise ValueError("Invalid ISO string")
+                if len_dtstr > 8 and dtstr[8] == date_separator:
+                    if len_dtstr == 9:
+                        raise ValueError("Invalid ISO string")
+                    if len_dtstr > 10 and _is_ascii_digit(dtstr[10]):
+                        # This is as far as we need to resolve the ambiguity for
+                        # the moment - if we have YYYY-Www-##, the separator is
+                        # either a hyphen at 8 or a number at 10.
+                        #
+                        # We'll assume it's a hyphen at 8 because it's way more
+                        # likely that someone will use a hyphen as a separator than
+                        # a number, but at this point it's really best effort
+                        # because this is an extension of the spec anyway.
+                        # TODO(pganssle): Document this
+                        return 8
+                    return 10
+                else:
+                    # YYYY-Www (8)
+                    return 8
+            else:
+                # YYYY-MM-DD (10)
+                return 10
+        else:
+            if dtstr[4] == week_indicator:
+                # YYYYWww (7) or YYYYWwwd (8)
+                idx = 7
+                while idx < len_dtstr:
+                    if not _is_ascii_digit(dtstr[idx]):
+                        break
+                    idx += 1
+
+                if idx < 9:
+                    return idx
+
+                if idx % 2 == 0:
+                    # If the index of the last number is even, it's YYYYWwwd
+                    return 7
+                else:
+                    return 8
+            else:
+                # YYYYMMDD (8)
+                return 8
+
+    @classmethod
+    def _parse_isoformat_time(cls, tstr):
+        # Format supported is HH[:MM[:SS[.fff[fff]]]][+HH:MM[:SS[.ffffff]]]
+        len_str = len(tstr)
+        if len_str < 2:
+            raise ValueError("Isoformat time too short")
+
+        # This is equivalent to re.search('[+-Z]', tstr), but faster
+        tz_pos = tstr.find("-") + 1 or tstr.find("+") + 1 or tstr.find("Z") + 1
+        timestr = tstr[: tz_pos - 1] if tz_pos > 0 else tstr
+
+        time_comps = cls._parse_hh_mm_ss_ff(timestr)
+
+        tzi = None
+        if tz_pos == len_str and tstr[-1] == "Z":
+            tzi = timezone.utc
+        elif tz_pos > 0:
+            tzstr = tstr[tz_pos:]
+
+            # Valid time zone strings are:
+            # HH                  len: 2
+            # HHMM                len: 4
+            # HH:MM               len: 5
+            # HHMMSS              len: 6
+            # HHMMSS.f+           len: 7+
+            # HH:MM:SS            len: 8
+            # HH:MM:SS.f+         len: 10+
+
+            if len(tzstr) in (0, 1, 3):
+                raise ValueError("Malformed time zone string")
+
+            tz_comps = cls._parse_hh_mm_ss_ff(tzstr)
+
+            if all(x == 0 for x in tz_comps):
+                tzi = timezone.utc
+            else:
+                tzsign = -1 if tstr[tz_pos - 1] == "-" else 1
+
+                td = timedelta(hours=tz_comps[0], minutes=tz_comps[1], seconds=tz_comps[2], microseconds=tz_comps[3])
+
+                tzi = timezone(tzsign * td)
+
+        time_comps.append(tzi)
+
+        return time_comps
+
+    @classmethod
+    def _parse_hh_mm_ss_ff(cls, tstr):
+        # Parses things of the form HH[:?MM[:?SS[{.,}fff[fff]]]]
+        len_str = len(tstr)
+
+        time_comps = [0, 0, 0, 0]
+        pos = 0
+        for comp in range(0, 3):
+            if (len_str - pos) < 2:
+                raise ValueError("Incomplete time component")
+
+            time_comps[comp] = int(tstr[pos : pos + 2])
+
+            pos += 2
+            next_char = tstr[pos : pos + 1]
+
+            if comp == 0:
+                has_sep = next_char == ":"
+
+            if not next_char or comp >= 2:
+                break
+
+            if has_sep and next_char != ":":
+                raise ValueError("Invalid time separator: %c" % next_char)
+
+            pos += has_sep
+
+        if pos < len_str:
+            if tstr[pos] not in ".,":
+                raise ValueError("Invalid microsecond component")
+            else:
+                pos += 1
+
+                len_remainder = len_str - pos
+
+                if len_remainder >= 6:
+                    to_parse = 6
+                else:
+                    to_parse = len_remainder
+
+                time_comps[3] = int(tstr[pos : (pos + to_parse)])
+                if to_parse < 6:
+                    time_comps[3] *= _FRACTION_CORRECTION[to_parse - 1]
+                if len_remainder > to_parse and not all(map(_is_ascii_digit, tstr[(pos + to_parse) :])):
+                    raise ValueError("Non-digit values in unparsed fraction")
+
+        return time_comps
 
     @staticmethod
     def _check_tzinfo_arg(tz):
@@ -1428,7 +1622,7 @@ class JalaliDateTime(JalaliDate):
             "%S": "%02d" % self._second,
             "%f": "%06d" % self._microsecond,
             "%z": datetime.strftime("%z"),
-            "%Z": ("" if not self._tzinfo else self._tzinfo.tzname(self)),
+            "%Z": ("" if not self._tzinfo else self._tzinfo.tzname(datetime)),
             "%X": "%02d:%02d:%02d" % (self._hour, self._minute, self._second),
         }
 

{persiantools-4.1.0 → persiantools-4.1.2/persiantools.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: persiantools
-Version: 4.1.0
+Version: 4.1.2
 Summary: Jalali date and datetime with other tools
 Home-page: https://github.com/majiidd/persiantools
 Author: Majid Hajiloo

{persiantools-4.1.0 → persiantools-4.1.2}/tests/test_jalalidate.py

@@ -278,7 +278,7 @@ class TestJalaliDate(TestCase):
         with pytest.raises(TypeError):
             JalaliDate.fromisoformat(13670214)
 
-        with pytest.raises(ValueError, match="Invalid date separator: /"):
+        with pytest.raises(ValueError):
             JalaliDate.fromisoformat("1367/02/14")
 
         with pytest.raises(ValueError):

{persiantools-4.1.0 → persiantools-4.1.2}/tests/test_jalalidatetime.py

@@ -9,7 +9,7 @@ from unittest import TestCase
 import pytest
 import pytz
 
-from persiantools.jdatetime import JalaliDate, JalaliDateTime
+from persiantools.jdatetime import JalaliDate, JalaliDateTime, _is_ascii_digit
 
 
 class TestJalaliDateTime(TestCase):
@@ -64,7 +64,7 @@ class TestJalaliDateTime(TestCase):
         )
         self.assertEqual(
             JalaliDateTime.utcfromtimestamp(578723400),
-            JalaliDateTime(1367, 2, 14, 4, 30, 0, 0),
+            JalaliDateTime(1367, 2, 14, 4, 30, 0, 0, tzinfo=timezone.utc),
         )
 
         with pytest.raises(TypeError):
@@ -376,7 +376,7 @@ class TestJalaliDateTime(TestCase):
             JalaliDateTime.strptime(date_string, fmt, locale="invalid")
 
     def test_utcnow(self):
-        now_utc = datetime.utcnow()
+        now_utc = datetime.now(timezone.utc)
         jalali_now = JalaliDateTime.utcnow()
         gregorian_now = jalali_now.to_gregorian()
 
@@ -546,3 +546,94 @@ class TestJalaliDateTime(TestCase):
         expected = timedelta(days=1)
 
         self.assertEqual(result, expected)
+
+    def test_to_jalali_with_timezone(self):
+        dt = datetime.now(timezone.utc)
+        jdate = JalaliDateTime.to_jalali(dt)
+        self.assertEqual(jdate.tzinfo, timezone.utc)
+
+    def test_strftime_basic(self):
+        jdate = JalaliDateTime(1400, 1, 1, 15, 30, 45)
+        self.assertEqual(jdate.strftime("%Y-%m-%d %H:%M:%S"), "1400-01-01 15:30:45")
+
+    def test_strftime_locale_fa(self):
+        jdate = JalaliDateTime(1400, 1, 1, 15, 30, 45, locale="fa")
+        self.assertEqual(jdate.strftime("%Y-%m-%d %H:%M:%S", locale="fa"), "۱۴۰۰-۰۱-۰۱ ۱۵:۳۰:۴۵")
+
+    def test_strftime_with_timezone_utc(self):
+        jdate = JalaliDateTime(1400, 1, 1, 15, 30, 45, tzinfo=timezone.utc)
+        self.assertEqual(jdate.strftime("%Y-%m-%d %H:%M:%S %Z"), "1400-01-01 15:30:45 UTC")
+
+    def test_strftime_with_timezone_offset(self):
+        tz = timezone(timedelta(hours=3, minutes=30))
+        jdate = JalaliDateTime(1400, 1, 1, 15, 30, 45, tzinfo=tz)
+        self.assertEqual(jdate.strftime("%Y-%m-%d %H:%M:%S %z"), "1400-01-01 15:30:45 +0330")
+
+    def test_strftime_with_abbreviated_month_day(self):
+        jdate = JalaliDateTime(1400, 1, 1, 15, 30, 45)
+        self.assertEqual(jdate.strftime("%b %a"), "Far Yek")
+
+    def test_strftime_with_full_month_day(self):
+        jdate = JalaliDateTime(1400, 1, 1, 15, 30, 45)
+        self.assertEqual(jdate.strftime("%B %A"), "Farvardin Yekshanbeh")
+
+    def test_strftime_with_custom_format(self):
+        jdate = JalaliDateTime(1400, 1, 1, 15, 30, 45)
+        self.assertEqual(jdate.strftime("%d %B %Y - %H:%M"), "01 Farvardin 1400 - 15:30")
+
+    def test_strftime_with_persian_locale(self):
+        jdate = JalaliDateTime(1400, 1, 1, 15, 30, 45, locale="fa")
+        self.assertEqual(jdate.strftime("%A, %d %B %Y - %H:%M", locale="fa"), "یکشنبه, ۰۱ فروردین ۱۴۰۰ - ۱۵:۳۰")
+
+    def test_strftime_with_periodic_time(self):
+        jdate = JalaliDateTime(1400, 1, 1, 15, 30, 45)
+        self.assertEqual(jdate.strftime("%I:%M %p"), "03:30 PM")
+
+    def test_strftime_edge_case_midnight(self):
+        jdate = JalaliDateTime(1400, 1, 1, 0, 0, 0)
+        self.assertEqual(jdate.strftime("%Y-%m-%d %H:%M:%S"), "1400-01-01 00:00:00")
+
+    def test_fromisoformat_valid_date_and_time(self):
+        jdt = JalaliDateTime.fromisoformat("1403-08-09T02:21:45.123456+04:30")
+        self.assertEqual(jdt.year, 1403)
+        self.assertEqual(jdt.month, 8)
+        self.assertEqual(jdt.day, 9)
+        self.assertEqual(jdt.hour, 2)
+        self.assertEqual(jdt.minute, 21)
+        self.assertEqual(jdt.second, 45)
+        self.assertEqual(jdt.microsecond, 123456)
+        self.assertEqual(jdt.tzinfo, timezone(timedelta(hours=4, minutes=30)))
+
+    def test_fromisoformat_with_timezone(self):
+        jdt = JalaliDateTime.fromisoformat("1403-08-09T02:21:45+04:30")
+        self.assertEqual(jdt.tzinfo, timezone(timedelta(hours=4, minutes=30)))
+
+    def test_fromisoformat_invalid_string(self):
+        with self.assertRaises(ValueError):
+            JalaliDateTime.fromisoformat("invalid-date-time")
+
+    def test_find_isoformat_datetime_separator(self):
+        separator = JalaliDateTime._find_isoformat_datetime_separator("1403-08-09T02:21:45")
+        self.assertEqual(separator, 10)
+
+    def test_parse_isoformat_time_with_microseconds(self):
+        time_components = JalaliDateTime._parse_isoformat_time("02:21:45.123456")
+        self.assertEqual(time_components, [2, 21, 45, 123456, None])
+
+    def test_parse_isoformat_time_with_timezone(self):
+        time_components = JalaliDateTime._parse_isoformat_time("02:21:45+04:30")
+        self.assertEqual(time_components, [2, 21, 45, 0, timezone(timedelta(hours=4, minutes=30))])
+
+    def test_parse_hh_mm_ss_ff_with_microseconds(self):
+        time_components = JalaliDateTime._parse_hh_mm_ss_ff("02:21:45.123456")
+        self.assertEqual(time_components, [2, 21, 45, 123456])
+
+    def test_is_ascii_digit(self):
+        self.assertTrue(_is_ascii_digit("5"))
+        self.assertFalse(_is_ascii_digit("a"))
+
+    def test_isoformat_round_trip(self):
+        original = JalaliDateTime(1403, 8, 9, 2, 21, 45, 123456, tzinfo=timezone.utc)
+        iso_format = original.isoformat()
+        parsed = JalaliDateTime.fromisoformat(iso_format)
+        self.assertEqual(original, parsed)