jenkins_api_client 0.11.0 → 0.14.0

data/.gitignore

@@ -17,6 +17,9 @@ doc
 #
 Gemfile.lock
 
+# graphviz dot file
+*.dot
+
 # MacOS:
 .DS_Store
 

data/.travis.yml

@@ -2,23 +2,29 @@ language: ruby
 rvm:
   - 2.0.0
   - 1.9.3
-  - 1.9.2
   - jruby-18mode
   - jruby-19mode
   - rbx-18mode
   - rbx-19mode
-  - ruby-head
-  - jruby-head
   - 1.8.7
   - ree
 matrix:
   allow_failures:
     - rvm: jruby-18mode
     - rvm: jruby-19mode
-    - rvm: jruby-head
+    - rvm: rbx-18mode
+    - rvm: rbx-19mode
     - rvm: ree
-script: bundle exec rake unit_tests
+before_install:
+  - travis/setup.sh
+
+script:
+  - bundle exec rake unit_tests
+  - bundle exec rake func_tests
+  - travis/setup_crumb.sh
+  - bundle exec rake func_tests
 notifications:
+  webhooks: https://www.buildheroes.com/api/projects/588c9dffdc8f0deff4d89d87bf370e8dba8a8a95/builds
   email: false
   irc:
     on_success: change

data/CHANGELOG.md

@@ -4,9 +4,77 @@ CHANGELOG
 upcoming
 --------
 
+v0.14.0  [07-AUG-2013]
+----------------------
+* Fixed a bug where a space was missing in the exec_cli method argument list.
+  Credit: @missedone
+* Refactored create/update jobs by introducing create_or_update methods.
+  Credit: @riywo
+* Enhancement to crumb processing - auto detect the change of crumb setting and
+  do proper exception handling. Credit: dougforpress
+* Added a `User` class which will handle jenkins users related functions.
+  Credit: dougforpres
+* Added a method `Job#poll` which will poll for SCM changes programatically.
+* Added a shortcut method `System#restart!` for force restart.
+
+v0.13.0  [09-JUL-2013]
+----------------------
+* Jenkins XSS disable option is now supported. No inputs are required - the
+  jenkins_api_client will automatically detech whether to use the crumbs or not
+  when making the POST requests.
+* Support for logging is added. Logs can be redirected to a log file and the
+  log level can be customized. This implementation uses the `Logger` class so
+  it follows the nice format in logging messages.
+* The job `build` method will now optionally return the build number. This
+  option should be used with care as the build method will wait till the
+  jenkins job is placed on an executor from the build queue. By default the
+  build number will NOT be returned. nil will be returned if the build number
+  is not available. Also a Timeout error will be raised if the job waits in the
+  queue for longer than the 'timeout' parameter. This timeout parameter can be
+  set during the client initialization.
+* Improved documentation
+* Support for enabling/disabling jobs. Credit: @dieterdemeyer
+* Added functionality for copying jobs. Credit: @dieterdemeyer
+* Added functionality for wiping out the workspace of a job.
+  Credit: @dieterdemeyer
+* Added functionality for listing jenkins users. Credit: @dieterdemeyer
+* Fixed a bug where the exceptions where not thrown when using the
+  `get_console_output` method.
+* Fixed a bug where the jenkins_path attribute was ignored when the server_url
+  input argument is given. Credit: @woodbusy
+* support public/private key pair authentication for Jenkins CLI.
+  Credit: @missedone
+
+
+v0.12.1  [25-JUN-2013]
+----------------------
+* Fixed a bug where the SSL support was not working properly with Ruby
+  1.8.7/JRuby 1.6. Credit: @brettporter (For more info:
+  https://github.com/arangamani/jenkins_api_client/pull/85)
+
+v0.12.0  [18-JUN-2013]
+----------------------
+* Authentication is now optional as not all Jenkins instances have
+  authentication enabled by default. Credit: @dougforpres
+* Ability to retrieve build details so that more than just (`lamp color`) is
+  available. Credit: @dougforpres
+* Ability to retrieve build test-results for those builds that have them.
+  Credit: @dougforpres
+* Option to follow any 301/302 responses. This allows POST to build to follow
+  the redirect and end up with a 200 response. Credit: @dougforpres
+* Minor change to the POST requests handling where jenkins instances with a
+  proxy returns 411 if no form data is specified. Fixed by sending an empty
+  hash. Credit: @dougforpres
+* As of Jenkins release 1.519, the job build returns a 201 code instead of 302.
+  This was resulting in an exception and the exception handling is modified to
+  handle this condition.
+* The jobs that are not built yet have a new color (`notbuilt`) in the recent
+  version of jenkins (> 1.517) which resulted in `invalid` status. This is fixed.
+
 v0.11.0  [09-JUN-2013]
 ----------------------
-* A new input argument `server_url` is supported which accepts the jenkins URL instead of IP address and Port. Credit: @dieterdemeyer
+* A new input argument `server_url` is supported which accepts the jenkins URL
+  instead of IP address and Port. Credit: @dieterdemeyer
 * When renaming the job, preserve the job history. Credit: @rubytester
 * Various exception handling improvements. Credit: @drnic
 
@@ -20,17 +88,21 @@ v0.10.0  [24-APR-2013]
 
 v0.9.1  [01-APR-2013]
 ---------------------
-* Removed the dependency of ActiveSupport and Builder as they were not being used.
+* Removed the dependency of ActiveSupport and Builder as they were not being
+  used.
 
 v0.9.0  [10-MAR-2013]
 ---------------------
 * Added capability to send email notification to existing jobs
 * Removed warnings from client.rb
 * Refactored and improved exception handling
-* A bug is fixed in client which allows only the valid params as options. Credit: @Niarfe
-* Added a timeout parameter for waiting for jenkins to become ready. Credit: @Niarfe
+* A bug is fixed in client which allows only the valid params as options.
+  Credit: @Niarfe
+* Added a timeout parameter for waiting for jenkins to become ready.
+  Credit: @Niarfe
 * Added function to reload jenkins. Credit: @missedone
-* Fixed a bug where jenkins_path was missing in get_config and post_config. Credit: @cylol
+* Fixed a bug where jenkins_path was missing in get_config and post_config.
+  Credit: @cylol
 * Added capability to obtain jenkins version and other useful information
 * Added new tests for various cases, and other code improvements
 
@@ -42,7 +114,8 @@ v0.8.0  [14-FEB-2013]
 ---------------------
 * Added capability to send timer trigger while creating a job
 * Added rename feature for jobs
-* Added support for sending skype notification in job creation and on existing jobs
+* Added support for sending skype notification in job creation and on existing
+  jobs
 * Added support for sending Jenkins root URL configuration. Credit: @kevinhcross
 * Added `delete_all!` methods for Job, View, and Node.
 * `get_eta` in BuildQueue will return "N/A" if the ETA is not given by Jenkins
@@ -52,7 +125,8 @@ v0.8.0  [14-FEB-2013]
 
 v0.7.3  [05-FEB-2013]
 ---------------------
-* Fixed #27 with a bug in create_view including extra character in the end of the name
+* Fixed #27 with a bug in create_view including extra character in the end of
+  the name
 
 v0.7.2  [02-FEB-2013]
 ---------------------
@@ -76,24 +150,29 @@ v0.7.0  [27-JAN-2013]
 
 v0.6.2  [13-JAN-2013]
 ---------------------
-* Fixed a bug where running job previously aborted was not recognized by the color
+* Fixed a bug where running job previously aborted was not recognized by the
+  color
 
 v0.6.1  [13-JAN-2013]
 ---------------------
-* Fixed a bug where the last few lines of console output was missed in the CLI when using the `jenkinscli job console` command.
+* Fixed a bug where the last few lines of console output was missed in the CLI
+  when using the `jenkinscli job console` command.
 
 v0.6.0  [12-JAN-2013]
 ---------------------
 * Added functionality to get progressive console output from Jenkins.
-* Added CLI command `console` for printing progressive console output on terminal.
-* Fixed a bug with `get_current_build_number` not returning the recent running build number.
+* Added CLI command `console` for printing progressive console output on
+  terminal.
+* Fixed a bug with `get_current_build_number` not returning the recent running
+  build number.
 
 v0.5.0  [22-DEC-2012]
 ---------------------
 * Added functionality to create jobs with params.
 * Added View class and added methods accessing List Views of Jenkins server.
 * Added functionality to abort a running job.
-* Deprecated `list_running` of Job class. `list_by_status('running')` is suggested.
+* Deprecated `list_running` of Job class. `list_by_status('running')` is
+  suggested.
 
 v0.4.0  [07-DEC-2012]
 ---------------------

data/CONTRIBUTORS.md

@@ -0,0 +1,13 @@
+Thank you very much to all who contributed to this project.
+
+* [Niarfe](https://github.com/Niarfe)
+* [dieterdemeyer](https://github.com/dieterdemeyer)
+* [kevinhcross](https://github.com/kevinhcross)
+* [drnic](https://github.com/drnic)
+* [woodbusy](https://github.com/woodbusy)
+* [missedone](https://github.com/missedone)
+* [cylol](https://github.com/cylol)
+* [madisp](https://github.com/madisp)
+* [rubytester](https://github.com/rubytester)
+* [dougforpres](https://github.com/dougforpres)
+* [brettporter](https://github.com/brettporter)

data/Gemfile

@@ -1,14 +1,15 @@
-source "http://rubygems.org"
+source "https://rubygems.org"
 
-gem "nokogiri"
+gem "nokogiri", "~> 1.5.0"
 gem "thor", ">= 0.16.0"
 gem "json", ">= 0"
 gem "terminal-table", ">= 1.4.0"
-gem "mixlib-shellout", "~> 1.1.0"
+gem "mixlib-shellout", ">= 1.1.0"
 
 group :development do
   gem "bundler", ">= 1.0"
   gem "jeweler", ">= 1.6.4"
+  gem "rspec", "~> 2.13.0"
   gem "simplecov"
-  gem "rspec"
+  gem "yard"
 end

data/README.md

@@ -9,7 +9,7 @@ Copyright © 2012-2013, Kannan Manickam [![endorse](http://api.coderwall.com
 
 Client libraries for communicating with a Jenkins CI server and programatically managing jobs.
 
-IRC Channel: ##jenkins-api-client
+IRC Channel: ##jenkins-api-client (on freenode)
 
 Mailing list: jenkins_api_client@googlegroups.com
 
@@ -17,20 +17,18 @@ Google Group: https://groups.google.com/group/jenkins_api_client
 
 OVERVIEW:
 ---------
-This project is a simple API client for interacting with Jenkins Continuous Integration server.
-Jenkins provides three kinds of remote access API. 1. XML API, 2. JSON API, and 3. Python API.
-This project aims at consuming the JSON API and provides some useful functions for controlling
-jobs on the Jenkins programatically. Even though Jenkins provides an awesome UI for controlling
-jobs, it would be nice and helpful to have a programmable interface so we can dynamically and
-automatically manage jobs and other artifacts.
+This project is a simple API client for interacting with Jenkins Continuous
+Integration server. Jenkins provides three kinds of remote access API.
+1. XML API, 2. JSON API, and 3. Python API. This project aims at consuming the
+JSON API and provides some useful functions for controlling jobs on the Jenkins
+programatically. Even though Jenkins provides an awesome UI for controlling
+jobs, it would be nice and helpful to have a programmable interface so we can
+dynamically and automatically manage jobs and other artifacts.
 
 DETAILS:
 --------
-This projects currently only provides functionality for the <tt>jobs, node, and system</tt> interfaces.
-This is still a work-in-progress project. I mainly use the functionality of this project for my autmation
-work and the functionality mainly focussed on my usage and I believe others might find it useful
-too. I would love to add more features to it and I will continue working on improving existing
-features and add more interfaces such as nodes, views, build queue, etc,.
+This projects currently only provides functionality for the
+<tt>jobs, node, view, system, and build queue</tt> interfaces.
 
 USAGE:
 ------
@@ -44,30 +42,45 @@ Include this gem in your code as a require statement.
 
 ### Using with IRB
 
-If you want to just play with it and not actually want to write a script, you can just use the
-irb launcher script which is available in <tt>scripts/login_with_irb.rb</tt>. But make sure that
-you have your credentials available in the correct location. By default the script assumes that
-you have your credentials file in <tt>~/.jenkins_api_client/login.yml</tt>. If you don't prefer this
-location and would like to use a different location, just modify that script to point to the
-location where the credentials file exists.
+If you want to just play with it and not actually want to write a script, you
+can just use the irb launcher script which is available in
+<tt>scripts/login_with_irb.rb</tt>. But make sure that you have your credentials
+available in the correct location. By default the script assumes that you have
+your credentials file in <tt>~/.jenkins_api_client/login.yml</tt>. If you don't
+prefer this location and would like to use a different location, just modify
+that script to point to the location where the credentials file exists.
 
     ruby scripts/login_with_irb.rb
 
-You will see the that it entered IRB session and you can play with the API client with the
-<tt>@client</tt> object that it has returned.
+You will see the that it entered IRB session and you can play with the API
+client with the <tt>@client</tt> object that it has returned.
 
 ### Authentication
 
-This project supports two types of password-based authentication. You can just you the plain
-password by using <tt>password</tt> parameter. If you don't prefer leaving plain passwords in the
-credentials file, you can encode your password in base64 format and use <tt>password_base64</tt>
-parameter to specify the password either in the arguments or in the credentials file.
+Supplying credentials to the client is optional, as not all Jenkins instances
+require authentication. This project supports two types of password-based
+authentication. You can just you the plain password by using <tt>password</tt>
+parameter. If you don't prefer leaving plain passwords in the credentials file,
+you can encode your password in base64 format and use <tt>password_base64</tt>
+parameter to specify the password either in the arguments or in the credentials
+file. To use the client without credentials, just leave out the
+<tt>username</tt> and <tt>password</tt> parameters. The <tt>password</tt>
+parameter is only required if <tt>username</tt> is specified.
+
+### Cross-site Scripting (XSS) and Crumb Support
+
+Support for Jenkins crumbs has been added.  These allow an application to
+use the Jenkins API POST methods without requiring the 'Prevent Cross Site
+Request Forgery exploits' to be disabled.  The API will check in with the
+Jenkins server to determine whether crumbs are enabled or not, and use them
+if appropriate.
 
 ### Basic Usage
 
-As discussed earlier, you can either specify all the credentials and server information as
-parameters to the Client or have a credentials file and just parse the yaml file and pass it in.
-The following call just passes the information as parameters
+As discussed earlier, you can either specify all the credentials and server
+information as parameters to the Client or have a credentials file and just
+parse the yaml file and pass it in. The following call just passes the
+information as parameters
 
 ```ruby
 @client = JenkinsApi::Client.new(:server_ip => '0.0.0.0',
@@ -76,8 +89,8 @@ The following call just passes the information as parameters
 puts @client.job.list("^Testjob")
 ```
 
-The following example passes the YAML file contents. An example yaml file is located in
-<tt>config/login.yml.example</tt>.
+The following example passes the YAML file contents. An example yaml file is
+located in <tt>config/login.yml.example</tt>.
 
 ```ruby
 @client = JenkinsApi::Client.new(YAML.Load_file(File.expand_path(
@@ -88,8 +101,8 @@ puts @client.job.list_all
 
 ### Chaining and Building Jobs
 
-Sometimes we want certain jobs to be added as downstream projects and run them sequencially.
-The following example will explain how this could be done.
+Sometimes we want certain jobs to be added as downstream projects and run them
+sequencially. The following example will explain how this could be done.
 
 ```ruby
 require 'jenkins_api_client'
@@ -117,28 +130,35 @@ code = @client.job.build(initial_jobs[0])
 raise "Could not build the job specified" unless code == 302
 ```
 
-In the above example, you might have noticed that the chain method returns an array instead of a
-single job. There is a reason behind it. In simple chain, such as the one in the example above, all
-jobs specified are chained one by one. But in some cases they might not be dependent on the previous
-jobs and we might want to run some jobs parallelly. We just have to specify that as a parameter.
-
-For example: <tt>parallel = 3</tt> in the parameter list to the <tt>chain</tt> method will take the first three
-jobs and chain them with the next three jobs and so forth till it reaches the end of the list.
-
-There is another filter option you can specify for the method to take only jobs that are in a
-particular state. In case if we want to build only jobs that are failed or unstable, we can achieve
-that by passing in the states in the third parameter. In the example above, we wanted build all jobs.
-If we just want to build failed and unstable jobs, just pass <tt>["failure", "unstable"]</tt>. Also if you
-pass in an empty array, it will assume that you want to consider all jobs and no filtering will be
-performed.
-
-There is another parameter called <tt>threshold</tt> you can specify for the chaining and this is used
-to decide whether to move forward with the next job in the chain or not. A <tt>success</tt> will move to
-the next job only if the current build succeeds, <tt>failure</tt> will move to the next job even if the build
-fails, and <tt>unstable</tt> will move to the job even if the build is unstable.
-
-The following call to the <tt>chain</tt> method will consider only failed and unstable jobs, chain then
-with 'failure' as the threshold, and also chain three jobs in parallel.
+In the above example, you might have noticed that the chain method returns an
+array instead of a single job. There is a reason behind it. In simple chain,
+such as the one in the example above, all jobs specified are chained one by
+one. But in some cases they might not be dependent on the previous jobs and we
+might want to run some jobs parallelly. We just have to specify that as a
+parameter.
+
+For example: <tt>parallel = 3</tt> in the parameter list to the <tt>chain</tt>
+method will take the first three jobs and chain them with the next three jobs
+and so forth till it reaches the end of the list.
+
+There is another filter option you can specify for the method to take only
+jobs that are in a particular state. In case if we want to build only jobs
+that are failed or unstable, we can achieve that by passing in the states in
+the third parameter. In the example above, we wanted build all jobs. If we just
+want to build failed and unstable jobs, just pass
+<tt>["failure", "unstable"]</tt>. Also if you pass in an empty array, it will
+assume that you want to consider all jobs and no filtering will be performed.
+
+There is another parameter called <tt>threshold</tt> you can specify for the
+chaining and this is used to decide whether to move forward with the next job
+in the chain or not. A <tt>success</tt> will move to the next job only if the
+current build succeeds, <tt>failure</tt> will move to the next job even if the
+build fails, and <tt>unstable</tt> will move to the job even if the build is
+unstable.
+
+The following call to the <tt>chain</tt> method will consider only failed and
+unstable jobs, chain then with 'failure' as the threshold, and also chain three
+jobs in parallel.
 
 ```ruby
 initial_jobs = @client.job.chain(jobs, 'failure', ["failure", "unstable"], 3)
@@ -152,17 +172,35 @@ end
 ### Running Jenkins CLI
 To running [Jenkins CLI](https://wiki.jenkins-ci.org/display/JENKINS/Jenkins+CLI)
 
+* authentication with username/password (deprecated)
+
 ```ruby
-@client = JenkinsApi::Client.new(:server_ip => '0.0.0.0',
+@client = JenkinsApi::Client.new(:server_ip => '127.0.0.1',
          :username => 'somename', :password => 'secret password')
 # The following call will return the version of Jenkins instance
 puts @client.exec_cli("version")
 ```
 
-Before you run the CLI, please make sure the following requirements are fulfilled:
-* JRE/JDK 6 (or above) is installed, and 'java' is on the $PATH environment variable
-* The ```jenkins_api_client/java_deps/jenkins-cli.jar``` is required as the client to run the CLI. You can retrieve the available commands via accessing the URL: ```http://<server>:<port>/cli```
-* (Optional) required if you run the Groovy Script through CLI, make sure the *user* have the privilige to run script
+* authentication with public/private key file
+remember to upload the public key to
+http://<Server IP>:<Server Port>/user/<Username>/configure
+
+```ruby
+@client = JenkinsApi::Client.new(:server_ip => '127.0.0.1',
+         :identity_file => '~/.ssh/id_rsa')
+# The following call will return the version of Jenkins instance
+puts @client.exec_cli("version")
+```
+
+Before you run the CLI, please make sure the following requirements are
+fulfilled:
+* JRE/JDK 6 (or above) is installed, and 'java' is on the $PATH environment
+  variable
+* The ```jenkins_api_client/java_deps/jenkins-cli.jar``` is required as the
+  client to run the CLI. You can retrieve the available commands via accessing
+  the URL: ```http://<server>:<port>/cli```
+* (Optional) required if you run the Groovy Script through CLI, make sure
+  the *user* have the privilige to run script
 
 ### Using with command line
 Command line interface is supported only from version 0.2.0.
@@ -171,12 +209,46 @@ See help using <tt>jenkinscli help</tt>
 There are three ways for authentication using command line interface
 1. Passing all credentials and server information using command line parameters
 2. Passing the credentials file as the command line parameter
-3. Having the credentials file in the default location <tt>HOME/.jenkins_api_client/login.yml</tt>
+3. Having the credentials file in the default location
+   <tt>HOME/.jenkins_api_client/login.yml</tt>
 
 ### Debug
 
-The call to client initialization accepts a debug parameter. If it is set to <tt>true</tt> it will print
-some debug information to the console. By default it is set to false.
+As of v0.13.0, this debug parameter is removed. Use the logger instead. See the
+next section for more information about this option.
+
+### Logger
+
+As of v0.13.0, support for logger is introduced. Since it would be nice to have
+the activities of the jenkins_api_client in a log file, this feature is
+implemented using the Ruby's standard Logger class. For using this feature,
+there are two new input arguments used during the initialization of Client.
+
+1. `:log_location` - This argument specifies the location for the log file. A
+   good location for linux based systems would be
+   '/var/log/jenkins_api_client.log'. The default for this values is STDOUT.
+   This will print the log messages on the console itself.
+2. `:log_level` - This argument specifies the level of messages to be logged.
+   It should be one of Logger::DEBUG (0), Logger::INFO (1), Logger::WARN (2),
+   Logger::ERROR (3), Logger::FATAL (4). It can be specified either using the
+   constants available in the Logger class or using these integers provided
+   here. The default for this argument is Logger::INFO (1)
+
+If you want customization on the functionality Logger provides such as leave n
+old log files, open the log file in append mode, create your own logger and
+then set that in the client.
+
+#### Examples
+
+```ruby
+  @client = JenkinsApi::Client.new(...)
+  # Create a logger which ages logfile once it reaches a certain size. Leave 10
+  # “old log files” and each file is about 1,024,000 bytes.
+  @client.logger = Logger.new('foo.log', 10, 1024000)
+```
+Please refer to [Ruby
+Logger](http://www.ruby-doc.org/stdlib-1.9.3/libdoc/logger/rdoc/Logger.html)
+for more information.
 
 CONTRIBUTING:
 -------------
@@ -195,6 +267,6 @@ Please take a look at the issues page if you want to get started.
 FEATURE REQUEST:
 ----------------
 
-If you use this gem for your project and you think it would be nice to have a particular feature
-that is presently not implemented, I would love to hear that and consider working on it.
-Just open an issue in Github as a feature request.
+If you use this gem for your project and you think it would be nice to have a
+particular feature that is presently not implemented, I would love to hear that
+and consider working on it. Just open an issue in Github as a feature request.

data/Rakefile

@@ -3,6 +3,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'jenkins_api_client/version'
 require 'rake'
 require 'jeweler'
+require 'yard'
 
 Jeweler::Tasks.new do |gemspec|
   gemspec.name             = 'jenkins_api_client'
@@ -41,4 +42,65 @@ RSpec::Core::RakeTask.new(:test) do |spec|
   spec.rspec_opts = ['--color', '--format documentation']
 end
 
-task :default => [:unit_tests]
+YARD::Config.load_plugin 'thor'
+YARD::Rake::YardocTask.new do |t|
+  t.files = ['lib/**/*.rb', 'lib/**/**/*.rb']
+end
+
+namespace :doc do
+  # This task requires that graphviz is installed locally. For more info:
+  # http://www.graphviz.org/
+  desc "Generates the class diagram using the yard generated dot file"
+  task :generate_class_diagram do
+    puts "Generating the dot file..."
+    `yard graph --file jenkins_api_client.dot`
+    puts "Generating class diagram from the dot file..."
+    `dot jenkins_api_client.dot -Tpng -o jenkins_api_client_class_diagram.png`
+  end
+
+  desc "Applies Google Analytics tracking script to all generated html files"
+  task :apply_google_analytics do
+    files = Dir.glob("**/*.html")
+
+    string_to_replace = "</body>"
+    string_to_replace_with = <<-EOF
+      <script type="text/javascript">
+        var _gaq = _gaq || [];
+        _gaq.push(['_setAccount', 'UA-37519629-2']);
+        _gaq.push(['_trackPageview']);
+
+        (function() {
+            var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+            ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+            var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+        })();
+      </script>
+    </body>
+    EOF
+
+    files.each do |html_file|
+      puts "Processing file: #{html_file}"
+      contents = ""
+      # Read the file contents
+      file =  File.open(html_file)
+      file.each { |line| contents << line }
+      file.close
+
+      # If the file already has google analytics tracking info, skip it.
+      if contents.include?(string_to_replace_with)
+        puts "Skipped..."
+        next
+      end
+
+      # Apply google analytics tracking info to the html file
+      contents.gsub!(string_to_replace, string_to_replace_with)
+
+      # Write the contents with the google analytics info to the file
+      file =  File.open(html_file, "w")
+      file.write(contents)
+      file.close
+    end
+  end
+end
+
+task :default => [:unit_tests]