jenkins-maestrodev 0.6.9

data/features/default_host.feature

@@ -0,0 +1,26 @@
+Feature: Display default host information
+
+  Scenario: Display default host information if it is setup
+    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
+      """
+
+  Scenario: Display default secure host information if it is setup
+    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: 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/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.
+      """
+
+  @jenkins-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
+      """
+
+  @jenkins-server
+  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
+
+      """

data/features/manage_jobs.feature

@@ -0,0 +1,263 @@
+@jenkins-server
+Feature: Create and manage jobs
+  In order to reduce cost of getting a new project up onto Jenkins
+  As a project developer
+  I want to add a new project to Jenkins as a job
+
+  Background:
+    Given I have a Jenkins server running
+    And the Jenkins server has no current jobs
+  
+  Scenario: Setup jenkins job for git scm (jenkins create)
+    Given 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"
+    Then I should see exactly
+      """
+      Added ruby project 'ruby' to Jenkins.
+      Triggering initial build...
+      Trigger additional builds via:
+        URL: http://localhost:3010/job/ruby/build
+        CLI: jenkins build ruby
+      """
+    When I run local executable "jenkins" with arguments "list --host localhost --port 3010"
+    Then I should see "ruby"
+  
+  Scenario: Create job via $JENKINS_HOST and $JENKINS_PORT (jenkins create)
+    Given I am in the "ruby" project folder
+    And the project uses "git" scm
+    And env variable $JENKINS_HOST set to "localhost"
+    And env variable $JENKINS_PORT set to "3010"
+    When I run local executable "jenkins" with arguments "create ."
+    Then I should see "http://localhost:3010/job/ruby/build"
+    When I run local executable "jenkins" with arguments "list"
+    Then I should see "ruby"
+  
+  Scenario: Don't trigger initial job build (jenkins create --no-build)
+    Given I am in the "ruby" project folder
+    And the project uses "git" scm
+    When I run local executable "jenkins" with arguments "create . --no-build --host localhost --port 3010"
+    Then I should see exactly
+      """
+      Added ruby project 'ruby' to Jenkins.
+      Trigger builds via:
+        URL: http://localhost:3010/job/ruby/build
+        CLI: jenkins build ruby
+      """
+
+  Scenario: Setup jenkins job with explicit scm url/branches (jenkins create --scm URI --scm-branches='master,other')
+    Given I am in the "ruby" project folder
+    And the project uses "git" scm
+    When I run local executable "jenkins" with arguments "create . --scm git://localhost/myapp.git --scm-branches 'master,other' --host localhost --port 3010"
+    Then I should see "Added ruby project 'ruby' to Jenkins."
+    And the job "ruby" config "scm" should be:
+      """
+      <scm class="hudson.plugins.git.GitSCM">
+          <configVersion>1</configVersion>
+          <remoteRepositories>
+            <org.spearce.jgit.transport.RemoteConfig>
+              <string>origin</string>
+              <int>5</int>
+              <string>fetch</string>
+              <string>+refs/heads/*:refs/remotes/origin/*</string>
+              <string>receivepack</string>
+              <string>git-upload-pack</string>
+              <string>uploadpack</string>
+              <string>git-upload-pack</string>
+              <string>url</string>
+              <string>git://localhost/myapp.git</string>
+              <string>tagopt</string>
+              <string></string>
+            </org.spearce.jgit.transport.RemoteConfig>
+          </remoteRepositories>
+          <branches>
+            <hudson.plugins.git.BranchSpec>
+              <name>master</name>
+            </hudson.plugins.git.BranchSpec>
+            <hudson.plugins.git.BranchSpec>
+              <name>other</name>
+            </hudson.plugins.git.BranchSpec>
+          </branches>
+          <localBranch></localBranch>
+          <mergeOptions />
+          <recursiveSubmodules>false</recursiveSubmodules>
+          <doGenerateSubmoduleConfigurations>false</doGenerateSubmoduleConfigurations>
+          <authorOrCommitter>false</authorOrCommitter>
+          <clean>false</clean>
+          <wipeOutWorkspace>false</wipeOutWorkspace>
+          <pruneBranches>false</pruneBranches>
+          <buildChooser class="hudson.plugins.git.util.DefaultBuildChooser" />
+          <gitTool>Default</gitTool>
+          <submoduleCfg class="list" />
+          <relativeTargetDir></relativeTargetDir>
+          <excludedRegions></excludedRegions>
+          <excludedUsers></excludedUsers>
+        </scm>
+      """
+
+  Scenario: Update the SCM configuration of an existing jenkins job (jenkins update . --scm URI --scm-branches='master')
+    Given I am in the "ruby" project folder
+    And the project uses "git" scm
+    And I run local executable "jenkins" with arguments "create . --scm git://localhost/myapp.git --scm-branches 'master,other' --host localhost --port 3010"
+    Then I should see "Added ruby project 'ruby' to Jenkins."
+    And I run local executable "jenkins" with arguments "update . --scm git://localhost/myapp_new.git --scm-branches 'master' --host localhost --port 3010"
+    Then I should see "Updated ruby project 'ruby'."
+    And the job "ruby" config "scm" should be:
+      """
+      <scm class="hudson.plugins.git.GitSCM">
+          <configVersion>1</configVersion>
+          <remoteRepositories>
+            <org.spearce.jgit.transport.RemoteConfig>
+              <string>origin</string>
+              <int>5</int>
+              <string>fetch</string>
+              <string>+refs/heads/*:refs/remotes/origin/*</string>
+              <string>receivepack</string>
+              <string>git-upload-pack</string>
+              <string>uploadpack</string>
+              <string>git-upload-pack</string>
+              <string>url</string>
+              <string>git://localhost/myapp_new.git</string>
+              <string>tagopt</string>
+              <string />
+            </org.spearce.jgit.transport.RemoteConfig>
+          </remoteRepositories>
+          <branches>
+            <hudson.plugins.git.BranchSpec>
+              <name>master</name>
+            </hudson.plugins.git.BranchSpec>
+          </branches>
+          <localBranch />
+          <mergeOptions />
+          <recursiveSubmodules>false</recursiveSubmodules>
+          <doGenerateSubmoduleConfigurations>false</doGenerateSubmoduleConfigurations>
+          <authorOrCommitter>false</authorOrCommitter>
+          <clean>false</clean>
+          <wipeOutWorkspace>false</wipeOutWorkspace>
+          <buildChooser class="hudson.plugins.git.util.DefaultBuildChooser" />
+          <gitTool>Default</gitTool>
+          <submoduleCfg class="list" />
+          <relativeTargetDir />
+          <excludedRegions />
+          <excludedUsers />
+        </scm>
+      """
+
+  Scenario: Setup jenkins job with multiple rubies (jenkins create --rubies '1.8.7,rbx-head,jruby')
+    Given I am in the "ruby" project folder
+    And the project uses "git" scm
+    When I run local executable "jenkins" with arguments "create . --rubies '1.8.7,rbx-head,jruby' --host localhost --port 3010"
+    Then I should see "Added ruby project 'ruby' to Jenkins."
+    And the job "ruby" config "axes" should be:
+      """
+      <axes>
+          <hudson.matrix.TextAxis>
+            <name>RUBY_VERSION</name>
+            <values>
+              <string>1.8.7</string>
+              <string>rbx-head</string>
+              <string>jruby</string>
+            </values>
+          </hudson.matrix.TextAxis>
+        </axes>
+      """
+
+  Scenario: Setup jenkins job with multiple rubies and multiple nodes (jenkins create --rubies.. --node_labels..)
+    Given I am in the "ruby" project folder
+    And the project uses "git" scm
+    When I run local executable "jenkins" with arguments "create . --rubies '1.8.7,rbx-head,jruby' --node-labels '1.8.7,ubuntu' --host localhost --port 3010"
+    Then I should see "Added ruby project 'ruby' to Jenkins."
+    And the job "ruby" config "axes" should be:
+      """
+      <axes>
+          <hudson.matrix.TextAxis>
+            <name>RUBY_VERSION</name>
+            <values>
+              <string>1.8.7</string>
+              <string>rbx-head</string>
+              <string>jruby</string>
+            </values>
+          </hudson.matrix.TextAxis>
+          <hudson.matrix.LabelAxis>
+            <name>label</name>
+            <values>
+              <string>1.8.7</string>
+              <string>ubuntu</string>
+            </values>
+          </hudson.matrix.LabelAxis>
+        </axes>
+      """
+  
+  Scenario: Setup jenkins job for a specific node label (jenkins create --assigned_node)
+    Given I am in the "ruby" project folder
+    And the project uses "git" scm
+    When I run local executable "jenkins" with arguments "create . --assigned_node my_node --host localhost --port 3010"
+    Then I should see "Added ruby project 'ruby' to Jenkins."
+
+  Scenario: Select 'rails3' project type (jenkins create --template rails3)
+    Given I am in the "rails-3" project folder
+    And the project uses "git" scm
+    When I run local executable "jenkins" with arguments "create . --template rails3 --host localhost --port 3010"
+    Then I should see "Added rails3 project 'rails-3' to Jenkins."
+
+  Scenario: Select 'erlang' project type (jenkins create --template erlang)
+    Given I am in the "erlang" project folder
+    And the project uses "git" scm
+    When I run local executable "jenkins" with arguments "create . --template erlang --host localhost --port 3010"
+    Then I should see "Added erlang project 'erlang' to Jenkins."
+
+  Scenario: Create job without default steps (jenkins create --no-template)
+    Given I am in the "non-bundler" project folder
+    And the project uses "git" scm
+    When I run local executable "jenkins" with arguments "create . --no-template --host localhost --port 3010"
+    Then I should see "Added project 'non-bundler' to Jenkins."
+    And the job "non-bundler" config "builders" should be:
+      """
+      <builders>
+          <hudson.tasks.Shell>
+            <command>echo &quot;THERE ARE NO STEPS! Except this one...&quot;</command>
+          </hudson.tasks.Shell>
+        </builders>
+      """
+
+  Scenario: Reject projects that don't use bundler (jenkins create)
+    Given I am in the "non-bundler" project folder
+    And the project uses "git" scm
+    When I run local executable "jenkins" with arguments "create . --host localhost --port 3010"
+    Then I should see "Ruby/Rails projects without a Gemfile are currently unsupported."
+
+  Scenario: Attempt to create project without scm (jenkins create)
+    Given I am in the "ruby" project folder
+    When I run local executable "jenkins" with arguments "create . --host localhost --port 3010"
+    Then I should see "Cannot determine project SCM. Currently supported:"
+
+  Scenario: Recreate a job (jenkins create --override)
+    Given I am in the "ruby" project folder
+    When I create a job
+    Then I should see "Added ruby project 'ruby' to Jenkins."
+    When I recreate a job
+    Then I should see "Added ruby project 'ruby' to Jenkins."
+
+  Scenario: Trigger a job build (jenkins build)
+    Given I am in the "ruby" project folder
+    When I create a job
+    When I run local executable "jenkins" with arguments "build"
+    Then I should see "Build for 'ruby' running now..."
+  
+  Scenario: Trigger a job build on invaild project (jenkins build)
+    Given I am in the "ruby" project folder
+    When I run local executable "jenkins" with arguments "build . --host localhost --port 3010"
+    Then I should see "ERROR: No job 'ruby' on server."
+  
+  Scenario: Remove a job (jenkins remove)
+    Given I am in the "ruby" project folder
+    When I create a job
+    Then I should see "Added ruby project 'ruby' to Jenkins."
+    When I run local executable "jenkins" with arguments "remove ."
+    Then I should see "Removed project 'ruby' from Jenkins."
+  
+  Scenario: Remove a job that doesn't exist gives error (jenkins remove)
+    Given I am in the "ruby" project folder
+    When I run local executable "jenkins" with arguments "remove . --host localhost --port 3010"
+    Then I should see "ERROR: Failed to delete project 'ruby'."
+  

data/features/manage_slave_nodes.feature

@@ -0,0 +1,83 @@
+@jenkins-server
+Feature: Adding slave nodes
+  In order to have different environments for different projects
+  As a developer
+  I want to add new slave nodes to my Jenkins instance
+
+  Background:
+    Given I have a Jenkins server running
+    And the Jenkins server has no slaves
+    When I run local executable "jenkins" with arguments "nodes --host localhost --port 3010"
+    Then I should see exactly
+      """
+      master
+      """
+
+  Scenario: Add slave via API (jenkins nodes)
+    When I create a new node with the following options on "http://localhost:3010":
+      | name       | Slave 1        |
+      | label      | app1 app2 app3 |
+      | slave_host | foo1.bar.com   |
+      | slave_user | jenkins         |
+    When I run local executable "jenkins" with arguments "nodes"
+    Then I should see exactly
+      """
+      master
+      Slave 1
+      """
+
+  Scenario: Add slave via CLI with name defaulted to URL (jenkins add_node)
+    When I run local executable "jenkins" with arguments "add_node foo1.bar.com --slave-user deploy --labels 'app1,app2'"
+    Then I should see exactly
+      """
+      Added slave node 'foo1.bar.com' to foo1.bar.com
+      """
+    When I run local executable "jenkins" with arguments "add_node foo1.bar.com --slave-user deploy --labels 'app1,app2'"
+    Then I should see exactly
+      """
+      Slave called 'foo1.bar.com' already exists
+      ERROR: Failed to add slave node foo1.bar.com
+      """
+    When I run local executable "jenkins" with arguments "nodes"
+    Then I should see exactly
+      """
+      master
+      foo1.bar.com
+      """
+
+  @wip
+  Scenario: Add a local Vagrant/VirtualBox VM as a slave (jenkins add_node --vagrant)
+    Given I am in the "rails-3" project folder
+    When I run local executable "jenkins" with arguments "add_node localhost --name rails-3 --vagrant --labels 'app1,app2'"
+    Then I should see exactly
+      """
+      Added slave node 'rails-3' to localhost
+      """
+    When I run local executable "jenkins" with arguments "nodes"
+    Then I should see exactly
+      """
+      master
+      rails-3
+      """
+    And the Jenkins config "slaves" should be:
+      """
+      <slaves>
+          <slave>
+            <name>rails-3</name>
+            <description>Automatically created by Jenkins.rb</description>
+            <remoteFS>/vagrant/tmp/jenkins-slave/</remoteFS>
+            <numExecutors>2</numExecutors>
+            <mode>EXCLUSIVE</mode>
+            <retentionStrategy class="hudson.slaves.RetentionStrategy$Always" />
+            <launcher class="hudson.plugins.sshslaves.SSHLauncher">
+              <host>localhost</host>
+              <port>2222</port>
+              <username>vagrant</username>
+              <password>rvDV+OTiBj3UtK5p7sl62Q==</password>
+              <privatekey>/Library/Ruby/Gems/1.8/gems/vagrant-0.6.7/keys/vagrant</privatekey>
+            </launcher>
+            <label>app1 app2</label>
+            <nodeProperties />
+          </slave>
+        </slaves>
+      """

data/features/step_definitions/common_steps.rb

@@ -0,0 +1,192 @@
+
+Given /^this project is active project folder/ do
+  @active_project_folder = File.expand_path(File.dirname(__FILE__) + "/../..")
+end
+
+Given /^env variable \$([\w_]+) set to( project path|) "(.*)"/ do |env_var, path, value|
+  in_project_folder {
+    value = File.expand_path(value)
+  } unless path.empty?
+  ENV[env_var] = value
+end
+
+Given /"(.*)" folder is deleted/ do |folder|
+  in_project_folder { FileUtils.rm_rf folder }
+end
+
+When /^I invoke "(.*)" generator with arguments "(.*)"$/ do |generator, arguments|
+  @stdout = StringIO.new
+  in_project_folder do
+    if Object.const_defined?("APP_ROOT")
+      APP_ROOT.replace(FileUtils.pwd)
+    else
+      APP_ROOT = FileUtils.pwd
+    end
+    run_generator(generator, arguments.split(' '), SOURCES, :stdout => @stdout)
+  end
+  File.open(File.join(@tmp_root, "generator.out"), "w") do |f|
+    @stdout.rewind
+    f << @stdout.read
+  end
+end
+
+When /^I run executable "(.*)" with arguments "(.*)"/ do |executable, arguments|
+  @stdout = File.expand_path(File.join(@tmp_root, "executable.out"))
+  in_project_folder do
+    system "#{executable.inspect} #{arguments} > #{@stdout.inspect} 2> #{@stdout.inspect}"
+  end
+end
+
+When /^I run project executable "(.*)" with arguments "(.*)"/ do |executable, arguments|
+  @stdout = File.expand_path(File.join(@tmp_root, "executable.out"))
+  in_project_folder do
+    system "ruby #{executable.inspect} #{arguments} > #{@stdout.inspect} 2> #{@stdout.inspect}"
+  end
+end
+
+When /^I run local executable "(.*)" with arguments "(.*)"/ do |executable, arguments|
+  @stdout = File.expand_path(File.join(@tmp_root, "executable.out"))
+  executable = File.expand_path(File.join(File.dirname(__FILE__), "/../../bin", executable))
+  in_project_folder do
+    system "ruby #{executable.inspect} #{arguments} > #{@stdout.inspect} 2> #{@stdout.inspect}"
+  end
+end
+
+When /^I invoke task "rake (.*)"/ do |task|
+  @stdout = File.expand_path(File.join(@tmp_root, "tests.out"))
+  in_project_folder do
+    system "rake #{task} --trace > #{@stdout.inspect} 2> #{@stdout.inspect}"
+  end
+end
+
+Then /^folder "(.*)" (is|is not) created/ do |folder, is|
+  in_project_folder do
+    File.exists?(folder).should(is == 'is' ? be_true : be_false)
+  end
+end
+
+Then /^file "(.*)" (is|is not) created/ do |file, is|
+  in_project_folder do
+    File.exists?(file).should(is == 'is' ? be_true : be_false)
+  end
+end
+
+Then /^file with name matching "(.*)" is created/ do |pattern|
+  in_project_folder do
+    Dir[pattern].should_not be_empty
+  end
+end
+
+Then /^file "(.*)" contents (does|does not) match \/(.*)\// do |file, does, regex|
+  in_project_folder do
+    actual_output = File.read(file)
+    (does == 'does') ?
+      actual_output.should(match(/#{regex}/)) :
+      actual_output.should_not(match(/#{regex}/))
+  end
+end
+
+Then /gem file "(.*)" and generated file "(.*)" should be the same/ do |gem_file, project_file|
+  File.exists?(gem_file).should be_true
+  File.exists?(project_file).should be_true
+  gem_file_contents = File.read(File.dirname(__FILE__) + "/../../#{gem_file}")
+  project_file_contents = File.read(File.join(@active_project_folder, project_file))
+  project_file_contents.should == gem_file_contents
+end
+
+Then /^(does|does not) invoke generator "(.*)"$/ do |does_invoke, generator|
+  actual_output = get_command_output
+  does_invoke == "does" ?
+    actual_output.should(match(/dependency\s+#{generator}/)) :
+    actual_output.should_not(match(/dependency\s+#{generator}/))
+end
+
+Then /help options "(.*)" and "(.*)" are displayed/ do |opt1, opt2|
+  actual_output = get_command_output
+  actual_output.should match(/#{opt1}/)
+  actual_output.should match(/#{opt2}/)
+end
+
+Then /^I should see "([^\"]*)"$/ do |text|
+  actual_output = get_command_output
+  actual_output.should contain(text)
+end
+
+Then /^I should not see "([^\"]*)"$/ do |text|
+  actual_output =
+  actual_output.should_not contain(text)
+end
+
+Then /^I should see$/ do |text|
+  actual_output = get_command_output
+  actual_output.should contain(text)
+end
+
+Then /^I should not see$/ do |text|
+  actual_output = get_command_output
+  actual_output.should_not contain(text)
+end
+
+Then /^I should see exactly$/ do |text|
+  actual_output = get_command_output
+  actual_output.should == text
+end
+
+Then /^I should see all (\d+) tests pass/ do |expected_test_count|
+  expected = %r{^#{expected_test_count} tests, \d+ assertions, 0 failures, 0 errors}
+  actual_output = get_command_output
+  actual_output.should match(expected)
+end
+
+Then /^I should see all (\d+) examples pass/ do |expected_test_count|
+  expected = %r{^#{expected_test_count} examples?, 0 failures}
+  actual_output = get_command_output
+  actual_output.should match(expected)
+end
+
+Then /^yaml file "(.*)" contains (\{.*\})/ do |file, yaml|
+  in_project_folder do
+    yaml = eval yaml
+    YAML.load(File.read(file)).should == yaml
+  end
+end
+
+Then /^Rakefile can display tasks successfully/ do
+  @stdout = File.expand_path(File.join(@tmp_root, "rakefile.out"))
+  in_project_folder do
+    system "rake -T > #{@stdout.inspect} 2> #{@stdout.inspect}"
+  end
+  actual_output = get_command_output
+  actual_output.should match(/^rake\s+\w+\s+#\s.*/)
+end
+
+Then /^task "rake (.*)" is executed successfully/ do |task|
+  @stdout.should_not be_nil
+  actual_output = get_command_output
+  actual_output.should_not match(/^Don't know how to build task '#{task}'/)
+  actual_output.should_not match(/Error/i)
+end
+
+Then /^gem spec key "(.*)" contains \/(.*)\// do |key, regex|
+  in_project_folder do
+    gem_file = Dir["pkg/*.gem"].first
+    gem_spec = Gem::Specification.from_yaml(`gem spec #{gem_file}`)
+    spec_value = gem_spec.send(key.to_sym)
+    spec_value.to_s.should match(/#{regex}/)
+  end
+end
+
+Then /^the file "([^\"]*)" is a valid gemspec$/ do |filename|
+  spec = eval(File.read(filename))
+  spec.validate
+end
+
+When /^I create a new node with the following options on "http:\/\/(.+?):(\d+)":$/ do |host, port, table|
+  options = table.raw.inject({}) do |options, (key, value)|
+    options[(key.to_sym rescue key) || key] = value
+    options
+  end
+
+  Jenkins::Api.setup_base_url(:host => host, :port => port.to_i)
+  Jenkins::Api.add_node(options)
+end