auser-poolparty 1.2.2 → 1.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/VERSION.yml +1 -1
- data/bin/cloud +37 -48
- data/bin/cloud-bootstrap +33 -23
- data/bin/cloud-configure +33 -34
- data/bin/cloud-console +31 -9
- data/bin/cloud-contract +27 -11
- data/bin/cloud-expand +32 -19
- data/bin/cloud-list +31 -15
- data/bin/cloud-osxcopy +22 -12
- data/bin/cloud-provision +35 -24
- data/bin/cloud-setup-dev +31 -20
- data/bin/cloud-show +40 -21
- data/bin/cloud-ssh +24 -15
- data/bin/cloud-start +33 -19
- data/bin/cloud-terminate +33 -20
- data/bin/cloud-verify +38 -29
- data/bin/install-poolparty +4 -198
- data/bin/server-cloud-elections +1 -1
- data/examples/basic.rb +9 -9
- data/examples/fairchild.rb +1 -1
- data/examples/metavirt_cloud.rb +21 -0
- data/lib/poolparty/aska.rb +3 -0
- data/lib/poolparty/base_packages/haproxy.rb +19 -18
- data/lib/poolparty/base_packages/poolparty.rb +1 -1
- data/lib/poolparty/core/hash.rb +46 -0
- data/lib/poolparty/core/object.rb +21 -15
- data/lib/poolparty/core/string.rb +16 -0
- data/lib/poolparty/dependency_resolver/chef_resolver.rb +23 -6
- data/lib/poolparty/dependency_resolver/dependency_resolver.rb +1 -1
- data/lib/poolparty/dependency_resolver/dependency_resolver_cloud_extensions.rb +2 -2
- data/lib/poolparty/dependency_resolver/puppet_resolver.rb +10 -32
- data/lib/poolparty/helpers/optioner.rb +19 -14
- data/lib/poolparty/installers/base_installer.rb +113 -0
- data/lib/poolparty/installers/ec2.rb +141 -0
- data/lib/poolparty/installers/vmrun.rb +144 -0
- data/lib/poolparty/modules/callbacks.rb +6 -2
- data/lib/poolparty/modules/cloud_dsl.rb +2 -2
- data/lib/poolparty/modules/cloud_resourcer.rb +10 -50
- data/lib/poolparty/modules/file_writer.rb +2 -2
- data/lib/poolparty/modules/pinger.rb +4 -1
- data/lib/poolparty/modules/resourcing_dsl.rb +1 -29
- data/lib/poolparty/modules/searchable_paths.rb +3 -3
- data/lib/poolparty/monitors/monitor_rack.rb +1 -1
- data/lib/poolparty/net/remote_bases.rb +2 -0
- data/lib/poolparty/net/remote_instance.rb +6 -4
- data/lib/poolparty/net/remoter/interactive.rb +2 -3
- data/lib/poolparty/net/remoter_base.rb +54 -31
- data/lib/poolparty/net/remoter_bases/ec2/ec2.rb +49 -26
- data/lib/poolparty/net/remoter_bases/ec2/ec2_remote_instance.rb +6 -19
- data/lib/poolparty/net/remoter_bases/ec2/ec2_response_object.rb +4 -3
- data/lib/poolparty/net/remoter_bases/metavirt/metavirt.rb +99 -0
- data/lib/poolparty/net/remoter_bases/metavirt/metavirt_instance.rb +52 -0
- data/lib/poolparty/net/remoter_bases/vmrun/utilities/vm_disk.rb +1 -1
- data/lib/poolparty/net/remoter_bases/vmrun/utilities/vmx.rb +1 -1
- data/lib/poolparty/net/remoter_bases/vmrun/utilities/vmx_file.rb +117 -117
- data/lib/poolparty/net/remoter_bases/vmrun/vmrun.rb +36 -31
- data/lib/poolparty/net/remoter_bases/vmrun/vmrun_instance.rb +9 -5
- data/lib/poolparty/plugins/apache2/apache.rb +118 -73
- data/lib/poolparty/plugins/chef.rb +15 -17
- data/lib/poolparty/plugins/chef_deploy.rb +18 -4
- data/lib/poolparty/plugins/deploy_directory.rb +25 -16
- data/lib/poolparty/plugins/gem_package.rb +15 -5
- data/lib/poolparty/plugins/git.rb +44 -30
- data/lib/poolparty/plugins/line_in_file.rb +5 -1
- data/lib/poolparty/plugins/rails_deploy.rb +79 -26
- data/lib/poolparty/plugins/svn.rb +2 -2
- data/lib/poolparty/poolparty/cloud.rb +101 -47
- data/lib/poolparty/poolparty/default.rb +25 -23
- data/lib/poolparty/poolparty/key.rb +18 -27
- data/lib/poolparty/poolparty/neighborhoods.rb +1 -1
- data/lib/poolparty/poolparty/plugin.rb +17 -7
- data/lib/poolparty/poolparty/pool.rb +3 -3
- data/lib/poolparty/poolparty/poolparty_base_class.rb +41 -35
- data/lib/poolparty/poolparty/resource.rb +18 -44
- data/lib/poolparty/poolparty/service.rb +1 -5
- data/lib/poolparty/provision/boot_strapper.rb +24 -19
- data/lib/poolparty/provision/configurations/chef.rb +4 -4
- data/lib/poolparty/provision/dr_configure.rb +11 -10
- data/lib/poolparty/resources/cron.rb +7 -3
- data/lib/poolparty/resources/directory.rb +7 -0
- data/lib/poolparty/resources/exec.rb +2 -1
- data/lib/poolparty/resources/file.rb +23 -9
- data/lib/poolparty/resources/group.rb +21 -0
- data/lib/poolparty/resources/host.rb +2 -1
- data/lib/poolparty/resources/mount.rb +0 -4
- data/lib/poolparty/resources/remote_file.rb +1 -1
- data/lib/poolparty/resources/service.rb +2 -1
- data/lib/poolparty/resources/sshkey.rb +10 -12
- data/lib/poolparty/resources/symlink.rb +3 -5
- data/lib/poolparty/resources/user.rb +5 -0
- data/lib/poolparty/resources/variable.rb +1 -1
- data/lib/poolparty/templates/haproxy.conf +1 -1
- data/lib/poolparty/verification/verify.rb +4 -0
- data/lib/poolparty.rb +9 -4
- data/lib/poolpartycl.rb +1 -52
- data/spec/bin/bin_spec_helper.rb +1 -0
- data/spec/bin/server-list-active_spec.rb +3 -3
- data/spec/poolparty/core/object_spec.rb +9 -46
- data/spec/poolparty/dependency_resolver/dependency_resolver_cloud_extensions_spec.rb +18 -12
- data/spec/poolparty/fixtures/clouds.json +1 -1
- data/spec/poolparty/helpers/optioner_spec.rb +4 -11
- data/spec/poolparty/modules/cloud_resourcer_spec.rb +1 -1
- data/spec/poolparty/net/remote_instance_spec.rb +0 -1
- data/spec/poolparty/net/remoter_base_spec.rb +7 -11
- data/spec/poolparty/net/remoter_bases/ec2_mocks_and_stubs.rb +9 -11
- data/spec/poolparty/net/remoter_bases/ec2_remote_instance_spec.rb +6 -44
- data/spec/poolparty/net/remoter_bases/ec2_spec.rb +2 -3
- data/spec/poolparty/net/remoter_spec.rb +2 -3
- data/spec/poolparty/plugins/git_spec.rb +5 -8
- data/spec/poolparty/poolparty/cloud_spec.rb +17 -24
- data/spec/poolparty/poolparty/configurers/files/ruby_basic.rb +1 -3
- data/spec/poolparty/poolparty/configurers/ruby_spec.rb +1 -6
- data/spec/poolparty/poolparty/default_spec.rb +23 -22
- data/spec/poolparty/poolparty/example_spec.rb +6 -5
- data/spec/poolparty/poolparty/plugin_model_spec.rb +7 -4
- data/spec/poolparty/poolparty/pool_spec.rb +2 -9
- data/spec/poolparty/poolparty/resource_spec.rb +10 -24
- data/spec/poolparty/poolparty/script_spec.rb +1 -4
- data/spec/poolparty/poolparty/test_plugins/webserver.rb +0 -2
- data/spec/poolparty/resources/file_spec.rb +4 -4
- data/spec/poolparty/resources/service_spec.rb +1 -1
- data/spec/poolparty/spec_helper.rb +9 -38
- data/tasks/spec.rake +6 -2
- data/test/fixtures/test_key +1 -0
- data/test/poolparty/core/object_test.rb +29 -0
- data/test/poolparty/dependency_resolver/puppet_resolver_test.rb +1 -1
- data/test/poolparty/modules/cloud_dsl_test.rb +4 -4
- data/test/poolparty/net/remoter_bases/metavirt/metavirt_test.rb +55 -0
- data/test/poolparty/net/remoter_bases/vmrun/vmrun_test.rb +41 -14
- data/test/poolparty/plugins/chef_deploy_test.rb +37 -0
- data/test/poolparty/plugins/rails_deploy_test.rb +50 -0
- data/test/poolparty/poolparty/plugin_test.rb +18 -0
- data/test/poolparty/poolparty/poolparty_base_class_test.rb +41 -3
- data/test/test_helper.rb +5 -1
- data/vendor/gems/dslify/LICENSE +20 -0
- data/vendor/gems/dslify/README.rdoc +33 -0
- data/vendor/gems/dslify/Rakefile +56 -56
- data/vendor/gems/dslify/lib/dslify.rb +76 -5
- data/vendor/gems/dslify/test/dslify_test.rb +197 -0
- data/vendor/gems/dslify/test/test_helper.rb +7 -0
- data/vendor/gems/git-style-binaries/README.markdown +274 -0
- data/vendor/gems/{butterfly → git-style-binaries}/Rakefile +64 -62
- data/vendor/gems/git-style-binaries/VERSION.yml +4 -0
- data/vendor/gems/git-style-binaries/doc/EXAMPLES +1 -0
- data/vendor/gems/git-style-binaries/doc/poolparty-binaries.screenplay +45 -0
- data/vendor/gems/git-style-binaries/git-style-binaries.gemspec +69 -0
- data/vendor/gems/git-style-binaries/lib/ext/colorize.rb +198 -0
- data/vendor/gems/git-style-binaries/lib/ext/core.rb +16 -0
- data/vendor/gems/git-style-binaries/lib/git-style-binary/autorunner.rb +21 -0
- data/vendor/gems/git-style-binaries/lib/git-style-binary/command.rb +204 -0
- data/vendor/gems/git-style-binaries/lib/git-style-binary/commands/help.rb +32 -0
- data/vendor/gems/git-style-binaries/lib/git-style-binary/helpers/name_resolver.rb +78 -0
- data/vendor/gems/git-style-binaries/lib/git-style-binary/helpers/pager.rb +37 -0
- data/vendor/gems/git-style-binaries/lib/git-style-binary/parser.rb +223 -0
- data/vendor/gems/git-style-binaries/lib/git-style-binary.rb +74 -0
- data/vendor/gems/git-style-binaries/test/fixtures/flickr +4 -0
- data/vendor/gems/git-style-binaries/test/fixtures/flickr-download +17 -0
- data/vendor/gems/git-style-binaries/test/fixtures/wordpress +42 -0
- data/vendor/gems/git-style-binaries/test/fixtures/wordpress-categories +18 -0
- data/vendor/gems/git-style-binaries/test/fixtures/wordpress-list +18 -0
- data/vendor/gems/git-style-binaries/test/fixtures/wordpress-post +26 -0
- data/vendor/gems/git-style-binaries/test/git-style-binary/command_test.rb +17 -0
- data/vendor/gems/git-style-binaries/test/git_style_binary_test.rb +21 -0
- data/vendor/gems/git-style-binaries/test/running_binaries_test.rb +224 -0
- data/vendor/gems/git-style-binaries/test/shoulda_macros/matching_stdio.rb +13 -0
- data/vendor/gems/git-style-binaries/test/test_helper.rb +28 -0
- data/vendor/gems/parenting/lib/parenting/parenting.rb +13 -4
- data/vendor/gems/rest-client/README.rdoc +151 -0
- data/vendor/gems/rest-client/Rakefile +85 -0
- data/vendor/gems/rest-client/bin/restclient +87 -0
- data/vendor/gems/rest-client/lib/rest_client.rb +2 -0
- data/vendor/gems/rest-client/lib/restclient/exceptions.rb +84 -0
- data/vendor/gems/rest-client/lib/restclient/mixin/response.rb +43 -0
- data/vendor/gems/rest-client/lib/restclient/raw_response.rb +30 -0
- data/vendor/gems/rest-client/lib/restclient/request.rb +232 -0
- data/vendor/gems/rest-client/lib/restclient/resource.rb +146 -0
- data/vendor/gems/rest-client/lib/restclient/response.rb +20 -0
- data/vendor/gems/rest-client/lib/restclient.rb +93 -0
- data/vendor/gems/rest-client/rest-client.gemspec +21 -0
- data/vendor/gems/rest-client/spec/base.rb +4 -0
- data/vendor/gems/rest-client/spec/exceptions_spec.rb +54 -0
- data/vendor/gems/rest-client/spec/mixin/response_spec.rb +46 -0
- data/vendor/gems/rest-client/spec/raw_response_spec.rb +17 -0
- data/vendor/gems/rest-client/spec/request_spec.rb +442 -0
- data/vendor/gems/rest-client/spec/resource_spec.rb +75 -0
- data/vendor/gems/rest-client/spec/response_spec.rb +16 -0
- data/vendor/gems/rest-client/spec/restclient_spec.rb +53 -0
- data/vendor/gems/trollop/FAQ.txt +35 -0
- data/vendor/gems/trollop/History.txt +97 -0
- data/vendor/gems/trollop/Manifest.txt +7 -0
- data/vendor/gems/trollop/README.txt +40 -0
- data/vendor/gems/trollop/Rakefile +36 -0
- data/vendor/gems/trollop/lib/trollop.rb +735 -0
- data/vendor/gems/trollop/release-script.txt +13 -0
- data/vendor/gems/trollop/test/test_trollop.rb +1042 -0
- data/vendor/gems/trollop/www/index.html +167 -0
- metadata +100 -70
- data/bin/cloud-describe +0 -28
- data/bin/cloud-handle-load +0 -27
- data/bin/cloud-rsync +0 -28
- data/bin/cloud-spec +0 -40
- data/lib/poolparty/plugins/nanite.rb +0 -41
- data/lib/poolparty/plugins/runit.rb +0 -96
- data/vendor/gems/butterfly/History.txt +0 -4
- data/vendor/gems/butterfly/PostInstall.txt +0 -2
- data/vendor/gems/butterfly/README.rdoc +0 -48
- data/vendor/gems/butterfly/VERSION.yml +0 -4
- data/vendor/gems/butterfly/bin/flutter +0 -4
- data/vendor/gems/butterfly/butterfly.gemspec +0 -37
- data/vendor/gems/butterfly/examples/config.ru +0 -15
- data/vendor/gems/butterfly/examples/my_app.rb +0 -12
- data/vendor/gems/butterfly/lib/butterfly.rb +0 -14
- data/vendor/gems/butterfly/lib/handler.rb +0 -48
- data/vendor/gems/butterfly/lib/request.rb +0 -29
- data/vendor/gems/butterfly/lib/response.rb +0 -49
- data/vendor/gems/butterfly/script/console +0 -10
- data/vendor/gems/butterfly/script/destroy +0 -14
- data/vendor/gems/butterfly/script/generate +0 -14
- data/vendor/gems/butterfly/test/test_adapter_base.rb +0 -23
- data/vendor/gems/butterfly/test/test_butterfly_request.rb +0 -46
- data/vendor/gems/butterfly/test/test_butterfly_response.rb +0 -43
- data/vendor/gems/butterfly/test/test_butterfly_server.rb +0 -16
- data/vendor/gems/butterfly/test/test_default.rb +0 -12
- data/vendor/gems/butterfly/test/test_helper.rb +0 -6
- data/vendor/gems/dslify/History.txt +0 -4
- data/vendor/gems/dslify/Manifest.txt +0 -25
- data/vendor/gems/dslify/PostInstall.txt +0 -5
- data/vendor/gems/dslify/README.txt +0 -60
- data/vendor/gems/dslify/config/hoe.rb +0 -73
- data/vendor/gems/dslify/config/requirements.rb +0 -15
- data/vendor/gems/dslify/dslify.gemspec +0 -40
- data/vendor/gems/dslify/lib/dslify/dslify.rb +0 -76
- data/vendor/gems/dslify/lib/dslify/version.rb +0 -10
- data/vendor/gems/dslify/script/console +0 -10
- data/vendor/gems/dslify/script/destroy +0 -14
- data/vendor/gems/dslify/script/generate +0 -14
- data/vendor/gems/dslify/script/txt2html +0 -82
- data/vendor/gems/dslify/setup.rb +0 -1585
- data/vendor/gems/dslify/tasks/deployment.rake +0 -34
- data/vendor/gems/dslify/tasks/environment.rake +0 -7
- data/vendor/gems/dslify/tasks/website.rake +0 -17
- data/vendor/gems/dslify/test/test_dslify.rb +0 -138
- data/vendor/gems/dslify/website/index.html +0 -86
- data/vendor/gems/dslify/website/index.txt +0 -83
- data/vendor/gems/dslify/website/javascripts/rounded_corners_lite.inc.js +0 -285
- data/vendor/gems/dslify/website/stylesheets/screen.css +0 -138
- data/vendor/gems/dslify/website/template.html.erb +0 -48
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
class Test::Unit::TestCase
|
|
2
|
+
def output_should_match(regexp)
|
|
3
|
+
assert_match regexp, @stdout + @stderr
|
|
4
|
+
end
|
|
5
|
+
alias_method :output_matches, :output_should_match
|
|
6
|
+
|
|
7
|
+
def stdout_should_match(regexp)
|
|
8
|
+
assert_match regexp, @stdout
|
|
9
|
+
end
|
|
10
|
+
def stderr_should_match(regexp)
|
|
11
|
+
assert_match regexp, @stderr
|
|
12
|
+
end
|
|
13
|
+
end
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
require 'rubygems'
|
|
2
|
+
require 'test/unit'
|
|
3
|
+
require 'shoulda'
|
|
4
|
+
begin require 'redgreen'; rescue LoadError; end
|
|
5
|
+
require 'open3'
|
|
6
|
+
|
|
7
|
+
$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
|
|
8
|
+
$LOAD_PATH.unshift(File.dirname(__FILE__))
|
|
9
|
+
Dir[File.join(File.dirname(__FILE__), "shoulda_macros", "*.rb")].each {|f| require f}
|
|
10
|
+
ENV['NO_COLOR'] = "true"
|
|
11
|
+
|
|
12
|
+
require 'git-style-binary'
|
|
13
|
+
GitStyleBinary.run = true
|
|
14
|
+
|
|
15
|
+
class Test::Unit::TestCase
|
|
16
|
+
def fixtures_dir
|
|
17
|
+
File.join(File.dirname(__FILE__), "fixtures")
|
|
18
|
+
end
|
|
19
|
+
end
|
|
20
|
+
|
|
21
|
+
module RunsBinaryFixtures
|
|
22
|
+
# run the specified cmd returning the string values of [stdout,stderr]
|
|
23
|
+
def bin(cmd)
|
|
24
|
+
stdin, stdout, stderr = Open3.popen3("#{fixtures_dir}/#{cmd}")
|
|
25
|
+
[stdout.read, stderr.read]
|
|
26
|
+
end
|
|
27
|
+
end
|
|
28
|
+
|
|
@@ -6,11 +6,18 @@ module Parenting
|
|
|
6
6
|
def context_stack
|
|
7
7
|
$context_stack ||= []
|
|
8
8
|
end
|
|
9
|
+
def initialize(o, &block)
|
|
10
|
+
run_in_context do
|
|
11
|
+
instance_eval(&block) if block
|
|
12
|
+
super(&block)
|
|
13
|
+
end
|
|
14
|
+
end
|
|
15
|
+
|
|
9
16
|
def run_in_context(&block)
|
|
10
17
|
@parent = parent
|
|
11
18
|
|
|
12
19
|
context_stack.push self
|
|
13
|
-
|
|
20
|
+
instance_eval(&block) if block
|
|
14
21
|
context_stack.pop
|
|
15
22
|
head
|
|
16
23
|
end
|
|
@@ -35,7 +42,7 @@ module Parenting
|
|
|
35
42
|
def this
|
|
36
43
|
@this ||= self
|
|
37
44
|
end
|
|
38
|
-
def method_missing(m,*args,&block)
|
|
45
|
+
def method_missing(m,*args,&block)
|
|
39
46
|
if block
|
|
40
47
|
if args.empty?
|
|
41
48
|
super
|
|
@@ -46,9 +53,11 @@ module Parenting
|
|
|
46
53
|
context_stack.pop
|
|
47
54
|
end
|
|
48
55
|
else
|
|
49
|
-
if
|
|
56
|
+
# if this_context.respond_to?(m)
|
|
57
|
+
# this_context.send(m,*args,&block)
|
|
58
|
+
if parent.respond_to?(m)
|
|
50
59
|
parent.send(m,*args,&block)
|
|
51
|
-
else
|
|
60
|
+
else
|
|
52
61
|
super
|
|
53
62
|
end
|
|
54
63
|
end
|
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
= REST Client -- simple DSL for accessing REST resources
|
|
2
|
+
|
|
3
|
+
A simple REST client for Ruby, inspired by the Sinatra's microframework style
|
|
4
|
+
of specifying actions: get, put, post, delete.
|
|
5
|
+
|
|
6
|
+
== Usage: Raw URL
|
|
7
|
+
|
|
8
|
+
require 'rest_client'
|
|
9
|
+
|
|
10
|
+
RestClient.get 'http://example.com/resource'
|
|
11
|
+
RestClient.get 'https://user:password@example.com/private/resource'
|
|
12
|
+
|
|
13
|
+
RestClient.post 'http://example.com/resource', :param1 => 'one', :nested => { :param2 => 'two' }
|
|
14
|
+
|
|
15
|
+
RestClient.delete 'http://example.com/resource'
|
|
16
|
+
|
|
17
|
+
See RestClient module docs for details.
|
|
18
|
+
|
|
19
|
+
== Usage: ActiveResource-Style
|
|
20
|
+
|
|
21
|
+
resource = RestClient::Resource.new 'http://example.com/resource'
|
|
22
|
+
resource.get
|
|
23
|
+
|
|
24
|
+
private_resource = RestClient::Resource.new 'https://example.com/private/resource', :user => 'adam', :password => 'secret', :timeout => 20, :open_timeout => 5
|
|
25
|
+
private_resource.put File.read('pic.jpg'), :content_type => 'image/jpg'
|
|
26
|
+
|
|
27
|
+
See RestClient::Resource module docs for details.
|
|
28
|
+
|
|
29
|
+
== Usage: Resource Nesting
|
|
30
|
+
|
|
31
|
+
site = RestClient::Resource.new('http://example.com')
|
|
32
|
+
site['posts/1/comments'].post 'Good article.', :content_type => 'text/plain'
|
|
33
|
+
|
|
34
|
+
See RestClient::Resource docs for details.
|
|
35
|
+
|
|
36
|
+
== Shell
|
|
37
|
+
|
|
38
|
+
The restclient shell command gives an IRB session with RestClient already loaded:
|
|
39
|
+
|
|
40
|
+
$ restclient
|
|
41
|
+
>> RestClient.get 'http://example.com'
|
|
42
|
+
|
|
43
|
+
Specify a URL argument for get/post/put/delete on that resource:
|
|
44
|
+
|
|
45
|
+
$ restclient http://example.com
|
|
46
|
+
>> put '/resource', 'data'
|
|
47
|
+
|
|
48
|
+
Add a user and password for authenticated resources:
|
|
49
|
+
|
|
50
|
+
$ restclient https://example.com user pass
|
|
51
|
+
>> delete '/private/resource'
|
|
52
|
+
|
|
53
|
+
Create ~/.restclient for named sessions:
|
|
54
|
+
|
|
55
|
+
sinatra:
|
|
56
|
+
url: http://localhost:4567
|
|
57
|
+
rack:
|
|
58
|
+
url: http://localhost:9292
|
|
59
|
+
private_site:
|
|
60
|
+
url: http://example.com
|
|
61
|
+
username: user
|
|
62
|
+
password: pass
|
|
63
|
+
|
|
64
|
+
Then invoke:
|
|
65
|
+
|
|
66
|
+
$ restclient private_site
|
|
67
|
+
|
|
68
|
+
Use as a one-off, curl-style:
|
|
69
|
+
|
|
70
|
+
$ restclient get http://example.com/resource > output_body
|
|
71
|
+
|
|
72
|
+
$ restclient put http://example.com/resource < input_body
|
|
73
|
+
|
|
74
|
+
== Logging
|
|
75
|
+
|
|
76
|
+
Write calls to a log filename (can also be "stdout" or "stderr"):
|
|
77
|
+
|
|
78
|
+
RestClient.log = '/tmp/restclient.log'
|
|
79
|
+
|
|
80
|
+
Or set an environment variable to avoid modifying the code:
|
|
81
|
+
|
|
82
|
+
$ RESTCLIENT_LOG=stdout path/to/my/program
|
|
83
|
+
|
|
84
|
+
Either produces logs like this:
|
|
85
|
+
|
|
86
|
+
RestClient.get "http://some/resource"
|
|
87
|
+
# => 200 OK | text/html 250 bytes
|
|
88
|
+
RestClient.put "http://some/resource", "payload"
|
|
89
|
+
# => 401 Unauthorized | application/xml 340 bytes
|
|
90
|
+
|
|
91
|
+
Note that these logs are valid Ruby, so you can paste them into the restclient
|
|
92
|
+
shell or a script to replay your sequence of rest calls.
|
|
93
|
+
|
|
94
|
+
== Proxy
|
|
95
|
+
|
|
96
|
+
All calls to RestClient, including Resources, will use the proxy specified by
|
|
97
|
+
RestClient.proxy:
|
|
98
|
+
|
|
99
|
+
RestClient.proxy = "http://proxy.example.com/"
|
|
100
|
+
RestClient.get "http://some/resource"
|
|
101
|
+
# => response from some/resource as proxied through proxy.example.com
|
|
102
|
+
|
|
103
|
+
Often the proxy url is set in an environment variable, so you can do this to
|
|
104
|
+
use whatever proxy the system is configured to use:
|
|
105
|
+
|
|
106
|
+
RestClient.proxy = ENV['http_proxy']
|
|
107
|
+
|
|
108
|
+
== Cookies
|
|
109
|
+
|
|
110
|
+
Request and Response objects know about HTTP cookies, and will automatically
|
|
111
|
+
extract and set headers for them as needed:
|
|
112
|
+
|
|
113
|
+
response = RestClient.get 'http://example.com/action_which_sets_session_id'
|
|
114
|
+
response.cookies
|
|
115
|
+
# => {"_applicatioN_session_id" => "1234"}
|
|
116
|
+
|
|
117
|
+
response2 = RestClient.post(
|
|
118
|
+
'http://localhost:3000/',
|
|
119
|
+
{:param1 => "foo"},
|
|
120
|
+
{:cookies => {:session_id => "1234"}}
|
|
121
|
+
)
|
|
122
|
+
# ...response body
|
|
123
|
+
|
|
124
|
+
== SSL Client Certificates
|
|
125
|
+
|
|
126
|
+
RestClient::Resource.new(
|
|
127
|
+
'https://example.com',
|
|
128
|
+
:ssl_client_cert => OpenSSL::X509::Certificate.new(File.read("cert.pem")),
|
|
129
|
+
:ssl_client_key => OpenSSL::PKey::RSA.new(File.read("key.pem"), "passphrase, if any"),
|
|
130
|
+
:ssl_ca_file => "ca_certificate.pem",
|
|
131
|
+
:verify_ssl => OpenSSL::SSL::VERIFY_PEER
|
|
132
|
+
).get
|
|
133
|
+
|
|
134
|
+
Self-signed certificates can be generated with the openssl command-line tool.
|
|
135
|
+
|
|
136
|
+
== Meta
|
|
137
|
+
|
|
138
|
+
Written by Adam Wiggins (adam at heroku dot com)
|
|
139
|
+
|
|
140
|
+
Patches contributed by: Chris Anderson, Greg Borenstein, Ardekantur, Pedro
|
|
141
|
+
Belo, Rafael Souza, Rick Olson, Aman Gupta, Blake Mizerany, Brian Donovan, Ivan
|
|
142
|
+
Makfinsky, Marc-André Cournoyer, Coda Hale, Tetsuo Watanabe, Dusty Doris,
|
|
143
|
+
Lennon Day-Reynolds, James Edward Gray II, Cyril Rohr, Juan Alvarez, and Adam
|
|
144
|
+
Jacob
|
|
145
|
+
|
|
146
|
+
Released under the MIT License: http://www.opensource.org/licenses/mit-license.php
|
|
147
|
+
|
|
148
|
+
http://rest-client.heroku.com
|
|
149
|
+
|
|
150
|
+
http://github.com/adamwiggins/rest-client
|
|
151
|
+
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
require 'rake'
|
|
2
|
+
require 'spec/rake/spectask'
|
|
3
|
+
|
|
4
|
+
desc "Run all specs"
|
|
5
|
+
Spec::Rake::SpecTask.new('spec') do |t|
|
|
6
|
+
t.spec_opts = ['--colour --format progress --loadby mtime --reverse']
|
|
7
|
+
t.spec_files = FileList['spec/*_spec.rb']
|
|
8
|
+
end
|
|
9
|
+
|
|
10
|
+
desc "Print specdocs"
|
|
11
|
+
Spec::Rake::SpecTask.new(:doc) do |t|
|
|
12
|
+
t.spec_opts = ["--format", "specdoc", "--dry-run"]
|
|
13
|
+
t.spec_files = FileList['spec/*_spec.rb']
|
|
14
|
+
end
|
|
15
|
+
|
|
16
|
+
desc "Run all examples with RCov"
|
|
17
|
+
Spec::Rake::SpecTask.new('rcov') do |t|
|
|
18
|
+
t.spec_files = FileList['spec/*_spec.rb']
|
|
19
|
+
t.rcov = true
|
|
20
|
+
t.rcov_opts = ['--exclude', 'examples']
|
|
21
|
+
end
|
|
22
|
+
|
|
23
|
+
task :default => :spec
|
|
24
|
+
|
|
25
|
+
######################################################
|
|
26
|
+
|
|
27
|
+
require 'rake'
|
|
28
|
+
require 'rake/testtask'
|
|
29
|
+
require 'rake/clean'
|
|
30
|
+
require 'rake/gempackagetask'
|
|
31
|
+
require 'rake/rdoctask'
|
|
32
|
+
require 'fileutils'
|
|
33
|
+
|
|
34
|
+
version = "0.9.2"
|
|
35
|
+
name = "rest-client"
|
|
36
|
+
|
|
37
|
+
spec = Gem::Specification.new do |s|
|
|
38
|
+
s.name = name
|
|
39
|
+
s.version = version
|
|
40
|
+
s.summary = "Simple REST client for Ruby, inspired by microframework syntax for specifying actions."
|
|
41
|
+
s.description = "A simple REST client for Ruby, inspired by the Sinatra microframework style of specifying actions: get, put, post, delete."
|
|
42
|
+
s.author = "Adam Wiggins"
|
|
43
|
+
s.email = "adam@heroku.com"
|
|
44
|
+
s.homepage = "http://rest-client.heroku.com/"
|
|
45
|
+
s.rubyforge_project = "rest-client"
|
|
46
|
+
|
|
47
|
+
s.platform = Gem::Platform::RUBY
|
|
48
|
+
s.has_rdoc = true
|
|
49
|
+
|
|
50
|
+
s.files = %w(Rakefile README.rdoc) + Dir.glob("{lib,spec}/**/*")
|
|
51
|
+
s.executables = ['restclient']
|
|
52
|
+
|
|
53
|
+
s.require_path = "lib"
|
|
54
|
+
end
|
|
55
|
+
|
|
56
|
+
Rake::GemPackageTask.new(spec) do |p|
|
|
57
|
+
p.need_tar = true if RUBY_PLATFORM !~ /mswin/
|
|
58
|
+
end
|
|
59
|
+
|
|
60
|
+
task :install => [ :package ] do
|
|
61
|
+
sh %{sudo gem install pkg/#{name}-#{version}.gem}
|
|
62
|
+
end
|
|
63
|
+
|
|
64
|
+
task :uninstall => [ :clean ] do
|
|
65
|
+
sh %{sudo gem uninstall #{name}}
|
|
66
|
+
end
|
|
67
|
+
|
|
68
|
+
Rake::TestTask.new do |t|
|
|
69
|
+
t.libs << "spec"
|
|
70
|
+
t.test_files = FileList['spec/*_spec.rb']
|
|
71
|
+
t.verbose = true
|
|
72
|
+
end
|
|
73
|
+
|
|
74
|
+
Rake::RDocTask.new do |t|
|
|
75
|
+
t.rdoc_dir = 'rdoc'
|
|
76
|
+
t.title = "rest-client, fetch RESTful resources effortlessly"
|
|
77
|
+
t.options << '--line-numbers' << '--inline-source' << '-A cattr_accessor=object'
|
|
78
|
+
t.options << '--charset' << 'utf-8'
|
|
79
|
+
t.rdoc_files.include('README.rdoc')
|
|
80
|
+
t.rdoc_files.include('lib/restclient.rb')
|
|
81
|
+
t.rdoc_files.include('lib/restclient/*.rb')
|
|
82
|
+
end
|
|
83
|
+
|
|
84
|
+
CLEAN.include [ 'pkg', '*.gem', '.config' ]
|
|
85
|
+
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
#!/usr/bin/env ruby
|
|
2
|
+
|
|
3
|
+
$:.unshift File.dirname(__FILE__) + "/../lib"
|
|
4
|
+
require 'restclient'
|
|
5
|
+
|
|
6
|
+
require "yaml"
|
|
7
|
+
|
|
8
|
+
def usage(why = nil)
|
|
9
|
+
puts "failed for reason: #{why}" if why
|
|
10
|
+
puts "usage: restclient [get|put|post|delete] url|name [username] [password]"
|
|
11
|
+
puts " The verb is optional, if you leave it off you'll get an interactive shell."
|
|
12
|
+
puts " put and post both take the input body on stdin."
|
|
13
|
+
exit(1)
|
|
14
|
+
end
|
|
15
|
+
|
|
16
|
+
if %w(get put post delete).include? ARGV.first
|
|
17
|
+
@verb = ARGV.shift
|
|
18
|
+
else
|
|
19
|
+
@verb = nil
|
|
20
|
+
end
|
|
21
|
+
|
|
22
|
+
@url = ARGV.shift || 'http://localhost:4567'
|
|
23
|
+
|
|
24
|
+
config = YAML.load(File.read(ENV['HOME'] + "/.restclient")) rescue {}
|
|
25
|
+
|
|
26
|
+
@url, @username, @password = if c = config[@url]
|
|
27
|
+
[c['url'], c['username'], c['password']]
|
|
28
|
+
else
|
|
29
|
+
[@url, *ARGV]
|
|
30
|
+
end
|
|
31
|
+
|
|
32
|
+
usage("invalid url '#{@url}") unless @url =~ /^https?/
|
|
33
|
+
usage("too few args") unless ARGV.size < 3
|
|
34
|
+
|
|
35
|
+
def r
|
|
36
|
+
@r ||= RestClient::Resource.new(@url, @username, @password)
|
|
37
|
+
end
|
|
38
|
+
|
|
39
|
+
r # force rc to load
|
|
40
|
+
|
|
41
|
+
if @verb
|
|
42
|
+
begin
|
|
43
|
+
if %w(put post).include? @verb
|
|
44
|
+
puts r.send(@verb, STDIN.read)
|
|
45
|
+
else
|
|
46
|
+
puts r.send(@verb)
|
|
47
|
+
end
|
|
48
|
+
exit 0
|
|
49
|
+
rescue RestClient::Exception => e
|
|
50
|
+
puts e.response.body if e.respond_to? :response
|
|
51
|
+
raise
|
|
52
|
+
end
|
|
53
|
+
end
|
|
54
|
+
|
|
55
|
+
%w(get post put delete).each do |m|
|
|
56
|
+
eval <<-end_eval
|
|
57
|
+
def #{m}(path, *args, &b)
|
|
58
|
+
r[path].#{m}(*args, &b)
|
|
59
|
+
end
|
|
60
|
+
end_eval
|
|
61
|
+
end
|
|
62
|
+
|
|
63
|
+
def method_missing(s, *args, &b)
|
|
64
|
+
super unless r.respond_to?(s)
|
|
65
|
+
begin
|
|
66
|
+
r.send(s, *args, &b)
|
|
67
|
+
rescue RestClient::RequestFailed => e
|
|
68
|
+
print STDERR, e.response.body
|
|
69
|
+
raise e
|
|
70
|
+
end
|
|
71
|
+
end
|
|
72
|
+
|
|
73
|
+
require 'irb'
|
|
74
|
+
require 'irb/completion'
|
|
75
|
+
|
|
76
|
+
if File.exists? ".irbrc"
|
|
77
|
+
ENV['IRBRC'] = ".irbrc"
|
|
78
|
+
end
|
|
79
|
+
|
|
80
|
+
if File.exists?(rcfile = "~/.restclientrc")
|
|
81
|
+
load(rcfile)
|
|
82
|
+
end
|
|
83
|
+
|
|
84
|
+
ARGV.clear
|
|
85
|
+
|
|
86
|
+
IRB.start
|
|
87
|
+
exit!
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
module RestClient
|
|
2
|
+
# This is the base RestClient exception class. Rescue it if you want to
|
|
3
|
+
# catch any exception that your request might raise
|
|
4
|
+
class Exception < RuntimeError
|
|
5
|
+
def message(default=nil)
|
|
6
|
+
self.class::ErrorMessage
|
|
7
|
+
end
|
|
8
|
+
end
|
|
9
|
+
|
|
10
|
+
# Base RestClient exception when there's a response available
|
|
11
|
+
class ExceptionWithResponse < Exception
|
|
12
|
+
attr_accessor :response
|
|
13
|
+
|
|
14
|
+
def initialize(response=nil)
|
|
15
|
+
@response = response
|
|
16
|
+
end
|
|
17
|
+
|
|
18
|
+
def http_code
|
|
19
|
+
@response.code.to_i if @response
|
|
20
|
+
end
|
|
21
|
+
end
|
|
22
|
+
|
|
23
|
+
# A redirect was encountered; caught by execute to retry with the new url.
|
|
24
|
+
class Redirect < Exception
|
|
25
|
+
ErrorMessage = "Redirect"
|
|
26
|
+
|
|
27
|
+
attr_accessor :url
|
|
28
|
+
def initialize(url)
|
|
29
|
+
@url = url
|
|
30
|
+
end
|
|
31
|
+
end
|
|
32
|
+
|
|
33
|
+
class NotModified < ExceptionWithResponse
|
|
34
|
+
ErrorMessage = 'NotModified'
|
|
35
|
+
end
|
|
36
|
+
|
|
37
|
+
# Authorization is required to access the resource specified.
|
|
38
|
+
class Unauthorized < ExceptionWithResponse
|
|
39
|
+
ErrorMessage = 'Unauthorized'
|
|
40
|
+
end
|
|
41
|
+
|
|
42
|
+
# No resource was found at the given URL.
|
|
43
|
+
class ResourceNotFound < ExceptionWithResponse
|
|
44
|
+
ErrorMessage = 'Resource not found'
|
|
45
|
+
end
|
|
46
|
+
|
|
47
|
+
# The server broke the connection prior to the request completing. Usually
|
|
48
|
+
# this means it crashed, or sometimes that your network connection was
|
|
49
|
+
# severed before it could complete.
|
|
50
|
+
class ServerBrokeConnection < Exception
|
|
51
|
+
ErrorMessage = 'Server broke connection'
|
|
52
|
+
end
|
|
53
|
+
|
|
54
|
+
# The server took too long to respond.
|
|
55
|
+
class RequestTimeout < Exception
|
|
56
|
+
ErrorMessage = 'Request timed out'
|
|
57
|
+
end
|
|
58
|
+
|
|
59
|
+
# The request failed, meaning the remote HTTP server returned a code other
|
|
60
|
+
# than success, unauthorized, or redirect.
|
|
61
|
+
#
|
|
62
|
+
# The exception message attempts to extract the error from the XML, using
|
|
63
|
+
# format returned by Rails: <errors><error>some message</error></errors>
|
|
64
|
+
#
|
|
65
|
+
# You can get the status code by e.http_code, or see anything about the
|
|
66
|
+
# response via e.response. For example, the entire result body (which is
|
|
67
|
+
# probably an HTML error page) is e.response.body.
|
|
68
|
+
class RequestFailed < ExceptionWithResponse
|
|
69
|
+
def message
|
|
70
|
+
"HTTP status code #{http_code}"
|
|
71
|
+
end
|
|
72
|
+
|
|
73
|
+
def to_s
|
|
74
|
+
message
|
|
75
|
+
end
|
|
76
|
+
end
|
|
77
|
+
end
|
|
78
|
+
|
|
79
|
+
# backwards compatibility
|
|
80
|
+
class RestClient::Request
|
|
81
|
+
Redirect = RestClient::Redirect
|
|
82
|
+
Unauthorized = RestClient::Unauthorized
|
|
83
|
+
RequestFailed = RestClient::RequestFailed
|
|
84
|
+
end
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
module RestClient
|
|
2
|
+
module Mixin
|
|
3
|
+
module Response
|
|
4
|
+
attr_reader :net_http_res
|
|
5
|
+
|
|
6
|
+
# HTTP status code, always 200 since RestClient throws exceptions for
|
|
7
|
+
# other codes.
|
|
8
|
+
def code
|
|
9
|
+
@code ||= @net_http_res.code.to_i
|
|
10
|
+
end
|
|
11
|
+
|
|
12
|
+
# A hash of the headers, beautified with symbols and underscores.
|
|
13
|
+
# e.g. "Content-type" will become :content_type.
|
|
14
|
+
def headers
|
|
15
|
+
@headers ||= self.class.beautify_headers(@net_http_res.to_hash)
|
|
16
|
+
end
|
|
17
|
+
|
|
18
|
+
# Hash of cookies extracted from response headers
|
|
19
|
+
def cookies
|
|
20
|
+
@cookies ||= (self.headers[:set_cookie] || "").split('; ').inject({}) do |out, raw_c|
|
|
21
|
+
key, val = raw_c.split('=')
|
|
22
|
+
unless %w(expires domain path secure).member?(key)
|
|
23
|
+
out[key] = val
|
|
24
|
+
end
|
|
25
|
+
out
|
|
26
|
+
end
|
|
27
|
+
end
|
|
28
|
+
|
|
29
|
+
def self.included(receiver)
|
|
30
|
+
receiver.extend(RestClient::Mixin::Response::ClassMethods)
|
|
31
|
+
end
|
|
32
|
+
|
|
33
|
+
module ClassMethods
|
|
34
|
+
def beautify_headers(headers)
|
|
35
|
+
headers.inject({}) do |out, (key, value)|
|
|
36
|
+
out[key.gsub(/-/, '_').to_sym] = value.first
|
|
37
|
+
out
|
|
38
|
+
end
|
|
39
|
+
end
|
|
40
|
+
end
|
|
41
|
+
end
|
|
42
|
+
end
|
|
43
|
+
end
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
require File.dirname(__FILE__) + '/mixin/response'
|
|
2
|
+
|
|
3
|
+
module RestClient
|
|
4
|
+
# The response from RestClient on a raw request looks like a string, but is
|
|
5
|
+
# actually one of these. 99% of the time you're making a rest call all you
|
|
6
|
+
# care about is the body, but on the occassion you want to fetch the
|
|
7
|
+
# headers you can:
|
|
8
|
+
#
|
|
9
|
+
# RestClient.get('http://example.com').headers[:content_type]
|
|
10
|
+
#
|
|
11
|
+
# In addition, if you do not use the response as a string, you can access
|
|
12
|
+
# a Tempfile object at res.file, which contains the path to the raw
|
|
13
|
+
# downloaded request body.
|
|
14
|
+
class RawResponse
|
|
15
|
+
include RestClient::Mixin::Response
|
|
16
|
+
|
|
17
|
+
attr_reader :file
|
|
18
|
+
|
|
19
|
+
def initialize(tempfile, net_http_res)
|
|
20
|
+
@net_http_res = net_http_res
|
|
21
|
+
@file = tempfile
|
|
22
|
+
end
|
|
23
|
+
|
|
24
|
+
def to_s
|
|
25
|
+
@file.open
|
|
26
|
+
@file.read
|
|
27
|
+
end
|
|
28
|
+
|
|
29
|
+
end
|
|
30
|
+
end
|