ymdp 0.1.7 → 0.1.8

data/Gemfile

@@ -0,0 +1,13 @@
+gem "rspec", ">= 1.2.6"
+gem "haml"
+gem "json"
+gem "hpricot"
+gem "ruby-growl"
+gem "activesupport"
+gem "sishen-rtranslate"
+gem "progressions-basepath", :require_as => "basepath"
+gem "progessions-g", :require_as => "g"
+gem "timer"
+gem "serenity"
+gem "ymdp_generator"
+gem "ymdt"

data/History.txt

@@ -1,17 +1,21 @@
-== in Git
+== 0.1.8 2010-01-20
   * minor enhancements
-    
+    * load JSLint settings from config/jslint.js
+  * bug fixes
+    * eliminate extra newlines in translations
+    * fixed incorrect paths in compiler
+    * correctly sync YMDP application with rake sync
 
 == 0.1.7 2010-01-17
   * minor enhancements
-    * Refactored ApplicationView and the F file support class
+    * refactored ApplicationView and the F file support class
     * improved RDoc coverage
     * improved test coverage to 89%
 
 == 0.1.6 2010-01-16
   * major enhancements
     * YMDP global settings now assigned through YMDP::Base.configure block
-    * Raise exceptions if vital settings like version and server don't exist
+    * raise exceptions if vital settings like version and server don't exist
   * minor enhancements
     * improved RDoc coverage
     * improved test coverage

data/Rakefile

@@ -10,18 +10,20 @@ begin
     gem.email = "progressions@gmail.com"
     gem.homepage = "http://github.com/progressions/ymdp"
     gem.authors = ["Jeff Coleman"]
-    gem.add_development_dependency "haml", ">= 0"
-    gem.add_development_dependency "json", ">= 0"
-    gem.add_development_dependency "hpricot", ">= 0"
-    gem.add_development_dependency "ruby-growl", ">= 0"
-    gem.add_development_dependency "activesupport", ">= 0"
-    gem.add_development_dependency "sishen-rtranslate", ">= 0"
-    gem.add_development_dependency "progressions-basepath", ">= 0"
-    gem.add_development_dependency "progressions-g", ">= 0"
-    gem.add_development_dependency "bundler", ">= 0"
-    gem.add_development_dependency "timer", ">= 0"
-    gem.add_development_dependency "serenity", ">= 0"
-    gem.add_development_dependency "ymdp_generator", ">= 0"
+    gem.add_development_dependency "rspec", ">= 1.2.6"
+    gem.add_runtime_dependency "haml", ">= 0"
+    gem.add_runtime_dependency "json", ">= 0"
+    gem.add_runtime_dependency "hpricot", ">= 0"
+    gem.add_runtime_dependency "ruby-growl", ">= 0"
+    gem.add_runtime_dependency "activesupport", ">= 0"
+    gem.add_runtime_dependency "sishen-rtranslate", ">= 0"
+    gem.add_runtime_dependency "progressions-basepath", ">= 0"
+    gem.add_runtime_dependency "progressions-g", ">= 0"
+    gem.add_runtime_dependency "bundler", ">= 0"
+    gem.add_runtime_dependency "timer", ">= 0"
+    gem.add_runtime_dependency "serenity", ">= 0"
+    gem.add_runtime_dependency "ymdp_generator", ">= 0"
+    gem.add_runtime_dependency "ymdt", ">= 0"
     # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
   end
   Jeweler::GemcutterTasks.new

data/VERSION

@@ -1 +1 @@
-0.1.7
+0.1.8

data/lib/ymdp/base.rb

@@ -39,17 +39,22 @@ module YMDP
       
       yield setter
       
-      @@paths = setter.paths
-      @@servers = setter.servers
+      @@paths = setter.paths if setter.paths.try(:any?)
+      @@servers = setter.servers if setter.servers.try(:any?)
+      
+      @@content_variables ||= {}
       
       setter.instance_variables.each do |key|
-        unless ["@servers", "@paths"].include?(key)
+        unless ["@servers", "@paths", "@content_variables"].include?(key)
           value = setter.instance_variable_get(key)
           create_accessor(key, value)
         end
       end
       
-      create_accessors_from_content_variables(setter.content_variables)
+      if setter.content_variables.any?
+        content_variables = @@content_variables.merge(setter.content_variables)
+        create_accessor("content_variables", content_variables)
+      end
     end
     
     # Returns the server definition hash as a class variable, making it available to
@@ -103,16 +108,6 @@ module YMDP
     
     private
     
-    # This probably isn't actually a good place to have this, because
-    # the 'content variables' are only intended to be relevant inside
-    # of a view template.
-    #
-    def self.create_accessors_from_content_variables(content_variables)
-      content_variables.each do |key, value|
-        create_accessor(key, value)
-      end
-    end
-    
     # Creates class- and instance-level accessors for the key and value.
     #
     def self.create_accessor(key, value)
@@ -126,6 +121,7 @@ module YMDP
             attr_accessor :#{key}
           end
         )
+        
         self.send("#{key}=".to_sym, value)
       
         eval %(

data/lib/ymdp/compiler/base.rb

@@ -115,11 +115,11 @@ module YMDP
       #
       def clean_domain
         dir = "#{servers_path}/#{domain}"
-        FileUtils.rm_rf("#{dir}/views")
-        FileUtils.rm_rf("#{dir}/assets/javascripts")
-        FileUtils.rm_rf("#{dir}/assets/stylesheets")
-        FileUtils.rm_rf("#{dir}/assets/yrb")
-        FileUtils.rm_rf("#{TMP_PATH}/")
+        FileUtils.rm_rf(Dir.glob("#{dir}/views/*"))
+        FileUtils.rm_rf(Dir.glob("#{dir}/assets/javascripts/*"))
+        FileUtils.rm_rf(Dir.glob("#{dir}/assets/stylesheets/*"))
+        FileUtils.rm_rf(Dir.glob("#{dir}/assets/yrb/*"))
+        FileUtils.rm_rf(Dir.glob("#{TMP_PATH}/*"))
         FileUtils.mkdir_p(TMP_PATH)
       end
 
@@ -161,7 +161,7 @@ module YMDP
         if options[:verbose]
           $stdout.puts log("Moving images into #{servers_path}/#{domain}/assets/images...")
         end
-        FileUtils.rm_rf("#{servers_path}/#{domain}/assets/images")
+        FileUtils.rm_rf(Dir.glob("#{servers_path}/#{domain}/assets/images/*"))
         FileUtils.mkdir_p("#{servers_path}/#{domain}/assets")
         FileUtils.cp_r("#{images_path}/", "#{servers_path}/#{domain}/assets")
       end
@@ -188,6 +188,10 @@ module YMDP
         "#{base_path}/app"
       end
       
+      def servers_path
+        "#{base_path}/servers"
+      end
+      
       def assets_path
         "#{app_path}/assets"
       end
@@ -199,10 +203,6 @@ module YMDP
       def images_path
         "#{assets_path}/images"
       end
-      
-      def servers_path
-        "#{app_path}/servers"
-      end
     end
   end
 end

data/lib/ymdp/configuration/config.rb

@@ -57,6 +57,11 @@ module YMDP
       # overwrite default settings.
       attr_accessor :paths
       
+      # Configuration options for JSLint JavaScript validator. Should be maintained in
+      # <tt>jslint_settings.yml</tt>.
+      #
+      attr_accessor :jslint_settings
+      
       def initialize #:nodoc:
         @paths = {}
         @content_variables = {}
@@ -103,6 +108,10 @@ module YMDP
         @config.get(base, *args)
       end
       
+      def any?
+        options.any?
+      end
+      
       def each
         options.each do |name, values|
           yield name, values

data/lib/ymdp/configuration/constants.rb

@@ -1,7 +1,9 @@
 CONFIG = YMDP::Configuration::Config.new unless defined?(CONFIG)
 SERVERS = YMDP::Configuration::Servers.new unless defined?(SERVERS)
 
-@content_variables = YAML.load_file("#{CONFIG_PATH}/content.yml")
+@content_variables = YAML.load_file("#{BASE_PATH}/config/content.yml")
+
+@jslint_settings = File.read("#{BASE_PATH}/config/jslint_settings.js") if File.exists?("#{BASE_PATH}/config/jslint.js")
 
 YMDP::Base.configure do |config|
   config.username = CONFIG["username"]
@@ -17,3 +19,7 @@ YMDP::Base.configure do |config|
   
   config.content_variables = @content_variables
 end
+
+YMDP::Validator::JavaScript.configure do |config|
+  config.jslint_settings = @jslint_settings
+end

data/lib/ymdp/generator/templates/translation.pres

@@ -3,6 +3,8 @@
 # <%= @view.capitalize %> view resource file
 #
 
+<%= @view.upcase %>=<%= @view.capitalize %>
+
 <%= @view.upcase %>_HEADING=<%= @view.capitalize %>
 
-<%= @view.upcase %>_SUBHEAD=
+<%= @view.upcase %>_SUBHEAD= 

data/lib/ymdp/processor/form_post.rb

@@ -4,7 +4,7 @@ require 'rubygems'
 require 'mime/types'
 require 'net/http'
 begin
-  require 'CGI' 
+  require 'CGI'
 rescue StandardError => e
   # puts e.message
 end

data/lib/ymdp/processor/validator.rb

@@ -11,7 +11,6 @@ module YMDP
     class HTML < Base
       def self.validate(path)
         html_display_path = display_path(path)
-        log_path = "#{TMP_PATH}/#{File.basename(path)}_errors.html"
 
         log_path = validation_errors(path)
         if log_path
@@ -59,10 +58,7 @@ module YMDP
       end
       
       def self.jslint_settings
-<<-JSLINT
-/*jslint bitwise: true, browser: true, evil: true, eqeqeq: true, immed: true, newcap: true, onevar: false, plusplus: true, regexp: true, undef: true, sub: true */
-/*global YAHOO, openmail, OpenMailIntl, _gat, unescape, $, $$, $A, $H, $R, $w, $div, Event, Effect, Behavior, Try, PeriodicalExecuter, Element, identify, Sortable, window, I18n, Identity, Logger, OIB, Tags, ABTesting, Flash, Debug */
-JSLINT
+        YMDP::Base.jslint_settings
       end
       
       def self.jslint_settings_count

data/lib/ymdp/tasks/ymdp.rake

@@ -162,20 +162,20 @@ end
 desc "Deploys application to YMDP servers"
 task :deploy do
   time("Deployed #{@application}: #{@path}") do
-    deploy(@application, @path)
+    deploy(@application, @path, :sync => @sync)
   end
 end
 
 desc "Deploys application to YMDP servers, matching a path"
 task :deploy_path do
   time("Deployed #{@application}: #{@path}") do
-    deploy_path(@application, @path)
+    deploy_path(@application, @path, :sync => @sync)
   end
 end
 
 task :deploy_yrb do
   time("Deployed #{@application}: #{@path}") do
-    deploy_yrb(@application, @path, {:lang => @lang, :view => @view})
+    deploy_yrb(@application, @path, {:lang => @lang, :view => @view, :sync => @sync})
   end
 end
 
@@ -501,19 +501,21 @@ def validated_embedded_js(path)
   system "rm #{js_fragment_path}"
 end
 
-def deploy(application, path)
+def deploy(application, path, options={})
   puts "\nDeploying #{application}: #{path}"
+  sync = options[:sync]
 
   Rake::Task["validate:html"].invoke if CONFIG.validate_html?
   Rake::Task["validate:embedded_js"].invoke if CONFIG.validate_embedded_js?
   Rake::Task["validate:#{application}:javascripts"].invoke if CONFIG.validate_js_assets?
   Rake::Task["validate:#{application}:json"].invoke if CONFIG.validate_json_assets?
 
-  ymdt.put(:application => application, :path => path)
+  ymdt.put(:application => application, :path => path, :sync => sync)
 end
 
-def deploy_path(application, path)
+def deploy_path(application, path, options={})
   puts "\nDeploying #{application}: #{path}"
+  sync = options[:sync]
 
   Rake::Task["validate:html"].invoke if CONFIG.validate_html?
   Rake::Task["validate:embedded_js"].invoke if CONFIG.validate_embedded_js?
@@ -535,7 +537,7 @@ def deploy_path(application, path)
   
       if file =~ Regexp.new(path)
         puts file
-        ymdt.put(:application => application, :path => new_path)
+        ymdt.put(:application => application, :path => new_path, :sync => sync)
       end
     end
   end
@@ -544,12 +546,13 @@ end
 def deploy_yrb(application, path, options={})
   lang = options[:lang]
   view = options[:view]
+  sync = options[:sync]
   
   if lang
     new_path = "#{path}/keys_#{lang}.json"
-    deploy_path(application, new_path)
+    deploy_path(application, new_path, sync)
   else
-    deploy_path(application, path)
+    deploy_path(application, path, sync)
   end
 end
 

data/lib/ymdp/translator/base.rb

@@ -188,7 +188,7 @@ module YMDP
         
         @lines.each do |line|
           new_line = yield line
-          output << new_line
+          output << new_line unless line.blank?
         end
         output.flatten.join("\n")
       end

data/spec/compiler_spec.rb

@@ -3,7 +3,7 @@ require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
 require 'compiler/base'
 require 'compiler/template'
 
-YMDP_ENV = "build"
+YMDP_ENV = "build" unless defined?(YMDP_ENV)
 
 describe "Compiler" do
   before(:each) do
@@ -61,17 +61,17 @@ describe "Compiler" do
     
     describe "copy_images" do
       it "should remove images folder" do
-        FileUtils.should_receive(:rm_rf).with("./app/servers/#{@domain}/assets/images")
+        FileUtils.should_receive(:rm_rf).with(Dir.glob("./servers/#{@domain}/assets/images/*"))
         @compiler.process_all
       end
       
       it "should create images folder" do
-        FileUtils.should_receive(:mkdir_p).with("./app/servers/#{@domain}/assets")
+        FileUtils.should_receive(:mkdir_p).with("./servers/#{@domain}/assets")
         @compiler.process_all
       end
       
       it "should copy images from app to server" do
-        FileUtils.should_receive(:cp_r).with("./app/assets/images/", "./app/servers/#{@domain}/assets")
+        FileUtils.should_receive(:cp_r).with("./app/assets/images/", "./servers/#{@domain}/assets")
         @compiler.process_all
       end
       

data/spec/validator_spec.rb

@@ -72,6 +72,25 @@ describe "Validator" do
   end
   
   describe "JavaScript" do
+    describe "jslint" do
+      before(:each) do
+        @jslint_settings = "/* These are JSLint settings %/"
+        F.stub!(:execute).with(/java/, :return => true).and_return("jslint: No problems found")  
+      end
+      
+      it "should set jslint settings" do
+        YMDP::Validator::JavaScript.configure do |config|
+          config.jslint_settings = @jslint_settings
+        end
+        YMDP::Validator::JavaScript.jslint_settings.should == @jslint_settings
+      end
+      
+      it "should put jslint settings in the file" do
+        @file.should_receive(:puts).with(@jslint_settings)
+        YMDP::Validator::JavaScript.validate("path")
+      end
+    end
+    
     describe "valid" do
       before(:each) do
         F.stub!(:execute).with(/java/, :return => true).and_return("jslint: No problems found")

data/spec/ymdp_base_spec.rb

@@ -106,7 +106,7 @@ describe YMDP::Base do
           YMDP::Base.configure do |config|
             config.add_content_variable(:funky, "Real funky")
           end
-          @ymdp.funky.should == "Real funky"
+          @ymdp.content_variables.should == {:funky => "Real funky"}
         end
       end
       
@@ -122,7 +122,7 @@ describe YMDP::Base do
           YMDP::Base.configure do |config|
             config.load_content_variables "content"
           end
-          @ymdp.version.should == "1.1"
+          @ymdp.content_variables["version"].should == "1.1"
         end
       end
       
@@ -137,11 +137,11 @@ describe YMDP::Base do
         end
     
         it "should set sprint name in content variables" do
-          @ymdp.version.should == "1.2"
+          @ymdp.content_variables["version"] == "1.2"
         end
     
         it "should set sprint name in content variables" do
-          @ymdp.sprint_name.should == "Gorgonzola"
+          @ymdp.content_variables["sprint_name"].should == "Gorgonzola"
         end
       end
       

data/ymdp.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{ymdp}
-  s.version = "0.1.7"
+  s.version = "0.1.8"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Jeff Coleman"]
-  s.date = %q{2010-01-17}
+  s.date = %q{2010-01-21}
   s.default_executable = %q{ymdp}
   s.description = %q{Framework for developing applications in the Yahoo! Mail Development Platform.}
   s.email = %q{progressions@gmail.com}
@@ -21,6 +21,7 @@ Gem::Specification.new do |s|
   s.files = [
     ".document",
      ".gitignore",
+     "Gemfile",
      "History.txt",
      "LICENSE",
      "README.rdoc",
@@ -168,19 +169,22 @@ Gem::Specification.new do |s|
     s.specification_version = 3
 
     if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
-      s.add_development_dependency(%q<haml>, [">= 0"])
-      s.add_development_dependency(%q<json>, [">= 0"])
-      s.add_development_dependency(%q<hpricot>, [">= 0"])
-      s.add_development_dependency(%q<ruby-growl>, [">= 0"])
-      s.add_development_dependency(%q<activesupport>, [">= 0"])
-      s.add_development_dependency(%q<sishen-rtranslate>, [">= 0"])
-      s.add_development_dependency(%q<progressions-basepath>, [">= 0"])
-      s.add_development_dependency(%q<progressions-g>, [">= 0"])
-      s.add_development_dependency(%q<bundler>, [">= 0"])
-      s.add_development_dependency(%q<timer>, [">= 0"])
-      s.add_development_dependency(%q<serenity>, [">= 0"])
-      s.add_development_dependency(%q<ymdp_generator>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 1.2.6"])
+      s.add_runtime_dependency(%q<haml>, [">= 0"])
+      s.add_runtime_dependency(%q<json>, [">= 0"])
+      s.add_runtime_dependency(%q<hpricot>, [">= 0"])
+      s.add_runtime_dependency(%q<ruby-growl>, [">= 0"])
+      s.add_runtime_dependency(%q<activesupport>, [">= 0"])
+      s.add_runtime_dependency(%q<sishen-rtranslate>, [">= 0"])
+      s.add_runtime_dependency(%q<progressions-basepath>, [">= 0"])
+      s.add_runtime_dependency(%q<progressions-g>, [">= 0"])
+      s.add_runtime_dependency(%q<bundler>, [">= 0"])
+      s.add_runtime_dependency(%q<timer>, [">= 0"])
+      s.add_runtime_dependency(%q<serenity>, [">= 0"])
+      s.add_runtime_dependency(%q<ymdp_generator>, [">= 0"])
+      s.add_runtime_dependency(%q<ymdt>, [">= 0"])
     else
+      s.add_dependency(%q<rspec>, [">= 1.2.6"])
       s.add_dependency(%q<haml>, [">= 0"])
       s.add_dependency(%q<json>, [">= 0"])
       s.add_dependency(%q<hpricot>, [">= 0"])
@@ -193,8 +197,10 @@ Gem::Specification.new do |s|
       s.add_dependency(%q<timer>, [">= 0"])
       s.add_dependency(%q<serenity>, [">= 0"])
       s.add_dependency(%q<ymdp_generator>, [">= 0"])
+      s.add_dependency(%q<ymdt>, [">= 0"])
     end
   else
+    s.add_dependency(%q<rspec>, [">= 1.2.6"])
     s.add_dependency(%q<haml>, [">= 0"])
     s.add_dependency(%q<json>, [">= 0"])
     s.add_dependency(%q<hpricot>, [">= 0"])
@@ -207,6 +213,7 @@ Gem::Specification.new do |s|
     s.add_dependency(%q<timer>, [">= 0"])
     s.add_dependency(%q<serenity>, [">= 0"])
     s.add_dependency(%q<ymdp_generator>, [">= 0"])
+    s.add_dependency(%q<ymdt>, [">= 0"])
   end
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: ymdp
 version: !ruby/object:Gem::Version 
-  version: 0.1.7
+  version: 0.1.8
 platform: ruby
 authors: 
 - Jeff Coleman
@@ -9,13 +9,23 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-01-17 00:00:00 -06:00
+date: 2010-01-21 00:00:00 -06:00
 default_executable: ymdp
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  name: haml
+  name: rspec
   type: :development
   version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.6
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: haml
+  type: :runtime
+  version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
@@ -24,7 +34,7 @@ dependencies:
     version: 
 - !ruby/object:Gem::Dependency 
   name: json
-  type: :development
+  type: :runtime
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
@@ -34,7 +44,7 @@ dependencies:
     version: 
 - !ruby/object:Gem::Dependency 
   name: hpricot
-  type: :development
+  type: :runtime
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
@@ -44,7 +54,7 @@ dependencies:
     version: 
 - !ruby/object:Gem::Dependency 
   name: ruby-growl
-  type: :development
+  type: :runtime
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
@@ -54,7 +64,7 @@ dependencies:
     version: 
 - !ruby/object:Gem::Dependency 
   name: activesupport
-  type: :development
+  type: :runtime
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
@@ -64,7 +74,7 @@ dependencies:
     version: 
 - !ruby/object:Gem::Dependency 
   name: sishen-rtranslate
-  type: :development
+  type: :runtime
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
@@ -74,7 +84,7 @@ dependencies:
     version: 
 - !ruby/object:Gem::Dependency 
   name: progressions-basepath
-  type: :development
+  type: :runtime
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
@@ -84,7 +94,7 @@ dependencies:
     version: 
 - !ruby/object:Gem::Dependency 
   name: progressions-g
-  type: :development
+  type: :runtime
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
@@ -94,7 +104,7 @@ dependencies:
     version: 
 - !ruby/object:Gem::Dependency 
   name: bundler
-  type: :development
+  type: :runtime
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
@@ -104,7 +114,7 @@ dependencies:
     version: 
 - !ruby/object:Gem::Dependency 
   name: timer
-  type: :development
+  type: :runtime
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
@@ -114,7 +124,7 @@ dependencies:
     version: 
 - !ruby/object:Gem::Dependency 
   name: serenity
-  type: :development
+  type: :runtime
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
@@ -124,7 +134,17 @@ dependencies:
     version: 
 - !ruby/object:Gem::Dependency 
   name: ymdp_generator
-  type: :development
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: ymdt
+  type: :runtime
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
@@ -144,6 +164,7 @@ extra_rdoc_files:
 files: 
 - .document
 - .gitignore
+- Gemfile
 - History.txt
 - LICENSE
 - README.rdoc