@@ -2,6 +2,15 @@ Fluently is a JavaScript toolkit for creating FluentInterfaces[http://martinfowler.com/bliki/FluentInterface.html]. +I use this to define the mocks, stubs, and expectations in LzTestKit[http://osteele.com/sources/openlaszlo/lztestkit]. + += Status + +Alpha. I use this in other projects, but it's got a known bug (chained modifiers +ignore all but the last one), and the API isn't final. + += Examples + With Fluently, you can do this: var o = Fluently.make(function(define) { define('fn1', function() {console.info('called fn1')}); @@ -26,13 +35,11 @@ You can also define modifiers, and aliases: o.fn1().and.fn2() // same as o.fn1().fn2() o.fn1().and.not.fn2() // options.not is set when fn2 is called -I use this to define the mocks, stubs, and expectations in LzTestKit[http://osteele.com/sources/openlaszlo/lztestkit]. - I've extracted a couple of files, from LzTestKit, into the examples[http://osteele.com/sources/javascript/fluently/examples/] directory. These don't run on their own, but at least they show the code in use. -You can also see a range of examples by viewing the sources to the specs[http://osteele.com/sources/javascript/fluently/specs/]. +You can also see a range of examples by viewing the specs[http://osteele.com/sources/javascript/fluently/specs/fluently-specs.js]. = Download README @@ -16,9 +16,8 @@ end task :publish => [:package, :docs] do target = "osteele.com:osteele.com/sources/javascript/fluently" - sh "rsync pkg/* #{target}" - sh "rsync build/index.html #{target}/index.html" - sh "rsync -a #{PACKAGE_FILES.join(' ')} #{target}" + sh "rsync -av --delete . #{target} --exclude build" + sh "scp build/index.html #{target}/index.html" end task :clean do Rakefile @@ -1 +1 @@ -0.1 +0.2 VERSION @@ -4,7 +4,6 @@ - examples * API -- define empty alias with define.alias - default modifier table, retrieved via this - define a set of objects agenda.txt @@ -8,23 +8,17 @@ var Fluently = { finalizers = [], modifiers; - define.alias = function(target, source) { - path(target).set(host[source]); - } - define.synonym = function(target, source) { + define.alias = define.synonym = function(target, source) { if (arguments.length < 2) host[target] = host; else path(target).set(host[source]); } - define.empty = function(name) { - host[name] = host; - } - define.modifier = function(name) { + define.option = function(name) { modifiers[name] = false; defineSetter(name, modifiers, name, true); } - define.modifier.dictionary = function(object) { + define.option.dictionary = function(object) { modifiers = object; } fluently.js @@ -24,7 +24,7 @@ describe('Definitions', { var chain = Fluently.make(function(define) { define('a', function() {return 1}); define('b', function() {return 2}); - define.empty('self'); + define.alias('self'); define.alias('alias_a', 'a'); define.alias('alias_b', 'b'); }); @@ -33,7 +33,7 @@ describe('Definitions', { value_of(chain.alias_b()).should_be(2); value_of(chain.self.alias_a()).should_be(1); }, - 'should apply modifiers': function() { + 'should apply options': function() { var trace; var options = {}; options.reset = function() { @@ -57,9 +57,9 @@ describe('Definitions', { trace += spans.join(''); } var chain = Fluently.make(function(define) { - define.modifier.dictionary(options); - define.modifier('o1'); - define.modifier('o2'); + define.option.dictionary(options); + define.option('o1'); + define.option('o2'); define('reset', function() {trace = ''; options.reset()}); define('a', function() {t('a')}); define('b', function() {t('b')}); specs/fluently-specs.js 21bd19dc9aa7186007aa252536ed8b27f7ffa7ab Oliver Steele steele@osteele.com http://github.com/osteele/fluently/commit/9380b521762bdfabe5ae3c0bb09c37bcb6193a13 9380b521762bdfabe5ae3c0bb09c37bcb6193a13 2008-02-14T11:45:23-08:00 2008-02-14T11:45:23-08:00 modifier -> option 3c8662adc9c8be864fb7abb135160339c82e7b70 Oliver Steele steele@osteele.com