Module: RestCore::Client
- Includes:
- RestCore
- Defined in:
- lib/rest-core/client.rb
Constant Summary
collapse
- Unserializable =
[Proc, Method, IO]
Constants included
from RestCore
ASYNC, CLIENT, DRY, FAIL, HIJACK, LOG, PROMISE, REQUEST_HEADERS, REQUEST_METHOD, REQUEST_PATH, REQUEST_PAYLOAD, REQUEST_QUERY, REQUEST_URI, RESPONSE_BODY, RESPONSE_HEADERS, RESPONSE_KEY, RESPONSE_SOCKET, RESPONSE_STATUS, Simple, TIMER, Universal, VERSION
Instance Attribute Summary collapse
Class Method Summary
collapse
Instance Method Summary
collapse
-
#attributes ⇒ Object
-
#build_env(env = {}) ⇒ Object
-
#default_env ⇒ Object
-
#delete(path, query = {}, opts = {}, &cb) ⇒ Object
-
#event_source(path, query = {}, opts = {}) ⇒ Object
-
#get(path, query = {}, opts = {}, &cb) ⇒ Object
-
#head(path, query = {}, opts = {}, &cb) ⇒ Object
-
#initialize(o = {}) ⇒ Object
-
#inspect ⇒ Object
-
#lighten(o = {}) ⇒ Object
-
#lighten!(o = {}) ⇒ Object
-
#options(path, query = {}, opts = {}, &cb) ⇒ Object
-
#patch(path, payload = {}, query = {}, opts = {}, &cb) ⇒ Object
-
#post(path, payload = {}, query = {}, opts = {}, &cb) ⇒ Object
-
#put(path, payload = {}, query = {}, opts = {}, &cb) ⇒ Object
-
#request(env, app = app) ⇒ Object
-
#request_full(env, app = app, &k) ⇒ Object
-
#url(path, query = {}, opts = {}) ⇒ Object
-
#wait ⇒ Object
Methods included from RestCore
eagerload, id
Instance Attribute Details
#app ⇒ Object
Returns the value of attribute app.
43
44
45
|
# File 'lib/rest-core/client.rb', line 43
def app
@app
end
|
#dry ⇒ Object
Returns the value of attribute dry.
43
44
45
|
# File 'lib/rest-core/client.rb', line 43
def dry
@dry
end
|
#promises ⇒ Object
Returns the value of attribute promises.
43
44
45
|
# File 'lib/rest-core/client.rb', line 43
def promises
@promises
end
|
Class Method Details
.included(mod) ⇒ Object
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
|
# File 'lib/rest-core/client.rb', line 11
def self.included mod
src = mod.members.map{ |name|
<<-RUBY
def #{name}
if (r = super).nil?
self.#{name} = default_#{name}
else
r
end
end
def default_#{name} app=app
if self.class.respond_to?("default_#{name}")
self.class.default_#{name} # old class default style
elsif app.respond_to?(:#{name})
app.#{name}({}) # middleware instance value
elsif app.respond_to?(:app)
default_#{name}(app.app) # walk into next app
else
nil
end
end
private :default_#{name}
RUBY
}
accessor = Module.new
accessor.module_eval(src.join("\n"), __FILE__, __LINE__)
mod.const_set('Accessor', accessor)
mod.send(:include, accessor)
end
|
Instance Method Details
#attributes ⇒ Object
53
54
55
|
# File 'lib/rest-core/client.rb', line 53
def attributes
Hash[each_pair.map{ |k, v| [k, send(k)] }]
end
|
#build_env(env = {}) ⇒ Object
#delete(path, query = {}, opts = {}, &cb) ⇒ Object
104
105
106
107
108
109
|
# File 'lib/rest-core/client.rb', line 104
def delete path, query={}, opts={}, &cb
request(
{REQUEST_METHOD => :delete,
REQUEST_PATH => path ,
REQUEST_QUERY => query }.merge(opts), &cb)
end
|
#event_source(path, query = {}, opts = {}) ⇒ Object
151
152
153
|
# File 'lib/rest-core/client.rb', line 151
def event_source path, query={}, opts={}
self.class.event_source_class.new(self, path, query, opts)
end
|
#get(path, query = {}, opts = {}, &cb) ⇒ Object
97
98
99
100
101
102
|
# File 'lib/rest-core/client.rb', line 97
def get path, query={}, opts={}, &cb
request(
{REQUEST_METHOD => :get ,
REQUEST_PATH => path ,
REQUEST_QUERY => query }.merge(opts), &cb)
end
|
#head(path, query = {}, opts = {}, &cb) ⇒ Object
#initialize(o = {}) ⇒ Object
44
45
46
47
48
49
50
51
|
# File 'lib/rest-core/client.rb', line 44
def initialize o={}
@app ||= self.class.builder.to_app @dry ||= self.class.builder.to_app(Dry)
@promises = [] @mutex = nil o.each{ |key, value| send("#{key}=", value) if respond_to?("#{key}=") }
end
|
#inspect ⇒ Object
57
58
59
60
61
62
63
64
65
66
|
# File 'lib/rest-core/client.rb', line 57
def inspect
fields = if size > 0
' ' + attributes.map{ |k, v|
"#{k}=#{v.inspect.sub(/(?<=.{12}).{4,}/u, '...')}"
}.join(', ')
else
''
end
"#<struct #{self.class.name}#{fields}>"
end
|
#lighten(o = {}) ⇒ Object
81
82
83
|
# File 'lib/rest-core/client.rb', line 81
def lighten o={}
dup.lighten!(o)
end
|
#lighten!(o = {}) ⇒ Object
68
69
70
71
72
73
74
75
76
77
78
79
|
# File 'lib/rest-core/client.rb', line 68
def lighten! o={}
attributes.each{ |k, v| vv = case v;
when Hash; lighten_hash(v)
when Array; lighten_array(v)
when *Unserializable; nil
else v
end
send("#{k}=", vv)}
initialize(o)
@app, @dry = lighten_app(app), lighten_app(dry)
self
end
|
#options(path, query = {}, opts = {}, &cb) ⇒ Object
#patch(path, payload = {}, query = {}, opts = {}, &cb) ⇒ Object
#post(path, payload = {}, query = {}, opts = {}, &cb) ⇒ Object
#put(path, payload = {}, query = {}, opts = {}, &cb) ⇒ Object
#request(env, app = app) ⇒ Object
155
156
157
158
159
160
161
|
# File 'lib/rest-core/client.rb', line 155
def request env, app=app
if block_given?
request_full(env, app){ |response| yield(response[response_key(env)]) }
else
request_full(env, app)[response_key(env)]
end
end
|
#request_full(env, app = app, &k) ⇒ Object
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
|
# File 'lib/rest-core/client.rb', line 163
def request_full env, app=app, &k
response = app.call(build_env({ASYNC => !!k}.merge(env)),
&(k || RC.id))
if response.kind_of?(Hash) && response[PROMISE].kind_of?(Promise)
weak_promise = WeakRef.new(response[PROMISE])
self.class.give_promise(weak_promise)
self.class.give_promise(weak_promise, promises, mutex)
end
if block_given?
self
else
response
end
end
|
#url(path, query = {}, opts = {}) ⇒ Object
90
91
92
93
94
95
|
# File 'lib/rest-core/client.rb', line 90
def url path, query={}, opts={}
dry.call(build_env({
REQUEST_PATH => path,
REQUEST_QUERY => query,
DRY => true}.merge(opts)), &Middleware.method(:request_uri))
end
|
#wait ⇒ Object
85
86
87
88
|
# File 'lib/rest-core/client.rb', line 85
def wait
self.class.wait(promises, mutex)
self
end
|