= A.E. – Assertive Expressive
== DESCRIPTION
Assertions Expressive (A.E.) is an assertions framework intended for
reuse by any TDD, BDD or similar system.
== FEATURES/ISSUES
- Clear, simple and concise syntax.
- Uses higher-order functions and fluid notation.
- Reusable core extensions ease assertion construction.
- Core extensions are stable and standardized via Ruby F.s.
- Facets is an optional dependency; extensions are built-in.
- Easily extensible allowing for alternate notations.
- Eats it’s own dog food.
== RELEASE NOTES
=== 1.0.0 / 2009-09-03
This is the initial release of AE.
Changes:
-
1 Major Enhancment
- Happy Birthday!
== SYNOPSIS
AE defines the method +assert+. It’s is compatible with the method as
defined by Test::Unit and minitest, which verifies truth of a single
argument (and can accept an optional failure message).
assert(true)
In addition AE’s +assert+ method has been extended to accept a block,
the result of which is likewise verified.
assert{true}
But these are simply legacy compatibility modes. The true power the AE’s
+assert+ method, lies in it’s use without argument or block. In this
case, it returns an +Assertor+ instance. An +Assertor+ is an Assertion
Functor, or Higher-Order Function, which is a function that operates on
another function. With it we can make assertions like:
x.assert == y
a.assert.include? e
StandardError.assert.raised? do
…
end
And so forth. AE’s abilities in this areas are quite extensive. You are
encouraged to read the QEDocs to learn more.
== HOW TO INSTALL
=== Gem Installs
AE releases it’s gems via Gemcutter. If you don’t have Gemcutter
installed do:
$ gem install gemcutter
$ gem tumble
Then you can install AE with:
gem install ae
=== Site Installs
Local installation requires Setup.rb.
gem install setup
The Download the tarball package from GitHub (under pack/ directory) and
do:
$ tar -xvzf ae-1.0.0.tgz
$ cd ae-1.0.0.tgz
$ sudo setup.rb all
Windows users use ‘ruby setup.rb all’.
== COPYRIGHTS & LICENSE
Copyright © 2008,2009 Thomas S.
Unless otherwise provided for by the originating author, this program is
distributed under the terms of the GPL v3 license.
See LICENSE file for details.