inspec 2.1.80 → 2.1.81

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 (510) hide show
  1. checksums.yaml +4 -4
  2. data/.rubocop.yml +101 -101
  3. data/CHANGELOG.md +3177 -3172
  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 +40 -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/modules/.gitkeep +0 -0
  201. data/examples/kitchen-puppet/test/integration/default/web_spec.rb +28 -28
  202. data/examples/meta-profile/README.md +37 -37
  203. data/examples/meta-profile/controls/example.rb +13 -13
  204. data/examples/meta-profile/inspec.yml +13 -13
  205. data/examples/profile-attribute.yml +2 -2
  206. data/examples/profile-attribute/README.md +14 -14
  207. data/examples/profile-attribute/controls/example.rb +11 -11
  208. data/examples/profile-attribute/inspec.yml +8 -8
  209. data/examples/profile-aws/controls/iam_password_policy_expiration.rb +8 -8
  210. data/examples/profile-aws/controls/iam_password_policy_max_age.rb +8 -8
  211. data/examples/profile-aws/controls/iam_root_user_mfa.rb +8 -8
  212. data/examples/profile-aws/controls/iam_users_access_key_age.rb +8 -8
  213. data/examples/profile-aws/controls/iam_users_console_users_mfa.rb +8 -8
  214. data/examples/profile-aws/inspec.yml +11 -11
  215. data/examples/profile-azure/controls/azure_resource_group_example.rb +24 -24
  216. data/examples/profile-azure/controls/azure_vm_example.rb +29 -29
  217. data/examples/profile-azure/inspec.yml +11 -11
  218. data/examples/profile-sensitive/README.md +29 -29
  219. data/examples/profile-sensitive/controls/sensitive-failures.rb +9 -9
  220. data/examples/profile-sensitive/controls/sensitive.rb +9 -9
  221. data/examples/profile-sensitive/inspec.yml +8 -8
  222. data/examples/profile/README.md +48 -48
  223. data/examples/profile/controls/example.rb +23 -23
  224. data/examples/profile/controls/gordon.rb +36 -36
  225. data/examples/profile/controls/meta.rb +34 -34
  226. data/examples/profile/inspec.yml +10 -10
  227. data/examples/profile/libraries/gordon_config.rb +59 -59
  228. data/inspec.gemspec +49 -49
  229. data/lib/bundles/README.md +3 -3
  230. data/lib/bundles/inspec-artifact.rb +7 -7
  231. data/lib/bundles/inspec-artifact/README.md +1 -1
  232. data/lib/bundles/inspec-artifact/cli.rb +277 -277
  233. data/lib/bundles/inspec-compliance.rb +16 -16
  234. data/lib/bundles/inspec-compliance/.kitchen.yml +20 -20
  235. data/lib/bundles/inspec-compliance/README.md +193 -193
  236. data/lib/bundles/inspec-compliance/api.rb +360 -360
  237. data/lib/bundles/inspec-compliance/api/login.rb +193 -193
  238. data/lib/bundles/inspec-compliance/bootstrap.sh +41 -41
  239. data/lib/bundles/inspec-compliance/cli.rb +260 -260
  240. data/lib/bundles/inspec-compliance/configuration.rb +103 -103
  241. data/lib/bundles/inspec-compliance/http.rb +125 -125
  242. data/lib/bundles/inspec-compliance/images/cc-token.png +0 -0
  243. data/lib/bundles/inspec-compliance/support.rb +36 -36
  244. data/lib/bundles/inspec-compliance/target.rb +112 -112
  245. data/lib/bundles/inspec-compliance/test/integration/default/cli.rb +93 -93
  246. data/lib/bundles/inspec-habitat.rb +12 -12
  247. data/lib/bundles/inspec-habitat/cli.rb +36 -36
  248. data/lib/bundles/inspec-habitat/log.rb +10 -10
  249. data/lib/bundles/inspec-habitat/profile.rb +391 -391
  250. data/lib/bundles/inspec-init.rb +8 -8
  251. data/lib/bundles/inspec-init/README.md +31 -31
  252. data/lib/bundles/inspec-init/cli.rb +97 -97
  253. data/lib/bundles/inspec-init/templates/profile/README.md +3 -3
  254. data/lib/bundles/inspec-init/templates/profile/controls/example.rb +19 -19
  255. data/lib/bundles/inspec-init/templates/profile/inspec.yml +8 -8
  256. data/lib/bundles/inspec-init/templates/profile/libraries/.gitkeep +0 -0
  257. data/lib/bundles/inspec-supermarket.rb +13 -13
  258. data/lib/bundles/inspec-supermarket/README.md +45 -45
  259. data/lib/bundles/inspec-supermarket/api.rb +84 -84
  260. data/lib/bundles/inspec-supermarket/cli.rb +73 -73
  261. data/lib/bundles/inspec-supermarket/target.rb +34 -34
  262. data/lib/fetchers/git.rb +163 -163
  263. data/lib/fetchers/local.rb +74 -74
  264. data/lib/fetchers/mock.rb +35 -35
  265. data/lib/fetchers/url.rb +247 -247
  266. data/lib/inspec.rb +24 -24
  267. data/lib/inspec/archive/tar.rb +29 -29
  268. data/lib/inspec/archive/zip.rb +19 -19
  269. data/lib/inspec/backend.rb +93 -93
  270. data/lib/inspec/base_cli.rb +368 -368
  271. data/lib/inspec/cached_fetcher.rb +66 -66
  272. data/lib/inspec/cli.rb +292 -292
  273. data/lib/inspec/completions/bash.sh.erb +45 -45
  274. data/lib/inspec/completions/fish.sh.erb +34 -34
  275. data/lib/inspec/completions/zsh.sh.erb +61 -61
  276. data/lib/inspec/control_eval_context.rb +179 -179
  277. data/lib/inspec/dependencies/cache.rb +72 -72
  278. data/lib/inspec/dependencies/dependency_set.rb +92 -92
  279. data/lib/inspec/dependencies/lockfile.rb +115 -115
  280. data/lib/inspec/dependencies/requirement.rb +123 -123
  281. data/lib/inspec/dependencies/resolver.rb +86 -86
  282. data/lib/inspec/describe.rb +27 -27
  283. data/lib/inspec/dsl.rb +66 -66
  284. data/lib/inspec/dsl_shared.rb +33 -33
  285. data/lib/inspec/env_printer.rb +157 -157
  286. data/lib/inspec/errors.rb +14 -14
  287. data/lib/inspec/exceptions.rb +12 -12
  288. data/lib/inspec/expect.rb +45 -45
  289. data/lib/inspec/fetcher.rb +45 -45
  290. data/lib/inspec/file_provider.rb +275 -275
  291. data/lib/inspec/formatters.rb +3 -3
  292. data/lib/inspec/formatters/base.rb +259 -259
  293. data/lib/inspec/formatters/json_rspec.rb +20 -20
  294. data/lib/inspec/formatters/show_progress.rb +12 -12
  295. data/lib/inspec/library_eval_context.rb +58 -58
  296. data/lib/inspec/log.rb +11 -11
  297. data/lib/inspec/metadata.rb +247 -247
  298. data/lib/inspec/method_source.rb +24 -24
  299. data/lib/inspec/objects.rb +14 -14
  300. data/lib/inspec/objects/attribute.rb +75 -75
  301. data/lib/inspec/objects/control.rb +61 -61
  302. data/lib/inspec/objects/describe.rb +92 -92
  303. data/lib/inspec/objects/each_loop.rb +36 -36
  304. data/lib/inspec/objects/list.rb +15 -15
  305. data/lib/inspec/objects/or_test.rb +40 -40
  306. data/lib/inspec/objects/ruby_helper.rb +15 -15
  307. data/lib/inspec/objects/tag.rb +27 -27
  308. data/lib/inspec/objects/test.rb +87 -87
  309. data/lib/inspec/objects/value.rb +27 -27
  310. data/lib/inspec/plugins.rb +60 -60
  311. data/lib/inspec/plugins/cli.rb +24 -24
  312. data/lib/inspec/plugins/fetcher.rb +86 -86
  313. data/lib/inspec/plugins/resource.rb +135 -135
  314. data/lib/inspec/plugins/secret.rb +15 -15
  315. data/lib/inspec/plugins/source_reader.rb +40 -40
  316. data/lib/inspec/polyfill.rb +12 -12
  317. data/lib/inspec/profile.rb +513 -513
  318. data/lib/inspec/profile_context.rb +208 -208
  319. data/lib/inspec/profile_vendor.rb +66 -66
  320. data/lib/inspec/reporters.rb +60 -60
  321. data/lib/inspec/reporters/automate.rb +76 -76
  322. data/lib/inspec/reporters/base.rb +25 -25
  323. data/lib/inspec/reporters/cli.rb +356 -356
  324. data/lib/inspec/reporters/json.rb +117 -117
  325. data/lib/inspec/reporters/json_min.rb +48 -48
  326. data/lib/inspec/reporters/junit.rb +78 -78
  327. data/lib/inspec/require_loader.rb +33 -33
  328. data/lib/inspec/resource.rb +190 -190
  329. data/lib/inspec/rule.rb +280 -280
  330. data/lib/inspec/runner.rb +345 -345
  331. data/lib/inspec/runner_mock.rb +41 -41
  332. data/lib/inspec/runner_rspec.rb +175 -175
  333. data/lib/inspec/runtime_profile.rb +26 -26
  334. data/lib/inspec/schema.rb +213 -213
  335. data/lib/inspec/secrets.rb +19 -19
  336. data/lib/inspec/secrets/yaml.rb +30 -30
  337. data/lib/inspec/shell.rb +220 -220
  338. data/lib/inspec/shell_detector.rb +90 -90
  339. data/lib/inspec/source_reader.rb +29 -29
  340. data/lib/inspec/version.rb +8 -8
  341. data/lib/matchers/matchers.rb +339 -339
  342. data/lib/resource_support/aws.rb +50 -50
  343. data/lib/resource_support/aws/aws_backend_base.rb +12 -12
  344. data/lib/resource_support/aws/aws_backend_factory_mixin.rb +12 -12
  345. data/lib/resource_support/aws/aws_plural_resource_mixin.rb +21 -21
  346. data/lib/resource_support/aws/aws_resource_mixin.rb +66 -66
  347. data/lib/resource_support/aws/aws_singular_resource_mixin.rb +24 -24
  348. data/lib/resources/aide_conf.rb +151 -151
  349. data/lib/resources/apache.rb +48 -48
  350. data/lib/resources/apache_conf.rb +149 -149
  351. data/lib/resources/apt.rb +149 -149
  352. data/lib/resources/audit_policy.rb +63 -63
  353. data/lib/resources/auditd.rb +231 -231
  354. data/lib/resources/auditd_conf.rb +46 -46
  355. data/lib/resources/aws/aws_cloudtrail_trail.rb +93 -93
  356. data/lib/resources/aws/aws_cloudtrail_trails.rb +47 -47
  357. data/lib/resources/aws/aws_cloudwatch_alarm.rb +62 -62
  358. data/lib/resources/aws/aws_cloudwatch_log_metric_filter.rb +100 -100
  359. data/lib/resources/aws/aws_config_delivery_channel.rb +70 -70
  360. data/lib/resources/aws/aws_config_recorder.rb +93 -93
  361. data/lib/resources/aws/aws_ec2_instance.rb +157 -157
  362. data/lib/resources/aws/aws_ec2_instances.rb +64 -64
  363. data/lib/resources/aws/aws_iam_access_key.rb +106 -106
  364. data/lib/resources/aws/aws_iam_access_keys.rb +149 -149
  365. data/lib/resources/aws/aws_iam_group.rb +58 -58
  366. data/lib/resources/aws/aws_iam_groups.rb +52 -52
  367. data/lib/resources/aws/aws_iam_password_policy.rb +116 -116
  368. data/lib/resources/aws/aws_iam_policies.rb +53 -53
  369. data/lib/resources/aws/aws_iam_policy.rb +291 -291
  370. data/lib/resources/aws/aws_iam_role.rb +55 -55
  371. data/lib/resources/aws/aws_iam_root_user.rb +78 -78
  372. data/lib/resources/aws/aws_iam_user.rb +142 -142
  373. data/lib/resources/aws/aws_iam_users.rb +146 -146
  374. data/lib/resources/aws/aws_kms_key.rb +96 -96
  375. data/lib/resources/aws/aws_kms_keys.rb +53 -53
  376. data/lib/resources/aws/aws_rds_instance.rb +71 -71
  377. data/lib/resources/aws/aws_route_table.rb +63 -63
  378. data/lib/resources/aws/aws_route_tables.rb +60 -60
  379. data/lib/resources/aws/aws_s3_bucket.rb +137 -137
  380. data/lib/resources/aws/aws_s3_bucket_object.rb +82 -82
  381. data/lib/resources/aws/aws_s3_buckets.rb +51 -51
  382. data/lib/resources/aws/aws_security_group.rb +249 -249
  383. data/lib/resources/aws/aws_security_groups.rb +68 -68
  384. data/lib/resources/aws/aws_sns_subscription.rb +78 -78
  385. data/lib/resources/aws/aws_sns_topic.rb +53 -53
  386. data/lib/resources/aws/aws_sns_topics.rb +56 -56
  387. data/lib/resources/aws/aws_subnet.rb +88 -88
  388. data/lib/resources/aws/aws_subnets.rb +53 -53
  389. data/lib/resources/aws/aws_vpc.rb +73 -73
  390. data/lib/resources/aws/aws_vpcs.rb +52 -52
  391. data/lib/resources/azure/azure_backend.rb +377 -377
  392. data/lib/resources/azure/azure_generic_resource.rb +59 -59
  393. data/lib/resources/azure/azure_resource_group.rb +152 -152
  394. data/lib/resources/azure/azure_virtual_machine.rb +264 -264
  395. data/lib/resources/azure/azure_virtual_machine_data_disk.rb +134 -134
  396. data/lib/resources/bash.rb +35 -35
  397. data/lib/resources/bond.rb +69 -69
  398. data/lib/resources/bridge.rb +122 -122
  399. data/lib/resources/chocolatey_package.rb +78 -78
  400. data/lib/resources/command.rb +73 -73
  401. data/lib/resources/cpan.rb +58 -58
  402. data/lib/resources/cran.rb +64 -64
  403. data/lib/resources/crontab.rb +169 -169
  404. data/lib/resources/csv.rb +56 -56
  405. data/lib/resources/dh_params.rb +77 -77
  406. data/lib/resources/directory.rb +25 -25
  407. data/lib/resources/docker.rb +236 -236
  408. data/lib/resources/docker_container.rb +89 -89
  409. data/lib/resources/docker_image.rb +83 -83
  410. data/lib/resources/docker_object.rb +57 -57
  411. data/lib/resources/docker_service.rb +90 -90
  412. data/lib/resources/elasticsearch.rb +169 -169
  413. data/lib/resources/etc_fstab.rb +94 -94
  414. data/lib/resources/etc_group.rb +154 -154
  415. data/lib/resources/etc_hosts.rb +66 -66
  416. data/lib/resources/etc_hosts_allow_deny.rb +112 -112
  417. data/lib/resources/file.rb +298 -298
  418. data/lib/resources/filesystem.rb +31 -31
  419. data/lib/resources/firewalld.rb +143 -143
  420. data/lib/resources/gem.rb +70 -70
  421. data/lib/resources/groups.rb +215 -215
  422. data/lib/resources/grub_conf.rb +227 -227
  423. data/lib/resources/host.rb +306 -306
  424. data/lib/resources/http.rb +253 -253
  425. data/lib/resources/iis_app.rb +101 -101
  426. data/lib/resources/iis_site.rb +148 -148
  427. data/lib/resources/inetd_conf.rb +54 -54
  428. data/lib/resources/ini.rb +29 -29
  429. data/lib/resources/interface.rb +129 -129
  430. data/lib/resources/iptables.rb +80 -80
  431. data/lib/resources/json.rb +111 -111
  432. data/lib/resources/kernel_module.rb +107 -107
  433. data/lib/resources/kernel_parameter.rb +58 -58
  434. data/lib/resources/key_rsa.rb +63 -63
  435. data/lib/resources/limits_conf.rb +46 -46
  436. data/lib/resources/login_def.rb +57 -57
  437. data/lib/resources/mount.rb +88 -88
  438. data/lib/resources/mssql_session.rb +101 -101
  439. data/lib/resources/mysql.rb +82 -82
  440. data/lib/resources/mysql_conf.rb +127 -127
  441. data/lib/resources/mysql_session.rb +85 -85
  442. data/lib/resources/nginx.rb +96 -96
  443. data/lib/resources/nginx_conf.rb +226 -226
  444. data/lib/resources/npm.rb +48 -48
  445. data/lib/resources/ntp_conf.rb +51 -51
  446. data/lib/resources/oneget.rb +71 -71
  447. data/lib/resources/oracledb_session.rb +139 -139
  448. data/lib/resources/os.rb +36 -36
  449. data/lib/resources/os_env.rb +86 -86
  450. data/lib/resources/package.rb +370 -370
  451. data/lib/resources/packages.rb +111 -111
  452. data/lib/resources/parse_config.rb +112 -112
  453. data/lib/resources/passwd.rb +76 -76
  454. data/lib/resources/pip.rb +130 -130
  455. data/lib/resources/platform.rb +109 -109
  456. data/lib/resources/port.rb +771 -771
  457. data/lib/resources/postgres.rb +131 -131
  458. data/lib/resources/postgres_conf.rb +114 -114
  459. data/lib/resources/postgres_hba_conf.rb +90 -90
  460. data/lib/resources/postgres_ident_conf.rb +79 -79
  461. data/lib/resources/postgres_session.rb +71 -71
  462. data/lib/resources/powershell.rb +67 -67
  463. data/lib/resources/processes.rb +204 -204
  464. data/lib/resources/rabbitmq_conf.rb +51 -51
  465. data/lib/resources/registry_key.rb +297 -297
  466. data/lib/resources/security_policy.rb +180 -180
  467. data/lib/resources/service.rb +794 -794
  468. data/lib/resources/shadow.rb +159 -159
  469. data/lib/resources/ssh_conf.rb +97 -97
  470. data/lib/resources/ssl.rb +99 -99
  471. data/lib/resources/sys_info.rb +28 -28
  472. data/lib/resources/toml.rb +32 -32
  473. data/lib/resources/users.rb +654 -654
  474. data/lib/resources/vbscript.rb +68 -68
  475. data/lib/resources/virtualization.rb +247 -247
  476. data/lib/resources/windows_feature.rb +84 -84
  477. data/lib/resources/windows_hotfix.rb +35 -35
  478. data/lib/resources/windows_task.rb +102 -102
  479. data/lib/resources/wmi.rb +110 -110
  480. data/lib/resources/x509_certificate.rb +137 -137
  481. data/lib/resources/xinetd.rb +106 -106
  482. data/lib/resources/xml.rb +46 -46
  483. data/lib/resources/yaml.rb +43 -43
  484. data/lib/resources/yum.rb +180 -180
  485. data/lib/resources/zfs_dataset.rb +60 -60
  486. data/lib/resources/zfs_pool.rb +49 -49
  487. data/lib/source_readers/flat.rb +39 -39
  488. data/lib/source_readers/inspec.rb +75 -75
  489. data/lib/utils/command_wrapper.rb +27 -27
  490. data/lib/utils/convert.rb +12 -12
  491. data/lib/utils/database_helpers.rb +77 -77
  492. data/lib/utils/enumerable_delegation.rb +9 -9
  493. data/lib/utils/erlang_parser.rb +192 -192
  494. data/lib/utils/file_reader.rb +25 -25
  495. data/lib/utils/filter.rb +273 -273
  496. data/lib/utils/filter_array.rb +27 -27
  497. data/lib/utils/find_files.rb +47 -47
  498. data/lib/utils/hash.rb +41 -41
  499. data/lib/utils/json_log.rb +18 -18
  500. data/lib/utils/latest_version.rb +22 -22
  501. data/lib/utils/modulator.rb +12 -12
  502. data/lib/utils/nginx_parser.rb +105 -105
  503. data/lib/utils/object_traversal.rb +49 -49
  504. data/lib/utils/parser.rb +274 -274
  505. data/lib/utils/pkey_reader.rb +15 -15
  506. data/lib/utils/plugin_registry.rb +93 -93
  507. data/lib/utils/simpleconfig.rb +120 -120
  508. data/lib/utils/spdx.rb +13 -13
  509. data/lib/utils/spdx.txt +343 -343
  510. metadata +3 -3
@@ -1,58 +1,58 @@
1
- # encoding: utf-8
2
-
3
- # Usage:
4
- # describe cpan('DBD::Pg') do
5
- # it { should be_installed }
6
- # end
7
- #
8
-
9
- module Inspec::Resources
10
- class CpanPackage < Inspec.resource(1)
11
- name 'cpan'
12
- supports platform: 'unix'
13
- desc 'Use the `cpan` InSpec audit resource to test Perl modules that are installed by system packages or the CPAN installer.'
14
- example "
15
- describe cpan('DBD::Pg') do
16
- it { should be_installed }
17
- end
18
- "
19
-
20
- def initialize(package_name, perl_lib_path = nil)
21
- @package_name = package_name
22
- @perl_lib_path = perl_lib_path
23
- @perl_cmd = 'perl'
24
-
25
- # this resource is not supported on Windows
26
- return skip_resource 'The `cpan` resource is not supported on your OS yet.' if inspec.os.windows?
27
- return skip_resource 'perl not found' unless inspec.command(@perl_cmd).exist?
28
- end
29
-
30
- def info
31
- return @info if defined?(@info)
32
-
33
- @info = {}
34
- @info[:type] = 'cpan'
35
- @info[:name] = @package_name
36
- # set PERL5LIB environment variable if a custom lib path is given
37
- lib_path = @perl_lib_path.nil? ? '' : "PERL5LIB=#{@perl_lib_path} "
38
- cmd = inspec.command("#{lib_path+@perl_cmd} -le 'eval \"require $ARGV[0]\" and print $ARGV[0]->VERSION or exit 1' #{@package_name}")
39
- @info[:installed] = cmd.exit_status.zero?
40
- return @info unless cmd.exit_status.zero?
41
-
42
- @info[:version] = cmd.stdout.strip
43
- @info
44
- end
45
-
46
- def installed?
47
- info[:installed] == true
48
- end
49
-
50
- def version
51
- info[:version]
52
- end
53
-
54
- def to_s
55
- "Perl Module #{@package_name}"
56
- end
57
- end
58
- end
1
+ # encoding: utf-8
2
+
3
+ # Usage:
4
+ # describe cpan('DBD::Pg') do
5
+ # it { should be_installed }
6
+ # end
7
+ #
8
+
9
+ module Inspec::Resources
10
+ class CpanPackage < Inspec.resource(1)
11
+ name 'cpan'
12
+ supports platform: 'unix'
13
+ desc 'Use the `cpan` InSpec audit resource to test Perl modules that are installed by system packages or the CPAN installer.'
14
+ example "
15
+ describe cpan('DBD::Pg') do
16
+ it { should be_installed }
17
+ end
18
+ "
19
+
20
+ def initialize(package_name, perl_lib_path = nil)
21
+ @package_name = package_name
22
+ @perl_lib_path = perl_lib_path
23
+ @perl_cmd = 'perl'
24
+
25
+ # this resource is not supported on Windows
26
+ return skip_resource 'The `cpan` resource is not supported on your OS yet.' if inspec.os.windows?
27
+ return skip_resource 'perl not found' unless inspec.command(@perl_cmd).exist?
28
+ end
29
+
30
+ def info
31
+ return @info if defined?(@info)
32
+
33
+ @info = {}
34
+ @info[:type] = 'cpan'
35
+ @info[:name] = @package_name
36
+ # set PERL5LIB environment variable if a custom lib path is given
37
+ lib_path = @perl_lib_path.nil? ? '' : "PERL5LIB=#{@perl_lib_path} "
38
+ cmd = inspec.command("#{lib_path+@perl_cmd} -le 'eval \"require $ARGV[0]\" and print $ARGV[0]->VERSION or exit 1' #{@package_name}")
39
+ @info[:installed] = cmd.exit_status.zero?
40
+ return @info unless cmd.exit_status.zero?
41
+
42
+ @info[:version] = cmd.stdout.strip
43
+ @info
44
+ end
45
+
46
+ def installed?
47
+ info[:installed] == true
48
+ end
49
+
50
+ def version
51
+ info[:version]
52
+ end
53
+
54
+ def to_s
55
+ "Perl Module #{@package_name}"
56
+ end
57
+ end
58
+ end
@@ -1,64 +1,64 @@
1
- # encoding: utf-8
2
-
3
- # Usage:
4
- # describe cran('DBI') do
5
- # it { should be_installed }
6
- # end
7
- #
8
-
9
- module Inspec::Resources
10
- class CranPackage < Inspec.resource(1)
11
- name 'cran'
12
- supports platform: 'unix'
13
- desc 'Use the `cran` InSpec audit resource to test R modules that are installed from CRAN package repository.'
14
- example "
15
- describe cran('DBI') do
16
- it { should be_installed }
17
- end
18
- "
19
-
20
- def initialize(package_name)
21
- @package_name = package_name
22
- @r_cmd = 'Rscript'
23
-
24
- # this resource is not supported on Windows
25
- return skip_resource 'The `cran` resource is not supported on your OS yet.' if inspec.os.windows?
26
- return skip_resource 'Rscript not found' unless inspec.command(@r_cmd).exist?
27
- end
28
-
29
- def info
30
- return @info if defined?(@info)
31
-
32
- @info = {}
33
- @info[:type] = 'cran'
34
- @info[:name] = @package_name
35
- cmd = inspec.command("#{@r_cmd} -e 'packageVersion(\"#{@package_name}\")'")
36
- return @info unless cmd.exit_status.zero?
37
-
38
- # Extract package version from Rscript output
39
- # Output includes unicode punctuation (backticks) characters like so:
40
- # [1] '0.5.1'
41
- #
42
- # So make sure command output is converted to unicode, as it returns ASCII-8BIT by default
43
- utf8_stdout = cmd.stdout.chomp.force_encoding(Encoding::UTF_8)
44
- params = /^\[\d+\]\s+(?:\p{Initial_Punctuation})(.+)(?:\p{Final_Punctuation})$/.match(utf8_stdout)
45
- @info[:installed] = !params.nil?
46
- return @info unless @info[:installed]
47
-
48
- @info[:version] = params[1]
49
- @info
50
- end
51
-
52
- def installed?
53
- info[:installed] == true
54
- end
55
-
56
- def version
57
- info[:version]
58
- end
59
-
60
- def to_s
61
- "R Module #{@package_name}"
62
- end
63
- end
64
- end
1
+ # encoding: utf-8
2
+
3
+ # Usage:
4
+ # describe cran('DBI') do
5
+ # it { should be_installed }
6
+ # end
7
+ #
8
+
9
+ module Inspec::Resources
10
+ class CranPackage < Inspec.resource(1)
11
+ name 'cran'
12
+ supports platform: 'unix'
13
+ desc 'Use the `cran` InSpec audit resource to test R modules that are installed from CRAN package repository.'
14
+ example "
15
+ describe cran('DBI') do
16
+ it { should be_installed }
17
+ end
18
+ "
19
+
20
+ def initialize(package_name)
21
+ @package_name = package_name
22
+ @r_cmd = 'Rscript'
23
+
24
+ # this resource is not supported on Windows
25
+ return skip_resource 'The `cran` resource is not supported on your OS yet.' if inspec.os.windows?
26
+ return skip_resource 'Rscript not found' unless inspec.command(@r_cmd).exist?
27
+ end
28
+
29
+ def info
30
+ return @info if defined?(@info)
31
+
32
+ @info = {}
33
+ @info[:type] = 'cran'
34
+ @info[:name] = @package_name
35
+ cmd = inspec.command("#{@r_cmd} -e 'packageVersion(\"#{@package_name}\")'")
36
+ return @info unless cmd.exit_status.zero?
37
+
38
+ # Extract package version from Rscript output
39
+ # Output includes unicode punctuation (backticks) characters like so:
40
+ # [1] '0.5.1'
41
+ #
42
+ # So make sure command output is converted to unicode, as it returns ASCII-8BIT by default
43
+ utf8_stdout = cmd.stdout.chomp.force_encoding(Encoding::UTF_8)
44
+ params = /^\[\d+\]\s+(?:\p{Initial_Punctuation})(.+)(?:\p{Final_Punctuation})$/.match(utf8_stdout)
45
+ @info[:installed] = !params.nil?
46
+ return @info unless @info[:installed]
47
+
48
+ @info[:version] = params[1]
49
+ @info
50
+ end
51
+
52
+ def installed?
53
+ info[:installed] == true
54
+ end
55
+
56
+ def version
57
+ info[:version]
58
+ end
59
+
60
+ def to_s
61
+ "R Module #{@package_name}"
62
+ end
63
+ end
64
+ end
@@ -1,169 +1,169 @@
1
- # encoding: utf-8
2
-
3
- require 'utils/parser'
4
- require 'utils/filter'
5
-
6
- module Inspec::Resources
7
- class Crontab < Inspec.resource(1)
8
- name 'crontab'
9
- supports platform: 'unix'
10
- desc 'Use the crontab InSpec audit resource to test the contents of the crontab for a given user which contains information about scheduled tasks owned by that user.'
11
- example "
12
- describe crontab(user: 'root') do
13
- its('commands') { should include '/path/to/some/script' }
14
- end
15
-
16
- describe crontab('myuser').commands('/home/myuser/build.sh') do
17
- its('hours') { should cmp '*' }
18
- its('minutes') { should cmp '*' }
19
- end
20
-
21
- describe crontab.where({'hour' => '*', 'minute' => '*'}) do
22
- its('entries.length') { should cmp '0' }
23
- end
24
-
25
- describe crontab.where { command =~ /a partial command string/ } do
26
- its('entries.length') { should cmp 1 }
27
- end
28
-
29
- describe crontab(path: '/etc/cron.d/some_crontab') do
30
- its('commands') { should include '/path/to/some/script' }
31
- end
32
- "
33
-
34
- attr_reader :params
35
-
36
- include CommentParser
37
-
38
- def initialize(opts = nil)
39
- if opts.respond_to?(:fetch)
40
- Hash[opts.map { |k, v| [k.to_sym, v] }]
41
- @user = opts.fetch(:user, nil)
42
- @path = opts.fetch(:path, nil)
43
- raise Inspec::Exceptions::ResourceFailed, 'A user or path must be supplied.' if @user.nil? && @path.nil?
44
- else
45
- @user = opts
46
- @path = nil
47
- end
48
- @params = read_crontab
49
- end
50
-
51
- def read_crontab
52
- ct = is_system_crontab? ? inspec.file(@path).content : inspec.command(crontab_cmd).stdout
53
- ct.lines.map { |l| parse_crontab_line(l) }.compact
54
- end
55
-
56
- def parse_crontab_line(l)
57
- data, = parse_comment_line(l, comment_char: '#', standalone_comments: false)
58
- return nil if data.nil? || data.empty?
59
-
60
- is_system_crontab? ? parse_system_crontab(data) : parse_user_crontab(data)
61
- end
62
-
63
- def crontab_cmd
64
- @user.nil? ? 'crontab -l' : "crontab -l -u #{@user}"
65
- end
66
-
67
- filter = FilterTable.create
68
- filter.add_accessor(:where)
69
- .add_accessor(:entries)
70
- .add(:minutes, field: 'minute')
71
- .add(:hours, field: 'hour')
72
- .add(:days, field: 'day')
73
- .add(:months, field: 'month')
74
- .add(:weekdays, field: 'weekday')
75
- .add(:user, field: 'user')
76
- .add(:commands, field: 'command')
77
-
78
- # rebuild the crontab line from raw content
79
- filter.add(:content) { |t, _|
80
- t.entries.map do |e|
81
- [e.minute, e.hour, e.day, e.month, e.weekday, e.user, e.command].compact.join(' ')
82
- end.join("\n")
83
- }
84
-
85
- filter.connect(self, :params)
86
-
87
- def to_s
88
- if is_system_crontab?
89
- "crontab for path #{@path}"
90
- elsif is_user_crontab?
91
- "crontab for user #{@user}"
92
- else
93
- 'crontab for current user'
94
- end
95
- end
96
-
97
- private
98
-
99
- def is_system_crontab?
100
- !@path.nil?
101
- end
102
-
103
- def is_user_crontab?
104
- !@user.nil?
105
- end
106
-
107
- def parse_system_crontab(data)
108
- case data
109
- when /@hourly .*/
110
- elements = data.split(/\s+/, 3)
111
- { 'minute' => '0', 'hour' => '*', 'day' => '*', 'month' => '*', 'weekday' => '*', 'user' => elements.at(1), 'command' => elements.at(2) }
112
- when /@(midnight|daily) .*/
113
- elements = data.split(/\s+/, 3)
114
- { 'minute' => '0', 'hour' => '0', 'day' => '*', 'month' => '*', 'weekday' => '*', 'user' => elements.at(1), 'command' => elements.at(2) }
115
- when /@weekly .*/
116
- elements = data.split(/\s+/, 3)
117
- { 'minute' => '0', 'hour' => '0', 'day' => '*', 'month' => '*', 'weekday' => '0', 'user' => elements.at(1), 'command' => elements.at(2) }
118
- when /@monthly ./
119
- elements = data.split(/\s+/, 3)
120
- { 'minute' => '0', 'hour' => '0', 'day' => '1', 'month' => '*', 'weekday' => '*', 'user' => elements.at(1), 'command' => elements.at(2) }
121
- when /@(annually|yearly) .*/
122
- elements = data.split(/\s+/, 3)
123
- { 'minute' => '0', 'hour' => '0', 'day' => '1', 'month' => '1', 'weekday' => '*', 'user' => elements.at(1), 'command' => elements.at(2) }
124
- when /@reboot .*/
125
- elements = data.split(/\s+/, 3)
126
- { 'minute' => '-1', 'hour' => '-1', 'day' => '-1', 'month' => '-1', 'weekday' => '-1', 'user' => elements.at(1), 'command' => elements.at(2) }
127
- else
128
- elements = data.split(/\s+/, 7)
129
- {
130
- 'minute' => elements.at(0),
131
- 'hour' => elements.at(1),
132
- 'day' => elements.at(2),
133
- 'month' => elements.at(3),
134
- 'weekday' => elements.at(4),
135
- 'user' => elements.at(5),
136
- 'command' => elements.at(6),
137
- }
138
- end
139
- end
140
-
141
- def parse_user_crontab(data)
142
- case data
143
- when /@hourly .*/
144
- { 'minute' => '0', 'hour' => '*', 'day' => '*', 'month' => '*', 'weekday' => '*', 'user' => @user, 'command' => data.split(/\s+/, 2).at(1) }
145
- when /@(midnight|daily) .*/
146
- { 'minute' => '0', 'hour' => '0', 'day' => '*', 'month' => '*', 'weekday' => '*', 'user' => @user, 'command' => data.split(/\s+/, 2).at(1) }
147
- when /@weekly .*/
148
- { 'minute' => '0', 'hour' => '0', 'day' => '*', 'month' => '*', 'weekday' => '0', 'user' => @user, 'command' => data.split(/\s+/, 2).at(1) }
149
- when /@monthly ./
150
- { 'minute' => '0', 'hour' => '0', 'day' => '1', 'month' => '*', 'weekday' => '*', 'user' => @user, 'command' => data.split(/\s+/, 2).at(1) }
151
- when /@(annually|yearly) .*/
152
- { 'minute' => '0', 'hour' => '0', 'day' => '1', 'month' => '1', 'weekday' => '*', 'user' => @user, 'command' => data.split(/\s+/, 2).at(1) }
153
- when /@reboot .*/
154
- { 'minute' => '-1', 'hour' => '-1', 'day' => '-1', 'month' => '-1', 'weekday' => '-1', 'user' => @user, 'command' => data.split(/\s+/, 2).at(1) }
155
- else
156
- elements = data.split(/\s+/, 6)
157
- {
158
- 'minute' => elements.at(0),
159
- 'hour' => elements.at(1),
160
- 'day' => elements.at(2),
161
- 'month' => elements.at(3),
162
- 'weekday' => elements.at(4),
163
- 'user' => @user,
164
- 'command' => elements.at(5),
165
- }
166
- end
167
- end
168
- end
169
- end
1
+ # encoding: utf-8
2
+
3
+ require 'utils/parser'
4
+ require 'utils/filter'
5
+
6
+ module Inspec::Resources
7
+ class Crontab < Inspec.resource(1)
8
+ name 'crontab'
9
+ supports platform: 'unix'
10
+ desc 'Use the crontab InSpec audit resource to test the contents of the crontab for a given user which contains information about scheduled tasks owned by that user.'
11
+ example "
12
+ describe crontab(user: 'root') do
13
+ its('commands') { should include '/path/to/some/script' }
14
+ end
15
+
16
+ describe crontab('myuser').commands('/home/myuser/build.sh') do
17
+ its('hours') { should cmp '*' }
18
+ its('minutes') { should cmp '*' }
19
+ end
20
+
21
+ describe crontab.where({'hour' => '*', 'minute' => '*'}) do
22
+ its('entries.length') { should cmp '0' }
23
+ end
24
+
25
+ describe crontab.where { command =~ /a partial command string/ } do
26
+ its('entries.length') { should cmp 1 }
27
+ end
28
+
29
+ describe crontab(path: '/etc/cron.d/some_crontab') do
30
+ its('commands') { should include '/path/to/some/script' }
31
+ end
32
+ "
33
+
34
+ attr_reader :params
35
+
36
+ include CommentParser
37
+
38
+ def initialize(opts = nil)
39
+ if opts.respond_to?(:fetch)
40
+ Hash[opts.map { |k, v| [k.to_sym, v] }]
41
+ @user = opts.fetch(:user, nil)
42
+ @path = opts.fetch(:path, nil)
43
+ raise Inspec::Exceptions::ResourceFailed, 'A user or path must be supplied.' if @user.nil? && @path.nil?
44
+ else
45
+ @user = opts
46
+ @path = nil
47
+ end
48
+ @params = read_crontab
49
+ end
50
+
51
+ def read_crontab
52
+ ct = is_system_crontab? ? inspec.file(@path).content : inspec.command(crontab_cmd).stdout
53
+ ct.lines.map { |l| parse_crontab_line(l) }.compact
54
+ end
55
+
56
+ def parse_crontab_line(l)
57
+ data, = parse_comment_line(l, comment_char: '#', standalone_comments: false)
58
+ return nil if data.nil? || data.empty?
59
+
60
+ is_system_crontab? ? parse_system_crontab(data) : parse_user_crontab(data)
61
+ end
62
+
63
+ def crontab_cmd
64
+ @user.nil? ? 'crontab -l' : "crontab -l -u #{@user}"
65
+ end
66
+
67
+ filter = FilterTable.create
68
+ filter.add_accessor(:where)
69
+ .add_accessor(:entries)
70
+ .add(:minutes, field: 'minute')
71
+ .add(:hours, field: 'hour')
72
+ .add(:days, field: 'day')
73
+ .add(:months, field: 'month')
74
+ .add(:weekdays, field: 'weekday')
75
+ .add(:user, field: 'user')
76
+ .add(:commands, field: 'command')
77
+
78
+ # rebuild the crontab line from raw content
79
+ filter.add(:content) { |t, _|
80
+ t.entries.map do |e|
81
+ [e.minute, e.hour, e.day, e.month, e.weekday, e.user, e.command].compact.join(' ')
82
+ end.join("\n")
83
+ }
84
+
85
+ filter.connect(self, :params)
86
+
87
+ def to_s
88
+ if is_system_crontab?
89
+ "crontab for path #{@path}"
90
+ elsif is_user_crontab?
91
+ "crontab for user #{@user}"
92
+ else
93
+ 'crontab for current user'
94
+ end
95
+ end
96
+
97
+ private
98
+
99
+ def is_system_crontab?
100
+ !@path.nil?
101
+ end
102
+
103
+ def is_user_crontab?
104
+ !@user.nil?
105
+ end
106
+
107
+ def parse_system_crontab(data)
108
+ case data
109
+ when /@hourly .*/
110
+ elements = data.split(/\s+/, 3)
111
+ { 'minute' => '0', 'hour' => '*', 'day' => '*', 'month' => '*', 'weekday' => '*', 'user' => elements.at(1), 'command' => elements.at(2) }
112
+ when /@(midnight|daily) .*/
113
+ elements = data.split(/\s+/, 3)
114
+ { 'minute' => '0', 'hour' => '0', 'day' => '*', 'month' => '*', 'weekday' => '*', 'user' => elements.at(1), 'command' => elements.at(2) }
115
+ when /@weekly .*/
116
+ elements = data.split(/\s+/, 3)
117
+ { 'minute' => '0', 'hour' => '0', 'day' => '*', 'month' => '*', 'weekday' => '0', 'user' => elements.at(1), 'command' => elements.at(2) }
118
+ when /@monthly ./
119
+ elements = data.split(/\s+/, 3)
120
+ { 'minute' => '0', 'hour' => '0', 'day' => '1', 'month' => '*', 'weekday' => '*', 'user' => elements.at(1), 'command' => elements.at(2) }
121
+ when /@(annually|yearly) .*/
122
+ elements = data.split(/\s+/, 3)
123
+ { 'minute' => '0', 'hour' => '0', 'day' => '1', 'month' => '1', 'weekday' => '*', 'user' => elements.at(1), 'command' => elements.at(2) }
124
+ when /@reboot .*/
125
+ elements = data.split(/\s+/, 3)
126
+ { 'minute' => '-1', 'hour' => '-1', 'day' => '-1', 'month' => '-1', 'weekday' => '-1', 'user' => elements.at(1), 'command' => elements.at(2) }
127
+ else
128
+ elements = data.split(/\s+/, 7)
129
+ {
130
+ 'minute' => elements.at(0),
131
+ 'hour' => elements.at(1),
132
+ 'day' => elements.at(2),
133
+ 'month' => elements.at(3),
134
+ 'weekday' => elements.at(4),
135
+ 'user' => elements.at(5),
136
+ 'command' => elements.at(6),
137
+ }
138
+ end
139
+ end
140
+
141
+ def parse_user_crontab(data)
142
+ case data
143
+ when /@hourly .*/
144
+ { 'minute' => '0', 'hour' => '*', 'day' => '*', 'month' => '*', 'weekday' => '*', 'user' => @user, 'command' => data.split(/\s+/, 2).at(1) }
145
+ when /@(midnight|daily) .*/
146
+ { 'minute' => '0', 'hour' => '0', 'day' => '*', 'month' => '*', 'weekday' => '*', 'user' => @user, 'command' => data.split(/\s+/, 2).at(1) }
147
+ when /@weekly .*/
148
+ { 'minute' => '0', 'hour' => '0', 'day' => '*', 'month' => '*', 'weekday' => '0', 'user' => @user, 'command' => data.split(/\s+/, 2).at(1) }
149
+ when /@monthly ./
150
+ { 'minute' => '0', 'hour' => '0', 'day' => '1', 'month' => '*', 'weekday' => '*', 'user' => @user, 'command' => data.split(/\s+/, 2).at(1) }
151
+ when /@(annually|yearly) .*/
152
+ { 'minute' => '0', 'hour' => '0', 'day' => '1', 'month' => '1', 'weekday' => '*', 'user' => @user, 'command' => data.split(/\s+/, 2).at(1) }
153
+ when /@reboot .*/
154
+ { 'minute' => '-1', 'hour' => '-1', 'day' => '-1', 'month' => '-1', 'weekday' => '-1', 'user' => @user, 'command' => data.split(/\s+/, 2).at(1) }
155
+ else
156
+ elements = data.split(/\s+/, 6)
157
+ {
158
+ 'minute' => elements.at(0),
159
+ 'hour' => elements.at(1),
160
+ 'day' => elements.at(2),
161
+ 'month' => elements.at(3),
162
+ 'weekday' => elements.at(4),
163
+ 'user' => @user,
164
+ 'command' => elements.at(5),
165
+ }
166
+ end
167
+ end
168
+ end
169
+ end