fiveruns-dash-ruby 0.8.3 → 0.8.4
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/README.rdoc +5 -4
- data/Rakefile +1 -2
- data/lib/fiveruns/dash.rb +5 -4
- data/lib/fiveruns/dash/metric.rb +2 -1
- data/lib/fiveruns/dash/reporter.rb +9 -7
- data/lib/fiveruns/dash/store/file.rb +1 -1
- data/lib/fiveruns/dash/store/http.rb +4 -4
- data/lib/fiveruns/dash/trace.rb +4 -4
- data/lib/fiveruns/dash/update.rb +4 -4
- data/lib/fiveruns/json.rb +15 -0
- data/lib/fiveruns/json/add/core.rb +131 -0
- data/lib/fiveruns/json/add/rails.rb +55 -0
- data/lib/fiveruns/json/common.rb +352 -0
- data/lib/fiveruns/json/generator.rb +394 -0
- data/lib/fiveruns/json/pure.rb +71 -0
- data/lib/fiveruns/json/version.rb +8 -0
- data/test/collector_communication_test.rb +1 -1
- data/test/data_payload.bin.gz +0 -0
- data/test/json_test.rb +33 -0
- data/version.yml +1 -1
- metadata +15 -13
@@ -0,0 +1,394 @@
|
|
1
|
+
module Fiveruns::JSON
|
2
|
+
MAP = {
|
3
|
+
"\x0" => '\u0000',
|
4
|
+
"\x1" => '\u0001',
|
5
|
+
"\x2" => '\u0002',
|
6
|
+
"\x3" => '\u0003',
|
7
|
+
"\x4" => '\u0004',
|
8
|
+
"\x5" => '\u0005',
|
9
|
+
"\x6" => '\u0006',
|
10
|
+
"\x7" => '\u0007',
|
11
|
+
"\b" => '\b',
|
12
|
+
"\t" => '\t',
|
13
|
+
"\n" => '\n',
|
14
|
+
"\xb" => '\u000b',
|
15
|
+
"\f" => '\f',
|
16
|
+
"\r" => '\r',
|
17
|
+
"\xe" => '\u000e',
|
18
|
+
"\xf" => '\u000f',
|
19
|
+
"\x10" => '\u0010',
|
20
|
+
"\x11" => '\u0011',
|
21
|
+
"\x12" => '\u0012',
|
22
|
+
"\x13" => '\u0013',
|
23
|
+
"\x14" => '\u0014',
|
24
|
+
"\x15" => '\u0015',
|
25
|
+
"\x16" => '\u0016',
|
26
|
+
"\x17" => '\u0017',
|
27
|
+
"\x18" => '\u0018',
|
28
|
+
"\x19" => '\u0019',
|
29
|
+
"\x1a" => '\u001a',
|
30
|
+
"\x1b" => '\u001b',
|
31
|
+
"\x1c" => '\u001c',
|
32
|
+
"\x1d" => '\u001d',
|
33
|
+
"\x1e" => '\u001e',
|
34
|
+
"\x1f" => '\u001f',
|
35
|
+
'"' => '\"',
|
36
|
+
'\\' => '\\\\',
|
37
|
+
'/' => '\/',
|
38
|
+
} # :nodoc:
|
39
|
+
|
40
|
+
# Convert a UTF8 encoded Ruby string _string_ to a FiverunsJSON string, encoded with
|
41
|
+
# UTF16 big endian characters as \u????, and return it.
|
42
|
+
def utf8_to_json(string) # :nodoc:
|
43
|
+
string = string.gsub(/["\\\/\x0-\x1f]/) { MAP[$&] }
|
44
|
+
string.gsub!(/(
|
45
|
+
(?:
|
46
|
+
[\xc2-\xdf][\x80-\xbf] |
|
47
|
+
[\xe0-\xef][\x80-\xbf]{2} |
|
48
|
+
[\xf0-\xf4][\x80-\xbf]{3}
|
49
|
+
)+ |
|
50
|
+
[\x80-\xc1\xf5-\xff] # invalid
|
51
|
+
)/nx) { |c|
|
52
|
+
c.size == 1 and raise GeneratorError, "invalid utf8 byte: '#{c}'"
|
53
|
+
s = ::Fiveruns::JSON::UTF8toUTF16.iconv(c).unpack('H*')[0]
|
54
|
+
s.gsub!(/.{4}/n, '\\\\u\&')
|
55
|
+
}
|
56
|
+
string
|
57
|
+
rescue Iconv::Failure => e
|
58
|
+
raise GeneratorError, "Caught #{e.class}: #{e}"
|
59
|
+
end
|
60
|
+
module_function :utf8_to_json
|
61
|
+
|
62
|
+
module Pure
|
63
|
+
module Generator
|
64
|
+
# This class is used to create State instances, that are use to hold data
|
65
|
+
# while generating a FiverunsJSON text from a a Ruby data structure.
|
66
|
+
class State
|
67
|
+
# Creates a State object from _opts_, which ought to be Hash to create
|
68
|
+
# a new State instance configured by _opts_, something else to create
|
69
|
+
# an unconfigured instance. If _opts_ is a State object, it is just
|
70
|
+
# returned.
|
71
|
+
def self.from_state(opts)
|
72
|
+
case opts
|
73
|
+
when self
|
74
|
+
opts
|
75
|
+
when Hash
|
76
|
+
new(opts)
|
77
|
+
else
|
78
|
+
new
|
79
|
+
end
|
80
|
+
end
|
81
|
+
|
82
|
+
# Instantiates a new State object, configured by _opts_.
|
83
|
+
#
|
84
|
+
# _opts_ can have the following keys:
|
85
|
+
#
|
86
|
+
# * *indent*: a string used to indent levels (default: ''),
|
87
|
+
# * *space*: a string that is put after, a : or , delimiter (default: ''),
|
88
|
+
# * *space_before*: a string that is put before a : pair delimiter (default: ''),
|
89
|
+
# * *object_nl*: a string that is put at the end of a FiverunsJSON object (default: ''),
|
90
|
+
# * *array_nl*: a string that is put at the end of a FiverunsJSON array (default: ''),
|
91
|
+
# * *check_circular*: true if checking for circular data structures
|
92
|
+
# should be done (the default), false otherwise.
|
93
|
+
# * *check_circular*: true if checking for circular data structures
|
94
|
+
# should be done, false (the default) otherwise.
|
95
|
+
# * *allow_nan*: true if NaN, Infinity, and -Infinity should be
|
96
|
+
# generated, otherwise an exception is thrown, if these values are
|
97
|
+
# encountered. This options defaults to false.
|
98
|
+
def initialize(opts = {})
|
99
|
+
@seen = {}
|
100
|
+
@indent = ''
|
101
|
+
@space = ''
|
102
|
+
@space_before = ''
|
103
|
+
@object_nl = ''
|
104
|
+
@array_nl = ''
|
105
|
+
@check_circular = true
|
106
|
+
@allow_nan = false
|
107
|
+
configure opts
|
108
|
+
end
|
109
|
+
|
110
|
+
# This string is used to indent levels in the FiverunsJSON text.
|
111
|
+
attr_accessor :indent
|
112
|
+
|
113
|
+
# This string is used to insert a space between the tokens in a FiverunsJSON
|
114
|
+
# string.
|
115
|
+
attr_accessor :space
|
116
|
+
|
117
|
+
# This string is used to insert a space before the ':' in FiverunsJSON objects.
|
118
|
+
attr_accessor :space_before
|
119
|
+
|
120
|
+
# This string is put at the end of a line that holds a FiverunsJSON object (or
|
121
|
+
# Hash).
|
122
|
+
attr_accessor :object_nl
|
123
|
+
|
124
|
+
# This string is put at the end of a line that holds a FiverunsJSON array.
|
125
|
+
attr_accessor :array_nl
|
126
|
+
|
127
|
+
# This integer returns the maximum level of data structure nesting in
|
128
|
+
# the generated FiverunsJSON, max_nesting = 0 if no maximum is checked.
|
129
|
+
attr_accessor :max_nesting
|
130
|
+
|
131
|
+
def check_max_nesting(depth) # :nodoc:
|
132
|
+
return if @max_nesting.zero?
|
133
|
+
current_nesting = depth + 1
|
134
|
+
current_nesting > @max_nesting and
|
135
|
+
raise NestingError, "nesting of #{current_nesting} is too deep"
|
136
|
+
end
|
137
|
+
|
138
|
+
# Returns true, if circular data structures should be checked,
|
139
|
+
# otherwise returns false.
|
140
|
+
def check_circular?
|
141
|
+
@check_circular
|
142
|
+
end
|
143
|
+
|
144
|
+
# Returns true if NaN, Infinity, and -Infinity should be considered as
|
145
|
+
# valid FiverunsJSON and output.
|
146
|
+
def allow_nan?
|
147
|
+
@allow_nan
|
148
|
+
end
|
149
|
+
|
150
|
+
# Returns _true_, if _object_ was already seen during this generating
|
151
|
+
# run.
|
152
|
+
def seen?(object)
|
153
|
+
@seen.key?(object.__id__)
|
154
|
+
end
|
155
|
+
|
156
|
+
# Remember _object_, to find out if it was already encountered (if a
|
157
|
+
# cyclic data structure is if a cyclic data structure is rendered).
|
158
|
+
def remember(object)
|
159
|
+
@seen[object.__id__] = true
|
160
|
+
end
|
161
|
+
|
162
|
+
# Forget _object_ for this generating run.
|
163
|
+
def forget(object)
|
164
|
+
@seen.delete object.__id__
|
165
|
+
end
|
166
|
+
|
167
|
+
# Configure this State instance with the Hash _opts_, and return
|
168
|
+
# itself.
|
169
|
+
def configure(opts)
|
170
|
+
@indent = opts[:indent] if opts.key?(:indent)
|
171
|
+
@space = opts[:space] if opts.key?(:space)
|
172
|
+
@space_before = opts[:space_before] if opts.key?(:space_before)
|
173
|
+
@object_nl = opts[:object_nl] if opts.key?(:object_nl)
|
174
|
+
@array_nl = opts[:array_nl] if opts.key?(:array_nl)
|
175
|
+
@check_circular = !!opts[:check_circular] if opts.key?(:check_circular)
|
176
|
+
@allow_nan = !!opts[:allow_nan] if opts.key?(:allow_nan)
|
177
|
+
if !opts.key?(:max_nesting) # defaults to 19
|
178
|
+
@max_nesting = 19
|
179
|
+
elsif opts[:max_nesting]
|
180
|
+
@max_nesting = opts[:max_nesting]
|
181
|
+
else
|
182
|
+
@max_nesting = 0
|
183
|
+
end
|
184
|
+
self
|
185
|
+
end
|
186
|
+
|
187
|
+
# Returns the configuration instance variables as a hash, that can be
|
188
|
+
# passed to the configure method.
|
189
|
+
def to_h
|
190
|
+
result = {}
|
191
|
+
for iv in %w[indent space space_before object_nl array_nl check_circular allow_nan max_nesting]
|
192
|
+
result[iv.intern] = instance_variable_get("@#{iv}")
|
193
|
+
end
|
194
|
+
result
|
195
|
+
end
|
196
|
+
end
|
197
|
+
|
198
|
+
module GeneratorMethods
|
199
|
+
module Object
|
200
|
+
# Converts this object to a string (calling #to_s), converts
|
201
|
+
# it to a FiverunsJSON string, and returns the result. This is a fallback, if no
|
202
|
+
# special method #to_json was defined for some object.
|
203
|
+
def to_fjson(*) to_s.to_fjson end
|
204
|
+
end
|
205
|
+
|
206
|
+
module Hash
|
207
|
+
# Returns a FiverunsJSON string containing a FiverunsJSON object, that is unparsed from
|
208
|
+
# this Hash instance.
|
209
|
+
# _state_ is a FiverunsJSON::State object, that can also be used to configure the
|
210
|
+
# produced FiverunsJSON string output further.
|
211
|
+
# _depth_ is used to find out nesting depth, to indent accordingly.
|
212
|
+
def to_fjson(state = nil, depth = 0, *)
|
213
|
+
if state
|
214
|
+
state = ::Fiveruns::JSON.state.from_state(state)
|
215
|
+
state.check_max_nesting(depth)
|
216
|
+
fjson_check_circular(state) { fjson_transform(state, depth) }
|
217
|
+
else
|
218
|
+
fjson_transform(state, depth)
|
219
|
+
end
|
220
|
+
end
|
221
|
+
|
222
|
+
private
|
223
|
+
|
224
|
+
def fjson_check_circular(state)
|
225
|
+
if state and state.check_circular?
|
226
|
+
state.seen?(self) and raise ::Fiveruns::JSON::CircularDatastructure,
|
227
|
+
"circular data structures not supported!"
|
228
|
+
state.remember self
|
229
|
+
end
|
230
|
+
yield
|
231
|
+
ensure
|
232
|
+
state and state.forget self
|
233
|
+
end
|
234
|
+
|
235
|
+
def fjson_shift(state, depth)
|
236
|
+
state and not state.object_nl.empty? or return ''
|
237
|
+
state.indent * depth
|
238
|
+
end
|
239
|
+
|
240
|
+
def fjson_transform(state, depth)
|
241
|
+
delim = ','
|
242
|
+
delim << state.object_nl if state
|
243
|
+
result = '{'
|
244
|
+
result << state.object_nl if state
|
245
|
+
result << map { |key,value|
|
246
|
+
s = fjson_shift(state, depth + 1)
|
247
|
+
s << key.to_s.to_fjson(state, depth + 1)
|
248
|
+
s << state.space_before if state
|
249
|
+
s << ':'
|
250
|
+
s << state.space if state
|
251
|
+
s << value.to_fjson(state, depth + 1)
|
252
|
+
}.join(delim)
|
253
|
+
result << state.object_nl if state
|
254
|
+
result << fjson_shift(state, depth)
|
255
|
+
result << '}'
|
256
|
+
result
|
257
|
+
end
|
258
|
+
end
|
259
|
+
|
260
|
+
module Array
|
261
|
+
# Returns a FiverunsJSON string containing a FiverunsJSON array, that is unparsed from
|
262
|
+
# this Array instance.
|
263
|
+
# _state_ is a FiverunsJSON::State object, that can also be used to configure the
|
264
|
+
# produced FiverunsJSON string output further.
|
265
|
+
# _depth_ is used to find out nesting depth, to indent accordingly.
|
266
|
+
def to_fjson(state = nil, depth = 0, *)
|
267
|
+
if state
|
268
|
+
state = ::Fiveruns::JSON.state.from_state(state)
|
269
|
+
state.check_max_nesting(depth)
|
270
|
+
fjson_check_circular(state) { fjson_transform(state, depth) }
|
271
|
+
else
|
272
|
+
fjson_transform(state, depth)
|
273
|
+
end
|
274
|
+
end
|
275
|
+
|
276
|
+
private
|
277
|
+
|
278
|
+
def fjson_check_circular(state)
|
279
|
+
if state and state.check_circular?
|
280
|
+
state.seen?(self) and raise ::Fiveruns::JSON::CircularDatastructure,
|
281
|
+
"circular data structures not supported!"
|
282
|
+
state.remember self
|
283
|
+
end
|
284
|
+
yield
|
285
|
+
ensure
|
286
|
+
state and state.forget self
|
287
|
+
end
|
288
|
+
|
289
|
+
def fjson_shift(state, depth)
|
290
|
+
state and not state.array_nl.empty? or return ''
|
291
|
+
state.indent * depth
|
292
|
+
end
|
293
|
+
|
294
|
+
def fjson_transform(state, depth)
|
295
|
+
delim = ','
|
296
|
+
delim << state.array_nl if state
|
297
|
+
result = '['
|
298
|
+
result << state.array_nl if state
|
299
|
+
result << map { |value|
|
300
|
+
fjson_shift(state, depth + 1) << value.to_fjson(state, depth + 1)
|
301
|
+
}.join(delim)
|
302
|
+
result << state.array_nl if state
|
303
|
+
result << fjson_shift(state, depth)
|
304
|
+
result << ']'
|
305
|
+
result
|
306
|
+
end
|
307
|
+
end
|
308
|
+
|
309
|
+
module Integer
|
310
|
+
# Returns a FiverunsJSON string representation for this Integer number.
|
311
|
+
def to_fjson(*) to_s end
|
312
|
+
end
|
313
|
+
|
314
|
+
module Float
|
315
|
+
# Returns a FiverunsJSON string representation for this Float number.
|
316
|
+
def to_fjson(state = nil, *)
|
317
|
+
case
|
318
|
+
when infinite?
|
319
|
+
if !state || state.allow_nan?
|
320
|
+
to_s
|
321
|
+
else
|
322
|
+
raise GeneratorError, "#{self} not allowed in FiverunsJSON"
|
323
|
+
end
|
324
|
+
when nan?
|
325
|
+
if !state || state.allow_nan?
|
326
|
+
to_s
|
327
|
+
else
|
328
|
+
raise GeneratorError, "#{self} not allowed in FiverunsJSON"
|
329
|
+
end
|
330
|
+
else
|
331
|
+
to_s
|
332
|
+
end
|
333
|
+
end
|
334
|
+
end
|
335
|
+
|
336
|
+
module String
|
337
|
+
# This string should be encoded with UTF-8 A call to this method
|
338
|
+
# returns a FiverunsJSON string encoded with UTF16 big endian characters as
|
339
|
+
# \u????.
|
340
|
+
def to_fjson(*)
|
341
|
+
'"' << ::Fiveruns::JSON.utf8_to_json(self) << '"'
|
342
|
+
end
|
343
|
+
|
344
|
+
# Module that holds the extinding methods if, the String module is
|
345
|
+
# included.
|
346
|
+
module Extend
|
347
|
+
# Raw Strings are FiverunsJSON Objects (the raw bytes are stored in an array for the
|
348
|
+
# key "raw"). The Ruby String can be created by this module method.
|
349
|
+
def fjson_create(o)
|
350
|
+
o['raw'].pack('C*')
|
351
|
+
end
|
352
|
+
end
|
353
|
+
|
354
|
+
# Extends _modul_ with the String::Extend module.
|
355
|
+
def self.included(modul)
|
356
|
+
modul.extend Extend
|
357
|
+
end
|
358
|
+
|
359
|
+
# This method creates a raw object hash, that can be nested into
|
360
|
+
# other data structures and will be unparsed as a raw string. This
|
361
|
+
# method should be used, if you want to convert raw strings to FiverunsJSON
|
362
|
+
# instead of UTF-8 strings, e. g. binary data.
|
363
|
+
def to_fjson_raw_object
|
364
|
+
{
|
365
|
+
::Fiveruns::JSON.create_id => self.class.name,
|
366
|
+
'raw' => self.unpack('C*'),
|
367
|
+
}
|
368
|
+
end
|
369
|
+
|
370
|
+
# This method creates a FiverunsJSON text from the result of
|
371
|
+
# a call to to_json_raw_object of this String.
|
372
|
+
def to_fjson_raw(*args)
|
373
|
+
to_fjson_raw_object.to_fjson(*args)
|
374
|
+
end
|
375
|
+
end
|
376
|
+
|
377
|
+
module TrueClass
|
378
|
+
# Returns a FiverunsJSON string for true: 'true'.
|
379
|
+
def to_fjson(*) 'true' end
|
380
|
+
end
|
381
|
+
|
382
|
+
module FalseClass
|
383
|
+
# Returns a FiverunsJSON string for false: 'false'.
|
384
|
+
def to_fjson(*) 'false' end
|
385
|
+
end
|
386
|
+
|
387
|
+
module NilClass
|
388
|
+
# Returns a FiverunsJSON string for nil: 'null'.
|
389
|
+
def to_fjson(*) 'null' end
|
390
|
+
end
|
391
|
+
end
|
392
|
+
end
|
393
|
+
end
|
394
|
+
end
|
@@ -0,0 +1,71 @@
|
|
1
|
+
|
2
|
+
module Fiveruns::JSON
|
3
|
+
begin
|
4
|
+
require 'iconv'
|
5
|
+
# An iconv instance to convert from UTF8 to UTF16 Big Endian.
|
6
|
+
UTF16toUTF8 = Iconv.new('utf-8', 'utf-16be') # :nodoc:
|
7
|
+
# An iconv instance to convert from UTF16 Big Endian to UTF8.
|
8
|
+
UTF8toUTF16 = Iconv.new('utf-16be', 'utf-8') # :nodoc:
|
9
|
+
UTF8toUTF16.iconv('no bom')
|
10
|
+
rescue Errno::EINVAL, Iconv::InvalidEncoding
|
11
|
+
# Iconv doesn't support big endian utf-16. Let's try to hack this manually
|
12
|
+
# into the converters.
|
13
|
+
begin
|
14
|
+
old_verbose, $VERBSOSE = $VERBOSE, nil
|
15
|
+
# An iconv instance to convert from UTF8 to UTF16 Big Endian.
|
16
|
+
UTF16toUTF8 = Iconv.new('utf-8', 'utf-16') # :nodoc:
|
17
|
+
# An iconv instance to convert from UTF16 Big Endian to UTF8.
|
18
|
+
UTF8toUTF16 = Iconv.new('utf-16', 'utf-8') # :nodoc:
|
19
|
+
UTF8toUTF16.iconv('no bom')
|
20
|
+
if UTF8toUTF16.iconv("\xe2\x82\xac") == "\xac\x20"
|
21
|
+
swapper = Class.new do
|
22
|
+
def initialize(iconv) # :nodoc:
|
23
|
+
@iconv = iconv
|
24
|
+
end
|
25
|
+
|
26
|
+
def iconv(string) # :nodoc:
|
27
|
+
result = @iconv.iconv(string)
|
28
|
+
::Fiveruns::JSON.swap!(result)
|
29
|
+
end
|
30
|
+
end
|
31
|
+
UTF8toUTF16 = swapper.new(UTF8toUTF16) # :nodoc:
|
32
|
+
end
|
33
|
+
if UTF16toUTF8.iconv("\xac\x20") == "\xe2\x82\xac"
|
34
|
+
swapper = Class.new do
|
35
|
+
def initialize(iconv) # :nodoc:
|
36
|
+
@iconv = iconv
|
37
|
+
end
|
38
|
+
|
39
|
+
def iconv(string) # :nodoc:
|
40
|
+
string = ::Fiveruns::JSON.swap!(string.dup)
|
41
|
+
@iconv.iconv(string)
|
42
|
+
end
|
43
|
+
end
|
44
|
+
UTF16toUTF8 = swapper.new(UTF16toUTF8) # :nodoc:
|
45
|
+
end
|
46
|
+
rescue Errno::EINVAL, Iconv::InvalidEncoding
|
47
|
+
raise MissingUnicodeSupport, "iconv doesn't seem to support UTF-8/UTF-16 conversions"
|
48
|
+
ensure
|
49
|
+
$VERBOSE = old_verbose
|
50
|
+
end
|
51
|
+
rescue LoadError
|
52
|
+
raise MissingUnicodeSupport,
|
53
|
+
"iconv couldn't be loaded, which is required for UTF-8/UTF-16 conversions"
|
54
|
+
end
|
55
|
+
|
56
|
+
# Swap consecutive bytes of _string_ in place.
|
57
|
+
def self.swap!(string) # :nodoc:
|
58
|
+
0.upto(string.size / 2) do |i|
|
59
|
+
break unless string[2 * i + 1]
|
60
|
+
string[2 * i], string[2 * i + 1] = string[2 * i + 1], string[2 * i]
|
61
|
+
end
|
62
|
+
string
|
63
|
+
end
|
64
|
+
|
65
|
+
# This module holds all the modules/classes that implement FiverunsJSON's
|
66
|
+
# functionality in pure ruby.
|
67
|
+
module Pure
|
68
|
+
$DEBUG and warn "Using pure library for Fiveruns::JSON."
|
69
|
+
::Fiveruns::JSON.generator = Generator
|
70
|
+
end
|
71
|
+
end
|