cerberus 0.1.0 → 0.1.1

data/CHANGES

@@ -1,7 +1,12 @@
 = Cerberus Changelog
 
-== Version 0.1.0
+== Version 0.1.1
+Minor improvements
+
+* Added 'buildall' command that build all projects added to Cerberus repository.
+* Fixed tests on *nix
 
+== Version 0.1.0
 Initial version of Cerberus tool
 
 * Implemented basic functionality required by Continuous Integration.

data/LICENSE

@@ -1,21 +1,21 @@
-Copyright (c) 2006 Anatol Pomozov
-
-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.
-
+Copyright (c) 2006 Anatol Pomozov
+
+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/README

@@ -1,7 +1,4 @@
-Cerberus developed by Anatol Pomozov (anatol.pomozov@gmail.com) and shared under MIT license.
-
-Cerberus is continuous integration (CI) software. Cerberus could be periodically run from scheduler 
-and check if application tests are broken. If it happend then Cerberus sends notification to developers.
+Cerberus is a Continuous Integration (CI) software. Cerberus could be periodically run from scheduler and check if application tests are broken. If it happens then Cerberus will send notification to developers. Cerberus perfectly works both on Windows and *nix platforms.
 
 For more CI theory read this document from Martin Fowler 
 http://www.martinfowler.com/articles/continuousIntegration.html.
@@ -11,7 +8,6 @@ Requirements:
   rake - 0.7 or higher
   svn client - 1.2 or higher
 
-
 What 'Cerberus' name means?
 Quote from Wikipedia (http://en.wikipedia.org/wiki/Cerberus)
 
@@ -19,23 +15,22 @@ Cerberus or Kerberos (Kerberos, demon of the pit), was the hound of Hades-a mons
 He guarded the gate to Hades (the Greek underworld) and ensured that the dead could not leave and the living could not enter. His brother was Orthrus. He is the offspring of Echidna and Typhon.
 
 
-So Cerberus will guard your tests and not allow your project to go to the world of dead.
-
+So Cerberus will guard your tests and not allow your project to go to the world of dead. 
 
 To use Cerberus it is very easy. First install it. Easiest way to do it through RubyGems package manager.
 
 'gem install cerberus'
 
+or get Cerberus distribution package right from download page http://rubyforge.org/frs/?group_id=1794
+
 then you need to add project that will be watched by Cerberus. Do it by
 
-cerberus add (DIR|SVN_URL)?    #Adds project to list of watched applications
+cerberus add (DIR|SVN_URL) APPLICATION_NAME=some_app RECIPIENTS=dev1@project.com,dev2@project.com
+
+as second parameter you could pass URL to subversion repository or directory with working SVN folder.
 
-as second parameted you could pass URL to subversion repository or directory with working SVN folder.
-If this parameted absent then would be added project from current directory
+Go to ~./cerberus and edit config.yml file (only once after installing Cerberus). Enter your configuration options here like email server, password, user_name and other options. See ActiveMailer description - Cerberus uses it as notification layer. My config file looks like this
 
-Go to ~./cerberus and edit config.yml file (only once after installing Cerberus). Enter your configuration options here
-like email server, password, user_name and other options. See ActiveMailer description - Cerberus uses it as notification
-layer. Mine config file looks like this
 mail:
   address: mail.somesever.com
   user_name: anatol
@@ -43,15 +38,14 @@ mail:
   domain: somesever.com
   authentication: login
 
-Also go to ~/.cerberus/config/<PROJECT_NAME>.yml and add comma-separated list of recipients for this project
-You could also change <PROJECT_NAME> to any other name. This name what Cerberus will use.
+Also check ~/.cerberus/config/<APPLICATION_NAME>.yml and make sure that you have right options.
 
 And then run Cerberus 
 
-cerberus build PROJECT_NAME    #Run project
+cerberus build APPLICATION_NAME    #Run project
 
-It will check out latest sources and run tests for your app. If tests are broken - recipients will recieve notifications.
+It will check out latest sources and run tests for your application. If tests are broken - recipients will receive notifications.
 
-But of course better run Cerberus automatically from Cron. Run it each 10 minutes for project will be ok.
+But of course better run Cerberus automatically from Cron. Run Cerberus for project each 10 minutes would be ok.
 
 Well, thats all. If you have any questions, proposals - just let me know.

data/Rakefile

@@ -40,7 +40,7 @@ GEM_SPEC = Gem::Specification.new do |s|
 
   s.summary = "Cerberus is a Continuous Integration tool that could be easily run from Cron."
   s.description = <<-DESC.strip.gsub(/\n\s+/, " ")
-    Cerberus is a Continuous Integration software for Ruby projects. CI helps you keep your project 
+    Cerberus is a Continuous Integration software for Ruby projects. CI helps you keep your project
     in a good shape.
 
     For now Cerberus only work with projects that use Subversion but in the future it would be provided
@@ -70,7 +70,7 @@ GEM_SPEC = Gem::Specification.new do |s|
   s.author = "Anatol Pomozov"
   s.email = "anatol.pomozov@gmail.com"
   s.homepage = "http://rubyforge.org/projects/cerberus"
-  s.rubyforge_project = "cerberus"
+  s.rubyforge_project = RUBY_FORGE_PROJECT
 end
 
 
@@ -120,6 +120,8 @@ end
 
 task :publish_news do
   require 'meta_project'
+
+  project = MetaProject::Project::XForge::RubyForge.new(RUBY_FORGE_PROJECT)
   Rake::XForge::NewsPublisher.new(project) do |publisher|
     publisher.user_name = RUBY_FORGE_USER
     publisher.password = ENV['RUBYFORGE_PASSWORD']

data/doc/FAQ

@@ -0,0 +1,21 @@
+* How to schedule Cerberus build on nnCron
+
+nnCron has simple user interface and it is easy to add new task - just run task with AsLoggedUser option.
+There is only issue - nnCron do not pass HOME environment variable to process so you need to add it to nncron.tab file.
+
+You could add CERBERUS_HOME envronment variable or HOME (in last case CERBERUS_HOME would be calculated as 
+HOME/.cerberus)
+
+Mine nncron.tab file looks like this
+
+
+
+SET CERBERUS_HOME="C:\Documents and Settings\anatol\.cerberus"
+
+#( [cerberus]watsjit
+AsLoggedUser
+Time: */15 * * * * *
+Action:
+SWHide   NormalPriority
+START-APPW: c:\progra~1\ruby\bin\cerberus.CMD build cerberus
+)#

data/lib/cerberus/cli.rb

@@ -11,7 +11,7 @@ module Cerberus
       say HELP if args.empty?
 
       command = args.shift
-      say HELP unless %w(add build).include?(command)
+      say HELP unless %w(add build buildall).include?(command)
 
       cli_options = extract_options(args)
 
@@ -27,16 +27,10 @@ module Cerberus
         application_name  = args.shift
 
         command = Cerberus::Build.new(application_name, cli_options)
-        begin
-          command.run
-        rescue Exception => e
-          File.open("#{HOME}/work/#{application_name}/error.log", File::WRONLY|File::APPEND|File::CREAT) do |f| 
-            f.puts Time.now.strftime("%a, %d %b %Y %H:%M:%S %z")
-            f.puts e.message
-            f.puts e.backtrace.collect{|line| ' '*5 + line}
-            f.puts "\n"
-          end
-        end
+        command.run
+      when 'buildall'
+        command = Cerberus::BuildAll.new(cli_options)
+        command.run
       end
     end
 
@@ -62,6 +56,7 @@ module Cerberus
       cerberus add <URL>      --- add project from svn repository to list watched of applications
       cerberus add <PATH>     --- add project from local path to list of watched applications
       cerberus build <APPLICATION_NAME>  --- build watched application
+      cerberus buildall       --- build all watched applications
 
     Version #{Cerberus::VERSION::STRING}
   }.gsub("\n    ","\n")

data/lib/cerberus/manager.rb

@@ -1,11 +1,12 @@
 require 'rubygems'
-require 'action_mailer'
 require 'fileutils'
 
 require 'cerberus/utils'
 require 'cerberus/constants'
 require 'cerberus/config'
 
+require 'cerberus/notifier/email'
+
 module Cerberus
   class Add
     include Cerberus::Utils
@@ -18,7 +19,7 @@ module Cerberus
       checkout = Checkout.new(@path, @config)
       say "Can't find any svn application under #{@path}" unless checkout.url
 
-      application_name = @config[:application_name] || File.basename(File.expand_path(@path)).strip
+      application_name = @config[:application_name] || extract_project_name(@path)
 
       create_default_config
       
@@ -34,6 +35,11 @@ module Cerberus
     end
 
     private
+    def extract_project_name(path)
+      path = File.expand_path(path) if test(?d, path)
+      File.basename(path).strip
+    end
+    
     def create_default_config
       default_mail_config = 
         {'mail'=>
@@ -70,36 +76,40 @@ module Cerberus
     end
  
     def run
-      @checkout.update!
-
-      previous_status = @status.recall
-
-      state = 
-      if @checkout.has_changes? or not previous_status
-        if status = make
-          @status.keep(:succesful)
-          previous_status == :failed ? :revived : :succesful
+      begin
+        previous_status = @status.recall
+        @checkout.update!
+
+        state = 
+        if @checkout.has_changes? or not previous_status
+          if status = make
+            @status.keep(:succesful)
+            case previous_status
+            when :failed
+              :revival
+            when :succesful
+              :succesful
+            when false
+              :setup
+            end
+          else
+            @status.keep(:failed)
+            previous_status == :failed ? :broken : :failure
+          end
         else
-          @status.keep(:failed)
-          previous_status == :failed ? :broken : :failed
+          :unchanged
         end
-      else
-        :unchanged
-      end
-
-      case state
-        when :failed
-          Notifier.deliver_failure(self, @config)
-        when :revived
-          Notifier.deliver_revival(self, @config)
-        when :broken
-          Notifier.deliver_broken(self, @config)
-        when :unchanged, :succesful
-          unless previous_status  #If it first time we build application then let everyone to know that we have Cerberus now
-            Notifier.deliver_setup(self, @config)
-          end
 
-          # Smile, be happy, it's all good
+        if [:failure, :broken, :revival, :setup].include?(state)
+          Cerberus::Notifier::Email.notify(state, self, @config)
+        end
+      rescue Exception => e
+        File.open("#{HOME}/work/#{@config[:application_name]}/error.log", File::WRONLY|File::APPEND|File::CREAT) do |f| 
+          f.puts Time.now.strftime("%a, %d %b %Y %H:%M:%S %z")
+          f.puts e.message
+          f.puts e.backtrace.collect{|line| ' '*5 + line}
+          f.puts "\n"
+        end
       end
     end
  
@@ -132,6 +142,23 @@ module Cerberus
         }
       end
   end
+
+  class BuildAll
+    def initialize(cli_options = {})
+      @cli_options = cli_options
+    end
+
+    def run
+      Dir["#{HOME}/config/*.yml"].each do |fn|
+        fn =~ %r{#{HOME}/config/(.*).yml}
+        application_name = $1
+
+        command = Cerberus::Build.new(application_name, @cli_options)
+        command.run
+      end
+    end
+  end
+
   
   class Checkout
     def initialize(path, options = {})
@@ -200,47 +227,4 @@ module Cerberus
       value.blank? ? false : value.to_sym
     end
   end
-
-  class Notifier < ActionMailer::Base
-    include Cerberus::Utils
-    
-    def failure(build, options)
-      @subject = "Build broken by #{build.checkout.last_author} (##{build.checkout.current_revision})"
-      send_message(build, options)
-    end
-    
-    def broken(build, options)
-      @subject = "Build still broken (##{build.checkout.current_revision})"
-      send_message(build, options)
-    end
-    
-    def revival(build, options)
-      @subject = "Build fixed by #{build.checkout.last_author} (##{build.checkout.current_revision})"
-      send_message(build, options)
-    end
-
-    def setup(build, options)
-      @subject = "Cerberus set up for project (##{build.checkout.current_revision})"
-      send_message(build, options)
-    end
-
-    private
-    def send_message(build, options)
-      mail_config = options[:mail] || {}
-      [:authentication, :delivery_method].each do |k|
-        mail_config[k] = mail_config[k].to_sym if mail_config[k]
-      end
-
-      ActionMailer::Base.delivery_method = mail_config[:delivery_method] if mail_config[:delivery_method]
-      ActionMailer::Base.server_settings = mail_config
-
-      @subject = "[#{options[:application_name]}] " + @subject
-      @body    = [ build.checkout.last_commit_message, build.output ].join("\n\n")
-
-      @recipients, @sent_on = options[:recipients], Time.now
-
-      @from = options[:sender] || "'Cerberus' <cerberus@example.com>"
-      raise "Please specify recipient addresses for application '#{options[:application_name]}'" unless options[:recipients]
-    end
-  end
-end
+end

data/lib/cerberus/notifier/email.rb

@@ -0,0 +1,47 @@
+require 'action_mailer'
+
+module Cerberus
+  module Notifier
+    class Email
+      def self.notify(state, build, options)
+        Email.configure(options)
+        ActionMailerNotifier.deliver_message(state, build, options)
+      end
+
+      private
+      def self.configure(options)
+        mail_config = options[:mail] || {}
+        [:authentication, :delivery_method].each do |k|
+          mail_config[k] = mail_config[k].to_sym if mail_config[k]
+        end
+
+        ActionMailer::Base.delivery_method = mail_config[:delivery_method] if mail_config[:delivery_method]
+        ActionMailer::Base.server_settings = mail_config
+      end
+
+      class ActionMailerNotifier < ActionMailer::Base
+        def message(state, build, options)
+          subject = 
+          case state
+          when :setup
+            "Cerberus set up for project (##{build.checkout.current_revision})"
+          when :broken
+            "Build still broken (##{build.checkout.current_revision})"
+          when :failure
+            "Build broken by #{build.checkout.last_author} (##{build.checkout.current_revision})"
+          when :revival
+            "Build fixed by #{build.checkout.last_author} (##{build.checkout.current_revision})"
+          end
+
+          @subject = "[#{options[:application_name]}] #{subject}"
+          @body    = [ build.checkout.last_commit_message, build.output ].join("\n\n")
+
+          @recipients, @sent_on = options[:recipients], Time.now
+
+          @from = options[:sender] || "'Cerberus' <cerberus@example.com>"
+          raise "Please specify recipient addresses for application '#{options[:application_name]}'" unless options[:recipients]
+        end
+      end
+    end
+  end
+end

data/lib/cerberus/version.rb

@@ -1,9 +1,9 @@
-module Cerberus
-  module VERSION #:nodoc:
-    MAJOR = 0
-    MINOR = 1
-    TINY  = 0
-
-    STRING = [MAJOR, MINOR, TINY].join('.')
-  end
-end
+module Cerberus
+  module VERSION #:nodoc:
+    MAJOR = 0
+    MINOR = 1
+    TINY  = 1
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+end

data/test/functional_test.rb

@@ -2,14 +2,13 @@ require 'test_helper'
 
 require 'cerberus/cli'
 
-#require 'mocks/notifier'
-
 class FunctionalTest < Test::Unit::TestCase
   def setup
     FileUtils.rm_rf HOME
   end
 
   def teardown
+    Dir.chdir HOME + '/../' #We need change working directory to some non-removable dir otherwise we would have warning after removing that working directory absent
     FileUtils.rm_rf HOME
   end
 
@@ -41,7 +40,7 @@ class FunctionalTest < Test::Unit::TestCase
 
   def test_build
     add_application('myapp', SVN_URL)
-    
+
     build = Cerberus::Build.new('myapp')
     build.run
     assert_equal 1, ActionMailer::Base.deliveries.size #first email that project was setup
@@ -85,11 +84,27 @@ class FunctionalTest < Test::Unit::TestCase
 
   def test_have_no_awkward_header
     add_application('myapp', SVN_URL)
-    
+
     build = Cerberus::Build.new('myapp')
     build.run
 
     assert build.checkout.last_commit_message !~ /-rHEAD -v/
     assert_equal 0, build.checkout.last_commit_message.index('-' * 72)
   end
+
+  def test_have_no_awkward_header
+    add_application('myapp1', SVN_URL)
+    add_application('myapp2', SVN_URL)
+    add_application('myapp3', SVN_URL)
+    add_application('myapp4', SVN_URL)
+
+    build = Cerberus::BuildAll.new
+    build.run
+
+    for i in 1..4 do
+      status_file = HOME + "/work/myapp#{i}/status.log"
+      assert File.exists?(status_file)
+      assert_equal 'succesful', IO.read(status_file)
+    end
+  end
 end

metadata

@@ -3,15 +3,15 @@ rubygems_version: 0.9.0
 specification_version: 1
 name: cerberus
 version: !ruby/object:Gem::Version 
-  version: 0.1.0
-date: 2006-07-16 00:00:00 +04:00
+  version: 0.1.1
+date: 2006-07-22 00:00:00 +04:00
 summary: Cerberus is a Continuous Integration tool that could be easily run from Cron.
 require_paths: 
 - lib
 email: anatol.pomozov@gmail.com
 homepage: http://rubyforge.org/projects/cerberus
 rubyforge_project: cerberus
-description: Cerberus is a Continuous Integration software for Ruby projects. CI helps you keep your project  in a good shape. For now Cerberus only work with projects that use Subversion but in the future it would be provided support for other VCS. Cerberus could be easily invoked from Cron (for Unix) or nnCron (for Windows) utilities.
+description: Cerberus is a Continuous Integration software for Ruby projects. CI helps you keep your project in a good shape. For now Cerberus only work with projects that use Subversion but in the future it would be provided support for other VCS. Cerberus could be easily invoked from Cron (for Unix) or nnCron (for Windows) utilities.
 autorequire: 
 default_executable: cerberus
 bindir: bin
@@ -37,8 +37,10 @@ files:
 - lib/cerberus/constants.rb
 - lib/cerberus/latch.rb
 - lib/cerberus/manager.rb
+- lib/cerberus/notifier
 - lib/cerberus/utils.rb
 - lib/cerberus/version.rb
+- lib/cerberus/notifier/email.rb
 - test/config_test.rb
 - test/data
 - test/functional_test.rb