glennr-cijoe 0.4.3

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,6 @@
1
+ .DS_Store
2
+ rdoc
3
+ pkg
4
+ *.tmproj
5
+ tmp/**/*
6
+ tmp/*
data/LICENSE ADDED
@@ -0,0 +1,20 @@
1
+ Copyright (c) 2009 Chris Wanstrath
2
+
3
+ Permission is hereby granted, free of charge, to any person obtaining
4
+ a copy of this software and associated documentation files (the
5
+ "Software"), to deal in the Software without restriction, including
6
+ without limitation the rights to use, copy, modify, merge, publish,
7
+ distribute, sublicense, and/or sell copies of the Software, and to
8
+ permit persons to whom the Software is furnished to do so, subject to
9
+ the following conditions:
10
+
11
+ The above copyright notice and this permission notice shall be
12
+ included in all copies or substantial portions of the Software.
13
+
14
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
15
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
16
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
17
+ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
18
+ LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
19
+ OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
20
+ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
@@ -0,0 +1,170 @@
1
+ CI Joe
2
+ ======
3
+
4
+ Joe is a [Continuous
5
+ Integration](http://en.wikipedia.org/wiki/Continuous_integration)
6
+ server that'll run your tests on demand and report their pass/fail status.
7
+
8
+ Because knowing is half the battle.
9
+
10
+ ![The Battle](http://img.skitch.com/20090805-g4a2qhttwij8n2jr9t552efn3k.png)
11
+
12
+ Quickstart
13
+ ----------
14
+
15
+ RubyGems:
16
+
17
+ $ gem install cijoe
18
+ $ git clone git://github.com/you/yourrepo.git
19
+ $ cijoe yourrepo
20
+
21
+ Boom. Navigate to <http://localhost:4567> to see Joe in action.
22
+ Check `cijoe -h` for other options.
23
+
24
+ Basically you need to run `cijoe` and hand it the path to a git
25
+ repo. Make sure this isn't a shared repo: Joe needs to own it.
26
+
27
+ Joe looks for various git config settings in the repo you hand it. For
28
+ instance, you can tell Joe what command to run by setting
29
+ `cijoe.runner`:
30
+
31
+ $ git config --add cijoe.runner "rake -s test:units"
32
+
33
+ Joe doesn't care about Ruby, Python, or whatever. As long as the
34
+ runner returns a non-zero exit status on fail and a zero on success,
35
+ everyone is happy.
36
+
37
+ Need to do some massaging of your repo before the tests run, like
38
+ maybe swapping in a new database.yml? No problem - Joe will try to
39
+ run `.git/hooks/after-reset` if it exists before each build phase.
40
+ Do it in there. Just make sure it's executable.
41
+
42
+ Want to notify IRC or email on test pass or failure? Joe will run
43
+ `.git/hooks/build-failed` or `.git/hooks/build-worked` if they exist
44
+ and are executable on build pass / fail. They're just shell scripts -
45
+ put whatever you want in there.
46
+
47
+ Tip: your repo's `HEAD` will point to the commit used to run the
48
+ build. Pull any metadata you want out of that scro.
49
+
50
+
51
+ Other Branches
52
+ ----------------------
53
+
54
+ Want joe to run against a branch other than `master`? No problem:
55
+
56
+ $ git config --add cijoe.branch deploy
57
+
58
+
59
+ Concurrent Push's - a kind of "queueing"
60
+ ----------------------------------------
61
+
62
+ Joe runs just one build at the time. If you expect concurrent push's
63
+ to your repo and want joe to build each in a kind of queue, just set:
64
+
65
+ $ git config --add cijoe.buildallfile tmp/cijoe.txt
66
+
67
+ Joe will save requests while another build runs. If more than one push
68
+ hits joe, he just picks the last after finishing the prior.
69
+
70
+
71
+ Campfire
72
+ -------------
73
+
74
+ Campfire notification is included, because it's what we use. Want Joe
75
+ notify your Campfire? Put this in your repo's `.git/config`:
76
+
77
+ [campfire]
78
+ token = your_api_token
79
+ subdomain = whatever
80
+ room = Awesomeness
81
+ ssl = false
82
+
83
+ Note: your API token may differ between subdomains!
84
+
85
+ Or do it the old fashion way:
86
+
87
+ $ cd yourrepo
88
+ $ git config --add campfire.token 98ADFLKJSDOIU7BLAH
89
+ $ git config --add campfire.subdomain github
90
+ etc.
91
+
92
+
93
+ Checkin' Status
94
+ ----------------------
95
+
96
+ Want to see how your build's doing without any of this fancy UI crap?
97
+ Ping Joe for the lowdown:
98
+
99
+ curl http://localhost:4567/ping
100
+
101
+ Joe will return `200 OK` if all is quiet on the Western Front. If
102
+ Joe's busy building or your last build failed, you'll get `412
103
+ PRECONDITION FAILED`.
104
+
105
+
106
+ Multiple Projects
107
+ ------------------------
108
+
109
+ Want CI for multiple projects? Just start multiple instances of Joe!
110
+ He can run on any port - try `cijoe -h` for more options.
111
+
112
+ If you're using Passenger, see [this blog post](http://chrismdp.github.com/2010/03/multiple-ci-joes-with-rack-and-passenger/).
113
+
114
+
115
+ HTTP Auth
116
+ ----------------
117
+
118
+ Worried about people triggering your builds? Setup HTTP auth:
119
+
120
+ $ git config --add cijoe.user chris
121
+ $ git config --add cijoe.pass secret
122
+
123
+
124
+ GitHub Integration
125
+ --------------------------
126
+
127
+ Any POST to Joe will trigger a build. If you are hiding Joe behind
128
+ HTTP auth, that's okay - GitHub knows how to authenticate properly.
129
+
130
+ ![Post-Receive URL](http://img.skitch.com/20090806-d2bxrk733gqu8m11tf4kyir5d8.png)
131
+
132
+ You can find the Post-Receive option under the 'Service Hooks' subtab
133
+ of your project's "Admin" tab.
134
+
135
+
136
+ Daemonize
137
+ ----------------
138
+
139
+ Want to run Joe as a daemon? Use `nohup`:
140
+
141
+ $ nohup cijoe -p 4444 repo &
142
+
143
+
144
+ Other CI Servers
145
+ ------------------------
146
+
147
+ Need more features? More notifiers? Check out one of these bad boys:
148
+
149
+ * [Cerberus](http://cerberus.rubyforge.org/)
150
+ * [Integrity](http://integrityapp.com/)
151
+ * [CruiseControl.rb](http://cruisecontrolrb.thoughtworks.com/)
152
+ * [BuildBot](http://buildbot.net/trac)
153
+ * [Signal](http://www.github.com/dcrec1/signal)
154
+
155
+
156
+ Screenshots
157
+ ------------------
158
+
159
+ ![Building](http://img.skitch.com/20090806-ryw34ksi5ixnrdwxcptqy28iy7.png)
160
+
161
+ ![Built](http://img.skitch.com/20090806-f7j3r65yecaq13hdcxqwtc5krd.)
162
+
163
+
164
+ Questions? Concerns?
165
+ ---------------------------------
166
+
167
+ [Issues](http://github.com/defunkt/cijoe/issues) or [the mailing list](http://groups.google.com/group/cijoe).
168
+
169
+
170
+ ( Chris Wanstrath :: chris@ozmm.org )
@@ -0,0 +1,68 @@
1
+ desc "Build a gem"
2
+ task :gem => [ :gemspec, :build ]
3
+
4
+ begin
5
+ require 'jeweler'
6
+
7
+ $LOAD_PATH.unshift File.dirname(__FILE__) + '/lib'
8
+ require 'cijoe/version'
9
+
10
+ Jeweler::Tasks.new do |gemspec|
11
+ gemspec.name = "glennr-cijoe"
12
+ gemspec.summary = "CI Joe is a simple Continuous Integration server."
13
+ gemspec.description = "CI Joe is a simple Continuous Integration server."
14
+ gemspec.email = "chris@ozmm.org"
15
+ gemspec.homepage = "http://github.com/defunkt/cijoe"
16
+ gemspec.authors = ["Chris Wanstrath"]
17
+ gemspec.add_dependency 'choice'
18
+ gemspec.add_dependency 'sinatra'
19
+ gemspec.add_dependency 'tinder'
20
+ gemspec.add_development_dependency 'rack-test'
21
+ gemspec.version = CIJoe::Version.to_s
22
+ end
23
+ rescue LoadError
24
+ puts "Jeweler not available."
25
+ puts "Install it with: gem install jeweler"
26
+ end
27
+
28
+ desc "Publish a RubyGem"
29
+ task :publish => :gem do
30
+ $LOAD_PATH.unshift File.dirname(__FILE__) + '/lib'
31
+ require 'cijoe/version'
32
+
33
+ sh "gem push pkg/glennr-cijoe-#{CIJoe::Version}.gem"
34
+ end
35
+
36
+ require 'rake/testtask'
37
+ Rake::TestTask.new(:test) do |test|
38
+ test.libs << 'lib' << 'test'
39
+ test.pattern = 'test/**/test_*.rb'
40
+ test.verbose = true
41
+ end
42
+
43
+ begin
44
+ require 'rcov/rcovtask'
45
+ Rcov::RcovTask.new do |test|
46
+ test.libs << 'test'
47
+ test.pattern = 'test/**/test_*.rb'
48
+ test.verbose = true
49
+ end
50
+ rescue LoadError
51
+ task :rcov do
52
+ abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
53
+ end
54
+ end
55
+
56
+ task :test => :check_dependencies
57
+
58
+ task :default => :test
59
+
60
+ require 'rake/rdoctask'
61
+ Rake::RDocTask.new do |rdoc|
62
+ version = File.exist?('VERSION') ? File.read('VERSION') : ""
63
+
64
+ rdoc.rdoc_dir = 'rdoc'
65
+ rdoc.title = "someproject #{version}"
66
+ rdoc.rdoc_files.include('README*')
67
+ rdoc.rdoc_files.include('lib/**/*.rb')
68
+ end
@@ -0,0 +1,51 @@
1
+ #!/usr/bin/env ruby
2
+ $LOAD_PATH.unshift File.dirname(__FILE__) + '/../lib'
3
+
4
+ require 'choice'
5
+
6
+ Choice.options do
7
+ banner "Usage: #{File.basename(__FILE__)} [-hpv] path_to_git_repo"
8
+ header ''
9
+ header 'Server options:'
10
+
11
+ option :host do
12
+ d = "0.0.0.0"
13
+ short '-h'
14
+ long '--host=HOST'
15
+ desc "The hostname or ip of the host to bind to (default #{d})"
16
+ default d
17
+ end
18
+
19
+ option :port do
20
+ d = 4567
21
+ short '-p'
22
+ long '--port=PORT'
23
+ desc "The port to listen on (default #{d})"
24
+ cast Integer
25
+ default d
26
+ end
27
+
28
+ separator ''
29
+ separator 'Common options: '
30
+
31
+ option :help do
32
+ long '--help'
33
+ desc 'Show this message'
34
+ end
35
+
36
+ option :version do
37
+ short '-v'
38
+ long '--version'
39
+ desc 'Show version'
40
+ action do
41
+ puts "#{File.basename(__FILE__)} v#{CIJoe::Version}"
42
+ exit
43
+ end
44
+ end
45
+ end
46
+
47
+ options = Choice.choices
48
+
49
+ require 'cijoe'
50
+
51
+ CIJoe::Server.start(options[:host], options[:port], File.expand_path(Choice.rest[0]))
@@ -0,0 +1,77 @@
1
+ # Generated by jeweler
2
+ # DO NOT EDIT THIS FILE DIRECTLY
3
+ # Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
4
+ # -*- encoding: utf-8 -*-
5
+
6
+ Gem::Specification.new do |s|
7
+ s.name = %q{cijoe}
8
+ s.version = "0.4.1"
9
+
10
+ s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
11
+ s.authors = ["Chris Wanstrath"]
12
+ s.date = %q{2010-07-21}
13
+ s.default_executable = %q{cijoe}
14
+ s.description = %q{CI Joe is a simple Continuous Integration server.}
15
+ s.email = %q{chris@ozmm.org}
16
+ s.executables = ["cijoe"]
17
+ s.extra_rdoc_files = [
18
+ "LICENSE",
19
+ "README.markdown"
20
+ ]
21
+ s.files = [
22
+ ".gitignore",
23
+ "LICENSE",
24
+ "README.markdown",
25
+ "Rakefile",
26
+ "bin/cijoe",
27
+ "deps.rip",
28
+ "examples/build-failed",
29
+ "examples/build-worked",
30
+ "examples/cijoe.ru",
31
+ "examples/cijoed",
32
+ "lib/cijoe.rb",
33
+ "lib/cijoe/build.rb",
34
+ "lib/cijoe/campfire.rb",
35
+ "lib/cijoe/commit.rb",
36
+ "lib/cijoe/config.rb",
37
+ "lib/cijoe/public/favicon.ico",
38
+ "lib/cijoe/public/octocat.png",
39
+ "lib/cijoe/public/screen.css",
40
+ "lib/cijoe/server.rb",
41
+ "lib/cijoe/version.rb",
42
+ "lib/cijoe/views/template.erb",
43
+ "test/helper.rb",
44
+ "test/test_cijoe.rb",
45
+ "test/test_cijoe_server.rb"
46
+ ]
47
+ s.homepage = %q{http://github.com/defunkt/cijoe}
48
+ s.rdoc_options = ["--charset=UTF-8"]
49
+ s.require_paths = ["lib"]
50
+ s.rubygems_version = %q{1.3.7}
51
+ s.summary = %q{CI Joe is a simple Continuous Integration server.}
52
+ s.test_files = [
53
+ "test/helper.rb",
54
+ "test/test_cijoe.rb",
55
+ "test/test_cijoe_server.rb"
56
+ ]
57
+
58
+ if s.respond_to? :specification_version then
59
+ current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
60
+ s.specification_version = 3
61
+
62
+ if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
63
+ s.add_runtime_dependency(%q<choice>, [">= 0"])
64
+ s.add_runtime_dependency(%q<sinatra>, [">= 0"])
65
+ s.add_development_dependency(%q<rack-test>, [">= 0"])
66
+ else
67
+ s.add_dependency(%q<choice>, [">= 0"])
68
+ s.add_dependency(%q<sinatra>, [">= 0"])
69
+ s.add_dependency(%q<rack-test>, [">= 0"])
70
+ end
71
+ else
72
+ s.add_dependency(%q<choice>, [">= 0"])
73
+ s.add_dependency(%q<sinatra>, [">= 0"])
74
+ s.add_dependency(%q<rack-test>, [">= 0"])
75
+ end
76
+ end
77
+
@@ -0,0 +1,4 @@
1
+ git://github.com/collectiveidea/tinder.git 1.4.0
2
+ git://github.com/sinatra/sinatra.git 0.9.4
3
+ git://github.com/rack/rack.git 1.0
4
+ git://github.com/defunkt/choice.git 8b125564
@@ -0,0 +1,22 @@
1
+ #!/bin/sh
2
+ #
3
+ # Put this file to $PROJECT/.git/hooks/ for email notifications.
4
+ #
5
+ # You should have mail command provided by mailutils package on Debian
6
+ # based systems.
7
+ #
8
+ # sudo apt-get install mailutils
9
+ #
10
+ # You should have mail server running
11
+ #
12
+ # Do not forget: chmod +x build-failed
13
+ #
14
+ echo "
15
+ Visit http://ci.example.org/ for details
16
+
17
+ Author: $AUTHOR
18
+ Message:
19
+ $MESSAGE
20
+
21
+ $OUTPUT
22
+ " | mail -s "[example.org] BUILD FAILED $SHA" --to first@gmail.com second@gmail.com
@@ -0,0 +1,22 @@
1
+ #!/bin/sh
2
+ #
3
+ # Put this file to $PROJECT/.git/hooks/ for email notifications.
4
+ #
5
+ # You should have mail command provided by mailutils package on Debian
6
+ # based systems.
7
+ #
8
+ # sudo apt-get install mailutils
9
+ #
10
+ # You should have mail server running
11
+ #
12
+ # Do not forget: chmod +x build-worked
13
+ #
14
+ echo "
15
+ Visit http://ci.example.org/ for details
16
+
17
+ Author: $AUTHOR
18
+ Message:
19
+ $MESSAGE
20
+
21
+ " | mail -s "[example.org] build OK" --to first@gmail.com second@gmail.com
22
+