fairchild-poolparty 1.1.4 → 1.1.5

Sign up to get free protection for your applications and to get access to all the features.
Files changed (333) hide show
  1. data/README.txt +0 -12
  2. data/Rakefile +17 -1
  3. data/VERSION.yml +1 -1
  4. data/bin/cloud +20 -1
  5. data/bin/cloud-bootstrap +14 -4
  6. data/bin/cloud-configure +26 -9
  7. data/bin/cloud-contract +7 -7
  8. data/bin/cloud-describe +28 -0
  9. data/bin/cloud-expand +13 -6
  10. data/bin/cloud-list +3 -5
  11. data/bin/cloud-osxcopy +1 -1
  12. data/bin/cloud-provision +1 -1
  13. data/bin/cloud-show +6 -5
  14. data/bin/cloud-ssh +1 -3
  15. data/bin/cloud-start +8 -6
  16. data/bin/cloud-terminate +9 -7
  17. data/bin/server-cloud-elections +29 -18
  18. data/bin/server-ensure-provisioning +24 -29
  19. data/bin/server-list-active +10 -5
  20. data/bin/server-monitor.ru +18 -1
  21. data/bin/server-update-hosts +3 -3
  22. data/bin/server-write-new-nodes +1 -1
  23. data/config/jeweler.rb +12 -3
  24. data/lib/poolparty/aska/aska.rb +1 -12
  25. data/lib/poolparty/base_packages/haproxy.rb +26 -18
  26. data/lib/poolparty/base_packages/poolparty.rb +1 -1
  27. data/lib/poolparty/capistrano.rb +1 -1
  28. data/lib/poolparty/core/array.rb +12 -0
  29. data/lib/poolparty/core/hash.rb +12 -5
  30. data/lib/poolparty/core/nil.rb +8 -0
  31. data/lib/poolparty/core/object.rb +15 -5
  32. data/lib/poolparty/core/string.rb +28 -2
  33. data/lib/poolparty/dependency_resolver/chef_resolver.rb +106 -79
  34. data/lib/poolparty/dependency_resolver/dependency_resolver.rb +1 -1
  35. data/lib/poolparty/dependency_resolver/dependency_resolver_cloud_extensions.rb +5 -4
  36. data/lib/poolparty/dependency_resolver/puppet_resolver.rb +44 -17
  37. data/lib/poolparty/helpers/console.rb +1 -1
  38. data/lib/poolparty/helpers/optioner.rb +9 -2
  39. data/lib/poolparty/lite.rb +12 -2
  40. data/lib/poolparty/modules/callbacks.rb +44 -0
  41. data/lib/poolparty/modules/cloud_dsl.rb +17 -11
  42. data/lib/poolparty/modules/cloud_resourcer.rb +29 -21
  43. data/lib/poolparty/modules/definable_resource.rb +1 -1
  44. data/lib/poolparty/modules/pinger.rb +28 -0
  45. data/lib/poolparty/modules/resourcing_dsl.rb +7 -3
  46. data/lib/poolparty/modules/thread_pool.rb +107 -106
  47. data/lib/poolparty/modules/user_helpers.rb +20 -0
  48. data/lib/poolparty/monitors/base_monitor.rb +32 -81
  49. data/lib/poolparty/monitors/monitor_rack.rb +60 -69
  50. data/lib/poolparty/monitors/monitors/favicon_monitor.rb +12 -0
  51. data/lib/poolparty/monitors/monitors/load_monitor.rb +9 -15
  52. data/lib/poolparty/monitors/monitors/memory_monitor.rb +48 -48
  53. data/lib/poolparty/monitors/monitors/neighborhood_monitor.rb +77 -0
  54. data/lib/poolparty/monitors/{stats_monitor.rb → monitors/stats_monitor.rb} +29 -24
  55. data/lib/poolparty/monitors/monitors/time_monitor.rb +15 -0
  56. data/lib/poolparty/net/messenger.rb +2 -0
  57. data/lib/poolparty/net/remoter/cloud_control.rb +177 -227
  58. data/lib/poolparty/net/remoter/connections.rb +10 -18
  59. data/lib/poolparty/net/remoter/interactive.rb +24 -90
  60. data/lib/poolparty/net/remoter_base.rb +98 -25
  61. data/lib/poolparty/net/remoter_bases/ec2/ec2.rb +83 -66
  62. data/lib/poolparty/net/remoter_bases/vmrun/utilities/vm_disk.rb +12 -0
  63. data/lib/poolparty/net/remoter_bases/vmrun/utilities/vmx.rb +33 -0
  64. data/lib/poolparty/net/remoter_bases/vmrun/utilities/vmx_file.rb +117 -0
  65. data/lib/poolparty/net/remoter_bases/vmrun/vmrun.rb +165 -0
  66. data/lib/poolparty/net/remoter_bases/vmrun/vmrun_instance.rb +71 -0
  67. data/lib/poolparty/{base_packages → plugins}/bind.rb +1 -1
  68. data/lib/poolparty/plugins/chef.rb +71 -71
  69. data/lib/poolparty/plugins/chef_deploy.rb +58 -0
  70. data/lib/poolparty/plugins/{deploydirectory.rb → deploy_directory.rb} +12 -3
  71. data/lib/poolparty/plugins/dynomite.rb +14 -0
  72. data/lib/poolparty/plugins/gem_package.rb +37 -0
  73. data/lib/poolparty/plugins/line_in_file.rb +1 -0
  74. data/lib/poolparty/plugins/nanite.rb +41 -0
  75. data/lib/poolparty/{base_packages → plugins}/tokyo_tyrant.rb +1 -1
  76. data/lib/poolparty/poolparty/cloud.rb +36 -35
  77. data/lib/poolparty/poolparty/default.rb +2 -11
  78. data/lib/poolparty/poolparty/key.rb +15 -12
  79. data/lib/poolparty/poolparty/neighborhoods.rb +54 -21
  80. data/lib/poolparty/poolparty/plugin.rb +6 -9
  81. data/lib/poolparty/poolparty/plugin_model.rb +5 -5
  82. data/lib/poolparty/poolparty/pool.rb +8 -4
  83. data/lib/poolparty/poolparty/poolparty_base_class.rb +20 -11
  84. data/lib/poolparty/poolparty/resource.rb +9 -5
  85. data/lib/poolparty/poolparty/service.rb +3 -1
  86. data/lib/poolparty/provision/boot_strapper.rb +47 -24
  87. data/lib/poolparty/provision/configurations/chef.rb +7 -4
  88. data/lib/poolparty/provision/dr_configure.rb +80 -25
  89. data/lib/poolparty/resources/cron.rb +8 -0
  90. data/lib/poolparty/resources/directory.rb +1 -1
  91. data/lib/poolparty/resources/file.rb +16 -0
  92. data/lib/poolparty/resources/package.rb +7 -2
  93. data/lib/poolparty/resources/service.rb +4 -3
  94. data/lib/poolparty/resources/symlink.rb +0 -8
  95. data/lib/poolparty/schema.rb +35 -20
  96. data/lib/poolparty/templates/haproxy.conf +27 -25
  97. data/lib/poolparty/templates/monitor.ru +3 -3
  98. data/lib/poolparty/verification/verifier_base.rb +17 -0
  99. data/lib/poolparty/verification/verifiers/ping.rb +17 -0
  100. data/lib/poolparty/verification/verify.rb +74 -0
  101. data/lib/poolparty.rb +8 -9
  102. data/lib/poolpartycl.rb +14 -0
  103. data/spec/bin/server-list-active_spec.rb +2 -0
  104. data/spec/poolparty/base_packages/haproxy_spec.rb +1 -1
  105. data/spec/poolparty/core/array_spec.rb +3 -1
  106. data/spec/poolparty/core/ordered_hash_spec.rb +2 -2
  107. data/spec/poolparty/dependency_resolver/chef_resolver_spec.rb +9 -15
  108. data/spec/poolparty/dependency_resolver/dependency_resolver_cloud_extensions_spec.rb +6 -6
  109. data/spec/poolparty/dependency_resolver/puppet_resolver_spec.rb +121 -124
  110. data/spec/poolparty/net/remote_spec.rb +287 -286
  111. data/spec/poolparty/net/remoter_bases/ec2_mocks_and_stubs.rb +1 -1
  112. data/spec/poolparty/net/remoter_bases/ec2_remote_instance_spec.rb +7 -8
  113. data/spec/poolparty/net/remoter_bases/ec2_spec.rb +22 -7
  114. data/spec/poolparty/net/remoter_spec.rb +48 -45
  115. data/spec/poolparty/poolparty/cloud_spec.rb +15 -22
  116. data/spec/poolparty/poolparty/key_spec.rb +4 -4
  117. data/spec/poolparty/poolparty/neighborhoods_spec.rb +1 -2
  118. data/spec/poolparty/poolparty/plugin_spec.rb +2 -2
  119. data/spec/poolparty/poolparty/resource_spec.rb +4 -5
  120. data/spec/poolparty/poolparty_base_class_spec.rb +82 -78
  121. data/spec/poolparty/resources/package_spec.rb +0 -3
  122. data/spec/poolparty/spec_helper.rb +4 -4
  123. data/tasks/development.rake +9 -0
  124. data/test/poolparty/core/array_test.rb +21 -0
  125. data/test/poolparty/core/hash_test.rb +14 -1
  126. data/test/poolparty/core/string_test.rb +29 -0
  127. data/test/poolparty/dependency_resolver/puppet_resolver_test.rb +106 -0
  128. data/test/poolparty/modules/callbacks_test.rb +40 -0
  129. data/test/poolparty/modules/cloud_dsl_test.rb +25 -0
  130. data/test/poolparty/net/remoter_bases/vmrun/vmrun_test.rb +50 -0
  131. data/test/poolparty/net/remoter_test.rb +14 -0
  132. data/test/poolparty/poolparty/neighborhood_test.rb +23 -0
  133. data/test/poolparty/poolparty/poolparty_base_class_test.rb +84 -0
  134. data/test/poolparty/verification/verify_test.rb +49 -0
  135. data/test/test_helper.rb +4 -1
  136. data/test/test_poolparty.rb +6 -5
  137. data/vendor/chef/apache2/attributes/apache.rb +1 -1
  138. data/vendor/chef/apache2/templates/default/default-site.erb +1 -1
  139. data/vendor/chef/chef-deploy/LICENSE +201 -0
  140. data/vendor/chef/chef-deploy/README.rdoc +24 -0
  141. data/vendor/chef/chef-deploy/Rakefile +57 -0
  142. data/vendor/chef/chef-deploy/TODO +4 -0
  143. data/vendor/chef/chef-deploy/lib/chef-deploy/cached_deploy.rb +230 -0
  144. data/vendor/chef/chef-deploy/lib/chef-deploy/git.rb +132 -0
  145. data/vendor/chef/chef-deploy/lib/chef-deploy/subversion.rb +98 -0
  146. data/vendor/chef/chef-deploy/lib/chef-deploy.rb +183 -0
  147. metadata +57 -252
  148. data/bin/cloud-run +0 -18
  149. data/bin/cloud-stats +0 -17
  150. data/bin/ec2-list-active +0 -24
  151. data/bin/pool +0 -31
  152. data/bin/pool-describe +0 -8
  153. data/bin/pool-generate +0 -18
  154. data/bin/pool-init +0 -28
  155. data/bin/pool-list +0 -30
  156. data/bin/pool-start +0 -26
  157. data/bin/server-list-instances +0 -15
  158. data/lib/erlang/messenger/Emakefile +0 -1
  159. data/lib/erlang/messenger/Makefile +0 -15
  160. data/lib/erlang/messenger/README +0 -5
  161. data/lib/erlang/messenger/Rakefile +0 -72
  162. data/lib/erlang/messenger/control +0 -11
  163. data/lib/erlang/messenger/ebin/client.app +0 -19
  164. data/lib/erlang/messenger/ebin/master.app +0 -19
  165. data/lib/erlang/messenger/ebin/node.app +0 -19
  166. data/lib/erlang/messenger/ebin/packager.app +0 -19
  167. data/lib/erlang/messenger/ebin/pm_client_rel-0.1.rel +0 -1
  168. data/lib/erlang/messenger/ebin/pm_master_rel-0.1.rel +0 -1
  169. data/lib/erlang/messenger/ebin/pm_node_rel-0.1.rel +0 -1
  170. data/lib/erlang/messenger/include/defines.hrl +0 -27
  171. data/lib/erlang/messenger/lib/eunit/AUTHORS +0 -2
  172. data/lib/erlang/messenger/lib/eunit/CHANGELOG +0 -14
  173. data/lib/erlang/messenger/lib/eunit/COPYING +0 -504
  174. data/lib/erlang/messenger/lib/eunit/Makefile +0 -28
  175. data/lib/erlang/messenger/lib/eunit/NOTES +0 -276
  176. data/lib/erlang/messenger/lib/eunit/README +0 -3
  177. data/lib/erlang/messenger/lib/eunit/doc/edoc-info +0 -3
  178. data/lib/erlang/messenger/lib/eunit/doc/erlang.png +0 -0
  179. data/lib/erlang/messenger/lib/eunit/doc/eunit.html +0 -172
  180. data/lib/erlang/messenger/lib/eunit/doc/index.html +0 -17
  181. data/lib/erlang/messenger/lib/eunit/doc/modules-frame.html +0 -12
  182. data/lib/erlang/messenger/lib/eunit/doc/overview-summary.html +0 -984
  183. data/lib/erlang/messenger/lib/eunit/doc/overview.edoc +0 -980
  184. data/lib/erlang/messenger/lib/eunit/doc/packages-frame.html +0 -11
  185. data/lib/erlang/messenger/lib/eunit/doc/stylesheet.css +0 -55
  186. data/lib/erlang/messenger/lib/eunit/ebin/autoload.beam +0 -0
  187. data/lib/erlang/messenger/lib/eunit/ebin/code_monitor.beam +0 -0
  188. data/lib/erlang/messenger/lib/eunit/ebin/eunit.app +0 -21
  189. data/lib/erlang/messenger/lib/eunit/ebin/eunit.appup +0 -1
  190. data/lib/erlang/messenger/lib/eunit/ebin/eunit.beam +0 -0
  191. data/lib/erlang/messenger/lib/eunit/ebin/eunit_autoexport.beam +0 -0
  192. data/lib/erlang/messenger/lib/eunit/ebin/eunit_data.beam +0 -0
  193. data/lib/erlang/messenger/lib/eunit/ebin/eunit_lib.beam +0 -0
  194. data/lib/erlang/messenger/lib/eunit/ebin/eunit_proc.beam +0 -0
  195. data/lib/erlang/messenger/lib/eunit/ebin/eunit_serial.beam +0 -0
  196. data/lib/erlang/messenger/lib/eunit/ebin/eunit_server.beam +0 -0
  197. data/lib/erlang/messenger/lib/eunit/ebin/eunit_striptests.beam +0 -0
  198. data/lib/erlang/messenger/lib/eunit/ebin/eunit_test.beam +0 -0
  199. data/lib/erlang/messenger/lib/eunit/ebin/eunit_tests.beam +0 -0
  200. data/lib/erlang/messenger/lib/eunit/ebin/eunit_tty.beam +0 -0
  201. data/lib/erlang/messenger/lib/eunit/ebin/file_monitor.beam +0 -0
  202. data/lib/erlang/messenger/lib/eunit/examples/eunit_examples.erl +0 -339
  203. data/lib/erlang/messenger/lib/eunit/examples/fib.erl +0 -19
  204. data/lib/erlang/messenger/lib/eunit/examples/tests.txt +0 -1
  205. data/lib/erlang/messenger/lib/eunit/include/eunit.hrl +0 -313
  206. data/lib/erlang/messenger/lib/eunit/src/Makefile +0 -46
  207. data/lib/erlang/messenger/lib/eunit/src/autoload.erl +0 -388
  208. data/lib/erlang/messenger/lib/eunit/src/code_monitor.erl +0 -243
  209. data/lib/erlang/messenger/lib/eunit/src/eunit.app.src +0 -21
  210. data/lib/erlang/messenger/lib/eunit/src/eunit.appup.src +0 -1
  211. data/lib/erlang/messenger/lib/eunit/src/eunit.erl +0 -196
  212. data/lib/erlang/messenger/lib/eunit/src/eunit_autoexport.erl +0 -102
  213. data/lib/erlang/messenger/lib/eunit/src/eunit_data.erl +0 -798
  214. data/lib/erlang/messenger/lib/eunit/src/eunit_internal.hrl +0 -48
  215. data/lib/erlang/messenger/lib/eunit/src/eunit_lib.erl +0 -682
  216. data/lib/erlang/messenger/lib/eunit/src/eunit_proc.erl +0 -552
  217. data/lib/erlang/messenger/lib/eunit/src/eunit_serial.erl +0 -157
  218. data/lib/erlang/messenger/lib/eunit/src/eunit_server.erl +0 -340
  219. data/lib/erlang/messenger/lib/eunit/src/eunit_striptests.erl +0 -64
  220. data/lib/erlang/messenger/lib/eunit/src/eunit_test.erl +0 -334
  221. data/lib/erlang/messenger/lib/eunit/src/eunit_tests.erl +0 -45
  222. data/lib/erlang/messenger/lib/eunit/src/eunit_tty.erl +0 -272
  223. data/lib/erlang/messenger/lib/eunit/src/file_monitor.erl +0 -409
  224. data/lib/erlang/messenger/lib/eunit/sys.config +0 -9
  225. data/lib/erlang/messenger/lib/eunit/vsn.mk +0 -1
  226. data/lib/erlang/messenger/pm_client_rel-0.1.boot +0 -0
  227. data/lib/erlang/messenger/pm_client_rel-0.1.script +0 -238
  228. data/lib/erlang/messenger/pm_master_rel-0.1.boot +0 -0
  229. data/lib/erlang/messenger/pm_master_rel-0.1.script +0 -239
  230. data/lib/erlang/messenger/pm_node_rel-0.1.boot +0 -0
  231. data/lib/erlang/messenger/pm_node_rel-0.1.script +0 -237
  232. data/lib/erlang/messenger/src/client_app.erl +0 -39
  233. data/lib/erlang/messenger/src/client_server.erl +0 -60
  234. data/lib/erlang/messenger/src/master_app.erl +0 -39
  235. data/lib/erlang/messenger/src/node_app.erl +0 -39
  236. data/lib/erlang/messenger/src/pm_client.erl +0 -49
  237. data/lib/erlang/messenger/src/pm_client_supervisor.erl +0 -38
  238. data/lib/erlang/messenger/src/pm_cluster.erl +0 -61
  239. data/lib/erlang/messenger/src/pm_event_manager.erl +0 -27
  240. data/lib/erlang/messenger/src/pm_master.erl +0 -215
  241. data/lib/erlang/messenger/src/pm_master_event_handler.erl +0 -72
  242. data/lib/erlang/messenger/src/pm_master_supervisor.erl +0 -39
  243. data/lib/erlang/messenger/src/pm_node.erl +0 -200
  244. data/lib/erlang/messenger/src/pm_node_supervisor.erl +0 -38
  245. data/lib/erlang/messenger/src/pm_packager.erl +0 -76
  246. data/lib/erlang/messenger/src/pm_spawner.erl +0 -213
  247. data/lib/erlang/messenger/src/pm_strings.erl +0 -11
  248. data/lib/erlang/messenger/src/utils.erl +0 -72
  249. data/lib/erlang/messenger/useful_snippets +0 -17
  250. data/lib/poolparty/monitors/monitors/server_monitor.rb +0 -7
  251. data/lib/poolparty/monitors/monitors/web_monitor.rb +0 -18
  252. data/lib/poolparty/monitors/neighborhood_monitor.rb +0 -24
  253. data/lib/poolparty/monitors.rb +0 -6
  254. data/lib/poolparty/net/remoter/lists.rb +0 -12
  255. data/lib/poolparty/poolparty/custom_resource.rb +0 -45
  256. data/lib/poolparty/resources/custom_service.rb +0 -30
  257. data/lib/poolparty/services/gem_package.rb +0 -52
  258. data/lib/poolparty/version.rb +0 -15
  259. data/spec/poolparty/plugins/svn_spec.rb +0 -16
  260. data/spec/poolparty/poolparty/custom_resource_spec.rb +0 -79
  261. data/vendor/gems/butterfly/History.txt +0 -4
  262. data/vendor/gems/butterfly/PostInstall.txt +0 -2
  263. data/vendor/gems/butterfly/README.rdoc +0 -48
  264. data/vendor/gems/butterfly/Rakefile +0 -62
  265. data/vendor/gems/butterfly/VERSION.yml +0 -4
  266. data/vendor/gems/butterfly/bin/flutter +0 -4
  267. data/vendor/gems/butterfly/butterfly.gemspec +0 -37
  268. data/vendor/gems/butterfly/examples/config.ru +0 -15
  269. data/vendor/gems/butterfly/examples/my_app.rb +0 -12
  270. data/vendor/gems/butterfly/lib/butterfly.rb +0 -14
  271. data/vendor/gems/butterfly/lib/handler.rb +0 -48
  272. data/vendor/gems/butterfly/lib/request.rb +0 -29
  273. data/vendor/gems/butterfly/lib/response.rb +0 -49
  274. data/vendor/gems/butterfly/script/console +0 -10
  275. data/vendor/gems/butterfly/script/destroy +0 -14
  276. data/vendor/gems/butterfly/script/generate +0 -14
  277. data/vendor/gems/butterfly/test/test_adapter_base.rb +0 -23
  278. data/vendor/gems/butterfly/test/test_butterfly_request.rb +0 -46
  279. data/vendor/gems/butterfly/test/test_butterfly_response.rb +0 -43
  280. data/vendor/gems/butterfly/test/test_butterfly_server.rb +0 -16
  281. data/vendor/gems/butterfly/test/test_default.rb +0 -12
  282. data/vendor/gems/butterfly/test/test_helper.rb +0 -6
  283. data/vendor/gems/dslify/History.txt +0 -4
  284. data/vendor/gems/dslify/Manifest.txt +0 -25
  285. data/vendor/gems/dslify/PostInstall.txt +0 -5
  286. data/vendor/gems/dslify/README.txt +0 -60
  287. data/vendor/gems/dslify/Rakefile +0 -56
  288. data/vendor/gems/dslify/config/hoe.rb +0 -73
  289. data/vendor/gems/dslify/config/requirements.rb +0 -15
  290. data/vendor/gems/dslify/dslify.gemspec +0 -40
  291. data/vendor/gems/dslify/lib/dslify/dslify.rb +0 -69
  292. data/vendor/gems/dslify/lib/dslify/version.rb +0 -10
  293. data/vendor/gems/dslify/lib/dslify.rb +0 -7
  294. data/vendor/gems/dslify/script/console +0 -10
  295. data/vendor/gems/dslify/script/destroy +0 -14
  296. data/vendor/gems/dslify/script/generate +0 -14
  297. data/vendor/gems/dslify/script/txt2html +0 -82
  298. data/vendor/gems/dslify/setup.rb +0 -1585
  299. data/vendor/gems/dslify/tasks/deployment.rake +0 -34
  300. data/vendor/gems/dslify/tasks/environment.rake +0 -7
  301. data/vendor/gems/dslify/tasks/website.rake +0 -17
  302. data/vendor/gems/dslify/test/test_dslify.rb +0 -114
  303. data/vendor/gems/dslify/website/index.html +0 -86
  304. data/vendor/gems/dslify/website/index.txt +0 -83
  305. data/vendor/gems/dslify/website/javascripts/rounded_corners_lite.inc.js +0 -285
  306. data/vendor/gems/dslify/website/stylesheets/screen.css +0 -138
  307. data/vendor/gems/dslify/website/template.html.erb +0 -48
  308. data/vendor/gems/parenting/History.txt +0 -4
  309. data/vendor/gems/parenting/Manifest.txt +0 -13
  310. data/vendor/gems/parenting/PostInstall.txt +0 -2
  311. data/vendor/gems/parenting/README.rdoc +0 -47
  312. data/vendor/gems/parenting/Rakefile +0 -28
  313. data/vendor/gems/parenting/lib/parenting/base.rb +0 -65
  314. data/vendor/gems/parenting/lib/parenting.rb +0 -10
  315. data/vendor/gems/parenting/parenting.gemspec +0 -39
  316. data/vendor/gems/parenting/script/console +0 -10
  317. data/vendor/gems/parenting/script/destroy +0 -14
  318. data/vendor/gems/parenting/script/generate +0 -14
  319. data/vendor/gems/parenting/test/file_to_eval.rb +0 -9
  320. data/vendor/gems/parenting/test/test_helper.rb +0 -5
  321. data/vendor/gems/parenting/test/test_parenting.rb +0 -89
  322. data/vendor/gems/suitcase/LICENSE +0 -20
  323. data/vendor/gems/suitcase/README.rdoc +0 -31
  324. data/vendor/gems/suitcase/Rakefile +0 -57
  325. data/vendor/gems/suitcase/VERSION.yml +0 -4
  326. data/vendor/gems/suitcase/lib/suitcase/unzipper.rb +0 -15
  327. data/vendor/gems/suitcase/lib/suitcase/zipper.rb +0 -119
  328. data/vendor/gems/suitcase/lib/suitcase.rb +0 -5
  329. data/vendor/gems/suitcase/suitcase.gemspec +0 -32
  330. data/vendor/gems/suitcase/test/suitcase_test.rb +0 -102
  331. data/vendor/gems/suitcase/test/test_dir/box.rb +0 -1
  332. data/vendor/gems/suitcase/test/test_dir/test.txt +0 -1
  333. data/vendor/gems/suitcase/test/test_helper.rb +0 -12
@@ -1,552 +0,0 @@
1
- %% This library is free software; you can redistribute it and/or modify
2
- %% it under the terms of the GNU Lesser General Public License as
3
- %% published by the Free Software Foundation; either version 2 of the
4
- %% License, or (at your option) any later version.
5
- %%
6
- %% This library is distributed in the hope that it will be useful, but
7
- %% WITHOUT ANY WARRANTY; without even the implied warranty of
8
- %% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
9
- %% Lesser General Public License for more details.
10
- %%
11
- %% You should have received a copy of the GNU Lesser General Public
12
- %% License along with this library; if not, write to the Free Software
13
- %% Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
14
- %% USA
15
- %%
16
- %% $Id: eunit_proc.erl 256 2008-09-29 17:42:21Z rcarlsson $
17
- %%
18
- %% @author Richard Carlsson <richardc@it.uu.se>
19
- %% @copyright 2006 Richard Carlsson
20
- %% @private
21
- %% @see eunit
22
- %% @doc Test runner process tree functions
23
-
24
- -module(eunit_proc).
25
-
26
- -include("eunit.hrl").
27
- -include("eunit_internal.hrl").
28
-
29
- -export([start/4]).
30
-
31
-
32
- -record(procstate, {ref, id, super, insulator, parent, order}).
33
-
34
-
35
- %% Spawns test process and returns the process Pid; sends {done,
36
- %% Reference, Pid} to caller when finished. See the function
37
- %% wait_for_task/2 for details about the need for the reference.
38
- %%
39
- %% The `Super' process receives a stream of status messages; see
40
- %% status_message/3 for details.
41
-
42
- start(Tests, Order, Super, Reference)
43
- when is_pid(Super), is_reference(Reference) ->
44
- St = #procstate{ref = Reference,
45
- id = [],
46
- super = Super,
47
- order = Order},
48
- spawn_group(local, #group{tests = Tests}, St).
49
-
50
-
51
- %% Status messages sent to the supervisor process. (A supervisor does
52
- %% not have to act on these messages - it can e.g. just log them, or
53
- %% even discard them.) Each status message has the following form:
54
- %%
55
- %% {status, Id, Info}
56
- %%
57
- %% where Id identifies the item that the message pertains to, and the
58
- %% Info part can be one of:
59
- %%
60
- %% {progress, 'begin', test | group}
61
- %% indicates that the item has been entered, and what type it is
62
- %%
63
- %% {progress, 'end', {Status, Time::integer(), Output::io_list()}}
64
- %% Status = 'ok' | {error, Exception} | {skipped, Cause}
65
- %%
66
- %% where Time is measured in milliseconds and Output is the data
67
- %% written to the standard output stream during the test; if
68
- %% Status is {skipped, Cause}, then Cause is a term thrown from
69
- %% eunit_test:run_testfun/1
70
- %%
71
- %% {cancel, Descriptor}
72
- %% where Descriptor can be:
73
- %% timeout a timeout occurred
74
- %% {blame, Id} forced to terminate because of item `Id'
75
- %% {abort, Cause} the test failed to execute
76
- %% {exit, Reason} the test process terminated unexpectedly
77
- %% {startup, Reason} failed to start a remote test process
78
- %%
79
- %% where Cause is a term thrown from eunit_data:enter_context/4 or
80
- %% from eunit_data:iter_next/2, and Reason is an exit term from a
81
- %% crashed process
82
- %%
83
- %% Note that due to concurrent (and possibly distributed) execution,
84
- %% there are *no* strict ordering guarantees on the status messages,
85
- %% with one exception: a 'begin' message will always arrive before its
86
- %% corresponding 'end' message.
87
-
88
- status_message(Id, Info, St) ->
89
- St#procstate.super ! {status, Id, Info}.
90
-
91
-
92
- %% @TODO implement synchronized mode for insulator/child execution
93
-
94
- %% Ideas for synchronized mode:
95
- %%
96
- %% * At each "program point", i.e., before entering a test, entering a
97
- %% group, or leaving a group, the child will synchronize with the
98
- %% insulator to make sure it is ok to proceed.
99
- %%
100
- %% * The insulator can receive controlling messages from higher up in
101
- %% the hierarchy, telling it to pause, resume, single-step, repeat, etc.
102
- %%
103
- %% * Synchronization on entering/leaving groups is necessary in order to
104
- %% get control over things such as subprocess creation/termination and
105
- %% setup/cleanup, making it possible to, e.g., repeat all the tests
106
- %% within a particular subprocess without terminating and restarting it,
107
- %% or repeating tests without repeating the setup/cleanup.
108
- %%
109
- %% * Some tests that depend on state will not be possible to repeat, but
110
- %% require a fresh context setup. There is nothing that can be done
111
- %% about this, and the many tests that are repeatable should not be
112
- %% punished because of it. The user must decide which level to restart.
113
- %%
114
- %% * Question: How propagate control messages down the hierarchy
115
- %% (preferably only to the correct insulator process)? An insulator does
116
- %% not currenctly know whether its child process has spawned subtasks.
117
- %% (The "supervisor" process does not know the Pids of the controlling
118
- %% insulator processes in the tree, and it probably should not be
119
- %% responsible for this anyway.)
120
-
121
-
122
- %% ---------------------------------------------------------------------
123
- %% Process tree primitives
124
-
125
- %% A "task" consists of an insulator process and a child process which
126
- %% handles the actual work. When the child terminates, the insulator
127
- %% process sends {done, Reference, self()} to the process which started
128
- %% the task (the "parent"). The child process is given a State record
129
- %% which contains the process id:s of the parent, the insulator, and the
130
- %% supervisor.
131
-
132
- %% @spec (Type, (#procstate{}) -> () -> term(), #procstate{}) -> pid()
133
- %% Type = local | {remote, Node::atom()}
134
-
135
- start_task(Type, Fun, St0) ->
136
- St = St0#procstate{parent = self()},
137
- %% (note: the link here is mainly to propagate signals *downwards*,
138
- %% so that the insulator can detect if the process that started the
139
- %% task dies before the task is done)
140
- F = fun () -> insulator_process(Type, Fun, St) end,
141
- case Type of
142
- local ->
143
- %% we assume (at least for now) that local spawns can never
144
- %% fail in such a way that the process does not start, so a
145
- %% new local insulator does not need to synchronize here
146
- spawn_link(F);
147
- {remote, Node} ->
148
- Pid = spawn_link(Node, F),
149
- %% See below for the need for the {ok, Reference, Pid}
150
- %% message.
151
- Reference = St#procstate.ref,
152
- Monitor = erlang:monitor(process, Pid),
153
- %% (the DOWN message is guaranteed to arrive after any
154
- %% messages sent by the process itself)
155
- receive
156
- {ok, Reference, Pid} ->
157
- Pid;
158
- {'DOWN', Monitor, process, Pid, Reason} ->
159
- %% send messages as if the insulator process was
160
- %% started, but terminated on its own accord
161
- Msg = {startup, Reason},
162
- status_message(St#procstate.id, {cancel, Msg}, St),
163
- self() ! {done, Reference, Pid}
164
- end,
165
- erlang:demonitor(Monitor, [flush]),
166
- Pid
167
- end.
168
-
169
- %% Relatively simple, and hopefully failure-proof insulator process
170
- %% (This is cleaner than temporarily setting up the caller to trap
171
- %% signals, and does not affect the caller's mailbox or other state.)
172
- %%
173
- %% We assume that nobody does a 'kill' on an insulator process - if that
174
- %% should happen, the test framework will hang since the insulator will
175
- %% never send a reply; see below for more.
176
- %%
177
- %% Note that even if the insulator process itself never fails, it is
178
- %% still possible that it does not start properly, if it is spawned
179
- %% remotely (e.g., if the remote node is down). Therefore, remote
180
- %% insulators must always immediately send an {ok, Reference, self()}
181
- %% message to the parent as soon as it is spawned.
182
-
183
- %% @spec (Type, Fun::() -> term(), St::#procstate{}) -> ok
184
- %% Type = local | {remote, Node::atom()}
185
-
186
- insulator_process(Type, Fun, St0) ->
187
- process_flag(trap_exit, true),
188
- Parent = St0#procstate.parent,
189
- if Type == local -> ok;
190
- true -> Parent ! {ok, St0#procstate.ref, self()}
191
- end,
192
- St = St0#procstate{insulator = self()},
193
- Child = spawn_link(fun () -> child_process(Fun(St), St) end),
194
- insulator_wait(Child, Parent, [], St).
195
-
196
- %% Normally, child processes exit with the reason 'normal' even if the
197
- %% executed tests failed (by throwing exceptions), since the tests are
198
- %% executed within a try-block. Child processes can terminate abnormally
199
- %% by the following reasons:
200
- %% 1) an error in the processing of the test descriptors (a malformed
201
- %% descriptor, failure in a setup, cleanup or initialization, a
202
- %% missing module or function, or a failing generator function);
203
- %% 2) an internal error in the test running framework itself;
204
- %% 3) receiving a non-trapped error signal as a consequence of running
205
- %% test code.
206
- %% Those under point 1 are "expected errors", handled specially in the
207
- %% protocol, while the other two are unexpected errors. (Since alt. 3
208
- %% implies that the test neither reported success nor failure, it can
209
- %% never be considered "proper" behaviour of a test.) Abnormal
210
- %% termination is reported to the supervisor process but otherwise does
211
- %% not affect the insulator compared to normal termination. Child
212
- %% processes can also be killed abruptly by their insulators, in case of
213
- %% a timeout or if a parent process dies.
214
- %%
215
- %% The insulator is the group leader for the child process, and gets all
216
- %% of its standard I/O. The output is buffered and associated with the
217
- %% currently active test or group, and is sent along with the 'end'
218
- %% progress message when the test or group has finished.
219
-
220
- insulator_wait(Child, Parent, Buf, St) ->
221
- receive
222
- {io_request, From, ReplyAs, Req} when is_pid(From) ->
223
- Buf1 = io_request(From, ReplyAs, Req, hd(Buf)),
224
- insulator_wait(Child, Parent, [Buf1 | tl(Buf)], St);
225
- {progress, Child, Id, 'begin', Class} ->
226
- status_message(Id, {progress, 'begin', Class}, St),
227
- insulator_wait(Child, Parent, [[] | Buf], St);
228
- {progress, Child, Id, 'end', {Status, Time}} ->
229
- Msg = {Status, Time, lists:reverse(hd(Buf))},
230
- status_message(Id, {progress, 'end', Msg}, St),
231
- insulator_wait(Child, Parent, tl(Buf), St);
232
- {cancel, Child, Id, Reason} ->
233
- status_message(Id, {cancel, Reason}, St),
234
- insulator_wait(Child, Parent, Buf, St);
235
- {abort, Child, Id, Cause} ->
236
- exit_messages(Id, {abort, Cause}, St),
237
- %% no need to wait for the {'EXIT',Child,_} message
238
- terminate_insulator(St);
239
- {timeout, Child, Id} ->
240
- exit_messages(Id, timeout, St),
241
- kill_task(Child, St);
242
- {'EXIT', Child, normal} ->
243
- terminate_insulator(St);
244
- {'EXIT', Child, Reason} ->
245
- exit_messages(St#procstate.id, {exit, Reason}, St),
246
- terminate_insulator(St);
247
- {'EXIT', Parent, _} ->
248
- %% make sure child processes are cleaned up recursively
249
- kill_task(Child, St)
250
- end.
251
-
252
- kill_task(Child, St) ->
253
- exit(Child, kill),
254
- terminate_insulator(St).
255
-
256
- %% Unlinking before exit avoids polluting the parent process with exit
257
- %% signals from the insulator. The child process is already dead here.
258
-
259
- terminate_insulator(St) ->
260
- %% messaging/unlinking is ok even if the parent is already dead
261
- Parent = St#procstate.parent,
262
- Parent ! {done, St#procstate.ref, self()},
263
- unlink(Parent),
264
- exit(normal).
265
-
266
- %% send cancel messages for the Id of the "causing" item, and also for
267
- %% the Id of the insulator itself, if they are different
268
- exit_messages(Id, Cause, St) ->
269
- %% the message for the most specific Id is always sent first
270
- status_message(Id, {cancel, Cause}, St),
271
- case St#procstate.id of
272
- Id -> ok;
273
- Id1 -> status_message(Id1, {cancel, {blame, Id}}, St)
274
- end.
275
-
276
- %% Child processes send all messages via the insulator to ensure proper
277
- %% sequencing with timeouts and exit signals.
278
-
279
- abort_message(Cause, St) ->
280
- St#procstate.insulator ! {abort, self(), St#procstate.id, Cause}.
281
-
282
- cancel_message(Msg, St) ->
283
- St#procstate.insulator ! {cancel, self(), St#procstate.id, Msg}.
284
-
285
- progress_message(Type, Data, St) ->
286
- St#procstate.insulator ! {progress, self(), St#procstate.id,
287
- Type, Data}.
288
-
289
- %% Timeout handling
290
-
291
- set_timeout(Time, St) ->
292
- erlang:send_after(Time, St#procstate.insulator,
293
- {timeout, self(), St#procstate.id}).
294
-
295
- clear_timeout(Ref) ->
296
- erlang:cancel_timer(Ref).
297
-
298
- with_timeout(undefined, Default, F, St) ->
299
- with_timeout(Default, F, St);
300
- with_timeout(Time, _Default, F, St) ->
301
- with_timeout(Time, F, St).
302
-
303
- with_timeout(infinity, F, _St) ->
304
- %% don't start timers unnecessarily
305
- {T0, _} = statistics(wall_clock),
306
- Value = F(),
307
- {T1, _} = statistics(wall_clock),
308
- {Value, T1 - T0};
309
- with_timeout(Time, F, St) when is_integer(Time), Time > 16#FFFFffff ->
310
- with_timeout(16#FFFFffff, F, St);
311
- with_timeout(Time, F, St) when is_integer(Time), Time < 0 ->
312
- with_timeout(0, F, St);
313
- with_timeout(Time, F, St) when is_integer(Time) ->
314
- Ref = set_timeout(Time, St),
315
- {T0, _} = statistics(wall_clock),
316
- try F() of
317
- Value ->
318
- %% we could also read the timer, but this is simpler
319
- {T1, _} = statistics(wall_clock),
320
- {Value, T1 - T0}
321
- after
322
- clear_timeout(Ref)
323
- end.
324
-
325
- %% The normal behaviour of a child process is to trap exit signals. This
326
- %% makes it easier to write tests that spawn off separate (linked)
327
- %% processes and test whether they terminate as expected. The testing
328
- %% framework is not dependent on this, however, so the test code is
329
- %% allowed to disable signal trapping as it pleases.
330
- %% Note that I/O is redirected to the insulator process.
331
-
332
- %% @spec (() -> term(), #procstate{}) -> ok
333
-
334
- child_process(Fun, St) ->
335
- process_flag(trap_exit, true),
336
- group_leader(St#procstate.insulator, self()),
337
- try Fun() of
338
- _ -> ok
339
- catch
340
- %% the only "normal" way for a child process to bail out is to
341
- %% throw an {eunit_abort, Reason} exception; any other exception
342
- %% will be reported as an unexpected termination of the test
343
- {eunit_abort, Cause} ->
344
- abort_message(Cause, St),
345
- exit(aborted)
346
- end.
347
-
348
- %% @throws abortException()
349
- %% @type abortException() = {abort, Cause::term()}
350
-
351
- abort_task(Cause) ->
352
- throw({eunit_abort, Cause}).
353
-
354
- %% Typically, the process that executes this code is trapping signals,
355
- %% but it might not be - it is outside of our control, since test code
356
- %% could turn off trapping. That is why the insulator process of a task
357
- %% must be guaranteed to always send a reply before it terminates.
358
- %%
359
- %% The unique reference guarantees that we don't extract any message
360
- %% from the mailbox unless it belongs to the test framework (and not to
361
- %% the running tests) - it is not possible to use selective receive to
362
- %% match only messages tagged with some pid in a dynamically varying set
363
- %% of pids. When the wait-loop terminates, no such message should remain
364
- %% in the mailbox.
365
-
366
- wait_for_task(Pid, St) ->
367
- wait_for_tasks(sets:from_list([Pid]), St).
368
-
369
- wait_for_tasks(PidSet, St) ->
370
- case sets:size(PidSet) of
371
- 0 ->
372
- ok;
373
- _ ->
374
- %% (note that when we receive this message for some task, we
375
- %% are guaranteed that the insulator process of the task has
376
- %% already informed the supervisor about any anomalies)
377
- Reference = St#procstate.ref,
378
- receive
379
- {done, Reference, Pid} ->
380
- %% (if Pid is not in the set, del_element has no
381
- %% effect, so this is always safe)
382
- Rest = sets:del_element(Pid, PidSet),
383
- wait_for_tasks(Rest, St)
384
- end
385
- end.
386
-
387
-
388
- %% ---------------------------------------------------------------------
389
- %% Separate testing process
390
-
391
- tests(T, St) ->
392
- I = eunit_data:iter_init(T, St#procstate.id),
393
- case St#procstate.order of
394
- inorder -> tests_inorder(I, St);
395
- inparallel -> tests_inparallel(I, 0, St);
396
- {inparallel, N} when is_integer(N), N >= 0 ->
397
- tests_inparallel(I, N, St)
398
- end.
399
-
400
- set_id(I, St) ->
401
- St#procstate{id = eunit_data:iter_id(I)}.
402
-
403
- tests_inorder(I, St) ->
404
- tests_inorder(I, 0, St).
405
-
406
- tests_inorder(I, N, St) ->
407
- case get_next_item(I) of
408
- {T, I1} ->
409
- handle_item(T, set_id(I1, St)),
410
- tests_inorder(I1, N+1, St);
411
- none ->
412
- N
413
- end.
414
-
415
- tests_inparallel(I, K0, St) ->
416
- tests_inparallel(I, 0, St, K0, K0, sets:new()).
417
-
418
- tests_inparallel(I, N, St, K, K0, Children) when K =< 0, K0 > 0 ->
419
- wait_for_tasks(Children, St),
420
- tests_inparallel(I, N, St, K0, K0, sets:new());
421
- tests_inparallel(I, N, St, K, K0, Children) ->
422
- case get_next_item(I) of
423
- {T, I1} ->
424
- Child = spawn_item(T, set_id(I1, St)),
425
- tests_inparallel(I1, N+1, St, K - 1, K0,
426
- sets:add_element(Child, Children));
427
- none ->
428
- wait_for_tasks(Children, St),
429
- N
430
- end.
431
-
432
- spawn_item(T, St0) ->
433
- Fun = fun (St) ->
434
- fun () -> handle_item(T, St) end
435
- end,
436
- %% inparallel-items are always spawned locally
437
- start_task(local, Fun, St0).
438
-
439
- get_next_item(I) ->
440
- eunit_data:iter_next(I, fun abort_task/1).
441
-
442
- handle_item(T, St) ->
443
- case T of
444
- #test{} -> handle_test(T, St);
445
- #group{} -> handle_group(T, St)
446
- end.
447
-
448
- handle_test(T, St) ->
449
- progress_message('begin', test, St),
450
- {Status, Time} = with_timeout(T#test.timeout, ?DEFAULT_TEST_TIMEOUT,
451
- fun () -> run_test(T) end, St),
452
- progress_message('end', {Status, Time}, St),
453
- ok.
454
-
455
- %% @spec (#test{}) -> ok | {error, eunit_lib:exception()}
456
- %% | {skipped, eunit_test:wrapperError()}
457
-
458
- run_test(#test{f = F}) ->
459
- try eunit_test:run_testfun(F) of
460
- {ok, _Value} ->
461
- %% just throw away the return value
462
- ok;
463
- {error, Exception} ->
464
- {error, Exception}
465
- catch
466
- throw:WrapperError -> {skipped, WrapperError}
467
- end.
468
-
469
- set_group_order(#group{order = undefined}, St) ->
470
- St;
471
- set_group_order(#group{order = Order}, St) ->
472
- St#procstate{order = Order}.
473
-
474
- handle_group(T, St0) ->
475
- St = set_group_order(T, St0),
476
- case T#group.spawn of
477
- undefined ->
478
- run_group(T, St);
479
- Type ->
480
- Child = spawn_group(Type, T, St),
481
- wait_for_task(Child, St)
482
- end.
483
-
484
- spawn_group(Type, T, St0) ->
485
- Fun = fun (St) ->
486
- fun () -> run_group(T, St) end
487
- end,
488
- start_task(Type, Fun, St0).
489
-
490
- run_group(T, St) ->
491
- %% note that the setup/cleanup is outside the group timeout; if the
492
- %% setup fails, we do not start any timers
493
- Timeout = T#group.timeout,
494
- progress_message('begin', group, St),
495
- F = fun (T) -> enter_group(T, Timeout, St) end,
496
- try with_context(T, F) of
497
- {Status, Time} ->
498
- progress_message('end', {Status, Time}, St)
499
- catch
500
- throw:Cause ->
501
- cancel_message({abort, Cause}, St)
502
- end,
503
- ok.
504
-
505
- enter_group(T, Timeout, St) ->
506
- with_timeout(Timeout, ?DEFAULT_GROUP_TIMEOUT,
507
- fun () -> tests(T, St) end, St).
508
-
509
- with_context(#group{context = undefined, tests = T}, F) ->
510
- F(T);
511
- with_context(#group{context = #context{} = C, tests = I}, F) ->
512
- eunit_data:enter_context(C, I, F).
513
-
514
- %% Implementation of buffering I/O for the insulator process. (Note that
515
- %% each batch of characters is just pushed on the buffer, so it needs to
516
- %% be reversed when it is flushed.)
517
-
518
- io_request(From, ReplyAs, Req, Buf) ->
519
- {Reply, Buf1} = io_request(Req, Buf),
520
- io_reply(From, ReplyAs, Reply),
521
- Buf1.
522
-
523
- io_reply(From, ReplyAs, Reply) ->
524
- From ! {io_reply, ReplyAs, Reply}.
525
-
526
- io_request({put_chars, Chars}, Buf) ->
527
- {ok, [Chars | Buf]};
528
- io_request({put_chars, M, F, As}, Buf) ->
529
- try apply(M, F, As) of
530
- Chars -> {ok, [Chars | Buf]}
531
- catch
532
- C:T -> {{error, {C,T,erlang:get_stacktrace()}}, Buf}
533
- end;
534
- io_request({get_chars, _Prompt, _N}, Buf) ->
535
- {eof, Buf};
536
- io_request({get_chars, _Prompt, _M, _F, _Xs}, Buf) ->
537
- {eof, Buf};
538
- io_request({get_line, _Prompt}, Buf) ->
539
- {eof, Buf};
540
- io_request({get_until, _Prompt, _M, _F, _As}, Buf) ->
541
- {eof, Buf};
542
- io_request({setopts, _Opts}, Buf) ->
543
- {ok, Buf};
544
- io_request({requests, Reqs}, Buf) ->
545
- io_requests(Reqs, {ok, Buf});
546
- io_request(_, Buf) ->
547
- {{error, request}, Buf}.
548
-
549
- io_requests([R | Rs], {ok, Buf}) ->
550
- io_requests(Rs, io_request(R, Buf));
551
- io_requests(_, Result) ->
552
- Result.
@@ -1,157 +0,0 @@
1
- %% This library is free software; you can redistribute it and/or modify
2
- %% it under the terms of the GNU Lesser General Public License as
3
- %% published by the Free Software Foundation; either version 2 of the
4
- %% License, or (at your option) any later version.
5
- %%
6
- %% This library is distributed in the hope that it will be useful, but
7
- %% WITHOUT ANY WARRANTY; without even the implied warranty of
8
- %% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
9
- %% Lesser General Public License for more details.
10
- %%
11
- %% You should have received a copy of the GNU Lesser General Public
12
- %% License along with this library; if not, write to the Free Software
13
- %% Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
14
- %% USA
15
- %%
16
- %% $Id: eunit_serial.erl 249 2008-05-11 20:06:45Z rcarlsson $
17
- %%
18
- %% @author Richard Carlsson <richardc@it.uu.se>
19
- %% @copyright 2006 Richard Carlsson
20
- %% @private
21
- %% @see eunit
22
- %% @doc Event serializing process which works as an adapter and
23
- %% multiplexer for "supervisor" processes
24
-
25
- -module(eunit_serial).
26
-
27
- -include("eunit.hrl").
28
- -include("eunit_internal.hrl").
29
-
30
- -export([start/1]).
31
-
32
- %% Notes:
33
- %% * Due to concurrency, there are no guarantees that we will receive
34
- %% all status messages for the items within a group before we receive
35
- %% the 'end' message of the group itself.
36
- %%
37
- %% * A cancelling event may arrive at any time, and may concern items we
38
- %% are not yet expecting (if tests are executed in parallel), or may
39
- %% concern not only the current item but possibly a group ancestor of
40
- %% the current item (as in the case of a group timeout).
41
- %%
42
- %% * It is not possible to use selective receive to extract only those
43
- %% cancelling messages that affect the current item and its parents;
44
- %% basically, because we cannot have a dynamically computed prefix as a
45
- %% pattern in a receive. Hence, we must extract each cancelling event as
46
- %% it arrives and keep track of them separately.
47
- %%
48
- %% * Before we wait for a new item, we must check whether it (and thus
49
- %% also all its subitems, if any) is already cancelled.
50
- %%
51
- %% * When a new cancelling event arrives, we must either store it for
52
- %% future use, and/or cancel the current item and possibly one or more
53
- %% of its parent groups.
54
-
55
- -record(state, {listeners,
56
- cancelled = eunit_lib:trie_new(),
57
- messages = dict:new()}).
58
-
59
- start(Pids) ->
60
- spawn(fun () -> serializer(Pids) end).
61
-
62
- serializer(Pids) ->
63
- St = #state{listeners = sets:from_list(Pids),
64
- cancelled = eunit_lib:trie_new(),
65
- messages = dict:new()},
66
- item([], none, none, St),
67
- exit(normal).
68
-
69
- item(Id, ParentId, N0, St0) ->
70
- case wait(Id, 'begin', ParentId, N0, St0) of
71
- {none, St1} ->
72
- {true, St1};
73
- {{cancel, Done, undefined}, St1} ->
74
- {Done, cast({status, Id, {cancel, undefined}}, St1)};
75
- {{cancel, Done, Msg}, St1} ->
76
- {Done, cast(Msg, St1)};
77
- {{ok, Msg}, St1} ->
78
- %%?debugVal({got_begin, Id, Msg}),
79
- cast(Msg, St1),
80
- St2 = case Msg of
81
- {status, _, {progress, 'begin', group}} ->
82
- items(Id, 0, St1);
83
- _ -> St1
84
- end,
85
- case wait(Id, 'end', ParentId, N0, St2) of
86
- {{cancel, Done, undefined}, St3} ->
87
- {Done, cast({status, Id, {cancel, undefined}}, St3)};
88
- {{cancel, Done, Msg1}, St3} ->
89
- {Done, cast(Msg1, St3)};
90
- {{ok, Msg1}, St3} ->
91
- %%?debugVal({got_end, Id, Msg1}),
92
- {false, cast(Msg1, St3)}
93
- end
94
- end.
95
-
96
- items(ParentId, N0, St) ->
97
- N = N0 + 1,
98
- case item(ParentId ++ [N], ParentId, N0, St) of
99
- {false, St1} ->
100
- items(ParentId, N, St1);
101
- {true, St1} ->
102
- St1
103
- end.
104
-
105
- cast(M, St) ->
106
- sets:fold(fun (L, M) -> L ! M end, M, St#state.listeners),
107
- St.
108
-
109
- wait(Id, Type, ParentId, N0, St) ->
110
- %%?debugVal({wait, Id, Type}),
111
- case check_cancelled(Id, St) of
112
- no ->
113
- case recall(Id, St) of
114
- undefined ->
115
- wait_1(Id, Type, ParentId, N0, St);
116
- Msg ->
117
- {{ok, Msg}, forget(Id, St)}
118
- end;
119
- Why ->
120
- %%?debugVal({cancelled, Why, Id, ParentId}),
121
- Done = (Why =:= prefix),
122
- {{cancel, Done, recall(Id, St)}, forget(Id, St)}
123
- end.
124
-
125
- wait_1(Id, Type, ParentId, N0, St) ->
126
- receive
127
- {status, Id, {progress, Type, _}}=Msg ->
128
- %%?debugVal({Type, ParentId, Id}),
129
- {{ok, Msg}, St};
130
- {status,ParentId,{progress,'end',{N0,_,_}}}=Msg ->
131
- %%?debugVal({end_group, ParentId, Id}),
132
- {none, remember(ParentId, Msg, St)};
133
- {status, SomeId, {cancel, _Cause}}=Msg ->
134
- %%?debugVal({got_cancel, SomeId, ParentId, Id}),
135
- St1 = set_cancelled(SomeId, Msg, St),
136
- wait(Id, Type, ParentId, N0, St1)
137
- end.
138
-
139
- set_cancelled(Id, Msg, St0) ->
140
- St = remember(Id, Msg, St0),
141
- St#state{cancelled = eunit_lib:trie_store(Id, St0#state.cancelled)}.
142
-
143
- check_cancelled(Id, St) ->
144
- eunit_lib:trie_match(Id, St#state.cancelled).
145
-
146
- remember(Id, Msg, St) ->
147
- St#state{messages = dict:store(Id, Msg, St#state.messages)}.
148
-
149
- forget(Id, St) ->
150
- %% this is just to enable garbage collection of old messages
151
- St#state{messages = dict:store(Id, undefined, St#state.messages)}.
152
-
153
- recall(Id, St) ->
154
- case dict:find(Id, St#state.messages) of
155
- {ok, Msg} -> Msg;
156
- error -> undefined
157
- end.