Bitlore

Bitlore provides a simple way to implement flexible validation scenarios in .NET framework.

Bitlore is a natural fit for complex domain models: combine Rules and Interpretations in Specifications to implement easy to follow and test scenarios.

• Small: Only three basic concepts!
• Fluff-free: Use your programming language and your model to define the rules.
• Extensible: Implement Rule interface to encapsulate complexity, define your own specifications and interpretations.

Sample of a spec

 Specifications.All(new Dictionary<Rule<int>,Func<Rule<int>,Interpretation>>
            {
                {Rules<int>.Predicate(x => x % 2 == 0), _ => Interpretations.Static("NOT_EVEN")},
                {Rules<int>.Predicate(x => x > 0), _ => Interpretations.Static("NOT_POSITIVE")}
            });

Defines 2 rules and combines them in the specification that can be used to perform a validation:

 var failures = spec.Test(3); // { "NOT_EVEN" }

Where it gets really interesting and powerful is with ActionSpecification:

            Specifications.Action(new List<Binding<int>>
            {
                Rules<int>
                    .Predicate(x => x % 2 == 0)
                    .Bind(_ => Interpretations.Static("NOT_EVEN"), (_,i)=>_failureInvoked = true,
                        _ => Interpretations.Static("EVEN"), (_,i)=>_successInvoked = true),
                Rules<int>
                    .Predicate(x => x > 0)
                    .Bind(_ => Interpretations.Static("NOT_POSITIVE"), (_,i)=>_failureInvoked = true,
                        _ => Interpretations.Static("POSITIVE"), (_,i)=>_successInvoked = true),
            })
            .Test(2);

Actions are invoked and we can see that the varialbes have been set:

            Assert.True(_successInvoked);
            Assert.False(_failureInvoked);

Obviously you'd want to do something more intersting, like manipulating your view, but you get the idea.

See the unit tests for complete details.

Building Bitlore

1. Clone the source down to your machine. git clone git://github.com/et1975/Bitlore.git
2. Ensure Ruby is installed. RubyInstaller for Windows
3. Ensure git is on your path. git.exe and git.cmd work equally well.
4. Ensure gems are installed, run:

gem install albacore
gem install semver2

Run rake

Target frameworks

The library is portable and available for

• .Net >= 4.0
• Silverlight >= 4.0
• WP >= 7.5
• Windows Store

Credits

Build script has been adopted from Chris Patterson's (http://github.com/phatboyg) projects.