brine-dsl 0.5.0

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 (72) hide show
  1. checksums.yaml +7 -0
  2. data/.gitignore +4 -0
  3. data/.ruby-version +1 -0
  4. data/.travis.yml +11 -0
  5. data/Gemfile +3 -0
  6. data/Gemfile.lock +123 -0
  7. data/Guardfile +12 -0
  8. data/LICENSE +21 -0
  9. data/README.md +137 -0
  10. data/Rakefile +32 -0
  11. data/brine-dsl.gemspec +32 -0
  12. data/config/cucumber.yml +2 -0
  13. data/docs/build.gradle +19 -0
  14. data/docs/cookbook.html +567 -0
  15. data/docs/gradle/wrapper/gradle-wrapper.jar +0 -0
  16. data/docs/gradle/wrapper/gradle-wrapper.properties +6 -0
  17. data/docs/gradlew +172 -0
  18. data/docs/gradlew.bat +84 -0
  19. data/docs/guide.html +1149 -0
  20. data/docs/index.html +472 -0
  21. data/docs/specs.html +1672 -0
  22. data/docs/src/cookbook.adoc +87 -0
  23. data/docs/src/guide.adoc +427 -0
  24. data/docs/src/index.adoc +16 -0
  25. data/docs/src/spec.erb +121 -0
  26. data/docs/src/specs.adoc +24 -0
  27. data/features/argument_transforms/boolean.feature +37 -0
  28. data/features/argument_transforms/datetime.feature +45 -0
  29. data/features/argument_transforms/integer.feature +41 -0
  30. data/features/argument_transforms/list.feature +46 -0
  31. data/features/argument_transforms/object.feature +66 -0
  32. data/features/argument_transforms/quoted.feature +41 -0
  33. data/features/argument_transforms/regex.feature +40 -0
  34. data/features/argument_transforms/template.feature +46 -0
  35. data/features/argument_transforms/whitespace.feature +51 -0
  36. data/features/assertions/is_a_valid.feature +184 -0
  37. data/features/assertions/is_equal_to.feature +60 -0
  38. data/features/assertions/is_including.feature +29 -0
  39. data/features/assertions/is_matching.feature +35 -0
  40. data/features/deprecations/replaced_with.feature +35 -0
  41. data/features/request_construction/basic.feature +29 -0
  42. data/features/request_construction/body.feature +26 -0
  43. data/features/request_construction/clearing.feature +46 -0
  44. data/features/request_construction/headers.feature +94 -0
  45. data/features/request_construction/params.feature +60 -0
  46. data/features/resource_cleanup/cleanup.feature +86 -0
  47. data/features/selectors/all.feature +55 -0
  48. data/features/selectors/any.feature +48 -0
  49. data/features/step_definitions/test_steps.rb +5 -0
  50. data/features/support/env.rb +10 -0
  51. data/lib/brine/cleaner_upper.rb +62 -0
  52. data/lib/brine/coercer.rb +18 -0
  53. data/lib/brine/hooks.rb +4 -0
  54. data/lib/brine/mustache_binder.rb +25 -0
  55. data/lib/brine/requester.rb +125 -0
  56. data/lib/brine/rest_steps.rb +138 -0
  57. data/lib/brine/selector.rb +66 -0
  58. data/lib/brine/step_definitions/assertions.rb +37 -0
  59. data/lib/brine/step_definitions/assignment.rb +13 -0
  60. data/lib/brine/step_definitions/cleanup.rb +4 -0
  61. data/lib/brine/step_definitions/request_construction.rb +19 -0
  62. data/lib/brine/step_definitions/selection.rb +37 -0
  63. data/lib/brine/test_steps.rb +138 -0
  64. data/lib/brine/transforms.rb +81 -0
  65. data/lib/brine/type_checks.rb +35 -0
  66. data/lib/brine/util.rb +35 -0
  67. data/lib/brine.rb +39 -0
  68. data/tutorial/missing.feature +5 -0
  69. data/tutorial/post_matching.feature +12 -0
  70. data/tutorial/post_status.feature +10 -0
  71. data/tutorial/support/env.rb +2 -0
  72. metadata +306 -0
@@ -0,0 +1,567 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
6
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
7
+ <meta name="generator" content="Asciidoctor 1.5.0">
8
+ <meta name="description" content="Cookbook for the Brine REST Testing DSL">
9
+ <meta name="keywords" content="Brine, Cucumber, REST, DSL">
10
+ <meta name="author" content="Matt Whipple">
11
+ <title>Brine Cookbook</title>
12
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic|Noto+Serif:400,400italic,700,700italic|Droid+Sans+Mono:400">
13
+ <style>
14
+ /* Asciidoctor default stylesheet | MIT License | http://asciidoctor.org */
15
+ /* Remove the comments around the @import statement below when using this as a custom stylesheet */
16
+ /*@import "https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic|Noto+Serif:400,400italic,700,700italic|Droid+Sans+Mono:400";*/
17
+ article,aside,details,figcaption,figure,footer,header,hgroup,main,nav,section,summary{display:block}
18
+ audio,canvas,video{display:inline-block}
19
+ audio:not([controls]){display:none;height:0}
20
+ [hidden],template{display:none}
21
+ script{display:none!important}
22
+ html{font-family:sans-serif;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}
23
+ body{margin:0}
24
+ a{background:transparent}
25
+ a:focus{outline:thin dotted}
26
+ a:active,a:hover{outline:0}
27
+ h1{font-size:2em;margin:.67em 0}
28
+ abbr[title]{border-bottom:1px dotted}
29
+ b,strong{font-weight:bold}
30
+ dfn{font-style:italic}
31
+ hr{-moz-box-sizing:content-box;box-sizing:content-box;height:0}
32
+ mark{background:#ff0;color:#000}
33
+ code,kbd,pre,samp{font-family:monospace;font-size:1em}
34
+ pre{white-space:pre-wrap}
35
+ q{quotes:"\201C" "\201D" "\2018" "\2019"}
36
+ small{font-size:80%}
37
+ sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}
38
+ sup{top:-.5em}
39
+ sub{bottom:-.25em}
40
+ img{border:0}
41
+ svg:not(:root){overflow:hidden}
42
+ figure{margin:0}
43
+ fieldset{border:1px solid silver;margin:0 2px;padding:.35em .625em .75em}
44
+ legend{border:0;padding:0}
45
+ button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}
46
+ button,input{line-height:normal}
47
+ button,select{text-transform:none}
48
+ button,html input[type="button"],input[type="reset"],input[type="submit"]{-webkit-appearance:button;cursor:pointer}
49
+ button[disabled],html input[disabled]{cursor:default}
50
+ input[type="checkbox"],input[type="radio"]{box-sizing:border-box;padding:0}
51
+ input[type="search"]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}
52
+ input[type="search"]::-webkit-search-cancel-button,input[type="search"]::-webkit-search-decoration{-webkit-appearance:none}
53
+ button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}
54
+ textarea{overflow:auto;vertical-align:top}
55
+ table{border-collapse:collapse;border-spacing:0}
56
+ *,*:before,*:after{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}
57
+ html,body{font-size:100%}
58
+ body{background:#fff;color:rgba(0,0,0,.8);padding:0;margin:0;font-family:"Noto Serif","DejaVu Serif",serif;font-weight:400;font-style:normal;line-height:1;position:relative;cursor:auto}
59
+ a:hover{cursor:pointer}
60
+ img,object,embed{max-width:100%;height:auto}
61
+ object,embed{height:100%}
62
+ img{-ms-interpolation-mode:bicubic}
63
+ #map_canvas img,#map_canvas embed,#map_canvas object,.map_canvas img,.map_canvas embed,.map_canvas object{max-width:none!important}
64
+ .left{float:left!important}
65
+ .right{float:right!important}
66
+ .text-left{text-align:left!important}
67
+ .text-right{text-align:right!important}
68
+ .text-center{text-align:center!important}
69
+ .text-justify{text-align:justify!important}
70
+ .hide{display:none}
71
+ .antialiased,body{-webkit-font-smoothing:antialiased}
72
+ img{display:inline-block;vertical-align:middle}
73
+ textarea{height:auto;min-height:50px}
74
+ select{width:100%}
75
+ p.lead,.paragraph.lead>p,#preamble>.sectionbody>.paragraph:first-of-type p{font-size:1.21875em;line-height:1.6}
76
+ .subheader,.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{line-height:1.45;color:#7a2518;font-weight:400;margin-top:0;margin-bottom:.25em}
77
+ div,dl,dt,dd,ul,ol,li,h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6,pre,form,p,blockquote,th,td{margin:0;padding:0;direction:ltr}
78
+ a{color:#2156a5;text-decoration:underline;line-height:inherit}
79
+ a:hover,a:focus{color:#1d4b8f}
80
+ a img{border:none}
81
+ p{font-family:inherit;font-weight:400;font-size:1em;line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility}
82
+ p aside{font-size:.875em;line-height:1.35;font-style:italic}
83
+ h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{font-family:"Open Sans","DejaVu Sans",sans-serif;font-weight:300;font-style:normal;color:#ba3925;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:.5em;line-height:1.0125em}
84
+ h1 small,h2 small,h3 small,#toctitle small,.sidebarblock>.content>.title small,h4 small,h5 small,h6 small{font-size:60%;color:#e99b8f;line-height:0}
85
+ h1{font-size:2.125em}
86
+ h2{font-size:1.6875em}
87
+ h3,#toctitle,.sidebarblock>.content>.title{font-size:1.375em}
88
+ h4,h5{font-size:1.125em}
89
+ h6{font-size:1em}
90
+ hr{border:solid #ddddd8;border-width:1px 0 0;clear:both;margin:1.25em 0 1.1875em;height:0}
91
+ em,i{font-style:italic;line-height:inherit}
92
+ strong,b{font-weight:bold;line-height:inherit}
93
+ small{font-size:60%;line-height:inherit}
94
+ code{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;font-weight:400;color:rgba(0,0,0,.9)}
95
+ ul,ol,dl{font-size:1em;line-height:1.6;margin-bottom:1.25em;list-style-position:outside;font-family:inherit}
96
+ ul,ol,ul.no-bullet,ol.no-bullet{margin-left:1.5em}
97
+ ul li ul,ul li ol{margin-left:1.25em;margin-bottom:0;font-size:1em}
98
+ ul.square li ul,ul.circle li ul,ul.disc li ul{list-style:inherit}
99
+ ul.square{list-style-type:square}
100
+ ul.circle{list-style-type:circle}
101
+ ul.disc{list-style-type:disc}
102
+ ul.no-bullet{list-style:none}
103
+ ol li ul,ol li ol{margin-left:1.25em;margin-bottom:0}
104
+ dl dt{margin-bottom:.3125em;font-weight:bold}
105
+ dl dd{margin-bottom:1.25em}
106
+ abbr,acronym{text-transform:uppercase;font-size:90%;color:rgba(0,0,0,.8);border-bottom:1px dotted #ddd;cursor:help}
107
+ abbr{text-transform:none}
108
+ blockquote{margin:0 0 1.25em;padding:.5625em 1.25em 0 1.1875em;border-left:1px solid #ddd}
109
+ blockquote cite{display:block;font-size:.9375em;color:rgba(0,0,0,.6)}
110
+ blockquote cite:before{content:"\2014 \0020"}
111
+ blockquote cite a,blockquote cite a:visited{color:rgba(0,0,0,.6)}
112
+ blockquote,blockquote p{line-height:1.6;color:rgba(0,0,0,.85)}
113
+ @media only screen and (min-width:768px){h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2}
114
+ h1{font-size:2.75em}
115
+ h2{font-size:2.3125em}
116
+ h3,#toctitle,.sidebarblock>.content>.title{font-size:1.6875em}
117
+ h4{font-size:1.4375em}}table{background:#fff;margin-bottom:1.25em;border:solid 1px #dedede}
118
+ table thead,table tfoot{background:#f7f8f7;font-weight:bold}
119
+ table thead tr th,table thead tr td,table tfoot tr th,table tfoot tr td{padding:.5em .625em .625em;font-size:inherit;color:rgba(0,0,0,.8);text-align:left}
120
+ table tr th,table tr td{padding:.5625em .625em;font-size:inherit;color:rgba(0,0,0,.8)}
121
+ table tr.even,table tr.alt,table tr:nth-of-type(even){background:#f8f8f7}
122
+ table thead tr th,table tfoot tr th,table tbody tr td,table tr td,table tfoot tr td{display:table-cell;line-height:1.6}
123
+ h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2;word-spacing:-.05em}
124
+ h1 strong,h2 strong,h3 strong,#toctitle strong,.sidebarblock>.content>.title strong,h4 strong,h5 strong,h6 strong{font-weight:400}
125
+ .clearfix:before,.clearfix:after,.float-group:before,.float-group:after{content:" ";display:table}
126
+ .clearfix:after,.float-group:after{clear:both}
127
+ *:not(pre)>code{font-size:.9375em;font-style:normal!important;letter-spacing:0;padding:.1em .5ex;word-spacing:-.15em;background-color:#f7f7f8;-webkit-border-radius:4px;border-radius:4px;line-height:1.45;text-rendering:optimizeSpeed}
128
+ pre,pre>code{line-height:1.45;color:rgba(0,0,0,.9);font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;font-weight:400;text-rendering:optimizeSpeed}
129
+ .keyseq{color:rgba(51,51,51,.8)}
130
+ kbd{display:inline-block;color:rgba(0,0,0,.8);font-size:.75em;line-height:1.4;background-color:#f7f7f7;border:1px solid #ccc;-webkit-border-radius:3px;border-radius:3px;-webkit-box-shadow:0 1px 0 rgba(0,0,0,.2),0 0 0 .1em white inset;box-shadow:0 1px 0 rgba(0,0,0,.2),0 0 0 .1em #fff inset;margin:-.15em .15em 0 .15em;padding:.2em .6em .2em .5em;vertical-align:middle;white-space:nowrap}
131
+ .keyseq kbd:first-child{margin-left:0}
132
+ .keyseq kbd:last-child{margin-right:0}
133
+ .menuseq,.menu{color:rgba(0,0,0,.8)}
134
+ b.button:before,b.button:after{position:relative;top:-1px;font-weight:400}
135
+ b.button:before{content:"[";padding:0 3px 0 2px}
136
+ b.button:after{content:"]";padding:0 2px 0 3px}
137
+ p a>code:hover{color:rgba(0,0,0,.9)}
138
+ #header,#content,#footnotes,#footer{width:100%;margin-left:auto;margin-right:auto;margin-top:0;margin-bottom:0;max-width:62.5em;*zoom:1;position:relative;padding-left:.9375em;padding-right:.9375em}
139
+ #header:before,#header:after,#content:before,#content:after,#footnotes:before,#footnotes:after,#footer:before,#footer:after{content:" ";display:table}
140
+ #header:after,#content:after,#footnotes:after,#footer:after{clear:both}
141
+ #content{margin-top:1.25em}
142
+ #content:before{content:none}
143
+ #header>h1:first-child{color:rgba(0,0,0,.85);margin-top:2.25rem;margin-bottom:0}
144
+ #header>h1:first-child+#toc{margin-top:8px;border-top:1px solid #ddddd8}
145
+ #header>h1:only-child,body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #ddddd8;padding-bottom:8px}
146
+ #header .details{border-bottom:1px solid #ddddd8;line-height:1.45;padding-top:.25em;padding-bottom:.25em;padding-left:.25em;color:rgba(0,0,0,.6);display:-ms-flexbox;display:-webkit-flex;display:flex;-ms-flex-flow:row wrap;-webkit-flex-flow:row wrap;flex-flow:row wrap}
147
+ #header .details span:first-child{margin-left:-.125em}
148
+ #header .details span.email a{color:rgba(0,0,0,.85)}
149
+ #header .details br{display:none}
150
+ #header .details br+span:before{content:"\00a0\2013\00a0"}
151
+ #header .details br+span.author:before{content:"\00a0\22c5\00a0";color:rgba(0,0,0,.85)}
152
+ #header .details br+span#revremark:before{content:"\00a0|\00a0"}
153
+ #header #revnumber{text-transform:capitalize}
154
+ #header #revnumber:after{content:"\00a0"}
155
+ #content>h1:first-child:not([class]){color:rgba(0,0,0,.85);border-bottom:1px solid #ddddd8;padding-bottom:8px;margin-top:0;padding-top:1rem;margin-bottom:1.25rem}
156
+ #toc{border-bottom:1px solid #efefed;padding-bottom:.5em}
157
+ #toc>ul{margin-left:.125em}
158
+ #toc ul.sectlevel0>li>a{font-style:italic}
159
+ #toc ul.sectlevel0 ul.sectlevel1{margin:.5em 0}
160
+ #toc ul{font-family:"Open Sans","DejaVu Sans",sans-serif;list-style-type:none}
161
+ #toc a{text-decoration:none}
162
+ #toc a:active{text-decoration:underline}
163
+ #toctitle{color:#7a2518;font-size:1.2em}
164
+ @media only screen and (min-width:768px){#toctitle{font-size:1.375em}
165
+ body.toc2{padding-left:15em;padding-right:0}
166
+ #toc.toc2{margin-top:0!important;background-color:#f8f8f7;position:fixed;width:15em;left:0;top:0;border-right:1px solid #efefed;border-top-width:0!important;border-bottom-width:0!important;z-index:1000;padding:1.25em 1em;height:100%;overflow:auto}
167
+ #toc.toc2 #toctitle{margin-top:0;font-size:1.2em}
168
+ #toc.toc2>ul{font-size:.9em;margin-bottom:0}
169
+ #toc.toc2 ul ul{margin-left:0;padding-left:1em}
170
+ #toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:0;margin-top:.5em;margin-bottom:.5em}
171
+ body.toc2.toc-right{padding-left:0;padding-right:15em}
172
+ body.toc2.toc-right #toc.toc2{border-right-width:0;border-left:1px solid #efefed;left:auto;right:0}}@media only screen and (min-width:1280px){body.toc2{padding-left:20em;padding-right:0}
173
+ #toc.toc2{width:20em}
174
+ #toc.toc2 #toctitle{font-size:1.375em}
175
+ #toc.toc2>ul{font-size:.95em}
176
+ #toc.toc2 ul ul{padding-left:1.25em}
177
+ body.toc2.toc-right{padding-left:0;padding-right:20em}}#content #toc{border-style:solid;border-width:1px;border-color:#e0e0dc;margin-bottom:1.25em;padding:1.25em;background:#f8f8f7;-webkit-border-radius:4px;border-radius:4px}
178
+ #content #toc>:first-child{margin-top:0}
179
+ #content #toc>:last-child{margin-bottom:0}
180
+ #footer{max-width:100%;background-color:rgba(0,0,0,.8);padding:1.25em}
181
+ #footer-text{color:rgba(255,255,255,.8);line-height:1.44}
182
+ .sect1{padding-bottom:.625em}
183
+ @media only screen and (min-width:768px){.sect1{padding-bottom:1.25em}}.sect1+.sect1{border-top:1px solid #efefed}
184
+ #content h1>a.anchor,h2>a.anchor,h3>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;display:block;text-decoration:none!important;visibility:hidden;text-align:center;font-weight:400}
185
+ #content h1>a.anchor:before,h2>a.anchor:before,h3>a.anchor:before,#toctitle>a.anchor:before,.sidebarblock>.content>.title>a.anchor:before,h4>a.anchor:before,h5>a.anchor:before,h6>a.anchor:before{content:"\00A7";font-size:.85em;display:block;padding-top:.1em}
186
+ #content h1:hover>a.anchor,#content h1>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,#toctitle:hover>a.anchor,.sidebarblock>.content>.title:hover>a.anchor,h3>a.anchor:hover,#toctitle>a.anchor:hover,.sidebarblock>.content>.title>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible}
187
+ #content h1>a.link,h2>a.link,h3>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h4>a.link,h5>a.link,h6>a.link{color:#ba3925;text-decoration:none}
188
+ #content h1>a.link:hover,h2>a.link:hover,h3>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#a53221}
189
+ .audioblock,.imageblock,.literalblock,.listingblock,.stemblock,.videoblock{margin-bottom:1.25em}
190
+ .admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{text-rendering:optimizeLegibility;text-align:left;font-family:"Noto Serif","DejaVu Serif",serif;font-size:1rem;font-style:italic}
191
+ table.tableblock>caption.title{white-space:nowrap;overflow:visible;max-width:0}
192
+ .paragraph.lead>p,#preamble>.sectionbody>.paragraph:first-of-type p{color:rgba(0,0,0,.85)}
193
+ table.tableblock #preamble>.sectionbody>.paragraph:first-of-type p{font-size:inherit}
194
+ .admonitionblock>table{border-collapse:separate;border:0;background:none;width:100%}
195
+ .admonitionblock>table td.icon{text-align:center;width:80px}
196
+ .admonitionblock>table td.icon img{max-width:none}
197
+ .admonitionblock>table td.icon .title{font-weight:bold;font-family:"Open Sans","DejaVu Sans",sans-serif;text-transform:uppercase}
198
+ .admonitionblock>table td.content{padding-left:1.125em;padding-right:1.25em;border-left:1px solid #ddddd8;color:rgba(0,0,0,.6)}
199
+ .admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0}
200
+ .exampleblock>.content{border-style:solid;border-width:1px;border-color:#e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#fff;-webkit-border-radius:4px;border-radius:4px}
201
+ .exampleblock>.content>:first-child{margin-top:0}
202
+ .exampleblock>.content>:last-child{margin-bottom:0}
203
+ .sidebarblock{border-style:solid;border-width:1px;border-color:#e0e0dc;margin-bottom:1.25em;padding:1.25em;background:#f8f8f7;-webkit-border-radius:4px;border-radius:4px}
204
+ .sidebarblock>:first-child{margin-top:0}
205
+ .sidebarblock>:last-child{margin-bottom:0}
206
+ .sidebarblock>.content>.title{color:#7a2518;margin-top:0;text-align:center}
207
+ .exampleblock>.content>:last-child>:last-child,.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child{margin-bottom:0}
208
+ .literalblock pre,.listingblock pre:not(.highlight),.listingblock pre[class="highlight"],.listingblock pre[class^="highlight "],.listingblock pre.CodeRay,.listingblock pre.prettyprint{background:#f7f7f8}
209
+ .sidebarblock .literalblock pre,.sidebarblock .listingblock pre:not(.highlight),.sidebarblock .listingblock pre[class="highlight"],.sidebarblock .listingblock pre[class^="highlight "],.sidebarblock .listingblock pre.CodeRay,.sidebarblock .listingblock pre.prettyprint{background:#f2f1f1}
210
+ .literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{-webkit-border-radius:4px;border-radius:4px;word-wrap:break-word;padding:1em;font-size:.8125em}
211
+ .literalblock pre.nowrap,.literalblock pre[class].nowrap,.listingblock pre.nowrap,.listingblock pre[class].nowrap{overflow-x:auto;white-space:pre;word-wrap:normal}
212
+ @media only screen and (min-width:768px){.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{font-size:.90625em}}@media only screen and (min-width:1280px){.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{font-size:1em}}.literalblock.output pre{color:#f7f7f8;background-color:rgba(0,0,0,.9)}
213
+ .listingblock pre.highlightjs{padding:0}
214
+ .listingblock pre.highlightjs>code{padding:1em;-webkit-border-radius:4px;border-radius:4px}
215
+ .listingblock pre.prettyprint{border-width:0}
216
+ .listingblock>.content{position:relative}
217
+ .listingblock code[data-lang]:before{display:none;content:attr(data-lang);position:absolute;font-size:.75em;top:.425rem;right:.5rem;line-height:1;text-transform:uppercase;color:#999}
218
+ .listingblock:hover code[data-lang]:before{display:block}
219
+ .listingblock.terminal pre .command:before{content:attr(data-prompt);padding-right:.5em;color:#999}
220
+ .listingblock.terminal pre .command:not([data-prompt]):before{content:"$"}
221
+ table.pyhltable{border-collapse:separate;border:0;margin-bottom:0;background:none}
222
+ table.pyhltable td{vertical-align:top;padding-top:0;padding-bottom:0}
223
+ table.pyhltable td.code{padding-left:.75em;padding-right:0}
224
+ pre.pygments .lineno,table.pyhltable td:not(.code){color:#999;padding-left:0;padding-right:.5em;border-right:1px solid #ddddd8}
225
+ pre.pygments .lineno{display:inline-block;margin-right:.25em}
226
+ table.pyhltable .linenodiv{background:none!important;padding-right:0!important}
227
+ .quoteblock{margin:0 1em 1.25em 1.5em;display:table}
228
+ .quoteblock>.title{margin-left:-1.5em;margin-bottom:.75em}
229
+ .quoteblock blockquote,.quoteblock blockquote p{color:rgba(0,0,0,.85);font-size:1.15rem;line-height:1.75;word-spacing:.1em;letter-spacing:0;font-style:italic;text-align:justify}
230
+ .quoteblock blockquote{margin:0;padding:0;border:0}
231
+ .quoteblock blockquote:before{content:"\201c";float:left;font-size:2.75em;font-weight:bold;line-height:.6em;margin-left:-.6em;color:#7a2518;text-shadow:0 1px 2px rgba(0,0,0,.1)}
232
+ .quoteblock blockquote>.paragraph:last-child p{margin-bottom:0}
233
+ .quoteblock .attribution{margin-top:.5em;margin-right:.5ex;text-align:right}
234
+ .quoteblock .quoteblock{margin-left:0;margin-right:0;padding:.5em 0;border-left:3px solid rgba(0,0,0,.6)}
235
+ .quoteblock .quoteblock blockquote{padding:0 0 0 .75em}
236
+ .quoteblock .quoteblock blockquote:before{display:none}
237
+ .verseblock{margin:0 1em 1.25em 1em}
238
+ .verseblock pre{font-family:"Open Sans","DejaVu Sans",sans;font-size:1.15rem;color:rgba(0,0,0,.85);font-weight:300;text-rendering:optimizeLegibility}
239
+ .verseblock pre strong{font-weight:400}
240
+ .verseblock .attribution{margin-top:1.25rem;margin-left:.5ex}
241
+ .quoteblock .attribution,.verseblock .attribution{font-size:.9375em;line-height:1.45;font-style:italic}
242
+ .quoteblock .attribution br,.verseblock .attribution br{display:none}
243
+ .quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-.05em;color:rgba(0,0,0,.6)}
244
+ .quoteblock.abstract{margin:0 0 1.25em 0;display:block}
245
+ .quoteblock.abstract blockquote,.quoteblock.abstract blockquote p{text-align:left;word-spacing:0}
246
+ .quoteblock.abstract blockquote:before,.quoteblock.abstract blockquote p:first-of-type:before{display:none}
247
+ table.tableblock{max-width:100%;border-collapse:separate}
248
+ table.tableblock td>.paragraph:last-child p>p:last-child,table.tableblock th>p:last-child,table.tableblock td>p:last-child{margin-bottom:0}
249
+ table.spread{width:100%}
250
+ table.tableblock,th.tableblock,td.tableblock{border:0 solid #dedede}
251
+ table.grid-all th.tableblock,table.grid-all td.tableblock{border-width:0 1px 1px 0}
252
+ table.grid-all tfoot>tr>th.tableblock,table.grid-all tfoot>tr>td.tableblock{border-width:1px 1px 0 0}
253
+ table.grid-cols th.tableblock,table.grid-cols td.tableblock{border-width:0 1px 0 0}
254
+ table.grid-all *>tr>.tableblock:last-child,table.grid-cols *>tr>.tableblock:last-child{border-right-width:0}
255
+ table.grid-rows th.tableblock,table.grid-rows td.tableblock{border-width:0 0 1px 0}
256
+ table.grid-all tbody>tr:last-child>th.tableblock,table.grid-all tbody>tr:last-child>td.tableblock,table.grid-all thead:last-child>tr>th.tableblock,table.grid-rows tbody>tr:last-child>th.tableblock,table.grid-rows tbody>tr:last-child>td.tableblock,table.grid-rows thead:last-child>tr>th.tableblock{border-bottom-width:0}
257
+ table.grid-rows tfoot>tr>th.tableblock,table.grid-rows tfoot>tr>td.tableblock{border-width:1px 0 0 0}
258
+ table.frame-all{border-width:1px}
259
+ table.frame-sides{border-width:0 1px}
260
+ table.frame-topbot{border-width:1px 0}
261
+ th.halign-left,td.halign-left{text-align:left}
262
+ th.halign-right,td.halign-right{text-align:right}
263
+ th.halign-center,td.halign-center{text-align:center}
264
+ th.valign-top,td.valign-top{vertical-align:top}
265
+ th.valign-bottom,td.valign-bottom{vertical-align:bottom}
266
+ th.valign-middle,td.valign-middle{vertical-align:middle}
267
+ table thead th,table tfoot th{font-weight:bold}
268
+ tbody tr th{display:table-cell;line-height:1.6;background:#f7f8f7}
269
+ tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:rgba(0,0,0,.8);font-weight:bold}
270
+ p.tableblock>code:only-child{background:none;padding:0}
271
+ p.tableblock{font-size:1em}
272
+ td>div.verse{white-space:pre}
273
+ ol{margin-left:1.75em}
274
+ ul li ol{margin-left:1.5em}
275
+ dl dd{margin-left:1.125em}
276
+ dl dd:last-child,dl dd:last-child>:last-child{margin-bottom:0}
277
+ ol>li p,ul>li p,ul dd,ol dd,.olist .olist,.ulist .ulist,.ulist .olist,.olist .ulist{margin-bottom:.625em}
278
+ ul.unstyled,ol.unnumbered,ul.checklist,ul.none{list-style-type:none}
279
+ ul.unstyled,ol.unnumbered,ul.checklist{margin-left:.625em}
280
+ ul.checklist li>p:first-child>.fa-check-square-o:first-child,ul.checklist li>p:first-child>input[type="checkbox"]:first-child{margin-right:.25em}
281
+ ul.checklist li>p:first-child>input[type="checkbox"]:first-child{position:relative;top:1px}
282
+ ul.inline{margin:0 auto .625em auto;margin-left:-1.375em;margin-right:0;padding:0;list-style:none;overflow:hidden}
283
+ ul.inline>li{list-style:none;float:left;margin-left:1.375em;display:block}
284
+ ul.inline>li>*{display:block}
285
+ .unstyled dl dt{font-weight:400;font-style:normal}
286
+ ol.arabic{list-style-type:decimal}
287
+ ol.decimal{list-style-type:decimal-leading-zero}
288
+ ol.loweralpha{list-style-type:lower-alpha}
289
+ ol.upperalpha{list-style-type:upper-alpha}
290
+ ol.lowerroman{list-style-type:lower-roman}
291
+ ol.upperroman{list-style-type:upper-roman}
292
+ ol.lowergreek{list-style-type:lower-greek}
293
+ .hdlist>table,.colist>table{border:0;background:none}
294
+ .hdlist>table>tbody>tr,.colist>table>tbody>tr{background:none}
295
+ td.hdlist1{padding-right:.75em;font-weight:bold}
296
+ td.hdlist1,td.hdlist2{vertical-align:top}
297
+ .literalblock+.colist,.listingblock+.colist{margin-top:-.5em}
298
+ .colist>table tr>td:first-of-type{padding:0 .75em;line-height:1}
299
+ .colist>table tr>td:last-of-type{padding:.25em 0}
300
+ .thumb,.th{line-height:0;display:inline-block;border:solid 4px #fff;-webkit-box-shadow:0 0 0 1px #ddd;box-shadow:0 0 0 1px #ddd}
301
+ .imageblock.left,.imageblock[style*="float: left"]{margin:.25em .625em 1.25em 0}
302
+ .imageblock.right,.imageblock[style*="float: right"]{margin:.25em 0 1.25em .625em}
303
+ .imageblock>.title{margin-bottom:0}
304
+ .imageblock.thumb,.imageblock.th{border-width:6px}
305
+ .imageblock.thumb>.title,.imageblock.th>.title{padding:0 .125em}
306
+ .image.left,.image.right{margin-top:.25em;margin-bottom:.25em;display:inline-block;line-height:0}
307
+ .image.left{margin-right:.625em}
308
+ .image.right{margin-left:.625em}
309
+ a.image{text-decoration:none}
310
+ span.footnote,span.footnoteref{vertical-align:super;font-size:.875em}
311
+ span.footnote a,span.footnoteref a{text-decoration:none}
312
+ span.footnote a:active,span.footnoteref a:active{text-decoration:underline}
313
+ #footnotes{padding-top:.75em;padding-bottom:.75em;margin-bottom:.625em}
314
+ #footnotes hr{width:20%;min-width:6.25em;margin:-.25em 0 .75em 0;border-width:1px 0 0 0}
315
+ #footnotes .footnote{padding:0 .375em;line-height:1.3;font-size:.875em;margin-left:1.2em;text-indent:-1.2em;margin-bottom:.2em}
316
+ #footnotes .footnote a:first-of-type{font-weight:bold;text-decoration:none}
317
+ #footnotes .footnote:last-of-type{margin-bottom:0}
318
+ #content #footnotes{margin-top:-.625em;margin-bottom:0;padding:.75em 0}
319
+ .gist .file-data>table{border:0;background:#fff;width:100%;margin-bottom:0}
320
+ .gist .file-data>table td.line-data{width:99%}
321
+ div.unbreakable{page-break-inside:avoid}
322
+ .big{font-size:larger}
323
+ .small{font-size:smaller}
324
+ .underline{text-decoration:underline}
325
+ .overline{text-decoration:overline}
326
+ .line-through{text-decoration:line-through}
327
+ .aqua{color:#00bfbf}
328
+ .aqua-background{background-color:#00fafa}
329
+ .black{color:#000}
330
+ .black-background{background-color:#000}
331
+ .blue{color:#0000bf}
332
+ .blue-background{background-color:#0000fa}
333
+ .fuchsia{color:#bf00bf}
334
+ .fuchsia-background{background-color:#fa00fa}
335
+ .gray{color:#606060}
336
+ .gray-background{background-color:#7d7d7d}
337
+ .green{color:#006000}
338
+ .green-background{background-color:#007d00}
339
+ .lime{color:#00bf00}
340
+ .lime-background{background-color:#00fa00}
341
+ .maroon{color:#600000}
342
+ .maroon-background{background-color:#7d0000}
343
+ .navy{color:#000060}
344
+ .navy-background{background-color:#00007d}
345
+ .olive{color:#606000}
346
+ .olive-background{background-color:#7d7d00}
347
+ .purple{color:#600060}
348
+ .purple-background{background-color:#7d007d}
349
+ .red{color:#bf0000}
350
+ .red-background{background-color:#fa0000}
351
+ .silver{color:#909090}
352
+ .silver-background{background-color:#bcbcbc}
353
+ .teal{color:#006060}
354
+ .teal-background{background-color:#007d7d}
355
+ .white{color:#bfbfbf}
356
+ .white-background{background-color:#fafafa}
357
+ .yellow{color:#bfbf00}
358
+ .yellow-background{background-color:#fafa00}
359
+ span.icon>.fa{cursor:default}
360
+ .admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;text-shadow:1px 1px 2px rgba(0,0,0,.5);cursor:default}
361
+ .admonitionblock td.icon .icon-note:before{content:"\f05a";color:#19407c}
362
+ .admonitionblock td.icon .icon-tip:before{content:"\f0eb";text-shadow:1px 1px 2px rgba(155,155,0,.8);color:#111}
363
+ .admonitionblock td.icon .icon-warning:before{content:"\f071";color:#bf6900}
364
+ .admonitionblock td.icon .icon-caution:before{content:"\f06d";color:#bf3400}
365
+ .admonitionblock td.icon .icon-important:before{content:"\f06a";color:#bf0000}
366
+ .conum[data-value]{display:inline-block;color:#fff!important;background-color:rgba(0,0,0,.8);-webkit-border-radius:100px;border-radius:100px;text-align:center;font-size:.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans","DejaVu Sans",sans-serif;font-style:normal;font-weight:bold}
367
+ .conum[data-value] *{color:#fff!important}
368
+ .conum[data-value]+b{display:none}
369
+ .conum[data-value]:after{content:attr(data-value)}
370
+ pre .conum[data-value]{position:relative;top:-.125em}
371
+ b.conum *{color:inherit!important}
372
+ .conum:not([data-value]):empty{display:none}
373
+ h1,h2{letter-spacing:-.01em}
374
+ dt,th.tableblock,td.content{text-rendering:optimizeLegibility}
375
+ p,td.content{letter-spacing:-.01em}
376
+ p strong,td.content strong{letter-spacing:-.005em}
377
+ p,blockquote,dt,td.content{font-size:1.0625rem}
378
+ p{margin-bottom:1.25rem}
379
+ .sidebarblock p,.sidebarblock dt,.sidebarblock td.content,p.tableblock{font-size:1em}
380
+ .exampleblock>.content{background-color:#fffef7;border-color:#e0e0dc;-webkit-box-shadow:0 1px 4px #e0e0dc;box-shadow:0 1px 4px #e0e0dc}
381
+ .print-only{display:none!important}
382
+ @media print{@page{margin:1.25cm .75cm}
383
+ *{-webkit-box-shadow:none!important;box-shadow:none!important;text-shadow:none!important}
384
+ a{color:inherit!important;text-decoration:underline!important}
385
+ a.bare,a[href^="#"],a[href^="mailto:"]{text-decoration:none!important}
386
+ a[href^="http:"]:not(.bare):after,a[href^="https:"]:not(.bare):after,a[href^="mailto:"]:not(.bare):after{content:"(" attr(href) ")";display:inline-block;font-size:.875em;padding-left:.25em}
387
+ abbr[title]:after{content:" (" attr(title) ")"}
388
+ pre,blockquote,tr,img{page-break-inside:avoid}
389
+ thead{display:table-header-group}
390
+ img{max-width:100%!important}
391
+ p,blockquote,dt,td.content{font-size:1em;orphans:3;widows:3}
392
+ h2,h3,#toctitle,.sidebarblock>.content>.title{page-break-after:avoid}
393
+ #toc,.sidebarblock,.exampleblock>.content{background:none!important}
394
+ #toc{border-bottom:1px solid #ddddd8!important;padding-bottom:0!important}
395
+ .sect1{padding-bottom:0!important}
396
+ .sect1+.sect1{border:0!important}
397
+ #header>h1:first-child{margin-top:1.25rem}
398
+ body.book #header{text-align:center}
399
+ body.book #header>h1:first-child{border:0!important;margin:2.5em 0 1em 0}
400
+ body.book #header .details{border:0!important;display:block;padding:0!important}
401
+ body.book #header .details span:first-child{margin-left:0!important}
402
+ body.book #header .details br{display:block}
403
+ body.book #header .details br+span:before{content:none!important}
404
+ body.book #toc{border:0!important;text-align:left!important;padding:0!important;margin:0!important}
405
+ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-break-before:always}
406
+ .listingblock code[data-lang]:before{display:block}
407
+ #footer{background:none!important;padding:0 .9375em}
408
+ #footer-text{color:rgba(0,0,0,.6)!important;font-size:.9em}
409
+ .hide-on-print{display:none!important}
410
+ .print-only{display:block!important}
411
+ .hide-for-print{display:none!important}
412
+ .show-for-print{display:inherit!important}}
413
+ </style>
414
+ <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.1.0/css/font-awesome.min.css">
415
+ <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/8.1/styles/github.min.css">
416
+ <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/8.1/highlight.min.js"></script>
417
+ <script>hljs.initHighlightingOnLoad()</script>
418
+ </head>
419
+ <body class="article toc2 toc-right">
420
+ <div id="header">
421
+ <h1><span class="icon"><i class="fa fa-cutlery"></i></span> Brine Cookbook</h1>
422
+ <div class="details">
423
+ <span id="author" class="author">Matt Whipple</span><br>
424
+ <span id="email" class="email"><a href="http://github.com/mwhipple">@mwhipple</a></span><br>
425
+ </div>
426
+ <div id="toc" class="toc2">
427
+ <div id="toctitle">Table of Contents</div>
428
+ <ul class="sectlevel1">
429
+ <li><a href="#_overview">Overview</a></li>
430
+ <li><a href="#__assurances">"Assurances"</a>
431
+ <ul class="sectlevel2">
432
+ <li><a href="#_context">Context</a></li>
433
+ <li><a href="#_solution">Solution</a></li>
434
+ <li><a href="#_recipe">Recipe</a></li>
435
+ </ul>
436
+ </li>
437
+ </ul>
438
+ </div>
439
+ </div>
440
+ <div id="content">
441
+ <div class="sect1">
442
+ <h2 id="_overview">Overview</h2>
443
+ <div class="sectionbody">
444
+ <div class="paragraph">
445
+ <p>The following are some recipes to address issues which may arise while using
446
+ Brine but are not considered part of Brine&#8217;s responsibility (at least presently).
447
+ Many of these are focused on simplicity and ease rather than robustness or elegance,
448
+ and modification to address specific cases should be expected.</p>
449
+ </div>
450
+ </div>
451
+ </div>
452
+ <div class="sect1">
453
+ <h2 id="__assurances">"Assurances"</h2>
454
+ <div class="sectionbody">
455
+ <div class="sect2">
456
+ <h3 id="_context">Context</h3>
457
+ <div class="paragraph">
458
+ <p>Ideally all tests should be as self-contained and isolated as possible;
459
+ when writing functional tests, however, there are cases where this isn&#8217;t
460
+ feasible or possible. In some cases a system depends on another external
461
+ system which is not a system that is under test and which (for whatever reason)
462
+ cannot be easily worked with. In white box testing such a system would likely be
463
+ represented by some form of test double, but this may be unfeasible and/or
464
+ undesirable when testing a deployed system.</p>
465
+ </div>
466
+ <div class="paragraph">
467
+ <p>An example of such a system is user/account management which often incurs
468
+ additional overhead to provision a new account. When testing a secured
469
+ system valid accounts are needed for representative testing, but provisioning
470
+ a new account may be difficult or outside the scope of the system that is being
471
+ actively tested. If tested functionality involves enacting account-wide changes
472
+ and the number of accounts is limited, then that is likely to unfortunately prevent
473
+ complete test isolation.</p>
474
+ </div>
475
+ </div>
476
+ <div class="sect2">
477
+ <h3 id="_solution">Solution</h3>
478
+ <div class="paragraph">
479
+ <p>In such cases a standard solution is to designate certain resources to be reused for
480
+ certain tests. These are analogous to the concept of "fixtures" in some test suites
481
+ though there may be slight differences in implementation and reliance on them.
482
+ Here the term "assurances" is used..primarily because it starts with <code>a</code> which lends
483
+ itself to relevant files being listed towards the beginning alphabetically in a given directory.</p>
484
+ </div>
485
+ <div class="paragraph">
486
+ <p>The goal of assurances is to specify conditions which are expected before other
487
+ tests are to be run. Preferably the dependent tests should also explicitly declare the
488
+ dependency but a significant solution for that is not established. Assurances therefore
489
+ validate that preconditions are met; ideally if such preconditions can be established
490
+ idempotently then the assurances can do so before the validation.</p>
491
+ </div>
492
+ <div class="sect3">
493
+ <h4 id="_assurances_are_not_tests">Assurances are NOT Tests</h4>
494
+ <div class="paragraph">
495
+ <p><strong>Assurances validate a state which is desired to be consistently retained within the
496
+ system rather than being changed</strong>. This means that they should <em>not</em> be used for tests
497
+ as that would require state changes, nor should they clean up after themselves (as that
498
+ would also imply a state change). If assurances are configured for a system which should
499
+ also be tested, then appropriate tests should exist (including those that may validate any
500
+ behavior relied upon by the assurance).</p>
501
+ </div>
502
+ </div>
503
+ <div class="sect3">
504
+ <h4 id="_consequences">Consequences</h4>
505
+ <div class="paragraph">
506
+ <p>As mentioned previously assertions help in cases where tests cannot be fully isolated,
507
+ and therefore some known state must be established and reused across tests (and such state
508
+ should <strong>not</strong> change). A practical reason for this is to allow for overlapping test executions.
509
+ If tests are not fully isolated, state is being changed, and test runs overlap, then tests
510
+ may fail non-deterministically due to one test run pulling the state out from another. This
511
+ in the simplest form can be a nuisance but it also effectively precludes the ability to speed
512
+ up test runs through the use of parallelism/asynchronicity.</p>
513
+ </div>
514
+ <div class="paragraph">
515
+ <p><em>TODO: Enumerate drawbacks</em></p>
516
+ </div>
517
+ </div>
518
+ </div>
519
+ <div class="sect2">
520
+ <h3 id="_recipe">Recipe</h3>
521
+ <div class="paragraph">
522
+ <p>This can be done using standard cucumber tags. Assurances can be defined in designated
523
+ <code>assure_*.feature</code> files where each Feature is appropriately tagged:</p>
524
+ </div>
525
+ <div class="listingblock">
526
+ <div class="content">
527
+ <pre class="highlightjs highlight"><code class="language-gherkin" data-lang="gherkin">@assure
528
+ Feature: Some preconditions are verified...</code></pre>
529
+ </div>
530
+ </div>
531
+ <div class="paragraph">
532
+ <p>And then a Rake task is added to run those tagged features:</p>
533
+ </div>
534
+ <div class="listingblock">
535
+ <div class="content">
536
+ <pre class="highlightjs highlight"><code class="language-ruby" data-lang="ruby">Cucumber::Rake::Task.new(:assure) do |t|
537
+ t.cucumber_opts = "#{ENV['CUCUMBER_OPTS']} --tags @assure"
538
+ end</code></pre>
539
+ </div>
540
+ </div>
541
+ <div class="paragraph">
542
+ <p>The Rake task that runs the other tests then depends on that task:</p>
543
+ </div>
544
+ <div class="listingblock">
545
+ <div class="content">
546
+ <pre class="highlightjs highlight"><code class="language-ruby" data-lang="ruby">task :invoke_cuke =&gt; [:assure] do
547
+ #Run cucumber, potentially in parallel and likely with --tags `@assure`
548
+ end</code></pre>
549
+ </div>
550
+ </div>
551
+ <div class="paragraph">
552
+ <p>This approach tests preconditions and will avoid running the rest of the tests if they
553
+ are not (relying on standard Rake behavior). The assurances can also be run with different
554
+ Cucumber behavior so that the full test suite can be more stochastic
555
+ (randomized/non-serialized) while the assurances can be more controlled.</p>
556
+ </div>
557
+ </div>
558
+ </div>
559
+ </div>
560
+ </div>
561
+ <div id="footer">
562
+ <div id="footer-text">
563
+ Last updated 2017-10-25 10:06:13 -04:00
564
+ </div>
565
+ </div>
566
+ </body>
567
+ </html>
@@ -0,0 +1,6 @@
1
+ #Mon Sep 18 08:41:45 EDT 2017
2
+ distributionBase=GRADLE_USER_HOME
3
+ distributionPath=wrapper/dists
4
+ zipStoreBase=GRADLE_USER_HOME
5
+ zipStorePath=wrapper/dists
6
+ distributionUrl=https\://services.gradle.org/distributions/gradle-4.0.1-bin.zip