cocaine-framework-ruby 0.11.2
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/.gitignore +3 -0
- data/LICENSE +165 -0
- data/README.md +16 -0
- data/cocaine.gemspec +27 -0
- data/examples/echo/echo.rb +56 -0
- data/examples/echo/manifest.json +3 -0
- data/lib/cocaine.rb +6 -0
- data/lib/cocaine/asio/channel.rb +88 -0
- data/lib/cocaine/asio/channel/combiner.rb +16 -0
- data/lib/cocaine/asio/channel/manager.rb +19 -0
- data/lib/cocaine/asio/connection.rb +58 -0
- data/lib/cocaine/client/dispatcher.rb +46 -0
- data/lib/cocaine/client/error.rb +7 -0
- data/lib/cocaine/client/service.rb +130 -0
- data/lib/cocaine/decoder.rb +11 -0
- data/lib/cocaine/dispatcher.rb +19 -0
- data/lib/cocaine/error.rb +2 -0
- data/lib/cocaine/future.rb +26 -0
- data/lib/cocaine/namespace.rb +4 -0
- data/lib/cocaine/protocol.rb +155 -0
- data/lib/cocaine/server/dispatcher.rb +72 -0
- data/lib/cocaine/server/health.rb +76 -0
- data/lib/cocaine/server/http.rb +63 -0
- data/lib/cocaine/server/request.rb +9 -0
- data/lib/cocaine/server/response.rb +31 -0
- data/lib/cocaine/server/sandbox.rb +38 -0
- data/lib/cocaine/server/worker.rb +73 -0
- data/lib/cocaine/synchrony/channel.rb +72 -0
- data/lib/cocaine/synchrony/service.rb +53 -0
- data/lib/cocaine/testing/mock_server.rb +123 -0
- data/lib/version.rb +3 -0
- data/spec/channel_spec.rb +160 -0
- data/spec/connection_spec.rb +31 -0
- data/spec/health_spec.rb +19 -0
- data/spec/service_spec.rb +322 -0
- data/spec/stub_server.rb +60 -0
- data/spec/worker_spec.rb +37 -0
- metadata +126 -0
checksums.yaml
ADDED
@@ -0,0 +1,7 @@
|
|
1
|
+
---
|
2
|
+
SHA1:
|
3
|
+
metadata.gz: e672a62ce51809f252292594d90437bd715578d3
|
4
|
+
data.tar.gz: 82f05f204171448f75fad74f766cafb5e632f60e
|
5
|
+
SHA512:
|
6
|
+
metadata.gz: e6b3eacfab1a44db31970b5daa93965cf3f0a6bba3bd84a9ef5b271006397a1813ded72eb657fe3995a1b6159dd9995bca2909112d21350e7ef77c23e9c94e67
|
7
|
+
data.tar.gz: f823b966e2c7a886fd2be2cea30e18952b81dbfeaaa0e619f67ae94cfab44673a36493b637b71f652ac8f208b606529ac827cfaa3fdc92f0c47054898d1c5814
|
data/.gitignore
ADDED
data/LICENSE
ADDED
@@ -0,0 +1,165 @@
|
|
1
|
+
GNU LESSER GENERAL PUBLIC LICENSE
|
2
|
+
Version 3, 29 June 2007
|
3
|
+
|
4
|
+
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
|
5
|
+
Everyone is permitted to copy and distribute verbatim copies
|
6
|
+
of this license document, but changing it is not allowed.
|
7
|
+
|
8
|
+
|
9
|
+
This version of the GNU Lesser General Public License incorporates
|
10
|
+
the terms and conditions of version 3 of the GNU General Public
|
11
|
+
License, supplemented by the additional permissions listed below.
|
12
|
+
|
13
|
+
0. Additional Definitions.
|
14
|
+
|
15
|
+
As used herein, "this License" refers to version 3 of the GNU Lesser
|
16
|
+
General Public License, and the "GNU GPL" refers to version 3 of the GNU
|
17
|
+
General Public License.
|
18
|
+
|
19
|
+
"The Library" refers to a covered work governed by this License,
|
20
|
+
other than an Application or a Combined Work as defined below.
|
21
|
+
|
22
|
+
An "Application" is any work that makes use of an interface provided
|
23
|
+
by the Library, but which is not otherwise based on the Library.
|
24
|
+
Defining a subclass of a class defined by the Library is deemed a mode
|
25
|
+
of using an interface provided by the Library.
|
26
|
+
|
27
|
+
A "Combined Work" is a work produced by combining or linking an
|
28
|
+
Application with the Library. The particular version of the Library
|
29
|
+
with which the Combined Work was made is also called the "Linked
|
30
|
+
Version".
|
31
|
+
|
32
|
+
The "Minimal Corresponding Source" for a Combined Work means the
|
33
|
+
Corresponding Source for the Combined Work, excluding any source code
|
34
|
+
for portions of the Combined Work that, considered in isolation, are
|
35
|
+
based on the Application, and not on the Linked Version.
|
36
|
+
|
37
|
+
The "Corresponding Application Code" for a Combined Work means the
|
38
|
+
object code and/or source code for the Application, including any data
|
39
|
+
and utility programs needed for reproducing the Combined Work from the
|
40
|
+
Application, but excluding the System Libraries of the Combined Work.
|
41
|
+
|
42
|
+
1. Exception to Section 3 of the GNU GPL.
|
43
|
+
|
44
|
+
You may convey a covered work under sections 3 and 4 of this License
|
45
|
+
without being bound by section 3 of the GNU GPL.
|
46
|
+
|
47
|
+
2. Conveying Modified Versions.
|
48
|
+
|
49
|
+
If you modify a copy of the Library, and, in your modifications, a
|
50
|
+
facility refers to a function or data to be supplied by an Application
|
51
|
+
that uses the facility (other than as an argument passed when the
|
52
|
+
facility is invoked), then you may convey a copy of the modified
|
53
|
+
version:
|
54
|
+
|
55
|
+
a) under this License, provided that you make a good faith effort to
|
56
|
+
ensure that, in the event an Application does not supply the
|
57
|
+
function or data, the facility still operates, and performs
|
58
|
+
whatever part of its purpose remains meaningful, or
|
59
|
+
|
60
|
+
b) under the GNU GPL, with none of the additional permissions of
|
61
|
+
this License applicable to that copy.
|
62
|
+
|
63
|
+
3. Object Code Incorporating Material from Library Header Files.
|
64
|
+
|
65
|
+
The object code form of an Application may incorporate material from
|
66
|
+
a header file that is part of the Library. You may convey such object
|
67
|
+
code under terms of your choice, provided that, if the incorporated
|
68
|
+
material is not limited to numerical parameters, data structure
|
69
|
+
layouts and accessors, or small macros, inline functions and templates
|
70
|
+
(ten or fewer lines in length), you do both of the following:
|
71
|
+
|
72
|
+
a) Give prominent notice with each copy of the object code that the
|
73
|
+
Library is used in it and that the Library and its use are
|
74
|
+
covered by this License.
|
75
|
+
|
76
|
+
b) Accompany the object code with a copy of the GNU GPL and this license
|
77
|
+
document.
|
78
|
+
|
79
|
+
4. Combined Works.
|
80
|
+
|
81
|
+
You may convey a Combined Work under terms of your choice that,
|
82
|
+
taken together, effectively do not restrict modification of the
|
83
|
+
portions of the Library contained in the Combined Work and reverse
|
84
|
+
engineering for debugging such modifications, if you also do each of
|
85
|
+
the following:
|
86
|
+
|
87
|
+
a) Give prominent notice with each copy of the Combined Work that
|
88
|
+
the Library is used in it and that the Library and its use are
|
89
|
+
covered by this License.
|
90
|
+
|
91
|
+
b) Accompany the Combined Work with a copy of the GNU GPL and this license
|
92
|
+
document.
|
93
|
+
|
94
|
+
c) For a Combined Work that displays copyright notices during
|
95
|
+
execution, include the copyright notice for the Library among
|
96
|
+
these notices, as well as a reference directing the user to the
|
97
|
+
copies of the GNU GPL and this license document.
|
98
|
+
|
99
|
+
d) Do one of the following:
|
100
|
+
|
101
|
+
0) Convey the Minimal Corresponding Source under the terms of this
|
102
|
+
License, and the Corresponding Application Code in a form
|
103
|
+
suitable for, and under terms that permit, the user to
|
104
|
+
recombine or relink the Application with a modified version of
|
105
|
+
the Linked Version to produce a modified Combined Work, in the
|
106
|
+
manner specified by section 6 of the GNU GPL for conveying
|
107
|
+
Corresponding Source.
|
108
|
+
|
109
|
+
1) Use a suitable shared library mechanism for linking with the
|
110
|
+
Library. A suitable mechanism is one that (a) uses at run time
|
111
|
+
a copy of the Library already present on the user's computer
|
112
|
+
system, and (b) will operate properly with a modified version
|
113
|
+
of the Library that is interface-compatible with the Linked
|
114
|
+
Version.
|
115
|
+
|
116
|
+
e) Provide Installation Information, but only if you would otherwise
|
117
|
+
be required to provide such information under section 6 of the
|
118
|
+
GNU GPL, and only to the extent that such information is
|
119
|
+
necessary to install and execute a modified version of the
|
120
|
+
Combined Work produced by recombining or relinking the
|
121
|
+
Application with a modified version of the Linked Version. (If
|
122
|
+
you use option 4d0, the Installation Information must accompany
|
123
|
+
the Minimal Corresponding Source and Corresponding Application
|
124
|
+
Code. If you use option 4d1, you must provide the Installation
|
125
|
+
Information in the manner specified by section 6 of the GNU GPL
|
126
|
+
for conveying Corresponding Source.)
|
127
|
+
|
128
|
+
5. Combined Libraries.
|
129
|
+
|
130
|
+
You may place library facilities that are a work based on the
|
131
|
+
Library side by side in a single library together with other library
|
132
|
+
facilities that are not Applications and are not covered by this
|
133
|
+
License, and convey such a combined library under terms of your
|
134
|
+
choice, if you do both of the following:
|
135
|
+
|
136
|
+
a) Accompany the combined library with a copy of the same work based
|
137
|
+
on the Library, uncombined with any other library facilities,
|
138
|
+
conveyed under the terms of this License.
|
139
|
+
|
140
|
+
b) Give prominent notice with the combined library that part of it
|
141
|
+
is a work based on the Library, and explaining where to find the
|
142
|
+
accompanying uncombined form of the same work.
|
143
|
+
|
144
|
+
6. Revised Versions of the GNU Lesser General Public License.
|
145
|
+
|
146
|
+
The Free Software Foundation may publish revised and/or new versions
|
147
|
+
of the GNU Lesser General Public License from time to time. Such new
|
148
|
+
versions will be similar in spirit to the present version, but may
|
149
|
+
differ in detail to address new problems or concerns.
|
150
|
+
|
151
|
+
Each version is given a distinguishing version number. If the
|
152
|
+
Library as you received it specifies that a certain numbered version
|
153
|
+
of the GNU Lesser General Public License "or any later version"
|
154
|
+
applies to it, you have the option of following the terms and
|
155
|
+
conditions either of that published version or of any later version
|
156
|
+
published by the Free Software Foundation. If the Library as you
|
157
|
+
received it does not specify a version number of the GNU Lesser
|
158
|
+
General Public License, you may choose any version of the GNU Lesser
|
159
|
+
General Public License ever published by the Free Software Foundation.
|
160
|
+
|
161
|
+
If the Library as you received it specifies that a proxy can decide
|
162
|
+
whether future versions of the GNU Lesser General Public License shall
|
163
|
+
apply, that proxy's public statement of acceptance of any version is
|
164
|
+
permanent authorization for you to choose that version for the
|
165
|
+
Library.
|
data/README.md
ADDED
@@ -0,0 +1,16 @@
|
|
1
|
+
Introducing cocaine-framework-ruby
|
2
|
+
========================================
|
3
|
+
|
4
|
+
Here you are, almighty Ruby programmers! Introducing another framework for our Cocaine Cloud.
|
5
|
+
This time it is cocaine-framework-ruby.
|
6
|
+
|
7
|
+
* Requires at least Ruby 1.9
|
8
|
+
|
9
|
+
Framework provides next features:
|
10
|
+
|
11
|
+
* Ability to create your own apps and upload it to the Cloud.
|
12
|
+
* Ability to use other Cloud services or apps.
|
13
|
+
* Explicit future-based asynchronous backend to maximize performance without using threads.
|
14
|
+
* Fiber-aware asynchronous backend to make your asynchronous code look like it is synchronous.
|
15
|
+
* Integration with our http-proxy for simple applications.
|
16
|
+
* [In the nearest future] Ruby on Rails support.
|
data/cocaine.gemspec
ADDED
@@ -0,0 +1,27 @@
|
|
1
|
+
# -*- encoding: utf-8 -*-
|
2
|
+
$:.unshift File.expand_path('../lib', __FILE__)
|
3
|
+
|
4
|
+
require 'version'
|
5
|
+
|
6
|
+
|
7
|
+
Gem::Specification.new do |s|
|
8
|
+
s.name = 'cocaine-framework-ruby'
|
9
|
+
s.version = Cocaine::VERSION
|
10
|
+
s.homepage = 'https://github.com/cocaine/cocaine-framework-ruby'
|
11
|
+
s.licenses = ['Ruby', 'LGPLv3']
|
12
|
+
|
13
|
+
s.authors = ['Evgeny Safronov']
|
14
|
+
s.email = ['division494@gmail.com']
|
15
|
+
|
16
|
+
s.files = `git ls-files`.split("\n")
|
17
|
+
s.extensions = []
|
18
|
+
|
19
|
+
s.summary = 'Ruby/Cocaine library'
|
20
|
+
s.description = "Cocaine Framework is a framework for simplifying development both server-side
|
21
|
+
and client-side applications. It's pretty nice, I promise."
|
22
|
+
|
23
|
+
s.add_development_dependency 'rspec', '~> 0'
|
24
|
+
|
25
|
+
s.add_runtime_dependency 'eventmachine', '~> 1.0'
|
26
|
+
s.add_runtime_dependency 'em-synchrony', '~> 1.0'
|
27
|
+
end
|
@@ -0,0 +1,56 @@
|
|
1
|
+
#!/usr/bin/env ruby
|
2
|
+
|
3
|
+
require 'cocaine'
|
4
|
+
require 'cocaine/server/http'
|
5
|
+
|
6
|
+
$log = Logger.new(STDERR)
|
7
|
+
$log.level = Logger::DEBUG
|
8
|
+
|
9
|
+
class Echo
|
10
|
+
def execute(request, response)
|
11
|
+
df = request.read
|
12
|
+
df.callback do |msg|
|
13
|
+
$log.debug "Message received: #{msg}"
|
14
|
+
response.write msg
|
15
|
+
response.close
|
16
|
+
end
|
17
|
+
end
|
18
|
+
end
|
19
|
+
|
20
|
+
|
21
|
+
class EchoStreaming
|
22
|
+
def execute(request, response)
|
23
|
+
df = request.read
|
24
|
+
df.callback do |msg|
|
25
|
+
$log.debug "Message received: #{msg}. Sending it back more happily."
|
26
|
+
response.write msg
|
27
|
+
response.write msg + '!'
|
28
|
+
response.write msg + '! :)'
|
29
|
+
response.close
|
30
|
+
end
|
31
|
+
end
|
32
|
+
end
|
33
|
+
|
34
|
+
|
35
|
+
class HttpEcho
|
36
|
+
extend Cocaine::Http
|
37
|
+
|
38
|
+
def execute(request, response)
|
39
|
+
df = request.read
|
40
|
+
df.callback do |rq|
|
41
|
+
msg = rq.query['message']
|
42
|
+
$log.debug "Message: #{rq.query}"
|
43
|
+
$log.debug "Message: #{msg}"
|
44
|
+
response.write_headers(200, ['Content-Type', 'plain/text'])
|
45
|
+
response.body = msg
|
46
|
+
response.close
|
47
|
+
end
|
48
|
+
end
|
49
|
+
http :execute
|
50
|
+
end
|
51
|
+
|
52
|
+
w = Cocaine::WorkerFactory.create
|
53
|
+
w.on 'ping', Echo.new
|
54
|
+
w.on 'ping-streaming', EchoStreaming.new
|
55
|
+
w.on 'ping-http', HttpEcho.new
|
56
|
+
w.run()
|
data/lib/cocaine.rb
ADDED
@@ -0,0 +1,88 @@
|
|
1
|
+
require 'eventmachine'
|
2
|
+
|
3
|
+
require 'cocaine/error'
|
4
|
+
require 'cocaine/namespace'
|
5
|
+
|
6
|
+
class Cocaine::Channel
|
7
|
+
def initialize
|
8
|
+
@state = :opened
|
9
|
+
|
10
|
+
@pending = []
|
11
|
+
@errors = []
|
12
|
+
|
13
|
+
@callbacks = []
|
14
|
+
@errbacks = []
|
15
|
+
@collector = nil
|
16
|
+
end
|
17
|
+
|
18
|
+
def callback(&block)
|
19
|
+
register_callback @callbacks, @pending, block
|
20
|
+
self
|
21
|
+
end
|
22
|
+
|
23
|
+
def errback(&block)
|
24
|
+
register_callback @errbacks, @errors, block
|
25
|
+
self
|
26
|
+
end
|
27
|
+
|
28
|
+
def trigger(chunk)
|
29
|
+
do_trigger @callbacks, @pending, chunk
|
30
|
+
end
|
31
|
+
|
32
|
+
def error(err)
|
33
|
+
do_trigger @errbacks, @errors, err
|
34
|
+
end
|
35
|
+
|
36
|
+
def close
|
37
|
+
@state = :closed
|
38
|
+
check_and_trigger_collector
|
39
|
+
end
|
40
|
+
|
41
|
+
def collect
|
42
|
+
raise IllegalStateError if @state == :closed
|
43
|
+
raise IllegalStateError.new 'only one collector can be bound to the channel' if @collector
|
44
|
+
@collector ||= EM::DefaultDeferrable.new
|
45
|
+
end
|
46
|
+
|
47
|
+
private
|
48
|
+
def check_and_trigger_collector
|
49
|
+
if @collector
|
50
|
+
trigger_collector
|
51
|
+
end
|
52
|
+
end
|
53
|
+
|
54
|
+
private
|
55
|
+
def trigger_collector
|
56
|
+
if @errors.length == 1
|
57
|
+
@collector.fail *@errors
|
58
|
+
else
|
59
|
+
@collector.succeed @pending.concat(@errors)
|
60
|
+
end
|
61
|
+
end
|
62
|
+
|
63
|
+
private
|
64
|
+
def register_callback(callbacks, entities, block)
|
65
|
+
raise IllegalStateError unless @state == :opened
|
66
|
+
|
67
|
+
until entities.empty?
|
68
|
+
block.call entities.pop
|
69
|
+
end
|
70
|
+
|
71
|
+
callbacks.push block
|
72
|
+
self
|
73
|
+
end
|
74
|
+
|
75
|
+
private
|
76
|
+
def do_trigger(callbacks, entities, entity)
|
77
|
+
raise IllegalStateError unless @state == :opened
|
78
|
+
|
79
|
+
if callbacks.empty?
|
80
|
+
entities ||= []
|
81
|
+
entities.push entity
|
82
|
+
else
|
83
|
+
callbacks.each do |callback|
|
84
|
+
callback.call entity
|
85
|
+
end
|
86
|
+
end
|
87
|
+
end
|
88
|
+
end
|
@@ -0,0 +1,16 @@
|
|
1
|
+
require 'cocaine/future'
|
2
|
+
|
3
|
+
class Cocaine::ChannelCombiner
|
4
|
+
def initialize(channel)
|
5
|
+
channel.callback { |result|
|
6
|
+
@callback.call Cocaine::Future.value result if @callback
|
7
|
+
}
|
8
|
+
channel.errback { |err|
|
9
|
+
@callback.call Cocaine::Future.error err if @callback
|
10
|
+
}
|
11
|
+
end
|
12
|
+
|
13
|
+
def callback(&block)
|
14
|
+
@callback = block
|
15
|
+
end
|
16
|
+
end
|
@@ -0,0 +1,19 @@
|
|
1
|
+
require 'cocaine/asio/channel'
|
2
|
+
require 'cocaine/namespace'
|
3
|
+
|
4
|
+
class Cocaine::ChannelManager
|
5
|
+
def initialize
|
6
|
+
@counter = 0
|
7
|
+
@channels = {}
|
8
|
+
end
|
9
|
+
|
10
|
+
def create
|
11
|
+
@counter += 1
|
12
|
+
channel = @channels[@counter] = Cocaine::Channel.new
|
13
|
+
[@counter, channel]
|
14
|
+
end
|
15
|
+
|
16
|
+
def [](session)
|
17
|
+
@channels[session]
|
18
|
+
end
|
19
|
+
end
|
@@ -0,0 +1,58 @@
|
|
1
|
+
require 'logger'
|
2
|
+
require 'eventmachine'
|
3
|
+
|
4
|
+
require 'cocaine/dispatcher'
|
5
|
+
require 'cocaine/decoder'
|
6
|
+
require 'cocaine/protocol'
|
7
|
+
|
8
|
+
|
9
|
+
$log = Logger.new(STDERR)
|
10
|
+
$log.level = Logger::DEBUG
|
11
|
+
|
12
|
+
|
13
|
+
class HookManager
|
14
|
+
def initialize
|
15
|
+
@hooks = {}
|
16
|
+
end
|
17
|
+
|
18
|
+
def on(type, &block)
|
19
|
+
@hooks[type] = block
|
20
|
+
end
|
21
|
+
|
22
|
+
def clear
|
23
|
+
@hooks.clear
|
24
|
+
end
|
25
|
+
|
26
|
+
def call(type, *args)
|
27
|
+
@hooks[type].call *args if @hooks.has_key? type
|
28
|
+
end
|
29
|
+
end
|
30
|
+
|
31
|
+
|
32
|
+
class Cocaine::Connection < EventMachine::Connection
|
33
|
+
attr_reader :state, :hooks
|
34
|
+
|
35
|
+
def initialize(decoder=nil)
|
36
|
+
@decoder = decoder || Cocaine::Decoder.new
|
37
|
+
@state = :connecting
|
38
|
+
@hooks = HookManager.new
|
39
|
+
end
|
40
|
+
|
41
|
+
def connection_completed
|
42
|
+
@state = :connected
|
43
|
+
@hooks.call :connected
|
44
|
+
end
|
45
|
+
|
46
|
+
def unbind
|
47
|
+
@state = :disconnected
|
48
|
+
@hooks.call :disconnected, error?
|
49
|
+
end
|
50
|
+
|
51
|
+
def receive_data(raw_data)
|
52
|
+
@decoder.feed(raw_data) do |id, session, data|
|
53
|
+
message = Cocaine::ProtocolFactory.create(id, data)
|
54
|
+
$log.debug "received message #{{:type => message.id, :session => session}}"
|
55
|
+
@hooks.call :message, session, message
|
56
|
+
end
|
57
|
+
end
|
58
|
+
end
|