gopkg.in/thejerf/abtime.v1

abtime

go get github.com/thejerf/abtime

A library for abstracting away from the literal Go time library, for testing and time control.

In any code that seriously uses time, such as billing or scheduling code, best software engineering practices are that you should not directly access the operating system time. This module provides you with code to implement that principle in Go.

See some discussions:

• blog.plover.com's Moonpig discussion
• Jon Skeet's discussion on Stack Overflow
• Jim McBeath's post

This module is fully covered with godoc, including examples, usage, and everything else you might expect from a README.md on GitHub. (DRY.)

Changelog

• 1.0.3:
  • Fix locking for Unregister and UnregisterAll.
• 1.0.2

  • Adds support for unregistering triggers, so the ids can be reused with the same abtime object.

    As the godoc says, this is a sign of some sort of flaw, but it is not yet clear how to handle it. I still haven't found a good option for an API for this stuff. My original goal with abtime was to be as close to the original time API as possible, I'm considering abandoning that. Though I still don't know what exactly that would look like.

    (Plus, this need some sort of context support now.)

• 1.0.1
  • Issue 3 reports a reversal in the sense of the timer.Reset return value, which is fixed. While fixing this, a race condition in setting the underlying value was also fixed.
• 1.0.0
  • Initial Release.

Commit Signing

Starting with the commit after 3003eee879c, I will be signing this repository with the "jerf" keybase account. If you are viewing this repository through GitHub, you should see the commits as showing as "verified" in the commit view.

(Bear in mind that due to the nature of how git commit signing works, there may be runs of unverified commits; what matters is that the top one is signed.)