minilab 1.1.0-x86-mswin32-60

data/vendor/diy-1.1.1/History.txt

@@ -0,0 +1,23 @@
+== 1.1.1 / 2008-05-21
+  * Fixed bug that did not allow a method to be properly injected into an object
+
+== 1.1 / 2008-05-20
+  * Added 'method' directive for building a bounded method from an object defined in diy
+
+== 1.0.3 / 2007-12-11
+
+* The 1.0.1 release had a load-path search in it that resulted in requiring files with full path names (rooted in loadpath entries).  This is unintuitive, and will almost always result in a double "require" if the application code ever requires a library.  The "require" for library loading now relies implicitly on the load path (just like normal human-coded requires.)
+
+== 1.0.1 / 2007-12-02
+
+* Added 'using_namespace' directive for assuming a module for a group of object defs
+* Added 'use_class_directly' option for configuring an ObjectDef.  Instead of instantiating an instance
+  of the specified class, the class itself is referenced.  (Good for injecting ActiveRecord classes into 
+  other components in the guise of factories.
+* Added DIY::Context.auto_require boolean setting. When false, the library of a
+  class is not autoloaded ahead of object construction. Is true by default.
+* 'auto_require' can, if neccessary, be set in the YAML config for an individual object. 
+
+== 1.0.0 / 2007-11-19
+
+* Released!

data/vendor/diy-1.1.1/Manifest.txt

@@ -0,0 +1,88 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+TODO.txt
+homepage/Notes.txt
+homepage/Rakefile
+homepage/diy_example.png
+homepage/index.erb
+homepage/index.html
+homepage/objects_yml.png
+homepage/page_header.graffle
+homepage/page_header.html
+homepage/page_header.png
+lib/diy.rb
+sample_code/car.rb
+sample_code/chassis.rb
+sample_code/diy_example.rb
+sample_code/engine.rb
+sample_code/objects.yml
+test/constructor.rb
+test/diy_test.rb
+test/files/broken_construction.yml
+test/files/cat/cat.rb
+test/files/cat/extra_conflict.yml
+test/files/cat/heritage.rb
+test/files/cat/needs_input.yml
+test/files/cat/the_cat_lineage.rb
+test/files/dog/dog_model.rb
+test/files/dog/dog_presenter.rb
+test/files/dog/dog_view.rb
+test/files/dog/file_resolver.rb
+test/files/dog/other_thing.rb
+test/files/dog/simple.yml
+test/files/donkey/foo.rb
+test/files/donkey/foo/bar/qux.rb
+test/files/fud/objects.yml
+test/files/fud/toy.rb
+test/files/functions/invalid_method.yml
+test/files/functions/method_extractor.rb
+test/files/functions/nonsingleton_objects.yml
+test/files/functions/objects.yml
+test/files/functions/thing.rb
+test/files/functions/thing_builder.rb
+test/files/functions/things_builder.rb
+test/files/gnu/objects.yml
+test/files/gnu/thinger.rb
+test/files/goat/base.rb
+test/files/goat/can.rb
+test/files/goat/goat.rb
+test/files/goat/objects.yml
+test/files/goat/paper.rb
+test/files/goat/plane.rb
+test/files/goat/shirt.rb
+test/files/goat/wings.rb
+test/files/horse/holder_thing.rb
+test/files/horse/objects.yml
+test/files/namespace/animal/bird.rb
+test/files/namespace/animal/cat.rb
+test/files/namespace/animal/reptile/hardshell/turtle.rb
+test/files/namespace/animal/reptile/lizard.rb
+test/files/namespace/bad_module_specified.yml
+test/files/namespace/class_name_combine.yml
+test/files/namespace/hello.txt
+test/files/namespace/no_module_specified.yml
+test/files/namespace/objects.yml
+test/files/namespace/road.rb
+test/files/namespace/sky.rb
+test/files/namespace/subcontext.yml
+test/files/non_singleton/air.rb
+test/files/non_singleton/fat_cat.rb
+test/files/non_singleton/objects.yml
+test/files/non_singleton/pig.rb
+test/files/non_singleton/thread_spinner.rb
+test/files/non_singleton/tick.rb
+test/files/non_singleton/yard.rb
+test/files/yak/core_model.rb
+test/files/yak/core_presenter.rb
+test/files/yak/core_view.rb
+test/files/yak/data_source.rb
+test/files/yak/fringe_model.rb
+test/files/yak/fringe_presenter.rb
+test/files/yak/fringe_view.rb
+test/files/yak/giant_squid.rb
+test/files/yak/krill.rb
+test/files/yak/my_objects.yml
+test/files/yak/sub_sub_context_test.yml
+test/test_helper.rb

data/vendor/diy-1.1.1/README.txt

@@ -0,0 +1,220 @@
+== DIY
+
+* http://rubyforge.org/projects/atomicobjectrb/
+* http://atomicobjectrb.rubyforge.org/diy
+
+== DESCRIPTION:
+
+DIY (Dependency Injection in YAML) is a simple dependency injection library
+which focuses on declarative composition of objects through constructor injection.
+
+== INSTALL:
+
+* gem install diy
+
+== SYNOPSIS:
+
+=== Common Usage
+
+Author a YAML file that describes your objects and how they fit together.
+This means you're building a Hash whose keys are the object names, and whose
+values are Hashes that define the object. 
+
+The following context defines an automobile engine:
+
+context.yml:
+  ---
+  engine:
+    compose: throttle, block
+  throttle:
+    compose: cable, pedal
+  block:
+  cable:
+  pedal:
+
+In your code, use DIY to load the YAML, then access its parts:
+
+  context = DIY::Context.from_file('context.yml')
+  context[:engine]  => <Engine:0x81eb0> 
+
+This approach assumes:
+
+* You've got classes for Engine, Throttle, Block, Cable and Pedal
+* They're defined in engine.rb, throttle.rb, etc
+* The library files are in your load-path
+* Engine and Throttle both have a constructor that accepts a Hash.  The Hash 
+  will contain keys 'throttle', 'block' (for Engine) and 'cable, 'pedal' (for Throttle)
+  and the values will be references to their respective objects.
+* Block, Cable and Pedal all have default constructors that accept no arguments
+
+Sample code for Engine's constructor:
+
+  class Engine
+    def initialize(components)
+      @throttle = components['throttle']
+      @block = components['block']
+    end
+  end
+
+Writing code like that is repetetive; that's why we created the Constructor gem, which lets you
+specify object components using the "constructor" class method:
+
+* http://atomicobjectrb.rubyforge.org/constructor
+
+Using constructor, you can write Engine like this:
+
+  class Engine
+    constructor :throttle, :block
+  end
+
+=== Special Cases
+
+If your object has a lot of components (or they have big names) you can specify an array of component names
+as opposed to a comma-separated list:
+
+  engine:
+    compose:
+    - throttle
+    - block
+
+Sometimes you won't be able to rely on DIY's basic assumptions about class names and library files.
+
+* You can specify the 'class' option
+* You can specify the 'library' option.  If you do not, the library is inferred from the class name. 
+  (Eg, My::Train::Station will be sought in "my/train/station.rb"
+
+  engine:
+    class: FourHorse::Base
+    library: general_engines/base
+    compose: throttle, block
+
+If the Hash coming into your constructor needs to have some keys that do not exactly match the official
+object names, you can specify them one-by-one:
+
+  engine:
+    the_throttle: throttle
+    the_block: block
+
+=== Non-singleton objects
+ 
+Non-singletons are named objects that provide a new instance every time you ask for them.
+By default, DIY considers all objects to be singletons.  To override, use the "singleton" setting and
+set it to false:
+
+  foo:
+    singleton: false
+
+=== Sub-Contexts
+
+Sub-contexts are useful for creating isolated object networks that may need to be instantiated 
+zero or many times in your application.  Objects defined in subcontexts can reference "upward" to 
+their surroundings, as well as objects in the subcontext itself. 
+
+If you wanted to be able to make more than one Engine from the preceding examples, you might try:
+
+  ---
+  epa_regulations:
+
+  +automotive_plant:
+    engine:
+      compose: block, throttle, epa_regulations
+    block:
+    throttle:
+
+Each time you delve into the automotive_plant, you get a solar system of the defined objects.
+In this context, the objects are singleton-like.  The next time you invoke the subcontext, however,
+you'll be working with a fresh set of objects... another solar system with the same layout, so to speak.
+
+Subcontexts are not initialized until you call upon them, which you do using the "within" method:
+
+  context = DIY::Context.from_file('context.yml')
+  context.within('automotive_plant') do |plant|
+    puts plant[:engine]
+  end
+
+=== Direct Class References
+
+Occasionally you will have a class at your disposal that you'd like to provide directly as components
+to other objects (as opposed to getting _instances_ of that class, you want to reference the class itself, eg, 
+to use its factory methods).  Enter the "use_class_directly" flag:
+
+  ---
+  customer_order_finder:
+    class: CustomerOrder
+    use_class_directly: true
+
+This can be handy in Rails when you'd like to use some of class methods on an ActiveRecord subclass, but 
+you'd like to avoid direct ActiveRecord class usage in your code.  In this case, the customer_order_finder
+is actually the CustomerOrder class, and so, it has methods like "find" and "destroy_all".
+
+=== Namespace Convenience
+
+If you find yourself writing context entries like this:
+
+  ---
+  engine:
+    class: Car::Parts::Engine
+  throttle:
+    class: Car::Parts::Block
+  cable:
+    class: Car::Parts::Cable
+
+You can set the "assumed" module for a group of objects like this:
+
+  ---
+  using_namespace Car Parts:
+    engine:
+
+    throttle:
+
+    block:
+
+=== Preventing auto-requiring of library files
+
+Normally, DIY will "require" the library for an object just before it instantiates the object.
+If this is not desired (in Rails, auto-require can lead to library double-load issues), you
+can deactivate auto-require.  There is a global default setting (handled in code) and
+a per-object override (handled in the context YAML):
+
+  DIY::Context.auto_require = false 
+    
+  ---
+  engine:
+    auto_require: false
+
+=== Method Directive
+
+This introduces the concept of first class methods. An object can now be constructed with a method object 
+bound to a particular object in the diy context.
+  
+  ---
+  trinket_builder:
+
+  method build_trinket:
+      object: trinket_builder
+      method: build
+       
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2007 Atomic Object
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/vendor/diy-1.1.1/Rakefile

@@ -0,0 +1,29 @@
+require 'rubygems'
+require 'hoe'
+require './lib/diy.rb'
+
+task :default => [ :test ]
+
+Hoe.new('diy', DIY::VERSION) do |p|
+  p.rubyforge_name = 'atomicobjectrb'
+  p.author = 'Atomic Object'
+  p.email = 'dev@atomicobject.com'
+  p.summary = 'Constructor-based dependency injection container using YAML input.'
+  p.description = p.paragraphs_of('README.txt', 2..5).join("\n\n")
+  p.url = p.paragraphs_of('README.txt', 0).first.split(/\n/)[1..-1]
+  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+  p.test_globs = 'test/*_test.rb'
+  p.extra_deps << ['constructor', '>= 1.0.0']
+end
+
+if File.exists?("../tools/")
+  load "../tools/tasks/homepage.rake"
+  load "../tools/tasks/release_tagging.rake"
+  ReleaseTagging.new do |t|
+    t.package = "diy"
+    t.version = DIY::VERSION
+  end
+
+  desc "Release package to Rubyforge, tag the release in svn, and publish documentation"
+  task :release_full => [ :release, :tag_release, :publish_docs ] 
+end

data/vendor/diy-1.1.1/TODO.txt

@@ -0,0 +1,9 @@
+Sun Dec  2 19:59:16 EST 2007
+crosby
+
+Features from FRE's rogue diy.rb (inside Injection) that need to be
+incorporated into trunk:
+
+* auto_require
+* use_class_directly
+

data/vendor/diy-1.1.1/homepage/Notes.txt

@@ -0,0 +1,27 @@
+Wed Nov 21 21:49:27 EST 2007
+crosby
+
+1. Edit page_header.graffle
+2. Export as HTML imagemap
+3. Open ../sample_code/synopsis.rb
+4. Screen shot, save as sample_code.png
+5. rake (rewrites index.html)
+6. cd ..
+7. rake publish_docs
+
+page_header.graffle
+  Export-as-HTML-Imagemap
+  Use png
+  Use 125% scale
+  Remember to use the style inspector to assign actions to things that should be links.
+
+rake index
+  Rewrites index.html using index.erb and page_header.html (and some values in the Rakefile)
+
+The code sample screenshot:
+  Taken with Snapz Pro X (this is important, as Snapz is providing the
+  dropshadow and about 28 extra pixels widthwise)
+
+  Should be 650 px wide to line up with the page header.
+
+  Transparency: be conscious of WHAT'S IN THE BACKGROUND

data/vendor/diy-1.1.1/homepage/Rakefile

@@ -0,0 +1,14 @@
+desc "Rewrite index.html using index.erb and publisher_homepage.html"
+task :index do
+  require 'erb'
+  @title = "DIY - atomicobject.rb"
+  @header_html = File.read("page_header.html")
+  html = ERB.new(File.read("index.erb")).result(binding)
+  fname = "index.html"
+  File.open(fname,"w") do |f|
+    f.print html
+  end
+  puts "Wrote #{fname}"
+end
+
+task :default => :index

data/vendor/diy-1.1.1/homepage/index.erb

@@ -0,0 +1,36 @@
+<html>
+  <head>
+    <title><%= @title %></title>
+    <style>
+      .code_sample_title {
+        border-top: 1px solid grey;
+        width: 625px;
+        font: bold 12pt Trebuchet MS;
+        text-align:left;
+        margin: 5px;
+        padding-top: 5px;
+      }
+    </style>
+  </head>
+
+  <body>
+
+    <div align="center">
+
+      <%= @header_html  %>
+
+      <div class="code_sample_title">
+        objects.yml:
+      </div>
+      <a href="rdoc/index.html"><img border="0" src="objects_yml.png"></a>
+
+      <div class="code_sample_title">
+        diy_example.rb:
+      </div>
+      <a href="rdoc/index.html"><img border="0" src="diy_example.png"></a>
+    </div>
+
+
+
+  </body>
+</html>