test_schedules.py 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772
  1. from __future__ import absolute_import, unicode_literals
  2. import pytest
  3. import time
  4. from contextlib import contextmanager
  5. from datetime import datetime, timedelta
  6. from pickle import dumps, loads
  7. from case import Case, Mock, skip
  8. from celery.five import items
  9. from celery.schedules import (
  10. ParseException, crontab, crontab_parser, schedule, solar,
  11. )
  12. assertions = Case('__init__')
  13. @contextmanager
  14. def patch_crontab_nowfun(cls, retval):
  15. prev_nowfun = cls.nowfun
  16. cls.nowfun = lambda: retval
  17. try:
  18. yield
  19. finally:
  20. cls.nowfun = prev_nowfun
  21. @skip.unless_module('ephem')
  22. class test_solar:
  23. def setup(self):
  24. self.s = solar('sunrise', 60, 30, app=self.app)
  25. def test_reduce(self):
  26. fun, args = self.s.__reduce__()
  27. assert fun(*args) == self.s
  28. def test_eq(self):
  29. assert self.s == solar('sunrise', 60, 30, app=self.app)
  30. assert self.s != solar('sunset', 60, 30, app=self.app)
  31. assert self.s != schedule(10)
  32. def test_repr(self):
  33. assert repr(self.s)
  34. def test_is_due(self):
  35. self.s.remaining_estimate = Mock(name='rem')
  36. self.s.remaining_estimate.return_value = timedelta(seconds=0)
  37. assert self.s.is_due(datetime.utcnow()).is_due
  38. def test_is_due__not_due(self):
  39. self.s.remaining_estimate = Mock(name='rem')
  40. self.s.remaining_estimate.return_value = timedelta(hours=10)
  41. assert not self.s.is_due(datetime.utcnow()).is_due
  42. def test_remaining_estimate(self):
  43. self.s.cal = Mock(name='cal')
  44. self.s.cal.next_rising().datetime.return_value = datetime.utcnow()
  45. self.s.remaining_estimate(datetime.utcnow())
  46. def test_coordinates(self):
  47. with pytest.raises(ValueError):
  48. solar('sunrise', -120, 60, app=self.app)
  49. with pytest.raises(ValueError):
  50. solar('sunrise', 120, 60, app=self.app)
  51. with pytest.raises(ValueError):
  52. solar('sunrise', 60, -200, app=self.app)
  53. with pytest.raises(ValueError):
  54. solar('sunrise', 60, 200, app=self.app)
  55. def test_invalid_event(self):
  56. with pytest.raises(ValueError):
  57. solar('asdqwewqew', 60, 60, app=self.app)
  58. def test_event_uses_center(self):
  59. s = solar('solar_noon', 60, 60, app=self.app)
  60. for ev, is_center in s._use_center_l.items():
  61. s.method = s._methods[ev]
  62. s.is_center = s._use_center_l[ev]
  63. try:
  64. s.remaining_estimate(datetime.utcnow())
  65. except TypeError:
  66. pytest.fail("{0} was called with 'use_center' which is not a \
  67. valid keyword for the function.".format(s.method))
  68. class test_schedule:
  69. def test_ne(self):
  70. s1 = schedule(10, app=self.app)
  71. s2 = schedule(12, app=self.app)
  72. s3 = schedule(10, app=self.app)
  73. assert s1 == s3
  74. assert s1 != s2
  75. def test_pickle(self):
  76. s1 = schedule(10, app=self.app)
  77. fun, args = s1.__reduce__()
  78. s2 = fun(*args)
  79. assert s1 == s2
  80. # This is needed for test_crontab_parser because datetime.utcnow doesn't pickle
  81. # in python 2
  82. def utcnow():
  83. return datetime.utcnow()
  84. class test_crontab_parser:
  85. def crontab(self, *args, **kwargs):
  86. return crontab(*args, **dict(kwargs, app=self.app))
  87. def test_crontab_reduce(self):
  88. c = self.crontab('*')
  89. assert c == loads(dumps(c))
  90. c = self.crontab(
  91. minute='1',
  92. hour='2',
  93. day_of_week='3',
  94. day_of_month='4',
  95. month_of_year='5',
  96. nowfun=utcnow)
  97. assert c == loads(dumps(c))
  98. def test_range_steps_not_enough(self):
  99. with pytest.raises(crontab_parser.ParseException):
  100. crontab_parser(24)._range_steps([1])
  101. def test_parse_star(self):
  102. assert crontab_parser(24).parse('*') == set(range(24))
  103. assert crontab_parser(60).parse('*') == set(range(60))
  104. assert crontab_parser(7).parse('*') == set(range(7))
  105. assert crontab_parser(31, 1).parse('*') == set(range(1, 31 + 1))
  106. assert crontab_parser(12, 1).parse('*') == set(range(1, 12 + 1))
  107. def test_parse_range(self):
  108. assert crontab_parser(60).parse('1-10') == set(range(1, 10 + 1))
  109. assert crontab_parser(24).parse('0-20') == set(range(0, 20 + 1))
  110. assert crontab_parser().parse('2-10') == set(range(2, 10 + 1))
  111. assert crontab_parser(60, 1).parse('1-10') == set(range(1, 10 + 1))
  112. def test_parse_range_wraps(self):
  113. assert crontab_parser(12).parse('11-1') == {11, 0, 1}
  114. assert crontab_parser(60, 1).parse('2-1') == set(range(1, 60 + 1))
  115. def test_parse_groups(self):
  116. assert crontab_parser().parse('1,2,3,4') == {1, 2, 3, 4}
  117. assert crontab_parser().parse('0,15,30,45') == {0, 15, 30, 45}
  118. assert crontab_parser(min_=1).parse('1,2,3,4') == {1, 2, 3, 4}
  119. def test_parse_steps(self):
  120. assert crontab_parser(8).parse('*/2') == {0, 2, 4, 6}
  121. assert crontab_parser().parse('*/2') == {i * 2 for i in range(30)}
  122. assert crontab_parser().parse('*/3') == {i * 3 for i in range(20)}
  123. assert crontab_parser(8, 1).parse('*/2') == {1, 3, 5, 7}
  124. assert crontab_parser(min_=1).parse('*/2') == {
  125. i * 2 + 1 for i in range(30)
  126. }
  127. assert crontab_parser(min_=1).parse('*/3') == {
  128. i * 3 + 1 for i in range(20)
  129. }
  130. def test_parse_composite(self):
  131. assert crontab_parser(8).parse('*/2') == {0, 2, 4, 6}
  132. assert crontab_parser().parse('2-9/5') == {2, 7}
  133. assert crontab_parser().parse('2-10/5') == {2, 7}
  134. assert crontab_parser(min_=1).parse('55-5/3') == {55, 58, 1, 4}
  135. assert crontab_parser().parse('2-11/5,3') == {2, 3, 7}
  136. assert crontab_parser().parse('2-4/3,*/5,0-21/4') == {
  137. 0, 2, 4, 5, 8, 10, 12, 15, 16, 20, 25, 30, 35, 40, 45, 50, 55,
  138. }
  139. assert crontab_parser().parse('1-9/2') == {1, 3, 5, 7, 9}
  140. assert crontab_parser(8, 1).parse('*/2') == {1, 3, 5, 7}
  141. assert crontab_parser(min_=1).parse('2-9/5') == {2, 7}
  142. assert crontab_parser(min_=1).parse('2-10/5') == {2, 7}
  143. assert crontab_parser(min_=1).parse('2-11/5,3') == {2, 3, 7}
  144. assert crontab_parser(min_=1).parse('2-4/3,*/5,1-21/4') == {
  145. 1, 2, 5, 6, 9, 11, 13, 16, 17, 21, 26, 31, 36, 41, 46, 51, 56,
  146. }
  147. assert crontab_parser(min_=1).parse('1-9/2') == {1, 3, 5, 7, 9}
  148. def test_parse_errors_on_empty_string(self):
  149. with pytest.raises(ParseException):
  150. crontab_parser(60).parse('')
  151. def test_parse_errors_on_empty_group(self):
  152. with pytest.raises(ParseException):
  153. crontab_parser(60).parse('1,,2')
  154. def test_parse_errors_on_empty_steps(self):
  155. with pytest.raises(ParseException):
  156. crontab_parser(60).parse('*/')
  157. def test_parse_errors_on_negative_number(self):
  158. with pytest.raises(ParseException):
  159. crontab_parser(60).parse('-20')
  160. def test_parse_errors_on_lt_min(self):
  161. crontab_parser(min_=1).parse('1')
  162. with pytest.raises(ValueError):
  163. crontab_parser(12, 1).parse('0')
  164. with pytest.raises(ValueError):
  165. crontab_parser(24, 1).parse('12-0')
  166. def test_parse_errors_on_gt_max(self):
  167. crontab_parser(1).parse('0')
  168. with pytest.raises(ValueError):
  169. crontab_parser(1).parse('1')
  170. with pytest.raises(ValueError):
  171. crontab_parser(60).parse('61-0')
  172. def test_expand_cronspec_eats_iterables(self):
  173. assert crontab._expand_cronspec(iter([1, 2, 3]), 100) == {1, 2, 3}
  174. assert crontab._expand_cronspec(iter([1, 2, 3]), 100, 1) == {1, 2, 3}
  175. def test_expand_cronspec_invalid_type(self):
  176. with pytest.raises(TypeError):
  177. crontab._expand_cronspec(object(), 100)
  178. def test_repr(self):
  179. assert '*' in repr(self.crontab('*'))
  180. def test_eq(self):
  181. assert (self.crontab(day_of_week='1, 2') ==
  182. self.crontab(day_of_week='1-2'))
  183. assert (self.crontab(day_of_month='1, 16, 31') ==
  184. self.crontab(day_of_month='*/15'))
  185. assert (
  186. self.crontab(
  187. minute='1', hour='2', day_of_week='5',
  188. day_of_month='10', month_of_year='5') ==
  189. self.crontab(
  190. minute='1', hour='2', day_of_week='5',
  191. day_of_month='10', month_of_year='5'))
  192. assert crontab(minute='1') != crontab(minute='2')
  193. assert (self.crontab(month_of_year='1') !=
  194. self.crontab(month_of_year='2'))
  195. assert object() != self.crontab(minute='1')
  196. assert self.crontab(minute='1') != object()
  197. assert crontab(month_of_year='1') != schedule(10)
  198. class test_crontab_remaining_estimate:
  199. def crontab(self, *args, **kwargs):
  200. return crontab(*args, **dict(kwargs, app=self.app))
  201. def next_ocurrance(self, crontab, now):
  202. crontab.nowfun = lambda: now
  203. return now + crontab.remaining_estimate(now)
  204. def test_next_minute(self):
  205. next = self.next_ocurrance(
  206. self.crontab(), datetime(2010, 9, 11, 14, 30, 15),
  207. )
  208. assert next == datetime(2010, 9, 11, 14, 31)
  209. def test_not_next_minute(self):
  210. next = self.next_ocurrance(
  211. self.crontab(), datetime(2010, 9, 11, 14, 59, 15),
  212. )
  213. assert next == datetime(2010, 9, 11, 15, 0)
  214. def test_this_hour(self):
  215. next = self.next_ocurrance(
  216. self.crontab(minute=[5, 42]), datetime(2010, 9, 11, 14, 30, 15),
  217. )
  218. assert next == datetime(2010, 9, 11, 14, 42)
  219. def test_not_this_hour(self):
  220. next = self.next_ocurrance(
  221. self.crontab(minute=[5, 10, 15]),
  222. datetime(2010, 9, 11, 14, 30, 15),
  223. )
  224. assert next == datetime(2010, 9, 11, 15, 5)
  225. def test_today(self):
  226. next = self.next_ocurrance(
  227. self.crontab(minute=[5, 42], hour=[12, 17]),
  228. datetime(2010, 9, 11, 14, 30, 15),
  229. )
  230. assert next == datetime(2010, 9, 11, 17, 5)
  231. def test_not_today(self):
  232. next = self.next_ocurrance(
  233. self.crontab(minute=[5, 42], hour=[12]),
  234. datetime(2010, 9, 11, 14, 30, 15),
  235. )
  236. assert next == datetime(2010, 9, 12, 12, 5)
  237. def test_weekday(self):
  238. next = self.next_ocurrance(
  239. self.crontab(minute=30, hour=14, day_of_week='sat'),
  240. datetime(2010, 9, 11, 14, 30, 15),
  241. )
  242. assert next == datetime(2010, 9, 18, 14, 30)
  243. def test_not_weekday(self):
  244. next = self.next_ocurrance(
  245. self.crontab(minute=[5, 42], day_of_week='mon-fri'),
  246. datetime(2010, 9, 11, 14, 30, 15),
  247. )
  248. assert next == datetime(2010, 9, 13, 0, 5)
  249. def test_monthday(self):
  250. next = self.next_ocurrance(
  251. self.crontab(minute=30, hour=14, day_of_month=18),
  252. datetime(2010, 9, 11, 14, 30, 15),
  253. )
  254. assert next == datetime(2010, 9, 18, 14, 30)
  255. def test_not_monthday(self):
  256. next = self.next_ocurrance(
  257. self.crontab(minute=[5, 42], day_of_month=29),
  258. datetime(2010, 1, 22, 14, 30, 15),
  259. )
  260. assert next == datetime(2010, 1, 29, 0, 5)
  261. def test_weekday_monthday(self):
  262. next = self.next_ocurrance(
  263. self.crontab(minute=30, hour=14,
  264. day_of_week='mon', day_of_month=18),
  265. datetime(2010, 1, 18, 14, 30, 15),
  266. )
  267. assert next == datetime(2010, 10, 18, 14, 30)
  268. def test_monthday_not_weekday(self):
  269. next = self.next_ocurrance(
  270. self.crontab(minute=[5, 42], day_of_week='sat', day_of_month=29),
  271. datetime(2010, 1, 29, 0, 5, 15),
  272. )
  273. assert next == datetime(2010, 5, 29, 0, 5)
  274. def test_weekday_not_monthday(self):
  275. next = self.next_ocurrance(
  276. self.crontab(minute=[5, 42], day_of_week='mon', day_of_month=18),
  277. datetime(2010, 1, 11, 0, 5, 15),
  278. )
  279. assert next == datetime(2010, 1, 18, 0, 5)
  280. def test_not_weekday_not_monthday(self):
  281. next = self.next_ocurrance(
  282. self.crontab(minute=[5, 42], day_of_week='mon', day_of_month=18),
  283. datetime(2010, 1, 10, 0, 5, 15),
  284. )
  285. assert next == datetime(2010, 1, 18, 0, 5)
  286. def test_leapday(self):
  287. next = self.next_ocurrance(
  288. self.crontab(minute=30, hour=14, day_of_month=29),
  289. datetime(2012, 1, 29, 14, 30, 15),
  290. )
  291. assert next == datetime(2012, 2, 29, 14, 30)
  292. def test_not_leapday(self):
  293. next = self.next_ocurrance(
  294. self.crontab(minute=30, hour=14, day_of_month=29),
  295. datetime(2010, 1, 29, 14, 30, 15),
  296. )
  297. assert next == datetime(2010, 3, 29, 14, 30)
  298. def test_weekmonthdayyear(self):
  299. next = self.next_ocurrance(
  300. self.crontab(minute=30, hour=14, day_of_week='fri',
  301. day_of_month=29, month_of_year=1),
  302. datetime(2010, 1, 22, 14, 30, 15),
  303. )
  304. assert next == datetime(2010, 1, 29, 14, 30)
  305. def test_monthdayyear_not_week(self):
  306. next = self.next_ocurrance(
  307. self.crontab(minute=[5, 42], day_of_week='wed,thu',
  308. day_of_month=29, month_of_year='1,4,7'),
  309. datetime(2010, 1, 29, 14, 30, 15),
  310. )
  311. assert next == datetime(2010, 4, 29, 0, 5)
  312. def test_weekdaymonthyear_not_monthday(self):
  313. next = self.next_ocurrance(
  314. self.crontab(minute=30, hour=14, day_of_week='fri',
  315. day_of_month=29, month_of_year='1-10'),
  316. datetime(2010, 1, 29, 14, 30, 15),
  317. )
  318. assert next == datetime(2010, 10, 29, 14, 30)
  319. def test_weekmonthday_not_monthyear(self):
  320. next = self.next_ocurrance(
  321. self.crontab(minute=[5, 42], day_of_week='fri',
  322. day_of_month=29, month_of_year='2-10'),
  323. datetime(2010, 1, 29, 14, 30, 15),
  324. )
  325. assert next == datetime(2010, 10, 29, 0, 5)
  326. def test_weekday_not_monthdayyear(self):
  327. next = self.next_ocurrance(
  328. self.crontab(minute=[5, 42], day_of_week='mon',
  329. day_of_month=18, month_of_year='2-10'),
  330. datetime(2010, 1, 11, 0, 5, 15),
  331. )
  332. assert next == datetime(2010, 10, 18, 0, 5)
  333. def test_monthday_not_weekdaymonthyear(self):
  334. next = self.next_ocurrance(
  335. self.crontab(minute=[5, 42], day_of_week='mon',
  336. day_of_month=29, month_of_year='2-4'),
  337. datetime(2010, 1, 29, 0, 5, 15),
  338. )
  339. assert next == datetime(2010, 3, 29, 0, 5)
  340. def test_monthyear_not_weekmonthday(self):
  341. next = self.next_ocurrance(
  342. self.crontab(minute=[5, 42], day_of_week='mon',
  343. day_of_month=29, month_of_year='2-4'),
  344. datetime(2010, 2, 28, 0, 5, 15),
  345. )
  346. assert next == datetime(2010, 3, 29, 0, 5)
  347. def test_not_weekmonthdayyear(self):
  348. next = self.next_ocurrance(
  349. self.crontab(minute=[5, 42], day_of_week='fri,sat',
  350. day_of_month=29, month_of_year='2-10'),
  351. datetime(2010, 1, 28, 14, 30, 15),
  352. )
  353. assert next == datetime(2010, 5, 29, 0, 5)
  354. def test_invalid_specification(self):
  355. # *** WARNING ***
  356. # This test triggers an infinite loop in case of a regression
  357. with pytest.raises(RuntimeError):
  358. self.next_ocurrance(
  359. self.crontab(day_of_month=31, month_of_year=4),
  360. datetime(2010, 1, 28, 14, 30, 15),
  361. )
  362. def test_leapyear(self):
  363. next = self.next_ocurrance(
  364. self.crontab(minute=30, hour=14, day_of_month=29, month_of_year=2),
  365. datetime(2012, 2, 29, 14, 30),
  366. )
  367. assert next == datetime(2016, 2, 29, 14, 30)
  368. class test_crontab_is_due:
  369. def setup(self):
  370. self.now = self.app.now()
  371. self.next_minute = 60 - self.now.second - 1e-6 * self.now.microsecond
  372. self.every_minute = self.crontab()
  373. self.quarterly = self.crontab(minute='*/15')
  374. self.hourly = self.crontab(minute=30)
  375. self.daily = self.crontab(hour=7, minute=30)
  376. self.weekly = self.crontab(hour=7, minute=30, day_of_week='thursday')
  377. self.monthly = self.crontab(
  378. hour=7, minute=30, day_of_week='thursday', day_of_month='8-14',
  379. )
  380. self.monthly_moy = self.crontab(
  381. hour=22, day_of_week='*', month_of_year='2',
  382. day_of_month='26,27,28',
  383. )
  384. self.yearly = self.crontab(
  385. hour=7, minute=30, day_of_week='thursday',
  386. day_of_month='8-14', month_of_year=3,
  387. )
  388. def crontab(self, *args, **kwargs):
  389. return crontab(*args, app=self.app, **kwargs)
  390. def test_default_crontab_spec(self):
  391. c = self.crontab()
  392. assert c.minute == set(range(60))
  393. assert c.hour == set(range(24))
  394. assert c.day_of_week == set(range(7))
  395. assert c.day_of_month == set(range(1, 32))
  396. assert c.month_of_year == set(range(1, 13))
  397. def test_simple_crontab_spec(self):
  398. c = self.crontab(minute=30)
  399. assert c.minute == {30}
  400. assert c.hour == set(range(24))
  401. assert c.day_of_week == set(range(7))
  402. assert c.day_of_month == set(range(1, 32))
  403. assert c.month_of_year == set(range(1, 13))
  404. @pytest.mark.parametrize('minute,expected', [
  405. (30, {30}),
  406. ('30', {30}),
  407. ((30, 40, 50), {30, 40, 50}),
  408. ((30, 40, 50, 51), {30, 40, 50, 51})
  409. ])
  410. def test_crontab_spec_minute_formats(self, minute, expected):
  411. c = self.crontab(minute=minute)
  412. assert c.minute == expected
  413. @pytest.mark.parametrize('minute', [60, '0-100'])
  414. def test_crontab_spec_invalid_minute(self, minute):
  415. with pytest.raises(ValueError):
  416. self.crontab(minute=minute)
  417. @pytest.mark.parametrize('hour,expected', [
  418. (6, {6}),
  419. ('5', {5}),
  420. ((4, 8, 12), {4, 8, 12}),
  421. ])
  422. def test_crontab_spec_hour_formats(self, hour, expected):
  423. c = self.crontab(hour=hour)
  424. assert c.hour == expected
  425. @pytest.mark.parametrize('hour', [24, '0-30'])
  426. def test_crontab_spec_invalid_hour(self, hour):
  427. with pytest.raises(ValueError):
  428. self.crontab(hour=hour)
  429. @pytest.mark.parametrize('day_of_week,expected', [
  430. (5, {5}),
  431. ('5', {5}),
  432. ('fri', {5}),
  433. ('tuesday,sunday,fri', {0, 2, 5}),
  434. ('mon-fri', {1, 2, 3, 4, 5}),
  435. ('*/2', {0, 2, 4, 6}),
  436. ])
  437. def test_crontab_spec_dow_formats(self, day_of_week, expected):
  438. c = self.crontab(day_of_week=day_of_week)
  439. assert c.day_of_week == expected
  440. @pytest.mark.parametrize('day_of_week', [
  441. 'fooday-barday', '1,4,foo', '7', '12',
  442. ])
  443. def test_crontab_spec_invalid_dow(self, day_of_week):
  444. with pytest.raises(ValueError):
  445. self.crontab(day_of_week=day_of_week)
  446. @pytest.mark.parametrize('day_of_month,expected', [
  447. (5, {5}),
  448. ('5', {5}),
  449. ('2,4,6', {2, 4, 6}),
  450. ('*/5', {1, 6, 11, 16, 21, 26, 31}),
  451. ])
  452. def test_crontab_spec_dom_formats(self, day_of_month, expected):
  453. c = self.crontab(day_of_month=day_of_month)
  454. assert c.day_of_month == expected
  455. @pytest.mark.parametrize('day_of_month', [0, '0-10', 32, '31,32'])
  456. def test_crontab_spec_invalid_dom(self, day_of_month):
  457. with pytest.raises(ValueError):
  458. self.crontab(day_of_month=day_of_month)
  459. @pytest.mark.parametrize('month_of_year,expected', [
  460. (1, {1}),
  461. ('1', {1}),
  462. ('2,4,6', {2, 4, 6}),
  463. ('*/2', {1, 3, 5, 7, 9, 11}),
  464. ('2-12/2', {2, 4, 6, 8, 10, 12}),
  465. ])
  466. def test_crontab_spec_moy_formats(self, month_of_year, expected):
  467. c = self.crontab(month_of_year=month_of_year)
  468. assert c.month_of_year == expected
  469. @pytest.mark.parametrize('month_of_year', [0, '0-5', 13, '12,13'])
  470. def test_crontab_spec_invalid_moy(self, month_of_year):
  471. with pytest.raises(ValueError):
  472. self.crontab(month_of_year=month_of_year)
  473. def seconds_almost_equal(self, a, b, precision):
  474. for index, skew in enumerate((+1, -1, 0)):
  475. try:
  476. assertions.assertAlmostEqual(a, b + skew, precision)
  477. except Exception as exc:
  478. # AssertionError != builtins.AssertionError in py.test
  479. if 'AssertionError' in str(exc):
  480. if index + 1 >= 3:
  481. raise
  482. else:
  483. break
  484. def test_every_minute_execution_is_due(self):
  485. last_ran = self.now - timedelta(seconds=61)
  486. due, remaining = self.every_minute.is_due(last_ran)
  487. self.assert_relativedelta(self.every_minute, last_ran)
  488. assert due
  489. self.seconds_almost_equal(remaining, self.next_minute, 1)
  490. def assert_relativedelta(self, due, last_ran):
  491. try:
  492. from dateutil.relativedelta import relativedelta
  493. except ImportError:
  494. return
  495. l1, d1, n1 = due.remaining_delta(last_ran)
  496. l2, d2, n2 = due.remaining_delta(last_ran, ffwd=relativedelta)
  497. if not isinstance(d1, relativedelta):
  498. assert l1 == l2
  499. for field, value in items(d1._fields()):
  500. assert getattr(d1, field) == value
  501. assert not d2.years
  502. assert not d2.months
  503. assert not d2.days
  504. assert not d2.leapdays
  505. assert not d2.hours
  506. assert not d2.minutes
  507. assert not d2.seconds
  508. assert not d2.microseconds
  509. def test_every_minute_execution_is_not_due(self):
  510. last_ran = self.now - timedelta(seconds=self.now.second)
  511. due, remaining = self.every_minute.is_due(last_ran)
  512. assert not due
  513. self.seconds_almost_equal(remaining, self.next_minute, 1)
  514. def test_execution_is_due_on_saturday(self):
  515. # 29th of May 2010 is a saturday
  516. with patch_crontab_nowfun(self.hourly, datetime(2010, 5, 29, 10, 30)):
  517. last_ran = self.now - timedelta(seconds=61)
  518. due, remaining = self.every_minute.is_due(last_ran)
  519. assert due
  520. self.seconds_almost_equal(remaining, self.next_minute, 1)
  521. def test_execution_is_due_on_sunday(self):
  522. # 30th of May 2010 is a sunday
  523. with patch_crontab_nowfun(self.hourly, datetime(2010, 5, 30, 10, 30)):
  524. last_ran = self.now - timedelta(seconds=61)
  525. due, remaining = self.every_minute.is_due(last_ran)
  526. assert due
  527. self.seconds_almost_equal(remaining, self.next_minute, 1)
  528. def test_execution_is_due_on_monday(self):
  529. # 31st of May 2010 is a monday
  530. with patch_crontab_nowfun(self.hourly, datetime(2010, 5, 31, 10, 30)):
  531. last_ran = self.now - timedelta(seconds=61)
  532. due, remaining = self.every_minute.is_due(last_ran)
  533. assert due
  534. self.seconds_almost_equal(remaining, self.next_minute, 1)
  535. def test_every_hour_execution_is_due(self):
  536. with patch_crontab_nowfun(self.hourly, datetime(2010, 5, 10, 10, 30)):
  537. due, remaining = self.hourly.is_due(datetime(2010, 5, 10, 6, 30))
  538. assert due
  539. assert remaining == 60 * 60
  540. def test_every_hour_execution_is_not_due(self):
  541. with patch_crontab_nowfun(self.hourly, datetime(2010, 5, 10, 10, 29)):
  542. due, remaining = self.hourly.is_due(datetime(2010, 5, 10, 9, 30))
  543. assert not due
  544. assert remaining == 60
  545. def test_first_quarter_execution_is_due(self):
  546. with patch_crontab_nowfun(
  547. self.quarterly, datetime(2010, 5, 10, 10, 15)):
  548. due, remaining = self.quarterly.is_due(
  549. datetime(2010, 5, 10, 6, 30),
  550. )
  551. assert due
  552. assert remaining == 15 * 60
  553. def test_second_quarter_execution_is_due(self):
  554. with patch_crontab_nowfun(
  555. self.quarterly, datetime(2010, 5, 10, 10, 30)):
  556. due, remaining = self.quarterly.is_due(
  557. datetime(2010, 5, 10, 6, 30),
  558. )
  559. assert due
  560. assert remaining == 15 * 60
  561. def test_first_quarter_execution_is_not_due(self):
  562. with patch_crontab_nowfun(
  563. self.quarterly, datetime(2010, 5, 10, 10, 14)):
  564. due, remaining = self.quarterly.is_due(
  565. datetime(2010, 5, 10, 10, 0),
  566. )
  567. assert not due
  568. assert remaining == 60
  569. def test_second_quarter_execution_is_not_due(self):
  570. with patch_crontab_nowfun(
  571. self.quarterly, datetime(2010, 5, 10, 10, 29)):
  572. due, remaining = self.quarterly.is_due(
  573. datetime(2010, 5, 10, 10, 15),
  574. )
  575. assert not due
  576. assert remaining == 60
  577. def test_daily_execution_is_due(self):
  578. with patch_crontab_nowfun(self.daily, datetime(2010, 5, 10, 7, 30)):
  579. due, remaining = self.daily.is_due(datetime(2010, 5, 9, 7, 30))
  580. assert due
  581. assert remaining == 24 * 60 * 60
  582. def test_daily_execution_is_not_due(self):
  583. with patch_crontab_nowfun(self.daily, datetime(2010, 5, 10, 10, 30)):
  584. due, remaining = self.daily.is_due(datetime(2010, 5, 10, 7, 30))
  585. assert not due
  586. assert remaining == 21 * 60 * 60
  587. def test_weekly_execution_is_due(self):
  588. with patch_crontab_nowfun(self.weekly, datetime(2010, 5, 6, 7, 30)):
  589. due, remaining = self.weekly.is_due(datetime(2010, 4, 30, 7, 30))
  590. assert due
  591. assert remaining == 7 * 24 * 60 * 60
  592. def test_weekly_execution_is_not_due(self):
  593. with patch_crontab_nowfun(self.weekly, datetime(2010, 5, 7, 10, 30)):
  594. due, remaining = self.weekly.is_due(datetime(2010, 5, 6, 7, 30))
  595. assert not due
  596. assert remaining == 6 * 24 * 60 * 60 - 3 * 60 * 60
  597. def test_monthly_execution_is_due(self):
  598. with patch_crontab_nowfun(self.monthly, datetime(2010, 5, 13, 7, 30)):
  599. due, remaining = self.monthly.is_due(datetime(2010, 4, 8, 7, 30))
  600. assert due
  601. assert remaining == 28 * 24 * 60 * 60
  602. def test_monthly_execution_is_not_due(self):
  603. with patch_crontab_nowfun(self.monthly, datetime(2010, 5, 9, 10, 30)):
  604. due, remaining = self.monthly.is_due(datetime(2010, 4, 8, 7, 30))
  605. assert not due
  606. assert remaining == 4 * 24 * 60 * 60 - 3 * 60 * 60
  607. def test_monthly_moy_execution_is_due(self):
  608. with patch_crontab_nowfun(
  609. self.monthly_moy, datetime(2014, 2, 26, 22, 0)):
  610. due, remaining = self.monthly_moy.is_due(
  611. datetime(2013, 7, 4, 10, 0),
  612. )
  613. assert due
  614. assert remaining == 60.0
  615. @skip.todo('unstable test')
  616. def test_monthly_moy_execution_is_not_due(self):
  617. with patch_crontab_nowfun(
  618. self.monthly_moy, datetime(2013, 6, 28, 14, 30)):
  619. due, remaining = self.monthly_moy.is_due(
  620. datetime(2013, 6, 28, 22, 14),
  621. )
  622. assert not due
  623. attempt = (
  624. time.mktime(datetime(2014, 2, 26, 22, 0).timetuple()) -
  625. time.mktime(datetime(2013, 6, 28, 14, 30).timetuple()) -
  626. 60 * 60
  627. )
  628. assert remaining == attempt
  629. def test_monthly_moy_execution_is_due2(self):
  630. with patch_crontab_nowfun(
  631. self.monthly_moy, datetime(2014, 2, 26, 22, 0)):
  632. due, remaining = self.monthly_moy.is_due(
  633. datetime(2013, 2, 28, 10, 0),
  634. )
  635. assert due
  636. assert remaining == 60.0
  637. def test_monthly_moy_execution_is_not_due2(self):
  638. with patch_crontab_nowfun(
  639. self.monthly_moy, datetime(2014, 2, 26, 21, 0)):
  640. due, remaining = self.monthly_moy.is_due(
  641. datetime(2013, 6, 28, 22, 14),
  642. )
  643. assert not due
  644. attempt = 60 * 60
  645. assert remaining == attempt
  646. def test_yearly_execution_is_due(self):
  647. with patch_crontab_nowfun(self.yearly, datetime(2010, 3, 11, 7, 30)):
  648. due, remaining = self.yearly.is_due(datetime(2009, 3, 12, 7, 30))
  649. assert due
  650. assert remaining == 364 * 24 * 60 * 60
  651. def test_yearly_execution_is_not_due(self):
  652. with patch_crontab_nowfun(self.yearly, datetime(2010, 3, 7, 10, 30)):
  653. due, remaining = self.yearly.is_due(datetime(2009, 3, 12, 7, 30))
  654. assert not due
  655. assert remaining == 4 * 24 * 60 * 60 - 3 * 60 * 60