akqa-jenkins 0.6.4.1

data/.gitignore

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

data/Changelog.md

@@ -0,0 +1,54 @@
+# Changelog
+
+## 0.6.4 - 2011/04/13
+
+* change from json to json_pure
+
+## 0.6.3 - 2011/04/12
+
+* fixes for ruby 1.9
+
+## 0.6.2 - 2011/03/17
+
+* add `build_details` command for fetching the result of a particular build.
+* add instructions for running with non-english locale
+* remove, fix obsolete gem dependencies
+
+## 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,56 @@
+PATH
+  remote: .
+  specs:
+    jenkins (0.6.4)
+      builder (~> 2.1.2)
+      hpricot
+      httparty (~> 0.6.1)
+      json_pure (>= 1.5.1)
+      term-ansicolor (>= 1.0.4)
+      thor (~> 0.14.2)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    awesome_print (0.3.2)
+    builder (2.1.2)
+    crack (0.1.8)
+    cucumber (0.10.0)
+      builder (>= 2.1.2)
+      diff-lcs (~> 1.1.2)
+      gherkin (~> 2.3.2)
+      json (~> 1.4.6)
+      term-ansicolor (~> 1.0.5)
+    diff-lcs (1.1.2)
+    gherkin (2.3.4)
+      json (~> 1.4.6)
+    hpricot (0.8.4)
+    httparty (0.6.1)
+      crack (= 0.1.8)
+    jenkins-war (1.401)
+    json (1.4.6)
+    json_pure (1.5.1)
+    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)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  awesome_print
+  cucumber (~> 0.10.0)
+  jenkins!
+  jenkins-war (>= 1.396)
+  rake (~> 0.8.7)
+  rspec (~> 2.0.0)

data/README.md

@@ -0,0 +1,159 @@
+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,erlang)
+        --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 suites expects Jenkins to speak English. If you are not using an
+English locale prepare the terminal session running the test suite with:
+
+    export LC_ALL=en_US.UTF-8
+
+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", __FILE__)
+    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", __FILE__)
+        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,11 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+$:.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/cucumber.yml

@@ -0,0 +1,8 @@
+<%
+rerun = File.file?('rerun.txt') ? IO.read('rerun.txt') : ""
+rerun_opts = rerun.to_s.strip.empty? ? "--format #{ENV['CUCUMBER_FORMAT'] || 'pretty'} features" : "--format #{ENV['CUCUMBER_FORMAT'] || 'pretty'} #{rerun}"
+std_opts = "--format #{ENV['CUCUMBER_FORMAT'] || 'pretty'} --strict --tags ~@wip"
+%>
+default: --drb <%= std_opts %> features
+wip: --drb --tags @wip:3 --wip features
+rerun: --drb <%= rerun_opts %> --format rerun --out rerun.txt --strict --tags ~@wip

data/features/build_details.feature

@@ -0,0 +1,42 @@
+Feature: Show build details
+  I want to see details about a particular build for a job I'm interested in
+
+  Scenario: Show build details for a job on a non-existent server (jenkins build_details)
+    When I run local executable "jenkins" with arguments "build_details ruby 1 --host localhost --port 9999"
+    Then I should see exactly
+      """
+      No connection available to the server.
+      """
+  
+  Scenario: Show build details for a non-existent job (jenkins build_details)
+    Given I have a Jenkins server running
+    And the Jenkins server has no current jobs
+    When I run local executable "jenkins" with arguments "build_details ruby 1 --host localhost --port 3010"
+    Then I should see exactly
+      """
+      ERROR: Cannot find project 'ruby'.
+      """
+  
+  Scenario: Show build details for a job (jenkins build_details)
+    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 "build"
+    When I wait for ruby build 1 to start
+    When I run local executable "jenkins" with arguments "build_details ruby 1 --host localhost --port 3010 --json"
+    Then I should see
+      """
+      "builtOn":"","result":"FAILURE","number":1,"keepLog":false,
+      """
+    And I should see
+      """
+      "actions":[{"causes":[{"userName":"anonymous","shortDescription":"Started by user anonymous"},{"userName":"anonymous","shortDescription":"Started by user anonymous"}]}],
+      """
+    And I should see
+      """
+      "description":null,"changeSet":{"kind":null,"items":[]},"fullDisplayName":"ruby #1"
+      """
+  
+  

data/features/configure.feature

@@ -0,0 +1,36 @@
+Feature: Configure host connection information
+
+  Scenario: Configure host connection information and check default host and reconfigure
+    Given I run local executable "jenkins" with arguments "configure --host localhost --port 3010"
+    When I run local executable "jenkins" with arguments "default_host"
+    Then I should see exactly
+      """
+      http://localhost:3010
+      """
+    Given I run local executable "jenkins" with arguments "configure --host localhost --port 3010 --ssl"
+    When I run local executable "jenkins" with arguments "default_host"
+    Then I should see exactly
+      """
+      https://localhost:3010
+      """
+
+  Scenario: Configure host connection authentication information and check auth_info and reconfigure
+    Given I run local executable "jenkins" with arguments "auth_info"
+    Then I should see exactly
+      """
+      """
+    When I run local executable "jenkins" with arguments "configure --username jenkins --password sniknej"
+      And I run local executable "jenkins" with arguments "auth_info"
+    Then I should see exactly
+      """
+      username: jenkins
+      password: sniknej
+      """
+    When I run local executable "jenkins" with arguments "configure --username jenkins1 --password 1sniknej"
+      And I run local executable "jenkins" with arguments "auth_info"
+    Then I should see exactly
+      """
+      username: jenkins1
+      password: 1sniknej
+      """
+