inspec 2.1.21 → 2.1.30

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (502) hide show
  1. checksums.yaml +4 -4
  2. data/.rubocop.yml +101 -101
  3. data/CHANGELOG.md +3062 -3045
  4. data/Gemfile +56 -56
  5. data/LICENSE +14 -14
  6. data/MAINTAINERS.md +33 -33
  7. data/MAINTAINERS.toml +52 -52
  8. data/README.md +447 -447
  9. data/Rakefile +322 -322
  10. data/bin/inspec +12 -12
  11. data/docs/.gitignore +2 -2
  12. data/docs/README.md +40 -40
  13. data/docs/dsl_inspec.md +258 -258
  14. data/docs/dsl_resource.md +100 -100
  15. data/docs/glossary.md +99 -99
  16. data/docs/habitat.md +191 -191
  17. data/docs/inspec_and_friends.md +114 -114
  18. data/docs/matchers.md +169 -169
  19. data/docs/migration.md +293 -293
  20. data/docs/platforms.md +118 -118
  21. data/docs/plugin_kitchen_inspec.md +50 -50
  22. data/docs/profiles.md +376 -376
  23. data/docs/reporters.md +105 -105
  24. data/docs/resources/aide_conf.md.erb +75 -75
  25. data/docs/resources/apache.md.erb +67 -67
  26. data/docs/resources/apache_conf.md.erb +68 -68
  27. data/docs/resources/apt.md.erb +71 -71
  28. data/docs/resources/audit_policy.md.erb +47 -47
  29. data/docs/resources/auditd.md.erb +79 -79
  30. data/docs/resources/auditd_conf.md.erb +68 -68
  31. data/docs/resources/aws_cloudtrail_trail.md.erb +140 -140
  32. data/docs/resources/aws_cloudtrail_trails.md.erb +81 -81
  33. data/docs/resources/aws_cloudwatch_alarm.md.erb +86 -86
  34. data/docs/resources/aws_cloudwatch_log_metric_filter.md.erb +151 -151
  35. data/docs/resources/aws_config_delivery_channel.md +79 -79
  36. data/docs/resources/aws_config_recorder.md.erb +71 -71
  37. data/docs/resources/aws_ec2_instance.md.erb +106 -106
  38. data/docs/resources/aws_iam_access_key.md.erb +123 -123
  39. data/docs/resources/aws_iam_access_keys.md.erb +198 -198
  40. data/docs/resources/aws_iam_group.md.erb +46 -46
  41. data/docs/resources/aws_iam_groups.md.erb +43 -43
  42. data/docs/resources/aws_iam_password_policy.md.erb +76 -76
  43. data/docs/resources/aws_iam_policies.md.erb +82 -82
  44. data/docs/resources/aws_iam_policy.md.erb +144 -144
  45. data/docs/resources/aws_iam_role.md.erb +63 -63
  46. data/docs/resources/aws_iam_root_user.md.erb +70 -58
  47. data/docs/resources/aws_iam_user.md.erb +64 -64
  48. data/docs/resources/aws_iam_users.md.erb +89 -89
  49. data/docs/resources/aws_kms_key.md.erb +171 -171
  50. data/docs/resources/aws_kms_keys.md.erb +84 -84
  51. data/docs/resources/aws_rds_instance.md.erb +60 -60
  52. data/docs/resources/aws_route_table.md.erb +47 -47
  53. data/docs/resources/aws_route_tables.md.erb +49 -0
  54. data/docs/resources/aws_s3_bucket.md.erb +134 -134
  55. data/docs/resources/aws_s3_bucket_object.md.erb +83 -83
  56. data/docs/resources/aws_s3_buckets.md.erb +53 -0
  57. data/docs/resources/aws_security_group.md.erb +151 -151
  58. data/docs/resources/aws_security_groups.md.erb +91 -91
  59. data/docs/resources/aws_sns_subscription.md.erb +124 -124
  60. data/docs/resources/aws_sns_topic.md.erb +63 -63
  61. data/docs/resources/aws_sns_topics.md.erb +52 -52
  62. data/docs/resources/aws_subnet.md.erb +134 -134
  63. data/docs/resources/aws_subnets.md.erb +126 -126
  64. data/docs/resources/aws_vpc.md.erb +120 -120
  65. data/docs/resources/aws_vpcs.md.erb +48 -48
  66. data/docs/resources/azure_generic_resource.md.erb +171 -171
  67. data/docs/resources/azure_resource_group.md.erb +284 -284
  68. data/docs/resources/azure_virtual_machine.md.erb +347 -347
  69. data/docs/resources/azure_virtual_machine_data_disk.md.erb +224 -224
  70. data/docs/resources/bash.md.erb +75 -75
  71. data/docs/resources/bond.md.erb +90 -90
  72. data/docs/resources/bridge.md.erb +57 -57
  73. data/docs/resources/bsd_service.md.erb +67 -67
  74. data/docs/resources/chocolatey_package.md.erb +58 -0
  75. data/docs/resources/command.md.erb +138 -138
  76. data/docs/resources/cpan.md.erb +79 -79
  77. data/docs/resources/cran.md.erb +64 -64
  78. data/docs/resources/crontab.md.erb +89 -89
  79. data/docs/resources/csv.md.erb +54 -54
  80. data/docs/resources/dh_params.md.erb +205 -205
  81. data/docs/resources/directory.md.erb +30 -30
  82. data/docs/resources/docker.md.erb +219 -219
  83. data/docs/resources/docker_container.md.erb +103 -103
  84. data/docs/resources/docker_image.md.erb +94 -94
  85. data/docs/resources/docker_service.md.erb +114 -114
  86. data/docs/resources/elasticsearch.md.erb +242 -242
  87. data/docs/resources/etc_fstab.md.erb +125 -125
  88. data/docs/resources/etc_group.md.erb +75 -75
  89. data/docs/resources/etc_hosts.md.erb +78 -78
  90. data/docs/resources/etc_hosts_allow.md.erb +74 -74
  91. data/docs/resources/etc_hosts_deny.md.erb +74 -74
  92. data/docs/resources/file.md.erb +526 -526
  93. data/docs/resources/filesystem.md.erb +41 -41
  94. data/docs/resources/firewalld.md.erb +107 -107
  95. data/docs/resources/gem.md.erb +79 -79
  96. data/docs/resources/group.md.erb +61 -61
  97. data/docs/resources/grub_conf.md.erb +101 -101
  98. data/docs/resources/host.md.erb +86 -86
  99. data/docs/resources/http.md.erb +196 -196
  100. data/docs/resources/iis_app.md.erb +122 -122
  101. data/docs/resources/iis_site.md.erb +135 -135
  102. data/docs/resources/inetd_conf.md.erb +94 -94
  103. data/docs/resources/ini.md.erb +76 -76
  104. data/docs/resources/interface.md.erb +58 -58
  105. data/docs/resources/iptables.md.erb +64 -64
  106. data/docs/resources/json.md.erb +63 -63
  107. data/docs/resources/kernel_module.md.erb +120 -120
  108. data/docs/resources/kernel_parameter.md.erb +53 -53
  109. data/docs/resources/key_rsa.md.erb +85 -85
  110. data/docs/resources/launchd_service.md.erb +57 -57
  111. data/docs/resources/limits_conf.md.erb +75 -75
  112. data/docs/resources/login_defs.md.erb +71 -71
  113. data/docs/resources/mount.md.erb +69 -69
  114. data/docs/resources/mssql_session.md.erb +60 -60
  115. data/docs/resources/mysql_conf.md.erb +99 -99
  116. data/docs/resources/mysql_session.md.erb +74 -74
  117. data/docs/resources/nginx.md.erb +79 -79
  118. data/docs/resources/nginx_conf.md.erb +138 -138
  119. data/docs/resources/npm.md.erb +60 -60
  120. data/docs/resources/ntp_conf.md.erb +60 -60
  121. data/docs/resources/oneget.md.erb +53 -53
  122. data/docs/resources/oracledb_session.md.erb +52 -52
  123. data/docs/resources/os.md.erb +141 -141
  124. data/docs/resources/os_env.md.erb +78 -78
  125. data/docs/resources/package.md.erb +120 -120
  126. data/docs/resources/packages.md.erb +67 -67
  127. data/docs/resources/parse_config.md.erb +103 -103
  128. data/docs/resources/parse_config_file.md.erb +138 -138
  129. data/docs/resources/passwd.md.erb +141 -141
  130. data/docs/resources/pip.md.erb +67 -67
  131. data/docs/resources/port.md.erb +137 -137
  132. data/docs/resources/postgres_conf.md.erb +79 -79
  133. data/docs/resources/postgres_hba_conf.md.erb +93 -93
  134. data/docs/resources/postgres_ident_conf.md.erb +76 -76
  135. data/docs/resources/postgres_session.md.erb +69 -69
  136. data/docs/resources/powershell.md.erb +102 -102
  137. data/docs/resources/processes.md.erb +109 -109
  138. data/docs/resources/rabbitmq_config.md.erb +41 -41
  139. data/docs/resources/registry_key.md.erb +158 -158
  140. data/docs/resources/runit_service.md.erb +57 -57
  141. data/docs/resources/security_policy.md.erb +47 -47
  142. data/docs/resources/service.md.erb +121 -121
  143. data/docs/resources/shadow.md.erb +146 -146
  144. data/docs/resources/ssh_config.md.erb +73 -73
  145. data/docs/resources/sshd_config.md.erb +83 -83
  146. data/docs/resources/ssl.md.erb +119 -119
  147. data/docs/resources/sys_info.md.erb +42 -42
  148. data/docs/resources/systemd_service.md.erb +57 -57
  149. data/docs/resources/sysv_service.md.erb +57 -57
  150. data/docs/resources/upstart_service.md.erb +57 -57
  151. data/docs/resources/user.md.erb +140 -140
  152. data/docs/resources/users.md.erb +127 -127
  153. data/docs/resources/vbscript.md.erb +55 -55
  154. data/docs/resources/virtualization.md.erb +57 -57
  155. data/docs/resources/windows_feature.md.erb +47 -47
  156. data/docs/resources/windows_hotfix.md.erb +53 -53
  157. data/docs/resources/windows_task.md.erb +95 -95
  158. data/docs/resources/wmi.md.erb +81 -81
  159. data/docs/resources/x509_certificate.md.erb +151 -151
  160. data/docs/resources/xinetd_conf.md.erb +156 -156
  161. data/docs/resources/xml.md.erb +85 -85
  162. data/docs/resources/yaml.md.erb +69 -69
  163. data/docs/resources/yum.md.erb +98 -98
  164. data/docs/resources/zfs_dataset.md.erb +53 -53
  165. data/docs/resources/zfs_pool.md.erb +47 -47
  166. data/docs/ruby_usage.md +203 -203
  167. data/docs/shared/matcher_be.md.erb +1 -1
  168. data/docs/shared/matcher_cmp.md.erb +43 -43
  169. data/docs/shared/matcher_eq.md.erb +3 -3
  170. data/docs/shared/matcher_include.md.erb +1 -1
  171. data/docs/shared/matcher_match.md.erb +1 -1
  172. data/docs/shell.md +217 -217
  173. data/examples/README.md +8 -8
  174. data/examples/inheritance/README.md +65 -65
  175. data/examples/inheritance/controls/example.rb +14 -14
  176. data/examples/inheritance/inspec.yml +15 -15
  177. data/examples/kitchen-ansible/.kitchen.yml +25 -25
  178. data/examples/kitchen-ansible/Gemfile +19 -19
  179. data/examples/kitchen-ansible/README.md +53 -53
  180. data/examples/kitchen-ansible/files/nginx.repo +6 -6
  181. data/examples/kitchen-ansible/tasks/main.yml +16 -16
  182. data/examples/kitchen-ansible/test/integration/default/default.yml +5 -5
  183. data/examples/kitchen-ansible/test/integration/default/web_spec.rb +28 -28
  184. data/examples/kitchen-chef/.kitchen.yml +20 -20
  185. data/examples/kitchen-chef/Berksfile +3 -3
  186. data/examples/kitchen-chef/Gemfile +19 -19
  187. data/examples/kitchen-chef/README.md +27 -27
  188. data/examples/kitchen-chef/metadata.rb +7 -7
  189. data/examples/kitchen-chef/recipes/default.rb +6 -6
  190. data/examples/kitchen-chef/recipes/nginx.rb +30 -30
  191. data/examples/kitchen-chef/test/integration/default/web_spec.rb +28 -28
  192. data/examples/kitchen-puppet/.kitchen.yml +22 -22
  193. data/examples/kitchen-puppet/Gemfile +20 -20
  194. data/examples/kitchen-puppet/Puppetfile +25 -25
  195. data/examples/kitchen-puppet/README.md +53 -53
  196. data/examples/kitchen-puppet/manifests/site.pp +33 -33
  197. data/examples/kitchen-puppet/metadata.json +11 -11
  198. data/examples/kitchen-puppet/test/integration/default/web_spec.rb +28 -28
  199. data/examples/meta-profile/README.md +37 -37
  200. data/examples/meta-profile/controls/example.rb +13 -13
  201. data/examples/meta-profile/inspec.yml +13 -13
  202. data/examples/profile-attribute.yml +2 -2
  203. data/examples/profile-attribute/README.md +14 -14
  204. data/examples/profile-attribute/controls/example.rb +11 -11
  205. data/examples/profile-attribute/inspec.yml +8 -8
  206. data/examples/profile-aws/controls/iam_password_policy_expiration.rb +8 -8
  207. data/examples/profile-aws/controls/iam_password_policy_max_age.rb +8 -8
  208. data/examples/profile-aws/controls/iam_root_user_mfa.rb +8 -8
  209. data/examples/profile-aws/controls/iam_users_access_key_age.rb +8 -8
  210. data/examples/profile-aws/controls/iam_users_console_users_mfa.rb +8 -8
  211. data/examples/profile-aws/inspec.yml +11 -11
  212. data/examples/profile-azure/controls/azure_resource_group_example.rb +24 -24
  213. data/examples/profile-azure/controls/azure_vm_example.rb +29 -29
  214. data/examples/profile-azure/inspec.yml +11 -11
  215. data/examples/profile-sensitive/README.md +29 -29
  216. data/examples/profile-sensitive/controls/sensitive-failures.rb +9 -9
  217. data/examples/profile-sensitive/controls/sensitive.rb +9 -9
  218. data/examples/profile-sensitive/inspec.yml +8 -8
  219. data/examples/profile/README.md +48 -48
  220. data/examples/profile/controls/example.rb +23 -23
  221. data/examples/profile/controls/gordon.rb +36 -36
  222. data/examples/profile/controls/meta.rb +34 -34
  223. data/examples/profile/inspec.yml +10 -10
  224. data/examples/profile/libraries/gordon_config.rb +59 -53
  225. data/inspec.gemspec +47 -47
  226. data/lib/bundles/README.md +3 -3
  227. data/lib/bundles/inspec-artifact.rb +7 -7
  228. data/lib/bundles/inspec-artifact/README.md +1 -1
  229. data/lib/bundles/inspec-artifact/cli.rb +277 -277
  230. data/lib/bundles/inspec-compliance.rb +16 -16
  231. data/lib/bundles/inspec-compliance/.kitchen.yml +20 -20
  232. data/lib/bundles/inspec-compliance/README.md +185 -185
  233. data/lib/bundles/inspec-compliance/api.rb +316 -316
  234. data/lib/bundles/inspec-compliance/api/login.rb +152 -152
  235. data/lib/bundles/inspec-compliance/bootstrap.sh +41 -41
  236. data/lib/bundles/inspec-compliance/cli.rb +254 -254
  237. data/lib/bundles/inspec-compliance/configuration.rb +103 -103
  238. data/lib/bundles/inspec-compliance/http.rb +86 -86
  239. data/lib/bundles/inspec-compliance/support.rb +36 -36
  240. data/lib/bundles/inspec-compliance/target.rb +98 -98
  241. data/lib/bundles/inspec-compliance/test/integration/default/cli.rb +93 -93
  242. data/lib/bundles/inspec-habitat.rb +12 -12
  243. data/lib/bundles/inspec-habitat/cli.rb +36 -36
  244. data/lib/bundles/inspec-habitat/log.rb +10 -10
  245. data/lib/bundles/inspec-habitat/profile.rb +391 -391
  246. data/lib/bundles/inspec-init.rb +8 -8
  247. data/lib/bundles/inspec-init/README.md +31 -31
  248. data/lib/bundles/inspec-init/cli.rb +97 -97
  249. data/lib/bundles/inspec-init/templates/profile/README.md +3 -3
  250. data/lib/bundles/inspec-init/templates/profile/controls/example.rb +19 -19
  251. data/lib/bundles/inspec-init/templates/profile/inspec.yml +8 -8
  252. data/lib/bundles/inspec-supermarket.rb +13 -13
  253. data/lib/bundles/inspec-supermarket/README.md +45 -45
  254. data/lib/bundles/inspec-supermarket/api.rb +84 -84
  255. data/lib/bundles/inspec-supermarket/cli.rb +73 -73
  256. data/lib/bundles/inspec-supermarket/target.rb +34 -34
  257. data/lib/fetchers/git.rb +163 -163
  258. data/lib/fetchers/local.rb +74 -74
  259. data/lib/fetchers/mock.rb +35 -35
  260. data/lib/fetchers/url.rb +204 -204
  261. data/lib/inspec.rb +24 -24
  262. data/lib/inspec/archive/tar.rb +29 -29
  263. data/lib/inspec/archive/zip.rb +19 -19
  264. data/lib/inspec/backend.rb +93 -93
  265. data/lib/inspec/base_cli.rb +363 -357
  266. data/lib/inspec/cached_fetcher.rb +66 -66
  267. data/lib/inspec/cli.rb +292 -292
  268. data/lib/inspec/completions/bash.sh.erb +45 -45
  269. data/lib/inspec/completions/fish.sh.erb +34 -34
  270. data/lib/inspec/completions/zsh.sh.erb +61 -61
  271. data/lib/inspec/control_eval_context.rb +179 -179
  272. data/lib/inspec/dependencies/cache.rb +72 -72
  273. data/lib/inspec/dependencies/dependency_set.rb +92 -92
  274. data/lib/inspec/dependencies/lockfile.rb +115 -115
  275. data/lib/inspec/dependencies/requirement.rb +123 -123
  276. data/lib/inspec/dependencies/resolver.rb +86 -86
  277. data/lib/inspec/describe.rb +27 -27
  278. data/lib/inspec/dsl.rb +66 -66
  279. data/lib/inspec/dsl_shared.rb +33 -33
  280. data/lib/inspec/env_printer.rb +157 -157
  281. data/lib/inspec/errors.rb +14 -13
  282. data/lib/inspec/exceptions.rb +12 -12
  283. data/lib/inspec/expect.rb +45 -45
  284. data/lib/inspec/fetcher.rb +45 -45
  285. data/lib/inspec/file_provider.rb +275 -275
  286. data/lib/inspec/formatters.rb +3 -3
  287. data/lib/inspec/formatters/base.rb +259 -250
  288. data/lib/inspec/formatters/json_rspec.rb +20 -20
  289. data/lib/inspec/formatters/show_progress.rb +12 -12
  290. data/lib/inspec/library_eval_context.rb +58 -58
  291. data/lib/inspec/log.rb +11 -11
  292. data/lib/inspec/metadata.rb +247 -247
  293. data/lib/inspec/method_source.rb +24 -24
  294. data/lib/inspec/objects.rb +14 -14
  295. data/lib/inspec/objects/attribute.rb +65 -65
  296. data/lib/inspec/objects/control.rb +61 -61
  297. data/lib/inspec/objects/describe.rb +92 -92
  298. data/lib/inspec/objects/each_loop.rb +36 -36
  299. data/lib/inspec/objects/list.rb +15 -15
  300. data/lib/inspec/objects/or_test.rb +40 -40
  301. data/lib/inspec/objects/ruby_helper.rb +15 -15
  302. data/lib/inspec/objects/tag.rb +27 -27
  303. data/lib/inspec/objects/test.rb +87 -87
  304. data/lib/inspec/objects/value.rb +27 -27
  305. data/lib/inspec/plugins.rb +60 -60
  306. data/lib/inspec/plugins/cli.rb +24 -24
  307. data/lib/inspec/plugins/fetcher.rb +86 -86
  308. data/lib/inspec/plugins/resource.rb +135 -135
  309. data/lib/inspec/plugins/secret.rb +15 -15
  310. data/lib/inspec/plugins/source_reader.rb +40 -40
  311. data/lib/inspec/polyfill.rb +12 -12
  312. data/lib/inspec/profile.rb +513 -513
  313. data/lib/inspec/profile_context.rb +208 -208
  314. data/lib/inspec/profile_vendor.rb +66 -66
  315. data/lib/inspec/reporters.rb +60 -54
  316. data/lib/inspec/reporters/automate.rb +76 -0
  317. data/lib/inspec/reporters/base.rb +25 -24
  318. data/lib/inspec/reporters/cli.rb +356 -356
  319. data/lib/inspec/reporters/json.rb +116 -116
  320. data/lib/inspec/reporters/json_min.rb +48 -48
  321. data/lib/inspec/reporters/junit.rb +77 -77
  322. data/lib/inspec/require_loader.rb +33 -33
  323. data/lib/inspec/resource.rb +187 -186
  324. data/lib/inspec/rule.rb +266 -266
  325. data/lib/inspec/runner.rb +345 -345
  326. data/lib/inspec/runner_mock.rb +41 -41
  327. data/lib/inspec/runner_rspec.rb +175 -175
  328. data/lib/inspec/runtime_profile.rb +26 -26
  329. data/lib/inspec/schema.rb +213 -213
  330. data/lib/inspec/secrets.rb +19 -19
  331. data/lib/inspec/secrets/yaml.rb +30 -30
  332. data/lib/inspec/shell.rb +220 -220
  333. data/lib/inspec/shell_detector.rb +90 -90
  334. data/lib/inspec/source_reader.rb +29 -29
  335. data/lib/inspec/version.rb +8 -8
  336. data/lib/matchers/matchers.rb +339 -339
  337. data/lib/resource_support/aws.rb +49 -47
  338. data/lib/resource_support/aws/aws_backend_base.rb +12 -12
  339. data/lib/resource_support/aws/aws_backend_factory_mixin.rb +12 -12
  340. data/lib/resource_support/aws/aws_plural_resource_mixin.rb +21 -21
  341. data/lib/resource_support/aws/aws_resource_mixin.rb +66 -66
  342. data/lib/resource_support/aws/aws_singular_resource_mixin.rb +24 -24
  343. data/lib/resources/aide_conf.rb +151 -151
  344. data/lib/resources/apache.rb +48 -48
  345. data/lib/resources/apache_conf.rb +149 -149
  346. data/lib/resources/apt.rb +149 -149
  347. data/lib/resources/audit_policy.rb +63 -63
  348. data/lib/resources/auditd.rb +231 -231
  349. data/lib/resources/auditd_conf.rb +46 -46
  350. data/lib/resources/aws/aws_cloudtrail_trail.rb +77 -77
  351. data/lib/resources/aws/aws_cloudtrail_trails.rb +47 -47
  352. data/lib/resources/aws/aws_cloudwatch_alarm.rb +62 -62
  353. data/lib/resources/aws/aws_cloudwatch_log_metric_filter.rb +100 -100
  354. data/lib/resources/aws/aws_config_delivery_channel.rb +76 -76
  355. data/lib/resources/aws/aws_config_recorder.rb +98 -98
  356. data/lib/resources/aws/aws_ec2_instance.rb +157 -157
  357. data/lib/resources/aws/aws_iam_access_key.rb +106 -106
  358. data/lib/resources/aws/aws_iam_access_keys.rb +149 -149
  359. data/lib/resources/aws/aws_iam_group.rb +56 -56
  360. data/lib/resources/aws/aws_iam_groups.rb +52 -52
  361. data/lib/resources/aws/aws_iam_password_policy.rb +116 -116
  362. data/lib/resources/aws/aws_iam_policies.rb +53 -53
  363. data/lib/resources/aws/aws_iam_policy.rb +125 -125
  364. data/lib/resources/aws/aws_iam_role.rb +51 -51
  365. data/lib/resources/aws/aws_iam_root_user.rb +78 -60
  366. data/lib/resources/aws/aws_iam_user.rb +111 -111
  367. data/lib/resources/aws/aws_iam_users.rb +108 -108
  368. data/lib/resources/aws/aws_kms_key.rb +96 -96
  369. data/lib/resources/aws/aws_kms_keys.rb +53 -53
  370. data/lib/resources/aws/aws_rds_instance.rb +71 -71
  371. data/lib/resources/aws/aws_route_table.rb +63 -63
  372. data/lib/resources/aws/aws_route_tables.rb +60 -0
  373. data/lib/resources/aws/aws_s3_bucket.rb +115 -115
  374. data/lib/resources/aws/aws_s3_bucket_object.rb +82 -82
  375. data/lib/resources/aws/aws_s3_buckets.rb +51 -0
  376. data/lib/resources/aws/aws_security_group.rb +93 -93
  377. data/lib/resources/aws/aws_security_groups.rb +68 -68
  378. data/lib/resources/aws/aws_sns_subscription.rb +78 -78
  379. data/lib/resources/aws/aws_sns_topic.rb +53 -53
  380. data/lib/resources/aws/aws_sns_topics.rb +56 -56
  381. data/lib/resources/aws/aws_subnet.rb +88 -88
  382. data/lib/resources/aws/aws_subnets.rb +53 -53
  383. data/lib/resources/aws/aws_vpc.rb +69 -69
  384. data/lib/resources/aws/aws_vpcs.rb +45 -45
  385. data/lib/resources/azure/azure_backend.rb +377 -377
  386. data/lib/resources/azure/azure_generic_resource.rb +59 -59
  387. data/lib/resources/azure/azure_resource_group.rb +152 -152
  388. data/lib/resources/azure/azure_virtual_machine.rb +264 -264
  389. data/lib/resources/azure/azure_virtual_machine_data_disk.rb +134 -134
  390. data/lib/resources/bash.rb +35 -35
  391. data/lib/resources/bond.rb +69 -69
  392. data/lib/resources/bridge.rb +122 -122
  393. data/lib/resources/chocolatey_package.rb +78 -0
  394. data/lib/resources/command.rb +73 -73
  395. data/lib/resources/cpan.rb +58 -58
  396. data/lib/resources/cran.rb +64 -64
  397. data/lib/resources/crontab.rb +169 -169
  398. data/lib/resources/csv.rb +56 -56
  399. data/lib/resources/dh_params.rb +77 -77
  400. data/lib/resources/directory.rb +25 -25
  401. data/lib/resources/docker.rb +236 -236
  402. data/lib/resources/docker_container.rb +89 -89
  403. data/lib/resources/docker_image.rb +83 -83
  404. data/lib/resources/docker_object.rb +57 -57
  405. data/lib/resources/docker_service.rb +90 -90
  406. data/lib/resources/elasticsearch.rb +169 -169
  407. data/lib/resources/etc_fstab.rb +94 -94
  408. data/lib/resources/etc_group.rb +152 -152
  409. data/lib/resources/etc_hosts.rb +66 -66
  410. data/lib/resources/etc_hosts_allow_deny.rb +112 -112
  411. data/lib/resources/file.rb +298 -298
  412. data/lib/resources/filesystem.rb +31 -31
  413. data/lib/resources/firewalld.rb +143 -143
  414. data/lib/resources/gem.rb +70 -70
  415. data/lib/resources/groups.rb +215 -215
  416. data/lib/resources/grub_conf.rb +227 -227
  417. data/lib/resources/host.rb +306 -306
  418. data/lib/resources/http.rb +253 -253
  419. data/lib/resources/iis_app.rb +101 -101
  420. data/lib/resources/iis_site.rb +148 -148
  421. data/lib/resources/inetd_conf.rb +54 -54
  422. data/lib/resources/ini.rb +29 -29
  423. data/lib/resources/interface.rb +129 -129
  424. data/lib/resources/iptables.rb +80 -80
  425. data/lib/resources/json.rb +107 -107
  426. data/lib/resources/kernel_module.rb +107 -107
  427. data/lib/resources/kernel_parameter.rb +58 -58
  428. data/lib/resources/key_rsa.rb +61 -61
  429. data/lib/resources/limits_conf.rb +46 -46
  430. data/lib/resources/login_def.rb +57 -57
  431. data/lib/resources/mount.rb +88 -88
  432. data/lib/resources/mssql_session.rb +101 -101
  433. data/lib/resources/mysql.rb +82 -81
  434. data/lib/resources/mysql_conf.rb +127 -127
  435. data/lib/resources/mysql_session.rb +85 -85
  436. data/lib/resources/nginx.rb +96 -96
  437. data/lib/resources/nginx_conf.rb +226 -226
  438. data/lib/resources/npm.rb +48 -48
  439. data/lib/resources/ntp_conf.rb +51 -51
  440. data/lib/resources/oneget.rb +71 -71
  441. data/lib/resources/oracledb_session.rb +139 -139
  442. data/lib/resources/os.rb +36 -36
  443. data/lib/resources/os_env.rb +75 -75
  444. data/lib/resources/package.rb +370 -370
  445. data/lib/resources/packages.rb +111 -111
  446. data/lib/resources/parse_config.rb +112 -112
  447. data/lib/resources/passwd.rb +76 -76
  448. data/lib/resources/pip.rb +130 -130
  449. data/lib/resources/platform.rb +109 -109
  450. data/lib/resources/port.rb +771 -771
  451. data/lib/resources/postgres.rb +131 -130
  452. data/lib/resources/postgres_conf.rb +114 -114
  453. data/lib/resources/postgres_hba_conf.rb +90 -90
  454. data/lib/resources/postgres_ident_conf.rb +79 -79
  455. data/lib/resources/postgres_session.rb +71 -71
  456. data/lib/resources/powershell.rb +66 -66
  457. data/lib/resources/processes.rb +204 -204
  458. data/lib/resources/rabbitmq_conf.rb +51 -51
  459. data/lib/resources/registry_key.rb +297 -297
  460. data/lib/resources/security_policy.rb +180 -180
  461. data/lib/resources/service.rb +794 -790
  462. data/lib/resources/shadow.rb +149 -149
  463. data/lib/resources/ssh_conf.rb +97 -97
  464. data/lib/resources/ssl.rb +99 -99
  465. data/lib/resources/sys_info.rb +28 -28
  466. data/lib/resources/toml.rb +32 -32
  467. data/lib/resources/users.rb +654 -654
  468. data/lib/resources/vbscript.rb +68 -68
  469. data/lib/resources/virtualization.rb +247 -247
  470. data/lib/resources/windows_feature.rb +84 -84
  471. data/lib/resources/windows_hotfix.rb +35 -35
  472. data/lib/resources/windows_task.rb +102 -102
  473. data/lib/resources/wmi.rb +110 -110
  474. data/lib/resources/x509_certificate.rb +137 -137
  475. data/lib/resources/xinetd.rb +106 -106
  476. data/lib/resources/xml.rb +46 -46
  477. data/lib/resources/yaml.rb +43 -43
  478. data/lib/resources/yum.rb +180 -180
  479. data/lib/resources/zfs_dataset.rb +60 -60
  480. data/lib/resources/zfs_pool.rb +49 -49
  481. data/lib/source_readers/flat.rb +39 -39
  482. data/lib/source_readers/inspec.rb +75 -75
  483. data/lib/utils/command_wrapper.rb +27 -27
  484. data/lib/utils/convert.rb +12 -12
  485. data/lib/utils/database_helpers.rb +77 -77
  486. data/lib/utils/erlang_parser.rb +192 -192
  487. data/lib/utils/file_reader.rb +25 -25
  488. data/lib/utils/filter.rb +273 -273
  489. data/lib/utils/filter_array.rb +27 -27
  490. data/lib/utils/find_files.rb +44 -44
  491. data/lib/utils/hash.rb +41 -41
  492. data/lib/utils/json_log.rb +18 -18
  493. data/lib/utils/latest_version.rb +22 -22
  494. data/lib/utils/modulator.rb +12 -12
  495. data/lib/utils/nginx_parser.rb +85 -85
  496. data/lib/utils/object_traversal.rb +49 -49
  497. data/lib/utils/parser.rb +274 -274
  498. data/lib/utils/plugin_registry.rb +93 -93
  499. data/lib/utils/simpleconfig.rb +120 -120
  500. data/lib/utils/spdx.rb +13 -13
  501. data/lib/utils/spdx.txt +343 -343
  502. metadata +9 -2
@@ -1,72 +1,72 @@
1
- # encoding: utf-8
2
- require 'fileutils'
3
-
4
- module Inspec
5
- #
6
- # Inspec::Cache manages an on-disk cache of inspec profiles. The
7
- # cache can contain:
8
- #
9
- # - .tar.gz profile archives
10
- # - .zip profile archives
11
- # - unpacked profiles
12
- #
13
- # Cache entries names include a hash of their source to prevent
14
- # conflicts between depenedencies with the same name from different
15
- # sources.
16
- #
17
- #
18
- class Cache
19
- attr_reader :path
20
- def initialize(path = nil)
21
- @path = path || File.join(Dir.home, '.inspec', 'cache')
22
- FileUtils.mkdir_p(@path) unless File.directory?(@path)
23
- end
24
-
25
- def prefered_entry_for(key)
26
- path = base_path_for(key)
27
- if File.directory?(path)
28
- path
29
- else
30
- archive_entry_for(key)
31
- end
32
- end
33
-
34
- def archive_entry_for(key)
35
- path = base_path_for(key)
36
- if File.exist?("#{path}.tar.gz")
37
- "#{path}.tar.gz"
38
- elsif File.exist?("#{path}.zip")
39
- "#{path}.zip"
40
- end
41
- end
42
-
43
- #
44
- # For a given name and source_url, return true if the
45
- # profile exists in the Cache.
46
- #
47
- # @param [String] name
48
- # @param [String] source_url
49
- # @return [Boolean]
50
- #
51
- def exists?(key)
52
- return false if key.nil? || key.empty?
53
- path = base_path_for(key)
54
- File.directory?(path) || File.exist?("#{path}.tar.gz") || File.exist?("#{path}.zip")
55
- end
56
-
57
- #
58
- # Return the path to given profile in the cache.
59
- #
60
- # The `source_url` parameter should be a URI-like string that
61
- # fully specifies the source of the exact version we want to pull
62
- # down.
63
- #
64
- # @param [String] name
65
- # @param [String] source_url
66
- # @return [String]
67
- #
68
- def base_path_for(cache_key)
69
- File.join(@path, cache_key)
70
- end
71
- end
72
- end
1
+ # encoding: utf-8
2
+ require 'fileutils'
3
+
4
+ module Inspec
5
+ #
6
+ # Inspec::Cache manages an on-disk cache of inspec profiles. The
7
+ # cache can contain:
8
+ #
9
+ # - .tar.gz profile archives
10
+ # - .zip profile archives
11
+ # - unpacked profiles
12
+ #
13
+ # Cache entries names include a hash of their source to prevent
14
+ # conflicts between depenedencies with the same name from different
15
+ # sources.
16
+ #
17
+ #
18
+ class Cache
19
+ attr_reader :path
20
+ def initialize(path = nil)
21
+ @path = path || File.join(Dir.home, '.inspec', 'cache')
22
+ FileUtils.mkdir_p(@path) unless File.directory?(@path)
23
+ end
24
+
25
+ def prefered_entry_for(key)
26
+ path = base_path_for(key)
27
+ if File.directory?(path)
28
+ path
29
+ else
30
+ archive_entry_for(key)
31
+ end
32
+ end
33
+
34
+ def archive_entry_for(key)
35
+ path = base_path_for(key)
36
+ if File.exist?("#{path}.tar.gz")
37
+ "#{path}.tar.gz"
38
+ elsif File.exist?("#{path}.zip")
39
+ "#{path}.zip"
40
+ end
41
+ end
42
+
43
+ #
44
+ # For a given name and source_url, return true if the
45
+ # profile exists in the Cache.
46
+ #
47
+ # @param [String] name
48
+ # @param [String] source_url
49
+ # @return [Boolean]
50
+ #
51
+ def exists?(key)
52
+ return false if key.nil? || key.empty?
53
+ path = base_path_for(key)
54
+ File.directory?(path) || File.exist?("#{path}.tar.gz") || File.exist?("#{path}.zip")
55
+ end
56
+
57
+ #
58
+ # Return the path to given profile in the cache.
59
+ #
60
+ # The `source_url` parameter should be a URI-like string that
61
+ # fully specifies the source of the exact version we want to pull
62
+ # down.
63
+ #
64
+ # @param [String] name
65
+ # @param [String] source_url
66
+ # @return [String]
67
+ #
68
+ def base_path_for(cache_key)
69
+ File.join(@path, cache_key)
70
+ end
71
+ end
72
+ end
@@ -1,92 +1,92 @@
1
- # encoding: utf-8
2
- require 'inspec/dependencies/requirement'
3
- require 'inspec/dependencies/resolver'
4
-
5
- module Inspec
6
- #
7
- # A DependencySet manages a list of dependencies for a profile.
8
- #
9
- class DependencySet
10
- #
11
- # Return a dependency set given a lockfile.
12
- #
13
- # @param lockfile [Inspec::Lockfile] A lockfile to generate the dependency set from
14
- # @param cwd [String] Current working directory for relative path includes
15
- # @param vendor_path [String] Path to the vendor directory
16
- #
17
- def self.from_lockfile(lockfile, cwd, cache, backend, opts = {})
18
- dep_tree = lockfile.deps.map do |dep|
19
- Inspec::Requirement.from_lock_entry(dep, cwd, cache, backend, opts)
20
- end
21
-
22
- dep_list = flatten_dep_tree(dep_tree)
23
- new(cwd, cache, dep_list, backend)
24
- end
25
-
26
- def self.from_array(dependencies, cwd, cache, backend)
27
- dep_list = {}
28
- dependencies.each do |d|
29
- dep_list[d.name] = d
30
- end
31
- new(cwd, cache, dep_list, backend)
32
- end
33
-
34
- # This is experimental code to test the working of the
35
- # dependency loader - perform a proper dependency related search
36
- # in the future.
37
- #
38
- # Flatten tree because that is all we know how to deal with for
39
- # right now. Last dep seen for a given name wins right now.
40
- def self.flatten_dep_tree(dep_tree)
41
- dep_list = {}
42
- dep_tree.each do |d|
43
- dep_list[d.name] = d
44
- dep_list.merge!(flatten_dep_tree(d.dependencies))
45
- end
46
- dep_list
47
- end
48
-
49
- attr_reader :vendor_path
50
- attr_writer :dep_list
51
- # initialize
52
- #
53
- # @param cwd [String] current working directory for relative path includes
54
- # @param vendor_path [String] path which contains vendored dependencies
55
- # @return [dependencies] this
56
- def initialize(cwd, cache, dep_list, backend)
57
- @cwd = cwd
58
- @cache = cache
59
- @dep_list = dep_list
60
- @backend = backend
61
- end
62
-
63
- def each
64
- @dep_list.each do |_k, v|
65
- yield v.profile
66
- end
67
- end
68
-
69
- def list
70
- @dep_list || {}
71
- end
72
-
73
- def to_array
74
- return [] if @dep_list.nil?
75
- @dep_list.map do |_k, v|
76
- v.to_hash
77
- end.compact
78
- end
79
-
80
- #
81
- # 1. Get dependencies, pull things to a local cache if necessary
82
- # 2. Resolve dependencies
83
- #
84
- # @param dependencies [Gem::Dependency] list of dependencies
85
- # @return [nil]
86
- #
87
- def vendor(dependencies)
88
- return nil if dependencies.nil? || dependencies.empty?
89
- @dep_list = Resolver.resolve(dependencies, @cache, @cwd, @backend)
90
- end
91
- end
92
- end
1
+ # encoding: utf-8
2
+ require 'inspec/dependencies/requirement'
3
+ require 'inspec/dependencies/resolver'
4
+
5
+ module Inspec
6
+ #
7
+ # A DependencySet manages a list of dependencies for a profile.
8
+ #
9
+ class DependencySet
10
+ #
11
+ # Return a dependency set given a lockfile.
12
+ #
13
+ # @param lockfile [Inspec::Lockfile] A lockfile to generate the dependency set from
14
+ # @param cwd [String] Current working directory for relative path includes
15
+ # @param vendor_path [String] Path to the vendor directory
16
+ #
17
+ def self.from_lockfile(lockfile, cwd, cache, backend, opts = {})
18
+ dep_tree = lockfile.deps.map do |dep|
19
+ Inspec::Requirement.from_lock_entry(dep, cwd, cache, backend, opts)
20
+ end
21
+
22
+ dep_list = flatten_dep_tree(dep_tree)
23
+ new(cwd, cache, dep_list, backend)
24
+ end
25
+
26
+ def self.from_array(dependencies, cwd, cache, backend)
27
+ dep_list = {}
28
+ dependencies.each do |d|
29
+ dep_list[d.name] = d
30
+ end
31
+ new(cwd, cache, dep_list, backend)
32
+ end
33
+
34
+ # This is experimental code to test the working of the
35
+ # dependency loader - perform a proper dependency related search
36
+ # in the future.
37
+ #
38
+ # Flatten tree because that is all we know how to deal with for
39
+ # right now. Last dep seen for a given name wins right now.
40
+ def self.flatten_dep_tree(dep_tree)
41
+ dep_list = {}
42
+ dep_tree.each do |d|
43
+ dep_list[d.name] = d
44
+ dep_list.merge!(flatten_dep_tree(d.dependencies))
45
+ end
46
+ dep_list
47
+ end
48
+
49
+ attr_reader :vendor_path
50
+ attr_writer :dep_list
51
+ # initialize
52
+ #
53
+ # @param cwd [String] current working directory for relative path includes
54
+ # @param vendor_path [String] path which contains vendored dependencies
55
+ # @return [dependencies] this
56
+ def initialize(cwd, cache, dep_list, backend)
57
+ @cwd = cwd
58
+ @cache = cache
59
+ @dep_list = dep_list
60
+ @backend = backend
61
+ end
62
+
63
+ def each
64
+ @dep_list.each do |_k, v|
65
+ yield v.profile
66
+ end
67
+ end
68
+
69
+ def list
70
+ @dep_list || {}
71
+ end
72
+
73
+ def to_array
74
+ return [] if @dep_list.nil?
75
+ @dep_list.map do |_k, v|
76
+ v.to_hash
77
+ end.compact
78
+ end
79
+
80
+ #
81
+ # 1. Get dependencies, pull things to a local cache if necessary
82
+ # 2. Resolve dependencies
83
+ #
84
+ # @param dependencies [Gem::Dependency] list of dependencies
85
+ # @return [nil]
86
+ #
87
+ def vendor(dependencies)
88
+ return nil if dependencies.nil? || dependencies.empty?
89
+ @dep_list = Resolver.resolve(dependencies, @cache, @cwd, @backend)
90
+ end
91
+ end
92
+ end
@@ -1,115 +1,115 @@
1
- # encoding: utf-8
2
- require 'yaml'
3
-
4
- module Inspec
5
- class Lockfile
6
- # When we finalize this feature, we should set these to 1
7
- MINIMUM_SUPPORTED_VERSION = 1
8
- CURRENT_LOCKFILE_VERSION = 1
9
-
10
- def self.from_dependency_set(dep_set)
11
- lockfile_content = {
12
- 'lockfile_version' => CURRENT_LOCKFILE_VERSION,
13
- 'depends' => dep_set.to_array,
14
- }
15
- new(lockfile_content)
16
- end
17
-
18
- def self.from_content(content)
19
- parsed_content = YAML.load(content)
20
- version = parsed_content['lockfile_version']
21
- raise "No lockfile_version set in #{path}!" if version.nil?
22
- validate_lockfile_version!(version.to_i)
23
- new(parsed_content)
24
- end
25
-
26
- def self.from_file(path)
27
- content = File.read(path)
28
- from_content(content)
29
- end
30
-
31
- def self.validate_lockfile_version!(version)
32
- if version < MINIMUM_SUPPORTED_VERSION
33
- raise <<~EOF
34
- This lockfile specifies a lockfile_version of #{version} which is
35
- lower than the minimum supported version #{MINIMUM_SUPPORTED_VERSION}.
36
-
37
- Please create a new lockfile for this project by running:
38
-
39
- inspec vendor
40
- EOF
41
- elsif version > CURRENT_LOCKFILE_VERSION
42
- raise <<~EOF
43
- This lockfile claims to be version #{version} which is greater than
44
- the most recent lockfile version(#{CURRENT_LOCKFILE_VERSION}).
45
-
46
- This may happen if you are using an older version of inspec than was
47
- used to create the lockfile.
48
- EOF
49
- end
50
- end
51
-
52
- attr_reader :version, :deps
53
- def initialize(lockfile_content_hash)
54
- version = lockfile_content_hash['lockfile_version']
55
- @version = version.to_i
56
- parse_content_hash(lockfile_content_hash)
57
- end
58
-
59
- def to_yaml
60
- {
61
- 'lockfile_version' => CURRENT_LOCKFILE_VERSION,
62
- 'depends' => @deps.map { |i| stringify_keys(i) },
63
- }.to_yaml
64
- end
65
-
66
- private
67
-
68
- # Refactor this to be "version-wise" - i.e. make one dispatch
69
- # function for each version so that even if it duplicates code,
70
- # it can describe the part of the code that it expects to be
71
- # different. Then that dispatch routine can call more well
72
- # defined methods like "parse_v0_dependencies" or
73
- # "parse_flat_dependencies" or what not as things generally
74
- # develop. It does help people easily set breakpoints/track
75
- # different entry points of the API.
76
- def parse_content_hash(lockfile_content_hash)
77
- case version
78
- when 1
79
- parse_content_hash_1(lockfile_content_hash)
80
- else
81
- # If we've gotten here, there is likely a mistake in the
82
- # lockfile version validation in the constructor.
83
- raise "No lockfile parser for version #{version}"
84
- end
85
- end
86
-
87
- def parse_content_hash_1(lockfile_content_hash)
88
- @deps = lockfile_content_hash['depends']&.map { |i| symbolize_keys(i) }
89
- end
90
-
91
- def mutate_hash_keys_with(hash, fun)
92
- hash.each_with_object({}) do |v, memo|
93
- key = fun.call(v[0])
94
- value = if v[1].is_a?(Hash)
95
- mutate_hash_keys_with(v[1], fun)
96
- elsif v[1].is_a?(Array)
97
- v[1].map do |i|
98
- i.is_a?(Hash) ? mutate_hash_keys_with(i, fun) : i
99
- end
100
- else
101
- v[1]
102
- end
103
- memo[key] = value
104
- end
105
- end
106
-
107
- def stringify_keys(hash)
108
- mutate_hash_keys_with(hash, proc { |i| i.to_s })
109
- end
110
-
111
- def symbolize_keys(hash)
112
- mutate_hash_keys_with(hash, proc { |i| i.to_sym })
113
- end
114
- end
115
- end
1
+ # encoding: utf-8
2
+ require 'yaml'
3
+
4
+ module Inspec
5
+ class Lockfile
6
+ # When we finalize this feature, we should set these to 1
7
+ MINIMUM_SUPPORTED_VERSION = 1
8
+ CURRENT_LOCKFILE_VERSION = 1
9
+
10
+ def self.from_dependency_set(dep_set)
11
+ lockfile_content = {
12
+ 'lockfile_version' => CURRENT_LOCKFILE_VERSION,
13
+ 'depends' => dep_set.to_array,
14
+ }
15
+ new(lockfile_content)
16
+ end
17
+
18
+ def self.from_content(content)
19
+ parsed_content = YAML.load(content)
20
+ version = parsed_content['lockfile_version']
21
+ raise "No lockfile_version set in #{path}!" if version.nil?
22
+ validate_lockfile_version!(version.to_i)
23
+ new(parsed_content)
24
+ end
25
+
26
+ def self.from_file(path)
27
+ content = File.read(path)
28
+ from_content(content)
29
+ end
30
+
31
+ def self.validate_lockfile_version!(version)
32
+ if version < MINIMUM_SUPPORTED_VERSION
33
+ raise <<~EOF
34
+ This lockfile specifies a lockfile_version of #{version} which is
35
+ lower than the minimum supported version #{MINIMUM_SUPPORTED_VERSION}.
36
+
37
+ Please create a new lockfile for this project by running:
38
+
39
+ inspec vendor
40
+ EOF
41
+ elsif version > CURRENT_LOCKFILE_VERSION
42
+ raise <<~EOF
43
+ This lockfile claims to be version #{version} which is greater than
44
+ the most recent lockfile version(#{CURRENT_LOCKFILE_VERSION}).
45
+
46
+ This may happen if you are using an older version of inspec than was
47
+ used to create the lockfile.
48
+ EOF
49
+ end
50
+ end
51
+
52
+ attr_reader :version, :deps
53
+ def initialize(lockfile_content_hash)
54
+ version = lockfile_content_hash['lockfile_version']
55
+ @version = version.to_i
56
+ parse_content_hash(lockfile_content_hash)
57
+ end
58
+
59
+ def to_yaml
60
+ {
61
+ 'lockfile_version' => CURRENT_LOCKFILE_VERSION,
62
+ 'depends' => @deps.map { |i| stringify_keys(i) },
63
+ }.to_yaml
64
+ end
65
+
66
+ private
67
+
68
+ # Refactor this to be "version-wise" - i.e. make one dispatch
69
+ # function for each version so that even if it duplicates code,
70
+ # it can describe the part of the code that it expects to be
71
+ # different. Then that dispatch routine can call more well
72
+ # defined methods like "parse_v0_dependencies" or
73
+ # "parse_flat_dependencies" or what not as things generally
74
+ # develop. It does help people easily set breakpoints/track
75
+ # different entry points of the API.
76
+ def parse_content_hash(lockfile_content_hash)
77
+ case version
78
+ when 1
79
+ parse_content_hash_1(lockfile_content_hash)
80
+ else
81
+ # If we've gotten here, there is likely a mistake in the
82
+ # lockfile version validation in the constructor.
83
+ raise "No lockfile parser for version #{version}"
84
+ end
85
+ end
86
+
87
+ def parse_content_hash_1(lockfile_content_hash)
88
+ @deps = lockfile_content_hash['depends']&.map { |i| symbolize_keys(i) }
89
+ end
90
+
91
+ def mutate_hash_keys_with(hash, fun)
92
+ hash.each_with_object({}) do |v, memo|
93
+ key = fun.call(v[0])
94
+ value = if v[1].is_a?(Hash)
95
+ mutate_hash_keys_with(v[1], fun)
96
+ elsif v[1].is_a?(Array)
97
+ v[1].map do |i|
98
+ i.is_a?(Hash) ? mutate_hash_keys_with(i, fun) : i
99
+ end
100
+ else
101
+ v[1]
102
+ end
103
+ memo[key] = value
104
+ end
105
+ end
106
+
107
+ def stringify_keys(hash)
108
+ mutate_hash_keys_with(hash, proc { |i| i.to_s })
109
+ end
110
+
111
+ def symbolize_keys(hash)
112
+ mutate_hash_keys_with(hash, proc { |i| i.to_sym })
113
+ end
114
+ end
115
+ end