summaryrefslogtreecommitdiff
path: root/devel/rubygem-timecop/pkg-descr
blob: 86a5757841c08222087cecb6d1f3cb684f9fdb1b (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
timecop is a gem providing "time travel" and "time freezing" capabilities,
making it dead simple to test time-dependent code. It provides a unified method
to mock Time.now, Date.today, and DateTime.now in a single call.

Features:
- Freeze time to a specific point.
- Travel back to a specific point in time, but allow time to continue moving
  forward from there.
- Scale time by a given scaling factor that will cause time to move at an
  accelerated pace.
- No dependencies, can be used with any ruby project
- Timecop api allows arguments to be passed into #freeze and #travel as one of
  the following:
  - Time instance
  - DateTime instance
  - Date instance
  - individual arguments (year, month, day, hour, minute, second)
  - a single integer argument that is interpreted as an offset in seconds from
    Time.now
- Nested calls to Timecop#travel and Timecop#freeze are supported -- each block
  will maintain its interpretation of now.
- Works with regular Ruby projects, and Ruby on Rails projects