Blackskirt 0.1

Relative weekday/date utilities useful for finding public holidays

Relative weekday/date utilities useful for finding public holidays

Installation

pip install blackskirt

Examples

from blackskirt import (WEEKDAY_MON, WEEKDAY_TUE, WEEKDAY_WED,
                        WEEKDAY_THU, WEEKDAY_FRI, WEEKDAY_SAT,
                        WEEKDAY_SUN,)
from blackskirt.blackskirt import (mondayise, next_weekday,
                                   prev_weekday, nearest_weekday,
                                   nth_weekday, last_weekday,
                                   next_date, prev_date, nearest_date,)

mondayise

1. New Year’s Day: 1 January (or the following Monday if it falls on a Saturday or Sunday)

# 2011-01-01 is Saturday
assert mondayise("2011-01-01", cases=((WEEKDAY_SAT, WEEKDAY_MON),
                                      (WEEKDAY_SUN, WEEKDAY_MON),)) == "2011-01-03"

2. Day after New Year’s Day: 2 January (or the following Monday if it falls on a Saturday, or the following Tuesday if it falls on a Sunday)

# 2011-01-02 is Sunday
assert mondayise("2011-01-02", cases=((WEEKDAY_SAT, WEEKDAY_MON),
                                      (WEEKDAY_SUN, WEEKDAY_TUE),)) == "2011-01-03"

nth_weekday

Labour Day: The fourth Monday in October

assert nth_weekday(2014, 10, n=4, weekday=WEEKDAY_MON) == "2014-10-27"

next_weekday

Marlborough provincial anniversary day: First Monday after Labour Day

assert next_weekday("2014-10-27", weekday=WEEKDAY_MON) == "2014-11-03"

nearest_weekday

Wellington provincial anniversary day: 22 January (Monday nearest to the actual day)

# 2014-01-22 is Wednesday
nearest_weekday("2014-01-22", weekday=WEEKDAY_MON) == "2014-01-20"

last_weekday

Memorial Day: Last Monday in May

assert last_weekday(2014, 5, weekday=WEEKDAY_MON) == "2014-05-26"

next_date

Inauguration Day: First January 20 following a Presidential election

# 2012-11-06 was the previous presidential election day in US
assert next_date(1, 20, offset="2012-11-06") == "2013-01-20"

License

All the code is licensed under the GNU Lesser General Public License (v3+).