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.
@@ -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