Merge pull request #59 from kinegratii/develop

Release v4.1.1

borax/__init__.py

@@ -1,2 +1,2 @@
-__version__ = '4.1.0'
+__version__ = '4.1.1'
 __author__ = 'kinegratii'

borax/calendars/festivals2.py

@@ -30,6 +30,8 @@ class FreqConst:
  YEARLY = 0
  MONTHLY = 1
 
+ LABEL2VAL = {'monthly': 1, 'yearly': 0, 'm': 1, 'y': 0}
+
 
 class FestivalCatalog:
  basic = 'basic'
@@ -167,17 +169,19 @@ class Period:
  """A shortcut methods for some specified date Period."""
 
  @staticmethod
- def solar_year(year: int) -> Tuple[date, date]:
- return date(year, 1, 1), date(year, 12, 31)
+ def solar_year(year: int, end_year: int = 0) -> Tuple[date, date]:
+ end_year = end_year or year
+ return date(year, 1, 1), date(end_year, 12, 31)
 
  @staticmethod
  def solar_month(year: int, month: int) -> Tuple[date, date]:
  ndays = calendar.monthrange(year, month)[1]
  return date(year, month, 1), date(year, month, ndays)
 
  @staticmethod
- def lunar_year(year: int) -> Tuple[LunarDate, LunarDate]:
- return LunarDate(year, 1, 1), LunarDate(year + 1, 1, 1) - timedelta(days=1)
+ def lunar_year(year: int, end_year: int = 0) -> Tuple[LunarDate, LunarDate]:
+ end_year = end_year or year
+ return LunarDate(year, 1, 1), LunarDate.last_day(end_year)
 
  @staticmethod
  def lunar_month(year: int, month: int, leap: int = _IGNORE_LEAP_MONTH) -> Tuple[LunarDate, LunarDate]:
@@ -460,12 +464,17 @@ class SolarFestival(Festival):
  """
  date_class = date
 
- def __init__(self, *, day: int, freq: int = FreqConst.YEARLY, month: int = 0, name: str = None):
+ def __init__(self, *, day: int, freq: Union[int, Literal['yearly', 'monthly', 'y', 'm']] = FreqConst.YEARLY,
+ month: int = 0, name: str = None):
  if day < 0:
  day = -day
  reverse = 1
  else:
  reverse = 0
+ if isinstance(freq, str):
+ freq = FreqConst.LABEL2VAL.get(freq, -1)
+ if freq == -1:
+ raise ValueError('Invalid freq string.')
  super().__init__(name=name, freq=freq, month=month, day=day, reverse=reverse, schema=FestivalSchema.SOLAR)
 
  def _get_description(self) -> str:
@@ -680,13 +689,17 @@ class LunarFestival(Festival):
  """
  date_class = LunarDate
 
- def __init__(self, *, day: int, freq: int = FreqConst.YEARLY, month: int = 0, leap: int = _IGNORE_LEAP_MONTH,
- name: str = None):
+ def __init__(self, *, day: int, freq: Union[int, Literal['yearly', 'monthly', 'y', 'm']] = FreqConst.YEARLY,
+ month: int = 0, leap: int = _IGNORE_LEAP_MONTH, name: str = None):
  if day < 0:
  day = -day
  reverse = 1
  else:
  reverse = 0
+ if isinstance(freq, str):
+ freq = FreqConst.LABEL2VAL.get(freq, -1)
+ if freq == -1:
+ raise ValueError('Invalid freq string.')
  super().__init__(freq=freq, name=name, month=month, day=day, leap=leap, reverse=reverse,
  schema=FestivalSchema.LUNAR)
 

borax/calendars/lunardate.py

@@ -658,6 +658,24 @@ def tomorrow(cls) -> 'LunarDate':
  sd = datetime.date.today() + datetime.timedelta(days=1)
  return cls.from_solar_date(sd.year, sd.month, sd.day)
 
+ @classmethod
+ def last_day(cls, year: int, month: int = 0, leap: int = 0) -> 'LunarDate':
+ """return the last day in a lunar year or a lunar month."""
+ mdls = list(LCalendars.iter_year_month(year))
+ if month == 0:
+ index = -1
+ else:
+ leap_month_of_year = LCalendars.leap_month(year)
+ if leap:
+ if month == leap_month_of_year:
+ index = month
+ else:
+ raise InvalidLunarDateError(f'{year=}, {month=},leap=1 does not exist.')
+ else:
+ index = month - 1 + int(leap_month_of_year and month > leap_month_of_year)
+ month, day, leap = mdls[index]
+ return cls(year, month, day, leap)
+
  @classmethod
  def strptime(cls, date_str: str, date_fmt: str) -> 'LunarDate':
  """Parse a LunarDate object from a whole string.
@@ -678,7 +696,7 @@ def __sub__(self, other):
  :param other: a instance of LunarDate / date / timedelta
  :return:
  """
- if hasattr(other, 'solar'):
+ if hasattr(other, 'solar'): # For WrappedDate in festivals2 module
  return self.to_solar_date() - other.solar
  elif isinstance(other, LunarDate):
  return self.to_solar_date() - other.to_solar_date()

borax/capp/borax_calendar_app.py

@@ -15,6 +15,7 @@
 from borax.calendars.ui import CalendarFrame, FestivalTableFrame
 from borax.calendars.utils import ThreeNineUtils
 from borax.capp.festival_creator import FestivalCreatePanel
+from borax.ui.widgets import MessageLabel
 
 library = FestivalLibrary.load_builtin().sort_by_countdown()
 
@@ -82,7 +83,7 @@ def __init__(self, master=None):
 
  ttk.Button(self._tool_form_frame, text='计算', command=self.run_date_delta).grid(
  row=2, column=0, columnspan=4, pady=8)
- self.result1_label = ttk.Label(self._tool_form_frame, text='')
+ self.result1_label = MessageLabel(self._tool_form_frame, text='')
  self.result1_label.grid(row=3, column=0, columnspan=4)
  notebook.add(self._tool_form_frame, text='日期间隔', padding=4)
 
@@ -104,7 +105,7 @@ def __init__(self, master=None):
  delta_days_com.grid(row=2, column=2, columnspan=2, sticky=tk.E + tk.W + tk.N + tk.S)
  ttk.Button(deduction_frame, text='计算', command=self.run_date_deduction).grid(
  row=3, column=0, columnspan=4, pady=8)
- self.result2_label = ttk.Label(deduction_frame, text='')
+ self.result2_label = MessageLabel(deduction_frame, text='')
  self.result2_label.grid(row=4, column=0, columnspan=4)
  # init
  self.day_delta_s.set(1)
@@ -131,17 +132,17 @@ def run_date_delta(self):
  d1, d2 = self._data_stores['d1'].get_date(), self._data_stores['d2'].get_date()
  if d1 and d2:
  ndays = (d2.solar - d1.solar).days
- self.result1_label.config(text=f'相差 {ndays} 天')
+ self.result1_label.show_text(text=f'相差 {ndays} 天')
  else:
- self.result1_label.config(text='未选择日期，无法计算')
+ self.result1_label.show_error_splash(text='未选择日期，无法计算')
 
  def run_date_deduction(self):
  d3 = self._data_stores['d3'].get_date()
  if d3:
  result2 = d3 + timedelta(self.day_delta_s.get() * self.delta_days.get())
- self.result2_label.config(text=str(result2))
+ self.result2_label.show_text(str(result2))
  else:
- self.result2_label.config(text='未选择日期，无法计算')
+ self.result2_label.show_error_splash(text='未选择日期，无法计算')
 
 
 class DateDetailFrame(ttk.LabelFrame):