rmm-chef 0.10.0.rc.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (441) hide show
  1. data/LICENSE +201 -0
  2. data/README.rdoc +171 -0
  3. data/bin/chef-client +26 -0
  4. data/bin/chef-solo +25 -0
  5. data/bin/knife +26 -0
  6. data/bin/shef +34 -0
  7. data/distro/README +2 -0
  8. data/distro/arch/etc/conf.d/chef-client.conf +5 -0
  9. data/distro/arch/etc/conf.d/chef-expander.conf +8 -0
  10. data/distro/arch/etc/conf.d/chef-server-webui.conf +10 -0
  11. data/distro/arch/etc/conf.d/chef-server.conf +10 -0
  12. data/distro/arch/etc/conf.d/chef-solr.conf +8 -0
  13. data/distro/arch/etc/rc.d/chef-client +76 -0
  14. data/distro/arch/etc/rc.d/chef-expander +78 -0
  15. data/distro/arch/etc/rc.d/chef-server +78 -0
  16. data/distro/arch/etc/rc.d/chef-server-webui +78 -0
  17. data/distro/arch/etc/rc.d/chef-solr +78 -0
  18. data/distro/common/html/chef-client.8.html +141 -0
  19. data/distro/common/html/chef-expander-cluster.8.html +164 -0
  20. data/distro/common/html/chef-expanderctl.8.html +146 -0
  21. data/distro/common/html/chef-server-webui.8.html +185 -0
  22. data/distro/common/html/chef-server.8.html +182 -0
  23. data/distro/common/html/chef-solo.8.html +191 -0
  24. data/distro/common/html/chef-solr.8.html +163 -0
  25. data/distro/common/html/knife-bootstrap.1.html +241 -0
  26. data/distro/common/html/knife-client.1.html +219 -0
  27. data/distro/common/html/knife-configure.1.html +170 -0
  28. data/distro/common/html/knife-cookbook-site.1.html +239 -0
  29. data/distro/common/html/knife-cookbook.1.html +373 -0
  30. data/distro/common/html/knife-data-bag.1.html +234 -0
  31. data/distro/common/html/knife-environment.1.html +267 -0
  32. data/distro/common/html/knife-exec.1.html +134 -0
  33. data/distro/common/html/knife-index.1.html +125 -0
  34. data/distro/common/html/knife-node.1.html +270 -0
  35. data/distro/common/html/knife-recipe.1.html +92 -0
  36. data/distro/common/html/knife-role.1.html +200 -0
  37. data/distro/common/html/knife-search.1.html +143 -0
  38. data/distro/common/html/knife-ssh.1.html +156 -0
  39. data/distro/common/html/knife-status.1.html +128 -0
  40. data/distro/common/html/knife-tag.1.html +137 -0
  41. data/distro/common/html/knife.1.html +295 -0
  42. data/distro/common/html/shef.1.html +283 -0
  43. data/distro/common/man/man1/knife-bootstrap.1 +189 -0
  44. data/distro/common/man/man1/knife-client.1 +99 -0
  45. data/distro/common/man/man1/knife-configure.1 +88 -0
  46. data/distro/common/man/man1/knife-cookbook-site.1 +137 -0
  47. data/distro/common/man/man1/knife-cookbook.1 +320 -0
  48. data/distro/common/man/man1/knife-data-bag.1 +130 -0
  49. data/distro/common/man/man1/knife-environment.1 +178 -0
  50. data/distro/common/man/man1/knife-exec.1 +46 -0
  51. data/distro/common/man/man1/knife-index.1 +29 -0
  52. data/distro/common/man/man1/knife-node.1 +154 -0
  53. data/distro/common/man/man1/knife-role.1 +88 -0
  54. data/distro/common/man/man1/knife-search.1 +61 -0
  55. data/distro/common/man/man1/knife-ssh.1 +74 -0
  56. data/distro/common/man/man1/knife-status.1 +29 -0
  57. data/distro/common/man/man1/knife-tag.1 +43 -0
  58. data/distro/common/man/man1/knife.1 +251 -0
  59. data/distro/common/man/man1/shef.1 +256 -0
  60. data/distro/common/man/man8/chef-client.8 +84 -0
  61. data/distro/common/man/man8/chef-expander-cluster.8 +97 -0
  62. data/distro/common/man/man8/chef-expanderctl.8 +62 -0
  63. data/distro/common/man/man8/chef-server-webui.8 +155 -0
  64. data/distro/common/man/man8/chef-server.8 +147 -0
  65. data/distro/common/man/man8/chef-solo.8 +158 -0
  66. data/distro/common/man/man8/chef-solr.8 +114 -0
  67. data/distro/common/markdown/README +3 -0
  68. data/distro/common/markdown/man1/knife-bootstrap.mkd +138 -0
  69. data/distro/common/markdown/man1/knife-client.mkd +103 -0
  70. data/distro/common/markdown/man1/knife-configure.mkd +70 -0
  71. data/distro/common/markdown/man1/knife-cookbook-site.mkd +119 -0
  72. data/distro/common/markdown/man1/knife-cookbook.mkd +253 -0
  73. data/distro/common/markdown/man1/knife-data-bag.mkd +117 -0
  74. data/distro/common/markdown/man1/knife-environment.mkd +151 -0
  75. data/distro/common/markdown/man1/knife-exec.mkd +37 -0
  76. data/distro/common/markdown/man1/knife-index.mkd +30 -0
  77. data/distro/common/markdown/man1/knife-node.mkd +147 -0
  78. data/distro/common/markdown/man1/knife-role.mkd +85 -0
  79. data/distro/common/markdown/man1/knife-search.mkd +55 -0
  80. data/distro/common/markdown/man1/knife-ssh.mkd +62 -0
  81. data/distro/common/markdown/man1/knife-status.mkd +36 -0
  82. data/distro/common/markdown/man1/knife-tag.mkd +39 -0
  83. data/distro/common/markdown/man1/knife.mkd +189 -0
  84. data/distro/common/markdown/man1/shef.mkd +189 -0
  85. data/distro/common/markdown/man8/chef-client.mkd +65 -0
  86. data/distro/common/markdown/man8/chef-expander-cluster.mkd +82 -0
  87. data/distro/common/markdown/man8/chef-expanderctl.mkd +58 -0
  88. data/distro/common/markdown/man8/chef-server-webui.mkd +121 -0
  89. data/distro/common/markdown/man8/chef-server.mkd +121 -0
  90. data/distro/common/markdown/man8/chef-solo.mkd +107 -0
  91. data/distro/common/markdown/man8/chef-solr.mkd +85 -0
  92. data/distro/debian/etc/default/chef-client +4 -0
  93. data/distro/debian/etc/default/chef-expander +8 -0
  94. data/distro/debian/etc/default/chef-server +9 -0
  95. data/distro/debian/etc/default/chef-server-webui +9 -0
  96. data/distro/debian/etc/default/chef-solr +8 -0
  97. data/distro/debian/etc/init.d/chef-client +175 -0
  98. data/distro/debian/etc/init.d/chef-expander +176 -0
  99. data/distro/debian/etc/init.d/chef-server +122 -0
  100. data/distro/debian/etc/init.d/chef-server-webui +123 -0
  101. data/distro/debian/etc/init.d/chef-solr +176 -0
  102. data/distro/debian/etc/init/chef-client.conf +17 -0
  103. data/distro/debian/etc/init/chef-expander.conf +17 -0
  104. data/distro/debian/etc/init/chef-server-webui.conf +17 -0
  105. data/distro/debian/etc/init/chef-server.conf +17 -0
  106. data/distro/debian/etc/init/chef-solr.conf +17 -0
  107. data/distro/redhat/etc/init.d/chef-client +106 -0
  108. data/distro/redhat/etc/init.d/chef-expander +104 -0
  109. data/distro/redhat/etc/init.d/chef-server +112 -0
  110. data/distro/redhat/etc/init.d/chef-server-webui +112 -0
  111. data/distro/redhat/etc/init.d/chef-solr +104 -0
  112. data/distro/redhat/etc/logrotate.d/chef-client +8 -0
  113. data/distro/redhat/etc/logrotate.d/chef-expander +8 -0
  114. data/distro/redhat/etc/logrotate.d/chef-server +8 -0
  115. data/distro/redhat/etc/logrotate.d/chef-server-webui +8 -0
  116. data/distro/redhat/etc/logrotate.d/chef-solr +8 -0
  117. data/distro/redhat/etc/sysconfig/chef-client +15 -0
  118. data/distro/redhat/etc/sysconfig/chef-expander +7 -0
  119. data/distro/redhat/etc/sysconfig/chef-server +14 -0
  120. data/distro/redhat/etc/sysconfig/chef-server-webui +14 -0
  121. data/distro/redhat/etc/sysconfig/chef-solr +8 -0
  122. data/lib/chef.rb +40 -0
  123. data/lib/chef/api_client.rb +265 -0
  124. data/lib/chef/application.rb +152 -0
  125. data/lib/chef/application/agent.rb +18 -0
  126. data/lib/chef/application/client.rb +280 -0
  127. data/lib/chef/application/knife.rb +188 -0
  128. data/lib/chef/application/solo.rb +218 -0
  129. data/lib/chef/applications.rb +4 -0
  130. data/lib/chef/certificate.rb +194 -0
  131. data/lib/chef/checksum.rb +182 -0
  132. data/lib/chef/checksum_cache.rb +189 -0
  133. data/lib/chef/client.rb +366 -0
  134. data/lib/chef/config.rb +244 -0
  135. data/lib/chef/cookbook/chefignore.rb +66 -0
  136. data/lib/chef/cookbook/cookbook_collection.rb +45 -0
  137. data/lib/chef/cookbook/cookbook_version_loader.rb +173 -0
  138. data/lib/chef/cookbook/file_system_file_vendor.rb +56 -0
  139. data/lib/chef/cookbook/file_vendor.rb +48 -0
  140. data/lib/chef/cookbook/metadata.rb +629 -0
  141. data/lib/chef/cookbook/remote_file_vendor.rb +87 -0
  142. data/lib/chef/cookbook/syntax_check.rb +136 -0
  143. data/lib/chef/cookbook_loader.rb +103 -0
  144. data/lib/chef/cookbook_site_streaming_uploader.rb +244 -0
  145. data/lib/chef/cookbook_uploader.rb +151 -0
  146. data/lib/chef/cookbook_version.rb +1071 -0
  147. data/lib/chef/cookbook_version_selector.rb +168 -0
  148. data/lib/chef/couchdb.rb +246 -0
  149. data/lib/chef/daemon.rb +172 -0
  150. data/lib/chef/data_bag.rb +223 -0
  151. data/lib/chef/data_bag_item.rb +267 -0
  152. data/lib/chef/encrypted_data_bag_item.rb +126 -0
  153. data/lib/chef/environment.rb +449 -0
  154. data/lib/chef/exceptions.rb +153 -0
  155. data/lib/chef/file_access_control.rb +144 -0
  156. data/lib/chef/file_cache.rb +218 -0
  157. data/lib/chef/handler.rb +206 -0
  158. data/lib/chef/handler/error_report.rb +40 -0
  159. data/lib/chef/handler/json_file.rb +58 -0
  160. data/lib/chef/index_queue.rb +29 -0
  161. data/lib/chef/index_queue/amqp_client.rb +116 -0
  162. data/lib/chef/index_queue/consumer.rb +76 -0
  163. data/lib/chef/index_queue/indexable.rb +109 -0
  164. data/lib/chef/json_compat.rb +52 -0
  165. data/lib/chef/knife.rb +548 -0
  166. data/lib/chef/knife/bootstrap.rb +228 -0
  167. data/lib/chef/knife/bootstrap/archlinux-gems.erb +48 -0
  168. data/lib/chef/knife/bootstrap/centos5-gems.erb +50 -0
  169. data/lib/chef/knife/bootstrap/fedora13-gems.erb +39 -0
  170. data/lib/chef/knife/bootstrap/ubuntu10.04-apt.erb +32 -0
  171. data/lib/chef/knife/bootstrap/ubuntu10.04-gems.erb +48 -0
  172. data/lib/chef/knife/client_bulk_delete.rb +43 -0
  173. data/lib/chef/knife/client_create.rb +73 -0
  174. data/lib/chef/knife/client_delete.rb +48 -0
  175. data/lib/chef/knife/client_edit.rb +48 -0
  176. data/lib/chef/knife/client_list.rb +43 -0
  177. data/lib/chef/knife/client_reregister.rb +59 -0
  178. data/lib/chef/knife/client_show.rb +53 -0
  179. data/lib/chef/knife/configure.rb +149 -0
  180. data/lib/chef/knife/configure_client.rb +52 -0
  181. data/lib/chef/knife/cookbook_bulk_delete.rb +72 -0
  182. data/lib/chef/knife/cookbook_create.rb +274 -0
  183. data/lib/chef/knife/cookbook_delete.rb +149 -0
  184. data/lib/chef/knife/cookbook_download.rb +134 -0
  185. data/lib/chef/knife/cookbook_list.rb +53 -0
  186. data/lib/chef/knife/cookbook_metadata.rb +107 -0
  187. data/lib/chef/knife/cookbook_metadata_from_file.rb +44 -0
  188. data/lib/chef/knife/cookbook_show.rb +102 -0
  189. data/lib/chef/knife/cookbook_site_download.rb +70 -0
  190. data/lib/chef/knife/cookbook_site_install.rb +148 -0
  191. data/lib/chef/knife/cookbook_site_list.rb +60 -0
  192. data/lib/chef/knife/cookbook_site_search.rb +51 -0
  193. data/lib/chef/knife/cookbook_site_share.rb +114 -0
  194. data/lib/chef/knife/cookbook_site_show.rb +57 -0
  195. data/lib/chef/knife/cookbook_site_unshare.rb +56 -0
  196. data/lib/chef/knife/cookbook_site_vendor.rb +46 -0
  197. data/lib/chef/knife/cookbook_test.rb +93 -0
  198. data/lib/chef/knife/cookbook_upload.rb +169 -0
  199. data/lib/chef/knife/core/cookbook_scm_repo.rb +149 -0
  200. data/lib/chef/knife/core/generic_presenter.rb +184 -0
  201. data/lib/chef/knife/core/node_editor.rb +127 -0
  202. data/lib/chef/knife/core/node_presenter.rb +103 -0
  203. data/lib/chef/knife/core/object_loader.rb +75 -0
  204. data/lib/chef/knife/core/subcommand_loader.rb +112 -0
  205. data/lib/chef/knife/core/text_formatter.rb +100 -0
  206. data/lib/chef/knife/core/ui.rb +211 -0
  207. data/lib/chef/knife/data_bag_create.rb +95 -0
  208. data/lib/chef/knife/data_bag_delete.rb +51 -0
  209. data/lib/chef/knife/data_bag_edit.rb +94 -0
  210. data/lib/chef/knife/data_bag_from_file.rb +91 -0
  211. data/lib/chef/knife/data_bag_list.rb +46 -0
  212. data/lib/chef/knife/data_bag_show.rb +81 -0
  213. data/lib/chef/knife/environment_create.rb +53 -0
  214. data/lib/chef/knife/environment_delete.rb +45 -0
  215. data/lib/chef/knife/environment_edit.rb +45 -0
  216. data/lib/chef/knife/environment_from_file.rb +50 -0
  217. data/lib/chef/knife/environment_list.rb +42 -0
  218. data/lib/chef/knife/environment_show.rb +46 -0
  219. data/lib/chef/knife/exec.rb +51 -0
  220. data/lib/chef/knife/help.rb +102 -0
  221. data/lib/chef/knife/index_rebuild.rb +50 -0
  222. data/lib/chef/knife/node_bulk_delete.rb +80 -0
  223. data/lib/chef/knife/node_create.rb +50 -0
  224. data/lib/chef/knife/node_delete.rb +47 -0
  225. data/lib/chef/knife/node_edit.rb +72 -0
  226. data/lib/chef/knife/node_from_file.rb +50 -0
  227. data/lib/chef/knife/node_list.rb +46 -0
  228. data/lib/chef/knife/node_run_list_add.rb +67 -0
  229. data/lib/chef/knife/node_run_list_remove.rb +48 -0
  230. data/lib/chef/knife/node_show.rb +68 -0
  231. data/lib/chef/knife/recipe_list.rb +32 -0
  232. data/lib/chef/knife/role_bulk_delete.rb +70 -0
  233. data/lib/chef/knife/role_create.rb +55 -0
  234. data/lib/chef/knife/role_delete.rb +47 -0
  235. data/lib/chef/knife/role_edit.rb +48 -0
  236. data/lib/chef/knife/role_from_file.rb +54 -0
  237. data/lib/chef/knife/role_list.rb +43 -0
  238. data/lib/chef/knife/role_show.rb +54 -0
  239. data/lib/chef/knife/search.rb +138 -0
  240. data/lib/chef/knife/ssh.rb +329 -0
  241. data/lib/chef/knife/status.rb +104 -0
  242. data/lib/chef/knife/tag_create.rb +52 -0
  243. data/lib/chef/knife/tag_delete.rb +60 -0
  244. data/lib/chef/knife/tag_list.rb +47 -0
  245. data/lib/chef/log.rb +39 -0
  246. data/lib/chef/mash.rb +211 -0
  247. data/lib/chef/mixin/check_helper.rb +31 -0
  248. data/lib/chef/mixin/checksum.rb +32 -0
  249. data/lib/chef/mixin/command.rb +221 -0
  250. data/lib/chef/mixin/command/unix.rb +215 -0
  251. data/lib/chef/mixin/command/windows.rb +76 -0
  252. data/lib/chef/mixin/convert_to_class_name.rb +63 -0
  253. data/lib/chef/mixin/create_path.rb +56 -0
  254. data/lib/chef/mixin/deep_merge.rb +225 -0
  255. data/lib/chef/mixin/deprecation.rb +65 -0
  256. data/lib/chef/mixin/from_file.rb +50 -0
  257. data/lib/chef/mixin/language.rb +165 -0
  258. data/lib/chef/mixin/language_include_attribute.rb +61 -0
  259. data/lib/chef/mixin/language_include_recipe.rb +52 -0
  260. data/lib/chef/mixin/params_validate.rb +225 -0
  261. data/lib/chef/mixin/recipe_definition_dsl_core.rb +78 -0
  262. data/lib/chef/mixin/shell_out.rb +41 -0
  263. data/lib/chef/mixin/template.rb +95 -0
  264. data/lib/chef/mixin/xml_escape.rb +140 -0
  265. data/lib/chef/mixins.rb +15 -0
  266. data/lib/chef/monkey_patches/dir.rb +36 -0
  267. data/lib/chef/monkey_patches/numeric.rb +7 -0
  268. data/lib/chef/monkey_patches/object.rb +9 -0
  269. data/lib/chef/monkey_patches/regexp.rb +34 -0
  270. data/lib/chef/monkey_patches/string.rb +28 -0
  271. data/lib/chef/monkey_patches/tempfile.rb +64 -0
  272. data/lib/chef/nil_argument.rb +3 -0
  273. data/lib/chef/node.rb +677 -0
  274. data/lib/chef/node/attribute.rb +487 -0
  275. data/lib/chef/openid_registration.rb +187 -0
  276. data/lib/chef/platform.rb +409 -0
  277. data/lib/chef/provider.rb +124 -0
  278. data/lib/chef/provider/breakpoint.rb +36 -0
  279. data/lib/chef/provider/cookbook_file.rb +100 -0
  280. data/lib/chef/provider/cron.rb +186 -0
  281. data/lib/chef/provider/cron/solaris.rb +195 -0
  282. data/lib/chef/provider/deploy.rb +343 -0
  283. data/lib/chef/provider/deploy/revision.rb +80 -0
  284. data/lib/chef/provider/deploy/timestamped.rb +33 -0
  285. data/lib/chef/provider/directory.rb +72 -0
  286. data/lib/chef/provider/env.rb +152 -0
  287. data/lib/chef/provider/env/windows.rb +75 -0
  288. data/lib/chef/provider/erl_call.rb +101 -0
  289. data/lib/chef/provider/execute.rb +65 -0
  290. data/lib/chef/provider/file.rb +222 -0
  291. data/lib/chef/provider/git.rb +230 -0
  292. data/lib/chef/provider/group.rb +133 -0
  293. data/lib/chef/provider/group/aix.rb +70 -0
  294. data/lib/chef/provider/group/dscl.rb +121 -0
  295. data/lib/chef/provider/group/gpasswd.rb +53 -0
  296. data/lib/chef/provider/group/groupadd.rb +81 -0
  297. data/lib/chef/provider/group/pw.rb +84 -0
  298. data/lib/chef/provider/group/usermod.rb +57 -0
  299. data/lib/chef/provider/group/windows.rb +79 -0
  300. data/lib/chef/provider/http_request.rb +122 -0
  301. data/lib/chef/provider/ifconfig.rb +134 -0
  302. data/lib/chef/provider/link.rb +164 -0
  303. data/lib/chef/provider/log.rb +54 -0
  304. data/lib/chef/provider/mdadm.rb +91 -0
  305. data/lib/chef/provider/mount.rb +114 -0
  306. data/lib/chef/provider/mount/mount.rb +232 -0
  307. data/lib/chef/provider/mount/windows.rb +81 -0
  308. data/lib/chef/provider/ohai.rb +42 -0
  309. data/lib/chef/provider/package.rb +164 -0
  310. data/lib/chef/provider/package/apt.rb +110 -0
  311. data/lib/chef/provider/package/dpkg.rb +112 -0
  312. data/lib/chef/provider/package/easy_install.rb +136 -0
  313. data/lib/chef/provider/package/freebsd.rb +122 -0
  314. data/lib/chef/provider/package/macports.rb +105 -0
  315. data/lib/chef/provider/package/pacman.rb +101 -0
  316. data/lib/chef/provider/package/portage.rb +135 -0
  317. data/lib/chef/provider/package/rpm.rb +101 -0
  318. data/lib/chef/provider/package/rubygems.rb +462 -0
  319. data/lib/chef/provider/package/solaris.rb +127 -0
  320. data/lib/chef/provider/package/yum-dump.py +128 -0
  321. data/lib/chef/provider/package/yum.rb +261 -0
  322. data/lib/chef/provider/package/zypper.rb +127 -0
  323. data/lib/chef/provider/remote_directory.rb +139 -0
  324. data/lib/chef/provider/remote_file.rb +118 -0
  325. data/lib/chef/provider/route.rb +193 -0
  326. data/lib/chef/provider/ruby_block.rb +34 -0
  327. data/lib/chef/provider/script.rb +55 -0
  328. data/lib/chef/provider/service.rb +122 -0
  329. data/lib/chef/provider/service/arch.rb +109 -0
  330. data/lib/chef/provider/service/debian.rb +130 -0
  331. data/lib/chef/provider/service/freebsd.rb +154 -0
  332. data/lib/chef/provider/service/gentoo.rb +53 -0
  333. data/lib/chef/provider/service/init.rb +71 -0
  334. data/lib/chef/provider/service/insserv.rb +52 -0
  335. data/lib/chef/provider/service/redhat.rb +60 -0
  336. data/lib/chef/provider/service/simple.rb +120 -0
  337. data/lib/chef/provider/service/solaris.rb +85 -0
  338. data/lib/chef/provider/service/upstart.rb +192 -0
  339. data/lib/chef/provider/service/windows.rb +146 -0
  340. data/lib/chef/provider/subversion.rb +197 -0
  341. data/lib/chef/provider/template.rb +104 -0
  342. data/lib/chef/provider/user.rb +186 -0
  343. data/lib/chef/provider/user/dscl.rb +280 -0
  344. data/lib/chef/provider/user/pw.rb +113 -0
  345. data/lib/chef/provider/user/useradd.rb +137 -0
  346. data/lib/chef/provider/user/windows.rb +124 -0
  347. data/lib/chef/providers.rb +93 -0
  348. data/lib/chef/recipe.rb +128 -0
  349. data/lib/chef/resource.rb +554 -0
  350. data/lib/chef/resource/apt_package.rb +34 -0
  351. data/lib/chef/resource/bash.rb +33 -0
  352. data/lib/chef/resource/breakpoint.rb +35 -0
  353. data/lib/chef/resource/cookbook_file.rb +45 -0
  354. data/lib/chef/resource/cron.rb +188 -0
  355. data/lib/chef/resource/csh.rb +33 -0
  356. data/lib/chef/resource/deploy.rb +371 -0
  357. data/lib/chef/resource/deploy_revision.rb +40 -0
  358. data/lib/chef/resource/directory.rb +76 -0
  359. data/lib/chef/resource/dpkg_package.rb +34 -0
  360. data/lib/chef/resource/easy_install_package.rb +57 -0
  361. data/lib/chef/resource/env.rb +58 -0
  362. data/lib/chef/resource/erl_call.rb +83 -0
  363. data/lib/chef/resource/execute.rb +127 -0
  364. data/lib/chef/resource/file.rb +99 -0
  365. data/lib/chef/resource/freebsd_package.rb +35 -0
  366. data/lib/chef/resource/gem_package.rb +53 -0
  367. data/lib/chef/resource/git.rb +37 -0
  368. data/lib/chef/resource/group.rb +70 -0
  369. data/lib/chef/resource/http_request.rb +61 -0
  370. data/lib/chef/resource/ifconfig.rb +134 -0
  371. data/lib/chef/resource/link.rb +78 -0
  372. data/lib/chef/resource/log.rb +62 -0
  373. data/lib/chef/resource/macports_package.rb +29 -0
  374. data/lib/chef/resource/mdadm.rb +82 -0
  375. data/lib/chef/resource/mount.rb +135 -0
  376. data/lib/chef/resource/ohai.rb +40 -0
  377. data/lib/chef/resource/package.rb +80 -0
  378. data/lib/chef/resource/pacman_package.rb +33 -0
  379. data/lib/chef/resource/perl.rb +33 -0
  380. data/lib/chef/resource/portage_package.rb +33 -0
  381. data/lib/chef/resource/python.rb +33 -0
  382. data/lib/chef/resource/remote_directory.rb +109 -0
  383. data/lib/chef/resource/remote_file.rb +83 -0
  384. data/lib/chef/resource/route.rb +135 -0
  385. data/lib/chef/resource/rpm_package.rb +34 -0
  386. data/lib/chef/resource/ruby.rb +33 -0
  387. data/lib/chef/resource/ruby_block.rb +40 -0
  388. data/lib/chef/resource/scm.rb +147 -0
  389. data/lib/chef/resource/script.rb +60 -0
  390. data/lib/chef/resource/service.rb +160 -0
  391. data/lib/chef/resource/solaris_package.rb +36 -0
  392. data/lib/chef/resource/subversion.rb +36 -0
  393. data/lib/chef/resource/template.rb +69 -0
  394. data/lib/chef/resource/timestamped_deploy.rb +31 -0
  395. data/lib/chef/resource/user.rb +130 -0
  396. data/lib/chef/resource/yum_package.rb +43 -0
  397. data/lib/chef/resource_collection.rb +217 -0
  398. data/lib/chef/resource_collection/stepable_iterator.rb +124 -0
  399. data/lib/chef/resource_definition.rb +67 -0
  400. data/lib/chef/resource_definition_list.rb +38 -0
  401. data/lib/chef/resources.rb +64 -0
  402. data/lib/chef/rest.rb +392 -0
  403. data/lib/chef/rest/auth_credentials.rb +71 -0
  404. data/lib/chef/rest/cookie_jar.rb +31 -0
  405. data/lib/chef/rest/rest_request.rb +213 -0
  406. data/lib/chef/role.rb +342 -0
  407. data/lib/chef/run_context.rb +126 -0
  408. data/lib/chef/run_list.rb +165 -0
  409. data/lib/chef/run_list/run_list_expansion.rb +193 -0
  410. data/lib/chef/run_list/run_list_item.rb +92 -0
  411. data/lib/chef/run_list/versioned_recipe_list.rb +68 -0
  412. data/lib/chef/run_status.rb +121 -0
  413. data/lib/chef/runner.rb +92 -0
  414. data/lib/chef/sandbox.rb +153 -0
  415. data/lib/chef/search/query.rb +65 -0
  416. data/lib/chef/shef.rb +327 -0
  417. data/lib/chef/shef/ext.rb +569 -0
  418. data/lib/chef/shef/model_wrapper.rb +120 -0
  419. data/lib/chef/shef/shef_rest.rb +28 -0
  420. data/lib/chef/shef/shef_session.rb +284 -0
  421. data/lib/chef/shell_out.rb +250 -0
  422. data/lib/chef/shell_out/unix.rb +223 -0
  423. data/lib/chef/shell_out/windows.rb +98 -0
  424. data/lib/chef/solr_query.rb +187 -0
  425. data/lib/chef/solr_query/lucene.treetop +150 -0
  426. data/lib/chef/solr_query/lucene_nodes.rb +285 -0
  427. data/lib/chef/solr_query/query_transform.rb +65 -0
  428. data/lib/chef/solr_query/solr_http_request.rb +118 -0
  429. data/lib/chef/streaming_cookbook_uploader.rb +201 -0
  430. data/lib/chef/tasks/chef_repo.rake +330 -0
  431. data/lib/chef/util/file_edit.rb +122 -0
  432. data/lib/chef/util/windows.rb +56 -0
  433. data/lib/chef/util/windows/net_group.rb +101 -0
  434. data/lib/chef/util/windows/net_use.rb +121 -0
  435. data/lib/chef/util/windows/net_user.rb +198 -0
  436. data/lib/chef/util/windows/volume.rb +59 -0
  437. data/lib/chef/version.rb +23 -0
  438. data/lib/chef/version_class.rb +70 -0
  439. data/lib/chef/version_constraint.rb +116 -0
  440. data/lib/chef/webui_user.rb +231 -0
  441. metadata +759 -0
@@ -0,0 +1,215 @@
1
+ #
2
+ # Author:: Adam Jacob (<adam@opscode.com>)
3
+ # Copyright:: Copyright (c) 2008 Opscode, Inc.
4
+ # License:: Apache License, Version 2.0
5
+ #
6
+ # Licensed under the Apache License, Version 2.0 (the "License");
7
+ # you may not use this file except in compliance with the License.
8
+ # You may obtain a copy of the License at
9
+ #
10
+ # http://www.apache.org/licenses/LICENSE-2.0
11
+ #
12
+ # Unless required by applicable law or agreed to in writing, software
13
+ # distributed under the License is distributed on an "AS IS" BASIS,
14
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15
+ # See the License for the specific language governing permissions and
16
+ # limitations under the License.
17
+ #
18
+
19
+ class Chef
20
+ module Mixin
21
+ module Command
22
+ module Unix
23
+ # This is taken directly from Ara T Howard's Open4 library, and then
24
+ # modified to suit the needs of Chef. Any bugs here are most likely
25
+ # my own, and not Ara's.
26
+ #
27
+ # The original appears in external/open4.rb in its unmodified form.
28
+ #
29
+ # Thanks Ara!
30
+ def popen4(cmd, args={}, &b)
31
+
32
+ # Waitlast - this is magic.
33
+ #
34
+ # Do we wait for the child process to die before we yield
35
+ # to the block, or after? That is the magic of waitlast.
36
+ #
37
+ # By default, we are waiting before we yield the block.
38
+ args[:waitlast] ||= false
39
+
40
+ args[:user] ||= nil
41
+ unless args[:user].kind_of?(Integer)
42
+ args[:user] = Etc.getpwnam(args[:user]).uid if args[:user]
43
+ end
44
+ args[:group] ||= nil
45
+ unless args[:group].kind_of?(Integer)
46
+ args[:group] = Etc.getgrnam(args[:group]).gid if args[:group]
47
+ end
48
+ args[:environment] ||= {}
49
+
50
+ # Default on C locale so parsing commands output can be done
51
+ # independently of the node's default locale.
52
+ # "LC_ALL" could be set to nil, in which case we also must ignore it.
53
+ unless args[:environment].has_key?("LC_ALL")
54
+ args[:environment]["LC_ALL"] = "C"
55
+ end
56
+
57
+ pw, pr, pe, ps = IO.pipe, IO.pipe, IO.pipe, IO.pipe
58
+
59
+ verbose = $VERBOSE
60
+ begin
61
+ $VERBOSE = nil
62
+ ps.last.fcntl(Fcntl::F_SETFD, Fcntl::FD_CLOEXEC)
63
+
64
+ cid = fork {
65
+ pw.last.close
66
+ STDIN.reopen pw.first
67
+ pw.first.close
68
+
69
+ pr.first.close
70
+ STDOUT.reopen pr.last
71
+ pr.last.close
72
+
73
+ pe.first.close
74
+ STDERR.reopen pe.last
75
+ pe.last.close
76
+
77
+ STDOUT.sync = STDERR.sync = true
78
+
79
+ if args[:group]
80
+ Process.egid = args[:group]
81
+ Process.gid = args[:group]
82
+ end
83
+
84
+ if args[:user]
85
+ Process.euid = args[:user]
86
+ Process.uid = args[:user]
87
+ end
88
+
89
+ args[:environment].each do |key,value|
90
+ ENV[key] = value
91
+ end
92
+
93
+ if args[:umask]
94
+ umask = ((args[:umask].respond_to?(:oct) ? args[:umask].oct : args[:umask].to_i) & 007777)
95
+ File.umask(umask)
96
+ end
97
+
98
+ begin
99
+ if cmd.kind_of?(Array)
100
+ exec(*cmd)
101
+ else
102
+ exec(cmd)
103
+ end
104
+ raise 'forty-two'
105
+ rescue Exception => e
106
+ Marshal.dump(e, ps.last)
107
+ ps.last.flush
108
+ end
109
+ ps.last.close unless (ps.last.closed?)
110
+ exit!
111
+ }
112
+ ensure
113
+ $VERBOSE = verbose
114
+ end
115
+
116
+ [pw.first, pr.last, pe.last, ps.last].each{|fd| fd.close}
117
+
118
+ begin
119
+ e = Marshal.load ps.first
120
+ raise(Exception === e ? e : "unknown failure!")
121
+ rescue EOFError # If we get an EOF error, then the exec was successful
122
+ 42
123
+ ensure
124
+ ps.first.close
125
+ end
126
+
127
+ pw.last.sync = true
128
+
129
+ pi = [pw.last, pr.first, pe.first]
130
+
131
+ if b
132
+ begin
133
+ if args[:waitlast]
134
+ b[cid, *pi]
135
+ # send EOF so that if the child process is reading from STDIN
136
+ # it will actually finish up and exit
137
+ pi[0].close_write
138
+ Process.waitpid2(cid).last
139
+ else
140
+ # This took some doing.
141
+ # The trick here is to close STDIN
142
+ # Then set our end of the childs pipes to be O_NONBLOCK
143
+ # Then wait for the child to die, which means any IO it
144
+ # wants to do must be done - it's dead. If it isn't,
145
+ # it's because something totally skanky is happening,
146
+ # and we don't care.
147
+ o = StringIO.new
148
+ e = StringIO.new
149
+
150
+ pi[0].close
151
+
152
+ stdout = pi[1]
153
+ stderr = pi[2]
154
+
155
+ stdout.sync = true
156
+ stderr.sync = true
157
+
158
+ stdout.fcntl(Fcntl::F_SETFL, pi[1].fcntl(Fcntl::F_GETFL) | Fcntl::O_NONBLOCK)
159
+ stderr.fcntl(Fcntl::F_SETFL, pi[2].fcntl(Fcntl::F_GETFL) | Fcntl::O_NONBLOCK)
160
+
161
+ stdout_finished = false
162
+ stderr_finished = false
163
+
164
+ results = nil
165
+
166
+ while !stdout_finished || !stderr_finished
167
+ begin
168
+ channels_to_watch = []
169
+ channels_to_watch << stdout if !stdout_finished
170
+ channels_to_watch << stderr if !stderr_finished
171
+ ready = IO.select(channels_to_watch, nil, nil, 1.0)
172
+ rescue Errno::EAGAIN
173
+ ensure
174
+ results = Process.waitpid2(cid, Process::WNOHANG)
175
+ if results
176
+ stdout_finished = true
177
+ stderr_finished = true
178
+ end
179
+ end
180
+
181
+ if ready && ready.first.include?(stdout)
182
+ line = results ? stdout.gets(nil) : stdout.gets
183
+ if line
184
+ o.write(line)
185
+ else
186
+ stdout_finished = true
187
+ end
188
+ end
189
+ if ready && ready.first.include?(stderr)
190
+ line = results ? stderr.gets(nil) : stderr.gets
191
+ if line
192
+ e.write(line)
193
+ else
194
+ stderr_finished = true
195
+ end
196
+ end
197
+ end
198
+ results = Process.waitpid2(cid) unless results
199
+ o.rewind
200
+ e.rewind
201
+ b[cid, pi[0], o, e]
202
+ results.last
203
+ end
204
+ ensure
205
+ pi.each{|fd| fd.close unless fd.closed?}
206
+ end
207
+ else
208
+ [cid, pw.last, pr.first, pe.first]
209
+ end
210
+ end
211
+
212
+ end
213
+ end
214
+ end
215
+ end
@@ -0,0 +1,76 @@
1
+ #
2
+ # Author:: Adam Jacob (<adam@opscode.com>)
3
+ # Copyright:: Copyright (c) 2008 Opscode, Inc.
4
+ # Author:: Doug MacEachern (<dougm@vmware.com>)
5
+ # Copyright:: Copyright (c) 2010 VMware, Inc.
6
+ # License:: Apache License, Version 2.0
7
+ #
8
+ # Licensed under the Apache License, Version 2.0 (the "License");
9
+ # you may not use this file except in compliance with the License.
10
+ # You may obtain a copy of the License at
11
+ #
12
+ # http://www.apache.org/licenses/LICENSE-2.0
13
+ #
14
+ # Unless required by applicable law or agreed to in writing, software
15
+ # distributed under the License is distributed on an "AS IS" BASIS,
16
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
17
+ # See the License for the specific language governing permissions and
18
+ # limitations under the License.
19
+ #
20
+
21
+ if RUBY_VERSION =~ /^1\.8/
22
+ require 'win32/open3'
23
+ else
24
+ require 'open3'
25
+ end
26
+
27
+ class Chef
28
+ module Mixin
29
+ module Command
30
+ module Windows
31
+ def popen4(cmd, args={}, &b)
32
+
33
+ # By default, we are waiting before we yield the block.
34
+ args[:waitlast] ||= false
35
+
36
+ #XXX :user, :group, :environment support?
37
+
38
+ Open4.popen4(cmd) do |stdin,stdout,stderr,cid|
39
+ if b
40
+ if args[:waitlast]
41
+ b[cid, stdin, stdout, stderr]
42
+ # send EOF so that if the child process is reading from STDIN
43
+ # it will actually finish up and exit
44
+ stdin.close_write
45
+ else
46
+ o = StringIO.new
47
+ e = StringIO.new
48
+
49
+ stdin.close
50
+
51
+ stdout.sync = true
52
+ stderr.sync = true
53
+
54
+ line = stdout.gets(nil)
55
+ if line
56
+ o.write(line)
57
+ end
58
+ line = stderr.gets(nil)
59
+ if line
60
+ e.write(line)
61
+ end
62
+ o.rewind
63
+ e.rewind
64
+ b[cid, stdin, o, e]
65
+ end
66
+ else
67
+ [cid, stdin, stdout, stderr]
68
+ end
69
+ end
70
+ $?
71
+ end
72
+
73
+ end
74
+ end
75
+ end
76
+ end
@@ -0,0 +1,63 @@
1
+ #
2
+ # Author:: Adam Jacob (<adam@opscode.com>)
3
+ # Author:: Christopher Walters (<cw@opscode.com>)
4
+ # Copyright:: Copyright (c) 2008, 2009 Opscode, Inc.
5
+ # License:: Apache License, Version 2.0
6
+ #
7
+ # Licensed under the Apache License, Version 2.0 (the "License");
8
+ # you may not use this file except in compliance with the License.
9
+ # You may obtain a copy of the License at
10
+ #
11
+ # http://www.apache.org/licenses/LICENSE-2.0
12
+ #
13
+ # Unless required by applicable law or agreed to in writing, software
14
+ # distributed under the License is distributed on an "AS IS" BASIS,
15
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16
+ # See the License for the specific language governing permissions and
17
+ # limitations under the License.
18
+ #
19
+
20
+ class Chef
21
+ module Mixin
22
+ module ConvertToClassName
23
+ extend self
24
+
25
+ def convert_to_class_name(str)
26
+ rname = nil
27
+ regexp = %r{^(.+?)(_(.+))?$}
28
+
29
+ mn = str.match(regexp)
30
+ if mn
31
+ rname = mn[1].capitalize
32
+
33
+ while mn && mn[3]
34
+ mn = mn[3].match(regexp)
35
+ rname << mn[1].capitalize if mn
36
+ end
37
+ end
38
+
39
+ rname
40
+ end
41
+
42
+ def convert_to_snake_case(str, namespace=nil)
43
+ str = str.dup
44
+ str.sub!(/^#{namespace}(\:\:)?/, '') if namespace
45
+ str.gsub!(/[A-Z]/) {|s| "_" + s}
46
+ str.downcase!
47
+ str.sub!(/^\_/, "")
48
+ str
49
+ end
50
+
51
+ def snake_case_basename(str)
52
+ with_namespace = convert_to_snake_case(str)
53
+ with_namespace.split("::").last.sub(/^_/, '')
54
+ end
55
+
56
+ def filename_to_qualified_string(base, filename)
57
+ file_base = File.basename(filename, ".rb")
58
+ base.to_s + (file_base == 'default' ? '' : "_#{file_base}")
59
+ end
60
+
61
+ end
62
+ end
63
+ end
@@ -0,0 +1,56 @@
1
+ #
2
+ # Author:: Adam Jacob (<adam@opscode.com>)
3
+ # Copyright:: Copyright (c) 2008 Opscode, Inc.
4
+ # License:: Apache License, Version 2.0
5
+ #
6
+ # Licensed under the Apache License, Version 2.0 (the "License");
7
+ # you may not use this file except in compliance with the License.
8
+ # You may obtain a copy of the License at
9
+ #
10
+ # http://www.apache.org/licenses/LICENSE-2.0
11
+ #
12
+ # Unless required by applicable law or agreed to in writing, software
13
+ # distributed under the License is distributed on an "AS IS" BASIS,
14
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15
+ # See the License for the specific language governing permissions and
16
+ # limitations under the License.
17
+
18
+ class Chef
19
+ module Mixin
20
+ module CreatePath
21
+
22
+ # Creates a given path, including all directories that lead up to it.
23
+ # Like mkdir_p, but without the leaking.
24
+ #
25
+ # === Parameters
26
+ # file_path<String, Array>:: A string that represents the path to create,
27
+ # or an Array with the path-parts.
28
+ #
29
+ # === Returns
30
+ # The created file_path.
31
+ def create_path(file_path)
32
+ unless file_path.kind_of?(String) || file_path.kind_of?(Array)
33
+ raise ArgumentError, "file_path must be a string or an array!"
34
+ end
35
+
36
+ if file_path.kind_of?(String)
37
+ file_path = File.expand_path(file_path).split(File::SEPARATOR)
38
+ file_path.shift if file_path[0] = ''
39
+ unless file_path[0].match("^#{File::SEPARATOR}")
40
+ file_path[0] = "#{File::SEPARATOR}#{file_path[0]}"
41
+ end
42
+ end
43
+
44
+ file_path.each_index do |i|
45
+ create_path = File.join(file_path[0, i + 1])
46
+ unless File.directory?(create_path)
47
+ Chef::Log.debug("Creating directory #{create_path}")
48
+ Dir.mkdir(create_path)
49
+ end
50
+ end
51
+ File.expand_path(File.join(file_path))
52
+ end
53
+
54
+ end
55
+ end
56
+ end
@@ -0,0 +1,225 @@
1
+ #
2
+ # Author:: Adam Jacob (<adam@opscode.com>)
3
+ # Author:: Steve Midgley (http://www.misuse.org/science)
4
+ # Copyright:: Copyright (c) 2009 Opscode, Inc.
5
+ # Copyright:: Copyright (c) 2008 Steve Midgley
6
+ # License:: Apache License, Version 2.0
7
+ #
8
+ # Licensed under the Apache License, Version 2.0 (the "License");
9
+ # you may not use this file except in compliance with the License.
10
+ # You may obtain a copy of the License at
11
+ #
12
+ # http://www.apache.org/licenses/LICENSE-2.0
13
+ #
14
+ # Unless required by applicable law or agreed to in writing, software
15
+ # distributed under the License is distributed on an "AS IS" BASIS,
16
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
17
+ # See the License for the specific language governing permissions and
18
+ # limitations under the License.
19
+
20
+ class Chef
21
+ module Mixin
22
+ # == Chef::Mixin::DeepMerge
23
+ # Implements a deep merging algorithm for nested data structures.
24
+ # ==== Notice:
25
+ # This code is imported from deep_merge by Steve Midgley. deep_merge is
26
+ # available under the MIT license from
27
+ # http://trac.misuse.org/science/wiki/DeepMerge
28
+ module DeepMerge
29
+ def self.merge(first, second)
30
+ first = Mash.new(first) unless first.kind_of?(Mash)
31
+ second = Mash.new(second) unless second.kind_of?(Mash)
32
+
33
+ DeepMerge.deep_merge!(second, first, {:knockout_prefix => "!merge:", :preserve_unmergeables => false})
34
+ end
35
+
36
+ class InvalidParameter < StandardError; end
37
+
38
+ DEFAULT_FIELD_KNOCKOUT_PREFIX = '--' unless defined?(DEFAULT_FIELD_KNOCKOUT_PREFIX)
39
+
40
+ # Deep Merge core documentation.
41
+ # deep_merge! method permits merging of arbitrary child elements. The two top level
42
+ # elements must be hashes. These hashes can contain unlimited (to stack limit) levels
43
+ # of child elements. These child elements to not have to be of the same types.
44
+ # Where child elements are of the same type, deep_merge will attempt to merge them together.
45
+ # Where child elements are not of the same type, deep_merge will skip or optionally overwrite
46
+ # the destination element with the contents of the source element at that level.
47
+ # So if you have two hashes like this:
48
+ # source = {:x => [1,2,3], :y => 2}
49
+ # dest = {:x => [4,5,'6'], :y => [7,8,9]}
50
+ # dest.deep_merge!(source)
51
+ # Results: {:x => [1,2,3,4,5,'6'], :y => 2}
52
+ # By default, "deep_merge!" will overwrite any unmergeables and merge everything else.
53
+ # To avoid this, use "deep_merge" (no bang/exclamation mark)
54
+ #
55
+ # Options:
56
+ # Options are specified in the last parameter passed, which should be in hash format:
57
+ # hash.deep_merge!({:x => [1,2]}, {:knockout_prefix => '--'})
58
+ # :preserve_unmergeables DEFAULT: false
59
+ # Set to true to skip any unmergeable elements from source
60
+ # :knockout_prefix DEFAULT: nil
61
+ # Set to string value to signify prefix which deletes elements from existing element
62
+ # :sort_merged_arrays DEFAULT: false
63
+ # Set to true to sort all arrays that are merged together
64
+ # :unpack_arrays DEFAULT: nil
65
+ # Set to string value to run "Array::join" then "String::split" against all arrays
66
+ # :merge_debug DEFAULT: false
67
+ # Set to true to get console output of merge process for debugging
68
+ #
69
+ # Selected Options Details:
70
+ # :knockout_prefix => The purpose of this is to provide a way to remove elements
71
+ # from existing Hash by specifying them in a special way in incoming hash
72
+ # source = {:x => ['--1', '2']}
73
+ # dest = {:x => ['1', '3']}
74
+ # dest.ko_deep_merge!(source)
75
+ # Results: {:x => ['2','3']}
76
+ # Additionally, if the knockout_prefix is passed alone as a string, it will cause
77
+ # the entire element to be removed:
78
+ # source = {:x => '--'}
79
+ # dest = {:x => [1,2,3]}
80
+ # dest.ko_deep_merge!(source)
81
+ # Results: {:x => ""}
82
+ # :unpack_arrays => The purpose of this is to permit compound elements to be passed
83
+ # in as strings and to be converted into discrete array elements
84
+ # irsource = {:x => ['1,2,3', '4']}
85
+ # dest = {:x => ['5','6','7,8']}
86
+ # dest.deep_merge!(source, {:unpack_arrays => ','})
87
+ # Results: {:x => ['1','2','3','4','5','6','7','8'}
88
+ # Why: If receiving data from an HTML form, this makes it easy for a checkbox
89
+ # to pass multiple values from within a single HTML element
90
+ #
91
+ # There are many tests for this library - and you can learn more about the features
92
+ # and usages of deep_merge! by just browsing the test examples
93
+ def self.deep_merge!(source, dest, options = {})
94
+ # turn on this line for stdout debugging text
95
+ merge_debug = options[:merge_debug] || false
96
+ overwrite_unmergeable = !options[:preserve_unmergeables]
97
+ knockout_prefix = options[:knockout_prefix] || nil
98
+ raise InvalidParameter, "knockout_prefix cannot be an empty string in deep_merge!" if knockout_prefix == ""
99
+ raise InvalidParameter, "overwrite_unmergeable must be true if knockout_prefix is specified in deep_merge!" if knockout_prefix && !overwrite_unmergeable
100
+ # if present: we will split and join arrays on this char before merging
101
+ array_split_char = options[:unpack_arrays] || false
102
+ # request that we sort together any arrays when they are merged
103
+ sort_merged_arrays = options[:sort_merged_arrays] || false
104
+ di = options[:debug_indent] || ''
105
+ # do nothing if source is nil
106
+ return dest if source.nil?
107
+ # if dest doesn't exist, then simply copy source to it
108
+ if dest.nil? && overwrite_unmergeable
109
+ dest = source; return dest
110
+ end
111
+
112
+ puts "#{di}Source class: #{source.class.inspect} :: Dest class: #{dest.class.inspect}" if merge_debug
113
+ if source.kind_of?(Hash)
114
+ puts "#{di}Hashes: #{source.inspect} :: #{dest.inspect}" if merge_debug
115
+ source.each do |src_key, src_value|
116
+ if dest.kind_of?(Hash)
117
+ puts "#{di} looping: #{src_key.inspect} => #{src_value.inspect} :: #{dest.inspect}" if merge_debug
118
+ if dest[src_key]
119
+ puts "#{di} ==>merging: #{src_key.inspect} => #{src_value.inspect} :: #{dest[src_key].inspect}" if merge_debug
120
+ dest[src_key] = deep_merge!(src_value, dest[src_key], options.merge(:debug_indent => di + ' '))
121
+ else # dest[src_key] doesn't exist so we want to create and overwrite it (but we do this via deep_merge!)
122
+ puts "#{di} ==>merging over: #{src_key.inspect} => #{src_value.inspect}" if merge_debug
123
+ # note: we rescue here b/c some classes respond to "dup" but don't implement it (Numeric, TrueClass, FalseClass, NilClass among maybe others)
124
+ begin
125
+ src_dup = src_value.dup # we dup src_value if possible because we're going to merge into it (since dest is empty)
126
+ rescue TypeError
127
+ src_dup = src_value
128
+ end
129
+ dest[src_key] = deep_merge!(src_value, src_dup, options.merge(:debug_indent => di + ' '))
130
+ end
131
+ else # dest isn't a hash, so we overwrite it completely (if permitted)
132
+ if overwrite_unmergeable
133
+ puts "#{di} overwriting dest: #{src_key.inspect} => #{src_value.inspect} -over-> #{dest.inspect}" if merge_debug
134
+ dest = overwrite_unmergeables(source, dest, options)
135
+ end
136
+ end
137
+ end
138
+ elsif source.kind_of?(Array)
139
+ puts "#{di}Arrays: #{source.inspect} :: #{dest.inspect}" if merge_debug
140
+ # if we are instructed, join/split any source arrays before processing
141
+ if array_split_char
142
+ puts "#{di} split/join on source: #{source.inspect}" if merge_debug
143
+ source = source.join(array_split_char).split(array_split_char)
144
+ if dest.kind_of?(Array)
145
+ dest = dest.join(array_split_char).split(array_split_char)
146
+ end
147
+ end
148
+ # if there's a naked knockout_prefix in source, that means we are to truncate dest
149
+ if source.index(knockout_prefix)
150
+ dest = clear_or_nil(dest); source.delete(knockout_prefix)
151
+ end
152
+ if dest.kind_of?(Array)
153
+ if knockout_prefix
154
+ print "#{di} knocking out: " if merge_debug
155
+ # remove knockout prefix items from both source and dest
156
+ source.delete_if do |ko_item|
157
+ retval = false
158
+ item = ko_item.respond_to?(:gsub) ? ko_item.gsub(%r{^#{knockout_prefix}}, "") : ko_item
159
+ if item != ko_item
160
+ print "#{ko_item} - " if merge_debug
161
+ dest.delete(item)
162
+ dest.delete(ko_item)
163
+ retval = true
164
+ end
165
+ retval
166
+ end
167
+ puts if merge_debug
168
+ end
169
+ puts "#{di} merging arrays: #{source.inspect} :: #{dest.inspect}" if merge_debug
170
+ dest = dest | source
171
+ dest.sort! if sort_merged_arrays
172
+ elsif overwrite_unmergeable
173
+ puts "#{di} overwriting dest: #{source.inspect} -over-> #{dest.inspect}" if merge_debug
174
+ dest = overwrite_unmergeables(source, dest, options)
175
+ end
176
+ else # src_hash is not an array or hash, so we'll have to overwrite dest
177
+ puts "#{di}Others: #{source.inspect} :: #{dest.inspect}" if merge_debug
178
+ dest = overwrite_unmergeables(source, dest, options)
179
+ end
180
+ puts "#{di}Returning #{dest.inspect}" if merge_debug
181
+ dest
182
+ end # deep_merge!
183
+
184
+ # allows deep_merge! to uniformly handle overwriting of unmergeable entities
185
+ def self.overwrite_unmergeables(source, dest, options)
186
+ merge_debug = options[:merge_debug] || false
187
+ overwrite_unmergeable = !options[:preserve_unmergeables]
188
+ knockout_prefix = options[:knockout_prefix] || false
189
+ di = options[:debug_indent] || ''
190
+ if knockout_prefix && overwrite_unmergeable
191
+ if source.kind_of?(String) # remove knockout string from source before overwriting dest
192
+ src_tmp = source.gsub(%r{^#{knockout_prefix}},"")
193
+ elsif source.kind_of?(Array) # remove all knockout elements before overwriting dest
194
+ src_tmp = source.delete_if {|ko_item| ko_item.kind_of?(String) && ko_item.match(%r{^#{knockout_prefix}}) }
195
+ else
196
+ src_tmp = source
197
+ end
198
+ if src_tmp == source # if we didn't find a knockout_prefix then we just overwrite dest
199
+ puts "#{di}#{src_tmp.inspect} -over-> #{dest.inspect}" if merge_debug
200
+ dest = src_tmp
201
+ else # if we do find a knockout_prefix, then we just delete dest
202
+ puts "#{di}\"\" -over-> #{dest.inspect}" if merge_debug
203
+ dest = ""
204
+ end
205
+ elsif overwrite_unmergeable
206
+ dest = source
207
+ end
208
+ dest
209
+ end
210
+
211
+ def self.clear_or_nil(obj)
212
+ if obj.respond_to?(:clear)
213
+ obj.clear
214
+ else
215
+ obj = nil
216
+ end
217
+ obj
218
+ end
219
+
220
+ end
221
+
222
+ end
223
+ end
224
+
225
+