inspec 2.1.81 → 2.1.83

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 (507) hide show
  1. checksums.yaml +5 -5
  2. data/.rubocop.yml +101 -101
  3. data/CHANGELOG.md +3183 -3177
  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 +453 -453
  9. data/Rakefile +349 -349
  10. data/bin/inspec +12 -12
  11. data/docs/.gitignore +2 -2
  12. data/docs/README.md +41 -40
  13. data/docs/dev/control-eval.md +61 -61
  14. data/docs/dsl_inspec.md +258 -258
  15. data/docs/dsl_resource.md +100 -100
  16. data/docs/glossary.md +99 -99
  17. data/docs/habitat.md +191 -191
  18. data/docs/inspec_and_friends.md +114 -114
  19. data/docs/matchers.md +169 -169
  20. data/docs/migration.md +293 -293
  21. data/docs/platforms.md +118 -118
  22. data/docs/plugin_kitchen_inspec.md +50 -50
  23. data/docs/profiles.md +378 -378
  24. data/docs/reporters.md +105 -105
  25. data/docs/resources/aide_conf.md.erb +75 -75
  26. data/docs/resources/apache.md.erb +67 -67
  27. data/docs/resources/apache_conf.md.erb +68 -68
  28. data/docs/resources/apt.md.erb +71 -71
  29. data/docs/resources/audit_policy.md.erb +47 -47
  30. data/docs/resources/auditd.md.erb +79 -79
  31. data/docs/resources/auditd_conf.md.erb +68 -68
  32. data/docs/resources/aws_cloudtrail_trail.md.erb +155 -155
  33. data/docs/resources/aws_cloudtrail_trails.md.erb +86 -86
  34. data/docs/resources/aws_cloudwatch_alarm.md.erb +91 -91
  35. data/docs/resources/aws_cloudwatch_log_metric_filter.md.erb +154 -154
  36. data/docs/resources/aws_config_delivery_channel.md.erb +101 -101
  37. data/docs/resources/aws_config_recorder.md.erb +86 -86
  38. data/docs/resources/aws_ec2_instance.md.erb +112 -112
  39. data/docs/resources/aws_ec2_instances.md.erb +79 -79
  40. data/docs/resources/aws_iam_access_key.md.erb +129 -129
  41. data/docs/resources/aws_iam_access_keys.md.erb +204 -204
  42. data/docs/resources/aws_iam_group.md.erb +64 -64
  43. data/docs/resources/aws_iam_groups.md.erb +49 -49
  44. data/docs/resources/aws_iam_password_policy.md.erb +82 -82
  45. data/docs/resources/aws_iam_policies.md.erb +87 -87
  46. data/docs/resources/aws_iam_policy.md.erb +245 -245
  47. data/docs/resources/aws_iam_role.md.erb +69 -69
  48. data/docs/resources/aws_iam_root_user.md.erb +76 -76
  49. data/docs/resources/aws_iam_user.md.erb +120 -120
  50. data/docs/resources/aws_iam_users.md.erb +279 -279
  51. data/docs/resources/aws_kms_key.md.erb +177 -177
  52. data/docs/resources/aws_kms_keys.md.erb +89 -89
  53. data/docs/resources/aws_rds_instance.md.erb +66 -66
  54. data/docs/resources/aws_route_table.md.erb +53 -53
  55. data/docs/resources/aws_route_tables.md.erb +55 -55
  56. data/docs/resources/aws_s3_bucket.md.erb +146 -146
  57. data/docs/resources/aws_s3_bucket_object.md.erb +89 -89
  58. data/docs/resources/aws_s3_buckets.md.erb +59 -59
  59. data/docs/resources/aws_security_group.md.erb +296 -296
  60. data/docs/resources/aws_security_groups.md.erb +97 -97
  61. data/docs/resources/aws_sns_subscription.md.erb +130 -130
  62. data/docs/resources/aws_sns_topic.md.erb +69 -69
  63. data/docs/resources/aws_sns_topics.md.erb +58 -58
  64. data/docs/resources/aws_subnet.md.erb +140 -140
  65. data/docs/resources/aws_subnets.md.erb +132 -132
  66. data/docs/resources/aws_vpc.md.erb +125 -125
  67. data/docs/resources/aws_vpcs.md.erb +125 -125
  68. data/docs/resources/azure_generic_resource.md.erb +171 -171
  69. data/docs/resources/azure_resource_group.md.erb +284 -284
  70. data/docs/resources/azure_virtual_machine.md.erb +347 -347
  71. data/docs/resources/azure_virtual_machine_data_disk.md.erb +224 -224
  72. data/docs/resources/bash.md.erb +75 -75
  73. data/docs/resources/bond.md.erb +90 -90
  74. data/docs/resources/bridge.md.erb +57 -57
  75. data/docs/resources/bsd_service.md.erb +67 -67
  76. data/docs/resources/chocolatey_package.md.erb +58 -58
  77. data/docs/resources/command.md.erb +138 -138
  78. data/docs/resources/cpan.md.erb +79 -79
  79. data/docs/resources/cran.md.erb +64 -64
  80. data/docs/resources/crontab.md.erb +89 -89
  81. data/docs/resources/csv.md.erb +54 -54
  82. data/docs/resources/dh_params.md.erb +205 -205
  83. data/docs/resources/directory.md.erb +30 -30
  84. data/docs/resources/docker.md.erb +219 -219
  85. data/docs/resources/docker_container.md.erb +103 -103
  86. data/docs/resources/docker_image.md.erb +94 -94
  87. data/docs/resources/docker_service.md.erb +114 -114
  88. data/docs/resources/elasticsearch.md.erb +242 -242
  89. data/docs/resources/etc_fstab.md.erb +125 -125
  90. data/docs/resources/etc_group.md.erb +75 -75
  91. data/docs/resources/etc_hosts.md.erb +78 -78
  92. data/docs/resources/etc_hosts_allow.md.erb +74 -74
  93. data/docs/resources/etc_hosts_deny.md.erb +74 -74
  94. data/docs/resources/file.md.erb +526 -526
  95. data/docs/resources/filesystem.md.erb +41 -41
  96. data/docs/resources/firewalld.md.erb +107 -107
  97. data/docs/resources/gem.md.erb +79 -79
  98. data/docs/resources/group.md.erb +61 -61
  99. data/docs/resources/grub_conf.md.erb +101 -101
  100. data/docs/resources/host.md.erb +86 -86
  101. data/docs/resources/http.md.erb +197 -197
  102. data/docs/resources/iis_app.md.erb +122 -122
  103. data/docs/resources/iis_site.md.erb +135 -135
  104. data/docs/resources/inetd_conf.md.erb +94 -94
  105. data/docs/resources/ini.md.erb +76 -76
  106. data/docs/resources/interface.md.erb +58 -58
  107. data/docs/resources/iptables.md.erb +64 -64
  108. data/docs/resources/json.md.erb +63 -63
  109. data/docs/resources/kernel_module.md.erb +120 -120
  110. data/docs/resources/kernel_parameter.md.erb +53 -53
  111. data/docs/resources/key_rsa.md.erb +85 -85
  112. data/docs/resources/launchd_service.md.erb +57 -57
  113. data/docs/resources/limits_conf.md.erb +75 -75
  114. data/docs/resources/login_defs.md.erb +71 -71
  115. data/docs/resources/mount.md.erb +69 -69
  116. data/docs/resources/mssql_session.md.erb +60 -60
  117. data/docs/resources/mysql_conf.md.erb +99 -99
  118. data/docs/resources/mysql_session.md.erb +74 -74
  119. data/docs/resources/nginx.md.erb +79 -79
  120. data/docs/resources/nginx_conf.md.erb +138 -138
  121. data/docs/resources/npm.md.erb +60 -60
  122. data/docs/resources/ntp_conf.md.erb +60 -60
  123. data/docs/resources/oneget.md.erb +53 -53
  124. data/docs/resources/oracledb_session.md.erb +52 -52
  125. data/docs/resources/os.md.erb +141 -141
  126. data/docs/resources/os_env.md.erb +91 -91
  127. data/docs/resources/package.md.erb +120 -120
  128. data/docs/resources/packages.md.erb +67 -67
  129. data/docs/resources/parse_config.md.erb +103 -103
  130. data/docs/resources/parse_config_file.md.erb +138 -138
  131. data/docs/resources/passwd.md.erb +141 -141
  132. data/docs/resources/pip.md.erb +67 -67
  133. data/docs/resources/port.md.erb +137 -137
  134. data/docs/resources/postgres_conf.md.erb +79 -79
  135. data/docs/resources/postgres_hba_conf.md.erb +93 -93
  136. data/docs/resources/postgres_ident_conf.md.erb +76 -76
  137. data/docs/resources/postgres_session.md.erb +69 -69
  138. data/docs/resources/powershell.md.erb +102 -102
  139. data/docs/resources/processes.md.erb +109 -109
  140. data/docs/resources/rabbitmq_config.md.erb +41 -41
  141. data/docs/resources/registry_key.md.erb +158 -158
  142. data/docs/resources/runit_service.md.erb +57 -57
  143. data/docs/resources/security_policy.md.erb +47 -47
  144. data/docs/resources/service.md.erb +121 -121
  145. data/docs/resources/shadow.md.erb +146 -146
  146. data/docs/resources/ssh_config.md.erb +73 -73
  147. data/docs/resources/sshd_config.md.erb +83 -83
  148. data/docs/resources/ssl.md.erb +119 -119
  149. data/docs/resources/sys_info.md.erb +42 -42
  150. data/docs/resources/systemd_service.md.erb +57 -57
  151. data/docs/resources/sysv_service.md.erb +57 -57
  152. data/docs/resources/upstart_service.md.erb +57 -57
  153. data/docs/resources/user.md.erb +140 -140
  154. data/docs/resources/users.md.erb +127 -127
  155. data/docs/resources/vbscript.md.erb +55 -55
  156. data/docs/resources/virtualization.md.erb +57 -57
  157. data/docs/resources/windows_feature.md.erb +47 -47
  158. data/docs/resources/windows_hotfix.md.erb +53 -53
  159. data/docs/resources/windows_task.md.erb +95 -95
  160. data/docs/resources/wmi.md.erb +81 -81
  161. data/docs/resources/x509_certificate.md.erb +151 -151
  162. data/docs/resources/xinetd_conf.md.erb +156 -156
  163. data/docs/resources/xml.md.erb +85 -85
  164. data/docs/resources/yaml.md.erb +69 -69
  165. data/docs/resources/yum.md.erb +98 -98
  166. data/docs/resources/zfs_dataset.md.erb +53 -53
  167. data/docs/resources/zfs_pool.md.erb +47 -47
  168. data/docs/ruby_usage.md +203 -203
  169. data/docs/shared/matcher_be.md.erb +1 -1
  170. data/docs/shared/matcher_cmp.md.erb +43 -43
  171. data/docs/shared/matcher_eq.md.erb +3 -3
  172. data/docs/shared/matcher_include.md.erb +1 -1
  173. data/docs/shared/matcher_match.md.erb +1 -1
  174. data/docs/shell.md +217 -217
  175. data/examples/README.md +8 -8
  176. data/examples/inheritance/README.md +65 -65
  177. data/examples/inheritance/controls/example.rb +14 -14
  178. data/examples/inheritance/inspec.yml +15 -15
  179. data/examples/kitchen-ansible/.kitchen.yml +25 -25
  180. data/examples/kitchen-ansible/Gemfile +19 -19
  181. data/examples/kitchen-ansible/README.md +53 -53
  182. data/examples/kitchen-ansible/files/nginx.repo +6 -6
  183. data/examples/kitchen-ansible/tasks/main.yml +16 -16
  184. data/examples/kitchen-ansible/test/integration/default/default.yml +5 -5
  185. data/examples/kitchen-ansible/test/integration/default/web_spec.rb +28 -28
  186. data/examples/kitchen-chef/.kitchen.yml +20 -20
  187. data/examples/kitchen-chef/Berksfile +3 -3
  188. data/examples/kitchen-chef/Gemfile +19 -19
  189. data/examples/kitchen-chef/README.md +27 -27
  190. data/examples/kitchen-chef/metadata.rb +7 -7
  191. data/examples/kitchen-chef/recipes/default.rb +6 -6
  192. data/examples/kitchen-chef/recipes/nginx.rb +30 -30
  193. data/examples/kitchen-chef/test/integration/default/web_spec.rb +28 -28
  194. data/examples/kitchen-puppet/.kitchen.yml +23 -23
  195. data/examples/kitchen-puppet/Gemfile +20 -20
  196. data/examples/kitchen-puppet/Puppetfile +25 -25
  197. data/examples/kitchen-puppet/README.md +53 -53
  198. data/examples/kitchen-puppet/manifests/site.pp +33 -33
  199. data/examples/kitchen-puppet/metadata.json +11 -11
  200. data/examples/kitchen-puppet/test/integration/default/web_spec.rb +28 -28
  201. data/examples/meta-profile/README.md +37 -37
  202. data/examples/meta-profile/controls/example.rb +13 -13
  203. data/examples/meta-profile/inspec.yml +13 -13
  204. data/examples/profile-attribute.yml +2 -2
  205. data/examples/profile-attribute/README.md +14 -14
  206. data/examples/profile-attribute/controls/example.rb +11 -11
  207. data/examples/profile-attribute/inspec.yml +8 -8
  208. data/examples/profile-aws/controls/iam_password_policy_expiration.rb +8 -8
  209. data/examples/profile-aws/controls/iam_password_policy_max_age.rb +8 -8
  210. data/examples/profile-aws/controls/iam_root_user_mfa.rb +8 -8
  211. data/examples/profile-aws/controls/iam_users_access_key_age.rb +8 -8
  212. data/examples/profile-aws/controls/iam_users_console_users_mfa.rb +8 -8
  213. data/examples/profile-aws/inspec.yml +11 -11
  214. data/examples/profile-azure/controls/azure_resource_group_example.rb +24 -24
  215. data/examples/profile-azure/controls/azure_vm_example.rb +29 -29
  216. data/examples/profile-azure/inspec.yml +11 -11
  217. data/examples/profile-sensitive/README.md +29 -29
  218. data/examples/profile-sensitive/controls/sensitive-failures.rb +9 -9
  219. data/examples/profile-sensitive/controls/sensitive.rb +9 -9
  220. data/examples/profile-sensitive/inspec.yml +8 -8
  221. data/examples/profile/README.md +48 -48
  222. data/examples/profile/controls/example.rb +23 -23
  223. data/examples/profile/controls/gordon.rb +36 -36
  224. data/examples/profile/controls/meta.rb +34 -34
  225. data/examples/profile/inspec.yml +10 -10
  226. data/examples/profile/libraries/gordon_config.rb +59 -59
  227. data/inspec.gemspec +49 -49
  228. data/lib/bundles/README.md +3 -3
  229. data/lib/bundles/inspec-artifact.rb +7 -7
  230. data/lib/bundles/inspec-artifact/README.md +1 -1
  231. data/lib/bundles/inspec-artifact/cli.rb +277 -277
  232. data/lib/bundles/inspec-compliance.rb +16 -16
  233. data/lib/bundles/inspec-compliance/.kitchen.yml +20 -20
  234. data/lib/bundles/inspec-compliance/README.md +193 -193
  235. data/lib/bundles/inspec-compliance/api.rb +360 -360
  236. data/lib/bundles/inspec-compliance/api/login.rb +193 -193
  237. data/lib/bundles/inspec-compliance/bootstrap.sh +41 -41
  238. data/lib/bundles/inspec-compliance/cli.rb +260 -260
  239. data/lib/bundles/inspec-compliance/configuration.rb +103 -103
  240. data/lib/bundles/inspec-compliance/http.rb +125 -125
  241. data/lib/bundles/inspec-compliance/support.rb +36 -36
  242. data/lib/bundles/inspec-compliance/target.rb +112 -112
  243. data/lib/bundles/inspec-compliance/test/integration/default/cli.rb +93 -93
  244. data/lib/bundles/inspec-habitat.rb +12 -12
  245. data/lib/bundles/inspec-habitat/cli.rb +36 -36
  246. data/lib/bundles/inspec-habitat/log.rb +10 -10
  247. data/lib/bundles/inspec-habitat/profile.rb +391 -391
  248. data/lib/bundles/inspec-init.rb +8 -8
  249. data/lib/bundles/inspec-init/README.md +31 -31
  250. data/lib/bundles/inspec-init/cli.rb +97 -97
  251. data/lib/bundles/inspec-init/templates/profile/README.md +3 -3
  252. data/lib/bundles/inspec-init/templates/profile/controls/example.rb +19 -19
  253. data/lib/bundles/inspec-init/templates/profile/inspec.yml +8 -8
  254. data/lib/bundles/inspec-supermarket.rb +13 -13
  255. data/lib/bundles/inspec-supermarket/README.md +45 -45
  256. data/lib/bundles/inspec-supermarket/api.rb +84 -84
  257. data/lib/bundles/inspec-supermarket/cli.rb +73 -73
  258. data/lib/bundles/inspec-supermarket/target.rb +34 -34
  259. data/lib/fetchers/git.rb +163 -163
  260. data/lib/fetchers/local.rb +74 -74
  261. data/lib/fetchers/mock.rb +35 -35
  262. data/lib/fetchers/url.rb +247 -247
  263. data/lib/inspec.rb +24 -24
  264. data/lib/inspec/archive/tar.rb +29 -29
  265. data/lib/inspec/archive/zip.rb +19 -19
  266. data/lib/inspec/backend.rb +93 -93
  267. data/lib/inspec/base_cli.rb +368 -368
  268. data/lib/inspec/cached_fetcher.rb +66 -66
  269. data/lib/inspec/cli.rb +292 -292
  270. data/lib/inspec/completions/bash.sh.erb +45 -45
  271. data/lib/inspec/completions/fish.sh.erb +34 -34
  272. data/lib/inspec/completions/zsh.sh.erb +61 -61
  273. data/lib/inspec/control_eval_context.rb +179 -179
  274. data/lib/inspec/dependencies/cache.rb +72 -72
  275. data/lib/inspec/dependencies/dependency_set.rb +92 -92
  276. data/lib/inspec/dependencies/lockfile.rb +115 -115
  277. data/lib/inspec/dependencies/requirement.rb +123 -123
  278. data/lib/inspec/dependencies/resolver.rb +86 -86
  279. data/lib/inspec/describe.rb +27 -27
  280. data/lib/inspec/dsl.rb +66 -66
  281. data/lib/inspec/dsl_shared.rb +33 -33
  282. data/lib/inspec/env_printer.rb +157 -157
  283. data/lib/inspec/errors.rb +14 -14
  284. data/lib/inspec/exceptions.rb +12 -12
  285. data/lib/inspec/expect.rb +45 -45
  286. data/lib/inspec/fetcher.rb +45 -45
  287. data/lib/inspec/file_provider.rb +275 -275
  288. data/lib/inspec/formatters.rb +3 -3
  289. data/lib/inspec/formatters/base.rb +259 -259
  290. data/lib/inspec/formatters/json_rspec.rb +20 -20
  291. data/lib/inspec/formatters/show_progress.rb +12 -12
  292. data/lib/inspec/library_eval_context.rb +58 -58
  293. data/lib/inspec/log.rb +11 -11
  294. data/lib/inspec/metadata.rb +247 -247
  295. data/lib/inspec/method_source.rb +24 -24
  296. data/lib/inspec/objects.rb +14 -14
  297. data/lib/inspec/objects/attribute.rb +75 -75
  298. data/lib/inspec/objects/control.rb +61 -61
  299. data/lib/inspec/objects/describe.rb +92 -92
  300. data/lib/inspec/objects/each_loop.rb +36 -36
  301. data/lib/inspec/objects/list.rb +15 -15
  302. data/lib/inspec/objects/or_test.rb +40 -40
  303. data/lib/inspec/objects/ruby_helper.rb +15 -15
  304. data/lib/inspec/objects/tag.rb +27 -27
  305. data/lib/inspec/objects/test.rb +87 -87
  306. data/lib/inspec/objects/value.rb +27 -27
  307. data/lib/inspec/plugins.rb +60 -60
  308. data/lib/inspec/plugins/cli.rb +24 -24
  309. data/lib/inspec/plugins/fetcher.rb +86 -86
  310. data/lib/inspec/plugins/resource.rb +135 -135
  311. data/lib/inspec/plugins/secret.rb +15 -15
  312. data/lib/inspec/plugins/source_reader.rb +40 -40
  313. data/lib/inspec/polyfill.rb +12 -12
  314. data/lib/inspec/profile.rb +513 -513
  315. data/lib/inspec/profile_context.rb +208 -208
  316. data/lib/inspec/profile_vendor.rb +66 -66
  317. data/lib/inspec/reporters.rb +60 -60
  318. data/lib/inspec/reporters/automate.rb +76 -76
  319. data/lib/inspec/reporters/base.rb +25 -25
  320. data/lib/inspec/reporters/cli.rb +356 -356
  321. data/lib/inspec/reporters/json.rb +117 -117
  322. data/lib/inspec/reporters/json_min.rb +48 -48
  323. data/lib/inspec/reporters/junit.rb +78 -78
  324. data/lib/inspec/require_loader.rb +33 -33
  325. data/lib/inspec/resource.rb +190 -190
  326. data/lib/inspec/rule.rb +280 -280
  327. data/lib/inspec/runner.rb +345 -345
  328. data/lib/inspec/runner_mock.rb +41 -41
  329. data/lib/inspec/runner_rspec.rb +175 -175
  330. data/lib/inspec/runtime_profile.rb +26 -26
  331. data/lib/inspec/schema.rb +213 -213
  332. data/lib/inspec/secrets.rb +19 -19
  333. data/lib/inspec/secrets/yaml.rb +30 -30
  334. data/lib/inspec/shell.rb +220 -220
  335. data/lib/inspec/shell_detector.rb +90 -90
  336. data/lib/inspec/source_reader.rb +29 -29
  337. data/lib/inspec/version.rb +8 -8
  338. data/lib/matchers/matchers.rb +339 -339
  339. data/lib/resource_support/aws.rb +50 -50
  340. data/lib/resource_support/aws/aws_backend_base.rb +12 -12
  341. data/lib/resource_support/aws/aws_backend_factory_mixin.rb +12 -12
  342. data/lib/resource_support/aws/aws_plural_resource_mixin.rb +21 -21
  343. data/lib/resource_support/aws/aws_resource_mixin.rb +66 -66
  344. data/lib/resource_support/aws/aws_singular_resource_mixin.rb +24 -24
  345. data/lib/resources/aide_conf.rb +151 -151
  346. data/lib/resources/apache.rb +48 -48
  347. data/lib/resources/apache_conf.rb +149 -149
  348. data/lib/resources/apt.rb +149 -149
  349. data/lib/resources/audit_policy.rb +63 -63
  350. data/lib/resources/auditd.rb +231 -231
  351. data/lib/resources/auditd_conf.rb +46 -46
  352. data/lib/resources/aws/aws_cloudtrail_trail.rb +93 -93
  353. data/lib/resources/aws/aws_cloudtrail_trails.rb +47 -47
  354. data/lib/resources/aws/aws_cloudwatch_alarm.rb +62 -62
  355. data/lib/resources/aws/aws_cloudwatch_log_metric_filter.rb +100 -100
  356. data/lib/resources/aws/aws_config_delivery_channel.rb +70 -70
  357. data/lib/resources/aws/aws_config_recorder.rb +93 -93
  358. data/lib/resources/aws/aws_ec2_instance.rb +157 -157
  359. data/lib/resources/aws/aws_ec2_instances.rb +64 -64
  360. data/lib/resources/aws/aws_iam_access_key.rb +106 -106
  361. data/lib/resources/aws/aws_iam_access_keys.rb +149 -149
  362. data/lib/resources/aws/aws_iam_group.rb +58 -58
  363. data/lib/resources/aws/aws_iam_groups.rb +52 -52
  364. data/lib/resources/aws/aws_iam_password_policy.rb +116 -116
  365. data/lib/resources/aws/aws_iam_policies.rb +53 -53
  366. data/lib/resources/aws/aws_iam_policy.rb +291 -291
  367. data/lib/resources/aws/aws_iam_role.rb +55 -55
  368. data/lib/resources/aws/aws_iam_root_user.rb +78 -78
  369. data/lib/resources/aws/aws_iam_user.rb +142 -142
  370. data/lib/resources/aws/aws_iam_users.rb +146 -146
  371. data/lib/resources/aws/aws_kms_key.rb +96 -96
  372. data/lib/resources/aws/aws_kms_keys.rb +53 -53
  373. data/lib/resources/aws/aws_rds_instance.rb +71 -71
  374. data/lib/resources/aws/aws_route_table.rb +63 -63
  375. data/lib/resources/aws/aws_route_tables.rb +60 -60
  376. data/lib/resources/aws/aws_s3_bucket.rb +137 -137
  377. data/lib/resources/aws/aws_s3_bucket_object.rb +82 -82
  378. data/lib/resources/aws/aws_s3_buckets.rb +51 -51
  379. data/lib/resources/aws/aws_security_group.rb +249 -249
  380. data/lib/resources/aws/aws_security_groups.rb +68 -68
  381. data/lib/resources/aws/aws_sns_subscription.rb +78 -78
  382. data/lib/resources/aws/aws_sns_topic.rb +53 -53
  383. data/lib/resources/aws/aws_sns_topics.rb +56 -56
  384. data/lib/resources/aws/aws_subnet.rb +88 -88
  385. data/lib/resources/aws/aws_subnets.rb +53 -53
  386. data/lib/resources/aws/aws_vpc.rb +73 -73
  387. data/lib/resources/aws/aws_vpcs.rb +52 -52
  388. data/lib/resources/azure/azure_backend.rb +377 -377
  389. data/lib/resources/azure/azure_generic_resource.rb +59 -59
  390. data/lib/resources/azure/azure_resource_group.rb +152 -152
  391. data/lib/resources/azure/azure_virtual_machine.rb +264 -264
  392. data/lib/resources/azure/azure_virtual_machine_data_disk.rb +134 -134
  393. data/lib/resources/bash.rb +35 -35
  394. data/lib/resources/bond.rb +69 -69
  395. data/lib/resources/bridge.rb +122 -122
  396. data/lib/resources/chocolatey_package.rb +78 -78
  397. data/lib/resources/command.rb +73 -73
  398. data/lib/resources/cpan.rb +58 -58
  399. data/lib/resources/cran.rb +64 -64
  400. data/lib/resources/crontab.rb +169 -169
  401. data/lib/resources/csv.rb +56 -56
  402. data/lib/resources/dh_params.rb +77 -77
  403. data/lib/resources/directory.rb +25 -25
  404. data/lib/resources/docker.rb +236 -236
  405. data/lib/resources/docker_container.rb +89 -89
  406. data/lib/resources/docker_image.rb +83 -83
  407. data/lib/resources/docker_object.rb +57 -57
  408. data/lib/resources/docker_service.rb +90 -90
  409. data/lib/resources/elasticsearch.rb +169 -169
  410. data/lib/resources/etc_fstab.rb +94 -94
  411. data/lib/resources/etc_group.rb +154 -154
  412. data/lib/resources/etc_hosts.rb +66 -66
  413. data/lib/resources/etc_hosts_allow_deny.rb +112 -112
  414. data/lib/resources/file.rb +298 -298
  415. data/lib/resources/filesystem.rb +31 -31
  416. data/lib/resources/firewalld.rb +143 -143
  417. data/lib/resources/gem.rb +70 -70
  418. data/lib/resources/groups.rb +215 -215
  419. data/lib/resources/grub_conf.rb +227 -227
  420. data/lib/resources/host.rb +306 -306
  421. data/lib/resources/http.rb +253 -253
  422. data/lib/resources/iis_app.rb +101 -101
  423. data/lib/resources/iis_site.rb +148 -148
  424. data/lib/resources/inetd_conf.rb +54 -54
  425. data/lib/resources/ini.rb +29 -29
  426. data/lib/resources/interface.rb +129 -129
  427. data/lib/resources/iptables.rb +80 -80
  428. data/lib/resources/json.rb +111 -111
  429. data/lib/resources/kernel_module.rb +107 -107
  430. data/lib/resources/kernel_parameter.rb +58 -58
  431. data/lib/resources/key_rsa.rb +63 -63
  432. data/lib/resources/limits_conf.rb +46 -46
  433. data/lib/resources/login_def.rb +57 -57
  434. data/lib/resources/mount.rb +88 -88
  435. data/lib/resources/mssql_session.rb +101 -101
  436. data/lib/resources/mysql.rb +82 -82
  437. data/lib/resources/mysql_conf.rb +127 -127
  438. data/lib/resources/mysql_session.rb +85 -85
  439. data/lib/resources/nginx.rb +96 -96
  440. data/lib/resources/nginx_conf.rb +226 -226
  441. data/lib/resources/npm.rb +48 -48
  442. data/lib/resources/ntp_conf.rb +51 -51
  443. data/lib/resources/oneget.rb +71 -71
  444. data/lib/resources/oracledb_session.rb +139 -139
  445. data/lib/resources/os.rb +36 -36
  446. data/lib/resources/os_env.rb +86 -86
  447. data/lib/resources/package.rb +370 -370
  448. data/lib/resources/packages.rb +111 -111
  449. data/lib/resources/parse_config.rb +112 -112
  450. data/lib/resources/passwd.rb +76 -76
  451. data/lib/resources/pip.rb +130 -130
  452. data/lib/resources/platform.rb +109 -109
  453. data/lib/resources/port.rb +771 -771
  454. data/lib/resources/postgres.rb +131 -131
  455. data/lib/resources/postgres_conf.rb +114 -114
  456. data/lib/resources/postgres_hba_conf.rb +90 -90
  457. data/lib/resources/postgres_ident_conf.rb +79 -79
  458. data/lib/resources/postgres_session.rb +71 -71
  459. data/lib/resources/powershell.rb +67 -67
  460. data/lib/resources/processes.rb +204 -204
  461. data/lib/resources/rabbitmq_conf.rb +51 -51
  462. data/lib/resources/registry_key.rb +297 -297
  463. data/lib/resources/security_policy.rb +180 -180
  464. data/lib/resources/service.rb +794 -794
  465. data/lib/resources/shadow.rb +159 -159
  466. data/lib/resources/ssh_conf.rb +97 -97
  467. data/lib/resources/ssl.rb +99 -99
  468. data/lib/resources/sys_info.rb +28 -28
  469. data/lib/resources/toml.rb +32 -32
  470. data/lib/resources/users.rb +654 -654
  471. data/lib/resources/vbscript.rb +68 -68
  472. data/lib/resources/virtualization.rb +247 -247
  473. data/lib/resources/windows_feature.rb +84 -84
  474. data/lib/resources/windows_hotfix.rb +35 -35
  475. data/lib/resources/windows_task.rb +102 -102
  476. data/lib/resources/wmi.rb +110 -110
  477. data/lib/resources/x509_certificate.rb +137 -137
  478. data/lib/resources/xinetd.rb +106 -106
  479. data/lib/resources/xml.rb +46 -46
  480. data/lib/resources/yaml.rb +43 -43
  481. data/lib/resources/yum.rb +180 -180
  482. data/lib/resources/zfs_dataset.rb +60 -60
  483. data/lib/resources/zfs_pool.rb +49 -49
  484. data/lib/source_readers/flat.rb +39 -39
  485. data/lib/source_readers/inspec.rb +75 -75
  486. data/lib/utils/command_wrapper.rb +27 -27
  487. data/lib/utils/convert.rb +12 -12
  488. data/lib/utils/database_helpers.rb +77 -77
  489. data/lib/utils/enumerable_delegation.rb +9 -9
  490. data/lib/utils/erlang_parser.rb +192 -192
  491. data/lib/utils/file_reader.rb +25 -25
  492. data/lib/utils/filter.rb +273 -273
  493. data/lib/utils/filter_array.rb +27 -27
  494. data/lib/utils/find_files.rb +47 -47
  495. data/lib/utils/hash.rb +41 -41
  496. data/lib/utils/json_log.rb +18 -18
  497. data/lib/utils/latest_version.rb +22 -22
  498. data/lib/utils/modulator.rb +12 -12
  499. data/lib/utils/nginx_parser.rb +105 -105
  500. data/lib/utils/object_traversal.rb +49 -49
  501. data/lib/utils/parser.rb +274 -274
  502. data/lib/utils/pkey_reader.rb +15 -15
  503. data/lib/utils/plugin_registry.rb +93 -93
  504. data/lib/utils/simpleconfig.rb +120 -120
  505. data/lib/utils/spdx.rb +13 -13
  506. data/lib/utils/spdx.txt +343 -343
  507. metadata +3 -3
@@ -1,24 +1,24 @@
1
- # encoding: utf-8
2
- # author: Dominik Richter
3
- # author: Christoph Hartmann
4
-
5
- module Inspec
6
- module MethodSource
7
- def self.code_at(location, source_reader)
8
- # TODO: logger for these cases
9
- return '' if location.nil? || location[:ref].nil? || location[:line].nil?
10
- return '' unless source_reader && source_reader.target
11
-
12
- # TODO: Non-controls still need more detection
13
- ref = location[:ref]
14
- ref = ref.sub(source_reader.target.prefix, '')
15
- src = source_reader.tests[ref]
16
- return '' if src.nil?
17
-
18
- ::MethodSource.expression_at(src.lines, location[:line]).force_encoding('utf-8')
19
- rescue SyntaxError => e
20
- raise ::MethodSource::SourceNotFoundError,
21
- "Could not parse source at #{location[:ref]}:#{location[:line]}: #{e.message}"
22
- end
23
- end
24
- end
1
+ # encoding: utf-8
2
+ # author: Dominik Richter
3
+ # author: Christoph Hartmann
4
+
5
+ module Inspec
6
+ module MethodSource
7
+ def self.code_at(location, source_reader)
8
+ # TODO: logger for these cases
9
+ return '' if location.nil? || location[:ref].nil? || location[:line].nil?
10
+ return '' unless source_reader && source_reader.target
11
+
12
+ # TODO: Non-controls still need more detection
13
+ ref = location[:ref]
14
+ ref = ref.sub(source_reader.target.prefix, '')
15
+ src = source_reader.tests[ref]
16
+ return '' if src.nil?
17
+
18
+ ::MethodSource.expression_at(src.lines, location[:line]).force_encoding('utf-8')
19
+ rescue SyntaxError => e
20
+ raise ::MethodSource::SourceNotFoundError,
21
+ "Could not parse source at #{location[:ref]}:#{location[:line]}: #{e.message}"
22
+ end
23
+ end
24
+ end
@@ -1,14 +1,14 @@
1
- # encoding: utf-8
2
-
3
- module Inspec
4
- autoload :Attribute, 'inspec/objects/attribute'
5
- autoload :Tag, 'inspec/objects/tag'
6
- autoload :Control, 'inspec/objects/control'
7
- autoload :Describe, 'inspec/objects/describe'
8
- autoload :EachLoop, 'inspec/objects/each_loop'
9
- autoload :List, 'inspec/objects/list'
10
- autoload :OrTest, 'inspec/objects/or_test'
11
- autoload :RubyHelper, 'inspec/objects/ruby_helper'
12
- autoload :Test, 'inspec/objects/test'
13
- autoload :Value, 'inspec/objects/value'
14
- end
1
+ # encoding: utf-8
2
+
3
+ module Inspec
4
+ autoload :Attribute, 'inspec/objects/attribute'
5
+ autoload :Tag, 'inspec/objects/tag'
6
+ autoload :Control, 'inspec/objects/control'
7
+ autoload :Describe, 'inspec/objects/describe'
8
+ autoload :EachLoop, 'inspec/objects/each_loop'
9
+ autoload :List, 'inspec/objects/list'
10
+ autoload :OrTest, 'inspec/objects/or_test'
11
+ autoload :RubyHelper, 'inspec/objects/ruby_helper'
12
+ autoload :Test, 'inspec/objects/test'
13
+ autoload :Value, 'inspec/objects/value'
14
+ end
@@ -1,75 +1,75 @@
1
- # encoding:utf-8
2
-
3
- module Inspec
4
- class Attribute
5
- attr_accessor :name
6
- attr_writer :value
7
-
8
- DEFAULT_ATTRIBUTE = Class.new do
9
- def initialize(name)
10
- @name = name
11
- end
12
-
13
- def method_missing(*_)
14
- Inspec::Log.warn(
15
- "Returning DEFAULT_ATTRIBUTE for '#{@name}'. "\
16
- "Use --attrs to provide a value for '#{@name}' or specify a default "\
17
- "value with `attribute('#{@name}', default: 'somedefault', ...)`.",
18
- )
19
-
20
- self
21
- end
22
-
23
- def respond_to_missing?(_, _)
24
- true
25
- end
26
- end
27
-
28
- def initialize(name, options = {})
29
- @name = name
30
- @opts = options
31
- @value = nil
32
- end
33
-
34
- # implicit call is done by inspec to determine the value of an attribute
35
- def value
36
- @value.nil? ? default : @value
37
- end
38
-
39
- def default
40
- @opts.key?(:default) ? @opts[:default] : DEFAULT_ATTRIBUTE.new(@name)
41
- end
42
-
43
- def title
44
- @opts[:title]
45
- end
46
-
47
- def description
48
- @opts[:description]
49
- end
50
-
51
- def ruby_var_identifier
52
- @opts[:identifier] || 'attr_' + @name.downcase.strip.gsub(/\s+/, '-').gsub(/[^\w-]/, '')
53
- end
54
-
55
- def to_hash
56
- {
57
- name: @name,
58
- options: @opts,
59
- }
60
- end
61
-
62
- def to_ruby
63
- res = ["#{ruby_var_identifier} = attribute('#{@name}',{"]
64
- res.push " title: '#{title}'," unless title.to_s.empty?
65
- res.push " default: #{default.inspect}," unless default.to_s.empty?
66
- res.push " description: '#{description}'," unless description.to_s.empty?
67
- res.push '})'
68
- res.join("\n")
69
- end
70
-
71
- def to_s
72
- "Attribute #{@name} with #{@value}"
73
- end
74
- end
75
- end
1
+ # encoding:utf-8
2
+
3
+ module Inspec
4
+ class Attribute
5
+ attr_accessor :name
6
+ attr_writer :value
7
+
8
+ DEFAULT_ATTRIBUTE = Class.new do
9
+ def initialize(name)
10
+ @name = name
11
+ end
12
+
13
+ def method_missing(*_)
14
+ Inspec::Log.warn(
15
+ "Returning DEFAULT_ATTRIBUTE for '#{@name}'. "\
16
+ "Use --attrs to provide a value for '#{@name}' or specify a default "\
17
+ "value with `attribute('#{@name}', default: 'somedefault', ...)`.",
18
+ )
19
+
20
+ self
21
+ end
22
+
23
+ def respond_to_missing?(_, _)
24
+ true
25
+ end
26
+ end
27
+
28
+ def initialize(name, options = {})
29
+ @name = name
30
+ @opts = options
31
+ @value = nil
32
+ end
33
+
34
+ # implicit call is done by inspec to determine the value of an attribute
35
+ def value
36
+ @value.nil? ? default : @value
37
+ end
38
+
39
+ def default
40
+ @opts.key?(:default) ? @opts[:default] : DEFAULT_ATTRIBUTE.new(@name)
41
+ end
42
+
43
+ def title
44
+ @opts[:title]
45
+ end
46
+
47
+ def description
48
+ @opts[:description]
49
+ end
50
+
51
+ def ruby_var_identifier
52
+ @opts[:identifier] || 'attr_' + @name.downcase.strip.gsub(/\s+/, '-').gsub(/[^\w-]/, '')
53
+ end
54
+
55
+ def to_hash
56
+ {
57
+ name: @name,
58
+ options: @opts,
59
+ }
60
+ end
61
+
62
+ def to_ruby
63
+ res = ["#{ruby_var_identifier} = attribute('#{@name}',{"]
64
+ res.push " title: '#{title}'," unless title.to_s.empty?
65
+ res.push " default: #{default.inspect}," unless default.to_s.empty?
66
+ res.push " description: '#{description}'," unless description.to_s.empty?
67
+ res.push '})'
68
+ res.join("\n")
69
+ end
70
+
71
+ def to_s
72
+ "Attribute #{@name} with #{@value}"
73
+ end
74
+ end
75
+ end
@@ -1,61 +1,61 @@
1
- # encoding:utf-8
2
-
3
- module Inspec
4
- class Control
5
- attr_accessor :id, :title, :desc, :impact, :tests, :tags, :refs
6
- def initialize
7
- @tests = []
8
- @tags = []
9
- @refs = []
10
- end
11
-
12
- def add_test(t)
13
- @tests.push(t)
14
- end
15
-
16
- def add_tag(t)
17
- @tags.push(t)
18
- end
19
-
20
- def to_hash
21
- { id: id, title: title, desc: desc, impact: impact, tests: tests.map(&:to_hash), tags: tags.map(&:to_hash) }
22
- end
23
-
24
- def to_ruby # rubocop:disable Metrics/AbcSize
25
- res = ["control #{id.inspect} do"]
26
- res.push " title #{title.inspect}" unless title.to_s.empty?
27
- res.push " desc #{prettyprint_text(desc, 2)}" unless desc.to_s.empty?
28
- res.push " impact #{impact}" unless impact.nil?
29
- tags.each { |t| res.push(indent(t.to_ruby, 2)) }
30
- refs.each { |t| res.push(" ref #{print_ref(t)}") }
31
- tests.each { |t| res.push(indent(t.to_ruby, 2)) }
32
- res.push 'end'
33
- res.join("\n")
34
- end
35
-
36
- private
37
-
38
- def print_ref(x)
39
- return x.inspect if x.is_a?(String)
40
- raise "Cannot process the ref: #{x}" unless x.is_a?(Hash)
41
- '('+x.inspect+')'
42
- end
43
-
44
- # Pretty-print a text block of InSpec code
45
- #
46
- # @param s [String] should not be empty
47
- # @param depth [Int] indentation length for multiline text blocks
48
- # @return [String] pretty-printed textblock
49
- def prettyprint_text(s, depth)
50
- txt = s.to_s.inspect.gsub('\n', "\n")
51
- return txt if !txt.include?("\n")
52
- middle = indent(txt[1..-2], depth+2)
53
- txt[0] + "\n" + middle + "\n" + ' '*depth + txt[-1]
54
- end
55
-
56
- def indent(txt, d)
57
- dt = ' '*d
58
- dt + txt.gsub("\n", "\n"+dt)
59
- end
60
- end
61
- end
1
+ # encoding:utf-8
2
+
3
+ module Inspec
4
+ class Control
5
+ attr_accessor :id, :title, :desc, :impact, :tests, :tags, :refs
6
+ def initialize
7
+ @tests = []
8
+ @tags = []
9
+ @refs = []
10
+ end
11
+
12
+ def add_test(t)
13
+ @tests.push(t)
14
+ end
15
+
16
+ def add_tag(t)
17
+ @tags.push(t)
18
+ end
19
+
20
+ def to_hash
21
+ { id: id, title: title, desc: desc, impact: impact, tests: tests.map(&:to_hash), tags: tags.map(&:to_hash) }
22
+ end
23
+
24
+ def to_ruby # rubocop:disable Metrics/AbcSize
25
+ res = ["control #{id.inspect} do"]
26
+ res.push " title #{title.inspect}" unless title.to_s.empty?
27
+ res.push " desc #{prettyprint_text(desc, 2)}" unless desc.to_s.empty?
28
+ res.push " impact #{impact}" unless impact.nil?
29
+ tags.each { |t| res.push(indent(t.to_ruby, 2)) }
30
+ refs.each { |t| res.push(" ref #{print_ref(t)}") }
31
+ tests.each { |t| res.push(indent(t.to_ruby, 2)) }
32
+ res.push 'end'
33
+ res.join("\n")
34
+ end
35
+
36
+ private
37
+
38
+ def print_ref(x)
39
+ return x.inspect if x.is_a?(String)
40
+ raise "Cannot process the ref: #{x}" unless x.is_a?(Hash)
41
+ '('+x.inspect+')'
42
+ end
43
+
44
+ # Pretty-print a text block of InSpec code
45
+ #
46
+ # @param s [String] should not be empty
47
+ # @param depth [Int] indentation length for multiline text blocks
48
+ # @return [String] pretty-printed textblock
49
+ def prettyprint_text(s, depth)
50
+ txt = s.to_s.inspect.gsub('\n', "\n")
51
+ return txt if !txt.include?("\n")
52
+ middle = indent(txt[1..-2], depth+2)
53
+ txt[0] + "\n" + middle + "\n" + ' '*depth + txt[-1]
54
+ end
55
+
56
+ def indent(txt, d)
57
+ dt = ' '*d
58
+ dt + txt.gsub("\n", "\n"+dt)
59
+ end
60
+ end
61
+ end
@@ -1,92 +1,92 @@
1
- # encoding:utf-8
2
-
3
- module Inspec
4
- class Describe
5
- # Internal helper to structure test objects.
6
- # Should not be exposed to the user as it is hidden behind
7
- # `add_test`, `to_hash`, and `to_ruby` in Inspec::Describe
8
- Test = Struct.new(:its, :matcher, :expectation, :negated) do
9
- def negate!
10
- self.negated = !negated
11
- end
12
-
13
- def to_ruby
14
- itsy = its.nil? ? 'it' : 'its(' + its.to_s.inspect + ')'
15
- naughty = negated ? '_not' : ''
16
- xpect = if expectation.nil?
17
- ''
18
- elsif expectation.class == Regexp
19
- # without this, xpect values like / \/zones\// will not be parsed properly
20
- "(#{expectation.inspect})"
21
- else
22
- ' ' + expectation.inspect
23
- end
24
- format('%s { should%s %s%s }', itsy, naughty, matcher, xpect)
25
- end
26
- end
27
-
28
- # A qualifier describing the resource that will be tested. It may consist
29
- # of the resource identification and multiple accessors to pinpoint the data
30
- # the user wants to test.
31
- attr_accessor :qualifier
32
-
33
- # An array of individual tests for the qualifier. Every entry will be
34
- # translated into an `it` or `its` clause.
35
- attr_accessor :tests
36
-
37
- # Optional variables which are used by tests.
38
- attr_accessor :variables
39
-
40
- # Optional method to skip this describe block altogether. If `skip` is
41
- # defined it takes precendence and will print the skip statement instead
42
- # of adding other tests.
43
- attr_accessor :skip
44
-
45
- include RubyHelper
46
-
47
- def initialize
48
- @qualifier = []
49
- @tests = []
50
- @variables = []
51
- end
52
-
53
- def add_test(its, matcher, expectation)
54
- test = Inspec::Describe::Test.new(its, matcher, expectation, false)
55
- tests.push(test)
56
- test
57
- end
58
-
59
- def to_ruby
60
- return rb_skip if !skip.nil?
61
- rb_describe
62
- end
63
-
64
- def to_hash
65
- { qualifier: qualifier, tests: tests.map(&:to_h), variables: variables, skip: skip }
66
- end
67
-
68
- def resource
69
- return nil if qualifier.empty? || qualifier[0].empty? || qualifier[0][0].empty?
70
- qualifier[0][0]
71
- end
72
-
73
- private
74
-
75
- def rb_describe
76
- vars = variables.map(&:to_ruby).join("\n")
77
- vars += "\n" unless vars.empty?
78
-
79
- objarr = @qualifier
80
- objarr = [['unknown object'.inspect]] if objarr.nil? || objarr.empty?
81
- obj = objarr.map { |q| ruby_qualifier(q) }.join('.')
82
-
83
- rbtests = tests.map(&:to_ruby).join("\n ")
84
- format("%sdescribe %s do\n %s\nend", vars, obj, rbtests)
85
- end
86
-
87
- def rb_skip
88
- obj = @qualifier || skip.inspect
89
- format("describe %s do\n skip %s\nend", obj, skip.inspect)
90
- end
91
- end
92
- end
1
+ # encoding:utf-8
2
+
3
+ module Inspec
4
+ class Describe
5
+ # Internal helper to structure test objects.
6
+ # Should not be exposed to the user as it is hidden behind
7
+ # `add_test`, `to_hash`, and `to_ruby` in Inspec::Describe
8
+ Test = Struct.new(:its, :matcher, :expectation, :negated) do
9
+ def negate!
10
+ self.negated = !negated
11
+ end
12
+
13
+ def to_ruby
14
+ itsy = its.nil? ? 'it' : 'its(' + its.to_s.inspect + ')'
15
+ naughty = negated ? '_not' : ''
16
+ xpect = if expectation.nil?
17
+ ''
18
+ elsif expectation.class == Regexp
19
+ # without this, xpect values like / \/zones\// will not be parsed properly
20
+ "(#{expectation.inspect})"
21
+ else
22
+ ' ' + expectation.inspect
23
+ end
24
+ format('%s { should%s %s%s }', itsy, naughty, matcher, xpect)
25
+ end
26
+ end
27
+
28
+ # A qualifier describing the resource that will be tested. It may consist
29
+ # of the resource identification and multiple accessors to pinpoint the data
30
+ # the user wants to test.
31
+ attr_accessor :qualifier
32
+
33
+ # An array of individual tests for the qualifier. Every entry will be
34
+ # translated into an `it` or `its` clause.
35
+ attr_accessor :tests
36
+
37
+ # Optional variables which are used by tests.
38
+ attr_accessor :variables
39
+
40
+ # Optional method to skip this describe block altogether. If `skip` is
41
+ # defined it takes precendence and will print the skip statement instead
42
+ # of adding other tests.
43
+ attr_accessor :skip
44
+
45
+ include RubyHelper
46
+
47
+ def initialize
48
+ @qualifier = []
49
+ @tests = []
50
+ @variables = []
51
+ end
52
+
53
+ def add_test(its, matcher, expectation)
54
+ test = Inspec::Describe::Test.new(its, matcher, expectation, false)
55
+ tests.push(test)
56
+ test
57
+ end
58
+
59
+ def to_ruby
60
+ return rb_skip if !skip.nil?
61
+ rb_describe
62
+ end
63
+
64
+ def to_hash
65
+ { qualifier: qualifier, tests: tests.map(&:to_h), variables: variables, skip: skip }
66
+ end
67
+
68
+ def resource
69
+ return nil if qualifier.empty? || qualifier[0].empty? || qualifier[0][0].empty?
70
+ qualifier[0][0]
71
+ end
72
+
73
+ private
74
+
75
+ def rb_describe
76
+ vars = variables.map(&:to_ruby).join("\n")
77
+ vars += "\n" unless vars.empty?
78
+
79
+ objarr = @qualifier
80
+ objarr = [['unknown object'.inspect]] if objarr.nil? || objarr.empty?
81
+ obj = objarr.map { |q| ruby_qualifier(q) }.join('.')
82
+
83
+ rbtests = tests.map(&:to_ruby).join("\n ")
84
+ format("%sdescribe %s do\n %s\nend", vars, obj, rbtests)
85
+ end
86
+
87
+ def rb_skip
88
+ obj = @qualifier || skip.inspect
89
+ format("describe %s do\n skip %s\nend", obj, skip.inspect)
90
+ end
91
+ end
92
+ end