= 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 (c) 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.