rails-xmlrpc 0.3.2

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/.gitignore ADDED
@@ -0,0 +1,9 @@
1
+ config
2
+ Capfile
3
+
4
+ coverage
5
+ doc
6
+ pkg
7
+
8
+ *.gem
9
+
data/README.rdoc ADDED
@@ -0,0 +1,69 @@
1
+ = rails-xmlrpc
2
+
3
+ Rails has native support for xmlrpc. Most people are familiar with the 'xmlrpc/client' library. The 'xmlrpc/server' library examples mostly make an assumption that you will run a standalone server.
4
+
5
+ rails-xmlrpc allows you to instead expose normal Rails controller methods via XMLRPC, tied to an xmlrpc endpoint route in your app.
6
+
7
+ ==Install
8
+
9
+ Run in terminal:
10
+ gem install rails-xmlrpc
11
+
12
+ === For Rails 2
13
+ Add row to environment.rb inside Rails::Initializer block:
14
+ config.gem "rails-xmlrpc"
15
+
16
+ Add row to routes.rb
17
+ map.connect 'api/xmlrpc', :controller => 'my_controller', :action => 'xe_index'
18
+
19
+ === For Rails 3
20
+ Add row to Gemfile:
21
+ gem "rails-xmlrpc"
22
+
23
+ Set up a route in your routes.rb file
24
+ match 'api/xmlrpc' => 'my#xe_index'
25
+
26
+
27
+ == Examples
28
+ Add this code to your controller:
29
+
30
+ class MyController < ApplicationController
31
+ exposes_xmlrpc_methods
32
+
33
+ add_method 'Container.method_name' do
34
+ return 'Hello World'
35
+ end
36
+
37
+ end
38
+
39
+ Then, pointing an XMLRPC client at the defined route, your normal controller actions will handle the requests.
40
+
41
+ require 'xmlrpc/client'
42
+ server = XMLRPC::Client.new2("http://localhost:3000/api/xmlrpc")
43
+ server.call("Container.method_name")
44
+
45
+ To use a custom namespace prefix on all exposed methods (for example, if using someone else's specified protocol like MetaWeblog[http://www.xmlrpc.com/metaWeblogApi]), declare a method_prefix:
46
+
47
+ class MyApiController < ApplicationController
48
+ exposes_xmlrpc_methods :method_prefix => "metaWeblog."
49
+
50
+ # This method will be exposed externally as "metaWeblog.newPost()"
51
+ def newPost(blogid, username, password, struct, publish)
52
+ ...
53
+ end
54
+ end
55
+
56
+
57
+ == Note on Patches/Pull Requests
58
+
59
+ * Fork the project.
60
+ * Make your feature addition or bug fix.
61
+ * Add tests for it. This is important so I don't break it in a
62
+ future version unintentionally.
63
+ * Commit, do not mess with rakefile, version, or history.
64
+ (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
65
+ * Send me a pull request. Bonus points for topic branches.
66
+
67
+ == Copyright
68
+
69
+ Copyright (c) 2011 Aleksei Kvitinskii, released under the MIT license.
data/Rakefile ADDED
@@ -0,0 +1,53 @@
1
+ require 'rubygems'
2
+ require 'rake'
3
+
4
+ begin
5
+ require 'jeweler'
6
+ Jeweler::Tasks.new do |gem|
7
+ gem.name = "rails-xmlrpc"
8
+ gem.summary = %Q{Expose Rails controller actions as XMLRPC method calls.}
9
+ gem.description = %Q{Expose Rails controller actions as XMLRPC method calls.}
10
+ gem.email = "wkoffel@alum.mit.edu"
11
+ gem.homepage = "http://github.com/Axt/rails-xmlrpc"
12
+ gem.authors = ["Will Koffel"]
13
+ gem.add_development_dependency "thoughtbot-shoulda", ">= 0"
14
+ # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
15
+ end
16
+ Jeweler::GemcutterTasks.new
17
+ rescue LoadError
18
+ puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
19
+ end
20
+
21
+ require 'rake/testtask'
22
+ Rake::TestTask.new(:test) do |test|
23
+ test.libs << 'lib' << 'test'
24
+ test.pattern = 'test/**/test_*.rb'
25
+ test.verbose = true
26
+ end
27
+
28
+ begin
29
+ require 'rcov/rcovtask'
30
+ Rcov::RcovTask.new do |test|
31
+ test.libs << 'test'
32
+ test.pattern = 'test/**/test_*.rb'
33
+ test.verbose = true
34
+ end
35
+ rescue LoadError
36
+ task :rcov do
37
+ abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
38
+ end
39
+ end
40
+
41
+ task :test => :check_dependencies
42
+
43
+ task :default => :test
44
+
45
+ require 'rake/rdoctask'
46
+ Rake::RDocTask.new do |rdoc|
47
+ version = File.exist?('VERSION') ? File.read('VERSION') : ""
48
+
49
+ rdoc.rdoc_dir = 'rdoc'
50
+ rdoc.title = "rails-xmlrpc #{version}"
51
+ rdoc.rdoc_files.include('README*')
52
+ rdoc.rdoc_files.include('lib/**/*.rb')
53
+ end
data/init.rb ADDED
@@ -0,0 +1 @@
1
+ require 'rails-xmlrpc'
@@ -0,0 +1,76 @@
1
+ module ActionController
2
+ module Acts
3
+ module RailsXmlrpc
4
+ def self.included(controller)
5
+ controller.extend(ClassMethods)
6
+ end
7
+
8
+ module ClassMethods
9
+ def exposes_xmlrpc_methods(options = {})
10
+ configuration = { :method_prefix => nil }
11
+ configuration.update(options) if options.is_a?(Hash)
12
+
13
+ before_filter(:add_method_handlers, :only => [:xe_index])
14
+ class_eval <<-EOV
15
+ require 'xmlrpc/server'
16
+ include ActionController::Acts::RailsXmlrpc::InstanceMethods
17
+
18
+ def xe_method_prefix
19
+ '#{configuration[:method_prefix]}'
20
+ end
21
+
22
+ def self.add_method name, &block
23
+ @method_list ||= []
24
+ lambda_block = lambda &block
25
+ @method_list << { :name => name, :block => lambda_block}
26
+ end
27
+
28
+ def self.xe_method_list
29
+ @method_list ||= []
30
+ @method_list
31
+ end
32
+
33
+ def self.method_size
34
+ @method_list
35
+ end
36
+ EOV
37
+ end
38
+ end
39
+
40
+ module InstanceMethods
41
+ # TODO: add route automatically for this?
42
+ def xe_index
43
+ result = @xmlrpc_server.process(request.body)
44
+ puts "\n\n----- BEGIN RESULT -----\n#{result}----- END RESULT -----\n\n"
45
+ render :text => result, :content_type => 'text/xml'
46
+ end
47
+
48
+ private
49
+
50
+ def add_method_handlers
51
+ @xmlrpc_server = XMLRPC::BasicServer.new
52
+ # loop through all the methods, adding them as handlers
53
+ self.class.xe_method_list.each do |method|
54
+ puts "Adding XMLRPC method for #{method[:name].to_s}"
55
+ @xmlrpc_server.add_handler method[:name], &method[:block]
56
+ # method[:block].call
57
+ # end
58
+ end
59
+
60
+ @xmlrpc_server.add_handler 'demo3' do
61
+ self.class.method_size[0][:name]
62
+ end
63
+
64
+ self.class.instance_methods(false).each do |method|
65
+ unless ['xe_index', 'xe_method_prefix', 'xe_method_list'].member?(method)
66
+ puts "Adding XMLRPC method for #{method.to_s}"
67
+ @xmlrpc_server.add_handler(xe_method_prefix + method) do |*args|
68
+ self.send(method.to_sym, *args)
69
+ end
70
+ end
71
+ end
72
+ end
73
+ end
74
+ end
75
+ end
76
+ end
@@ -0,0 +1,8 @@
1
+ # This file loads when the gem is included, and does plugin-style initialization
2
+
3
+ module ActionController::Acts
4
+ autoload :RailsXmlrpc, "#{File.dirname(__FILE__)}/action_controller/acts/rails_xmlrpc.rb"
5
+ end
6
+
7
+ ActionController::Base.send(:include, ActionController::Acts::RailsXmlrpc )
8
+
@@ -0,0 +1,49 @@
1
+ # -*- encoding: utf-8 -*-
2
+
3
+ Gem::Specification.new do |s|
4
+ s.name = %q{rails-xmlrpc}
5
+ s.version = "0.3.2"
6
+
7
+ s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
8
+ s.authors = ["Aleksei Kvitinskii","Will Koffel"]
9
+ s.date = %q{2011-04-10}
10
+ s.description = %q{Gem allows you to use our RubyOnRails project like XMLRPC server. Support Rails 3.}
11
+ s.email = %q{aleksei.wm@gmail.com}
12
+ s.extra_rdoc_files = [
13
+ "README.rdoc"
14
+ ]
15
+ s.files = [
16
+ ".gitignore",
17
+ "README.rdoc",
18
+ "Rakefile",
19
+ "init.rb",
20
+ "lib/action_controller/acts/rails_xmlrpc.rb",
21
+ "lib/rails-xmlrpc.rb",
22
+ "test/helper.rb",
23
+ "test/test_rails-xmlrpc.rb",
24
+ "rails-xmlrpc.gemspec"
25
+ ]
26
+ s.homepage = %q{http://github.com/Axy/rails-xmlrpc}
27
+ s.rdoc_options = ["--charset=UTF-8"]
28
+ s.require_paths = ["lib"]
29
+ s.rubygems_version = %q{1.3.5}
30
+ s.summary = %q{Gem allows you to use our RubyOnRails project like XMLRPC server. Support Rails 3.}
31
+ s.test_files = [
32
+ "test/helper.rb",
33
+ "test/test_rails-xmlrpc.rb"
34
+ ]
35
+
36
+ if s.respond_to? :specification_version then
37
+ current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
38
+ s.specification_version = 3
39
+
40
+ if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
41
+ s.add_development_dependency(%q<thoughtbot-shoulda>, [">= 0"])
42
+ else
43
+ s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
44
+ end
45
+ else
46
+ s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
47
+ end
48
+ end
49
+
data/test/helper.rb ADDED
@@ -0,0 +1,10 @@
1
+ require 'rubygems'
2
+ require 'test/unit'
3
+ require 'shoulda'
4
+
5
+ $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
6
+ $LOAD_PATH.unshift(File.dirname(__FILE__))
7
+ require 'rails-xmlrpc'
8
+
9
+ class Test::Unit::TestCase
10
+ end
@@ -0,0 +1,7 @@
1
+ require 'helper'
2
+
3
+ class TestRailsXmlrpc < Test::Unit::TestCase
4
+ should "probably rename this file and start testing for real" do
5
+ flunk "hey buddy, you should probably rename this file and start testing for real"
6
+ end
7
+ end
metadata ADDED
@@ -0,0 +1,90 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: rails-xmlrpc
3
+ version: !ruby/object:Gem::Version
4
+ hash: 23
5
+ prerelease:
6
+ segments:
7
+ - 0
8
+ - 3
9
+ - 2
10
+ version: 0.3.2
11
+ platform: ruby
12
+ authors:
13
+ - Aleksei Kvitinskii
14
+ - Will Koffel
15
+ autorequire:
16
+ bindir: bin
17
+ cert_chain: []
18
+
19
+ date: 2011-04-10 00:00:00 +03:00
20
+ default_executable:
21
+ dependencies:
22
+ - !ruby/object:Gem::Dependency
23
+ name: thoughtbot-shoulda
24
+ prerelease: false
25
+ requirement: &id001 !ruby/object:Gem::Requirement
26
+ none: false
27
+ requirements:
28
+ - - ">="
29
+ - !ruby/object:Gem::Version
30
+ hash: 3
31
+ segments:
32
+ - 0
33
+ version: "0"
34
+ type: :development
35
+ version_requirements: *id001
36
+ description: Gem allows you to use our RubyOnRails project like XMLRPC server. Support Rails 3.
37
+ email: aleksei.wm@gmail.com
38
+ executables: []
39
+
40
+ extensions: []
41
+
42
+ extra_rdoc_files:
43
+ - README.rdoc
44
+ files:
45
+ - .gitignore
46
+ - README.rdoc
47
+ - Rakefile
48
+ - init.rb
49
+ - lib/action_controller/acts/rails_xmlrpc.rb
50
+ - lib/rails-xmlrpc.rb
51
+ - test/helper.rb
52
+ - test/test_rails-xmlrpc.rb
53
+ - rails-xmlrpc.gemspec
54
+ has_rdoc: true
55
+ homepage: http://github.com/Axy/rails-xmlrpc
56
+ licenses: []
57
+
58
+ post_install_message:
59
+ rdoc_options:
60
+ - --charset=UTF-8
61
+ require_paths:
62
+ - lib
63
+ required_ruby_version: !ruby/object:Gem::Requirement
64
+ none: false
65
+ requirements:
66
+ - - ">="
67
+ - !ruby/object:Gem::Version
68
+ hash: 3
69
+ segments:
70
+ - 0
71
+ version: "0"
72
+ required_rubygems_version: !ruby/object:Gem::Requirement
73
+ none: false
74
+ requirements:
75
+ - - ">="
76
+ - !ruby/object:Gem::Version
77
+ hash: 3
78
+ segments:
79
+ - 0
80
+ version: "0"
81
+ requirements: []
82
+
83
+ rubyforge_project:
84
+ rubygems_version: 1.4.1
85
+ signing_key:
86
+ specification_version: 3
87
+ summary: Gem allows you to use our RubyOnRails project like XMLRPC server. Support Rails 3.
88
+ test_files:
89
+ - test/helper.rb
90
+ - test/test_rails-xmlrpc.rb