opal 0.10.6 → 0.11.0.rc1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (450) hide show
  1. checksums.yaml +5 -5
  2. data/.codeclimate.yml +19 -0
  3. data/.gitmodules +1 -1
  4. data/.jshintrc +1 -2
  5. data/.travis.yml +26 -18
  6. data/CHANGELOG.md +89 -23
  7. data/{CODE_OF_CONDUCT.md → CONDUCT.md} +0 -0
  8. data/Gemfile +19 -21
  9. data/HACKING.md +2 -0
  10. data/README.md +7 -6
  11. data/Rakefile +1 -1
  12. data/appveyor.yml +21 -4
  13. data/benchmark-ips/bm_case.rb +33 -0
  14. data/benchmark-ips/bm_constants_lookup.rb +13 -0
  15. data/benchmark-ips/bm_is_number.rb +29 -0
  16. data/benchmark-ips/bm_symbol_to_proc.rb +19 -0
  17. data/benchmark/bm_constant_lookup_big.rb +799 -0
  18. data/benchmark/bm_constant_lookup_small.rb +59 -0
  19. data/benchmark/bm_module_definition_big.rb +400 -0
  20. data/benchmark/bm_module_definition_small.rb +30 -0
  21. data/bin/opal-repl +23 -1
  22. data/docs/compiled_ruby.md +16 -14
  23. data/docs/faq.md +3 -3
  24. data/docs/rspec.md +2 -1
  25. data/docs/unsupported_features.md +6 -4
  26. data/examples/rack/Gemfile +1 -0
  27. data/examples/rack/app/application.rb +14 -3
  28. data/examples/rack/app/user.rb +2 -0
  29. data/examples/rack/config.ru +1 -1
  30. data/examples/rack/index.html.erb +1 -0
  31. data/lib/opal.rb +6 -1
  32. data/lib/opal/ast/builder.rb +17 -0
  33. data/lib/opal/ast/node.rb +30 -0
  34. data/lib/opal/builder.rb +14 -3
  35. data/lib/opal/builder_processors.rb +1 -0
  36. data/lib/opal/cli.rb +45 -59
  37. data/lib/opal/cli_options.rb +11 -7
  38. data/lib/opal/cli_runners.rb +1 -0
  39. data/lib/opal/cli_runners/applescript.rb +3 -3
  40. data/lib/opal/cli_runners/nashorn.rb +1 -0
  41. data/lib/opal/cli_runners/nodejs.rb +4 -1
  42. data/lib/opal/cli_runners/phantom.js +1 -2
  43. data/lib/opal/cli_runners/phantomjs.rb +3 -2
  44. data/lib/opal/cli_runners/server.rb +1 -0
  45. data/lib/opal/compiler.rb +145 -94
  46. data/lib/opal/config.rb +1 -0
  47. data/lib/opal/deprecations.rb +18 -0
  48. data/lib/opal/erb.rb +1 -0
  49. data/lib/opal/errors.rb +1 -0
  50. data/lib/opal/fragment.rb +1 -0
  51. data/lib/opal/hike_path_finder.rb +1 -0
  52. data/lib/opal/nodes.rb +3 -0
  53. data/lib/opal/nodes/arglist.rb +2 -1
  54. data/lib/opal/nodes/args/initialize_kwargs.rb +1 -0
  55. data/lib/opal/nodes/args/kwarg.rb +7 -7
  56. data/lib/opal/nodes/args/kwoptarg.rb +6 -7
  57. data/lib/opal/nodes/args/kwrestarg.rb +5 -5
  58. data/lib/opal/nodes/args/mlhsarg.rb +3 -2
  59. data/lib/opal/nodes/args/normarg.rb +6 -7
  60. data/lib/opal/nodes/args/optarg.rb +5 -7
  61. data/lib/opal/nodes/args/post_args.rb +6 -5
  62. data/lib/opal/nodes/args/post_kwargs.rb +1 -0
  63. data/lib/opal/nodes/args/restarg.rb +7 -7
  64. data/lib/opal/nodes/array.rb +1 -0
  65. data/lib/opal/nodes/base.rb +24 -3
  66. data/lib/opal/nodes/call.rb +167 -155
  67. data/lib/opal/nodes/call_special.rb +31 -217
  68. data/lib/opal/nodes/case.rb +36 -22
  69. data/lib/opal/nodes/class.rb +4 -3
  70. data/lib/opal/nodes/constants.rb +28 -48
  71. data/lib/opal/nodes/csend.rb +25 -0
  72. data/lib/opal/nodes/def.rb +49 -16
  73. data/lib/opal/nodes/defined.rb +170 -60
  74. data/lib/opal/nodes/definitions.rb +40 -133
  75. data/lib/opal/nodes/defs.rb +29 -0
  76. data/lib/opal/nodes/for.rb +52 -25
  77. data/lib/opal/nodes/hash.rb +12 -35
  78. data/lib/opal/nodes/helpers.rb +27 -54
  79. data/lib/opal/nodes/if.rb +21 -32
  80. data/lib/opal/nodes/inline_args.rb +12 -13
  81. data/lib/opal/nodes/iter.rb +61 -36
  82. data/lib/opal/nodes/literal.rb +189 -116
  83. data/lib/opal/nodes/logic.rb +20 -25
  84. data/lib/opal/nodes/masgn.rb +20 -18
  85. data/lib/opal/nodes/module.rb +10 -11
  86. data/lib/opal/nodes/node_with_args.rb +14 -17
  87. data/lib/opal/nodes/rescue.rb +37 -70
  88. data/lib/opal/nodes/runtime_helpers.rb +8 -3
  89. data/lib/opal/nodes/scope.rb +9 -5
  90. data/lib/opal/nodes/singleton_class.rb +4 -3
  91. data/lib/opal/nodes/super.rb +115 -87
  92. data/lib/opal/nodes/top.rb +7 -2
  93. data/lib/opal/nodes/variables.rb +46 -35
  94. data/lib/opal/nodes/while.rb +11 -1
  95. data/lib/opal/nodes/yield.rb +1 -17
  96. data/lib/opal/parser.rb +28 -770
  97. data/lib/opal/path_reader.rb +5 -1
  98. data/lib/opal/paths.rb +10 -4
  99. data/lib/opal/regexp_anchors.rb +1 -0
  100. data/lib/opal/rewriter.rb +60 -0
  101. data/lib/opal/rewriters/base.rb +60 -0
  102. data/lib/opal/rewriters/binary_operator_assignment.rb +144 -0
  103. data/lib/opal/rewriters/block_to_iter.rb +17 -0
  104. data/lib/opal/rewriters/break_finder.rb +34 -0
  105. data/lib/opal/rewriters/dot_js_syntax.rb +60 -0
  106. data/lib/opal/rewriters/explicit_writer_return.rb +58 -0
  107. data/lib/opal/rewriters/js_reserved_words.rb +111 -0
  108. data/lib/opal/rewriters/logical_operator_assignment.rb +155 -0
  109. data/lib/opal/rewriters/opal_engine_check.rb +42 -0
  110. data/lib/opal/rewriters/rubyspec/filters_rewriter.rb +67 -0
  111. data/lib/opal/server.rb +4 -0
  112. data/lib/opal/simple_server.rb +100 -0
  113. data/lib/opal/source_map.rb +1 -1
  114. data/lib/opal/util.rb +5 -5
  115. data/lib/opal/version.rb +2 -1
  116. data/lib/tilt/opal.rb +1 -0
  117. data/opal.gemspec +8 -7
  118. data/opal/README.md +1 -1
  119. data/opal/corelib/array.rb +137 -83
  120. data/opal/corelib/basic_object.rb +6 -6
  121. data/opal/corelib/class.rb +14 -11
  122. data/opal/corelib/complex.rb +5 -1
  123. data/opal/corelib/constants.rb +3 -3
  124. data/opal/corelib/enumerable.rb +129 -11
  125. data/opal/corelib/error.rb +35 -17
  126. data/opal/corelib/file.rb +65 -170
  127. data/opal/corelib/hash.rb +128 -13
  128. data/opal/corelib/helpers.rb +12 -15
  129. data/opal/corelib/io.rb +1 -0
  130. data/opal/corelib/kernel.rb +40 -21
  131. data/opal/corelib/marshal/read_buffer.rb +1 -1
  132. data/opal/corelib/method.rb +33 -13
  133. data/opal/corelib/module.rb +133 -81
  134. data/opal/corelib/number.rb +141 -25
  135. data/opal/corelib/numeric.rb +0 -8
  136. data/opal/corelib/process.rb +44 -4
  137. data/opal/corelib/random.rb +117 -0
  138. data/opal/corelib/random/seedrandom.js.rb +15 -0
  139. data/opal/corelib/range.rb +133 -10
  140. data/opal/corelib/regexp.rb +37 -9
  141. data/opal/corelib/runtime.js +601 -390
  142. data/opal/corelib/string.rb +39 -8
  143. data/opal/corelib/string/encoding.rb +51 -7
  144. data/opal/corelib/struct.rb +20 -0
  145. data/opal/corelib/time.rb +3 -3
  146. data/opal/corelib/variables.rb +1 -1
  147. data/opal/opal.rb +1 -0
  148. data/spec/filters/bugs/array.rb +5 -1
  149. data/spec/filters/bugs/basicobject.rb +2 -5
  150. data/spec/filters/bugs/bigdecimal.rb +8 -22
  151. data/spec/filters/bugs/class.rb +2 -1
  152. data/spec/filters/bugs/comparable.rb +5 -0
  153. data/spec/filters/bugs/date.rb +3 -3
  154. data/spec/filters/bugs/enumerable.rb +4 -11
  155. data/spec/filters/bugs/enumerator.rb +2 -4
  156. data/spec/filters/bugs/exception.rb +16 -2
  157. data/spec/filters/bugs/file.rb +8 -0
  158. data/spec/filters/bugs/float.rb +7 -1
  159. data/spec/filters/bugs/hash.rb +6 -2
  160. data/spec/filters/bugs/integer.rb +2 -0
  161. data/spec/filters/bugs/io.rb +8 -0
  162. data/spec/filters/bugs/kernel.rb +9 -138
  163. data/spec/filters/bugs/language.rb +89 -174
  164. data/spec/filters/bugs/marshal.rb +33 -35
  165. data/spec/filters/bugs/method.rb +0 -24
  166. data/spec/filters/bugs/module.rb +19 -55
  167. data/spec/filters/bugs/numeric.rb +0 -119
  168. data/spec/filters/bugs/pathname.rb +2 -0
  169. data/spec/filters/bugs/proc.rb +5 -4
  170. data/spec/filters/bugs/random.rb +7 -0
  171. data/spec/filters/bugs/range.rb +12 -120
  172. data/spec/filters/bugs/rational.rb +1 -1
  173. data/spec/filters/bugs/regexp.rb +2 -40
  174. data/spec/filters/bugs/set.rb +0 -1
  175. data/spec/filters/bugs/string.rb +5 -8
  176. data/spec/filters/bugs/stringscanner.rb +11 -19
  177. data/spec/filters/bugs/time.rb +7 -1
  178. data/spec/filters/bugs/unboundmethod.rb +1 -11
  179. data/spec/filters/unsupported/array.rb +5 -1
  180. data/spec/filters/unsupported/basicobject.rb +1 -1
  181. data/spec/filters/unsupported/bignum.rb +4 -1
  182. data/spec/filters/unsupported/class.rb +1 -1
  183. data/spec/filters/unsupported/delegator.rb +1 -1
  184. data/spec/filters/unsupported/enumerable.rb +1 -1
  185. data/spec/filters/unsupported/enumerator.rb +1 -1
  186. data/spec/filters/unsupported/file.rb +4 -0
  187. data/spec/filters/unsupported/fixnum.rb +1 -1
  188. data/spec/filters/unsupported/float.rb +4 -1
  189. data/spec/filters/unsupported/freeze.rb +27 -5
  190. data/spec/filters/unsupported/hash.rb +7 -15
  191. data/spec/filters/unsupported/integer.rb +1 -1
  192. data/spec/filters/unsupported/kernel.rb +2 -1
  193. data/spec/filters/unsupported/language.rb +6 -1
  194. data/spec/filters/unsupported/marshal.rb +1 -1
  195. data/spec/filters/unsupported/matchdata.rb +4 -1
  196. data/spec/filters/unsupported/math.rb +1 -1
  197. data/spec/filters/unsupported/pathname.rb +1 -1
  198. data/spec/filters/unsupported/privacy.rb +141 -9
  199. data/spec/filters/unsupported/proc.rb +1 -1
  200. data/spec/filters/unsupported/random.rb +4 -0
  201. data/spec/filters/unsupported/range.rb +7 -0
  202. data/spec/filters/unsupported/regexp.rb +25 -15
  203. data/spec/filters/unsupported/set.rb +1 -1
  204. data/spec/filters/unsupported/singleton.rb +1 -1
  205. data/spec/filters/unsupported/string.rb +110 -101
  206. data/spec/filters/unsupported/struct.rb +1 -1
  207. data/spec/filters/unsupported/symbol.rb +2 -1
  208. data/spec/filters/unsupported/taint.rb +22 -7
  209. data/spec/filters/unsupported/thread.rb +1 -1
  210. data/spec/filters/unsupported/time.rb +1 -1
  211. data/spec/lib/builder_spec.rb +17 -0
  212. data/spec/lib/cli_spec.rb +37 -8
  213. data/spec/lib/compiler/call_spec.rb +98 -66
  214. data/spec/lib/compiler_spec.rb +39 -30
  215. data/spec/lib/dependency_resolver_spec.rb +2 -2
  216. data/spec/lib/deprecations_spec.rb +16 -0
  217. data/spec/lib/fixtures/source_location_test.rb +7 -0
  218. data/spec/lib/rewriters/binary_operator_assignment_spec.rb +151 -0
  219. data/spec/lib/rewriters/block_to_iter_spec.rb +28 -0
  220. data/spec/lib/rewriters/dot_js_syntax_spec.rb +108 -0
  221. data/spec/lib/rewriters/explicit_writer_return_spec.rb +186 -0
  222. data/spec/lib/rewriters/js_reserved_words_spec.rb +116 -0
  223. data/spec/lib/rewriters/logical_operator_assignment_spec.rb +202 -0
  224. data/spec/lib/rewriters/opal_engine_check_spec.rb +82 -0
  225. data/spec/lib/rewriters/rubyspec/filters_rewriter_spec.rb +53 -0
  226. data/spec/lib/simple_server_spec.rb +54 -0
  227. data/spec/mspec-opal/formatters.rb +65 -17
  228. data/spec/mspec-opal/runner.rb +47 -67
  229. data/spec/opal/core/date_spec.rb +14 -0
  230. data/spec/opal/core/exception_spec.rb +10 -0
  231. data/spec/opal/core/hash/internals_spec.rb +10 -10
  232. data/spec/opal/core/kernel/rand_spec.rb +0 -4
  233. data/spec/opal/core/kernel/respond_to_spec.rb +5 -2
  234. data/spec/opal/core/language/constant_lookup_spec.rb +38 -0
  235. data/spec/opal/core/language/predefined_spec.rb +1 -1
  236. data/spec/opal/core/language/safe_navigator_spec.rb +7 -0
  237. data/spec/opal/core/language/send_spec.rb +1 -9
  238. data/spec/opal/core/language/string_spec.rb +8 -8
  239. data/spec/opal/core/language/versions/def_2_0_spec.rb +0 -4
  240. data/spec/opal/core/language_spec.rb +32 -0
  241. data/spec/opal/core/module/const_get_spec.rb +1 -1
  242. data/spec/opal/core/runtime/is_a_spec.rb +36 -0
  243. data/spec/opal/core/runtime/rescue_spec.rb +35 -0
  244. data/spec/opal/core/runtime_spec.rb +4 -4
  245. data/spec/opal/core/string_spec.rb +8 -8
  246. data/spec/opal/core/time_spec.rb +26 -17
  247. data/spec/opal/stdlib/erb/quoted.opalerb +1 -1
  248. data/spec/opal/stdlib/json/parse_spec.rb +4 -0
  249. data/spec/opal/stdlib/native/hash_spec.rb +16 -0
  250. data/spec/ruby_specs +2 -1
  251. data/spec/spec_helper.rb +1 -0
  252. data/spec/support/rewriters_helper.rb +24 -0
  253. data/stdlib/base64.rb +4 -2
  254. data/stdlib/bigdecimal/bignumber.js.rb +1 -1
  255. data/stdlib/date.rb +18 -19
  256. data/stdlib/json.rb +16 -4
  257. data/stdlib/nashorn/file.rb +15 -0
  258. data/stdlib/native.rb +21 -12
  259. data/stdlib/nodejs/dir.rb +1 -1
  260. data/stdlib/nodejs/file.rb +49 -20
  261. data/stdlib/nodejs/io.rb +22 -1
  262. data/stdlib/nodejs/{node_modules/js-yaml/dist/js-yaml.js → js-yaml-3-6-1.js} +815 -626
  263. data/stdlib/nodejs/kernel.rb +3 -1
  264. data/stdlib/nodejs/package.json +0 -1
  265. data/stdlib/nodejs/stacktrace.rb +163 -0
  266. data/stdlib/nodejs/yaml.rb +2 -1
  267. data/stdlib/opal-platform.rb +15 -0
  268. data/stdlib/opal/platform.rb +5 -13
  269. data/stdlib/pathname.rb +1 -1
  270. data/stdlib/strscan.rb +15 -1
  271. data/stdlib/yaml.rb +1 -1
  272. data/tasks/benchmarking.rake +9 -0
  273. data/tasks/building.rake +24 -20
  274. data/tasks/linting.rake +24 -13
  275. data/tasks/testing.rake +322 -205
  276. data/tasks/testing/mspec_special_calls.rb +44 -15
  277. data/tasks/testing/opal_rspec_smoketest.Gemfile +13 -0
  278. data/test/nodejs/fixtures/hello.rb +1 -0
  279. data/test/nodejs/test_file.rb +57 -0
  280. data/test/nodejs/test_io.rb +18 -0
  281. data/test/nodejs/test_opal_builder.rb +12 -0
  282. data/test/opal/unsupported_and_bugs.rb +9 -0
  283. metadata +127 -240
  284. data/lib/opal/parser/grammar.rb +0 -6157
  285. data/lib/opal/parser/grammar.y +0 -2011
  286. data/lib/opal/parser/keywords.rb +0 -66
  287. data/lib/opal/parser/lexer.rb +0 -1352
  288. data/lib/opal/parser/parser_scope.rb +0 -28
  289. data/lib/opal/parser/sexp.rb +0 -90
  290. data/lib/opal/sprockets.rb +0 -77
  291. data/lib/opal/sprockets/environment.rb +0 -23
  292. data/lib/opal/sprockets/erb.rb +0 -28
  293. data/lib/opal/sprockets/path_reader.rb +0 -36
  294. data/lib/opal/sprockets/processor.rb +0 -173
  295. data/lib/opal/sprockets/server.rb +0 -133
  296. data/lib/opal/sprockets/source_map_header_patch.rb +0 -41
  297. data/lib/opal/sprockets/source_map_server.rb +0 -117
  298. data/spec/filters/bugs/compiler_opal.rb +0 -5
  299. data/spec/filters/bugs/language_opal.rb +0 -88
  300. data/spec/filters/unsupported/module.rb +0 -8
  301. data/spec/lib/compiler/pre_processed_conditionals_spec.rb +0 -87
  302. data/spec/lib/lexer_spec.rb +0 -110
  303. data/spec/lib/parser/alias_spec.rb +0 -26
  304. data/spec/lib/parser/and_spec.rb +0 -13
  305. data/spec/lib/parser/aref_spec.rb +0 -10
  306. data/spec/lib/parser/attrasgn_spec.rb +0 -28
  307. data/spec/lib/parser/begin_spec.rb +0 -42
  308. data/spec/lib/parser/block_spec.rb +0 -12
  309. data/spec/lib/parser/break_spec.rb +0 -17
  310. data/spec/lib/parser/call_spec.rb +0 -201
  311. data/spec/lib/parser/class_spec.rb +0 -35
  312. data/spec/lib/parser/comments_spec.rb +0 -11
  313. data/spec/lib/parser/def_spec.rb +0 -109
  314. data/spec/lib/parser/if_spec.rb +0 -26
  315. data/spec/lib/parser/iter_spec.rb +0 -59
  316. data/spec/lib/parser/lambda_spec.rb +0 -219
  317. data/spec/lib/parser/literal_spec.rb +0 -118
  318. data/spec/lib/parser/masgn_spec.rb +0 -37
  319. data/spec/lib/parser/module_spec.rb +0 -27
  320. data/spec/lib/parser/not_spec.rb +0 -21
  321. data/spec/lib/parser/op_asgn1_spec.rb +0 -23
  322. data/spec/lib/parser/op_asgn2_spec.rb +0 -23
  323. data/spec/lib/parser/op_asgn_spec.rb +0 -17
  324. data/spec/lib/parser/or_spec.rb +0 -13
  325. data/spec/lib/parser/return_spec.rb +0 -22
  326. data/spec/lib/parser/sclass_spec.rb +0 -21
  327. data/spec/lib/parser/string_spec.rb +0 -286
  328. data/spec/lib/parser/super_spec.rb +0 -20
  329. data/spec/lib/parser/unary_spec.rb +0 -52
  330. data/spec/lib/parser/undef_spec.rb +0 -19
  331. data/spec/lib/parser/unless_spec.rb +0 -13
  332. data/spec/lib/parser/variables_spec.rb +0 -112
  333. data/spec/lib/parser/while_spec.rb +0 -15
  334. data/spec/lib/parser/yield_spec.rb +0 -20
  335. data/spec/lib/sprockets/erb_spec.rb +0 -38
  336. data/spec/lib/sprockets/path_reader_spec.rb +0 -41
  337. data/spec/lib/sprockets/processor_spec.rb +0 -79
  338. data/spec/lib/sprockets/server_spec.rb +0 -102
  339. data/spec/lib/sprockets_spec.rb +0 -39
  340. data/spec/lib/tilt/opal_spec.rb +0 -37
  341. data/spec/opal/core/language/block_spec.rb +0 -538
  342. data/spec/opal/core/language/proc_spec.rb +0 -263
  343. data/spec/opal/core/language/variables_spec.rb +0 -1366
  344. data/spec/opal/core/runtime/block_send_spec.rb +0 -28
  345. data/spec/opal/core/runtime/send_spec.rb +0 -34
  346. data/spec/support/parser_helpers.rb +0 -37
  347. data/stdlib/nodejs/node_modules/js-yaml/HISTORY.md +0 -277
  348. data/stdlib/nodejs/node_modules/js-yaml/LICENSE +0 -21
  349. data/stdlib/nodejs/node_modules/js-yaml/README.md +0 -288
  350. data/stdlib/nodejs/node_modules/js-yaml/bin/js-yaml.js +0 -140
  351. data/stdlib/nodejs/node_modules/js-yaml/bower.json +0 -23
  352. data/stdlib/nodejs/node_modules/js-yaml/dist/js-yaml.min.js +0 -3
  353. data/stdlib/nodejs/node_modules/js-yaml/examples/custom_types.js +0 -102
  354. data/stdlib/nodejs/node_modules/js-yaml/examples/custom_types.yml +0 -18
  355. data/stdlib/nodejs/node_modules/js-yaml/examples/dumper.js +0 -31
  356. data/stdlib/nodejs/node_modules/js-yaml/examples/dumper.json +0 -22
  357. data/stdlib/nodejs/node_modules/js-yaml/examples/sample_document.js +0 -18
  358. data/stdlib/nodejs/node_modules/js-yaml/examples/sample_document.yml +0 -197
  359. data/stdlib/nodejs/node_modules/js-yaml/index.js +0 -7
  360. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml.js +0 -39
  361. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/common.js +0 -62
  362. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/dumper.js +0 -554
  363. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/exception.js +0 -25
  364. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/loader.js +0 -1581
  365. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/mark.js +0 -78
  366. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/schema.js +0 -103
  367. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/schema/core.js +0 -18
  368. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/schema/default_full.js +0 -25
  369. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/schema/default_safe.js +0 -28
  370. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/schema/failsafe.js +0 -17
  371. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/schema/json.js +0 -25
  372. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/type.js +0 -61
  373. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/type/binary.js +0 -133
  374. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/type/bool.js +0 -37
  375. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/type/float.js +0 -110
  376. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/type/int.js +0 -183
  377. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/type/js/function.js +0 -85
  378. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/type/js/regexp.js +0 -84
  379. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/type/js/undefined.js +0 -27
  380. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/type/map.js +0 -8
  381. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/type/merge.js +0 -12
  382. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/type/null.js +0 -36
  383. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/type/omap.js +0 -56
  384. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/type/pairs.js +0 -61
  385. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/type/seq.js +0 -8
  386. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/type/set.js +0 -33
  387. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/type/str.js +0 -8
  388. data/stdlib/nodejs/node_modules/js-yaml/lib/js-yaml/type/timestamp.js +0 -98
  389. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/HISTORY.md +0 -115
  390. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/LICENSE +0 -21
  391. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/README.md +0 -239
  392. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/examples/arguments.js +0 -36
  393. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/examples/choice.js +0 -22
  394. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/examples/constants.js +0 -59
  395. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/examples/help.js +0 -13
  396. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/examples/nargs.js +0 -33
  397. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/examples/parents.js +0 -28
  398. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/examples/prefix_chars.js +0 -23
  399. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/examples/sub_commands.js +0 -49
  400. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/examples/sum.js +0 -35
  401. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/examples/testformatters.js +0 -270
  402. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/index.js +0 -1
  403. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/action.js +0 -146
  404. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/action/append.js +0 -55
  405. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/action/append/constant.js +0 -47
  406. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/action/count.js +0 -40
  407. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/action/help.js +0 -48
  408. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/action/store.js +0 -50
  409. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/action/store/constant.js +0 -43
  410. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/action/store/false.js +0 -27
  411. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/action/store/true.js +0 -26
  412. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/action/subparsers.js +0 -148
  413. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/action/version.js +0 -50
  414. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/action_container.js +0 -481
  415. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/argparse.js +0 -14
  416. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/argument/error.js +0 -50
  417. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/argument/exclusive.js +0 -54
  418. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/argument/group.js +0 -75
  419. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/argument_parser.js +0 -1168
  420. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/const.js +0 -18
  421. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/help/added_formatters.js +0 -88
  422. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/help/formatter.js +0 -798
  423. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/lib/namespace.js +0 -77
  424. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/node_modules/underscore.string/.npmignore +0 -2
  425. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/node_modules/underscore.string/.travis.yml +0 -8
  426. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/node_modules/underscore.string/README.markdown +0 -825
  427. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/node_modules/underscore.string/bower.json +0 -33
  428. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/node_modules/underscore.string/component.json +0 -11
  429. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/node_modules/underscore.string/foo.js +0 -10
  430. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/node_modules/underscore.string/gulpfile.js +0 -26
  431. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/node_modules/underscore.string/lib/underscore.string.js +0 -673
  432. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/node_modules/underscore.string/libpeerconnection.log +0 -0
  433. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/node_modules/underscore.string/package.json +0 -107
  434. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/node_modules/underscore/LICENSE +0 -23
  435. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/node_modules/underscore/README.md +0 -22
  436. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/node_modules/underscore/package.json +0 -69
  437. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/node_modules/underscore/underscore-min.js +0 -6
  438. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/node_modules/underscore/underscore.js +0 -1415
  439. data/stdlib/nodejs/node_modules/js-yaml/node_modules/argparse/package.json +0 -62
  440. data/stdlib/nodejs/node_modules/js-yaml/node_modules/esprima/README.md +0 -73
  441. data/stdlib/nodejs/node_modules/js-yaml/node_modules/esprima/bin/esparse.js +0 -117
  442. data/stdlib/nodejs/node_modules/js-yaml/node_modules/esprima/bin/esvalidate.js +0 -177
  443. data/stdlib/nodejs/node_modules/js-yaml/node_modules/esprima/esprima.js +0 -3908
  444. data/stdlib/nodejs/node_modules/js-yaml/node_modules/esprima/package.json +0 -69
  445. data/stdlib/nodejs/node_modules/js-yaml/node_modules/esprima/test/compat.js +0 -239
  446. data/stdlib/nodejs/node_modules/js-yaml/node_modules/esprima/test/reflect.js +0 -422
  447. data/stdlib/nodejs/node_modules/js-yaml/node_modules/esprima/test/run.js +0 -66
  448. data/stdlib/nodejs/node_modules/js-yaml/node_modules/esprima/test/runner.js +0 -387
  449. data/stdlib/nodejs/node_modules/js-yaml/node_modules/esprima/test/test.js +0 -20238
  450. data/stdlib/nodejs/node_modules/js-yaml/package.json +0 -83
@@ -1,28 +0,0 @@
1
- require 'spec_helper'
2
-
3
- class RuntimeOpalBlockSendSpec
4
- def simple
5
- 42
6
- end
7
-
8
- def yielder(&block)
9
- yield 3.142
10
- end
11
- end
12
-
13
- describe "Opal.block_send()" do
14
- before do
15
- @obj = RuntimeOpalBlockSendSpec.new
16
- end
17
-
18
- it "calls receiver with given method" do
19
- `Opal.block_send(#{@obj}, 'simple')`.should == 42
20
- end
21
-
22
- it "calls method with given block" do
23
- val = nil
24
- p = proc { |a| val = a }
25
- `Opal.block_send(#{@obj}, 'yielder', p)`
26
- val.should == 3.142
27
- end
28
- end
@@ -1,34 +0,0 @@
1
- class RuntimeOpalSendSpec
2
- def simple
3
- 42
4
- end
5
-
6
- def args *a
7
- a
8
- end
9
-
10
- def method_missing sym, *args
11
- [sym, args]
12
- end
13
- end
14
-
15
-
16
- describe "Opal.send()" do
17
- before do
18
- @obj = RuntimeOpalSendSpec.new
19
- end
20
-
21
- it "calls receiver with given method" do
22
- `Opal.send(#{@obj}, "simple")`.should == 42
23
- end
24
-
25
- it "sends any arguments to the method" do
26
- `Opal.send(#{@obj}, "args", 1, 2, 3)`.should == [1, 2, 3]
27
- end
28
-
29
- it "calls method_missing on the object if method doesnt exist" do
30
- `Opal.send(#{@obj}, "blah")`.should == [:blah, []]
31
- `Opal.send(#{@obj}, "bleh", 1)`.should == [:bleh, [1]]
32
- `Opal.send(#{@obj}, "blih", 1, 2)`.should == [:blih, [1, 2]]
33
- end
34
- end
@@ -1,37 +0,0 @@
1
- require 'opal/parser'
2
-
3
- module ParserHelpers
4
- def parsed(source, file='(ParserHelpers:string)')
5
- Opal::Parser.new.parse(source, file)
6
- end
7
-
8
- def expect_parsed(source)
9
- expect(parsed(source))
10
- end
11
-
12
- def expect_parsed_string(source)
13
- expect(parsed(source)[1])
14
- end
15
-
16
- def expect_lines(source)
17
- expect(parsed_nodes(source).map { |sexp| sexp.line })
18
- end
19
-
20
- def expect_columns(source)
21
- expect(parsed_nodes(source).map { |sexp| sexp.column })
22
- end
23
-
24
- def parsed_nodes(source)
25
- parsed = Opal::Parser.new.parse(source)
26
- parsed.type == :block ? parsed.children : [parsed]
27
- end
28
- end
29
-
30
- if defined? RSpec
31
- RSpec.configure do |config|
32
- config.include ParserHelpers
33
- end
34
- else
35
- include ParserHelpers
36
- end
37
-
@@ -1,277 +0,0 @@
1
- 3.2.6 / 2015-02-07
2
- ------------------
3
-
4
- - Fixed encoding of UTF-16 surrogate pairs. (e.g. "\U0001F431" CAT FACE)
5
- - Fixed demo dates dump (#113, thanks to @Hypercubed).
6
-
7
-
8
- 3.2.5 / 2014-12-28
9
- ------------------
10
-
11
- - Fixed resolving of all built-in types on empty nodes.
12
- - Fixed invalid warning on empty lines within quoted scalars and flow collections.
13
- - Fixed bug: Tag on an empty node didn't resolve in some cases.
14
-
15
-
16
- 3.2.4 / 2014-12-19
17
- ------------------
18
-
19
- - Fixed resolving of !!null tag on an empty node.
20
-
21
-
22
- 3.2.3 / 2014-11-08
23
- ------------------
24
-
25
- - Implemented dumping of objects with circular and cross references.
26
- - Partially fixed aliasing of constructed objects. (see issue #141 for details)
27
-
28
-
29
- 3.2.2 / 2014-09-07
30
- ------------------
31
-
32
- - Fixed infinite loop on unindented block scalars.
33
- - Rewritten base64 encode/decode in binary type, to keep code licence clear.
34
-
35
-
36
- 3.2.1 / 2014-08-24
37
- ------------------
38
-
39
- - Nothig new. Just fix npm publish error.
40
-
41
-
42
- 3.2.0 / 2014-08-24
43
- ------------------
44
-
45
- - Added input piping support to CLI.
46
- - Fixed typo, that could cause hand on initial indent (#139).
47
-
48
-
49
- 3.1.0 / 2014-07-07
50
- ------------------
51
-
52
- - 1.5x-2x speed boost.
53
- - Removed deprecated `require('xxx.yml')` support.
54
- - Significant code cleanup and refactoring.
55
- - Internal API changed. If you used custom types - see updated examples.
56
- Others are not affected.
57
- - Even if the input string has no trailing line break character,
58
- it will be parsed as if it has one.
59
- - Added benchmark scripts.
60
- - Moved bower files to /dist folder
61
- - Bugfixes.
62
-
63
-
64
- 3.0.2 / 2014-02-27
65
- ------------------
66
-
67
- - Fixed bug: "constructor" string parsed as `null`.
68
-
69
-
70
- 3.0.1 / 2013-12-22
71
- ------------------
72
-
73
- - Fixed parsing of literal scalars. (issue #108)
74
- - Prevented adding unnecessary spaces in object dumps. (issue #68)
75
- - Fixed dumping of objects with very long (> 1024 in length) keys.
76
-
77
-
78
- 3.0.0 / 2013-12-16
79
- ------------------
80
-
81
- - Refactored code. Changed API for custom types.
82
- - Removed output colors in CLI, dump json by default.
83
- - Removed big dependencies from browser version (esprima, buffer)
84
- - load `esprima` manually, if !!js/function needed
85
- - !!bin now returns Array in browser
86
- - AMD support.
87
- - Don't quote dumped strings because of `-` & `?` (if not first char).
88
- - __Deprecated__ loading yaml files via `require()`, as not recommended
89
- behaviour for node.
90
-
91
-
92
- 2.1.3 / 2013-10-16
93
- ------------------
94
-
95
- - Fix wrong loading of empty block scalars.
96
-
97
-
98
- 2.1.2 / 2013-10-07
99
- ------------------
100
-
101
- - Fix unwanted line breaks in folded scalars.
102
-
103
-
104
- 2.1.1 / 2013-10-02
105
- ------------------
106
-
107
- - Dumper now respects deprecated booleans syntax from YAML 1.0/1.1
108
- - Fixed reader bug in JSON-like sequences/mappings.
109
-
110
-
111
- 2.1.0 / 2013-06-05
112
- ------------------
113
-
114
- - Add standard YAML schemas: Failsafe (`FAILSAFE_SCHEMA`),
115
- JSON (`JSON_SCHEMA`) and Core (`CORE_SCHEMA`).
116
- - Rename `DEFAULT_SCHEMA` to `DEFAULT_FULL_SCHEMA`
117
- and `SAFE_SCHEMA` to `DEFAULT_SAFE_SCHEMA`.
118
- - Bug fix: export `NIL` constant from the public interface.
119
- - Add `skipInvalid` dumper option.
120
- - Use `safeLoad` for `require` extension.
121
-
122
-
123
- 2.0.5 / 2013-04-26
124
- ------------------
125
-
126
- - Close security issue in !!js/function constructor.
127
- Big thanks to @nealpoole for security audit.
128
-
129
-
130
- 2.0.4 / 2013-04-08
131
- ------------------
132
-
133
- - Updated .npmignore to reduce package size
134
-
135
-
136
- 2.0.3 / 2013-02-26
137
- ------------------
138
-
139
- - Fixed dumping of empty arrays ans objects. ([] and {} instead of null)
140
-
141
-
142
- 2.0.2 / 2013-02-15
143
- ------------------
144
-
145
- - Fixed input validation: tabs are printable characters.
146
-
147
-
148
- 2.0.1 / 2013-02-09
149
- ------------------
150
-
151
- - Fixed error, when options not passed to function cass
152
-
153
-
154
- 2.0.0 / 2013-02-09
155
- ------------------
156
-
157
- - Full rewrite. New architecture. Fast one-stage parsing.
158
- - Changed custom types API.
159
- - Added YAML dumper.
160
-
161
-
162
- 1.0.3 / 2012-11-05
163
- ------------------
164
-
165
- - Fixed utf-8 files loading.
166
-
167
-
168
- 1.0.2 / 2012-08-02
169
- ------------------
170
-
171
- - Pull out hand-written shims. Use ES5-Shims for old browsers support. See #44.
172
- - Fix timstamps incorectly parsed in local time when no time part specified.
173
-
174
-
175
- 1.0.1 / 2012-07-07
176
- ------------------
177
-
178
- - Fixes `TypeError: 'undefined' is not an object` under Safari. Thanks Phuong.
179
- - Fix timestamps incorrectly parsed in local time. Thanks @caolan. Closes #46.
180
-
181
-
182
- 1.0.0 / 2012-07-01
183
- ------------------
184
-
185
- - `y`, `yes`, `n`, `no`, `on`, `off` are not converted to Booleans anymore.
186
- Fixes #42.
187
- - `require(filename)` now returns a single document and throws an Error if
188
- file contains more than one document.
189
- - CLI was merged back from js-yaml.bin
190
-
191
-
192
- 0.3.7 / 2012-02-28
193
- ------------------
194
-
195
- - Fix export of `addConstructor()`. Closes #39.
196
-
197
-
198
- 0.3.6 / 2012-02-22
199
- ------------------
200
-
201
- - Removed AMD parts - too buggy to use. Need help to rewrite from scratch
202
- - Removed YUI compressor warning (renamed `double` variable). Closes #40.
203
-
204
-
205
- 0.3.5 / 2012-01-10
206
- ------------------
207
-
208
- - Workagound for .npmignore fuckup under windows. Thanks to airportyh.
209
-
210
-
211
- 0.3.4 / 2011-12-24
212
- ------------------
213
-
214
- - Fixes str[] for oldIEs support.
215
- - Adds better has change support for browserified demo.
216
- - improves compact output of Error. Closes #33.
217
-
218
-
219
- 0.3.3 / 2011-12-20
220
- ------------------
221
-
222
- - jsyaml executable moved to separate module.
223
- - adds `compact` stringification of Errors.
224
-
225
-
226
- 0.3.2 / 2011-12-16
227
- ------------------
228
-
229
- - Fixes ug with block style scalars. Closes #26.
230
- - All sources are passing JSLint now.
231
- - Fixes bug in Safari. Closes #28.
232
- - Fixes bug in Opers. Closes #29.
233
- - Improves browser support. Closes #20.
234
- - Added jsyaml executable.
235
- - Added !!js/function support. Closes #12.
236
-
237
-
238
- 0.3.1 / 2011-11-18
239
- ------------------
240
-
241
- - Added AMD support for browserified version.
242
- - Wrapped browserified js-yaml into closure.
243
- - Fixed the resolvement of non-specific tags. Closes #17.
244
- - Added permalinks for online demo YAML snippets. Now we have YPaste service, lol.
245
- - Added !!js/regexp and !!js/undefined types. Partially solves #12.
246
- - Fixed !!set mapping.
247
- - Fixed month parse in dates. Closes #19.
248
-
249
-
250
- 0.3.0 / 2011-11-09
251
- ------------------
252
-
253
- - Removed JS.Class dependency. Closes #3.
254
- - Added browserified version. Closes #13.
255
- - Added live demo of browserified version.
256
- - Ported some of the PyYAML tests. See #14.
257
- - Fixed timestamp bug when fraction was given.
258
-
259
-
260
- 0.2.2 / 2011-11-06
261
- ------------------
262
-
263
- - Fixed crash on docs without ---. Closes #8.
264
- - Fixed miltiline string parse
265
- - Fixed tests/comments for using array as key
266
-
267
-
268
- 0.2.1 / 2011-11-02
269
- ------------------
270
-
271
- - Fixed short file read (<4k). Closes #9.
272
-
273
-
274
- 0.2.0 / 2011-11-02
275
- ------------------
276
-
277
- - First public release
@@ -1,21 +0,0 @@
1
- (The MIT License)
2
-
3
- Copyright (C) 2011, 2013 by Vitaly Puzrin
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in
13
- all copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21
- THE SOFTWARE.
@@ -1,288 +0,0 @@
1
- JS-YAML - YAML 1.2 parser and serializer for JavaScript
2
- =======================================================
3
-
4
- [![Build Status](https://travis-ci.org/nodeca/js-yaml.svg?branch=master)](https://travis-ci.org/nodeca/js-yaml)
5
- [![NPM version](https://img.shields.io/npm/v/js-yaml.svg)](https://www.npmjs.org/package/js-yaml)
6
-
7
- [Online Demo](http://nodeca.github.com/js-yaml/)
8
-
9
-
10
- This is an implementation of [YAML](http://yaml.org/), a human friendly data
11
- serialization language. Started as [PyYAML](http://pyyaml.org/) port, it was
12
- completely rewritten from scratch. Now it's very fast, and supports 1.2 spec.
13
-
14
-
15
- Installation
16
- ------------
17
-
18
- ### YAML module for node.js
19
-
20
- ```
21
- npm install js-yaml
22
- ```
23
-
24
-
25
- ### CLI executable
26
-
27
- If you want to inspect your YAML files from CLI, install js-yaml globally:
28
-
29
- ```
30
- npm install -g js-yaml
31
- ```
32
-
33
- #### Usage
34
-
35
- ```
36
- usage: js-yaml [-h] [-v] [-c] [-t] file
37
-
38
- Positional arguments:
39
- file File with YAML document(s)
40
-
41
- Optional arguments:
42
- -h, --help Show this help message and exit.
43
- -v, --version Show program's version number and exit.
44
- -c, --compact Display errors in compact mode
45
- -t, --trace Show stack trace on error
46
- ```
47
-
48
-
49
- ### Bundled YAML library for browsers
50
-
51
- ``` html
52
- <!-- esprima required only for !!js/function -->
53
- <script src="esprima.js"></script>
54
- <script src="js-yaml.min.js"></script>
55
- <script type="text/javascript">
56
- var doc = jsyaml.load('greeting: hello\nname: world');
57
- </script>
58
- ```
59
-
60
- Browser support was done mostly for online demo. If you find any errors - feel
61
- free to send pull requests with fixes. Also note, that IE and other old browsers
62
- needs [es5-shims](https://github.com/kriskowal/es5-shim) to operate.
63
-
64
- Notes:
65
-
66
- 1. We have no resourses to support browserified version. Don't expect it to be
67
- well tested. Don't expect fast fixes if something goes wrong there.
68
- 2. `!!js/function` in browser bundle will not work by default. If you really need
69
- it - load `esprima` parser first (via amd or directly).
70
- 3. `!!bin` in browser will return `Array`, because browsers do not support
71
- node.js `Buffer` and adding Buffer shims is completely useless on practice.
72
-
73
-
74
- API
75
- ---
76
-
77
- Here we cover the most 'useful' methods. If you need advanced details (creating
78
- your own tags), see [wiki](https://github.com/nodeca/js-yaml/wiki) and
79
- [examples](https://github.com/nodeca/js-yaml/tree/master/examples) for more
80
- info.
81
-
82
- ``` javascript
83
- yaml = require('js-yaml');
84
- fs = require('fs');
85
-
86
- // Get document, or throw exception on error
87
- try {
88
- var doc = yaml.safeLoad(fs.readFileSync('/home/ixti/example.yml', 'utf8'));
89
- console.log(doc);
90
- } catch (e) {
91
- console.log(e);
92
- }
93
- ```
94
-
95
-
96
- ### safeLoad (string [ , options ])
97
-
98
- **Recommended loading way.** Parses `string` as single YAML document. Returns a JavaScript
99
- object or throws `YAMLException` on error. By default, does not support regexps,
100
- functions and undefined. This method is safe for untrusted data.
101
-
102
- options:
103
-
104
- - `filename` _(default: null)_ - string to be used as a file path in
105
- error/warning messages.
106
- - `onWarning` _(default: null)_ - function to call on warning messages.
107
- Loader will throw on warnings if this function is not provided.
108
- - `schema` _(default: `DEFAULT_SAFE_SCHEMA`)_ - specifies a schema to use.
109
- - `FAILSAFE_SCHEMA` - only strings, arrays and plain objects:
110
- http://www.yaml.org/spec/1.2/spec.html#id2802346
111
- - `JSON_SCHEMA` - all JSON-supported types:
112
- http://www.yaml.org/spec/1.2/spec.html#id2803231
113
- - `CORE_SCHEMA` - same as `JSON_SCHEMA`:
114
- http://www.yaml.org/spec/1.2/spec.html#id2804923
115
- - `DEFAULT_SAFE_SCHEMA` - all supported YAML types, without unsafe ones
116
- (`!!js/undefined`, `!!js/regexp` and `!!js/function`):
117
- http://yaml.org/type/
118
- - `DEFAULT_FULL_SCHEMA` - all supported YAML types.
119
-
120
- NOTE: This function **does not** understand multi-document sources, it throws
121
- exception on those.
122
-
123
- NOTE: JS-YAML **does not** support schema-specific tag resolution restrictions.
124
- So, JSON schema is not as strict as defined in the YAML specification.
125
- It allows numbers in any notaion, use `Null` and `NULL` as `null`, etc.
126
- Core schema also has no such restrictions. It allows binary notation for integers.
127
-
128
-
129
- ### load (string [ , options ])
130
-
131
- **Use with care with untrusted sources**. The same as `safeLoad()` but uses
132
- `DEFAULT_FULL_SCHEMA` by default - adds some JavaScript-specific types:
133
- `!!js/function`, `!!js/regexp` and `!!js/undefined`. For untrusted sources you
134
- must additionally validate object structure, to avoid injections:
135
-
136
- ``` javascript
137
- var untrusted_code = '"toString": !<tag:yaml.org,2002:js/function> "function (){very_evil_thing();}"';
138
-
139
- // I'm just converting that string, what could possibly go wrong?
140
- require('js-yaml').load(untrusted_code) + ''
141
- ```
142
-
143
-
144
- ### safeLoadAll (string, iterator [ , options ])
145
-
146
- Same as `safeLoad()`, but understands multi-document sources and apply
147
- `iterator` to each document.
148
-
149
- ``` javascript
150
- var yaml = require('js-yaml');
151
-
152
- yaml.safeLoadAll(data, function (doc) {
153
- console.log(doc);
154
- });
155
- ```
156
-
157
-
158
- ### loadAll (string, iterator [ , options ])
159
-
160
- Same as `safeLoadAll()` but uses `DEFAULT_FULL_SCHEMA` by default.
161
-
162
-
163
- ### safeDump (object [ , options ])
164
-
165
- Serializes `object` as YAML document. Uses `DEFAULT_SAFE_SCHEMA`, so it will
166
- throw exception if you try to dump regexps or functions. However, you can
167
- disable exceptions by `skipInvalid` option.
168
-
169
- options:
170
-
171
- - `indent` _(default: 2)_ - indentation width to use (in spaces).
172
- - `skipInvalid` _(default: false)_ - do not throw on invalid types (like function
173
- in the safe schema) and skip pairs and single values with such types.
174
- - `flowLevel` (default: -1) - specifies level of nesting, when to switch from
175
- block to flow style for collections. -1 means block style everwhere
176
- - `styles` - "tag" => "style" map. Each tag may have own set of styles.
177
- - `schema` _(default: `DEFAULT_SAFE_SCHEMA`)_ specifies a schema to use.
178
-
179
- styles:
180
-
181
- ``` none
182
- !!null
183
- "canonical" => "~"
184
-
185
- !!int
186
- "binary" => "0b1", "0b101010", "0b1110001111010"
187
- "octal" => "01", "052", "016172"
188
- "decimal" => "1", "42", "7290"
189
- "hexadecimal" => "0x1", "0x2A", "0x1C7A"
190
-
191
- !!null, !!bool, !!float
192
- "lowercase" => "null", "true", "false", ".nan", '.inf'
193
- "uppercase" => "NULL", "TRUE", "FALSE", ".NAN", '.INF'
194
- "camelcase" => "Null", "True", "False", ".NaN", '.Inf'
195
- ```
196
-
197
- By default, !!int uses `decimal`, and !!null, !!bool, !!float use `lowercase`.
198
-
199
-
200
-
201
- ### dump (object [ , options ])
202
-
203
- Same as `safeDump()` but without limits (uses `DEFAULT_FULL_SCHEMA` by default).
204
-
205
-
206
- Supported YAML types
207
- --------------------
208
-
209
- The list of standard YAML tags and corresponding JavaScipt types. See also
210
- [YAML tag discussion](http://pyyaml.org/wiki/YAMLTagDiscussion) and
211
- [YAML types repository](http://yaml.org/type/).
212
-
213
- ```
214
- !!null '' # null
215
- !!bool 'yes' # bool
216
- !!int '3...' # number
217
- !!float '3.14...' # number
218
- !!binary '...base64...' # buffer
219
- !!timestamp 'YYYY-...' # date
220
- !!omap [ ... ] # array of key-value pairs
221
- !!pairs [ ... ] # array or array pairs
222
- !!set { ... } # array of objects with given keys and null values
223
- !!str '...' # string
224
- !!seq [ ... ] # array
225
- !!map { ... } # object
226
- ```
227
-
228
- **JavaScript-specific tags**
229
-
230
- ```
231
- !!js/regexp /pattern/gim # RegExp
232
- !!js/undefined '' # Undefined
233
- !!js/function 'function () {...}' # Function
234
- ```
235
-
236
- Caveats
237
- -------
238
-
239
- Note, that you use arrays or objects as key in JS-YAML. JS do not allows objects
240
- or array as keys, and stringifies (by calling .toString method) them at the
241
- moment of adding them.
242
-
243
- ``` yaml
244
- ---
245
- ? [ foo, bar ]
246
- : - baz
247
- ? { foo: bar }
248
- : - baz
249
- - baz
250
- ```
251
-
252
- ``` javascript
253
- { "foo,bar": ["baz"], "[object Object]": ["baz", "baz"] }
254
- ```
255
-
256
- Also, reading of properties on implicit block mapping keys is not supported yet.
257
- So, the following YAML document cannot be loaded.
258
-
259
- ``` yaml
260
- &anchor foo:
261
- foo: bar
262
- *anchor: duplicate key
263
- baz: bat
264
- *anchor: duplicate key
265
- ```
266
-
267
-
268
- Breaking changes in 2.x.x -> 3.x.x
269
- ----------------------------------
270
-
271
- If your have not used __custom__ tags or loader classes and not loaded yaml
272
- files via `require()` - no changes needed. Just upgrade library.
273
-
274
- In other case, you should:
275
-
276
- 1. Replace all occurences of `require('xxxx.yml')` by `fs.readFileSync()` +
277
- `yaml.safeLoad()`.
278
- 2. rewrite your custom tags constructors and custom loader
279
- classes, to conform new API. See
280
- [examples](https://github.com/nodeca/js-yaml/tree/master/examples) and
281
- [wiki](https://github.com/nodeca/js-yaml/wiki) for details.
282
-
283
-
284
- License
285
- -------
286
-
287
- View the [LICENSE](https://github.com/nodeca/js-yaml/blob/master/LICENSE) file
288
- (MIT).