cwver is a command line tool to work with calender week version strings in the following form
<yy>w<ww>.<d>
For example 21w01.1 corresponds to monday in the 1st week of 2021. The corresponding ISO date is 2021-01-04.
Valid values:
<yy>represents the year in two digits<ww>represents the ISO calendar week in two digits and can have a range from 01 - 53.<d>can have a range from 1 (=monday) till 7 (=sunday).
More about ISO week date: https://en.wikipedia.org/wiki/ISO_week_date
cwver supports 3 major subcommands:
cwver 0.1.0
Florian Bramer <[email protected]>
Command line tool to work with calendar week version strings (e.g. 21w45.7).
USAGE:
cwver [SUBCOMMAND]
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
SUBCOMMANDS:
bisect Calculates the workday(s) in the middle of two given cw versions spanning a regression range.
Saturdays and sundays are ignored. Use --workdays to override.
convert Convert cw version string (e.g. 21w45.7) into ISO date.
help Prints this message or the help of the given subcommand(s)
today Display today's date as cw version string.
Converts a calendar week version string into an ISO date. E.g.:
✗ cwver convert 21w05.6
21w05.6 = 2021-02-06
Or the other way around:
✗ cwver convert 2021-02-06
2021-02-06 = 21w05.6
Prints today's date in the calender week format. E.g.
✗ cwver today
Today = 21w11.1
Large software projects often provide one nightly build per day. You might receive bug reports similar to:
I observed a regression in our software: The nightly build 21w04.3 is affected. It was still working fine back in 21w03.1.
You might want to know now: which was the first nightly build that introduced the regression?
The information given above spans your regression range of
21w03.1 ➔ 21w04.3
The range contains 7 workdays (we want to ignore saturday and sunday). cwver bisect can help you to find the middle in the range to start your binary search journey:
✗ cwver bisect 21w03.1 21w04.3
Regression Range:
2021-01-18 ➔ 2021-01-27 (7 workday(s))
Two equivaletent bisect starting points:
• 21w03.4 = 2021-01-21, or
• 21w03.5 = 2021-01-22
In this example there is not even single nightly build in the middle. The middle of the range is two days wide. So it is up to you to pick one.
cwver ignores saturday and sundays per default. You can override this default behaviour with the --workdays option.