jenkins 0.6.0

data/.gitignore

@@ -0,0 +1,6 @@
+hudson-*.gem
+tmp
+var
+*.rbc
+.bundle
+pkg/

data/Changelog.md

@@ -0,0 +1,40 @@
+# Changelog
+
+## 0.5.0 - 2010/12/1
+
+* hudson warfile no longer bundled with hudson gem
+  * rubygem is now 235K instead of 31M!
+  * upgrade hudson server and related plugins without requiring a new gem release
+* hudson gem now fully drinks the bundler koolaid.
+* hudson create
+  * --node-labels 'ubuntu,gentoo' - run tests against multiple slave nodes by their label
+  * --no-template - do not generate any default steps (well, a silly one)
+* hudson add_node
+  * --vagrant - provide alternate default values when adding nodes if the node is a Vagrant VM
+* hudson default_host
+  * NEW - displays the current default host:port URI
+
+## 0.4.0 - 2010/11/11
+
+* hudson create
+  * --rubies '1.8.7,1.9.2,rbx-head,jruby' - uses RVM and Hudson's Axes support to run tests within different Ruby environments
+  * --scm git://some-alternate.com/repo.git - can override the "origin" URI
+  * --scm-branches 'master,other,branches' - specify which branches can be pulled from to trigger tests
+
+* hudson job
+  * Can dump information/status about a job
+
+## 0.3.1 - 2010/11/8
+
+* fixed error in the rails3 template's test for schema.rb
+
+## 0.3.0 - 2010/11/8
+
+MAJOR RELEASE!
+
+* All new commands for CLI: build, remove, nodes, add_node
+* Updated to Hudson CI 1.381
+
+## 0.2.7 2010/8/25
+
+* Updated to Hudson CI 1.373

data/Gemfile

@@ -0,0 +1,3 @@
+source 'http://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,58 @@
+PATH
+  remote: .
+  specs:
+    jenkins (0.6.0)
+      builder (~> 2.1.2)
+      hpricot
+      httparty (~> 0.6.1)
+      term-ansicolor (>= 1.0.4)
+      thor (~> 0.14.2)
+      yajl-ruby (>= 0.7.6)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    awesome_print (0.2.1)
+    builder (2.1.2)
+    crack (0.1.8)
+    cucumber (0.9.3)
+      builder (~> 2.1.2)
+      diff-lcs (~> 1.1.2)
+      gherkin (~> 2.2.9)
+      json (~> 1.4.6)
+      term-ansicolor (~> 1.0.5)
+    diff-lcs (1.1.2)
+    gherkin (2.2.9)
+      json (~> 1.4.6)
+      term-ansicolor (~> 1.0.5)
+    hpricot (0.8.3)
+    httparty (0.6.1)
+      crack (= 0.1.8)
+    jenkins-war (1.396)
+    json (1.4.6)
+    rake (0.8.7)
+    rspec (2.0.1)
+      rspec-core (~> 2.0.1)
+      rspec-expectations (~> 2.0.1)
+      rspec-mocks (~> 2.0.1)
+    rspec-core (2.0.1)
+    rspec-expectations (2.0.1)
+      diff-lcs (>= 1.1.2)
+    rspec-mocks (2.0.1)
+      rspec-core (~> 2.0.1)
+      rspec-expectations (~> 2.0.1)
+    term-ansicolor (1.0.5)
+    thor (0.14.6)
+    yajl-ruby (0.7.8)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  awesome_print
+  cucumber (~> 0.9.0)
+  jenkins!
+  jenkins-war (>= 1.396)
+  json (~> 1.4.0)
+  rake (~> 0.8.7)
+  rspec (~> 2.0.0)

data/README.md

@@ -0,0 +1,154 @@
+Jenkins
+======
+
+[Jenkins CI](http://jenkins-ci.org/) is a sweet continuous integration platform. Jenkins.rb makes it easy to get started, add/remove Ruby jobs and slave nodes; either from a CLI or an API.
+
+  * Email: [http://groups.google.com/group/jenkinsrb](http://groups.google.com/group/jenkinsrb)
+  * IRC:  [irc://irc.freenode.net/jenkins.rb](irc://irc.freenode.net/jenkins.rb)
+  * CI: [http://jenkins.thefrontside.net/job/jenkins.rb/](http://jenkins.thefrontside.net/job/jenkins.rb/)
+
+Install
+=======
+
+    gem install jenkins
+
+You do not need to download Jenkins CI. It is bundled in the RubyGem.
+
+Example
+=======
+
+Jenkins.rb is continuously tested using Jenkins at [http://jenkins.thefrontside.net/job/jenkins.rb/](http://jenkins.thefrontside.net/job/jenkins.rb/).
+
+The `jenkins` application allows you to see the projects/jobs and their statuses:
+
+    $ jenkins list --host jenkins.thefrontside.net --port 80
+    jenkins.rb - http://jenkins.thefrontside.net/job/jenkins.rb/
+    TheRubyRacer - http://jenkins.thefrontside.net/job/TheRubyRacer/
+
+Alternately use environment variables:
+
+    $ JENKINS_HOST=jenkins.thefrontside.net JENKINS_PORT=80 jenkins list
+
+Alternately, it will remember the last Jenkins CI master used.
+
+    $ jenkins list
+
+Usage
+=====
+
+To run your own Jenkins server (by default opens at http://localhost:3001):
+
+    Usage: jenkins server [options]
+      -p,  --port [3001]                         run jenkins server on this port
+      -c,  --control [3002]                      set the shutdown/control port
+           --daemon                              fork into background and run as a daemon
+           --logfile [PATH]                      redirect log messages to this file
+      -k,  --kill                                send shutdown signal to control port
+           --home [/Users/drnic/.jenkins/server]  use this directory to store server data
+
+The remaining CLI tasks are for communicating with a running Jenkins server; either the one created above or hosted remotely.
+
+### Jobs
+
+To list Jobs/Projects on a Jenkins server:
+
+    Usage: jenkins list [options]
+
+To add Jobs/Projects (create a Job) on a Jenkins server:
+
+    Usage: jenkins create PROJECT_PATH [options]
+        --public-scm                     	  use public scm URL
+        --template [ruby]                	  template of job steps (available: rails,rails3,ruby,rubygem)
+        --assigned-node [ASSIGNED-NODE]  	  only use slave nodes with this label
+        --override                       	  override if job exists
+        --no-build                       	  create job without initial build
+
+To trigger a Job to build:
+
+    Usage: jenkins build
+
+To remove a Job from a Jenkins server:
+
+    Usage: jenkins remove PROJECT_PATH
+
+### Slave nodes
+
+To list slaves on a Jenkins server (including itself):
+
+    Usage: jenkins nodes
+
+To add a remote machine/remote VM to a Jenkins server as a slave:
+
+    Usage: jenkins add_node SLAVE_HOST
+        --slave-port [22]          	  SSH port for Jenkins to connect to slave node
+        --label [LABEL]            	  Labels for a job --assigned_node to match against to select a slave.         --master-key [MASTER-KEY]  	  Location of master public key or identity file
+        --slave-fs [SLAVE-FS]      	  Location of file system on slave for Jenkins to use
+        --name [NAME]              	  Name of slave node (default SLAVE_HOST)
+        --slave-user [deploy]      	  SSH user for Jenkins to connect to slave node
+
+### Selecting a Jenkins CI server
+
+**For all client-side commands, there are `--host` and `--port` options flags.** These are cached after first used, so are only required for the first request to a Jenkins CI server. For example:
+
+    jenkins create . --host localhost --port 3001
+    jenkins list
+    jenkins create . --override
+
+Alternately, `$JENKINS_HOST` and `$JENKINS_PORT` can be provided in lieu of the cached target Jenkins CI server
+
+    JENKINS_HOST=localhost JENKINS_PORT=3001 jenkins list
+
+
+Developer Instructions
+======================
+
+The dependencies for the gem and for developing the gem are managed by bundler.
+
+    gem install bundler
+    git clone http://github.com/cowboyd/jenkins.rb.git
+    bundle install
+
+The test suite is run with:
+
+    rake
+
+This launches a Jenkins server, runs cucumber features, and kills the Jenkins server.
+
+Alternately, manually launch the Jenkins server, run features and close the Jenkins server:
+
+    rake jenkins:server:test
+    rake cucumber:ok
+    rake jenkins:server:killtest
+
+Contributors
+============
+
+* Charles Lowell
+* Dr Nic Williams
+* Bo Jeanes
+
+License
+=======
+
+(The MIT License)
+
+Copyright (c) 2010 Charles Lowell, cowboyd@thefrontside.net
+
+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/Rakefile

@@ -0,0 +1,82 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new(:spec)
+
+namespace :cucumber do
+  require 'cucumber/rake/task'
+  Cucumber::Rake::Task.new(:wip, 'Run features that are being worked on') do |t|
+    t.cucumber_opts = "--tags @wip"
+  end
+  Cucumber::Rake::Task.new(:ok, 'Run features that should be working') do |t|
+    t.cucumber_opts = "--tags ~@wip"
+  end
+  task :all => [:ok, :wip]
+end
+
+desc 'Alias for cucumber:ok'
+task :cucumber => 'cucumber:ok'
+
+desc "Start test server; Run cucumber:ok; Kill Test Server;"
+task :default => [:spec, "jenkins:server:killtest", "jenkins:server:test"] do
+  require 'socket'
+  require 'net/http'
+  print "waiting for at most 30 seconds for the server to start"
+  tries = 1
+  begin
+    print "."; $stdout.flush
+    tries += 1
+    Net::HTTP.start("localhost", "3010") { |http| http.get('/') }
+    sleep(10)
+    puts ""
+    result = Rake::Task["cucumber:ok"].invoke
+  rescue Exception => e
+    if tries <= 15
+      sleep 2
+      retry
+    end
+    raise
+  ensure
+    Rake::Task["jenkins:server:killtest"].tap do |task|
+      task.reenable
+      task.invoke
+    end
+  end
+  raise unless result
+end
+
+namespace :jenkins do
+  namespace :server do
+    require 'fileutils'
+
+    directory plugin_dir = File.expand_path("var/jenkins/plugins")
+    desc "Run a server for tests"
+    task :test => plugin_dir do
+      port = 3010
+      control = 3011
+      FileUtils.chdir(File.dirname(__FILE__)) do
+        Dir["fixtures/jenkins/*.hpi"].each do |plugin|
+          FileUtils.cp plugin, plugin_dir
+        end
+        logfile = File.expand_path("var/jenkins/test.log")
+        puts "Launching jenkins test server at http://localhost:#{port}..."
+        puts "  output will be logged to #{logfile}"
+        `ruby bin/jenkins server --home #{File.dirname(plugin_dir)} --port #{port} --control #{control} --daemon --logfile #{logfile}`
+      end
+    end
+
+    desc "Kill jenkins test server if it is running."
+    task :killtest do
+      FileUtils.chdir(File.dirname(__FILE__)) do
+        puts "Killing any running server processes..."
+        `ruby bin/jenkins server --control 3011 --kill 2>/dev/null`
+      end
+    end
+
+  end
+end
+
+Dir['tasks/**/*.rake'].each {|f| load f}
+
+

data/bin/jenkins

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+$:.unshift(File.expand_path(File.dirname(File.dirname(__FILE__) + "/../lib/jenkins.rb")))
+require File.expand_path(File.dirname(__FILE__) + '/../lib/jenkins')
+require 'jenkins/cli'
+
+begin
+  Jenkins::CLI.start
+rescue Errno::ECONNREFUSED, Errno::EAFNOSUPPORT
+  Jenkins::CLI.new.shell.say "No connection available to the server.", :red
+end

data/features/default_host.feature

@@ -0,0 +1,19 @@
+Feature: Display default host information
+
+  Scenario: Display default host information if it is setup
+    Given I run local executable "jenkins" with arguments "list --host localhost --port 3010"
+    When I run local executable "jenkins" with arguments "default_host"
+    Then I should see exactly
+      """
+      http://localhost:3010
+      """
+
+  Scenario: Display warning if never used Jenkins.rb before
+    When I run local executable "jenkins" with arguments "default_host"
+    Then I should see exactly
+      """
+      ERROR: Either use --host or add remote servers.
+      """
+  
+  
+  

data/features/development.feature

@@ -0,0 +1,14 @@
+Feature: Development processes of jenkins itself (rake tasks)
+
+  As a Newgem maintainer or contributor
+  I want rake tasks to maintain and release the gem
+  So that I can spend time on the tests and code, and not excessive time on maintenance processes
+    
+  Scenario: Generate RubyGem
+    Given this project is active project folder
+    When I invoke task "rake clean" so that I start with nothing
+    And I invoke task "rake build"
+    Then file with name matching "pkg/jenkins-*.gem" is created
+    And file with name matching "jenkins.gemspec" is created
+    And the file "jenkins.gemspec" is a valid gemspec
+

data/features/launch_server.feature

@@ -0,0 +1,16 @@
+Feature: Running a Jenkins Server
+  As a jenkins server administrator
+  I want to be able to easily control a jenkins server 
+  In order to spend my time on how the process operates, not how to start stop and control it. 
+  
+  Scenario: Start a Jenkins Server (jenkins server)
+    Given env variable $HOME set to project path "home"
+      And "home/.jenkins" folder is deleted
+      And there is nothing listening on port 5001
+      And there is nothing listening on port 5002
+      And I cleanup any jenkins processes with control port 5002
+    When I run jenkins server with arguments "--port 5001 --control 5002 --daemon --logfile=server.log"
+    Then I should see a jenkins server on port 5001
+      And folder "home/.jenkins/server" is created
+      And folder "home/.jenkins/server/javatmp" is created
+    

data/features/listing_jobs.feature

@@ -0,0 +1,34 @@
+Feature: Listing jobs
+  I want to see the status of jobs on servers I'm interested in
+
+  Scenario: List jobs on a non-existent server (jenkins list)
+    When I run local executable "jenkins" with arguments "list --host localhost --port 9999"
+    Then I should see exactly
+      """
+      No connection available to the server.
+      """
+  
+  Scenario: List jobs on a server with no jobs (jenkins list)
+    Given I have a Jenkins server running
+    And the Jenkins server has no current jobs
+    When I run local executable "jenkins" with arguments "list --host localhost --port 3010"
+    Then I should see exactly
+      """
+      http://localhost:3010: no jobs
+      """
+  
+  Scenario: List jobs on a server with jobs (jenkins list)
+    Given I have a Jenkins server running
+    And the Jenkins server has no current jobs
+    And I am in the "ruby" project folder
+    And the project uses "git" scm
+    When I run local executable "jenkins" with arguments "create . --host localhost --port 3010"
+    When I run local executable "jenkins" with arguments "list"
+    Then I should see exactly
+      """
+      http://localhost:3010:
+      * ruby
+
+      """
+  
+