chef-dk 0.8.0 → 0.9.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (299) hide show
  1. checksums.yaml +4 -4
  2. data/CONTRIBUTING.md +190 -190
  3. data/Gemfile +26 -0
  4. data/LICENSE +201 -201
  5. data/README.md +276 -276
  6. data/Rakefile +18 -18
  7. data/bin/chef +25 -25
  8. data/lib/chef-dk.rb +19 -19
  9. data/lib/chef-dk/authenticated_http.rb +40 -40
  10. data/lib/chef-dk/builtin_commands.rb +60 -60
  11. data/lib/chef-dk/chef_runner.rb +98 -98
  12. data/lib/chef-dk/cli.rb +200 -200
  13. data/lib/chef-dk/command/base.rb +79 -75
  14. data/lib/chef-dk/command/clean_policy_cookbooks.rb +116 -116
  15. data/lib/chef-dk/command/clean_policy_revisions.rb +113 -113
  16. data/lib/chef-dk/command/delete_policy.rb +122 -122
  17. data/lib/chef-dk/command/delete_policy_group.rb +122 -122
  18. data/lib/chef-dk/command/diff.rb +316 -316
  19. data/lib/chef-dk/command/env.rb +90 -90
  20. data/lib/chef-dk/command/exec.rb +45 -45
  21. data/lib/chef-dk/command/export.rb +151 -153
  22. data/lib/chef-dk/command/gem.rb +47 -47
  23. data/lib/chef-dk/command/generate.rb +120 -118
  24. data/lib/chef-dk/command/generator_commands.rb +80 -80
  25. data/lib/chef-dk/command/generator_commands/app.rb +107 -107
  26. data/lib/chef-dk/command/generator_commands/attribute.rb +37 -37
  27. data/lib/chef-dk/command/generator_commands/base.rb +121 -121
  28. data/lib/chef-dk/command/generator_commands/cookbook.rb +119 -108
  29. data/lib/chef-dk/command/generator_commands/cookbook_code_file.rb +100 -100
  30. data/lib/chef-dk/command/generator_commands/cookbook_file.rb +45 -45
  31. data/lib/chef-dk/command/generator_commands/generator_generator.rb +177 -0
  32. data/lib/chef-dk/command/generator_commands/lwrp.rb +36 -36
  33. data/lib/chef-dk/command/generator_commands/policyfile.rb +86 -83
  34. data/lib/chef-dk/command/generator_commands/recipe.rb +36 -36
  35. data/lib/chef-dk/command/generator_commands/repo.rb +96 -96
  36. data/lib/chef-dk/command/generator_commands/template.rb +46 -46
  37. data/lib/chef-dk/command/install.rb +121 -121
  38. data/lib/chef-dk/command/provision.rb +438 -438
  39. data/lib/chef-dk/command/push.rb +118 -118
  40. data/lib/chef-dk/command/push_archive.rb +126 -126
  41. data/lib/chef-dk/command/shell_init.rb +180 -180
  42. data/lib/chef-dk/command/show_policy.rb +165 -165
  43. data/lib/chef-dk/command/undelete.rb +155 -155
  44. data/lib/chef-dk/command/update.rb +129 -129
  45. data/lib/chef-dk/command/verify.rb +490 -453
  46. data/lib/chef-dk/commands_map.rb +115 -115
  47. data/lib/chef-dk/completions/bash.sh.erb +5 -5
  48. data/lib/chef-dk/completions/chef.fish.erb +10 -10
  49. data/lib/chef-dk/completions/zsh.zsh.erb +21 -21
  50. data/lib/chef-dk/component_test.rb +171 -171
  51. data/lib/chef-dk/configurable.rb +57 -52
  52. data/lib/chef-dk/cookbook_metadata.rb +45 -45
  53. data/lib/chef-dk/cookbook_omnifetch.rb +32 -32
  54. data/lib/chef-dk/cookbook_profiler/git.rb +151 -151
  55. data/lib/chef-dk/cookbook_profiler/identifiers.rb +72 -72
  56. data/lib/chef-dk/cookbook_profiler/null_scm.rb +32 -32
  57. data/lib/chef-dk/exceptions.rb +113 -113
  58. data/lib/chef-dk/generator.rb +163 -162
  59. data/lib/chef-dk/helpers.rb +159 -159
  60. data/lib/chef-dk/pager.rb +106 -106
  61. data/lib/chef-dk/policyfile/chef_repo_cookbook_source.rb +122 -122
  62. data/lib/chef-dk/policyfile/chef_server_cookbook_source.rb +54 -54
  63. data/lib/chef-dk/policyfile/community_cookbook_source.rb +82 -82
  64. data/lib/chef-dk/policyfile/comparison_base.rb +124 -124
  65. data/lib/chef-dk/policyfile/cookbook_location_specification.rb +133 -133
  66. data/lib/chef-dk/policyfile/cookbook_locks.rb +466 -466
  67. data/lib/chef-dk/policyfile/cookbook_sources.rb +21 -21
  68. data/lib/chef-dk/policyfile/differ.rb +266 -266
  69. data/lib/chef-dk/policyfile/dsl.rb +197 -197
  70. data/lib/chef-dk/policyfile/lister.rb +232 -232
  71. data/lib/chef-dk/policyfile/null_cookbook_source.rb +45 -45
  72. data/lib/chef-dk/policyfile/read_cookbook_for_compat_mode_upload.rb +124 -124
  73. data/lib/chef-dk/policyfile/reports/install.rb +70 -70
  74. data/lib/chef-dk/policyfile/reports/table_printer.rb +58 -58
  75. data/lib/chef-dk/policyfile/reports/upload.rb +70 -70
  76. data/lib/chef-dk/policyfile/solution_dependencies.rb +298 -298
  77. data/lib/chef-dk/policyfile/storage_config.rb +100 -100
  78. data/lib/chef-dk/policyfile/undo_record.rb +142 -142
  79. data/lib/chef-dk/policyfile/undo_stack.rb +130 -130
  80. data/lib/chef-dk/policyfile/uploader.rb +213 -213
  81. data/lib/chef-dk/policyfile_compiler.rb +322 -322
  82. data/lib/chef-dk/policyfile_lock.rb +552 -552
  83. data/lib/chef-dk/policyfile_services/clean_policies.rb +95 -95
  84. data/lib/chef-dk/policyfile_services/clean_policy_cookbooks.rb +125 -125
  85. data/lib/chef-dk/policyfile_services/export_repo.rb +309 -281
  86. data/lib/chef-dk/policyfile_services/install.rb +125 -125
  87. data/lib/chef-dk/policyfile_services/push.rb +114 -114
  88. data/lib/chef-dk/policyfile_services/push_archive.rb +173 -173
  89. data/lib/chef-dk/policyfile_services/rm_policy.rb +142 -142
  90. data/lib/chef-dk/policyfile_services/rm_policy_group.rb +86 -86
  91. data/lib/chef-dk/policyfile_services/show_policy.rb +237 -237
  92. data/lib/chef-dk/policyfile_services/undelete.rb +108 -108
  93. data/lib/chef-dk/policyfile_services/update_attributes.rb +104 -104
  94. data/lib/chef-dk/service_exception_inspectors.rb +25 -25
  95. data/lib/chef-dk/service_exception_inspectors/base.rb +40 -40
  96. data/lib/chef-dk/service_exception_inspectors/http.rb +121 -121
  97. data/lib/chef-dk/service_exceptions.rb +143 -143
  98. data/lib/chef-dk/shell_out.rb +36 -36
  99. data/lib/chef-dk/skeletons/code_generator/files/default/Berksfile +3 -3
  100. data/lib/chef-dk/skeletons/code_generator/files/default/chefignore +100 -100
  101. data/lib/chef-dk/skeletons/code_generator/files/default/cookbook_readmes/README-policy.md +9 -9
  102. data/lib/chef-dk/skeletons/code_generator/files/default/cookbook_readmes/README.md +54 -54
  103. data/lib/chef-dk/skeletons/code_generator/files/default/gitignore +16 -16
  104. data/lib/chef-dk/skeletons/code_generator/files/default/repo/README.md +28 -28
  105. data/lib/chef-dk/skeletons/code_generator/files/default/repo/cookbooks/example/README.md +27 -0
  106. data/lib/chef-dk/skeletons/code_generator/files/default/repo/cookbooks/example/attributes/default.rb +7 -7
  107. data/lib/chef-dk/skeletons/code_generator/files/default/repo/cookbooks/example/metadata.rb +3 -3
  108. data/lib/chef-dk/skeletons/code_generator/files/default/repo/cookbooks/example/recipes/default.rb +8 -8
  109. data/lib/chef-dk/skeletons/code_generator/files/default/repo/data_bags/README.md +57 -57
  110. data/lib/chef-dk/skeletons/code_generator/files/default/repo/data_bags/example/example_item.json +3 -3
  111. data/lib/chef-dk/skeletons/code_generator/files/default/repo/environments/README.md +9 -9
  112. data/lib/chef-dk/skeletons/code_generator/files/default/repo/environments/example.json +12 -12
  113. data/lib/chef-dk/skeletons/code_generator/files/default/repo/roles/README.md +8 -8
  114. data/lib/chef-dk/skeletons/code_generator/files/default/repo/roles/example.json +12 -12
  115. data/lib/chef-dk/skeletons/code_generator/files/default/serverspec_spec_helper.rb +8 -3
  116. data/lib/chef-dk/skeletons/code_generator/files/default/spec_helper.rb +2 -2
  117. data/lib/chef-dk/skeletons/code_generator/metadata.rb +8 -8
  118. data/lib/chef-dk/skeletons/code_generator/recipes/app.rb +97 -97
  119. data/lib/chef-dk/skeletons/code_generator/recipes/attribute.rb +12 -12
  120. data/lib/chef-dk/skeletons/code_generator/recipes/cookbook.rb +104 -92
  121. data/lib/chef-dk/skeletons/code_generator/recipes/cookbook_file.rb +24 -24
  122. data/lib/chef-dk/skeletons/code_generator/recipes/lwrp.rb +23 -23
  123. data/lib/chef-dk/skeletons/code_generator/recipes/policyfile.rb +8 -8
  124. data/lib/chef-dk/skeletons/code_generator/recipes/recipe.rb +27 -27
  125. data/lib/chef-dk/skeletons/code_generator/recipes/repo.rb +48 -47
  126. data/lib/chef-dk/skeletons/code_generator/recipes/template.rb +32 -32
  127. data/lib/chef-dk/skeletons/code_generator/templates/default/LICENSE.all_rights.erb +3 -3
  128. data/lib/chef-dk/skeletons/code_generator/templates/default/LICENSE.apache2.erb +201 -201
  129. data/lib/chef-dk/skeletons/code_generator/templates/default/LICENSE.gplv2.erb +339 -339
  130. data/lib/chef-dk/skeletons/code_generator/templates/default/LICENSE.gplv3.erb +674 -674
  131. data/lib/chef-dk/skeletons/code_generator/templates/default/LICENSE.mit.erb +21 -21
  132. data/lib/chef-dk/skeletons/code_generator/templates/default/Policyfile.rb.erb +20 -16
  133. data/lib/chef-dk/skeletons/code_generator/templates/default/README.md.erb +4 -4
  134. data/lib/chef-dk/skeletons/code_generator/templates/default/kitchen.yml.erb +16 -16
  135. data/lib/chef-dk/skeletons/code_generator/templates/default/kitchen_policyfile.yml.erb +27 -0
  136. data/lib/chef-dk/skeletons/code_generator/templates/default/metadata.rb.erb +7 -7
  137. data/lib/chef-dk/skeletons/code_generator/templates/default/recipe.rb.erb +5 -5
  138. data/lib/chef-dk/skeletons/code_generator/templates/default/recipe_spec.rb.erb +20 -20
  139. data/lib/chef-dk/skeletons/code_generator/templates/default/repo/gitignore.erb +11 -11
  140. data/lib/chef-dk/skeletons/code_generator/templates/default/serverspec_default_spec.rb.erb +9 -9
  141. data/lib/chef-dk/ui.rb +58 -58
  142. data/lib/chef-dk/version.rb +20 -20
  143. data/lib/kitchen/provisioner/policyfile_zero.rb +193 -164
  144. data/spec/shared/a_file_generator.rb +125 -125
  145. data/spec/shared/a_generated_file.rb +12 -12
  146. data/spec/shared/command_with_ui_object.rb +11 -11
  147. data/spec/shared/custom_generator_cookbook.rb +117 -117
  148. data/spec/shared/fixture_cookbook_checksums.rb +47 -47
  149. data/spec/shared/setup_git_cookbooks.rb +53 -53
  150. data/spec/spec_helper.rb +49 -48
  151. data/spec/test_helpers.rb +84 -84
  152. data/spec/unit/chef_runner_spec.rb +111 -110
  153. data/spec/unit/cli_spec.rb +357 -357
  154. data/spec/unit/command/base_spec.rb +169 -136
  155. data/spec/unit/command/clean_policy_cookbooks_spec.rb +181 -181
  156. data/spec/unit/command/clean_policy_revisions_spec.rb +181 -181
  157. data/spec/unit/command/delete_policy_group_spec.rb +207 -207
  158. data/spec/unit/command/delete_policy_spec.rb +207 -207
  159. data/spec/unit/command/diff_spec.rb +312 -312
  160. data/spec/unit/command/env_spec.rb +52 -52
  161. data/spec/unit/command/exec_spec.rb +179 -179
  162. data/spec/unit/command/export_spec.rb +189 -189
  163. data/spec/unit/command/generate_spec.rb +142 -142
  164. data/spec/unit/command/generator_commands/app_spec.rb +169 -169
  165. data/spec/unit/command/generator_commands/attribute_spec.rb +32 -32
  166. data/spec/unit/command/generator_commands/cookbook_file_spec.rb +32 -32
  167. data/spec/unit/command/generator_commands/cookbook_spec.rb +320 -240
  168. data/spec/unit/command/generator_commands/generator_generator_spec.rb +229 -0
  169. data/spec/unit/command/generator_commands/lwrp_spec.rb +32 -32
  170. data/spec/unit/command/generator_commands/policyfile_spec.rb +125 -125
  171. data/spec/unit/command/generator_commands/recipe_spec.rb +34 -34
  172. data/spec/unit/command/generator_commands/repo_spec.rb +283 -283
  173. data/spec/unit/command/generator_commands/template_spec.rb +32 -32
  174. data/spec/unit/command/install_spec.rb +179 -179
  175. data/spec/unit/command/provision_spec.rb +592 -592
  176. data/spec/unit/command/push_archive_spec.rb +153 -153
  177. data/spec/unit/command/push_spec.rb +199 -199
  178. data/spec/unit/command/shell_init_spec.rb +329 -329
  179. data/spec/unit/command/show_policy_spec.rb +235 -235
  180. data/spec/unit/command/undelete_spec.rb +246 -246
  181. data/spec/unit/command/update_spec.rb +251 -251
  182. data/spec/unit/command/verify_spec.rb +323 -322
  183. data/spec/unit/commands_map_spec.rb +57 -57
  184. data/spec/unit/component_test_spec.rb +126 -126
  185. data/spec/unit/cookbook_metadata_spec.rb +98 -98
  186. data/spec/unit/cookbook_profiler/git_spec.rb +176 -176
  187. data/spec/unit/cookbook_profiler/identifiers_spec.rb +83 -83
  188. data/spec/unit/fixtures/chef-runner-cookbooks/test_cookbook/recipes/recipe_one.rb +9 -9
  189. data/spec/unit/fixtures/chef-runner-cookbooks/test_cookbook/recipes/recipe_two.rb +9 -9
  190. data/spec/unit/fixtures/command/cli_test_command.rb +26 -26
  191. data/spec/unit/fixtures/command/explicit_path_example.rb +7 -7
  192. data/spec/unit/fixtures/cookbook_cache/baz-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/.kitchen.yml +16 -16
  193. data/spec/unit/fixtures/cookbook_cache/baz-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/Berksfile +3 -3
  194. data/spec/unit/fixtures/cookbook_cache/baz-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/README.md +4 -4
  195. data/spec/unit/fixtures/cookbook_cache/baz-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/chefignore +96 -96
  196. data/spec/unit/fixtures/cookbook_cache/baz-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/metadata.rb +8 -8
  197. data/spec/unit/fixtures/cookbook_cache/baz-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/recipes/default.rb +8 -8
  198. data/spec/unit/fixtures/cookbook_cache/dep_of_bar-1.2.3/.kitchen.yml +16 -16
  199. data/spec/unit/fixtures/cookbook_cache/dep_of_bar-1.2.3/Berksfile +3 -3
  200. data/spec/unit/fixtures/cookbook_cache/dep_of_bar-1.2.3/README.md +4 -4
  201. data/spec/unit/fixtures/cookbook_cache/dep_of_bar-1.2.3/chefignore +96 -96
  202. data/spec/unit/fixtures/cookbook_cache/dep_of_bar-1.2.3/metadata.rb +8 -8
  203. data/spec/unit/fixtures/cookbook_cache/dep_of_bar-1.2.3/recipes/default.rb +8 -8
  204. data/spec/unit/fixtures/cookbook_cache/foo-1.0.0/.kitchen.yml +16 -16
  205. data/spec/unit/fixtures/cookbook_cache/foo-1.0.0/Berksfile +3 -3
  206. data/spec/unit/fixtures/cookbook_cache/foo-1.0.0/README.md +4 -4
  207. data/spec/unit/fixtures/cookbook_cache/foo-1.0.0/chefignore +96 -96
  208. data/spec/unit/fixtures/cookbook_cache/foo-1.0.0/metadata.rb +8 -8
  209. data/spec/unit/fixtures/cookbook_cache/foo-1.0.0/recipes/default.rb +8 -8
  210. data/spec/unit/fixtures/cookbooks_api/pruned_small_universe.json +1321 -1321
  211. data/spec/unit/fixtures/cookbooks_api/small_universe.json +2987 -2987
  212. data/spec/unit/fixtures/cookbooks_api/universe.json +1 -1
  213. data/spec/unit/fixtures/cookbooks_api/update_fixtures.rb +36 -36
  214. data/spec/unit/fixtures/dev_cookbooks/README.md +16 -16
  215. data/spec/unit/fixtures/eg_omnibus_dir/valid/embedded/apps/berkshelf/integration_test +2 -2
  216. data/spec/unit/fixtures/eg_omnibus_dir/valid/embedded/apps/berkshelf/verify_me +5 -5
  217. data/spec/unit/fixtures/eg_omnibus_dir/valid/embedded/apps/chef/verify_me +3 -3
  218. data/spec/unit/fixtures/eg_omnibus_dir/valid/embedded/apps/test-kitchen/verify_me +2 -2
  219. data/spec/unit/fixtures/example_cookbook/.gitignore +17 -17
  220. data/spec/unit/fixtures/example_cookbook/.kitchen.yml +16 -16
  221. data/spec/unit/fixtures/example_cookbook/Berksfile +3 -3
  222. data/spec/unit/fixtures/example_cookbook/README.md +4 -4
  223. data/spec/unit/fixtures/example_cookbook/chefignore +96 -96
  224. data/spec/unit/fixtures/example_cookbook/metadata.rb +8 -8
  225. data/spec/unit/fixtures/example_cookbook/recipes/default.rb +8 -8
  226. data/spec/unit/fixtures/example_cookbook_metadata_json_only/.gitignore +17 -17
  227. data/spec/unit/fixtures/example_cookbook_metadata_json_only/.kitchen.yml +16 -16
  228. data/spec/unit/fixtures/example_cookbook_metadata_json_only/Berksfile +3 -3
  229. data/spec/unit/fixtures/example_cookbook_metadata_json_only/README.md +4 -4
  230. data/spec/unit/fixtures/example_cookbook_metadata_json_only/chefignore +96 -96
  231. data/spec/unit/fixtures/example_cookbook_metadata_json_only/metadata.json +5 -5
  232. data/spec/unit/fixtures/example_cookbook_metadata_json_only/recipes/default.rb +8 -8
  233. data/spec/unit/fixtures/example_cookbook_no_metadata/.gitignore +17 -17
  234. data/spec/unit/fixtures/example_cookbook_no_metadata/.kitchen.yml +16 -16
  235. data/spec/unit/fixtures/example_cookbook_no_metadata/Berksfile +3 -3
  236. data/spec/unit/fixtures/example_cookbook_no_metadata/README.md +4 -4
  237. data/spec/unit/fixtures/example_cookbook_no_metadata/chefignore +96 -96
  238. data/spec/unit/fixtures/example_cookbook_no_metadata/recipes/default.rb +8 -8
  239. data/spec/unit/fixtures/local_path_cookbooks/another-local-cookbook/README.md +4 -4
  240. data/spec/unit/fixtures/local_path_cookbooks/another-local-cookbook/chefignore +96 -96
  241. data/spec/unit/fixtures/local_path_cookbooks/another-local-cookbook/metadata.rb +8 -8
  242. data/spec/unit/fixtures/local_path_cookbooks/another-local-cookbook/recipes/default.rb +8 -8
  243. data/spec/unit/fixtures/local_path_cookbooks/cookbook-with-a-dep/Berksfile +3 -3
  244. data/spec/unit/fixtures/local_path_cookbooks/cookbook-with-a-dep/README.md +4 -4
  245. data/spec/unit/fixtures/local_path_cookbooks/cookbook-with-a-dep/chefignore +96 -96
  246. data/spec/unit/fixtures/local_path_cookbooks/cookbook-with-a-dep/metadata.rb +9 -9
  247. data/spec/unit/fixtures/local_path_cookbooks/cookbook-with-a-dep/recipes/default.rb +8 -8
  248. data/spec/unit/fixtures/local_path_cookbooks/local-cookbook/.kitchen.yml +16 -16
  249. data/spec/unit/fixtures/local_path_cookbooks/local-cookbook/Berksfile +3 -3
  250. data/spec/unit/fixtures/local_path_cookbooks/local-cookbook/README.md +4 -4
  251. data/spec/unit/fixtures/local_path_cookbooks/local-cookbook/chefignore +96 -96
  252. data/spec/unit/fixtures/local_path_cookbooks/local-cookbook/metadata.rb +8 -8
  253. data/spec/unit/fixtures/local_path_cookbooks/local-cookbook/recipes/default.rb +8 -8
  254. data/spec/unit/fixtures/local_path_cookbooks/metadata-missing/README.md +2 -2
  255. data/spec/unit/fixtures/local_path_cookbooks/noignore-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/.kitchen.yml +16 -16
  256. data/spec/unit/fixtures/local_path_cookbooks/noignore-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/README.md +4 -4
  257. data/spec/unit/fixtures/local_path_cookbooks/noignore-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/metadata.rb +8 -8
  258. data/spec/unit/fixtures/local_path_cookbooks/noignore-f59ee7a5bca6a4e606b67f7f856b768d847c39bb/recipes/default.rb +8 -8
  259. data/spec/unit/generator_spec.rb +120 -120
  260. data/spec/unit/helpers_spec.rb +92 -92
  261. data/spec/unit/pager_spec.rb +119 -119
  262. data/spec/unit/policyfile/chef_repo_cookbook_source_spec.rb +66 -66
  263. data/spec/unit/policyfile/chef_server_cookbook_source_spec.rb +34 -34
  264. data/spec/unit/policyfile/community_cookbook_source_spec.rb +51 -51
  265. data/spec/unit/policyfile/comparison_base_spec.rb +343 -343
  266. data/spec/unit/policyfile/cookbook_location_specification_spec.rb +252 -252
  267. data/spec/unit/policyfile/cookbook_locks_spec.rb +529 -529
  268. data/spec/unit/policyfile/differ_spec.rb +687 -687
  269. data/spec/unit/policyfile/lister_spec.rb +272 -272
  270. data/spec/unit/policyfile/null_cookbook_source_spec.rb +35 -35
  271. data/spec/unit/policyfile/read_cookbook_for_compat_mode_upload_spec.rb +92 -92
  272. data/spec/unit/policyfile/reports/install_spec.rb +115 -115
  273. data/spec/unit/policyfile/reports/upload_spec.rb +96 -96
  274. data/spec/unit/policyfile/solution_dependencies_spec.rb +145 -145
  275. data/spec/unit/policyfile/storage_config_spec.rb +172 -172
  276. data/spec/unit/policyfile/undo_record_spec.rb +260 -260
  277. data/spec/unit/policyfile/undo_stack_spec.rb +266 -266
  278. data/spec/unit/policyfile/uploader_spec.rb +410 -410
  279. data/spec/unit/policyfile_demands_spec.rb +876 -876
  280. data/spec/unit/policyfile_evaluation_spec.rb +441 -441
  281. data/spec/unit/policyfile_lock_build_spec.rb +1056 -1056
  282. data/spec/unit/policyfile_lock_install_spec.rb +138 -138
  283. data/spec/unit/policyfile_lock_serialization_spec.rb +425 -425
  284. data/spec/unit/policyfile_lock_validation_spec.rb +611 -611
  285. data/spec/unit/policyfile_services/clean_policies_spec.rb +236 -236
  286. data/spec/unit/policyfile_services/clean_policy_cookbooks_spec.rb +275 -275
  287. data/spec/unit/policyfile_services/export_repo_spec.rb +439 -416
  288. data/spec/unit/policyfile_services/install_spec.rb +191 -191
  289. data/spec/unit/policyfile_services/push_archive_spec.rb +345 -345
  290. data/spec/unit/policyfile_services/push_spec.rb +233 -233
  291. data/spec/unit/policyfile_services/rm_policy_group_spec.rb +241 -241
  292. data/spec/unit/policyfile_services/rm_policy_spec.rb +266 -266
  293. data/spec/unit/policyfile_services/show_policy_spec.rb +889 -889
  294. data/spec/unit/policyfile_services/undelete_spec.rb +304 -304
  295. data/spec/unit/policyfile_services/update_attributes_spec.rb +217 -217
  296. data/spec/unit/service_exception_inspectors/base_spec.rb +43 -43
  297. data/spec/unit/service_exception_inspectors/http_spec.rb +140 -140
  298. data/spec/unit/shell_out_spec.rb +34 -34
  299. metadata +9 -3
@@ -1,466 +1,466 @@
1
- #
2
- # Copyright:: Copyright (c) 2014 Chef Software Inc.
3
- # License:: Apache License, Version 2.0
4
- #
5
- # Licensed under the Apache License, Version 2.0 (the "License");
6
- # you may not use this file except in compliance with the License.
7
- # You may obtain a copy of the License at
8
- #
9
- # http://www.apache.org/licenses/LICENSE-2.0
10
- #
11
- # Unless required by applicable law or agreed to in writing, software
12
- # distributed under the License is distributed on an "AS IS" BASIS,
13
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
- # See the License for the specific language governing permissions and
15
- # limitations under the License.
16
- #
17
-
18
- require 'forwardable'
19
-
20
- require 'chef-dk/exceptions'
21
-
22
- require 'chef-dk/cookbook_profiler/null_scm'
23
- require 'chef-dk/cookbook_profiler/git'
24
-
25
- require 'chef-dk/cookbook_profiler/identifiers'
26
- require 'chef-dk/policyfile/storage_config'
27
-
28
- require 'chef-dk/policyfile/cookbook_location_specification'
29
-
30
- module ChefDK
31
-
32
- module Policyfile
33
-
34
- # Base class for CookbookLock implementations
35
- class CookbookLock
36
-
37
- REQUIRED_LOCK_DATA_KEYS = %w{version identifier dotted_decimal_identifier cache_key source_options}
38
- REQUIRED_LOCK_DATA_KEYS.each(&:freeze)
39
- REQUIRED_LOCK_DATA_KEYS.freeze
40
-
41
- include Policyfile::StorageConfigDelegation
42
-
43
- # The cookbook name (without any version or other info suffixed)
44
- attr_reader :name
45
-
46
- # Options specifying the source and revision of this cookbook. These can
47
- # be passed to a CookbookLocationSpecification to create an object that can install the
48
- # same revision of the cookbook on another machine.
49
- attr_accessor :source_options
50
-
51
- # A string that uniquely identifies the cookbook version. If not
52
- # explicitly set, an identifier is generated based on the cookbook's
53
- # content.
54
- attr_accessor :identifier
55
-
56
- # A string in "X.Y.Z" version number format that uniquely identifies the
57
- # cookbook version. This is for compatibility with Chef Server 11.x,
58
- # where cookbooks are stored by x.y.z version numbers.
59
- attr_accessor :dotted_decimal_identifier
60
-
61
- attr_reader :storage_config
62
-
63
- attr_accessor :version
64
-
65
- def initialize(name, storage_config)
66
- @name = name
67
- @version = nil
68
- @source_options = nil
69
- @identifier = nil
70
- @dotted_decimal_identifier = nil
71
- @storage_config = storage_config
72
- end
73
-
74
- def installed?
75
- cookbook_location_spec.installed?
76
- end
77
-
78
- def install_locked
79
- cookbook_location_spec.ensure_cached
80
- end
81
-
82
- def cookbook_location_spec
83
- raise InvalidCookbookLockData, "Cannot create CookbookLocationSpecification for #{name} without version" if version.nil?
84
- raise InvalidCookbookLockData, "Cannot create CookbookLocationSpecification for #{name} without source options" if source_options.nil?
85
- @location_spec ||= CookbookLocationSpecification.new(name, "= #{version}", source_options, storage_config)
86
- end
87
-
88
- def dependencies
89
- cookbook_location_spec.dependencies
90
- end
91
-
92
- def gather_profile_data
93
- @identifier ||= identifiers.content_identifier
94
- @dotted_decimal_identifier ||= identifiers.dotted_decimal_identifier
95
- @version ||= identifiers.semver_version
96
- end
97
-
98
- def identifiers
99
- @identifiers ||= CookbookProfiler::Identifiers.new(cookbook_version)
100
- end
101
-
102
- def cookbook_path
103
- raise NotImplementedError, "#{self.class} must override #cookbook_path with a specific implementation"
104
- end
105
-
106
- def to_lock
107
- validate!
108
- lock_data
109
- end
110
-
111
- def lock_data
112
- raise NotImplementedError, "#{self.class} must override #lock_data a specific implementation"
113
- end
114
-
115
- def build_from_lock_data(lock_data)
116
- raise NotImplementedError, "#{self.class} must override #build_from_lock_data with a specific implementation"
117
- end
118
-
119
- def validate!
120
- raise NotImplementedError, "#{self.class} must override #validate! with a specific implementation"
121
- end
122
-
123
- def refresh!
124
- raise NotImplementedError, "#{self.class} must override #refresh! with a specific implementation"
125
- end
126
-
127
- def updated?
128
- false
129
- end
130
-
131
- def identifier_updated?
132
- false
133
- end
134
-
135
- def version_updated?
136
- false
137
- end
138
-
139
- def symbolize_source_options_keys(source_options_from_json)
140
- source_options_from_json ||= {}
141
- source_options_from_json.inject({}) do |normalized_source_opts, (key, value)|
142
- normalized_source_opts[key.to_sym] = value
143
- normalized_source_opts
144
- end
145
- end
146
-
147
- def cookbook_version
148
- @cookbook_version ||= cookbook_loader.cookbook_version
149
- end
150
-
151
- def cookbook_loader
152
- @cookbook_loader ||=
153
- begin
154
- loader = Chef::Cookbook::CookbookVersionLoader.new(cookbook_path, chefignore)
155
- loader.load!
156
- loader
157
- end
158
- end
159
-
160
- def chefignore
161
- @chefignore ||= Chef::Cookbook::Chefignore.new(File.join(cookbook_path, "chefignore"))
162
- end
163
-
164
- private
165
-
166
- def assert_required_keys_valid!(lock_data)
167
- missing_keys = REQUIRED_LOCK_DATA_KEYS.reject {|key| lock_data.key?(key) }
168
- unless missing_keys.empty?
169
- raise InvalidLockfile, "Lockfile cookbook_lock for #{name} missing required attributes `#{missing_keys.join("', `")}'"
170
- end
171
-
172
- version = lock_data["version"]
173
- unless version.kind_of?(String)
174
- raise InvalidLockfile, "Lockfile cookbook_lock for #{name} `version' attribute must be a string (got: #{version})"
175
- end
176
-
177
- identifier = lock_data["identifier"]
178
- unless identifier.kind_of?(String)
179
- raise InvalidLockfile, "Lockfile cookbook_lock for #{name} `identifier' attribute must be a string (got: #{identifier})"
180
- end
181
-
182
- cache_key = lock_data["cache_key"]
183
- unless cache_key.kind_of?(String) || cache_key.nil?
184
- raise InvalidLockfile, "Lockfile cookbook_lock for #{name} `cache_key' attribute must be a string (got: #{cache_key})"
185
- end
186
-
187
- source_options = lock_data["source_options"]
188
- unless source_options.kind_of?(Hash)
189
- raise InvalidLockfile, "Lockfile cookbook_lock for #{name} `source_options' attribute must be a Hash (JSON object) (got: #{source_options})"
190
- end
191
- end
192
-
193
- end
194
-
195
- # CachedCookbook objects represent a cookbook that has been fetched from an
196
- # upstream canonical source and stored (presumed unmodified).
197
- class CachedCookbook < CookbookLock
198
-
199
- # The directory name in the cookbook cache where the cookbook is stored.
200
- # By convention, this should be the name of the cookbook followed by a
201
- # hyphen and then some sort of version identifier (depending on the
202
- # cookbook source).
203
- attr_accessor :cache_key
204
-
205
- # A URI pointing to the canonical source of the cookbook.
206
- attr_accessor :origin
207
-
208
- def initialize(name, storage_config)
209
- @name = name
210
- @version = nil
211
- @origin = nil
212
- @source_options = nil
213
- @cache_key = nil
214
- @identifier = nil
215
- @dotted_decimal_identifier = nil
216
- @storage_config = storage_config
217
- end
218
-
219
- def cookbook_path
220
- if cache_key.nil?
221
- raise MissingCookbookLockData, "Cannot locate cached cookbook `#{name}' because the `cache_key' attribute is not set"
222
- end
223
- File.join(cache_path, cache_key)
224
- end
225
-
226
- def build_from_lock_data(lock_data)
227
- assert_required_keys_valid!(lock_data)
228
-
229
- @version = lock_data["version"]
230
- @identifier = lock_data["identifier"]
231
- @dotted_decimal_identifier = lock_data["dotted_decimal_identifier"]
232
- @cache_key = lock_data["cache_key"]
233
- @origin = lock_data["origin"]
234
- @source_options = symbolize_source_options_keys(lock_data["source_options"])
235
- end
236
-
237
- def lock_data
238
- {
239
- "version" => version,
240
- "identifier" => identifier,
241
- "dotted_decimal_identifier" => dotted_decimal_identifier,
242
- "cache_key" => cache_key,
243
- "origin" => origin,
244
- "source_options" => source_options
245
- }
246
- end
247
-
248
- def validate!
249
- if cache_key.nil?
250
- raise CachedCookbookNotFound, "Cookbook `#{name}' does not have a `cache_key` set, cannot locate cookbook"
251
- end
252
- unless File.exist?(cookbook_path)
253
- raise CachedCookbookNotFound, "Cookbook `#{name}' not found at expected cache location `#{cache_key}' (full path: `#{cookbook_path}')"
254
- end
255
- end
256
-
257
- # We do not expect the cookbook to get mutated out-of-band, so refreshing
258
- # the data generally should have no affect. If the cookbook has been
259
- # mutated, though, then a CachedCookbookModified exception is raised.
260
- def refresh!
261
- # This behavior fits better with the intent of the #validate! method,
262
- # but we cannot check for modifications there because the user may be
263
- # setting custom identifiers.
264
- if @identifier and identifiers.content_identifier != @identifier
265
- message = "Cached cookbook `#{name}' (#{version}) has been modified since the lockfile was generated. " +
266
- "Cached cookbooks cannot be modified. (full path: `#{cookbook_path}')"
267
- raise CachedCookbookModified, message
268
- end
269
- end
270
-
271
- end
272
-
273
- # LocalCookbook objects represent cookbooks that are sourced from the local
274
- # filesystem and are assumed to be under active development.
275
- class LocalCookbook < CookbookLock
276
-
277
- # A relative or absolute path to the cookbook. If a relative path is
278
- # given, it is resolved relative to #relative_paths_root
279
- attr_accessor :source
280
-
281
- def initialize(name, storage_config)
282
- @name = name
283
- @identifier = nil
284
- @storage_config = storage_config
285
-
286
- @identifier_updated = false
287
- @version_updated = false
288
- @cookbook_in_git_repo = nil
289
- @scm_info = nil
290
- end
291
-
292
- def cookbook_path
293
- File.expand_path(source, relative_paths_root)
294
- end
295
-
296
- def scm_profiler
297
- if cookbook_in_git_repo?
298
- CookbookProfiler::Git.new(cookbook_path)
299
- else
300
- CookbookProfiler::NullSCM.new(cookbook_path)
301
- end
302
- end
303
-
304
- def scm_info
305
- @scm_info
306
- end
307
-
308
- def to_lock
309
- refresh_scm_info
310
- super
311
- end
312
-
313
- def lock_data
314
- {
315
- "version" => version,
316
- "identifier" => identifier,
317
- "dotted_decimal_identifier" => dotted_decimal_identifier,
318
- "source" => source,
319
- "cache_key" => nil,
320
- "scm_info" => scm_info,
321
- "source_options" => source_options
322
- }
323
- end
324
-
325
- def build_from_lock_data(lock_data)
326
- assert_required_keys_valid!(lock_data)
327
-
328
- @version = lock_data["version"]
329
- @identifier = lock_data["identifier"]
330
- @dotted_decimal_identifier = lock_data["dotted_decimal_identifier"]
331
- @source = lock_data["source"]
332
- @source_options = symbolize_source_options_keys(lock_data["source_options"])
333
- @scm_info = lock_data["scm_info"]
334
- end
335
-
336
- def validate!
337
- if source.nil?
338
- raise LocalCookbookNotFound, "Cookbook `#{name}' does not have a `source` set, cannot locate cookbook"
339
- end
340
- unless File.exist?(cookbook_path)
341
- raise LocalCookbookNotFound, "Cookbook `#{name}' not found at path source `#{source}` (full path: `#{cookbook_path}')"
342
- end
343
- unless cookbook_version.name.to_s == name
344
- msg = "The cookbook at path source `#{source}' is expected to be named `#{name}', but is now named `#{cookbook_version.name}' (full path: #{cookbook_path})"
345
- raise MalformedCookbook, msg
346
- end
347
- end
348
-
349
- def refresh!
350
- old_identifier, old_version = @identifier, @version
351
- @identifier, @dotted_decimal_identifier, @version = nil, nil, nil
352
- gather_profile_data
353
- if @identifier != old_identifier
354
- @identifier_updated = true
355
- end
356
- if @version != old_version
357
- @version_updated = true
358
- end
359
- self
360
- end
361
-
362
- def updated?
363
- @identifier_updated || @version_updated
364
- end
365
-
366
- def version_updated?
367
- @version_updated
368
- end
369
-
370
- def identifier_updated?
371
- @identifier_updated
372
- end
373
-
374
- private
375
-
376
- def refresh_scm_info
377
- @scm_info = scm_profiler.profile_data
378
- end
379
-
380
- def assert_required_keys_valid!(lock_data)
381
- super
382
-
383
- source = lock_data["source"]
384
- if source.nil?
385
- raise InvalidLockfile, "Lockfile cookbook_lock for #{name} is invalid. Lock data for a local cookbook must have a `source' attribute"
386
- end
387
-
388
- unless source.kind_of?(String)
389
- raise InvalidLockfile, "Lockfile cookbook_lock for #{name} is invalid: `source' attribute must be a String (got: #{source.inspect})"
390
- end
391
- end
392
-
393
- def cookbook_in_git_repo?
394
- return @cookbook_in_git_repo unless @cookbook_in_git_repo.nil?
395
-
396
- @cookbook_in_git_repo = false
397
-
398
- dot_git = Pathname.new(".git")
399
- Pathname.new(cookbook_path).ascend do |parent_dir|
400
- possbile_git_dir = parent_dir + dot_git
401
- if possbile_git_dir.exist?
402
- @cookbook_in_git_repo = true
403
- break
404
- end
405
- end
406
-
407
- @cookbook_in_git_repo
408
- end
409
-
410
- end
411
-
412
- class ArchivedCookbook < CookbookLock
413
-
414
- extend Forwardable
415
-
416
- def_delegator :@archived_lock, :name
417
- def_delegator :@archived_lock, :source_options
418
- def_delegator :@archived_lock, :identifier
419
- def_delegator :@archived_lock, :dotted_decimal_identifier
420
- def_delegator :@archived_lock, :version
421
- def_delegator :@archived_lock, :source
422
-
423
- # #to_lock calls #validate! which will typically ensure that the cookbook
424
- # is present at the correct path for the lock type. For an archived
425
- # cookbook, the cookbook is located in the archive, so it probably won't
426
- # exist there. Therefore, we bypass #validate! and get the lock data
427
- # directly.
428
- def_delegator :@archived_lock, :lock_data, :to_lock
429
-
430
- def initialize(archived_lock, storage_config)
431
- @archived_lock = archived_lock
432
- @storage_config = storage_config
433
- end
434
-
435
- def build_from_lock_data(lock_data)
436
- raise NotImplementedError, "ArchivedCookbook cannot be built from lock data, it can only wrap an existing lock object"
437
- end
438
-
439
- def installed?
440
- File.exist?(cookbook_path) && File.directory?(cookbook_path)
441
- end
442
-
443
- # The cookbook is assumed to be stored in a Chef Zero compatible repo as
444
- # created by `chef export`. Currently that only creates "compatibility
445
- # mode" repos since Chef Zero doesn't yet support cookbook_artifact APIs.
446
- # So the cookbook will be located in a path like:
447
- # cookbooks/nginx-111.222.333
448
- def cookbook_path
449
- File.join(relative_paths_root, "cookbooks", "#{name}-#{dotted_decimal_identifier}")
450
- end
451
-
452
- # We trust that archived cookbooks haven't been modified, so just return
453
- # true for #validate!
454
- def validate!
455
- true
456
- end
457
-
458
- # We trust that archived cookbooks haven't been modified, so just return
459
- # true for #refresh!
460
- def refresh!
461
- true
462
- end
463
- end
464
-
465
- end
466
- end
1
+ #
2
+ # Copyright:: Copyright (c) 2014 Chef Software Inc.
3
+ # License:: Apache License, Version 2.0
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # http://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+ #
17
+
18
+ require 'forwardable'
19
+
20
+ require 'chef-dk/exceptions'
21
+
22
+ require 'chef-dk/cookbook_profiler/null_scm'
23
+ require 'chef-dk/cookbook_profiler/git'
24
+
25
+ require 'chef-dk/cookbook_profiler/identifiers'
26
+ require 'chef-dk/policyfile/storage_config'
27
+
28
+ require 'chef-dk/policyfile/cookbook_location_specification'
29
+
30
+ module ChefDK
31
+
32
+ module Policyfile
33
+
34
+ # Base class for CookbookLock implementations
35
+ class CookbookLock
36
+
37
+ REQUIRED_LOCK_DATA_KEYS = %w{version identifier dotted_decimal_identifier cache_key source_options}
38
+ REQUIRED_LOCK_DATA_KEYS.each(&:freeze)
39
+ REQUIRED_LOCK_DATA_KEYS.freeze
40
+
41
+ include Policyfile::StorageConfigDelegation
42
+
43
+ # The cookbook name (without any version or other info suffixed)
44
+ attr_reader :name
45
+
46
+ # Options specifying the source and revision of this cookbook. These can
47
+ # be passed to a CookbookLocationSpecification to create an object that can install the
48
+ # same revision of the cookbook on another machine.
49
+ attr_accessor :source_options
50
+
51
+ # A string that uniquely identifies the cookbook version. If not
52
+ # explicitly set, an identifier is generated based on the cookbook's
53
+ # content.
54
+ attr_accessor :identifier
55
+
56
+ # A string in "X.Y.Z" version number format that uniquely identifies the
57
+ # cookbook version. This is for compatibility with Chef Server 11.x,
58
+ # where cookbooks are stored by x.y.z version numbers.
59
+ attr_accessor :dotted_decimal_identifier
60
+
61
+ attr_reader :storage_config
62
+
63
+ attr_accessor :version
64
+
65
+ def initialize(name, storage_config)
66
+ @name = name
67
+ @version = nil
68
+ @source_options = nil
69
+ @identifier = nil
70
+ @dotted_decimal_identifier = nil
71
+ @storage_config = storage_config
72
+ end
73
+
74
+ def installed?
75
+ cookbook_location_spec.installed?
76
+ end
77
+
78
+ def install_locked
79
+ cookbook_location_spec.ensure_cached
80
+ end
81
+
82
+ def cookbook_location_spec
83
+ raise InvalidCookbookLockData, "Cannot create CookbookLocationSpecification for #{name} without version" if version.nil?
84
+ raise InvalidCookbookLockData, "Cannot create CookbookLocationSpecification for #{name} without source options" if source_options.nil?
85
+ @location_spec ||= CookbookLocationSpecification.new(name, "= #{version}", source_options, storage_config)
86
+ end
87
+
88
+ def dependencies
89
+ cookbook_location_spec.dependencies
90
+ end
91
+
92
+ def gather_profile_data
93
+ @identifier ||= identifiers.content_identifier
94
+ @dotted_decimal_identifier ||= identifiers.dotted_decimal_identifier
95
+ @version ||= identifiers.semver_version
96
+ end
97
+
98
+ def identifiers
99
+ @identifiers ||= CookbookProfiler::Identifiers.new(cookbook_version)
100
+ end
101
+
102
+ def cookbook_path
103
+ raise NotImplementedError, "#{self.class} must override #cookbook_path with a specific implementation"
104
+ end
105
+
106
+ def to_lock
107
+ validate!
108
+ lock_data
109
+ end
110
+
111
+ def lock_data
112
+ raise NotImplementedError, "#{self.class} must override #lock_data a specific implementation"
113
+ end
114
+
115
+ def build_from_lock_data(lock_data)
116
+ raise NotImplementedError, "#{self.class} must override #build_from_lock_data with a specific implementation"
117
+ end
118
+
119
+ def validate!
120
+ raise NotImplementedError, "#{self.class} must override #validate! with a specific implementation"
121
+ end
122
+
123
+ def refresh!
124
+ raise NotImplementedError, "#{self.class} must override #refresh! with a specific implementation"
125
+ end
126
+
127
+ def updated?
128
+ false
129
+ end
130
+
131
+ def identifier_updated?
132
+ false
133
+ end
134
+
135
+ def version_updated?
136
+ false
137
+ end
138
+
139
+ def symbolize_source_options_keys(source_options_from_json)
140
+ source_options_from_json ||= {}
141
+ source_options_from_json.inject({}) do |normalized_source_opts, (key, value)|
142
+ normalized_source_opts[key.to_sym] = value
143
+ normalized_source_opts
144
+ end
145
+ end
146
+
147
+ def cookbook_version
148
+ @cookbook_version ||= cookbook_loader.cookbook_version
149
+ end
150
+
151
+ def cookbook_loader
152
+ @cookbook_loader ||=
153
+ begin
154
+ loader = Chef::Cookbook::CookbookVersionLoader.new(cookbook_path, chefignore)
155
+ loader.load!
156
+ loader
157
+ end
158
+ end
159
+
160
+ def chefignore
161
+ @chefignore ||= Chef::Cookbook::Chefignore.new(File.join(cookbook_path, "chefignore"))
162
+ end
163
+
164
+ private
165
+
166
+ def assert_required_keys_valid!(lock_data)
167
+ missing_keys = REQUIRED_LOCK_DATA_KEYS.reject {|key| lock_data.key?(key) }
168
+ unless missing_keys.empty?
169
+ raise InvalidLockfile, "Lockfile cookbook_lock for #{name} missing required attributes `#{missing_keys.join("', `")}'"
170
+ end
171
+
172
+ version = lock_data["version"]
173
+ unless version.kind_of?(String)
174
+ raise InvalidLockfile, "Lockfile cookbook_lock for #{name} `version' attribute must be a string (got: #{version})"
175
+ end
176
+
177
+ identifier = lock_data["identifier"]
178
+ unless identifier.kind_of?(String)
179
+ raise InvalidLockfile, "Lockfile cookbook_lock for #{name} `identifier' attribute must be a string (got: #{identifier})"
180
+ end
181
+
182
+ cache_key = lock_data["cache_key"]
183
+ unless cache_key.kind_of?(String) || cache_key.nil?
184
+ raise InvalidLockfile, "Lockfile cookbook_lock for #{name} `cache_key' attribute must be a string (got: #{cache_key})"
185
+ end
186
+
187
+ source_options = lock_data["source_options"]
188
+ unless source_options.kind_of?(Hash)
189
+ raise InvalidLockfile, "Lockfile cookbook_lock for #{name} `source_options' attribute must be a Hash (JSON object) (got: #{source_options})"
190
+ end
191
+ end
192
+
193
+ end
194
+
195
+ # CachedCookbook objects represent a cookbook that has been fetched from an
196
+ # upstream canonical source and stored (presumed unmodified).
197
+ class CachedCookbook < CookbookLock
198
+
199
+ # The directory name in the cookbook cache where the cookbook is stored.
200
+ # By convention, this should be the name of the cookbook followed by a
201
+ # hyphen and then some sort of version identifier (depending on the
202
+ # cookbook source).
203
+ attr_accessor :cache_key
204
+
205
+ # A URI pointing to the canonical source of the cookbook.
206
+ attr_accessor :origin
207
+
208
+ def initialize(name, storage_config)
209
+ @name = name
210
+ @version = nil
211
+ @origin = nil
212
+ @source_options = nil
213
+ @cache_key = nil
214
+ @identifier = nil
215
+ @dotted_decimal_identifier = nil
216
+ @storage_config = storage_config
217
+ end
218
+
219
+ def cookbook_path
220
+ if cache_key.nil?
221
+ raise MissingCookbookLockData, "Cannot locate cached cookbook `#{name}' because the `cache_key' attribute is not set"
222
+ end
223
+ File.join(cache_path, cache_key)
224
+ end
225
+
226
+ def build_from_lock_data(lock_data)
227
+ assert_required_keys_valid!(lock_data)
228
+
229
+ @version = lock_data["version"]
230
+ @identifier = lock_data["identifier"]
231
+ @dotted_decimal_identifier = lock_data["dotted_decimal_identifier"]
232
+ @cache_key = lock_data["cache_key"]
233
+ @origin = lock_data["origin"]
234
+ @source_options = symbolize_source_options_keys(lock_data["source_options"])
235
+ end
236
+
237
+ def lock_data
238
+ {
239
+ "version" => version,
240
+ "identifier" => identifier,
241
+ "dotted_decimal_identifier" => dotted_decimal_identifier,
242
+ "cache_key" => cache_key,
243
+ "origin" => origin,
244
+ "source_options" => source_options
245
+ }
246
+ end
247
+
248
+ def validate!
249
+ if cache_key.nil?
250
+ raise CachedCookbookNotFound, "Cookbook `#{name}' does not have a `cache_key` set, cannot locate cookbook"
251
+ end
252
+ unless File.exist?(cookbook_path)
253
+ raise CachedCookbookNotFound, "Cookbook `#{name}' not found at expected cache location `#{cache_key}' (full path: `#{cookbook_path}')"
254
+ end
255
+ end
256
+
257
+ # We do not expect the cookbook to get mutated out-of-band, so refreshing
258
+ # the data generally should have no affect. If the cookbook has been
259
+ # mutated, though, then a CachedCookbookModified exception is raised.
260
+ def refresh!
261
+ # This behavior fits better with the intent of the #validate! method,
262
+ # but we cannot check for modifications there because the user may be
263
+ # setting custom identifiers.
264
+ if @identifier and identifiers.content_identifier != @identifier
265
+ message = "Cached cookbook `#{name}' (#{version}) has been modified since the lockfile was generated. " +
266
+ "Cached cookbooks cannot be modified. (full path: `#{cookbook_path}')"
267
+ raise CachedCookbookModified, message
268
+ end
269
+ end
270
+
271
+ end
272
+
273
+ # LocalCookbook objects represent cookbooks that are sourced from the local
274
+ # filesystem and are assumed to be under active development.
275
+ class LocalCookbook < CookbookLock
276
+
277
+ # A relative or absolute path to the cookbook. If a relative path is
278
+ # given, it is resolved relative to #relative_paths_root
279
+ attr_accessor :source
280
+
281
+ def initialize(name, storage_config)
282
+ @name = name
283
+ @identifier = nil
284
+ @storage_config = storage_config
285
+
286
+ @identifier_updated = false
287
+ @version_updated = false
288
+ @cookbook_in_git_repo = nil
289
+ @scm_info = nil
290
+ end
291
+
292
+ def cookbook_path
293
+ File.expand_path(source, relative_paths_root)
294
+ end
295
+
296
+ def scm_profiler
297
+ if cookbook_in_git_repo?
298
+ CookbookProfiler::Git.new(cookbook_path)
299
+ else
300
+ CookbookProfiler::NullSCM.new(cookbook_path)
301
+ end
302
+ end
303
+
304
+ def scm_info
305
+ @scm_info
306
+ end
307
+
308
+ def to_lock
309
+ refresh_scm_info
310
+ super
311
+ end
312
+
313
+ def lock_data
314
+ {
315
+ "version" => version,
316
+ "identifier" => identifier,
317
+ "dotted_decimal_identifier" => dotted_decimal_identifier,
318
+ "source" => source,
319
+ "cache_key" => nil,
320
+ "scm_info" => scm_info,
321
+ "source_options" => source_options
322
+ }
323
+ end
324
+
325
+ def build_from_lock_data(lock_data)
326
+ assert_required_keys_valid!(lock_data)
327
+
328
+ @version = lock_data["version"]
329
+ @identifier = lock_data["identifier"]
330
+ @dotted_decimal_identifier = lock_data["dotted_decimal_identifier"]
331
+ @source = lock_data["source"]
332
+ @source_options = symbolize_source_options_keys(lock_data["source_options"])
333
+ @scm_info = lock_data["scm_info"]
334
+ end
335
+
336
+ def validate!
337
+ if source.nil?
338
+ raise LocalCookbookNotFound, "Cookbook `#{name}' does not have a `source` set, cannot locate cookbook"
339
+ end
340
+ unless File.exist?(cookbook_path)
341
+ raise LocalCookbookNotFound, "Cookbook `#{name}' not found at path source `#{source}` (full path: `#{cookbook_path}')"
342
+ end
343
+ unless cookbook_version.name.to_s == name
344
+ msg = "The cookbook at path source `#{source}' is expected to be named `#{name}', but is now named `#{cookbook_version.name}' (full path: #{cookbook_path})"
345
+ raise MalformedCookbook, msg
346
+ end
347
+ end
348
+
349
+ def refresh!
350
+ old_identifier, old_version = @identifier, @version
351
+ @identifier, @dotted_decimal_identifier, @version = nil, nil, nil
352
+ gather_profile_data
353
+ if @identifier != old_identifier
354
+ @identifier_updated = true
355
+ end
356
+ if @version != old_version
357
+ @version_updated = true
358
+ end
359
+ self
360
+ end
361
+
362
+ def updated?
363
+ @identifier_updated || @version_updated
364
+ end
365
+
366
+ def version_updated?
367
+ @version_updated
368
+ end
369
+
370
+ def identifier_updated?
371
+ @identifier_updated
372
+ end
373
+
374
+ private
375
+
376
+ def refresh_scm_info
377
+ @scm_info = scm_profiler.profile_data
378
+ end
379
+
380
+ def assert_required_keys_valid!(lock_data)
381
+ super
382
+
383
+ source = lock_data["source"]
384
+ if source.nil?
385
+ raise InvalidLockfile, "Lockfile cookbook_lock for #{name} is invalid. Lock data for a local cookbook must have a `source' attribute"
386
+ end
387
+
388
+ unless source.kind_of?(String)
389
+ raise InvalidLockfile, "Lockfile cookbook_lock for #{name} is invalid: `source' attribute must be a String (got: #{source.inspect})"
390
+ end
391
+ end
392
+
393
+ def cookbook_in_git_repo?
394
+ return @cookbook_in_git_repo unless @cookbook_in_git_repo.nil?
395
+
396
+ @cookbook_in_git_repo = false
397
+
398
+ dot_git = Pathname.new(".git")
399
+ Pathname.new(cookbook_path).ascend do |parent_dir|
400
+ possbile_git_dir = parent_dir + dot_git
401
+ if possbile_git_dir.exist?
402
+ @cookbook_in_git_repo = true
403
+ break
404
+ end
405
+ end
406
+
407
+ @cookbook_in_git_repo
408
+ end
409
+
410
+ end
411
+
412
+ class ArchivedCookbook < CookbookLock
413
+
414
+ extend Forwardable
415
+
416
+ def_delegator :@archived_lock, :name
417
+ def_delegator :@archived_lock, :source_options
418
+ def_delegator :@archived_lock, :identifier
419
+ def_delegator :@archived_lock, :dotted_decimal_identifier
420
+ def_delegator :@archived_lock, :version
421
+ def_delegator :@archived_lock, :source
422
+
423
+ # #to_lock calls #validate! which will typically ensure that the cookbook
424
+ # is present at the correct path for the lock type. For an archived
425
+ # cookbook, the cookbook is located in the archive, so it probably won't
426
+ # exist there. Therefore, we bypass #validate! and get the lock data
427
+ # directly.
428
+ def_delegator :@archived_lock, :lock_data, :to_lock
429
+
430
+ def initialize(archived_lock, storage_config)
431
+ @archived_lock = archived_lock
432
+ @storage_config = storage_config
433
+ end
434
+
435
+ def build_from_lock_data(lock_data)
436
+ raise NotImplementedError, "ArchivedCookbook cannot be built from lock data, it can only wrap an existing lock object"
437
+ end
438
+
439
+ def installed?
440
+ File.exist?(cookbook_path) && File.directory?(cookbook_path)
441
+ end
442
+
443
+ # The cookbook is assumed to be stored in a Chef Zero compatible repo as
444
+ # created by `chef export`. Currently that only creates "compatibility
445
+ # mode" repos since Chef Zero doesn't yet support cookbook_artifact APIs.
446
+ # So the cookbook will be located in a path like:
447
+ # cookbooks/nginx-111.222.333
448
+ def cookbook_path
449
+ File.join(relative_paths_root, "cookbooks", "#{name}-#{dotted_decimal_identifier}")
450
+ end
451
+
452
+ # We trust that archived cookbooks haven't been modified, so just return
453
+ # true for #validate!
454
+ def validate!
455
+ true
456
+ end
457
+
458
+ # We trust that archived cookbooks haven't been modified, so just return
459
+ # true for #refresh!
460
+ def refresh!
461
+ true
462
+ end
463
+ end
464
+
465
+ end
466
+ end