/*
Copyright (c) 2012, Matt T. Proud
All rights reserved.

Use of this source code is governed by a BSD-style
license that can be found in the LICENSE file.
*/

/*
The utility package provides general purpose helpers to assist with this
library.

optional.go provides a mechanism for safely getting a set value or falling
back to defaults a la a Haskell and Scala Maybe or Guava Optional.

optional_test.go provides a test complement for the optional.go module.

priority_queue.go provides a simple priority queue.

priority_queue_test.go provides a test complement for the priority_queue.go
module.

test_helper.go provides a testing assistents for this package and its
dependents.

utility_test.go provides a test suite for all tests in the utility package
hierarchy.  It employs the gocheck framework for test scaffolding.
*/
package documentation