travisjeffery/timecop

Health v2 · maintenance only

Flags: no_releases

Adoption not part of the score

3425 stars · 227 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

Timecop is a Ruby gem that provides time travel, time freezing, and time acceleration capabilities for testing time-dependent code. It offers a unified API to mock Time.now, Date.today, DateTime.now, and Process.clock_gettime in a single call.

Use cases

• freeze time in tests to assert time-dependent behavior
• mock Time.now and Date.today in Ruby test suites
• simulate the passage of time in unit tests
• test expiring subscriptions or mortgage due dates
• set a fixed test date for a Rails test environment
• accelerate time to test scheduled or timeout logic

When to choose

• you write Ruby or Rails tests involving time-sensitive logic
• you need to freeze, travel, or scale time deterministically in specs
• you want a dependency-free gem that mocks multiple time APIs uniformly

When to avoid

• your project is not in Ruby
• you only need simple stubbing already covered by your mocking framework
• you need to mock time in production code rather than tests

Facets

library · maturity stable

testing mocking date-time testing developer-tools programming-languages ruby cli time-mocking ruby-gem time-freezing time-travel rails-testing

Member repositories

For agents

markdown · JSON · MCP: product_card(name="travisjeffery/timecop")