From 01851a491ce8ddb854a7c76540065c4761c38bcd Mon Sep 17 00:00:00 2001
From: Marcin Grzejszczak <marcin@grzejszczak.pl>
Date: Wed, 7 Aug 2019 23:14:13 +0200
Subject: [PATCH] Sync docs from master to gh-pages

---
 ...w-consumer-cdc-external-consumer.png.cache |     1 +
 ...w-consumer-cdc-external-producer.png.cache |     1 +
 .../flows-provider-non-jvm-consumer.png.cache |     1 +
 .../flows-provider-non-jvm-producer.png.cache |     1 +
 ...lows-provider-rest-docs-producer.png.cache |     1 +
 ...getting-started-cdc-client-final.png.cache |     1 +
 .../getting-started-cdc-client.png.cache      |     1 +
 .../getting-started-cdc-server.png.cache      |     1 +
 .../getting-started-three-second.png.cache    |     1 +
 .../diagram/how-to-common-repo.png.cache      |     1 +
 .../.asciidoctor/diagram/rest-docs.png.cache  |     1 +
 reference/html/README.html                    |   102 +-
 reference/html/advanced.html                  |  1197 ++
 reference/html/docker-project.html            |   585 +
 reference/html/documentation-overview.html    |   372 +
 reference/html/getting-started.html           |  2370 +++
 reference/html/gradle-project.html            |   862 +
 reference/html/howto.html                     |  2508 +++
 ...verview-consumer-cdc-external-consumer.png |   Bin 0 -> 38637 bytes
 ...verview-consumer-cdc-external-producer.png |   Bin 0 -> 78892 bytes
 .../flows-provider-non-jvm-consumer.png       |   Bin 0 -> 36164 bytes
 .../flows-provider-non-jvm-producer.png       |   Bin 0 -> 45592 bytes
 .../flows-provider-rest-docs-producer.png     |   Bin 0 -> 38280 bytes
 .../getting-started-cdc-client-final.png      |   Bin 0 -> 29859 bytes
 .../images/getting-started-cdc-client.png     |   Bin 0 -> 73373 bytes
 .../images/getting-started-cdc-server.png     |   Bin 0 -> 39245 bytes
 .../images/getting-started-three-second.png   |   Bin 0 -> 41948 bytes
 reference/html/images/how-to-common-repo.png  |   Bin 0 -> 104779 bytes
 reference/html/images/rest-docs.png           |   Bin 0 -> 55044 bytes
 reference/html/index.html                     | 15005 +---------------
 reference/html/legal.html                     |   121 +
 reference/html/maven-project.html             |  1039 ++
 reference/html/project-features.html          |  8980 +++++++++
 reference/html/sagan-boot.html                |    73 +-
 reference/html/sagan-index.html               |    32 +-
 reference/html/using.html                     |  1217 ++
 ...w-consumer-cdc-external-consumer.png.cache |     1 +
 ...w-consumer-cdc-external-producer.png.cache |     1 +
 .../flows-provider-non-jvm-consumer.png.cache |     1 +
 .../flows-provider-non-jvm-producer.png.cache |     1 +
 ...lows-provider-rest-docs-producer.png.cache |     1 +
 ...getting-started-cdc-client-final.png.cache |     1 +
 .../getting-started-cdc-client.png.cache      |     1 +
 .../getting-started-cdc-server.png.cache      |     1 +
 .../getting-started-three-second.png.cache    |     1 +
 .../diagram/how-to-common-repo.png.cache      |     1 +
 .../.asciidoctor/diagram/rest-docs.png.cache  |     1 +
 ...verview-consumer-cdc-external-consumer.png |   Bin 0 -> 38637 bytes
 ...verview-consumer-cdc-external-producer.png |   Bin 0 -> 78892 bytes
 .../flows-provider-non-jvm-consumer.png       |   Bin 0 -> 36164 bytes
 .../flows-provider-non-jvm-producer.png       |   Bin 0 -> 45592 bytes
 .../flows-provider-rest-docs-producer.png     |   Bin 0 -> 38280 bytes
 .../getting-started-cdc-client-final.png      |   Bin 0 -> 29859 bytes
 .../images/getting-started-cdc-client.png     |   Bin 0 -> 73373 bytes
 .../images/getting-started-cdc-server.png     |   Bin 0 -> 39245 bytes
 .../images/getting-started-three-second.png   |   Bin 0 -> 41948 bytes
 .../htmlsingle/images/how-to-common-repo.png  |   Bin 0 -> 104779 bytes
 reference/htmlsingle/images/rest-docs.png     |   Bin 0 -> 55044 bytes
 reference/htmlsingle/index.html               | 14911 +++++++++++++++
 .../apidocs/allclasses-frame.html             |     2 +-
 .../apidocs/allclasses-index.html             |   225 +
 .../apidocs/allclasses-noframe.html           |     2 +-
 .../apidocs/allclasses.html                   |    38 +
 .../apidocs/allpackages-index.html            |   172 +
 .../apidocs/constant-values.html              |     2 +-
 .../apidocs/deprecated-list.html              |     2 +-
 .../apidocs/element-list                      |     2 +
 .../apidocs/help-doc.html                     |     2 +-
 .../apidocs/index-all.html                    |     2 +-
 .../apidocs/index.html                        |     2 +-
 .../apidocs/jquery/external/jquery/jquery.js  | 10364 +++++++++++
 .../images/ui-bg_flat_0_aaaaaa_40x100.png     |   Bin 0 -> 212 bytes
 .../images/ui-bg_flat_75_ffffff_40x100.png    |   Bin 0 -> 208 bytes
 .../images/ui-bg_glass_55_fbf9ee_1x400.png    |   Bin 0 -> 335 bytes
 .../images/ui-bg_glass_65_ffffff_1x400.png    |   Bin 0 -> 207 bytes
 .../images/ui-bg_glass_75_dadada_1x400.png    |   Bin 0 -> 262 bytes
 .../images/ui-bg_glass_75_e6e6e6_1x400.png    |   Bin 0 -> 262 bytes
 .../images/ui-bg_glass_95_fef1ec_1x400.png    |   Bin 0 -> 332 bytes
 .../ui-bg_highlight-soft_75_cccccc_1x100.png  |   Bin 0 -> 280 bytes
 .../jquery/images/ui-icons_222222_256x240.png |   Bin 0 -> 6922 bytes
 .../jquery/images/ui-icons_2e83ff_256x240.png |   Bin 0 -> 4549 bytes
 .../jquery/images/ui-icons_454545_256x240.png |   Bin 0 -> 6992 bytes
 .../jquery/images/ui-icons_888888_256x240.png |   Bin 0 -> 6999 bytes
 .../jquery/images/ui-icons_cd0a0a_256x240.png |   Bin 0 -> 4549 bytes
 .../apidocs/jquery/jquery-3.3.1.js            | 10364 +++++++++++
 .../apidocs/jquery/jquery-migrate-3.0.1.js    |   628 +
 .../apidocs/jquery/jquery-ui.css              |   544 +
 .../apidocs/jquery/jquery-ui.js               |  2610 +++
 .../apidocs/jquery/jquery-ui.min.css          |     7 +
 .../apidocs/jquery/jquery-ui.min.js           |     7 +
 .../apidocs/jquery/jquery-ui.structure.css    |   152 +
 .../jquery/jquery-ui.structure.min.css        |     5 +
 .../jquery/jszip-utils/dist/jszip-utils-ie.js |    56 +
 .../jszip-utils/dist/jszip-utils-ie.min.js    |    10 +
 .../jquery/jszip-utils/dist/jszip-utils.js    |   118 +
 .../jszip-utils/dist/jszip-utils.min.js       |    10 +
 .../apidocs/jquery/jszip/dist/jszip.js        | 11623 ++++++++++++
 .../apidocs/jquery/jszip/dist/jszip.min.js    |    15 +
 .../apidocs/member-search-index.js            |     1 +
 .../apidocs/member-search-index.zip           |   Bin 0 -> 773 bytes
 .../maven/verifier/BaseClassMapping.html      |     2 +-
 .../contract/maven/verifier/ConvertMojo.html  |     2 +-
 .../maven/verifier/GenerateStubsMojo.html     |     2 +-
 .../maven/verifier/GenerateTestsMojo.html     |     2 +-
 .../contract/maven/verifier/HelpMojo.html     |     2 +-
 .../maven/verifier/PushStubsToScmMojo.html    |     2 +-
 .../contract/maven/verifier/RunMojo.html      |     2 +-
 .../verifier/class-use/BaseClassMapping.html  |     2 +-
 .../maven/verifier/class-use/ConvertMojo.html |     2 +-
 .../verifier/class-use/GenerateStubsMojo.html |     2 +-
 .../verifier/class-use/GenerateTestsMojo.html |     2 +-
 .../maven/verifier/class-use/HelpMojo.html    |     2 +-
 .../class-use/PushStubsToScmMojo.html         |     2 +-
 .../maven/verifier/class-use/RunMojo.html     |     2 +-
 .../maven/verifier/package-frame.html         |     2 +-
 .../maven/verifier/package-summary.html       |     2 +-
 .../contract/maven/verifier/package-tree.html |     2 +-
 .../contract/maven/verifier/package-use.html  |     2 +-
 .../AetherStubDownloaderFactory.html          |     2 +-
 .../verifier/stubrunner/LocalStubRunner.html  |     2 +-
 .../verifier/stubrunner/RemoteStubRunner.html |     2 +-
 .../AetherStubDownloaderFactory.html          |     2 +-
 .../stubrunner/class-use/LocalStubRunner.html |     2 +-
 .../class-use/RemoteStubRunner.html           |     2 +-
 .../verifier/stubrunner/package-frame.html    |     2 +-
 .../verifier/stubrunner/package-summary.html  |     2 +-
 .../verifier/stubrunner/package-tree.html     |     2 +-
 .../verifier/stubrunner/package-use.html      |     2 +-
 .../apidocs/overview-frame.html               |     2 +-
 .../apidocs/overview-summary.html             |     2 +-
 .../apidocs/overview-tree.html                |     2 +-
 .../apidocs/package-search-index.js           |     1 +
 .../apidocs/package-search-index.zip          |   Bin 0 -> 273 bytes
 .../apidocs/resources/glass.png               |   Bin 0 -> 499 bytes
 .../apidocs/resources/x.png                   |   Bin 0 -> 394 bytes
 .../apidocs/search.js                         |   329 +
 .../apidocs/stylesheet.css                    |   492 +-
 .../apidocs/type-search-index.js              |     1 +
 .../apidocs/type-search-index.zip             |   Bin 0 -> 375 bytes
 .../checkstyle.html                           |   700 +-
 .../checkstyle.rss                            |    12 +-
 .../convert-mojo.html                         |     8 +-
 .../generateStubs-mojo.html                   |    31 +-
 143 files changed, 72495 insertions(+), 15502 deletions(-)
 create mode 100644 reference/html/.asciidoctor/diagram/flow-overview-consumer-cdc-external-consumer.png.cache
 create mode 100644 reference/html/.asciidoctor/diagram/flow-overview-consumer-cdc-external-producer.png.cache
 create mode 100644 reference/html/.asciidoctor/diagram/flows-provider-non-jvm-consumer.png.cache
 create mode 100644 reference/html/.asciidoctor/diagram/flows-provider-non-jvm-producer.png.cache
 create mode 100644 reference/html/.asciidoctor/diagram/flows-provider-rest-docs-producer.png.cache
 create mode 100644 reference/html/.asciidoctor/diagram/getting-started-cdc-client-final.png.cache
 create mode 100644 reference/html/.asciidoctor/diagram/getting-started-cdc-client.png.cache
 create mode 100644 reference/html/.asciidoctor/diagram/getting-started-cdc-server.png.cache
 create mode 100644 reference/html/.asciidoctor/diagram/getting-started-three-second.png.cache
 create mode 100644 reference/html/.asciidoctor/diagram/how-to-common-repo.png.cache
 create mode 100644 reference/html/.asciidoctor/diagram/rest-docs.png.cache
 create mode 100644 reference/html/advanced.html
 create mode 100644 reference/html/docker-project.html
 create mode 100644 reference/html/documentation-overview.html
 create mode 100644 reference/html/getting-started.html
 create mode 100644 reference/html/gradle-project.html
 create mode 100644 reference/html/howto.html
 create mode 100644 reference/html/images/flow-overview-consumer-cdc-external-consumer.png
 create mode 100644 reference/html/images/flow-overview-consumer-cdc-external-producer.png
 create mode 100644 reference/html/images/flows-provider-non-jvm-consumer.png
 create mode 100644 reference/html/images/flows-provider-non-jvm-producer.png
 create mode 100644 reference/html/images/flows-provider-rest-docs-producer.png
 create mode 100644 reference/html/images/getting-started-cdc-client-final.png
 create mode 100644 reference/html/images/getting-started-cdc-client.png
 create mode 100644 reference/html/images/getting-started-cdc-server.png
 create mode 100644 reference/html/images/getting-started-three-second.png
 create mode 100644 reference/html/images/how-to-common-repo.png
 create mode 100644 reference/html/images/rest-docs.png
 create mode 100644 reference/html/legal.html
 create mode 100644 reference/html/maven-project.html
 create mode 100644 reference/html/project-features.html
 create mode 100644 reference/html/using.html
 create mode 100644 reference/htmlsingle/.asciidoctor/diagram/flow-overview-consumer-cdc-external-consumer.png.cache
 create mode 100644 reference/htmlsingle/.asciidoctor/diagram/flow-overview-consumer-cdc-external-producer.png.cache
 create mode 100644 reference/htmlsingle/.asciidoctor/diagram/flows-provider-non-jvm-consumer.png.cache
 create mode 100644 reference/htmlsingle/.asciidoctor/diagram/flows-provider-non-jvm-producer.png.cache
 create mode 100644 reference/htmlsingle/.asciidoctor/diagram/flows-provider-rest-docs-producer.png.cache
 create mode 100644 reference/htmlsingle/.asciidoctor/diagram/getting-started-cdc-client-final.png.cache
 create mode 100644 reference/htmlsingle/.asciidoctor/diagram/getting-started-cdc-client.png.cache
 create mode 100644 reference/htmlsingle/.asciidoctor/diagram/getting-started-cdc-server.png.cache
 create mode 100644 reference/htmlsingle/.asciidoctor/diagram/getting-started-three-second.png.cache
 create mode 100644 reference/htmlsingle/.asciidoctor/diagram/how-to-common-repo.png.cache
 create mode 100644 reference/htmlsingle/.asciidoctor/diagram/rest-docs.png.cache
 create mode 100644 reference/htmlsingle/images/flow-overview-consumer-cdc-external-consumer.png
 create mode 100644 reference/htmlsingle/images/flow-overview-consumer-cdc-external-producer.png
 create mode 100644 reference/htmlsingle/images/flows-provider-non-jvm-consumer.png
 create mode 100644 reference/htmlsingle/images/flows-provider-non-jvm-producer.png
 create mode 100644 reference/htmlsingle/images/flows-provider-rest-docs-producer.png
 create mode 100644 reference/htmlsingle/images/getting-started-cdc-client-final.png
 create mode 100644 reference/htmlsingle/images/getting-started-cdc-client.png
 create mode 100644 reference/htmlsingle/images/getting-started-cdc-server.png
 create mode 100644 reference/htmlsingle/images/getting-started-three-second.png
 create mode 100644 reference/htmlsingle/images/how-to-common-repo.png
 create mode 100644 reference/htmlsingle/images/rest-docs.png
 create mode 100644 reference/htmlsingle/index.html
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/allclasses-index.html
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/allclasses.html
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/allpackages-index.html
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/element-list
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/external/jquery/jquery.js
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_flat_0_aaaaaa_40x100.png
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_flat_75_ffffff_40x100.png
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_glass_55_fbf9ee_1x400.png
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_glass_65_ffffff_1x400.png
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_glass_75_dadada_1x400.png
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_glass_75_e6e6e6_1x400.png
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_glass_95_fef1ec_1x400.png
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_highlight-soft_75_cccccc_1x100.png
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-icons_222222_256x240.png
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-icons_2e83ff_256x240.png
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-icons_454545_256x240.png
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-icons_888888_256x240.png
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-icons_cd0a0a_256x240.png
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-3.3.1.js
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-migrate-3.0.1.js
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.css
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.js
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.min.css
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.min.js
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.structure.css
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.structure.min.css
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/jszip-utils/dist/jszip-utils-ie.js
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/jszip-utils/dist/jszip-utils-ie.min.js
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/jszip-utils/dist/jszip-utils.js
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/jszip-utils/dist/jszip-utils.min.js
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/jszip/dist/jszip.js
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/jquery/jszip/dist/jszip.min.js
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/member-search-index.js
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/member-search-index.zip
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/package-search-index.js
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/package-search-index.zip
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/resources/glass.png
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/resources/x.png
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/search.js
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/type-search-index.js
 create mode 100644 spring-cloud-contract-maven-plugin/apidocs/type-search-index.zip

diff --git a/reference/html/.asciidoctor/diagram/flow-overview-consumer-cdc-external-consumer.png.cache b/reference/html/.asciidoctor/diagram/flow-overview-consumer-cdc-external-consumer.png.cache
new file mode 100644
index 0000000000..ca8988965c
--- /dev/null
+++ b/reference/html/.asciidoctor/diagram/flow-overview-consumer-cdc-external-consumer.png.cache
@@ -0,0 +1 @@
+{"checksum":"23a7e5a52b04e1a55f2d102255d7ea04","width":886,"height":676}
\ No newline at end of file
diff --git a/reference/html/.asciidoctor/diagram/flow-overview-consumer-cdc-external-producer.png.cache b/reference/html/.asciidoctor/diagram/flow-overview-consumer-cdc-external-producer.png.cache
new file mode 100644
index 0000000000..a17e22fcb1
--- /dev/null
+++ b/reference/html/.asciidoctor/diagram/flow-overview-consumer-cdc-external-producer.png.cache
@@ -0,0 +1 @@
+{"checksum":"c9ffba1bc9383435e35a7973e5641dd8","width":1213,"height":1341}
\ No newline at end of file
diff --git a/reference/html/.asciidoctor/diagram/flows-provider-non-jvm-consumer.png.cache b/reference/html/.asciidoctor/diagram/flows-provider-non-jvm-consumer.png.cache
new file mode 100644
index 0000000000..2f99cba6c4
--- /dev/null
+++ b/reference/html/.asciidoctor/diagram/flows-provider-non-jvm-consumer.png.cache
@@ -0,0 +1 @@
+{"checksum":"30b3d3322b3ecb24a6c5346a8571ba98","width":815,"height":618}
\ No newline at end of file
diff --git a/reference/html/.asciidoctor/diagram/flows-provider-non-jvm-producer.png.cache b/reference/html/.asciidoctor/diagram/flows-provider-non-jvm-producer.png.cache
new file mode 100644
index 0000000000..5a3310d3c6
--- /dev/null
+++ b/reference/html/.asciidoctor/diagram/flows-provider-non-jvm-producer.png.cache
@@ -0,0 +1 @@
+{"checksum":"37241bc45c73dbad7383a4733a05d559","width":930,"height":810}
\ No newline at end of file
diff --git a/reference/html/.asciidoctor/diagram/flows-provider-rest-docs-producer.png.cache b/reference/html/.asciidoctor/diagram/flows-provider-rest-docs-producer.png.cache
new file mode 100644
index 0000000000..2d6b2f9d08
--- /dev/null
+++ b/reference/html/.asciidoctor/diagram/flows-provider-rest-docs-producer.png.cache
@@ -0,0 +1 @@
+{"checksum":"b137ec966db7960885422f991695d28f","width":783,"height":677}
\ No newline at end of file
diff --git a/reference/html/.asciidoctor/diagram/getting-started-cdc-client-final.png.cache b/reference/html/.asciidoctor/diagram/getting-started-cdc-client-final.png.cache
new file mode 100644
index 0000000000..eac3cd74e2
--- /dev/null
+++ b/reference/html/.asciidoctor/diagram/getting-started-cdc-client-final.png.cache
@@ -0,0 +1 @@
+{"checksum":"a46f733654d99c8861184f0e4e04bb95","width":590,"height":685}
\ No newline at end of file
diff --git a/reference/html/.asciidoctor/diagram/getting-started-cdc-client.png.cache b/reference/html/.asciidoctor/diagram/getting-started-cdc-client.png.cache
new file mode 100644
index 0000000000..89ce0d961d
--- /dev/null
+++ b/reference/html/.asciidoctor/diagram/getting-started-cdc-client.png.cache
@@ -0,0 +1 @@
+{"checksum":"b1418561d3b01d5d71885b4b7bb1be93","width":1138,"height":1223}
\ No newline at end of file
diff --git a/reference/html/.asciidoctor/diagram/getting-started-cdc-server.png.cache b/reference/html/.asciidoctor/diagram/getting-started-cdc-server.png.cache
new file mode 100644
index 0000000000..0b7b2d7806
--- /dev/null
+++ b/reference/html/.asciidoctor/diagram/getting-started-cdc-server.png.cache
@@ -0,0 +1 @@
+{"checksum":"7a8cb19e9d604071d61e4aa9201ee623","width":688,"height":903}
\ No newline at end of file
diff --git a/reference/html/.asciidoctor/diagram/getting-started-three-second.png.cache b/reference/html/.asciidoctor/diagram/getting-started-three-second.png.cache
new file mode 100644
index 0000000000..3e5f4a8ff5
--- /dev/null
+++ b/reference/html/.asciidoctor/diagram/getting-started-three-second.png.cache
@@ -0,0 +1 @@
+{"checksum":"27396daead141eee677aa6311403d175","width":986,"height":704}
\ No newline at end of file
diff --git a/reference/html/.asciidoctor/diagram/how-to-common-repo.png.cache b/reference/html/.asciidoctor/diagram/how-to-common-repo.png.cache
new file mode 100644
index 0000000000..c23499f956
--- /dev/null
+++ b/reference/html/.asciidoctor/diagram/how-to-common-repo.png.cache
@@ -0,0 +1 @@
+{"checksum":"89bbfd25e4c214245543ed34208e2afa","width":1588,"height":1421}
\ No newline at end of file
diff --git a/reference/html/.asciidoctor/diagram/rest-docs.png.cache b/reference/html/.asciidoctor/diagram/rest-docs.png.cache
new file mode 100644
index 0000000000..74da30c065
--- /dev/null
+++ b/reference/html/.asciidoctor/diagram/rest-docs.png.cache
@@ -0,0 +1 @@
+{"checksum":"e3500a52c420af0a5337450779a25536","width":1237,"height":835}
\ No newline at end of file
diff --git a/reference/html/README.html b/reference/html/README.html
index 3dfbe5ed6d..2e5526be54 100644
--- a/reference/html/README.html
+++ b/reference/html/README.html
@@ -100,7 +100,7 @@ $(addBlockSwitches);
 <li><a href="#_spring_cloud_contract_workshops">Spring Cloud Contract workshops</a></li>
 </ul>
 </li>
-<li><a href="#_documentation">Documentation</a></li>
+<li><a href="#_project_page">Project page</a></li>
 <li><a href="#_contributing">Contributing</a>
 <ul class="sectlevel2">
 <li><a href="#_sign_the_contributor_license_agreement">Sign the Contributor License Agreement</a></li>
@@ -110,7 +110,7 @@ $(addBlockSwitches);
 <li><a href="#_ide_setup">IDE setup</a></li>
 </ul>
 </li>
-<li><a href="#_how_to_build_it">How to build it</a>
+<li><a href="#_how_to_build_spring_cloud_contract">How to Build Spring Cloud Contract</a>
 <ul class="sectlevel2">
 <li><a href="#_project_structure">Project structure</a></li>
 <li><a href="#_commands">Commands</a></li>
@@ -121,32 +121,13 @@ $(addBlockSwitches);
 </div>
 </div>
 <div id="content">
-<div id="preamble">
-<div class="sectionbody">
-<div class="imageblock">
-<div class="content">
-<a class="image" href="https://gitter.im/spring-cloud/spring-cloud-contract?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge"><img src="https://badges.gitter.im/Join%20Chat.svg" alt="Gitter"></a>
-</div>
-</div>
-<div class="imageblock">
-<div class="content">
-<a class="image" href="https://codecov.io/gh/spring-cloud/spring-cloud-contract"><img src="https://codecov.io/gh/spring-cloud/spring-cloud-contract/branch/master/graph/badge.svg" alt="codecov"></a>
-</div>
-</div>
-<div class="imageblock">
-<div class="content">
-<a class="image" href="https://circleci.com/gh/spring-cloud/spring-cloud-contract"><img src="https://circleci.com/gh/spring-cloud/spring-cloud-contract.svg?style=svg" alt="CircleCI"></a>
-</div>
-</div>
-</div>
-</div>
 <div class="sect1">
 <h2 id="_spring_cloud_contract"><a class="link" href="#_spring_cloud_contract">Spring Cloud Contract</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>You always need confidence when pushing new features into a new application or service in
-a distributed system. To that end, this project provides support for Consumer-driven
-Contracts and service schemas in Spring applications, covering a range of options for
+a distributed system. To that end, this project provides support for consumer-driven
+contracts and service schemas in Spring applications, covering a range of options for
 writing tests, publishing them as assets, and asserting that a contract is kept by
 producers and consumers&#8201;&#8212;&#8201;for both HTTP and message-based interactions.</p>
 </div>
@@ -161,11 +142,10 @@ workshops under
 </div>
 </div>
 <div class="sect1">
-<h2 id="_documentation"><a class="link" href="#_documentation">Documentation</a></h2>
+<h2 id="_project_page"><a class="link" href="#_project_page">Project page</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
-<p>You can read more about Spring Cloud Contract Verifier by reading the
-{documentation_url}[docs]</p>
+<p>You can read more about Spring Cloud Contract by going to <a href="https://spring.io/projects/spring-cloud-contract">the project page</a></p>
 </div>
 </div>
 </div>
@@ -476,7 +456,7 @@ Remember to set the <code>Scan Scope</code> to <code>All sources</code> since we
 </div>
 </div>
 <div class="sect1">
-<h2 id="_how_to_build_it"><a class="link" href="#_how_to_build_it">How to build it</a></h2>
+<h2 id="_how_to_build_spring_cloud_contract"><a class="link" href="#_how_to_build_spring_cloud_contract">How to Build Spring Cloud Contract</a></h2>
 <div class="sectionbody">
 <div class="admonitionblock important">
 <table>
@@ -486,9 +466,9 @@ Remember to set the <code>Scan Scope</code> to <code>All sources</code> since we
 </td>
 <td class="content">
 You need to have all the necessary Groovy plugins
- installed for your IDE to properly resolve the sources. For example in
- Intellij IDEA having both Eclipse Groovy Compiler Plugin &amp; GMavenPlus Intellij Plugin
- results in properly imported project.
+installed for your IDE to properly resolve the sources. For example, in
+Intellij IDEA, having both the Eclipse Groovy Compiler Plugin and the GMavenPlus Intellij
+Plugin results in properly imported project.
 </td>
 </tr>
 </table>
@@ -513,7 +493,7 @@ have Docker installed.
 <i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
-If you want to run the build in offline mode, you have to have Maven 3.5.2+ installed.
+If you want to run the build in offline mode, you must have Maven 3.5.2+ installed.
 </td>
 </tr>
 </table>
@@ -521,7 +501,7 @@ If you want to run the build in offline mode, you have to have Maven 3.5.2+ inst
 <div class="sect2">
 <h3 id="_project_structure"><a class="link" href="#_project_structure">Project structure</a></h3>
 <div class="paragraph">
-<p>Here you can find the Spring Cloud Contract folder structure</p>
+<p>The following listing shows the Spring Cloud Contract folder structure:</p>
 </div>
 <div class="listingblock">
 <div class="content">
@@ -541,52 +521,55 @@ If you want to run the build in offline mode, you have to have Maven 3.5.2+ inst
 └── tests</code></pre>
 </div>
 </div>
+<div class="paragraph">
+<p>The following list describes each of the top-level folders in the project structure:</p>
+</div>
 <div class="ulist">
 <ul>
 <li>
-<p><code>config</code> - folder contains setup for Spring Cloud Release Tools automated release process</p>
+<p><code>config</code>: Folder contains setup for Spring Cloud Release Tools automated release process</p>
 </li>
 <li>
-<p><code>docker</code> - folder contains docker images</p>
+<p><code>docker</code>: Folder contains docker images</p>
 </li>
 <li>
-<p><code>samples</code> - folder contains test samples together with standalone ones used also to build documentation</p>
+<p><code>samples</code>: Folder contains test samples together with standalone ones used also to build documentation</p>
 </li>
 <li>
-<p><code>scripts</code> - contains scripts to build and test <code>Spring Cloud Contract</code> with Maven, Gradle and standalone projects</p>
+<p><code>scripts</code>: Contains scripts to build and test <code>Spring Cloud Contract</code> with Maven, Gradle and standalone projects</p>
 </li>
 <li>
-<p><code>specs</code> - contains specifications for the Contract DSL.</p>
+<p><code>specs</code>: Contains specifications for the Contract DSL.</p>
 </li>
 <li>
-<p><code>spring-cloud-contract-dependencies</code> - contains Spring Cloud Contract BOM</p>
+<p><code>spring-cloud-contract-dependencies</code>: Contains Spring Cloud Contract BOM</p>
 </li>
 <li>
-<p><code>spring-cloud-contract-shade</code> - shaded dependencies used by the plugins</p>
+<p><code>spring-cloud-contract-shade</code>: Shaded dependencies used by the plugins</p>
 </li>
 <li>
-<p><code>spring-cloud-contract-starters</code> - contains Spring Cloud Contract Starters</p>
+<p><code>spring-cloud-contract-starters</code>: Contains Spring Cloud Contract Starters</p>
 </li>
 <li>
-<p><code>spring-cloud-contract-spec</code> - contains specification modules (contains concept of a Contract)</p>
+<p><code>spring-cloud-contract-spec</code>: Contains specification modules (contains concept of a Contract)</p>
 </li>
 <li>
-<p><code>spring-cloud-contract-stub-runner</code> - contains Stub Runner related modules</p>
+<p><code>spring-cloud-contract-stub-runner</code>: Contains Stub Runner related modules</p>
 </li>
 <li>
-<p><code>spring-cloud-contract-stub-runner-boot</code> - contains Stub Runner Boot app</p>
+<p><code>spring-cloud-contract-stub-runner-boot</code>: Contains Stub Runner Boot app</p>
 </li>
 <li>
-<p><code>spring-cloud-contract-tools</code> - Gradle and Maven plugin for <code>Spring Cloud Contract Verifier</code></p>
+<p><code>spring-cloud-contract-tools</code>: Gradle and Maven plugin for <code>Spring Cloud Contract Verifier</code></p>
 </li>
 <li>
-<p><code>spring-cloud-contract-verifier</code> - core of the <code>Spring Cloud Contract Verifier</code> functionality</p>
+<p><code>spring-cloud-contract-verifier</code>: Core of the <code>Spring Cloud Contract Verifier</code> functionality</p>
 </li>
 <li>
-<p><code>spring-cloud-contract-wiremock</code> - all WireMock related functionality</p>
+<p><code>spring-cloud-contract-wiremock</code>: All WireMock related functionality</p>
 </li>
 <li>
-<p><code>tests</code> - integration tests for different messaging technologies</p>
+<p><code>tests</code>: Integration tests for different messaging technologies</p>
 </li>
 </ul>
 </div>
@@ -594,7 +577,8 @@ If you want to run the build in offline mode, you have to have Maven 3.5.2+ inst
 <div class="sect2">
 <h3 id="_commands"><a class="link" href="#_commands">Commands</a></h3>
 <div class="paragraph">
-<p>To build the core functionality together with Maven Plugin you can run</p>
+<p>To build the core functionality together with the Maven Plugin, you can run the following
+command:</p>
 </div>
 <div class="listingblock">
 <div class="content">
@@ -602,11 +586,12 @@ If you want to run the build in offline mode, you have to have Maven 3.5.2+ inst
 </div>
 </div>
 <div class="paragraph">
-<p>Calling that function will build core, Maven plugin, Gradle plugin and run end to end tests on the
-standalone samples in proper order (both for Maven and Gradle).</p>
+<p>Calling that function builds the core, the Maven plugin, and the Gradle plugin and runs
+end-to_end tests on the
+standalone samples in the proper order (both for Maven and Gradle).</p>
 </div>
 <div class="paragraph">
-<p>To build the Gradle Plugin only</p>
+<p>To build only the Gradle Plugin, you can run the following commands:</p>
 </div>
 <div class="listingblock">
 <div class="content">
@@ -618,10 +603,11 @@ standalone samples in proper order (both for Maven and Gradle).</p>
 <div class="sect2">
 <h3 id="_helpful_scripts"><a class="link" href="#_helpful_scripts">Helpful scripts</a></h3>
 <div class="paragraph">
-<p>We&#8217;re providing a couple of helpful scripts to build the project.</p>
+<p>We provide a couple of helpful scripts to build the project.</p>
 </div>
 <div class="paragraph">
-<p>To build the project in parallel (by default uses 4 cores but you can change it)</p>
+<p>To build the project in parallel (by default, it uses four cores, but you can change it),
+run the following command:</p>
 </div>
 <div class="listingblock">
 <div class="content">
@@ -629,7 +615,7 @@ standalone samples in proper order (both for Maven and Gradle).</p>
 </div>
 </div>
 <div class="paragraph">
-<p>and with 8 cores</p>
+<p>To use eight 8 cores, run thke following command:</p>
 </div>
 <div class="listingblock">
 <div class="content">
@@ -637,7 +623,8 @@ standalone samples in proper order (both for Maven and Gradle).</p>
 </div>
 </div>
 <div class="paragraph">
-<p>To build the project without any integration tests (by default uses 1 core)</p>
+<p>To build the project without any integration tests (by default, this uses one core), run
+the following command:</p>
 </div>
 <div class="listingblock">
 <div class="content">
@@ -645,7 +632,7 @@ standalone samples in proper order (both for Maven and Gradle).</p>
 </div>
 </div>
 <div class="paragraph">
-<p>and with 8 cores</p>
+<p>To use eight cores, run the following command:</p>
 </div>
 <div class="listingblock">
 <div class="content">
@@ -653,7 +640,8 @@ standalone samples in proper order (both for Maven and Gradle).</p>
 </div>
 </div>
 <div class="paragraph">
-<p>To generate the documentation (both the root one and the maven plugin one)</p>
+<p>To generate the documentation (for both the root project and the maven plugin), run the
+following command:</p>
 </div>
 <div class="listingblock">
 <div class="content">
diff --git a/reference/html/advanced.html b/reference/html/advanced.html
new file mode 100644
index 0000000000..dc4ac67519
--- /dev/null
+++ b/reference/html/advanced.html
@@ -0,0 +1,1197 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.7.1">
+<title>Spring Cloud Contract customization</title>
+<link rel="stylesheet" href="css/spring.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css">
+
+<style>
+.hidden {
+	display: none;
+}
+
+.switch {
+	border-width: 1px 1px 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+	display: inline-block;
+}
+
+.switch--item {
+	padding: 10px;
+	background-color: #ffffff;
+	color: #7a2518;
+	display: inline-block;
+	cursor: pointer;
+}
+
+.switch--item:not(:first-child) {
+	border-width: 0 0 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+}
+
+.switch--item.selected {
+	background-color: #7a2519;
+	color: #ffffff;
+}
+</style>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/zepto/1.2.0/zepto.min.js"></script>
+<script type="text/javascript">
+function addBlockSwitches() {
+	$('.primary').each(function() {
+		primary = $(this);
+		createSwitchItem(primary, createBlockSwitch(primary)).item.addClass("selected");
+		primary.children('.title').remove();
+	});
+	$('.secondary').each(function(idx, node) {
+		secondary = $(node);
+		primary = findPrimary(secondary);
+		switchItem = createSwitchItem(secondary, primary.children('.switch'));
+		switchItem.content.addClass('hidden');
+		findPrimary(secondary).append(switchItem.content);
+		secondary.remove();
+	});
+}
+
+function createBlockSwitch(primary) {
+	blockSwitch = $('<div class="switch"></div>');
+	primary.prepend(blockSwitch);
+	return blockSwitch;
+}
+
+function findPrimary(secondary) {
+	candidate = secondary.prev();
+	while (!candidate.is('.primary')) {
+		candidate = candidate.prev();
+	}
+	return candidate;
+}
+
+function createSwitchItem(block, blockSwitch) {
+	blockName = block.children('.title').text();
+	content = block.children('.content').first().append(block.next('.colist'));
+	item = $('<div class="switch--item">' + blockName + '</div>');
+	item.on('click', '', content, function(e) {
+		$(this).addClass('selected');
+		$(this).siblings().removeClass('selected');
+		e.data.siblings('.content').addClass('hidden');
+		e.data.removeClass('hidden');
+	});
+	blockSwitch.append(item);
+	return {'item': item, 'content': content};
+}
+
+$(addBlockSwitches);
+</script>
+
+</head>
+<body id="contract-customization" class="book toc2 toc-left">
+<div id="header">
+<h1>Spring Cloud Contract customization</h1>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="#customization-customization">1. DSL Customization</a>
+<ul class="sectlevel2">
+<li><a href="#customization-extending">1.1. Extending the DSL</a></li>
+<li><a href="#customization-extending-common-jar">1.2. Common JAR</a></li>
+<li><a href="#customization-test-dep">1.3. Adding a Test Dependency in the Project&#8217;s Dependencies</a></li>
+<li><a href="#customization-plugin-dep">1.4. Adding a Test Dependency in the Plugin&#8217;s Dependencies</a></li>
+<li><a href="#customization-referencing">1.5. Referencing Classes in DSLs</a></li>
+</ul>
+</li>
+<li><a href="#customization-wiremock">2. WireMock Customization</a>
+<ul class="sectlevel2">
+<li><a href="#customization-wiremock-extension">2.1. Registering Your Own WireMock Extension</a></li>
+<li><a href="#customization-wiremock-configuration">2.2. Customization of WireMock Configuration</a></li>
+</ul>
+</li>
+<li><a href="#customization-pluggable-architecture">3. Using the Pluggable Architecture</a>
+<ul class="sectlevel2">
+<li><a href="#customization-custom-contract-converter">3.1. Custom Contract Converter</a></li>
+<li><a href="#customization-custom-test-generator">3.2. Using the Custom Test Generator</a></li>
+<li><a href="#customization-custom-stub-generator">3.3. Using the Custom Stub Generator</a></li>
+<li><a href="#customization-custom-stub-runner">3.4. Using the Custom Stub Runner</a></li>
+<li><a href="#customization-custom-stub-downloader">3.5. Using the Custom Stub Downloader</a></li>
+<li><a href="#scm-stub-downloader">3.6. Using the SCM Stub Downloader</a></li>
+</ul>
+</li>
+</ul>
+</div>
+</div>
+<div id="content">
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>In this section, we describe how to customize various parts of Spring Cloud Contract.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="customization-customization"><a class="anchor" href="#customization-customization"></a><a class="link" href="#customization-customization">1. DSL Customization</a></h2>
+<div class="sectionbody">
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+This section is valid only for the Groovy DSL
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>You can customize the Spring Cloud Contract Verifier by extending the DSL, as shown in
+the remainder of this section.</p>
+</div>
+<div class="sect2">
+<h3 id="customization-extending"><a class="anchor" href="#customization-extending"></a><a class="link" href="#customization-extending">1.1. Extending the DSL</a></h3>
+<div class="paragraph">
+<p>You can provide your own functions to the DSL. The key requirement for this feature is to
+maintain the static compatibility. Later in this document, you can see examples of:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Creating a JAR with reusable classes.</p>
+</li>
+<li>
+<p>Referencing of these classes in the DSLs.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>You can find the full example
+<a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples">here</a>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="customization-extending-common-jar"><a class="anchor" href="#customization-extending-common-jar"></a><a class="link" href="#customization-extending-common-jar">1.2. Common JAR</a></h3>
+<div class="paragraph">
+<p>The following examples show three classes that can be reused in the DSLs.</p>
+</div>
+<div class="paragraph">
+<p><code>PatternUtils</code> contains functions used by both the consumer and the producer.
+The following listing shows the <code>PatternUtils</code> class:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package com.example;
+
+import java.util.regex.Pattern;
+
+/**
+ * If you want to use {@link Pattern} directly in your tests
+ * then you can create a class resembling this one. It can
+ * contain all the {@link Pattern} you want to use in the DSL.
+ *
+ * &lt;pre&gt;
+ * {@code
+ * request {
+ *     body(
+ *         [ age: $(c(PatternUtils.oldEnough()))]
+ *     )
+ * }
+ * &lt;/pre&gt;
+ *
+ * Notice that we're using both {@code $()} for dynamic values
+ * and {@code c()} for the consumer side.
+ *
+ * @author Marcin Grzejszczak
+ */
+//tag::impl[]
+public class PatternUtils {
+
+    public static String tooYoung() {
+        //remove::start[]
+        return "[0-1][0-9]";
+        //remove::end[return]
+    }
+
+    public static Pattern oldEnough() {
+        //remove::start[]
+        return Pattern.compile("[2-9][0-9]");
+        //remove::end[return]
+    }
+
+    /**
+     * Makes little sense but it's just an example ;)
+     */
+    public static Pattern ok() {
+        //remove::start[]
+        return Pattern.compile("OK");
+        //remove::end[return]
+    }
+}
+//end::impl[]</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p><code>ConsumerUtils</code> contains functions used by the consumer.
+The following listing shows the <code>ConsumerUtils</code> class:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package com.example;
+
+import org.springframework.cloud.contract.spec.internal.ClientDslProperty;
+
+/**
+ * DSL Properties passed to the DSL from the consumer's perspective.
+ * That means that on the input side {@code Request} for HTTP
+ * or {@code Input} for messaging you can have a regular expression.
+ * On the {@code Response} for HTTP or {@code Output} for messaging
+ * you have to have a concrete value.
+ *
+ * @author Marcin Grzejszczak
+ */
+//tag::impl[]
+public class ConsumerUtils {
+    /**
+     * Consumer side property. By using the {@link ClientDslProperty}
+     * you can omit most of boilerplate code from the perspective
+     * of dynamic values. Example
+     *
+     * &lt;pre&gt;
+     * {@code
+     * request {
+     *     body(
+     *         [ age: $(ConsumerUtils.oldEnough())]
+     *     )
+     * }
+     * &lt;/pre&gt;
+     *
+     * That way it's in the implementation that we decide what value we will pass to the consumer
+     * and which one to the producer.
+     *
+     * @author Marcin Grzejszczak
+     */
+    public static ClientDslProperty oldEnough() {
+        //remove::start[]
+        // this example is not the best one and
+        // theoretically you could just pass the regex instead of `ServerDslProperty` but
+        // it's just to show some new tricks :)
+        return new ClientDslProperty(PatternUtils.oldEnough(), 40);
+        //remove::end[return]
+    }
+
+}
+//end::impl[]</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p><code>ProducerUtils</code> contains functions used by the producer.
+The following listing shows the <code>ProducerUtils</code> class:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package com.example;
+
+import org.springframework.cloud.contract.spec.internal.ServerDslProperty;
+
+/**
+ * DSL Properties passed to the DSL from the producer's perspective.
+ * That means that on the input side {@code Request} for HTTP
+ * or {@code Input} for messaging you have to have a concrete value.
+ * On the {@code Response} for HTTP or {@code Output} for messaging
+ * you can have a regular expression.
+ *
+ * @author Marcin Grzejszczak
+ */
+//tag::impl[]
+public class ProducerUtils {
+
+    /**
+     * Producer side property. By using the {@link ProducerUtils}
+     * you can omit most of boilerplate code from the perspective
+     * of dynamic values. Example
+     *
+     * &lt;pre&gt;
+     * {@code
+     * response {
+     *     body(
+     *         [ status: $(ProducerUtils.ok())]
+     *     )
+     * }
+     * &lt;/pre&gt;
+     *
+     * That way it's in the implementation that we decide what value we will pass to the consumer
+     * and which one to the producer.
+     */
+    public static ServerDslProperty ok() {
+        // this example is not the best one and
+        // theoretically you could just pass the regex instead of `ServerDslProperty` but
+        // it's just to show some new tricks :)
+        return new ServerDslProperty( PatternUtils.ok(), "OK");
+    }
+}
+//end::impl[]</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="customization-test-dep"><a class="anchor" href="#customization-test-dep"></a><a class="link" href="#customization-test-dep">1.3. Adding a Test Dependency in the Project&#8217;s Dependencies</a></h3>
+<div class="paragraph">
+<p>To add a test dependency in the project&#8217;s dependencies, you must first add the common jar
+dependency as a test dependency. Because your contracts files
+are available on the test resources path,  the common jar classes automatically become
+visible in your Groovy files. The following examples show how to test the dependency:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;com.example&lt;/groupId&gt;
+    &lt;artifactId&gt;beer-common&lt;/artifactId&gt;
+    &lt;version&gt;${project.version}&lt;/version&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile("com.example:beer-common:0.0.1.BUILD-SNAPSHOT")</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="customization-plugin-dep"><a class="anchor" href="#customization-plugin-dep"></a><a class="link" href="#customization-plugin-dep">1.4. Adding a Test Dependency in the Plugin&#8217;s Dependencies</a></h3>
+<div class="paragraph">
+<p>Now, you must add the dependency for the plugin to reuse at runtime, as the
+following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;packageWithBaseClasses&gt;com.example&lt;/packageWithBaseClasses&gt;
+        &lt;baseClassMappings&gt;
+            &lt;baseClassMapping&gt;
+                &lt;contractPackageRegex&gt;.*intoxication.*&lt;/contractPackageRegex&gt;
+                &lt;baseClassFQN&gt;com.example.intoxication.BeerIntoxicationBase&lt;/baseClassFQN&gt;
+            &lt;/baseClassMapping&gt;
+        &lt;/baseClassMappings&gt;
+    &lt;/configuration&gt;
+    &lt;dependencies&gt;
+        &lt;dependency&gt;
+            &lt;groupId&gt;com.example&lt;/groupId&gt;
+            &lt;artifactId&gt;beer-common&lt;/artifactId&gt;
+            &lt;version&gt;${project.version}&lt;/version&gt;
+            &lt;scope&gt;compile&lt;/scope&gt;
+        &lt;/dependency&gt;
+    &lt;/dependencies&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">classpath "com.example:beer-common:0.0.1.BUILD-SNAPSHOT"</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="customization-referencing"><a class="anchor" href="#customization-referencing"></a><a class="link" href="#customization-referencing">1.5. Referencing Classes in DSLs</a></h3>
+<div class="paragraph">
+<p>You can now reference your classes in your DSL, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package contracts.beer.rest
+
+import com.example.ConsumerUtils
+import com.example.ProducerUtils
+import org.springframework.cloud.contract.spec.Contract
+
+Contract.make {
+    description("""
+Represents a successful scenario of getting a beer
+
+```
+given:
+    client is old enough
+when:
+    he applies for a beer
+then:
+    we'll grant him the beer
+```
+
+""")
+    request {
+        method 'POST'
+        url '/check'
+        body(
+                age: $(ConsumerUtils.oldEnough())
+        )
+        headers {
+            contentType(applicationJson())
+        }
+    }
+    response {
+        status 200
+        body("""
+            {
+                "status": "${value(ProducerUtils.ok())}"
+            }
+            """)
+        headers {
+            contentType(applicationJson())
+        }
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+You can set the Spring Cloud Contract plugin up by setting <code>convertToYaml</code> to
+<code>true</code>. That way, you do NOT have to add the dependency with the extended functionality
+to the consumer side, since the consumer side uses YAML contracts instead of Groovy contracts.
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="customization-wiremock"><a class="anchor" href="#customization-wiremock"></a><a class="link" href="#customization-wiremock">2. WireMock Customization</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>In this section, we show how to customize the way you work with <a href="https://wiremock.org">WireMock</a>.</p>
+</div>
+<div class="sect2">
+<h3 id="customization-wiremock-extension"><a class="anchor" href="#customization-wiremock-extension"></a><a class="link" href="#customization-wiremock-extension">2.1. Registering Your Own WireMock Extension</a></h3>
+<div class="paragraph">
+<p>WireMock lets you register custom extensions. By default, Spring Cloud Contract registers
+the transformer, which lets you reference a request from a response. If you want to
+provide your own extensions, you can register an implementation of the
+<code>org.springframework.cloud.contract.verifier.dsl.wiremock.WireMockExtensions</code> interface.
+Since we use the <code>spring.factories</code> extension approach, you can create an entry in
+<code>META-INF/spring.factories</code> file similar to the following:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.verifier.dsl.wiremock.WireMockExtensions=\
+org.springframework.cloud.contract.stubrunner.provider.wiremock.TestWireMockExtensions
+org.springframework.cloud.contract.spec.ContractConverter=\
+org.springframework.cloud.contract.stubrunner.TestCustomYamlContractConverter</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example shows a custom extension:</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 1. TestWireMockExtensions.groovy</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">/*
+ * Copyright 2013-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.cloud.contract.verifier.dsl.wiremock
+
+import com.github.tomakehurst.wiremock.extension.Extension
+
+/**
+ * Extension that registers the default transformer and the custom one
+ */
+class TestWireMockExtensions implements WireMockExtensions {
+    @Override
+    List&lt;Extension&gt; extensions() {
+        return [
+                new DefaultResponseTransformer(),
+                new CustomExtension()
+        ]
+    }
+}
+
+class CustomExtension implements Extension {
+
+    @Override
+    String getName() {
+        return "foo-transformer"
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Remember to override the <code>applyGlobally()</code> method and set it to <code>false</code> if you
+want the transformation to be applied only for a mapping that explicitly requires it.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="customization-wiremock-configuration"><a class="anchor" href="#customization-wiremock-configuration"></a><a class="link" href="#customization-wiremock-configuration">2.2. Customization of WireMock Configuration</a></h3>
+<div class="paragraph">
+<p>You can register a bean of type <code>org.springframework.cloud.contract.wiremock.WireMockConfigurationCustomizer</code>
+to customize the WireMock configuration (for example, to add custom transformers).
+The following example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">        @Bean
+        WireMockConfigurationCustomizer optionsCustomizer() {
+            return new WireMockConfigurationCustomizer() {
+                @Override
+                public void customize(WireMockConfiguration options) {
+// perform your customization here
+                }
+            };
+        }</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="customization-pluggable-architecture"><a class="anchor" href="#customization-pluggable-architecture"></a><a class="link" href="#customization-pluggable-architecture">3. Using the Pluggable Architecture</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>You may encounter cases where your contracts have been defined in other formats,
+such as YAML, RAML, or PACT. In those cases, you still want to benefit from the automatic
+generation of tests and stubs. You can add your own implementation for generating both
+tests and stubs. Also, you can customize the way tests are generated (for example, you
+can generate tests for other languages) and the way stubs are generated (for example, you
+can generate stubs for other HTTP server implementations).</p>
+</div>
+<div class="sect2">
+<h3 id="customization-custom-contract-converter"><a class="anchor" href="#customization-custom-contract-converter"></a><a class="link" href="#customization-custom-contract-converter">3.1. Custom Contract Converter</a></h3>
+<div class="paragraph">
+<p>The <code>ContractConverter</code> interface lets you register your own implementation of a contract
+structure converter. The following code listing shows the <code>ContractConverter</code> interface:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package org.springframework.cloud.contract.spec;
+
+import java.io.File;
+import java.util.Collection;
+
+/**
+ * Converter to be used to convert FROM {@link File} TO {@link Contract} and from
+ * {@link Contract} to {@code T}.
+ *
+ * @param &lt;T&gt; - type to which we want to convert the contract
+ * @author Marcin Grzejszczak
+ * @since 1.1.0
+ */
+public interface ContractConverter&lt;T&gt; extends ContractStorer&lt;T&gt; {
+
+    /**
+     * Should this file be accepted by the converter. Can use the file extension to check
+     * if the conversion is possible.
+     * @param file - file to be considered for conversion
+     * @return - {@code true} if the given implementation can convert the file
+     */
+    boolean isAccepted(File file);
+
+    /**
+     * Converts the given {@link File} to its {@link Contract} representation.
+     * @param file - file to convert
+     * @return - {@link Contract} representation of the file
+     */
+    Collection&lt;Contract&gt; convertFrom(File file);
+
+    /**
+     * Converts the given {@link Contract} to a {@link T} representation.
+     * @param contract - the parsed contract
+     * @return - {@link T} the type to which we do the conversion
+     */
+    T convertTo(Collection&lt;Contract&gt; contract);
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Your implementation must define the condition on which it should start the
+conversion. Also, you must define how to perform that conversion in both directions.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Once you create your implementation, you must create a
+<code>/META-INF/spring.factories</code> file in which you provide the fully qualified name of your
+implementation.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following example shows a typical <code>spring.factories</code> file:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code>org.springframework.cloud.contract.spec.ContractConverter=\
+org.springframework.cloud.contract.verifier.converter.YamlContractConverter</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="customization-custom-test-generator"><a class="anchor" href="#customization-custom-test-generator"></a><a class="link" href="#customization-custom-test-generator">3.2. Using the Custom Test Generator</a></h3>
+<div class="paragraph">
+<p>If you want to generate tests for languages other than Java or you are not happy with the
+way the verifier builds Java tests, you can register your own implementation.</p>
+</div>
+<div class="paragraph">
+<p>The <code>SingleTestGenerator</code> interface lets you register your own implementation.  The
+following code listing shows the <code>SingleTestGenerator</code> interface:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package org.springframework.cloud.contract.verifier.builder;
+
+import java.nio.file.Path;
+import java.util.Collection;
+
+import org.springframework.cloud.contract.verifier.config.ContractVerifierConfigProperties;
+import org.springframework.cloud.contract.verifier.file.ContractMetadata;
+
+/**
+ * Builds a single test.
+ *
+ * @since 1.1.0
+ */
+public interface SingleTestGenerator {
+
+    /**
+     * Creates contents of a single test class in which all test scenarios from the
+     * contract metadata should be placed.
+     * @param properties - properties passed to the plugin
+     * @param listOfFiles - list of parsed contracts with additional metadata
+     * @param className - the name of the generated test class
+     * @param classPackage - the name of the package in which the test class should be
+     * stored
+     * @param includedDirectoryRelativePath - relative path to the included directory
+     * @return contents of a single test class
+     * @deprecated use{@link SingleTestGenerator#buildClass(ContractVerifierConfigProperties, Collection, String, GeneratedClassData)}
+     */
+    @Deprecated
+    String buildClass(ContractVerifierConfigProperties properties,
+            Collection&lt;ContractMetadata&gt; listOfFiles, String className,
+            String classPackage, String includedDirectoryRelativePath);
+
+    /**
+     * Creates contents of a single test class in which all test scenarios from the
+     * contract metadata should be placed.
+     * @param properties - properties passed to the plugin
+     * @param listOfFiles - list of parsed contracts with additional metadata
+     * @param generatedClassData - information about the generated class
+     * @param includedDirectoryRelativePath - relative path to the included directory
+     * @return contents of a single test class
+     */
+    default String buildClass(ContractVerifierConfigProperties properties,
+            Collection&lt;ContractMetadata&gt; listOfFiles,
+            String includedDirectoryRelativePath, GeneratedClassData generatedClassData) {
+        String className = generatedClassData.className;
+        String classPackage = generatedClassData.classPackage;
+        String path = includedDirectoryRelativePath;
+        return buildClass(properties, listOfFiles, className, classPackage, path);
+    }
+
+    /**
+     * Extension that should be appended to the generated test class. E.g. {@code .java}
+     * or {@code .php}
+     * @param properties - properties passed to the plugin
+     */
+    String fileExtension(ContractVerifierConfigProperties properties);
+
+    class GeneratedClassData {
+
+        public final String className;
+
+        public final String classPackage;
+
+        public final Path testClassPath;
+
+        public GeneratedClassData(String className, String classPackage,
+                Path testClassPath) {
+            this.className = className;
+            this.classPackage = classPackage;
+            this.testClassPath = testClassPath;
+        }
+
+    }
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Again, you must provide a <code>spring.factories</code> file, such as the one shown in the following
+example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code>org.springframework.cloud.contract.verifier.builder.SingleTestGenerator=/
+com.example.MyGenerator</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="customization-custom-stub-generator"><a class="anchor" href="#customization-custom-stub-generator"></a><a class="link" href="#customization-custom-stub-generator">3.3. Using the Custom Stub Generator</a></h3>
+<div class="paragraph">
+<p>If you want to generate stubs for stub servers other than WireMock, you can plug in your
+own implementation of the <code>StubGenerator</code> interface. The following code listing shows the
+<code>StubGenerator</code> interface:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package org.springframework.cloud.contract.verifier.converter;
+
+import java.util.Map;
+
+import org.springframework.cloud.contract.spec.Contract;
+import org.springframework.cloud.contract.verifier.file.ContractMetadata;
+
+/**
+ * Converts contracts into their stub representation.
+ *
+ * @since 1.1.0
+ */
+public interface StubGenerator {
+
+    /**
+     * @param fileName - file name
+     * @return {@code true} if the converter can handle the file to convert it into a
+     * stub.
+     */
+    default boolean canHandleFileName(String fileName) {
+        return fileName.endsWith(fileExtension());
+    }
+
+    /**
+     * @param rootName - root name of the contract
+     * @param content - metadata of the contract
+     * @return the collection of converted contracts into stubs. One contract can result
+     * in multiple stubs.
+     */
+    Map&lt;Contract, String&gt; convertContents(String rootName, ContractMetadata content);
+
+    /**
+     * @param inputFileName - name of the input file
+     * @return the name of the converted stub file. If you have multiple contracts in a
+     * single file then a prefix will be added to the generated file. If you provide the
+     * {@link Contract#name} field then that field will override the generated file name.
+     *
+     * Example: name of file with 2 contracts is {@code foo.groovy}, it will be converted
+     * by the implementation to {@code foo.json}. The recursive file converter will create
+     * two files {@code 0_foo.json} and {@code 1_foo.json}
+     */
+    String generateOutputFileNameForInput(String inputFileName);
+
+    /**
+     * Describes the file extension that this stub generator can handle.
+     * @return string describing the file extension
+     */
+    default String fileExtension() {
+        return ".json";
+    }
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Again, you must provide a <code>spring.factories</code> file, such as the one shown in the following
+example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code># Stub converters
+org.springframework.cloud.contract.verifier.converter.StubGenerator=\
+org.springframework.cloud.contract.verifier.wiremock.DslToWireMockClientConverter</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The default implementation is the WireMock stub generation.</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+You can provide multiple stub generator implementations. For example, from a single
+DSL, you can produce both WireMock stubs and Pact files.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="customization-custom-stub-runner"><a class="anchor" href="#customization-custom-stub-runner"></a><a class="link" href="#customization-custom-stub-runner">3.4. Using the Custom Stub Runner</a></h3>
+<div class="paragraph">
+<p>If you decide to use a custom stub generation, you also need a custom way of running
+stubs with your different stub provider.</p>
+</div>
+<div class="paragraph">
+<p>Assume that you use <a href="https://github.com/dreamhead/moco">Moco</a> to build your stubs and that
+you have written a stub generator and placed your stubs in a JAR file.</p>
+</div>
+<div class="paragraph">
+<p>In order for Stub Runner to know how to run your stubs, you have to define a custom
+HTTP Stub server implementation, which might resemble the following example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package org.springframework.cloud.contract.stubrunner.provider.moco
+
+import com.github.dreamhead.moco.bootstrap.arg.HttpArgs
+import com.github.dreamhead.moco.runner.JsonRunner
+import com.github.dreamhead.moco.runner.RunnerSetting
+import groovy.util.logging.Commons
+
+import org.springframework.cloud.contract.stubrunner.HttpServerStub
+import org.springframework.util.SocketUtils
+
+@Commons
+class MocoHttpServerStub implements HttpServerStub {
+
+    private boolean started
+    private JsonRunner runner
+    private int port
+
+    @Override
+    int port() {
+        if (!isRunning()) {
+            return -1
+        }
+        return port
+    }
+
+    @Override
+    boolean isRunning() {
+        return started
+    }
+
+    @Override
+    HttpServerStub start() {
+        return start(SocketUtils.findAvailableTcpPort())
+    }
+
+    @Override
+    HttpServerStub start(int port) {
+        this.port = port
+        return this
+    }
+
+    @Override
+    HttpServerStub stop() {
+        if (!isRunning()) {
+            return this
+        }
+        this.runner.stop()
+        return this
+    }
+
+    @Override
+    HttpServerStub registerMappings(Collection&lt;File&gt; stubFiles) {
+        List&lt;RunnerSetting&gt; settings = stubFiles.findAll { it.name.endsWith("json") }
+            .collect {
+            log.info("Trying to parse [${it.name}]")
+            try {
+                return RunnerSetting.aRunnerSetting().withStream(it.newInputStream()).
+                    build()
+            }
+            catch (Exception e) {
+                log.warn("Exception occurred while trying to parse file [${it.name}]", e)
+                return null
+            }
+        }.findAll { it }
+        this.runner = JsonRunner.newJsonRunnerWithSetting(settings,
+            HttpArgs.httpArgs().withPort(this.port).build())
+        this.runner.run()
+        this.started = true
+        return this
+    }
+
+    @Override
+    String registeredMappings() {
+        return ""
+    }
+
+    @Override
+    boolean isAccepted(File file) {
+        return file.name.endsWith(".json")
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Then you can register it in your <code>spring.factories</code> file, as the following
+example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code>org.springframework.cloud.contract.stubrunner.HttpServerStub=\
+org.springframework.cloud.contract.stubrunner.provider.moco.MocoHttpServerStub</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Now you can run stubs with Moco.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+If you do not provide any implementation, the default (WireMock)
+implementation is used. If you provide more than one, the first one on the list is used.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="customization-custom-stub-downloader"><a class="anchor" href="#customization-custom-stub-downloader"></a><a class="link" href="#customization-custom-stub-downloader">3.5. Using the Custom Stub Downloader</a></h3>
+<div class="paragraph">
+<p>You can customize the way your stubs are downloaded by creating an implementation of the
+<code>StubDownloaderBuilder</code> interface, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package com.example;
+
+class CustomStubDownloaderBuilder implements StubDownloaderBuilder {
+
+    @Override
+    public StubDownloader build(final StubRunnerOptions stubRunnerOptions) {
+        return new StubDownloader() {
+            @Override
+            public Map.Entry&lt;StubConfiguration, File&gt; downloadAndUnpackStubJar(
+                    StubConfiguration config) {
+                File unpackedStubs = retrieveStubs();
+                return new AbstractMap.SimpleEntry&lt;&gt;(
+                        new StubConfiguration(config.getGroupId(), config.getArtifactId(), version,
+                                config.getClassifier()), unpackedStubs);
+            }
+
+            File retrieveStubs() {
+                // here goes your custom logic to provide a folder where all the stubs reside
+            }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Then you can register it in your <code>spring.factories</code> file, as the following
+example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code># Example of a custom Stub Downloader Provider
+org.springframework.cloud.contract.stubrunner.StubDownloaderBuilder=\
+com.example.CustomStubDownloaderBuilder</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Now you can pick a folder with the source of your stubs.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+If you do not provide any implementation, the default (scanning the classpath) is used.
+If you provide the <code>stubsMode = StubRunnerProperties.StubsMode.LOCAL</code> or
+<code>stubsMode = StubRunnerProperties.StubsMode.REMOTE</code>, the Aether implementation is used
+If you provide more than one, the first one on the list is used.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="scm-stub-downloader"><a class="anchor" href="#scm-stub-downloader"></a><a class="link" href="#scm-stub-downloader">3.6. Using the SCM Stub Downloader</a></h3>
+<div class="paragraph">
+<p>Whenever the <code>repositoryRoot</code> starts with a SCM protocol
+(currently, we support only <code>git://</code>), the stub downloader tries
+to clone the repository and use it as a source of contracts
+to generate tests or stubs.</p>
+</div>
+<div class="paragraph">
+<p>Through environment variables, system properties, or properties set
+inside the plugin or the contracts repository configuration, you can
+tweak the downloader&#8217;s behavior. The following table describes the available
+properties:</p>
+</div>
+<table class="tableblock frame-all grid-all stretch">
+<caption class="title">Table 1. SCM Stub Downloader properties</caption>
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Type of a property</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Name of the property</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Description</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>git.branch</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.git.branch</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_GIT_BRANCH</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">master</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Which branch to checkout</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>git.username</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.git.username</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_GIT_USERNAME</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Git clone username</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>git.password</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.git.password</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_GIT_PASSWORD</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Git clone password</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>git.no-of-attempts</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.git.no-of-attempts</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_GIT_NO_OF_ATTEMPTS</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">10</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number of attempts to push the commits to <code>origin</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>git.wait-between-attempts</code> (Plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.git.wait-between-attempts</code>  (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_GIT_WAIT_BETWEEN_ATTEMPTS</code>  (env prop)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">1000</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number of milliseconds to wait between attempts to push the commits to <code>origin</code></p></td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+</div>
+</div>
+<script type="text/javascript" src="js/tocbot/tocbot.min.js"></script>
+<script type="text/javascript" src="js/toc.js"></script>
+<link rel="stylesheet" href="js/highlight/styles/atom-one-dark-reasonable.min.css">
+<script src="js/highlight/highlight.min.js"></script>
+<script>hljs.initHighlighting()</script>
+</body>
+</html>
\ No newline at end of file
diff --git a/reference/html/docker-project.html b/reference/html/docker-project.html
new file mode 100644
index 0000000000..c5bb1866ee
--- /dev/null
+++ b/reference/html/docker-project.html
@@ -0,0 +1,585 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.7.1">
+<title>Docker Project</title>
+<link rel="stylesheet" href="css/spring.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css">
+
+<style>
+.hidden {
+	display: none;
+}
+
+.switch {
+	border-width: 1px 1px 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+	display: inline-block;
+}
+
+.switch--item {
+	padding: 10px;
+	background-color: #ffffff;
+	color: #7a2518;
+	display: inline-block;
+	cursor: pointer;
+}
+
+.switch--item:not(:first-child) {
+	border-width: 0 0 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+}
+
+.switch--item.selected {
+	background-color: #7a2519;
+	color: #ffffff;
+}
+</style>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/zepto/1.2.0/zepto.min.js"></script>
+<script type="text/javascript">
+function addBlockSwitches() {
+	$('.primary').each(function() {
+		primary = $(this);
+		createSwitchItem(primary, createBlockSwitch(primary)).item.addClass("selected");
+		primary.children('.title').remove();
+	});
+	$('.secondary').each(function(idx, node) {
+		secondary = $(node);
+		primary = findPrimary(secondary);
+		switchItem = createSwitchItem(secondary, primary.children('.switch'));
+		switchItem.content.addClass('hidden');
+		findPrimary(secondary).append(switchItem.content);
+		secondary.remove();
+	});
+}
+
+function createBlockSwitch(primary) {
+	blockSwitch = $('<div class="switch"></div>');
+	primary.prepend(blockSwitch);
+	return blockSwitch;
+}
+
+function findPrimary(secondary) {
+	candidate = secondary.prev();
+	while (!candidate.is('.primary')) {
+		candidate = candidate.prev();
+	}
+	return candidate;
+}
+
+function createSwitchItem(block, blockSwitch) {
+	blockName = block.children('.title').text();
+	content = block.children('.content').first().append(block.next('.colist'));
+	item = $('<div class="switch--item">' + blockName + '</div>');
+	item.on('click', '', content, function(e) {
+		$(this).addClass('selected');
+		$(this).siblings().removeClass('selected');
+		e.data.siblings('.content').addClass('hidden');
+		e.data.removeClass('hidden');
+	});
+	blockSwitch.append(item);
+	return {'item': item, 'content': content};
+}
+
+$(addBlockSwitches);
+</script>
+
+</head>
+<body id="docker" class="book toc2 toc-left">
+<div id="header">
+<h1>Docker Project</h1>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="#docker-intro">1. A Short Introduction to Maven, JARs and Binary storage</a></li>
+<li><a href="#docker-how-it-works">2. Generating Tests on the Producer Side</a>
+<ul class="sectlevel2">
+<li><a href="#docker-env-vars">2.1. Environment Variables</a></li>
+<li><a href="#docker-example-of-usage">2.2. Example of Usage</a></li>
+</ul>
+</li>
+<li><a href="#docker-stubrunner">3. Running Stubs on the Consumer Side</a>
+<ul class="sectlevel2">
+<li><a href="#docker-stubrunner-env-vars">3.1. Environment Variables</a></li>
+<li><a href="#docker-stubrunner-example">3.2. Example of Usage</a></li>
+</ul>
+</li>
+</ul>
+</div>
+</div>
+<div id="content">
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>In this section, we publish a <code>springcloud/spring-cloud-contract</code> Docker image
+that contains a project that generates tests and runs them in <code>EXPLICIT</code> mode
+against a running application.</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+The <code>EXPLICIT</code> mode means that the tests generated from contracts send
+real requests and not the mocked ones.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>We also publish a <code>spring-cloud/spring-cloud-contract-stub-runner</code> Docker image
+that starts the standalone version of Stub Runner.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="docker-intro"><a class="anchor" href="#docker-intro"></a><a class="link" href="#docker-intro">1. A Short Introduction to Maven, JARs and Binary storage</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Since non-JVM projects can use the Docker image, it is good to
+explain the basic terms behind Spring Cloud Contract packaging defaults.</p>
+</div>
+<div class="paragraph">
+<p>Parts of the following definitions were taken from the <a href="https://maven.apache.org/glossary.html">Maven Glossary</a>:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>Project</code>: Maven thinks in terms of projects. Projects
+are all you build. Those projects follow a well defined
+“Project Object Model”. Projects can depend on other projects,
+in which case the latter are called “dependencies”. A project may
+consistent of several subprojects. However, these subprojects are still
+treated equally as projects.</p>
+</li>
+<li>
+<p><code>Artifact</code>: An artifact is something that is either produced or used
+by a project. Examples of artifacts produced by Maven for a project
+include JAR files and source and binary distributions. Each artifact
+is uniquely identified by a group ID and an artifact ID that is
+unique within a group.</p>
+</li>
+<li>
+<p><code>JAR</code>: JAR stands for Java ARchive. Its format is based on
+the ZIP file format. Spring Cloud Contract packages the contracts and generated
+stubs in a JAR file.</p>
+</li>
+<li>
+<p><code>GroupId</code>: A group ID is a universally unique identifier for a project.
+While this is often just the project name (for example, <code>commons-collections</code>),
+it is helpful to use a fully-qualified package name to distinguish it
+from other projects with a similar name (for example, <code>org.apache.maven</code>).
+Typically, when published to the Artifact Manager, the <code>GroupId</code> gets
+slash separated and forms part of the URL. For example, for a group ID of <code>com.example</code>
+and an artifact ID of <code>application</code>, the result would be <code>/com/example/application/</code>.</p>
+</li>
+<li>
+<p><code>Classifier</code>: The Maven dependency notation looks as follows:
+<code>groupId:artifactId:version:classifier</code>. The classifier is an additional suffix
+passed to the dependency&#8201;&#8212;&#8201;for example, <code>stubs</code> or <code>sources</code>. The same dependency
+(for example, <code>com.example:application</code>) can produce multiple artifacts that
+differ from each other with the classifier.</p>
+</li>
+<li>
+<p><code>Artifact manager</code>: When you generate binaries, sources, or packages, you would
+like them to be available for others to download, reference, or reuse. In the case
+of the JVM world, those artifacts are generally JARs. For Ruby, those artifacts are gems.
+For Docker, those artifacts are Docker images. You can store those artifacts
+in a manager. Examples of such managers include <a href="https://jfrog.com/artifactory/">Artifactory</a>
+or <a href="https://www.sonatype.org/nexus/">Nexus</a>.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="docker-how-it-works"><a class="anchor" href="#docker-how-it-works"></a><a class="link" href="#docker-how-it-works">2. Generating Tests on the Producer Side</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The image searches for contracts under the <code>/contracts</code> folder.
+The output from running the tests is available in the
+<code>/spring-cloud-contract/build</code> folder (useful for debugging
+purposes).</p>
+</div>
+<div class="paragraph">
+<p>You can mount your contracts and pass the environment variables.
+The image then:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Generates the contract tests</p>
+</li>
+<li>
+<p>Runs the tests against the provided URL</p>
+</li>
+<li>
+<p>Generates the <a href="https://github.com/tomakehurst/wiremock">WireMock</a> stubs</p>
+</li>
+<li>
+<p>Publishes the stubs to a Artifact Manager (optional - turned on by default)</p>
+</li>
+</ul>
+</div>
+<div class="sect2">
+<h3 id="docker-env-vars"><a class="anchor" href="#docker-env-vars"></a><a class="link" href="#docker-env-vars">2.1. Environment Variables</a></h3>
+<div class="paragraph">
+<p>The Docker image requires some environment variables to point to
+your running application, to the Artifact manager instance, and so on.
+The following list describes the environment variables:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>PROJECT_GROUP</code>: Your project&#8217;s group ID. Defaults to <code>com.example</code>.</p>
+</li>
+<li>
+<p><code>PROJECT_VERSION</code>: Your project&#8217;s version. Defaults to <code>0.0.1-SNAPSHOT</code>.</p>
+</li>
+<li>
+<p><code>PROJECT_NAME</code>: Your project&#8217;s artifact id. Defaults to <code>example</code>.</p>
+</li>
+<li>
+<p><code>PRODUCER_STUBS_CLASSIFIER</code>: Archive classifier used for generated producer stubs. Defaults to <code>stubs</code>.</p>
+</li>
+<li>
+<p><code>REPO_WITH_BINARIES_URL</code>: URL of your Artifact Manager. Defaults to <code><a href="http://localhost:8081/artifactory/libs-release-local" class="bare">localhost:8081/artifactory/libs-release-local</a></code>,
+which is the default URL of <a href="https://jfrog.com/artifactory/">Artifactory</a> running locally.</p>
+</li>
+<li>
+<p><code>REPO_WITH_BINARIES_USERNAME</code>: (optional) Username when the Artifact Manager is secured. Defaults to <code>admin</code>.</p>
+</li>
+<li>
+<p><code>REPO_WITH_BINARIES_PASSWORD</code>: (optional) Password when the Artifact Manager is secured. Defaults to <code>password</code>.</p>
+</li>
+<li>
+<p><code>PUBLISH_ARTIFACTS</code>: If set to <code>true</code>, publishes the artifact to binary storage. Defaults to <code>true</code>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>These environment variables are used when contracts lay in an external repository. To enable
+this feature, you must set the <code>EXTERNAL_CONTRACTS_ARTIFACT_ID</code> environment variable.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>EXTERNAL_CONTRACTS_GROUP_ID</code>: Group ID of the project with contracts. Defaults to <code>com.example</code></p>
+</li>
+<li>
+<p><code>EXTERNAL_CONTRACTS_ARTIFACT_ID</code>: Artifact ID of the project with contracts.</p>
+</li>
+<li>
+<p><code>EXTERNAL_CONTRACTS_CLASSIFIER</code>: Classifier of the project with contracts. Empty by default.</p>
+</li>
+<li>
+<p><code>EXTERNAL_CONTRACTS_VERSION</code>: Version of the project with contracts. Defaults to <code>+</code>, equivalent to picking the latest.</p>
+</li>
+<li>
+<p><code>EXTERNAL_CONTRACTS_REPO_WITH_BINARIES_URL</code>: URL of your Artifact Manager. It defaults to
+the value of <code>REPO_WITH_BINARIES_URL</code> environment variable.
+If that is not set, it defaults to <code><a href="http://localhost:8081/artifactory/libs-release-local" class="bare">localhost:8081/artifactory/libs-release-local</a></code>,
+which is the default URL of <a href="https://jfrog.com/artifactory/">Artifactory</a> running locally.</p>
+</li>
+<li>
+<p><code>EXTERNAL_CONTRACTS_REPO_WITH_BINARIES_USERNAME</code>: (optional) Username if the <code>EXTERNAL_CONTRACTS_REPO_WITH_BINARIES_URL</code>
+requires authentication. It defaults to <code>REPO_WITH_BINARIES_USERNAME</code>. If that is not set, it defaults to <code>admin</code>.</p>
+</li>
+<li>
+<p><code>EXTERNAL_CONTRACTS_REPO_WITH_BINARIES_PASSWORD</code>: (optional) Password if the <code>EXTERNAL_CONTRACTS_REPO_WITH_BINARIES_URL</code>
+requires authentication. It defaults to <code>REPO_WITH_BINARIES_PASSWORD</code>. If that is not set, it defaults to <code>password</code>.</p>
+</li>
+<li>
+<p><code>EXTERNAL_CONTRACTS_PATH</code>: Path to contracts for the given project, inside the project with contracts.
+Defaults to slash-separated <code>EXTERNAL_CONTRACTS_GROUP_ID</code> concatenated with <code>/</code> and <code>EXTERNAL_CONTRACTS_ARTIFACT_ID</code>. For example,
+for group id <code>cat-server-side.dog</code> and artifact id <code>fish</code>, would result in <code>cat/dog/fish</code> for the contracts path.</p>
+</li>
+<li>
+<p><code>EXTERNAL_CONTRACTS_WORK_OFFLINE</code>; If set to <code>true</code>, retrieves the artifact with contracts
+from the container&#8217;s <code>.m2</code>. Mount your local <code>.m2</code> as a volume available at the container&#8217;s <code>/root/.m2</code> path.</p>
+</li>
+</ul>
+</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title="Warning"></i>
+</td>
+<td class="content">
+You must not set both <code>EXTERNAL_CONTRACTS_WORK_OFFLINE</code> and <code>EXTERNAL_CONTRACTS_REPO_WITH_BINARIES_URL</code>.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following environment variables are used when tests are executed:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>APPLICATION_BASE_URL</code>: URL against which tests should be run.
+Remember that it has to be accessible from the Docker container (for example, <code>localhost</code>
+does not work)</p>
+</li>
+<li>
+<p><code>APPLICATION_USERNAME</code>: (optional) Username for basic authentication to your application.</p>
+</li>
+<li>
+<p><code>APPLICATION_PASSWORD</code>: (optional) Password for basic authentication to your application.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="docker-example-of-usage"><a class="anchor" href="#docker-example-of-usage"></a><a class="link" href="#docker-example-of-usage">2.2. Example of Usage</a></h3>
+<div class="paragraph">
+<p>In this section, we explore a simple MVC application. To get started, clone the following
+git repository and cd to the resulting directory, by running the following commands:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ git clone https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs
+$ cd bookstore</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The contracts are available in the <code>/contracts</code> folder.</p>
+</div>
+<div class="paragraph">
+<p>Since we want to run tests, we can run the following command:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ npm test</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>However, for learning purposes, we split it into pieces, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Stop docker infra (nodejs, artifactory)
+$ ./stop_infra.sh
+# Start docker infra (nodejs, artifactory)
+$ ./setup_infra.sh
+
+# Kill &amp; Run app
+$ pkill -f "node app"
+$ nohup node app &amp;
+
+# Prepare environment variables
+$ SC_CONTRACT_DOCKER_VERSION="..."
+$ APP_IP="192.168.0.100"
+$ APP_PORT="3000"
+$ ARTIFACTORY_PORT="8081"
+$ APPLICATION_BASE_URL="http://${APP_IP}:${APP_PORT}"
+$ ARTIFACTORY_URL="http://${APP_IP}:${ARTIFACTORY_PORT}/artifactory/libs-release-local"
+$ CURRENT_DIR="$( pwd )"
+$ CURRENT_FOLDER_NAME=${PWD##*/}
+$ PROJECT_VERSION="0.0.1.RELEASE"
+
+# Execute contract tests
+$ docker run  --rm -e "APPLICATION_BASE_URL=${APPLICATION_BASE_URL}" -e "PUBLISH_ARTIFACTS=true" -e "PROJECT_NAME=${CURRENT_FOLDER_NAME}" -e "REPO_WITH_BINARIES_URL=${ARTIFACTORY_URL}" -e "PROJECT_VERSION=${PROJECT_VERSION}" -v "${CURRENT_DIR}/contracts/:/contracts:ro" -v "${CURRENT_DIR}/node_modules/spring-cloud-contract/output:/spring-cloud-contract-output/" springcloud/spring-cloud-contract:"${SC_CONTRACT_DOCKER_VERSION}"
+
+# Kill app
+$ pkill -f "node app"</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Through bash scripts, the following happens:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The infrastructure (MongoDb and Artifactory) is set up.
+In a real-life scenario, you would run the NodeJS application
+with a mocked database. In this example, we want to show how we can
+benefit from Spring Cloud Contract in very little time.</p>
+</li>
+<li>
+<p>Due to those constraints, the contracts also represent the
+stateful situation.</p>
+<div class="ulist">
+<ul>
+<li>
+<p>The first request is a <code>POST</code> that causes data to get inserted to the database.</p>
+</li>
+<li>
+<p>The second request is a <code>GET</code> that returns a list of data with 1 previously inserted element.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>The NodeJS application is started (on port <code>3000</code>).</p>
+</li>
+<li>
+<p>The contract tests are generated through Docker, and tests
+are run against the running application.</p>
+<div class="ulist">
+<ul>
+<li>
+<p>The contracts are taken from <code>/contracts</code> folder.</p>
+</li>
+<li>
+<p>The output of the test execution is available under
+<code>node_modules/spring-cloud-contract/output</code>.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>The stubs are uploaded to Artifactory. You can find them in
+<a href="http://localhost:8081/artifactory/libs-release-local/com/example/bookstore/0.0.1.RELEASE/" class="bare">localhost:8081/artifactory/libs-release-local/com/example/bookstore/0.0.1.RELEASE/</a> .
+The stubs are at <a href="http://localhost:8081/artifactory/libs-release-local/com/example/bookstore/0.0.1.RELEASE/bookstore-0.0.1.RELEASE-stubs.jar" class="bare">localhost:8081/artifactory/libs-release-local/com/example/bookstore/0.0.1.RELEASE/bookstore-0.0.1.RELEASE-stubs.jar</a>.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="docker-stubrunner"><a class="anchor" href="#docker-stubrunner"></a><a class="link" href="#docker-stubrunner">3. Running Stubs on the Consumer Side</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This section describes how to use Docker on the consumer side to fetch and run stubs.</p>
+</div>
+<div class="paragraph">
+<p>We publish a <code>spring-cloud/spring-cloud-contract-stub-runner</code> Docker image
+that starts the standalone version of Stub Runner.</p>
+</div>
+<div class="sect2">
+<h3 id="docker-stubrunner-env-vars"><a class="anchor" href="#docker-stubrunner-env-vars"></a><a class="link" href="#docker-stubrunner-env-vars">3.1. Environment Variables</a></h3>
+<div class="paragraph">
+<p>You can run the docker image and pass any of the <a href="project-features.html#features-stub-runner-common-properties-junit-spring">Common Properties for JUnit and Spring</a>
+as environment variables. The convention is that all the
+letters should be upper case.
+The dot (<code>.</code>) should be replaced with underscore (<code>_</code>) characters. For example,
+the <code>stubrunner.repositoryRoot</code> property should be represented
+as a <code>STUBRUNNER_REPOSITORY_ROOT</code> environment variable.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="docker-stubrunner-example"><a class="anchor" href="#docker-stubrunner-example"></a><a class="link" href="#docker-stubrunner-example">3.2. Example of Usage</a></h3>
+<div class="paragraph">
+<p>We want to use the stubs created in this <a href="#docker-server-side">[docker-server-side]</a> step.
+Assume that we want to run the stubs on port <code>9876</code>. You can see the NodeJS code
+by cloning the repository and changing to the directory indicated in the following commands:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ git clone https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs
+$ cd bookstore</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Now we can run the Stub Runner Boot application with the stubs, by running the following
+commands:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Provide the Spring Cloud Contract Docker version
+$ SC_CONTRACT_DOCKER_VERSION="..."
+# The IP at which the app is running and Docker container can reach it
+$ APP_IP="192.168.0.100"
+# Spring Cloud Contract Stub Runner properties
+$ STUBRUNNER_PORT="8083"
+# Stub coordinates 'groupId:artifactId:version:classifier:port'
+$ STUBRUNNER_IDS="com.example:bookstore:0.0.1.RELEASE:stubs:9876"
+$ STUBRUNNER_REPOSITORY_ROOT="http://${APP_IP}:8081/artifactory/libs-release-local"
+# Run the docker with Stub Runner Boot
+$ docker run  --rm -e "STUBRUNNER_IDS=${STUBRUNNER_IDS}" -e "STUBRUNNER_REPOSITORY_ROOT=${STUBRUNNER_REPOSITORY_ROOT}" -e "STUBRUNNER_STUBS_MODE=REMOTE" -p "${STUBRUNNER_PORT}:${STUBRUNNER_PORT}" -p "9876:9876" springcloud/spring-cloud-contract-stub-runner:"${SC_CONTRACT_DOCKER_VERSION}"</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>When the preceding commands run,</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>A standalone Stub Runner application gets started.</p>
+</li>
+<li>
+<p>It downloads the stub with coordinates <code>com.example:bookstore:0.0.1.RELEASE:stubs</code> on port <code>9876</code>.</p>
+</li>
+<li>
+<p>It gets downloads from Artifactory running at <code><a href="http://192.168.0.100:8081/artifactory/libs-release-local" class="bare">192.168.0.100:8081/artifactory/libs-release-local</a></code>.</p>
+</li>
+<li>
+<p>After a whil, Stub Runner is running on port <code>8083</code>.</p>
+</li>
+<li>
+<p>The stubs are running at port <code>9876</code>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>On the server side, we built a stateful stub. We can use curl to assert
+that the stubs are setup properly. To do so, run the following commands:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># let's execute the first request (no response is returned)
+$ curl -H "Content-Type:application/json" -X POST --data '{ "title" : "Title", "genre" : "Genre", "description" : "Description", "author" : "Author", "publisher" : "Publisher", "pages" : 100, "image_url" : "https://d213dhlpdb53mu.cloudfront.net/assets/pivotal-square-logo-41418bd391196c3022f3cd9f3959b3f6d7764c47873d858583384e759c7db435.svg", "buy_url" : "https://pivotal.io" }' http://localhost:9876/api/books
+# Now time for the second request
+$ curl -X GET http://localhost:9876/api/books
+# You will receive contents of the JSON</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+If you want use the stubs that you have built locally, on your host,
+you should set the <code>-e STUBRUNNER_STUBS_MODE=LOCAL</code> environment variable and mount
+the volume of your local m2 (<code>-v "${HOME}/.m2/:/root/.m2:ro"</code>).
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+</div>
+</div>
+<script type="text/javascript" src="js/tocbot/tocbot.min.js"></script>
+<script type="text/javascript" src="js/toc.js"></script>
+<link rel="stylesheet" href="js/highlight/styles/atom-one-dark-reasonable.min.css">
+<script src="js/highlight/highlight.min.js"></script>
+<script>hljs.initHighlighting()</script>
+</body>
+</html>
\ No newline at end of file
diff --git a/reference/html/documentation-overview.html b/reference/html/documentation-overview.html
new file mode 100644
index 0000000000..92d2337dae
--- /dev/null
+++ b/reference/html/documentation-overview.html
@@ -0,0 +1,372 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.7.1">
+<title>Spring Cloud Contract Documentation</title>
+<link rel="stylesheet" href="css/spring.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css">
+
+<style>
+.hidden {
+	display: none;
+}
+
+.switch {
+	border-width: 1px 1px 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+	display: inline-block;
+}
+
+.switch--item {
+	padding: 10px;
+	background-color: #ffffff;
+	color: #7a2518;
+	display: inline-block;
+	cursor: pointer;
+}
+
+.switch--item:not(:first-child) {
+	border-width: 0 0 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+}
+
+.switch--item.selected {
+	background-color: #7a2519;
+	color: #ffffff;
+}
+</style>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/zepto/1.2.0/zepto.min.js"></script>
+<script type="text/javascript">
+function addBlockSwitches() {
+	$('.primary').each(function() {
+		primary = $(this);
+		createSwitchItem(primary, createBlockSwitch(primary)).item.addClass("selected");
+		primary.children('.title').remove();
+	});
+	$('.secondary').each(function(idx, node) {
+		secondary = $(node);
+		primary = findPrimary(secondary);
+		switchItem = createSwitchItem(secondary, primary.children('.switch'));
+		switchItem.content.addClass('hidden');
+		findPrimary(secondary).append(switchItem.content);
+		secondary.remove();
+	});
+}
+
+function createBlockSwitch(primary) {
+	blockSwitch = $('<div class="switch"></div>');
+	primary.prepend(blockSwitch);
+	return blockSwitch;
+}
+
+function findPrimary(secondary) {
+	candidate = secondary.prev();
+	while (!candidate.is('.primary')) {
+		candidate = candidate.prev();
+	}
+	return candidate;
+}
+
+function createSwitchItem(block, blockSwitch) {
+	blockName = block.children('.title').text();
+	content = block.children('.content').first().append(block.next('.colist'));
+	item = $('<div class="switch--item">' + blockName + '</div>');
+	item.on('click', '', content, function(e) {
+		$(this).addClass('selected');
+		$(this).siblings().removeClass('selected');
+		e.data.siblings('.content').addClass('hidden');
+		e.data.removeClass('hidden');
+	});
+	blockSwitch.append(item);
+	return {'item': item, 'content': content};
+}
+
+$(addBlockSwitches);
+</script>
+
+</head>
+<body id="documentation" class="book toc2 toc-left">
+<div id="header">
+<h1>Spring Cloud Contract Documentation</h1>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="#contract-documentation-about">1. About the Documentation</a></li>
+<li><a href="#documentation-getting-help">2. Getting Help</a></li>
+<li><a href="#contract-documentation-first-steps">3. First Steps</a></li>
+<li><a href="#working-with-spring-cloud-contract">4. Working with Spring Cloud Contract</a></li>
+<li><a href="#learning-about-spring-cloud-contract-features">5. Learning about Spring Cloud Contract Features</a></li>
+<li><a href="#advanced-topics">6. Advanced Topics</a></li>
+</ul>
+</div>
+</div>
+<div id="content">
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>This section provides a brief overview of Spring Cloud Contract reference documentation. It serves
+as a map for the rest of the document.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="contract-documentation-about"><a class="anchor" href="#contract-documentation-about"></a><a class="link" href="#contract-documentation-about">1. About the Documentation</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The Spring Cloud Contract reference guide is available as</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="https://cloud.spring.io/spring-cloud-contract/${git.branch}//html">Multi-page HTML</a></p>
+</li>
+<li>
+<p><a href="https://cloud.spring.io/spring-cloud-contract/${git.branch}//htmlsingle">Single-page HTML</a></p>
+</li>
+<li>
+<p><a href="https://cloud.spring.io/spring-cloud-contract/${git.branch}//pdf/spring-cloud-contract.pdf">PDF</a></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Copies of this document may be made for your own use and for distribution to others,
+provided that you do not charge any fee for such copies and further provided that each
+copy contains this Copyright Notice, whether distributed in print or electronically.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="documentation-getting-help"><a class="anchor" href="#documentation-getting-help"></a><a class="link" href="#documentation-getting-help">2. Getting Help</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>If you have trouble with Spring Cloud Contract, we would like to help.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Try the <a href="howto.html#howto">How-to documents</a>. They provide solutions to the most
+common questions.</p>
+</li>
+<li>
+<p>Learn the Spring Cloud Contract basics. If you are
+starting out with Spring Cloud Contract, try one of the <a href="https://spring.io/guides">guides</a>.</p>
+</li>
+<li>
+<p>Ask a question. We monitor <a href="https://stackoverflow.com">stackoverflow.com</a> for questions
+tagged with <a href="https://stackoverflow.com/tags/spring-cloud-contract"><code>spring-cloud-contract</code></a>.</p>
+</li>
+<li>
+<p>Report bugs with Spring Cloud Contract at <a href="https://github.com/spring-cloud/spring-cloud-contract/issues" class="bare">github.com/spring-cloud/spring-cloud-contract/issues</a>.</p>
+</li>
+<li>
+<p>Chat with us at <a href="http://https://gitter.im/spring-cloud/spring-cloud-contract">Spring Cloud Contract Gitter</a></p>
+</li>
+</ul>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+All of Spring Cloud Contract is open source, including the documentation. If you find
+problems with the docs or if you want to improve them, please <a href="https://github.com/spring-cloud/spring-cloud-contract/tree/${github-tag}">get
+involved</a>.
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="contract-documentation-first-steps"><a class="anchor" href="#contract-documentation-first-steps"></a><a class="link" href="#contract-documentation-first-steps">3. First Steps</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>If you are getting started with Spring Cloud Contract or 'Spring' in general, start with
+<a href="getting-started.html#getting-started">the following topics</a>:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>From scratch:</strong>
+<a href="getting-started.html#getting-started-introducing-spring-cloud-contract">Overview</a> |
+<a href="getting-started.html#getting-started-three-second-tour">Three-second Tour</a> |
+<a href="getting-started.html#getting-started-first-application">First application</a></p>
+</li>
+<li>
+<p><strong>Tutorial:</strong>
+<a href="getting-started.html#getting-started-cdc">Introduction</a> |
+<a href="getting-started.html#consumer-side-loan-issuance">Consumer, Part 1</a> |
+<a href="getting-started.html#producer-side-fraud-detection-server">Producer</a> |
+<a href="getting-started.html#consumer-side-loan-issuance-final-step">Consumer, Part 2</a></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="working-with-spring-cloud-contract"><a class="anchor" href="#working-with-spring-cloud-contract"></a><a class="link" href="#working-with-spring-cloud-contract">4. Working with Spring Cloud Contract</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Ready to actually start using Spring Cloud Contract? <a href="using.html#using">We have
+you covered</a>:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>Provider contract testing:</strong></p>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="using.html#flows-provider-nexus">Provider contract testing with stubs in Nexus or Artifactory</a></p>
+</li>
+<li>
+<p><a href="using.html#flows-provider-git">Provider contract testing with stubs in Git</a></p>
+</li>
+<li>
+<p><a href="using.html#flows-provider-non-spring">Provider contract testing with stubs in Artifactory for a non-Spring application</a></p>
+</li>
+<li>
+<p><a href="using.html#flows-provider-non-jvm">Provider contract testing with stubs in Artifactory in non JVM world</a></p>
+</li>
+<li>
+<p><a href="using.html#flows-provider-rest-docs">Provider contract testing with REST Docs and stubs in Nexus / Artifactory</a></p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>Consumer-Driven contract testing:</strong></p>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="using.html#flows-cdc-contracts-producer">Consumer Driven Contracts with contracts on the producer side</a></p>
+</li>
+<li>
+<p><a href="using.html#flows-cdc-contracts-external">Consumer Driven Contracts with contracts in external repo</a></p>
+</li>
+<li>
+<p><a href="using.html#flows-cdc-contracts-stubs-git">Consumer Driven Contracts with contracts on the producer side, pushed to git</a></p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+We talk about <strong>Provider Contracts</strong> when it is the producer of the API that defines the contracts and
+publishes it for all its consumers to use. This approach is useful for producers that cannot
+directly collaborate with their consumers&#8201;&#8212;&#8201;for example, when there are too many consumers or
+the consumers are external (do not work within the same company).
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+We use the term, <strong>Consumer-Driven Contracts</strong>, to refer to workflows where the consumers of an API
+play a vital role in the process of creating the contracts. We recommended this approach, because it is easy
+to implement when both producer and consumer teams work for the same organizations and the number
+of consumers is not extremely large.
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="learning-about-spring-cloud-contract-features"><a class="anchor" href="#learning-about-spring-cloud-contract-features"></a><a class="link" href="#learning-about-spring-cloud-contract-features">5. Learning about Spring Cloud Contract Features</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Need more details about Spring Cloud Contract&#8217;s core features?
+<a href="project-features.html#features">The following content is for you</a>:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>Core Features:</strong>
+<a href="project-features.html#contract-dsl">Contract DSL</a> |
+<a href="project-features.html#features-http">Contracts for HTTP</a> |
+<a href="project-features.html#features-messaging">Contracts for Messaging</a></p>
+</li>
+<li>
+<p><strong>Integrations:</strong>
+<a href="project-features.html#features-jax-rs">JAX-RS</a> |
+<a href="project-features.html#features-context-paths">Context Paths</a> |
+<a href="project-features.html#features-rest-docs">RESTDocs</a>
+<a href="howto.html#how-to-generate-pact-from-scc">Pact</a></p>
+</li>
+<li>
+<p><strong>Modules:</strong>
+<a href="project-features.html#features-stub-runner">Stub Runner</a> |
+<a href="project-features.html#features-wiremock">WireMock</a></p>
+</li>
+<li>
+<p><strong>Build Tools:</strong>
+<a href="maven-project.html">Contract Verifier - Maven</a> |
+<a href="gradle-project.html">Contract Verifier - Gradle</a> |
+<a href="docker-project.html">Docker</a></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="advanced-topics"><a class="anchor" href="#advanced-topics"></a><a class="link" href="#advanced-topics">6. Advanced Topics</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Finally, we have a few topics for more advanced users:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>Customizing the DSL:</strong>
+<a href="advanced.html#contract-dsl-customization">DSL Customization</a> |
+<a href="advanced.html#contract-dsl-extending-common-jar">Common JAR</a> |
+<a href="advanced.html#contract-dsl-test-dep">Test Dependency</a> |
+<a href="advanced.html#contract-dsl-plugin-dep">Plugin Dependency</a> |
+<a href="advanced.html#contract-dsl-referencing">Referencing the DSL</a></p>
+</li>
+<li>
+<p><strong>Customizing WireMock:</strong>
+<a href="advanced.html#customization-wiremock-extension">Extensions</a> |
+<a href="advanced.html#customization-wiremock-configuration">Configuration</a></p>
+</li>
+<li>
+<p><strong>Customizing Spring Cloud Contract:</strong>
+<a href="advanced.html#contract-dsl-pluggable-architecture">Pluggable Architecture</a> |
+<a href="advanced.html#contract-dsl-custom-contract-converter">Contract Converter</a> |
+<a href="advanced.html#contract-dsl-custom-test-generator">Test Generator</a> |
+<a href="advanced.html#contract-dsl-custom-stub-generator">Stub Generator</a> |
+<a href="advanced.html#contract-dsl-custom-stub-runner">Stub Runner</a> |
+<a href="advanced.html#contract-dsl-custom-stub-downloader">Stub Downloader</a></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<script type="text/javascript" src="js/tocbot/tocbot.min.js"></script>
+<script type="text/javascript" src="js/toc.js"></script>
+<link rel="stylesheet" href="js/highlight/styles/atom-one-dark-reasonable.min.css">
+<script src="js/highlight/highlight.min.js"></script>
+<script>hljs.initHighlighting()</script>
+</body>
+</html>
\ No newline at end of file
diff --git a/reference/html/getting-started.html b/reference/html/getting-started.html
new file mode 100644
index 0000000000..c85ec0d0ce
--- /dev/null
+++ b/reference/html/getting-started.html
@@ -0,0 +1,2370 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.7.1">
+<title>Getting Started</title>
+<link rel="stylesheet" href="css/spring.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css">
+
+<style>
+.hidden {
+	display: none;
+}
+
+.switch {
+	border-width: 1px 1px 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+	display: inline-block;
+}
+
+.switch--item {
+	padding: 10px;
+	background-color: #ffffff;
+	color: #7a2518;
+	display: inline-block;
+	cursor: pointer;
+}
+
+.switch--item:not(:first-child) {
+	border-width: 0 0 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+}
+
+.switch--item.selected {
+	background-color: #7a2519;
+	color: #ffffff;
+}
+</style>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/zepto/1.2.0/zepto.min.js"></script>
+<script type="text/javascript">
+function addBlockSwitches() {
+	$('.primary').each(function() {
+		primary = $(this);
+		createSwitchItem(primary, createBlockSwitch(primary)).item.addClass("selected");
+		primary.children('.title').remove();
+	});
+	$('.secondary').each(function(idx, node) {
+		secondary = $(node);
+		primary = findPrimary(secondary);
+		switchItem = createSwitchItem(secondary, primary.children('.switch'));
+		switchItem.content.addClass('hidden');
+		findPrimary(secondary).append(switchItem.content);
+		secondary.remove();
+	});
+}
+
+function createBlockSwitch(primary) {
+	blockSwitch = $('<div class="switch"></div>');
+	primary.prepend(blockSwitch);
+	return blockSwitch;
+}
+
+function findPrimary(secondary) {
+	candidate = secondary.prev();
+	while (!candidate.is('.primary')) {
+		candidate = candidate.prev();
+	}
+	return candidate;
+}
+
+function createSwitchItem(block, blockSwitch) {
+	blockName = block.children('.title').text();
+	content = block.children('.content').first().append(block.next('.colist'));
+	item = $('<div class="switch--item">' + blockName + '</div>');
+	item.on('click', '', content, function(e) {
+		$(this).addClass('selected');
+		$(this).siblings().removeClass('selected');
+		e.data.siblings('.content').addClass('hidden');
+		e.data.removeClass('hidden');
+	});
+	blockSwitch.append(item);
+	return {'item': item, 'content': content};
+}
+
+$(addBlockSwitches);
+</script>
+
+</head>
+<body id="getting-started" class="book toc2 toc-left">
+<div id="header">
+<h1>Getting Started</h1>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="#getting-started-introducing-spring-cloud-contract">1. Introducing Spring Cloud Contract</a>
+<ul class="sectlevel2">
+<li><a href="#getting-started-introducing-spring-cloud-contract-history">1.1. History</a>
+<ul class="sectlevel3">
+<li><a href="#getting-started-introducing-spring-cloud-contract-why">1.1.1. Why Do You Need It?</a></li>
+<li><a href="#getting-started-introducing-spring-cloud-contract-testing-issues">1.1.2. Testing Issues</a></li>
+</ul>
+</li>
+<li><a href="#getting-started-introducing-spring-cloud-contract-purposes">1.2. Purposes</a></li>
+<li><a href="#getting-started-what-is-a-contract">1.3. What Is a Contract?</a></li>
+</ul>
+</li>
+<li><a href="#getting-started-three-second-tour">2. A Three-second Tour</a>
+<ul class="sectlevel2">
+<li><a href="#getting-started-three-second-tour-producer">2.1. On the Producer Side</a></li>
+<li><a href="#getting-started-three-second-tour-consumer">2.2. On the Consumer Side</a></li>
+</ul>
+</li>
+<li><a href="#getting-started-first-application">3. Developing Your First Spring Cloud Contract-based Application</a>
+<ul class="sectlevel2">
+<li><a href="#getting-started-first-application-producer">3.1. On the Producer Side</a></li>
+<li><a href="#getting-started-first-application-consumer">3.2. On the Consumer Side</a></li>
+</ul>
+</li>
+<li><a href="#getting-started-cdc">4. Step-by-step Guide to Consumer Driven Contracts (CDC) with Contracts on the Producer Side</a>
+<ul class="sectlevel2">
+<li><a href="#getting-started-cdc-technical-note">4.1. Technical Note</a></li>
+<li><a href="#getting-started-cdc-consumer">4.2. The Consumer Side (Loan Issuance)</a>
+<ul class="sectlevel3">
+<li><a href="#getting-started-cdc-consumer-start">4.2.1. Start Doing TDD by Writing a Test for Your Feature</a></li>
+<li><a href="#getting-started-cdc-consumer-write">4.2.2. Write the Missing Implementation</a></li>
+<li><a href="#getting-started-cdc-consumer-clone">4.2.3. Clone the Fraud Detection service repository locally</a></li>
+<li><a href="#getting-started-cdc-consumer-define">4.2.4. Define the Contract Locally in the Repository of the Fraud Detection Service</a></li>
+<li><a href="#getting-started-cdc-consumer-add">4.2.5. Add the Spring Cloud Contract Verifier Plugin</a></li>
+<li><a href="#getting-started-cdc-consumer-run">4.2.6. Running the Integration Tests</a></li>
+<li><a href="#getting-started-cdc-consumer-file">4.2.7. Filing a Pull Request</a></li>
+</ul>
+</li>
+<li><a href="#getting-started-cdc-producer">4.3. The Producer Side (Fraud Detection server)</a>
+<ul class="sectlevel3">
+<li><a href="#getting-started-cdc-producer-pr">4.3.1. Taking over the Pull Request</a></li>
+<li><a href="#getting-started-cdc-producer-impl">4.3.2. Write the Missing Implementation</a></li>
+<li><a href="#getting-started-cdc-producer-deploy">4.3.3. Deploying Your Application</a></li>
+</ul>
+</li>
+<li><a href="#getting-started-cdc-consumer-final">4.4. Consumer Side (Loan Issuance), Final Step</a>
+<ul class="sectlevel3">
+<li><a href="#getting-started-cdc-consumer-final-merge">4.4.1. Merging a Branch to Master</a></li>
+<li><a href="#getting-started-cdc-consumer-final-online">4.4.2. Working Online</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#getting-started-whats-next">5. Next Steps</a></li>
+</ul>
+</div>
+</div>
+<div id="content">
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>If you are getting started with Spring Cloud Contract, or Spring in general, start by reading
+this section. It answers the basic &#8220;what?&#8221;, &#8220;how?&#8221; and &#8220;why?&#8221; questions. It
+includes an introduction to Spring Cloud Contract, along with installation instructions. We then
+walk you through building your first Spring Cloud Contract application, discussing some core
+principles as we go.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="getting-started-introducing-spring-cloud-contract"><a class="anchor" href="#getting-started-introducing-spring-cloud-contract"></a><a class="link" href="#getting-started-introducing-spring-cloud-contract">1. Introducing Spring Cloud Contract</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Spring Cloud Contract moves TDD to the level of software architecture.
+It lets you perform consumer-driven and producer-driven contract testing.</p>
+</div>
+<div class="sect2">
+<h3 id="getting-started-introducing-spring-cloud-contract-history"><a class="anchor" href="#getting-started-introducing-spring-cloud-contract-history"></a><a class="link" href="#getting-started-introducing-spring-cloud-contract-history">1.1. History</a></h3>
+<div class="paragraph">
+<p>Before becoming Spring Cloud Contract, this project was called <a href="https://github.com/Codearte/accurest">Accurest</a>.
+It was created by <a href="https://twitter.com/mgrzejszczak">Marcin Grzejszczak</a> and <a href="https://twitter.com/jkubrynski">Jakub Kubrynski</a>
+from (<a href="https://github.com/Codearte">Codearte</a>).</p>
+</div>
+<div class="paragraph">
+<p>The <code>0.1.0</code> release took place on 26 Jan 2015 and it became stable with <code>1.0.0</code> release on 29 Feb 2016.</p>
+</div>
+<div class="sect3">
+<h4 id="getting-started-introducing-spring-cloud-contract-why"><a class="anchor" href="#getting-started-introducing-spring-cloud-contract-why"></a><a class="link" href="#getting-started-introducing-spring-cloud-contract-why">1.1.1. Why Do You Need It?</a></h4>
+<div class="paragraph">
+<p>Assume that we have a system that consists of multiple microservices, as the following
+image shows:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/Deps.png" alt="Microservices Architecture">
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-introducing-spring-cloud-contract-testing-issues"><a class="anchor" href="#getting-started-introducing-spring-cloud-contract-testing-issues"></a><a class="link" href="#getting-started-introducing-spring-cloud-contract-testing-issues">1.1.2. Testing Issues</a></h4>
+<div class="paragraph">
+<p>If we want to test the application in the top left corner of the image in the preceding
+section to determine whether it can communicate with other services, we could do one of
+two things:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Deploy all microservices and perform end-to-end tests.</p>
+</li>
+<li>
+<p>Mock other microservices in unit and integration tests.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Both have their advantages but also a lot of disadvantages.</p>
+</div>
+<div class="paragraph">
+<p><strong>Deploy all microservices and perform end to end tests</strong></p>
+</div>
+<div class="paragraph">
+<p>Advantages:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Simulates production.</p>
+</li>
+<li>
+<p>Tests real communication between services.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Disadvantages:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>To test one microservice, we have to deploy six microservices, a couple of databases,
+and other items.</p>
+</li>
+<li>
+<p>The environment where the tests run is locked for a single suite of tests (nobody else
+would be able to run the tests in the meantime).</p>
+</li>
+<li>
+<p>They take a long time to run.</p>
+</li>
+<li>
+<p>The feedback comes very late in the process.</p>
+</li>
+<li>
+<p>They are extremely hard to debug.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p><strong>Mock other microservices in unit and integration tests</strong></p>
+</div>
+<div class="paragraph">
+<p>Advantages:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>They provide very fast feedback.</p>
+</li>
+<li>
+<p>They have no infrastructure requirements.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Disadvantages:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The implementor of the service creates stubs that might have nothing to do with
+reality.</p>
+</li>
+<li>
+<p>You can go to production with passing tests and failing production.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>To solve the aforementioned issues, Spring Cloud Contract was created. The main idea is to
+give you very fast feedback, without the need to set up the
+whole world of microservices. If you work on stubs, then the only applications you need
+are those that your application directly uses. The following image shows the relationship
+of stubs to an application:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/Stubs2.png" alt="Stubbed Services">
+</div>
+</div>
+<div class="paragraph">
+<p>Spring Cloud Contract gives you the certainty that the stubs that you use were
+created by the service that you call. Also, if you can use them, it means that they
+were tested against the producer&#8217;s side. In short, you can trust those stubs.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="getting-started-introducing-spring-cloud-contract-purposes"><a class="anchor" href="#getting-started-introducing-spring-cloud-contract-purposes"></a><a class="link" href="#getting-started-introducing-spring-cloud-contract-purposes">1.2. Purposes</a></h3>
+<div class="paragraph">
+<p>The main purposes of Spring Cloud Contract are:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>To ensure that HTTP and Messaging stubs (used when developing the client) do exactly
+what the actual server-side implementation does.</p>
+</li>
+<li>
+<p>To promote the ATDD (acceptance test-driven developement) method and the microservices architectural style.</p>
+</li>
+<li>
+<p>To provide a way to publish changes in contracts that are immediately visible on both sides.</p>
+</li>
+<li>
+<p>To generate boilerplate test code to be used on the server side.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>By default, Spring Cloud Contract integrates with <a href="http://wiremock.org">Wiremock</a> as the HTTP server stub.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Spring Cloud Contract&#8217;s purpose is NOT to start writing business
+features in the contracts. Assume that we have a business use case of fraud check. If a
+user can be a fraud for 100 different reasons, we would assume that you would create two
+contracts, one for the positive case and one for the negative case. Contract tests are
+used to test contracts between applications and not to simulate full behavior.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="getting-started-what-is-a-contract"><a class="anchor" href="#getting-started-what-is-a-contract"></a><a class="link" href="#getting-started-what-is-a-contract">1.3. What Is a Contract?</a></h3>
+<div class="paragraph">
+<p>As consumers of services, we need to define what exactly we want to achieve. We need to
+formulate our expectations. That is why we write contracts. In other words, a contract is
+an agreement on how the API or message communication should look. Consider the following example:</p>
+</div>
+<div class="paragraph">
+<p>Assume that you want to send a request that contains the ID of a client company and the
+amount it wants to borrow from us. You also want to send it to the <code>/fraudcheck</code> URL via
+the <code>PUT</code> method. The following listing shows a contract to check whether a client should
+be marked as a fraud in both Groovy and YAML:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">/*
+ * Copyright 2013-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package contracts
+
+org.springframework.cloud.contract.spec.Contract.make {
+    request { // (1)
+        method 'PUT' // (2)
+        url '/fraudcheck' // (3)
+        body([ // (4)
+               "client.id": $(regex('[0-9]{10}')),
+               loanAmount : 99999
+        ])
+        headers { // (5)
+            contentType('application/json')
+        }
+    }
+    response { // (6)
+        status OK() // (7)
+        body([ // (8)
+               fraudCheckStatus  : "FRAUD",
+               "rejection.reason": "Amount too high"
+        ])
+        headers { // (9)
+            contentType('application/json')
+        }
+    }
+}
+
+/*
+From the Consumer perspective, when shooting a request in the integration test:
+
+(1) - If the consumer sends a request
+(2) - With the "PUT" method
+(3) - to the URL "/fraudcheck"
+(4) - with the JSON body that
+ * has a field `client.id` that matches a regular expression `[0-9]{10}`
+ * has a field `loanAmount` that is equal to `99999`
+(5) - with header `Content-Type` equal to `application/json`
+(6) - then the response will be sent with
+(7) - status equal `200`
+(8) - and JSON body equal to
+ { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+(9) - with header `Content-Type` equal to `application/json`
+
+From the Producer perspective, in the autogenerated producer-side test:
+
+(1) - A request will be sent to the producer
+(2) - With the "PUT" method
+(3) - to the URL "/fraudcheck"
+(4) - with the JSON body that
+ * has a field `client.id` that will have a generated value that matches a regular expression `[0-9]{10}`
+ * has a field `loanAmount` that is equal to `99999`
+(5) - with header `Content-Type` equal to `application/json`
+(6) - then the test will assert if the response has been sent with
+(7) - status equal `200`
+(8) - and JSON body equal to
+ { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+(9) - with header `Content-Type` matching `application/json.*`
+ */</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yaml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">request: # (1)
+  method: PUT # (2)
+  url: /fraudcheck # (3)
+  body: # (4)
+    "client.id": 1234567890
+    loanAmount: 99999
+  headers: # (5)
+    Content-Type: application/json
+  matchers:
+    body:
+      - path: $.['client.id'] # (6)
+        type: by_regex
+        value: "[0-9]{10}"
+response: # (7)
+  status: 200 # (8)
+  body:  # (9)
+    fraudCheckStatus: "FRAUD"
+    "rejection.reason": "Amount too high"
+  headers: # (10)
+    Content-Type: application/json
+
+
+#From the Consumer perspective, when shooting a request in the integration test:
+#
+#(1) - If the consumer sends a request
+#(2) - With the "PUT" method
+#(3) - to the URL "/fraudcheck"
+#(4) - with the JSON body that
+# * has a field `client.id`
+# * has a field `loanAmount` that is equal to `99999`
+#(5) - with header `Content-Type` equal to `application/json`
+#(6) - and a `client.id` json entry matches the regular expression `[0-9]{10}`
+#(7) - then the response will be sent with
+#(8) - status equal `200`
+#(9) - and JSON body equal to
+# { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+#(10) - with header `Content-Type` equal to `application/json`
+#
+#From the Producer perspective, in the autogenerated producer-side test:
+#
+#(1) - A request will be sent to the producer
+#(2) - With the "PUT" method
+#(3) - to the URL "/fraudcheck"
+#(4) - with the JSON body that
+# * has a field `client.id` `1234567890`
+# * has a field `loanAmount` that is equal to `99999`
+#(5) - with header `Content-Type` equal to `application/json`
+#(7) - then the test will assert if the response has been sent with
+#(8) - status equal `200`
+#(9) - and JSON body equal to
+# { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+#(10) - with header `Content-Type` equal to `application/json`</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="getting-started-three-second-tour"><a class="anchor" href="#getting-started-three-second-tour"></a><a class="link" href="#getting-started-three-second-tour">2. A Three-second Tour</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This very brief tour walks through using Spring Cloud Contract. It consists of the
+following topics:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#getting-started-three-second-tour-producer">On the Producer Side</a></p>
+</li>
+<li>
+<p><a href="#getting-started-three-second-tour-consumer">On the Consumer Side</a></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>You can find a somewhat longer tour
+<a href="#getting-started-first-application">here</a>.</p>
+</div>
+<div class="paragraph">
+<p>The following UML diagram shows the relationship of the parts within Spring Cloud Contract:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/getting-started-three-second.png" alt="getting started three second" width="986" height="704">
+</div>
+</div>
+<div class="sect2">
+<h3 id="getting-started-three-second-tour-producer"><a class="anchor" href="#getting-started-three-second-tour-producer"></a><a class="link" href="#getting-started-three-second-tour-producer">2.1. On the Producer Side</a></h3>
+<div class="paragraph">
+<p>To start working with Spring Cloud Contract, you can add files with REST or messaging contracts
+expressed in either Groovy DSL or YAML to the contracts directory, which is set by the
+<code>contractsDslDir</code> property. By default, it is <code>$rootDir/src/test/resources/contracts</code>.</p>
+</div>
+<div class="paragraph">
+<p>Then you can add the Spring Cloud Contract Verifier dependency and plugin to your build file, as
+the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-starter-contract-verifier&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following listing shows how to add the plugin, which should go in the build/plugins
+portion of the file:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Running <code>./mvnw clean install</code> automatically generates tests that verify the application
+compliance with the added contracts. By default, the tests get generated under
+<code>org.springframework.cloud.contract.verifier.tests.</code>.</p>
+</div>
+<div class="paragraph">
+<p>As the implementation of the functionalities described by the contracts is not yet
+present, the tests fail.</p>
+</div>
+<div class="paragraph">
+<p>To make them pass, you must add the correct implementation of either handling HTTP
+requests or messages. Also, you must add a correct base test class for auto-generated
+tests to the project. This class is extended by all the auto-generated tests, and it
+should contain all the setup information necessary to run them (for example <code>RestAssuredMockMvc</code>
+controller setup or messaging test setup).</p>
+</div>
+<div class="paragraph">
+<p>Once the implementation and the test base class are in place, the tests pass, and both the
+application and the stub artifacts are built and installed in the local Maven repository.
+You can now merge the changes, and you can publish both the application and the stub artifacts
+in an online repository.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="getting-started-three-second-tour-consumer"><a class="anchor" href="#getting-started-three-second-tour-consumer"></a><a class="link" href="#getting-started-three-second-tour-consumer">2.2. On the Consumer Side</a></h3>
+<div class="paragraph">
+<p>You can use <code>Spring Cloud Contract Stub Runner</code> in the integration tests to get a running
+WireMock instance or messaging route that simulates the actual service.</p>
+</div>
+<div class="paragraph">
+<p>To do so, add the dependency to <code>Spring Cloud Contract Stub Runner</code>, as the
+following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-starter-contract-stub-runner&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can get the Producer-side stubs installed in your Maven repository in either of two
+ways:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>By checking out the Producer side repository and adding contracts and generating the stubs
+by running the following commands:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ cd local-http-server-repo
+$ ./mvnw clean install -DskipTests</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+The tests are being skipped because the producer-side contract implementation is not
+in place yet, so the automatically-generated contract tests fail.
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>By getting already-existing producer service stubs from a remote repository. To do so,
+pass the stub artifact IDs and artifact repository URL as <code>Spring Cloud Contract
+Stub Runner</code> properties, as the following example shows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">stubrunner:
+  ids: 'com.example:http-server-dsl:+:stubs:8080'
+  repositoryRoot: https://repo.spring.io/libs-snapshot</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Now you can annotate your test class with <code>@AutoConfigureStubRunner</code>. In the annotation,
+provide the <code>group-id</code> and <code>artifact-id</code> values for <code>Spring Cloud Contract Stub Runner</code> to
+run the collaborators' stubs for you, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment=WebEnvironment.NONE)
+@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:stubs:6565"},
+        stubsMode = StubRunnerProperties.StubsMode.LOCAL)
+public class LoanApplicationServiceTests {</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+Use the <code>REMOTE</code> <code>stubsMode</code> when downloading stubs from an online repository and
+<code>LOCAL</code> for offline work.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Now, in your integration test, you can receive stubbed versions of HTTP responses or
+messages that are expected to be emitted by the collaborator service.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="getting-started-first-application"><a class="anchor" href="#getting-started-first-application"></a><a class="link" href="#getting-started-first-application">3. Developing Your First Spring Cloud Contract-based Application</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This brief tour walks through using Spring Cloud Contract. It consists of the following topics:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#getting-started-first-application-producer">On the Producer Side</a></p>
+</li>
+<li>
+<p><a href="#getting-started-first-application-consumer">On the Consumer Side</a></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>You can find an even more brief tour
+<a href="#getting-started-three-second-tour">here</a>.</p>
+</div>
+<div class="paragraph">
+<p>For the sake of this example, the <code>Stub Storage</code> is Nexus/Artifactory.</p>
+</div>
+<div class="paragraph">
+<p>The following UML diagram shows the relationship of the parts of Spring Cloud Contract:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/getting-started-three-second.png" alt="Getting started first application">
+</div>
+</div>
+<div class="sect2">
+<h3 id="getting-started-first-application-producer"><a class="anchor" href="#getting-started-first-application-producer"></a><a class="link" href="#getting-started-first-application-producer">3.1. On the Producer Side</a></h3>
+<div class="paragraph">
+<p>To start working with <code>Spring Cloud Contract</code>, you can add Spring Cloud Contract Verifier
+dependency and plugin to your build file, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-starter-contract-verifier&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following listing shows how to add the plugin, which should go in the build/plugins
+portion of the file:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Now you can add files with <code>REST/</code> messaging contracts
+expressed in either Groovy DSL or YAML to the contracts directory, which is set by the
+<code>contractsDslDir</code> property. By default, it is <code>$rootDir/src/test/resources/contracts</code>.</p>
+</div>
+<div class="paragraph">
+<p>For the HTTP stubs, a contract defines what kind of response should be returned for a
+given request (taking into account the HTTP methods, URLs, headers, status codes, and so
+on). The following example shows an HTTP stub contract in both Groovy and YAML:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package contracts
+
+org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method 'PUT'
+        url '/fraudcheck'
+        body([
+               "client.id": $(regex('[0-9]{10}')),
+               loanAmount: 99999
+        ])
+        headers {
+            contentType('application/json')
+        }
+    }
+    response {
+        status OK()
+        body([
+               fraudCheckStatus: "FRAUD",
+               "rejection.reason": "Amount too high"
+        ])
+        headers {
+            contentType('application/json')
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yaml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">request:
+  method: PUT
+  url: /fraudcheck
+  body:
+    "client.id": 1234567890
+    loanAmount: 99999
+  headers:
+    Content-Type: application/json
+  matchers:
+    body:
+      - path: $.['client.id']
+        type: by_regex
+        value: "[0-9]{10}"
+response:
+  status: 200
+  body:
+    fraudCheckStatus: "FRAUD"
+    "rejection.reason": "Amount too high"
+  headers:
+    Content-Type: application/json;charset=UTF-8</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In the case of messaging, you can define:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The input and output messages (taking into account from and where it
+was sent, the message body, and the header).</p>
+</li>
+<li>
+<p>The methods that should be called after the message is received.</p>
+</li>
+<li>
+<p>The methods that, when called, should trigger a message.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The following example shows a Camel messaging contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">def contractDsl = Contract.make {
+    name "foo"
+    label 'some_label'
+    input {
+        messageFrom('jms:delete')
+        messageBody([
+                bookName: 'foo'
+        ])
+        messageHeaders {
+            header('sample', 'header')
+        }
+        assertThat('bookWasDeleted()')
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yaml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">label: some_label
+input:
+  messageFrom: jms:delete
+  messageBody:
+    bookName: 'foo'
+  messageHeaders:
+    sample: header
+  assertThat: bookWasDeleted()</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Running <code>./mvnw clean install</code> automatically generates tests that verify the application
+compliance with the added contracts. By default, the generated tests are under
+<code>org.springframework.cloud.contract.verifier.tests.</code>.</p>
+</div>
+<div class="paragraph">
+<p>The generated tests may differ, depending on which framework and test type you have setup in your plugin.</p>
+</div>
+<div class="paragraph">
+<p>In the next listing, you can find:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The default test mode for HTTP contracts in <code>MockMvc</code></p>
+</li>
+<li>
+<p>A JAX-RS client with the <code>JAXRS</code> test mode</p>
+</li>
+<li>
+<p>A <code>WebTestClient</code>-based test (this is particularly recommended while working with
+Reactive, <code>Web-Flux</code>-based applications) set with the <code>WEBTESTCLIENT</code> test mode</p>
+</li>
+<li>
+<p>A Spock-based test with the <code>testFramework</code> property set to <code>SPOCK</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The following listing shows all these samples:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">mockmvc</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
+public void validate_shouldMarkClientAsFraud() throws Exception {
+    // given:
+        MockMvcRequestSpecification request = given()
+                .header("Content-Type", "application/vnd.fraud.v1+json")
+                .body("{\"client.id\":\"1234567890\",\"loanAmount\":99999}");
+
+    // when:
+        ResponseOptions response = given().spec(request)
+                .put("/fraudcheck");
+
+    // then:
+        assertThat(response.statusCode()).isEqualTo(200);
+        assertThat(response.header("Content-Type")).matches("application/vnd.fraud.v1.json.*");
+    // and:
+        DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
+        assertThatJson(parsedJson).field("['fraudCheckStatus']").matches("[A-Z]{5}");
+        assertThatJson(parsedJson).field("['rejection.reason']").isEqualTo("Amount too high");
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">jaxrs</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@SuppressWarnings("rawtypes")
+public class FooTest {
+  WebTarget webTarget;
+
+  @Test
+  public void validate_() throws Exception {
+
+    // when:
+      Response response = webTarget
+              .path("/users")
+              .queryParam("limit", "10")
+              .queryParam("offset", "20")
+              .queryParam("filter", "email")
+              .queryParam("sort", "name")
+              .queryParam("search", "55")
+              .queryParam("age", "99")
+              .queryParam("name", "Denis.Stepanov")
+              .queryParam("email", "bob@email.com")
+              .request()
+              .build("GET")
+              .invoke();
+      String responseAsString = response.readEntity(String.class);
+
+    // then:
+      assertThat(response.getStatus()).isEqualTo(200);
+
+    // and:
+      DocumentContext parsedJson = JsonPath.parse(responseAsString);
+      assertThatJson(parsedJson).field("['property1']").isEqualTo("a");
+  }
+
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">webtestclient</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
+    public void validate_shouldRejectABeerIfTooYoung() throws Exception {
+        // given:
+            WebTestClientRequestSpecification request = given()
+                    .header("Content-Type", "application/json")
+                    .body("{\"age\":10}");
+
+        // when:
+            WebTestClientResponse response = given().spec(request)
+                    .post("/check");
+
+        // then:
+            assertThat(response.statusCode()).isEqualTo(200);
+            assertThat(response.header("Content-Type")).matches("application/json.*");
+        // and:
+            DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
+            assertThatJson(parsedJson).field("['status']").isEqualTo("NOT_OK");
+    }</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">spock</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">given:
+     ContractVerifierMessage inputMessage = contractVerifierMessaging.create(
+        \'\'\'{"bookName":"foo"}\'\'\',
+        ['sample': 'header']
+    )
+
+when:
+     contractVerifierMessaging.send(inputMessage, 'jms:delete')
+
+then:
+     noExceptionThrown()
+     bookWasDeleted()</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>As the implementation of the functionalities described by the contracts is not yet
+present, the tests fail.</p>
+</div>
+<div class="paragraph">
+<p>To make them pass, you must add the correct implementation of handling either HTTP
+requests or messages. Also, you must add a correct base test class for auto-generated
+tests to the project. This class is extended by all the auto-generated tests and should
+contain all the setup necessary information needed to run them (for example,
+<code>RestAssuredMockMvc</code> controller setup or messaging test setup).</p>
+</div>
+<div class="paragraph">
+<p>Once the implementation and the test base class are in place, the tests pass, and both the
+application and the stub artifacts are built and installed in the local Maven repository.
+Information about installing the stubs jar to the local repository appears in the logs, as
+the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">[INFO] --- spring-cloud-contract-maven-plugin:1.0.0.BUILD-SNAPSHOT:generateStubs (default-generateStubs) @ http-server ---
+[INFO] Building jar: /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar
+[INFO]
+[INFO] --- maven-jar-plugin:2.6:jar (default-jar) @ http-server ---
+[INFO] Building jar: /some/path/http-server/target/http-server-0.0.1-SNAPSHOT.jar
+[INFO]
+[INFO] --- spring-boot-maven-plugin:1.5.5.BUILD-SNAPSHOT:repackage (default) @ http-server ---
+[INFO]
+[INFO] --- maven-install-plugin:2.5.2:install (default-install) @ http-server ---
+[INFO] Installing /some/path/http-server/target/http-server-0.0.1-SNAPSHOT.jar to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT.jar
+[INFO] Installing /some/path/http-server/pom.xml to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT.pom
+[INFO] Installing /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can now merge the changes and publish both the application and the stub artifacts
+in an online repository.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="getting-started-first-application-consumer"><a class="anchor" href="#getting-started-first-application-consumer"></a><a class="link" href="#getting-started-first-application-consumer">3.2. On the Consumer Side</a></h3>
+<div class="paragraph">
+<p>You can use Spring Cloud Contract Stub Runner in the integration tests to get a running
+WireMock instance or messaging route that simulates the actual service.</p>
+</div>
+<div class="paragraph">
+<p>To get started, add the dependency to <code>Spring Cloud Contract Stub Runner</code>, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-starter-contract-stub-runner&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can get the Producer-side stubs installed in your Maven repository in either of two
+ways:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>By checking out the Producer side repository and adding contracts and generating the
+stubs by running the following commands:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ cd local-http-server-repo
+$ ./mvnw clean install -DskipTests</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+The tests are skipped because the Producer-side contract implementation is not yet
+in place, so the automatically-generated contract tests fail.
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>Getting already existing producer service stubs from a remote repository. To do so,
+pass the stub artifact IDs and artifact repository URl as <code>Spring Cloud Contract Stub
+Runner</code> properties, as the following example shows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">stubrunner:
+  ids: 'com.example:http-server-dsl:+:stubs:8080'
+  repositoryRoot: https://repo.spring.io/libs-snapshot</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Now you can annotate your test class with <code>@AutoConfigureStubRunner</code>. In the annotation,
+provide the <code>group-id</code> and <code>artifact-id</code> for <code>Spring Cloud Contract Stub Runner</code> to run
+the collaborators' stubs for you, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment=WebEnvironment.NONE)
+@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:stubs:6565"},
+        stubsMode = StubRunnerProperties.StubsMode.LOCAL)
+public class LoanApplicationServiceTests {</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+Use the <code>REMOTE</code> <code>stubsMode</code> when downloading stubs from an online repository and
+<code>LOCAL</code> for offline work.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>In your integration test, you can receive stubbed versions of HTTP responses or messages
+that are expected to be emitted by the collaborator service. You can see entries similar
+to the following in the build logs:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">2016-07-19 14:22:25.403  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Desired version is + - will try to resolve the latest version
+2016-07-19 14:22:25.438  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolved version is 0.0.1-SNAPSHOT
+2016-07-19 14:22:25.439  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolving artifact com.example:http-server:jar:stubs:0.0.1-SNAPSHOT using remote repositories []
+2016-07-19 14:22:25.451  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolved artifact com.example:http-server:jar:stubs:0.0.1-SNAPSHOT to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar
+2016-07-19 14:22:25.465  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Unpacking stub from JAR [URI: file:/path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar]
+2016-07-19 14:22:25.475  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Unpacked file to [/var/folders/0p/xwq47sq106x1_g3dtv6qfm940000gq/T/contracts100276532569594265]
+2016-07-19 14:22:27.737  INFO 41050 --- [           main] o.s.c.c.stubrunner.StubRunnerExecutor    : All stubs are now running RunningStubs [namesAndPorts={com.example:http-server:0.0.1-SNAPSHOT:stubs=8080}]</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="getting-started-cdc"><a class="anchor" href="#getting-started-cdc"></a><a class="link" href="#getting-started-cdc">4. Step-by-step Guide to Consumer Driven Contracts (CDC) with Contracts on the Producer Side</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Consider an example of fraud detection and the loan issuance process. The business
+scenario is such that we want to issue loans to people but do not want them to steal from
+us. The current implementation of our system grants loans to everybody.</p>
+</div>
+<div class="paragraph">
+<p>Assume that <code>Loan Issuance</code> is a client to the <code>Fraud Detection</code> server. In the current
+sprint, we must develop a new feature: if a client wants to borrow too much money,
+we mark the client as a fraud.</p>
+</div>
+<div class="paragraph">
+<p>Technical remarks</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Fraud Detection has an <code>artifact-id</code> of <code>http-server</code></p>
+</li>
+<li>
+<p>Loan Issuance has an artifact-id of <code>http-client</code></p>
+</li>
+<li>
+<p>Both have a <code>group-id</code> of <code>com.example</code></p>
+</li>
+<li>
+<p>For the sake of this example the <code>Stub Storage</code> is Nexus/Artifactory</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Social remarks</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Both the client and the server development teams need to communicate directly and
+discuss changes while going through the process</p>
+</li>
+<li>
+<p>CDC is all about communication</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The <a href="https://github.com/spring-cloud/spring-cloud-contract/tree/{branch}/samples/standalone/dsl/http-server">server-side
+code is available here</a> and <a href="https://github.com/spring-cloud/spring-cloud-contract/tree/{branch}/samples/standalone/dsl/http-client">the client code  is available here</a>.</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+In this case, the producer owns the contracts. Physically, all of the contracts are
+in the producer&#8217;s repository.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2">
+<h3 id="getting-started-cdc-technical-note"><a class="anchor" href="#getting-started-cdc-technical-note"></a><a class="link" href="#getting-started-cdc-technical-note">4.1. Technical Note</a></h3>
+<div class="paragraph">
+<p>If you use the SNAPSHOT, Milestone, or Release Candidate versions you need to add the
+following section to your build:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;repositories&gt;
+    &lt;repository&gt;
+        &lt;id&gt;spring-snapshots&lt;/id&gt;
+        &lt;name&gt;Spring Snapshots&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;true&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/repository&gt;
+    &lt;repository&gt;
+        &lt;id&gt;spring-milestones&lt;/id&gt;
+        &lt;name&gt;Spring Milestones&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/repository&gt;
+    &lt;repository&gt;
+        &lt;id&gt;spring-releases&lt;/id&gt;
+        &lt;name&gt;Spring Releases&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/repository&gt;
+&lt;/repositories&gt;
+&lt;pluginRepositories&gt;
+    &lt;pluginRepository&gt;
+        &lt;id&gt;spring-snapshots&lt;/id&gt;
+        &lt;name&gt;Spring Snapshots&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;true&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/pluginRepository&gt;
+    &lt;pluginRepository&gt;
+        &lt;id&gt;spring-milestones&lt;/id&gt;
+        &lt;name&gt;Spring Milestones&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/pluginRepository&gt;
+    &lt;pluginRepository&gt;
+        &lt;id&gt;spring-releases&lt;/id&gt;
+        &lt;name&gt;Spring Releases&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/pluginRepository&gt;
+&lt;/pluginRepositories&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">repositories {
+    mavenCentral()
+    mavenLocal()
+    maven { url "https://repo.spring.io/snapshot" }
+    maven { url "https://repo.spring.io/milestone" }
+    maven { url "https://repo.spring.io/release" }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>For simplicity, we use the following acronyms:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Loan Issuance (LI): The HTTP client</p>
+</li>
+<li>
+<p>Fraud Detection (FD): The HTTP server</p>
+</li>
+<li>
+<p>Spring Cloud Contract (SCC)</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="getting-started-cdc-consumer"><a class="anchor" href="#getting-started-cdc-consumer"></a><a class="link" href="#getting-started-cdc-consumer">4.2. The Consumer Side (Loan Issuance)</a></h3>
+<div class="paragraph">
+<p>As a developer of the Loan Issuance service (a consumer of the Fraud Detection server), you might do the following steps:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Start doing TDD by writing a test for your feature.</p>
+</li>
+<li>
+<p>Write the missing implementation.</p>
+</li>
+<li>
+<p>Clone the Fraud Detection service repository locally.</p>
+</li>
+<li>
+<p>Define the contract locally in the repo of the fraud detection service.</p>
+</li>
+<li>
+<p>Add the Spring Cloud Contract (SCC) plugin.</p>
+</li>
+<li>
+<p>Run the integration tests.</p>
+</li>
+<li>
+<p>File a pull request.</p>
+</li>
+<li>
+<p>Create an initial implementation.</p>
+</li>
+<li>
+<p>Take over the pull request.</p>
+</li>
+<li>
+<p>Write the missing implementation.</p>
+</li>
+<li>
+<p>Deploy your app.</p>
+</li>
+<li>
+<p>Work online.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>We start with the loan issuance flow, which the following UML diagram shows:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/getting-started-cdc-client.png" alt="getting started cdc client" width="1138" height="1223">
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-cdc-consumer-start"><a class="anchor" href="#getting-started-cdc-consumer-start"></a><a class="link" href="#getting-started-cdc-consumer-start">4.2.1. Start Doing TDD by Writing a Test for Your Feature</a></h4>
+<div class="paragraph">
+<p>The following listing shows a test that we might use to check whether a loan amount is too
+large:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@Test
+public void shouldBeRejectedDueToAbnormalLoanAmount() {
+    // given:
+    LoanApplication application = new LoanApplication(new Client("1234567890"),
+            99999);
+    // when:
+    LoanApplicationResult loanApplication = service.loanApplication(application);
+    // then:
+    assertThat(loanApplication.getLoanApplicationStatus())
+            .isEqualTo(LoanApplicationStatus.LOAN_APPLICATION_REJECTED);
+    assertThat(loanApplication.getRejectionReason()).isEqualTo("Amount too high");
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Assume that you have written a test of your new feature. If a loan application for a big
+amount is received, the system should reject that loan application with some description.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-cdc-consumer-write"><a class="anchor" href="#getting-started-cdc-consumer-write"></a><a class="link" href="#getting-started-cdc-consumer-write">4.2.2. Write the Missing Implementation</a></h4>
+<div class="paragraph">
+<p>At some point in time, you need to send a request to the Fraud Detection service. Assume
+that you need to send the request containing the ID of the client and the amount the
+client wants to borrow. You want to send it to the <code>/fraudcheck</code> URL by using the <code>PUT</code> method.
+To do so, you might use code similar to the following:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">ResponseEntity&lt;FraudServiceResponse&gt; response = restTemplate.exchange(
+        "http://localhost:" + port + "/fraudcheck", HttpMethod.PUT,
+        new HttpEntity&lt;&gt;(request, httpHeaders), FraudServiceResponse.class);</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>For simplicity, the port of the Fraud Detection service is set to <code>8080</code>, and the
+application runs on <code>8090</code>.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+If you start the test at this point, it breaks, because no service currently runs on port
+<code>8080</code>.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-cdc-consumer-clone"><a class="anchor" href="#getting-started-cdc-consumer-clone"></a><a class="link" href="#getting-started-cdc-consumer-clone">4.2.3. Clone the Fraud Detection service repository locally</a></h4>
+<div class="paragraph">
+<p>You can start by playing around with the server side contract. To do so, you must first
+clone it, by running the following command:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ git clone https://your-git-server.com/server-side.git local-http-server-repo</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-cdc-consumer-define"><a class="anchor" href="#getting-started-cdc-consumer-define"></a><a class="link" href="#getting-started-cdc-consumer-define">4.2.4. Define the Contract Locally in the Repository of the Fraud Detection Service</a></h4>
+<div class="paragraph">
+<p>As a consumer, you need to define what exactly you want to achieve. You need to formulate
+your expectations. To do so, write the following contract:</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Place the contract in the <code>src/test/resources/contracts/fraud</code> folder. The <code>fraud</code> folder
+is important because the producer&#8217;s test base class name references that folder.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following example shows our contract, in both Groovy and YAML:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">/*
+ * Copyright 2013-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package contracts
+
+org.springframework.cloud.contract.spec.Contract.make {
+    request { // (1)
+        method 'PUT' // (2)
+        url '/fraudcheck' // (3)
+        body([ // (4)
+               "client.id": $(regex('[0-9]{10}')),
+               loanAmount : 99999
+        ])
+        headers { // (5)
+            contentType('application/json')
+        }
+    }
+    response { // (6)
+        status OK() // (7)
+        body([ // (8)
+               fraudCheckStatus  : "FRAUD",
+               "rejection.reason": "Amount too high"
+        ])
+        headers { // (9)
+            contentType('application/json')
+        }
+    }
+}
+
+/*
+From the Consumer perspective, when shooting a request in the integration test:
+
+(1) - If the consumer sends a request
+(2) - With the "PUT" method
+(3) - to the URL "/fraudcheck"
+(4) - with the JSON body that
+ * has a field `client.id` that matches a regular expression `[0-9]{10}`
+ * has a field `loanAmount` that is equal to `99999`
+(5) - with header `Content-Type` equal to `application/json`
+(6) - then the response will be sent with
+(7) - status equal `200`
+(8) - and JSON body equal to
+ { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+(9) - with header `Content-Type` equal to `application/json`
+
+From the Producer perspective, in the autogenerated producer-side test:
+
+(1) - A request will be sent to the producer
+(2) - With the "PUT" method
+(3) - to the URL "/fraudcheck"
+(4) - with the JSON body that
+ * has a field `client.id` that will have a generated value that matches a regular expression `[0-9]{10}`
+ * has a field `loanAmount` that is equal to `99999`
+(5) - with header `Content-Type` equal to `application/json`
+(6) - then the test will assert if the response has been sent with
+(7) - status equal `200`
+(8) - and JSON body equal to
+ { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+(9) - with header `Content-Type` matching `application/json.*`
+ */</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yaml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">request: # (1)
+  method: PUT # (2)
+  url: /fraudcheck # (3)
+  body: # (4)
+    "client.id": 1234567890
+    loanAmount: 99999
+  headers: # (5)
+    Content-Type: application/json
+  matchers:
+    body:
+      - path: $.['client.id'] # (6)
+        type: by_regex
+        value: "[0-9]{10}"
+response: # (7)
+  status: 200 # (8)
+  body:  # (9)
+    fraudCheckStatus: "FRAUD"
+    "rejection.reason": "Amount too high"
+  headers: # (10)
+    Content-Type: application/json
+
+
+#From the Consumer perspective, when shooting a request in the integration test:
+#
+#(1) - If the consumer sends a request
+#(2) - With the "PUT" method
+#(3) - to the URL "/fraudcheck"
+#(4) - with the JSON body that
+# * has a field `client.id`
+# * has a field `loanAmount` that is equal to `99999`
+#(5) - with header `Content-Type` equal to `application/json`
+#(6) - and a `client.id` json entry matches the regular expression `[0-9]{10}`
+#(7) - then the response will be sent with
+#(8) - status equal `200`
+#(9) - and JSON body equal to
+# { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+#(10) - with header `Content-Type` equal to `application/json`
+#
+#From the Producer perspective, in the autogenerated producer-side test:
+#
+#(1) - A request will be sent to the producer
+#(2) - With the "PUT" method
+#(3) - to the URL "/fraudcheck"
+#(4) - with the JSON body that
+# * has a field `client.id` `1234567890`
+# * has a field `loanAmount` that is equal to `99999`
+#(5) - with header `Content-Type` equal to `application/json`
+#(7) - then the test will assert if the response has been sent with
+#(8) - status equal `200`
+#(9) - and JSON body equal to
+# { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+#(10) - with header `Content-Type` equal to `application/json`</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The YML contract is quite straightforward. However, when you take a look at the Contract
+written with a statically typed Groovy DSL, you might wonder what the
+<code>value(client(&#8230;&#8203;), server(&#8230;&#8203;))</code> parts are. By using this notation, Spring Cloud
+Contract lets you define parts of a JSON block, a URL, or other structure that is dynamic. In case
+of an identifier or a timestamp, you need not hardcode a value. You want to allow some
+different ranges of values. To enable ranges of values, you can set regular expressions
+that match those values for the consumer side. You can provide the body by means of either
+a map notation or String with interpolations. We highly recommend using the map notation.</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+You must understand the map notation in order to set up contracts. See the
+<a href="https://groovy-lang.org/json.html">Groovy docs regarding JSON</a>.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The previously shown contract is an agreement between two sides that:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>If an HTTP request is sent with all of</p>
+<div class="ulist">
+<ul>
+<li>
+<p>A <code>PUT</code> method on the <code>/fraudcheck</code> endpoint</p>
+</li>
+<li>
+<p>A JSON body with a <code>client.id</code> that matches the regular expression <code>[0-9]{10}</code> and
+<code>loanAmount</code> equal to <code>99999</code>,</p>
+</li>
+<li>
+<p>A <code>Content-Type</code> header with a value of <code>application/vnd.fraud.v1+json</code></p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Then an HTTP response is sent to the consumer that</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Has status <code>200</code></p>
+</li>
+<li>
+<p>Contains a JSON body with the <code>fraudCheckStatus</code> field containing a value of <code>FRAUD</code> and
+the <code>rejectionReason</code> field having a value of <code>Amount too high</code></p>
+</li>
+<li>
+<p>Has a <code>Content-Type</code> header with a value of <code>application/vnd.fraud.v1+json</code></p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Once you are ready to check the API in practice in the integration tests, you need to
+install the stubs locally.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-cdc-consumer-add"><a class="anchor" href="#getting-started-cdc-consumer-add"></a><a class="link" href="#getting-started-cdc-consumer-add">4.2.5. Add the Spring Cloud Contract Verifier Plugin</a></h4>
+<div class="paragraph">
+<p>We can add either a Maven or a Gradle plugin. In this example, we show how to add Maven.
+First, we add the <code>Spring Cloud Contract</code> BOM, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependencyManagement&gt;
+    &lt;dependencies&gt;
+        &lt;dependency&gt;
+            &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+            &lt;artifactId&gt;spring-cloud-dependencies&lt;/artifactId&gt;
+            &lt;version&gt;${spring-cloud-release.version}&lt;/version&gt;
+            &lt;type&gt;pom&lt;/type&gt;
+            &lt;scope&gt;import&lt;/scope&gt;
+        &lt;/dependency&gt;
+    &lt;/dependencies&gt;
+&lt;/dependencyManagement&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Next, add the <code>Spring Cloud Contract Verifier</code> Maven plugin, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;packageWithBaseClasses&gt;com.example.fraud&lt;/packageWithBaseClasses&gt;
+        &lt;convertToYaml&gt;true&lt;/convertToYaml&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Since the plugin was added, you get the <code>Spring Cloud Contract Verifier</code> features, which,
+from the provided contracts:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Generate and run tests</p>
+</li>
+<li>
+<p>Produce and install stubs</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>You do not want to generate tests, since you, as the consumer, want only to play with the
+stubs. You need to skip the test generation and execution. To do so, run the following commands:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ cd local-http-server-repo
+$ ./mvnw clean install -DskipTests</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Once you run those commands, you should you see something like the following content in the logs:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">[INFO] --- spring-cloud-contract-maven-plugin:1.0.0.BUILD-SNAPSHOT:generateStubs (default-generateStubs) @ http-server ---
+[INFO] Building jar: /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar
+[INFO]
+[INFO] --- maven-jar-plugin:2.6:jar (default-jar) @ http-server ---
+[INFO] Building jar: /some/path/http-server/target/http-server-0.0.1-SNAPSHOT.jar
+[INFO]
+[INFO] --- spring-boot-maven-plugin:1.5.5.BUILD-SNAPSHOT:repackage (default) @ http-server ---
+[INFO]
+[INFO] --- maven-install-plugin:2.5.2:install (default-install) @ http-server ---
+[INFO] Installing /some/path/http-server/target/http-server-0.0.1-SNAPSHOT.jar to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT.jar
+[INFO] Installing /some/path/http-server/pom.xml to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT.pom
+[INFO] Installing /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following line is extremely important:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">[INFO] Installing /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>It confirms that the stubs of the <code>http-server</code> have been installed in the local
+repository.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-cdc-consumer-run"><a class="anchor" href="#getting-started-cdc-consumer-run"></a><a class="link" href="#getting-started-cdc-consumer-run">4.2.6. Running the Integration Tests</a></h4>
+<div class="paragraph">
+<p>In order to profit from the Spring Cloud Contract Stub Runner functionality of automatic
+stub downloading, you must do the following in your consumer side project (<code>Loan
+Application service</code>):</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Add the <code>Spring Cloud Contract</code> BOM, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependencyManagement&gt;
+    &lt;dependencies&gt;
+        &lt;dependency&gt;
+            &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+            &lt;artifactId&gt;spring-cloud-dependencies&lt;/artifactId&gt;
+            &lt;version&gt;${spring-cloud-release-train.version}&lt;/version&gt;
+            &lt;type&gt;pom&lt;/type&gt;
+            &lt;scope&gt;import&lt;/scope&gt;
+        &lt;/dependency&gt;
+    &lt;/dependencies&gt;
+&lt;/dependencyManagement&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Add the dependency to <code>Spring Cloud Contract Stub Runner</code>, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-starter-contract-stub-runner&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Annotate your test class with <code>@AutoConfigureStubRunner</code>. In the annotation, provide the
+<code>group-id</code> and <code>artifact-id</code> for the Stub Runner to download the stubs of your
+collaborators. (Optional step) Because you are playing with the collaborators offline, you
+can also provide the offline work switch (<code>StubRunnerProperties.StubsMode.LOCAL</code>).</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment = WebEnvironment.NONE)
+@AutoConfigureStubRunner(ids = {
+        "com.example:http-server-dsl:+:stubs:6565" }, stubsMode = StubRunnerProperties.StubsMode.LOCAL)
+public class LoanApplicationServiceTests {</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Now, when you run your tests, you see something like the following output in the logs:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">2016-07-19 14:22:25.403  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Desired version is + - will try to resolve the latest version
+2016-07-19 14:22:25.438  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolved version is 0.0.1-SNAPSHOT
+2016-07-19 14:22:25.439  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolving artifact com.example:http-server:jar:stubs:0.0.1-SNAPSHOT using remote repositories []
+2016-07-19 14:22:25.451  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolved artifact com.example:http-server:jar:stubs:0.0.1-SNAPSHOT to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar
+2016-07-19 14:22:25.465  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Unpacking stub from JAR [URI: file:/path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar]
+2016-07-19 14:22:25.475  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Unpacked file to [/var/folders/0p/xwq47sq106x1_g3dtv6qfm940000gq/T/contracts100276532569594265]
+2016-07-19 14:22:27.737  INFO 41050 --- [           main] o.s.c.c.stubrunner.StubRunnerExecutor    : All stubs are now running RunningStubs [namesAndPorts={com.example:http-server:0.0.1-SNAPSHOT:stubs=8080}]</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>This output means that Stub Runner has found your stubs and started a server for your application
+with a group ID of <code>com.example</code> and an artifact ID of <code>http-server</code> with version <code>0.0.1-SNAPSHOT</code> of
+the stubs and with the <code>stubs</code> classifier on port <code>8080</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-cdc-consumer-file"><a class="anchor" href="#getting-started-cdc-consumer-file"></a><a class="link" href="#getting-started-cdc-consumer-file">4.2.7. Filing a Pull Request</a></h4>
+<div class="paragraph">
+<p>What you have done until now is an iterative process. You can play around with the
+contract, install it locally, and work on the consumer side until the contract works as
+you wish.</p>
+</div>
+<div class="paragraph">
+<p>Once you are satisfied with the results and the test passes, you can publish a pull request to
+the server side. Currently, the consumer side work is done.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="getting-started-cdc-producer"><a class="anchor" href="#getting-started-cdc-producer"></a><a class="link" href="#getting-started-cdc-producer">4.3. The Producer Side (Fraud Detection server)</a></h3>
+<div class="paragraph">
+<p>As a developer of the Fraud Detection server (a server to the Loan Issuance service), you
+might want to do the following</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Take over the pull request</p>
+</li>
+<li>
+<p>Write the missing implementation</p>
+</li>
+<li>
+<p>Deploy the application</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The following UML diagram shows the fraud detection flow:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/getting-started-cdc-server.png" alt="getting started cdc server" width="688" height="903">
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-cdc-producer-pr"><a class="anchor" href="#getting-started-cdc-producer-pr"></a><a class="link" href="#getting-started-cdc-producer-pr">4.3.1. Taking over the Pull Request</a></h4>
+<div class="paragraph">
+<p>As a reminder, the following listing shows the initial implementation:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RequestMapping(value = "/fraudcheck", method = PUT)
+public FraudCheckResult fraudCheck(@RequestBody FraudCheck fraudCheck) {
+return new FraudCheckResult(FraudCheckStatus.OK, NO_REASON);
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Then you can run the following commands:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ git checkout -b contract-change-pr master
+$ git pull https://your-git-server.com/server-side-fork.git contract-change-pr</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You must add the dependencies needed by the autogenerated tests, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-starter-contract-verifier&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In the configuration of the Maven plugin, you must pass the <code>packageWithBaseClasses</code> property, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;packageWithBaseClasses&gt;com.example.fraud&lt;/packageWithBaseClasses&gt;
+        &lt;convertToYaml&gt;true&lt;/convertToYaml&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+This example uses &#8220;convention-based&#8221; naming by setting the
+<code>packageWithBaseClasses</code> property. Doing so means that the two last packages combine to
+make the name of the base test class. In our case, the contracts were placed under
+<code>src/test/resources/contracts/fraud</code>. Since you do not have two packages starting from
+the <code>contracts</code> folder, pick only one, which should be <code>fraud</code>. Add the <code>Base</code> suffix and
+capitalize <code>fraud</code>. That gives you the <code>FraudBase</code> test class name.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>All the generated tests extend that class. Over there, you can set up your Spring Context
+or whatever is necessary. In this case, you should use <a href="https://github.com/rest-assured/rest-assured">Rest Assured MVC</a> to
+start the server side <code>FraudDetectionController</code>. The following listing shows the
+<code>FraudBase</code> class:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">/*
+ * Copyright 2013-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.fraud;
+
+import io.restassured.module.mockmvc.RestAssuredMockMvc;
+import org.junit.Before;
+
+public class FraudBase {
+
+    @Before
+    public void setup() {
+        RestAssuredMockMvc.standaloneSetup(new FraudDetectionController(),
+                new FraudStatsController(stubbedStatsProvider()));
+    }
+
+    private StatsProvider stubbedStatsProvider() {
+        return fraudType -&gt; {
+            switch (fraudType) {
+            case DRUNKS:
+                return 100;
+            case ALL:
+                return 200;
+            }
+            return 0;
+        };
+    }
+
+    public void assertThatRejectionReasonIsNull(Object rejectionReason) {
+        assert rejectionReason == null;
+    }
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Now, if you run the <code>./mvnw clean install</code>, you get something like the following output:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">Results :
+
+Tests in error:
+  ContractVerifierTest.validate_shouldMarkClientAsFraud:32 » IllegalState Parsed...</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>This error occurs because you have a new contract from which a test was generated and it
+failed since you have not implemented the feature. The auto-generated test would look
+like the following test method:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
+public void validate_shouldMarkClientAsFraud() throws Exception {
+    // given:
+        MockMvcRequestSpecification request = given()
+                .header("Content-Type", "application/vnd.fraud.v1+json")
+                .body("{\"client.id\":\"1234567890\",\"loanAmount\":99999}");
+
+    // when:
+        ResponseOptions response = given().spec(request)
+                .put("/fraudcheck");
+
+    // then:
+        assertThat(response.statusCode()).isEqualTo(200);
+        assertThat(response.header("Content-Type")).matches("application/vnd.fraud.v1.json.*");
+    // and:
+        DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
+        assertThatJson(parsedJson).field("['fraudCheckStatus']").matches("[A-Z]{5}");
+        assertThatJson(parsedJson).field("['rejection.reason']").isEqualTo("Amount too high");
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>If you used the Groovy DSL, you can see that all of the <code>producer()</code> parts of the Contract that were present in the
+<code>value(consumer(&#8230;&#8203;), producer(&#8230;&#8203;))</code> blocks got injected into the test.
+In case of using YAML, the same applied for the <code>matchers</code> sections of the <code>response</code>.</p>
+</div>
+<div class="paragraph">
+<p>Note that, on the producer side, you are also doing TDD. The expectations are expressed
+in the form of a test. This test sends a request to our own application with the URL,
+headers, and body defined in the contract. It is also expecting precisely defined values
+in the response. In other words, you have the <code>red</code> part of <code>red</code>, <code>green</code>, and
+<code>refactor</code>. It is time to convert the <code>red</code> into the <code>green</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-cdc-producer-impl"><a class="anchor" href="#getting-started-cdc-producer-impl"></a><a class="link" href="#getting-started-cdc-producer-impl">4.3.2. Write the Missing Implementation</a></h4>
+<div class="paragraph">
+<p>Because you know the expected input and expected output, you can write the missing
+implementation as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RequestMapping(value = "/fraudcheck", method = PUT)
+public FraudCheckResult fraudCheck(@RequestBody FraudCheck fraudCheck) {
+if (amountGreaterThanThreshold(fraudCheck)) {
+    return new FraudCheckResult(FraudCheckStatus.FRAUD, AMOUNT_TOO_HIGH);
+}
+return new FraudCheckResult(FraudCheckStatus.OK, NO_REASON);
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>When you run <code>./mvnw clean install</code> again, the tests pass. Since the <code>Spring Cloud
+Contract Verifier</code> plugin adds the tests to the <code>generated-test-sources</code>, you can
+actually run those tests from your IDE.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-cdc-producer-deploy"><a class="anchor" href="#getting-started-cdc-producer-deploy"></a><a class="link" href="#getting-started-cdc-producer-deploy">4.3.3. Deploying Your Application</a></h4>
+<div class="paragraph">
+<p>Once you finish your work, you can deploy your changes. To do so, you must first merge the
+branch by running the following commands:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ git checkout master
+$ git merge --no-ff contract-change-pr
+$ git push origin master</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Your CI might run something a command such as <code>./mvnw clean deploy</code>, which would publish both the
+application and the stub artifacts.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="getting-started-cdc-consumer-final"><a class="anchor" href="#getting-started-cdc-consumer-final"></a><a class="link" href="#getting-started-cdc-consumer-final">4.4. Consumer Side (Loan Issuance), Final Step</a></h3>
+<div class="paragraph">
+<p>As a developer of the loan issuance service (a consumer of the Fraud Detection server), I want to:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Merge our feature branch to <code>master</code></p>
+</li>
+<li>
+<p>Switch to online mode of working</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The following UML diagram shows the final state of the process:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/getting-started-cdc-client-final.png" alt="getting started cdc client final" width="590" height="685">
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-cdc-consumer-final-merge"><a class="anchor" href="#getting-started-cdc-consumer-final-merge"></a><a class="link" href="#getting-started-cdc-consumer-final-merge">4.4.1. Merging a Branch to Master</a></h4>
+<div class="paragraph">
+<p>The following commands show one way to merge a branch into master with Git:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ git checkout master
+$ git merge --no-ff contract-change-pr</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-cdc-consumer-final-online"><a class="anchor" href="#getting-started-cdc-consumer-final-online"></a><a class="link" href="#getting-started-cdc-consumer-final-online">4.4.2. Working Online</a></h4>
+<div class="paragraph">
+<p>Now you can disable the offline work for Spring Cloud Contract Stub Runner and indicate
+where the repository with your stubs is located. At this moment, the stubs of the server
+side are automatically downloaded from Nexus/Artifactory. You can set the value of
+<code>stubsMode</code> to <code>REMOTE</code>. The following code shows an example of
+achieving the same thing by changing the properties:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">stubrunner:
+  ids: 'com.example:http-server-dsl:+:stubs:8080'
+  repositoryRoot: https://repo.spring.io/libs-snapshot</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>That&#8217;s it. You have finished the tutorial.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="getting-started-whats-next"><a class="anchor" href="#getting-started-whats-next"></a><a class="link" href="#getting-started-whats-next">5. Next Steps</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Hopefully, this section provided some of the Spring Cloud Contract basics and got you on your way
+to writing your own applications. If you are a task-oriented type of developer, you might
+want to jump over to <a href="https://spring.io" class="bare">spring.io</a> and check out some of the
+<a href="https://spring.io/guides/">getting started</a> guides that solve specific &#8220;How do I do that
+with Spring?&#8221; problems. We also have Spring Cloud Contract-specific
+&#8220;<a href="howto.html#howto">how-to</a>&#8221; reference documentation.</p>
+</div>
+<div class="paragraph">
+<p>Otherwise, the next logical step is to read <a href="using.html#using">Using Spring Cloud Contract</a>. If
+you are really impatient, you could also jump ahead and read about
+<a href="project-features.html#project-features">Spring Cloud Contract features</a>.</p>
+</div>
+<div class="paragraph">
+<p>In addition to that you can check out the following videos:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>"Consumer Driven Contracts and Your Microservice Architecture" by Olga Maciaszek-Sharma and Marcin Grzejszczak</p>
+</li>
+</ul>
+</div>
+<div class="videoblock">
+<div class="content">
+<iframe width="640" height="480" src="https://www.youtube.com/embed/pDkC_00hhvA?rel=0" frameborder="0" allowfullscreen></iframe>
+</div>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>"Contract Tests in the Enterprise" by Marcin Grzejszczak</p>
+</li>
+</ul>
+</div>
+<div class="videoblock">
+<div class="content">
+<iframe width="640" height="480" src="https://www.youtube.com/embed/ZyHG-VOzPZg?rel=0" frameborder="0" allowfullscreen></iframe>
+</div>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>"Why Contract Tests Matter?" by Marcin Grzejszczak</p>
+</li>
+</ul>
+</div>
+<div class="videoblock">
+<div class="content">
+<iframe width="640" height="480" src="https://www.youtube.com/embed/TvpkZu1e2Dc?rel=0&amp;start=6262" frameborder="0" allowfullscreen></iframe>
+</div>
+</div>
+<div class="paragraph">
+<p>You can find the default project samples at
+<a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples">samples</a>.</p>
+</div>
+<div class="paragraph">
+<p>You can find the Spring Cloud Contract workshops <a href="https://cloud-samples.spring.io/spring-cloud-contract-samples/">here</a>.</p>
+</div>
+</div>
+</div>
+</div>
+<script type="text/javascript" src="js/tocbot/tocbot.min.js"></script>
+<script type="text/javascript" src="js/toc.js"></script>
+<link rel="stylesheet" href="js/highlight/styles/atom-one-dark-reasonable.min.css">
+<script src="js/highlight/highlight.min.js"></script>
+<script>hljs.initHighlighting()</script>
+</body>
+</html>
\ No newline at end of file
diff --git a/reference/html/gradle-project.html b/reference/html/gradle-project.html
new file mode 100644
index 0000000000..b30987ab6f
--- /dev/null
+++ b/reference/html/gradle-project.html
@@ -0,0 +1,862 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.7.1">
+<title>Gradle Project</title>
+<link rel="stylesheet" href="css/spring.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css">
+
+<style>
+.hidden {
+	display: none;
+}
+
+.switch {
+	border-width: 1px 1px 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+	display: inline-block;
+}
+
+.switch--item {
+	padding: 10px;
+	background-color: #ffffff;
+	color: #7a2518;
+	display: inline-block;
+	cursor: pointer;
+}
+
+.switch--item:not(:first-child) {
+	border-width: 0 0 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+}
+
+.switch--item.selected {
+	background-color: #7a2519;
+	color: #ffffff;
+}
+</style>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/zepto/1.2.0/zepto.min.js"></script>
+<script type="text/javascript">
+function addBlockSwitches() {
+	$('.primary').each(function() {
+		primary = $(this);
+		createSwitchItem(primary, createBlockSwitch(primary)).item.addClass("selected");
+		primary.children('.title').remove();
+	});
+	$('.secondary').each(function(idx, node) {
+		secondary = $(node);
+		primary = findPrimary(secondary);
+		switchItem = createSwitchItem(secondary, primary.children('.switch'));
+		switchItem.content.addClass('hidden');
+		findPrimary(secondary).append(switchItem.content);
+		secondary.remove();
+	});
+}
+
+function createBlockSwitch(primary) {
+	blockSwitch = $('<div class="switch"></div>');
+	primary.prepend(blockSwitch);
+	return blockSwitch;
+}
+
+function findPrimary(secondary) {
+	candidate = secondary.prev();
+	while (!candidate.is('.primary')) {
+		candidate = candidate.prev();
+	}
+	return candidate;
+}
+
+function createSwitchItem(block, blockSwitch) {
+	blockName = block.children('.title').text();
+	content = block.children('.content').first().append(block.next('.colist'));
+	item = $('<div class="switch--item">' + blockName + '</div>');
+	item.on('click', '', content, function(e) {
+		$(this).addClass('selected');
+		$(this).siblings().removeClass('selected');
+		e.data.siblings('.content').addClass('hidden');
+		e.data.removeClass('hidden');
+	});
+	blockSwitch.append(item);
+	return {'item': item, 'content': content};
+}
+
+$(addBlockSwitches);
+</script>
+
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>Gradle Project</h1>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="#gradle-prerequisites">1. Prerequisites</a></li>
+<li><a href="#gradle-add-gradle-plugin">2. Add Gradle Plugin with Dependencies</a></li>
+<li><a href="#gradle-and-rest-assured">3. Gradle and Rest Assured 2.0</a></li>
+<li><a href="#gradle-snapshot-versions">4. Snapshot Versions for Gradle</a></li>
+<li><a href="#gradle-add-stubs">5. Add stubs</a></li>
+<li><a href="#gradle-run-plugin">6. Running the Plugin</a></li>
+<li><a href="#gradle-default-setup">7. Default Setup</a></li>
+<li><a href="#gradle-configure-plugin">8. Configuring the Plugin</a></li>
+<li><a href="#gradle-configuration-options">9. Configuration Options</a></li>
+<li><a href="#gradle-single-base-class">10. Single Base Class for All Tests</a></li>
+<li><a href="#gradle-different-base-classes">11. Different Base Classes for Contracts</a>
+<ul class="sectlevel2">
+<li><a href="#by-convention">11.1. By Convention</a></li>
+<li><a href="#by-mapping">11.2. By Mapping</a></li>
+</ul>
+</li>
+<li><a href="#gradle-invoking-generated-tests">12. Invoking Generated Tests</a></li>
+<li><a href="#gradle-pushing-stubs-to-scm">13. Pushing Stubs to SCM</a></li>
+<li><a href="#gradle-consumer">14. Spring Cloud Contract Verifier on the Consumer Side</a></li>
+</ul>
+</div>
+</div>
+<div id="content">
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>To learn how to set up the Gradle project for Spring Cloud Contract Verifier, read the
+following sections:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#gradle-prerequisites">Prerequisites</a></p>
+</li>
+<li>
+<p><a href="#gradle-add-gradle-plugin">Add Gradle Plugin with Dependencies</a></p>
+</li>
+<li>
+<p><a href="#gradle-and-rest-assured">Gradle and Rest Assured 2.0</a></p>
+</li>
+<li>
+<p><a href="#gradle-snapshot-versions">Snapshot Versions for Gradle</a></p>
+</li>
+<li>
+<p><a href="#gradle-add-stubs">Add stubs</a></p>
+</li>
+<li>
+<p><a href="#gradle-default-setup">Default Setup</a></p>
+</li>
+<li>
+<p><a href="#gradle-configure-plugin">Configuring the Plugin</a></p>
+</li>
+<li>
+<p><a href="#gradle-configuration-options">Configuration Options</a></p>
+</li>
+<li>
+<p><a href="#gradle-single-base-class">Single Base Class for All Tests</a></p>
+</li>
+<li>
+<p><a href="#gradle-different-base-classes">Different Base Classes for Contracts</a></p>
+</li>
+<li>
+<p><a href="#gradle-invoking-generated-tests">Invoking Generated Tests</a></p>
+</li>
+<li>
+<p><a href="#gradle-pushing-stubs-to-scm">Pushing Stubs to SCM</a></p>
+</li>
+<li>
+<p><a href="#gradle-consumer">Spring Cloud Contract Verifier on the Consumer Side</a></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="gradle-prerequisites"><a class="anchor" href="#gradle-prerequisites"></a><a class="link" href="#gradle-prerequisites">1. Prerequisites</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>In order to use Spring Cloud Contract Verifier with WireMock, you must use either a
+Gradle or a Maven plugin.</p>
+</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title="Warning"></i>
+</td>
+<td class="content">
+If you want to use Spock in your projects, you must separately add the
+<code>spock-core</code> and <code>spock-spring</code> modules. See <a href="https://spockframework.github.io/">Spock&#8217;s
+documnetation for more information</a>
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="gradle-add-gradle-plugin"><a class="anchor" href="#gradle-add-gradle-plugin"></a><a class="link" href="#gradle-add-gradle-plugin">2. Add Gradle Plugin with Dependencies</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>To add a Gradle plugin with dependencies, you can use code similar to the following:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Plugin DSL</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">buildscript {
+    repositories {
+        mavenCentral()
+    }
+    dependencies {
+        classpath "org.springframework.boot:spring-boot-gradle-plugin:${springboot_version}"
+        classpath "org.springframework.cloud:spring-cloud-contract-gradle-plugin:${verifier_version}"
+    }
+}
+
+apply plugin: 'groovy'
+apply plugin: 'spring-cloud-contract'
+
+dependencyManagement {
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-contract-dependencies:${verifier_version}"
+    }
+}
+
+dependencies {
+    testCompile "org.codehaus.groovy:groovy-all:${groovyVersion}"
+    // example with adding Spock core and Spock Spring
+    testCompile "org.spockframework:spock-core:${spockVersion}"
+    testCompile "org.spockframework:spock-spring:${spockVersion}"
+    testCompile 'org.springframework.cloud:spring-cloud-starter-contract-verifier'
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Legacy Plugin Application</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">buildscript {
+    repositories {
+        mavenCentral()
+    }
+    dependencies {
+        classpath "org.springframework.boot:spring-boot-gradle-plugin:${springboot_version}"
+    }
+}
+
+apply plugin: 'groovy'
+
+plugins {
+  id "org.springframework.cloud.contract" version "${GAVerifierVersion}"
+}
+
+dependencyManagement {
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-contract-dependencies:${verifier_version}"
+    }
+}
+
+dependencies {
+    testCompile "org.codehaus.groovy:groovy-all:${groovyVersion}"
+    // example with adding Spock core and Spock Spring
+    testCompile "org.spockframework:spock-core:${spockVersion}"
+    testCompile "org.spockframework:spock-spring:${spockVersion}"
+    testCompile 'org.springframework.cloud:spring-cloud-starter-contract-verifier'
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+The Plugin DSL option will only work for GA (General Availability) releases (i.e. <code>2.2.0.RELEASE</code> etc.).
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="gradle-and-rest-assured"><a class="anchor" href="#gradle-and-rest-assured"></a><a class="link" href="#gradle-and-rest-assured">3. Gradle and Rest Assured 2.0</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>By default, Rest Assured 3.x is added to the classpath. However, to use Rest Assured 2.x
+you can add it to the plugins classpath, as the following listing shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">buildscript {
+    repositories {
+        mavenCentral()
+    }
+    dependencies {
+        classpath "org.springframework.boot:spring-boot-gradle-plugin:${springboot_version}"
+        classpath "org.springframework.cloud:spring-cloud-contract-gradle-plugin:${verifier_version}"
+        classpath "com.jayway.restassured:rest-assured:2.5.0"
+        classpath "com.jayway.restassured:spring-mock-mvc:2.5.0"
+    }
+}
+
+depenendencies {
+    // all dependencies
+    // you can exclude rest-assured from spring-cloud-contract-verifier
+    testCompile "com.jayway.restassured:rest-assured:2.5.0"
+    testCompile "com.jayway.restassured:spring-mock-mvc:2.5.0"
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>That way, the plugin automatically sees that Rest Assured 2.x is present on the classpath
+and modifies the imports accordingly.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="gradle-snapshot-versions"><a class="anchor" href="#gradle-snapshot-versions"></a><a class="link" href="#gradle-snapshot-versions">4. Snapshot Versions for Gradle</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>You can add the additional snapshot repository to your <code>build.gradle</code> to use snapshot versions,
+which are automatically uploaded after every successful build, as the following listing shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">buildscript {
+    repositories {
+        mavenCentral()
+        mavenLocal()
+        maven { url "https://repo.spring.io/snapshot" }
+        maven { url "https://repo.spring.io/milestone" }
+        maven { url "https://repo.spring.io/release" }
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="gradle-add-stubs"><a class="anchor" href="#gradle-add-stubs"></a><a class="link" href="#gradle-add-stubs">5. Add stubs</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>By default, Spring Cloud Contract Verifier looks for stubs in the
+<code>src/test/resources/contracts</code> directory.</p>
+</div>
+<div class="paragraph">
+<p>The directory that contains stub definitions is treated as a class name, and each stub
+definition is treated as a single test. Spring Cloud Contract Verifier assumes that it
+contains at  least one level of directories that are to be used as the test class name.
+If more than  one level of nested directories is present, all except the last one is used
+as the package name. Consider the following structure:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">src/test/resources/contracts/myservice/shouldCreateUser.groovy
+src/test/resources/contracts/myservice/shouldReturnUser.groovy</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Given the preceding structure, Spring Cloud Contract Verifier creates a test class named
+<code>defaultBasePackage.MyService</code> with two methods:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>shouldCreateUser()</code></p>
+</li>
+<li>
+<p><code>shouldReturnUser()</code></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="gradle-run-plugin"><a class="anchor" href="#gradle-run-plugin"></a><a class="link" href="#gradle-run-plugin">6. Running the Plugin</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The plugin registers itself to be invoked before a <code>check</code> task. If you want it to be
+part of your build process, you need do nothing more. If you just want to generate
+tests, invoke the <code>generateContractTests</code> task.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="gradle-default-setup"><a class="anchor" href="#gradle-default-setup"></a><a class="link" href="#gradle-default-setup">7. Default Setup</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The default Gradle Plugin setup creates the following Gradle part of the build (in
+pseudocode):</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+    testFramework ='JUNIT'
+    testMode = 'MockMvc'
+    generatedTestSourcesDir = project.file("${project.buildDir}/generated-test-sources/contracts")
+    generatedTestResourcesDir = project.file("${project.buildDir}/generated-test-resources/contracts")
+    contractsDslDir = "${project.rootDir}/src/test/resources/contracts"
+    basePackageForTests = 'org.springframework.cloud.verifier.tests'
+    stubsOutputDir = project.file("${project.buildDir}/stubs")
+
+    // the following properties are used when you want to provide where the JAR with contract lays
+    contractDependency {
+        stringNotation = ''
+    }
+    contractsPath = ''
+    contractsWorkOffline = false
+    contractRepository {
+        cacheDownloadedContracts(true)
+    }
+}
+
+tasks.create(type: Jar, name: 'verifierStubsJar', dependsOn: 'generateClientStubs') {
+    baseName = project.name
+    classifier = contracts.stubsSuffix
+    from contractVerifier.stubsOutputDir
+}
+
+project.artifacts {
+    archives task
+}
+
+tasks.create(type: Copy, name: 'copyContracts') {
+    from contracts.contractsDslDir
+    into contracts.stubsOutputDir
+}
+
+verifierStubsJar.dependsOn 'copyContracts'
+
+publishing {
+    publications {
+        stubs(MavenPublication) {
+            artifactId project.name
+            artifact verifierStubsJar
+        }
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="gradle-configure-plugin"><a class="anchor" href="#gradle-configure-plugin"></a><a class="link" href="#gradle-configure-plugin">8. Configuring the Plugin</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>To change the default configuration, you can add a <code>contracts</code> snippet to your Gradle
+configuration, as the following listing shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+    testMode = 'MockMvc'
+    baseClassForTests = 'org.mycompany.tests'
+    generatedTestSourcesDir = project.file('src/generatedContract')
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="gradle-configuration-options"><a class="anchor" href="#gradle-configuration-options"></a><a class="link" href="#gradle-configuration-options">9. Configuration Options</a></h2>
+<div class="sectionbody">
+<div class="ulist">
+<ul>
+<li>
+<p><code>testMode</code>: Defines the mode for acceptance tests. By default, the mode is MockMvc,
+which is based on Spring&#8217;s MockMvc. It can also be changed to WebTestClient, JaxRsClient, or
+Explicit (for real HTTP calls).</p>
+</li>
+<li>
+<p><code>imports</code>: Creates an array with imports that should be included in the generated tests
+(for example, <code>['org.myorg.Matchers']</code>). By default, it creates an empty array.</p>
+</li>
+<li>
+<p><code>staticImports</code>: Creates an array with static imports that should be included in
+generated tests(for example, <code>['org.myorg.Matchers.*']</code>). By default, it creates an empty
+array.</p>
+</li>
+<li>
+<p><code>basePackageForTests</code>: Specifies the base package for all generated tests. If not set,
+the value is picked from the package of <code>baseClassForTests</code> and from <code>packageWithBaseClasses</code>.
+If neither of these values are set, the value is set to
+<code>org.springframework.cloud.contract.verifier.tests</code>.</p>
+</li>
+<li>
+<p><code>baseClassForTests</code>: Creates a base class for all generated tests. By default, if you
+use Spock classes, the class is <code>spock.lang.Specification</code>.</p>
+</li>
+<li>
+<p><code>packageWithBaseClasses</code>: Defines a package where all the base classes reside. This
+setting takes precedence over <code>baseClassForTests</code>.</p>
+</li>
+<li>
+<p><code>baseClassMappings</code>: Explicitly maps a contract package to a FQN of a base class. This
+setting takes precedence over <code>packageWithBaseClasses</code> and <code>baseClassForTests</code>.</p>
+</li>
+<li>
+<p><code>ruleClassForTests</code>: Specifies a rule that should be added to the generated test
+classes.</p>
+</li>
+<li>
+<p><code>ignoredFiles</code>: Uses an <code>Antmatcher</code> to allow defining stub files for which processing
+should be skipped. By default, it is an empty array.</p>
+</li>
+<li>
+<p><code>contractsDslDir</code>: Specifies the directory that contains contracts written by using the
+GroovyDSL. By default, its value is <code>$rootDir/src/test/resources/contracts</code>.</p>
+</li>
+<li>
+<p><code>generatedTestSourcesDir</code>: Specifies the test source directory where tests generated
+from the Groovy DSL should be placed. By default, its value is
+<code>$buildDir/generated-test-sources/contracts</code>.</p>
+</li>
+<li>
+<p><code>generatedTestResourcesDir</code>: Specifies the test resource directory where resources used by the tests generated
+from the Groovy DSL should be placed. By default, its value is
+<code>$buildDir/generated-test-resources/contracts</code>.</p>
+</li>
+<li>
+<p><code>stubsOutputDir</code>: Specifies the directory where the generated WireMock stubs from
+the Groovy DSL should be placed.</p>
+</li>
+<li>
+<p><code>testFramework</code>: Specifies the target test framework to be used. Currently, Spock, JUnit 4 (<code>TestFramework.JUNIT</code>), and
+JUnit 5 are supported, with JUnit 4 being the default framework.</p>
+</li>
+<li>
+<p><code>contractsProperties</code>: A map that contains properties to be passed to Spring Cloud Contract
+components. Those properties might be used by (for example) built-in or custom Stub Downloaders.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>You can use the following properties when you want to specify the location of the JAR
+that contains the contracts:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>contractDependency</code>: Specifies the Dependency that provides
+<code>groupid:artifactid:version:classifier</code> coordinates. You can use the <code>contractDependency</code>
+closure to set it up.</p>
+</li>
+<li>
+<p><code>contractsPath</code>: Specifies the path to the jar. If contract dependencies are
+downloaded, the path defaults to <code>groupid/artifactid</code> where <code>groupid</code> is slash
+separated. Otherwise, it scans contracts under the provided directory.</p>
+</li>
+<li>
+<p><code>contractsMode</code>: Specifies the mode for downloading contracts (whether the
+JAR is available offline, remotely, and so on).</p>
+</li>
+<li>
+<p><code>deleteStubsAfterTest</code>: If set to <code>false</code>, do not remove any downloaded
+contracts from temporary directories.</p>
+</li>
+<li>
+<p><code>failOnNoContracts</code>: When enabled, will throw an exception when no contracts were found. Defaults to <code>true</code>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>There is also the <code>contractRepository { &#8230;&#8203; }</code> closure that contains the following properties</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>repositoryUrl</code>: the URL to the repository with contract definitions</p>
+</li>
+<li>
+<p><code>username</code> : Repository username</p>
+</li>
+<li>
+<p><code>password</code> : Repository password</p>
+</li>
+<li>
+<p><code>proxyPort</code> : the port of the proxy</p>
+</li>
+<li>
+<p><code>proxyHost</code> : the host of the proxy</p>
+</li>
+<li>
+<p><code>cacheDownloadedContracts</code> : If set to <code>true</code> then will cache the folder where non snapshot contract artifacts got downloaded. Defaults to <code>true</code>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>You can also turn on the following experimental features in the plugin:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>convertToYaml</code>: Converts all DSLs to the declarative YAML format. This can be extremely
+useful when you use external libraries in your Groovy DSLs. By turning this feature on
+(by setting it to <code>true</code>) you need not add the library dependency on the consumer side.</p>
+</li>
+<li>
+<p><code>assertJsonSize</code>: You can check the size of JSON arrays in the generated tests. This
+feature is disabled by default.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="gradle-single-base-class"><a class="anchor" href="#gradle-single-base-class"></a><a class="link" href="#gradle-single-base-class">10. Single Base Class for All Tests</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>When using Spring Cloud Contract Verifier in default MockMvc, you need to create a base
+specification for all generated acceptance tests. In this class, you need to point to an
+endpoint, which should be verified. The following example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">abstract class BaseMockMvcSpec extends Specification {
+
+    def setup() {
+        RestAssuredMockMvc.standaloneSetup(new PairIdController())
+    }
+
+    void isProperCorrelationId(Integer correlationId) {
+        assert correlationId == 123456
+    }
+
+    void isEmpty(String value) {
+        assert value == null
+    }
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>If you use <code>Explicit</code> mode, you can use a base class to initialize the whole tested application,
+as you might see in regular integration tests. If you use the <code>JAXRSCLIENT</code> mode, this
+base class should also contain a <code>protected WebTarget webTarget</code> field. Right now, the
+only option to test the JAX-RS API is to start a web server.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="gradle-different-base-classes"><a class="anchor" href="#gradle-different-base-classes"></a><a class="link" href="#gradle-different-base-classes">11. Different Base Classes for Contracts</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>If your base classes differ between contracts, you can tell the Spring Cloud Contract
+plugin which class should get extended by the autogenerated tests. You have two options:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Follow a convention by providing the <code>packageWithBaseClasses</code></p>
+</li>
+<li>
+<p>Provide explicit mapping by using <code>baseClassMappings</code></p>
+</li>
+</ul>
+</div>
+<div class="sect2">
+<h3 id="by-convention"><a class="anchor" href="#by-convention"></a><a class="link" href="#by-convention">11.1. By Convention</a></h3>
+<div class="paragraph">
+<p>The convention is such that if you have a contract in (for example)
+<code>src/test/resources/contract/foo/bar/baz/</code> and set the value of the
+<code>packageWithBaseClasses</code> property to <code>com.example.base</code>, then Spring Cloud Contract
+Verifier assumes that there is a <code>BarBazBase</code> class under the <code>com.example.base</code> package.
+In other words, the system takes the last two parts of the package, if they exist, and
+forms a class with a <code>Base</code> suffix. This rule takes precedence over <code>baseClassForTests</code>.
+The following example shows how it works in the <code>contracts</code> closure:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">packageWithBaseClasses = 'com.example.base'</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="by-mapping"><a class="anchor" href="#by-mapping"></a><a class="link" href="#by-mapping">11.2. By Mapping</a></h3>
+<div class="paragraph">
+<p>You can manually map a regular expression of the contract&#8217;s package to the fully qualified
+name of the base class for the matched contract. You have to provide a list called
+<code>baseClassMappings</code> that consists of <code>baseClassMapping</code> objects that take a
+<code>contractPackageRegex</code> to <code>baseClassFQN</code> mapping. Consider the following example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">baseClassForTests = "com.example.FooBase"
+baseClassMappings {
+    baseClassMapping('.*/com/.*', 'com.example.ComBase')
+    baseClassMapping('.*/bar/.*': 'com.example.BarBase')
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Let&#8217;s assume that you have contracts in the following directories:
+ - <code>src/test/resources/contract/com/</code>
+ - <code>src/test/resources/contract/foo/</code></p>
+</div>
+<div class="paragraph">
+<p>By providing <code>baseClassForTests</code>, we have a fallback in case mapping did not succeed.
+(You could also provide the <code>packageWithBaseClasses</code> as a fallback.) That way, the tests
+generated from <code>src/test/resources/contract/com/</code> contracts extend the
+<code>com.example.ComBase</code>, whereas the rest of the tests extend <code>com.example.FooBase</code>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="gradle-invoking-generated-tests"><a class="anchor" href="#gradle-invoking-generated-tests"></a><a class="link" href="#gradle-invoking-generated-tests">12. Invoking Generated Tests</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>To ensure that the provider side is compliant with your defined contracts, you need to run
+the following command:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./gradlew generateContractTests test</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="gradle-pushing-stubs-to-scm"><a class="anchor" href="#gradle-pushing-stubs-to-scm"></a><a class="link" href="#gradle-pushing-stubs-to-scm">13. Pushing Stubs to SCM</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>If you use the SCM repository to keep the contracts and
+stubs, you might want to automate the step of pushing stubs to
+the repository. To do that, you can call the <code>pushStubsToScm</code>
+task by running the following command:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ ./gradlew pushStubsToScm</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Under <a href="#scm-stub-downloader">[scm-stub-downloader]</a> you can find all possible
+configuration options that you can pass either through
+the <code>contractsProperties</code> field (for example, <code>contracts { contractsProperties = [foo:"bar"] }</code>),
+through the <code>contractsProperties</code> method (for example, <code>contracts { contractsProperties([foo:"bar"]) }</code>),
+or through a system property or an environment variable.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="gradle-consumer"><a class="anchor" href="#gradle-consumer"></a><a class="link" href="#gradle-consumer">14. Spring Cloud Contract Verifier on the Consumer Side</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>In a consuming service, you need to configure the Spring Cloud Contract Verifier plugin
+in exactly the same way as in the case of a provider. If you do not want to use Stub Runner,
+you need to copy the contracts stored in <code>src/test/resources/contracts</code> and generate
+WireMock JSON stubs by using the following command:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./gradlew generateClientStubs</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+The <code>stubsOutputDir</code> option has to be set for stub generation to work.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>When present, JSON stubs can be used in automated tests to consume a service. The
+following example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@ContextConfiguration(loader == SpringApplicationContextLoader, classes == Application)
+class LoanApplicationServiceSpec extends Specification {
+
+ @ClassRule
+ @Shared
+ WireMockClassRule wireMockRule == new WireMockClassRule()
+
+ @Autowired
+ LoanApplicationService sut
+
+ def 'should successfully apply for loan'() {
+   given:
+    LoanApplication application =
+            new LoanApplication(client: new Client(clientPesel: '12345678901'), amount: 123.123)
+   when:
+    LoanApplicationResult loanApplication == sut.loanApplication(application)
+   then:
+    loanApplication.loanApplicationStatus == LoanApplicationStatus.LOAN_APPLIED
+    loanApplication.rejectionReason == null
+ }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In the preceding example, <code>LoanApplication</code> makes a call to the <code>FraudDetection</code> service.
+This request is handled by a WireMock server configured with stubs that were generated by
+Spring Cloud Contract Verifier.</p>
+</div>
+</div>
+</div>
+</div>
+<script type="text/javascript" src="js/tocbot/tocbot.min.js"></script>
+<script type="text/javascript" src="js/toc.js"></script>
+<link rel="stylesheet" href="js/highlight/styles/atom-one-dark-reasonable.min.css">
+<script src="js/highlight/highlight.min.js"></script>
+<script>hljs.initHighlighting()</script>
+</body>
+</html>
\ No newline at end of file
diff --git a/reference/html/howto.html b/reference/html/howto.html
new file mode 100644
index 0000000000..ce0e38f66b
--- /dev/null
+++ b/reference/html/howto.html
@@ -0,0 +1,2508 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.7.1">
+<title>&#8220;How-to&#8221; Guides</title>
+<link rel="stylesheet" href="css/spring.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css">
+
+<style>
+.hidden {
+	display: none;
+}
+
+.switch {
+	border-width: 1px 1px 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+	display: inline-block;
+}
+
+.switch--item {
+	padding: 10px;
+	background-color: #ffffff;
+	color: #7a2518;
+	display: inline-block;
+	cursor: pointer;
+}
+
+.switch--item:not(:first-child) {
+	border-width: 0 0 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+}
+
+.switch--item.selected {
+	background-color: #7a2519;
+	color: #ffffff;
+}
+</style>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/zepto/1.2.0/zepto.min.js"></script>
+<script type="text/javascript">
+function addBlockSwitches() {
+	$('.primary').each(function() {
+		primary = $(this);
+		createSwitchItem(primary, createBlockSwitch(primary)).item.addClass("selected");
+		primary.children('.title').remove();
+	});
+	$('.secondary').each(function(idx, node) {
+		secondary = $(node);
+		primary = findPrimary(secondary);
+		switchItem = createSwitchItem(secondary, primary.children('.switch'));
+		switchItem.content.addClass('hidden');
+		findPrimary(secondary).append(switchItem.content);
+		secondary.remove();
+	});
+}
+
+function createBlockSwitch(primary) {
+	blockSwitch = $('<div class="switch"></div>');
+	primary.prepend(blockSwitch);
+	return blockSwitch;
+}
+
+function findPrimary(secondary) {
+	candidate = secondary.prev();
+	while (!candidate.is('.primary')) {
+		candidate = candidate.prev();
+	}
+	return candidate;
+}
+
+function createSwitchItem(block, blockSwitch) {
+	blockName = block.children('.title').text();
+	content = block.children('.content').first().append(block.next('.colist'));
+	item = $('<div class="switch--item">' + blockName + '</div>');
+	item.on('click', '', content, function(e) {
+		$(this).addClass('selected');
+		$(this).siblings().removeClass('selected');
+		e.data.siblings('.content').addClass('hidden');
+		e.data.removeClass('hidden');
+	});
+	blockSwitch.append(item);
+	return {'item': item, 'content': content};
+}
+
+$(addBlockSwitches);
+</script>
+
+</head>
+<body id="howto" class="book toc2 toc-left">
+<div id="header">
+<h1>&#8220;How-to&#8221; Guides</h1>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="#why-spring-cloud-contract">1. Why use Spring Cloud Contract?</a></li>
+<li><a href="#how-to-not-write-contracts-in-groovy">2. How Can I Write Contracts in a Language Other than Groovy?</a></li>
+<li><a href="#how-to-provide-dynamic-values">3. How Can I Provide Dynamic Values to a Contract?</a></li>
+<li><a href="#how-to-do-stubs-versioning">4. How to Do Stubs versioning?</a>
+<ul class="sectlevel2">
+<li><a href="#how-to-api-versioning">4.1. API Versioning</a></li>
+<li><a href="#how-to-jar-versioning">4.2. JAR versioning</a></li>
+<li><a href="#how-to-dev-or-prod-stubs">4.3. Development or Production Stubs</a></li>
+</ul>
+</li>
+<li><a href="#how-to-common-repo-with-contracts">5. How Can I use a Common Repository with Contracts Instead of Storing Them with the Producer?</a>
+<ul class="sectlevel2">
+<li><a href="#how-to-repo-structure">5.1. Repo Structure</a></li>
+<li><a href="#how-to-workflow">5.2. Workflow</a></li>
+<li><a href="#how-to-workflow-consumer">5.3. Consumer</a></li>
+<li><a href="#how-to-workflow-producer">5.4. Producer</a></li>
+<li><a href="#how-to-define-messaging-contracts-per-topic">5.5. How Can I Define Messaging Contracts per Topic Rather than per Producer?</a>
+<ul class="sectlevel3">
+<li><a href="#how-to-define-messaging-contracts-per-topic-maven">5.5.1. For Maven Projects</a></li>
+<li><a href="#how-to-define-messaging-contracts-per-topic-gradle">5.5.2. For Gradle Projects</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#how-to-use-git-as-storage">6. How Can I Use Git as the Storage for Contracts and Stubs?</a>
+<ul class="sectlevel2">
+<li><a href="#how-to-protocol-convention">6.1. Protocol Convention</a></li>
+<li><a href="#how-to-protocol-convention-producer">6.2. Producer</a></li>
+<li><a href="#how-to-protocol-convention-producer-with-contracts-stored-locally">6.3. Producer with Contracts Stored Locally</a></li>
+<li><a href="#how-to-protocol-convention-contracts-producer-stubs-external">6.4. Keeping Contracts with the Producer and Stubs in an External Repository</a></li>
+<li><a href="#how-to-protocol-convention-contracts-producer-stubs-external-consumer">6.5. Consumer</a></li>
+</ul>
+</li>
+<li><a href="#how-to-use-pact-broker">7. How Can I Use the Pact Broker?</a>
+<ul class="sectlevel2">
+<li><a href="#how-to-use-pact-broker-pact">7.1. How to Work with Pact</a></li>
+<li><a href="#how-to-use-pact-broker-pact-converter">7.2. Pact Converter</a></li>
+<li><a href="#how-to-use-pact-broker-pact-contract">7.3. Pact Contract</a></li>
+<li><a href="#how-to-use-pact-broker-pact-for-producers">7.4. Pact for Producers</a></li>
+<li><a href="#how-to-use-pact-broker-pact-consumers">7.5. Pact for Consumers</a></li>
+<li><a href="#pact-stub-downloader">7.6. Communicating with the Pact Broker</a></li>
+<li><a href="#how-to-pact-consumer">7.7. Flow: Consumer Contract approach with Pact Broker | Consumer Side</a></li>
+<li><a href="#how-to-pact-producer">7.8. Flow: Consumer Contract Approach with Pact Broker on the Producer Side</a></li>
+<li><a href="#how-to-pact-consumer-producer-contract">7.9. Flow: Producer Contract approach with Pact on the Consumer Side</a></li>
+</ul>
+</li>
+<li><a href="#how-to-debug">8. How Can I Debug the Request/Response Being Sent by the Generated Tests Client?</a></li>
+<li><a href="#how-to-debug-wiremock">9. How Can I Debug the Mapping, Request, or Response Being Sent by WireMock?</a></li>
+<li><a href="#how-to-see-registered-stubs">10. How Can I See What Got Registered in the HTTP Server Stub?</a></li>
+<li><a href="#how-to-reference-text-from-file">11. How Can I Reference Text from File?</a></li>
+<li><a href="#how-to-generate-pact-from-scc">12. How Can I Generate Pact, YAML, or X files from Spring Cloud Contract Contracts?</a></li>
+<li><a href="#how-to-work-with-transitivie">13. How Can I Work with Transitive Dependencies?</a>
+<ul class="sectlevel2">
+<li><a href="#how-to-work-with-transitivie-optional">13.1. How Can I Mark All Application Dependencies as Optional?</a></li>
+<li><a href="#how-to-work-with-transitivie-separate">13.2. How can I Create a Separate <code>artifactid</code> for the Stubs?</a></li>
+<li><a href="#how-to-work-with-transitivie-exclude">13.3. How can I Exclude Dependencies on the Consumer Side?</a></li>
+</ul>
+</li>
+<li><a href="#contract-dsl-rest-docs">14. How can I Generate Spring REST Docs Snippets from the Contracts?</a></li>
+<li><a href="#how-to-use-stubs-from-a-location">15. How can I Use Stubs from a Location</a></li>
+<li><a href="#how-to-generate-stubs-at-runtime">16. How can I Generate Stubs at Runtime</a></li>
+<li><a href="#how-to-use-the-failonnostubs-feature">17. How can I Make The Build Pass if There Are No Contracts or Stubs</a></li>
+</ul>
+</div>
+</div>
+<div id="content">
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>This section provides answers to some common &#8220;how do I do that&#8230;&#8203;&#8221; questions
+that often arise when using Spring Cloud Contract. Its coverage is not exhaustive, but it
+does cover quite a lot.</p>
+</div>
+<div class="paragraph">
+<p>If you have a specific problem that we do not cover here, you might want to check out
+<a href="https://stackoverflow.com/tags/spring-cloud-contract">stackoverflow.com</a> to see if someone has
+already provided an answer. Stack Overflow is also a great place to ask new questions (please use
+the <code>spring-cloud-contract</code> tag).</p>
+</div>
+<div class="paragraph">
+<p>We are also more than happy to extend this section. If you want to add a &#8220;how-to&#8221;,
+send us a <a href="https://github.com/spring-cloud/spring-cloud-contract/tree/${github-tag}">pull request</a>.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="why-spring-cloud-contract"><a class="anchor" href="#why-spring-cloud-contract"></a><a class="link" href="#why-spring-cloud-contract">1. Why use Spring Cloud Contract?</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Spring Cloud Contract works great in a polyglot environment. This project has a lot of
+really interesting features. Quite a few of these features definitely make
+Spring Cloud Contract Verifier stand out on the market of Consumer Driven Contract
+(CDC) tooling. The most interesting features include the following:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Ability to do CDC with messaging.</p>
+</li>
+<li>
+<p>Clear and easy to use, statically typed DSL.</p>
+</li>
+<li>
+<p>Ability to copy-paste your current JSON file to the contract and only edit its elements.</p>
+</li>
+<li>
+<p>Automatic generation of tests from the defined Contract.</p>
+</li>
+<li>
+<p>Stub Runner functionality: The stubs are automatically downloaded at runtime from Nexus/Artifactory.</p>
+</li>
+<li>
+<p>Spring Cloud integration: No discovery service is needed for integration tests.</p>
+</li>
+<li>
+<p>Spring Cloud Contract integrates with Pact and provides easy hooks to extend its functionality.</p>
+</li>
+<li>
+<p>Ability to add support for any language &amp; framework through Docker.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="how-to-not-write-contracts-in-groovy"><a class="anchor" href="#how-to-not-write-contracts-in-groovy"></a><a class="link" href="#how-to-not-write-contracts-in-groovy">2. How Can I Write Contracts in a Language Other than Groovy?</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>You can write a contract in YAML. See <a href="project-features.html#contract-dsl">this section</a> for more information.</p>
+</div>
+<div class="paragraph">
+<p>We are working on allowing more ways of describing the contracts. You can check the <a href="https://github.com/spring-cloud/spring-cloud-contract/issues/">github-issues</a> for more information.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="how-to-provide-dynamic-values"><a class="anchor" href="#how-to-provide-dynamic-values"></a><a class="link" href="#how-to-provide-dynamic-values">3. How Can I Provide Dynamic Values to a Contract?</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>One of the biggest challenges related to stubs is their reusability. Only if they can be widely used can they serve their purpose.
+The hard-coded values (such as dates and IDs) of request and response elements generally make that difficult.
+Consider the following JSON request:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+    "time" : "2016-10-10 20:10:15",
+    "id" : "9febab1c-6f36-4a0b-88d6-3b6a6d81cd4a",
+    "body" : "foo"
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Now consider the following JSON response:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+    "time" : "2016-10-10 21:10:15",
+    "id" : "c4231e1f-3ca9-48d3-b7e7-567d55f0d051",
+    "body" : "bar"
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Imagine the pain required to set the proper value of the <code>time</code> field (assume that this content is generated by the
+database) by changing the clock in the system or by providing stub implementations of data providers. The same is related
+to the field called <code>id</code>. You could create a stubbed implementation of UUID generator, but doing so makes little sense.</p>
+</div>
+<div class="paragraph">
+<p>So, as a consumer, you want to send a request that matches any form of a time or any UUID. That way, your system
+works as usual, generating data without you having to stub out anything. Assume that, in case of the aforementioned
+JSON, the most important part is the <code>body</code> field. You can focus on that and provide matching for other fields. In other words,
+you would like the stub to work as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+    "time" : "SOMETHING THAT MATCHES TIME",
+    "id" : "SOMETHING THAT MATCHES UUID",
+    "body" : "foo"
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>As far as the response goes, as a consumer, you need a concrete value on which you can operate.
+Consequently, the following JSON is valid:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+    "time" : "2016-10-10 21:10:15",
+    "id" : "c4231e1f-3ca9-48d3-b7e7-567d55f0d051",
+    "body" : "bar"
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In the previous sections, we generated tests from contracts. So, from the producer&#8217;s side, the situation looks
+much different. We parse the provided contract, and, in the test, we want to send a real request to your endpoints.
+So, for the case of a producer for the request, we cannot have any sort of matching. We need concrete values on which the
+producer&#8217;s backend can work. Consequently, the following JSON would be valid:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+    "time" : "2016-10-10 20:10:15",
+    "id" : "9febab1c-6f36-4a0b-88d6-3b6a6d81cd4a",
+    "body" : "foo"
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>On the other hand, from the point of view of the validity of the contract, the response does not necessarily have to
+contain concrete values for <code>time</code> or <code>id</code>. Suppose you generate those on the producer side. Again, you
+have to do a lot of stubbing to ensure that you always return the same values. That is why, from the producer&#8217;s side
+you might want the following response:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+    "time" : "SOMETHING THAT MATCHES TIME",
+    "id" : "SOMETHING THAT MATCHES UUID",
+    "body" : "bar"
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>How can you then provide a matcher for the consumer and a concrete value for the producer (and the opposite at some other time)?
+Spring Cloud Contract lets you provide a dynamic value. That means that it can differ for both
+sides of the communication.</p>
+</div>
+<div class="paragraph">
+<p>You can read more about this in the <a href="project-features.html#contract-dsl">Contract DSL</a> section.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Read the <a href="https://groovy-lang.org/json.html">Groovy docs related to JSON</a> to understand how to
+properly structure the request and response bodies.
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="how-to-do-stubs-versioning"><a class="anchor" href="#how-to-do-stubs-versioning"></a><a class="link" href="#how-to-do-stubs-versioning">4. How to Do Stubs versioning?</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This section covers version of the stubs, which you can handle in a number of different ways:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#how-to-api-versioning">API Versioning</a></p>
+</li>
+<li>
+<p><a href="#how-to-jar-versioning">JAR versioning</a></p>
+</li>
+<li>
+<p><a href="#how-to-dev-or-prod-stubs">Development or Production Stubs</a></p>
+</li>
+</ul>
+</div>
+<div class="sect2">
+<h3 id="how-to-api-versioning"><a class="anchor" href="#how-to-api-versioning"></a><a class="link" href="#how-to-api-versioning">4.1. API Versioning</a></h3>
+<div class="paragraph">
+<p>What does versioning really mean? If you refer to the API version, there are
+different approaches:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Use hypermedia links and do not version your API by any means</p>
+</li>
+<li>
+<p>Pass the version through headers and URLs</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>We do not try to answer the question of which approach is better. You should pick whatever
+suits your needs and lets you generate business value.</p>
+</div>
+<div class="paragraph">
+<p>Assume that you do version your API. In that case, you should provide as many contracts with as many versions as you support.
+You can create a subfolder for every version or append it to the contract name&#8201;&#8212;&#8201;whatever suits you best.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-jar-versioning"><a class="anchor" href="#how-to-jar-versioning"></a><a class="link" href="#how-to-jar-versioning">4.2. JAR versioning</a></h3>
+<div class="paragraph">
+<p>If, by versioning, you mean the version of the JAR that contains the stubs, then there are essentially two main approaches.</p>
+</div>
+<div class="paragraph">
+<p>Assume that you do continuous delivery and deployment, which means that you generate a new version of
+the jar each time you go through the pipeline and that the jar can go to production at any time. For example, your jar version
+looks like the following (because it got built on the 20.10.2016 at 20:15:21) :</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">1.0.0.20161020-201521-RELEASE</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In that case your, generated stub jar should look like the following:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">1.0.0.20161020-201521-RELEASE-stubs.jar</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In this case, you should, inside your <code>application.yml</code> or <code>@AutoConfigureStubRunner</code> when
+referencing stubs, provide the latest version of the stubs. You can do that by passing the
+<code>+</code> sign. the following example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:stubs:8080"})</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>If the versioning, however, is fixed (for example, <code>1.0.4.RELEASE</code> or <code>2.1.1</code>), you have to set the concrete value of the jar
+version. The following example shows how to do so for version 2.1.1:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:2.1.1:stubs:8080"})</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-dev-or-prod-stubs"><a class="anchor" href="#how-to-dev-or-prod-stubs"></a><a class="link" href="#how-to-dev-or-prod-stubs">4.3. Development or Production Stubs</a></h3>
+<div class="paragraph">
+<p>You can manipulate the classifier to run the tests against current the development version
+of the stubs of other services or the ones that were deployed to production. If you alter
+your build to deploy the stubs with the <code>prod-stubs</code> classifier once you reach production
+deployment, you can run tests in one case with development stubs and one with production stubs.</p>
+</div>
+<div class="paragraph">
+<p>The following example works for tests that use the development version of the stubs:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:stubs:8080"})</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example works for tests that use the production version of stubs:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:prod-stubs:8080"})</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can also pass those values also in properties from your deployment pipeline.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="how-to-common-repo-with-contracts"><a class="anchor" href="#how-to-common-repo-with-contracts"></a><a class="link" href="#how-to-common-repo-with-contracts">5. How Can I use a Common Repository with Contracts Instead of Storing Them with the Producer?</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Another way of storing contracts, rather than having them with the producer, is to keep
+them in a common place. This situation can be related to security issues (where the
+consumers cannot clone the producer&#8217;s code). Also if you keep contracts in a single place,
+then you, as a producer, know how many consumers you have and which consumer you may break
+with your local changes.</p>
+</div>
+<div class="sect2">
+<h3 id="how-to-repo-structure"><a class="anchor" href="#how-to-repo-structure"></a><a class="link" href="#how-to-repo-structure">5.1. Repo Structure</a></h3>
+<div class="paragraph">
+<p>Assume that we have a producer with coordinates of <code>com.example:server</code> and three
+consumers: <code>client1</code>, <code>client2</code>, and <code>client3</code>. Then, in the repository with common
+contracts, you could have the following setup (which you can check out
+<a href="https://github.com/spring-cloud/spring-cloud-contract/tree/{branch}/samples/standalone/contracts">here</a>).
+The following listing shows such a structure:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">├── com
+│   └── example
+│       └── server
+│           ├── client1
+│           │   └── expectation.groovy
+│           ├── client2
+│           │   └── expectation.groovy
+│           ├── client3
+│           │   └── expectation.groovy
+│           └── pom.xml
+├── mvnw
+├── mvnw.cmd
+├── pom.xml
+└── src
+    └── assembly
+        └── contracts.xml</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>As you can see under the slash-delimited <code>groupid/artifact id</code> folder (<code>com/example/server</code>) you have
+expectations of the three consumers (<code>client1</code>, <code>client2</code>, and <code>client3</code>). Expectations are the standard Groovy DSL
+contract files, as described throughout this documentation. This repository has to produce a JAR file that maps
+one-to-one to the contents of the repository.</p>
+</div>
+<div class="paragraph">
+<p>The following example shows a <code>pom.xml</code> inside the <code>server</code> folder:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;?xml version="1.0" encoding="UTF-8"?&gt;
+&lt;project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xmlns="http://maven.apache.org/POM/4.0.0"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"&gt;
+    &lt;modelVersion&gt;4.0.0&lt;/modelVersion&gt;
+
+    &lt;groupId&gt;com.example&lt;/groupId&gt;
+    &lt;artifactId&gt;server&lt;/artifactId&gt;
+    &lt;version&gt;0.0.1-SNAPSHOT&lt;/version&gt;
+
+    &lt;name&gt;Server Stubs&lt;/name&gt;
+    &lt;description&gt;POM used to install locally stubs for consumer side&lt;/description&gt;
+
+    &lt;parent&gt;
+        &lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;
+        &lt;artifactId&gt;spring-boot-starter-parent&lt;/artifactId&gt;
+        &lt;version&gt;2.2.0.BUILD-SNAPSHOT&lt;/version&gt;
+        &lt;relativePath/&gt;
+    &lt;/parent&gt;
+
+    &lt;properties&gt;
+        &lt;project.build.sourceEncoding&gt;UTF-8&lt;/project.build.sourceEncoding&gt;
+        &lt;java.version&gt;1.8&lt;/java.version&gt;
+        &lt;spring-cloud-contract.version&gt;2.2.0.BUILD-SNAPSHOT&lt;/spring-cloud-contract.version&gt;
+        &lt;spring-cloud-release.version&gt;Hoxton.BUILD-SNAPSHOT&lt;/spring-cloud-release.version&gt;
+        &lt;excludeBuildFolders&gt;true&lt;/excludeBuildFolders&gt;
+    &lt;/properties&gt;
+
+    &lt;dependencyManagement&gt;
+        &lt;dependencies&gt;
+            &lt;dependency&gt;
+                &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+                &lt;artifactId&gt;spring-cloud-dependencies&lt;/artifactId&gt;
+                &lt;version&gt;${spring-cloud-release.version}&lt;/version&gt;
+                &lt;type&gt;pom&lt;/type&gt;
+                &lt;scope&gt;import&lt;/scope&gt;
+            &lt;/dependency&gt;
+        &lt;/dependencies&gt;
+    &lt;/dependencyManagement&gt;
+
+    &lt;build&gt;
+        &lt;plugins&gt;
+            &lt;plugin&gt;
+                &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+                &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+                &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+                &lt;extensions&gt;true&lt;/extensions&gt;
+                &lt;configuration&gt;
+                    &lt;!-- By default it would search under src/test/resources/ --&gt;
+                    &lt;contractsDirectory&gt;${project.basedir}&lt;/contractsDirectory&gt;
+                &lt;/configuration&gt;
+            &lt;/plugin&gt;
+        &lt;/plugins&gt;
+    &lt;/build&gt;
+
+    &lt;repositories&gt;
+        &lt;repository&gt;
+            &lt;id&gt;spring-snapshots&lt;/id&gt;
+            &lt;name&gt;Spring Snapshots&lt;/name&gt;
+            &lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
+            &lt;snapshots&gt;
+                &lt;enabled&gt;true&lt;/enabled&gt;
+            &lt;/snapshots&gt;
+        &lt;/repository&gt;
+        &lt;repository&gt;
+            &lt;id&gt;spring-milestones&lt;/id&gt;
+            &lt;name&gt;Spring Milestones&lt;/name&gt;
+            &lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
+            &lt;snapshots&gt;
+                &lt;enabled&gt;false&lt;/enabled&gt;
+            &lt;/snapshots&gt;
+        &lt;/repository&gt;
+        &lt;repository&gt;
+            &lt;id&gt;spring-releases&lt;/id&gt;
+            &lt;name&gt;Spring Releases&lt;/name&gt;
+            &lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
+            &lt;snapshots&gt;
+                &lt;enabled&gt;false&lt;/enabled&gt;
+            &lt;/snapshots&gt;
+        &lt;/repository&gt;
+    &lt;/repositories&gt;
+    &lt;pluginRepositories&gt;
+        &lt;pluginRepository&gt;
+            &lt;id&gt;spring-snapshots&lt;/id&gt;
+            &lt;name&gt;Spring Snapshots&lt;/name&gt;
+            &lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
+            &lt;snapshots&gt;
+                &lt;enabled&gt;true&lt;/enabled&gt;
+            &lt;/snapshots&gt;
+        &lt;/pluginRepository&gt;
+        &lt;pluginRepository&gt;
+            &lt;id&gt;spring-milestones&lt;/id&gt;
+            &lt;name&gt;Spring Milestones&lt;/name&gt;
+            &lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
+            &lt;snapshots&gt;
+                &lt;enabled&gt;false&lt;/enabled&gt;
+            &lt;/snapshots&gt;
+        &lt;/pluginRepository&gt;
+        &lt;pluginRepository&gt;
+            &lt;id&gt;spring-releases&lt;/id&gt;
+            &lt;name&gt;Spring Releases&lt;/name&gt;
+            &lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
+            &lt;snapshots&gt;
+                &lt;enabled&gt;false&lt;/enabled&gt;
+            &lt;/snapshots&gt;
+        &lt;/pluginRepository&gt;
+    &lt;/pluginRepositories&gt;
+
+&lt;/project&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>There are no dependencies other than the Spring Cloud Contract Maven Plugin.
+Those pom files are necessary for the consumer side to run <code>mvn clean install -DskipTests</code> to locally install
+the stubs of the producer project.</p>
+</div>
+<div class="paragraph">
+<p>The <code>pom.xml</code> in the root folder can look like the following:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;?xml version="1.0" encoding="UTF-8"?&gt;
+&lt;project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xmlns="http://maven.apache.org/POM/4.0.0"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"&gt;
+    &lt;modelVersion&gt;4.0.0&lt;/modelVersion&gt;
+
+    &lt;groupId&gt;com.example.standalone&lt;/groupId&gt;
+    &lt;artifactId&gt;contracts&lt;/artifactId&gt;
+    &lt;version&gt;0.0.1-SNAPSHOT&lt;/version&gt;
+
+    &lt;name&gt;Contracts&lt;/name&gt;
+    &lt;description&gt;Contains all the Spring Cloud Contracts, well, contracts. JAR used by the
+        producers to generate tests and stubs
+    &lt;/description&gt;
+
+    &lt;properties&gt;
+        &lt;project.build.sourceEncoding&gt;UTF-8&lt;/project.build.sourceEncoding&gt;
+    &lt;/properties&gt;
+
+    &lt;build&gt;
+        &lt;plugins&gt;
+            &lt;plugin&gt;
+                &lt;groupId&gt;org.apache.maven.plugins&lt;/groupId&gt;
+                &lt;artifactId&gt;maven-assembly-plugin&lt;/artifactId&gt;
+                &lt;executions&gt;
+                    &lt;execution&gt;
+                        &lt;id&gt;contracts&lt;/id&gt;
+                        &lt;phase&gt;prepare-package&lt;/phase&gt;
+                        &lt;goals&gt;
+                            &lt;goal&gt;single&lt;/goal&gt;
+                        &lt;/goals&gt;
+                        &lt;configuration&gt;
+                            &lt;attach&gt;true&lt;/attach&gt;
+                            &lt;descriptor&gt;${basedir}/src/assembly/contracts.xml&lt;/descriptor&gt;
+                            &lt;!-- If you want an explicit classifier remove the following line --&gt;
+                            &lt;appendAssemblyId&gt;false&lt;/appendAssemblyId&gt;
+                        &lt;/configuration&gt;
+                    &lt;/execution&gt;
+                &lt;/executions&gt;
+            &lt;/plugin&gt;
+        &lt;/plugins&gt;
+    &lt;/build&gt;
+
+&lt;/project&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>It uses the assembly plugin to build the JAR with all the contracts. The following example
+shows such a setup:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;assembly xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+          xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3"
+          xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 https://maven.apache.org/xsd/assembly-1.1.3.xsd"&gt;
+    &lt;id&gt;project&lt;/id&gt;
+    &lt;formats&gt;
+        &lt;format&gt;jar&lt;/format&gt;
+    &lt;/formats&gt;
+    &lt;includeBaseDirectory&gt;false&lt;/includeBaseDirectory&gt;
+    &lt;fileSets&gt;
+        &lt;fileSet&gt;
+            &lt;directory&gt;${project.basedir}&lt;/directory&gt;
+            &lt;outputDirectory&gt;/&lt;/outputDirectory&gt;
+            &lt;useDefaultExcludes&gt;true&lt;/useDefaultExcludes&gt;
+            &lt;excludes&gt;
+                &lt;exclude&gt;**/${project.build.directory}/**&lt;/exclude&gt;
+                &lt;exclude&gt;mvnw&lt;/exclude&gt;
+                &lt;exclude&gt;mvnw.cmd&lt;/exclude&gt;
+                &lt;exclude&gt;.mvn/**&lt;/exclude&gt;
+                &lt;exclude&gt;src/**&lt;/exclude&gt;
+            &lt;/excludes&gt;
+        &lt;/fileSet&gt;
+    &lt;/fileSets&gt;
+&lt;/assembly&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-workflow"><a class="anchor" href="#how-to-workflow"></a><a class="link" href="#how-to-workflow">5.2. Workflow</a></h3>
+<div class="paragraph">
+<p>The workflow assumes that Spring Cloud Contract is set up both on the consumer and on the
+producer side. There is also the proper plugin setup in the common repository with
+contracts. The CI jobs are set for a common repository to build an artifact of all
+contracts and upload it to Nexus/Artifactory. The following image shows the UML for this
+workflow:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/how-to-common-repo.png" alt="how to common repo" width="1588" height="1421">
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-workflow-consumer"><a class="anchor" href="#how-to-workflow-consumer"></a><a class="link" href="#how-to-workflow-consumer">5.3. Consumer</a></h3>
+<div class="paragraph">
+<p>When the consumer wants to work on the contracts offline, instead of cloning the producer
+code, the consumer team clones the common repository, goes to the required producer&#8217;s
+folder (for example, <code>com/example/server</code>) and runs <code>mvn clean install -DskipTests</code> to
+locally install the stubs converted from the contracts.</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+You need to have <a href="https://maven.apache.org/download.cgi">Maven installed locally</a>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-workflow-producer"><a class="anchor" href="#how-to-workflow-producer"></a><a class="link" href="#how-to-workflow-producer">5.4. Producer</a></h3>
+<div class="paragraph">
+<p>As a producer, you can to alter the Spring Cloud Contract Verifier to provide the URL and
+the dependency of the JAR that contains the contracts, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;configuration&gt;
+        &lt;contractsMode&gt;REMOTE&lt;/contractsMode&gt;
+        &lt;contractsRepositoryUrl&gt;
+            https://link/to/your/nexus/or/artifactory/or/sth
+        &lt;/contractsRepositoryUrl&gt;
+        &lt;contractDependency&gt;
+            &lt;groupId&gt;com.example.standalone&lt;/groupId&gt;
+            &lt;artifactId&gt;contracts&lt;/artifactId&gt;
+        &lt;/contractDependency&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>With this setup, the JAR with a groupid of <code>com.example.standalone</code> and artifactid
+<code>contracts</code> is downloaded from <code><a href="https://link/to/your/nexus/or/artifactory/or/sth" class="bare">link/to/your/nexus/or/artifactory/or/sth</a></code>. It is
+then unpacked in a local temporary folder, and the contracts present in
+<code>com/example/server</code> are picked as the ones used to generate the tests and the stubs. Due
+to this convention, the producer team can know which consumer teams will be broken when
+some incompatible changes are made.</p>
+</div>
+<div class="paragraph">
+<p>The rest of the flow looks the same.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-define-messaging-contracts-per-topic"><a class="anchor" href="#how-to-define-messaging-contracts-per-topic"></a><a class="link" href="#how-to-define-messaging-contracts-per-topic">5.5. How Can I Define Messaging Contracts per Topic Rather than per Producer?</a></h3>
+<div class="paragraph">
+<p>To avoid messaging contracts duplication in the common repository, when a few producers write messages to one topic,
+we could create a structure in which the REST contracts are placed in a folder per producer and messaging
+contracts are placed in the folder per topic.</p>
+</div>
+<div class="sect3">
+<h4 id="how-to-define-messaging-contracts-per-topic-maven"><a class="anchor" href="#how-to-define-messaging-contracts-per-topic-maven"></a><a class="link" href="#how-to-define-messaging-contracts-per-topic-maven">5.5.1. For Maven Projects</a></h4>
+<div class="paragraph">
+<p>To make it possible to work on the producer side, we should specify an inclusion pattern for
+filtering common repository jar files by messaging topics we are interested in. The
+<code>includedFiles</code> property of the Maven Spring Cloud Contract plugin
+lets us do so. Also, <code>contractsPath</code> need to be specified, since the default path would be
+the common repository <code>groupid/artifactid</code>. The following example shows a Maven
+plugin for Spring Cloud Contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+   &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+   &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+   &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+   &lt;configuration&gt;
+      &lt;contractsMode&gt;REMOTE&lt;/contractsMode&gt;
+      &lt;contractsRepositoryUrl&gt;https://link/to/your/nexus/or/artifactory/or/sth&lt;/contractsRepositoryUrl&gt;
+      &lt;contractDependency&gt;
+         &lt;groupId&gt;com.example&lt;/groupId&gt;
+         &lt;artifactId&gt;common-repo-with-contracts&lt;/artifactId&gt;
+         &lt;version&gt;+&lt;/version&gt;
+      &lt;/contractDependency&gt;
+      &lt;contractsPath&gt;/&lt;/contractsPath&gt;
+      &lt;baseClassMappings&gt;
+         &lt;baseClassMapping&gt;
+            &lt;contractPackageRegex&gt;.*messaging.*&lt;/contractPackageRegex&gt;
+            &lt;baseClassFQN&gt;com.example.services.MessagingBase&lt;/baseClassFQN&gt;
+         &lt;/baseClassMapping&gt;
+         &lt;baseClassMapping&gt;
+            &lt;contractPackageRegex&gt;.*rest.*&lt;/contractPackageRegex&gt;
+            &lt;baseClassFQN&gt;com.example.services.TestBase&lt;/baseClassFQN&gt;
+         &lt;/baseClassMapping&gt;
+      &lt;/baseClassMappings&gt;
+      &lt;includedFiles&gt;
+         &lt;includedFile&gt;**/${project.artifactId}/**&lt;/includedFile&gt;
+         &lt;includedFile&gt;**/${first-topic}/**&lt;/includedFile&gt;
+         &lt;includedFile&gt;**/${second-topic}/**&lt;/includedFile&gt;
+      &lt;/includedFiles&gt;
+   &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+Many of the values in the preceding Maven plugin can be changed. We included it for
+illustration purposes rather than trying to provide a &#8220;typical&#8221; example.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect3">
+<h4 id="how-to-define-messaging-contracts-per-topic-gradle"><a class="anchor" href="#how-to-define-messaging-contracts-per-topic-gradle"></a><a class="link" href="#how-to-define-messaging-contracts-per-topic-gradle">5.5.2. For Gradle Projects</a></h4>
+<div class="paragraph">
+<p>To work with a Gradle project:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Add a custom configuration for the common repository dependency, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">ext {
+    conractsGroupId = "com.example"
+    contractsArtifactId = "common-repo"
+    contractsVersion = "1.2.3"
+}
+
+configurations {
+    contracts {
+        transitive = false
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Add the common repository dependency to your classpath, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">dependencies {
+    contracts "${conractsGroupId}:${contractsArtifactId}:${contractsVersion}"
+    testCompile "${conractsGroupId}:${contractsArtifactId}:${contractsVersion}"
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Download the dependency to an appropriate folder, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">task getContracts(type: Copy) {
+    from configurations.contracts
+    into new File(project.buildDir, "downloadedContracts")
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Unzip the JAR, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">task unzipContracts(type: Copy) {
+    def zipFile = new File(project.buildDir, "downloadedContracts/${contractsArtifactId}-${contractsVersion}.jar")
+    def outputDir = file("${buildDir}/unpackedContracts")
+
+    from zipTree(zipFile)
+    into outputDir
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Cleanup unused contracts, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">task deleteUnwantedContracts(type: Delete) {
+    delete fileTree(dir: "${buildDir}/unpackedContracts",
+        include: "**/*",
+        excludes: [
+            "**/${project.name}/**"",
+            "**/${first-topic}/**",
+            "**/${second-topic}/**"])
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Create task dependencies, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">unzipContracts.dependsOn("getContracts")
+deleteUnwantedContracts.dependsOn("unzipContracts")
+build.dependsOn("deleteUnwantedContracts")</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Configure the plugin by specifying the directory that contains the contracts, by setting
+the <code>contractsDslDir</code> property, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+    contractsDslDir = new File("${buildDir}/unpackedContracts")
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="how-to-use-git-as-storage"><a class="anchor" href="#how-to-use-git-as-storage"></a><a class="link" href="#how-to-use-git-as-storage">6. How Can I Use Git as the Storage for Contracts and Stubs?</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>In the polyglot world, there are languages that do not use binary storages, as
+Artifactory or Nexus do. Starting from Spring Cloud Contract version 2.0.0, we provide
+mechanisms to store contracts and stubs in a SCM (Source Control Management) repository. Currently, the
+only supported SCM is Git.</p>
+</div>
+<div class="paragraph">
+<p>The repository would have to have the following setup
+(which you can checkout from <a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x/contracts_git/">here</a>):</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code>.
+└── META-INF
+    └── com.example
+        └── beer-api-producer-git
+            └── 0.0.1-SNAPSHOT
+                ├── contracts
+                │   └── beer-api-consumer
+                │       ├── messaging
+                │       │   ├── shouldSendAcceptedVerification.groovy
+                │       │   └── shouldSendRejectedVerification.groovy
+                │       └── rest
+                │           ├── shouldGrantABeerIfOldEnough.groovy
+                │           └── shouldRejectABeerIfTooYoung.groovy
+                └── mappings
+                    └── beer-api-consumer
+                        └── rest
+                            ├── shouldGrantABeerIfOldEnough.json
+                            └── shouldRejectABeerIfTooYoung.json</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Under the <code>META-INF</code> folder:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>We group applications by <code>groupId</code> (such as <code>com.example</code>).</p>
+</li>
+<li>
+<p>Each application is represented by its <code>artifactId</code> (for example, <code>beer-api-producer-git</code>).</p>
+</li>
+<li>
+<p>Next, each application is organized by its version (such as <code>0.0.1-SNAPSHOT</code>). Starting
+from Spring Cloud Contract version <code>2.1.0</code>, you can specify the versions as follows
+(assuming that your versions follow semantic versioning):</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>+</code> or <code>latest</code>: To find the latest version of your stubs (assuming that the snapshots
+are always the latest artifact for a given revision number). That means:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>If you have <code>1.0.0.RELEASE</code>, <code>2.0.0.BUILD-SNAPSHOT</code>, and <code>2.0.0.RELEASE</code>, we assume
+that the latest is <code>2.0.0.BUILD-SNAPSHOT</code>.</p>
+</li>
+<li>
+<p>If you have <code>1.0.0.RELEASE</code> and <code>2.0.0.RELEASE</code>, we assume that the latest is <code>2.0.0.RELEASE</code>.</p>
+</li>
+<li>
+<p>If you have a version called <code>latest</code> or <code>+</code>, we will pick that folder.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><code>release</code>: To find the latest release version of your stubs. That means:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>If you have <code>1.0.0.RELEASE</code>, <code>2.0.0.BUILD-SNAPSHOT</code>, and <code>2.0.0.RELEASE</code> we assume
+that the latest is <code>2.0.0.RELEASE</code>.</p>
+</li>
+<li>
+<p>If you have a version called <code>release</code>, we pick that folder.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Finally, there are two folders:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>contracts</code>: The good practice is to store the contracts required by each
+consumer in the folder with the consumer name (such as <code>beer-api-consumer</code>). That way, you
+can use the <code>stubs-per-consumer</code> feature. Further directory structure is arbitrary.</p>
+</li>
+<li>
+<p><code>mappings</code>: The Maven or Gradle Spring Cloud Contract plugins push
+the stub server mappings in this folder. On the consumer side, Stub Runner scans this folder
+to start stub servers with stub definitions. The folder structure is a copy
+of the one created in the <code>contracts</code> subfolder.</p>
+</li>
+</ul>
+</div>
+<div class="sect2">
+<h3 id="how-to-protocol-convention"><a class="anchor" href="#how-to-protocol-convention"></a><a class="link" href="#how-to-protocol-convention">6.1. Protocol Convention</a></h3>
+<div class="paragraph">
+<p>To control the type and location of the source of contracts (whether
+binary storage or an SCM repository), you can use the protocol in the URL of
+the repository. Spring Cloud Contract iterates over registered protocol resolvers
+and tries to fetch the contracts (by using a plugin) or stubs (from Stub Runner).</p>
+</div>
+<div class="paragraph">
+<p>For the SCM functionality, currently, we support the Git repository. To use it,
+in the property where the repository URL needs to be placed, you have to prefix
+the connection URL with <code>git://</code>. The following listing shows some examples:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code>git://file:///foo/bar
+git://https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git
+git://git@github.com:spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-protocol-convention-producer"><a class="anchor" href="#how-to-protocol-convention-producer"></a><a class="link" href="#how-to-protocol-convention-producer">6.2. Producer</a></h3>
+<div class="paragraph">
+<p>For the producer, to use the SCM (Source Control Management) approach, we can reuse the
+same mechanism we use for external contracts. We route Spring Cloud Contract
+to use the SCM implementation from the URL that starts with
+the <code>git://</code> protocol.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+You have to manually add the <code>pushStubsToScm</code>
+goal in Maven or execute (bind) the <code>pushStubsToScm</code> task in
+Gradle. We do not push stubs to the <code>origin</code> of your git
+repository.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following listing includes the relevant parts both Maven and Gradle build files:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;!-- Base class mappings etc. --&gt;
+
+        &lt;!-- We want to pick contracts from a Git repository --&gt;
+        &lt;contractsRepositoryUrl&gt;git://https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git&lt;/contractsRepositoryUrl&gt;
+
+        &lt;!-- We reuse the contract dependency section to set up the path
+        to the folder that contains the contract definitions. In our case the
+        path will be /groupId/artifactId/version/contracts --&gt;
+        &lt;contractDependency&gt;
+            &lt;groupId&gt;${project.groupId}&lt;/groupId&gt;
+            &lt;artifactId&gt;${project.artifactId}&lt;/artifactId&gt;
+            &lt;version&gt;${project.version}&lt;/version&gt;
+        &lt;/contractDependency&gt;
+
+        &lt;!-- The contracts mode can't be classpath --&gt;
+        &lt;contractsMode&gt;REMOTE&lt;/contractsMode&gt;
+    &lt;/configuration&gt;
+    &lt;executions&gt;
+        &lt;execution&gt;
+            &lt;phase&gt;package&lt;/phase&gt;
+            &lt;goals&gt;
+                &lt;!-- By default we will not push the stubs back to SCM,
+                you have to explicitly add it as a goal --&gt;
+                &lt;goal&gt;pushStubsToScm&lt;/goal&gt;
+            &lt;/goals&gt;
+        &lt;/execution&gt;
+    &lt;/executions&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+    // We want to pick contracts from a Git repository
+    contractDependency {
+        stringNotation = "${project.group}:${project.name}:${project.version}"
+    }
+    /*
+    We reuse the contract dependency section to set up the path
+    to the folder that contains the contract definitions. In our case the
+    path will be /groupId/artifactId/version/contracts
+     */
+    contractRepository {
+        repositoryUrl = "git://https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git"
+    }
+    // The mode can't be classpath
+    contractsMode = "REMOTE"
+    // Base class mappings etc.
+}
+
+/*
+In this scenario we want to publish stubs to SCM whenever
+the `publish` task is executed
+*/
+publish.dependsOn("publishStubsToScm")</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>With such a setup:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>A git project is cloned to a temporary directory</p>
+</li>
+<li>
+<p>The SCM stub downloader goes to <code>META-INF/groupId/artifactId/version/contracts</code> folder
+to find contracts. For example, for <code>com.example:foo:1.0.0</code>, the path would be
+<code>META-INF/com.example/foo/1.0.0/contracts</code>.</p>
+</li>
+<li>
+<p>Tests are generated from the contracts.</p>
+</li>
+<li>
+<p>Stubs are created from the contracts.</p>
+</li>
+<li>
+<p>Once the tests pass, the stubs are committed in the cloned repository.</p>
+</li>
+<li>
+<p>Finally, a push is sent to that repo&#8217;s <code>origin</code>.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-protocol-convention-producer-with-contracts-stored-locally"><a class="anchor" href="#how-to-protocol-convention-producer-with-contracts-stored-locally"></a><a class="link" href="#how-to-protocol-convention-producer-with-contracts-stored-locally">6.3. Producer with Contracts Stored Locally</a></h3>
+<div class="paragraph">
+<p>Another option to use the SCM as the destination for stubs and contracts is to store the
+contracts locally, with the producer, and only push the contracts and the stubs to SCM.
+The following listing shows the setup required to achieve this with Maven and Gradle:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;!-- In the default configuration, we want to use the contracts stored locally --&gt;
+    &lt;configuration&gt;
+        &lt;baseClassMappings&gt;
+            &lt;baseClassMapping&gt;
+                &lt;contractPackageRegex&gt;.*messaging.*&lt;/contractPackageRegex&gt;
+                &lt;baseClassFQN&gt;com.example.BeerMessagingBase&lt;/baseClassFQN&gt;
+            &lt;/baseClassMapping&gt;
+            &lt;baseClassMapping&gt;
+                &lt;contractPackageRegex&gt;.*rest.*&lt;/contractPackageRegex&gt;
+                &lt;baseClassFQN&gt;com.example.BeerRestBase&lt;/baseClassFQN&gt;
+            &lt;/baseClassMapping&gt;
+        &lt;/baseClassMappings&gt;
+        &lt;basePackageForTests&gt;com.example&lt;/basePackageForTests&gt;
+    &lt;/configuration&gt;
+    &lt;executions&gt;
+        &lt;execution&gt;
+            &lt;phase&gt;package&lt;/phase&gt;
+            &lt;goals&gt;
+                &lt;!-- By default we will not push the stubs back to SCM,
+                you have to explicitly add it as a goal --&gt;
+                &lt;goal&gt;pushStubsToScm&lt;/goal&gt;
+            &lt;/goals&gt;
+            &lt;configuration&gt;
+                &lt;!-- We want to pick contracts from a Git repository --&gt;
+                &lt;contractsRepositoryUrl&gt;git://file://${env.ROOT}/target/contract_empty_git/
+                &lt;/contractsRepositoryUrl&gt;
+                &lt;!-- Example of URL via git protocol --&gt;
+                &lt;!--&lt;contractsRepositoryUrl&gt;git://git@github.com:spring-cloud-samples/spring-cloud-contract-samples.git&lt;/contractsRepositoryUrl&gt;--&gt;
+                &lt;!-- Example of URL via http protocol --&gt;
+                &lt;!--&lt;contractsRepositoryUrl&gt;git://https://github.com/spring-cloud-samples/spring-cloud-contract-samples.git&lt;/contractsRepositoryUrl&gt;--&gt;
+                &lt;!-- We reuse the contract dependency section to set up the path
+                to the folder that contains the contract definitions. In our case the
+                path will be /groupId/artifactId/version/contracts --&gt;
+                &lt;contractDependency&gt;
+                    &lt;groupId&gt;${project.groupId}&lt;/groupId&gt;
+                    &lt;artifactId&gt;${project.artifactId}&lt;/artifactId&gt;
+                    &lt;version&gt;${project.version}&lt;/version&gt;
+                &lt;/contractDependency&gt;
+                &lt;!-- The mode can't be classpath --&gt;
+                &lt;contractsMode&gt;LOCAL&lt;/contractsMode&gt;
+            &lt;/configuration&gt;
+        &lt;/execution&gt;
+    &lt;/executions&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+        // Base package for generated tests
+    basePackageForTests = "com.example"
+    baseClassMappings {
+        baseClassMapping(".*messaging.*", "com.example.BeerMessagingBase")
+        baseClassMapping(".*rest.*", "com.example.BeerRestBase")
+    }
+}
+
+/*
+In this scenario we want to publish stubs to SCM whenever
+the `publish` task is executed
+*/
+publishStubsToScm {
+    // We want to modify the default set up of the plugin when publish stubs to scm is called
+    customize {
+        // We want to pick contracts from a Git repository
+        contractDependency {
+            stringNotation = "${project.group}:${project.name}:${project.version}"
+        }
+        /*
+        We reuse the contract dependency section to set up the path
+        to the folder that contains the contract definitions. In our case the
+        path will be /groupId/artifactId/version/contracts
+         */
+        contractRepository {
+            repositoryUrl = "git://file://${System.getenv("ROOT")}/target/contract_empty_git/"
+        }
+        // The mode can't be classpath
+        contractsMode = "LOCAL"
+    }
+}
+
+publish.dependsOn("publishStubsToScm")
+publishToMavenLocal.dependsOn("publishStubsToScm")</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>With such a setup:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Contracts from the default <code>src/test/resources/contracts</code> directory are picked.</p>
+</li>
+<li>
+<p>Tests are generated from the contracts.</p>
+</li>
+<li>
+<p>Stubs are created from the contracts.</p>
+</li>
+<li>
+<p>Once the tests pass:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>The git project is cloned to a temporary directory.</p>
+</li>
+<li>
+<p>The stubs and contracts are committed in the cloned repository.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Finally, a push is done to that repository&#8217;s <code>origin</code>.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-protocol-convention-contracts-producer-stubs-external"><a class="anchor" href="#how-to-protocol-convention-contracts-producer-stubs-external"></a><a class="link" href="#how-to-protocol-convention-contracts-producer-stubs-external">6.4. Keeping Contracts with the Producer and Stubs in an External Repository</a></h3>
+<div class="paragraph">
+<p>You can also keep the contracts in the producer repository but keep the stubs in an external git repository.
+This is most useful when you want to use the base consumer-producer collaboration flow but cannot
+use an artifact repository to store the stubs.</p>
+</div>
+<div class="paragraph">
+<p>To do so, use the usual producer setup and then add the <code>pushStubsToScm</code> goal and set
+<code>contractsRepositoryUrl</code> to the repository where you want to keep the stubs.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-protocol-convention-contracts-producer-stubs-external-consumer"><a class="anchor" href="#how-to-protocol-convention-contracts-producer-stubs-external-consumer"></a><a class="link" href="#how-to-protocol-convention-contracts-producer-stubs-external-consumer">6.5. Consumer</a></h3>
+<div class="paragraph">
+<p>On the consumer side, when passing the <code>repositoryRoot</code> parameter,
+either from the <code>@AutoConfigureStubRunner</code> annotation, the
+JUnit rule, JUnit 5 extension, or properties, you can pass the URL of the
+SCM repository, prefixed with the <code>git://</code> protocol. The following example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(
+    stubsMode="REMOTE",
+    repositoryRoot="git://https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git",
+    ids="com.example:bookstore:0.0.1.RELEASE"
+)</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>With such a setup:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The git project is cloned to a temporary directory.</p>
+</li>
+<li>
+<p>The SCM stub downloader goes to thje <code>META-INF/groupId/artifactId/version/</code> folder
+to find stub definitions and contracts. For example, for <code>com.example:foo:1.0.0</code>, the path would be
+<code>META-INF/com.example/foo/1.0.0/</code>.</p>
+</li>
+<li>
+<p>Stub servers are started and fed with mappings.</p>
+</li>
+<li>
+<p>Messaging definitions are read and used in the messaging tests.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="how-to-use-pact-broker"><a class="anchor" href="#how-to-use-pact-broker"></a><a class="link" href="#how-to-use-pact-broker">7. How Can I Use the Pact Broker?</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>When using <a href="https://pact.io/">Pact</a>, you can use the <a href="https://github.com/pact-foundation/pact_broker">Pact Broker</a>
+to store and share Pact definitions. Starting from Spring Cloud Contract
+2.0.0, you can fetch Pact files from the Pact Broker to generate
+tests and stubs.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Pact follows the consumer contract convention. That means
+that the consumer creates the Pact definitions first and then
+shares the files with the Producer. Those expectations are generated
+from the Consumer&#8217;s code and can break the Producer if the expectations
+are not met.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2">
+<h3 id="how-to-use-pact-broker-pact"><a class="anchor" href="#how-to-use-pact-broker-pact"></a><a class="link" href="#how-to-use-pact-broker-pact">7.1. How to Work with Pact</a></h3>
+<div class="paragraph">
+<p>Spring Cloud Contract includes support for the <a href="https://docs.pact.io/">Pact</a> representation of
+contracts up until version 4. Instead of using the DSL, you can use Pact files. In this section, we
+show how to add Pact support for your project. Note, however, that not all functionality is supported.
+Starting with version 3, you can combine multiple matchers for the same element;
+you can use matchers for the body, headers, request and path; and you can use value generators.
+Spring Cloud Contract currently only supports multiple matchers that are combined by using the <code>AND</code> rule logic.
+Next to that, the request and path matchers are skipped during the conversion.
+When using a date, time, or datetime value generator with a given format,
+the given format is skipped and the ISO format is used.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-use-pact-broker-pact-converter"><a class="anchor" href="#how-to-use-pact-broker-pact-converter"></a><a class="link" href="#how-to-use-pact-broker-pact-converter">7.2. Pact Converter</a></h3>
+<div class="paragraph">
+<p>In order to properly support the Spring Cloud Contract way of doing messaging
+with Pact, you have to provide some additional meta data entries.</p>
+</div>
+<div class="paragraph">
+<p>To define the destination to which a message gets sent, you have to
+set a <code>metaData</code> entry in the Pact file with the <code>sentTo</code> key equal to the destination to
+ which a message is to be sent (for example, <code>"metaData": { "sentTo": "activemq:output" }</code>).</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-use-pact-broker-pact-contract"><a class="anchor" href="#how-to-use-pact-broker-pact-contract"></a><a class="link" href="#how-to-use-pact-broker-pact-contract">7.3. Pact Contract</a></h3>
+<div class="paragraph">
+<p>Spring Cloud Contract can read the Pact JSON definition. You can place the file in the
+<code>src/test/resources/contracts</code> folder. The following example shows such a Pact contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">{
+  "provider": {
+    "name": "Provider"
+  },
+  "consumer": {
+    "name": "Consumer"
+  },
+  "interactions": [
+    {
+      "description": "",
+      "request": {
+        "method": "PUT",
+        "path": "/fraudcheck",
+        "headers": {
+          "Content-Type": "application/vnd.fraud.v1+json"
+        },
+        "body": {
+          "clientId": "1234567890",
+          "loanAmount": 99999
+        },
+        "generators": {
+          "body": {
+            "$.clientId": {
+              "type": "Regex",
+              "regex": "[0-9]{10}"
+            }
+          }
+        },
+        "matchingRules": {
+          "header": {
+            "Content-Type": {
+              "matchers": [
+                {
+                  "match": "regex",
+                  "regex": "application/vnd\\.fraud\\.v1\\+json.*"
+                }
+              ],
+              "combine": "AND"
+            }
+          },
+          "body": {
+            "$.clientId": {
+              "matchers": [
+                {
+                  "match": "regex",
+                  "regex": "[0-9]{10}"
+                }
+              ],
+              "combine": "AND"
+            }
+          }
+        }
+      },
+      "response": {
+        "status": 200,
+        "headers": {
+          "Content-Type": "application/vnd.fraud.v1+json"
+        },
+        "body": {
+          "fraudCheckStatus": "FRAUD",
+          "rejectionReason": "Amount too high"
+        },
+        "matchingRules": {
+          "header": {
+            "Content-Type": {
+              "matchers": [
+                {
+                  "match": "regex",
+                  "regex": "application/vnd\\.fraud\\.v1\\+json.*"
+                }
+              ],
+              "combine": "AND"
+            }
+          },
+          "body": {
+            "$.fraudCheckStatus": {
+              "matchers": [
+                {
+                  "match": "regex",
+                  "regex": "FRAUD"
+                }
+              ],
+              "combine": "AND"
+            }
+          }
+        }
+      }
+    }
+  ],
+  "metadata": {
+    "pact-specification": {
+      "version": "3.0.0"
+    },
+    "pact-jvm": {
+      "version": "3.5.13"
+    }
+  }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-use-pact-broker-pact-for-producers"><a class="anchor" href="#how-to-use-pact-broker-pact-for-producers"></a><a class="link" href="#how-to-use-pact-broker-pact-for-producers">7.4. Pact for Producers</a></h3>
+<div class="paragraph">
+<p>On the producer side, you must add two additional dependencies to your plugin
+configuration. One is the Spring Cloud Contract Pact support, and the other represents
+the current Pact version that you use. The following listing shows how to do so for both
+Maven and Gradle:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;packageWithBaseClasses&gt;com.example.fraud&lt;/packageWithBaseClasses&gt;
+    &lt;/configuration&gt;
+    &lt;dependencies&gt;
+        &lt;dependency&gt;
+            &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+            &lt;artifactId&gt;spring-cloud-contract-pact&lt;/artifactId&gt;
+            &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+        &lt;/dependency&gt;
+    &lt;/dependencies&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">classpath "org.springframework.cloud:spring-cloud-contract-pact:${findProperty('verifierVersion') ?: verifierVersion}"</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>When you execute the build of your application, a test and stub is generated. The following
+example shows a test and stub that came from this process:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">test</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
+    public void validate_shouldMarkClientAsFraud() throws Exception {
+        // given:
+            MockMvcRequestSpecification request = given()
+                    .header("Content-Type", "application/vnd.fraud.v1+json")
+                    .body("{\"clientId\":\"1234567890\",\"loanAmount\":99999}");
+
+        // when:
+            ResponseOptions response = given().spec(request)
+                    .put("/fraudcheck");
+
+        // then:
+            assertThat(response.statusCode()).isEqualTo(200);
+            assertThat(response.header("Content-Type")).matches("application/vnd\\.fraud\\.v1\\+json.*");
+        // and:
+            DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
+            assertThatJson(parsedJson).field("['rejectionReason']").isEqualTo("Amount too high");
+        // and:
+            assertThat(parsedJson.read("$.fraudCheckStatus", String.class)).matches("FRAUD");
+    }</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">stub</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+  "id" : "996ae5ae-6834-4db6-8fac-358ca187ab62",
+  "uuid" : "996ae5ae-6834-4db6-8fac-358ca187ab62",
+  "request" : {
+    "url" : "/fraudcheck",
+    "method" : "PUT",
+    "headers" : {
+      "Content-Type" : {
+        "matches" : "application/vnd\\.fraud\\.v1\\+json.*"
+      }
+    },
+    "bodyPatterns" : [ {
+      "matchesJsonPath" : "$[?(@.['loanAmount'] = 99999)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.clientId =~ /([0-9]{10})/)]"
+    } ]
+  },
+  "response" : {
+    "status" : 200,
+    "body" : "{\"fraudCheckStatus\":\"FRAUD\",\"rejectionReason\":\"Amount too high\"}",
+    "headers" : {
+      "Content-Type" : "application/vnd.fraud.v1+json;charset=UTF-8"
+    },
+    "transformers" : [ "response-template" ]
+  },
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-use-pact-broker-pact-consumers"><a class="anchor" href="#how-to-use-pact-broker-pact-consumers"></a><a class="link" href="#how-to-use-pact-broker-pact-consumers">7.5. Pact for Consumers</a></h3>
+<div class="paragraph">
+<p>On the producer side, you must add two additional dependencies to your project
+dependencies. One is the Spring Cloud Contract Pact support, and the other represents the
+current Pact version that you use. The following listing shows how to do so for both
+Maven and Gradle:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-pact&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile "org.springframework.cloud:spring-cloud-contract-pact"</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="pact-stub-downloader"><a class="anchor" href="#pact-stub-downloader"></a><a class="link" href="#pact-stub-downloader">7.6. Communicating with the Pact Broker</a></h3>
+<div class="paragraph">
+<p>Whenever the <code>repositoryRoot</code> property starts with a Pact protocol
+(starts with <code>pact://</code>), the stub downloader tries
+to fetch the Pact contract definitions from the Pact Broker.
+Whatever is set after <code>pact://</code> is parsed as the Pact Broker URL.</p>
+</div>
+<div class="paragraph">
+<p>By setting environment variables, system properties, or properties set
+inside the plugin or contracts repository configuration, you can
+tweak the downloader&#8217;s behavior. The following table describes the
+properties:</p>
+</div>
+<table class="tableblock frame-all grid-all stretch">
+<caption class="title">Table 1. Pact Stub Downloader properties</caption>
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Name of a property</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Default</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Description</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.host</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.pactbroker.host</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_HOST</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Host from URL passed to <code>repositoryRoot</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The URL of the Pact Broker.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.port</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.pactbroker.port</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_PORT</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Port from URL passed to <code>repositoryRoot</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The port of Pact Broker.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.protocol</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.pactbroker.protocol</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_PROTOCOL</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Protocol from URL passed to <code>repositoryRoot</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The protocol of Pact Broker.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.tags</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.pactbroker.tags</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_TAGS</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Version of the stub, or <code>latest</code> if version is <code>+</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The tags that should be used to fetch the stub.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.auth.scheme</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.pactbroker.auth.scheme</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_AUTH_SCHEME</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Basic</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The kind of authentication that should be used to connect to the Pact Broker.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.auth.username</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.pactbroker.auth.username</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_AUTH_USERNAME</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The username passed to <code>contractsRepositoryUsername</code> (maven) or <code>contractRepository.username</code> (gradle)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The username to use when connecting to the Pact Broker.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.auth.password</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.pactbroker.auth.password</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_AUTH_PASSWORD</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The password passed to <code>contractsRepositoryPassword</code> (maven) or <code>contractRepository.password</code> (gradle)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The password to use when connecting to the Pact Broker.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.provider-name-with-group-id</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.pactbroker.provider-name-with-group-id</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_PROVIDER_NAME_WITH_GROUP_ID</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">When <code>true</code>, the provider name is a combination of <code>groupId:artifactId</code>. If <code>false</code>, only <code>artifactId</code> is used.</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect2">
+<h3 id="how-to-pact-consumer"><a class="anchor" href="#how-to-pact-consumer"></a><a class="link" href="#how-to-pact-consumer">7.7. Flow: Consumer Contract approach with Pact Broker | Consumer Side</a></h3>
+<div class="paragraph">
+<p>The consumer uses the Pact framework to generate Pact files. The
+Pact files are sent to the Pact Broker. You can find an example of such a setup
+<a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x/consumer_pact">here</a>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-pact-producer"><a class="anchor" href="#how-to-pact-producer"></a><a class="link" href="#how-to-pact-producer">7.8. Flow: Consumer Contract Approach with Pact Broker on the Producer Side</a></h3>
+<div class="paragraph">
+<p>For the producer to use the Pact files from the Pact Broker, we can reuse the
+same mechanism we use for external contracts. We route Spring Cloud Contract
+to use the Pact implementation with the URL that contains
+the <code>pact://</code> protocol. You can pass the URL to the
+Pact Broker. You can find an example of such a setup
+<a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x/producer_pact">here</a>.
+The following listing shows the configuration details for both Maven and Gradle:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;!-- Base class mappings etc. --&gt;
+
+        &lt;!-- We want to pick contracts from a Git repository --&gt;
+        &lt;contractsRepositoryUrl&gt;pact://http://localhost:8085&lt;/contractsRepositoryUrl&gt;
+
+        &lt;!-- We reuse the contract dependency section to set up the path
+        to the folder that contains the contract definitions. In our case the
+        path will be /groupId/artifactId/version/contracts --&gt;
+        &lt;contractDependency&gt;
+            &lt;groupId&gt;${project.groupId}&lt;/groupId&gt;
+            &lt;artifactId&gt;${project.artifactId}&lt;/artifactId&gt;
+            &lt;!-- When + is passed, a latest tag will be applied when fetching pacts --&gt;
+            &lt;version&gt;+&lt;/version&gt;
+        &lt;/contractDependency&gt;
+
+        &lt;!-- The contracts mode can't be classpath --&gt;
+        &lt;contractsMode&gt;REMOTE&lt;/contractsMode&gt;
+    &lt;/configuration&gt;
+    &lt;!-- Don't forget to add spring-cloud-contract-pact to the classpath! --&gt;
+    &lt;dependencies&gt;
+        &lt;dependency&gt;
+            &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+            &lt;artifactId&gt;spring-cloud-contract-pact&lt;/artifactId&gt;
+            &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+        &lt;/dependency&gt;
+    &lt;/dependencies&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">buildscript {
+    repositories {
+        //...
+    }
+
+    dependencies {
+        // ...
+        // Don't forget to add spring-cloud-contract-pact to the classpath!
+        classpath "org.springframework.cloud:spring-cloud-contract-pact:${contractVersion}"
+    }
+}
+
+contracts {
+    // When + is passed, a latest tag will be applied when fetching pacts
+    contractDependency {
+        stringNotation = "${project.group}:${project.name}:+"
+    }
+    contractRepository {
+        repositoryUrl = "pact://http://localhost:8085"
+    }
+    // The mode can't be classpath
+    contractsMode = "REMOTE"
+    // Base class mappings etc.
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>With such a setup:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Pact files are downloaded from the Pact Broker.</p>
+</li>
+<li>
+<p>Spring Cloud Contract converts the Pact files into tests and stubs.</p>
+</li>
+<li>
+<p>The JAR with the stubs gets automatically created, as usual.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-pact-consumer-producer-contract"><a class="anchor" href="#how-to-pact-consumer-producer-contract"></a><a class="link" href="#how-to-pact-consumer-producer-contract">7.9. Flow: Producer Contract approach with Pact on the Consumer Side</a></h3>
+<div class="paragraph">
+<p>In the scenario where you do not want to do the consumer contract approach
+(for every single consumer, define the expectations) but you prefer
+to do producer contracts (the producer provides the contracts and
+publishes stubs), you can use Spring Cloud Contract with the
+Stub Runner option. You can find an example of such a setup
+<a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x/consumer_pact_stubrunner">here</a>.</p>
+</div>
+<div class="paragraph">
+<p>Remember to add the Stub Runner and Spring Cloud Contract Pact modules
+as test dependencies.</p>
+</div>
+<div class="paragraph">
+<p>The following listing shows the configuration details for both Maven and Gradle:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependencyManagement&gt;
+    &lt;dependencies&gt;
+        &lt;dependency&gt;
+            &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+            &lt;artifactId&gt;spring-cloud-dependencies&lt;/artifactId&gt;
+            &lt;version&gt;${spring-cloud.version}&lt;/version&gt;
+            &lt;type&gt;pom&lt;/type&gt;
+            &lt;scope&gt;import&lt;/scope&gt;
+        &lt;/dependency&gt;
+    &lt;/dependencies&gt;
+&lt;/dependencyManagement&gt;
+
+&lt;!-- Don't forget to add spring-cloud-contract-pact to the classpath! --&gt;
+&lt;dependencies&gt;
+    &lt;!-- ... --&gt;
+    &lt;dependency&gt;
+        &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+        &lt;artifactId&gt;spring-cloud-starter-contract-stub-runner&lt;/artifactId&gt;
+        &lt;scope&gt;test&lt;/scope&gt;
+    &lt;/dependency&gt;
+    &lt;dependency&gt;
+        &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+        &lt;artifactId&gt;spring-cloud-contract-pact&lt;/artifactId&gt;
+        &lt;scope&gt;test&lt;/scope&gt;
+    &lt;/dependency&gt;
+&lt;/dependencies&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">dependencyManagement {
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
+    }
+}
+
+dependencies {
+    //...
+    testCompile("org.springframework.cloud:spring-cloud-starter-contract-stub-runner")
+    // Don't forget to add spring-cloud-contract-pact to the classpath!
+    testCompile("org.springframework.cloud:spring-cloud-contract-pact")
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Next, you can pass the URL of the Pact Broker to <code>repositoryRoot</code>, prefixed
+with <code>pact://</code> protocol (for example, <code>pact://http://localhost:8085</code>), as the following
+example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
+@SpringBootTest
+@AutoConfigureStubRunner(stubsMode = StubRunnerProperties.StubsMode.REMOTE,
+        ids = "com.example:beer-api-producer-pact",
+        repositoryRoot = "pact://http://localhost:8085")
+public class BeerControllerTest {
+    //Inject the port of the running stub
+    @StubRunnerPort("beer-api-producer-pact") int producerPort;
+    //...
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>With such a setup:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Pact files are downloaded from the Pact Broker.</p>
+</li>
+<li>
+<p>Spring Cloud Contract converts the Pact files into stub definitions.</p>
+</li>
+<li>
+<p>The stub servers are started and fed with stubs.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="how-to-debug"><a class="anchor" href="#how-to-debug"></a><a class="link" href="#how-to-debug">8. How Can I Debug the Request/Response Being Sent by the Generated Tests Client?</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The generated tests all boil down to RestAssured in some form or fashion. RestAssured
+relies on the <a href="https://hc.apache.org/httpcomponents-client-ga/">Apache HttpClient</a>.
+HttpClient has a facility called
+<a href="https://hc.apache.org/httpcomponents-client-ga/logging.html#Wire_Logging">wire logging</a>,
+which logs the entire request and response to HttpClient. Spring Boot has a logging
+<a href="https://docs.spring.io/spring-boot/docs/current/reference/html/common-application-properties.html">common application property</a>
+for doing this sort of thing. To use it, add this to your application properties, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties">logging.level.org.apache.http.wire=DEBUG</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="how-to-debug-wiremock"><a class="anchor" href="#how-to-debug-wiremock"></a><a class="link" href="#how-to-debug-wiremock">9. How Can I Debug the Mapping, Request, or Response Being Sent by WireMock?</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Starting from version <code>1.2.0</code>, we turn on WireMock logging to
+<code>info</code> and set the WireMock notifier to being verbose. Now you can
+exactly know what request was received by the WireMock server and which
+matching response definition was picked.</p>
+</div>
+<div class="paragraph">
+<p>To turn off this feature, set WireMock logging to <code>ERROR</code>, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties">logging.level.com.github.tomakehurst.wiremock=ERROR</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="how-to-see-registered-stubs"><a class="anchor" href="#how-to-see-registered-stubs"></a><a class="link" href="#how-to-see-registered-stubs">10. How Can I See What Got Registered in the HTTP Server Stub?</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>You can use the <code>mappingsOutputFolder</code> property on <code>@AutoConfigureStubRunner</code>, <code>StubRunnerRule</code>, or
+`StubRunnerExtension`to dump all mappings per artifact ID. Also the port at which the given stub server
+was started is attached.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="how-to-reference-text-from-file"><a class="anchor" href="#how-to-reference-text-from-file"></a><a class="link" href="#how-to-reference-text-from-file">11. How Can I Reference Text from File?</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>In version 1.2.0, we added this ability. You can call a <code>file(&#8230;&#8203;)</code> method in the
+DSL and provide a path relative to where the contract lies.
+If you use YAML, you can use the <code>bodyFromFile</code> property.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="how-to-generate-pact-from-scc"><a class="anchor" href="#how-to-generate-pact-from-scc"></a><a class="link" href="#how-to-generate-pact-from-scc">12. How Can I Generate Pact, YAML, or X files from Spring Cloud Contract Contracts?</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Spring Cloud Contract comes with a <code>ToFileContractsTransformer</code> class that lets you dump
+contracts as files for the given <code>ContractConverter</code>. It contains a <code>static void main</code>
+method that lets you execute the transformer as an executable. It takes the following
+arguments:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>argument 1 : <code>FQN</code>: Fully qualified name of the <code>ContractConverter</code> (for example, <code>PactContractConverter</code>). <strong>REQUIRED</strong>.</p>
+</li>
+<li>
+<p>argument 2 : <code>path</code>: Path where the dumped files should be stored. <strong>OPTIONAL</strong>&#8201;&#8212;&#8201;defaults to <code>target/converted-contracts</code>.</p>
+</li>
+<li>
+<p>argument 3 : <code>path</code>: Path were the contracts should be searched for. <strong>OPTIONAL</strong>&#8201;&#8212;&#8201;defaults to <code>src/test/resources/contracts</code>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>After executing the transformer, the Spring Cloud Contract files are processed and,
+depending on the provided FQN of the <code>ContractTransformer</code>, the contracts are transformed
+to the required format and dumped to the provided folder.</p>
+</div>
+<div class="paragraph">
+<p>The following example shows how to configure Pact integration for both Maven and Gradle:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.codehaus.mojo&lt;/groupId&gt;
+    &lt;artifactId&gt;exec-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;1.6.0&lt;/version&gt;
+    &lt;executions&gt;
+        &lt;execution&gt;
+            &lt;id&gt;convert-dsl-to-pact&lt;/id&gt;
+            &lt;phase&gt;process-test-classes&lt;/phase&gt;
+            &lt;configuration&gt;
+                &lt;classpathScope&gt;test&lt;/classpathScope&gt;
+                &lt;mainClass&gt;
+                    org.springframework.cloud.contract.verifier.util.ToFileContractsTransformer
+                &lt;/mainClass&gt;
+                &lt;arguments&gt;
+                    &lt;argument&gt;
+                        org.springframework.cloud.contract.verifier.spec.pact.PactContractConverter
+                    &lt;/argument&gt;
+                    &lt;argument&gt;${project.basedir}/target/pacts&lt;/argument&gt;
+                    &lt;argument&gt;
+                        ${project.basedir}/src/test/resources/contracts
+                    &lt;/argument&gt;
+                &lt;/arguments&gt;
+            &lt;/configuration&gt;
+            &lt;goals&gt;
+                &lt;goal&gt;java&lt;/goal&gt;
+            &lt;/goals&gt;
+        &lt;/execution&gt;
+    &lt;/executions&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">task convertContracts(type: JavaExec) {
+    main = "org.springframework.cloud.contract.verifier.util.ToFileContractsTransformer"
+    classpath = sourceSets.test.compileClasspath
+    args("org.springframework.cloud.contract.verifier.spec.pact.PactContractConverter",
+            "${project.rootDir}/build/pacts", "${project.rootDir}/src/test/resources/contracts")
+}
+
+test.dependsOn("convertContracts")</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="how-to-work-with-transitivie"><a class="anchor" href="#how-to-work-with-transitivie"></a><a class="link" href="#how-to-work-with-transitivie">13. How Can I Work with Transitive Dependencies?</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The Spring Cloud Contract plugins add the tasks that create the stubs jar for you. One
+problem that arises is that, when reusing the stubs, you can mistakenly import all of
+that stub&#8217;s dependencies. When building a Maven artifact, even though you have a couple
+of different jars, all of them share one pom, as the following listing shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">├── producer-0.0.1.BUILD-20160903.075506-1-stubs.jar
+├── producer-0.0.1.BUILD-20160903.075506-1-stubs.jar.sha1
+├── producer-0.0.1.BUILD-20160903.075655-2-stubs.jar
+├── producer-0.0.1.BUILD-20160903.075655-2-stubs.jar.sha1
+├── producer-0.0.1.BUILD-SNAPSHOT.jar
+├── producer-0.0.1.BUILD-SNAPSHOT.pom
+├── producer-0.0.1.BUILD-SNAPSHOT-stubs.jar
+├── ...
+└── ...</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>There are three possibilities of working with those dependencies so as not to have any
+issues with transitive dependencies:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Mark all application dependencies as optional</p>
+</li>
+<li>
+<p>Create a separate artifactid for the stubs</p>
+</li>
+<li>
+<p>Exclude dependencies on the consumer side</p>
+</li>
+</ul>
+</div>
+<div class="sect2">
+<h3 id="how-to-work-with-transitivie-optional"><a class="anchor" href="#how-to-work-with-transitivie-optional"></a><a class="link" href="#how-to-work-with-transitivie-optional">13.1. How Can I Mark All Application Dependencies as Optional?</a></h3>
+<div class="paragraph">
+<p>If, in the <code>producer</code> application, you mark all of your dependencies as optional,
+when you include the <code>producer</code> stubs in another application (or when that
+dependency gets downloaded by Stub Runner) then, since all of the dependencies are
+optional, they do not get downloaded.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-work-with-transitivie-separate"><a class="anchor" href="#how-to-work-with-transitivie-separate"></a><a class="link" href="#how-to-work-with-transitivie-separate">13.2. How can I Create a Separate <code>artifactid</code> for the Stubs?</a></h3>
+<div class="paragraph">
+<p>If you create a separate <code>artifactid</code>, you can set it up in whatever way you wish.
+For example, you might decide to have no dependencies at all.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-work-with-transitivie-exclude"><a class="anchor" href="#how-to-work-with-transitivie-exclude"></a><a class="link" href="#how-to-work-with-transitivie-exclude">13.3. How can I Exclude Dependencies on the Consumer Side?</a></h3>
+<div class="paragraph">
+<p>As a consumer, if you add the stub dependency to your classpath, you can explicitly exclude the unwanted dependencies.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="contract-dsl-rest-docs"><a class="anchor" href="#contract-dsl-rest-docs"></a><a class="link" href="#contract-dsl-rest-docs">14. How can I Generate Spring REST Docs Snippets from the Contracts?</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>When you want to include the requests and responses of your API by using Spring REST Docs,
+you only need to make some minor changes to your setup if you are using MockMvc and RestAssuredMockMvc.
+To do so, include the following dependencies (if you have not already done so):</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-starter-contract-verifier&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;
+&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.restdocs&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-restdocs-mockmvc&lt;/artifactId&gt;
+    &lt;optional&gt;true&lt;/optional&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile 'org.springframework.cloud:spring-cloud-starter-contract-verifier'
+testCompile 'org.springframework.restdocs:spring-restdocs-mockmvc'</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Next, you need to make some changes to your base class. The following examples use
+<code>WebAppContext</code> and the standalone option with RestAssured:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">WebAppContext</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package com.example.fraud;
+
+import io.restassured.module.mockmvc.RestAssuredMockMvc;
+import org.junit.Before;
+import org.junit.Rule;
+import org.junit.rules.TestName;
+import org.junit.runner.RunWith;
+
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.restdocs.JUnitRestDocumentation;
+import org.springframework.test.context.junit4.SpringRunner;
+import org.springframework.test.web.servlet.setup.MockMvcBuilders;
+import org.springframework.web.context.WebApplicationContext;
+
+import static org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.document;
+import static org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.documentationConfiguration;
+
+@RunWith(SpringRunner.class)
+@SpringBootTest(classes = Application.class)
+public abstract class FraudBaseWithWebAppSetup {
+
+    private static final String OUTPUT = "target/generated-snippets";
+
+    @Rule
+    public JUnitRestDocumentation restDocumentation = new JUnitRestDocumentation(OUTPUT);
+
+    @Rule
+    public TestName testName = new TestName();
+
+    @Autowired
+    private WebApplicationContext context;
+
+    @Before
+    public void setup() {
+        RestAssuredMockMvc.mockMvc(MockMvcBuilders.webAppContextSetup(this.context)
+                .apply(documentationConfiguration(this.restDocumentation))
+                .alwaysDo(document(
+                        getClass().getSimpleName() + "_" + testName.getMethodName()))
+                .build());
+    }
+
+    protected void assertThatRejectionReasonIsNull(Object rejectionReason) {
+        assert rejectionReason == null;
+    }
+
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Standalone</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package com.example.fraud;
+
+import io.restassured.module.mockmvc.RestAssuredMockMvc;
+import org.junit.Before;
+import org.junit.Rule;
+import org.junit.rules.TestName;
+
+import org.springframework.restdocs.JUnitRestDocumentation;
+import org.springframework.test.web.servlet.setup.MockMvcBuilders;
+
+import static org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.document;
+import static org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.documentationConfiguration;
+
+public abstract class FraudBaseWithStandaloneSetup {
+
+    private static final String OUTPUT = "target/generated-snippets";
+
+    @Rule
+    public JUnitRestDocumentation restDocumentation = new JUnitRestDocumentation(OUTPUT);
+
+    @Rule
+    public TestName testName = new TestName();
+
+    @Before
+    public void setup() {
+        RestAssuredMockMvc.standaloneSetup(MockMvcBuilders
+                .standaloneSetup(new FraudDetectionController())
+                .apply(documentationConfiguration(this.restDocumentation))
+                .alwaysDo(document(
+                        getClass().getSimpleName() + "_" + testName.getMethodName())));
+    }
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+You need not specify the output directory for the generated snippets (since version 1.2.0.RELEASE of Spring REST Docs).
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="how-to-use-stubs-from-a-location"><a class="anchor" href="#how-to-use-stubs-from-a-location"></a><a class="link" href="#how-to-use-stubs-from-a-location">15. How can I Use Stubs from a Location</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>If you want to fetch contracts or stubs from a given location without cloning a repo or fetching a JAR, just use the <code>stubs://</code> protocol when providing the repository root argument for Stub Runner or the Spring Cloud Contract plugin. You can read more about this in <a href="project-features.html#features-stub-runner-stubs-protocol">this section</a> of the documentation.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="how-to-generate-stubs-at-runtime"><a class="anchor" href="#how-to-generate-stubs-at-runtime"></a><a class="link" href="#how-to-generate-stubs-at-runtime">16. How can I Generate Stubs at Runtime</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>If you want to generate stubs at runtime for contracts, it&#8217;s enough to switch the <code>generateStubs</code> property in the <code>@AutoConfigureStubRunner</code> annotation, or call the <code>withGenerateStubs(true)</code> method on the JUnit Rule or Extension. You can read more about this in <a href="project-features.html#features-stub-runner-generate-stubs-at-runtime">this section</a> of the documentation.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="how-to-use-the-failonnostubs-feature"><a class="anchor" href="#how-to-use-the-failonnostubs-feature"></a><a class="link" href="#how-to-use-the-failonnostubs-feature">17. How can I Make The Build Pass if There Are No Contracts or Stubs</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>If you want Stub Runner not to fail if no stubs were found, it&#8217;s enough to switch the <code>generateStubs</code> property in the <code>@AutoConfigureStubRunner</code> annotation, or call the <code>withFailOnNoStubs(false)</code> method on the JUnit Rule or Extension. You can read more about this in <a href="project-features.html#features-stub-runner-fail-on-no-stubs">this section</a> of the documentation.</p>
+</div>
+<div class="paragraph">
+<p>If you want the plugins not to fail the build when no contracts were found, you can set the <code>failOnNoStubs</code> flag in Maven or call the <code>contractRepository { failOnNoStubs(false) }</code> Closure in Gradle.</p>
+</div>
+</div>
+</div>
+</div>
+<script type="text/javascript" src="js/tocbot/tocbot.min.js"></script>
+<script type="text/javascript" src="js/toc.js"></script>
+<link rel="stylesheet" href="js/highlight/styles/atom-one-dark-reasonable.min.css">
+<script src="js/highlight/highlight.min.js"></script>
+<script>hljs.initHighlighting()</script>
+</body>
+</html>
\ No newline at end of file
diff --git a/reference/html/images/flow-overview-consumer-cdc-external-consumer.png b/reference/html/images/flow-overview-consumer-cdc-external-consumer.png
new file mode 100644
index 0000000000000000000000000000000000000000..6304c4a33d763650066de3dfe85d2afc7d06ed10
GIT binary patch
literal 38637
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

literal 0
HcmV?d00001

diff --git a/reference/html/images/flow-overview-consumer-cdc-external-producer.png b/reference/html/images/flow-overview-consumer-cdc-external-producer.png
new file mode 100644
index 0000000000000000000000000000000000000000..df52a241142e937f992547d695e11cf8a464d5b2
GIT binary patch
literal 78892
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
D4THoj

literal 0
HcmV?d00001

diff --git a/reference/html/images/flows-provider-non-jvm-consumer.png b/reference/html/images/flows-provider-non-jvm-consumer.png
new file mode 100644
index 0000000000000000000000000000000000000000..0390d902a080cd5009f9b9795c24b6e7e396ad3a
GIT binary patch
literal 36164
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

literal 0
HcmV?d00001

diff --git a/reference/html/images/flows-provider-non-jvm-producer.png b/reference/html/images/flows-provider-non-jvm-producer.png
new file mode 100644
index 0000000000000000000000000000000000000000..98d31a4856301ad2e62687676fcbc643242b6a89
GIT binary patch
literal 45592
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
W=LLssEgOk1Iebt_Cg#A&EB_1oI~2tL

literal 0
HcmV?d00001

diff --git a/reference/html/images/flows-provider-rest-docs-producer.png b/reference/html/images/flows-provider-rest-docs-producer.png
new file mode 100644
index 0000000000000000000000000000000000000000..9f9ccd432c86a8dbe56e529aee3285096a9bad56
GIT binary patch
literal 38280
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

literal 0
HcmV?d00001

diff --git a/reference/html/images/getting-started-cdc-client-final.png b/reference/html/images/getting-started-cdc-client-final.png
new file mode 100644
index 0000000000000000000000000000000000000000..4736d615c6172f61bbea0cb580fc0843d7170319
GIT binary patch
literal 29859
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
NMp8i{{g&SI{|BsI!oL6j

literal 0
HcmV?d00001

diff --git a/reference/html/images/getting-started-cdc-client.png b/reference/html/images/getting-started-cdc-client.png
new file mode 100644
index 0000000000000000000000000000000000000000..447d7ecfdf50029e7037be5f8f7f831f43d79e31
GIT binary patch
literal 73373
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

literal 0
HcmV?d00001

diff --git a/reference/html/images/getting-started-cdc-server.png b/reference/html/images/getting-started-cdc-server.png
new file mode 100644
index 0000000000000000000000000000000000000000..7dadee02cf515ebcffc12fab3f0cd4115aca270c
GIT binary patch
literal 39245
zcmb?@1yq#X_bxHwC<CI1lz>PHD5-Qh3epNlr?hl;%U~cVskGA4-Kj`7(k0R*(lv0;
z3*zT5?)~4j?sctC=YyH|J?}aD?EUQLdCt6eC@YS4p6omZ1_qwQgM0EA7+5(N7})-B
zEbx<uEVCluA4a?TDt3C7R?cPyhISa@1{MZ3x^@Qo*Pb|EGq$s{;$vmCGSjuNvo|+m
z(X%wa$i{mWT!qv`QN`}`=NOpaGEULUiZYf%A_SG{3!d+0VDjdq%=c>jnO<NPUcRhI
zC>#E%p0c%QYhd((;-S0IhfqcH$ZMMeQH~B{QQYf&wh6Bve(n3l{PRi1vs)ZwA8SV%
zQ7i|=)eTSBCUNiP-#=sMODbxbe*UsYVQO28>TR-N!_Xp0`EwHAN}eTBC)~4$&opD4
z_cJ3MRaGUD{&bV~QI5^5aD32v>0tVEt=o@Dl&^odgi~vEfse*~NfIgMbDqa-{ms-6
zV@s;9DCyO@L!%F68nYJ%wKtdNzkhMb*bnG4B6CQby(sXsbcg!sEq%ZG#e6)CbFbeh
z-!+}8%_Kjw+w~>o8G3t_%K64lgKYxegQqcPXL;Un+uv%d3hP_In<5vb6Pi|8JA_%!
zYcM7F1slAOJenji;<I()dlM=4;u2|THOzedYN6Kff{a*ECfTEd0zcgGYef5+Q*F$m
zGrC-7#yBI1L|C8Kja`Fh^Xbv)(mN1n-nAsyuH#uia!3+STq@I=b?}I)AosS&Xufzp
z?R7Bo;?SH6VJ^{XSMb|AU#-Tk%b=(NF-f|VKB1n{{*VdJSE&1z<k?`Jk~%V^-i|NO
z;#=^pQ1k5fl(B1T%DNqT1l4DYzjeoOsWh;K=~p{%&!6kM@G<_UKbr0Q{^8-7rV;W<
zwSnfGfC@$us?VRFENQzc6xFX?))QF^M%90!7*85=e9W-3Nvz<Vgn{9OA#qPs(P?O@
z5>G>M_Wkw+IDH+)lgs8Z@DE?YzG_bYI)ir!`Q#J)L*COI&3^jf+h1vu)CQFZxR)0k
z?D00)3%S0cm9g(IMT#^fYif($Lllto(H<fRFweY=c<u!ktDWUAvgM0;Z%cC7`~5oF
zW9GBbOsl)riY<C&e=mk}`@2KwIS`nr20sPx4+aTViF=jt)3g>wu9?MGEtzl(3^o`>
z@tca0VS|_K+MA{ICqMCIhs9aAWwIC*TWiG~uH8XkV(7pzZsK`QHD+ane0A0o$RkHW
zm%~8R-a@X9SC1$?e7O4EpUPuv(CE&cJ8f-kbC}@LUes*S)Qvl;PaPb#zJK<A_44Hx
z!rQlR$DhThA;3V@SfQ>7&J$Z!qa6$llbw7n2p{AmC*uf$@q*8yIAJEtN9GNI6qD!j
z^7C=epJ!rX>coZyg4E$b=FEQU|3Xl)*{4oQO6q@s>ToH)<M(g9sKM2buYn)db@ZKT
z#_ed|mK_F-mqZ0M;X3X*G@aelvVRK&rUZ!rZp3LQJ%tZ;FmzuoL~V$i?Aulfs-s($
zme~zdakNt5H{Yj>+$G^^b!?BGPfAjK`u*3BhJyyrn+n3sYES#BT{eAZ<AOq7yP+3p
zJXU?HkG6`b8o(HI;5Ba%-s$O!mLB<^lIX@K(}#w9Su0kz#}5oUiM0>X)R8%6gO1g|
zUhltpHEv<txZ4#}#q5Cv=GKea%i9><dX_*sn&cyykEOe5WS`pdG8KYsN=ZIXe4L=5
zFs5XCthU@STRHrdH;Ld775J1+1hr1AE6FuScsT3P*>yT9_k!*D6e@D|x{hz(9$Q}+
z9E{q)^Uk<l-yZEOhi0Ouhi-NHA=E^Qu)7j^U{Lic0oy`7@vO39h3B$b*K2amtyL?}
z?NP-jluoTrN-LhIGcTCC2?spP^^wnB9I)AT^dtFwqd2tI?#`@m^)0H$$km-6A;BTl
z*;iuOzFYRjAy!KL;}94aD>Vdc9fF7(NULSFw{dZD^4-FPMU+QzM@?@+EiK?m*@vP!
z6a8{=9>r;lmdisCZQ}TcbK*z*sX4iCMg5>9oGEp*LSD<pKI^gGW{HDGx%6woS6fO(
z^ZWFjdv{>BZtcFh(niYH>$+ilq^$MAb8o((H)FidVKVM;ewaRFw!ez&V0ZS1(-K%7
zWR1W!b{7F#1hn*C&MWLN5YZS2@KAbiurI*P_*@W}e3&3wJG=DYonR}Wyi}LiVD4*s
zV1+$*r;VVup$*~hX2)_+B6yYM`|%fP4zANMSPlkf$lgmldKnnF1J=})K{96m3(Q&k
z5j1DyeFQf?R9pY(AZEELEvLO-gH1zo{cg4vI{qgfrZ6cO!$W9nU)f;`i>>dsS4xdm
z%j|{a8R(ss3#mMRkZ-rty?Nt5=4M;iRxX($SDpS?e(=H5g_r(R_)tuQFbIDf@yr|Z
z*`@Fa46OU|r9MGyl-nt%AyHynz|J_m^yYn8XqI@_s=%&1T=mDz);{6{&j~$xPuF%b
z^_%{Y(zgo90SaSBOGd1cp~5@YmYc(TqNB}e#C9stTh+rARsD?bgV!qbS6W-OwW{1Q
za@f!yWE}THYK4#1w<(=;^hImc<2+;c7t*D^=%=nzzPLF$GUBm69CwGCDr9tb#|b^_
zS@lx(WEt!>D$U>?dp$;UG0epd6&0wfJgemE8N#-P@9g>d85s|C8sE5nQ5q6Pi4@V}
zPh=MNz3cE!48N@Uwf_DmZTIc+M;$`sul~81CHw&G-xM`DsZL1raycX-9wvChxB$9T
zTC2lO6T{B|OSsUXQ(VT{e9HR;W!5U5qqLOdPk9GTa#blFbm@&R=MwvOKc?Le{Ve6~
zZe3bfEgLCVE_U~8mwGiRh(YcdIUHTxVh@g;o;U}|C0ap8e%gmAiEH2HdwvdC!Y{YI
zBln?`nn~kMzp4L%x+FdCds5ZXd)-ZznA>M#Mu^UhCdFTXLu)L?275BvE9%!gdWc6J
zK8$#_gQ7aL`mm-2U5wl^an7=KkHNQ~pm0I?!w0=KPmUUbjrV3kqdSo|8YZ&kJa^TC
z5TdNHxAz@iKMP1G#?*yk@daKj*tA)hf+e=Itdwr6ra?k{T4vGm6W^30c6OYa)><Nh
z9xGNHEow8M7ptohQFpFiSER7|q#z$X`TU|s^%45W+(Jl6af9Ff;fMMwH*tuX-@2`e
z4kby6dmgSQUGY874ns4OCsba(HE0QU`IR_WZAz<uwG!|6kz`Hap}E(5aZ2&1gf@OP
zFrXKdnd^7oM+{atCtb2*ce^zBiugj>_NBVd3{Ea%>4(?jAA<z%gx;e%bLMpwh+kdZ
zAHANg2DxWmHQ*~}>@>WkF&B1tP94wvb02@N+Osq>K7Qi!1>ws?-+Fs*b8~OMr_M3z
zf6&O|qQ`>G=MqWBC(4CROA3ffGBh#*HRt8adk^sN@Z1gIOM`bVaRiRB!R$6}OWFCD
z?I}pjOH@1UFBfxia^8PnGfGcv{@>pQN|8(ft$Tq+F%f`rii#V5?)e$yhMt>U=kiGB
z)XJn#HKGOq&sO9+*-!7m29nAKiaI_aMfD@0zAvav@!aCvuvS~S{DL>$fwU`D4rX?f
z8<o2;+YExESSTGG$;Q1}Cxj?>M?`t~1v2(JRt}rB@LNp_t<T&AIs{QQ?<13T6;(Vu
zgu3Z*aeLTdVj(gL3S(>2M+780o7Bh^=c%`r2M4oK1~2x^-O(3!mEPk*+3?-F=QQGD
z1?%cjF$2g8uMa__J5Eb_Cy-;slnozvvb8^j+imE1V&(M^Y&2J09V19R@?NR)^PQhJ
zr2@P8-o3eR=~Nq))DucMA*5J^!=Ew*cSe7T;gQb_cRd<V7vw<IQ0uR6^aP<t#{~~k
zgqO`s`K|Xh%CoD=rXs4P6|49>538}U#G39u0GXltdvEX6ozGNU!oR*uE%qOcEEjWy
zIe=>O0jcipE|XnxX?&5G#N7nGv1oAv8J`fR#SN>>V`Vr=iPZ-|F4J)hm0LqWL<wY<
z);gmsvsUu%5amS+Wd=8k$tx%e99Y#<ZsW%a>|UG}?o_p`ofPh*qi3PK)4b&w?|Qgf
za{tv#z*Xn*)$d5pozH%K?l1~8sAOxwi{vkCOiaQL6C?N>;fY3}C9bZn?!W7L^=D80
z7qWXIT%Zs)KHd+cIC{F?+E9OAa;T?ltMf=n+~nN3@wY^`z9b|RGb^8ub?55SUn}Sf
z+r6?h@8HrxFxNlIgAx%J?wdz4e7VH$eALP*_nPE8Lj;}hZqxP@){g8}Qe3RQcAn#W
z8l|UOFvpL`ypKyR0CYU1O3fCGaT`iOiM*FGY!0>7)Rs{`0tL{0RW$Odi)=d=?*{;+
zesal#$To$B&L*8RFg#pao7VI5n_oCe?cZ&hh&$SKy&%9Qk64?Hn|-N}zeBZYVPR2?
zUhasD3Tj$$bE`O97uHTnplU=-Ox7chc7nRDTWnTSjH9Skik3W6%8ZTY{L)xDC8!$3
z`0kWyMX+>CR%<XH)oJXFdme4WqC~rniX8F0Lm%01{-9#z=nwOwo+}!jCqj0bkG|G}
zf-6P{ppR#dvus#3`It&2g5ORJ@ef9LxY*d+quVT%(rmL+vwtI`V7hNq)Aj`^A#(de
z1P2=_9nC9YrW~x<)MxPzz6vaMM3Wl22ii$8<qtHS%kxBdbG#Z=x6GX9h`QY6c7@-%
zb3u6=Z4r9!ZJ@`sAZmgyGI2a_4doUKP2fXAvLmjRma-_YkYZfb`=iwo9aiJ+Rk^vG
ziQ-DLpI8_NX+Am4#wbRa&U>bRd+~xPaq%i&?|xE5Y;F(1gP*j-&aPVr*;!K`wfS6b
zfoCi3VMfIdmys_pVBbP-^b$zN9z5R*yBsq1qiFk^xr@A!PO)=`S?4wGbGcPp8=RKH
zBv_tDx@%(5uQ=jfSHReX*4RO5+T`tKOq2FJ_@^}03v8d3C8Gld;a$p*KAuhrta|ZR
zn5@h#Rf5RXE^*iUmyFsgQnD@)5_(fx!3P_^1=$r|Y5+Lkjp?}d5ud~rkDc!p>k<!d
zY3+?KAeaz{gE9>hfVhf#2vioE-OBFZ{`CaS1jh3zDJY%!?lTL@lVsBf?JBpWtu62n
zYE=hRt;LLFgpZo;6a`=LTUwIY8|vw(K(B^~stjbtAr3cEVr;I;A6fXr7D5%P<daMD
zdkAhAH6H}9s&dE`YPLR^eXa+ey5qLf38K@yXzUDbY+eIF>h?4nEbvAYIrrhsPpcah
z$}A`ljPoNT{YQPVveM%OsV@BXOh|F%D`1K(Qj`&*#rE8h)H!K!7I@yy5!Z7SEXeFl
zL0(r5>Q*o^vKFbiVT~Xn`l(&6L>slaYNb398wkyL92pj`5U6D~#h#y0(_BGfZl5oB
zmOP}m`r)zs?!s$s`Hf;7bcm?hklJQ?XJ_urwmuk^F?^-GLm6-6N06MP>|xceV6lZK
z2Z6+Dh<8HEOdGdy%XHw{`ls8TF&}LA#<zOG<YkHrlWx2QQNMz^1MAykm!sm-e7Pxy
zqkXjZe0U6uv8UA5Gqm?`(5PBjh-tfp2qZQ^bnCEq5Jg`f<w)r|@dcrsLUAezR&@5C
zVr}zFVba<Iy_o2U?vDt~p1OSR-m_0g20KZ~Xt99Ree}<x?04fIKaQvQp1)P3!=Cyu
zaLV^WH;X3U-g+EsAxR+!j4yEr96Xzrj`6IUs+D_Zy}h-C-S<Y5lPd~Mwfo4L3=Xw=
zKO$;O%=90A&}&StMEf>S?hEg4Rnm`sv|~JT#?tSZK;q$Lwa1$c`#-5jNqKj_ytvKi
z{JpML_&_(mz+yU5`e-<o42z<Yaob-mc7(1>Qd%Q}Gc~6J;q5Vsw;Adk=y9{#U-tPo
zQNOh?j?~Trtvd6imctFZe{TW^qMjVOz6sp2TQku<(7QgLF@5_*)84miB{f9;NQLt>
zcQq-kmYD1|bM_bQ3a1B^5d@S%wLR-vo5Yxz!7(xQppe|SVY~qnKRzybihzT0<=+^h
zA52AtsNYAk7p_WuV(TAzPg(_amW}&NYQiIt)e%a2az`8HAx-P1+T@1^>(&Aea|C(3
zE*nScITMT$mNxY?f?jqR-P`EtDQy8-DgDyhwx!0e0t0#6oYG^)w;BoN=47(I>f?UO
zGHi=X9@AQ3MaFA8B1fq^yMpfTb)L)pB3p((7^o2;=@Q;+x-MbAzir^@65Q{NUHz#0
zqto-=ULq|mq#_g+F>cKoICdL>MxgJ=vo49yC<`E6kKdf8IVvMLhbOYE3!j@a37>-v
zZp=ur{G5`{$XZ$T!#(SH@Z-LXy^8AYSp?=KvYnwn@MOMCS$+7$vu8g8D3^upQnv$0
z2?45qJ&6DI4bu1mQbb%X{~kjlYCeb^R`CZQLEuFTYJ-kJ6$usslNEtUA=q{)<{CKy
z6XivW@(PSKd?EV=4+XlZ#df^flxjDbKJIp@1ppPv!TaI~^=*p_dlwnnKAZrfO@ueQ
zw%vxHIT(A)wW#vUq;k9Nt3w2<3!Cx7Trh17i_DH&N?J$g7IRWzDH*xF`$Ns1A$Yt;
zrmkcZmEd|1ZWEJoTukIm4tU$CdA>}lIHf8+{u)0&z;WYay0nQ^@}_C7_wSz(ED?O3
zb5H9!2d}GZ048dpo!xNT#@}5wJMOms%F3IEtT>gfNQkzO^o)4_o^i3-0Fjt1ubo!d
zTbZ1U(uy*CVO=3blH*#sE|lUZ7n$Jb_#l<ocdU~7ja1ynkJnWd_^J?k*Y1SvNoFRk
z0ED?QbXzLmhi0AEXiLmCZ>4MZ)yi_@-Aa;;6+G_^ySzX<XB$$xk_&^so~(WMxcii8
zGfYitG%6};zVNI~{>VYMWI)1?Ztc+)kvSua@{Ziu#6fLV@t-Suns>1^)CAAFY@<XZ
zrHmNTA1f-l_4%8v?Fh$h63Q#2W%sHrjCFO1W(&TFnvT>}U<(YC^0a5g{t#EXEYuJi
zV(3{3MzZL54$sPD^Tr$tHdkx8W^$)y_f7Ud5n*H{Ty)%v8bggDo@(LDGr))x@QDcb
z;=*f1xL{OAX5_(Gc35-%E*G%?R0NC(M6N(o3HSqbzksPIIpg~TBL-vdgBJL7jUK0$
zEC%`^>s>Euk<S0&<<2FXdJI0y4KN0<KC-039&Ro!eB!v!Rgdq(lSciH$9i&Wd6+`5
zUac3RD?nQgLhtzQWCK^<UZkS>xkjX`tD8s5$EP+{URH*KgOjD2pPZiFa=pH&u(1B?
z*Y@|Ev&~`5Yq^Dmcc`hUuU)I@?^o{2%*ZGhlhV{2b*x&Cxd<BD{e4!gik<Zi;RwHK
zkaXy!-^GXXx^87eMXBGv@7K;XO%fauV$}Lhm*c&|@=%fjF6e-RFOibYFE0xkw!TB}
zZ!^;^^Q!rNo?sLaF2KDzF@+LYe2*992)7t1v0j^MnwXe~;dhKA_Zb=*k_e%%+?jkO
zFQQ6GOiWBfL^oeiTIyW?lIX*S4>2(@SJXo;v*3J8PM#SlwGB?3uDn@cH{UI|J+cns
zmC4|6TKjPN1w(A-c=FZHsgDu@sf4puG-vU>_0e^8cXL@y`?H8>KJt*e2KG&?IuXTF
z4V?iKs*-2YLtnb1q+lj5-;KN=SYR>AS6H*VK0EzUgQIfoQE+-tP)C|VN-MX#mKKXa
zsFdgTgdm~dAYvAcH`^To>j4_sE#ysoph!*p^w{P{n>VvRa41f>BF}N>&SPiRb|jaI
zrlxsE7ZwH8?>mlMr=dY+MO9W*gz~R`|Ni~yOA20_DViXG?xCSiSK3=zY;&*k^AEf2
zmzI{UtgI|FY;8F(()6#a9R`6+=Dt1ZxI9#d^vB=b+taFadF&ZwgD^2MaUjF8M|kHo
z<mGX=240!l!9aJiz`aHBYNwh)zA3u=nyeS~#W656EGj4fF#YRm^02t6u*=N#S6DQ7
z>=zVEXOyleJ$?*sd54Q@VM)0Zd5tdfCqd(#y}7Q0ap&2X`>(FtQq4;oHeWyx-Olz4
zr_Px*_71$zd12XyfTxtYlkDw9a`JMw-L=L3?3VqPFV8D0_tS_6+S%D%zI+)5gS{ii
zlE@9Ni}O5mcGgx_PPrM!?`R<{Ee(dQuCD&*(Ob7r`&$mb2K0g?NZB!)NqkaMZ)~O~
zCMJ?{8albSFl{3?iqrJqt)?Fg;7bDk8c?qe4i0kl8p_JcnM(nf!2|cbD&Vx*o2C$P
zOWjZx9=aXuax`OkICHSOzE+i#M90p~e&a@CON-QbBLf4~pC5~g9KP52eFmH<`;#vp
z@4q4=BkRo;+F#;q>I)KBd+zL<X}&;$^-9f{6bno)*zeE(-s@oBVIWDd{@%7(0{IuO
zTq!ai=33mIDETMabl_gU=S&A4-A^#Un?Td~3v=&-Cc*IrK3z6Ugts6KM<{7PvRvHC
z@-hV(S!7&X_Dw25myKHAvtirKmqle{WWbWY;(b*}f33>uyN_Ea8ujd%*;s|D!-s>T
z>zSIS=0-iqGTz?av9Yo8uO=raql)OoQT)B<yt+1!<=0@cU>-$-i{s+7Wo2b;ZP&}}
z7v0?478VzOju5=-P|di5X?^eBmkQ_gg@uLoXkJc}?nD4E+m=Ja!(E)5o(Gv&S_)fF
z-h1-ox+7r7F_2dLsB4Uj66hPmi|WM|mA1(EcIYCx?=V!e+Jmg-I;q`}@r4w>&T46C
z^>LEv9e=2k6R8v1n~;#8oUP?PixP>+S24w!92wD&m|9>WA|l#Di5Oki+vPXyyJ?Nl
zA-Js}A#v^`&lT&zLFNG=3Ojq2d0y!T3(HCx^}|`x?ntkJN&H$s;yp&{*!GXg>W>T#
zGV*W!`ekBjT5fWOmjfhHYdr55-}C-><n;ZEw{G1c=Q3N}+EV&T&>AN!%)%neVQpYA
z-TI!>a+qMGH`a?sK)|im=S*Jt+S(eULUJlf#I&EQ*mk1E8-yp=Z_d?v4fq!>1oidx
zMJa{Qe5P1{)fgYIX$l8yOCX=R$#uFpEI3MrzUSFFLU57L>EJ|~>(>PY1sh(I7aO#M
z^RvU$2nm#xmBsJhR~0shFEouBE(Q5?Z*$St*Vi9GdVRmGwN;VJf}NLR<by0mKr)oP
z*gjIT$&I1!o114og?lNT1qBHdfzw(A;gtAqAhxu;sOL0EE@RKZIxlQqKjw2m!E$r1
zPV&@#jtx~Tv9l*N<hZ;5wxzS0h68|oEZ>xqED}QQb12h9f+g<#;51fqVb{;h`8$XL
zQuxcI=a+w{HUg<@@?IXs#LsGW@kEPhIQYmS+be!qxSG@C-sV8WVx0t@1>Ek&XvzM=
zoeLcPp6TCJ&duP1Ev15rPbyd&=n)>{=W#1G9T4gXD4)fF%BdGMNqjLZ4?Fe>)ivk6
zprD(rWJLDLqsR4@4TilIUZcE@J0(z6aAD;1XMR3@jM5gc(Yn9Nj=YUHvL_`Qy;AKn
z$>A?p*s;j2nrGBm;D{0$JnIOrc~nz&@^rJ@u!a4y=*b_r!CNkEjcaj*!{$t}7^j=_
zBA&O8%V(Wp^?@<!i%wYaKd_G<OYAmmh8uByGUVsN(J68u@xc^5I!w81b(uuqWV)h9
z{sSsN=>up+f3FZ_6y|Syfxz^^`9Hs`jo4^@9`J&Y!D76M!i10guW5EU15_#uFIzGn
znJBI^I5;jYF0ye#l_e!Asslqqk#F7*5D-i(E|ODFXsW6*;{N#YL$m7o&70EU0hEG!
z6Scn0OtT$v5z`>mta%*l{F0E6$P=}+{Mp&rd2rws3NB6J<1J-klIHL4PYasjEkXua
zT6%h>mLHRoA3uI<j};sq8L4<ue_mn%RPR1VxE;d#INbzhRDmi>MHRQV=kn$FGMFzD
z-B?+(6;fp1vntBF%E-K4dz9g&Z<iE+KF%t)u3Wm5XTPX)^6o=%(|ck-Kg&?fr|l8m
z9<imPqsyaZW$max&)7$U%rPI<b|9vpsC3zU`sF(To74F}Rm#&aAwQo}P;j)NAtf_2
z^V6s1wzkaN+^(_#P$t{(M6IlHo?L!5Ir+pE`6fELl>$rrSws5CCb)=K>y3RjI5@bu
zxtWiT&tYi*)b6gKA*Pnu_84+PLIpK7ro;Hu)CWS6n5vY2Y9Vua$4OF=7CA{OZFsdg
zx}R-qZPnG(xXcD7mY3T|uugy`m`+!&Y|Zi_541~ZCl!bObNyeft<naiv}<3!d;xeK
zOi@lwPDaK}17{D9!+~7A(b3Vc6hw1N%irnbiY+q7X1aNG)heXvwr<_CiVA^V>2wgK
zl|Uve$!7!-qaekZo&^Yz)({|g_H6FqplYmjS5LOFl?}2p0!WG&H51U^P--WJ<Kl82
zW#bgffL!zHl@t<*opKq<9N4$je<yNc<JXNhZruV{Zsqw!8WcVSpX=6=hub|cUN$bS
zt*ZSMat{5*@x$fuEcN1*g>UI#Z+s-gpjm{HNHm~X1oMBrwsh0$`gk7%ou!Ehuhm3N
zG_UR6^y=YGgYcMbhaj_3#=}GMZgDF2(9qBVqYg?$Ek@TlueX~}Icv9svuIV^;9UbO
zc)_8h>3O~B@k<@=*gxxY0Jzj5px&a)$jJEi?c2QOckFswKgY9gW@lvuzI++%2jFjZ
z^<kO4(#pcZc?3eE%r32shI{<}e}low;ihe$tN>V;n=>}(kK(rcN^o4jA(*f8!%UJM
zkW2m`AY3QEya2cj7u2Bhda6QCdsBZj1dW$if4&X|f{BUg=jUhhq8gC9O@n#vs+5$J
zpoZU71(?vSIh3(abvHy#=&hd(Vw4Pv{krW;Yg$?wuj5KI&xK77R5<nX=g;49TgDDN
z=QL`Uj=X&iDbfHX|BF}%@8x{Ph@Y(02R0y*{rwvXOnSzgXDQbCVNcoZeXgsrG>sV+
zg=fnvD1>cCuxJJ^F_W`0Gjqy8(5I-q8Nk21hc*>e)C9uR^*~z=ou+c%c<WXH@I^Q^
z0pT^vFL*avE>Q42qdv}hm2mH_<2)Z31!iJwX=WxoB*a$16+CflczCh_y!S}FcWjJh
zP<h0Q)-|LlF+9S~W7rX{uK?j%8v|l63u-8lW>;tD`JZGip9nFq7k-DsfW*UxZ)~td
zz&gG<x;u~w;3mE|2WnzELc3@dU-a?guuTfAC_;Ai5$c>$)8h=9Igb0}$rBKGpeaad
ziD0e%^_3j3xy?yMeV4xq-hr)o3>BE{>A@{Lc0+3`x5xH-;tn_RJA_P4P4{<x1l0$s
z2pg;d{Mm&0>fFPx1o!UWXKX2?e*!AIc8-qsVHQYKB}l9F>chqASeFGxVPRpA!9d=v
z0)qQfhhkp8U*;rO5@Y#B9ap5-9hOvnUC9IO%i!LF^SHQi9(yL%)XhiKD%Bp9n@7~C
znVCeE>~1@&pvStYR`8&0MU9X>N_e710SBsgbL@^LJ|DNoJ+)iU-UatXh#qzJTqLbD
zhCBQmtF#=i3J(tlZC0sI|DGrI#B)AOHlO3Fn}!gTiyNG~kL(;6AOTI_?5yJvdYgfk
z_J%Ob%XSV{13!i(NOA}n{I1zNl<sUluV>-|-~eKHq7{X~DGG%X*p>lL;C5pA#%=r~
z3iPtkCGPuMTD(KU1D7Sx7K^Z&oKuLSHrL7@Kn>P_?HP4voTG|qmTpwf)rN+KayP%J
znJ6VfI&pFF7Uit0th|OhrhPXEsmBg%@co`WgQ@b^&2<uMIeiD6XkQeExT%&Qz>Rly
zKlI&e-IAUJ;`l@XO2ku%I<pj2n9N&Ll2QEbhN|dToPaY2504YrXU)L_11e1`HnhR{
z#TKJ`W3E5v$EiCbBL*qKbuQ)$hVTG{!;?wf`QA~*=y+VipiUFgMdh3HBm>>gS>f^H
zq(gr_TfoA%IlnKz1LNztY0v+Hvl%P|P*%9a_2)*wr%hE%+p$cMIzo?Z#KgpmjZ-5c
zBG%NsG%{N162yb>$!<69UD6mQ7>JH2RY%5if;)3^kic-{P7nnHH;gN8@b?%pLwTLo
z^l_2#SIV7!eWX2XZEXz?zcM%v^<=e}YL4)mTn4&uv-TFV*k1E?l-Usl77aNTW%dbr
z0x*NyewLyy(o}`n;Op0~EZS8E04Da;PuYxo`?lHmmWG0Y;>?*dAjd2iiw@og7=FGd
zg%!MOCd!gY@9&Ej8Y255pOc<s4`{h9;1*9i_%rVG=O{I|c63njJ7koXm+yso@0!7b
zD?n4l>$ExndSMpzBI!G@No*~b`J}UyP9pd^O~G`^SsJ-xp?=gkysY`o^8Jx`s;1Ws
z0W)^m_VSQa-dVgv$lmk2-=QJHN+G>$%YgEF@$Pj3A)r@Y5rC#B8en1RFJR>%-@z%d
zqEp-wdgx9K!9;=$VKo1BY~;j^KXn~U5CW3`@C(ORV1tPy{^nW$o_z~u4I)xNbl(Fo
z;28hn5c!;dVXTyMm`DELS0K(BQSk{M=3B{s7WH#Ify!QhF?_-1Wl+0nIPZZvUV~%_
z^fsNF$j+|Ljb9zb2D=?&%Vb6UoRcf1m=Mg;f#aN?q2Yi&Bk-#`w)VR#j?Ac$%R$x{
zc?|*2mA_yaEnRvsYzrS>d4{<0>Xsr^3267QMZut<j(wdRi=G>cPw4m4Sd3EN*lk*T
z|2cMu(>O9Xaolxv`2Au2-UL2o=V<{i$yY6}UhPa6AOCSUm#K{>)>=o1@q6CcUQ*{!
zzWp%9HUI_-5U&8{i2iAvcR|J@mk;YkRL{9{mH}8=17D3h51z!U6ih!T`_Nz9?+;0?
zQa}h4D$^qbs{@Gm)3qYF{Xe|4sEsEPVes-uB?d&x1~#aGa&mG%_w7H|)fJiNQ^yPq
zsSy)Lpinq>!6qfangu(P{`j^eK8O0CfDRX1&O#m}fa;Ie$jkRU-6lN)!=JKlx-r*v
z_5$Uxj#{DLnVd|Yq#`LPsjr_{T)cf!<}Gt$z&4M_eiNFJF9}lp-Me>1M7*-IEdeuO
zV35?70Nx)d<X)CR{=3QU=Mw<p4U0y}wemNwpB=Z<q)4k_kYn?H=UDGPPV!(E@z-Sb
z02GsRTg>TeFw!$t0Hl+dX%4`~;o+eszz$=eGD&J^XecW74(1yHPE$EUg?hItKfh-$
z6%ZCSHa3Z^f0}N~&jk1G-D{2F2B2gGw4NdKGIazaMWEHoIBxY`Qok|F^yp=W0VL48
zCKbWbv<CWe(2#F3HFKFheHuFb<P7a#9G`vj3<cI^g2uSzXjvgpMy0(j6L81h6t<fq
z0K7DyYmRq-4DwBQxM2|WL(g7IOUsC90|NtqG!`F&-c%!_vAw-Wh-uv#qpPbcT{#=H
z)s1a!n`>+G-13hed7oB(Oq56u!Mh9NxcK-=J+{`?)<Fn}Y61!L@#Dv!?7n{edQUt(
zz$~W<8E@~jHA2nfw!`*k2x8nYKHu{I3Ij$4bPKdCN=izAWXKmsUE|_%*j=0M&(`i|
z2PJ!Dq!f@fNl8iO=H~bB-(Sm3Ncg;$iUOT`#LnNHyD>#<ABoTE>gpNXD~)B-)6)vc
z(zSn0pcNA`-u9M-1)SDe?A|><C<TIrYYD$4$N}5k-PLOdw0Cq=j^oHFeL1yrinUo8
z--m@6tfwkvX)w-@=yS-tW20tel{;E3K#1Dg+bb$wmLo0b=ZbayF&c=XFC&6{QY4Wm
zJ-YYXf{$~o9&5_78-c(^Vtkzjd1b{quE?mfSNNcfGp=fj-+}~688xY~6aD)R<*3RZ
zgu4yaxZAq|wRqq&pCLNQtCV42nZqDxzd+c7Q)vG%rOlEgo-jV{!x1e^7CZ^&>ZHN?
zW}w_uW;HS{qn)q$$73shG-4C$?gZE|65dw7M0CGSSk<3jvc`37;OE%)PWi?Un}f|6
z%?Y0aDG@P+v*j!p&Q3cyFmmq|`(M9_9>-fEy=`A?`fm3Y=tMU-H{zaw2Hi`P9Vg|x
zN)vyToXYqm5e7h%A4$Li4B$15$C=|d_YLI@C?kUBJH-0`LW4tB1Q(aB{qlma*mB&X
zSb09o9urCmph|!&&qMR=+qXxL9*vES{RZ>LO^WYLOLKFX2M^$I`0D27>%hRQj10x*
zASz)Y&@ggv$SVPEvGowWA2!W59r72AO{d+&qM@mYjg8%(q1yB98=b-AX=`j`%CwaY
zQO1K2DJioX^F6O#y)w@-)x^Q5`GvsreKH|ycj*|+*X`}?o$^K30H+jC_a_NlBqJLd
z989Bik|+ZJ7z8$8rZ=~@m4nM<cONB)Q3!h+04%T|JB@A%VF3J(<I0H1da$OcDWCE#
zmonq6Tbrw^jU63e=bjL7A2-X?3~JzL1e$>w#5qtKK)PaNW>%o^vf5eIo&Eu_*`SGk
zou|R^o6Qb|#YIMbx>;>EAAC7IE31!{wW@Z8y2-v&BSYQDI40AC6f5)b7b+(J%(K%U
z;{<eebb4L_Rkm}%;%!uvDaZTXAi&POqy`-7F<Y%Ju{u9LFX>#G7(PA8w9%51l$2K9
z*x2~S)KQ{F@;zup7ZI8HcQO;R@?Rdr+%XNm?6Fch3sSGym}ZVDV0lCUk)*T1|4;Jh
zOCPuma|o|?`ZXCZ>dV2&3EJhdvNA4<k<^1{tkSUps%@Qo>YOR!>2?kd&AK}~I|YS>
zsu^Igzb_WA#BDxwJ4z2e^QS!@%!S%>2Rl2!<MOvCD=L<hl~MBA+^b@`aRbE2Lp)J4
zv!%7^mTc|nEVtgFNZzdsn`4%bmiO*IB%jhN`@&|h!QkG$&@QcsnVSN71c3d30ion~
zSOUq3ww9ZlyTzvTxtz2#;{16K2f+m~VPQ$O{x$7uK1)xg8sGY!y%5W1zmR9pqKJGG
z7sq;bVr3=kX4lD0K@r(p>_2<<>;+Pedx5l^oINg@nH)OLJWz)r1UzBX7<0GAJdfN#
z3(^jf1=z_AE2HJx%fk#2{UEY`e0{B6X2&=Ss54;YO~}n<7ZMul==gcK|5NV4gA$ib
zrjuWRO%-SY2fPzHiSQMsFI1;Vs9^#Q@W8gwPC&B)dVoy_T9<ewqgj0~;Msy0gqlGZ
zq%|FL2Uc9Qs%kNU`Pe}xgps7P0oeyoh3g4u>FAnXg6#;D8<1bshG8z|3uj1t%JIP#
zDYAdku~f5%s_E!pWnf4F63=Lvy^xU5=H_NAz1dahwuW%vMvW$LH9Whrh3~C)la^M0
zu`jcg9)ZygWYuUw@QXfn*l-cLeiZZ;*;<u*^!ewo!A#VMcEwTf@bIYERIF8%lnjgz
z&@wQ9Cb4sf9-1f}FX+~FCspSQO!2tt^o$T7$hmHEa~CHi836eJ4EuN}2*7V0dW*7y
z-IQzOptGx@rA2x1;`jM^UZ7pwQZE92#xQ1Ol)rzJbn-bu`l;#Zc{9RjIiM2;kYZ8t
z!y0fP0q~gGKNj==O99f=Z!87U8AQlJ>Pa=V&O^jTgzQsOQ%wyGpgp))N1=Iy>xi}8
za-DuX32EABqzSr4;(L;Y(-4><p5I}pYk;Ujk4w64ui%|KSL(LQ@%9YJx;3L5Fl>FC
z`!SzY3ZH%h-R<yV6!dcp6tG>_GG|xh={H>h{|idb^LygrQu2=W_IQBv$TyTxR*r~#
zryws6<f+Qa%7y^ae9t2fgIzydVtpc262QMXuNy|8;<b|%`_dlR*sKMRa!S+p0EXcv
zJ`&v|qN=I;?bBmEax)7H*#{5a_yL8={ktD=mPY9lO@0WsV<TRA^Y=HsCg+xo6(GHO
zwZe8*_D&EE40ahPC545Vn&o}t<JwKnFJ8R3KGT+-p3V=5k3@-(3_Q^z*)+5K>j`47
z`8*Cv+zi}FX7u1%9=isM{IEXqfY+~y6xNy;;u<jl=-C9FJ!c&S77h^>wbilo+NsX>
zHr=Xp;PJZg)2E--4!e`2f^)#->tT)L*4WK!V4$kxKHh9edH3&s=`^MgD@N5k@dYTx
zCKceKy+Y1pXk*ZVwX<qhig^1Lq;IBqrP3c1l$2RBk2Z_lN?DZibSx~gLKXWnQ&V$x
zLqw~k(=rs^78Dc=1M@t$6F{jzd`lCi(t)QE>%e)UCJ>n`ll8BH$4>GZZIk&($s_c+
zk!0!|Krw)v9V6=J&YP4MLzF9oxCLYr(M*2Wm8hitWI*OmnEBAm-(&d&FlNwI-tMlh
zM-LwYA~)U=K2@o4gH<IbzN)I~H<5I_Tt)fU`}~1yX2(TBNJx0`B5)wiL;T3@OjI*a
zwc5H(6#x%-vOZleXh+}Dh~rZVI4$(10f4mFN1%ADOUw%xbZRRw4J%w+{M@<QBx36O
zPXie6Dzw^W`sJqK>ja>e;~+4DD4^~QQff{Gaq!B^+Z@U^j;SF)phFCNuyPmJ)dlEy
ztkU(-E9*VdJ-NFRiYTuJ!wG!*>lW9TnOk-d-n)b_hv0|^Zo^iR#Up+wI{}sgLw0Nd
z1d;Q&`?mY9dSZ7s0c`y>q$w6Q_JylFUOK-kK!#F8aPV3yXU7Km7eWQOT8GP80pw*k
z&N0)0@%5=a;Li@~Sv@{@nEeM%DA1}u@Fc7}+*{;3s#N))ZHTPe?H48;;N)G)(k$0+
zBDbty*R6xWe5o<+PB=l($clmQZKA~?(p5tvnsy)511@gvY?a)*HdaPPDfLW%Eyg8g
z>D~QVKeO?}tg%lIUKVpz)d|SCXf*m_favM-V@$}hal<6(v(nNY3B4qG12bcvw^CJo
zUy9usH$G=r-Hyt*llsueM*n0N#|!LEg)GS7I6FJDD5ct7Vw#$niIk?_Oz1;2&TO=q
zHG;alz|OoFNsh(OAYRoZhXeQ}486Rk-<a$l>H;1ODEWGN39`GfW7H4lTL$0US|Jz^
z=3Q%JJxdfRXAOhija;1-K62h!{k~99X*=8g`o#+XLc%VqD=N}b@$>QN?`{KoG(()5
zJR|2x$!%>(-Dojuyn?DZY<lbGPw8TObclvyV_fYZV7q~{@{l2z!t-c<ocSl+PkMTK
zoHJ*@=-(fGzP_&S2>?F;N>Ub}l4j7FNQ{AVGis>#>eK1x<y`|xFQvzh?xJ;QP5j+!
zFnk@jlNoePKw(xbdukqlGPl3Gi`U8|7tQl4vv_QwiwPu>rp89LP_`jc@(v(Ki6cYU
z_n~-$JRYMIW>2?Q0J&9IPymSK#xrP;A<pW!vuc#E+08vHon+V;?Y7F8q8Mig6ho)7
zq>!A%PXV8+iJ4hIP|)`Jdil}eKH;THSz48RolML^HToQa`%C#>Mr9Xl<sjfcd}nD}
zJIdB&RK1TIaT1;)>DUQQK9$?D#4-8^kJ~?D=dYan>MA%7as#LH+(s6|LoHYTd#T(A
z5=Hp48o)Am#c)LvXUA6M9T>HY1KmnB#y(UG94Uf0dY5I(qwTR8!S843J%3i7tw#Ij
zcDU^g{Va3GIY!D8iWb*Qr<Tx!#MM9c@72~l=DR=v$^ZsN^qZq2;ciZW<Ym&^Vd_{I
z_-4>9orA4BJ85N-Jf*xu{Y2nkT*uviiTRG4pRpGpYk=mcV+XMo01p`3WBk?w!GoPx
zJ@lbn@yG1~<$~W`0rV1J_hP_;+FM(j026J!IdE$T2@1yaz%lUkPVSGiDwd=1J?~Ax
z19Dz2X^AV}`xD!XrDc#~-iqcOm;>dz1ahBYo+G}Lw+;B-U_=;5$Rq<s2L7w5$z%b*
zXPUXLu1;U#KU;r!n?L$^Pl_BX3rkUHmOUx1zOVcMI2iOY^VlyVCDVE$8vszC_cdU!
z+Os<Epw16B@8wOzxpTn2pWh~J*x~*9H~s-gyQ5_dARvQkNG<!gbRC@S5*F4rjk<D@
zMH$a-?JZ`fpG~&kDqu=g5aQ)^{u)3^A7av<rODM1h0e{Nz5V2P_+I=lPx~-ZVq%80
zm8HRaun&O#@#gm6;Gn9S+QRqm)Vq0=m1xiqy?F7WZ}DkZ?hI%e802CR`1oU`wkeTE
zw6BT&rLa2xM`7iBFL*W?91A%iBk};kTL1McEjzn7<@!ms3avZoq#s>qof+&&i$Cp8
zG}^=3o%0zSwxY!V^M>Wm4g<BlJcV#Q@gr?ZWF*;iLLy<)+Z5TD;Hy8Tr|B&1`o4j)
zjv9U~ce0+s|A-HIZ=|f6wARGB-{l>2en9rUZ;i!Xgy5buOFSTRhs^H-sjW3=YW4f)
zX7SAYl*gjzwMp_aLCdW#?Xf*`Bc}}yhSfHk9Mf?E)HgC}QC@TG%TSfyDV>dFW@OBL
z?`R&*&HyYoEb4TlOzPo_X5R=>tEXG+OWo)s08Cew{IsZ~s5sE7zjgIpAoW1eGOOle
zJG%`aQI%&tzxu98KTn7)Cf_LEXK%WvyZhw!?I2D`u-N!Q803^fB>!YlCEe1M&@c26
zv7o8D0@mbF>3?fq)-uCbZ?Twv!~HePlQS`)L)Ue_zP^42b&Z#Ia1vj%n5e4^kQG~I
zN}cU%e6ww_1DkWVu|P2mkov1Vi9WT@r0LfJ<K6B+SC{okuhOKu<^hff0!;}hoX{xP
ztGNJOA!sx8{PK<CMyHb-#$A1o=27c&rcd}=`hcy@e?`R7Ss&>7Ee3LGhlkaH<N5wG
zK$#C-Me3|C%`0}so(yf!mJG@+R-D4Zo=XF{K-ZCseB1l(-8+)YmjNKAlgi7>)Bj#*
z+TWM0&DuYRL?Pa4&?%=w0n08PyaMQIz~2ejFZ2Qz1aK|4o?RclN@>~Q-6SsY48$w&
zu7GZ4IM3i!DYZ(eP12OqA4xODJks{0ShRRIX(h_%)y~Wqf+$fCb!}dZ=5~Ez)L{a{
zI0;RyE(xIhzvmt^&o-aZ*u4I;`lu={F76^|Xli&sazR>|+1bg**x#N_Q~vEqVE9BV
zySXyDzqK5~yarTX>mOflX_obtZi0^(gB;_PUsx81N)~3-JOT`iMSqUF7N-?<<$XOp
zJ#cIwE^ZvXJs$Vwjn(GD<Kxx`tDPQkFGkUbVpLeSYeiJSKzGYGSCz)-2M(A%2-1j|
z*e~4j7R=IJdjy=Gj^p)sV9DX$AtVqJBzXCz^x)#|yGd-PUuCZ&6pC<9z!FA{Ebv&!
zX1gwKYX^;Ohj9*Y(@u`+%31p#r&zH>mXw{jXamx1>5dWx0X-|8*yEp%usw&!YsUw$
zlm8d1*0s9na0YPU7&W<gfX0YdwyX1Gf?;nRGe4l^2x|M|NyHGvKD8(Q_m>k_5HJ7n
zFMu2VmXX0Lh_8W2e7AGHPjtNIev`a_6882$LHcFwEl|sGp3AbqfS&1n5vtF#X7&(q
zEGrw!u7_&U9|ExiENLKUQr+wi51avk4ASlYmi7h0bqF2U2j|Y61BwU$#(>le3k#EM
z`Zq_!z)V@6f!E0(Fnv(vrf{)8{BEN-1@c;2<-hT}d&;|j^#r7oQAez~g@sn`ll#WT
z#zsa)$A$=T4-XGl*L@%lf^!I&{ok0dH#m>w34+@r_mS7mX`xf~jx*sjB*RVv`ic)F
zqFS7sEVg??sivV}7MRy2FH}@iOucRg?9T6zc~e3?RM!jry@G<<t_V>Vm$Ez!mJtJI
zfDdKmJ5I@%s^IE;!?xhM6T{StwsKsq77RcPLgpW@azE!}Vjo}Mu!38ciHWxx!Ql)6
zRhfl9tgYJq^3qZ$-rhfi3RJ8+#Zfwk2hbBg!D3=&HfoO^q(Kt=<8q+-#{@B7@tbA2
z%3}pN!urCt0V@KiSz~kaLKWq7ATFRV;=vI;kg<VpAJAwe)<25O2D@n>B19M{r;d(}
z(-Pi5<NU+Kss@LJ(czw0Bldu0lp2X@<N^oOj%OBvsNfI6o8|Ag`@e`-<ORF#YSz0V
z*)o9FuyWLWh(Nf-bS{4cJ&Y_N)WJiBC=k35uL%MdLNB1D0my|d2ihb$6N@k;#G3HP
zKy*ckn0OLo!8%S3#ZYqKw5%A`8h$Q``Fn?(*%Mzt&l~p!{mwB=z@Gyd|47om+26h$
zBRLlAJg!i#`5CaX4%;IbOeg)`94>%kg5R3zk)C{)4}AqGgCrGNud*}uc=l=9W80O>
zCPO{f1<-T(d`=j<)Myo#+{(H-<~zQE%?-_r5f&07P{zLR5zv(&vUH>jx%w;J((v`W
zuwT<bXNo;oNw#`5DWu@gJd%|3PG6>a|7(&mXjT35Ihmjz;Dm2<Erdud<QNw4uyfD2
z3ev2?bZSnysEK~n5@Zbc)NH%tgb*f4&M`j?dCx`*s&uWk4;838j~h%YF3e*?G}OUj
z9cK^>Warsqs0&=y_W{ua7V-B|f|)+e8mn}Ft*ZBT%BZx=Q`Fd?2iiH-E38^(9PcTe
zr!Mj<pTor+E;3gaRtouT+kuq7&X%Roa&B7MDM0OQMS*2J9nYQLfYP;|VB~AEh3n|!
zbR`J43l7!CkoW-mhI3p<2(sbq@2v~$E{y~gYt78y@Ov!*MkUuKNLUz?TVnbr*v{G2
z)&JSE3eYk>T`~EOhVuV`c)q)q)ZPavQdD6HqX2RiQs;OoL~)r1>#c5VL<_mQSX<||
z*=M%AOX$51kuVFFUJZ@*9yZ0Nd|M(y*8Jmvo7jQ_H$#b)uDiRtv-55!qeAZpAwZa7
z-~S*?I36C@|B9C?XmbE=E-ESl`F3xApV>q%<>16r?eXI)o_)&NAy9j2Yiohur@+}H
ztFRE5Qk>UkKq8CbwKeQclmL=XPH9?qw>)r00=t+*E`x0J18M03E#>q8Uf@v40|t)8
zArn%cSf%`g1mxK4%uKf<wCXM)z*D&%?ecHbbzbO+5&OSV*JIOr>MYHfoVk5{wEWFB
z5+TR54geGdTy(qx!05|+Hxsb7cBb$QQ==Y&5wSb<uE6Z_f;<5b72uYHrG2;GOD{A4
z-!k1cz%8XJZ)0LIX?Hd@?2;;M&Z=wpdF+CeYflWmS;2<l<_jf8LP|=Dm=}e>Q_IY(
zMwKZm-_Of->{Det7_sdL3k@BpDA&mk2&C@(6eEMQa{ackxryHBkuw1`mc*y31o`ms
zV>;!JKqmWdO!w3iM}T{p<u>ae`?hpO;hk4fMw`aBUJm9n5|y$<d=8OXFDl}Km}tOd
z#|#bLhB>OpK$Uf12E?Ou6j$2}iBGBR?AI?}fMHki%1tJw;2_`(P(uL*+9r2#VZmjp
z@#5|$U@E(IO+@B>Zf-6_33;H))*hLf+O$>b)M70r+-ZoFp*YFnff{2!2Xa4u{+v))
z`0WW`qk(ZJ#X(IE?xH3G1a;pn&R*PT4jBHyfbJ>OLZ?f01G=CM_yC88T>&}-KHE2L
zJtHGGTc$a<|9G%%RFss$+bIAekDK@EU$`d)1w#*ys;geWgpha7)O4of-hf+kO}mU{
zxq~@+ZxcixgePf2TU-`TC*nAsLK^UOC$_<W0tm7EZ^P_)>vye>qEBReyQ0+-g5ZOc
z8pScfQXusKxw>a@Y!BT(v*ds`yhy6sgSP}&sqrdzn>00fc@Dt$CP_tnJpDuni4U-c
zCOi^uE-`ZXIw8LOp0dA```<k`8kH_Yn%xVadVt<}fWYk_-y8tEO62vasb*%|0fo^+
zc?^_Kt-^_6wh2$vzOSn?Hi%Kki<mW&7>$qN1$?(r+W2HVyPx~VHr<~DnZE1Zuil<0
z=0qDE1H2j$lt|J{rQSXR%b1|?(5dtf0<4QbWdun6d<Jp-dQK4J0-jbr8jh!9{0_7>
zj0w2k=}*1AJ)nW!m-ExPO`;4xG5uJ;F*?uvHV0uq3O_iu0n#!g<U`J0`2Wz=L*dN|
zO6ebO06=um^^P-qr5zVY1Heh-kSLLk4T{lmw+^@i5-i|IH-dAS4_zi9nFAEN``!ky
zVH)WEXWxDkP%e(UFM+R6mBVFY4hShs>CwWTTH)Mx?lkR#Zy{j-+5--tu#rgQ`uh4K
z&P;qDdxKQ%RWtKE;5Z>&kQi8AUOq`kis23Q^*~yV5p*p&Ic*Z$%g@gboaJ*QSi-{9
z(a~2`-Tw#_@F8lQQ~!hwQio7t7ueZBqsyV4nz(h``Kn+x%}J8(<B7`42cHTTa5CU0
z@%@3O@>yD1Qq4D%NcKFDzw{-vv|?Wo$!7p~HC$9(QaU#Wj+86Y96MbQc6|K&Jv}|{
zZf@Xk%%@MEMn*=+$jLKb$;1i_jvO1`#YBPeor@dR)YLQrfgpsp9<WWG_|o$N0|P1e
z9h{t;3W|!F*Zw4fm%=xoWFRjR-tfmh)Vu(Qi=bDp2nipms`A>-NZTUW%m#A64FL+n
zBj<8*b>)QETu=hBqG&h(1N#5pqZ<1CA4^Xu^<0Y)*B64sl#~RWKOS7Dm}A(v9mgTW
z^k6_XnSYJWT|Do;=K+V6kryDxYS0-r9eXSt{bOg10x8z5V~hbEmIBWLT?_&oC24|>
zt?ldzfRdY@ZmOd*5qZZHD2<`hTXGR*qPDjAp>OT|@hSEIeXLPxQ(s50VH_mLhluh6
z7Xc<AI~<|~>Bnv$T>~-z=j_>^;LNIFM~V~|0~eRl+AlzhcK7xc*e~{NkGXaLbB62I
zK*HxvCWK)3sdW{c#3+az%rW}(q_i$DD5!dHeLnaxSnfn=0PE|+3q3eG$Mu5nKO5@K
zrTt|H$>Du$EhdK2(3N6(oGc7%ipu9VjLY=HPW)&O&_p#rPVfv86huU+|1(oN%t#%<
z$G_@d5z~1Z9UljJa0U2M6F8#YzKrRi8}{^%7k90w{G3yI=G56v;&TL!?kW)d5lj=o
zfsK>GA<-ci!!mf4k>Focg)5*c6f{s$pp<k^uK{dp!0=%%`}pRJ&cCRip&KJT^TBNw
zsaCtCSOr&WuqTDXZ>l~)hkB!3m%4O~iBOdDu$snGui^2EfxrHRO0>ewyhy6;_NyLf
zD&UX>I7)T*!0VsH3i);Zk;!~~qXe{0%=idXxKgItCit49t^MyZ(LC0m+jn$TaLkL)
z61aP6$;Nc#(srH>qmv4Uw9wztS5pGMbii5#0$X{Bz_G(WzS|CL&j)BUF{>8%GMzYP
zy09ZF0llw?kfs9DewOvu1JV5|M*RQIB|^DO`2up+^WK&6o=DO`m;Sye`P{?i!};LM
ze)~Sgu=(EyxkAXXz%xRyX_o@4srDaBaH6?$HvQT^wt*|^IlS4q?GCh<#HZ|^(vnZ`
z=&h`3^Og1|hWeSB$7|d}7nQyEMS+R)FL!+12tjB>L<^A>ING=N>-3o0Lym$e%f)Zz
z?P`hDF}=Nt2D_jZ>O0%p7s>#4vm<w#p;%ueTazrZ6I#fA14#o63@bzAo2aNoAZdHh
zMN|iKOh46X>I6r<`qGENJb3a0QDUYgEWpAX-s)&%3kJm)wtO1~#nO{}=`_$G%6j;V
zWL21J4W_>sY3GNHS~QG6jp|?>L27*gxM3MmCzmlZ+l5avudR(E2^{L-`9MuT>AI8)
zs3(cBX3HbcnfH+nVMVQz4d+wX{?)6h6N8ynHSNC=#nCXCPAL;%R>h*ggpJ{qK!(MC
zmI$2U0Z<!=aNlXf0#pi&AAvFg6v3H_uUlqd5L2_WK@|LbqobPc%{6Y0Tt;GjLxuIp
zt+_j&#Q)2j0^<6Q1MZsf|L}6e=P$mz#2|Zb+b<pyqlTx%>U_ZxoB`w;=ui)oyr58o
zs1#t|hwV8+_WehHm8H&VMp9sqge;NA+3{L9WQjcH>Ah62AWI}9MMJ3Pq(gmh)8sdM
zAKga)eEcO{9?PCehkL+M*m3nR6UYExx+nhFEla6$l7)VL{`|e;C+Tf-a17?3lR7%L
zfk<$p7{>9_RdP3|&Y#j<$W*Zxbg93`+Nh4D-NyQGRoVtJJsv*?&iQYu;_pYG;|6o6
zi63$1i^j%#8-?SQN2>=JZy%{9d<+$+>|n^dutMOK@K-BSb3j(fl2W4c{gZog!?>%l
z1#17c0OmmNxf979IBw4`;Q5YPC~V`usQJeZ`4K3rx>m|Z7yj5MdA<%-q#vab7~4aw
zJaBOWF8lw2z51_*d*_1kdBI7Ujg5^eZSI>l&4#(iwepIJ`s(YGK78;_zW>LjZ%c+{
zOX&5Fmo8qoW9G!$1c31GQ^z%((02;SVw@s1kOE?QqoSk#WR<M01aT?>r-!=>z|RmY
z8WkBC`sCjeOufUgb?L5rUOUr&(qLRcOpJ^sKn~8c0NfS8+Ibp_s|6k$CBX2%beHSW
ziRgc_P`B}F|LOl?0+{P*{r+SaAlz32MSYkb#-;oM)X|qO!RZe(aH#Ml5i{+$ql1GQ
zRoKbNpHS6ei<qDwId^xoIf>7|_lzfDVoZkB)VBagw>PIACFrQeN*{qr_D8dPK#{4k
zD2W84ff3mZXqLjwo9Mnwb=RlxFR%xgzXg3=$ia(@H-UF|cQ1kO#|hd4crULaBO^l{
zsZ%L=47z}l(kE^pgnx~X&t-Gr8#o~VIzoWv7R12G2M8$W*Z~ju_0Lasw7_AC$XM`P
zuKI9#@MR8})Ty67ffGEYfRFD>h72aabIvE=x<YVO$c^Mb&7xOMxwBvc=Kti*7D=$2
zg@MNlkmg{tpyU2c=j*yF0y9d8)WIJJ#;gY~z?U;ch&nm#_?*GjA3ZUc>A)@288F29
zATtR-{tqSto<9e~z*TOGk?>pUF8c7b^>rW!K-pNxK*yG-=@*cUL`6lxv&wS-m3`(>
zrbelJcWIM;B%AJCFgO3JxGxW<a{b>$DivjGGE^c`WC$5EwMvFUREjcX9#Tq$WT-R{
z2_ZxwBtyo`R1zZdJXPkgj3J!+UDV$DcfP-KopY{pU1$HXw|2`~?|R?o`3(2xzVB!L
z3)(2qOCiC1D!8QdK<y>>u57aD0}(PRD{iU$0ZT=M!H#bG;kkeGy)s%Yf?o*2uRuJ(
zYN_dY+VV}>Dt*9r&q5>X!u6msmKDSch(@BAj?($-s>wFVv)PkR<us;f*N#lOkz+!B
zv6Rbblcd<09^%hpL2PR4Dfo3ZB}`G}@jA6L%@_jAY7(HJfM}0CSZ7wdaAmgSV9XA$
zyq~&q7o8YqKSAZ^DTycOCO~ZFTDt71iWZXBjRlNw*KCSUVk9{emrro1GKkUQ&%p@~
zj{>h@CgBr3kAZW~Fp;I<&O+4}UU6Ldnf}Up)o<P<hCZu*MI8VMlTiFPhb=-{`0@M3
z|NF4<FHeAuEx+fSBa_@YNql4hClIr^wPdUj0g9Up0xOa!sJ`jxR}~aK4kY9afBjlj
zQL()gYHCcPsi>%~J369H!-Df0B>;3q#d{tez9%qkB=dSQRHi#SJ3)X9IPwDhbg^dA
z8Ys5&^Yfw5xNK{y7)WMK13s^Ad~$y-*0L!@akA@AUluf=<xlxHAt^tE{{IW<kw}Po
z8!#n2zH&RZ-l^$pm<ZTuXlR7*@&DBS?c1gPn%$fQQ7>L_m-3&@<S2X@8#__zZk?EM
z6&Q-UEt!)@&};7hT*lAOKS%KTkXrM1EpaH$p$;;j`Av#G$p9mUOm!W;7^93gtLH{h
z&h+yM3JP{Mon=T=-?@K(iv(%F@+eQtz$<nqld>nAw?iF<Ga%Cmy1Lo&G4eRQbL9yA
z@!ukQtptN=`i9f<s9A5Wpey<G$<oZMufM+uwfN}zTmeW#_TlZyg15z0LBM?H%eQaU
zb#=zC<4?j1aitJ3aFwhq2K&m=lP%!ySzysp@E}z3dvuQ-`|@v~XCL*yfu8P$<dQ{I
zV<%159NNYG`}b>UYx81WyG)+U6Lvw{v@MAEEHseDpPwR*N<sUGo>0Nn`uzFFT{eG(
z{+affN%HV0L#P$fwY;(LU$ea!x9u2%ugyo@bozPfzDt9ryD-UtSHQZpYqvq@xJ40u
zr~lxw0vd=bU$Ho+W9?bJ#OQf*G986Hs2asxwu*|ym>WFiJ6n>0l86kW$JfHV;6qUn
z=pU_43v-zHKvv#$2BC|_g~W_G+TSy*u=Yeo0U8QDY6N;B>i~pbCCRnyJpg|K;zw@@
zO|C5JF|c|-{_9vuwYw9J?5L@!iC}b%h~PL~+1xDod%oZC3L90Aph&QZiHQ8~FdPM_
zJ8s35KW%i$%7GSW4cG*kwmiwJs+Yj>f*)jN<p86rRr9<}7XM<F5)C{Wpc4e0w{!BU
zwJ+DtHM)Qx%vr=Ug6stSs*O!j;Z~|RE2>3sy7l%S_M-m3r#EKjX~0u`92C@CRh6Xw
zZUtn$5aSxJ7x5&>ZbAglO64wyoux%s{&(-vsH%R(1k|cAsj!9q)tL-ItoA>Ic#|Ls
zigMg!{PQ=4?;J$SO?`Of5(5(D*nSc4OnrV!KHPL#jAhEbz87xR-J_G;0KUxV#~m~u
zwv%W2#KT`py5J6oXTphR=nr@wy?k+yl9HKaM6==}?R|+mugz;;nuI#0)r-25t2ePA
zXSNF*r0*p>342Z_VLU_7v!a*iS@%3WA4fps$;`<324+O@@qGLCMnyy%l$W=6aPUGb
z1WT!86fCWe+(`nUoPvfZLbpWb`x7iN1V6pSZN|qXDf8{i6S0>?8d_R{A3of^<{ubA
z=9LeXfSi_r%(k{5Favk)50g8lyVBX&`CrgF(_VIVgSKpRRJNF_1qz!zN@eS9-|c60
z(y%7_Sdka2f5NME@2=Apl=A0UI^M~*zllw3pd>xrxn8^@PCFg`kPh;MJPFB(-ex1;
z<}CAVpnIQa)6KlB$Z!RXS^$OJj`OmoZ@`4Xf+Rry;&@v0T}I}(cfF{oEE8Y8R9c(*
z>eZ3FE5!Kaf&gOL0TKyhiL2Sbdu#W<oPW$;-=(zaQ(2kcqy9_~zeSt`d;NF&*>XR6
z{P+qBnxhpU085xwY@g^^hH4QsT&6eBwnd~bYTFcTAhtN}M3rtvvxi(Goib6=*9E83
z<j|{iq*8iQE46{OE``Qm5>%`sCQaI0Hupxzk;@w(maD6)vonPwY5Pdm0XuLOK+avH
zrMwoQo)i3=C7E1+5(*_H*gSA)n=TV=KmGyVuWmcBGe0fvOf7KqByBoB!bU?iM8dW)
z3Bs49QYR#ecE&=<$bs9ykx@d12^V!ef5BqJGXHsIx#Q<3c}7`}=zB`{*tS_+_q3mr
zb-#OZ{Y`rA6E_w2o4r!>5aCoeTSuQ`<|R`5^2d{Nmcl(JckGoDKJY!DPL=*IzZLKH
zaY;Yl_0uJqej|OsF8g*v(X8sg#vn?{z{b3Gp>^w$O`PIV=Phy;QjLdBqrLBI%}Qt7
z+_*q!`=a)F-cZ=gn24rNHV!)OOlNj%kyOB%eN^{>V%5N$C}Pbn*Q_JIx15d|p%5W<
zB)Ay~7=NX=mOrrmR{Ib-aS`h_4-Vol<PWyU0zevLq8dBAdI)7~6qKcPG6%_nK&~Fd
zZ^G3^wEcSZhk7fnST^nT8#bhXw0nz^0v22W8<tHy_W|KaX6%!Ym6Oa+9eFmEkUPWe
zx>rGxG^_X*nCb*^YjcPPtIRx@c<SwSH8t-G3t>etGd+DsULKXL7OTPhx!WVzW1i(U
zD^~Mp#`~U6_xG<ytFe0ZYC|wyUX@Pms@^=lS;lu+mkq$)^0Km8iKu<ux=adMoxu>5
z+SGuLRm;EJH*)>kckh7z6tOz((S{N<2c%mz#+xZZDWMw>o}z7?4!dSfZyv(rfniWJ
zRQl|R6Z@>&_TMXjPt~S7x7^%Rf<%s*h%dVYdsKLHa6YWBt=+o+ngAPHK{t(yC)@X_
zsm~=Pk7iG2UwfU9kZ?wGAQ(gYFEC<)G;$SaS4iFFG=QW*#G#y4XoO)w-TBr`Hbz=X
zHFWE!h}GCH0@52j`O2BP12El_5vS2k#Y-#0@;aVvZ+nX=$ybh}g4AG+bzjXgE@O_n
zBw|ieQ+XQ_*IIhWgg^e$AgK4dh>`K@I)X?&SF)XptEh0bt+xRT2rVJ8&gDf%H_o$6
z{2jbT-cx=G*c%SwLX2Df{^-N<@_eTf^Si}C@~&|>>A6po8Z``V=_ZzEgY?YIFPUAD
z)&tskb(z4RW4~~mlpn!}r<V;Ob$`TLkY(RwWSls8vOhQ~W(PGl?ixcf28lrEyM|zC
z01s^RN&Wlr-0&ljiD+Ev#8c%7U4HNIFsM8_XU{r<C$N#{q-oskYg1W@x4SL2xn4>q
z9uQGyI6HiS)6_^)>HwmeZ#pz^coJyF9?=IuAz?i*FkmzbZ5&Kfq6UR*Iu(L0(R`XZ
z)|he01Xz0mjreD57AYwy$l(kfAnyYY$G#PYEnpGcT?KCf2y3zdEQ8&7<x1N7QJ`2L
zIefHDEsrsxffNObpQ+(ip4pzRE-cV~M%TmJ><rO2fwzh(Q;b96#!O#S$pXVwl-FpP
zzYPsp&EGuKT`-T?sjAe3@B8i>b2Ew$A9r9~MH<nZZ_CawEPe#Cf=Y;l;<(@W%p@tW
z&DKtR|E^|`e2qwMuydeXw&ImeP7`DbJ9oOdxji}Z0*kh*v$Ho?qm-V;CbTu{>PW@2
zcfb}QV~I7QfpNhCH0q~6hhH}6FX3@-Z`RVi=y#t8+~J@cKQ&&s`~wRTl;UQSOgCDl
z(Snt%!hH|HLwOMy$#j%r<LsLBD|YPGO)UONtE1NvwU2}1(W9+NM#@M(`ufi<_u^ez
z*IJKaQ^CyP@iv(*qjiNN=Nmis+W5@g{XE|l_^njhFrOlyjgHdCAnbvy`sve5EGz>f
zBkfQNzIpQou|6gJ{rz<Ufk*grf3kPAai~7*XHF^<?oOWnZ24oW#a_Mqhy!7N_@t(C
zs@v7Q>rLif7*BerucQT)f>_~Vs&U^6V`CC{U+f*7@+tp@*!LHfrPfOMFJH^wnQc9=
zktea3w{v~y>%g2)<6Goip*E0z_q?9_RBwuk{wx<~z-Nq?C=PYNqFfO~)Q+~+{GC&O
z#l*AqKXjG@_bZGro}i#;S%bSG^JDgP;X|VQr^uK6u6&zZ6{2QG2z3@>qT0DwJ7yAB
zw!|zU|GenVa`_ncH#Hq0=;(WnC{4pmOuVWN;evB-5+6-5_mGc>)D%}sOG_d0z@par
z9=vSj+9QgJY%BzWZqeM$jiO_?737vz+UfB_URJdV#yt<jGuce#=V7x!E>(#DkY7N)
z^?sKbaNkFzAbCrQ1PO|dk553L0-_p0!K9Rw<BgZ#I<(m4LpcG7Q=;9g3F%EAR~ebW
zX{gZ(CKf;)jx8GldPKkjXfU9y!^CJ;GpNto?|l3KX<UL<YKbvNa?c0*$-xW&*+vVP
z=oU}nNpsg9RZ@Ditc&4KOkNJ-4zIg+)y@xwTx~mMeS~K!g&{iG2}0Lv*WMHx&cI~B
zsyk@T$V647%}AY1je4y<LEY9;<=T|<2|dIr+bGr0_?IuAz}w<hF?Iub83=~&`D0~*
zC3r+ZAyN9I1*-*&ZX7W~z|KMleECE5ZNry$cMyd(^J>+^X^V1pLsf?n*)%pfc$JWM
zq<R`owglw<4&d(*kQ(airwBR-2ZylmW%xoQjR8(_TgMvT7Esnwtr%8553en;3mwj#
zek!?*8doL_!x!TeIguO{p;k)V1BG3il9)H6-FWY@dwW3;9`!1Jtu<@PmUE%++e<e+
z$XH7jAdB~Qc*ytWApi8?w*g6x2r+fupPsT<T)rjSdQ_sqqVAQMFdKNg!g)SY4wJjA
zQ*BgvTxMq7txbj72X{+4B>hFASWI6F8;;{%LZJKUldo6j2;#e84~kaEXPP{+M5gv~
z@$w$cjAJ<OC!{Q+y^p&8>U0&qzZXX@EWb;i_P>TQOk_u(l<13dG!T!m-VB5p%9>4k
zOoiEO&h7Lmp80Uu=Cd)?#8i8tJ}G?KShcY+@BwH%Sk8LmTB4Q>0{f!j$MOM&IY~+C
z7AAdHmGpe#O<)L9h%X&|Ci_}tYb&B}PG;szd59!o){;A2ci(^0S?$yvZ5}LyP?#!C
zO-)VjJmK8MD^J6G^llxEi^_20k+6{2fzBW)BNHcR?~!?++lgQ_l?s7E2{sb#nYPMy
zlJFmkj*iBXxaSH**=SmB?hWJ;<VuEjoeNOQIoR8yx;V8ZHr30ny{5L-7ET#SBw$>6
zdSSV2Z)RIHCtxp>I{#9q@F~ms7e@j?%-gXuEG6YKRNUQeVbD}p-FbW}>vEquD=TZp
z$?#Qw$$M@wyR_DYydb2Ou25A(;_C0>hQjo(exCSEdFiR~zd|Lv0Uv^uFoyX4*5lR(
zNXMleXD~P|eeB^u+jtGl1ZGGIGFi9^hS-R7bH`V8(%lLbLm(QUb&&U9+>7lfPv<gi
zcq6F#+fc?{J02H-J$pWtmRjUHQ)0(q&I{m<fgdFfB#~GOm&?t{A(jY*8%f6AjQbo)
zDyNWo{2U}!rI<K{Tu+V~94wY6aED`Wd{11^Ggr5-=i-^%{D_6ObTLO1uSDZ3o3)KW
zEO+pom7I@y>j9Cg%(q!gcY~yzZrR8#HHuCJIqK6>si6Ioh=wWkY%aU+1?9+F4+%=w
zTD|8ADf+TP>meW*6e&(l3veXFo@;$`@h0)|l;ub6Q%c%CU%Se3Xg^=vIn$S=-;WOO
zxVTKO^NQP~5Bs88RWC|K#Nol?yzFcHM!H^2xPEX!dF%Ye{Or*m87%?rmcwF7R$r4p
zd@Aq#tAK`*F)ifTTm-Qyd$q2Pw(>S_3-s-0W@lL#{fPkpQMlljFIu$9te`zZN(*@V
zgV0CZCuprc1|8dMZSX4&@}Iu~J9HkR9pX9!$q_}^p~Pu~d?JhD9|G?t@&HB>-n95F
z0_tZwi#-Tw(x0D~sIUKvB+y<EL3Te-*nH^s`^skNe|*RWp1sBFIpQ#wCFmhvN(fVX
zbeLqzCY%qzIyKmM35tM{!&u@F*Js#Iyi98TuW|ZRFh<OET@J7`FjPjv2d@FFb>QrV
zhK3-aCK3LgH(gypA_bTA1UBB-sR2i#M}M$b*C|AdRE8G;{y{+HwT64-tx5O*)nopp
zl@bjPKP<<}k*=cm@8L`UmRaV@m*(hF5$-W80EJ+5d>kEN9CUiuzUv)0;5vaYKruv1
zPJs4MinO?^a8xNfYqq15>MHf;X-+tk!QKovtb}tkzUN9yN_^7|mII_j>&QKy503eK
zr8vTSSP1!EQ^=8c$n|Igc(Us1zC%?P{f7`HYgYA(i;MG}G&D9YIXrsx?X6WwV^AW(
zW5>#quc2k7sR{Xh%T`p}cawcEegGvYL)vY$kUN=N_20S0$jzaGgg*gDz*<w)08F_+
z%)(?ORqS7%&BEmR@5=GI53L-zru_9^YSRl(mugeou0UU3j-rwUz*<w|<F8_3UjO4w
zW!LR2%+Kk4|CT;j!j}7=`}+JN!eL>kJ|PrFYNHXdNOyRoq0)}oIXOnk=+G?T!r1+Y
zQyHvXN!xyoo+GNN=|m>{eXFoi{{~)uFJER99(wCy_}-0-xU*j{4LDA-!3A@;Ct9Wp
z5^^A_UUsQoOe@hFP@E89UN(+I{C`Sfxted~KJ<4_*)!jN%Xl+hcHs#-*z)9$SY*QD
zrBPA2U(J6wXb+U|ES@MNz>eB-^hJ($+eGpGx!WG7p~POY>8aBSt8z_j)b!$?y)b*u
zN268Va#;A~1U&olcTbQq^Aiu{pS#o15HN6%iJ`%O*@x-p<tIfSd2`Qc*V2Wlb5*0+
zy}23bcS~+v42g=V^=V13h}>y|Fgk)MTf6hDGuw92XIuMj6+Un#2N$A6K7Z{{TV>8U
zoz_lib-F6M&m1P>cTI2p1#&9!dQ)38u}7<lhcbh7=STMSYp%$08fSP)LEBtjaYLPO
z$fS5uggDZ2fE-8201ID<bHUR@O|1#S^%8g8Q!aL19bsb${)$`o|1e(2DWlaG1zk;h
zA>m!V%QEzB5AR9?`#_}!6vl8l@v(roh$<D<IfeAJOoE1>D)Ac7>`|#TE^5;yscC9*
zEx_dTSORgiyz-^xAK^w5%ceI9v$y``hv3H>1}lC*U`j`D<N)33)mj+-q3|CRCZJ-z
z_8pSD$kQuWWWYnSuQ`1LD6ucmW5H4sg3GyIzdCK;&+*`?(!fK=p-UX??d%>f?*p?i
zzx#FF?5XWj#I6V}afGH+3=NPBkLA;fZuz)o!nHKpuXJLh-3c^`sd{>{O)9R*nXRJp
zpH20*91nVhJ^Qc!ykKQD1b0@Lro4DhXiOHd9?cUc%7R2y4K9#KH|Jw4x2YdL-r3i;
z`-k?|UZ6a<gRi`5n~L7j!^>Ei@v#s5jF*Z(t<(Brx3n}XmCR0^BK-d_A~=5L%zkM8
zYUyk0>q{3fA*_)gmWl$71n{)cu+ORblDnCdczxQYYXMM&LbRmQ{4e0*ouQzt8f8%{
ztja&^wXIg%ua1qu6b!Tp;*;%f$vX1nOk%ELYIM77eN#)cZL<NDVb&W;qglxIPms2|
z6_=GA-LoNet!b*_<|_EU^t2pNR`&6HbxYK!MoL(CT!+?0;*Km6tqi6DDk`4t8v_Fa
zC8Dat56-Iu2*_Q5GD04$TUm2rhSzO)f~puAc49twIq7ZpsyI>e)+^|DgEewso_cRu
zV+E86z!anEDC0!>4rnpDZVG1-68vY6&YM$<7JZlQyJj;2B(95Q6T8&yaoH84q=}LD
zzm7lH#vWpw@o+p3HFuo#yKd=CWa*N@Em<y}%POY1#|F|+-Ay8eIk8F_{$rsrDOiIa
zOcZ8-@WB3uIW6E0C^CNh_yNIJ6%1b%AozxNB>H|1^X{IWQtgaj;+ZC)>j2^|9`y?p
zReONZpxU{gOPzczKz%mzvbSf}`}xIo{!H%m(>z#VY6IL_yMa&u<9m6g3t|dnwjM+-
z3a<P{P)pbiP=`xi?iDb2e;3bBq?jHfpUHvx&+p!m!0W(iPj7-AKCFmRWrfQ|qtK2W
z;guSV`#ZbKg24R-)H7TY<8wyYeypy@eCV7$4N6H)1-Jk#_3nmv%;skg@kA~*M5bJ-
znAtePD$lX7_Ulwyou4LiHqG>*L)enf+1^|lm|XZZoHyx~_hd0(ZeSyVNpK_msm~wZ
z*mPd2^XiGP^EhI=rqN(^5uF~*u%I1bW#!6#0S->m$<Jt4U7u0AW$9f%%$nm{xr0iS
zVv__VVOM@X-;Az6#*I2RnQFAeVJDL)g)qo-(VI88yrwNM)_C))wNvE4KI-gir}Iqh
zo%8Rpp&@ReuhBdsg>rDHz(<H`r{$2KirHNHPfw#;6sF)Jsqyck3TLDmV`5s2@vj><
zJZ+TZuC;=a$g-b$@daGM)OFFzR(xG0A|tR`l_;hTlJwB^j}YB7V-x)@qQ54hDgGtk
zOk@UvEE?gC%5BMCiv05;UuG$t|LLI@XRhQLp+ge!`%lxoA~HL>1xyPppM5IQD5xOj
zP1}!;6rhG7fx^exk@Wb!cf=*Y3xN@4l!zll+9cv9x!NODl$e%%#AyG%yF1R->j#k!
zh6y%vGq#P_U@3?(gUI&nVJM7nT;1DxU8gwtB-oCCdIjSD6mS`67zx3AV{%kN!U(YX
z78s>QwALih8k{?KHutcIR*OEIsVw2R;1>jj5fNo;VqrN<2<Kpbfw5NW>vMOK=77A|
z+_m&oCVFqI#B)B69(ArYN=GmQN1nU6YbOlABY#0DEiOI@mE!0E>b$OgbUHQ)a&j*7
zbiz+^v{s7jTUvc;>NDk%BhkC#Vq(1A;R6rkwOCwPS=n#S>cv}?5Q-LMNhDwALmk(=
zw#vg1;@Z#t*aVJI$X|^irAXQf^J7?X!3hDlke?XGLaetUdr42I6CaxiX2}fqIr81l
zLYI3GWgO@WPf~)Wx46n5rulc1uIU|c6^ts-Sm7gn@9Hsj)5VZmSPcyl3?+}365$zn
zN-<vt=&G0>$mkYKu8RP`Ub;U3Kt-O5e6r?(?5qZCG9(~2&lp2Hg+sN@95p*~#DnoR
zuz%%#Y*Q}J!$$&6au3$5%Fjs=idaK?ih8Xv4J@X19P31=?`Gl5{P+R0*{&gf-5a~D
zBb(z6zDRGsq20(=d3+{G$zSu@{B#f85^5=oKc7dCGG`S9oinEdn1SB{QOJt!mNMQ;
zIqJ0(#ckzjYSOFTJvNOqqTxuwI0;_eH8UJ_q7|l-O_#!?cKcO7;j;StRH{U~E3NR;
z?&iYPcU!%K>Xnw$vC@m}rA8^%F`Vl-+tS*~JClmU1NmmZcAuJ(v-factJD0bwtXOj
zUQMfUdGItLAg28Ev=u2D_-$2@pU<xL-3sXqGu$Odl{|cdMDv0hn0ZNh^UkEjL@;db
zWb`mFP#k^*8O4i;L4S*Ecw_7(Jq-<W!N6A<Pkem78QgBkJIQVOb1@JIP}}dI9`!E!
z%k`unHFzk=W@LZWz5B==z83ocs691`D@5K!0OoD7PFo8Ka&g@bYLN1k1~&i$#)%!1
zX<hfLzQm)rE~4-Cpg+ahP~&U<fd1nloO%ZlS*ov|_iAS8?H3Gac2S*!;}8=QNPGJF
z`aq+y;C_t(u^)d15-M+VA@#0HH0<o`Pd4-g>C-$94~JJV%sz}RI#m6@;s8o&4J3N8
z*}oBxJ=-ceKyLPpTiH3T_EjB{Xk>7N&<>P<@K0<3f<{VMECJ3~ub_+bxalnd2{twv
zcm4ngXggAp>bqUa6#6g-u_|W^z+CQ3I;3p}kU(>@{VthD{@3lJ6!t{OL<Q-MQ?~rc
zKIQ48yzJ~V>_^eaEu*4>m3#b(nmQqZWwZzrB;F{IrMmL(M8v$atfy^YztO{hfL(P3
zhJtj=!n?S*4sYG+{d1_RYoA`eGw9(wZXN&1L|b-+T$^Jt6?RBnYiX`j7%w$Zqwz?+
zSVH_{8j7RhD;LEv3J0OyJJ{a`z2QgsxZ~s~_(rUqpVG2Dx3#@J^wDwxDELAvXKvmP
z))1HyYu2n;Ny{hzB9{^@@8KjQM2)5iMIrp{V6BWGnRW5o3eGhMpr+LS4L(|MHN(zH
zm*$BU3`H+fy5;v~DB3=+qeMGRRO>M+i<2t>>Y<ynk~?npckUASo!V?j&Kb)Hf+IOJ
zFR~rccaY0$(s$km<sYLH-e~=5tIHf!qIL1s|GUhP<>GK(*C2W2$|Bk!ctG#MF2WoV
z>F|PEhrQXfOYyxRRvKknI^<JpDN)%!S7hpyaT@Qquy#J?Cq?5=|Dq@(v<oNx`HI6C
z(_U;YBlVj<G7Dv)^QgVI^wq+09*SB?yR*oJ|KlrMn9Ay*@kGC)T@eu%QWR-R>$g3p
z*s&9+Nh+WW<eq02JlfgF=#0`=<Ah4>EDu#%78foeF@mbdD4>9>-(t3bkm=&kfsW7>
zv@dq1_LCE-9!=BosVV=}1;_qT%sbo7|EEm(pV10eYyE$uUVOywE=FK6dv<Tt*3kj4
z2)=)EB1qP5VO>~Ab_;VNGg>sLrJ(e%HtP`*#GD}sgRV(y8j!|17vN8Aazeld=J7<e
zfYJZZuRuED&`?Y+^8@e0C=LF-CxBJ}48+bO*ww_L5g&lS5$ZeWbkV~&z&j{+e#T<o
zD-b%onD>=5H)lC5%mXRYO0ztTK#KjYdt<r_F!9cz7dMQcMFkX|R4MV8kbgAdD1#O2
zwgm?T#ajBWA8txjo?d`Sm(3t{PuBw46eSx%Tl>(}m1=?m(g(uoG&lm|PbgK@(&}q!
z6h`6xhTaBdNJOq2B98k=PfBiCz{sDB+mK5o!a=Fy7m+WY;CPk)kT17$FU0DfFc>28
z<;BZHzU1fppYtVE$X`_AL3w$3@AZE0xo_s*q<L|A)QFd)w%EzMkYk@(>||<u6l!Gt
z^g-`?@s$pz{Q+pSRHQM^+`HwzE@Y5F`|Xk#!_lKXBi(uF21_8F`OoF$FY3q$*@bPS
z3*DcXR#_9cb32@Vb~m0<SAU*8H(JWy6*nH>mpC)oY|Ycmc>rg}aPL_C7GpWEe4^!b
z9j+v|6Xsqq){&)r9}bn$E0|7APD<O4M^7j|=GTq?<<wQOv2hwuRmrih4!%PM%imjl
zeEsisN8~Nq9gpRygyrxCf|wH|B#3^m2mHiwzY`I&17E&8%RRB8*pJ?H{%H1i9_RSW
ztg>M7v59(J&F}=NES#_TiB<lthsT*jy@Int3AAug;yMzrohx{;51POTl!3*UoYJ=N
ziR<0?{Pn@7P{HqGW0J6sO0JXGN!ao(j>s*a3mw?b+PH<yl#@`r2!M1N9Be6dfPTxC
zJq6m0r_|KKn5j~;_@}l@&4atbOWJPcJA4Dip@kb4dz^RYAn1c@vg}=G2iL5@`e`8C
z4&u+oeqv*kvQM$xyguv`;n;1e9%1dqb{BjGNIYx@9v>xDL@ICYOT{b(jb}|!(cwUn
zfKiDr1|fSX(NKf4r%77?Bpu}+2Rc?bV&=6~R}=i#Qu>bz7>+*j-L!GzJ!@D2`ls83
zS*}~^b`%CH;h6D2C<di2Em*ND0eD4S9cg2@3{qO;^+sJC9cink6li$hy>$d*@S!c~
zPyc~Hl||7K{mg+s{Y>-@CIcgEmld>(iLlg%ST@`45*&Y#>d{_3S_X+yoON*v{oP`e
z*}c_KUM&%4BzEi|HTGZ`7~G`&Nj@r|hCan<xQhz~HwyBFTi;af7toW-{xxR$G+MMp
zj+QGx%OnP65x194Nm}|bPRQm0e~~$FRqqye_NwoT&yLZx`=H!SbRwPP$(Zb4Vu@^t
zPraY*mos^gmE|yd#I-PiN$^00$nRDthSo(I3Z17=r%L82E^?Zi(2K}0Zh@3jFi?8_
z=ee<6rt{%a1Q~&Od1{&k?_SG`tAa{5#h&8#ZmHS$fLFafg3~WGSFl2h6CIrZbvcAC
z<Z-_XtZKCn7NFoK=s^pw66&tRak`c9KTEZIJx?R&b5b}>A!JUO8(iPG6OR!1Ngey$
zWS_s9Ir+eq*n{gF`rpcEHK#siOnY;yE~#(^&Pf{|Sb5S%TTl2OuM?z}h~+>wbPEf4
zF0<p^3$}(t{hO(5aB3BSYW0e(nO@wGmNKoj?%VF)zZ*v<=kxe@8V(E9RJ@`VKpa0|
zFZUO5Qje1{-asJqO8wwpRJh0y^G}1xr_vg>xN|-VN_qZzA~Gl?B1viob@^*0K`+gv
zyG@lv>mooNxi3#4-<TV#;*8wOUY}ymh~Z(@jwqk!^cyk%%!WG?sI@YsDPj%ojx`O=
zfS9e(P*tQS(9MGy_goS9C5W#nl1F^a?o)e~Zmh||qY{uQEc^`3w^o?@@a5Ap@`z#_
zIXp6Ay>KNAC4-qvjh`klYsvk}Jwav0^pQTL!@~n)JUH<w9ESU@ntc@};C1b5*HZgL
z;Q*GH2HiKcPG@v1M<ZWR^)Igyyv1fJhq4n69T<;0O!RNuycsH6y15|=ilM+H)hR0*
zR`32zqwQYv<3E$uv1}C}kAKAyxV|$6_6z>1zQZo!aA#m0BY8Fu+`j(f!1~a=ee0wP
zoGHbk*wl`fBXsLz4_>#jVfhg!-n)PJ`UmN^EMi{28(azB8$UG*DL-0R_+MnAT%Wd5
z^`txu;S@?6<!K&nAoha&`FyK`#v{>XFTQ7+Sz~-1rn8+F?2!SAU|pH^Oc(1=LB?lm
zSE=zo+(htMdZ|4kL#?6M8WVG8qr_KyOR$1MoL$D>@o!}3-NF2?u{Aaxxt2oIB~mxh
ze8Y%i<^L{T8MUu!-%?o+A_6h}+?18aEx4d(y?KMff5nvMuaA|9qBC|aHnjisqbSH*
zhn8~VMq&;QGuyGSUST&qjKFXp7;);sSQh2edlVF#;uR0d9jB#t3yWK-M0lU_$<y2t
zZM*gj%s|U4_8}*<Kt-g`+b%%;)*>NC1mn_^`=~u>PzS=07WNWmpva+lUK~Q7Nc%lF
zSwLaoL*WEoe^!$&6S{3S_`RxB<vA@t;}5ko(7PpL&QhFS+^dVOpBpZ%lZ1M2sp*e<
zuy5bKq`l;ky6W&VOw@a9>R7ty{YUJ+JrEr{B1uMR%6>Plug;QbK_eJ-phdyh3`&9P
zfDIN?uolbjW_HWp&8#SaeK92G&Ghrwf$#IgsyWTf$^$dLyLZJLXHq!yF>W!iK&NY|
zqcX7V#t(Ph058<T1Zc5hE1O!o(t-|^l?I(l07au*i}T`a*-e%z4d&P2tMZ=D@4iiR
zybHnm?W(S;2C?{&FsCD?F7K;9o*=)c0MQi(>;WggLe)J=nbyVbp*uOR%4yKa0X3x7
znn1GW6v-3B&^cH@|LsFI5{`8{cIs60dPf+JB4=X?yLIfH)%j1w#TQ>6;ES*o4`OMC
zg;`7@=a-9ugyKnS|5*d_VNHi=2;Y%JZkz}vY<5czMVy4s>d5t>j~=nl{X}++Thl0W
zU^~lFcgSFR5pTtdqp-|GT~jcgxVg5s2&V)QgW5s}LUeFWhnE+;H1u#}2Epl~L8S&{
zv%PnVD*`d*`6aKR%w?9o{w9^JVUZ+sYYeu$e|o&$GZ<rG6a)O_9GW!ktSfPXXY;#1
z;2gT*Nn+AGOiY?j^68J+Xie$q(+n!kvf^lX96+*xBztH%^JQ5XWB?*r2LDNxyP7%U
zm3v{A%`Bjo4|IlQAN3*%SYcPP)U|n+U&VEGK8FZyX7i(mG9Z0o2JEiuZ5p><P480p
zsldNy$Gk>{hNfrn^!E_=!D*sa6Nl}&u!TLRqLTo_#K`ph6o&FENEe*+l3)(KgrX4}
zoZKl9OQm9)X$)(RS<b}T!84_d#Q*8Abj$x0Py7kGbb;N3JUevuY5Wxfn#D?9B8asy
z<MBleRSQ|O9|WJ7SRS!2V&~u?STA_~94v<K96wGx+9un~lpE=~7N-p_kuLm4jLcGV
z(*{sb7Y7T^GH0BnlsPQ6#{PQ0ND5&Vw~5HKbZPOLK6^UB=#}k(0Y6^^XkHbIOO!@L
z05PqgoMSAdZ#c6Fl4pf$PsJ`8oIc%%sW(6Zo`s;$>3>cN!jmE^IUm`2`pxz&PBuGt
z48&*St$z)M)vdCMkFdO<6_@&GFZJ=`VR9?S&%ODJ%2w32a>u@Lc=0M-;oH6Y*p;6|
z4Lk(b(>>+<A(nl1?WxxH4CBuE&7Mv%^`1F~?N*3)@-e))_)b%-JKc%aruu6i@M{tO
zLn6AP4M34w<uWU620={eT7VBI%6Dbq6K?I$5{@+G984<1`!#}RAw=tfiNG1f#+ek6
zdL<Fh6p)|5KQiT=h)vx?5a?zc=KE<12(@nAi>N5nipuZLzBaf$>X^NFA6rzFl<sHt
zfPM#=lNMJEGh3oqoNL)~-v`73`14M7y<4U1FCRbd8$e;SRt~N^RTF?A{{@>c*RY&r
zKizX`4T&B;5v;6E19iMOvF*}<AfDYpp(ick2*XJVF*YsbIdfij%Wd{xGDRH?szbF4
zLNm^oh^;(Jd+=Xq#>>5L$d4mc;2)sJwUUnbTFn(&TqzlklBUg4>y$*I;<J-}=EPw(
zNDL4=f=^NFRXjIv(x17h+I`gFoBBx?AI=Agw>uh$1<w13kJe=_*nXi}__KFV%i-&F
zBLpKYMI5ZMw~ucX6%!+Rv*gSAG*1rx$kJ9nOR8G7bC6MZZhaoB_BuxJ^B1#HmC<(9
z?Wc1x&P6x4TDeqqFI%xh;Zn^~*qo5&6nWKAef~z3UCXqGBO?_zH+gfF(w}Lu6N@87
z_peC1_F#Ve%g1x>GJ3bdy7ZTJUu;O0ON!?+v#p1Rg2d_#)>8TqCn~^C-I6FSm<^;k
zI;hE6creny=?hoxxwt!o1c8D=-bI(2_%GL;-(QpfETED4KVzHS{ukTqPnyRY=g)~!
zx1Wj2^*y2Ysa~|+{NZgJ94jkg6&`uAM0lm&UIz2X1L;;Yos6~*Ou}>cOg2{-Hm{PP
zG^`fUGLJlRNsVd8vy<GHrAQa97bYp6j`?7>)yaX0&Qa(kC-I^tE%P5oE}8y*(e|SD
zj7#su65Jg$%zA^4@m8+d9#mJS?r!pgRLZz2Rs9(bA`u!$u+9th_n$(hhxYn8#Cd?;
zHwByH?A)@sT6G>Ks-?>+qCaJPvdP*XdiCMPWG)CvMq{5pcl~c)s#K+obBm5at<&j$
zZP#A4l#b)dI3jmA;jvaRy;!t|w;Inz3AcQ~WD$;ea5g6%>3)3%nFBbWrUfy?`N1u^
zys3}aE-Za#S{EZ@EBi}<hIK1hujAl^oh$mG)%?$I>g@KExPId7U*|RfYT<G6Clm11
zc(<Wj$8--DGV;B}7abMS!5Q}fy1%{#rtM$m7UrmA+VbYh!u$xo0gaYemeXW%)Y<vK
z;9!~Rit42B^@ib`L9v>bzJ3c`x7z-VMwF+Q%zW?24N>j1=un;9Y)xs$@k$-g_j((X
z;mq35mSZvWt47Ou+qPjGEjlKeH{CcfVCRX$_p12%=+?0s(38T#LqC2@#3UnrIh~yQ
znbK2k`C4~{#~G<`vr-Jl#;d~@CUjY6o7+Wj6!-osmIFc7<@U2f)Lr41dghrK8_o?j
z=-b(`;vm=PSC%~{p>Z=myzan)*)BY^siwIsXgcd^!jCbboJlQ9cShIQ2|t$`O?2=f
zMzC}XI~0GL?Wagq<RQ-oj#WiP4xa*^B^lMdD!y+rQdMaE_5HC!hnV`ym#v(f`^MVy
z(z<I`>b}i=dE@FH!JS|3EQ9-VlzOOHZ%8qk$nfG9@xu?to9Yu5)&+^Pt`|D__NlM2
zkaTUO_L-Jso3Pt#72ehO^8C4sR)Th?ON)QeKG!+cI^MTF>#9?tMSXeRuP$K=iz;<D
zS(%{^d#NR6UNgG+{*2RjuT%<hyDByHPi2j<p!Q#blS7|Jy0j)H?yP6f>8<=$uy*VI
zJ8S2jHB@w`+DJ56nC?22HmF%be{5mi>($vT(1%=NV+U}|l)SBNeBt4)t}Gq9t|*)k
z9%`LCtsTA(28KNxbIX^ro;YrJZ>!Iih-X&?(FD_SvY6FG<nbMSI^N1F%|NFxJ9|gw
zedC@DbE?{P^dF^P2H%*7?d!Hl5}*c?#c6)bI`-uxt3*mcef=zsrz)!h#pgw<n49cj
znYx@S5Ka_kUi&ei89!KBVz2uv_<fT@MqPr_Tyk4ZR!^7X_lf#O>s)bVgUJ|;<|maU
zeWoMnd5$M0H$>hud+4x<XRPwDlWF}W)CPSC#sxmAo;4Cm!TwoU+WKF1&KbnUN&U=U
zwpCrjAC*rjSfcWz5$a1c75BW2a4c`$)a3AZ$ITm+m0zmZS!JHaTl%|hvbsK6Y!h_2
z&*|mH?T2WqE?*fQ1h-rW$C;X0Mf#+hRkwF>gxoOeO{I0Y+)^vFf9lLFYOlrbq^8Sc
z+7}h$rq_^IRO@9ZY9{=|F^)xa?Y(6`J8s_YkGi>H&V43kE-u(}vXjAvOY-WxqLkXN
zf}cOw)(Rb<XI;pievG-?FRbjsn!B3n&kq=PE6o}BkPOqmezod9jOl~$xQfUDJc3;;
zeRB#LJl+$pi>M+;W{0yBlYY4Kt4D50KcBjFa$Kf1@Hpd!@x<{IbMv(gW;Cz5I9zK4
zsq?1GKG(DwW?gS$b_=UaVZpg}<jb8LjOjo8m6`KS!rA8bY>T<i3zpvR%7)&?CaBnb
zz4zBqtFFr_nrh#@uXEJN>A2eHg-T0p{Xid}+6bl<4ecPC-EsA#x$d%G&FL~=7O72G
z9kbMklGfJ|s&(1SY#${|-TVGyk~jM%t7~>r+e4ncd^snv?AuIeQ;g_VQdmh}Z>8{7
z@zab{mnPDlvY84G$qP}7OjJj+skxupEooE{eT<~{In{UP#}@iePxhVOx-l`&ue!3W
zeLn4&G(*pqXrI+($sL1@c?t$9!9S1N%})2Q2C}rlj&Uc~XJJ;$V|QF7uNdxXkaeR7
zVN??VOZefi=jcR#grdDh&$x`$OSXzf8a}y#rYxii(<VB2a7~Pr>Z)kSRB;;w=`!vA
zbwM^cA@aHriWqj=&jmMU1D%ZYOn9QgrKY11=9K+ENZw?lXYCvr3Gy8ud-7!2!pK6T
zVnKlD_?k`GTQ-b;e|=6nL8t6=O7G_G>RlYFeoUME{Elq8bOT!{SO?yxcjUe1b+yy>
z_!u7xKBLpNa&A`U`HhYC-Jf(J{Fc5ln0Rxg=*Op<`37eOlTWZSM5?}6FhiZ^8SMMx
z%Z|g+o5VRevcrU863b|b05;+4;&~%t_|9#*lRd+I8(vGqs7b5u-1x+cQ}~-!-u%Sp
z8{cmNrf#~>Rg&92cRsB!;=ru7_|~DE>Fzzcx+4!*+B2_MIVl!TUTr@*<Fyd*?V+2j
z4pwU49ht!$lZS1rrbq4C+CpmfJlr25?P$<bE?xE7VJP*~nDt-;<Bj>T(10U4>!fNX
zBK-}n1%Jw*qm<a|YB@PHn}-#__T{MkeoT6N-A**+IvLIvwk91)b6*iry@`n_&Ezw)
zq>R-g1Vf+k51q6xgLfWbj9JUy&QA&py+V3G-`jiG;DTxIcK(EwzK1Do@1H7B(V`Vs
zm37X$WwI)#E-gv1{$+y9e(Sb8+mZ9LuSw)@RculF@?e+jUWrHS-qaRM-&rQ04XRj`
zbg@E{M3QUIl}Q|y9<44^h~8?xjwDM`O+Co<@dc-DRgO=5L!`0;-<gJqSly%kZTe<?
zCX7@ZHS?)=*utJgX+2+WSp6uWsp;m$i=ROyiMwPH`u#iGowZhasU(h0`lfgE6%`t&
zE0Xl5&(Tuy(^Aq&)iQ)^XTgZb*&n7>kI#m9xV4>*<&=;UAv`k@9*a_U=glzDcfesX
zu{PGHHgfa0?o=*&L?M%DZ?hGyOV+}ZP4)m#E8oLf*6s7Kc|N;)x4Zq+@U~4N4NqBV
zEPl8>ebzB)iLY1j<Q&bzhitSiGu(V_b(q>0y6bAPdZuJ>Cr>a`N(_jW9xnC&3^$Ve
zmD_rOD}NIgcS^HcG4?cc-nIGx-w_p3yApN_MVz=B#VV#k`dxX=;5Ru-wkKppr*bDB
z$~$WEd3sFu(I#=Jxgm@CNml9L(f(Ks=B=yibT4F9-Yz!l)ow=S6Ywwlk?yak!u*Rf
zu!4hB;TmYX5b6E!;&>g-N^D=4J7o4^L^zE*xsah!%Yl19_*b8*b;CmIh43{hqL~8X
zbdD@Y_Eaw|uf_1s(iJ#n2r~$JwrPE$zdTUarE)G-Fi5mo0>3BeI8n<rDLVduPpq}~
zZKv?K)j8aR>zCrXZLYYCme^k<eb8Q*{^2TfUg1}czAo!8vpCZ}_{Tui4Ei!$n9Y)p
zB==M)d=#^{c%49d;J^yuOzvbmA=vefR$})KS@#B|bO_VUIsPi42yqsNm(T4^9n^2a
zs;rERin)fahPMqBPM<!lZLH<P_uy8rwl%LFjY`N&k>TFC6M<#^ck3E8rh9Xyx(7lF
z>~}SkFOM?o9dT!q<<fi5sf}^1Vc6x9RkR))x`J{^2LvNP5#bezQ}mZVP#%}=U_Y3c
zeZBs}1M9htmFwnu4==N@SSNz(!%dTLK!~HI`Mxk-y`XU-RYqokWSbOF$h2ptdt(MJ
z*ioAq_fJA$<Y1CY=5A1$9RB_gI5_?NA>9iC-bk7C@gX=^V<vPV@Y<Mh?zFU4tf2Ou
zzv7ZjNTh;CoC#BX)nhIzC2rlKRoljuEPb=^o8c8cv7@AR5iAzjaD{UmTQ`{bp-xr#
z`>tRP_V-<RWh6^#=O$Jbh1e!WDrS3P>;{;xqJnr}00o@gwh<^huxoOiM}^^S*t4sv
zK^CBQDOW1`EF*KV`;%fXIuUHv_IR+-xo^+U=K>~`xh@9zEtxIDSWX`;bN-Z0?m$Kl
zd*<aIu?aFQgO%81<PT_jP3Mw5Iec~igTv##&$73QC62Hzh-uCVi%cr+%d~hvkAkrm
z(F^)4)*E6t($k5Xl`!nUp7Ka*N+I#n52IB6TG+ZUY3=PL-K0Es@trZ@W*F)tv|+>b
z<Hx)wW(Gdr%OPlw!bS9nC-EFuSg1A&*^lFV!UDSfsH6L+Q&U&6UJE0c_cIvHinjlX
zGx>ZTkf-wtCaN6?B12(oZb>%M6x8dQ;1rBKGBVZ0K7nOI)Fn#rf@`iJJ%9d|Xv&TX
zQFk+5NHsgGyS-%<t;=YCQ!2zV{D2RM<cs6eGzAI4cuOpsK!<s?XRhp<YDU+Utm7K~
ztXqVPO>IVxOoYqboR6$bpq04N$ped_$3oOA&R8{7Zl<|PMGCuaghPKG2W6==Cg~NF
z%E_%`l}rO-8GOk7hQ2gO%|iXlK*EBfy1o%7(M1k7(*M2~oL?>xUQu5!$zdof|6%n+
zb$@?LUo{sBsU2JA>UG>5XZk81FuNjp$}CK)9@&|2XIuYFmGWK!O1+>8zPlAIWu7J_
z9_G?Wodi6X{P?gi2xOQRV?yE%Fj6fJ-~~XUUu2msYUA-U***<#z$HLk)ULC0Z<QFo
zB0n$({Muu;`~XB`0&bo!N2`fua#uoL?%WOZa8VpNscb){81{rLq@G{4^m;gM8W|hk
z7_U4$@ZeU2raG?~|L)y#xL<4(Z)VXRDjXJ<k~(Y9x$=XoI(MJnapfk^$1BKq_An43
zc65Z#!^Z=vJzOG=SMkI=PJvY!;hY4sTR*;}_lNp;AnF_1yW)|$VnT#gmClJ1w^tC9
zh6|eP&&MBe3P1Ms4Ho$Gx4ODs<iADJyo8eDC+G071<DD(gWuIIC^zEI6pDvb4#pqQ
GbNwIRe087z

literal 0
HcmV?d00001

diff --git a/reference/html/images/getting-started-three-second.png b/reference/html/images/getting-started-three-second.png
new file mode 100644
index 0000000000000000000000000000000000000000..f04d2a1c7aa6182ef70ec0d55ef167706af70953
GIT binary patch
literal 41948
zcmcG$bySpX*Efuvz@-uj45*ZVgc8C~79g#3qXN?1QYv5&gOqfLbSmAb2tzjvjWTpf
zhs3vsQ7^sU`+3&-)_Pz6fQ17y$DHS}_x{x}ukOl-5gw;FPC!6FD1PU*909?BUIK#s
zACK;b|G~;eslqoV8xa*79dipu6TL?^1Y&w-dR7l?^mNZZbUbfhV`G72XSXnUU}j@$
zYQm;tZhDG?j|!ea%1}YY=GXrd?1QIqi1ZB_GVkU12R%eP>&ClsES~;&vVtjfVm^~1
z`nt%8Q9Y?ZakdW4hdDWo)ovBmmptWGv5i7QE?Z^hO+{QvuWfBt*m#R5+&r#KejdHU
z`0WMe$HCk8uIJOGkiAywCFPJ$QF?RR>}_y@A?2H3^*bvu@m!uv0hj4dlN8=ojIG1$
zva!7nI)1^eyq7Aa&@P*qH#qWHk+yXcL-mWDVN2Q|PO{|J9wKv9aUaG6&rXjW_F#@y
z=B(PO$u>OwP9*o(3)yGAS;<tM4MwL==w_-bsgdyeQ!hPRX8G~*J>9lP18K+iHOnJ{
z*DN{Mnp;ELOohq%%r(laC-o|F3R_otn9KsXOBXiSJ!0s3$Spmtk{`A&dwLCJdBjmn
zYT?!S2KxgE4C~oLSd1?>b&mGZR?+H*V?hQ>=<1Kc7f_cRZ!P3pAni~wR%<5dmuAr6
zxWi&*c>-xO!CLh`YUb28;_(P9Q=4!0tzJvTBdGD>%&35(_i{PBmHRF(yIa;`xXiiE
zD&OpR(fUuQiL)BxRCSd1B_ZR101tnaTWcgpa&bnPV!=B<dJa0@<Tudt&1x$VIy-ww
z>{9#(y78u=PNKsP=}S3SjHSLtC+S)&8B#teR}*hb71eY9WRok&%TJh<;Azr6VUzn!
z>RQ|BE<5U~Atd>L1-1Qtw&A2PH=3SamGm=bB}QEjt@UKak=wr0I=eP()_)=b&9wCO
zu;e%9`m0u&7B2gV1N*)UoIRdrA;54f_PAW*L&HXW)$f#xY5qfe_eo3%2%Zp#-@c*X
z&^uFhLWLAl_P$xulknMbE2H@8*cb)5Q3v+8E3M2AFDbAl=JDhUQgA1z@%hF^x6AXT
zQ0r_5qAA#i?1vLXt4@#ws*oN$b*1~d0L3=B`IC#vm5TedKF(trFtu~#Cn-mY9f$OV
zg`Bcfoif6PHfOo#eK_44<zW{S5KNpmIf~oQ1lPyg7Q{$9>6uhZ!+$(hP`xFQ#~8(V
zPu!hN&^b!L`Y6SzN6j@<BBHkBh>#4y`<!o-t+f+URC$%0+W5`{b4|2WVrn^G#GZPv
z>eFyfS7EJfp~B2HiEfmDT~f<!dz;@uMXWJ6iV^>Wniv0gLUu$5tGP+Tm|kt#dc!_}
z^mk)*O@YbrH$te(+5Gtq`X0^E*F{}?*J7!q#<Vy-G~ZBDvp$p4oT**mIzL#Jn#vrM
zMmfc6_%Snc_Ui8i1g*^Kwk~u@`L7R|NJvRZ$;gyDEX3)GtE!%>>m;;|<hrknu?xG^
z@{+?zbnMdAx=p+62?yiEn!$+z;q|ZX9v%m4PxF}ty7T<6PcE3YV~xqw44}8_f8+1(
z9}(egWqS+3NZ8$(r#bcy*Tsfte?Bjt?DD9~$iZ+XtM5ZY{v<tRPWH~urBu0^6|RWU
zspm);iuY;8B@Gu0ZifoeT9cg9bKzIDi6r?ne&@h*VpY1&w?moyb<e+RS?F@wo)F`7
zTg~B+I~Zf!Gwn3wWZ08UbGD*@uJO)+>F!QLA1BJZmK5EEVCCxam9FUt-l@vy*5d)6
z>Rg*93cs<iOdp`6jF@-U_qeek>$;fQsLadTExfz+M0<CWk(gTd(r6%~-&HfThKmhV
zv}LA(yyW-q7J*DmoYw5fK~FndQc^<}r7eS&So7tnPM!7d<U3g5H+NnY=jJZ^Tz2{9
zIsSOrf`a3taaVdQr@oy^VQ%e4()3iJXv@u;&s;a^Y4V46N)$Jz;*f)CPS@+LNgbz5
ztQGjB?#^ylcgbo_-rLN`lwo{V`~=0Wdey!m^qZZXopKiSm9zKs+8o!vKa^`*9W1jo
zFF*G-1IsY|4*PuunVG0@uXU1Uhoew7W^iRCEQ4Ng!a;p{JuORSbG6{b)+qZABV%@r
z61(N0U6+M<H=2aY#ZGI@LPCS`i9WS8-P@xfG5sa>Q&_)((yhf%w4bo4RSNx5bI!Db
zSZ$nWi<-;s0JDqjJ%o9NVC-m-7s@`LFBQR%yt>7g#<V%ns@>MMQ(`_e7%-x%ppUVv
zJsGAawDo<!u)R7<V?)Q9h%T$9217S{xz*BrGvN9#^3<szTU%Sl$%Iz9ix){r^FH>K
zWCaFdCt8OB!eqAJ&@DH+QL}MZED$!kZG_C%XDY13pQ3%fgK=Y3HkNRoihKS%T{=RE
z=-hC7PEw#$dVrhJ2LJq)1fR*ul9MYMmA7eV`d-OFC8WjDF^Vte7V3w!6^c9T>{t`Z
zIR2br%T%SZ^4cqR_w7v03U0nbo-btmU)>aqKP1T-=C+L1q*bIAsBzd{xf|8g!%M%c
z{@U@@RsEf<u<ajfvzX>>@`_OX(jik))sCa#J8ophvW+p_Y<h7&J`pE6K7L$tV<yXO
zJCIRU$mLBr*CTVRxb4DlPaS!}bQmXNYK7|T6XS-yj7)4s;gOCe#o59z$<#B9JKvjk
z1sZyalCtJMu1ve71Q`>r`MFUoZqHZDjCP_21{Cuz3GaG*>8eTy`LZ!!KO|St`7G*P
z-joA=+wjP=j@G*+$D0MV$BHr=T{a3cc#D0WHBf>fr0Uid<r3Pd(0xK9RN763G&45-
zG3b=mxy!bJaoc`n!z>o4?d;EtetFfSzzm_hBzl;eW!gPEn}km*XeReI8k4?JG$MBM
z^E?Ynv)-dQ7pyOz#D=-+QguN&_j;i0YE4H>K(;*3cXwjfq(`qlseOB(c@ypJ9jNO@
zD;_sybizi1w(*X;5{*z;dX>YMvgIW5QThs@9?9)Fdw&Lf#@U37G_0JM^egRcqjFb?
zvlE3;Q3GzfYv!q`O|@T!$Ho>bcGoHjJTDs^Y+SbqU)@p67m>;=-AZqGdR4X#wWPY)
z7Fx#5&>0uk?oH;R{Rk`Ox6`Kkk$Y@b3A51Edw?e_t=Ez>Orh;jmX_d`xAa5>=5A*Z
z+wC(m+tNe@Wn}}=f*%$KuxP9<@0a?ud2MzYy#p(|M`920iy3z=*oDUSE{&T+#<dml
z=6cRXL=16}<w@nXSXN@<#dj~uyD#oqUcLW<$dqei7jgO_Ux!xl@{u<ag*RNz`OUl9
zKik<b4|}D1T0v42wWTe=*43po(bGQp@hPE1Q7-5GC(40HwsYsL-}n@K+Povi##Sa1
z^;nkGKRyg;8yQZ&Y3%vJ)(U|UcKbRzu=d$g@QoB3gRKTXT+aMLl~F&pE!mALtFwLl
zTsGM=k~^E2g9%%03GP>8#ZV?!H&|yA$eM&<Ee#iBWKc(lcPfG$w$|mZFj^z2sf9#L
zzr7GX`9{-(GOC1|Ja=ra0_}4ylP$m~V3u`GQfIX*S|Rw1$3w5HiM{(U(FN+7Xmw-a
z<ft_1>PB6;fl^0}-iG=g-Lc%W-*$G^w3WySX?C9FCc18oUE4JrZ*ntUXlnIhS2BEY
zELG60X*0!Xu78M4=|icD^-@HU2rC(@%@&OoCTmxG4865=rVg!`M%EO%fUvedur;N;
zWNg%=?!c1d3Kx--#Wh~($JSD%oR~2Akb_QBt|4}`F_`6ru7AUgsW{b~XW<<SvclVa
zzPyJ+wo|T6)Euspe0_^+gV*6Z0k`Bb<~Z>*vpzc5TC&V(+N}SMNf^pF2|557k}V7N
zc+Z8}e@>norj`Ffv-1zDXN-&8_3Gh?d+k3se_cIGiPFs}I&0+4wD#`p42IF{+*!5+
zj&ryxw!%(Hni0gBkuHGA##MS?VCq4oi<6U+Z>1`3K71Hy_c3pLw#(OoWo}=dbzW^@
zm{cnCt*>7{nmbp@7r!a&?9zI#TeuQ&{3O+e`EGs<udG_Wb?zKvTJFlh&S+tM_cJOF
z9>{m>1{*2uOf;L1k>#o6wk)_gl)*^j*?oCiJ}TmJ>7|5PEB6TEpjRqx57kN?@~yVw
zFU#$okX1*IH$^30-mKSNWm48Sx11JKFVNkue)0SJrgUswnzry7x3Ozx)Y)F785?XU
zo;J&sm66({tFcW@f;7TAxv5i;)w`=k?0FVDtu2<^ifq~_%$;Kg5SW;2y=rLb!x^>P
z1v|3Wl~nkW`r=XQZ6Vb&rc_iP#A#^E7n=I}{iuaXFEt{O$V+o^rz~b2OKfTTy_~Mk
zYM3hZF9%9IymTx7@k(>~_Uwh>Q3;jY7wQ#Et(K$x6*r=DO~$*WscpJN&nP(UM0S#7
zr2WtxDlc$aw(#=XWk1n(EyU~RmB`Yz${m><u;1NTIlODV7BN)XnuyHYD!`Srk@)qG
z94ik=Rdwf>pM_{qAkHjtZtu>tSE%Uq<#Qk2W*()ymU$hWA&dU8I-5ZhQ}m^!P(=jS
zsq(ul9cQ~gbaizp6@_zLmYUYOG@H=aY3a-NWzky^c^mEPzUr;rAWv?%b<k(mUOhdt
z%Eho@u=-Px^|;4OQkM2^;Nravb14xt_x?;l^MZ#S>Mq2|{%MU~5w-CF7#MMKW;~tL
zW|B6gdi?0QrT&F{e3N+{*V-z)vN%P1g!oPFkOsp11N3n1iqofE+0Vp%vg}NhW~ta{
zbd#IwG^Ir-n;H3Q32o@gI&SpruKUq%UdyXFnb1FEy<7fG(9RgMQy+U{sL*cKKtx2%
zWajF&NPv2DG_~7i`!3@#`-NeePIW##1}kf8|97`~8sK*Ae19=9v}4DFG&@9|*4@{a
zkW?|G`!KX5SRUWK%ZrO;zgQ8`xQcB_p**i%wfnIln5Cr=8sj!xG`=Ytc6AK;lU&aG
z@5^W!bN`qmtHC=?hSs(kw2DEyH=3FT*_lp}=3U1sHLbQ<&c=$j9X@m@*<Q@hB;@gY
z$Yr^??Ka^nUC(eu<o;E_*`c+vQd%K4acpaMOSW`oWo1`ioAxWkk{yd^VdvVD-XbH%
z{*L&7rz*J<KX4^$BD<gd2yxvgVQ;1BD^!8WxIvYylHv4T@2O^D)}nhBzvGrYx}gIP
z;!Egw;*PCV-Sp}#v7X7!*0^wP3JQbKue;~EyTd@eK^L~!9^)#TWWAH*Hnp}C^I}?f
zTOz;~5Ww7A=7GZwWgCw?cB-NX2~{b1wyeH?-6!aT^raln5}LTHrJkR@*;Q~@QY^r2
zF=Kd`&Zd-Qs&KQSb}=X9f{>j_&d%)Y*y+khJPsk#k8X<I7PcOj3EWnK`7~nBTtegj
zKI@idBptmRTSYr`3Qjt@OMH$co{|v>Sc;UzuQ#6O#wLDQo;=gBOEQ<7gQd7}Ch$zV
zmEBy5MpDuT&Fs$sQ*EdjKM|COv$W9RzC}C+S?New3z}4xQjo#`gh<6w?8Af>s9*V<
zQI10)_1Hv)V4seBQ{yjh_3qLU?XH@82VoD+e#^g$R)24uJDh`^<+zbI-rU10f*p2c
zogFH%PgUK}d5bE*4MVN1bLWi<d!KUMU+<lxf3bG!g=_nWA>)pRlm1cOQ;#HO#sJQH
zq5>~ILAjGQaf*xg6_}_h$^~esIBY6cgb$@D6Jw7wT=0&f`wAfc6oL^*j@-c(%lG+?
ziTSHHbw`Zhq8F8v$V3ZF0phR;5dLPCk)?kO_uRM9wU>Y;?6aW?)qgE=QL4MuQfo%H
z75+Ykmhh~QuK&?94-#(!wK<Mp6d^zy89RsjFT1fz|J!fruZLcTC)=Yf<Vcz00T<V)
zfLIaz%R-ResNI#d`I<LN*(3BHK35`*GG_!{Nl@5Kew#l1FP}<vn&izIEC2qUD2zq?
z!1JshQs;jYxnggWaB4b}bfcV>+s<|q5VT&(?bT?-U8W0P6ILF(5mR?X+qB)LCoEq6
zZaeocFY45^(TMT!@%i%Q3$f7peR7rOUnDLvSk^Z-iWK$wHof^jDPy`0V_z=HZM8?=
z>bw8z*XPyCDZ_8Z(R~PbDc(OfQ1aqY9%U5sPew}rFC$e&%j6p(DqOcWtGvneB1SLK
zQUCt4y1KfSbh~%*^vs4W2`{qJbct@zex5lO_O9mAbayRJ2G*+kf;tPD=G?h+wNcMC
z&A-suOVCN2W_cC*B_lQUc%#uZHTrw%ELnHliOvbJgvx~n^F>)(%{46LblxtM^ysZi
z{L&P2vMY#Vzyi1Sdb>LR7bX^FW^*etw<58^+Veqog6Nb^UwNhO;vyK{X_hMym#?Jd
ze;9GqS&1Woi^Uo_KGGjHuAlbGBIIaZu=J}a;dALs4~oCZbR~LcuI-EXaQ5VD<&Q0A
zq;3*k{~U{rC*e@scZ>L7;N1hq4ovV8I37AF_=&EAfbJx6P{?^FBI+ddpTCY%3J9K{
z4&c7UVsT&p{mJw|0qw89Ke+GCS)0<zuMY&TYwf!w%W;hR2EpmW2*!jbDaX$~J|F5q
zap&xH^u8LF`xD0)-X1>x05<;d(9|by8AA^~#Vw^P3)^hPfAiiwe_vl|Rn;)h(Wn?p
zZ1rq^&+#>Vn}MS?&rA0|r#=dQd-`y(KdQjfCg0yD{|(E#y+utp*mo>MMn=AW&mk)-
zYj3}Hj`LA`LV|5axc;L@&!0aB@K~UnrNv&pKD@ayU9q(&X#+AJ0Rf`m5yI`8C;3=&
zjN97Wz|_=~e3DFKBrqwZA75Ub5q!L?Qe>4tMcn~_w#bSeiQN49$sMj5{6h|^9zAyK
z)Z5&=JOr0POR?=V1tn$h;^)sdRY%}?#>Wfv>d6$5jlpRo<m8gy^kZBe^<!S1qP_i+
zQ6}<|Hu2G;cVuOi>vbMJWRQ(cZ=YP9AIh4q%Qk2X=ax^D^3OVnKrWBe21+>IxN*b6
z;(a#7eEE;e1*4khHDs)+*<VJKrtR;^$u0I8X8{*`?C8j<^8Twgd->hEBPY*VY%Uv)
zmQktQAtxmzeRCVPT!I$MTe;?94vQn=c6Rw$S@Y#CKY{{cV`F=A^u1FDOC7D3Ct6c&
z!dWnDUoYHx?&0aFS!nS#GqdSBT2MehPEIa0HMJ{Cdwy(8Nlh&^$jQkmM%YbDsq$m6
zp1+@;?4w7IOifKqOw!NhSbhBG>{(v(L4l3U4E2I)6vDWa0<L}VP1P3w>WL0KYKn9O
z9f#k3?&VtA_+sOvL*S_iC5wm?zjtM!h|1#o=)%InmoJYx(#A2pVX96EVx*^MYBS92
zkBxfv?3rHun^*n(NTf_C$F~}P+EjHhF|oAHt*xzm^P$WjZ=(nsJ=I*pc7{<GN5>)?
zM&F@A%UcygBO|)l&O6f5!8fm%m?Fp{LX3)viX=9IS(Ha~9z1x<hbZ9KKX8P4e^tu?
zD2eNz36MKdOr$h4H2?hbb$IyU66w>YPrd3TUa5(hDEiA-kB%Xs#Cx;#yrZHtB_zCt
zyEc_gUU+z<YnCW64dv+j@gZP*WG$9wX37+wArI+nnY8Imd+@Et(y;E+ryH!w#Wf8L
zTuInQUjlhjj^*o6G_N_HpdzGG;KiJret39zz(%UBu5OID=A9(OjpWaacI8pd99V%(
z7#uiM$31LRw9{kRS;X3EDcOW#!JydH^QF|$!8zECjSUIhW7^t7U%uQ<5MW`cAL+3?
zLHkhw>ir++1#~B4u?%v|*REl@x>g&)I9FCypoIwu33;J}x2J|@0OV0<N1A48B*ezv
z?@Ct{7Z)EL9Ssf+?#nmL$;pwI;q+Etn`~#~=2o0>!&dudW@b+1VH?{l9fco!J~(TP
zj&WVl4UQIc0$oZSlck-Nk+HqC)I56s<9aP~AcJ%ODcK?AOaw6zky71wL)aN=YPRFi
zAtBdnrxaFt7a0Ct==0DL#EslSx7{5X85u0vPrKZ?C>6Wu$JXlR`m)H%1tgeC!}df+
z2ZzF<B3}w_BdFz6^(?hK2^*!Pc3&z!ITvb2Am|;A)jsF4DJq{621>tP1SJuhQQy$u
zywa&WdiJ{G-1>7uN}m{hEd>R-M?+cK!m_f>8%yJ95w!UT5|WXbnVI?d3fpNVMKtTH
z>uXQ@H2!UDB_|K}4yZXVw~EE>c#z}D4e`RRZQ;NXA}S&0!s6o1wgkzYot?30b|Tz^
z6TG?QsG$ls;fohPS5{(+#-qJ`d=%Jj><P2@&O`tN=u5bn7_ar1&*OT->C;qH&J!(f
zAGwI^X116eEhzeT!>D_33#N;mT<`v%W7=w^rq<i?_7){2WuF*2<NB!MQH26e=(6|*
ztj?Nnm6P+<ty@3_(gX-Cwl`N;OGunLlJCt|?7F6<XNb!8^z>w>`cVtY35|`6KpTMW
zQe0Bf9D3!Ji$mP1o#AB)=yoacNyWi(oG?jnt)AeRJIY=~B8t~CPRx&*MLClM?si6*
z)u@DxP3~fW6*38xrJ6H#M0ow_=7J}=R;aMs&OnKMT3VXOJN>4}o)J4k^Tjw3??DGF
zp-m)iU_28~e(G`I=!8Q=QqW?^NTVSA`}p{gJdD=T^78WHqT2iWpUAbH-v;@ey>c_s
zp)QCCw%@H6M1qcs@g$<RZ+CAYMn9XSkexZh>A0vHB~t)9=k@D<RCSGwSp+lH3uMa9
z$HU#fdR6ZDz`%frCyju^{r(^!=>0A~W($JXs;a8w#&ep5a-2(Yuc>zDoAyDI@vYah
z{?dzU-s*^d{&^i8ZI+HbaQNiiot@<KVn-Qvty)Uv%hPs7&$|md=u#;rGUG<wKSt*t
ze3Y>1ADKN0J&=^U)Z*K-+N_u2&5?XdgJn*2+J4Hi0^Yov>+8CY9sw1DYWGTKF*CK0
zP)~K->#;kvfs96POPiaTR##RA3e02VPE$}YqgaeDjupH7ScPg3?iAo>6HQ}IU*^}X
zc?~15$D_CyDVZ<n6zKU*%&(3ttizI+*e@uEgwIu_!nG_SLfz0X#S=-5Z__Dm(_I-K
zbkO1LmVx(Xy&Mk>?0X)4|1>O|0AYSePF`Mwuqxk|{1tCqTz|jDDE3#oyoie6F_o*U
zudh!ijg9>nkMdRupSi}y#&+@I&B2lJ@iezJEt(UyTa(I+(IKqr46gGN6TA;Td(euZ
z49r8S;}~oOkVrK*?vbybPJ_iDzpZ{pMusN|%kU28=MgBSVJVWlMAQ*fR2_bxp~`V`
zaxP5@?{L#3Xe=1&AaD(K^9nSq^XETSRf!ZGr|00fd%QVX(AeDE+?hh<7FyeJloXh;
z3rwzjlb(nA`XK=Ui<kA$+-yp%!Y5&PtCrYh&?DLWJ0@+W$VZQ&BT*4P%(&N9$w0A?
z%Rw`3aPYUX6A%{G-Y~GR>yPI}o#U*&j_x#q4H7qS?AWo+&d#>UvBrpC@6U}<h-(HC
zF`a43(?fNJAE8C-=;(0gOX~Q4hOJG;u4N*JhGE~~$Iy)WvAM~>z`#78lbs#zWJiTK
z0<Srth1^+AL;Ebx^ekl*3>Ld?KQ=X;9glHiYfBM$q}vuRp7W^j^v|BzMTTx^X(44%
z5^&w>E>tr!%go4_4dc|Gnx5vodezz4xx<Mo!5gN#F(y+{NolV8!>uB_{#Yg#q3z{%
zz`0D`$B!Q$nZ`Hu#TC=Od?<US@ua==euq9CQR*wllO!7>l#-HSb^C)QR#aJ88EcIG
zKU?*&GYl$Lv%E-LW4oV+%(Udc`RLJDT2?u8W{QA^6ZG1;TZP_UUbin+xd;jhjyK0-
zMGtW^qCh@^$E+<Z?#86YDV@3f;K$nh{KyEG>(=^ceMlOTjiStEvhC@CBX!3wYn85l
zaz9cneeS#`F#DLGH5%9TZ!q5l1O)o~`$c^z@|@P@7z!kHT48KGKY6aLrRBaHS~)|F
z^z7N>_DN9`Rf^D84egYw{Lz-r@J@$@aC<%#Rlm^SbB^=NSG{+1L~>e+ih2lSlPTK(
z*}warx@-A;G~kB7@ST~4NIp(55=Jh%zw;(rY89iY{p8;1bBOrqR6fV@FF?)InJM6n
zqT#jp`u$raY>yB&&Be7fjKdV)9@0LDpS&$~NMPXGfN!8M$D^ItpcR!pdj3CQ<prMS
zeW#uP0LInjvpuZtFXn*wanTmHTVsDrIlQ1b`OiVz57*JHmVbVKGWQOPaN^&OG|TuC
zVmXli^U$VW?SbyO-{8E}^1kj<m=xEc_1-{>Go23qb2;j7<W}@ZuN5FNSc+wD9-uw(
zFKwtZ=ttcR2(YyqTl8=pV&%7g<?+0$4v_xSpIrnKSDrq+wA=02U|hYg&+<j2dv8<K
zuVq#w($P;h)Jqa04^ijRxT&nkMMRT}q4!21VwZAi^7}2Br^Dz)i3!dOga*D=p3G%p
z522fwj}P8sm%|kgL2(w!4af^DF(hsn^;k;KK={VJ5$w>G)-%kq9WOso*YUqc=FY}s
zTwqudnpI%p`!y!n?~y3~TWKSIz_4qy2_1o>M@-NNyD$&`12}|+yT`9NCLE5$E40=&
z1R0v=Hw#Anji?OTE9#C(DSrHkAg>p6S(=FvEaFGnvHkGZd*tC4m->&N93no=9{r0z
z&2u=Y5dS1((*Hc!yD|4ue>0($g|WK|3c5Nv@=8jN9ylt0Ykenng6uK?&B_<V<^yl|
znXk?cvCES>G5w-otqYGh%=!zX_;-gAK+i`kE-j^{r*mm}pngsB*Bl4;A<U(tN9{bu
zrW^opsi=e|B_)-V{D4|%YisKe2@4B*`}QpipV`hd3~-J@=qT(JTiLZD$FrBw!aE;s
zXtS3sw`J?qtL1B^DQCHEuV6B6dGn`gn^{l(TPqG|$>^d*axI4kJ6jv}^Me_gnL@Tx
z9RNmy7tb)t03XpAtqUHW&dbYF&eV8?LJ2v1k6pbO>?gE&N2)9??j~!I>vl0TzTK_n
z-CUEBLFc7LAn?B!;fqtJPhZ^6D8~=}rR{VVHxCc<sHdlAb`4ZzbF+E<8`jj3FcxJd
zHnumPn}vQf#L^n77OQ0IzFI&UTy9Hx`}PwWJq`|(qGViL9D`J7Y-v_X$}1nApyOpu
zYj3z4>g(m}#C*=4`U7ORu6U8?Rg!|jwY^NkuJqwO_jV^I`8nUjk=HuIUtTQ+KY8*5
z01QKk7WDEUCi(asfNHYQ0zJd7()sd=iu5ab=lcf+$XV5vVScO)IyDasY43hT4-RUX
z?rn2~Id`;xV?b2Y?DRC)kU|M`mo6Es&h*gJ(_b?mq!N6b%j`H-w=(d!=JkaK4<3-S
zX(Xqm$=7FTl`#h=v=rL=iX7frEvRr=s3H$uBc>68#W?S7uLb*k`}XbAr%wguLu45m
zz<7^lPLw>185|shb{%5MWibbYYcd9b(bj!nycz24BPvf#P0hr_Bv%e&>e{t}wl=xh
z&EYQC7;v*beE6WHrB(Mq{=_DCkBosqG8JWwih_cI$x!+B`U3Xia<<Zx<uk6UI@Ko=
z@vW-Q>lfL3$f(5lJZX>Y1?c0+-u^3^{!U_IXc#n9d{(!Q%gf6rEJpF$`~2us(ftVb
zf{KbtXk+AzqubYy`|R!QEhQX*%WE3mc*ETJg};iHUAsKJJLyi6_&9)zHwB3g*{=3V
zivV9_UEkPvb<h|ylxr9$2P<alq-$cG#uP?vZ8<wyW2*_>X9NCej1krz?7(2wX8V-S
zN#K@iQ`!S`<ifwm!-N))$AS*iz3Gv$F=pJdHIft+71i@iKIG&`ii;ZpAN#ykzE&2q
zvz)XzHX5S6Q^oH3mLxGDq35iBXlQcxIPj$K1l;1>Za=sR%bOIgp{JwMo$bx*T>&nW
zrjQA@ai&Obo1(yabw(A~_lg|-_S?yxoN@4KM_J&D+wz3Jr{f_d;yp-?Ba+vM1Bs_$
zdy^fLymKcxGn0(8uhcQ;(xm)5>$2L~TEHP`qrIBM)B?ObJW55^`$y#Oa*>@|T0qly
zKY66D-`Cp<nuiEeLvu6vB)KtHW|nyj*;L_ZMha{IJNYYDu1txI&J=oTrcn%JyZZKB
zvA5F*6>wbSpD(3F8=9A`yn*HXi6uRQ>KYqKQv|KYq+DEFL`9$b`T50RpG{!;i>xIj
zCCvwlx$S0D6iaZD2?<F<I5!IuQ%Y%RX?C_1kj`OGfFrJ(omlzDt20bW_CQ^FdwZLO
zcQu?9T(Z52L=JOtaXBwV3_0&?j8`m0%}<29@bna~sB>3k(<;40qxViN5qE|CifRnF
zI^nrGIu!WGdJ8Sz0S~d7Eu_c459xf`VE1RwGBryW-sS6{QGl;mY;{Rs8FaEzb;v(k
zX$(`s?Sub`T9g2<nrxL4S&wcyuYY^do+!NpnF?!bN^YYLkRUs8%`>ZfGu0q@(PDv+
zl4nBLzQ6zCfrmOe2}7DCc9Y~@9ik#4gwz7v0BZAxfzwGi*4y-d?mCIOB_%5QE=4g-
z>6O&9O|d_%SgNdkLA<exui1?XhQ3oLw2N)PaXp}Sl<qRz)VosxkC$uu`hLKEdju2X
z7o=xQNIycDGp_)9+B=p~pws^+tk{G5)cvR@sDdZJLZl;j2+wkSTxXD3OpU1AlMiu{
z0X)hl=(M`Ly1KKD^*hH7^#HOSt}I#>GHXF?{I8&7q8vH+p@23P`}Y*K-*-V2ok1%4
z=IxO^!Ux(m;)p02(7$6ix@r>{bn$H%XoUa$(NgPA8Ikv0{)JUYGr^7!#r}S~+{_7~
zJv>S<;qc>LKtS-$cERaQmx7u81fHq=duW>geA#67wDsLxW7%QrEb8|N`()+2eMNX2
zOE9sH35wT^I-z-Ph;!n#_1#kWudPDuy&XSM%fuWK3~#&Cq)OsxEu_IU8Ilc)tXMk>
zOPhYLZ#?9`bjlV>NzXzZ?Rb>p=bEd(^&RzaIa`r6_MOYC=1JA2XeO_%ar52pD!b=q
zE$papk|_S|J_U?3^@D$*mT_ww@t%_1^VQJFs+y-i+3}v-S|%?csOtLBuKz(u?O8sY
zuKSCP7m!jE(DuKQ72?zrj}Wq_N+&h5e()QQnIn3av#f9#$^Qw5IDP#8i9;-ZVI17T
zB7^qh+3$_>prSolnJ%O+pd}$C?dk3g3Jx~xaD>tR?9d4t<N#pg+QVP}xMB-Rm8TKH
zHWRO7Vzl-25*97{3oZHW1JZG8g}vvEf>E})g3+FjoEA3fNM0LqtH|L#gnM+tA#HL!
z!o0l5Vc{WOLTOo0iUl@INB8C5iI2i`blesd1-`vJH=xcuGCC^$w)DdWKMtjA`jMyk
zoW1h!rvlscoCxt4<kEzGUHQWbii+Y<H{1_{Im51&I{|D&PUXL-uPqaofc<J-Q)Nj|
zlagux{ni#au(SOmIJh7$FIcN9LmkuIZIEe<O&lH`j(?Vuvji$Lu)y_mxVI3CZLI8{
zJqm(vj(#)QLYd>z*hK3)MFcVYBO(I9HotqSE|}%O{{0jb6!FeI*?OD$XhIu}NPbSv
zocw$qXya6B_q42~C(nRHkm$5B)#>Hs1=2T-u&c)Ls(8>^ekrfc^-i;>lQM>q+~(%<
zOXJPLj*GWhgVul>m6w+Tuxp=Ct4N8Aq=LB%7@@eh_yjrIZ4r?LPJ^pizjo+8s3DGx
z_tf_+7R)UzM|I@n0^+cM<ASdZf08Kb&WVWV111;Iu>ie<X&$E&cs_f!-#1YKFlR!O
zFXgr66VUVNJwb%6LxXBmg9h>38UbpBzinXaOK)%QmoGUmc{k*(&VK_%^nFvTKNuOm
zq*=3j5($ZkUIwW&RW76mSxL#9D;KX^`5^wU=Gv+Ouhq0C2!Q1nml@&i?!I}?kb{%6
zT|<n)))};dDfIgK`jaOFJz9E*{Ra*-+M4zUrGH<ZY)`QG_SqA-+pzu~zW*r)4<2XI
zv#=B3<5O*20Fc1XUjpr)(k-C~nb{iTRo!E$8t=@-%Wo!!hLDL)EY>Iw*4;X{C*&IW
z&x4N3Lhc#C&u`Webo16NcdiLg)791M*`KC(y=6T5lR`SM#4Fst{}n$JMcmLRM4A>q
zH5nNX#O&aX+-vqGXRkwVZf=rI6pG4k-tqjK=09-)sX&hHc%}wFH5FC*z&!(l2`^F>
zYGGFs4c6asZ=3C}`8!tJWj@uBBH!BD+UDtO59vk}3dPOMy>&V?6*}=RRr=ZiYp7uo
zl9yu?!m0_NFEKM4egFCi<erC_utfQ(g6rr;?gYQ&?;v%8?Ae_pOJk_*m@RSdUTdl2
z61XnolaqXIJI*V|e8!Lxva&QhCZV_+qDz_={vMnjs1klYK3~|X8;hf<sE8TZfG>z?
z%(~xy!eDUbP1~cJH}?y>Gc5gSDB;ScWsmUwo<sPbCLSSOKRz-+m)}98dHgBWvUV<*
z_3?9L<18^;dy2(Q@cw0q9V7I){G02+Jotmn*|#pB$`DUI@|6l3J%5j-NUS7o888Qb
zj+Ror|6vZDIu+P5U!ph8mUoXFPyK9+5!cEQZ-F0Y&2KGKj#m<Q`|@|NB+mlVEqM6n
ztCaTK)Buw0YPNh~T>O|z63hg*FWbR9wz#45Cy!^9W?HdXzvq|o;_)Hz+8aNP&3+xG
z<NDKK@SE)>PpSOZ34ldp6**oL+`_zgETuroH=00?E_LtwHuL9&8Bjy7n2QxIyr@LS
z5cA*Xmsy<o^4;+)U#<ige!u)g2hR0P-J;pT%3>HuxQh~tMSS!Xrjm)yEtHPo-xI%|
zpp07+-Ga~H9tNKp_w_oOfB%2bWQP}@Dj)wPdB{lY`}0j4_|vAuyP7cl_T&7)bZvAI
z;+NORa1?isaj$|KAp2-VeY#8R&Fjng_gJtrl{?w5!E{Os_e<B&>hkCnQoPUrU|-X=
zKQbK8Des#i2Z?YnX5gPc$7#V)YvSosFHo;ug$X!j%Ov$xxa~gKcR(gaC<7Nh%}lls
z5%H8W#g7$BTU!JK-$B%s<{?EO1TBYer<~c7lQV-NjNALGn1Q2SxNxEEWlYS_8&-9I
zRiS@&y%ZGQdc(=W6jPTwLF)rW-`Lm~)W)*XQt%*sBNo4ZzauW5lA5aaOYJp0VI%M#
zOpy!Ogxdk1_7o|V9F(_K8V$FNGXPczM=;HT$Vo`fUV{~8xGpa(^_9CgLCA$fgZZU5
z%P7c(6TEwZ$eE*HS>10$mg_fDOWJ6Zv6X_?RcGE`_@F;%XJrW92MCa+nW&`1#Nxuj
zWM3diaadeI;cM@D2*wiH%GrLm$?53`U_zzMb#+FWDD;;v$uylg*s<Q+kr@XotE<RC
z(m%_d_4D;#N@Q{5o@vwpQbmlA3#iqA=C7IcPfSgvYVez7N?T)4M-CruisDx;cf#x3
zaeJGg1;Pa<c`se6fsu!o0~<RR{=n8i&I}6-WzZ*%AAjcV4t?y1oU+aCSpGYZm^^UM
zsm1aMQ7j-zkh~g03ySIJy$x{N2T9a2IAYREK1BOHw$j7z#r9VyZ2!PfcnG#1m6_NR
zve$^B$tSagXNGpZg@uGrTe?-P>+(5vnm*XG#!nvxQ3v*Z?5L<2r;-*8VVKKYr*>_{
zCS!eVn%Rke*&Tm^!@}cL%-iTQvg;KL=BUC7Ig6Rge-adNCWBjbO`6D&tKyvt?yF}`
zZ%UOcPuuhHH)(mD|78NkljO#D)7Y%bwAs5V*<20$lMe9oqX<|n797y?HM;R`$jCn)
zJ7PdgE<DUrwQhrV!--n*zbo_Mm;k<{34YpG2shEf|ENX8VdCk1e@S9YhyHD{a0P!U
zU^rhXQ10gdK8m9R?_Ck&b_dS`1OZ1Y{5<X#4&bgj{1NUe1Qo9LUBTnR7~Hy`@b|(C
z*RSDpxF@R(X<#0I{dyn7Y+>OF`ym%hb#-ETx>TL9k<mq3S{G;M$7^$l)29PMLXtXY
zt~~q_&TX716?Rek9KL3Qt$a6u_(JHpYtja0e~3t%CkRlnH{9{i?vm}rix*9HnhGtk
zTxtgrNr2YuA@#;@4+LAH9YKx;W4shZH1z^AUj)BW=K_$!*5$qeb7e(EP+qQ{KOg({
z?TuFB4<ii?4Zv@^yH(iP*+o*gr~WN_qohS4e*QiT#(t>WMdH<`9!u+tee%bDrZ{9I
zp012^0=iPzB?|})4EEbYWFR8Q*NJ!z^!KxY95S(zC>;^BxVUJQqICCetfqGQzz8#V
z8X~uEpPeogHU1cM^QWyBD0g4bF*rOtwSBU~4}h8%D(RPMF|h&$R`4dynqia4(sTnj
zWkkNPu&{66K0pN$Q6E2E*Fj(m2t(y?sSSMMBb_m;Aqvsl++2{8Q{uK;zMw2MRp_|_
zP;Yj2_RQ(iscC88T!NI9uEE3xa-%535xbr+d4iCPi<6jJ!(Qs;%mOv;{$lUK`}glv
za~_S3jNsxKr4ILmx-giCcFPmf<6~oR?V|atMalGZbphffBdIAUiXT>aq5WuBXd3el
zOELWvb9tXAT0(#n@*-f<5>fJ)fR`PI0r^HwOH&g;O3Ll<{XRK4x&Ihw0Zc26lZEsv
zhbH6x!-)njBYQs)5s}2JqAuJ%L>zgqCbT(03%Gq4_wxkrb$-jQAD@CK3p)>ZdM&h^
z+5q}5ILRIwiQO=upHrt!fvDCjxTc}2I})PpDlP>N#;Q;A{`ZuPp^k-<!4FV><9F}Y
zu;pIBzaw0xhw0D=DH4TR;@^)m8<4oU8GLHfjVPx`px!<v;Zsu<Hp=K0{<c83fgnzc
zB`|OO5aK=7UFr?wuf@!f^wg;bOZGt(6(G2sId^Uni)}BlpMU-Ob!n+U!Xpihe%SSq
zQBh!sh6V@gEtXW<a=nlLwC}*-NFf)s6r2Rdl$D%(_c9N-eC5!ODe$Igrt|?_@Ay;d
z>gp-^W&_35)uM{tm~>T6y*d&@3vjp@Wuq19PMkO~$|5&`577i72QN^54*I+$wO343
zA0;?={V3sDfh7)91?)YrB)w>PxVT0}MtG4(ughJXoseF+z|35?UNSZn`X%6S9&1-+
zB`rO@h>{fuM`mVb2?+^rvOYo~XXoUA8U^xR(o`YU)88&EBx;xvsYyt<oK|N70s<ng
znWLx$dsWc<cDMHK89`c`WfjT%KuMA_$tm(1rOq4K-9@mEOIz17i;xT-;y)!xM=2<!
zK@h`qsJu*-<@<6PXA9ipRFrvduDGK%=#2<cz|+s_DJ?A%1elm=;mIqX<L)_@Kq(Gu
zXlTeIO2@!ZcX7jhb9qwE5l=|2GDR^=hgJq0=Dut<-jubgeHE`0zDd6hP~iIYCpDSb
zhLBT9MWtaZFrA&Xag^80;u8}kq*qFyei_)6CSMamn+CL+?r}w@I(axWCdOP}AHu~h
z*1?n%6t~r(Nf;R$6P6oiqIh}<foL!vIdD@+=}mc6HO%GCpujrm%<GnxAIi#HZr;2J
z^{=CY#d)A7N}xPG^(=s0=Bv)vXT5i!7V<s&PQ?l?F>`U*RC$s5(FiLEJ@@nkFvP;h
zC`R&qxXOF+LwWfQo`F0}UUdD<Kn@RaE05b({1`aFUV6VJg`V)Z^;p9(Vq$XZ#`^jQ
zq-|<>)ha%L^5ro;fdV&mtXHA7u@O{gkQsdxYHDh}FD$e|(wPQYul<~c;TAM%C}r-h
z1)`pR5=qAN@v%756U5U`VLSlYeNg$FkC*q78MD^e-{sH5XEzf{BILYo0iGo=<g&*r
zr`@IQ+~L@Pn{8gYQ2p8S1R*jn{>H|o(^P+EMO?f!^NfNE0Toj6S?Q{&g^NaPzFdT?
z*HCS(;nw;>eF(d`+)t3f9i85G?~jcRGRk7z#oM||OG~eWp}+4TwY_rw!=?(9!%s_G
zhz?R1YX3QG3GSbQFb4!Cp28A@oE@g~oyQu^t(es}J>MCKnZ0gd@%`<s7k7B}cEnfn
zm-K0F6{1|N&CPIXAe;5^J?hzqddN%~!4u+=l9Wgr105aOBEam>(d@r`ZI+tKdAu@(
z(RM5AjA(3Xn(Hf=hr|K0`Az;CRDloZB~eIQF9qmwfCdn|M}9gq1&?!p%Wixkc5O+?
z&(*PYZjBRxi+DKYC{D(SsD$<dv-0$55Jh#2jeq(#DIvEmxmCC<j?^Nf%szV@<8c!!
z3RN%bzqwKTd8#vwn<70m)eGF2n_vN4sXszYeH(@uS6VY{tRdGQrYkzq(!S0EXmk?H
z!!{8ut>}gPiQUd<zyQiv^In!ORaLc{y!`yKk-S$}SR^HUlnp;V*#|PQ($r9ylkzV6
z`fV|>dh&#lJqyRi+LYp*+XpZD1xWE!1et(7JyPQ@1zNcW1<s`FqoVFQFdL%`-cIfB
z;6|$ZPeVmS*0<^0^odb0$b6bnl-JIJTJs#Pqhf0hUaZ+l8A~y^XS97Hy|S`WB+q=P
zoK>v?;xt#jK7W4LJ?kI<+K6kiu<YqT++nhbOB9;Q%J$G8l9Mkb^xqHWvgyZnyDoiv
zw`<EP;^77rdHn<gbXFD@A4)uMW!MXS0$k`EQ`FGVxP99r)g7#xskpJJ!W-_;x2CkC
zG3c8JWr1~EQbp{PW$O@Z*J(^h^~yF-byanA)r_Ww#z_jpHz>&8O=o3L>4X~Rh$GCe
z?o9A5asD3q)~Q~8eh_&4=aoWc%h8i36>Kd4EU>m%1`>kt(FIp!{nL30<W3z+Rx)`S
z<TmlPh_*0<%aYntXsoTRBT7|7)Ix<^iqk8h)YvtPJ2Vg&<tdm(dB&J<6Ke<*P9a%_
zI{l(O7u+^alBaPba0s8-%djve#0HKjLcdb6+G|&Ng^SRwI*khn%@nCPANkND%`$IT
zgOC>9sSk?TR7T{YEne9%Ho0#NCJFcoHE)WGiaNWxD6#^wva+VORaI3tk<@3-yi<~I
zLIG_f;C}oDy*sH~V3j}fMit*yaB_L0J2bz6#s3ns8?)i~-4VOGEPW5_H-^JFumQ^l
zBF6}RyGs}pC2ZfM7}s8iqS@X97dH2GU?A-?r-fmWjZ2z$Hkw^mbCk6lMN&8+aTka|
zO=IryL3|D}S9eNtbBr-;Al`+CQ(zUtIrU{A8h6P-OKT9yVa2u-AMAM82D8D&);8F+
zF%PH?t6v2!`Vj*LBa`Pw*q+x7@aO__PlcNsBV*D677bone<V?2QW7yGPXic+Uu&6V
zec6<*U}9C)@w(3?GM1ISI92+G{GCZzH@QLYm46M5-R1+6X{%t~J!%NO@aVE>ozY7q
zAm6a|g}<bp><^HwVJJ{&&_Z1Vh_SuBU0^nlnuSeM$~b=VB*b+fLnI|B*>2DtiBhND
zwH|LGJa_fW`kW$6Pv|tgUVDiRvtu+a%l<E3h>iDW-g_rHJ6KktsvX8>{RmFu-guzd
zx*gGn>IzYO4Ur!laX?%D7lamNK@V62LSoHP{21np;HVOtj_u&(?{2K(wHNVh=Lu@$
zzo56Cp02x>HImxPb~dLox*sj1G`O!~iMvt!b7wX&_B%DTR=AEEL%Jt>gd2}6$UHq_
zQcZ0cVU?`>`ctjd^XQ>dI4uKD2A`BZBcm)T9Y!#`3`t|GKlj*G3?JwdXPO{!tV&Za
zBjT6c?Ax$fQx262jll;=aiifzpVboa3wT}m+gp|7pLdsiU;FK1G@1Y%UffH#0y=a&
zG&?f<B8t&Pz+~<LhUwgr(zG^zQ_HX47!=r>DF$zVC7yL_aV>p}jC?z8e;Z;VVAv4E
z3a<BAqkl+o^CEzQ;n-F#-<G1x-aLWZ@rw_Fta9l8y2OLD)&inqHr}LUkeZxav&ZFp
z-ae4H@H51+4^KvM!^fNuVnQoBKj!W8ai%k9hCh=sHdL|g9QQvyX-|@6nTIyQ;-zu#
z-i3LbvyYc&l$9~~p09&oXJT@k&BF)?3WC%^c3I_n6}k4MQJh+X`jZ7F2a%JJ)m=1f
z!N&|3Y)kQB!}5u_xpITnI2cX_HgqgSj~c_7<P+~i{GD7>RsY*NXv~PV#8gWIJrh5q
zudn|~N=b=q16c2UPh`{Hq)d2=#k=trQ>HOl_SV)ctgPHEmZ$n55H<*q9mJ2}FN<0g
zqX4aS_4Ofq26I}L>Dck(;et;2g)1OS!&ESpLqjgK$_AGeNc(_K78=7U0rv-ng{i8m
z12JRC&MeIP#AKQ>HaqLGv*oBt@7u}QljkbW$Hxb%v6Zge?=h4};wpwq676H@u*A*6
zFy&r-2+p~>x;{+aM7mCQv8F^uM5HMcT8(-+U%q^q%Ru;NbnxXf$wR*pF<_sB@72DP
zo1PSiS_v~i&P>3ELl(hEfFq^ZW>!m`xE0)xhv<TxrDc)x##Q;_6|^{E7bnGxAv4{4
z9q!zz>CH1<u@&Iv?u6iV#$9D)#-YZBhM+Y(U458Yr$-H#S;7T8d~Yqv>2(Oj10n59
z6C>e51_Z-_@hsP(;r8l1oonS?E$$^P<zKye1)C-W<`KD8vCS(c&!JPexF_s6hs4sw
zl@-z|g+YBiy~$|@DJdVd#{M3hXOQshaT`csDy2LZF1#%+R-3U~8f&am#2nT~!z_=m
zwd*gWB}CA`TzZO1>ukt~F3Q0kmS%z(bjKZN3jkXwrY+PH{OOJB^-D%gk$e!|i2Dkn
z9pqO#F$+R2n}GMd@<HEh1><YIcR@Um0r0kDgGy06KQHh4q;gUjg!LhUDzB{_<M00s
zi+#7Ai3{!H0J7Lgr<v{#3|WYf!+0NDNmaE-2Te4(-z*SeIN|Vzogl5VB4w8`1S2IW
z?%lhD6B~12n^PeWAf|-Mtt0mBX|d8cEfzTY7oVydQGfUH(@#M~!MAdGNG>}3r&Z9I
zAu{y0zh16>_wIRyjBQ=gd*2cyLx`w&?-Ct`Y-PHDYL$lAm<?2>OZWQ+K*gs56+4V5
z()6>9w-c!$gZ-fLFl6Di${veHz-;+_4V99y1X24Ac;YNXphSCC!msbYB`kBj|3uX|
z3F~QQfU<~)2ty2N@v=>g$W=14JLF|gl1N|d{29U;w?ByQ)caZ%=HjrM%^@b^Z!z<m
z5d48!fIR)bH<P^G(!GLbh~B3EepJbDk7bVsJ&(J3S{_77D`1MSYMqfh{bb`DPIASO
zd@02VUZh$0wIOHgh2g3R-o2=CooytZZqd=*mI7JCt|j&c$ezX~CJLR_|EWOlomScK
zTGj6IfphF#zsWp3J@8b(*BdOM5OC&o+02#Oh3vwn8zC2t%U{wwc<^9+Qc{F*PR6w_
z4pEKVihn2s=7yZ??9C$&p4ZL>EQW@Lf=&%-1qi5w1O=6@_8Lb=M?=;ILTc;7-t0j}
zo60_+)0wHM5_Nh@FlO=5rvq5&_Z$y5)8g$iI+Rt)9_NXkXw*D2rjPe)2nM45>SVT8
zPnG{x%Rbx^$p?+^QFAnFmjjd*+zU!|6F3<D?%lhIN1B=gP_2;X3bJw!d`E$t`}WO0
zAmE}z!S5K8wQ2t3a{+FsLtXjbp{O^ukc3I-wgb=Z1B%i-L~ib9|FZ_ZCjhJz;->>e
z)?%gFgOt;SMRQ>8iLBuoseeDXwt$;r)GTCrb-yeti&soTl<Hgz;+ol8J!8<3aYTv{
z-}!8_e;K7!N+3Ib(HQl;lr9$?6r^kNA?_9YP6)epmy-Hy4%UcUSXg+0Z*Q%k9hTU{
zpkVT+N_AB}B6+^bog;QkqYqalzQO66_>{jQ+vR5>rr99Pj8o{}mK`G#mC~e_wCRua
z)Ykwz2KIgNPXX^@NuB3GoQe>bf)NK5f$14&fXv*T^Ip8+x!rIeZ?Zkf+m%(L5a;&6
znc;1*mtb<j!Iv(L2-C6)6c|*RG?4M0vlonw)3K1uty`Pvc}G&G2FyCyHi!)@i<PKu
z4SW6O=)8ggWp?rpx1VueOw0_(M@5*tJ@oU!TuXpP*}#Nvlv{>yH>YgN7&_a(##>og
zWmjiJ5)u-&J%c#AscD8Y4$7DNZftI*HiZWVCuCtkr#0eUxtv|g)A#t+$*vw<dEhkg
z2_tLsLl~mGqS-ccc|LwNLS`E2Xv8&4RFQSt;fR+0mxdFCMP%V63^*)fkA%YSWzB-~
z!~fYZO+PFOad247^%ueW97f?Jh5T-4zz{5x)HB3=NDSUam8~d_cK9iLq&C7QV+aUn
zkO;7|<2=_*<RCtW<X;Lf226Gd?Xg~ycET%K`qt851N{_9h)&}JOx!-U{SGBQ1NLC>
zwgp`(w3>B*gJB=wp2{5myH$Ic_IMmRlbG`J{fM3z>$)u*+R%)T_VTj}q#uEfe4FsE
z=6cQW!=XcmhF?+;)4_+Ye1o$v&Mq#HA)xoAgOj<V|K_!e|2amcV{K=*y0$h{Y@1e&
z!X32HP~AIdbCs1<`duT>z&}`99!$_#I|YRfNHPLTj30v|20qHoBX;LX%>T2|+XgS=
zcEfPFWC$CA*CN)T;?9!$5#k`}_2<&Ewr9dAKO}{dr-d4S>JOhdk|Tfbw-eLQJaZfe
zL-(W-q+_-I8$bN%pOY?q_w44{Ahgre?8^pNJyc2+2MKU+*AwL?4adD8&<bhsvzt5#
zT-^MFmY?^PSkeg5>;O17Sk&eFq+7QiCyo*<!qL`3l|q>$<As<+{fP+Ukr$6;f?m=u
zN7>al1}xNCJ*y2mM0e8W#4l%J-hws+^H%GIm|)^m%w@*V5!TlnEvx`DeVeF2?n<l5
zsx)IKr{b@d+P?>vuT#pwN*@$3rFzm#U0G1s{hBtt<451D3G@PxD}malD&k&0Kl|fS
zVXKL&?n-z_{Y1%nVVxQ{1KJ7+AiU(4OziTbWW7~LK0*K?!%?e#{z0tz1TWrh*<AIg
zs1qOD|4SkUk9*I)!_Sg`gB49*ff4+h?!IEdzyGfQGLH59i|YUWsn3U~2=QPqvlBj1
z@C%Zsr`?|ab0(U9T2;H!Ki2lA<JD?LJl(1+m)5!fXc!6=PA%lme6RHScH!=yd3?X1
za1a3+mEq+6kM;F*)tp2~BI_9qCfGUych9QWdF)*f@>gy>8CwCL3N+dXLB96(cF;EM
zX1ZGmZMPb)4QZ4*T>0sO;*a|cUO{GZKm@s_=FaH$PYbuS0xaAKTM>~e`6co+5;C&q
z9v-+8U7+jsWLL$b&{b806kK2<Izqx1bb($3m<P3WcU<5UDxCWebol;J;{j+-BtJ7p
zT^HEdW#92*Z*F)s4ynRy^X%I*Vt@H@+U?nWr<R*h+JzQ3Y*qm#u(mJYk7>dH?Z=<f
ztVTxf={}(_O99Ke01Pp-Cjk|y8m@xkMj;-(N3fjy9UQ9J{2d&UveP$1fU}(F1}9J4
zs=?Fyb*wfDRd8~p*V2;)K6Yw&6!e*U7Afc1GI43#bJK+r+1}pu5a=Q7`lKrccW7}8
zhs(L8$(Xf^?B}Bw@7?ZiY?OX{r6;P$7Dfr|k(LD%eAdNGp~?)5A_nR3Wh~8Z;UQ!+
zjFRv)o`{GD<Hd);a6EC+5)Pn2z^K$_GC))eKNHMNOgeUpYd`1aa#7O8(^?ONUB3P6
zNjoe(Asa25)Xp>y(miPkDM*#!wtKl8tdh*VUC0FE<(ly6n#CNfoWW0dyU(B{s`lmq
zM1gMK-nNA_H3D9zp|LSaz|rdd{n%`SpJ@6m9!;Ar_F8TX{}oTwK?vhDmKqxu7x-AE
zpLmxG2~Ht+X)Pc}F|)AP&vd`lU@*((xO`cv&f3cAO9neGgPL$6a3D<m$R8`%4QDVH
zgCJsI(X4@HtIGj|a^~FoygZQTPRBGgH!G99QuJO&^7H@r@dL6_dEyB6OP7uk5p_9a
z*MXUI&7}M5^mHGD*G|!jLYFqMr~CZ#)C?%&Vj8NBFTH9%!y(e-<Yb7fl@u1%FoU$z
zpkY7O_31jAwP)3Ae?gIrI^=wC2k!RSlsXy+q$knQL!j84e))%4Pm$zFj$EZb5*~$0
z5}hH6TPsn*)N98C@AJ>yZGKg_mlOG&JrtAJp0#mUub`eHwfSONx36SDtY7<6)nCy?
zQ;04i*vP2oIc`W0^~!$y`_abQ(1NkoOLXFJ@<(l<>hB{tJb8!cV;Xh~Dj&;5FSZ5f
z41S9ImAl!l8Q5+`SB^oPlTp<5;ktm&-YM^vh1Id?z|njx(KLh32(Ej<XeTHt5tayB
zWoZ8O#~B7a+M@>@{wRo+g^K?dA(TDG`gbG+etJR%1q|suJv}|LH}-0xK4(AJ&ubkf
zfp!0J?guQo@q$+<`?D~;f1aZ^lSMSw)*d@?0**!6*xSck(GdlUq4*LUmE+>d1=$#U
zipP-khx50)5Ci5ZO0In)hL=GKyigzl4vet`b*@8M-uXEjagE<2Gak!c`u+3P#uDfu
z>YAD^fK@<CU>*gp4+4p3XeCvt5IM=xC_0TmxP1S5V^-u%ZhtXyr(SzUZm`Cv^v7HY
zAg%1HI1MzO1V26u0`J1%=$CSkD<^_8qyxpazP`Q^jxdQYTfv88LdXP8Ql}1#)hT*;
zdnbH{<CmNhchugny}7LVu#||x`?4V)9G4xN_o2KdBXJmi$Xzd`up~%XLE#dT?Ts)*
zX;gRdQVk)393ql4v$OEoeg{V1iQ@c*u&a7rT>Lf@Enxbku9|0;CMGgmz1oI%1Wq@A
ztC{EeXJ&K5bpNj?LWyKDP8I!Mj$Po^{r{Er-f=nZfBZNHS>X_&B&(!JqC~?8g%*{T
zXh^%XOXXNmDzr4HXliMfmQmf>yR_-nUP^oZp4WXx&iQ=5-+zARpYuTDzOVbb-mll|
zxnBP-+l5!+bX8|>>H~gTE34q(V8}_M)v}w5i=z`0tNdL#v`LVSBjB)EGlAlw81keN
z|83!UDsVNU&-(#pK<kivjLN>{G_5ldc2wDBq4AG~rC=f#kTtFddeGJD*Y7ksm6UrZ
zH_dY>ICzg3H1&*$7p0}&>euo9-^~=_g~b(vot-z5e4#x;WP*#iicoF;_wU2s9GR6W
zdVgsK_IZ!+Da70w1S=qs_AqtZCY7vPiV-|DB}Q~n(!?44e%o&ufYWUn8X9(cP8Qu4
zm_&%z;im^QOc(AO+#qm}l-gS~st~{T#nEi~Vk(}`(35)8A|o-;49*sfyvH)7a(aA`
zSDq22t_|9r{R%I=ysm4UQdfT^OQ;UM@1Z<QP51xTHqTLeh0%YR6nv%D7Ajn|{aTPL
zg5xMy)`}N!FeWhW^E0nDm$M03ge8;x4u>Y-8e7wOxW)vva6%rcqAEd#Vx<_uQ-5=#
z33yU+@wX$7DY_Cfp8vyW(3wibQX2ozc^I0uv7@_&?MFgFf}MvaHY%zy*}(5h*iG39
zB51;P^j1%F3hsa_%F0s{9RbeUBBkUHq~PTNlv9YhJUBk65z_8|#1ww<T+g3FL!pu{
z-V7AKswMoH<MaMZ7d_IZW^i3A3sD=A{E}2iZFZmy^dAn<`VgYgGmk_B*AluzQOi?N
ziT}|sv}OU%&y$iqpb%5)$ZRiQP|t_%0p1=ebgr!G;o~#W9U1FH$00S+{Px=2SyNIm
zmu`I90%h96<G2dq<&u&Tc-^6JsUB;GqAGv=eG2;-JiDYEVGkEBTtL#wshK1{125OY
z52C*(1kL+yOh-ejj*~v<5+KIEw13Ule!SiOFWJw$F6dX+w1}|o{gQN0<wSJn@03NH
zP=!4%|L$t#7p~o##|>VQ`<5=qDLMsyG*Fs~z>ClkQEnpQQzf)SWkPJ6oU|)f9+*uK
zh8PxEpYZz-zOPm23?ybyZb1ivE0oFFFfZQIt5W;FnYxy*Vfg+V`OQG<g3HrQb0yop
ziE8X3D$s4oQ|KOg>k`gMNEkL}9I+X`A?FPC4-#2|{>w@y=)VEbe`3zmJdWU7RBErF
z#iur$$MD53jJBt(t@_KCFY$1c5h`#J4WzTt;o)DXK!jMQR&*74sg5Rs5NP?J&Rn^0
zIamwD?&sdkedOr|fu9q73uw<~K%Y|kHt(eWka=rjs4_c%NkRF?&!2QFYhtnyuMq-U
zjLI9(R*6w+WDCf;tFw>AmV(wqo(d-1o*u|EY`=eAfAe+=t6=lfh0m~F(^^;e4dfD&
z2l)9F%3CR2-Ud3lO<c`sKlKz=Q@z<1Gq~dHo;}^&8*L30v-A3<TSl9gMLGRc`O+T#
z*XkcjpS=}3`AGRqx`a^R@jcsR?{4`^=I&ub#uV|Q^%`w@_ij`$H8m+6n&{GMlF3%x
zbckIy@Oh5S(v|9g$D`%v0(S-OSY@?n&uyoPm)Gm_y9H^_sXCMG)Ov=LdQ=Y%6dfx)
zIMAr)zjZCMaBpX4xIb%c2ZZ6O@5~~iqC6Bq*P2g_8tC4(qhksSz8$pctkB;@@|$(<
zCR735zmy0=+ZSNXW;Isy<*i7U9eI7zLdDib!^Qq>8^f4Je{bsF^z_M4B;m-jY_@j%
z>uSp>(!PCH!~c?9w=}`?fzmz9ArXk&z^OsVhGM_DIyw3B>Bs^#1Qr3u_pPYdScSw?
zKu-wn0MH9=7SuN~HEN$XUw+N3pT;`%^bt-E;Jl`QPSBY4qni6%$7ce@b#!!;Rg38h
zf4Paosx5DBS1tLVzbS}&-#+Lo`0YPF`eLD?;-8(J4RFQS*chJ`Z|03bcs5Rj!q9+;
z9vz0Kg-h23-QgviwVER8--yu*-9p=$kN9=a^@N-^#pPjU4#3#|%x?68Sw`D8i=}}v
zx2upuWDp%QoRoS9@H5YyEF@~gmu5X8gnXh?K^Hp5@u8#6K@nPb!Jl%<B5S7+UhrJ_
zG2u4dp+^171<_y13g{H8Ha#J_*p#|8Ms=GNueRKCjU>}97FAswK}ZEvmQ0-ZeR=7a
zmaig4`)+(_P|ba3_>Al;@x>=8KjH5(lfbKiGn9GSd|5DIn;KqATqm@Roq;$cD8lVu
z|4)?Y<}mc18?Ss9FG0{u#FKoz)ll`58vXR_d%A>+HnUN!g>;9NR)LKOqMU2*{*pzj
zoMfV5-9C7CCy#;UwzT4%R$<&l7Tm6`2}UQ*)S5h4G=HI@vlJv9!-lOSCK^VTzqHy{
zy|*!xTQa7Oe=%{>&Htq4t{($pDp%@C_wwC!cGnxdAc}WN`2j_)+q<7teR^|0<+C&A
zTO*>Mp<E9p!K#r>{8@@|6F*5|!K16BMpi0tT8ELIUx!n=*YDpibe0s^WnEX<+!SGZ
zb4)`fUvl?>o5anELLZnWBjsgex+U%t%f{WyDMMf2GHFS#hT*h%;pJ`m!!wco6r2Os
zFObZ&80XFWWxca#BSNRtaVpHeTNs@09RK|(!EC*ZNT{0s>P4$)em!U(_CO5Ew&lhg
zL4f`Ggm)}jMiql5UZYvVK!pFaQa`H1Ehua~HRfd(!#V{hhkTjS7GBNIup~q`8{l!e
zbjicpTLFk2?1f!LMdwE%kt7A>&~_mkJjK%u*)t75IkRU*8(6b-<F!}w=WJjK*njO#
z(->Q1ob}J^-AHi5o4avNaP~Fx%nh8ZFpj*5iD?EWh1%{pit29G-)Ie&vwAfMoG{53
z&_h7GnLeuEHLS176mZlsCgW-Kc+-G=$JehrI8H{0;wC^(H-Ce&HdyvI)<Ff(HUqM$
zueX;7Z<tX~vupeI4dO+n+~bf=e*E|mhAOC=s-5N3)zy1v|KXE3hhmFNrhtHeurO`t
zVUVshxFJL}G$kcv08$-juOML4-v0smIn6r&NEj0fJ$MWCVl%HdhUF2jEn_EP2O1kt
z$l7G-JqoIoE$Ht;=0mz3>FKu8($WxxJ#bx(HXc}Kz^$Q2Lo%<GSI#~^pb@MrPC|Pq
zH^pCP$X!C?qmKJUc|8V~aE=`#DARuW=mFl{y?YX}j0{3&OLh~<x?ap+ovoSw4Css8
z5X5Y*u=@g6ADEq}H@WLx0D}qudBW2C=8dn2L)MDO@$mdM2?e-MR<Bs`1;ay}a-l9v
zN=&dpLxyf30^(vkl8<35bkLJUh|%cb1Aa^JjzU7JhmE@`LWZ1Cz8Wdb_X~f2_=FlX
zQ(9}lWb!(nYHnyyp72zUX;SfD!<&o4>0sj$hQ-0#S6pXYF#=3xZp>j$A*ZCW@?!IO
zA6_vAym@gMaXC`%vg$5~;99)_3PUk-Dy|yChHez`fuN~0u@x83XEe&#8Q<UAd+g@-
z&oF$7Yru#z>;O#%x$96?d~nB9#o+k3m3chmvu(A`AOSn-kD7N6*J%eRR`g-=s%Ac0
z!QG=1qq=+kx^C@X?6Qa`8f)&^e7Lg=l%&*!3wD!TVTA<+?=VMRyjTgG^PqM~xFEQM
zs$f?{qSbGGiWd59Dg={(fjjv5`L*sKAIGKIi+Lq97B`KJkxk|>4gtPR77tUc!<+M`
zPURrQ<gvNRk)vR5gsq3ZLnar|@#fGwIUe!Y$Vm55h%kKgY9A&X4<!!E2ezWSDMe*T
zkg)MrQE(wdxKG=uUKmt2^IVzkeC_szZcAf!cr3Zq_f0Nl7Uw2;d3oKaJlu<*5HBKd
zEHV;z=NNJ}_SNd@k&(TmnZKd!FB3&6@=88jDeb#!*8la_UscQ-(2`9y`#*USD0v-q
z)uu1Ch(*MxN{8<qI^aXC`netZ<BeXC<%wB({>V&=MRNjF8UZ4+L*Ch+NhvM%%FU>h
zl^dAc9zXWyH+p%K6!tgte>xR=+Ui)LoE(x7tW}f8w3?YY1I1jh5G2?TGG8X4VGE|4
zcuHg`K_zNGJxEdyC=hQW9{R3|wilMoM{Gx<I9rjG9r-y9b|+Ic#fpRv4{+ZgPfkfC
zEj;`Ngn*OHoHj3>KHVv@*NaE3AMu+eeW@RjKFwHHgr=|0kgL|jML=1GR7b5uH-ul>
zbnhEE{DCk)CrZuvE?>h0??iV?b~b2a_3B*_CMG6mGeH?wJoEL{&ESmt0`e0*g-*`H
z^{-}O{w87)<0UYLyED_Ad_Y?VC-kJ8q-4p#(qp?NqmEVE68^$cCjK!wcOgdovuNyL
z<&TW)!6!(xlmo@!@DQR?-em@;zQ$q4yCX~pNPs0hEIivHWh{i;-dd!#?*vgN@E;Xr
zq2hx06IA@a4*l?daOf+qg-Bq&gcsXY>yOQW8ih4O?$V_vYl(`sc>d&gO@5EZ@uKW|
zX`(hG)?^LsY*eVrJDcYrmrd3XSLcE4qHZVjGpCS*Vz#Z!#Cf6bhz=rSGJSp8<))?O
zx>c(nw34mgy=zy_OOX9&i_&2oZF5_?62yK*Yj-z$0_>stT+sewWJH|+bIGfLBeVhz
zHLVFYA^1vSl#&X9U7=vg&#2Hw1wrJHCk7vJGB{gMJN@Y2`ud<mErJauLN6VrLP&1U
z2H;j{fTn;CdfG2DOWFp;*&K?60TqT-8Z^DDZcN_7Q=iJQi5y#GkYw_Z@10i5y|qDP
zT*Sa2GCr?!Qc|1wi9XcP(Q%g99{6-Wnk+mDNIBZY48;U!cCk8i%}^{eY~CDpo}P(`
zY5R8jZy%R+X`%?d8o`NO0YSVV!m&(x;Qm~Ph9KDW%<0ok$uA)v0ImzX1bYio_?*Ns
z<isKGAGKmv%g_~7<?<F(N2u#r&UuA9oUi)Ym~g(GOg2TAujpXfpl(?11#&a3y8T2|
za*68_iZ7!$jJWLGBphk$FW%KbpN}A<?=InCaEO8)9?1q~`OGRgJYh)2<C6cC(Dlo_
zq2&mf!JU>Tctu4eYPQeP6N(QV=tM3FzZ5i=5WWJ)L9qd61$!UBE$`81&o)r?Ahy*8
z2hwg7nm0De`_Znaj=PJVR}Y%^*r)RD+_g&`TGJs`obqgJXNzRha(00z_u0Y4WdKR(
zE^kb5f+nr^5+MVx-@4Ns=7G<>x}~pb^91e3e_Vseain|wGN1DNeDRsfKqC$!BJI{#
zslq#sJ|`*09xFItC(FMlKUYa?6Erl8yzpQJ({h5sSya?*g_Q`CGDnWuw-s!XsrK;j
z=<e2CUxO%<&tIK7Ac8MfM-mV&D=>`Z%N+{}B<{XkQ{oCG-H)si*FuGYGj|in@T@}I
zKqD9<dEHPMJ_`QMf<}e*<a*7AiRsJ!)eR|~BtiJ|66Z<syIT{u+s9z`fV&o{f}mHb
z5djPx(8R>PRR|HuLb;K-tkZ&#J|V#rOhw`uF|iB2eEUEYR~^K7CS0(zV*7>-yuiJ?
zq-kxz4HD{*t^XP=*f$#!GUIx&51x7?jIAz0%4($DyLWdK`&ptxA?FtvIH!p*nuWN1
zP+(1|SE1h3qp{?Lo<Og290Nv<-yZ{p%+G~0%P4y$`PEx6zCdnJ?~P4No^C~z@OUKF
zMs97Lo|yr)qgjAZhmg$R;8W+7rt;Zeef%|*D15+F;;}ap_H%IT(V!Sm#SUIClJ4LQ
zBZIVoJi+qjO<5#S%?+P+C+=bz)h>-6p83&-H}7&WB>L^;^XJtX(GP)SkB!m_qTNKi
zTi{h3ZNL6$Bj8SXNIvJw3^GvBv{D?76ecf_99L{;RhV^lG1afcHL7uY2O;+-0BPV4
z#V{BCYIn`HQOf9|8w%12=sQ@0SZj%&{_7V9l0~!1evfXLVSMj^1%37xrDI%bwha?a
z^SiIV580;gd}#Pf9Hw<t6<KVS_xe$W7(V9B?(4QQ{8W-C4UoHK{qeLj&RI$?JHEHO
zfZbG^rw%>8pWP41l>L-w1j^v`ex1sB;Z*Ifi3V$T=RB*NJQX@>Qy+@ig^Hm3_|)~I
zZ}bBan<guz?3-zce=sxq<G@#aW^-BQhnLOMWuq55Qw2-@{x!N~PtDfto0~Ioub6G~
z$$qiJa=c;X&<pOM01JmVTXB|5vEowA*NC~2>fsEY-5q-^S2lfP@NL|;boX)$nZK^U
zz4o<9Hu1Oc(${)RKc-wtiB*&eLZ`H&N}=*+{7YL>D4>75gt9-Th<Euq`jZMr{;{JI
zOr$!?D4!1H^TDS?{j7iv&HgdTQ9os)0|;uO-V{NwoKo(Q{g)O;P{JJW*=(cU6U@F4
z#T(Qob}hc10hSI~N4VX=G}fDhqg_M9Bs)91;8~?V2fT&{DTrxD#>@}Mme*x;;(&hG
zRj|rTlZlz%(0>?-tPe0Yz9JheqD~BUM_0E$*?AIStu50(m2w-J?Z%oAmN<Bgo{OSi
zyPJoQB<Giqhsk7{;MB8dA=gLzM8F}E<Elo9+|RKn$=J%S;V`57g51ays=A3_)PYWc
zB}^1#tc1dy`XAJGH8;;dWyA@BxB~muM|)|9mCE}ebySRTbR?kyCYd*WAI6<VeA^F8
z%1}Z?*(O$1RpsR6fk8#KB+?p@46*MbD=Vv0FeDJJ42J-ZmVVEe{G3r?Xk^4=%7yed
z%o6RB<zvY>ATgLdqTAd2&b+WOhsIgjYOKjJMC=w}k-;MkU;~YAhDD!my#vJF06$^J
zg+?LS)d4h!$V`_M94_0fzdwaiV{1=R{L6S90I1j<@nM*TL&NX|^v#@%P-!9>F;%yk
zU5-RpgAmMn-n6TNMJL;Y{9xD2Gl7-Fut=l}vfOTu*V*>Bsi2{Fb8$45bqNb!x$Y6Y
zg3?-4gfFH%^@40P+JaCY;Z)>NN!?+?4-<S`I3iY{2E;L39sx7`U~+1zfcsAdQ_MS%
zk}O-gRKG4>OxU;QO!*+lP4t^tliiWL-g!BbFq<$U_92%?tPP<#pcMtK7j3bQ9UY(+
z;Sg;DCZe<RY@s>l#c2&tSwDz8NxV0l*N{zd#@j=<x$+#UrHDq3Avho|X4tP1Y{v{u
z>-e_*?Jj6|t@)5y2D%u+)iw;3osE?h24v-D^3=Bz?#jW<q8ol|qdDDubP&Pg{;9qh
z<?`01Fe{;<`OIiK!xkpPY}<R_>EWdE#+-ID#6yb8XT5zZJz>>dwQs@-?Nf+@iJrR<
zmZ0d{0yV-d#D%ph9MEf*<D9P%jrIIlh9(%XUlS$q&T_+HwQ5^UdpK8d8&x?gL-iLJ
zO@<zJs2$YoB*#^5Kh`DcvLvpe^wByK%H%Zh;;Oh3jxsLjcZkQnkMsGYuBVTWj`k@K
zWVcx6oYV?(sKx%2yWmU2Ds0@ir!~ZE!-fs768(D5WJIIIh4w8xBBFdC=R4lRvE92r
z5oI59y`-0)yZh_m00^@lxjOv#u$;y()-cdUFZ5hk37`hRe|%+z8cYhI-a9&_VzYVM
zYZU88+AiNxRVE>Fi@*}Etgq5M?6O3?UwzZLp_m|YPtA<97c_Uy^jz_KqI>;dktc{p
z3@a@qcaG?P*)JCjP7D+gsO91djbFZ`0^XqX3rcsbN75jn{c;Vwg1LE;K<gQ1J56Jg
zwBsVJ1{I}%LBJ-O%uJg1-ABG>+xZ0jJ45APdsEYFSB;pf&?BZ3Pma!ra$FJegcxq5
z91rJ8yDY{$<9Q&Z1d>#-Hl&ZNSRw79^trIGQs8LJ(+lL=H(ClJURb(E4mXL!NGt4x
z0|NKP0_tQLc=hz@(=ezI!s7xGsAuR;+d4X&_q4UQQ-UjS@Bzzn?#rJ-01`Ym9AR;5
z+U53fawevv5ZN#1175t~a*c!#%YNh0jUu*PA>Q9JUj?<ZBEah-2uQ6qF>TMDw|Jn6
z>%zpD=3rXTk{ii3xN!r)cLkoClFLk7%-615=_6>a3oAR@6k=xNm;!jUh&<YHL#U4s
zLnb%oDG8n40y@fG>*`k&ipK34<yj7)0;@xj`pBcey%>MQE7;SHjwrgs9mT}<e4%f6
ztXPDctrCQ_rRAJRo05()!|X)$!M0uo$;H}HeP$Re{T0}u7=U&(7-dJFzZ%1AcXVUv
z6qXa!Lign3hsaXY0I+N|3EEPih~P;Lm!e6OCgt+FF#EB&#BXfqN=-8dNW1<JzkR&Z
zm$Vxx3-j2!*vsQRvDpxO8y&b>x2i3loi#xx%~koirD^1z1kTHEMeP+nOZh?ufcal{
zI6rG;rvS?`l+#Iz?M0JLj2+m85)<|8GQ1eBDk)<ljetSR2EFc4yP1~uJJyGU28_oW
zrP4*@2HRHtr4>a6gLju^P4{PWWGM)=d0p)O=byDiyYrTTXf`;T#z|*b4HMQ$_HVo6
zyo6Fa%eJwFeR4nQCec5fb2$CmQK7uAt%L@0(V{Q(2(3V|jx%n%KmWy7O(kU44GeFI
zR1&~3r<CtpzLF`0mkRYx$}<u#x+UsMMtW&NfQ{<~3x<gB_iIzi{h7iH|GD$e=xg%y
z=Ot)|?0VL<qgROPXs-LlYvbK<`LX}IWxwEGyVXlC3Mpn4?-WR@q}y`Dd^OQy5k1Bv
z{ff|=@y9}zmr{P*eEn`Y@!@;yP1zLD52ChZe*kn#7qe}l^!XHH0nsS@=TD8-p`!X%
zcfduM;OFr@%D1C+dBDD7<f_hooQ6b3+6zg3*b*F73gELnY*4S+qgXG$&?MB?$R}oJ
z>@QnP#dM8AJ~YN@oI!33)cndh-?pEgLPgvi$|3ZxKH(s~9!NJJ)vOCNKM`(7Bmw&M
zUPD|UtOE{Kjt4tCc2bgYXk5S;(hD^K6|g7YTS?cOb%rYN+r9gw0RdQ=l(vWd(ID(`
zBN~KTq-cN2<-5MR9a&6AkT^6NM8>#@NB#v65jv@3*8*#uEQpDD6m>-<(?(92bU|`%
zQP649{N1zv9IR+fB9y|8gdf(!hiibd0BXzPVrPGr_x$-5^Z2h{ujXFV;x%c304Hmx
zfCKg**=>d}z=19{v9uhhjcq~8u!df{(Jf8!e9UQg!C6=}ria5sa7b8ve|kppg`iec
z?Fk4+;bH~70TbB%%qW9Ddj<hqz)JW$GBPuX;H19#Lt0+oSPBIT>6cL^e~D@$ULB(Y
zN2SU;Gx2&N_JaF)`>v~R*D?sceEyuxZlRyioc^EwfVXxpwKI~QFX;<Cf~x>}1erMW
z2m_Bx-rzKKdh!CM>Ruv41aqDIHp$@wgnQNk9`aog=ot=P_8+V>aZh-zyk@@qo4%{4
zRyNAiTFnHL!x3PO2;6RaEiec`n%Xw7WwU+H<UI#DKT@j1YDxn{aP*e3nm20hFBW@$
zm8q!9%HBQ;QSUd*R8?P`|9kUhZQfZ1!DdLgAU44^vXFBiA`$;wJhGB97hFC=+O(4{
z`;xHJ+#^Q_swzauC|X+a00y_3v8+u2f!Q`Q(o?JD3qLh}j}^U3by=B-PZkWBK+3(w
zfcRh@?gSL47g$?heFIY~QlV~X*X6QLRu<Mfb#hc9fatRXJv}`;v(yVg7G|Pd`?Dut
zy&JK9@r*fs>Y$Yl-&)@`!R^e<v6A##wy<T>6)n6@uvdML&z?JXuq+ka8ukb<1WeRq
ze@(@@gWz~Qm7_5wui^lY%zjwTyrt+B_u0%t7xj7JoB;7fQ*Qu4bC`G11qlh+W^GMP
zfg?vE64*EbV9o2ByvdmrgI$HcU&irJ?=??vm--&+!F3;tBnrLp1yd@RN_jmgyXHF-
z1McUO1lG~}^{cd^qRz3px7R*#9y!_^?AkM?VTen$Ka6;e07DU;)a*@#0LL}m>+RI~
zCiNoynY`uXgx_eB#&Tv)&-JE;XS^Y!{B*lHLDk}d)j8|;XXVRI$xA+Ze172DHyLGR
zy=@ME7I42Fx-Ff^OIu1kl<fRghki&R%gD$eslNdEkCjMn^mN0HfEGIkyPwE&g6{eC
zdDhB%4;~<8p&f$>5i}jk1TXU%P`b`(#LEqEm`&?UolU{aF8D$+E&d~Rkv#@TATPU7
zCCviRtIA4qSaV<>K{l9J9UOo$-Q!3_g_k7P5{c1yZp^XoV)L*1I^Vu8m_-FDR)!WO
z!OEen-9b1T$NiL96eWoJpO+VKG4$~$)ZBg=F;Z6pPyQm3<SR|eW6@qaI5@Nku4$t`
zy_16@(t)x{pn&ekscmWwGenYwb7FokOe4NkCU@<Niq#Dd6+!kJI!I;+kx4GG5WFHU
zk3%>SepMs`6eA7a#Bim#xcH;+v_W^doD#8gRaI5QUZvWM=vLcZps7?@%2{PHaVQ>r
zJo3dL$?-u(YcAy&D2l)O;janRogz9k>$dy*_(YWN-Cq`j(VmzW9bLDacXyx(U-Dow
z>*dk4#V1u2+a}yZqGMA(h&ukFA?g!c8|vyHI}P9MXaluv0aw^YYrWSX8UrjCy@mRk
zz}V56bz1!-;)LfJ&>go=l(&n3ZHz0vmeb)THG4hxy8GV3ee;D&U+4SU-OpZ}4xJE6
zxHzVXf0<9S>S3Hfr5=(PdHJM!CNVGnCV}Aw+Pw;2L=@#u9CbRu)9H~tso)tOOHyEk
zMPHs&h-`13&2%W#3v1}~=$Eo<XD+ToPL=$hRq$$WYeX}hMe2Pf9|j}iJ^|2o%3Bvu
z;FW((e{FTJjhA?v*JTVCMVodW+&HnOro*U|X+W?9*)#a2gET}v0~Q=a)9_KP?G$P2
z-P;<BPbj(8Y+E|5{uu9(7&A{2E|ABdo$((9rvwVqK)XP@QOa^gF0s?**EJ-*or*nE
zG_$|j2+9T>E~WhxqR~X0_7~3zGdQqqgEb4V4u$i?IJ{_)!E+!12zkYdg)XyqI8_m}
z(BG1+Hqnif6`d7?PSUK(sm9+xr!_V;O^x)VfXpGs3?o-q)5hmIR<;m8wyEiATH0yo
za^#~f@8tOU?c3l`ArC*Yj@_&OXUcA>?In6p2&lciy;D-gfIh^kreDwahWUNFfN|hE
zbpT`LW@eW*-=lyZx7V0Af^!EnKxD|cF$i*>@OO8=sH~h0CPt<K4YE#;m3w6&AFBJz
zWKXPEDoo5Qt=tS;?>G;0Mtb=BM=fB__mR_qZ5qp$E!+3T;9KvmMnpVwa&cv1OYiit
zCu4bx+(Hj?V3*scmM{AfMC|o*Xl-zvKt`*WDb9okkx>jT!3&+u-G@i1Ua<N5FmExG
zO5qt;`2$81t2w-ei1iYe5q9uy?XF6R^oOZdKLIdv`DbDRz0L#lxc*n&(9ifr<TfB<
z=KBQ<`2a61`s(jf-nOV|CxPU$2xbuymrM+N^>F`&MUyW`#)=SzA|Q=bv2Yj(!7pbG
zb0l@DypOfTlxomd;0s=Di_thtGU;YrvWklP>_)q*v4pLm(~9oTN8rbgWv_XXP9U{o
zSNaLS7tTFaAVeYgxg0<0>*uEmf65ECKFnbw{L|?JJbH?8>S8!Ck+56oAMx$D<1aKU
zh)n<ZA5TdtqqH%D$|!NgkWWBd6)f%!VGh)qaM8DE*x6;aB@jsM_05!30#JLTefx-4
zmYJCe62wJe)1MDoaS$2u6DaJlUIV*K(5;#4l?_5qOg&D0MCqUU`r4=^c>f1h#mtBE
zA4Pq1aB%BU3;ly(fI$~P(&;|d68Om=Xx{W&#(?~aWtCBo8yO+<8>DlwHJx@tjY+@S
zpG~q}dC0lV(3D`0)2oTi#dp_IxFsc8YPbD$@qsLsjeinNffo+I8b2~|dljBcY&gjp
z3O=C$cCk2#BXb`!kT)voRWHwnr2+BqfSEONE=WmM{&hL!Dyo2eAvz>H83xB<P15U?
z<>ac-+IE3@ht}RKV}|0d_}$4zDeuRM$)Mz9#2Q?gSuM;CG6|0dQc{=>>0UzYM8##8
z<ro=zIyw-DxOM${86@~P8U1QJZPAYdK!_SO1zQ6m0GR!1ZGNlN)InXiuEO_Dv8<?Q
zMfSJDoW0g0rpB(he}aME`;<2|39+%UA-O`MazWW5`XP~?NL#YBu%LH{j*L7CRT*?W
z727F<5cdOBIk`jVG))>oK#1K!`qez;PS}Y18z(R&7jO<_j=h|$<>T^cdRDz32*582
z$~%_}DGZ-Jy#|S{5`cq$UZ)XwHPNhb{Dg6&O4J6t&HjFZ@t9ee^BhkN_S!|Xgg-aL
z`jH`-^GZt<d`{<BqKEDF0F9YpHq|ud@B!_OFnH9g*t#SIa+cXKKx!{I;j}{Q+dc`^
z2?fO^v>~rU$TdPoV^(B7j2JeB2AP}&y`?7a`W9qDy$~=tp#+nei^GP`noi@aEG!W}
z`@u}Y=ZtOyb^6Ef@bqYd(SV*sUv(-ElUho@W6uz%Kzc4E&6rY)5OQPoU-M8i<u=f_
zjB`4S{tGKlkggXV9nHnfZDDL2j_CZCMPEb3ea>yP1}F$h;W>cOiW?KX^^rT79oI01
z#uA;FQ_X6Eq!xThkkq06@SAC;S5Sf~-*Oj6k-<GWySa(rIDw}C#w$26;h_x{LdGV%
zUeKMsdP`xTS@(BU^4bE`jEvNSrLms!Yu0bwdIX_j*r&zje&OFo01RdjQ(=W39$7dy
z($mv%@T1qGJR`SjUXlN#Q`SdZ5EqxJ&()*SDV~ukRg9u8c9YN~zRCp_R%VoV3s>v&
zZ<cvT6QtaovNCCzIjrf3xss`*M%v7I`EOuom0iDE8){`OdpA%0mJLqbn^O1}K?3Of
z9o@f%V`?izK<7aQ8_yGj$wEbC+fuNJX>SCzB#VYGW^zo9A^-W%CVHagHUv?Ra^=NL
zzjjId`ahMCLjr)=^oMV=n|{&If4_HHc2UiQJWUFy@sxXoR8a9{R5s<rnqr0h1ZSYJ
zL6$1#^577Zl>LXICHP1Br0K@<cDXJ_^7^yAah(QhKO9v#VbIZvubEd{L96tfc~!fv
zP4m-;!J{f?ZaNn{T(oHCD)CdtFG1U->-XuQsw%0jDtDj4FPdQGA?f{}sw=;toy-2j
za!D!qsH;BB<}j6pFjv#LRll#*)gyJ4^iFgsU!6B5@>4(5saNgOAyJ)beVxZ7<h~E@
zRXaDb(&#|~g1d=E=Y7kOv8fm7%+B@KnK@5qX}{-tObxoc-QMo#-ZuK-sQI-mN2nhe
z*ZZ`Vfnx%IRuJ6TCrwIoST_Ic(Jg(e{^1KEq)!~JGU+d+UZy=&f5I3<Y^*dg=$FjD
zRvLgw^K=z-x$q$Zp^5$1Lni(ISdDS@5U6@8IkI9Iwz65y4^2=KQS|^RgehYF)x9Ru
zL*4ZRljg<!y@%#OE<}pMEnPx@Uetpsxkq|0D=P{g+^y!Y9}%)%L<Id;E>$6n?GdmH
z6N`VEnljb0?a}qf)f0oKySN76mN#;dh_E}qqYr}0_*5_}Sov0Jr4>8}KP<whv3m;o
zM$^b^h9>h$s?ao$-H9z&NT*@?I7JAUc|Y^g<;ySPVqKJ_-qlw>NuxR(J$e-F5QLr3
zGx2eAOX|3}x~^TfF5CFq36vn1GvN6|+~+1$`iSEE{D|miRqU=nAEaK5f(_YG79^@@
zxUl2njfurH>g|G1N_-v^cz8ZEj-j1iTat8PRKu_V!I02aC^Ij#z^o0q(!bB`hx(Lr
zyQuopr;|RX&8$(VCD4}EYQ=+nH&M6VeKRT%i*Ew+o#m($KQ7GWtWn(?oF&1oem$h`
z$*;-3m`4u8o6)hJ|9kn1LwYsfbAnlr%3QL-=X`k^VS+x01UGTQp2^G0o1<5~78xuT
zx)B6=Q(F4T`3SQu$cB<7xj%d6G1e}BQo{s$1&NEvG|#pxA;A9hp#Fadb@zArQDmC1
zNMz&Rh$4epFflVbkC@b$7y^MHVDq5@{h8U~=m&YN5L0X{r3Yuek*W5}HnM@Y8*;x+
zQUiW(w_k;J4}ykQRTzko7-(!^5fc&dbaVmf4r&L|ea7d#ziZ(X^u5SO@bdOXpeil1
zaN}hX-V9nTXfF255OEw66Ne(m48$FRy^q*(LcffMot;4hIV*js`SwKywul3yPTVK0
zsdGwlNKnwV-w5-ok3g6uY|&x-lI;3fnF7*^<3^+cl-x-E8FiO~s;C(VG;lAMEeBfr
zQd*Kvk?>a2av!~LeDDB36<8HxSSX3)Wm01@?z|C7NLj>g5yfR?CL9RmnxBH+Wg0R#
zEcGA`*+qXob^qo(%T4|@96{;1ps=k!9=@hOd#Q3I?P6^R1EXmd<|8xY5YB5$s|Oc3
z+^e|i<rwz~t3Qg6;F`?>3}$AmMd9VE8;^mOrCEgVx4ouDs{tfSFItxEK%uWiNd}SR
zNiIADnAejBGxGX$jo`{O%9;p;W@eIfwA_SJjsmN(z2)`GtMaqmF5^A_f%}qJwbvh2
z`R@RxRp9IE3v&((_*f74@Zm#*30$xI-S8D2|DT3$^i4tN?>P@dtO-0Qx+2gqLRbxx
zL89>}hCkid2PRj4k&O-@8%JUp#8YsS@xES)<X$v(&Jw3FcrOZ!RyRH^-)I7}DKv(V
z(rx_YHFlw7mjxTEFCZwI42))j<2a<mZOzQg@Y&zcqn;LG+YsQQEKj29gL2gt^g)S!
z%5rslXsZ#$(TIKl!dN6U3ENMn@)p_-Wb$JvN1=9#<{{d@BL5G~pFdug@}Y$S%vC-J
zsg8+o+v8Z{dA6?&!WA4A1-2&gJ|Pfil%FZL2~i!s6g7y(I#1B>*3MKpZuv(pF6Ne&
zh&gkbU8-IL;Tlb3P~4k%ouMTsUkt$#<89dHGTq!+8CD9o=~v^16(S0IF#)S2TwgN<
zkHH%Rt<K-4^&6N<KYuoctRq{tKdcCOd$OeJb3UGmpryPqwDs2E48m`3N+1{9Ib{(N
z02v!YDND}|_k30?A0ZICidV!7z%$gHff&dxjD9CienPK<m=Qt_Jmsrud#L{$sWy7*
zxHq+V%%N&UNr!igi0*ID3`Yle-Pj@nIR+CqpiP|RY&TO8G@&$(RaXu)s7AfIprP?P
zDgh}~z@qcsFf{V*Gkvsc0C_c-O(7hUVc-hDZ+X0g@$bI_XK&|&hN~TfpTL|~*`M;L
zZ0)BuB0)YUm=-!gW^}qj&@Rdtx78zK_6Mu>fe7-DFgv@%I|9$Eh3A!m=W#{OH=o|s
z?uURm&P#ysLZ%Xn5IWzE9ObzH8n4orOa_{NUQj7CHX^A7!@-Do25z)J-3KX?Nt7f0
zlMuD;^IZ(bc7sXEX1CyD#jm5H^y?FKKm=fkqc7Zw@I3;wt~7a?I}gxRtS3AA^JTm8
z^YL*iCv#GF`^g_gaHkG`%9}i4J8ZwHdykOOPJSif^ika{OOqjB<>R|lh3!B8;DD>C
z9bC4W9>urQ>>ZWsBD9~;Obaz_>0)SGN+E@@%Uv@s&$&$>2<$BVSl;#())NK)h|sN}
zPLxXTKfAvO_;Q{9SP1FjUOIW@oAD4766np_(5C~&j9jO=WBW>^jN|8<DEfmptyzw`
zeAhf8Xn1m=M~Q@Z&U;WVz4Eh=i0f1S^mnct;zC74sr?t;)oIFU5wfdQCo|y4w!zVk
z#qQaibJP4Bhv5zcO6PxI1*O4(Xa7r0?ilTJ3%1^B^o?3lwqv?B+y4!O`I)w7^Rrs6
zs_W;Io%=6J=67+h?UBbzk%PialF+FT0i6r|_$>QgYWqhO&;LTke*ekv;KKW&TS`!b
z^miRcehq&Vcx(QkCpM0;5lf$cO>9Jm$Fhu8ju1{^Gf2%Y0Rbz>8T(?HSJBkpbv6Bi
zA#0x(=+{}ye?p?9It$8?{goNs$=tj=bZ#lYoMSVF3UGV|4<Z5*%4b66Habc`(y+UD
zJc99x52FzrY#5(F+Sp^$D~Ej457g}+KddI&ym2HB=<(_x;4XV;b^&+04)guLaW^f7
z8RwJdV=O>TnW;mS(g$`7ZNtlX31`=bKxP-NLuqR#JICC?{H#Vb_KYqmEVLaL*!u^@
z$8akOok9#272^oeatFv=#P!jtfdaMOt`XDJ4Bqk`sFB$Hc}a%O#-DxyCh9smUFa;u
z#M?68JW{s>V4bw(8#EiI<iujdb^(X#K}MIq|1C9lgqNgV$I3Qrj(o;)?v&i7xSCou
z_sD4Df9Xne4hWo#YH`c+@>N+5^+Q0wKyR<Vr>7jkyRexBo(D&_gr(iUM&h~hm={>7
zSs{nnX*_Lhn_ct8u&ag`IBwUR17dad2U@jZMugS`$Nfv@k-J)C`p3x-?0qDxZbu3^
zU@Kk?-LSMl#j|`qGomU`T1bj!PtD;%O!8vjB}i_m7mUdaVXggut)g3zTT9SMP9|P0
zi@H4~nLR}xec)gg%K`nQS>CRG$MrS2m~iz`0f_G9&wIf4!;wJKVFz9SYE{bq&{k`R
zKAkob5n?(bHpAfp;evG-ZIS&P+5MV@xN?H&@n*Taax;h0>Q7KxO-{+QW4j>`RVHyY
z%FdYYk077GdR?%gn#ZZ)k(^JYBm4G=tC6bRu-D1r^yiA=+<VGLuw?Jf?}q{}=o~pJ
z`c?>5gXrmr5qgTh-7YnEw6!V5kXaR`py_XYjTR1_zIq6eSZI?p4DyGs#FalS1k$7v
zC=f+(dJwElv;gBRk1nbZgiAbRFqsg3(T-6oUfH`7IP!zB7!(>PA}NB%l3YeYAgh;!
z%*i(2cGQ8XA^p{R{r-K7Lt5@0se1YH4I?851TX`K?(Nk_e<SyYfK$UIS@RrLxlpAW
zg-hc*snQLs)49x1g1h9^D^1+ix1P?z<~zYwcqnDXT?3+%`(2*Q?<-aH5u1BJMB;A5
zBGK0>-&Oy^s^G_fCAuOly<-xI(SpWb-$O>$;_d3E(g*xv3=cVkTUg;>g*Cl$e+b^e
z!En}9AZYK;#+X+FOSw0Z^{3;Yu%gN{{^IC)f-v*A|Gv1~6RN*Q{|(%PyXnuS)WwKr
z`r24fTx{6zv|_IJ-iMps;<6Li^tLK5mExD9{cF9;3@F2MDpl>asQANuk>1(q!F=^^
z4ZRNrw(jSu-n(rx)gtvidD>X8(J*yL!eQu;3e_~W$nWAa8!N}28*(|;gB4bB*$|R0
z_!UMhTSShw`EByE9J3z1SQ-ZpR_;4s0*%$?+q6kgD>9{UQPmCv6EVpg8`_~IG*+_K
zyFC3E$<TDmKTjc^oG1QYUOi#zs6-JxSe@~f*>Z$<FTZ4^iK5~7UM8RT+Z}}7a^YK?
z@B3o0C8oF3=mk|N)vxt`)b~?FuV}+*em|GkTl)Xc?qzkEDckP#q^`{sJ^Qwd@#7pS
zkq!KMY!U4_-S>4p-@T$$Vz)D}I~x~#Q)%vNqb{jqbmO-g=I+r0dy=EoZ}2axJg_c4
z)LbQ5-u}ekyA}oO)7xFE{S!-0gwWQTO)6Qp{mr+l=;_k~PEOsI1!s%TaKwZfk+t%B
z{MIRay~cG&KKUi}E9+1F>npjH?FX6<T=B|?*;fC+F{$cuoy{sw-W!!&dUT#A%O37O
zb2^WWeHBwjh}<rRNn=%{CLs<CN4Bz(l9HU<{hQ{ZOkuPFRdq2pS1_z^|NME2m{?Nw
zT~0y6;tk@nBL#_xiD*kPPD*%UgJPfxlQe1HlC|c^k=yQ^zITL|_q2>m-@p!MSLK9L
zhjZuJ-KB)ltv+Rc+F~&DdQDsRZ9&Pc#^DL73olvMVY#ANqc6*|#IM<h^}p<p+m+pb
z2z1P(GBInz$sUUx1smkn9^d_O+t#hG!^1}{pNNs76?ZkXsO@Bl$C@4_t4@?#pbPVe
zT+%I|^**S?V&Q$hnPJj|p>%1$YudBS@n`Qn+JACauBccLxyCm0$H$zygx75AZ}oq;
zf_0nU8I6t^O*cQ|eN9_W3X<GCaJV~2F26O^<Wq}vhnU&6k#C>BtaS={(O1%$`i+BU
zfbQtg^t~^)XqL@7s~yuA69W9{Ce%I^sW#JE6RjU2#Hs(#M5I0R4C&iWl0;JCJ;SDB
znr930>+ZRx1f6VhVf6Xgo>_);YHscq%W22U9cDZ9Dqh(uU$H-%HB;_38)DianU&S-
z&U$~lU}DWjBfo79^)aq`OSyLKf^{!Id2rmoQ!7b^DWzt8*^rXhOQnV_)wD}4nf8}V
zhH#woXp>jamXR?KC8^mObici}1S=^e1Dds-$Y_=6-1sbHeAOi^tiPCFBay0zJ(l4b
z$)X^iJl7$zZlJj-AxoH~BzxbrL5UP#eSKKUerP;kE+Zs)wA1HcK-S!>|2mP!7qhV4
zPs-k27+W(7OPa^~Qq(-X`lni*<&e#oZrahqnw_LMZEeM5v`?{Wg>SW6i@c&dW3`DM
z(_*ez&=g57GR6Bv4|ViMd3E+RIFuAkpLE;)Quh0$OM0~?5wu&igr|BfrGyTt&rUn=
zcZd!-xxC=k(thO1c%En3o)|j1p9d{1Q}zaIW9Ql>YhrTH?v{;N_xEFFoo-se7dxKa
zvF{4G;WJczCi9B@#E~N&Z(j1<kj`$I9W^kQ=#rj!6L$c#4ruKD+K_X5w_XmJts33L
zVIMKAzlQdfeqX)Vq?W;3d8^BQWhT~4f{F6>V;vn~hZVQ9m$>SAY}L9tGF)A4hdmES
zaa_*o7}(i)fLHqL>Fr;Y&*d@CWaxRI1+3%A+7eNj#^8O=ejTsj*|wtR2jUcBw+q=?
z*!4u~<dIY(KfgL%HawSb_Q}cgJd1rxntqmwz$$;iK4-RDAsaU89!Ev5yiS8-;Uzu?
z6@6srv6_d?JfM1QYF?^=Ia5mOdg*leB=Yr`@X_9h87YVQmg=N)qM`#K=Q`N?>bqvg
z9Net>)8d+&o6;@Jy}8)An|H^Vo0>iqnCrJ32saga{~<23+v*^#baC2IM(@rBqdAp*
zO{|W`U1Y1qyFZ*-&BTAppfNQS9PhL8@84S_?l3akGzcOCR-F4OGVo?jb;x11lt(jY
zNN=b<iFU$;Z67Dwm*^UoJ%@M(+?|}vCNkNobso9$sEj|WIwMiw2rHV8dqP*WLKs_L
z_UuR`*7D9NsIlai1-#6XJp995YF0UV!`-BhpX%?qs-@i&b>)}cqZ=&@=_&P!=U?T@
z+ua``lEKDPH}#!uq-Bmt@1|MBYz=B@WjM=Vp;}29&&nlCmd3{8pP21c<winiIk#^&
zoEw|VGFnaCgM(dsedI`e=jV+hJ&szm9wxGD{nsUMx|AzxNON&C%oT8y=HI{uhX6m?
z`D<LW{%yWewX0wLt7pQhDuT`@&u!yY8Rrz96>(*1sMmZ4+UnUeug@9jmU|@xa|%-o
zRoR)fmW<3T|GIdsYo8p+@7itMlBT-UQz51%H&##a^JnSY8oB!FzAIzaX}8%3+BF4p
zB=L{HGYp63j_%1Bx;Qmb8<28}v?kR1)^xA-?vYZ5!n1qs2G;Xh{m5odx~y!Qc+Ok0
zA(`u9eF(Ff+5m7ycF{b}{FD!qpYNd28SR^5P7-svK0SUlNn*Hm)jGX41kTRBCxwy9
zUyFOua^oA)i`bSZt3<_H|8&SN`SRKkB=PfY=dvbP#dJhW)YJEv)y8<TcHp{x93*XE
z@;(rJac@Uo!`zh(mi@Q5+BGFfuV0hGg{G%FzTJG7RGy}6dOW>_Jccu-Dpr#>Vs!Zx
z+_cd`;p}@?<ZfgMt6yBZJtaDZTqF3GZmq7n$w9?S9i;<a!p=@v`#UcjZ7LPwm!Hvn
zf16p{sGB5gw_P!%KXbXTKr-1`&X;oW6tm5;r-zI-M_z8uP8%$4R9MHU)HyDaS@Lq`
z^<%f(Tw4#f)$~O+lU;j@n%4ZlO%NV&MEzT||77Jk;r3$N<1cz+9h&x4cGk8=#!6au
zN30)euZmzA@_c-}TLGu*;RrIumlQ@5TJEWfMrBXeczEv+DgXXDJ3Cg1Wm50HV-l9-
z7NoIANg+>DXI&_{UhDMMFDFQCaxzc3m+uk(Kz5tT|9fz%g>;TQNN(7(Ilx|b(kgT&
z`aanW8a|Z`rN<7|`@7EJk(S=;ZZT0~;Vt`|wti-N_6QH-rf3f?ELALAu1q}WH>Ew_
zOYF(ac(?CU>=Q4qa3<qElZJQelPM3n-(%c_y81<{*R8W2mf=xM%!y7O4QJ`98DQU|
z`2(n!y2{>l7RLH5Qu1*li>m$86F#hr3J*WfJtxtmFw^N~)ShK?wfqD!;YUi2^3=~9
z+;G8MKmNxn57ve?hQiV`>NEf7l=$Zt4D4;=7|H&TXnw1^D$FBxcDjSBV3Pt(p<KPz
zwu~0#T|eH|M3D<3wM%1GZ_Wx<-BORRdfZTqU8$2;Ev6?P9;xSj)G{mP&7>^Z!8R#7
z$#}ZF%p~cO<jeClY<N0rnfdhzL0ZlCL1l-{Pd3Sybm1fL;ykA@e0Z(vm*9W^H!JOH
z-#XT;NvnuXNN|UEgK`HkUgOxl7@5ggt)Xg{Hk=f%OCKni&6nD~nMdK{s~3hdF{enL
zrgJprLsyrR)(!=pWL!g>YmqEU3S-q?T-jZXX%}w}8FBTtsO<Bd>i$P;HPhTTmTa$E
zw`}yA-c@~d=(nHgQ80KzE^ugIVd0WdzH?_Xa&zQoh4z?TRzvwgD_16r%q2+8se8JK
zT)FX9CB$xG$QsLBD+jj=9jhMp;h=SKmg6gU%=<RUwNMWQ1jl4S^*tFGrLhw_4z}5X
zF$W%8wvUr=?o2f)Yqrtzo%GD(zB--Vpl-e{11C^}fWT&+{-@;Ox&((y!t8S{5!j{p
zK8a+&ar#U58BrId%-B>PPIl`xOp_XI*Dv;&DZe7)<L(tGWlG7VeB8$$<&owbQ!Fhf
z2Cs_GLE1-oPS(YGc&yVB<r`N`y4g03=S!x)I_aq^2Y=FM*{n(SuE~*4a}xovT`g6+
zc6;1(kkShICS>7EpV^4cM7!jc4f%BYGZv#x2bLt1ram`^>AB#qH%<8?Q*IWV{r>G6
zYxY{LgR57I%*_mtk!)pdmcgVF)!Nzl#4{-?|Kom3j<C}{GBom1YN|~N>PH~b{aeJn
z<wRW_<B}!J7kRijxto9T%vI<WJ->FwjWyrHn`dAS4Me;xdxuM6cBUFrE!(CxhbL}K
z4eTuIH}hX4%a^p5oAd>Wm&1Y_VR=SJ-`i%u`&LNfREUFm?_#fz12&9H!-96EDD$tA
z`N!9Hx5LD__-!L2bJ}XVzcP@MH|^FR*&S#Rt+bs#DSXd*U^R_+W^+dONDq;Zr)3;J
z+T_(aewS%m1I9OfA)-0aS9#Scw(D&7++O7?BKXH8&h&z_Qc@qPvLz+0Ra1ZXd~cU>
zn9RIjo{=Sd#=dQ=TdVb{lx)P@AaiNAS&ZAUik~6guSNpwS#kw6@^WHSo1k}TxpnaL
zTx&^QUIub$Ca0z>x+?YwSOrc7p0tiuO8QC?8TDQ!K9jGa5VK8`)bPqRa?X!4Ju_I~
z(8%tYhKAxz502ov94vTGul;f@^K47R#eipIFXwaGby96Vc5fIx86Las3B8W@%rLqi
zEPq|MT}9&?VSi=_x!EJ1JRInib8qGD>bZ@E5fEY?r*o&PylLL|N+m2TPBs3cY<Gp*
zHa9U>v0E2}X&Q#KbRIY7-R;h@n|n>0t^P{=ouMK38?>P+8jZ>7_oD5WR>jB_l0)e|
zHM_}fo1IRclijlx0u863qqvy#-Q#FH8wTqJuWt$THMKm<U7nMpCO#JuGSwex&sjCN
zoQ})Pe>22|LMnZtTb~FwWPb0k%eJ>W|I(sWDmCT7ZMtg@a@GoCrT|d)SEoSYCzJN~
z{~U^x=Yp*9Yg^%z!$jd$G|(>0`yDxxpAlbv%FN#h!7A%TNkN$|2a}S{XlR5@P1;!Y
zb#JFX{5>-EnNog$u~BTS<4S?`*Uz3JMX;IqZ-AP9i}n+-UFW})n_SuUKNEw-#!dHK
zFYW?)Os2&UvGS<KMxM3tcu99kWoUxeDen1r>iJG$P^120apol}@MXj>G>E@BP8mN0
zs&+b`dcNY|9$8v+xaEUJ!YVtJOA4QP=b%VO#Kn(nWY;PSt*m8bcMM#A&GqqP$Z$v%
zCRfI$K7LZtj0&bbt47)?`g<fZ--y{WA@ta8DeIZ8Pv-gASJL*)@{6yYJ$K^$xt=89
zmFx5*m2`q+X$%DIqSF^fIecI3UJ$ulTzweL>K1wJjC=M_ym1vVZC!tzwCR6e#FW72
z!_kQ1VD@Ha1}GHY#u&73kHiL!N6&MR6}Pci_pp*2_4gQrEc~7%x4Zh4g7(NuLswFF
zePYuy+6y~no?RBt*<-kA)218p3FU9*$5M_z#x=WbntnAV6LmY4IkH7C1+F`B@vO%l
z`3(miLFKf`w^~2(&HT_S@y7(oyu6N>qc7T9f2P5rgO~S1pRkEX?NQ$V38M{PWZez9
z`x09dyM~iI3wGW(^?dhke4y3BYvV1f2;}@1qD&PeED|*xoLh9z?(3ZM@lXxoU&X~F
LPsN<LdguQG)kZm5

literal 0
HcmV?d00001

diff --git a/reference/html/images/how-to-common-repo.png b/reference/html/images/how-to-common-repo.png
new file mode 100644
index 0000000000000000000000000000000000000000..3f4fbd5db37244ce5bd59c53f51872c9962a5d59
GIT binary patch
literal 104779
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
U?-OTH1kFKuy85}Sb4q9e0K#M_IRF3v

literal 0
HcmV?d00001

diff --git a/reference/html/images/rest-docs.png b/reference/html/images/rest-docs.png
new file mode 100644
index 0000000000000000000000000000000000000000..2ab7d3d3f104ee2611b2e4f1fc53eb57e00a2dcb
GIT binary patch
literal 55044
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
QYBNejLE}QsdDDCU0U=C-!vFvP

literal 0
HcmV?d00001

diff --git a/reference/html/index.html b/reference/html/index.html
index 8a5b0421d5..7fc936cdf6 100644
--- a/reference/html/index.html
+++ b/reference/html/index.html
@@ -5,7 +5,8 @@
 <!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <meta name="generator" content="Asciidoctor 1.5.7.1">
-<title>Spring Cloud Contract</title>
+<meta name="author" content="Adam Dudczak, Mathias Düsterhöft, Marcin Grzejszczak, Dennis Kieselhorst, Jakub Kubryński, Karol Lassak, Olga Maciaszek-Sharma, Mariusz Smykuła, Dave Syer, Jay Bryant">
+<title>Spring Cloud Contract Reference Documentation</title>
 <link rel="stylesheet" href="css/spring.css">
 <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css">
 
@@ -90,15013 +91,79 @@ $(addBlockSwitches);
 </script>
 
 </head>
-<body class="book toc2 toc-left">
+<body id="spring-cloud-contract-reference-documentation" class="book">
 <div id="header">
-<h1>Spring Cloud Contract</h1>
-<div id="toc" class="toc2">
-<div id="toctitle">Table of Contents</div>
-<ul class="sectlevel1">
-<li><a href="#_spring_cloud_contract">1. Spring Cloud Contract</a></li>
-<li><a href="#_spring_cloud_contract_verifier_introduction">2. Spring Cloud Contract Verifier Introduction</a>
-<ul class="sectlevel2">
-<li><a href="#_history">2.1. History</a></li>
-<li><a href="#_why_a_contract_verifier">2.2. Why a Contract Verifier?</a>
-<ul class="sectlevel3">
-<li><a href="#_testing_issues">2.2.1. Testing issues</a></li>
-</ul>
-</li>
-<li><a href="#_purposes">2.3. Purposes</a></li>
-<li><a href="#_how_it_works">2.4. How It Works</a>
-<ul class="sectlevel3">
-<li><a href="#spring-cloud-contract-verifier-intro-three-second-tour">2.4.1. A Three-second Tour</a></li>
-<li><a href="#spring-cloud-contract-verifier-intro-three-minute-tour">2.4.2. A Three-minute Tour</a></li>
-<li><a href="#_defining_the_contract">2.4.3. Defining the Contract</a></li>
-<li><a href="#_client_side">2.4.4. Client Side</a></li>
-<li><a href="#_server_side">2.4.5. Server Side</a></li>
-</ul>
-</li>
-<li><a href="#_step_by_step_guide_to_consumer_driven_contracts_cdc">2.5. Step-by-step Guide to Consumer Driven Contracts (CDC)</a>
-<ul class="sectlevel3">
-<li><a href="#_technical_note">2.5.1. Technical note</a></li>
-<li><a href="#_consumer_side_loan_issuance">2.5.2. Consumer side (Loan Issuance)</a></li>
-<li><a href="#_producer_side_fraud_detection_server">2.5.3. Producer side (Fraud Detection server)</a></li>
-<li><a href="#_consumer_side_loan_issuance_final_step">2.5.4. Consumer Side (Loan Issuance) Final Step</a></li>
-</ul>
-</li>
-<li><a href="#_dependencies">2.6. Dependencies</a></li>
-<li><a href="#_additional_links">2.7. Additional Links</a>
-<ul class="sectlevel3">
-<li><a href="#_spring_cloud_contract_video">2.7.1. Spring Cloud Contract video</a></li>
-<li><a href="#_readings">2.7.2. Readings</a></li>
-</ul>
-</li>
-<li><a href="#_samples">2.8. Samples</a></li>
-</ul>
-</li>
-<li><a href="#_spring_cloud_contract_faq">3. Spring Cloud Contract FAQ</a>
-<ul class="sectlevel2">
-<li><a href="#_why_use_spring_cloud_contract_verifier_and_not_x">3.1. Why use Spring Cloud Contract Verifier and not X ?</a></li>
-<li><a href="#_i_dont_want_to_write_a_contract_in_groovy">3.2. I don&#8217;t want to write a contract in Groovy!</a></li>
-<li><a href="#_what_is_this_valueconsumer_producer">3.3. What is this value(consumer(), producer()) ?</a></li>
-<li><a href="#_how_to_do_stubs_versioning">3.4. How to do Stubs versioning?</a>
-<ul class="sectlevel3">
-<li><a href="#_api_versioning">3.4.1. API Versioning</a></li>
-<li><a href="#_jar_versioning">3.4.2. JAR versioning</a></li>
-<li><a href="#_dev_or_prod_stubs">3.4.3. Dev or prod stubs</a></li>
-</ul>
-</li>
-<li><a href="#_common_repo_with_contracts">3.5. Common repo with contracts</a>
-<ul class="sectlevel3">
-<li><a href="#_repo_structure">3.5.1. Repo structure</a></li>
-<li><a href="#_workflow">3.5.2. Workflow</a></li>
-<li><a href="#_consumer">3.5.3. Consumer</a></li>
-<li><a href="#_producer">3.5.4. Producer</a></li>
-<li><a href="#_how_can_i_define_messaging_contracts_per_topic_not_per_producer">3.5.5. How can I define messaging contracts per topic not per producer?</a></li>
-</ul>
-</li>
-<li><a href="#_do_i_need_a_binary_storage_cant_i_use_git">3.6. Do I need a Binary Storage? Can&#8217;t I use Git?</a>
-<ul class="sectlevel3">
-<li><a href="#_protocol_convention">3.6.1. Protocol convention</a></li>
-<li><a href="#_producer_2">3.6.2. Producer</a></li>
-<li><a href="#_producer_with_contracts_stored_locally">3.6.3. Producer with contracts stored locally</a></li>
-<li><a href="#_consumer_2">3.6.4. Consumer</a></li>
-</ul>
-</li>
-<li><a href="#_can_i_use_the_pact_broker">3.7. Can I use the Pact Broker?</a>
-<ul class="sectlevel3">
-<li><a href="#_pact_consumer">3.7.1. Pact Consumer</a></li>
-<li><a href="#_producer_3">3.7.2. Producer</a></li>
-<li><a href="#_pact_consumer_producer_contract_approach">3.7.3. Pact Consumer (Producer Contract approach)</a></li>
-</ul>
-</li>
-<li><a href="#_how_can_i_debug_the_requestresponse_being_sent_by_the_generated_tests_client">3.8. How can I debug the request/response being sent by the generated tests client?</a>
-<ul class="sectlevel3">
-<li><a href="#_how_can_i_debug_the_mappingrequestresponse_being_sent_by_wiremock">3.8.1. How can I debug the mapping/request/response being sent by WireMock?</a></li>
-<li><a href="#_how_can_i_see_what_got_registered_in_the_http_server_stub">3.8.2. How can I see what got registered in the HTTP server stub?</a></li>
-<li><a href="#_can_i_reference_text_from_file">3.8.3. Can I reference text from file?</a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li><a href="#_spring_cloud_contract_verifier_setup">4. Spring Cloud Contract Verifier Setup</a>
-<ul class="sectlevel2">
-<li><a href="#gradle-project">4.1. Gradle Project</a>
-<ul class="sectlevel3">
-<li><a href="#gradle-prerequisites">4.1.1. Prerequisites</a></li>
-<li><a href="#gradle-add-gradle-plugin">4.1.2. Add Gradle Plugin with Dependencies</a></li>
-<li><a href="#gradle-and-rest-assured">4.1.3. Gradle and Rest Assured 2.0</a></li>
-<li><a href="#gradle-snapshot-versions">4.1.4. Snapshot Versions for Gradle</a></li>
-<li><a href="#gradle-add-stubs">4.1.5. Add stubs</a></li>
-<li><a href="#gradle-run-plugin">4.1.6. Run the Plugin</a></li>
-<li><a href="#gradle-default-setup">4.1.7. Default Setup</a></li>
-<li><a href="#gradle-configure-plugin">4.1.8. Configure Plugin</a></li>
-<li><a href="#gradle-configuration-options">4.1.9. Configuration Options</a></li>
-<li><a href="#gradle-single-base-class">4.1.10. Single Base Class for All Tests</a></li>
-<li><a href="#gradle-different-base-classes">4.1.11. Different Base Classes for Contracts</a></li>
-<li><a href="#gradle-invoking-generated-tests">4.1.12. Invoking Generated Tests</a></li>
-<li><a href="#gradle-pushing-stubs-to-scm">4.1.13. Pushing stubs to SCM</a></li>
-<li><a href="#gradle-consumer">4.1.14. Spring Cloud Contract Verifier on the Consumer Side</a></li>
-</ul>
-</li>
-<li><a href="#maven-project">4.2. Maven Project</a>
-<ul class="sectlevel3">
-<li><a href="#maven-add-plugin">4.2.1. Add maven plugin</a></li>
-<li><a href="#maven-rest-assured">4.2.2. Maven and Rest Assured 2.0</a></li>
-<li><a href="#maven-snapshot-versions">4.2.3. Snapshot versions for Maven</a></li>
-<li><a href="#maven-add-stubs">4.2.4. Add stubs</a></li>
-<li><a href="#maven-run-plugin">4.2.5. Run plugin</a></li>
-<li><a href="#maven-configure-plugin">4.2.6. Configure plugin</a></li>
-<li><a href="#maven-configuration-options">4.2.7. Configuration Options</a></li>
-<li><a href="#maven-single-base">4.2.8. Single Base Class for All Tests</a></li>
-<li><a href="#maven-different-base">4.2.9. Different base classes for contracts</a></li>
-<li><a href="#maven-invoking-generated-tests">4.2.10. Invoking generated tests</a></li>
-<li><a href="#maven-pushing-stubs-to-scm">4.2.11. Pushing stubs to SCM</a></li>
-<li><a href="#maven-sts">4.2.12. Maven Plugin and STS</a></li>
-<li><a href="#_maven_plugin_with_spock_tests">4.2.13. Maven Plugin with Spock Tests</a></li>
-</ul>
-</li>
-<li><a href="#_stubs_and_transitive_dependencies">4.3. Stubs and Transitive Dependencies</a></li>
-<li><a href="#_scenarios">4.4. Scenarios</a></li>
-<li><a href="#docker-project">4.5. Docker Project</a>
-<ul class="sectlevel3">
-<li><a href="#_short_intro_to_maven_jars_and_binary_storage">4.5.1. Short intro to Maven, JARs and Binary storage</a></li>
-<li><a href="#_how_it_works_2">4.5.2. How it works</a></li>
-<li><a href="#_example_of_usage">4.5.3. Example of usage</a></li>
-<li><a href="#docker-server-side">4.5.4. Server side (nodejs)</a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li><a href="#_spring_cloud_contract_verifier_messaging">5. Spring Cloud Contract Verifier Messaging</a>
-<ul class="sectlevel2">
-<li><a href="#_integrations">5.1. Integrations</a></li>
-<li><a href="#_manual_integration_testing">5.2. Manual Integration Testing</a></li>
-<li><a href="#_publisher_side_test_generation">5.3. Publisher-Side Test Generation</a>
-<ul class="sectlevel3">
-<li><a href="#_scenario_1_no_input_message">5.3.1. Scenario 1: No Input Message</a></li>
-<li><a href="#_scenario_2_output_triggered_by_input">5.3.2. Scenario 2: Output Triggered by Input</a></li>
-<li><a href="#_scenario_3_no_output_message">5.3.3. Scenario 3: No Output Message</a></li>
-</ul>
-</li>
-<li><a href="#_consumer_stub_generation">5.4. Consumer Stub Generation</a></li>
-</ul>
-</li>
-<li><a href="#_spring_cloud_contract_stub_runner">6. Spring Cloud Contract Stub Runner</a>
-<ul class="sectlevel2">
-<li><a href="#_snapshot_versions">6.1. Snapshot versions</a></li>
-<li><a href="#publishing-stubs-as-jars">6.2. Publishing Stubs as JARs</a></li>
-<li><a href="#_stub_runner_core">6.3. Stub Runner Core</a>
-<ul class="sectlevel3">
-<li><a href="#_retrieving_stubs">6.3.1. Retrieving stubs</a></li>
-<li><a href="#_running_stubs">6.3.2. Running stubs</a></li>
-</ul>
-</li>
-<li><a href="#_stub_runner_junit_rule_and_stub_runner_junit5_extension">6.4. Stub Runner JUnit Rule and Stub Runner JUnit5 Extension</a>
-<ul class="sectlevel3">
-<li><a href="#_maven_settings">6.4.1. Maven settings</a></li>
-<li><a href="#_providing_fixed_ports">6.4.2. Providing fixed ports</a></li>
-<li><a href="#_fluent_api">6.4.3. Fluent API</a></li>
-<li><a href="#_stub_runner_with_spring">6.4.4. Stub Runner with Spring</a></li>
-</ul>
-</li>
-<li><a href="#_stub_runner_spring_cloud">6.5. Stub Runner Spring Cloud</a>
-<ul class="sectlevel3">
-<li><a href="#_stubbing_service_discovery">6.5.1. Stubbing Service Discovery</a></li>
-<li><a href="#_additional_configuration">6.5.2. Additional Configuration</a></li>
-</ul>
-</li>
-<li><a href="#_stub_runner_boot_application">6.6. Stub Runner Boot Application</a>
-<ul class="sectlevel3">
-<li><a href="#_how_to_use_it">6.6.1. How to use it?</a></li>
-<li><a href="#_endpoints">6.6.2. Endpoints</a></li>
-<li><a href="#_example">6.6.3. Example</a></li>
-<li><a href="#_stub_runner_boot_with_service_discovery">6.6.4. Stub Runner Boot with Service Discovery</a></li>
-</ul>
-</li>
-<li><a href="#_stubs_per_consumer">6.7. Stubs Per Consumer</a></li>
-<li><a href="#_common">6.8. Common</a>
-<ul class="sectlevel3">
-<li><a href="#common-properties-junit-spring">6.8.1. Common Properties for JUnit and Spring</a></li>
-<li><a href="#stub-runner-stub-ids">6.8.2. Stub Runner Stubs IDs</a></li>
-</ul>
-</li>
-<li><a href="#stubrunner-docker">6.9. Stub Runner Docker</a>
-<ul class="sectlevel3">
-<li><a href="#_how_to_use_it_2">6.9.1. How to use it</a></li>
-<li><a href="#_example_of_client_side_usage_in_a_non_jvm_project">6.9.2. Example of client side usage in a non JVM project</a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li><a href="#stub-runner-for-messaging">7. Stub Runner for Messaging</a>
-<ul class="sectlevel2">
-<li><a href="#_stub_triggering">7.1. Stub triggering</a>
-<ul class="sectlevel3">
-<li><a href="#trigger-label">7.1.1. Trigger by Label</a></li>
-<li><a href="#trigger-group-artifact-ids">7.1.2. Trigger by Group and Artifact Ids</a></li>
-<li><a href="#trigger-artifact-ids">7.1.3. Trigger by Artifact Ids</a></li>
-<li><a href="#trigger-all-messages">7.1.4. Trigger All Messages</a></li>
-</ul>
-</li>
-<li><a href="#_stub_runner_camel">7.2. Stub Runner Camel</a>
-<ul class="sectlevel3">
-<li><a href="#_adding_it_to_the_project">7.2.1. Adding it to the project</a></li>
-<li><a href="#_disabling_the_functionality">7.2.2. Disabling the functionality</a></li>
-<li><a href="#_examples">7.2.3. Examples</a></li>
-</ul>
-</li>
-<li><a href="#_stub_runner_integration">7.3. Stub Runner Integration</a>
-<ul class="sectlevel3">
-<li><a href="#_adding_the_runner_to_the_project">7.3.1. Adding the Runner to the Project</a></li>
-<li><a href="#_disabling_the_functionality_2">7.3.2. Disabling the functionality</a></li>
-</ul>
-</li>
-<li><a href="#_stub_runner_stream">7.4. Stub Runner Stream</a>
-<ul class="sectlevel3">
-<li><a href="#_adding_the_runner_to_the_project_2">7.4.1. Adding the Runner to the Project</a></li>
-<li><a href="#_disabling_the_functionality_3">7.4.2. Disabling the functionality</a></li>
-</ul>
-</li>
-<li><a href="#_stub_runner_spring_amqp">7.5. Stub Runner Spring AMQP</a>
-<ul class="sectlevel3">
-<li><a href="#_adding_the_runner_to_the_project_3">7.5.1. Adding the Runner to the Project</a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li><a href="#contract-dsl">8. Contract DSL</a>
-<ul class="sectlevel2">
-<li><a href="#_limitations">8.1. Limitations</a></li>
-<li><a href="#_common_top_level_elements">8.2. Common Top-Level elements</a>
-<ul class="sectlevel3">
-<li><a href="#contract-dsl-description">8.2.1. Description</a></li>
-<li><a href="#contract-dsl-name">8.2.2. Name</a></li>
-<li><a href="#contract-dsl-ignoring-contracts">8.2.3. Ignoring Contracts</a></li>
-<li><a href="#contract-dsl-passing-values-from-files">8.2.4. Passing Values from Files</a></li>
-<li><a href="#contract-dsl-http-top-level-elements">8.2.5. HTTP Top-Level Elements</a></li>
-</ul>
-</li>
-<li><a href="#_request">8.3. Request</a></li>
-<li><a href="#_response">8.4. Response</a></li>
-<li><a href="#_dynamic_properties">8.5. Dynamic properties</a>
-<ul class="sectlevel3">
-<li><a href="#_dynamic_properties_inside_the_body">8.5.1. Dynamic properties inside the body</a></li>
-<li><a href="#_regular_expressions">8.5.2. Regular expressions</a></li>
-<li><a href="#_passing_optional_parameters">8.5.3. Passing Optional Parameters</a></li>
-<li><a href="#_executing_custom_methods_on_the_server_side">8.5.4. Executing Custom Methods on the Server Side</a></li>
-<li><a href="#_referencing_the_request_from_the_response">8.5.5. Referencing the Request from the Response</a></li>
-<li><a href="#_registering_your_own_wiremock_extension">8.5.6. Registering Your Own WireMock Extension</a></li>
-<li><a href="#contract-matchers">8.5.7. Dynamic Properties in the Matchers Sections</a></li>
-</ul>
-</li>
-<li><a href="#_jax_rs_support">8.6. JAX-RS Support</a></li>
-<li><a href="#_async_support">8.7. Async Support</a></li>
-<li><a href="#_working_with_context_paths">8.8. Working with Context Paths</a></li>
-<li><a href="#_working_with_webflux">8.9. Working with WebFlux</a>
-<ul class="sectlevel3">
-<li><a href="#_webflux_with_webtestclient">8.9.1. WebFlux with WebTestClient</a></li>
-<li><a href="#_webflux_with_explicit_mode">8.9.2. WebFlux with Explicit mode</a></li>
-</ul>
-</li>
-<li><a href="#_xml_support_for_rest">8.10. XML Support for REST</a></li>
-<li><a href="#_messaging_top_level_elements">8.11. Messaging Top-Level Elements</a>
-<ul class="sectlevel3">
-<li><a href="#contract-dsl-output-triggered-method">8.11.1. Output Triggered by a Method</a></li>
-<li><a href="#contract-dsl-output-triggered-message">8.11.2. Output Triggered by a Message</a></li>
-<li><a href="#contract-dsl-consumer-producer">8.11.3. Consumer/Producer</a></li>
-<li><a href="#contract-dsl-common">8.11.4. Common</a></li>
-</ul>
-</li>
-<li><a href="#_multiple_contracts_in_one_file">8.12. Multiple Contracts in One File</a></li>
-<li><a href="#_generating_spring_rest_docs_snippets_from_the_contracts">8.13. Generating Spring REST Docs snippets from the contracts</a></li>
-</ul>
-</li>
-<li><a href="#_customization">9. Customization</a>
-<ul class="sectlevel2">
-<li><a href="#_extending_the_dsl">9.1. Extending the DSL</a>
-<ul class="sectlevel3">
-<li><a href="#_common_jar">9.1.1. Common JAR</a></li>
-<li><a href="#_adding_the_dependency_to_the_project">9.1.2. Adding the Dependency to the Project</a></li>
-<li><a href="#_test_the_dependency_in_the_projects_dependencies">9.1.3. Test the Dependency in the Project&#8217;s Dependencies</a></li>
-<li><a href="#_test_a_dependency_in_the_plugins_dependencies">9.1.4. Test a Dependency in the Plugin&#8217;s Dependencies</a></li>
-<li><a href="#_referencing_classes_in_dsls">9.1.5. Referencing classes in DSLs</a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li><a href="#_using_the_pluggable_architecture">10. Using the Pluggable Architecture</a>
-<ul class="sectlevel2">
-<li><a href="#_custom_contract_converter">10.1. Custom Contract Converter</a>
-<ul class="sectlevel3">
-<li><a href="#pact-converter">10.1.1. Pact Converter</a></li>
-<li><a href="#_pact_contract">10.1.2. Pact Contract</a></li>
-<li><a href="#_pact_for_producers">10.1.3. Pact for Producers</a></li>
-<li><a href="#_pact_for_consumers">10.1.4. Pact for Consumers</a></li>
-</ul>
-</li>
-<li><a href="#_using_the_custom_test_generator">10.2. Using the Custom Test Generator</a></li>
-<li><a href="#_using_the_custom_stub_generator">10.3. Using the Custom Stub Generator</a></li>
-<li><a href="#_using_the_custom_stub_runner">10.4. Using the Custom Stub Runner</a></li>
-<li><a href="#_using_the_custom_stub_downloader">10.5. Using the Custom Stub Downloader</a></li>
-<li><a href="#scm-stub-downloader">10.6. Using the SCM Stub Downloader</a></li>
-<li><a href="#pact-stub-downloader">10.7. Using the Pact Stub Downloader</a></li>
-</ul>
-</li>
-<li><a href="#_spring_cloud_contract_wiremock">11. Spring Cloud Contract WireMock</a>
-<ul class="sectlevel2">
-<li><a href="#_registering_stubs_automatically">11.1. Registering Stubs Automatically</a></li>
-<li><a href="#_using_files_to_specify_the_stub_bodies">11.2. Using Files to Specify the Stub Bodies</a></li>
-<li><a href="#_alternative_using_junit_rules">11.3. Alternative: Using JUnit Rules</a></li>
-<li><a href="#_relaxed_ssl_validation_for_rest_template">11.4. Relaxed SSL Validation for Rest Template</a></li>
-<li><a href="#_wiremock_and_spring_mvc_mocks">11.5. WireMock and Spring MVC Mocks</a></li>
-<li><a href="#_customization_of_wiremock_configuration">11.6. Customization of WireMock configuration</a></li>
-<li><a href="#_generating_stubs_using_rest_docs">11.7. Generating Stubs using REST Docs</a></li>
-<li><a href="#_generating_contracts_by_using_rest_docs">11.8. Generating Contracts by Using REST Docs</a></li>
-</ul>
-</li>
-<li><a href="#_migrations">12. Migrations</a>
-<ul class="sectlevel2">
-<li><a href="#cloud-verifier-1.0-1.1">12.1. 1.0.x &#8594; 1.1.x</a>
-<ul class="sectlevel3">
-<li><a href="#_new_structure_of_generated_stubs">12.1.1. New structure of generated stubs</a></li>
-</ul>
-</li>
-<li><a href="#cloud-verifier-1.1-1.2">12.2. 1.1.x &#8594; 1.2.x</a>
-<ul class="sectlevel3">
-<li><a href="#_custom_httpserverstub">12.2.1. Custom <code>HttpServerStub</code></a></li>
-<li><a href="#_new_packages_for_generated_tests">12.2.2. New packages for generated tests</a></li>
-<li><a href="#_new_methods_in_templateprocessor">12.2.3. New Methods in TemplateProcessor</a></li>
-<li><a href="#_restassured_3_0">12.2.4. RestAssured 3.0</a></li>
-</ul>
-</li>
-<li><a href="#cloud-verifier-1.2-2.0">12.3. 1.2.x &#8594; 2.0.x</a></li>
-</ul>
-</li>
-<li><a href="#_links">13. Links</a></li>
-</ul>
+<h1>Spring Cloud Contract Reference Documentation</h1>
+<div class="details">
+<span id="author" class="author">Adam Dudczak, Mathias Düsterhöft, Marcin Grzejszczak, Dennis Kieselhorst, Jakub Kubryński, Karol Lassak, Olga Maciaszek-Sharma, Mariusz Smykuła, Dave Syer, Jay Bryant</span><br>
 </div>
 </div>
 <div id="content">
 <div id="preamble">
 <div class="sectionbody">
 <div class="paragraph">
-<p><em>Documentation Authors: Adam Dudczak, Mathias Düsterhöft, Marcin Grzejszczak, Dennis Kieselhorst, Jakub Kubryński, Karol Lassak,
-Olga Maciaszek-Sharma, Mariusz Smykuła, Dave Syer, Jay Bryant</em></p>
+<p>The reference documentation consists of the following sections:</p>
 </div>
-<div class="paragraph">
-<p>2.2.0.BUILD-SNAPSHOT</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_spring_cloud_contract"><a class="link" href="#_spring_cloud_contract">1. Spring Cloud Contract</a></h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>You need confidence when pushing new features to a new application or service in a
-distributed system. This project provides support for Consumer Driven Contracts and
-service schemas in Spring applications (for both HTTP and message-based interactions),
-covering a range of options for writing tests,  publishing them as assets, and asserting
-that a contract is kept by producers and consumers.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_spring_cloud_contract_verifier_introduction"><a class="link" href="#_spring_cloud_contract_verifier_introduction">2. Spring Cloud Contract Verifier Introduction</a></h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Spring Cloud Contract Verifier enables Consumer Driven Contract (CDC) development of
-JVM-based applications. It moves TDD to the level of software architecture.</p>
-</div>
-<div class="paragraph">
-<p>Spring Cloud Contract Verifier ships with <em>Contract Definition Language</em> (CDL). Contract
-definitions are used to produce the following resources:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>JSON stub definitions to be used by WireMock when doing integration testing on the
-client code (<em>client tests</em>). Test code must still be written by hand, and test data is
-produced by Spring Cloud Contract Verifier.</p>
-</li>
-<li>
-<p>Messaging routes, if you&#8217;re using a messaging service. We integrate with Spring
-Integration, Spring Cloud Stream, Spring AMQP, and Apache Camel. You can also set your
-own integrations.</p>
-</li>
-<li>
-<p>Acceptance tests (in JUnit 4, JUnit 5, TestNG or Spock) are used to verify if server-side implementation
-of the API is compliant with the contract (<em>server tests</em>). A full test is generated by
-Spring Cloud Contract Verifier.</p>
-</li>
-</ul>
-</div>
-<div class="sect2">
-<h3 id="_history"><a class="link" href="#_history">2.1. History</a></h3>
-<div class="paragraph">
-<p>Before becoming Spring Cloud Contract, this project was called <a href="https://github.com/Codearte/accurest">Accurest</a>.
-It was created by <a href="https://twitter.com/mgrzejszczak">Marcin Grzejszczak</a> and <a href="https://twitter.com/jkubrynski">Jakub Kubrynski</a>
-from (<a href="https://github.com/Codearte">Codearte</a>.</p>
-</div>
-<div class="paragraph">
-<p>The <code>0.1.0</code> release took place on 26 Jan 2015 and it became stable with <code>1.0.0</code> release on 29 Feb 2016.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_why_a_contract_verifier"><a class="link" href="#_why_a_contract_verifier">2.2. Why a Contract Verifier?</a></h3>
-<div class="paragraph">
-<p>Assume that we have a system consisting of multiple microservices:</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="https://raw.githubusercontent.com/spring-cloud/spring-cloud-contract/master/docs/src/main/asciidoc/images/Deps.png" alt="Microservices Architecture">
-</div>
-</div>
-<div class="sect3">
-<h4 id="_testing_issues"><a class="link" href="#_testing_issues">2.2.1. Testing issues</a></h4>
-<div class="paragraph">
-<p>If we wanted to test the application in top left corner to determine whether it can
-communicate with other services, we could do one of two things:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Deploy all microservices and perform end-to-end tests.</p>
-</li>
-<li>
-<p>Mock other microservices in unit/integration tests.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Both have their advantages but also a lot of disadvantages.</p>
-</div>
-<div class="paragraph">
-<p><strong>Deploy all microservices and perform end to end tests</strong></p>
-</div>
-<div class="paragraph">
-<p>Advantages:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Simulates production.</p>
-</li>
-<li>
-<p>Tests real communication between services.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Disadvantages:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>To test one microservice, we have to deploy 6 microservices, a couple of databases,
-etc.</p>
-</li>
-<li>
-<p>The environment where the tests run is locked for a single suite of tests (nobody else
-would be able to run the tests in the meantime).</p>
-</li>
-<li>
-<p>They take a long time to run.</p>
-</li>
-<li>
-<p>The feedback comes very late in the process.</p>
-</li>
-<li>
-<p>They are extremely hard to debug.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><strong>Mock other microservices in unit/integration tests</strong></p>
-</div>
-<div class="paragraph">
-<p>Advantages:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>They provide very fast feedback.</p>
-</li>
-<li>
-<p>They have no infrastructure requirements.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Disadvantages:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The implementor of the service creates stubs that might have nothing to do with
-reality.</p>
-</li>
-<li>
-<p>You can go to production with passing tests and failing production.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>To solve the aforementioned issues, Spring Cloud Contract Verifier with Stub Runner was
-created. The main idea is to give you very fast feedback, without the need to set up the
-whole world of microservices. If you work on stubs, then the only applications you need
-are those that your application directly uses.</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="https://raw.githubusercontent.com/spring-cloud/spring-cloud-contract/master/docs/src/main/asciidoc/images/Stubs2.png" alt="Stubbed Services">
-</div>
-</div>
-<div class="paragraph">
-<p>Spring Cloud Contract Verifier gives you the certainty that the stubs that you use were
-created by the service that you&#8217;re calling. Also, if you can use them, it means that they
-were tested against the producer&#8217;s side. In short, you can trust those stubs.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_purposes"><a class="link" href="#_purposes">2.3. Purposes</a></h3>
-<div class="paragraph">
-<p>The main purposes of Spring Cloud Contract Verifier with Stub Runner are:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>To ensure that WireMock/Messaging stubs (used when developing the client) do exactly
-what the actual server-side implementation does.</p>
-</li>
-<li>
-<p>To promote ATDD method and Microservices architectural style.</p>
-</li>
-<li>
-<p>To provide a way to publish changes in contracts that are immediately visible on both
-sides.</p>
-</li>
-<li>
-<p>To generate boilerplate test code to be used on the server side.</p>
-</li>
-</ul>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-Spring Cloud Contract Verifier&#8217;s purpose is NOT to start writing business
-features in the contracts. Assume that we have a business use case of fraud check. If a
-user can be a fraud for 100 different reasons, we would assume that you would create 2
-contracts, one for the positive case and one for the negative case. Contract tests are
-used to test contracts between applications and not to simulate full behavior.
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_how_it_works"><a class="link" href="#_how_it_works">2.4. How It Works</a></h3>
-<div class="paragraph">
-<p>This section explores how Spring Cloud Contract Verifier with Stub Runner works.</p>
-</div>
-<div class="sect3">
-<h4 id="spring-cloud-contract-verifier-intro-three-second-tour"><a class="link" href="#spring-cloud-contract-verifier-intro-three-second-tour">2.4.1. A Three-second Tour</a></h4>
-<div class="paragraph">
-<p>This very brief tour walks through using Spring Cloud Contract:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="#spring-cloud-contract-verifier-intro-three-second-tour-producer">On the Producer Side</a></p>
-</li>
-<li>
-<p><a href="#spring-cloud-contract-verifier-intro-three-second-tour-consumer">On the Consumer Side</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>You can find a somewhat longer tour
-<a href="#spring-cloud-contract-verifier-intro-three-minute-tour">here</a>.</p>
-</div>
-<div class="sect4">
-<h5 id="spring-cloud-contract-verifier-intro-three-second-tour-producer"><a class="link" href="#spring-cloud-contract-verifier-intro-three-second-tour-producer">On the Producer Side</a></h5>
-<div class="paragraph">
-<p>To start working with Spring Cloud Contract, add files with <code>REST/</code> messaging contracts
-expressed in either Groovy DSL or YAML to the contracts directory, which is set by the
-<code>contractsDslDir</code> property. By default, it is <code>$rootDir/src/test/resources/contracts</code>.</p>
-</div>
-<div class="paragraph">
-<p>Then add the Spring Cloud Contract Verifier dependency and plugin to your build file, as
-shown in the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
-	&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-cloud-starter-contract-verifier&lt;/artifactId&gt;
-	&lt;scope&gt;test&lt;/scope&gt;
-&lt;/dependency&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following listing shows how to add the plugin, which should go in the build/plugins
-portion of the file:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-	&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-	&lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-	&lt;extensions&gt;true&lt;/extensions&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Running <code>./mvnw clean install</code> automatically generates tests that verify the application
-compliance with the added contracts. By default, the tests get generated under
-<code>org.springframework.cloud.contract.verifier.tests.</code>.</p>
-</div>
-<div class="paragraph">
-<p>As the implementation of the functionalities described by the contracts is not yet
-present, the tests fail.</p>
-</div>
-<div class="paragraph">
-<p>To make them pass, you must add the correct implementation of either handling HTTP
-requests or messages. Also, you must add a correct base test class for auto-generated
-tests to the project. This class is extended by all the auto-generated tests, and it
-should contain all the setup necessary to run them (for example <code>RestAssuredMockMvc</code>
-controller setup or messaging test setup).</p>
-</div>
-<div class="paragraph">
-<p>Once the implementation and the test base class are in place, the tests pass, and both the
-application and the stub artifacts are built and installed in the local Maven repository.
-The changes can now be merged, and both the application and the stub artifacts may be
-published in an online repository.</p>
-</div>
-</div>
-<div class="sect4">
-<h5 id="spring-cloud-contract-verifier-intro-three-second-tour-consumer"><a class="link" href="#spring-cloud-contract-verifier-intro-three-second-tour-consumer">On the Consumer Side</a></h5>
-<div class="paragraph">
-<p><code>Spring Cloud Contract Stub Runner</code> can be used in the integration tests to get a running
-WireMock instance or messaging route that simulates the actual service.</p>
-</div>
-<div class="paragraph">
-<p>To do so, add the dependency to <code>Spring Cloud Contract Stub Runner</code>, as shown in the
-following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
-	&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-cloud-starter-contract-stub-runner&lt;/artifactId&gt;
-	&lt;scope&gt;test&lt;/scope&gt;
-&lt;/dependency&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can get the Producer-side stubs installed in your Maven repository in either of two
-ways:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>By checking out the Producer side repository and adding contracts and generating the stubs
-by running the following commands:</p>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ cd local-http-server-repo
-$ ./mvnw clean install -DskipTests</code></pre>
-</div>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-The tests are being skipped because the Producer-side contract implementation is not
-in place yet, so the automatically-generated contract tests fail.
-</td>
-</tr>
-</table>
-</div>
-</li>
-<li>
-<p>By getting already-existing producer service stubs from a remote repository. To do so,
-pass the stub artifact IDs and artifact repository URL as <code>Spring Cloud Contract
-Stub Runner</code> properties, as shown in the following example:</p>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">stubrunner:
-  ids: 'com.example:http-server-dsl:+:stubs:8080'
-  repositoryRoot: https://repo.spring.io/libs-snapshot</code></pre>
-</div>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Now you can annotate your test class with <code>@AutoConfigureStubRunner</code>. In the annotation,
-provide the <code>group-id</code> and <code>artifact-id</code> values for <code>Spring Cloud Contract Stub Runner</code> to
-run the collaborators' stubs for you, as shown in the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
-@SpringBootTest(webEnvironment=WebEnvironment.NONE)
-@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:stubs:6565"},
-		stubsMode = StubRunnerProperties.StubsMode.LOCAL)
-public class LoanApplicationServiceTests {</code></pre>
-</div>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-Use the <code>REMOTE</code> <code>stubsMode</code> when downloading stubs from an online repository and
-<code>LOCAL</code> for offline work.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>Now, in your integration test, you can receive stubbed versions of HTTP responses or
-messages that are expected to be emitted by the collaborator service.</p>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="spring-cloud-contract-verifier-intro-three-minute-tour"><a class="link" href="#spring-cloud-contract-verifier-intro-three-minute-tour">2.4.2. A Three-minute Tour</a></h4>
-<div class="paragraph">
-<p>This brief tour walks through using Spring Cloud Contract:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="#spring-cloud-contract-verifier-intro-three-minute-tour-producer">On the Producer Side</a></p>
-</li>
-<li>
-<p><a href="#spring-cloud-contract-verifier-intro-three-minute-tour-consumer">On the Consumer Side</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>You can find an even more brief tour
-<a href="#spring-cloud-contract-verifier-intro-three-second-tour">here</a>.</p>
-</div>
-<div class="sect4">
-<h5 id="spring-cloud-contract-verifier-intro-three-minute-tour-producer"><a class="link" href="#spring-cloud-contract-verifier-intro-three-minute-tour-producer">On the Producer Side</a></h5>
-<div class="paragraph">
-<p>To start working with <code>Spring Cloud Contract</code>, add files with <code>REST/</code> messaging contracts
-expressed in either Groovy DSL or YAML to the contracts directory, which is set by the
-<code>contractsDslDir</code> property. By default, it is <code>$rootDir/src/test/resources/contracts</code>.</p>
-</div>
-<div class="paragraph">
-<p>For the HTTP stubs, a contract defines what kind of response should be returned for a
-given request (taking into account the HTTP methods, URLs, headers, status codes, and so
-on). The following example shows how an HTTP stub contract in Groovy DSL:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package contracts
-
-org.springframework.cloud.contract.spec.Contract.make {
-	request {
-		method 'PUT'
-		url '/fraudcheck'
-		body([
-			   "client.id": $(regex('[0-9]{10}')),
-			   loanAmount: 99999
-		])
-		headers {
-			contentType('application/json')
-		}
-	}
-	response {
-		status OK()
-		body([
-			   fraudCheckStatus: "FRAUD",
-			   "rejection.reason": "Amount too high"
-		])
-		headers {
-			contentType('application/json')
-		}
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The same contract expressed in YAML would look like the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">request:
-  method: PUT
-  url: /fraudcheck
-  body:
-    "client.id": 1234567890
-    loanAmount: 99999
-  headers:
-    Content-Type: application/json
-  matchers:
-    body:
-      - path: $.['client.id']
-        type: by_regex
-        value: "[0-9]{10}"
-response:
-  status: 200
-  body:
-    fraudCheckStatus: "FRAUD"
-    "rejection.reason": "Amount too high"
-  headers:
-    Content-Type: application/json;charset=UTF-8</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In the case of messaging, you can define:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>The input and the output messages can be defined (taking into account from and where it
-was sent, the message body, and the header).</p>
-</li>
-<li>
-<p>The methods that should be called after the message is received.</p>
-</li>
-<li>
-<p>The methods that, when called, should trigger a message.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The following example shows a Camel messaging contract expressed in Groovy DSL:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">			def contractDsl = Contract.make {
-				name "foo"
-				label 'some_label'
-				input {
-					messageFrom('jms:delete')
-					messageBody([
-							bookName: 'foo'
-					])
-					messageHeaders {
-						header('sample', 'header')
-					}
-					assertThat('bookWasDeleted()')
-				}
-			}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following example shows the same contract expressed in YAML:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">label: some_label
-input:
-  messageFrom: jms:delete
-  messageBody:
-    bookName: 'foo'
-  messageHeaders:
-    sample: header
-  assertThat: bookWasDeleted()</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Then you can add Spring Cloud Contract Verifier dependency and plugin to your build file,
-as shown in the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
-	&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-cloud-starter-contract-verifier&lt;/artifactId&gt;
-	&lt;scope&gt;test&lt;/scope&gt;
-&lt;/dependency&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following listing shows how to add the plugin, which should go in the build/plugins
-portion of the file:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-	&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-	&lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-	&lt;extensions&gt;true&lt;/extensions&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Running <code>./mvnw clean install</code> automatically generates tests that verify the application
-compliance with the added contracts. By default, the generated tests are under
-<code>org.springframework.cloud.contract.verifier.tests.</code>.</p>
-</div>
-<div class="paragraph">
-<p>The following example shows a sample auto-generated test for an HTTP contract:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
-public void validate_shouldMarkClientAsFraud() throws Exception {
-    // given:
-        MockMvcRequestSpecification request = given()
-                .header("Content-Type", "application/vnd.fraud.v1+json")
-                .body("{\"client.id\":\"1234567890\",\"loanAmount\":99999}");
-
-    // when:
-        ResponseOptions response = given().spec(request)
-                .put("/fraudcheck");
-
-    // then:
-        assertThat(response.statusCode()).isEqualTo(200);
-        assertThat(response.header("Content-Type")).matches("application/vnd.fraud.v1.json.*");
-    // and:
-        DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
-        assertThatJson(parsedJson).field("['fraudCheckStatus']").matches("[A-Z]{5}");
-        assertThatJson(parsedJson).field("['rejection.reason']").isEqualTo("Amount too high");
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The preceding example uses Spring&#8217;s <code>MockMvc</code> to run the tests. This is the default test
-mode for HTTP contracts. However, JAX-RS client and explicit HTTP invocations can also be
-used. (To do so, change the <code>testMode</code> property of the plugin to <code>JAX-RS</code> or <code>EXPLICIT</code>,
-respectively.)</p>
-</div>
-<div class="paragraph">
-<p>Since 2.1.0, it is also possible to use <code>RestAssuredWebTestClient`with Spring&#8217;s reactive `WebTestClient</code>
-run under the hood. This is particularly recommended while working with Reactive, <code>Web-Flux</code>-based applications.
-In order to use <code>WebTestClient</code> set <code>testMode</code> to <code>WEBTESTCLIENT</code>.</p>
-</div>
-<div class="paragraph">
-<p>Here is an example of a test generated in <code>WEBTESTCLIENT</code> test mode:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[source,java,indent=0]</pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>@Test
-	public void validate_shouldRejectABeerIfTooYoung() throws Exception {
-		// given:
-			WebTestClientRequestSpecification request = given()
-					.header("Content-Type", "application/json")
-					.body("{\"age\":10}");
-
-		// when:
-			WebTestClientResponse response = given().spec(request)
-					.post("/check");
-
-		// then:
-			assertThat(response.statusCode()).isEqualTo(200);
-			assertThat(response.header("Content-Type")).matches("application/json.*");
-		// and:
-			DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
-			assertThatJson(parsedJson).field("['status']").isEqualTo("NOT_OK");
-	}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Apart from the default JUnit 4, you can instead use JUnit 5, TestNG or Spock tests, by setting the plugin
-<code>testFramework</code> property to either <code>JUNIT5</code>, <code>TESTNG</code> or <code>Spock</code>.</p>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-You can now also generate WireMock scenarios based on the contracts, by including an
-order number followed by an underscore at the beginning of the contract file names.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>The following example shows an auto-generated test in Spock for a messaging stub contract:</p>
-</div>
-<div class="literalblock">
-<div class="content">
-<pre>[source,groovy,indent=0]</pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>given:
-	 ContractVerifierMessage inputMessage = contractVerifierMessaging.create(
-		\'\'\'{"bookName":"foo"}\'\'\',
-		['sample': 'header']
-	)
-
-when:
-	 contractVerifierMessaging.send(inputMessage, 'jms:delete')
-
-then:
-	 noExceptionThrown()
-	 bookWasDeleted()</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>As the implementation of the functionalities described by the contracts is not yet
-present, the tests fail.</p>
-</div>
-<div class="paragraph">
-<p>To make them pass, you must add the correct implementation of handling either HTTP
-requests or messages. Also, you must add a correct base test class for auto-generated
-tests to the project. This class is extended by all the auto-generated tests and should
-contain all the setup necessary to run them (for example, <code>RestAssuredMockMvc</code> controller
-setup or messaging test setup).</p>
-</div>
-<div class="paragraph">
-<p>Once the implementation and the test base class are in place, the tests pass, and both the
-application and the stub artifacts are built and installed in the local Maven repository.
-Information about installing the stubs jar to the local repository appears in the logs, as
-shown in the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">[INFO] --- spring-cloud-contract-maven-plugin:1.0.0.BUILD-SNAPSHOT:generateStubs (default-generateStubs) @ http-server ---
-[INFO] Building jar: /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar
-[INFO]
-[INFO] --- maven-jar-plugin:2.6:jar (default-jar) @ http-server ---
-[INFO] Building jar: /some/path/http-server/target/http-server-0.0.1-SNAPSHOT.jar
-[INFO]
-[INFO] --- spring-boot-maven-plugin:1.5.5.BUILD-SNAPSHOT:repackage (default) @ http-server ---
-[INFO]
-[INFO] --- maven-install-plugin:2.5.2:install (default-install) @ http-server ---
-[INFO] Installing /some/path/http-server/target/http-server-0.0.1-SNAPSHOT.jar to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT.jar
-[INFO] Installing /some/path/http-server/pom.xml to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT.pom
-[INFO] Installing /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can now merge the changes and publish both the application and the stub artifacts
-in an online repository.</p>
-</div>
-<div class="paragraph">
-<p><strong>Docker Project</strong></p>
-</div>
-<div class="paragraph">
-<p>In order to enable working with contracts while creating applications in non-JVM
-technologies, the <code>springcloud/spring-cloud-contract</code> Docker image has been created. It
-contains a project that automatically generates tests for HTTP contracts and executes them
-in  <code>EXPLICIT</code> test mode. Then, if the tests pass, it generates Wiremock stubs and,
-optionally, publishes them to an artifact manager. In order to use the image, you can
-mount the contracts into the <code>/contracts</code> directory and set a few environment variables.</p>
-</div>
-</div>
-<div class="sect4">
-<h5 id="spring-cloud-contract-verifier-intro-three-minute-tour-consumer"><a class="link" href="#spring-cloud-contract-verifier-intro-three-minute-tour-consumer">On the Consumer Side</a></h5>
-<div class="paragraph">
-<p><code>Spring Cloud Contract Stub Runner</code> can be used in the integration tests to get a running
-WireMock instance or messaging route that simulates the actual service.</p>
-</div>
-<div class="paragraph">
-<p>To get started, add the dependency to <code>Spring Cloud Contract Stub Runner</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
-	&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-cloud-starter-contract-stub-runner&lt;/artifactId&gt;
-	&lt;scope&gt;test&lt;/scope&gt;
-&lt;/dependency&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can get the Producer-side stubs installed in your Maven repository in either of two
-ways:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>By checking out the Producer side repository and adding contracts and generating the
-stubs by running the following commands:</p>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ cd local-http-server-repo
-$ ./mvnw clean install -DskipTests</code></pre>
-</div>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-The tests are skipped because the Producer-side contract implementation is not yet
-in place, so the automatically-generated contract tests fail.
-</td>
-</tr>
-</table>
-</div>
-</li>
-<li>
-<p>Getting already existing producer service stubs from a remote repository. To do so,
-pass the stub artifact IDs and artifact repository URl as <code>Spring Cloud Contract Stub
-Runner</code> properties, as shown in the following example:</p>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">stubrunner:
-  ids: 'com.example:http-server-dsl:+:stubs:8080'
-  repositoryRoot: https://repo.spring.io/libs-snapshot</code></pre>
-</div>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Now you can annotate your test class with <code>@AutoConfigureStubRunner</code>. In the annotation,
-provide the <code>group-id</code> and <code>artifact-id</code> for <code>Spring Cloud Contract Stub Runner</code> to run
-the collaborators' stubs for you, as shown in the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
-@SpringBootTest(webEnvironment=WebEnvironment.NONE)
-@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:stubs:6565"},
-		stubsMode = StubRunnerProperties.StubsMode.LOCAL)
-public class LoanApplicationServiceTests {</code></pre>
-</div>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-Use the <code>REMOTE</code> <code>stubsMode</code> when downloading stubs from an online repository and
-<code>LOCAL</code> for offline work.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>In your integration test, you can receive stubbed versions of HTTP responses or messages
-that are expected to be emitted by the collaborator service. You can see entries similar
-to the following in the build logs:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">2016-07-19 14:22:25.403  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Desired version is + - will try to resolve the latest version
-2016-07-19 14:22:25.438  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolved version is 0.0.1-SNAPSHOT
-2016-07-19 14:22:25.439  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolving artifact com.example:http-server:jar:stubs:0.0.1-SNAPSHOT using remote repositories []
-2016-07-19 14:22:25.451  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolved artifact com.example:http-server:jar:stubs:0.0.1-SNAPSHOT to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar
-2016-07-19 14:22:25.465  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Unpacking stub from JAR [URI: file:/path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar]
-2016-07-19 14:22:25.475  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Unpacked file to [/var/folders/0p/xwq47sq106x1_g3dtv6qfm940000gq/T/contracts100276532569594265]
-2016-07-19 14:22:27.737  INFO 41050 --- [           main] o.s.c.c.stubrunner.StubRunnerExecutor    : All stubs are now running RunningStubs [namesAndPorts={com.example:http-server:0.0.1-SNAPSHOT:stubs=8080}]</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_defining_the_contract"><a class="link" href="#_defining_the_contract">2.4.3. Defining the Contract</a></h4>
-<div class="paragraph">
-<p>As consumers of services, we need to define what exactly we want to achieve. We need to
-formulate our expectations. That is why we write contracts.</p>
-</div>
-<div class="paragraph">
-<p>Assume that you want to send a request containing the ID of a client company and the
-amount it wants to borrow from us. You also want to send it to the /fraudcheck url via
-the PUT method.</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">/*
- * Copyright 2013-2019 the original author or authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package contracts
-
-org.springframework.cloud.contract.spec.Contract.make {
-	request { // (1)
-		method 'PUT' // (2)
-		url '/fraudcheck' // (3)
-		body([ // (4)
-			   "client.id": $(regex('[0-9]{10}')),
-			   loanAmount : 99999
-		])
-		headers { // (5)
-			contentType('application/json')
-		}
-	}
-	response { // (6)
-		status OK() // (7)
-		body([ // (8)
-			   fraudCheckStatus  : "FRAUD",
-			   "rejection.reason": "Amount too high"
-		])
-		headers { // (9)
-			contentType('application/json')
-		}
-	}
-}
-
-/*
-From the Consumer perspective, when shooting a request in the integration test:
-
-(1) - If the consumer sends a request
-(2) - With the "PUT" method
-(3) - to the URL "/fraudcheck"
-(4) - with the JSON body that
- * has a field `client.id` that matches a regular expression `[0-9]{10}`
- * has a field `loanAmount` that is equal to `99999`
-(5) - with header `Content-Type` equal to `application/json`
-(6) - then the response will be sent with
-(7) - status equal `200`
-(8) - and JSON body equal to
- { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
-(9) - with header `Content-Type` equal to `application/json`
-
-From the Producer perspective, in the autogenerated producer-side test:
-
-(1) - A request will be sent to the producer
-(2) - With the "PUT" method
-(3) - to the URL "/fraudcheck"
-(4) - with the JSON body that
- * has a field `client.id` that will have a generated value that matches a regular expression `[0-9]{10}`
- * has a field `loanAmount` that is equal to `99999`
-(5) - with header `Content-Type` equal to `application/json`
-(6) - then the test will assert if the response has been sent with
-(7) - status equal `200`
-(8) - and JSON body equal to
- { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
-(9) - with header `Content-Type` matching `application/json.*`
- */</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request: # (1)
-  method: PUT # (2)
-  url: /fraudcheck # (3)
-  body: # (4)
-    "client.id": 1234567890
-    loanAmount: 99999
-  headers: # (5)
-    Content-Type: application/json
-  matchers:
-    body:
-      - path: $.['client.id'] # (6)
-        type: by_regex
-        value: "[0-9]{10}"
-response: # (7)
-  status: 200 # (8)
-  body:  # (9)
-    fraudCheckStatus: "FRAUD"
-    "rejection.reason": "Amount too high"
-  headers: # (10)
-    Content-Type: application/json
-
-
-#From the Consumer perspective, when shooting a request in the integration test:
-#
-#(1) - If the consumer sends a request
-#(2) - With the "PUT" method
-#(3) - to the URL "/fraudcheck"
-#(4) - with the JSON body that
-# * has a field `client.id`
-# * has a field `loanAmount` that is equal to `99999`
-#(5) - with header `Content-Type` equal to `application/json`
-#(6) - and a `client.id` json entry matches the regular expression `[0-9]{10}`
-#(7) - then the response will be sent with
-#(8) - status equal `200`
-#(9) - and JSON body equal to
-# { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
-#(10) - with header `Content-Type` equal to `application/json`
-#
-#From the Producer perspective, in the autogenerated producer-side test:
-#
-#(1) - A request will be sent to the producer
-#(2) - With the "PUT" method
-#(3) - to the URL "/fraudcheck"
-#(4) - with the JSON body that
-# * has a field `client.id` `1234567890`
-# * has a field `loanAmount` that is equal to `99999`
-#(5) - with header `Content-Type` equal to `application/json`
-#(7) - then the test will assert if the response has been sent with
-#(8) - status equal `200`
-#(9) - and JSON body equal to
-# { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
-#(10) - with header `Content-Type` equal to `application/json`</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_client_side"><a class="link" href="#_client_side">2.4.4. Client Side</a></h4>
-<div class="paragraph">
-<p>Spring Cloud Contract generates stubs, which you can use during client-side testing.
-You get a running WireMock instance/Messaging route that simulates the service.
-You would like to feed that instance with a proper stub definition.</p>
-</div>
-<div class="paragraph">
-<p>At some point in time, you need to send a request to the Fraud Detection service.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">ResponseEntity&lt;FraudServiceResponse&gt; response = restTemplate.exchange(
-		"http://localhost:" + port + "/fraudcheck", HttpMethod.PUT,
-		new HttpEntity&lt;&gt;(request, httpHeaders), FraudServiceResponse.class);</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Annotate your test class with <code>@AutoConfigureStubRunner</code>. In the annotation provide the group id and artifact id for the Stub Runner to download stubs of your collaborators.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@RunWith(SpringRunner.class)
-@SpringBootTest(webEnvironment = WebEnvironment.NONE)
-@AutoConfigureStubRunner(ids = {
-		"com.example:http-server-dsl:+:stubs:6565" }, stubsMode = StubRunnerProperties.StubsMode.LOCAL)
-public class LoanApplicationServiceTests {</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>After that, during the tests, Spring Cloud Contract automatically finds the stubs
-(simulating the real service) in the Maven repository and exposes them on a configured
-(or random) port.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_server_side"><a class="link" href="#_server_side">2.4.5. Server Side</a></h4>
-<div class="paragraph">
-<p>Since you are developing your stub, you need to be sure that it actually resembles your
-concrete implementation. You cannot have a situation where your stub acts in one way and
-your application behaves in a different way, especially in production.</p>
-</div>
-<div class="paragraph">
-<p>To ensure that your application behaves the way you define in your stub, tests are
-generated from the stub you provide.</p>
-</div>
-<div class="paragraph">
-<p>The autogenerated test looks, more or less, like this:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
-public void validate_shouldMarkClientAsFraud() throws Exception {
-    // given:
-        MockMvcRequestSpecification request = given()
-                .header("Content-Type", "application/vnd.fraud.v1+json")
-                .body("{\"client.id\":\"1234567890\",\"loanAmount\":99999}");
-
-    // when:
-        ResponseOptions response = given().spec(request)
-                .put("/fraudcheck");
-
-    // then:
-        assertThat(response.statusCode()).isEqualTo(200);
-        assertThat(response.header("Content-Type")).matches("application/vnd.fraud.v1.json.*");
-    // and:
-        DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
-        assertThatJson(parsedJson).field("['fraudCheckStatus']").matches("[A-Z]{5}");
-        assertThatJson(parsedJson).field("['rejection.reason']").isEqualTo("Amount too high");
-}</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_step_by_step_guide_to_consumer_driven_contracts_cdc"><a class="link" href="#_step_by_step_guide_to_consumer_driven_contracts_cdc">2.5. Step-by-step Guide to Consumer Driven Contracts (CDC)</a></h3>
-<div class="paragraph">
-<p>Consider an example of Fraud Detection and the Loan Issuance process. The business
-scenario is such that we want to issue loans to people but do not want them to steal from
-us. The current implementation of our system grants loans to everybody.</p>
-</div>
-<div class="paragraph">
-<p>Assume that <code>Loan Issuance</code> is a client to the <code>Fraud Detection</code> server. In the current
-sprint, we must develop a new feature: if a client wants to borrow too much money, then
-we mark the client as a fraud.</p>
-</div>
-<div class="paragraph">
-<p>Technical remark - Fraud Detection has an <code>artifact-id</code> of <code>http-server</code>, while Loan
-Issuance has an artifact-id of <code>http-client</code>, and both have a <code>group-id</code> of <code>com.example</code>.</p>
-</div>
-<div class="paragraph">
-<p>Social remark - both client and server development teams need to communicate directly and
-discuss changes while going through the process. CDC is all about communication.</p>
-</div>
-<div class="paragraph">
-<p>The <a href="https://github.com/spring-cloud/spring-cloud-contract/tree/master/samples/standalone/dsl/http-server">server
-side code is available here</a> and <a href="https://github.com/spring-cloud/spring-cloud-contract/tree/master/samples/standalone/dsl/http-client">the
-client code here</a>.</p>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-In this case, the producer owns the contracts. Physically, all the contract are
-in the producer&#8217;s repository.
-</td>
-</tr>
-</table>
-</div>
-<div class="sect3">
-<h4 id="_technical_note"><a class="link" href="#_technical_note">2.5.1. Technical note</a></h4>
-<div class="paragraph">
-<p>If using the <strong>SNAPSHOT</strong> / <strong>Milestone</strong> / <strong>Release Candidate</strong> versions please add the
-following section to your build:</p>
-</div>
-<div class="listingblock primary">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;repositories&gt;
-	&lt;repository&gt;
-		&lt;id&gt;spring-snapshots&lt;/id&gt;
-		&lt;name&gt;Spring Snapshots&lt;/name&gt;
-		&lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
-		&lt;snapshots&gt;
-			&lt;enabled&gt;true&lt;/enabled&gt;
-		&lt;/snapshots&gt;
-	&lt;/repository&gt;
-	&lt;repository&gt;
-		&lt;id&gt;spring-milestones&lt;/id&gt;
-		&lt;name&gt;Spring Milestones&lt;/name&gt;
-		&lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
-		&lt;snapshots&gt;
-			&lt;enabled&gt;false&lt;/enabled&gt;
-		&lt;/snapshots&gt;
-	&lt;/repository&gt;
-	&lt;repository&gt;
-		&lt;id&gt;spring-releases&lt;/id&gt;
-		&lt;name&gt;Spring Releases&lt;/name&gt;
-		&lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
-		&lt;snapshots&gt;
-			&lt;enabled&gt;false&lt;/enabled&gt;
-		&lt;/snapshots&gt;
-	&lt;/repository&gt;
-&lt;/repositories&gt;
-&lt;pluginRepositories&gt;
-	&lt;pluginRepository&gt;
-		&lt;id&gt;spring-snapshots&lt;/id&gt;
-		&lt;name&gt;Spring Snapshots&lt;/name&gt;
-		&lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
-		&lt;snapshots&gt;
-			&lt;enabled&gt;true&lt;/enabled&gt;
-		&lt;/snapshots&gt;
-	&lt;/pluginRepository&gt;
-	&lt;pluginRepository&gt;
-		&lt;id&gt;spring-milestones&lt;/id&gt;
-		&lt;name&gt;Spring Milestones&lt;/name&gt;
-		&lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
-		&lt;snapshots&gt;
-			&lt;enabled&gt;false&lt;/enabled&gt;
-		&lt;/snapshots&gt;
-	&lt;/pluginRepository&gt;
-	&lt;pluginRepository&gt;
-		&lt;id&gt;spring-releases&lt;/id&gt;
-		&lt;name&gt;Spring Releases&lt;/name&gt;
-		&lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
-		&lt;snapshots&gt;
-			&lt;enabled&gt;false&lt;/enabled&gt;
-		&lt;/snapshots&gt;
-	&lt;/pluginRepository&gt;
-&lt;/pluginRepositories&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock secondary">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">repositories {
-	mavenCentral()
-	mavenLocal()
-	maven { url "https://repo.spring.io/snapshot" }
-	maven { url "https://repo.spring.io/milestone" }
-	maven { url "https://repo.spring.io/release" }
-}</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_consumer_side_loan_issuance"><a class="link" href="#_consumer_side_loan_issuance">2.5.2. Consumer side (Loan Issuance)</a></h4>
-<div class="paragraph">
-<p>As a developer of the Loan Issuance service (a consumer of the Fraud Detection server), you might do the following steps:</p>
-</div>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>Start doing TDD by writing a test for your feature.</p>
-</li>
-<li>
-<p>Write the missing implementation.</p>
-</li>
-<li>
-<p>Clone the Fraud Detection service repository locally.</p>
-</li>
-<li>
-<p>Define the contract locally in the repo of Fraud Detection service.</p>
-</li>
-<li>
-<p>Add the Spring Cloud Contract Verifier plugin.</p>
-</li>
-<li>
-<p>Run the integration tests.</p>
-</li>
-<li>
-<p>File a pull request.</p>
-</li>
-<li>
-<p>Create an initial implementation.</p>
-</li>
-<li>
-<p>Take over the pull request.</p>
-</li>
-<li>
-<p>Write the missing implementation.</p>
-</li>
-<li>
-<p>Deploy your app.</p>
-</li>
-<li>
-<p>Work online.</p>
-</li>
-</ol>
-</div>
-<div class="paragraph">
-<p><strong>Start doing TDD by writing a test for your feature.</strong></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@Test
-public void shouldBeRejectedDueToAbnormalLoanAmount() {
-	// given:
-	LoanApplication application = new LoanApplication(new Client("1234567890"),
-			99999);
-	// when:
-	LoanApplicationResult loanApplication = service.loanApplication(application);
-	// then:
-	assertThat(loanApplication.getLoanApplicationStatus())
-			.isEqualTo(LoanApplicationStatus.LOAN_APPLICATION_REJECTED);
-	assertThat(loanApplication.getRejectionReason()).isEqualTo("Amount too high");
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Assume that you have written a test of your new feature. If a loan application for a big
-amount is received, the system should reject that loan application with some description.</p>
-</div>
-<div class="paragraph">
-<p><strong>Write the missing implementation.</strong></p>
-</div>
-<div class="paragraph">
-<p>At some point in time, you need to send a request to the Fraud Detection service. Assume
-that you need to send the request containing the ID of the client and the amount the
-client wants to borrow. You want to send it to the <code>/fraudcheck</code> url via the <code>PUT</code> method.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">ResponseEntity&lt;FraudServiceResponse&gt; response = restTemplate.exchange(
-		"http://localhost:" + port + "/fraudcheck", HttpMethod.PUT,
-		new HttpEntity&lt;&gt;(request, httpHeaders), FraudServiceResponse.class);</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>For simplicity, the port of the Fraud Detection service is set to <code>8080</code>, and the
-application runs on <code>8090</code>.</p>
-</div>
-<div class="paragraph">
-<p>If you start the test at this point, it breaks, because no service currently runs on port
-<code>8080</code>.</p>
-</div>
-<div class="paragraph">
-<p><strong>Clone the Fraud Detection service repository locally.</strong></p>
-</div>
-<div class="paragraph">
-<p>You can start by playing around with the server side contract. To do so, you must first
-clone it.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ git clone https://your-git-server.com/server-side.git local-http-server-repo</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>Define the contract locally in the repo of Fraud Detection service.</strong></p>
-</div>
-<div class="paragraph">
-<p>As a consumer, you need to define what exactly you want to achieve. You need to formulate
-your expectations. To do so, write the following contract:</p>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-Place the contract under <code>src/test/resources/contracts/fraud</code> folder. The <code>fraud</code> folder
-is important because the producer&#8217;s test base class name references that folder.
-</td>
-</tr>
-</table>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">/*
- * Copyright 2013-2019 the original author or authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package contracts
-
-org.springframework.cloud.contract.spec.Contract.make {
-	request { // (1)
-		method 'PUT' // (2)
-		url '/fraudcheck' // (3)
-		body([ // (4)
-			   "client.id": $(regex('[0-9]{10}')),
-			   loanAmount : 99999
-		])
-		headers { // (5)
-			contentType('application/json')
-		}
-	}
-	response { // (6)
-		status OK() // (7)
-		body([ // (8)
-			   fraudCheckStatus  : "FRAUD",
-			   "rejection.reason": "Amount too high"
-		])
-		headers { // (9)
-			contentType('application/json')
-		}
-	}
-}
-
-/*
-From the Consumer perspective, when shooting a request in the integration test:
-
-(1) - If the consumer sends a request
-(2) - With the "PUT" method
-(3) - to the URL "/fraudcheck"
-(4) - with the JSON body that
- * has a field `client.id` that matches a regular expression `[0-9]{10}`
- * has a field `loanAmount` that is equal to `99999`
-(5) - with header `Content-Type` equal to `application/json`
-(6) - then the response will be sent with
-(7) - status equal `200`
-(8) - and JSON body equal to
- { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
-(9) - with header `Content-Type` equal to `application/json`
-
-From the Producer perspective, in the autogenerated producer-side test:
-
-(1) - A request will be sent to the producer
-(2) - With the "PUT" method
-(3) - to the URL "/fraudcheck"
-(4) - with the JSON body that
- * has a field `client.id` that will have a generated value that matches a regular expression `[0-9]{10}`
- * has a field `loanAmount` that is equal to `99999`
-(5) - with header `Content-Type` equal to `application/json`
-(6) - then the test will assert if the response has been sent with
-(7) - status equal `200`
-(8) - and JSON body equal to
- { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
-(9) - with header `Content-Type` matching `application/json.*`
- */</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request: # (1)
-  method: PUT # (2)
-  url: /fraudcheck # (3)
-  body: # (4)
-    "client.id": 1234567890
-    loanAmount: 99999
-  headers: # (5)
-    Content-Type: application/json
-  matchers:
-    body:
-      - path: $.['client.id'] # (6)
-        type: by_regex
-        value: "[0-9]{10}"
-response: # (7)
-  status: 200 # (8)
-  body:  # (9)
-    fraudCheckStatus: "FRAUD"
-    "rejection.reason": "Amount too high"
-  headers: # (10)
-    Content-Type: application/json
-
-
-#From the Consumer perspective, when shooting a request in the integration test:
-#
-#(1) - If the consumer sends a request
-#(2) - With the "PUT" method
-#(3) - to the URL "/fraudcheck"
-#(4) - with the JSON body that
-# * has a field `client.id`
-# * has a field `loanAmount` that is equal to `99999`
-#(5) - with header `Content-Type` equal to `application/json`
-#(6) - and a `client.id` json entry matches the regular expression `[0-9]{10}`
-#(7) - then the response will be sent with
-#(8) - status equal `200`
-#(9) - and JSON body equal to
-# { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
-#(10) - with header `Content-Type` equal to `application/json`
-#
-#From the Producer perspective, in the autogenerated producer-side test:
-#
-#(1) - A request will be sent to the producer
-#(2) - With the "PUT" method
-#(3) - to the URL "/fraudcheck"
-#(4) - with the JSON body that
-# * has a field `client.id` `1234567890`
-# * has a field `loanAmount` that is equal to `99999`
-#(5) - with header `Content-Type` equal to `application/json`
-#(7) - then the test will assert if the response has been sent with
-#(8) - status equal `200`
-#(9) - and JSON body equal to
-# { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
-#(10) - with header `Content-Type` equal to `application/json`</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The YML contract is quite straight-forward. However when you take a look at the Contract
-written using a statically typed Groovy DSL - you might wonder what the
-<code>value(client(&#8230;&#8203;), server(&#8230;&#8203;))</code> parts are. By using this notation, Spring Cloud
-Contract lets you define parts of a JSON block, a URL, etc., which are dynamic. In case
-of an identifier or a timestamp, you need not hardcode a value. You want to allow some
-different ranges of values. To enable ranges of values, you can set regular expressions
-matching those values for the consumer side. You can provide the body by means of either
-a map notation or String with interpolations.
-Consult the <a href="#contract-dsl">Contract DSL</a> section for more information. We highly recommend using the map notation!</p>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-You must understand the map notation in order to set up contracts. Please read the
-<a href="https://groovy-lang.org/json.html">Groovy docs regarding JSON</a>.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>The previously shown contract is an agreement between two sides that:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>if an HTTP request is sent with all of</p>
-<div class="ulist">
-<ul>
-<li>
-<p>a <code>PUT</code> method on the <code>/fraudcheck</code> endpoint,</p>
-</li>
-<li>
-<p>a JSON body with a <code>client.id</code> that matches the regular expression <code>[0-9]{10}</code> and
-<code>loanAmount</code> equal to <code>99999</code>,</p>
-</li>
-<li>
-<p>and a <code>Content-Type</code> header with a value of <code>application/vnd.fraud.v1+json</code>,</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>then an HTTP response is sent to the consumer that</p>
-<div class="ulist">
-<ul>
-<li>
-<p>has status <code>200</code>,</p>
-</li>
-<li>
-<p>contains a JSON body with the <code>fraudCheckStatus</code> field containing a value <code>FRAUD</code> and
-the <code>rejectionReason</code> field having value <code>Amount too high</code>,</p>
-</li>
-<li>
-<p>and a <code>Content-Type</code> header with a value of <code>application/vnd.fraud.v1+json</code>.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Once you are ready to check the API in practice in the integration tests, you need to
-install the stubs locally.</p>
-</div>
-<div class="paragraph">
-<p><strong>Add the Spring Cloud Contract Verifier plugin.</strong></p>
-</div>
-<div class="paragraph">
-<p>We can add either a Maven or a Gradle plugin. In this example, you see how to add Maven.
-First, add the <code>Spring Cloud Contract</code> BOM.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependencyManagement&gt;
-	&lt;dependencies&gt;
-		&lt;dependency&gt;
-			&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-			&lt;artifactId&gt;spring-cloud-dependencies&lt;/artifactId&gt;
-			&lt;version&gt;${spring-cloud-release.version}&lt;/version&gt;
-			&lt;type&gt;pom&lt;/type&gt;
-			&lt;scope&gt;import&lt;/scope&gt;
-		&lt;/dependency&gt;
-	&lt;/dependencies&gt;
-&lt;/dependencyManagement&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Next, add the <code>Spring Cloud Contract Verifier</code> Maven plugin</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-	&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-	&lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-	&lt;extensions&gt;true&lt;/extensions&gt;
-	&lt;configuration&gt;
-		&lt;packageWithBaseClasses&gt;com.example.fraud&lt;/packageWithBaseClasses&gt;
-		&lt;convertToYaml&gt;true&lt;/convertToYaml&gt;
-	&lt;/configuration&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Since the plugin was added, you get the <code>Spring Cloud Contract Verifier</code> features which,
-from the provided contracts:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>generate and run tests</p>
-</li>
-<li>
-<p>produce and install stubs</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>You do not want to generate tests since you, as the consumer, want only to play with the
-stubs. You need to skip the test generation and execution. When you execute:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ cd local-http-server-repo
-$ ./mvnw clean install -DskipTests</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In the logs, you see something like this:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">[INFO] --- spring-cloud-contract-maven-plugin:1.0.0.BUILD-SNAPSHOT:generateStubs (default-generateStubs) @ http-server ---
-[INFO] Building jar: /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar
-[INFO]
-[INFO] --- maven-jar-plugin:2.6:jar (default-jar) @ http-server ---
-[INFO] Building jar: /some/path/http-server/target/http-server-0.0.1-SNAPSHOT.jar
-[INFO]
-[INFO] --- spring-boot-maven-plugin:1.5.5.BUILD-SNAPSHOT:repackage (default) @ http-server ---
-[INFO]
-[INFO] --- maven-install-plugin:2.5.2:install (default-install) @ http-server ---
-[INFO] Installing /some/path/http-server/target/http-server-0.0.1-SNAPSHOT.jar to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT.jar
-[INFO] Installing /some/path/http-server/pom.xml to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT.pom
-[INFO] Installing /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following line is extremely important:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">[INFO] Installing /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>It confirms that the stubs of the <code>http-server</code> have been installed in the local
-repository.</p>
-</div>
-<div class="paragraph">
-<p><strong>Run the integration tests.</strong></p>
-</div>
-<div class="paragraph">
-<p>In order to profit from the Spring Cloud Contract Stub Runner functionality of automatic
-stub downloading, you must do the following in your consumer side project (<code>Loan
-Application service</code>):</p>
-</div>
-<div class="paragraph">
-<p>Add the <code>Spring Cloud Contract</code> BOM:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependencyManagement&gt;
-	&lt;dependencies&gt;
-		&lt;dependency&gt;
-			&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-			&lt;artifactId&gt;spring-cloud-dependencies&lt;/artifactId&gt;
-			&lt;version&gt;${spring-cloud-release-train.version}&lt;/version&gt;
-			&lt;type&gt;pom&lt;/type&gt;
-			&lt;scope&gt;import&lt;/scope&gt;
-		&lt;/dependency&gt;
-	&lt;/dependencies&gt;
-&lt;/dependencyManagement&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Add the dependency to <code>Spring Cloud Contract Stub Runner</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
-	&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-cloud-starter-contract-stub-runner&lt;/artifactId&gt;
-	&lt;scope&gt;test&lt;/scope&gt;
-&lt;/dependency&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Annotate your test class with <code>@AutoConfigureStubRunner</code>. In the annotation, provide the
-<code>group-id</code> and <code>artifact-id</code> for the Stub Runner to download the stubs of your
-collaborators. (Optional step) Because you&#8217;re playing with the collaborators offline, you
-can also provide the offline work switch (<code>StubRunnerProperties.StubsMode.LOCAL</code>).</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@RunWith(SpringRunner.class)
-@SpringBootTest(webEnvironment = WebEnvironment.NONE)
-@AutoConfigureStubRunner(ids = {
-		"com.example:http-server-dsl:+:stubs:6565" }, stubsMode = StubRunnerProperties.StubsMode.LOCAL)
-public class LoanApplicationServiceTests {</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Now, when you run your tests, you see something like this:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">2016-07-19 14:22:25.403  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Desired version is + - will try to resolve the latest version
-2016-07-19 14:22:25.438  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolved version is 0.0.1-SNAPSHOT
-2016-07-19 14:22:25.439  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolving artifact com.example:http-server:jar:stubs:0.0.1-SNAPSHOT using remote repositories []
-2016-07-19 14:22:25.451  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolved artifact com.example:http-server:jar:stubs:0.0.1-SNAPSHOT to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar
-2016-07-19 14:22:25.465  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Unpacking stub from JAR [URI: file:/path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar]
-2016-07-19 14:22:25.475  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Unpacked file to [/var/folders/0p/xwq47sq106x1_g3dtv6qfm940000gq/T/contracts100276532569594265]
-2016-07-19 14:22:27.737  INFO 41050 --- [           main] o.s.c.c.stubrunner.StubRunnerExecutor    : All stubs are now running RunningStubs [namesAndPorts={com.example:http-server:0.0.1-SNAPSHOT:stubs=8080}]</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This output means that Stub Runner has found your stubs and started a server for your app
-with group id <code>com.example</code>, artifact id <code>http-server</code> with version <code>0.0.1-SNAPSHOT</code> of
-the stubs and with <code>stubs</code> classifier on port <code>8080</code>.</p>
-</div>
-<div class="paragraph">
-<p><strong>File a pull request.</strong></p>
-</div>
-<div class="paragraph">
-<p>What you have done until now is an iterative process. You can play around with the
-contract, install it locally, and work on the consumer side until the contract works as
-you wish.</p>
-</div>
-<div class="paragraph">
-<p>Once you are satisfied with the results and the test passes, publish a pull request to
-the server side. Currently, the consumer side work is done.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_producer_side_fraud_detection_server"><a class="link" href="#_producer_side_fraud_detection_server">2.5.3. Producer side (Fraud Detection server)</a></h4>
-<div class="paragraph">
-<p>As a developer of the Fraud Detection server (a server to the Loan Issuance service):</p>
-</div>
-<div class="paragraph">
-<p><strong>Create an initial implementation.</strong></p>
-</div>
-<div class="paragraph">
-<p>As a reminder, you can see the initial implementation here:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RequestMapping(value = "/fraudcheck", method = PUT)
-public FraudCheckResult fraudCheck(@RequestBody FraudCheck fraudCheck) {
-return new FraudCheckResult(FraudCheckStatus.OK, NO_REASON);
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>Take over the pull request.</strong></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ git checkout -b contract-change-pr master
-$ git pull https://your-git-server.com/server-side-fork.git contract-change-pr</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You must add the dependencies needed by the autogenerated tests:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
-	&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-cloud-starter-contract-verifier&lt;/artifactId&gt;
-	&lt;scope&gt;test&lt;/scope&gt;
-&lt;/dependency&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In the configuration of the Maven plugin, pass the <code>packageWithBaseClasses</code> property</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-	&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-	&lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-	&lt;extensions&gt;true&lt;/extensions&gt;
-	&lt;configuration&gt;
-		&lt;packageWithBaseClasses&gt;com.example.fraud&lt;/packageWithBaseClasses&gt;
-		&lt;convertToYaml&gt;true&lt;/convertToYaml&gt;
-	&lt;/configuration&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-This example uses "convention based" naming by setting the
-<code>packageWithBaseClasses</code> property. Doing so means that the two last packages combine to
-make the name of the base test class. In our case, the contracts were placed under
-<code>src/test/resources/contracts/fraud</code>. Since you do not have two packages starting from
-the <code>contracts</code> folder, pick only one, which should be <code>fraud</code>. Add the <code>Base</code> suffix and
-capitalize <code>fraud</code>. That gives you the <code>FraudBase</code> test class name.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>All the generated tests extend that class. Over there, you can set up your Spring Context
-or whatever is necessary. In this case, use <a href="https://github.com/rest-assured/rest-assured">Rest Assured MVC</a> to
-start the server side <code>FraudDetectionController</code>.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">/*
- * Copyright 2013-2019 the original author or authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package com.example.fraud;
-
-import io.restassured.module.mockmvc.RestAssuredMockMvc;
-import org.junit.Before;
-
-public class FraudBase {
-
-	@Before
-	public void setup() {
-		RestAssuredMockMvc.standaloneSetup(new FraudDetectionController(),
-				new FraudStatsController(stubbedStatsProvider()));
-	}
-
-	private StatsProvider stubbedStatsProvider() {
-		return fraudType -&gt; {
-			switch (fraudType) {
-			case DRUNKS:
-				return 100;
-			case ALL:
-				return 200;
-			}
-			return 0;
-		};
-	}
-
-	public void assertThatRejectionReasonIsNull(Object rejectionReason) {
-		assert rejectionReason == null;
-	}
-
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Now, if you run the <code>./mvnw clean install</code>, you get something like this:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">Results :
-
-Tests in error:
-  ContractVerifierTest.validate_shouldMarkClientAsFraud:32 » IllegalState Parsed...</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This error occurs because you have a new contract from which a test was generated and it
-failed since you have not implemented the feature. The auto-generated test would look
-like this:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
-public void validate_shouldMarkClientAsFraud() throws Exception {
-    // given:
-        MockMvcRequestSpecification request = given()
-                .header("Content-Type", "application/vnd.fraud.v1+json")
-                .body("{\"client.id\":\"1234567890\",\"loanAmount\":99999}");
-
-    // when:
-        ResponseOptions response = given().spec(request)
-                .put("/fraudcheck");
-
-    // then:
-        assertThat(response.statusCode()).isEqualTo(200);
-        assertThat(response.header("Content-Type")).matches("application/vnd.fraud.v1.json.*");
-    // and:
-        DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
-        assertThatJson(parsedJson).field("['fraudCheckStatus']").matches("[A-Z]{5}");
-        assertThatJson(parsedJson).field("['rejection.reason']").isEqualTo("Amount too high");
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you used the Groovy DSL, you can see, all the <code>producer()</code> parts of the Contract that were present in the
-<code>value(consumer(&#8230;&#8203;), producer(&#8230;&#8203;))</code> blocks got injected into the test.
-In case of using YAML, the same applied for the <code>matchers</code> sections of the <code>response</code>.</p>
-</div>
-<div class="paragraph">
-<p>Note that, on the producer side, you are also doing TDD. The expectations are expressed
-in the form of a test. This test sends a request to our own application with the URL,
-headers, and body defined in the contract. It also is expecting precisely defined values
-in the response. In other words, you have the <code>red</code> part of <code>red</code>, <code>green</code>, and
-<code>refactor</code>. It is time to convert the <code>red</code> into the <code>green</code>.</p>
-</div>
-<div class="paragraph">
-<p><strong>Write the missing implementation.</strong></p>
-</div>
-<div class="paragraph">
-<p>Because you know the expected input and expected output, you can write the missing
-implementation:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RequestMapping(value = "/fraudcheck", method = PUT)
-public FraudCheckResult fraudCheck(@RequestBody FraudCheck fraudCheck) {
-if (amountGreaterThanThreshold(fraudCheck)) {
-	return new FraudCheckResult(FraudCheckStatus.FRAUD, AMOUNT_TOO_HIGH);
-}
-return new FraudCheckResult(FraudCheckStatus.OK, NO_REASON);
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>When you execute <code>./mvnw clean install</code> again, the tests pass. Since the <code>Spring Cloud
-Contract Verifier</code> plugin adds the tests to the <code>generated-test-sources</code>, you can
-actually run those tests from your IDE.</p>
-</div>
-<div class="paragraph">
-<p><strong>Deploy your app.</strong></p>
-</div>
-<div class="paragraph">
-<p>Once you finish your work, you can deploy your change. First, merge the branch:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ git checkout master
-$ git merge --no-ff contract-change-pr
-$ git push origin master</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Your CI might run something like <code>./mvnw clean deploy</code>, which would publish both the
-application and the stub artifacts.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_consumer_side_loan_issuance_final_step"><a class="link" href="#_consumer_side_loan_issuance_final_step">2.5.4. Consumer Side (Loan Issuance) Final Step</a></h4>
-<div class="paragraph">
-<p>As a developer of the Loan Issuance service (a consumer of the Fraud Detection server):</p>
-</div>
-<div class="paragraph">
-<p><strong>Merge branch to master.</strong></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ git checkout master
-$ git merge --no-ff contract-change-pr</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>Work online.</strong></p>
-</div>
-<div class="paragraph">
-<p>Now you can disable the offline work for Spring Cloud Contract Stub Runner and indicate
-where the repository with your stubs is located. At this moment the stubs of the server
-side are automatically downloaded from Nexus/Artifactory. You can set the value of
-<code>stubsMode</code> to <code>REMOTE</code>. The following code shows an example of
-achieving the same thing by changing the properties.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">stubrunner:
-  ids: 'com.example:http-server-dsl:+:stubs:8080'
-  repositoryRoot: https://repo.spring.io/libs-snapshot</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>That&#8217;s it!</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_dependencies"><a class="link" href="#_dependencies">2.6. Dependencies</a></h3>
-<div class="paragraph">
-<p>The best way to add dependencies is to use the proper <code>starter</code> dependency.</p>
-</div>
-<div class="paragraph">
-<p>For <code>stub-runner</code>, use <code>spring-cloud-starter-stub-runner</code>. When you use a plugin, add
-<code>spring-cloud-starter-contract-verifier</code>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_additional_links"><a class="link" href="#_additional_links">2.7. Additional Links</a></h3>
-<div class="paragraph">
-<p>Here are some resources related to Spring Cloud Contract Verifier and Stub Runner. Note
-that some may be outdated, because the Spring Cloud Contract Verifier project is under
-constant development.</p>
-</div>
-<div class="sect3">
-<h4 id="_spring_cloud_contract_video"><a class="link" href="#_spring_cloud_contract_video">2.7.1. Spring Cloud Contract video</a></h4>
-<div class="paragraph">
-<p>You can check out the video from the Warsaw JUG about Spring Cloud Contract:</p>
-</div>
-<div class="videoblock">
-<div class="content">
-<iframe width="640" height="480" src="https://www.youtube.com/embed/sAAklvxmPmk?rel=0&amp;start=538" frameborder="0" allowfullscreen></iframe>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_readings"><a class="link" href="#_readings">2.7.2. Readings</a></h4>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://www.slideshare.net/MarcinGrzejszczak/stick-to-the-rules-consumer-driven-contracts-201507-confitura">Slides from Marcin Grzejszczak&#8217;s talk about Accurest</a></p>
-</li>
-<li>
-<p><a href="https://toomuchcoding.com/blog/categories/accurest/">Accurest related articles from Marcin Grzejszczak&#8217;s blog</a></p>
-</li>
-<li>
-<p><a href="https://toomuchcoding.com/blog/categories/spring-cloud-contract/">Spring Cloud Contract related articles from Marcin Grzejszczak&#8217;s blog</a></p>
-</li>
-<li>
-<p><a href="https://groovy-lang.org/json.html">Groovy docs regarding JSON</a></p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_samples"><a class="link" href="#_samples">2.8. Samples</a></h3>
-<div class="paragraph">
-<p>You can find some samples at
-<a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples">samples</a>.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_spring_cloud_contract_faq"><a class="link" href="#_spring_cloud_contract_faq">3. Spring Cloud Contract FAQ</a></h2>
-<div class="sectionbody">
-<div class="sect2">
-<h3 id="_why_use_spring_cloud_contract_verifier_and_not_x"><a class="link" href="#_why_use_spring_cloud_contract_verifier_and_not_x">3.1. Why use Spring Cloud Contract Verifier and not X ?</a></h3>
-<div class="paragraph">
-<p>For the time being Spring Cloud Contract is a JVM based tool. So it could be your first pick when you&#8217;re already creating
-software for the JVM. This project has a lot of really interesting features but especially quite a few of them definitely make
-Spring Cloud Contract Verifier stand out on the "market" of Consumer Driven Contract (CDC) tooling. Out of many the most interesting are:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Possibility to do CDC with messaging</p>
-</li>
-<li>
-<p>Clear and easy to use, statically typed DSL</p>
-</li>
-<li>
-<p>Possibility to copy paste your current JSON file to the contract and only edit its elements</p>
-</li>
-<li>
-<p>Automatic generation of tests from the defined Contract</p>
-</li>
-<li>
-<p>Stub Runner functionality - the stubs are automatically downloaded at runtime from Nexus / Artifactory</p>
-</li>
-<li>
-<p>Spring Cloud integration - no discovery service is needed for integration tests</p>
-</li>
-<li>
-<p>Spring Cloud Contract integrates with Pact out of the box and provides easy hooks to extend its functionality</p>
-</li>
-<li>
-<p>Via Docker adds support for any language &amp; framework used</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_i_dont_want_to_write_a_contract_in_groovy"><a class="link" href="#_i_dont_want_to_write_a_contract_in_groovy">3.2. I don&#8217;t want to write a contract in Groovy!</a></h3>
-<div class="paragraph">
-<p>No problem. You can write a contract in YAML!</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_what_is_this_valueconsumer_producer"><a class="link" href="#_what_is_this_valueconsumer_producer">3.3. What is this value(consumer(), producer()) ?</a></h3>
-<div class="paragraph">
-<p>One of the biggest challenges related to stubs is their reusability. Only if they can be vastly used, will they serve their purpose.
-What typically makes that difficult are the hard-coded values of request / response elements. For example dates or ids.
-Imagine the following JSON request</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
-    "time" : "2016-10-10 20:10:15",
-    "id" : "9febab1c-6f36-4a0b-88d6-3b6a6d81cd4a",
-    "body" : "foo"
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>and JSON response</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
-    "time" : "2016-10-10 21:10:15",
-    "id" : "c4231e1f-3ca9-48d3-b7e7-567d55f0d051",
-    "body" : "bar"
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Imagine the pain required to set proper value of the <code>time</code> field (let&#8217;s assume that this content is generated by the
-database) by changing the clock in the system or providing stub implementations of data providers. The same is related
-to the field called <code>id</code>. Will you create a stubbed implementation of UUID generator? Makes little sense&#8230;&#8203;</p>
-</div>
-<div class="paragraph">
-<p>So as a consumer you would like to send a request that matches any form of a time or any UUID. That way your system
-will work as usual - will generate data and you won&#8217;t have to stub anything out. Let&#8217;s assume that in case of the aforementioned
-JSON the most important part is the <code>body</code> field. You can focus on that and provide matching for other fields. In other words
-you would like the stub to work like this:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
-    "time" : "SOMETHING THAT MATCHES TIME",
-    "id" : "SOMETHING THAT MATCHES UUID",
-    "body" : "foo"
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>As far as the response goes as a consumer you need a concrete value that you can operate on. So such a JSON is valid</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
-    "time" : "2016-10-10 21:10:15",
-    "id" : "c4231e1f-3ca9-48d3-b7e7-567d55f0d051",
-    "body" : "bar"
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>As you could see in the previous sections we generate tests from contracts. So from the producer&#8217;s side the situation looks
-much different. We&#8217;re parsing the provided contract and in the test we want to send a real request to your endpoints.
-So for the case of a producer for the request we can&#8217;t have any sort of matching. We need concrete values that the
-producer&#8217;s backend can work on. Such a JSON would be a valid one:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
-    "time" : "2016-10-10 20:10:15",
-    "id" : "9febab1c-6f36-4a0b-88d6-3b6a6d81cd4a",
-    "body" : "foo"
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>On the other hand from the point of view of the validity of the contract the response doesn&#8217;t necessarily have to
-contain concrete values of <code>time</code> or <code>id</code>. Let&#8217;s say that you generate those on the producer side - again, you&#8217;d
-have to do a lot of stubbing to ensure that you always return the same values. That&#8217;s why from the producer&#8217;s side
-what you might want is the following response:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
-    "time" : "SOMETHING THAT MATCHES TIME",
-    "id" : "SOMETHING THAT MATCHES UUID",
-    "body" : "bar"
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>How can you then provide one time a matcher for the consumer and a concrete value for the producer and vice versa?
-In Spring Cloud Contract we&#8217;re allowing you to provide a <strong>dynamic value</strong>. That means that it can differ for both
-sides of the communication. You can pass the values:</p>
-</div>
-<div class="paragraph">
-<p>Either via the <code>value</code> method</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">value(consumer(...), producer(...))
-value(stub(...), test(...))
-value(client(...), server(...))</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>or using the <code>$()</code> method</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">$(consumer(...), producer(...))
-$(stub(...), test(...))
-$(client(...), server(...))</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can read more about this in the <a href="#contract-dsl">Contract DSL</a> section.</p>
-</div>
-<div class="paragraph">
-<p>Calling <code>value()</code> or <code>$()</code> tells Spring Cloud Contract that you will be passing a dynamic value.
-Inside the <code>consumer()</code> method you pass the value that should be used on the consumer side (in the generated stub).
-Inside the <code>producer()</code> method you pass the value that should be used on the producer side (in the generated test).</p>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-If on one side you have passed the regular expression and you haven&#8217;t passed the other, then the
-other side will get auto-generated.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>Most often you will use that method together with the <code>regex</code> helper method. E.g. <code>consumer(regex('[0-9]{10}'))</code>.</p>
-</div>
-<div class="paragraph">
-<p>To sum it up the contract for the aforementioned scenario would look more or less like this (the regular expression
-for time and UUID are simplified and most likely invalid but we want to keep things very simple in this example):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
-				request {
-					method 'GET'
-					url '/someUrl'
-					body([
-					    time : value(consumer(regex('[0-9]{4}-[0-9]{2}-[0-9]{2} [0-2][0-9]-[0-5][0-9]-[0-5][0-9]')),
-					    id: value(consumer(regex('[0-9a-zA-z]{8}-[0-9a-zA-z]{4}-[0-9a-zA-z]{4}-[0-9a-zA-z]{12}'))
-					    body: "foo"
-					])
-				}
-			response {
-				status OK()
-				body([
-					    time : value(producer(regex('[0-9]{4}-[0-9]{2}-[0-9]{2} [0-2][0-9]-[0-5][0-9]-[0-5][0-9]')),
-					    id: value([producer(regex('[0-9a-zA-z]{8}-[0-9a-zA-z]{4}-[0-9a-zA-z]{4}-[0-9a-zA-z]{12}'))
-					    body: "bar"
-					])
-			}
-}</code></pre>
-</div>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-Please read the <a href="https://groovy-lang.org/json.html">Groovy docs related to JSON</a> to understand how to
-properly structure the request / response bodies.
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_how_to_do_stubs_versioning"><a class="link" href="#_how_to_do_stubs_versioning">3.4. How to do Stubs versioning?</a></h3>
-<div class="sect3">
-<h4 id="_api_versioning"><a class="link" href="#_api_versioning">3.4.1. API Versioning</a></h4>
-<div class="paragraph">
-<p>Let&#8217;s try to answer a question what versioning really means. If you&#8217;re referring to the API version then there are
-different approaches.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>use Hypermedia, links and do not version your API by any means</p>
-</li>
-<li>
-<p>pass versions through headers / urls</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>I will not try to answer a question which approach is better. Whatever suits your needs and allows you to generate
-business value should be picked.</p>
-</div>
-<div class="paragraph">
-<p>Let&#8217;s assume that you do version your API. In that case you should provide as many contracts as many versions you support.
-You can create a subfolder for every version or append it to the contract name - whatever suits you more.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_jar_versioning"><a class="link" href="#_jar_versioning">3.4.2. JAR versioning</a></h4>
-<div class="paragraph">
-<p>If by versioning you mean the version of the JAR that contains the stubs then there are essentially two main approaches.</p>
-</div>
-<div class="paragraph">
-<p>Let&#8217;s assume that you&#8217;re doing Continuous Delivery / Deployment which means that you&#8217;re generating a new version of
-the jar each time you go through the pipeline and that jar can go to production at any time. For example your jar version
-looks like this (it got built on the 20.10.2016 at 20:15:21) :</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">1.0.0.20161020-201521-RELEASE</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In that case your generated stub jar will look like this.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">1.0.0.20161020-201521-RELEASE-stubs.jar</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In this case you should inside your <code>application.yml</code> or <code>@AutoConfigureStubRunner</code> when referencing stubs provide the
- latest version of the stubs. You can do that by passing the <code>+</code> sign. Example</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:stubs:8080"})</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If the versioning however is fixed (e.g. <code>1.0.4.RELEASE</code> or <code>2.1.1</code>) then you have to set the concrete value of the jar
-version. Example for 2.1.1.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:2.1.1:stubs:8080"})</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_dev_or_prod_stubs"><a class="link" href="#_dev_or_prod_stubs">3.4.3. Dev or prod stubs</a></h4>
-<div class="paragraph">
-<p>You can manipulate the classifier to run the tests against current development version of the stubs of other services
- or the ones that were deployed to production. If you alter your build to deploy the stubs with the <code>prod-stubs</code> classifier
- once you reach production deployment then you can run tests in one case with dev stubs and one with prod stubs.</p>
-</div>
-<div class="paragraph">
-<p>Example of tests using development version of stubs</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:stubs:8080"})</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Example of tests using production version of stubs</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:prod-stubs:8080"})</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can pass those values also via properties from your deployment pipeline.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_common_repo_with_contracts"><a class="link" href="#_common_repo_with_contracts">3.5. Common repo with contracts</a></h3>
-<div class="paragraph">
-<p>Another way of storing contracts other than having them with the producer is keeping them in a common place.
-It can be related to security issues where the consumers can&#8217;t clone the producer&#8217;s code. Also if you keep
-contracts in a single place then you, as a producer, will know how many consumers you have and which
-consumer you will break with your local changes.</p>
-</div>
-<div class="sect3">
-<h4 id="_repo_structure"><a class="link" href="#_repo_structure">3.5.1. Repo structure</a></h4>
-<div class="paragraph">
-<p>Let&#8217;s assume that we have a producer with coordinates <code>com.example:server</code> and 3 consumers: <code>client1</code>,
-<code>client2</code>, <code>client3</code>. Then in the repository with common contracts you would have the following setup
-(which you can checkout <a href="https://github.com/spring-cloud/spring-cloud-contract/tree/master/samples/standalone/contracts">here</a>):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">├── com
-│   └── example
-│       └── server
-│           ├── client1
-│           │   └── expectation.groovy
-│           ├── client2
-│           │   └── expectation.groovy
-│           ├── client3
-│           │   └── expectation.groovy
-│           └── pom.xml
-├── mvnw
-├── mvnw.cmd
-├── pom.xml
-└── src
-    └── assembly
-        └── contracts.xml</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>As you can see under the slash-delimited groupid <code>/</code> artifact id folder (<code>com/example/server</code>) you have
-expectations of the 3 consumers (<code>client1</code>, <code>client2</code> and <code>client3</code>). Expectations are the standard Groovy DSL
-contract files as described throughout this documentation. This repository has to produce a JAR file that maps
-one to one to the contents of the repo.</p>
-</div>
-<div class="paragraph">
-<p>Example of a <code>pom.xml</code> inside the <code>server</code> folder.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;?xml version="1.0" encoding="UTF-8"?&gt;
-&lt;project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-		 xmlns="http://maven.apache.org/POM/4.0.0"
-		 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"&gt;
-	&lt;modelVersion&gt;4.0.0&lt;/modelVersion&gt;
-
-	&lt;groupId&gt;com.example&lt;/groupId&gt;
-	&lt;artifactId&gt;server&lt;/artifactId&gt;
-	&lt;version&gt;0.0.1-SNAPSHOT&lt;/version&gt;
-
-	&lt;name&gt;Server Stubs&lt;/name&gt;
-	&lt;description&gt;POM used to install locally stubs for consumer side&lt;/description&gt;
-
-	&lt;parent&gt;
-		&lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;
-		&lt;artifactId&gt;spring-boot-starter-parent&lt;/artifactId&gt;
-		&lt;version&gt;2.2.0.BUILD-SNAPSHOT&lt;/version&gt;
-		&lt;relativePath/&gt;
-	&lt;/parent&gt;
-
-	&lt;properties&gt;
-		&lt;project.build.sourceEncoding&gt;UTF-8&lt;/project.build.sourceEncoding&gt;
-		&lt;java.version&gt;1.8&lt;/java.version&gt;
-		&lt;spring-cloud-contract.version&gt;2.2.0.BUILD-SNAPSHOT&lt;/spring-cloud-contract.version&gt;
-		&lt;spring-cloud-release.version&gt;Hoxton.BUILD-SNAPSHOT&lt;/spring-cloud-release.version&gt;
-		&lt;excludeBuildFolders&gt;true&lt;/excludeBuildFolders&gt;
-	&lt;/properties&gt;
-
-	&lt;dependencyManagement&gt;
-		&lt;dependencies&gt;
-			&lt;dependency&gt;
-				&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-				&lt;artifactId&gt;spring-cloud-dependencies&lt;/artifactId&gt;
-				&lt;version&gt;${spring-cloud-release.version}&lt;/version&gt;
-				&lt;type&gt;pom&lt;/type&gt;
-				&lt;scope&gt;import&lt;/scope&gt;
-			&lt;/dependency&gt;
-		&lt;/dependencies&gt;
-	&lt;/dependencyManagement&gt;
-
-	&lt;build&gt;
-		&lt;plugins&gt;
-			&lt;plugin&gt;
-				&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-				&lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-				&lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-				&lt;extensions&gt;true&lt;/extensions&gt;
-				&lt;configuration&gt;
-					&lt;!-- By default it would search under src/test/resources/ --&gt;
-					&lt;contractsDirectory&gt;${project.basedir}&lt;/contractsDirectory&gt;
-				&lt;/configuration&gt;
-			&lt;/plugin&gt;
-		&lt;/plugins&gt;
-	&lt;/build&gt;
-
-	&lt;repositories&gt;
-		&lt;repository&gt;
-			&lt;id&gt;spring-snapshots&lt;/id&gt;
-			&lt;name&gt;Spring Snapshots&lt;/name&gt;
-			&lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
-			&lt;snapshots&gt;
-				&lt;enabled&gt;true&lt;/enabled&gt;
-			&lt;/snapshots&gt;
-		&lt;/repository&gt;
-		&lt;repository&gt;
-			&lt;id&gt;spring-milestones&lt;/id&gt;
-			&lt;name&gt;Spring Milestones&lt;/name&gt;
-			&lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
-			&lt;snapshots&gt;
-				&lt;enabled&gt;false&lt;/enabled&gt;
-			&lt;/snapshots&gt;
-		&lt;/repository&gt;
-		&lt;repository&gt;
-			&lt;id&gt;spring-releases&lt;/id&gt;
-			&lt;name&gt;Spring Releases&lt;/name&gt;
-			&lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
-			&lt;snapshots&gt;
-				&lt;enabled&gt;false&lt;/enabled&gt;
-			&lt;/snapshots&gt;
-		&lt;/repository&gt;
-	&lt;/repositories&gt;
-	&lt;pluginRepositories&gt;
-		&lt;pluginRepository&gt;
-			&lt;id&gt;spring-snapshots&lt;/id&gt;
-			&lt;name&gt;Spring Snapshots&lt;/name&gt;
-			&lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
-			&lt;snapshots&gt;
-				&lt;enabled&gt;true&lt;/enabled&gt;
-			&lt;/snapshots&gt;
-		&lt;/pluginRepository&gt;
-		&lt;pluginRepository&gt;
-			&lt;id&gt;spring-milestones&lt;/id&gt;
-			&lt;name&gt;Spring Milestones&lt;/name&gt;
-			&lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
-			&lt;snapshots&gt;
-				&lt;enabled&gt;false&lt;/enabled&gt;
-			&lt;/snapshots&gt;
-		&lt;/pluginRepository&gt;
-		&lt;pluginRepository&gt;
-			&lt;id&gt;spring-releases&lt;/id&gt;
-			&lt;name&gt;Spring Releases&lt;/name&gt;
-			&lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
-			&lt;snapshots&gt;
-				&lt;enabled&gt;false&lt;/enabled&gt;
-			&lt;/snapshots&gt;
-		&lt;/pluginRepository&gt;
-	&lt;/pluginRepositories&gt;
-
-&lt;/project&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>As you can see there are no dependencies other than the Spring Cloud Contract Maven Plugin.
-Those poms are necessary for the consumer side to run <code>mvn clean install -DskipTests</code> to locally install
- stubs of the producer project.</p>
-</div>
-<div class="paragraph">
-<p>The <code>pom.xml</code> in the root folder can look like this:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;?xml version="1.0" encoding="UTF-8"?&gt;
-&lt;project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-		 xmlns="http://maven.apache.org/POM/4.0.0"
-		 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"&gt;
-	&lt;modelVersion&gt;4.0.0&lt;/modelVersion&gt;
-
-	&lt;groupId&gt;com.example.standalone&lt;/groupId&gt;
-	&lt;artifactId&gt;contracts&lt;/artifactId&gt;
-	&lt;version&gt;0.0.1-SNAPSHOT&lt;/version&gt;
-
-	&lt;name&gt;Contracts&lt;/name&gt;
-	&lt;description&gt;Contains all the Spring Cloud Contracts, well, contracts. JAR used by the
-		producers to generate tests and stubs
-	&lt;/description&gt;
-
-	&lt;properties&gt;
-		&lt;project.build.sourceEncoding&gt;UTF-8&lt;/project.build.sourceEncoding&gt;
-	&lt;/properties&gt;
-
-	&lt;build&gt;
-		&lt;plugins&gt;
-			&lt;plugin&gt;
-				&lt;groupId&gt;org.apache.maven.plugins&lt;/groupId&gt;
-				&lt;artifactId&gt;maven-assembly-plugin&lt;/artifactId&gt;
-				&lt;executions&gt;
-					&lt;execution&gt;
-						&lt;id&gt;contracts&lt;/id&gt;
-						&lt;phase&gt;prepare-package&lt;/phase&gt;
-						&lt;goals&gt;
-							&lt;goal&gt;single&lt;/goal&gt;
-						&lt;/goals&gt;
-						&lt;configuration&gt;
-							&lt;attach&gt;true&lt;/attach&gt;
-							&lt;descriptor&gt;${basedir}/src/assembly/contracts.xml&lt;/descriptor&gt;
-							&lt;!-- If you want an explicit classifier remove the following line --&gt;
-							&lt;appendAssemblyId&gt;false&lt;/appendAssemblyId&gt;
-						&lt;/configuration&gt;
-					&lt;/execution&gt;
-				&lt;/executions&gt;
-			&lt;/plugin&gt;
-		&lt;/plugins&gt;
-	&lt;/build&gt;
-
-&lt;/project&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>It&#8217;s using the assembly plugin in order to build the JAR with all the contracts. Example of such setup is here:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;assembly xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-		  xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3"
-		  xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 https://maven.apache.org/xsd/assembly-1.1.3.xsd"&gt;
-	&lt;id&gt;project&lt;/id&gt;
-	&lt;formats&gt;
-		&lt;format&gt;jar&lt;/format&gt;
-	&lt;/formats&gt;
-	&lt;includeBaseDirectory&gt;false&lt;/includeBaseDirectory&gt;
-	&lt;fileSets&gt;
-		&lt;fileSet&gt;
-			&lt;directory&gt;${project.basedir}&lt;/directory&gt;
-			&lt;outputDirectory&gt;/&lt;/outputDirectory&gt;
-			&lt;useDefaultExcludes&gt;true&lt;/useDefaultExcludes&gt;
-			&lt;excludes&gt;
-				&lt;exclude&gt;**/${project.build.directory}/**&lt;/exclude&gt;
-				&lt;exclude&gt;mvnw&lt;/exclude&gt;
-				&lt;exclude&gt;mvnw.cmd&lt;/exclude&gt;
-				&lt;exclude&gt;.mvn/**&lt;/exclude&gt;
-				&lt;exclude&gt;src/**&lt;/exclude&gt;
-			&lt;/excludes&gt;
-		&lt;/fileSet&gt;
-	&lt;/fileSets&gt;
-&lt;/assembly&gt;</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_workflow"><a class="link" href="#_workflow">3.5.2. Workflow</a></h4>
-<div class="paragraph">
-<p>The workflow would look similar to the one presented in the <code>Step by step guide to CDC</code>. The only difference
- is that the producer doesn&#8217;t own the contracts anymore. So the consumer and the producer have to work on
- common contracts in a common repository.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_consumer"><a class="link" href="#_consumer">3.5.3. Consumer</a></h4>
-<div class="paragraph">
-<p>When the <strong>consumer</strong> wants to work on the contracts offline, instead of cloning the producer code, the
-consumer team clones the common repository, goes to the required producer&#8217;s folder (e.g. <code>com/example/server</code>)
-and runs <code>mvn clean install -DskipTests</code> to install locally the stubs converted from the contracts.</p>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-You need to have <a href="https://maven.apache.org/download.cgi">Maven installed locally</a>
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_producer"><a class="link" href="#_producer">3.5.4. Producer</a></h4>
-<div class="paragraph">
-<p>As a <strong>producer</strong> it&#8217;s enough to alter the Spring Cloud Contract Verifier to provide the URL and the dependency
-of the JAR containing the contracts:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-	&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-	&lt;configuration&gt;
-		&lt;contractsMode&gt;REMOTE&lt;/contractsMode&gt;
-		&lt;contractsRepositoryUrl&gt;
-			https://link/to/your/nexus/or/artifactory/or/sth
-		&lt;/contractsRepositoryUrl&gt;
-		&lt;contractDependency&gt;
-			&lt;groupId&gt;com.example.standalone&lt;/groupId&gt;
-			&lt;artifactId&gt;contracts&lt;/artifactId&gt;
-		&lt;/contractDependency&gt;
-	&lt;/configuration&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With this setup the JAR with groupid <code>com.example.standalone</code> and artifactid <code>contracts</code> will be downloaded
-from <code><a href="https://link/to/your/nexus/or/artifactory/or/sth" class="bare">https://link/to/your/nexus/or/artifactory/or/sth</a></code>. It will be then unpacked in a local temporary folder
-and contracts present under the <code>com/example/server</code> will be picked as the ones used to generate the
-tests and the stubs. Due to this convention the producer team will know which consumer teams will be broken
-when some incompatible changes are done.</p>
-</div>
-<div class="paragraph">
-<p>The rest of the flow looks the same.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_can_i_define_messaging_contracts_per_topic_not_per_producer"><a class="link" href="#_how_can_i_define_messaging_contracts_per_topic_not_per_producer">3.5.5. How can I define messaging contracts per topic not per producer?</a></h4>
-<div class="paragraph">
-<p>To avoid messaging contracts duplication in the common repo, when few producers writing messages to one topic,
-we could create the structure when the rest contracts would be placed in a folder per producer and messaging
-contracts in the folder per topic.</p>
-</div>
-<div class="sect4">
-<h5 id="_for_maven_project"><a class="link" href="#_for_maven_project">For Maven Project</a></h5>
-<div class="paragraph">
-<p>To make it possible to work on the producer side we should specify an inclusion pattern for
-filtering common repository jar by messaging topics we are interested in. <code><code>includedFiles</code></code> property of <code><code>Maven Spring Cloud Contract plugin</code></code>
-allows us to do that. Also <code><code>contractsPath</code></code> need to be specified since the default path would be the common repository <code><code>groupid/artifactid</code></code>.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-   &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-   &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-   &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-   &lt;configuration&gt;
-      &lt;contractsMode&gt;REMOTE&lt;/contractsMode&gt;
-      &lt;contractsRepositoryUrl&gt;https://link/to/your/nexus/or/artifactory/or/sth&lt;/contractsRepositoryUrl&gt;
-      &lt;contractDependency&gt;
-         &lt;groupId&gt;com.example&lt;/groupId&gt;
-         &lt;artifactId&gt;common-repo-with-contracts&lt;/artifactId&gt;
-         &lt;version&gt;+&lt;/version&gt;
-      &lt;/contractDependency&gt;
-      &lt;contractsPath&gt;/&lt;/contractsPath&gt;
-      &lt;baseClassMappings&gt;
-         &lt;baseClassMapping&gt;
-            &lt;contractPackageRegex&gt;.*messaging.*&lt;/contractPackageRegex&gt;
-            &lt;baseClassFQN&gt;com.example.services.MessagingBase&lt;/baseClassFQN&gt;
-         &lt;/baseClassMapping&gt;
-         &lt;baseClassMapping&gt;
-            &lt;contractPackageRegex&gt;.*rest.*&lt;/contractPackageRegex&gt;
-            &lt;baseClassFQN&gt;com.example.services.TestBase&lt;/baseClassFQN&gt;
-         &lt;/baseClassMapping&gt;
-      &lt;/baseClassMappings&gt;
-      &lt;includedFiles&gt;
-         &lt;includedFile&gt;**/${project.artifactId}/**&lt;/includedFile&gt;
-         &lt;includedFile&gt;**/${first-topic}/**&lt;/includedFile&gt;
-         &lt;includedFile&gt;**/${second-topic}/**&lt;/includedFile&gt;
-      &lt;/includedFiles&gt;
-   &lt;/configuration&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_for_gradle_project"><a class="link" href="#_for_gradle_project">For Gradle Project</a></h5>
-<div class="ulist">
-<ul>
-<li>
-<p>Add a custom configuration for the common-repo dependency:</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">ext {
-    conractsGroupId = "com.example"
-    contractsArtifactId = "common-repo"
-    contractsVersion = "1.2.3"
-}
-
-configurations {
-    contracts {
-        transitive = false
-    }
-}</code></pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Add the common-repo dependency to your classpath:</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">dependencies {
-    contracts "${conractsGroupId}:${contractsArtifactId}:${contractsVersion}"
-    testCompile "${conractsGroupId}:${contractsArtifactId}:${contractsVersion}"
-}</code></pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Download the dependency to an appropriate folder:</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">task getContracts(type: Copy) {
-    from configurations.contracts
-    into new File(project.buildDir, "downloadedContracts")
-}</code></pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Unzip JAR:</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">task unzipContracts(type: Copy) {
-    def zipFile = new File(project.buildDir, "downloadedContracts/${contractsArtifactId}-${contractsVersion}.jar")
-    def outputDir = file("${buildDir}/unpackedContracts")
-
-    from zipTree(zipFile)
-    into outputDir
-}</code></pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Cleanup unused contracts:</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">task deleteUnwantedContracts(type: Delete) {
-    delete fileTree(dir: "${buildDir}/unpackedContracts",
-        include: "**/*",
-        excludes: [
-            "**/${project.name}/**"",
-            "**/${first-topic}/**",
-            "**/${second-topic}/**"])
-}</code></pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Create task dependencies:</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">unzipContracts.dependsOn("getContracts")
-deleteUnwantedContracts.dependsOn("unzipContracts")
-build.dependsOn("deleteUnwantedContracts")</code></pre>
-</div>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Configure plugin by specifying the directory containing contracts using <code>contractsDslDir</code> property</p>
-</li>
-</ul>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
-    contractsDslDir = new File("${buildDir}/unpackedContracts")
-}</code></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_do_i_need_a_binary_storage_cant_i_use_git"><a class="link" href="#_do_i_need_a_binary_storage_cant_i_use_git">3.6. Do I need a Binary Storage? Can&#8217;t I use Git?</a></h3>
-<div class="paragraph">
-<p>In the polyglot world, there are languages that don&#8217;t use binary storages like
-Artifactory or Nexus. Starting from Spring Cloud Contract version 2.0.0 we provide
-mechanisms to store contracts and stubs in a SCM repository. Currently the
-only supported SCM is Git.</p>
-</div>
-<div class="paragraph">
-<p>The repository would have to the following setup
-(which you can checkout <a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x/contracts_git/">here</a>):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code>.
-└── META-INF
-    └── com.example
-        └── beer-api-producer-git
-            └── 0.0.1-SNAPSHOT
-                ├── contracts
-                │   └── beer-api-consumer
-                │       ├── messaging
-                │       │   ├── shouldSendAcceptedVerification.groovy
-                │       │   └── shouldSendRejectedVerification.groovy
-                │       └── rest
-                │           ├── shouldGrantABeerIfOldEnough.groovy
-                │           └── shouldRejectABeerIfTooYoung.groovy
-                └── mappings
-                    └── beer-api-consumer
-                        └── rest
-                            ├── shouldGrantABeerIfOldEnough.json
-                            └── shouldRejectABeerIfTooYoung.json</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Under <code>META-INF</code> folder:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>we group applications via <code>groupId</code> (e.g. <code>com.example</code>)</p>
-</li>
-<li>
-<p>then each application is represented via the <code>artifactId</code> (e.g. <code>beer-api-producer-git</code>)</p>
-</li>
-<li>
-<p>next, the version of the application (e.g. <code>0.0.1-SNAPSHOT</code>). Starting from Spring Cloud Contract version <code>2.1.0</code>, you can specify the versions as follows (assuming that your versions follow the semantic versioning)</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>+</code> or <code>latest</code> - to find the latest version of your stubs (assuming that the snapshots are always the latest artifact for a given revision number). That means:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>if you have a version <code>1.0.0.RELEASE</code>, <code>2.0.0.BUILD-SNAPSHOT</code> and <code>2.0.0.RELEASE</code> we will assume that the latest is <code>2.0.0.BUILD-SNAPSHOT</code></p>
-</li>
-<li>
-<p>if you have a version <code>1.0.0.RELEASE</code> and <code>2.0.0.RELEASE</code> we will assume that the latest is <code>2.0.0.RELEASE</code></p>
-</li>
-<li>
-<p>if you have a version called <code>latest</code> or <code>+</code> we will pick that folder</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><code>release</code> - to find the latest release version of your stubs. That means:</p>
-<div class="ulist">
-<ul>
-<li>
-<p>if you have a version <code>1.0.0.RELEASE</code>, <code>2.0.0.BUILD-SNAPSHOT</code> and <code>2.0.0.RELEASE</code> we will assume that the latest is <code>2.0.0.RELEASE</code></p>
-</li>
-<li>
-<p>if you have a version called <code>release</code> we will pick that folder</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>finally, there are two folders:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>contracts</code> - the good practice is to store the contracts required by each
-consumer in the folder with the consumer name (e.g. <code>beer-api-consumer</code>). That way you
-can use the <code>stubs-per-consumer</code> feature. Further directory structure is arbitrary.</p>
-</li>
-<li>
-<p><code>mappings</code> - in this folder the Maven / Gradle Spring Cloud Contract plugins will push
-the stub server mappings. On the consumer side, Stub Runner will scan this folder
-to start stub servers with stub definitions. The folder structure will be a copy
-of the one created in the <code>contracts</code> subfolder.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="sect3">
-<h4 id="_protocol_convention"><a class="link" href="#_protocol_convention">3.6.1. Protocol convention</a></h4>
-<div class="paragraph">
-<p>In order to control the type and location of the source of contracts (whether it&#8217;s
-a binary storage or an SCM repository), you can use the protocol in the URL of
-the repository. Spring Cloud Contract iterates over registered protocol resolvers
-and tries to fetch the contracts (via a plugin) or stubs (via Stub Runner).</p>
-</div>
-<div class="paragraph">
-<p>For the SCM functionality, currently, we support the Git repository. To use it,
-in the property, where the repository URL needs to be placed you just have to prefix
-the connection URL with <code>git://</code>. Here you can find a couple of examples:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code>git://file:///foo/bar
-git://https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git
-git://git@github.com:spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_producer_2"><a class="link" href="#_producer_2">3.6.2. Producer</a></h4>
-<div class="paragraph">
-<p>For the producer, to use the SCM approach, we can reuse the
-same mechanism we use for external contracts. We route Spring Cloud Contract
-to use the SCM implementation via the URL that contains
-the <code>git://</code> protocol.</p>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-You have to manually add the <code>pushStubsToScm</code>
-goal in Maven or execute (bind) the <code>pushStubsToScm</code> task in
-Gradle. We don&#8217;t push stubs to <code>origin</code> of your git
-repository out of the box.
-</td>
-</tr>
-</table>
-</div>
-<div class="listingblock">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-    &lt;extensions&gt;true&lt;/extensions&gt;
-    &lt;configuration&gt;
-        &lt;!-- Base class mappings etc. --&gt;
-
-        &lt;!-- We want to pick contracts from a Git repository --&gt;
-        &lt;contractsRepositoryUrl&gt;git://https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git&lt;/contractsRepositoryUrl&gt;
-
-        &lt;!-- We reuse the contract dependency section to set up the path
-        to the folder that contains the contract definitions. In our case the
-        path will be /groupId/artifactId/version/contracts --&gt;
-        &lt;contractDependency&gt;
-            &lt;groupId&gt;${project.groupId}&lt;/groupId&gt;
-            &lt;artifactId&gt;${project.artifactId}&lt;/artifactId&gt;
-            &lt;version&gt;${project.version}&lt;/version&gt;
-        &lt;/contractDependency&gt;
-
-        &lt;!-- The contracts mode can't be classpath --&gt;
-        &lt;contractsMode&gt;REMOTE&lt;/contractsMode&gt;
-    &lt;/configuration&gt;
-    &lt;executions&gt;
-        &lt;execution&gt;
-            &lt;phase&gt;package&lt;/phase&gt;
-            &lt;goals&gt;
-                &lt;!-- By default we will not push the stubs back to SCM,
-                you have to explicitly add it as a goal --&gt;
-                &lt;goal&gt;pushStubsToScm&lt;/goal&gt;
-            &lt;/goals&gt;
-        &lt;/execution&gt;
-    &lt;/executions&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-gradle hljs" data-lang="gradle">contracts {
-	// We want to pick contracts from a Git repository
-	contractDependency {
-		stringNotation = "${project.group}:${project.name}:${project.version}"
-	}
-	/*
-	We reuse the contract dependency section to set up the path
-	to the folder that contains the contract definitions. In our case the
-	path will be /groupId/artifactId/version/contracts
-	 */
-	contractRepository {
-		repositoryUrl = "git://https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git"
-	}
-	// The mode can't be classpath
-	contractsMode = "REMOTE"
-	// Base class mappings etc.
-}
-
-/*
-In this scenario we want to publish stubs to SCM whenever
-the `publish` task is executed
-*/
-publish.dependsOn("publishStubsToScm")</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With such a setup:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Git project will be cloned to a temporary directory</p>
-</li>
-<li>
-<p>The SCM stub downloader will go to <code>META-INF/groupId/artifactId/version/contracts</code> folder
-to find contracts. E.g. for <code>com.example:foo:1.0.0</code> the path would be
-<code>META-INF/com.example/foo/1.0.0/contracts</code></p>
-</li>
-<li>
-<p>Tests will be generated from the contracts</p>
-</li>
-<li>
-<p>Stubs will be created from the contracts</p>
-</li>
-<li>
-<p>Once the tests pass, the stubs will be committed in the cloned repository</p>
-</li>
-<li>
-<p>Finally, a push will be done to that repo&#8217;s <code>origin</code></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_producer_with_contracts_stored_locally"><a class="link" href="#_producer_with_contracts_stored_locally">3.6.3. Producer with contracts stored locally</a></h4>
-<div class="paragraph">
-<p>Another option to use the SCM as the destination for stubs and contracts is to store the contracts locally, with the producer, and only push the contracts and the stubs to SCM. Below, you can find the setup required to achieve this using Maven and Gradle.</p>
-</div>
-<div class="listingblock">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-	&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-	&lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-	&lt;extensions&gt;true&lt;/extensions&gt;
-	&lt;!-- In the default configuration, we want to use the contracts stored locally --&gt;
-	&lt;configuration&gt;
-		&lt;baseClassMappings&gt;
-			&lt;baseClassMapping&gt;
-				&lt;contractPackageRegex&gt;.*messaging.*&lt;/contractPackageRegex&gt;
-				&lt;baseClassFQN&gt;com.example.BeerMessagingBase&lt;/baseClassFQN&gt;
-			&lt;/baseClassMapping&gt;
-			&lt;baseClassMapping&gt;
-				&lt;contractPackageRegex&gt;.*rest.*&lt;/contractPackageRegex&gt;
-				&lt;baseClassFQN&gt;com.example.BeerRestBase&lt;/baseClassFQN&gt;
-			&lt;/baseClassMapping&gt;
-		&lt;/baseClassMappings&gt;
-		&lt;basePackageForTests&gt;com.example&lt;/basePackageForTests&gt;
-	&lt;/configuration&gt;
-	&lt;executions&gt;
-		&lt;execution&gt;
-			&lt;phase&gt;package&lt;/phase&gt;
-			&lt;goals&gt;
-				&lt;!-- By default we will not push the stubs back to SCM,
-				you have to explicitly add it as a goal --&gt;
-				&lt;goal&gt;pushStubsToScm&lt;/goal&gt;
-			&lt;/goals&gt;
-			&lt;configuration&gt;
-				&lt;!-- We want to pick contracts from a Git repository --&gt;
-				&lt;contractsRepositoryUrl&gt;git://file://${env.ROOT}/target/contract_empty_git/
-				&lt;/contractsRepositoryUrl&gt;
-				&lt;!-- Example of URL via git protocol --&gt;
-				&lt;!--&lt;contractsRepositoryUrl&gt;git://git@github.com:spring-cloud-samples/spring-cloud-contract-samples.git&lt;/contractsRepositoryUrl&gt;--&gt;
-				&lt;!-- Example of URL via http protocol --&gt;
-				&lt;!--&lt;contractsRepositoryUrl&gt;git://https://github.com/spring-cloud-samples/spring-cloud-contract-samples.git&lt;/contractsRepositoryUrl&gt;--&gt;
-				&lt;!-- We reuse the contract dependency section to set up the path
-				to the folder that contains the contract definitions. In our case the
-				path will be /groupId/artifactId/version/contracts --&gt;
-				&lt;contractDependency&gt;
-					&lt;groupId&gt;${project.groupId}&lt;/groupId&gt;
-					&lt;artifactId&gt;${project.artifactId}&lt;/artifactId&gt;
-					&lt;version&gt;${project.version}&lt;/version&gt;
-				&lt;/contractDependency&gt;
-				&lt;!-- The mode can't be classpath --&gt;
-				&lt;contractsMode&gt;LOCAL&lt;/contractsMode&gt;
-			&lt;/configuration&gt;
-		&lt;/execution&gt;
-	&lt;/executions&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">contracts {
-		// Base package for generated tests
-	basePackageForTests = "com.example"
-	baseClassMappings {
-		baseClassMapping(".*messaging.*", "com.example.BeerMessagingBase")
-		baseClassMapping(".*rest.*", "com.example.BeerRestBase")
-	}
-}
-
-/*
-In this scenario we want to publish stubs to SCM whenever
-the `publish` task is executed
-*/
-publishStubsToScm {
-	// We want to modify the default set up of the plugin when publish stubs to scm is called
-	customize {
-		// We want to pick contracts from a Git repository
-		contractDependency {
-			stringNotation = "${project.group}:${project.name}:${project.version}"
-		}
-		/*
-		We reuse the contract dependency section to set up the path
-		to the folder that contains the contract definitions. In our case the
-		path will be /groupId/artifactId/version/contracts
-		 */
-		contractRepository {
-			repositoryUrl = "git://file://${System.getenv("ROOT")}/target/contract_empty_git/"
-		}
-		// The mode can't be classpath
-		contractsMode = "LOCAL"
-	}
-}
-
-publish.dependsOn("publishStubsToScm")
-publishToMavenLocal.dependsOn("publishStubsToScm")</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With such a setup:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Contracts from the default <code>src/test/resources/contracts</code> directory will be picked</p>
-</li>
-<li>
-<p>Tests will be generated from the contracts</p>
-</li>
-<li>
-<p>Stubs will be created from the contracts</p>
-</li>
-<li>
-<p>Once the tests pass</p>
-<div class="ulist">
-<ul>
-<li>
-<p>Git project will be cloned to a temporary directory</p>
-</li>
-<li>
-<p>The stubs and contracts will be committed in the cloned repository</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>Finally, a push will be done to that repo&#8217;s <code>origin</code></p>
-</li>
-</ul>
-</div>
-<div class="sect4">
-<h5 id="_keeping_contracts_with_the_producer_and_stubs_in_an_external_repository"><a class="link" href="#_keeping_contracts_with_the_producer_and_stubs_in_an_external_repository">Keeping contracts with the producer and stubs in an external repository</a></h5>
-<div class="paragraph">
-<p>It is also possible to keep the contracts in the producer repository, but keep the stubs in an external git repo.
-This is most useful when you want to use the base consumer-producer collaboration flow, but do not have a possibility to
-use an artifact repository for storing the stubs.</p>
-</div>
-<div class="paragraph">
-<p>In order to do that, use the usual producer setup, and then add the <code>pushStubsToScm</code> goal and set
-<code>contractsRepositoryUrl</code> to the repository where you want to keep the stubs.</p>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_consumer_2"><a class="link" href="#_consumer_2">3.6.4. Consumer</a></h4>
-<div class="paragraph">
-<p>On the consumer side when passing the <code>repositoryRoot</code> parameter,
-either from the <code>@AutoConfigureStubRunner</code> annotation, the
-JUnit rule, JUnit 5 extension or properties, it&#8217;s enough to pass the URL of the
-SCM repository, prefixed with the protocol. For example</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(
-    stubsMode="REMOTE",
-    repositoryRoot="git://https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git",
-    ids="com.example:bookstore:0.0.1.RELEASE"
-)</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With such a setup:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Git project will be cloned to a temporary directory</p>
-</li>
-<li>
-<p>The SCM stub downloader will go to <code>META-INF/groupId/artifactId/version/</code> folder
-to find stub definitions and contracts. E.g. for <code>com.example:foo:1.0.0</code> the path would be
-<code>META-INF/com.example/foo/1.0.0/</code></p>
-</li>
-<li>
-<p>Stub servers will be started and fed with mappings</p>
-</li>
-<li>
-<p>Messaging definitions will be read and used in the messaging tests</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_can_i_use_the_pact_broker"><a class="link" href="#_can_i_use_the_pact_broker">3.7. Can I use the Pact Broker?</a></h3>
-<div class="paragraph">
-<p>When using <a href="https://pact.io/">Pact</a> you can use the <a href="https://github.com/pact-foundation/pact_broker">Pact Broker</a>
-to store and share Pact definitions. Starting from Spring Cloud Contract
-2.0.0 one can fetch Pact files from the Pact Broker to generate
-tests and stubs.</p>
-</div>
-<div class="paragraph">
-<p>As a prerequisite the Pact Converter and Pact Stub Downloader
-are required. You have to add them via the <code>spring-cloud-contract-pact</code> dependency.
-You can read more about it in the <a href="#pact-converter">Pact Converter</a> section.</p>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-Pact follows the Consumer Contract convention. That means
-that the Consumer creates the Pact definitions first, then
-shares the files with the Producer. Those expectations are generated
-from the Consumer&#8217;s code and can break the Producer if the expectations
-are not met.
-</td>
-</tr>
-</table>
-</div>
-<div class="sect3">
-<h4 id="_pact_consumer"><a class="link" href="#_pact_consumer">3.7.1. Pact Consumer</a></h4>
-<div class="paragraph">
-<p>The consumer uses Pact framework to generate Pact files. The
-Pact files are sent to the Pact Broker. An example of such
-setup can be found <a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x/consumer_pact">here</a>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_producer_3"><a class="link" href="#_producer_3">3.7.2. Producer</a></h4>
-<div class="paragraph">
-<p>For the producer, to use the Pact files from the Pact Broker, we can reuse the
-same mechanism we use for external contracts. We route Spring Cloud Contract
-to use the Pact implementation via the URL that contains
-the <code>pact://</code> protocol. It&#8217;s enough to pass the URL to the
-Pact Broker. An example of such setup can be found <a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x/producer_pact">here</a>.</p>
-</div>
-<div class="listingblock">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-    &lt;extensions&gt;true&lt;/extensions&gt;
-    &lt;configuration&gt;
-        &lt;!-- Base class mappings etc. --&gt;
-
-        &lt;!-- We want to pick contracts from a Git repository --&gt;
-        &lt;contractsRepositoryUrl&gt;pact://http://localhost:8085&lt;/contractsRepositoryUrl&gt;
-
-        &lt;!-- We reuse the contract dependency section to set up the path
-        to the folder that contains the contract definitions. In our case the
-        path will be /groupId/artifactId/version/contracts --&gt;
-        &lt;contractDependency&gt;
-            &lt;groupId&gt;${project.groupId}&lt;/groupId&gt;
-            &lt;artifactId&gt;${project.artifactId}&lt;/artifactId&gt;
-            &lt;!-- When + is passed, a latest tag will be applied when fetching pacts --&gt;
-            &lt;version&gt;+&lt;/version&gt;
-        &lt;/contractDependency&gt;
-
-        &lt;!-- The contracts mode can't be classpath --&gt;
-        &lt;contractsMode&gt;REMOTE&lt;/contractsMode&gt;
-    &lt;/configuration&gt;
-    &lt;!-- Don't forget to add spring-cloud-contract-pact to the classpath! --&gt;
-    &lt;dependencies&gt;
-        &lt;dependency&gt;
-            &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-            &lt;artifactId&gt;spring-cloud-contract-pact&lt;/artifactId&gt;
-            &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-        &lt;/dependency&gt;
-    &lt;/dependencies&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-gradle hljs" data-lang="gradle">buildscript {
-	repositories {
-		//...
-	}
-
-	dependencies {
-		// ...
-		// Don't forget to add spring-cloud-contract-pact to the classpath!
-		classpath "org.springframework.cloud:spring-cloud-contract-pact:${contractVersion}"
-	}
-}
-
-contracts {
-	// When + is passed, a latest tag will be applied when fetching pacts
-	contractDependency {
-		stringNotation = "${project.group}:${project.name}:+"
-	}
-	contractRepository {
-		repositoryUrl = "pact://http://localhost:8085"
-	}
-	// The mode can't be classpath
-	contractsMode = "REMOTE"
-	// Base class mappings etc.
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With such a setup:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Pact files will be downloaded from the Pact Broker</p>
-</li>
-<li>
-<p>Spring Cloud Contract will convert the Pact files into tests and stubs</p>
-</li>
-<li>
-<p>The JAR with the stubs gets automatically created as usual</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_pact_consumer_producer_contract_approach"><a class="link" href="#_pact_consumer_producer_contract_approach">3.7.3. Pact Consumer (Producer Contract approach)</a></h4>
-<div class="paragraph">
-<p>In the scenario where you don&#8217;t want to do Consumer Contract approach
-(for every single consumer define the expectations) but you&#8217;d prefer
-to do Producer Contracts (the producer provides the contracts and
-publishes stubs), it&#8217;s enough to use Spring Cloud Contract with
-Stub Runner option. An example of such setup can be found <a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x/consumer_pact_stubrunner">here</a>.</p>
-</div>
-<div class="paragraph">
-<p>First, remember to add Stub Runner and Spring Cloud Contract Pact module
-as test dependencies.</p>
-</div>
-<div class="listingblock">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependencyManagement&gt;
-    &lt;dependencies&gt;
-        &lt;dependency&gt;
-            &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-            &lt;artifactId&gt;spring-cloud-dependencies&lt;/artifactId&gt;
-            &lt;version&gt;${spring-cloud.version}&lt;/version&gt;
-            &lt;type&gt;pom&lt;/type&gt;
-            &lt;scope&gt;import&lt;/scope&gt;
-        &lt;/dependency&gt;
-    &lt;/dependencies&gt;
-&lt;/dependencyManagement&gt;
-
-&lt;!-- Don't forget to add spring-cloud-contract-pact to the classpath! --&gt;
-&lt;dependencies&gt;
-    &lt;!-- ... --&gt;
-    &lt;dependency&gt;
-        &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-        &lt;artifactId&gt;spring-cloud-starter-contract-stub-runner&lt;/artifactId&gt;
-        &lt;scope&gt;test&lt;/scope&gt;
-    &lt;/dependency&gt;
-    &lt;dependency&gt;
-        &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-        &lt;artifactId&gt;spring-cloud-contract-pact&lt;/artifactId&gt;
-        &lt;scope&gt;test&lt;/scope&gt;
-    &lt;/dependency&gt;
-&lt;/dependencies&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-gradle hljs" data-lang="gradle">dependencyManagement {
-    imports {
-        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
-    }
-}
-
-dependencies {
-    //...
-    testCompile("org.springframework.cloud:spring-cloud-starter-contract-stub-runner")
-    // Don't forget to add spring-cloud-contract-pact to the classpath!
-    testCompile("org.springframework.cloud:spring-cloud-contract-pact")
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Next, just pass the URL of the Pact Broker to <code>repositoryRoot</code>, prefixed
-with <code>pact://</code> protocol. E.g. <code>pact://http://localhost:8085</code></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
-@SpringBootTest
-@AutoConfigureStubRunner(stubsMode = StubRunnerProperties.StubsMode.REMOTE,
-		ids = "com.example:beer-api-producer-pact",
-		repositoryRoot = "pact://http://localhost:8085")
-public class BeerControllerTest {
-    //Inject the port of the running stub
-    @StubRunnerPort("beer-api-producer-pact") int producerPort;
-    //...
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>With such a setup:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Pact files will be downloaded from the Pact Broker</p>
-</li>
-<li>
-<p>Spring Cloud Contract will convert the Pact files into stub definitions</p>
-</li>
-<li>
-<p>The stub servers will be started and fed with stubs</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>For more information about Pact support you can go to
-the <a href="#pact-stub-downloader">Using the Pact Stub Downloader</a> section.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_how_can_i_debug_the_requestresponse_being_sent_by_the_generated_tests_client"><a class="link" href="#_how_can_i_debug_the_requestresponse_being_sent_by_the_generated_tests_client">3.8. How can I debug the request/response being sent by the generated tests client?</a></h3>
-<div class="paragraph">
-<p>The generated tests all boil down to RestAssured in some form or fashion which relies on <a href="https://hc.apache.org/httpcomponents-client-ga/">Apache HttpClient</a>.  HttpClient has a facility called <a href="https://hc.apache.org/httpcomponents-client-ga/logging.html#Wire_Logging">wire logging</a> which logs the entire request and response to HttpClient.  Spring Boot has a logging <a href="https://docs.spring.io/spring-boot/docs/current/reference/html/common-application-properties.html">common application property</a> for doing this sort of thing, just add this to your application properties</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties">logging.level.org.apache.http.wire=DEBUG</code></pre>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_can_i_debug_the_mappingrequestresponse_being_sent_by_wiremock"><a class="link" href="#_how_can_i_debug_the_mappingrequestresponse_being_sent_by_wiremock">3.8.1. How can I debug the mapping/request/response being sent by WireMock?</a></h4>
-<div class="paragraph">
-<p>Starting from version <code>1.2.0</code> we turn on WireMock logging to
-info and the WireMock notifier to being verbose. Now you will
-exactly know what request was received by WireMock server and which
-matching response definition was picked.</p>
-</div>
-<div class="paragraph">
-<p>To turn off this feature just bump WireMock logging to <code>ERROR</code></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties">logging.level.com.github.tomakehurst.wiremock=ERROR</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_can_i_see_what_got_registered_in_the_http_server_stub"><a class="link" href="#_how_can_i_see_what_got_registered_in_the_http_server_stub">3.8.2. How can I see what got registered in the HTTP server stub?</a></h4>
-<div class="paragraph">
-<p>You can use the <code>mappingsOutputFolder</code> property on <code>@AutoConfigureStubRunner</code>, <code>StubRunnerRule</code> or
-`StubRunnerExtension`to dump all mappings per artifact id. Also the port at which the given stub server
-was started will be attached.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_can_i_reference_text_from_file"><a class="link" href="#_can_i_reference_text_from_file">3.8.3. Can I reference text from file?</a></h4>
-<div class="paragraph">
-<p>Yes! With version 1.2.0 we&#8217;ve added such a possibility. It&#8217;s enough to call <code>file(&#8230;&#8203;)</code> method in the
-DSL and provide a path relative to where the contract lays.
-If you&#8217;re using YAML just use the <code>bodyFromFile</code> property.</p>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_spring_cloud_contract_verifier_setup"><a class="link" href="#_spring_cloud_contract_verifier_setup">4. Spring Cloud Contract Verifier Setup</a></h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>You can set up Spring Cloud Contract Verifier in the following ways:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="#gradle-project">As a Gradle project</a></p>
-</li>
-<li>
-<p><a href="#maven-project">As a Maven project</a></p>
-</li>
-<li>
-<p><a href="#docker-project">As a Docker project</a></p>
-</li>
-</ul>
-</div>
-<div class="sect2">
-<h3 id="gradle-project"><a class="link" href="#gradle-project">4.1. Gradle Project</a></h3>
-<div class="paragraph">
-<p>To learn how to set up the Gradle project for Spring Cloud Contract Verifier, read the
-following sections:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="#gradle-prerequisites">Prerequisites</a></p>
-</li>
-<li>
-<p><a href="#gradle-add-gradle-plugin">Add Gradle Plugin with Dependencies</a></p>
-</li>
-<li>
-<p><a href="#gradle-and-rest-assured">Gradle and Rest Assured 2.0</a></p>
-</li>
-<li>
-<p><a href="#gradle-snapshot-versions">Snapshot Versions for Gradle</a></p>
-</li>
-<li>
-<p><a href="#gradle-add-stubs">Add stubs</a></p>
-</li>
-<li>
-<p><a href="#gradle-default-setup">Default Setup</a></p>
-</li>
-<li>
-<p><a href="#gradle-configure-plugin">Configure Plugin</a></p>
-</li>
-<li>
-<p><a href="#gradle-configuration-options">Configuration Options</a></p>
-</li>
-<li>
-<p><a href="#gradle-single-base-class">Single Base Class for All Tests</a></p>
-</li>
-<li>
-<p><a href="#gradle-different-base-classes">Different Base Classes for Contracts</a></p>
-</li>
-<li>
-<p><a href="#gradle-invoking-generated-tests">Invoking Generated Tests</a></p>
-</li>
-<li>
-<p><a href="#gradle-pushing-stubs-to-scm">Pushing stubs to SCM</a></p>
-</li>
-<li>
-<p><a href="#gradle-consumer">Spring Cloud Contract Verifier on the Consumer Side</a></p>
-</li>
-</ul>
-</div>
-<div class="sect3">
-<h4 id="gradle-prerequisites"><a class="link" href="#gradle-prerequisites">4.1.1. Prerequisites</a></h4>
-<div class="paragraph">
-<p>In order to use Spring Cloud Contract Verifier with WireMock, you muse use either a
-Gradle or a Maven plugin.</p>
-</div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
-</td>
-<td class="content">
-If you want to use Spock in your projects, you must add separately the
-<code>spock-core</code> and <code>spock-spring</code> modules. Check <a href="https://spockframework.github.io/">Spock
-docs for more information</a>
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect3">
-<h4 id="gradle-add-gradle-plugin"><a class="link" href="#gradle-add-gradle-plugin">4.1.2. Add Gradle Plugin with Dependencies</a></h4>
-<div class="paragraph">
-<p>To add a Gradle plugin with dependencies, use code similar to this:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">buildscript {
-	repositories {
-		mavenCentral()
-	}
-	dependencies {
-		classpath "org.springframework.boot:spring-boot-gradle-plugin:${springboot_version}"
-		classpath "org.springframework.cloud:spring-cloud-contract-gradle-plugin:${verifier_version}"
-	}
-}
-
-apply plugin: 'groovy'
-apply plugin: 'spring-cloud-contract'
-
-dependencyManagement {
-	imports {
-		mavenBom "org.springframework.cloud:spring-cloud-contract-dependencies:${verifier_version}"
-	}
-}
-
-dependencies {
-	testCompile 'org.codehaus.groovy:groovy-all:2.4.6'
-	// example with adding Spock core and Spock Spring
-	testCompile 'org.spockframework:spock-core:1.0-groovy-2.4'
-	testCompile 'org.spockframework:spock-spring:1.0-groovy-2.4'
-	testCompile 'org.springframework.cloud:spring-cloud-starter-contract-verifier'
-}</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="gradle-and-rest-assured"><a class="link" href="#gradle-and-rest-assured">4.1.3. Gradle and Rest Assured 2.0</a></h4>
-<div class="paragraph">
-<p>By default, Rest Assured 3.x is added to the classpath. However, to use Rest Assured 2.x
-you can add it to the plugins classpath, as shown here:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">buildscript {
-	repositories {
-		mavenCentral()
-	}
-	dependencies {
-		classpath "org.springframework.boot:spring-boot-gradle-plugin:${springboot_version}"
-		classpath "org.springframework.cloud:spring-cloud-contract-gradle-plugin:${verifier_version}"
-		classpath "com.jayway.restassured:rest-assured:2.5.0"
-		classpath "com.jayway.restassured:spring-mock-mvc:2.5.0"
-	}
-}
-
-depenendencies {
-    // all dependencies
-    // you can exclude rest-assured from spring-cloud-contract-verifier
-    testCompile "com.jayway.restassured:rest-assured:2.5.0"
-    testCompile "com.jayway.restassured:spring-mock-mvc:2.5.0"
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>That way, the plugin automatically sees that Rest Assured 2.x is present on the classpath
-and modifies the imports accordingly.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="gradle-snapshot-versions"><a class="link" href="#gradle-snapshot-versions">4.1.4. Snapshot Versions for Gradle</a></h4>
-<div class="paragraph">
-<p>Add the additional snapshot repository to your build.gradle to use snapshot versions,
-which are automatically uploaded after every successful build, as shown here:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">buildscript {
-	repositories {
-		mavenCentral()
-		mavenLocal()
-		maven { url "https://repo.spring.io/snapshot" }
-		maven { url "https://repo.spring.io/milestone" }
-		maven { url "https://repo.spring.io/release" }
-	}
-}</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="gradle-add-stubs"><a class="link" href="#gradle-add-stubs">4.1.5. Add stubs</a></h4>
-<div class="paragraph">
-<p>By default, Spring Cloud Contract Verifier is looking for stubs in the
-<code>src/test/resources/contracts</code> directory.</p>
-</div>
-<div class="paragraph">
-<p>The directory containing stub definitions is treated as a class name, and each stub
-definition is treated as a single test. Spring Cloud Contract Verifier assumes that it
-contains at  least one level of directories that are to be used as the test class name.
-If more than  one level of nested directories is present, all except the last one is used
-as the package name. For example, with following structure:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">src/test/resources/contracts/myservice/shouldCreateUser.groovy
-src/test/resources/contracts/myservice/shouldReturnUser.groovy</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Spring Cloud Contract Verifier creates a test class named <code>defaultBasePackage.MyService</code>
-with two methods:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>shouldCreateUser()</code></p>
-</li>
-<li>
-<p><code>shouldReturnUser()</code></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="gradle-run-plugin"><a class="link" href="#gradle-run-plugin">4.1.6. Run the Plugin</a></h4>
-<div class="paragraph">
-<p>The plugin registers itself to be invoked before a <code>check</code> task. If you want it to be
-part of your build process, you need to do nothing more. If you just want to generate
-tests, invoke the <code>generateContractTests</code> task.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="gradle-default-setup"><a class="link" href="#gradle-default-setup">4.1.7. Default Setup</a></h4>
-<div class="paragraph">
-<p>The default Gradle Plugin setup creates the following Gradle part of the build (in
-pseudocode):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
-    testFramework ='JUNIT'
-    testMode = 'MockMvc'
-    generatedTestSourcesDir = project.file("${project.buildDir}/generated-test-sources/contracts")
-    generatedTestResourcesDir = project.file("${project.buildDir}/generated-test-resources/contracts")
-    contractsDslDir = "${project.rootDir}/src/test/resources/contracts"
-    basePackageForTests = 'org.springframework.cloud.verifier.tests'
-    stubsOutputDir = project.file("${project.buildDir}/stubs")
-
-    // the following properties are used when you want to provide where the JAR with contract lays
-    contractDependency {
-        stringNotation = ''
-    }
-    contractsPath = ''
-    contractsWorkOffline = false
-    contractRepository {
-        cacheDownloadedContracts(true)
-    }
-}
-
-tasks.create(type: Jar, name: 'verifierStubsJar', dependsOn: 'generateClientStubs') {
-    baseName = project.name
-    classifier = contracts.stubsSuffix
-    from contractVerifier.stubsOutputDir
-}
-
-project.artifacts {
-    archives task
-}
-
-tasks.create(type: Copy, name: 'copyContracts') {
-    from contracts.contractsDslDir
-    into contracts.stubsOutputDir
-}
-
-verifierStubsJar.dependsOn 'copyContracts'
-
-publishing {
-    publications {
-        stubs(MavenPublication) {
-            artifactId project.name
-            artifact verifierStubsJar
-        }
-    }
-}</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="gradle-configure-plugin"><a class="link" href="#gradle-configure-plugin">4.1.8. Configure Plugin</a></h4>
-<div class="paragraph">
-<p>To change the default configuration, add a <code>contracts</code> snippet to your Gradle config, as
-shown here:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
-	testMode = 'MockMvc'
-	baseClassForTests = 'org.mycompany.tests'
-	generatedTestSourcesDir = project.file('src/generatedContract')
-}</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="gradle-configuration-options"><a class="link" href="#gradle-configuration-options">4.1.9. Configuration Options</a></h4>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>testMode</strong>: Defines the mode for acceptance tests. By default, the mode is MockMvc,
-which is based on Spring&#8217;s MockMvc. It can also be changed to <strong>WebTestClient</strong>, <strong>JaxRsClient</strong> or to
-<strong>Explicit</strong> for real HTTP calls.</p>
-</li>
-<li>
-<p><strong>imports</strong>: Creates an array with imports that should be included in generated tests
-(for example ['org.myorg.Matchers']). By default, it creates an empty array.</p>
-</li>
-<li>
-<p><strong>staticImports</strong>: Creates an array with static imports that should be included in
-generated tests(for example ['org.myorg.Matchers.*']). By default, it creates an empty
-array.</p>
-</li>
-<li>
-<p><strong>basePackageForTests</strong>: Specifies the base package for all generated tests. If not set,
-the value is picked from <code>baseClassForTests&#8217;s package and from `packageWithBaseClasses</code>.
-If neither of these values are set, then the value is set to
-<code>org.springframework.cloud.contract.verifier.tests</code>.</p>
-</li>
-<li>
-<p><strong>baseClassForTests</strong>: Creates a base class for all generated tests. By default, if you
-use Spock classes, the class is <code>spock.lang.Specification</code>.</p>
-</li>
-<li>
-<p><strong>packageWithBaseClasses</strong>: Defines a package where all the base classes reside. This
-setting takes precedence over <strong>baseClassForTests</strong>.</p>
-</li>
-<li>
-<p><strong>baseClassMappings</strong>: Explicitly maps a contract package to a FQN of a base class. This
-setting takes precedence over <strong>packageWithBaseClasses</strong> and <strong>baseClassForTests</strong>.</p>
-</li>
-<li>
-<p><strong>ruleClassForTests</strong>: Specifies a rule that should be added to the generated test
-classes.</p>
-</li>
-<li>
-<p><strong>ignoredFiles</strong>: Uses an <code>Antmatcher</code> to allow defining stub files for which processing
-should be skipped. By default, it is an empty array.</p>
-</li>
-<li>
-<p><strong>contractsDslDir</strong>: Specifies the directory containing contracts written using the
-GroovyDSL. By default, its value is <code>$rootDir/src/test/resources/contracts</code>.</p>
-</li>
-<li>
-<p><strong>generatedTestSourcesDir</strong>: Specifies the test source directory where tests generated
-from the Groovy DSL should be placed. By default its value is
-<code>$buildDir/generated-test-sources/contracts</code>.</p>
-</li>
-<li>
-<p><strong>generatedTestResourcesDir</strong>: Specifies the test resource directory where resources used by the tests generated
-from the Groovy DSL should be placed. By default its value is
-<code>$buildDir/generated-test-resources/contracts</code>.</p>
-</li>
-<li>
-<p><strong>stubsOutputDir</strong>: Specifies the directory where the generated WireMock stubs from
-the Groovy DSL should be placed.</p>
-</li>
-<li>
-<p><strong>testFramework</strong>: Specifies the target test framework to be used. Currently, Spock, JUnit 4 (<code>TestFramework.JUNIT</code>), TestNG and
-JUnit 5 are supported with JUnit 4 being the default framework.</p>
-</li>
-<li>
-<p><strong>contractsProperties</strong>: a map containing properties to be passed to Spring Cloud Contract
-components. Those properties might be used by e.g. inbuilt or custom Stub Downloaders.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The following properties are used when you want to specify the location of the JAR
-containing the contracts:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>contractDependency</strong>: Specifies the Dependency that provides
-<code>groupid:artifactid:version:classifier</code> coordinates. You can use the <code>contractDependency</code>
-closure to set it up.</p>
-</li>
-<li>
-<p><strong>contractsPath</strong>: Specifies the path to the jar. If contract dependencies are
-downloaded, the path defaults to <code>groupid/artifactid</code> where <code>groupid</code> is slash
-separated. Otherwise, it scans contracts under the provided directory.</p>
-</li>
-<li>
-<p><strong>contractsMode</strong>: Specifies the mode of downloading contracts (whether the
-JAR is available offline, remotely etc.)</p>
-</li>
-<li>
-<p><strong>deleteStubsAfterTest</strong>: If set to <code>false</code> will not remove any downloaded
-contracts from temporary directories</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Below you can find a list of experimental features you can turn on via the plugin:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>convertToYaml</strong>: converts all DSLs to the declarative, YAML format. This can be extremely useful when you&#8217;re using external libraries in your Groovy DSLs. By turning this feature on (by setting it to <code>true</code>) you will not need to add the library dependency on the consumer side.</p>
-</li>
-<li>
-<p><strong>assertJsonSize</strong>: You can check the size of JSON arrays in the generated tests. This feature is disabled by default.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="gradle-single-base-class"><a class="link" href="#gradle-single-base-class">4.1.10. Single Base Class for All Tests</a></h4>
-<div class="paragraph">
-<p>When using Spring Cloud Contract Verifier in default MockMvc, you need to create a base
-specification for all generated acceptance tests. In this class, you need to point to an
-endpoint, which should be verified.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">abstract class BaseMockMvcSpec extends Specification {
-
-	def setup() {
-		RestAssuredMockMvc.standaloneSetup(new PairIdController())
-	}
-
-	void isProperCorrelationId(Integer correlationId) {
-		assert correlationId == 123456
-	}
-
-	void isEmpty(String value) {
-		assert value == null
-	}
-
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you use <code>Explicit</code> mode, you can use a base class to initialize the whole tested app
-as you might see in regular integration tests. If you use the <code>JAXRSCLIENT</code> mode, this
-base class should also contain a <code>protected WebTarget webTarget</code> field. Right now, the
-only option to test the JAX-RS API is to start a web server.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="gradle-different-base-classes"><a class="link" href="#gradle-different-base-classes">4.1.11. Different Base Classes for Contracts</a></h4>
-<div class="paragraph">
-<p>If your base classes differ between contracts, you can tell the Spring Cloud Contract
-plugin which class should get extended by the autogenerated tests. You have two options:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Follow a convention by providing the <code>packageWithBaseClasses</code></p>
-</li>
-<li>
-<p>Provide explicit mapping via <code>baseClassMappings</code></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><strong>By Convention</strong></p>
-</div>
-<div class="paragraph">
-<p>The convention is such that if you have a contract under (for example)
-<code>src/test/resources/contract/foo/bar/baz/</code> and set the value of the
-<code>packageWithBaseClasses</code> property to <code>com.example.base</code>, then Spring Cloud Contract
-Verifier assumes that there is a <code>BarBazBase</code> class under the <code>com.example.base</code> package.
-In other words, the system takes the last two parts of the package, if they exist, and
-forms a class with a <code>Base</code> suffix. This rule takes precedence over <strong>baseClassForTests</strong>.
-Here is an example of how it works in the <code>contracts</code> closure:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">packageWithBaseClasses = 'com.example.base'</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>By Mapping</strong></p>
-</div>
-<div class="paragraph">
-<p>You can manually map a regular expression of the contract&#8217;s package to fully qualified
-name of the base class for the matched contract. You have to provide a list called
-<code>baseClassMappings</code> that consists <code>baseClassMapping</code> objects that takes a
-<code>contractPackageRegex</code> to <code>baseClassFQN</code> mapping. Consider the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">baseClassForTests = "com.example.FooBase"
-baseClassMappings {
-	baseClassMapping('.*/com/.*', 'com.example.ComBase')
-	baseClassMapping('.*/bar/.*': 'com.example.BarBase')
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Let&#8217;s assume that you have contracts under
- - <code>src/test/resources/contract/com/</code>
- - <code>src/test/resources/contract/foo/</code></p>
-</div>
-<div class="paragraph">
-<p>By providing the <code>baseClassForTests</code>, we have a fallback in case mapping did not succeed.
-(You could also provide the <code>packageWithBaseClasses</code> as a fallback.) That way, the tests
-generated from <code>src/test/resources/contract/com/</code> contracts extend the
-<code>com.example.ComBase</code>, whereas the rest of the tests extend <code>com.example.FooBase</code>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="gradle-invoking-generated-tests"><a class="link" href="#gradle-invoking-generated-tests">4.1.12. Invoking Generated Tests</a></h4>
-<div class="paragraph">
-<p>To ensure that the provider side is compliant with defined contracts, you need to invoke:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./gradlew generateContractTests test</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="gradle-pushing-stubs-to-scm"><a class="link" href="#gradle-pushing-stubs-to-scm">4.1.13. Pushing stubs to SCM</a></h4>
-<div class="paragraph">
-<p>If you&#8217;re using the SCM repository to keep the contracts and
-stubs, you might want to automate the step of pushing stubs to
-the repository. To do that, it&#8217;s enough to call the <code>pushStubsToScm</code>
-task. Example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ ./gradlew pushStubsToScm</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Under <a href="#scm-stub-downloader">Using the SCM Stub Downloader</a> you can find all possible
-configuration options that you can pass either via
-the <code>contractsProperties</code> field e.g. <code>contracts { contractsProperties = [foo:"bar"] }</code>,
-via <code>contractsProperties</code> method e.g. <code>contracts { contractsProperties([foo:"bar"]) }</code>,
-a system property or an environment variable.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="gradle-consumer"><a class="link" href="#gradle-consumer">4.1.14. Spring Cloud Contract Verifier on the Consumer Side</a></h4>
-<div class="paragraph">
-<p>In a consuming service, you need to configure the Spring Cloud Contract Verifier plugin
-in exactly the same way as in case of provider. If you do not want to use Stub Runner
-then you need to copy contracts stored in <code>src/test/resources/contracts</code> and generate
-WireMock JSON stubs using:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./gradlew generateClientStubs</code></pre>
-</div>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-The <code>stubsOutputDir</code> option has to be set for stub generation to work.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>When present, JSON stubs can be used in automated tests of consuming a service.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@ContextConfiguration(loader == SpringApplicationContextLoader, classes == Application)
-class LoanApplicationServiceSpec extends Specification {
-
- @ClassRule
- @Shared
- WireMockClassRule wireMockRule == new WireMockClassRule()
-
- @Autowired
- LoanApplicationService sut
-
- def 'should successfully apply for loan'() {
-   given:
- 	LoanApplication application =
-			new LoanApplication(client: new Client(clientPesel: '12345678901'), amount: 123.123)
-   when:
-	LoanApplicationResult loanApplication == sut.loanApplication(application)
-   then:
-	loanApplication.loanApplicationStatus == LoanApplicationStatus.LOAN_APPLIED
-	loanApplication.rejectionReason == null
- }
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><code>LoanApplication</code> makes a call to <code>FraudDetection</code> service. This request is handled by a
-WireMock server configured with stubs generated by Spring Cloud Contract Verifier.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="maven-project"><a class="link" href="#maven-project">4.2. Maven Project</a></h3>
-<div class="paragraph">
-<p>To learn how to set up the Maven project for Spring Cloud Contract Verifier, read the
-following sections:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="#maven-add-plugin">Add maven plugin</a></p>
-</li>
-<li>
-<p><a href="#maven-rest-assured">Maven and Rest Assured 2.0</a></p>
-</li>
-<li>
-<p><a href="#maven-snapshot-versions">Snapshot versions for Maven</a></p>
-</li>
-<li>
-<p><a href="#maven-add-stubs">Add stubs</a></p>
-</li>
-<li>
-<p><a href="#maven-run-plugin">Run plugin</a></p>
-</li>
-<li>
-<p><a href="#maven-configure-plugin">Configure plugin</a></p>
-</li>
-<li>
-<p><a href="#maven-configuration-options">Configuration Options</a></p>
-</li>
-<li>
-<p><a href="#maven-single-base">Single Base Class for All Tests</a></p>
-</li>
-<li>
-<p><a href="#maven-different-base">Different base classes for contracts</a></p>
-</li>
-<li>
-<p><a href="#maven-invoking-generated-tests">Invoking generated tests</a></p>
-</li>
-<li>
-<p><a href="#maven-pushing-stubs-to-scm">Pushing stubs to SCM</a></p>
-</li>
-<li>
-<p><a href="#maven-sts">Maven Plugin and STS</a></p>
-</li>
-</ul>
-</div>
-<div class="sect3">
-<h4 id="maven-add-plugin"><a class="link" href="#maven-add-plugin">4.2.1. Add maven plugin</a></h4>
-<div class="paragraph">
-<p>Add the Spring Cloud Contract BOM in a fashion similar to this:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependencyManagement&gt;
-	&lt;dependencies&gt;
-		&lt;dependency&gt;
-			&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-			&lt;artifactId&gt;spring-cloud-dependencies&lt;/artifactId&gt;
-			&lt;version&gt;${spring-cloud-release.version}&lt;/version&gt;
-			&lt;type&gt;pom&lt;/type&gt;
-			&lt;scope&gt;import&lt;/scope&gt;
-		&lt;/dependency&gt;
-	&lt;/dependencies&gt;
-&lt;/dependencyManagement&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Next, add the <code>Spring Cloud Contract Verifier</code> Maven plugin:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-	&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-	&lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-	&lt;extensions&gt;true&lt;/extensions&gt;
-	&lt;configuration&gt;
-		&lt;packageWithBaseClasses&gt;com.example.fraud&lt;/packageWithBaseClasses&gt;
-		&lt;convertToYaml&gt;true&lt;/convertToYaml&gt;
-	&lt;/configuration&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can read more in the
-<a href="https://cloud.spring.io/spring-cloud-static/spring-cloud-contract/2.0.0.RELEASE/spring-cloud-contract-maven-plugin/">Spring
-Cloud Contract Maven Plugin Documentation (example for <code>2.0.0.RELEASE</code> version)</a>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="maven-rest-assured"><a class="link" href="#maven-rest-assured">4.2.2. Maven and Rest Assured 2.0</a></h4>
-<div class="paragraph">
-<p>By default, Rest Assured 3.x is added to the classpath. However, you can use Rest
-Assured 2.x by adding it to the plugins classpath, as shown here:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">&lt;plugin&gt;
-    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-    &lt;extensions&gt;true&lt;/extensions&gt;
-    &lt;configuration&gt;
-        &lt;packageWithBaseClasses&gt;com.example&lt;/packageWithBaseClasses&gt;
-    &lt;/configuration&gt;
-    &lt;dependencies&gt;
-        &lt;dependency&gt;
-            &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-            &lt;artifactId&gt;spring-cloud-contract-verifier&lt;/artifactId&gt;
-            &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-        &lt;/dependency&gt;
-        &lt;dependency&gt;
-           &lt;groupId&gt;com.jayway.restassured&lt;/groupId&gt;
-           &lt;artifactId&gt;rest-assured&lt;/artifactId&gt;
-           &lt;version&gt;2.5.0&lt;/version&gt;
-           &lt;scope&gt;compile&lt;/scope&gt;
-        &lt;/dependency&gt;
-        &lt;dependency&gt;
-           &lt;groupId&gt;com.jayway.restassured&lt;/groupId&gt;
-           &lt;artifactId&gt;spring-mock-mvc&lt;/artifactId&gt;
-           &lt;version&gt;2.5.0&lt;/version&gt;
-           &lt;scope&gt;compile&lt;/scope&gt;
-        &lt;/dependency&gt;
-    &lt;/dependencies&gt;
-&lt;/plugin&gt;
-
-&lt;dependencies&gt;
-    &lt;!-- all dependencies --&gt;
-    &lt;!-- you can exclude rest-assured from spring-cloud-contract-verifier --&gt;
-    &lt;dependency&gt;
-       &lt;groupId&gt;com.jayway.restassured&lt;/groupId&gt;
-       &lt;artifactId&gt;rest-assured&lt;/artifactId&gt;
-       &lt;version&gt;2.5.0&lt;/version&gt;
-       &lt;scope&gt;test&lt;/scope&gt;
-    &lt;/dependency&gt;
-    &lt;dependency&gt;
-       &lt;groupId&gt;com.jayway.restassured&lt;/groupId&gt;
-       &lt;artifactId&gt;spring-mock-mvc&lt;/artifactId&gt;
-       &lt;version&gt;2.5.0&lt;/version&gt;
-       &lt;scope&gt;test&lt;/scope&gt;
-    &lt;/dependency&gt;
-&lt;/dependencies&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>That way, the plugin automatically sees that Rest Assured 3.x is present on the classpath
-and modifies the imports accordingly.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="maven-snapshot-versions"><a class="link" href="#maven-snapshot-versions">4.2.3. Snapshot versions for Maven</a></h4>
-<div class="paragraph">
-<p>For Snapshot and Milestone versions, you have to add the following section to your
-<code>pom.xml</code>, as shown here:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;repositories&gt;
-	&lt;repository&gt;
-		&lt;id&gt;spring-snapshots&lt;/id&gt;
-		&lt;name&gt;Spring Snapshots&lt;/name&gt;
-		&lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
-		&lt;snapshots&gt;
-			&lt;enabled&gt;true&lt;/enabled&gt;
-		&lt;/snapshots&gt;
-	&lt;/repository&gt;
-	&lt;repository&gt;
-		&lt;id&gt;spring-milestones&lt;/id&gt;
-		&lt;name&gt;Spring Milestones&lt;/name&gt;
-		&lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
-		&lt;snapshots&gt;
-			&lt;enabled&gt;false&lt;/enabled&gt;
-		&lt;/snapshots&gt;
-	&lt;/repository&gt;
-	&lt;repository&gt;
-		&lt;id&gt;spring-releases&lt;/id&gt;
-		&lt;name&gt;Spring Releases&lt;/name&gt;
-		&lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
-		&lt;snapshots&gt;
-			&lt;enabled&gt;false&lt;/enabled&gt;
-		&lt;/snapshots&gt;
-	&lt;/repository&gt;
-&lt;/repositories&gt;
-&lt;pluginRepositories&gt;
-	&lt;pluginRepository&gt;
-		&lt;id&gt;spring-snapshots&lt;/id&gt;
-		&lt;name&gt;Spring Snapshots&lt;/name&gt;
-		&lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
-		&lt;snapshots&gt;
-			&lt;enabled&gt;true&lt;/enabled&gt;
-		&lt;/snapshots&gt;
-	&lt;/pluginRepository&gt;
-	&lt;pluginRepository&gt;
-		&lt;id&gt;spring-milestones&lt;/id&gt;
-		&lt;name&gt;Spring Milestones&lt;/name&gt;
-		&lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
-		&lt;snapshots&gt;
-			&lt;enabled&gt;false&lt;/enabled&gt;
-		&lt;/snapshots&gt;
-	&lt;/pluginRepository&gt;
-	&lt;pluginRepository&gt;
-		&lt;id&gt;spring-releases&lt;/id&gt;
-		&lt;name&gt;Spring Releases&lt;/name&gt;
-		&lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
-		&lt;snapshots&gt;
-			&lt;enabled&gt;false&lt;/enabled&gt;
-		&lt;/snapshots&gt;
-	&lt;/pluginRepository&gt;
-&lt;/pluginRepositories&gt;</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="maven-add-stubs"><a class="link" href="#maven-add-stubs">4.2.4. Add stubs</a></h4>
-<div class="paragraph">
-<p>By default, Spring Cloud Contract Verifier is looking for stubs in the
-<code>src/test/resources/contracts</code> directory. The directory containing stub definitions is
-treated as a class name, and each stub definition is treated as a single test. We assume
-that it contains at least one directory to be used as test class name. If there is more
-than one level of nested directories, all except the last one is used as package name.
-For example, with following structure:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">src/test/resources/contracts/myservice/shouldCreateUser.groovy
-src/test/resources/contracts/myservice/shouldReturnUser.groovy</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Spring Cloud Contract Verifier creates a test class named <code>defaultBasePackage.MyService</code>
-with two methods</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>shouldCreateUser()</code></p>
-</li>
-<li>
-<p><code>shouldReturnUser()</code></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="maven-run-plugin"><a class="link" href="#maven-run-plugin">4.2.5. Run plugin</a></h4>
-<div class="paragraph">
-<p>The plugin goal <code>generateTests</code> is assigned to be invoked in the phase called
-<code>generate-test-sources</code>. If you want it to be part of your build process, you need not do
-anything. If you just want to generate tests, invoke the <code>generateTests</code> goal.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="maven-configure-plugin"><a class="link" href="#maven-configure-plugin">4.2.6. Configure plugin</a></h4>
-<div class="paragraph">
-<p>To change the default configuration, just add a <code>configuration</code> section to the plugin
-definition or the <code>execution</code> definition, as shown here:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-    &lt;executions&gt;
-        &lt;execution&gt;
-            &lt;goals&gt;
-                &lt;goal&gt;convert&lt;/goal&gt;
-                &lt;goal&gt;generateStubs&lt;/goal&gt;
-                &lt;goal&gt;generateTests&lt;/goal&gt;
-            &lt;/goals&gt;
-        &lt;/execution&gt;
-    &lt;/executions&gt;
-    &lt;configuration&gt;
-        &lt;basePackageForTests&gt;org.springframework.cloud.verifier.twitter.place&lt;/basePackageForTests&gt;
-        &lt;baseClassForTests&gt;org.springframework.cloud.verifier.twitter.place.BaseMockMvcSpec&lt;/baseClassForTests&gt;
-    &lt;/configuration&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="maven-configuration-options"><a class="link" href="#maven-configuration-options">4.2.7. Configuration Options</a></h4>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>testMode</strong>: Defines the mode for acceptance tests. By default, the mode is MockMvc,
-which is based on Spring&#8217;s MockMvc. It can also be changed to <strong>WebTestClient</strong>, <strong>JaxRsClient</strong> or to
-<strong>Explicit</strong> for real HTTP calls.</p>
-</li>
-<li>
-<p><strong>basePackageForTests</strong>: Specifies the base package for all generated tests. If not set,
-the value is picked from <code>baseClassForTests&#8217;s package and from `packageWithBaseClasses</code>.
-If neither of these values are set, then the value is set to
-<code>org.springframework.cloud.contract.verifier.tests</code>.</p>
-</li>
-<li>
-<p><strong>ruleClassForTests</strong>: Specifies a rule that should be added to the generated test
-classes.</p>
-</li>
-<li>
-<p><strong>baseClassForTests</strong>: Creates a base class for all generated tests. By default, if you
-use Spock classes, the class is <code>spock.lang.Specification</code>.</p>
-</li>
-<li>
-<p><strong>contractsDirectory</strong>: Specifies a directory containing contracts written with the
-GroovyDSL. The default directory is <code>/src/test/resources/contracts</code>.</p>
-</li>
-<li>
-<p><strong>generatedTestSourcesDir</strong>: Specifies the test source directory where tests generated
-from the Groovy DSL should be placed. By default its value is
-<code>$buildDir/generated-test-sources/contracts</code>.</p>
-</li>
-<li>
-<p><strong>generatedTestResourcesDir</strong>: Specifies the test resource directory where resources used by the tests generated</p>
-</li>
-<li>
-<p><strong>testFramework</strong>: Specifies the target test framework to be used. Currently, Spock, JUnit 4 (<code>TestFramework.JUNIT</code>) and
-JUnit 5 are supported with JUnit 4 being the default framework.</p>
-</li>
-<li>
-<p><strong>packageWithBaseClasses</strong>: Defines a package where all the base classes reside. This
-setting takes precedence over <strong>baseClassForTests</strong>. The convention is such that, if you
-have a contract under (for example) <code>src/test/resources/contract/foo/bar/baz/</code> and set
-the value of the <code>packageWithBaseClasses</code> property to <code>com.example.base</code>, then Spring
-Cloud Contract Verifier assumes that there is a <code>BarBazBase</code> class under the
-<code>com.example.base</code> package. In other words, the system takes the last two parts of the
-package, if they exist, and forms a class with a <code>Base</code> suffix.</p>
-</li>
-<li>
-<p><strong>baseClassMappings</strong>: Specifies a list of base class mappings that provide
-<code>contractPackageRegex</code>, which is checked against the package where the contract is
-located, and <code>baseClassFQN</code>, which maps to the fully qualified name of the base class for
-the matched contract. For example, if you have a contract under
-<code>src/test/resources/contract/foo/bar/baz/</code> and map the property
-<code>.* &#8594; com.example.base.BaseClass</code>, then the test class generated from these contracts
-extends <code>com.example.base.BaseClass</code>. This setting takes precedence over
-<strong>packageWithBaseClasses</strong> and <strong>baseClassForTests</strong>.</p>
-</li>
-<li>
-<p><strong>contractsProperties</strong>: a map containing properties to be passed to Spring Cloud Contract
-components. Those properties might be used by e.g. inbuilt or custom Stub Downloaders.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>If you want to download your contract definitions from a Maven repository, you can use
-the following options:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>contractDependency</strong>: The contract dependency that contains all the packaged contracts.</p>
-</li>
-<li>
-<p><strong>contractsPath</strong>: The path to the concrete contracts in the JAR with packaged contracts.
-Defaults to <code>groupid/artifactid</code> where <code>gropuid</code> is slash separated.</p>
-</li>
-<li>
-<p><strong>contractsMode</strong>: Picks the mode in which stubs will be found and registered</p>
-</li>
-<li>
-<p><strong>deleteStubsAfterTest</strong>: If set to <code>false</code> will not remove any downloaded
-contracts from temporary directories</p>
-</li>
-<li>
-<p><strong>contractsRepositoryUrl</strong>: URL to a repo with the artifacts that have contracts. If it is not provided,
-use the current Maven ones.</p>
-</li>
-<li>
-<p><strong>contractsRepositoryUsername</strong>: The user name to be used to connect to the repo with contracts.</p>
-</li>
-<li>
-<p><strong>contractsRepositoryPassword</strong>: The password to be used to connect to the repo with contracts.</p>
-</li>
-<li>
-<p><strong>contractsRepositoryProxyHost</strong>: The proxy host to be used to connect to the repo with contracts.</p>
-</li>
-<li>
-<p><strong>contractsRepositoryProxyPort</strong>: The proxy port to be used to connect to the repo with contracts.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>We cache only non-snapshot, explicitly provided versions (for example
-<code>+</code> or <code>1.0.0.BUILD-SNAPSHOT</code> won&#8217;t get cached). By default, this feature is turned on.</p>
-</div>
-<div class="paragraph">
-<p>Below you can find a list of experimental features you can turn on via the plugin:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>convertToYaml</strong>: converts all DSLs to the declarative, YAML format. This can be extremely useful when you&#8217;re using external libraries in your Groovy DSLs. By turning this feature on (by setting it to <code>true</code>) you will not need to add the library dependency on the consumer side.</p>
-</li>
-<li>
-<p><strong>assertJsonSize</strong>: You can check the size of JSON arrays in the generated tests. This feature is disabled by default.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="maven-single-base"><a class="link" href="#maven-single-base">4.2.8. Single Base Class for All Tests</a></h4>
-<div class="paragraph">
-<p>When using Spring Cloud Contract Verifier in default MockMvc, you need to create a base
-specification for all generated acceptance tests. In this class, you need to point to an
-endpoint, which should be verified.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package org.mycompany.tests
-
-import org.mycompany.ExampleSpringController
-import com.jayway.restassured.module.mockmvc.RestAssuredMockMvc
-import spock.lang.Specification
-
-class MvcSpec extends Specification {
-  def setup() {
-   RestAssuredMockMvc.standaloneSetup(new ExampleSpringController())
-  }
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can also setup the whole context if necessary.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">import io.restassured.module.mockmvc.RestAssuredMockMvc;
-import org.junit.Before;
-import org.junit.runner.RunWith;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.boot.test.context.SpringBootTest;
-import org.springframework.test.context.junit4.SpringRunner;
-import org.springframework.web.context.WebApplicationContext;
-
-@RunWith(SpringRunner.class)
-@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT, classes = SomeConfig.class, properties="some=property")
-public abstract class BaseTestClass {
-
-	@Autowired
-	WebApplicationContext context;
-
-	@Before
-	public void setup() {
-		RestAssuredMockMvc.webAppContextSetup(this.context);
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you use <code>EXPLICIT</code> mode, you can use a base class to initialize the whole tested app
-similarly, as you might find in regular integration tests.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">import io.restassured.RestAssured;
-import org.junit.Before;
-import org.junit.runner.RunWith;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.boot.test.context.SpringBootTest;
-import org.springframework.boot.web.server.LocalServerPort
-import org.springframework.test.context.junit4.SpringRunner;
-import org.springframework.web.context.WebApplicationContext;
-
-@RunWith(SpringRunner.class)
-@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT, classes = SomeConfig.class, properties="some=property")
-public abstract class BaseTestClass {
-
-	@LocalServerPort
-	int port;
-
-	@Before
-	public void setup() {
-		RestAssured.baseURI = "http://localhost:" + this.port;
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you use the <code>JAXRSCLIENT</code> mode, this base class should also contain a <code>protected WebTarget webTarget</code> field. Right
-now, the only option to test the JAX-RS API is to start a web server.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="maven-different-base"><a class="link" href="#maven-different-base">4.2.9. Different base classes for contracts</a></h4>
-<div class="paragraph">
-<p>If your base classes differ between contracts, you can tell the Spring Cloud Contract
-plugin which class should get extended by the autogenerated tests. You have two options:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Follow a convention by providing the <code>packageWithBaseClasses</code></p>
-</li>
-<li>
-<p>provide explicit mapping via <code>baseClassMappings</code></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><strong>By Convention</strong></p>
-</div>
-<div class="paragraph">
-<p>The convention is such that if you have a contract under (for example)
-<code>src/test/resources/contract/foo/bar/baz/</code> and set the value of the
-<code>packageWithBaseClasses</code> property to <code>com.example.base</code>, then Spring Cloud Contract
-Verifier assumes that there is a <code>BarBazBase</code> class under the <code>com.example.base</code> package.
-In other words, the system takes the last two parts of the package, if they exist, and
-forms a class with a <code>Base</code> suffix. This rule takes precedence over <strong>baseClassForTests</strong>.
-Here is an example of how it works in the <code>contracts</code> closure:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-	&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-	&lt;configuration&gt;
-		&lt;packageWithBaseClasses&gt;hello&lt;/packageWithBaseClasses&gt;
-	&lt;/configuration&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>By Mapping</strong></p>
-</div>
-<div class="paragraph">
-<p>You can manually map a regular expression of the contract&#8217;s package to fully qualified
-name of the base class for the matched contract. You have to provide a list called
-<code>baseClassMappings</code> that consists <code>baseClassMapping</code> objects that takes a
-<code>contractPackageRegex</code> to <code>baseClassFQN</code> mapping. Consider the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-	&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-	&lt;configuration&gt;
-		&lt;baseClassForTests&gt;com.example.FooBase&lt;/baseClassForTests&gt;
-		&lt;baseClassMappings&gt;
-			&lt;baseClassMapping&gt;
-				&lt;contractPackageRegex&gt;.*com.*&lt;/contractPackageRegex&gt;
-				&lt;baseClassFQN&gt;com.example.TestBase&lt;/baseClassFQN&gt;
-			&lt;/baseClassMapping&gt;
-		&lt;/baseClassMappings&gt;
-	&lt;/configuration&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Assume that you have contracts under these two locations:
-* <code>src/test/resources/contract/com/</code>
-* <code>src/test/resources/contract/foo/</code></p>
-</div>
-<div class="paragraph">
-<p>By providing the <code>baseClassForTests</code>, we have a fallback in case mapping did not succeed.
-(You can also provide the <code>packageWithBaseClasses</code> as a fallback.) That way, the tests
-generated from <code>src/test/resources/contract/com/</code> contracts extend the
-<code>com.example.ComBase</code>, whereas the rest of the tests extend <code>com.example.FooBase</code>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="maven-invoking-generated-tests"><a class="link" href="#maven-invoking-generated-tests">4.2.10. Invoking generated tests</a></h4>
-<div class="paragraph">
-<p>The Spring Cloud Contract Maven Plugin generates verification code in a directory called
-<code>/generated-test-sources/contractVerifier</code> and attaches this directory to <code>testCompile</code>
-goal.</p>
-</div>
-<div class="paragraph">
-<p>For Groovy Spock code, use the following:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-	&lt;groupId&gt;org.codehaus.gmavenplus&lt;/groupId&gt;
-	&lt;artifactId&gt;gmavenplus-plugin&lt;/artifactId&gt;
-	&lt;version&gt;1.5&lt;/version&gt;
-	&lt;executions&gt;
-		&lt;execution&gt;
-			&lt;goals&gt;
-				&lt;goal&gt;testCompile&lt;/goal&gt;
-			&lt;/goals&gt;
-		&lt;/execution&gt;
-	&lt;/executions&gt;
-	&lt;configuration&gt;
-		&lt;testSources&gt;
-			&lt;testSource&gt;
-				&lt;directory&gt;${project.basedir}/src/test/groovy&lt;/directory&gt;
-				&lt;includes&gt;
-					&lt;include&gt;**/*.groovy&lt;/include&gt;
-				&lt;/includes&gt;
-			&lt;/testSource&gt;
-			&lt;testSource&gt;
-				&lt;directory&gt;${project.build.directory}/generated-test-sources/contractVerifier&lt;/directory&gt;
-				&lt;includes&gt;
-					&lt;include&gt;**/*.groovy&lt;/include&gt;
-				&lt;/includes&gt;
-			&lt;/testSource&gt;
-		&lt;/testSources&gt;
-	&lt;/configuration&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>To ensure that provider side is compliant with defined contracts, you need to invoke
-<code>mvn generateTest test</code>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="maven-pushing-stubs-to-scm"><a class="link" href="#maven-pushing-stubs-to-scm">4.2.11. Pushing stubs to SCM</a></h4>
-<div class="paragraph">
-<p>If you&#8217;re using the SCM repository to keep the contracts and
-stubs, you might want to automate the step of pushing stubs to
-the repository. To do that, it&#8217;s enough to add the <code>pushStubsToScm</code>
-goal. Example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-    &lt;extensions&gt;true&lt;/extensions&gt;
-    &lt;configuration&gt;
-        &lt;!-- Base class mappings etc. --&gt;
-
-        &lt;!-- We want to pick contracts from a Git repository --&gt;
-        &lt;contractsRepositoryUrl&gt;git://https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git&lt;/contractsRepositoryUrl&gt;
-
-        &lt;!-- We reuse the contract dependency section to set up the path
-        to the folder that contains the contract definitions. In our case the
-        path will be /groupId/artifactId/version/contracts --&gt;
-        &lt;contractDependency&gt;
-            &lt;groupId&gt;${project.groupId}&lt;/groupId&gt;
-            &lt;artifactId&gt;${project.artifactId}&lt;/artifactId&gt;
-            &lt;version&gt;${project.version}&lt;/version&gt;
-        &lt;/contractDependency&gt;
-
-        &lt;!-- The contracts mode can't be classpath --&gt;
-        &lt;contractsMode&gt;REMOTE&lt;/contractsMode&gt;
-    &lt;/configuration&gt;
-    &lt;executions&gt;
-        &lt;execution&gt;
-            &lt;phase&gt;package&lt;/phase&gt;
-            &lt;goals&gt;
-                &lt;!-- By default we will not push the stubs back to SCM,
-                you have to explicitly add it as a goal --&gt;
-                &lt;goal&gt;pushStubsToScm&lt;/goal&gt;
-            &lt;/goals&gt;
-        &lt;/execution&gt;
-    &lt;/executions&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Under <a href="#scm-stub-downloader">Using the SCM Stub Downloader</a> you can find all possible
-configuration options that you can pass either via
-the <code>&lt;configuration&gt;&lt;contractProperties&gt;</code> map, a system property
-or an environment variable.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="maven-sts"><a class="link" href="#maven-sts">4.2.12. Maven Plugin and STS</a></h4>
-<div class="paragraph">
-<p>If you see the following exception while using STS:</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="https://raw.githubusercontent.com/spring-cloud/spring-cloud-contract/master/docs/src/main/asciidoc/images/sts_exception.png" alt="STS Exception">
-</div>
-</div>
-<div class="paragraph">
-<p>When you click on the error marker you should see something like this:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"> plugin:1.1.0.M1:convert:default-convert:process-test-resources) org.apache.maven.plugin.PluginExecutionException: Execution default-convert of goal org.springframework.cloud:spring-
- cloud-contract-maven-plugin:1.1.0.M1:convert failed. at org.apache.maven.plugin.DefaultBuildPluginManager.executeMojo(DefaultBuildPluginManager.java:145) at
- org.eclipse.m2e.core.internal.embedder.MavenImpl.execute(MavenImpl.java:331) at org.eclipse.m2e.core.internal.embedder.MavenImpl$11.call(MavenImpl.java:1362) at
-...
- org.eclipse.core.internal.jobs.Worker.run(Worker.java:55) Caused by: java.lang.NullPointerException at
- org.eclipse.m2e.core.internal.builder.plexusbuildapi.EclipseIncrementalBuildContext.hasDelta(EclipseIncrementalBuildContext.java:53) at
- org.sonatype.plexus.build.incremental.ThreadBuildContext.hasDelta(ThreadBuildContext.java:59) at</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In order to fix this issue, provide the following section in your <code>pom.xml</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;build&gt;
-    &lt;pluginManagement&gt;
-        &lt;plugins&gt;
-            &lt;!--This plugin's configuration is used to store Eclipse m2e settings
-                only. It has no influence on the Maven build itself. --&gt;
-            &lt;plugin&gt;
-                &lt;groupId&gt;org.eclipse.m2e&lt;/groupId&gt;
-                &lt;artifactId&gt;lifecycle-mapping&lt;/artifactId&gt;
-                &lt;version&gt;1.0.0&lt;/version&gt;
-                &lt;configuration&gt;
-                    &lt;lifecycleMappingMetadata&gt;
-                        &lt;pluginExecutions&gt;
-                             &lt;pluginExecution&gt;
-                                &lt;pluginExecutionFilter&gt;
-                                    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-                                    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-                                    &lt;versionRange&gt;[1.0,)&lt;/versionRange&gt;
-                                    &lt;goals&gt;
-                                        &lt;goal&gt;convert&lt;/goal&gt;
-                                    &lt;/goals&gt;
-                                &lt;/pluginExecutionFilter&gt;
-                                &lt;action&gt;
-                                    &lt;execute /&gt;
-                                &lt;/action&gt;
-                             &lt;/pluginExecution&gt;
-                        &lt;/pluginExecutions&gt;
-                    &lt;/lifecycleMappingMetadata&gt;
-                &lt;/configuration&gt;
-            &lt;/plugin&gt;
-        &lt;/plugins&gt;
-    &lt;/pluginManagement&gt;
-&lt;/build&gt;</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_maven_plugin_with_spock_tests"><a class="link" href="#_maven_plugin_with_spock_tests">4.2.13. Maven Plugin with Spock Tests</a></h4>
-<div class="paragraph">
-<p>You can select the <a href="http://spockframework.org/">Spock Framework</a> for creating and executing the auto-generated contract
-verification tests with both Maven and Gradle plugin. However, whereas with Gradle its really straightforward,
-in Maven you will require some additional setup in order to make the tests compile and execute properly.</p>
-</div>
-<div class="paragraph">
-<p>First of all, you will have to use a plugin, such as <a href="https://github.com/groovy/GMavenPlus">GMavenPlus</a> plugin,
-to add Groovy to your project. In GMavenPlus plugin, you will need to explicitly set test sources, including both the
-path where your base test classes are defined and the path were the generated contract tests are added.
-Please refer to the example below:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"></code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you uphold to the Spock convention of ending the test class names with <code>Spec</code>, you will also need to adjust your Maven
-Surefire plugin setup, like in the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"></code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_stubs_and_transitive_dependencies"><a class="link" href="#_stubs_and_transitive_dependencies">4.3. Stubs and Transitive Dependencies</a></h3>
-<div class="paragraph">
-<p>The Maven and Gradle plugin that add the tasks that create the stubs jar for you. One
-problem that arises is that, when reusing the stubs, you can mistakenly import all of
-that stub&#8217;s dependencies. When building a Maven artifact, even though you have a couple
-of different jars, all of them share one pom:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">├── github-webhook-0.0.1.BUILD-20160903.075506-1-stubs.jar
-├── github-webhook-0.0.1.BUILD-20160903.075506-1-stubs.jar.sha1
-├── github-webhook-0.0.1.BUILD-20160903.075655-2-stubs.jar
-├── github-webhook-0.0.1.BUILD-20160903.075655-2-stubs.jar.sha1
-├── github-webhook-0.0.1.BUILD-SNAPSHOT.jar
-├── github-webhook-0.0.1.BUILD-SNAPSHOT.pom
-├── github-webhook-0.0.1.BUILD-SNAPSHOT-stubs.jar
-├── ...
-└── ...</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>There are three possibilities of working with those dependencies so as not to have any
-issues with transitive dependencies:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Mark all application dependencies as optional</p>
-</li>
-<li>
-<p>Create a separate artifactid for the stubs</p>
-</li>
-<li>
-<p>Exclude dependencies on the consumer side</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><strong>Mark all application dependencies as optional</strong></p>
-</div>
-<div class="paragraph">
-<p>If, in the <code>github-webhook</code> application, you mark all of your dependencies as optional,
-when you include the <code>github-webhook</code> stubs in another application (or when that
-dependency gets downloaded by Stub Runner) then, since all of the dependencies are
-optional, they will not get downloaded.</p>
-</div>
-<div class="paragraph">
-<p><strong>Create a separate <code>artifactid</code> for the stubs</strong></p>
-</div>
-<div class="paragraph">
-<p>If you create a separate <code>artifactid</code>, then you can set it up in whatever way you wish.
-For example, you might decide to have no dependencies at all.</p>
-</div>
-<div class="paragraph">
-<p><strong>Exclude dependencies on the consumer side</strong></p>
-</div>
-<div class="paragraph">
-<p>As a consumer, if you add the stub dependency to your classpath, you can explicitly
-exclude the unwanted dependencies.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_scenarios"><a class="link" href="#_scenarios">4.4. Scenarios</a></h3>
-<div class="paragraph">
-<p>You can handle scenarios with Spring Cloud Contract Verifier. All you need to do is to
-stick to the proper naming convention while creating your contracts. The convention
-requires including an order number followed by an underscore. This will work regardles
- of whether you&#8217;re working with YAML or Groovy. Example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code>my_contracts_dir\
-  scenario1\
-    1_login.groovy
-    2_showCart.groovy
-    3_logout.groovy</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Such a tree causes Spring Cloud Contract Verifier to generate WireMock&#8217;s scenario with a
-name of <code>scenario1</code> and the three following steps:</p>
-</div>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>login marked as <code>Started</code> pointing to&#8230;&#8203;</p>
-</li>
-<li>
-<p>showCart marked as <code>Step1</code> pointing to&#8230;&#8203;</p>
-</li>
-<li>
-<p>logout marked as <code>Step2</code> which will close the scenario.</p>
-</li>
-</ol>
-</div>
-<div class="paragraph">
-<p>More details about WireMock scenarios can be found at
-<a href="https://wiremock.org/docs/stateful-behaviour/">https://wiremock.org/docs/stateful-behaviour/</a></p>
-</div>
-<div class="paragraph">
-<p>Spring Cloud Contract Verifier also generates tests with a guaranteed order of execution.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="docker-project"><a class="link" href="#docker-project">4.5. Docker Project</a></h3>
-<div class="paragraph">
-<p>We&#8217;re publishing a <code>springcloud/spring-cloud-contract</code> Docker image
-that contains a project that will generate tests and execute them in <code>EXPLICIT</code> mode
-against a running application.</p>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-The <code>EXPLICIT</code> mode means that the tests generated from contracts will send
-real requests and not the mocked ones.
-</td>
-</tr>
-</table>
-</div>
-<div class="sect3">
-<h4 id="_short_intro_to_maven_jars_and_binary_storage"><a class="link" href="#_short_intro_to_maven_jars_and_binary_storage">4.5.1. Short intro to Maven, JARs and Binary storage</a></h4>
-<div class="paragraph">
-<p>Since the Docker image can be used by non JVM projects, it&#8217;s good to
-explain the basic terms behind Spring Cloud Contract packaging defaults.</p>
-</div>
-<div class="paragraph">
-<p>Part of the following definitions were taken from the <a href="https://maven.apache.org/glossary.html">Maven Glossary</a></p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>Project</code>: Maven thinks in terms of projects. Everything that you
-will build are projects. Those projects follow a well defined
-“Project Object Model”. Projects can depend on other projects,
-in which case the latter are called “dependencies”. A project may
-consistent of several subprojects, however these subprojects are still
-treated equally as projects.</p>
-</li>
-<li>
-<p><code>Artifact</code>: An artifact is something that is either produced or used
-by a project. Examples of artifacts produced by Maven for a project
-include: JARs, source and binary distributions. Each artifact
-is uniquely identified by a group id and an artifact ID which is
-unique within a group.</p>
-</li>
-<li>
-<p><code>JAR</code>: JAR stands for Java ARchive. It&#8217;s a format based on
-the ZIP file format. Spring Cloud Contract packages the contracts and generated
-stubs in a JAR file.</p>
-</li>
-<li>
-<p><code>GroupId</code>: A group ID is a universally unique identifier for a project.
-While this is often just the project name (eg. commons-collections),
-it is helpful to use a fully-qualified package name to distinguish it
-from other projects with a similar name (eg. org.apache.maven).
-Typically, when published to the Artifact Manager, the <code>GroupId</code> will get
-slash separated and form part of the URL. E.g. for group id <code>com.example</code>
-and artifact id <code>application</code> would be <code>/com/example/application/</code>.</p>
-</li>
-<li>
-<p><code>Classifier</code>: The Maven dependency notation looks as follows:
-<code>groupId:artifactId:version:classifier</code>. The classifier is additional suffix
-passed to the dependency. E.g. <code>stubs</code>, <code>sources</code>. The same dependency
-e.g. <code>com.example:application</code> can produce multiple artifacts that
-differ from each other with the classifier.</p>
-</li>
-<li>
-<p><code>Artifact manager</code>: When you generate binaries / sources / packages, you would
-like them to be available for others to download / reference or reuse. In case
-of the JVM world those artifacts would be JARs, for Ruby these are gems
-and for Docker those would be Docker images. You can store those artifacts
-in a manager. Examples of such managers can be <a href="https://jfrog.com/artifactory/">Artifactory</a>
-or <a href="https://www.sonatype.org/nexus/">Nexus</a>.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_how_it_works_2"><a class="link" href="#_how_it_works_2">4.5.2. How it works</a></h4>
-<div class="paragraph">
-<p>The image searches for contracts under the <code>/contracts</code> folder.
-The output from running the tests will be available under
-<code>/spring-cloud-contract/build</code> folder (it&#8217;s useful for debugging
-purposes).</p>
-</div>
-<div class="paragraph">
-<p>It&#8217;s enough for you to mount your contracts, pass the environment variables
- and the image will:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>generate the contract tests</p>
-</li>
-<li>
-<p>execute the tests against the provided URL</p>
-</li>
-<li>
-<p>generate the <a href="https://github.com/tomakehurst/wiremock">WireMock</a> stubs</p>
-</li>
-<li>
-<p>(optional - turned on by default) publish the stubs to a Artifact Manager</p>
-</li>
-</ul>
-</div>
-<div class="sect4">
-<h5 id="_environment_variables"><a class="link" href="#_environment_variables">Environment Variables</a></h5>
-<div class="paragraph">
-<p>The Docker image requires some environment variables to point to
-your running application, to the Artifact manager instance etc.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>PROJECT_GROUP</code> - your project&#8217;s group id. Defaults to <code>com.example</code></p>
-</li>
-<li>
-<p><code>PROJECT_VERSION</code> - your project&#8217;s version. Defaults to <code>0.0.1-SNAPSHOT</code></p>
-</li>
-<li>
-<p><code>PROJECT_NAME</code> - artifact id. Defaults to <code>example</code></p>
-</li>
-<li>
-<p><code>PRODUCER_STUBS_CLASSIFIER</code> - archive classifier used for generated producer stubs, defaults to <code>stubs</code>.</p>
-</li>
-<li>
-<p><code>REPO_WITH_BINARIES_URL</code> - URL of your Artifact Manager. Defaults to <code><a href="http://localhost:8081/artifactory/libs-release-local" class="bare">http://localhost:8081/artifactory/libs-release-local</a></code>
-which is the default URL of <a href="https://jfrog.com/artifactory/">Artifactory</a> running locally</p>
-</li>
-<li>
-<p><code>REPO_WITH_BINARIES_USERNAME</code> - (optional) username when the Artifact Manager is secured, defaults to <code>admin</code>.</p>
-</li>
-<li>
-<p><code>REPO_WITH_BINARIES_PASSWORD</code> - (optional) password when the Artifact Manager is secured, defaults to <code>password</code>.</p>
-</li>
-<li>
-<p><code>PUBLISH_ARTIFACTS</code> - if set to <code>true</code> then will publish artifact to binary storage. Defaults to <code>true</code>.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>These environment variables are used when contracts lay in an external repository. To enable
-this feature you must set the <code>EXTERNAL_CONTRACTS_ARTIFACT_ID</code> environment variable.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>EXTERNAL_CONTRACTS_GROUP_ID</code> - group id of the project with contracts. Defaults to <code>com.example</code></p>
-</li>
-<li>
-<p><code>EXTERNAL_CONTRACTS_ARTIFACT_ID</code>- artifact id of the project with contracts.</p>
-</li>
-<li>
-<p><code>EXTERNAL_CONTRACTS_CLASSIFIER</code>- classifier of the project with contracts. Empty by default</p>
-</li>
-<li>
-<p><code>EXTERNAL_CONTRACTS_VERSION</code> - version of the project with contracts. Defaults to <code>+</code>, equivalent to picking the latest</p>
-</li>
-<li>
-<p><code>EXTERNAL_CONTRACTS_REPO_WITH_BINARIES_URL</code> - URL of your Artifact Manager. Defaults to value of <code>REPO_WITH_BINARIES_URL</code> env var.
-If that&#8217;s not set, defaults to <code><a href="http://localhost:8081/artifactory/libs-release-local" class="bare">http://localhost:8081/artifactory/libs-release-local</a></code>
-which is the default URL of <a href="https://jfrog.com/artifactory/">Artifactory</a> running locally</p>
-</li>
-<li>
-<p><code>EXTERNAL_CONTRACTS_REPO_WITH_BINARIES_USERNAME</code> - (optional) username if the <code>EXTERNAL_CONTRACTS_REPO_WITH_BINARIES_URL</code>
-requires authentication, defaults to <code>REPO_WITH_BINARIES_USERNAME</code>. If that&#8217;s not set defaults to <code>admin</code>.</p>
-</li>
-<li>
-<p><code>EXTERNAL_CONTRACTS_REPO_WITH_BINARIES_PASSWORD</code> - (optional) password if the <code>EXTERNAL_CONTRACTS_REPO_WITH_BINARIES_URL</code>
-requires authentication, defaults to <code>REPO_WITH_BINARIES_PASSWORD</code>. If that&#8217;s not set defaults to <code>password</code>.</p>
-</li>
-<li>
-<p><code>EXTERNAL_CONTRACTS_PATH</code> - path to contracts for the given project, inside the project with contracts.
-Defaults to slash separated <code>EXTERNAL_CONTRACTS_GROUP_ID</code> concatenated with <code>/</code> and <code>EXTERNAL_CONTRACTS_ARTIFACT_ID</code>. E.g.
-for group id <code>foo.bar</code> and artifact id <code>baz</code>, would result in <code>foo/bar/baz</code> contracts path.</p>
-</li>
-<li>
-<p><code>EXTERNAL_CONTRACTS_WORK_OFFLINE</code> - if set to <code>true</code> then will retrieve artifact with contracts
-from the container&#8217;s <code>.m2</code>. Mount your local <code>.m2</code> as a volume available at the container&#8217;s <code>/root/.m2</code> path.
-You must not set both <code>EXTERNAL_CONTRACTS_WORK_OFFLINE</code> and <code>EXTERNAL_CONTRACTS_REPO_WITH_BINARIES_URL</code>.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>These environment variables are used when tests are executed:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>APPLICATION_BASE_URL</code> - url against which tests should be executed.
-Remember that it has to be accessible from the Docker container (e.g. <code>localhost</code>
-will not work)</p>
-</li>
-<li>
-<p><code>APPLICATION_USERNAME</code> - (optional) username for basic authentication to your application</p>
-</li>
-<li>
-<p><code>APPLICATION_PASSWORD</code> - (optional) password for basic authentication to your application</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_example_of_usage"><a class="link" href="#_example_of_usage">4.5.3. Example of usage</a></h4>
-<div class="paragraph">
-<p>Let&#8217;s take a look at a simple MVC application</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ git clone https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs
-$ cd bookstore</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The contracts are available under <code>/contracts</code> folder.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="docker-server-side"><a class="link" href="#docker-server-side">4.5.4. Server side (nodejs)</a></h4>
-<div class="paragraph">
-<p>Since we want to run tests, we could just execute:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ npm test</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>however, for learning purposes, let&#8217;s split it into pieces:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Stop docker infra (nodejs, artifactory)
-$ ./stop_infra.sh
-# Start docker infra (nodejs, artifactory)
-$ ./setup_infra.sh
-
-# Kill &amp; Run app
-$ pkill -f "node app"
-$ nohup node app &amp;
-
-# Prepare environment variables
-$ SC_CONTRACT_DOCKER_VERSION="..."
-$ APP_IP="192.168.0.100"
-$ APP_PORT="3000"
-$ ARTIFACTORY_PORT="8081"
-$ APPLICATION_BASE_URL="http://${APP_IP}:${APP_PORT}"
-$ ARTIFACTORY_URL="http://${APP_IP}:${ARTIFACTORY_PORT}/artifactory/libs-release-local"
-$ CURRENT_DIR="$( pwd )"
-$ CURRENT_FOLDER_NAME=${PWD##*/}
-$ PROJECT_VERSION="0.0.1.RELEASE"
-
-# Execute contract tests
-$ docker run  --rm -e "APPLICATION_BASE_URL=${APPLICATION_BASE_URL}" -e "PUBLISH_ARTIFACTS=true" -e "PROJECT_NAME=${CURRENT_FOLDER_NAME}" -e "REPO_WITH_BINARIES_URL=${ARTIFACTORY_URL}" -e "PROJECT_VERSION=${PROJECT_VERSION}" -v "${CURRENT_DIR}/contracts/:/contracts:ro" -v "${CURRENT_DIR}/node_modules/spring-cloud-contract/output:/spring-cloud-contract-output/" springcloud/spring-cloud-contract:"${SC_CONTRACT_DOCKER_VERSION}"
-
-# Kill app
-$ pkill -f "node app"</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>What will happen is that via bash scripts:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>infrastructure will be set up (MongoDb, Artifactory).
-In real life scenario you would just run the NodeJS application
-with mocked database. In this example we want to show how we can
-benefit from Spring Cloud Contract in no time.</p>
-</li>
-<li>
-<p>due to those constraints the contracts also represent the
-stateful situation</p>
-<div class="ulist">
-<ul>
-<li>
-<p>first request is a <code>POST</code> that causes data to get inserted to the database</p>
-</li>
-<li>
-<p>second request is a <code>GET</code> that returns a list of data with 1 previously inserted element</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>the NodeJS application will be started (on port <code>3000</code>)</p>
-</li>
-<li>
-<p>contract tests will be generated via Docker and tests
-will be executed against the running application</p>
-<div class="ulist">
-<ul>
-<li>
-<p>the contracts will be taken from <code>/contracts</code> folder.</p>
-</li>
-<li>
-<p>the output of the test execution is available under
-<code>node_modules/spring-cloud-contract/output</code>.</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>the stubs will be uploaded to Artifactory. You can check them out
-under <a href="http://localhost:8081/artifactory/libs-release-local/com/example/bookstore/0.0.1.RELEASE/" class="bare">http://localhost:8081/artifactory/libs-release-local/com/example/bookstore/0.0.1.RELEASE/</a> .
-The stubs will be here <a href="http://localhost:8081/artifactory/libs-release-local/com/example/bookstore/0.0.1.RELEASE/bookstore-0.0.1.RELEASE-stubs.jar" class="bare">http://localhost:8081/artifactory/libs-release-local/com/example/bookstore/0.0.1.RELEASE/bookstore-0.0.1.RELEASE-stubs.jar</a>.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>To see how the client side looks like check out the <a href="#stubrunner-docker">Stub Runner Docker</a> section.</p>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_spring_cloud_contract_verifier_messaging"><a class="link" href="#_spring_cloud_contract_verifier_messaging">5. Spring Cloud Contract Verifier Messaging</a></h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Spring Cloud Contract Verifier lets you verify applications that use messaging as a
-means of communication. All of the integrations shown in this document work with Spring,
-but you can also create one of your own and use that.</p>
-</div>
-<div class="sect2">
-<h3 id="_integrations"><a class="link" href="#_integrations">5.1. Integrations</a></h3>
-<div class="paragraph">
-<p>You can use one of the following four integration configurations:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Apache Camel</p>
-</li>
-<li>
-<p>Spring Integration</p>
-</li>
-<li>
-<p>Spring Cloud Stream</p>
-</li>
-<li>
-<p>Spring AMQP</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Since we use Spring Boot, if you have added one of these libraries to the classpath, all
-the messaging configuration is automatically set up.</p>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-Remember to put <code>@AutoConfigureMessageVerifier</code> on the base class of your
-generated tests. Otherwise, messaging part of Spring Cloud Contract Verifier does not
-work.
-</td>
-</tr>
-</table>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-If you want to use Spring Cloud Stream, remember to add a dependency on
-<code>org.springframework.cloud:spring-cloud-stream-test-support</code>, as shown here:
-</td>
-</tr>
-</table>
-</div>
-<div class="listingblock primary">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
-    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-    &lt;artifactId&gt;spring-cloud-stream-test-support&lt;/artifactId&gt;
-    &lt;scope&gt;test&lt;/scope&gt;
-&lt;/dependency&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock secondary">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile "org.springframework.cloud:spring-cloud-stream-test-support"</code></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_manual_integration_testing"><a class="link" href="#_manual_integration_testing">5.2. Manual Integration Testing</a></h3>
-<div class="paragraph">
-<p>The main interface used by the tests is
-<code>org.springframework.cloud.contract.verifier.messaging.MessageVerifier</code>.
-It defines how to send and receive messages. You can create your own implementation to
-achieve the same goal.</p>
-</div>
-<div class="paragraph">
-<p>In a test, you can inject a <code>ContractVerifierMessageExchange</code> to send and receive
-messages that follow the contract. Then add <code>@AutoConfigureMessageVerifier</code> to your test.
-Here&#8217;s an example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringTestRunner.class)
-@SpringBootTest
-@AutoConfigureMessageVerifier
-public static class MessagingContractTests {
-
-  @Autowired
-  private MessageVerifier verifier;
-  ...
-}</code></pre>
-</div>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-If your tests require stubs as well, then <code>@AutoConfigureStubRunner</code> includes the
-messaging configuration, so you only need the one annotation.
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_publisher_side_test_generation"><a class="link" href="#_publisher_side_test_generation">5.3. Publisher-Side Test Generation</a></h3>
-<div class="paragraph">
-<p>Having the <code>input</code> or <code>outputMessage</code> sections in your DSL results in creation of tests
-on the publisher&#8217;s side. By default, JUnit 4 tests are created. However, there is also a
-possibility to create JUnit 5, TestNG or Spock tests.</p>
-</div>
-<div class="paragraph">
-<p>There are 3 main scenarios that we should take into consideration:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Scenario 1: There is no input message that produces an output message. The output
-message  is triggered by a component inside the application (for example, scheduler).</p>
-</li>
-<li>
-<p>Scenario 2: The input message triggers an output message.</p>
-</li>
-<li>
-<p>Scenario 3: The input message is consumed and there is no output message.</p>
-</li>
-</ul>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-The destination passed to <code>messageFrom</code> or <code>sentTo</code> can have different
-meanings for different messaging implementations. For <strong>Stream</strong> and <strong>Integration</strong> it is
-first resolved as a <code>destination</code> of a channel. Then, if there is no such <code>destination</code>
-it is resolved as a channel name. For <strong>Camel</strong>, that&#8217;s a certain component (for example,
-<code>jms</code>).
-</td>
-</tr>
-</table>
-</div>
-<div class="sect3">
-<h4 id="_scenario_1_no_input_message"><a class="link" href="#_scenario_1_no_input_message">5.3.1. Scenario 1: No Input Message</a></h4>
-<div class="paragraph">
-<p>For the given contract:</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">			def contractDsl = Contract.make {
-				name "foo"
-				label 'some_label'
-				input {
-					triggeredBy('bookReturnedTriggered()')
-				}
-				outputMessage {
-					sentTo('activemq:output')
-					body('''{ "bookName" : "foo" }''')
-					headers {
-						header('BOOK-NAME', 'foo')
-						messagingContentType(applicationJson())
-					}
-				}
-			}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">label: some_label
-input:
-  triggeredBy: bookReturnedTriggered
-outputMessage:
-  sentTo: activemq:output
-  body:
-    bookName: foo
-  headers:
-    BOOK-NAME: foo
-    contentType: application/json</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following JUnit test is created:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">					'''\
-package com.example;
-
-import com.jayway.jsonpath.DocumentContext;
-import com.jayway.jsonpath.JsonPath;
-import org.junit.Test;
-import org.junit.Rule;
-import javax.inject.Inject;
-import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierObjectMapper;
-import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessage;
-import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessaging;
-
-import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat;
-import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*;
-import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson;
-import static org.springframework.cloud.contract.verifier.messaging.util.ContractVerifierMessagingUtil.headers;
-import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.fileToBytes;
-
-@SuppressWarnings("rawtypes")
-public class FooTest {
-\t@Inject ContractVerifierMessaging contractVerifierMessaging;
-\t@Inject ContractVerifierObjectMapper contractVerifierObjectMapper;
-
-\t@Test
-\tpublic void validate_foo() throws Exception {
-\t\t// when:
-\t\t\tbookReturnedTriggered();
-
-\t\t// then:
-\t\t\tContractVerifierMessage response = contractVerifierMessaging.receive("activemq:output");
-\t\t\tassertThat(response).isNotNull();
-
-\t\t// and:
-\t\t\tassertThat(response.getHeader("BOOK-NAME")).isNotNull();
-\t\t\tassertThat(response.getHeader("BOOK-NAME").toString()).isEqualTo("foo");
-\t\t\tassertThat(response.getHeader("contentType")).isNotNull();
-\t\t\tassertThat(response.getHeader("contentType").toString()).isEqualTo("application/json");
-
-\t\t// and:
-\t\t\tDocumentContext parsedJson = JsonPath.parse(contractVerifierObjectMapper.writeValueAsString(response.getPayload()));
-\t\t\tassertThatJson(parsedJson).field("['bookName']").isEqualTo("foo");
-\t}
-
-}
-
-'''</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And the following Spock test would be created:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">					'''\
-package com.example
-
-import com.jayway.jsonpath.DocumentContext
-import com.jayway.jsonpath.JsonPath
-import spock.lang.Specification
-import javax.inject.Inject
-import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierObjectMapper
-import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessage
-import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessaging
-
-import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat
-import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*
-import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson
-import static org.springframework.cloud.contract.verifier.messaging.util.ContractVerifierMessagingUtil.headers
-import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.fileToBytes
-
-@SuppressWarnings("rawtypes")
-class FooSpec extends Specification {
-\t@Inject ContractVerifierMessaging contractVerifierMessaging
-\t@Inject ContractVerifierObjectMapper contractVerifierObjectMapper
-
-\tdef validate_foo() throws Exception {
-\t\twhen:
-\t\t\tbookReturnedTriggered()
-
-\t\tthen:
-\t\t\tContractVerifierMessage response = contractVerifierMessaging.receive("activemq:output")
-\t\t\tresponse != null
-
-\t\tand:
-\t\t\tresponse.getHeader("BOOK-NAME") != null
-\t\t\tresponse.getHeader("BOOK-NAME").toString() == 'foo'
-\t\t\tresponse.getHeader("contentType") != null
-\t\t\tresponse.getHeader("contentType").toString() == 'application/json'
-
-\t\tand:
-\t\t\tDocumentContext parsedJson = JsonPath.parse(contractVerifierObjectMapper.writeValueAsString(response.getPayload()))
-\t\t\tassertThatJson(parsedJson).field("['bookName']").isEqualTo("foo")
-\t}
-
-}
-
-'''</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_scenario_2_output_triggered_by_input"><a class="link" href="#_scenario_2_output_triggered_by_input">5.3.2. Scenario 2: Output Triggered by Input</a></h4>
-<div class="paragraph">
-<p>For the given contract:</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">			def contractDsl = Contract.make {
-				name "foo"
-				label 'some_label'
-				input {
-					messageFrom('jms:input')
-					messageBody([
-							bookName: 'foo'
-					])
-					messageHeaders {
-						header('sample', 'header')
-					}
-				}
-				outputMessage {
-					sentTo('jms:output')
-					body([
-							bookName: 'foo'
-					])
-					headers {
-						header('BOOK-NAME', 'foo')
-					}
-				}
-			}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">label: some_label
-input:
-  messageFrom: jms:input
-  messageBody:
-    bookName: 'foo'
-  messageHeaders:
-    sample: header
-outputMessage:
-  sentTo: jms:output
-  body:
-    bookName: foo
-  headers:
-    BOOK-NAME: foo</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following JUnit test is created:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">					'''\
-package com.example;
-
-import com.jayway.jsonpath.DocumentContext;
-import com.jayway.jsonpath.JsonPath;
-import org.junit.Test;
-import org.junit.Rule;
-import javax.inject.Inject;
-import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierObjectMapper;
-import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessage;
-import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessaging;
-
-import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat;
-import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*;
-import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson;
-import static org.springframework.cloud.contract.verifier.messaging.util.ContractVerifierMessagingUtil.headers;
-import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.fileToBytes;
-
-@SuppressWarnings("rawtypes")
-public class FooTest {
-\t@Inject ContractVerifierMessaging contractVerifierMessaging;
-\t@Inject ContractVerifierObjectMapper contractVerifierObjectMapper;
-
-\t@Test
-\tpublic void validate_foo() throws Exception {
-\t\t// given:
-\t\t\tContractVerifierMessage inputMessage = contractVerifierMessaging.create(
-\t\t\t\t\t"{\\"bookName\\":\\"foo\\"}"
-\t\t\t\t\t\t, headers()
-\t\t\t\t\t\t\t.header("sample", "header")
-\t\t\t);
-
-\t\t// when:
-\t\t\tcontractVerifierMessaging.send(inputMessage, "jms:input");
-
-\t\t// then:
-\t\t\tContractVerifierMessage response = contractVerifierMessaging.receive("jms:output");
-\t\t\tassertThat(response).isNotNull();
-
-\t\t// and:
-\t\t\tassertThat(response.getHeader("BOOK-NAME")).isNotNull();
-\t\t\tassertThat(response.getHeader("BOOK-NAME").toString()).isEqualTo("foo");
-
-\t\t// and:
-\t\t\tDocumentContext parsedJson = JsonPath.parse(contractVerifierObjectMapper.writeValueAsString(response.getPayload()));
-\t\t\tassertThatJson(parsedJson).field("['bookName']").isEqualTo("foo");
-\t}
-
-}
-
-'''</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And the following Spock test would be created:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">					"""\
-package com.example
-
-import com.jayway.jsonpath.DocumentContext
-import com.jayway.jsonpath.JsonPath
-import spock.lang.Specification
-import javax.inject.Inject
-import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierObjectMapper
-import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessage
-import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessaging
-
-import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat
-import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*
-import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson
-import static org.springframework.cloud.contract.verifier.messaging.util.ContractVerifierMessagingUtil.headers
-import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.fileToBytes
-
-@SuppressWarnings("rawtypes")
-class FooSpec extends Specification {
-\t@Inject ContractVerifierMessaging contractVerifierMessaging
-\t@Inject ContractVerifierObjectMapper contractVerifierObjectMapper
-
-\tdef validate_foo() throws Exception {
-\t\tgiven:
-\t\t\tContractVerifierMessage inputMessage = contractVerifierMessaging.create(
-\t\t\t\t\t'''{"bookName":"foo"}'''
-\t\t\t\t\t\t, headers()
-\t\t\t\t\t\t\t.header("sample", "header")
-\t\t\t)
-
-\t\twhen:
-\t\t\tcontractVerifierMessaging.send(inputMessage, "jms:input")
-
-\t\tthen:
-\t\t\tContractVerifierMessage response = contractVerifierMessaging.receive("jms:output")
-\t\t\tresponse != null
-
-\t\tand:
-\t\t\tresponse.getHeader("BOOK-NAME") != null
-\t\t\tresponse.getHeader("BOOK-NAME").toString() == 'foo'
-
-\t\tand:
-\t\t\tDocumentContext parsedJson = JsonPath.parse(contractVerifierObjectMapper.writeValueAsString(response.getPayload()))
-\t\t\tassertThatJson(parsedJson).field("['bookName']").isEqualTo("foo")
-\t}
-
-}
-
-"""</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_scenario_3_no_output_message"><a class="link" href="#_scenario_3_no_output_message">5.3.3. Scenario 3: No Output Message</a></h4>
-<div class="paragraph">
-<p>For the given contract:</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">			def contractDsl = Contract.make {
-				name "foo"
-				label 'some_label'
-				input {
-					messageFrom('jms:delete')
-					messageBody([
-							bookName: 'foo'
-					])
-					messageHeaders {
-						header('sample', 'header')
-					}
-					assertThat('bookWasDeleted()')
-				}
-			}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">label: some_label
-input:
-  messageFrom: jms:delete
-  messageBody:
-    bookName: 'foo'
-  messageHeaders:
-    sample: header
-  assertThat: bookWasDeleted()</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following JUnit test is created:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">					"""\
-package com.example;
-
-import com.jayway.jsonpath.DocumentContext;
-import com.jayway.jsonpath.JsonPath;
-import org.junit.Test;
-import org.junit.Rule;
-import javax.inject.Inject;
-import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierObjectMapper;
-import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessage;
-import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessaging;
-
-import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat;
-import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*;
-import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson;
-import static org.springframework.cloud.contract.verifier.messaging.util.ContractVerifierMessagingUtil.headers;
-import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.fileToBytes;
-
-@SuppressWarnings("rawtypes")
-public class FooTest {
-\t@Inject ContractVerifierMessaging contractVerifierMessaging;
-\t@Inject ContractVerifierObjectMapper contractVerifierObjectMapper;
-
-\t@Test
-\tpublic void validate_foo() throws Exception {
-\t\t// given:
-\t\t\tContractVerifierMessage inputMessage = contractVerifierMessaging.create(
-\t\t\t\t\t"{\\"bookName\\":\\"foo\\"}"
-\t\t\t\t\t\t, headers()
-\t\t\t\t\t\t\t.header("sample", "header")
-\t\t\t);
-
-\t\t// when:
-\t\t\tcontractVerifierMessaging.send(inputMessage, "jms:delete");
-\t\t\tbookWasDeleted();
-
-\t}
-
-}
-
-"""</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And the following Spock test would be created:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">					"""\
-package com.example
-
-import com.jayway.jsonpath.DocumentContext
-import com.jayway.jsonpath.JsonPath
-import spock.lang.Specification
-import javax.inject.Inject
-import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierObjectMapper
-import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessage
-import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessaging
-
-import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat
-import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*
-import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson
-import static org.springframework.cloud.contract.verifier.messaging.util.ContractVerifierMessagingUtil.headers
-import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.fileToBytes
-
-@SuppressWarnings("rawtypes")
-class FooSpec extends Specification {
-\t@Inject ContractVerifierMessaging contractVerifierMessaging
-\t@Inject ContractVerifierObjectMapper contractVerifierObjectMapper
-
-\tdef validate_foo() throws Exception {
-\t\tgiven:
-\t\t\tContractVerifierMessage inputMessage = contractVerifierMessaging.create(
-\t\t\t\t\t'''{"bookName":"foo"}'''
-\t\t\t\t\t\t, headers()
-\t\t\t\t\t\t\t.header("sample", "header")
-\t\t\t)
-
-\t\twhen:
-\t\t\tcontractVerifierMessaging.send(inputMessage, "jms:delete")
-\t\t\tbookWasDeleted()
-
-\t\tthen:
-\t\t\tnoExceptionThrown()
-\t}
-
-}
-"""</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_consumer_stub_generation"><a class="link" href="#_consumer_stub_generation">5.4. Consumer Stub Generation</a></h3>
-<div class="paragraph">
-<p>Unlike the HTTP part, in messaging, we need to publish the Groovy DSL inside the JAR with
-a stub. Then it is parsed on the consumer side and proper stubbed routes are created.</p>
-</div>
-<div class="paragraph">
-<p>For more information, see <a href="#stub-runner-for-messaging">Stub Runner for Messaging</a> section.</p>
-</div>
-<div class="listingblock primary">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependencies&gt;
-	&lt;dependency&gt;
-		&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-		&lt;artifactId&gt;spring-cloud-starter-stream-rabbit&lt;/artifactId&gt;
-	&lt;/dependency&gt;
-
-	&lt;dependency&gt;
-		&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-		&lt;artifactId&gt;spring-cloud-starter-contract-stub-runner&lt;/artifactId&gt;
-		&lt;scope&gt;test&lt;/scope&gt;
-	&lt;/dependency&gt;
-	&lt;dependency&gt;
-		&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-		&lt;artifactId&gt;spring-cloud-stream-test-support&lt;/artifactId&gt;
-		&lt;scope&gt;test&lt;/scope&gt;
-	&lt;/dependency&gt;
-&lt;/dependencies&gt;
-
-&lt;dependencyManagement&gt;
-	&lt;dependencies&gt;
-		&lt;dependency&gt;
-			&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-			&lt;artifactId&gt;spring-cloud-dependencies&lt;/artifactId&gt;
-			&lt;version&gt;Hoxton.BUILD-SNAPSHOT&lt;/version&gt;
-			&lt;type&gt;pom&lt;/type&gt;
-			&lt;scope&gt;import&lt;/scope&gt;
-		&lt;/dependency&gt;
-	&lt;/dependencies&gt;
-&lt;/dependencyManagement&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock secondary">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">ext {
-	contractsDir = file("mappings")
-	stubsOutputDirRoot = file("${project.buildDir}/production/${project.name}-stubs/")
-}
-
-// Automatically added by plugin:
-// copyContracts - copies contracts to the output folder from which JAR will be created
-// verifierStubsJar - JAR with a provided stub suffix
-// the presented publication is also added by the plugin but you can modify it as you wish
-
-publishing {
-	publications {
-		stubs(MavenPublication) {
-			artifactId "${project.name}-stubs"
-			artifact verifierStubsJar
-		}
-	}
-}</code></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_spring_cloud_contract_stub_runner"><a class="link" href="#_spring_cloud_contract_stub_runner">6. Spring Cloud Contract Stub Runner</a></h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>One of the issues that you might encounter while using Spring Cloud Contract Verifier is
-passing the generated WireMock JSON stubs from the server side to the client side (or to
-various clients). The same takes place in terms of client-side generation for messaging.</p>
-</div>
-<div class="paragraph">
-<p>Copying the JSON files and setting the client side for messaging manually is out of the
-question. That is why we introduced Spring Cloud Contract Stub Runner. It can
-automatically download and run the stubs for you.</p>
-</div>
-<div class="sect2">
-<h3 id="_snapshot_versions"><a class="link" href="#_snapshot_versions">6.1. Snapshot versions</a></h3>
-<div class="paragraph">
-<p>Add the additional snapshot repository to your <code>build.gradle</code> file to use snapshot
-versions, which are automatically uploaded after every successful build:</p>
-</div>
-<div class="listingblock primary">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;repositories&gt;
-	&lt;repository&gt;
-		&lt;id&gt;spring-snapshots&lt;/id&gt;
-		&lt;name&gt;Spring Snapshots&lt;/name&gt;
-		&lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
-		&lt;snapshots&gt;
-			&lt;enabled&gt;true&lt;/enabled&gt;
-		&lt;/snapshots&gt;
-	&lt;/repository&gt;
-	&lt;repository&gt;
-		&lt;id&gt;spring-milestones&lt;/id&gt;
-		&lt;name&gt;Spring Milestones&lt;/name&gt;
-		&lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
-		&lt;snapshots&gt;
-			&lt;enabled&gt;false&lt;/enabled&gt;
-		&lt;/snapshots&gt;
-	&lt;/repository&gt;
-	&lt;repository&gt;
-		&lt;id&gt;spring-releases&lt;/id&gt;
-		&lt;name&gt;Spring Releases&lt;/name&gt;
-		&lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
-		&lt;snapshots&gt;
-			&lt;enabled&gt;false&lt;/enabled&gt;
-		&lt;/snapshots&gt;
-	&lt;/repository&gt;
-&lt;/repositories&gt;
-&lt;pluginRepositories&gt;
-	&lt;pluginRepository&gt;
-		&lt;id&gt;spring-snapshots&lt;/id&gt;
-		&lt;name&gt;Spring Snapshots&lt;/name&gt;
-		&lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
-		&lt;snapshots&gt;
-			&lt;enabled&gt;true&lt;/enabled&gt;
-		&lt;/snapshots&gt;
-	&lt;/pluginRepository&gt;
-	&lt;pluginRepository&gt;
-		&lt;id&gt;spring-milestones&lt;/id&gt;
-		&lt;name&gt;Spring Milestones&lt;/name&gt;
-		&lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
-		&lt;snapshots&gt;
-			&lt;enabled&gt;false&lt;/enabled&gt;
-		&lt;/snapshots&gt;
-	&lt;/pluginRepository&gt;
-	&lt;pluginRepository&gt;
-		&lt;id&gt;spring-releases&lt;/id&gt;
-		&lt;name&gt;Spring Releases&lt;/name&gt;
-		&lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
-		&lt;snapshots&gt;
-			&lt;enabled&gt;false&lt;/enabled&gt;
-		&lt;/snapshots&gt;
-	&lt;/pluginRepository&gt;
-&lt;/pluginRepositories&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock secondary">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">buildscript {
-	repositories {
-		mavenCentral()
-		mavenLocal()
-		maven { url "https://repo.spring.io/snapshot" }
-		maven { url "https://repo.spring.io/milestone" }
-		maven { url "https://repo.spring.io/release" }
-	}</code></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="publishing-stubs-as-jars"><a class="link" href="#publishing-stubs-as-jars">6.2. Publishing Stubs as JARs</a></h3>
-<div class="paragraph">
-<p>The easiest approach would be to centralize the way stubs are kept. For example, you can
-keep them as jars in a Maven repository.</p>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-For both Maven and Gradle, the setup comes ready to work. However, you can customize
-it if you want to.
-</td>
-</tr>
-</table>
-</div>
-<div class="listingblock primary">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;!-- First disable the default jar setup in the properties section --&gt;
-&lt;!-- we don't want the verifier to do a jar for us --&gt;
-&lt;spring.cloud.contract.verifier.skip&gt;true&lt;/spring.cloud.contract.verifier.skip&gt;
-
-&lt;!-- Next add the assembly plugin to your build --&gt;
-&lt;!-- we want the assembly plugin to generate the JAR --&gt;
-&lt;plugin&gt;
-	&lt;groupId&gt;org.apache.maven.plugins&lt;/groupId&gt;
-	&lt;artifactId&gt;maven-assembly-plugin&lt;/artifactId&gt;
-	&lt;executions&gt;
-		&lt;execution&gt;
-			&lt;id&gt;stub&lt;/id&gt;
-			&lt;phase&gt;prepare-package&lt;/phase&gt;
-			&lt;goals&gt;
-				&lt;goal&gt;single&lt;/goal&gt;
-			&lt;/goals&gt;
-			&lt;inherited&gt;false&lt;/inherited&gt;
-			&lt;configuration&gt;
-				&lt;attach&gt;true&lt;/attach&gt;
-				&lt;descriptors&gt;
-					${basedir}/src/assembly/stub.xml
-				&lt;/descriptors&gt;
-			&lt;/configuration&gt;
-		&lt;/execution&gt;
-	&lt;/executions&gt;
-&lt;/plugin&gt;
-
-&lt;!-- Finally setup your assembly. Below you can find the contents of src/main/assembly/stub.xml --&gt;
-&lt;assembly
-	xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3"
-	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-	xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 https://maven.apache.org/xsd/assembly-1.1.3.xsd"&gt;
-	&lt;id&gt;stubs&lt;/id&gt;
-	&lt;formats&gt;
-		&lt;format&gt;jar&lt;/format&gt;
-	&lt;/formats&gt;
-	&lt;includeBaseDirectory&gt;false&lt;/includeBaseDirectory&gt;
-	&lt;fileSets&gt;
-		&lt;fileSet&gt;
-			&lt;directory&gt;src/main/java&lt;/directory&gt;
-			&lt;outputDirectory&gt;/&lt;/outputDirectory&gt;
-			&lt;includes&gt;
-				&lt;include&gt;**com/example/model/*.*&lt;/include&gt;
-			&lt;/includes&gt;
-		&lt;/fileSet&gt;
-		&lt;fileSet&gt;
-			&lt;directory&gt;${project.build.directory}/classes&lt;/directory&gt;
-			&lt;outputDirectory&gt;/&lt;/outputDirectory&gt;
-			&lt;includes&gt;
-				&lt;include&gt;**com/example/model/*.*&lt;/include&gt;
-			&lt;/includes&gt;
-		&lt;/fileSet&gt;
-		&lt;fileSet&gt;
-			&lt;directory&gt;${project.build.directory}/snippets/stubs&lt;/directory&gt;
-			&lt;outputDirectory&gt;META-INF/${project.groupId}/${project.artifactId}/${project.version}/mappings&lt;/outputDirectory&gt;
-			&lt;includes&gt;
-				&lt;include&gt;**/*&lt;/include&gt;
-			&lt;/includes&gt;
-		&lt;/fileSet&gt;
-		&lt;fileSet&gt;
-			&lt;directory&gt;${basedir}/src/test/resources/contracts&lt;/directory&gt;
-			&lt;outputDirectory&gt;META-INF/${project.groupId}/${project.artifactId}/${project.version}/contracts&lt;/outputDirectory&gt;
-			&lt;includes&gt;
-				&lt;include&gt;**/*.groovy&lt;/include&gt;
-			&lt;/includes&gt;
-		&lt;/fileSet&gt;
-	&lt;/fileSets&gt;
-&lt;/assembly&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock secondary">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">ext {
-	contractsDir = file("mappings")
-	stubsOutputDirRoot = file("${project.buildDir}/production/${project.name}-stubs/")
-}
-
-// Automatically added by plugin:
-// copyContracts - copies contracts to the output folder from which JAR will be created
-// verifierStubsJar - JAR with a provided stub suffix
-// the presented publication is also added by the plugin but you can modify it as you wish
-
-publishing {
-	publications {
-		stubs(MavenPublication) {
-			artifactId "${project.name}-stubs"
-			artifact verifierStubsJar
-		}
-	}
-}</code></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_stub_runner_core"><a class="link" href="#_stub_runner_core">6.3. Stub Runner Core</a></h3>
-<div class="paragraph">
-<p>Runs stubs for service collaborators. Treating stubs as contracts of services allows to use stub-runner as an implementation of
-<a href="https://martinfowler.com/articles/consumerDrivenContracts.html">Consumer Driven Contracts</a>.</p>
-</div>
-<div class="paragraph">
-<p>Stub Runner allows you to automatically download the stubs of the provided dependencies (or pick those from the classpath), start WireMock servers for them and feed them with proper stub definitions.
-For messaging, special stub routes are defined.</p>
-</div>
-<div class="sect3">
-<h4 id="_retrieving_stubs"><a class="link" href="#_retrieving_stubs">6.3.1. Retrieving stubs</a></h4>
-<div class="paragraph">
-<p>You can pick the following options of acquiring stubs</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Aether based solution that downloads JARs with stubs from Artifactory / Nexus</p>
-</li>
-<li>
-<p>Classpath scanning solution that searches classpath via pattern to retrieve stubs</p>
-</li>
-<li>
-<p>Write your own implementation of the <code>org.springframework.cloud.contract.stubrunner.StubDownloaderBuilder</code> for full customization</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The latter example is described in the <a href="#custom_stub_runner">Custom Stub Runner</a> section.</p>
-</div>
-<div class="sect4">
-<h5 id="_stub_downloading"><a class="link" href="#_stub_downloading">Stub downloading</a></h5>
-<div class="paragraph">
-<p>You can control the stub downloading via the <code>stubsMode</code> switch. It picks value from the
-<code>StubRunnerProperties.StubsMode</code> enum. You can use the following options</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>StubRunnerProperties.StubsMode.CLASSPATH</code> (default value) - will pick stubs from the classpath</p>
-</li>
-<li>
-<p><code>StubRunnerProperties.StubsMode.LOCAL</code> - will pick stubs from a local storage (e.g. <code>.m2</code>)</p>
-</li>
-<li>
-<p><code>StubRunnerProperties.StubsMode.REMOTE</code> - will pick stubs from a remote location</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(repositoryRoot="https://foo.bar", ids = "com.example:beer-api-producer:+:stubs:8095", stubsMode = StubRunnerProperties.StubsMode.LOCAL)</code></pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_classpath_scanning"><a class="link" href="#_classpath_scanning">Classpath scanning</a></h5>
-<div class="paragraph">
-<p>If you set the <code>stubsMode</code> property to <code>StubRunnerProperties.StubsMode.CLASSPATH</code>
-(or set nothing since <code>CLASSPATH</code> is the default value) then classpath will get scanned.
-Let&#8217;s look at the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(ids = {
-    "com.example:beer-api-producer:+:stubs:8095",
-    "com.example.foo:bar:1.0.0:superstubs:8096"
-})</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you&#8217;ve added the dependencies to your classpath</p>
-</div>
-<div class="listingblock primary">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
-    &lt;groupId&gt;com.example&lt;/groupId&gt;
-    &lt;artifactId&gt;beer-api-producer-restdocs&lt;/artifactId&gt;
-    &lt;classifier&gt;stubs&lt;/classifier&gt;
-    &lt;version&gt;0.0.1-SNAPSHOT&lt;/version&gt;
-    &lt;scope&gt;test&lt;/scope&gt;
-    &lt;exclusions&gt;
-        &lt;exclusion&gt;
-            &lt;groupId&gt;*&lt;/groupId&gt;
-            &lt;artifactId&gt;*&lt;/artifactId&gt;
-        &lt;/exclusion&gt;
-    &lt;/exclusions&gt;
-&lt;/dependency&gt;
-&lt;dependency&gt;
-    &lt;groupId&gt;com.example.foo&lt;/groupId&gt;
-    &lt;artifactId&gt;bar&lt;/artifactId&gt;
-    &lt;classifier&gt;superstubs&lt;/classifier&gt;
-    &lt;version&gt;1.0.0&lt;/version&gt;
-    &lt;scope&gt;test&lt;/scope&gt;
-    &lt;exclusions&gt;
-        &lt;exclusion&gt;
-            &lt;groupId&gt;*&lt;/groupId&gt;
-            &lt;artifactId&gt;*&lt;/artifactId&gt;
-        &lt;/exclusion&gt;
-    &lt;/exclusions&gt;
-&lt;/dependency&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock secondary">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile("com.example:beer-api-producer-restdocs:0.0.1-SNAPSHOT:stubs") {
-    transitive = false
-}
-testCompile("com.example.foo:bar:1.0.0:superstubs") {
-    transitive = false
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Then the following locations on your classpath will get scanned. For <code>com.example:beer-api-producer-restdocs</code></p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>/META-INF/com.example/beer-api-producer-restdocs/<strong>*/</strong>.*</p>
-</li>
-<li>
-<p>/contracts/com.example/beer-api-producer-restdocs/<strong>*/</strong>.*</p>
-</li>
-<li>
-<p>/mappings/com.example/beer-api-producer-restdocs/<strong>*/</strong>.*</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>and <code>com.example.foo:bar</code></p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>/META-INF/com.example.foo/bar/<strong>*/</strong>.*</p>
-</li>
-<li>
-<p>/contracts/com.example.foo/bar/<strong>*/</strong>.*</p>
-</li>
-<li>
-<p>/mappings/com.example.foo/bar/<strong>*/</strong>.*</p>
-</li>
-</ul>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-As you can see you have to explicitly provide the group and artifact ids when packaging the
-producer stubs.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>The producer would setup the contracts like this:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── src
-    └── test
-        └── resources
-            └── contracts
-                └── com.example
-                    └── beer-api-producer-restdocs
-                        └── nested
-                            └── contract3.groovy</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>To achieve proper stub packaging.</p>
-</div>
-<div class="paragraph">
-<p>Or using the <a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/blob/2.2.x/producer_with_restdocs/pom.xml">Maven <code>assembly</code> plugin</a> or
-<a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/blob/2.2.x/producer_with_restdocs/build.gradle">Gradle Jar</a> task you have to create the following
-structure in your stubs jar.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── META-INF
-    └── com.example
-        └── beer-api-producer-restdocs
-            └── 2.0.0
-                ├── contracts
-                │   └── nested
-                │       └── contract2.groovy
-                └── mappings
-                    └── mapping.json</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>By maintaining this structure classpath gets scanned and you can profit from the messaging /
-HTTP stubs without the need to download artifacts.</p>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_configuring_http_server_stubs"><a class="link" href="#_configuring_http_server_stubs">Configuring HTTP Server Stubs</a></h5>
-<div class="paragraph">
-<p>Stub Runner has a notion of a <code>HttpServerStub</code> that abstracts the underlaying
-concrete implementation of the HTTP server (e.g. WireMock is one of the implementations).
-Sometimes, you need to perform some additional tuning of the stub servers,
-that is concrete for the given implementation. To do that, Stub Runner gives you
-the <code>httpServerStubConfigurer</code> property that is available in the annotation,
-JUnit rule, and is accessible via system properties, where you can provide
-your implementation of the <code>org.springframework.cloud.contract.stubrunner.HttpServerStubConfigurer</code> interface. The implementations can alter
-the configuration files for the given HTTP server stub.</p>
-</div>
-<div class="paragraph">
-<p>Spring Cloud Contract Stub Runner comes with an implementation that you
-can extend, for WireMock - <code>org.springframework.cloud.contract.stubrunner.provider.wiremock.WireMockHttpServerStubConfigurer</code>. In the <code>configure</code> method
-you can provide your own, custom configuration for the given stub. The use
-case might be starting WireMock for the given artifact id, on an HTTPs port. Example:</p>
-</div>
-<div class="listingblock">
-<div class="title">WireMockHttpServerStubConfigurer implementation</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@CompileStatic
-static class HttpsForFraudDetection extends WireMockHttpServerStubConfigurer {
-
-	private static final Log log = LogFactory.getLog(HttpsForFraudDetection)
-
-	@Override
-	WireMockConfiguration configure(WireMockConfiguration httpStubConfiguration, HttpServerStubConfiguration httpServerStubConfiguration) {
-		if (httpServerStubConfiguration.stubConfiguration.artifactId == "fraudDetectionServer") {
-			int httpsPort = SocketUtils.findAvailableTcpPort()
-			log.info("Will set HTTPs port [" + httpsPort + "] for fraud detection server")
-			return httpStubConfiguration
-					.httpsPort(httpsPort)
-		}
-		return httpStubConfiguration
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can then reuse it via the annotation</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@AutoConfigureStubRunner(mappingsOutputFolder = "target/outputmappings/",
-		httpServerStubConfigurer = HttpsForFraudDetection)</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Whenever an https port is found, it will take precedence over the http one.</p>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_running_stubs"><a class="link" href="#_running_stubs">6.3.2. Running stubs</a></h4>
-<div class="sect4">
-<h5 id="_running_using_main_app"><a class="link" href="#_running_using_main_app">Running using main app</a></h5>
-<div class="paragraph">
-<p>You can set the following options to the main class:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">-c, --classifier                Suffix for the jar containing stubs (e.
-                                  g. 'stubs' if the stub jar would
-                                  have a 'stubs' classifier for stubs:
-                                  foobar-stubs ). Defaults to 'stubs'
-                                  (default: stubs)
---maxPort, --maxp &lt;Integer&gt;     Maximum port value to be assigned to
-                                  the WireMock instance. Defaults to
-                                  15000 (default: 15000)
---minPort, --minp &lt;Integer&gt;     Minimum port value to be assigned to
-                                  the WireMock instance. Defaults to
-                                  10000 (default: 10000)
--p, --password                  Password to user when connecting to
-                                  repository
---phost, --proxyHost            Proxy host to use for repository
-                                  requests
---pport, --proxyPort [Integer]  Proxy port to use for repository
-                                  requests
--r, --root                      Location of a Jar containing server
-                                  where you keep your stubs (e.g. http:
-                                  //nexus.
-                                  net/content/repositories/repository)
--s, --stubs                     Comma separated list of Ivy
-                                  representation of jars with stubs.
-                                  Eg. groupid:artifactid1,groupid2:
-                                  artifactid2:classifier
---sm, --stubsMode               Stubs mode to be used. Acceptable values
-                                  [CLASSPATH, LOCAL, REMOTE]
--u, --username                  Username to user when connecting to
-                                  repository</code></pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_http_stubs"><a class="link" href="#_http_stubs">HTTP Stubs</a></h5>
-<div class="paragraph">
-<p>Stubs are defined in JSON documents, whose syntax is defined in <a href="http://wiremock.org/stubbing.html">WireMock documentation</a></p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">{
-    "request": {
-        "method": "GET",
-        "url": "/ping"
-    },
-    "response": {
-        "status": 200,
-        "body": "pong",
-        "headers": {
-            "Content-Type": "text/plain"
-        }
-    }
-}</code></pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_viewing_registered_mappings"><a class="link" href="#_viewing_registered_mappings">Viewing registered mappings</a></h5>
-<div class="paragraph">
-<p>Every stubbed collaborator exposes list of defined mappings under <code>__/admin/</code> endpoint.</p>
-</div>
-<div class="paragraph">
-<p>You can also use the <code>mappingsOutputFolder</code> property to dump the mappings to files.
- For annotation based approach it would look like this</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(ids="a.b.c:loanIssuance,a.b.c:fraudDetectionServer",
-mappingsOutputFolder = "target/outputmappings/")</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>and for the JUnit approach like this:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@ClassRule @Shared StubRunnerRule rule = new StubRunnerRule()
-			.repoRoot("https://some_url")
-			.downloadStub("a.b.c", "loanIssuance")
-			.downloadStub("a.b.c:fraudDetectionServer")
-			.withMappingsOutputFolder("target/outputmappings")</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Then if you check out the folder <code>target/outputmappings</code> you would see the following structure</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">.
-├── fraudDetectionServer_13705
-└── loanIssuance_12255</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>That means that there were two stubs registered. <code>fraudDetectionServer</code> was registered at port <code>13705</code>
-and <code>loanIssuance</code> at port <code>12255</code>. If we take a look at one of the files we would see (for WireMock)
-mappings available for the given server:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">[{
-  "id" : "f9152eb9-bf77-4c38-8289-90be7d10d0d7",
-  "request" : {
-    "url" : "/name",
-    "method" : "GET"
-  },
-  "response" : {
-    "status" : 200,
-    "body" : "fraudDetectionServer"
-  },
-  "uuid" : "f9152eb9-bf77-4c38-8289-90be7d10d0d7"
-},
-...
-]</code></pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_messaging_stubs"><a class="link" href="#_messaging_stubs">Messaging Stubs</a></h5>
-<div class="paragraph">
-<p>Depending on the provided Stub Runner dependency and the DSL the messaging routes are automatically set up.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_stub_runner_junit_rule_and_stub_runner_junit5_extension"><a class="link" href="#_stub_runner_junit_rule_and_stub_runner_junit5_extension">6.4. Stub Runner JUnit Rule and Stub Runner JUnit5 Extension</a></h3>
-<div class="paragraph">
-<p>Stub Runner comes with a JUnit rule thanks to which you can very easily download and run stubs for given group and artifact id:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@ClassRule
-public static StubRunnerRule rule = new StubRunnerRule().repoRoot(repoRoot())
-		.stubsMode(StubRunnerProperties.StubsMode.REMOTE)
-		.downloadStub("org.springframework.cloud.contract.verifier.stubs",
-				"loanIssuance")
-		.downloadStub(
-				"org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer");
-
-@BeforeClass
-@AfterClass
-public static void setupProps() {
-	System.clearProperty("stubrunner.repository.root");
-	System.clearProperty("stubrunner.classifier");
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>There&#8217;s also a <code>StubRunnerExtension</code> available for JUnit 5. <code>StubRunnerRule</code> and <code>StubRunnerExtension</code> work in a very
-similar fashion. After the rule/ extension is executed, Stub Runner connects to your Maven repository and for the given list of dependencies tries to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>download them</p>
-</li>
-<li>
-<p>cache them locally</p>
-</li>
-<li>
-<p>unzip them to a temporary folder</p>
-</li>
-<li>
-<p>start a WireMock server for each Maven dependency on a random port from the provided range of ports / provided port</p>
-</li>
-<li>
-<p>feed the WireMock server with all JSON files that are valid WireMock definitions</p>
-</li>
-<li>
-<p>can also send messages (remember to pass an implementation of <code>MessageVerifier</code> interface)</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Stub Runner uses <a href="https://wiki.eclipse.org/Aether">Eclipse Aether</a> mechanism to download the Maven dependencies.
-Check their <a href="https://wiki.eclipse.org/Aether">docs</a> for more information.</p>
-</div>
-<div class="paragraph">
-<p>Since the <code>StubRunnerRule</code> and <code>StubRunnerExtension</code> implement the <code>StubFinder</code> they allow you to find the started stubs:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package org.springframework.cloud.contract.stubrunner;
-
-import java.net.URL;
-import java.util.Collection;
-import java.util.Map;
-
-import org.springframework.cloud.contract.spec.Contract;
-
-/**
- * Contract for finding registered stubs.
- *
- * @author Marcin Grzejszczak
- */
-public interface StubFinder extends StubTrigger {
-
-	/**
-	 * For the given groupId and artifactId tries to find the matching URL of the running
-	 * stub.
-	 * @param groupId - might be null. In that case a search only via artifactId takes
-	 * place
-	 * @param artifactId - artifact id of the stub
-	 * @return URL of a running stub or throws exception if not found
-	 * @throws StubNotFoundException in case of not finding a stub
-	 */
-	URL findStubUrl(String groupId, String artifactId) throws StubNotFoundException;
-
-	/**
-	 * For the given Ivy notation {@code [groupId]:artifactId:[version]:[classifier]}
-	 * tries to find the matching URL of the running stub. You can also pass only
-	 * {@code artifactId}.
-	 * @param ivyNotation - Ivy representation of the Maven artifact
-	 * @return URL of a running stub or throws exception if not found
-	 * @throws StubNotFoundException in case of not finding a stub
-	 */
-	URL findStubUrl(String ivyNotation) throws StubNotFoundException;
-
-	/**
-	 * @return all running stubs
-	 */
-	RunningStubs findAllRunningStubs();
-
-	/**
-	 * @return the list of Contracts
-	 */
-	Map&lt;StubConfiguration, Collection&lt;Contract&gt;&gt; getContracts();
-
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Example of usage in Spock tests:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@ClassRule
-@Shared
-StubRunnerRule rule = new StubRunnerRule()
-		.stubsMode(StubRunnerProperties.StubsMode.REMOTE)
-		.repoRoot(StubRunnerRuleSpec.getResource("/m2repo/repository").toURI().toString())
-		.downloadStub("org.springframework.cloud.contract.verifier.stubs", "loanIssuance")
-		.downloadStub("org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer")
-		.withMappingsOutputFolder("target/outputmappingsforrule")
-
-
-def 'should start WireMock servers'() {
-	expect: 'WireMocks are running'
-		rule.findStubUrl('org.springframework.cloud.contract.verifier.stubs', 'loanIssuance') != null
-		rule.findStubUrl('loanIssuance') != null
-		rule.findStubUrl('loanIssuance') == rule.findStubUrl('org.springframework.cloud.contract.verifier.stubs', 'loanIssuance')
-		rule.findStubUrl('org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer') != null
-	and:
-		rule.findAllRunningStubs().isPresent('loanIssuance')
-		rule.findAllRunningStubs().isPresent('org.springframework.cloud.contract.verifier.stubs', 'fraudDetectionServer')
-		rule.findAllRunningStubs().isPresent('org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer')
-	and: 'Stubs were registered'
-		"${rule.findStubUrl('loanIssuance').toString()}/name".toURL().text == 'loanIssuance'
-		"${rule.findStubUrl('fraudDetectionServer').toString()}/name".toURL().text == 'fraudDetectionServer'
-}
-
-def 'should output mappings to output folder'() {
-	when:
-		def url = rule.findStubUrl('fraudDetectionServer')
-	then:
-		new File("target/outputmappingsforrule", "fraudDetectionServer_${url.port}").exists()
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Example of usage in JUnit tests:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">	@Test
-	public void should_start_wiremock_servers() throws Exception {
-		// expect: 'WireMocks are running'
-		then(rule.findStubUrl("org.springframework.cloud.contract.verifier.stubs",
-				"loanIssuance")).isNotNull();
-		then(rule.findStubUrl("loanIssuance")).isNotNull();
-		then(rule.findStubUrl("loanIssuance")).isEqualTo(rule.findStubUrl(
-				"org.springframework.cloud.contract.verifier.stubs", "loanIssuance"));
-		then(rule.findStubUrl(
-				"org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer"))
-						.isNotNull();
-		// and:
-		then(rule.findAllRunningStubs().isPresent("loanIssuance")).isTrue();
-		then(rule.findAllRunningStubs().isPresent(
-				"org.springframework.cloud.contract.verifier.stubs",
-				"fraudDetectionServer")).isTrue();
-		then(rule.findAllRunningStubs().isPresent(
-				"org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer"))
-						.isTrue();
-		// and: 'Stubs were registered'
-		then(httpGet(rule.findStubUrl("loanIssuance").toString() + "/name"))
-				.isEqualTo("loanIssuance");
-		then(httpGet(rule.findStubUrl("fraudDetectionServer").toString() + "/name"))
-				.isEqualTo("fraudDetectionServer");
-	}
-
-	private String httpGet(String url) throws Exception {
-		try (InputStream stream = URI.create(url).toURL().openStream()) {
-			return StreamUtils.copyToString(stream, Charset.forName("UTF-8"));
-		}
-	}
-
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>JUnit 5 Extension example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">// Visible for Junit
-@RegisterExtension
-static StubRunnerExtension stubRunnerExtension = new StubRunnerExtension()
-		.repoRoot(repoRoot()).stubsMode(StubRunnerProperties.StubsMode.REMOTE)
-		.downloadStub("org.springframework.cloud.contract.verifier.stubs",
-				"loanIssuance")
-		.downloadStub(
-				"org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer")
-		.withMappingsOutputFolder("target/outputmappingsforrule");
-
-@BeforeAll
-@AfterAll
-static void setupProps() {
-	System.clearProperty("stubrunner.repository.root");
-	System.clearProperty("stubrunner.classifier");
-}
-
-private static String repoRoot() {
-	try {
-		return StubRunnerRuleJUnitTest.class.getResource("/m2repo/repository/")
-				.toURI().toString();
-	}
-	catch (Exception e) {
-		return "";
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Check the <strong>Common properties for JUnit and Spring</strong> for more information on how to apply global configuration of Stub Runner.</p>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-To use the JUnit rule or JUnit 5 extension together with messaging, you have to provide an implementation of the
-<code>MessageVerifier</code> interface to the rule builder (e.g. <code>rule.messageVerifier(new MyMessageVerifier())</code>).
-If you don&#8217;t do this, then whenever you try to send a message an exception will be thrown.
-</td>
-</tr>
-</table>
-</div>
-<div class="sect3">
-<h4 id="_maven_settings"><a class="link" href="#_maven_settings">6.4.1. Maven settings</a></h4>
-<div class="paragraph">
-<p>The stub downloader honors Maven settings for a different local repository folder.
-Authentication details for repositories and profiles are currently not taken into account, so you need to specify it using the properties mentioned above.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_providing_fixed_ports"><a class="link" href="#_providing_fixed_ports">6.4.2. Providing fixed ports</a></h4>
-<div class="paragraph">
-<p>You can also run your stubs on fixed ports. You can do it in two different ways. One is to pass it in the properties, and the other via fluent API of
-JUnit rule.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_fluent_api"><a class="link" href="#_fluent_api">6.4.3. Fluent API</a></h4>
-<div class="paragraph">
-<p>When using the <code>StubRunnerRule</code> or <code>StubRunnerExtension</code> you can add a stub to download and then pass the port for the last downloaded stub.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@ClassRule
-public static StubRunnerRule rule = new StubRunnerRule().repoRoot(repoRoot())
-		.stubsMode(StubRunnerProperties.StubsMode.REMOTE)
-		.downloadStub("org.springframework.cloud.contract.verifier.stubs",
-				"loanIssuance")
-		.withPort(12345).downloadStub(
-				"org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer:12346");
-
-@BeforeClass
-@AfterClass
-public static void setupProps() {
-	System.clearProperty("stubrunner.repository.root");
-	System.clearProperty("stubrunner.classifier");
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can see that for this example the following test is valid:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">then(rule.findStubUrl("loanIssuance"))
-		.isEqualTo(URI.create("http://localhost:12345").toURL());
-then(rule.findStubUrl("fraudDetectionServer"))
-		.isEqualTo(URI.create("http://localhost:12346").toURL());</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_stub_runner_with_spring"><a class="link" href="#_stub_runner_with_spring">6.4.4. Stub Runner with Spring</a></h4>
-<div class="paragraph">
-<p>Sets up Spring configuration of the Stub Runner project.</p>
-</div>
-<div class="paragraph">
-<p>By providing a list of stubs inside your configuration file the Stub Runner automatically downloads
-and registers in WireMock the selected stubs.</p>
-</div>
-<div class="paragraph">
-<p>If you want to find the URL of your stubbed dependency you can autowire the <code>StubFinder</code> interface and use
-its methods as presented below:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@ContextConfiguration(classes = Config, loader = SpringBootContextLoader)
-@SpringBootTest(properties = [" stubrunner.cloud.enabled=false",
-		'foo=${stubrunner.runningstubs.fraudDetectionServer.port}',
-		'fooWithGroup=${stubrunner.runningstubs.org.springframework.cloud.contract.verifier.stubs.fraudDetectionServer.port}'])
-@AutoConfigureStubRunner(mappingsOutputFolder = "target/outputmappings/",
-		httpServerStubConfigurer = HttpsForFraudDetection)
-@ActiveProfiles("test")
-class StubRunnerConfigurationSpec extends Specification {
-
-	@Autowired
-	StubFinder stubFinder
-	@Autowired
-	Environment environment
-	@StubRunnerPort("fraudDetectionServer")
-	int fraudDetectionServerPort
-	@StubRunnerPort("org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer")
-	int fraudDetectionServerPortWithGroupId
-	@Value('${foo}')
-	Integer foo
-
-	@BeforeClass
-	@AfterClass
-	void setupProps() {
-		System.clearProperty("stubrunner.repository.root")
-		System.clearProperty("stubrunner.classifier")
-	}
-
-	def 'should start WireMock servers'() {
-		expect: 'WireMocks are running'
-			stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs', 'loanIssuance') != null
-			stubFinder.findStubUrl('loanIssuance') != null
-			stubFinder.findStubUrl('loanIssuance') == stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs', 'loanIssuance')
-			stubFinder.findStubUrl('loanIssuance') == stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs:loanIssuance')
-			stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs:loanIssuance:0.0.1-SNAPSHOT') == stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs:loanIssuance:0.0.1-SNAPSHOT:stubs')
-			stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer') != null
-		and:
-			stubFinder.findAllRunningStubs().isPresent('loanIssuance')
-			stubFinder.findAllRunningStubs().isPresent('org.springframework.cloud.contract.verifier.stubs', 'fraudDetectionServer')
-			stubFinder.findAllRunningStubs().isPresent('org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer')
-		and: 'Stubs were registered'
-			"${stubFinder.findStubUrl('loanIssuance').toString()}/name".toURL().text == 'loanIssuance'
-			"${stubFinder.findStubUrl('fraudDetectionServer').toString()}/name".toURL().text == 'fraudDetectionServer'
-		and: 'Fraud Detection is an HTTPS endpoint'
-			stubFinder.findStubUrl('fraudDetectionServer').toString().startsWith("https")
-	}
-
-	def 'should throw an exception when stub is not found'() {
-		when:
-			stubFinder.findStubUrl('nonExistingService')
-		then:
-			thrown(StubNotFoundException)
-		when:
-			stubFinder.findStubUrl('nonExistingGroupId', 'nonExistingArtifactId')
-		then:
-			thrown(StubNotFoundException)
-	}
-
-	def 'should register started servers as environment variables'() {
-		expect:
-			environment.getProperty("stubrunner.runningstubs.loanIssuance.port") != null
-			stubFinder.findAllRunningStubs().getPort("loanIssuance") == (environment.getProperty("stubrunner.runningstubs.loanIssuance.port") as Integer)
-		and:
-			environment.getProperty("stubrunner.runningstubs.fraudDetectionServer.port") != null
-			stubFinder.findAllRunningStubs().getPort("fraudDetectionServer") == (environment.getProperty("stubrunner.runningstubs.fraudDetectionServer.port") as Integer)
-		and:
-			environment.getProperty("stubrunner.runningstubs.fraudDetectionServer.port") != null
-			stubFinder.findAllRunningStubs().getPort("fraudDetectionServer") == (environment.getProperty("stubrunner.runningstubs.org.springframework.cloud.contract.verifier.stubs.fraudDetectionServer.port") as Integer)
-	}
-
-	def 'should be able to interpolate a running stub in the passed test property'() {
-		given:
-			int fraudPort = stubFinder.findAllRunningStubs().getPort("fraudDetectionServer")
-		expect:
-			fraudPort &gt; 0
-			environment.getProperty("foo", Integer) == fraudPort
-			environment.getProperty("fooWithGroup", Integer) == fraudPort
-			foo == fraudPort
-	}
-
-	@Issue("#573")
-	def 'should be able to retrieve the port of a running stub via an annotation'() {
-		given:
-			int fraudPort = stubFinder.findAllRunningStubs().getPort("fraudDetectionServer")
-		expect:
-			fraudPort &gt; 0
-			fraudDetectionServerPort == fraudPort
-			fraudDetectionServerPortWithGroupId == fraudPort
-	}
-
-	def 'should dump all mappings to a file'() {
-		when:
-			def url = stubFinder.findStubUrl("fraudDetectionServer")
-		then:
-			new File("target/outputmappings/", "fraudDetectionServer_${url.port}").exists()
-	}
-
-	@Configuration
-	@EnableAutoConfiguration
-	static class Config {}
-
-	@CompileStatic
-	static class HttpsForFraudDetection extends WireMockHttpServerStubConfigurer {
-
-		private static final Log log = LogFactory.getLog(HttpsForFraudDetection)
-
-		@Override
-		WireMockConfiguration configure(WireMockConfiguration httpStubConfiguration, HttpServerStubConfiguration httpServerStubConfiguration) {
-			if (httpServerStubConfiguration.stubConfiguration.artifactId == "fraudDetectionServer") {
-				int httpsPort = SocketUtils.findAvailableTcpPort()
-				log.info("Will set HTTPs port [" + httpsPort + "] for fraud detection server")
-				return httpStubConfiguration
-						.httpsPort(httpsPort)
-			}
-			return httpStubConfiguration
-		}
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>for the following configuration file:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">stubrunner:
-  repositoryRoot: classpath:m2repo/repository/
-  ids:
-    - org.springframework.cloud.contract.verifier.stubs:loanIssuance
-    - org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer
-    - org.springframework.cloud.contract.verifier.stubs:bootService
-  stubs-mode: remote</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Instead of using the properties you can also use the properties inside the <code>@AutoConfigureStubRunner</code>.
-Below you can find an example of achieving the same result by setting values on the annotation.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@AutoConfigureStubRunner(
-		ids = ["org.springframework.cloud.contract.verifier.stubs:loanIssuance",
-				"org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer",
-				"org.springframework.cloud.contract.verifier.stubs:bootService"],
-		stubsMode = StubRunnerProperties.StubsMode.REMOTE,
-		repositoryRoot = "classpath:m2repo/repository/")</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Stub Runner Spring registers environment variables in the following manner
-for every registered WireMock server. Example for Stub Runner ids
- <code>com.example:foo</code>, <code>com.example:bar</code>.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>stubrunner.runningstubs.foo.port</code></p>
-</li>
-<li>
-<p><code>stubrunner.runningstubs.com.example.foo.port</code></p>
-</li>
-<li>
-<p><code>stubrunner.runningstubs.bar.port</code></p>
-</li>
-<li>
-<p><code>stubrunner.runningstubs.com.example.bar.port</code></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Which you can reference in your code.</p>
-</div>
-<div class="paragraph">
-<p>You can also use the <code>@StubRunnerPort</code> annotation to inject the port of a running stub.
-Value of the annotation can be the <code>groupid:artifactid</code> or just the <code>artifactid</code>. Example for Stub Runner ids
-<code>com.example:foo</code>, <code>com.example:bar</code>.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@StubRunnerPort("foo")
-int fooPort;
-@StubRunnerPort("com.example:bar")
-int barPort;</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_stub_runner_spring_cloud"><a class="link" href="#_stub_runner_spring_cloud">6.5. Stub Runner Spring Cloud</a></h3>
-<div class="paragraph">
-<p>Stub Runner can integrate with Spring Cloud.</p>
-</div>
-<div class="paragraph">
-<p>For real life examples you can check the</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x/producer">producer app sample</a></p>
-</li>
-<li>
-<p><a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x/consumer_with_discovery">consumer app sample</a></p>
-</li>
-</ul>
-</div>
-<div class="sect3">
-<h4 id="_stubbing_service_discovery"><a class="link" href="#_stubbing_service_discovery">6.5.1. Stubbing Service Discovery</a></h4>
-<div class="paragraph">
-<p>The most important feature of <code>Stub Runner Spring Cloud</code> is the fact that it&#8217;s stubbing</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>DiscoveryClient</code></p>
-</li>
-<li>
-<p><code>Ribbon</code> <code>ServerList</code></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>that means that regardless of the fact whether you&#8217;re using Zookeeper, Consul, Eureka or anything else, you don&#8217;t need that in your tests.
-We&#8217;re starting WireMock instances of your dependencies and we&#8217;re telling your application whenever you&#8217;re using <code>Feign</code>, load balanced <code>RestTemplate</code>
-or <code>DiscoveryClient</code> directly, to call those stubbed servers instead of calling the real Service Discovery tool.</p>
-</div>
-<div class="paragraph">
-<p>For example this test will pass</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">def 'should make service discovery work'() {
-	expect: 'WireMocks are running'
-		"${stubFinder.findStubUrl('loanIssuance').toString()}/name".toURL().text == 'loanIssuance'
-		"${stubFinder.findStubUrl('fraudDetectionServer').toString()}/name".toURL().text == 'fraudDetectionServer'
-	and: 'Stubs can be reached via load service discovery'
-		restTemplate.getForObject('http://loanIssuance/name', String) == 'loanIssuance'
-		restTemplate.getForObject('http://someNameThatShouldMapFraudDetectionServer/name', String) == 'fraudDetectionServer'
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>for the following configuration file</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">stubrunner:
-  idsToServiceIds:
-    ivyNotation: someValueInsideYourCode
-    fraudDetectionServer: someNameThatShouldMapFraudDetectionServer</code></pre>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_test_profiles_and_service_discovery"><a class="link" href="#_test_profiles_and_service_discovery">Test profiles and service discovery</a></h5>
-<div class="paragraph">
-<p>In your integration tests you typically don&#8217;t want to call neither a discovery service (e.g. Eureka)
-or Config Server. That&#8217;s why you create an additional test configuration in which you want to disable
-these features.</p>
-</div>
-<div class="paragraph">
-<p>Due to certain limitations of <a href="https://github.com/spring-cloud/spring-cloud-commons/issues/156"><code>spring-cloud-commons</code></a> to achieve this you have disable these properties
-via a static block like presented below (example for Eureka)</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">    //Hack to work around https://github.com/spring-cloud/spring-cloud-commons/issues/156
-    static {
-        System.setProperty("eureka.client.enabled", "false");
-        System.setProperty("spring.cloud.config.failFast", "false");
-    }</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_additional_configuration"><a class="link" href="#_additional_configuration">6.5.2. Additional Configuration</a></h4>
-<div class="paragraph">
-<p>You can match the artifactId of the stub with the name of your app by using the <code>stubrunner.idsToServiceIds:</code> map.
-You can disable Stub Runner Ribbon support by providing: <code>stubrunner.cloud.ribbon.enabled</code> equal to <code>false</code>
-You can disable Stub Runner support by providing: <code>stubrunner.cloud.enabled</code> equal to <code>false</code></p>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-By default all service discovery will be stubbed. That means that regardless of the fact if you have
-an existing <code>DiscoveryClient</code> its results will be ignored. However, if you want to reuse it, just set
- <code>stubrunner.cloud.delegate.enabled</code> to <code>true</code> and then your existing <code>DiscoveryClient</code> results will be
- merged with the stubbed ones.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>The default Maven configuration used by Stub Runner can be tweaked either
-via the following system properties or environment variables</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>maven.repo.local</code> - path to the custom maven local repository location</p>
-</li>
-<li>
-<p><code>org.apache.maven.user-settings</code> - path to custom maven user settings location</p>
-</li>
-<li>
-<p><code>org.apache.maven.global-settings</code> - path to maven global settings location</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_stub_runner_boot_application"><a class="link" href="#_stub_runner_boot_application">6.6. Stub Runner Boot Application</a></h3>
-<div class="paragraph">
-<p>Spring Cloud Contract Stub Runner Boot is a Spring Boot application that exposes REST endpoints to
-trigger the messaging labels and to access started WireMock servers.</p>
-</div>
-<div class="paragraph">
-<p>One of the use-cases is to run some smoke (end to end) tests on a deployed application.
-You can check out the <a href="https://github.com/spring-cloud/spring-cloud-pipelines">Spring Cloud Pipelines</a>
-project for more information.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_use_it"><a class="link" href="#_how_to_use_it">6.6.1. How to use it?</a></h4>
-<div class="sect4">
-<h5 id="_stub_runner_server"><a class="link" href="#_stub_runner_server">Stub Runner Server</a></h5>
-<div class="paragraph">
-<p>Just add the</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">compile "org.springframework.cloud:spring-cloud-starter-stub-runner"</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Annotate a class with <code>@EnableStubRunnerServer</code>, build a fat-jar and you&#8217;re ready to go!</p>
-</div>
-<div class="paragraph">
-<p>For the properties check the <strong>Stub Runner Spring</strong> section.</p>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_stub_runner_server_fat_jar"><a class="link" href="#_stub_runner_server_fat_jar">Stub Runner Server Fat Jar</a></h5>
-<div class="paragraph">
-<p>You can download a standalone JAR from Maven (e.g. for version 2.0.1.RELEASE), as follows:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ wget -O stub-runner.jar 'https://search.maven.org/remotecontent?filepath=org/springframework/cloud/spring-cloud-contract-stub-runner-boot/2.0.1.RELEASE/spring-cloud-contract-stub-runner-boot-2.0.1.RELEASE.jar'
-$ java -jar stub-runner.jar --stubrunner.ids=... --stubrunner.repositoryRoot=...</code></pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_spring_cloud_cli"><a class="link" href="#_spring_cloud_cli">Spring Cloud CLI</a></h5>
-<div class="paragraph">
-<p>Starting from <code>1.4.0.RELEASE</code> version of the <a href="https://cloud.spring.io/spring-cloud-cli">Spring Cloud CLI</a>
-project you can start Stub Runner Boot by executing <code>spring cloud stubrunner</code>.</p>
-</div>
-<div class="paragraph">
-<p>In order to pass the configuration just create a <code>stubrunner.yml</code> file in the current working directory
-or a subdirectory called <code>config</code> or in <code>~/.spring-cloud</code>. The file could look like this
-(example for running stubs installed locally)</p>
-</div>
-<div class="listingblock">
-<div class="title">stubrunner.yml</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">stubrunner:
-  stubsMode: LOCAL
-  ids:
-    - com.example:beer-api-producer:+:9876</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>and then just call <code>spring cloud stubrunner</code> from your terminal window to start
-the Stub Runner server. It will be available at port <code>8750</code>.</p>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_endpoints"><a class="link" href="#_endpoints">6.6.2. Endpoints</a></h4>
-<div class="sect4">
-<h5 id="_http"><a class="link" href="#_http">HTTP</a></h5>
-<div class="ulist">
-<ul>
-<li>
-<p>GET <code>/stubs</code> - returns a list of all running stubs in <code>ivy:integer</code> notation</p>
-</li>
-<li>
-<p>GET <code>/stubs/{ivy}</code> - returns a port for the given <code>ivy</code> notation (when calling the endpoint <code>ivy</code> can also be <code>artifactId</code> only)</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_messaging"><a class="link" href="#_messaging">Messaging</a></h5>
-<div class="paragraph">
-<p>For Messaging</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>GET <code>/triggers</code> - returns a list of all running labels in <code>ivy : [ label1, label2 &#8230;&#8203;]</code> notation</p>
-</li>
-<li>
-<p>POST <code>/triggers/{label}</code> - executes a trigger with <code>label</code></p>
-</li>
-<li>
-<p>POST <code>/triggers/{ivy}/{label}</code> - executes a trigger with <code>label</code> for the given <code>ivy</code> notation (when calling the endpoint <code>ivy</code> can also be <code>artifactId</code> only)</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_example"><a class="link" href="#_example">6.6.3. Example</a></h4>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@ContextConfiguration(classes = StubRunnerBoot, loader = SpringBootContextLoader)
-@SpringBootTest(properties = "spring.cloud.zookeeper.enabled=false")
-@ActiveProfiles("test")
-class StubRunnerBootSpec extends Specification {
-
-	@Autowired
-	StubRunning stubRunning
-
-	def setup() {
-		RestAssuredMockMvc.standaloneSetup(new HttpStubsController(stubRunning),
-				new TriggerController(stubRunning))
-	}
-
-	def 'should return a list of running stub servers in "full ivy:port" notation'() {
-		when:
-			String response = RestAssuredMockMvc.get('/stubs').body.asString()
-		then:
-			def root = new JsonSlurper().parseText(response)
-			root.'org.springframework.cloud.contract.verifier.stubs:bootService:0.0.1-SNAPSHOT:stubs' instanceof Integer
-	}
-
-	def 'should return a port on which a [#stubId] stub is running'() {
-		when:
-			def response = RestAssuredMockMvc.get("/stubs/${stubId}")
-		then:
-			response.statusCode == 200
-			Integer.valueOf(response.body.asString()) &gt; 0
-		where:
-			stubId &lt;&lt; ['org.springframework.cloud.contract.verifier.stubs:bootService:+:stubs',
-					   'org.springframework.cloud.contract.verifier.stubs:bootService:0.0.1-SNAPSHOT:stubs',
-					   'org.springframework.cloud.contract.verifier.stubs:bootService:+',
-					   'org.springframework.cloud.contract.verifier.stubs:bootService',
-					   'bootService']
-	}
-
-	def 'should return 404 when missing stub was called'() {
-		when:
-			def response = RestAssuredMockMvc.get("/stubs/a:b:c:d")
-		then:
-			response.statusCode == 404
-	}
-
-	def 'should return a list of messaging labels that can be triggered when version and classifier are passed'() {
-		when:
-			String response = RestAssuredMockMvc.get('/triggers').body.asString()
-		then:
-			def root = new JsonSlurper().parseText(response)
-			root.'org.springframework.cloud.contract.verifier.stubs:bootService:0.0.1-SNAPSHOT:stubs'?.containsAll(["delete_book", "return_book_1", "return_book_2"])
-	}
-
-	def 'should trigger a messaging label'() {
-		given:
-			StubRunning stubRunning = Mock()
-			RestAssuredMockMvc.standaloneSetup(new HttpStubsController(stubRunning), new TriggerController(stubRunning))
-		when:
-			def response = RestAssuredMockMvc.post("/triggers/delete_book")
-		then:
-			response.statusCode == 200
-		and:
-			1 * stubRunning.trigger('delete_book')
-	}
-
-	def 'should trigger a messaging label for a stub with [#stubId] ivy notation'() {
-		given:
-			StubRunning stubRunning = Mock()
-			RestAssuredMockMvc.standaloneSetup(new HttpStubsController(stubRunning), new TriggerController(stubRunning))
-		when:
-			def response = RestAssuredMockMvc.post("/triggers/$stubId/delete_book")
-		then:
-			response.statusCode == 200
-		and:
-			1 * stubRunning.trigger(stubId, 'delete_book')
-		where:
-			stubId &lt;&lt; ['org.springframework.cloud.contract.verifier.stubs:bootService:stubs', 'org.springframework.cloud.contract.verifier.stubs:bootService', 'bootService']
-	}
-
-	def 'should throw exception when trigger is missing'() {
-		when:
-			RestAssuredMockMvc.post("/triggers/missing_label")
-		then:
-			Exception e = thrown(Exception)
-			e.message.contains("Exception occurred while trying to return [missing_label] label.")
-			e.message.contains("Available labels are")
-			e.message.contains("org.springframework.cloud.contract.verifier.stubs:loanIssuance:0.0.1-SNAPSHOT:stubs=[]")
-			e.message.contains("org.springframework.cloud.contract.verifier.stubs:bootService:0.0.1-SNAPSHOT:stubs=")
-	}
-
-}</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_stub_runner_boot_with_service_discovery"><a class="link" href="#_stub_runner_boot_with_service_discovery">6.6.4. Stub Runner Boot with Service Discovery</a></h4>
-<div class="paragraph">
-<p>One of the possibilities of using Stub Runner Boot is to use it as a feed of stubs for "smoke-tests". What does it mean?
- Let&#8217;s assume that you don&#8217;t want to deploy 50 microservice to a test environment in order
- to check if your application is working fine. You&#8217;ve already executed a suite of tests during the build process
- but you would also like to ensure that the packaging of your application is fine. What you can do
- is to deploy your application to an environment, start it and run a couple of tests on it to see if
- it&#8217;s working fine. We can call those tests smoke-tests since their idea is to check only a handful
- of testing scenarios.</p>
-</div>
-<div class="paragraph">
-<p>The problem with this approach is such that if you&#8217;re doing microservices most likely you&#8217;re
- using a service discovery tool. Stub Runner Boot allows you to solve this issue by starting the
- required stubs and register them in a service discovery tool. Let&#8217;s take a look at an example of
- such a setup with Eureka. Let&#8217;s assume that Eureka was already running.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@SpringBootApplication
-@EnableStubRunnerServer
-@EnableEurekaClient
-@AutoConfigureStubRunner
-public class StubRunnerBootEurekaExample {
-
-	public static void main(String[] args) {
-		SpringApplication.run(StubRunnerBootEurekaExample.class, args);
-	}
-
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>As you can see we want to start a Stub Runner Boot server <code>@EnableStubRunnerServer</code>, enable Eureka client <code>@EnableEurekaClient</code>
-and we want to have the stub runner feature turned on <code>@AutoConfigureStubRunner</code>.</p>
-</div>
-<div class="paragraph">
-<p>Now let&#8217;s assume that we want to start this application so that the stubs get automatically registered.
- We can do it by running the app <code>java -jar ${SYSTEM_PROPS} stub-runner-boot-eureka-example.jar</code> where
- <code>${SYSTEM_PROPS}</code> would contain the following list of properties</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">* -Dstubrunner.repositoryRoot=https://repo.spring.io/snapshot (1)
-* -Dstubrunner.cloud.stubbed.discovery.enabled=false (2)
-* -Dstubrunner.ids=org.springframework.cloud.contract.verifier.stubs:loanIssuance,org.
-* springframework.cloud.contract.verifier.stubs:fraudDetectionServer,org.springframework.
-* cloud.contract.verifier.stubs:bootService (3)
-* -Dstubrunner.idsToServiceIds.fraudDetectionServer=
-* someNameThatShouldMapFraudDetectionServer (4)
-*
-* (1) - we tell Stub Runner where all the stubs reside (2) - we don't want the default
-* behaviour where the discovery service is stubbed. That's why the stub registration will
-* be picked (3) - we provide a list of stubs to download (4) - we provide a list of</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>That way your deployed application can send requests to started WireMock servers via the service
-discovery. Most likely points 1-3 could be set by default in <code>application.yml</code> cause they are not
-likely to change. That way you can provide only the list of stubs to download whenever you start
-the Stub Runner Boot.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_stubs_per_consumer"><a class="link" href="#_stubs_per_consumer">6.7. Stubs Per Consumer</a></h3>
-<div class="paragraph">
-<p>There are cases in which 2 consumers of the same endpoint want to have 2 different responses.</p>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-This approach also allows you to immediately know which consumer is using which part of your API.
-You can remove part of a response that your API produces and you can see which of your autogenerated tests
-fails. If none fails then you can safely delete that part of the response cause nobody is using it.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>Let&#8217;s look at the following example for contract defined for the producer called <code>producer</code>.
-There are 2 consumers: <code>foo-consumer</code> and <code>bar-consumer</code>.</p>
-</div>
-<div class="paragraph">
-<p><strong>Consumer <code>foo-service</code></strong></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">request {
-   url '/foo'
-   method GET()
-}
-response {
-    status OK()
-    body(
-       foo: "foo"
-    }
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>Consumer <code>bar-service</code></strong></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">request {
-   url '/foo'
-   method GET()
-}
-response {
-    status OK()
-    body(
-       bar: "bar"
-    }
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can&#8217;t produce for the same request 2 different responses. That&#8217;s why you can properly package the
-contracts and then profit from the <code>stubsPerConsumer</code> feature.</p>
-</div>
-<div class="paragraph">
-<p>On the producer side the consumers can have a folder that contains contracts related only to them.
-By setting the <code>stubrunner.stubs-per-consumer</code> flag to <code>true</code> we no longer register all stubs but only those that
-correspond to the consumer application&#8217;s name. In other words we&#8217;ll scan the path of every stub and
-if it contains the subfolder with name of the consumer in the path only then will it get registered.</p>
-</div>
-<div class="paragraph">
-<p>On the <code>foo</code> producer side the contracts would look like this</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">.
-└── contracts
-    ├── bar-consumer
-    │   ├── bookReturnedForBar.groovy
-    │   └── shouldCallBar.groovy
-    └── foo-consumer
-        ├── bookReturnedForFoo.groovy
-        └── shouldCallFoo.groovy</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Being the <code>bar-consumer</code> consumer you can either set the <code>spring.application.name</code> or the <code>stubrunner.consumer-name</code> to <code>bar-consumer</code>
-Or set the test as follows:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@ContextConfiguration(classes = Config, loader = SpringBootContextLoader)
-@SpringBootTest(properties = ["spring.application.name=bar-consumer"])
-@AutoConfigureStubRunner(ids = "org.springframework.cloud.contract.verifier.stubs:producerWithMultipleConsumers",
-		repositoryRoot = "classpath:m2repo/repository/",
-		stubsMode = StubRunnerProperties.StubsMode.REMOTE,
-		stubsPerConsumer = true)
-class StubRunnerStubsPerConsumerSpec extends Specification {
-...
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Then only the stubs registered under a path that contains the <code>bar-consumer</code> in its name (i.e. those from the
-<code>src/test/resources/contracts/bar-consumer/some/contracts/&#8230;&#8203;</code> folder) will be allowed to be referenced.</p>
-</div>
-<div class="paragraph">
-<p>Or set the consumer name explicitly</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@ContextConfiguration(classes = Config, loader = SpringBootContextLoader)
-@SpringBootTest
-@AutoConfigureStubRunner(ids = "org.springframework.cloud.contract.verifier.stubs:producerWithMultipleConsumers",
-		repositoryRoot = "classpath:m2repo/repository/",
-		consumerName = "foo-consumer",
-		stubsMode = StubRunnerProperties.StubsMode.REMOTE,
-		stubsPerConsumer = true)
-class StubRunnerStubsPerConsumerWithConsumerNameSpec extends Specification {
-...
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Then only the stubs registered under a path that contains the <code>foo-consumer</code> in its name (i.e. those from the
-<code>src/test/resources/contracts/foo-consumer/some/contracts/&#8230;&#8203;</code> folder) will be allowed to be referenced.</p>
-</div>
-<div class="paragraph">
-<p>You can check out <a href="https://github.com/spring-cloud/spring-cloud-contract/issues/224">issue 224</a> for more
-information about the reasons behind this change.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_common"><a class="link" href="#_common">6.8. Common</a></h3>
-<div class="paragraph">
-<p>This section briefly describes common properties, including:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="#common-properties-junit-spring">Common Properties for JUnit and Spring</a></p>
-</li>
-<li>
-<p><a href="#stub-runner-stub-ids">Stub Runner Stubs IDs</a></p>
-</li>
-</ul>
-</div>
-<div class="sect3">
-<h4 id="common-properties-junit-spring"><a class="link" href="#common-properties-junit-spring">6.8.1. Common Properties for JUnit and Spring</a></h4>
-<div class="paragraph">
-<p>You can set repetitive properties by using system properties or Spring configuration
-properties. Here are their names with their default values:</p>
-</div>
-<table class="tableblock frame-topbot grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Property name</th>
-<th class="tableblock halign-left valign-top">Default value</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.minPort</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">10000</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Minimum value of a port for a started WireMock with stubs.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.maxPort</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">15000</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Maximum value of a port for a started WireMock with stubs.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.repositoryRoot</p></td>
-<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Maven repo URL. If blank, then call the local maven repo.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.classifier</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">stubs</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Default classifier for the stub artifacts.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.stubsMode</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">CLASSPATH</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The way you want to fetch and register the stubs</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.ids</p></td>
-<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Ivy notation stubs to download.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.username</p></td>
-<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional username to access the tool that stores the JARs with
-stubs.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.password</p></td>
-<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Optional password to access the tool that stores the JARs with
-stubs.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.stubsPerConsumer</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Set to <code>true</code> if you want to use different stubs for
-each consumer instead of registering all stubs for every consumer.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.consumerName</p></td>
-<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">If you want to use a stub for each consumer and want to
-override the consumer name just change this value.</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect3">
-<h4 id="stub-runner-stub-ids"><a class="link" href="#stub-runner-stub-ids">6.8.2. Stub Runner Stubs IDs</a></h4>
-<div class="paragraph">
-<p>You can provide the stubs to download via the <code>stubrunner.ids</code> system property. They
-follow this pattern:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">groupId:artifactId:version:classifier:port</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that <code>version</code>, <code>classifier</code> and <code>port</code> are optional.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>If you do not provide the <code>port</code>, a random one will be picked.</p>
-</li>
-<li>
-<p>If you do not provide the <code>classifier</code>, the default is used. (Note that you can
-pass an empty classifier this way: <code>groupId:artifactId:version:</code>).</p>
-</li>
-<li>
-<p>If you do not provide the <code>version</code>, then the <code>+</code> will be passed and the latest one is
-downloaded.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p><code>port</code> means the port of the WireMock server.</p>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-Starting with version 1.0.4, you can provide a range of versions that you
-would like the Stub Runner to take into consideration. You can read more about the
-<a href="https://wiki.eclipse.org/Aether/New_and_Noteworthy#Version_Ranges">Aether versioning
-ranges here</a>.
-</td>
-</tr>
-</table>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="stubrunner-docker"><a class="link" href="#stubrunner-docker">6.9. Stub Runner Docker</a></h3>
-<div class="paragraph">
-<p>We&#8217;re publishing a <code>spring-cloud/spring-cloud-contract-stub-runner</code> Docker image
-that will start the standalone version of Stub Runner.</p>
-</div>
-<div class="paragraph">
-<p>If you want to learn more about the basics of Maven, artifact ids,
-group ids, classifiers and Artifact Managers, just click here <a href="#docker-project">Docker Project</a>.</p>
-</div>
-<div class="sect3">
-<h4 id="_how_to_use_it_2"><a class="link" href="#_how_to_use_it_2">6.9.1. How to use it</a></h4>
-<div class="paragraph">
-<p>Just execute the docker image. You can pass any of the <a href="#common-properties-junit-spring">Common Properties for JUnit and Spring</a>
-as environment variables. The convention is that all the
-letters should be upper case. The camel case notation should
-and the dot (<code>.</code>) should be separated via underscore (<code>_</code>). E.g.
- the <code>stubrunner.repositoryRoot</code> property should be represented
-  as a <code>STUBRUNNER_REPOSITORY_ROOT</code> environment variable.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_example_of_client_side_usage_in_a_non_jvm_project"><a class="link" href="#_example_of_client_side_usage_in_a_non_jvm_project">6.9.2. Example of client side usage in a non JVM project</a></h4>
-<div class="paragraph">
-<p>We&#8217;d like to use the stubs created in this <a href="#docker-server-side">Server side (nodejs)</a> step.
-Let&#8217;s assume that we want to run the stubs on port <code>9876</code>. The NodeJS code
-is available here:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ git clone https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs
-$ cd bookstore</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Let&#8217;s run the Stub Runner Boot application with the stubs.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Provide the Spring Cloud Contract Docker version
-$ SC_CONTRACT_DOCKER_VERSION="..."
-# The IP at which the app is running and Docker container can reach it
-$ APP_IP="192.168.0.100"
-# Spring Cloud Contract Stub Runner properties
-$ STUBRUNNER_PORT="8083"
-# Stub coordinates 'groupId:artifactId:version:classifier:port'
-$ STUBRUNNER_IDS="com.example:bookstore:0.0.1.RELEASE:stubs:9876"
-$ STUBRUNNER_REPOSITORY_ROOT="http://${APP_IP}:8081/artifactory/libs-release-local"
-# Run the docker with Stub Runner Boot
-$ docker run  --rm -e "STUBRUNNER_IDS=${STUBRUNNER_IDS}" -e "STUBRUNNER_REPOSITORY_ROOT=${STUBRUNNER_REPOSITORY_ROOT}" -e "STUBRUNNER_STUBS_MODE=REMOTE" -p "${STUBRUNNER_PORT}:${STUBRUNNER_PORT}" -p "9876:9876" springcloud/spring-cloud-contract-stub-runner:"${SC_CONTRACT_DOCKER_VERSION}"</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>What&#8217;s happening is that</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>a standalone Stub Runner application got started</p>
-</li>
-<li>
-<p>it downloaded the stub with coordinates <code>com.example:bookstore:0.0.1.RELEASE:stubs</code> on port <code>9876</code></p>
-</li>
-<li>
-<p>it got downloaded from Artifactory running at <code><a href="http://192.168.0.100:8081/artifactory/libs-release-local" class="bare">http://192.168.0.100:8081/artifactory/libs-release-local</a></code></p>
-</li>
-<li>
-<p>after a while Stub Runner will be running on port <code>8083</code></p>
-</li>
-<li>
-<p>and the stubs will be running at port <code>9876</code></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>On the server side we built a stateful stub. Let&#8217;s use curl to assert
-that the stubs are setup properly.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># let's execute the first request (no response is returned)
-$ curl -H "Content-Type:application/json" -X POST --data '{ "title" : "Title", "genre" : "Genre", "description" : "Description", "author" : "Author", "publisher" : "Publisher", "pages" : 100, "image_url" : "https://d213dhlpdb53mu.cloudfront.net/assets/pivotal-square-logo-41418bd391196c3022f3cd9f3959b3f6d7764c47873d858583384e759c7db435.svg", "buy_url" : "https://pivotal.io" }' http://localhost:9876/api/books
-# Now time for the second request
-$ curl -X GET http://localhost:9876/api/books
-# You will receive contents of the JSON</code></pre>
-</div>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-If you want use the stubs that you have built locally, on your host,
-then you should pass the environment variable <code>-e STUBRUNNER_STUBS_MODE=LOCAL</code> and mount
-the volume of your local m2 <code>-v "${HOME}/.m2/:/root/.m2:ro"</code>
-</td>
-</tr>
-</table>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="stub-runner-for-messaging"><a class="link" href="#stub-runner-for-messaging">7. Stub Runner for Messaging</a></h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Stub Runner can run the published stubs in memory. It can integrate with the following
-frameworks:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Spring Integration</p>
-</li>
-<li>
-<p>Spring Cloud Stream</p>
-</li>
-<li>
-<p>Apache Camel</p>
-</li>
-<li>
-<p>Spring AMQP</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>It also provides entry points to integrate with any other solution on the market.</p>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-If you have multiple frameworks on the classpath Stub Runner will need to
-define which one should be used. Let&#8217;s assume that you have both AMQP, Spring Cloud Stream and Spring Integration
-on the classpath. Then you need to set <code>stubrunner.stream.enabled=false</code> and <code>stubrunner.integration.enabled=false</code>.
-That way the only remaining framework is Spring AMQP.
-</td>
-</tr>
-</table>
-</div>
-<div class="sect2">
-<h3 id="_stub_triggering"><a class="link" href="#_stub_triggering">7.1. Stub triggering</a></h3>
-<div class="paragraph">
-<p>To trigger a message, use the <code>StubTrigger</code> interface:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package org.springframework.cloud.contract.stubrunner;
-
-import java.util.Collection;
-import java.util.Map;
-
-/**
- * Contract for triggering stub messages.
- *
- * @author Marcin Grzejszczak
- */
-public interface StubTrigger {
-
-	/**
-	 * Triggers an event by a given label for a given {@code groupid:artifactid} notation.
-	 * You can use only {@code artifactId} too.
-	 *
-	 * Feature related to messaging.
-	 * @param ivyNotation ivy notation of a stub
-	 * @param labelName name of the label to trigger
-	 * @return true - if managed to run a trigger
-	 */
-	boolean trigger(String ivyNotation, String labelName);
-
-	/**
-	 * Triggers an event by a given label.
-	 *
-	 * Feature related to messaging.
-	 * @param labelName name of the label to trigger
-	 * @return true - if managed to run a trigger
-	 */
-	boolean trigger(String labelName);
-
-	/**
-	 * Triggers all possible events.
-	 *
-	 * Feature related to messaging.
-	 * @return true - if managed to run a trigger
-	 */
-	boolean trigger();
-
-	/**
-	 * Feature related to messaging.
-	 * @return a mapping of ivy notation of a dependency to all the labels it has.
-	 */
-	Map&lt;String, Collection&lt;String&gt;&gt; labels();
-
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>For convenience, the <code>StubFinder</code> interface extends <code>StubTrigger</code>, so you only need one
-or the other in your tests.</p>
-</div>
-<div class="paragraph">
-<p><code>StubTrigger</code> gives you the following options to trigger a message:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="#trigger-label">Trigger by Label</a></p>
-</li>
-<li>
-<p><a href="#trigger-group-artifact-ids">Trigger by Group and Artifact Ids</a></p>
-</li>
-<li>
-<p><a href="#trigger-artifact-ids">Trigger by Artifact Ids</a></p>
-</li>
-<li>
-<p><a href="#trigger-all-messages">Trigger All Messages</a></p>
-</li>
-</ul>
-</div>
-<div class="sect3">
-<h4 id="trigger-label"><a class="link" href="#trigger-label">7.1.1. Trigger by Label</a></h4>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger('return_book_1')</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="trigger-group-artifact-ids"><a class="link" href="#trigger-group-artifact-ids">7.1.2. Trigger by Group and Artifact Ids</a></h4>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger('org.springframework.cloud.contract.verifier.stubs:streamService', 'return_book_1')</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="trigger-artifact-ids"><a class="link" href="#trigger-artifact-ids">7.1.3. Trigger by Artifact Ids</a></h4>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger('streamService', 'return_book_1')</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="trigger-all-messages"><a class="link" href="#trigger-all-messages">7.1.4. Trigger All Messages</a></h4>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger()</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_stub_runner_camel"><a class="link" href="#_stub_runner_camel">7.2. Stub Runner Camel</a></h3>
-<div class="paragraph">
-<p>Spring Cloud Contract Verifier Stub Runner&#8217;s messaging module gives you an easy way to integrate with Apache Camel.
-For the provided artifacts it will automatically download the stubs and register the required
-routes.</p>
-</div>
-<div class="sect3">
-<h4 id="_adding_it_to_the_project"><a class="link" href="#_adding_it_to_the_project">7.2.1. Adding it to the project</a></h4>
-<div class="paragraph">
-<p>It&#8217;s enough to have both Apache Camel and Spring Cloud Contract Stub Runner on classpath.
-Remember to annotate your test class with <code>@AutoConfigureStubRunner</code>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_disabling_the_functionality"><a class="link" href="#_disabling_the_functionality">7.2.2. Disabling the functionality</a></h4>
-<div class="paragraph">
-<p>If you need to disable this functionality just pass <code>stubrunner.camel.enabled=false</code> property.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_examples"><a class="link" href="#_examples">7.2.3. Examples</a></h4>
-<div class="sect4">
-<h5 id="_stubs_structure"><a class="link" href="#_stubs_structure">Stubs structure</a></h5>
-<div class="paragraph">
-<p>Let us assume that we have the following Maven repository with a deployed stubs for the
-<code>camelService</code> application.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── .m2
-    └── repository
-        └── io
-            └── codearte
-                └── accurest
-                    └── stubs
-                        └── camelService
-                            ├── 0.0.1-SNAPSHOT
-                            │   ├── camelService-0.0.1-SNAPSHOT.pom
-                            │   ├── camelService-0.0.1-SNAPSHOT-stubs.jar
-                            │   └── maven-metadata-local.xml
-                            └── maven-metadata-local.xml</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And the stubs contain the following structure:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">├── META-INF
-│   └── MANIFEST.MF
-└── repository
-    ├── accurest
-    │   ├── bookDeleted.groovy
-    │   ├── bookReturned1.groovy
-    │   └── bookReturned2.groovy
-    └── mappings</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Let&#8217;s consider the following contracts (let' number it with <strong>1</strong>):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
-	label 'return_book_1'
-	input {
-		triggeredBy('bookReturnedTriggered()')
-	}
-	outputMessage {
-		sentTo('jms:output')
-		body('''{ "bookName" : "foo" }''')
-		headers {
-			header('BOOK-NAME', 'foo')
-		}
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>and number <strong>2</strong></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
-	label 'return_book_2'
-	input {
-		messageFrom('jms:input')
-		messageBody([
-				bookName: 'foo'
-		])
-		messageHeaders {
-			header('sample', 'header')
-		}
-	}
-	outputMessage {
-		sentTo('jms:output')
-		body([
-				bookName: 'foo'
-		])
-		headers {
-			header('BOOK-NAME', 'foo')
-		}
-	}
-}</code></pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_scenario_1_no_input_message_2"><a class="link" href="#_scenario_1_no_input_message_2">Scenario 1 (no input message)</a></h5>
-<div class="paragraph">
-<p>So as to trigger a message via the <code>return_book_1</code> label we&#8217;ll use the <code>StubTigger</code> interface as follows</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger('return_book_1')</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Next we&#8217;ll want to listen to the output of the message sent to <code>jms:output</code></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Exchange receivedMessage = consumerTemplate.receive('jms:output', 5000)</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And the received message would pass the following assertions</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">receivedMessage != null
-assertThatBodyContainsBookNameFoo(receivedMessage.in.body)
-receivedMessage.in.headers.get('BOOK-NAME') == 'foo'</code></pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_scenario_2_output_triggered_by_input_2"><a class="link" href="#_scenario_2_output_triggered_by_input_2">Scenario 2 (output triggered by input)</a></h5>
-<div class="paragraph">
-<p>Since the route is set for you it&#8217;s enough to just send a message to the <code>jms:output</code> destination.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">producerTemplate.
-		sendBodyAndHeaders('jms:input', new BookReturned('foo'), [sample: 'header'])</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Next we&#8217;ll want to listen to the output of the message sent to <code>jms:output</code></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Exchange receivedMessage = consumerTemplate.receive('jms:output', 5000)</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And the received message would pass the following assertions</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">receivedMessage != null
-assertThatBodyContainsBookNameFoo(receivedMessage.in.body)
-receivedMessage.in.headers.get('BOOK-NAME') == 'foo'</code></pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_scenario_3_input_with_no_output"><a class="link" href="#_scenario_3_input_with_no_output">Scenario 3 (input with no output)</a></h5>
-<div class="paragraph">
-<p>Since the route is set for you it&#8217;s enough to just send a message to the <code>jms:output</code> destination.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">producerTemplate.
-		sendBodyAndHeaders('jms:delete', new BookReturned('foo'), [sample: 'header'])</code></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_stub_runner_integration"><a class="link" href="#_stub_runner_integration">7.3. Stub Runner Integration</a></h3>
-<div class="paragraph">
-<p>Spring Cloud Contract Verifier Stub Runner&#8217;s messaging module gives you an easy way to
-integrate with Spring Integration. For the provided artifacts, it automatically downloads
-the stubs and registers the required routes.</p>
-</div>
-<div class="sect3">
-<h4 id="_adding_the_runner_to_the_project"><a class="link" href="#_adding_the_runner_to_the_project">7.3.1. Adding the Runner to the Project</a></h4>
-<div class="paragraph">
-<p>You can have both Spring Integration and Spring Cloud Contract Stub Runner on the
-classpath. Remember to annotate your test class with <code>@AutoConfigureStubRunner</code>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_disabling_the_functionality_2"><a class="link" href="#_disabling_the_functionality_2">7.3.2. Disabling the functionality</a></h4>
-<div class="paragraph">
-<p>If you need to disable this functionality, set the
-<code>stubrunner.integration.enabled=false</code> property.</p>
-</div>
-<div class="paragraph">
-<p>Assume that you have the following Maven repository with deployed stubs for the
-<code>integrationService</code> application:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── .m2
-    └── repository
-        └── io
-            └── codearte
-                └── accurest
-                    └── stubs
-                        └── integrationService
-                            ├── 0.0.1-SNAPSHOT
-                            │   ├── integrationService-0.0.1-SNAPSHOT.pom
-                            │   ├── integrationService-0.0.1-SNAPSHOT-stubs.jar
-                            │   └── maven-metadata-local.xml
-                            └── maven-metadata-local.xml</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Further assume the stubs contain the following structure:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">├── META-INF
-│   └── MANIFEST.MF
-└── repository
-    ├── accurest
-    │   ├── bookDeleted.groovy
-    │   ├── bookReturned1.groovy
-    │   └── bookReturned2.groovy
-    └── mappings</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Consider the following contracts (numbered <strong>1</strong>):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
-	label 'return_book_1'
-	input {
-		triggeredBy('bookReturnedTriggered()')
-	}
-	outputMessage {
-		sentTo('output')
-		body('''{ "bookName" : "foo" }''')
-		headers {
-			header('BOOK-NAME', 'foo')
-		}
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Now consider <strong>2</strong>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
-	label 'return_book_2'
-	input {
-		messageFrom('input')
-		messageBody([
-				bookName: 'foo'
-		])
-		messageHeaders {
-			header('sample', 'header')
-		}
-	}
-	outputMessage {
-		sentTo('output')
-		body([
-				bookName: 'foo'
-		])
-		headers {
-			header('BOOK-NAME', 'foo')
-		}
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>and the following Spring Integration Route:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;?xml version="1.0" encoding="UTF-8"?&gt;
-&lt;beans:beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-			 xmlns:beans="http://www.springframework.org/schema/beans"
-			 xmlns="http://www.springframework.org/schema/integration"
-			 xsi:schemaLocation="http://www.springframework.org/schema/beans
-			https://www.springframework.org/schema/beans/spring-beans.xsd
-			http://www.springframework.org/schema/integration
-			http://www.springframework.org/schema/integration/spring-integration.xsd"&gt;
-
-
-	&lt;!-- REQUIRED FOR TESTING --&gt;
-	&lt;bridge input-channel="output"
-			output-channel="outputTest"/&gt;
-
-	&lt;channel id="outputTest"&gt;
-		&lt;queue/&gt;
-	&lt;/channel&gt;
-
-&lt;/beans:beans&gt;</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>These examples lend themselves to three scenarios:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="#integration-scenario-1">Scenario 1 (no input message)</a></p>
-</li>
-<li>
-<p><a href="#integration-scenario-2">Scenario 2 (output triggered by input)</a></p>
-</li>
-<li>
-<p><a href="#integration-scenario-3">Scenario 3 (input with no output)</a></p>
-</li>
-</ul>
-</div>
-<div class="sect4">
-<h5 id="integration-scenario-1"><a class="link" href="#integration-scenario-1">Scenario 1 (no input message)</a></h5>
-<div class="paragraph">
-<p>To trigger a message via the <code>return_book_1</code> label, use the <code>StubTigger</code> interface, as
-follows:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger('return_book_1')</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>To listen to the output of the message sent to <code>output</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Message&lt;?&gt; receivedMessage = messaging.receive('outputTest')</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The received message would pass the following assertions:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">receivedMessage != null
-assertJsons(receivedMessage.payload)
-receivedMessage.headers.get('BOOK-NAME') == 'foo'</code></pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="integration-scenario-2"><a class="link" href="#integration-scenario-2">Scenario 2 (output triggered by input)</a></h5>
-<div class="paragraph">
-<p>Since the route is set for you, you can send a message to the <code>output</code>
-destination:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">messaging.send(new BookReturned('foo'), [sample: 'header'], 'input')</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>To listen to the output of the message sent to <code>output</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Message&lt;?&gt; receivedMessage = messaging.receive('outputTest')</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The received message passes the following assertions:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">receivedMessage != null
-assertJsons(receivedMessage.payload)
-receivedMessage.headers.get('BOOK-NAME') == 'foo'</code></pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="integration-scenario-3"><a class="link" href="#integration-scenario-3">Scenario 3 (input with no output)</a></h5>
-<div class="paragraph">
-<p>Since the route is set for you, you can send a message to the <code>input</code> destination:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">messaging.send(new BookReturned('foo'), [sample: 'header'], 'delete')</code></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_stub_runner_stream"><a class="link" href="#_stub_runner_stream">7.4. Stub Runner Stream</a></h3>
-<div class="paragraph">
-<p>Spring Cloud Contract Verifier Stub Runner&#8217;s messaging module gives you an easy way to
-integrate with Spring Stream. For the provided artifacts, it automatically downloads the
-stubs and registers the required routes.</p>
-</div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
-</td>
-<td class="content">
-If Stub Runner&#8217;s integration with Stream the <code>messageFrom</code> or <code>sentTo</code> Strings
-are resolved first as a <code>destination</code> of a channel and no such <code>destination</code> exists, the
-destination is resolved as a channel name.
-</td>
-</tr>
-</table>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-If you want to use Spring Cloud Stream remember, to add a dependency on
-<code>org.springframework.cloud:spring-cloud-stream-test-support</code>.
-</td>
-</tr>
-</table>
-</div>
-<div class="listingblock primary">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
-    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-    &lt;artifactId&gt;spring-cloud-stream-test-support&lt;/artifactId&gt;
-    &lt;scope&gt;test&lt;/scope&gt;
-&lt;/dependency&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock secondary">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile "org.springframework.cloud:spring-cloud-stream-test-support"</code></pre>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_adding_the_runner_to_the_project_2"><a class="link" href="#_adding_the_runner_to_the_project_2">7.4.1. Adding the Runner to the Project</a></h4>
-<div class="paragraph">
-<p>You can have both Spring Cloud Stream and Spring Cloud Contract Stub Runner on the
-classpath. Remember to annotate your test class with <code>@AutoConfigureStubRunner</code>.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_disabling_the_functionality_3"><a class="link" href="#_disabling_the_functionality_3">7.4.2. Disabling the functionality</a></h4>
-<div class="paragraph">
-<p>If you need to disable this functionality, set the <code>stubrunner.stream.enabled=false</code>
-property.</p>
-</div>
-<div class="paragraph">
-<p>Assume that you have the following Maven repository with a deployed stubs for the
-<code>streamService</code> application:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── .m2
-    └── repository
-        └── io
-            └── codearte
-                └── accurest
-                    └── stubs
-                        └── streamService
-                            ├── 0.0.1-SNAPSHOT
-                            │   ├── streamService-0.0.1-SNAPSHOT.pom
-                            │   ├── streamService-0.0.1-SNAPSHOT-stubs.jar
-                            │   └── maven-metadata-local.xml
-                            └── maven-metadata-local.xml</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Further assume the stubs contain the following structure:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">├── META-INF
-│   └── MANIFEST.MF
-└── repository
-    ├── accurest
-    │   ├── bookDeleted.groovy
-    │   ├── bookReturned1.groovy
-    │   └── bookReturned2.groovy
-    └── mappings</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Consider the following contracts (numbered <strong>1</strong>):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
-	label 'return_book_1'
-	input { triggeredBy('bookReturnedTriggered()') }
-	outputMessage {
-		sentTo('returnBook')
-		body('''{ "bookName" : "foo" }''')
-		headers { header('BOOK-NAME', 'foo') }
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Now consider <strong>2</strong>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
-	label 'return_book_2'
-	input {
-		messageFrom('bookStorage')
-		messageBody([
-				bookName: 'foo'
-		])
-		messageHeaders { header('sample', 'header') }
-	}
-	outputMessage {
-		sentTo('returnBook')
-		body([
-				bookName: 'foo'
-		])
-		headers { header('BOOK-NAME', 'foo') }
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Now consider the following Spring configuration:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">stubrunner.repositoryRoot: classpath:m2repo/repository/
-stubrunner.ids: org.springframework.cloud.contract.verifier.stubs:streamService:0.0.1-SNAPSHOT:stubs
-stubrunner.stubs-mode: remote
-spring:
-  cloud:
-    stream:
-      bindings:
-        output:
-          destination: returnBook
-        input:
-          destination: bookStorage
-
-server:
-  port: 0
-
-debug: true</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>These examples lend themselves to three scenarios:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="#stream-scenario-1">Scenario 1 (no input message)</a></p>
-</li>
-<li>
-<p><a href="#stream-scenario-2">Scenario 2 (output triggered by input)</a></p>
-</li>
-<li>
-<p><a href="#stream-scenario-3">Scenario 3 (input with no output)</a></p>
-</li>
-</ul>
-</div>
-<div class="sect4">
-<h5 id="stream-scenario-1"><a class="link" href="#stream-scenario-1">Scenario 1 (no input message)</a></h5>
-<div class="paragraph">
-<p>To trigger a message via the <code>return_book_1</code> label, use the <code>StubTrigger</code> interface as
-follows:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger('return_book_1')</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>To listen to the output of the message sent to a channel whose <code>destination</code> is
-<code>returnBook</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Message&lt;?&gt; receivedMessage = messaging.receive('returnBook')</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The received message passes the following assertions:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">receivedMessage != null
-assertJsons(receivedMessage.payload)
-receivedMessage.headers.get('BOOK-NAME') == 'foo'</code></pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="stream-scenario-2"><a class="link" href="#stream-scenario-2">Scenario 2 (output triggered by input)</a></h5>
-<div class="paragraph">
-<p>Since the route is set for you, you can send a message to the <code>bookStorage</code>
-<code>destination</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">messaging.send(new BookReturned('foo'), [sample: 'header'], 'bookStorage')</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>To listen to the output of the message sent to <code>returnBook</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Message&lt;?&gt; receivedMessage = messaging.receive('returnBook')</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The received message passes the following assertions:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">receivedMessage != null
-assertJsons(receivedMessage.payload)
-receivedMessage.headers.get('BOOK-NAME') == 'foo'</code></pre>
-</div>
-</div>
-</div>
-<div class="sect4">
-<h5 id="stream-scenario-3"><a class="link" href="#stream-scenario-3">Scenario 3 (input with no output)</a></h5>
-<div class="paragraph">
-<p>Since the route is set for you, you can send a message to the <code>output</code>
-destination:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">messaging.send(new BookReturned('foo'), [sample: 'header'], 'delete')</code></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_stub_runner_spring_amqp"><a class="link" href="#_stub_runner_spring_amqp">7.5. Stub Runner Spring AMQP</a></h3>
-<div class="paragraph">
-<p>Spring Cloud Contract Verifier Stub Runner&#8217;s messaging module provides an easy way to
-integrate with Spring AMQP&#8217;s Rabbit Template. For the provided artifacts, it
-automatically downloads the stubs and registers the required routes.</p>
-</div>
-<div class="paragraph">
-<p>The integration tries to work standalone (that is, without interaction with a running
-RabbitMQ message broker). It expects a <code>RabbitTemplate</code> on the application context and
-uses it as a spring boot test named <code>@SpyBean</code>. As a result, it can use the mockito spy
-functionality to verify and inspect messages sent by the application.</p>
-</div>
-<div class="paragraph">
-<p>On the message consumer side, the stub runner considers all <code>@RabbitListener</code> annotated
-endpoints and all <code>SimpleMessageListenerContainer</code> objects on the application context.</p>
-</div>
-<div class="paragraph">
-<p>As messages are usually sent to exchanges in AMQP, the message contract contains the
-exchange name as the destination. Message listeners on the other side are bound to
-queues. Bindings connect an exchange to a queue. If message contracts are triggered, the
-Spring AMQP stub runner integration looks for bindings on the application context that
-match this exchange. Then it collects the queues from the Spring exchanges and tries to
-find message listeners bound to these queues. The message is triggered for all matching
-message listeners.</p>
-</div>
-<div class="paragraph">
-<p>If you need to work with routing keys, it&#8217;s enough to pass them via the <code>amqp_receivedRoutingKey</code>
-messaging header.</p>
-</div>
-<div class="sect3">
-<h4 id="_adding_the_runner_to_the_project_3"><a class="link" href="#_adding_the_runner_to_the_project_3">7.5.1. Adding the Runner to the Project</a></h4>
-<div class="paragraph">
-<p>You can have both Spring AMQP and Spring Cloud Contract Stub Runner on the classpath and
-set the property <code>stubrunner.amqp.enabled=true</code>. Remember to annotate your test class
-with <code>@AutoConfigureStubRunner</code>.</p>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-If you already have Stream and Integration on the classpath, you need
-to disable them explicitly by setting the  <code>stubrunner.stream.enabled=false</code> and
-<code>stubrunner.integration.enabled=false</code> properties.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>Assume that you have the following Maven repository with a deployed stubs for the
-<code>spring-cloud-contract-amqp-test</code> application.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── .m2
-    └── repository
-        └── com
-            └── example
-                └── spring-cloud-contract-amqp-test
-                    ├── 0.4.0-SNAPSHOT
-                    │   ├── spring-cloud-contract-amqp-test-0.4.0-SNAPSHOT.pom
-                    │   ├── spring-cloud-contract-amqp-test-0.4.0-SNAPSHOT-stubs.jar
-                    │   └── maven-metadata-local.xml
-                    └── maven-metadata-local.xml</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Further assume that the stubs contain the following structure:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">├── META-INF
-│   └── MANIFEST.MF
-└── contracts
-    └── shouldProduceValidPersonData.groovy</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Consider the following contract:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
-	// Human readable description
-	description 'Should produce valid person data'
-	// Label by means of which the output message can be triggered
-	label 'contract-test.person.created.event'
-	// input to the contract
-	input {
-		// the contract will be triggered by a method
-		triggeredBy('createPerson()')
-	}
-	// output message of the contract
-	outputMessage {
-		// destination to which the output message will be sent
-		sentTo 'contract-test.exchange'
-		headers {
-			header('contentType': 'application/json')
-			header('__TypeId__': 'org.springframework.cloud.contract.stubrunner.messaging.amqp.Person')
-		}
-		// the body of the output message
-		body([
-				id  : $(consumer(9), producer(regex("[0-9]+"))),
-				name: "me"
-		])
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Now consider the following Spring configuration:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">stubrunner:
-  repositoryRoot: classpath:m2repo/repository/
-  ids: org.springframework.cloud.contract.verifier.stubs.amqp:spring-cloud-contract-amqp-test:0.4.0-SNAPSHOT:stubs
-  stubs-mode: remote
-  amqp:
-    enabled: true
-server:
-  port: 0</code></pre>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_triggering_the_message"><a class="link" href="#_triggering_the_message">Triggering the message</a></h5>
-<div class="paragraph">
-<p>To trigger a message using the contract above, use the <code>StubTrigger</code> interface as
-follows:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubTrigger.trigger("contract-test.person.created.event")</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The message has a destination of <code>contract-test.exchange</code>, so the Spring AMQP stub runner
-integration looks for bindings related to this exchange.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Bean
-public Binding binding() {
-	return BindingBuilder.bind(new Queue("test.queue"))
-			.to(new DirectExchange("contract-test.exchange")).with("#");
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The binding definition binds the queue <code>test.queue</code>. As a result, the following listener
-definition is matched and invoked with the contract message.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Bean
-public SimpleMessageListenerContainer simpleMessageListenerContainer(
-		ConnectionFactory connectionFactory,
-		MessageListenerAdapter listenerAdapter) {
-	SimpleMessageListenerContainer container = new SimpleMessageListenerContainer();
-	container.setConnectionFactory(connectionFactory);
-	container.setQueueNames("test.queue");
-	container.setMessageListener(listenerAdapter);
-
-	return container;
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Also, the following annotated listener matches and is invoked:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RabbitListener(bindings = @QueueBinding(value = @Queue("test.queue"),
-		exchange = @Exchange(value = "contract-test.exchange",
-				ignoreDeclarationExceptions = "true")))
-public void handlePerson(Person person) {
-	this.person = person;
-}</code></pre>
-</div>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-The message is directly handed over to the <code>onMessage</code> method of the
-<code>MessageListener</code> associated with the matching <code>SimpleMessageListenerContainer</code>.
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect4">
-<h5 id="_spring_amqp_test_configuration"><a class="link" href="#_spring_amqp_test_configuration">Spring AMQP Test Configuration</a></h5>
-<div class="paragraph">
-<p>In order to avoid Spring AMQP trying to connect to a running broker during our tests
-configure a mock <code>ConnectionFactory</code>.</p>
-</div>
-<div class="paragraph">
-<p>To disable the mocked ConnectionFactory, set the following property:
-<code>stubrunner.amqp.mockConnection=false</code></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">stubrunner:
-  amqp:
-    mockConnection: false</code></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="contract-dsl"><a class="link" href="#contract-dsl">8. Contract DSL</a></h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Spring Cloud Contract supports out of the box 2 types of DSL. One written in
-<code>Groovy</code> and one written in <code>YAML</code>.</p>
-</div>
-<div class="paragraph">
-<p>If you decide to write the contract in Groovy, do not be alarmed if you have not used Groovy
-before. Knowledge of the language is not really needed, as the Contract DSL uses only a
-tiny subset of it (only literals, method calls and closures). Also, the DSL is statically
-typed, to make it programmer-readable without any knowledge of the DSL itself.</p>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-Remember that, inside the Groovy contract file, you have to provide the fully
-qualified name to the <code>Contract</code> class and <code>make</code> static imports, such as
-<code>org.springframework.cloud.spec.Contract.make { &#8230;&#8203; }</code>. You can also provide an import to
-the <code>Contract</code> class: <code>import org.springframework.cloud.spec.Contract</code> and then call
-<code>Contract.make { &#8230;&#8203; }</code>.
-</td>
-</tr>
-</table>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-Spring Cloud Contract supports defining multiple contracts in a single file.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>The following is a complete example of a Groovy contract definition:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy"></code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following is a complete example of a YAML contract definition:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">description: Some description
-name: some name
-priority: 8
-ignored: true
-request:
-  url: /foo
-  queryParameters:
-    a: b
-    b: c
-  method: PUT
-  headers:
-    foo: bar
-    fooReq: baz
-  body:
-    foo: bar
-  matchers:
-    body:
-      - path: $.foo
-        type: by_regex
-        value: bar
-    headers:
-      - key: foo
-        regex: bar
-response:
-  status: 200
-  headers:
-    foo2: bar
-    foo3: foo33
-    fooRes: baz
-  body:
-    foo2: bar
-    foo3: baz
-    nullValue: null
-  matchers:
-    body:
-      - path: $.foo2
-        type: by_regex
-        value: bar
-      - path: $.foo3
-        type: by_command
-        value: executeMe($it)
-      - path: $.nullValue
-        type: by_null
-        value: null
-    headers:
-      - key: foo2
-        regex: bar
-      - key: foo3
-        command: andMeToo($it)</code></pre>
-</div>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-You can compile contracts to stubs mapping using standalone maven command:
-<code>mvn org.springframework.cloud:spring-cloud-contract-maven-plugin:convert</code>
-</td>
-</tr>
-</table>
-</div>
-<div class="sect2">
-<h3 id="_limitations"><a class="link" href="#_limitations">8.1. Limitations</a></h3>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
-</td>
-<td class="content">
-Spring Cloud Contract Verifier does not properly support XML. Please use JSON or
-help us implement this feature.
-</td>
-</tr>
-</table>
-</div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
-</td>
-<td class="content">
-The support for verifying the size of JSON arrays is experimental. If you want
-to turn it on, please set the value of the following system property to <code>true</code>:
-<code>spring.cloud.contract.verifier.assert.size</code>. By default, this feature is set to <code>false</code>.
-You can also provide the <code>assertJsonSize</code> property in the plugin configuration.
-</td>
-</tr>
-</table>
-</div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
-</td>
-<td class="content">
-Because JSON structure can have any form, it can be impossible to parse it
-properly when using the Groovy DSL and the <code>value(consumer(&#8230;&#8203;), producer(&#8230;&#8203;))</code> notation in <code>GString</code>. That
-is why you should use the Groovy Map notation.
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_common_top_level_elements"><a class="link" href="#_common_top_level_elements">8.2. Common Top-Level elements</a></h3>
-<div class="paragraph">
-<p>The following sections describe the most common top-level elements:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="#contract-dsl-description">Description</a></p>
-</li>
-<li>
-<p><a href="#contract-dsl-name">Name</a></p>
-</li>
-<li>
-<p><a href="#contract-dsl-ignoring-contracts">Ignoring Contracts</a></p>
-</li>
-<li>
-<p><a href="#contract-dsl-passing-values-from-files">Passing Values from Files</a></p>
-</li>
-<li>
-<p><a href="#contract-dsl-http-top-level-elements">HTTP Top-Level Elements</a></p>
-</li>
-</ul>
-</div>
-<div class="sect3">
-<h4 id="contract-dsl-description"><a class="link" href="#contract-dsl-description">8.2.1. Description</a></h4>
-<div class="paragraph">
-<p>You can add a <code>description</code> to your contract. The description is arbitrary text. The
-following code shows an example:</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">			org.springframework.cloud.contract.spec.Contract.make {
-				description('''
-given:
-	An input
-when:
-	Sth happens
-then:
-	Output
-''')
-			}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">description: Some description
-name: some name
-priority: 8
-ignored: true
-request:
-  url: /foo
-  queryParameters:
-    a: b
-    b: c
-  method: PUT
-  headers:
-    foo: bar
-    fooReq: baz
-  body:
-    foo: bar
-  matchers:
-    body:
-      - path: $.foo
-        type: by_regex
-        value: bar
-    headers:
-      - key: foo
-        regex: bar
-response:
-  status: 200
-  headers:
-    foo2: bar
-    foo3: foo33
-    fooRes: baz
-  body:
-    foo2: bar
-    foo3: baz
-    nullValue: null
-  matchers:
-    body:
-      - path: $.foo2
-        type: by_regex
-        value: bar
-      - path: $.foo3
-        type: by_command
-        value: executeMe($it)
-      - path: $.nullValue
-        type: by_null
-        value: null
-    headers:
-      - key: foo2
-        regex: bar
-      - key: foo3
-        command: andMeToo($it)</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="contract-dsl-name"><a class="link" href="#contract-dsl-name">8.2.2. Name</a></h4>
-<div class="paragraph">
-<p>You can provide a name for your contract. Assume that you provided the following name:
-<code>should register a user</code>. If you do so, the name of the autogenerated test is
-<code>validate_should_register_a_user</code>. Also, the name of the stub in a WireMock stub is
-<code>should_register_a_user.json</code>.</p>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-You must ensure that the name does not contain any characters that make the
-generated test not compile. Also, remember that, if you provide the same name for
-multiple contracts, your autogenerated tests fail to compile and your generated stubs
-override each other.
-</td>
-</tr>
-</table>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
-	name("some_special_name")
-}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">name: some name</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="contract-dsl-ignoring-contracts"><a class="link" href="#contract-dsl-ignoring-contracts">8.2.3. Ignoring Contracts</a></h4>
-<div class="paragraph">
-<p>If you want to ignore a contract, you can either set a value of ignored contracts in the
-plugin configuration or set the <code>ignored</code> property on the contract itself:</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
-	ignored()
-}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">ignored: true</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="contract-dsl-passing-values-from-files"><a class="link" href="#contract-dsl-passing-values-from-files">8.2.4. Passing Values from Files</a></h4>
-<div class="paragraph">
-<p>Starting with version <code>1.2.0</code>, you can pass values from files. Assume that you have the
-following resources in our project.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── src
-    └── test
-        └── resources
-            └── contracts
-                ├── readFromFile.groovy
-                ├── request.json
-                └── response.json</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Further assume that your contract is as follows:</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">/*
- * Copyright 2013-2019 the original author or authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import org.springframework.cloud.contract.spec.Contract
-
-Contract.make {
-	request {
-		method('PUT')
-		headers {
-			contentType(applicationJson())
-		}
-		body(file("request.json"))
-		url("/1")
-	}
-	response {
-		status OK()
-		body(file("response.json"))
-		headers {
-			contentType(applicationJson())
-		}
-	}
-}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request:
-  method: GET
-  url: /foo
-  bodyFromFile: request.json
-response:
-  status: 200
-  bodyFromFile: response.json</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Further assume that the JSON files is as follows:</p>
-</div>
-<div class="paragraph">
-<p><strong>request.json</strong></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
-  "status": "REQUEST"
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>response.json</strong></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
-  "status": "RESPONSE"
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>When test or stub generation takes place, the contents of the file is passed to the body
-of a request or a response. The name of the file needs to be a file with location
-relative to the folder in which the contract lays.</p>
-</div>
-<div class="paragraph">
-<p>If you need to pass the contents of a file in a binary form
-it&#8217;s enough for you to use the <code>fileAsBytes</code> method in Groovy DSL or <code>bodyFromFileAsBytes</code> field in YAML.</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">import org.springframework.cloud.contract.spec.Contract
-
-Contract.make {
-	request {
-		url("/1")
-		method(PUT())
-		headers {
-			contentType(applicationOctetStream())
-		}
-		body(fileAsBytes("request.pdf"))
-	}
-	response {
-		status 200
-		body(fileAsBytes("response.pdf"))
-		headers {
-			contentType(applicationOctetStream())
-		}
-	}
-}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request:
-  url: /1
-  method: PUT
-  headers:
-    Content-Type: application/octet-stream
-  bodyFromFileAsBytes: request.pdf
-response:
-  status: 200
-  bodyFromFileAsBytes: response.pdf
-  headers:
-    Content-Type: application/octet-stream</code></pre>
-</div>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-You should use this approach whenever you want to work with binary payloads both for HTTP and messaging.
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect3">
-<h4 id="contract-dsl-http-top-level-elements"><a class="link" href="#contract-dsl-http-top-level-elements">8.2.5. HTTP Top-Level Elements</a></h4>
-<div class="paragraph">
-<p>The following methods can be called in the top-level closure of a contract definition.
-<code>request</code> and <code>response</code> are mandatory. <code>priority</code> is optional.</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
-	// Definition of HTTP request part of the contract
-	// (this can be a valid request or invalid depending
-	// on type of contract being specified).
-	request {
-		method GET()
-		url "/foo"
-		//...
-	}
-
-	// Definition of HTTP response part of the contract
-	// (a service implementing this contract should respond
-	// with following response after receiving request
-	// specified in "request" part above).
-	response {
-		status 200
-		//...
-	}
-
-	// Contract priority, which can be used for overriding
-	// contracts (1 is highest). Priority is optional.
-	priority 1
-}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">priority: 8
-request:
-...
-response:
-...</code></pre>
-</div>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-If you want to make your contract have a <strong>higher</strong> value of priority
-you need to pass a <strong>lower</strong> number to the <code>priority</code> tag / method. E.g. <code>priority</code> with
-value <code>5</code> has <strong>higher</strong> priority than <code>priority</code> with value <code>10</code>.
-</td>
-</tr>
-</table>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_request"><a class="link" href="#_request">8.3. Request</a></h3>
-<div class="paragraph">
-<p>The HTTP protocol requires only <strong>method and url</strong> to be specified in a request. The
-same information is mandatory in request definition of the Contract.</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
-	request {
-		// HTTP request method (GET/POST/PUT/DELETE).
-		method 'GET'
-
-		// Path component of request URL is specified as follows.
-		urlPath('/users')
-	}
-
-	response {
-		//...
-		status 200
-	}
-}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">method: PUT
-url: /foo</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>It is possible to specify an absolute rather than relative <code>url</code>, but using <code>urlPath</code> is
-the recommended way, as doing so makes the tests <strong>host-independent</strong>.</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
-	request {
-		method 'GET'
-
-		// Specifying `url` and `urlPath` in one contract is illegal.
-		url('http://localhost:8888/users')
-	}
-
-	response {
-		//...
-		status 200
-	}
-}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request:
-  method: PUT
-  urlPath: /foo</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><code>request</code> may contain <strong>query parameters</strong>.</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
-	request {
-		//...
-		method GET()
-
-		urlPath('/users') {
-
-			// Each parameter is specified in form
-			// `'paramName' : paramValue` where parameter value
-			// may be a simple literal or one of matcher functions,
-			// all of which are used in this example.
-			queryParameters {
-
-				// If a simple literal is used as value
-				// default matcher function is used (equalTo)
-				parameter 'limit': 100
-
-				// `equalTo` function simply compares passed value
-				// using identity operator (==).
-				parameter 'filter': equalTo("email")
-
-				// `containing` function matches strings
-				// that contains passed substring.
-				parameter 'gender': value(consumer(containing("[mf]")), producer('mf'))
-
-				// `matching` function tests parameter
-				// against passed regular expression.
-				parameter 'offset': value(consumer(matching("[0-9]+")), producer(123))
-
-				// `notMatching` functions tests if parameter
-				// does not match passed regular expression.
-				parameter 'loginStartsWith': value(consumer(notMatching(".{0,2}")), producer(3))
-			}
-		}
-
-		//...
-	}
-
-	response {
-		//...
-		status 200
-	}
-}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request:
-...
-  queryParameters:
-    a: b
-    b: c
-  headers:
-    foo: bar
-    fooReq: baz
-  cookies:
-    foo: bar
-    fooReq: baz
-  body:
-    foo: bar
-  matchers:
-    body:
-      - path: $.foo
-        type: by_regex
-        value: bar
-    headers:
-      - key: foo
-        regex: bar
-response:
-  status: 200
-  fixedDelayMilliseconds: 1000
-  headers:
-    foo2: bar
-    foo3: foo33
-    fooRes: baz
-  body:
-    foo2: bar
-    foo3: baz
-    nullValue: null
-  matchers:
-    body:
-      - path: $.foo2
-        type: by_regex
-        value: bar
-      - path: $.foo3
-        type: by_command
-        value: executeMe($it)
-      - path: $.nullValue
-        type: by_null
-        value: null
-    headers:
-      - key: foo2
-        regex: bar
-      - key: foo3
-        command: andMeToo($it)
-    cookies:
-      - key: foo2
-        regex: bar
-      - key: foo3
-        predefined:</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><code>request</code> may contain additional <strong>request headers</strong>, as shown in the following example:</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
-	request {
-		//...
-		method GET()
-		url "/foo"
-
-		// Each header is added in form `'Header-Name' : 'Header-Value'`.
-		// there are also some helper methods
-		headers {
-			header 'key': 'value'
-			contentType(applicationJson())
-		}
-
-		//...
-	}
-
-	response {
-		//...
-		status 200
-	}
-}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request:
-...
-headers:
-  foo: bar
-  fooReq: baz</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><code>request</code> may contain additional <strong>request cookies</strong>, as shown in the following example:</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
-	request {
-		//...
-		method GET()
-		url "/foo"
-
-		// Each Cookies is added in form `'Cookie-Key' : 'Cookie-Value'`.
-		// there are also some helper methods
-		cookies {
-			cookie 'key': 'value'
-			cookie('another_key', 'another_value')
-		}
-
-		//...
-	}
-
-	response {
-		//...
-		status 200
-	}
-}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request:
-...
-cookies:
-  foo: bar
-  fooReq: baz</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><code>request</code> may contain a <strong>request body</strong>:</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
-	request {
-		//...
-		method GET()
-		url "/foo"
-
-		// Currently only JSON format of request body is supported.
-		// Format will be determined from a header or body's content.
-		body '''{ "login" : "john", "name": "John The Contract" }'''
-	}
-
-	response {
-		//...
-		status 200
-	}
-}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request:
-...
-body:
-  foo: bar</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><code>request</code> may contain <strong>multipart</strong> elements. To include multipart elements, use the
-<code>multipart</code> method/section, as shown in the following examples</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy"></code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request:
-  method: PUT
-  url: /multipart
-  headers:
-    Content-Type: multipart/form-data;boundary=AaB03x
-  multipart:
-    params:
-      # key (parameter name), value (parameter value) pair
-      formParameter: '"formParameterValue"'
-      someBooleanParameter: true
-    named:
-      - paramName: file
-        fileName: filename.csv
-        fileContent: file content
-  matchers:
-    multipart:
-      params:
-        - key: formParameter
-          regex: ".+"
-        - key: someBooleanParameter
-          predefined: any_boolean
-      named:
-        - paramName: file
-          fileName:
-            predefined: non_empty
-          fileContent:
-            predefined: non_empty
-response:
-  status: 200</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In the preceding example, we define parameters in either of two ways:</p>
-</div>
-<div class="ulist">
-<div class="title">Groovy DSL</div>
-<ul>
-<li>
-<p>Directly, by using the map notation, where the value can be a dynamic property (such as
-<code>formParameter: $(consumer(&#8230;&#8203;), producer(&#8230;&#8203;))</code>).</p>
-</li>
-<li>
-<p>By using the <code>named(&#8230;&#8203;)</code> method that lets you set a named parameter. A named parameter
-can set a <code>name</code> and <code>content</code>. You can call it either via a method with two  arguments,
-such as <code>named("fileName", "fileContent")</code>, or via a map notation, such as
-<code>named(name: "fileName", content: "fileContent")</code>.</p>
-</li>
-</ul>
-</div>
-<div class="ulist">
-<div class="title">YAML</div>
-<ul>
-<li>
-<p>The multipart parameters are set via <code>multipart.params</code> section</p>
-</li>
-<li>
-<p>The named parameters (the <code>fileName</code> and <code>fileContent</code> for a given parameter name)
-can be set via the <code>multipart.named</code> section. That section contains
-the <code>paramName</code> (name of the parameter), <code>fileName</code> (name of the file),
-<code>fileContent</code> (content of the file) fields</p>
-</li>
-<li>
-<p>The dynamic bits can be set via the <code>matchers.multipart</code> section</p>
-<div class="ulist">
-<ul>
-<li>
-<p>for parameters use the <code>params</code> section that can accept
-<code>regex</code> or a <code>predefined</code> regular expression</p>
-</li>
-<li>
-<p>for named params use the <code>named</code> section where first you
-define the parameter name via <code>paramName</code> and then you can pass the
-parametrization of either <code>fileName</code> or <code>fileContent</code> via
-<code>regex</code> or a <code>predefined</code> regular expression</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>From this contract, the generated test is as follows:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">// given:
- MockMvcRequestSpecification request = given()
-   .header("Content-Type", "multipart/form-data;boundary=AaB03x")
-   .param("formParameter", "\"formParameterValue\"")
-   .param("someBooleanParameter", "true")
-   .multiPart("file", "filename.csv", "file content".getBytes());
-
-// when:
- ResponseOptions response = given().spec(request)
-   .put("/multipart");
-
-// then:
- assertThat(response.statusCode()).isEqualTo(200);</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The WireMock stub is as follows:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">			'''
-{
-  "request" : {
-	"url" : "/multipart",
-	"method" : "PUT",
-	"headers" : {
-	  "Content-Type" : {
-		"matches" : "multipart/form-data;boundary=AaB03x.*"
-	  }
-	},
-	"bodyPatterns" : [ {
-		"matches" : ".*--(.*)\\r\\nContent-Disposition: form-data; name=\\"formParameter\\"\\r\\n(Content-Type: .*\\r\\n)?(Content-Transfer-Encoding: .*\\r\\n)?(Content-Length: \\\\d+\\r\\n)?\\r\\n\\".+\\"\\r\\n--\\\\1.*"
-  		}, {
-    			"matches" : ".*--(.*)\\r\\nContent-Disposition: form-data; name=\\"someBooleanParameter\\"\\r\\n(Content-Type: .*\\r\\n)?(Content-Transfer-Encoding: .*\\r\\n)?(Content-Length: \\\\d+\\r\\n)?\\r\\n(true|false)\\r\\n--\\\\1.*"
-  		}, {
-	  "matches" : ".*--(.*)\\r\\nContent-Disposition: form-data; name=\\"file\\"; filename=\\"[\\\\S\\\\s]+\\"\\r\\n(Content-Type: .*\\r\\n)?(Content-Transfer-Encoding: .*\\r\\n)?(Content-Length: \\\\d+\\r\\n)?\\r\\n[\\\\S\\\\s]+\\r\\n--\\\\1.*"
-	} ]
-  },
-  "response" : {
-	"status" : 200,
-	"transformers" : [ "response-template", "foo-transformer" ]
-  }
-}
-	'''</code></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_response"><a class="link" href="#_response">8.4. Response</a></h3>
-<div class="paragraph">
-<p>The response must contain an <strong>HTTP status code</strong> and may contain other information. The
-following code shows an example:</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
-	request {
-		//...
-		method GET()
-		url "/foo"
-	}
-	response {
-		// Status code sent by the server
-		// in response to request specified above.
-		status OK()
-	}
-}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">response:
-...
-status: 200</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Besides status, the response may contain <strong>headers</strong>, <strong>cookies</strong> and a <strong>body</strong>, both of which are
-specified the same way as in the request (see the previous paragraph).</p>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-Via the Groovy DSL you can reference the <code>org.springframework.cloud.contract.spec.internal.HttpStatus</code>
-methods to provide a meaningful status instead of a digit. E.g. you can call
-<code>OK()</code> for a status <code>200</code> or <code>BAD_REQUEST()</code> for <code>400</code>.
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_dynamic_properties"><a class="link" href="#_dynamic_properties">8.5. Dynamic properties</a></h3>
-<div class="paragraph">
-<p>The contract can contain some dynamic properties: timestamps, IDs, and so on. You do not
-want to force the consumers to stub their clocks to always return the same value of time
-so that it gets matched by the stub.</p>
-</div>
-<div class="paragraph">
-<p>For Groovy DSL you can provide the dynamic parts in your contracts
-in two ways: pass them directly in the body or set them in a separate section called
-<code>bodyMatchers</code>.</p>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-Before 2.0.0 these were set using <code>testMatchers</code> and <code>stubMatchers</code>,
-check out the <a href="https://github.com/spring-cloud/spring-cloud-contract/wiki/Spring-Cloud-Contract-2.0-Migration-Guide">migration guide</a> for more information.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>For YAML you can only use the <code>matchers</code> section.</p>
-</div>
-<div class="sect3">
-<h4 id="_dynamic_properties_inside_the_body"><a class="link" href="#_dynamic_properties_inside_the_body">8.5.1. Dynamic properties inside the body</a></h4>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-This section is valid only for Groovy DSL. Check out the
-<a href="#contract-matchers">Dynamic Properties in the Matchers Sections</a> section for YAML examples of a similar feature.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>You can set the properties inside the body either with the <code>value</code> method or, if you use
-the Groovy map notation, with <code>$()</code>. The following example shows how to set dynamic
-properties with the value method:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">value(consumer(...), producer(...))
-value(c(...), p(...))
-value(stub(...), test(...))
-value(client(...), server(...))</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following example shows how to set dynamic properties with <code>$()</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">$(consumer(...), producer(...))
-$(c(...), p(...))
-$(stub(...), test(...))
-$(client(...), server(...))</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Both approaches work equally well. <code>stub</code> and <code>client</code> methods are aliases over the <code>consumer</code>
-method. Subsequent sections take a closer look at what you can do with those values.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_regular_expressions"><a class="link" href="#_regular_expressions">8.5.2. Regular expressions</a></h4>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-This section is valid only for Groovy DSL. Check out the
-<a href="#contract-matchers">Dynamic Properties in the Matchers Sections</a> section for YAML examples of a similar feature.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>You can use regular expressions to write your requests in Contract DSL. Doing so is
-particularly useful when you want to indicate that a given response should be provided
-for requests that follow a given pattern. Also, you can use regular expressions when you
-need to use patterns and not exact values both for your test and your server side tests.</p>
-</div>
-<div class="paragraph">
-<p>Make sure that regex matches a whole region of a sequence as internally a call to
-<a href="https://docs.oracle.com/javase/8/docs/api/java/util/regex/Matcher.html#matches--">Pattern.matches()</a>
-is called. For instance, <code>abc</code> pattern doesn&#8217;t match <code>aabc</code> string but <code>.abc</code> does.
-There are several additional <a href="#regex-limitations">known limitations</a> as well.</p>
-</div>
-<div class="paragraph">
-<p>The following example shows how to use regular expressions to write a request:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
-	request {
-		method('GET')
-		url $(consumer(~/\/[0-9]{2}/), producer('/12'))
-	}
-	response {
-		status OK()
-		body(
-				id: $(anyNumber()),
-				surname: $(
-						consumer('Kowalsky'),
-						producer(regex('[a-zA-Z]+'))
-				),
-				name: 'Jan',
-				created: $(consumer('2014-02-02 12:23:43'), producer(execute('currentDate(it)'))),
-				correlationId: value(consumer('5d1f9fef-e0dc-4f3d-a7e4-72d2220dd827'),
-						producer(regex('[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}'))
-				)
-		)
-		headers {
-			header 'Content-Type': 'text/plain'
-		}
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can also provide only one side of the communication with a regular expression. If you
-do so, then the contract engine automatically provides the generated string that matches
-the provided regular expression. The following code shows an example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
-	request {
-		method 'PUT'
-		url value(consumer(regex('/foo/[0-9]{5}')))
-		body([
-				requestElement: $(consumer(regex('[0-9]{5}')))
-		])
-		headers {
-			header('header', $(consumer(regex('application\\/vnd\\.fraud\\.v1\\+json;.*'))))
-		}
-	}
-	response {
-		status OK()
-		body([
-				responseElement: $(producer(regex('[0-9]{7}')))
-		])
-		headers {
-			contentType("application/vnd.fraud.v1+json")
-		}
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In the preceding example, the opposite side of the communication has the respective data
-generated for request and response.</p>
-</div>
-<div class="paragraph">
-<p>Spring Cloud Contract comes with a series of predefined regular expressions that you can
-use in your contracts, as shown in the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">protected static final Pattern TRUE_OR_FALSE = Pattern.compile("(true|false)");
-
-protected static final Pattern ALPHA_NUMERIC = Pattern.compile("[a-zA-Z0-9]+");
-
-protected static final Pattern ONLY_ALPHA_UNICODE = Pattern.compile("[\\p{L}]*");
-
-protected static final Pattern NUMBER = Pattern.compile("-?(\\d*\\.\\d+|\\d+)");
-
-protected static final Pattern INTEGER = Pattern.compile("-?(\\d+)");
-
-protected static final Pattern POSITIVE_INT = Pattern.compile("([1-9]\\d*)");
-
-protected static final Pattern DOUBLE = Pattern.compile("-?(\\d*\\.\\d+)");
-
-protected static final Pattern HEX = Pattern.compile("[a-fA-F0-9]+");
-
-protected static final Pattern IP_ADDRESS = Pattern.compile(
-		"([01]?\\d\\d?|2[0-4]\\d|25[0-5])\\.([01]?\\d\\d?|2[0-4]\\d|25[0-5])\\.([01]?\\d\\d?|2[0-4]\\d|25[0-5])\\.([01]?\\d\\d?|2[0-4]\\d|25[0-5])");
-
-protected static final Pattern HOSTNAME_PATTERN = Pattern
-		.compile("((http[s]?|ftp):/)/?([^:/\\s]+)(:[0-9]{1,5})?");
-
-protected static final Pattern EMAIL = Pattern
-		.compile("[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,6}");
-
-protected static final Pattern URL = UrlHelper.URL;
-
-protected static final Pattern HTTPS_URL = UrlHelper.HTTPS_URL;
-
-protected static final Pattern UUID = Pattern
-		.compile("[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}");
-
-protected static final Pattern ANY_DATE = Pattern
-		.compile("(\\d\\d\\d\\d)-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])");
-
-protected static final Pattern ANY_DATE_TIME = Pattern.compile(
-		"([0-9]{4})-(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9])T(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])");
-
-protected static final Pattern ANY_TIME = Pattern
-		.compile("(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])");
-
-protected static final Pattern NON_EMPTY = Pattern.compile("[\\S\\s]+");
-
-protected static final Pattern NON_BLANK = Pattern.compile("^\\s*\\S[\\S\\s]*");
-
-protected static final Pattern ISO8601_WITH_OFFSET = Pattern.compile(
-		"([0-9]{4})-(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9])T(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])(\\.\\d{3})?(Z|[+-][01]\\d:[0-5]\\d)");
-
-protected static Pattern anyOf(String... values) {
-	return Pattern.compile(Arrays.stream(values).map(it -&gt; '^' + it + '$')
-			.collect(Collectors.joining("|")));
-}
-
-public static String multipartParam(Object name, Object value) {
-	return ".*--(.*)\r\nContent-Disposition: form-data; name=\"" + name
-			+ "\"\r\n(Content-Type: .*\r\n)?(Content-Transfer-Encoding: .*\r\n)?(Content-Length: \\d+\r\n)?\r\n"
-			+ value + "\r\n--\\1.*";
-}
-
-public static String multipartFile(Object name, Object filename, Object content,
-		Object contentType) {
-	return ".*--(.*)\r\nContent-Disposition: form-data; name=\"" + name
-			+ "\"; filename=\"" + filename + "\"\r\n(Content-Type: "
-			+ toContentType(contentType)
-			+ "\r\n)?(Content-Transfer-Encoding: .*\r\n)?(Content-Length: \\d+\r\n)?\r\n"
-			+ content + "\r\n--\\1.*";
-}
-
-private static String toContentType(Object contentType) {
-	if (contentType == null) {
-		return ".*";
-	}
-	if (contentType instanceof RegexProperty) {
-		return ((RegexProperty) contentType).pattern();
-	}
-	return contentType.toString();
-}
-
-public RegexProperty onlyAlphaUnicode() {
-	return new RegexProperty(ONLY_ALPHA_UNICODE).asString();
-}
-
-public RegexProperty alphaNumeric() {
-	return new RegexProperty(ALPHA_NUMERIC).asString();
-}
-
-public RegexProperty number() {
-	return new RegexProperty(NUMBER).asDouble();
-}
-
-public RegexProperty positiveInt() {
-	return new RegexProperty(POSITIVE_INT).asInteger();
-}
-
-public RegexProperty anyBoolean() {
-	return new RegexProperty(TRUE_OR_FALSE).asBooleanType();
-}
-
-public RegexProperty anInteger() {
-	return new RegexProperty(INTEGER).asInteger();
-}
-
-public RegexProperty aDouble() {
-	return new RegexProperty(DOUBLE).asDouble();
-}
-
-public RegexProperty ipAddress() {
-	return new RegexProperty(IP_ADDRESS).asString();
-}
-
-public RegexProperty hostname() {
-	return new RegexProperty(HOSTNAME_PATTERN).asString();
-}
-
-public RegexProperty email() {
-	return new RegexProperty(EMAIL).asString();
-}
-
-public RegexProperty url() {
-	return new RegexProperty(URL).asString();
-}
-
-public RegexProperty httpsUrl() {
-	return new RegexProperty(HTTPS_URL).asString();
-}
-
-public RegexProperty uuid() {
-	return new RegexProperty(UUID).asString();
-}
-
-public RegexProperty isoDate() {
-	return new RegexProperty(ANY_DATE).asString();
-}
-
-public RegexProperty isoDateTime() {
-	return new RegexProperty(ANY_DATE_TIME).asString();
-}
-
-public RegexProperty isoTime() {
-	return new RegexProperty(ANY_TIME).asString();
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In your contract, you can use it as shown in the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract dslWithOptionalsInString = Contract.make {
-	priority 1
-	request {
-		method POST()
-		url '/users/password'
-		headers {
-			contentType(applicationJson())
-		}
-		body(
-				email: $(consumer(optional(regex(email()))), producer('abc@abc.com')),
-				callback_url: $(consumer(regex(hostname())), producer('http://partners.com'))
-		)
-	}
-	response {
-		status 404
-		headers {
-			contentType(applicationJson())
-		}
-		body(
-				code: value(consumer("123123"), producer(optional("123123"))),
-				message: "User not found by email = [${value(producer(regex(email())), consumer('not.existing@user.com'))}]"
-		)
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>To make matters even simpler you can use a set of predefined objects that will automatically assume that you want a regular expression to be passed.
-All of those methods start with <code>any</code> prefix:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java"></code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>and this is an example of how you can reference those methods:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract contractDsl = Contract.make {
-	name "foo"
-	label 'trigger_event'
-	input {
-		triggeredBy('toString()')
-	}
-	outputMessage {
-		sentTo 'topic.rateablequote'
-		body([
-				alpha            : $(anyAlphaUnicode()),
-				number           : $(anyNumber()),
-				anInteger        : $(anyInteger()),
-				positiveInt      : $(anyPositiveInt()),
-				aDouble          : $(anyDouble()),
-				aBoolean         : $(aBoolean()),
-				ip               : $(anyIpAddress()),
-				hostname         : $(anyHostname()),
-				email            : $(anyEmail()),
-				url              : $(anyUrl()),
-				httpsUrl         : $(anyHttpsUrl()),
-				uuid             : $(anyUuid()),
-				date             : $(anyDate()),
-				dateTime         : $(anyDateTime()),
-				time             : $(anyTime()),
-				iso8601WithOffset: $(anyIso8601WithOffset()),
-				nonBlankString   : $(anyNonBlankString()),
-				nonEmptyString   : $(anyNonEmptyString()),
-				anyOf            : $(anyOf('foo', 'bar'))
-		])
-	}
-}</code></pre>
-</div>
-</div>
-<div class="sect4">
-<h5 id="regex-limitations"><a class="link" href="#regex-limitations">Limitations</a></h5>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
-</td>
-<td class="content">
-Due to certain limitations of <code>Xeger</code> library that generates string out of
-regex, do not use <code>$</code> and <code>^</code> signs in your regex if you rely on automatic
-generation. <a href="https://github.com/spring-cloud/spring-cloud-contract/issues/899">Issue 899</a>
-</td>
-</tr>
-</table>
-</div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
-</td>
-<td class="content">
-Do not use <code>LocalDate</code> instance as a value for <code>$</code> like this <code>$(consumer(LocalDate.now()))</code>.
-It causes <code>java.lang.StackOverflowError</code>. Use <code>$(consumer(LocalDate.now().toString()))</code> instead.
-<a href="https://github.com/spring-cloud/spring-cloud-contract/issues/900">Issue 900</a>
-</td>
-</tr>
-</table>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_passing_optional_parameters"><a class="link" href="#_passing_optional_parameters">8.5.3. Passing Optional Parameters</a></h4>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-This section is valid only for Groovy DSL. Check out the
-<a href="#contract-matchers">Dynamic Properties in the Matchers Sections</a> section for YAML examples of a similar feature.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>It is possible to provide optional parameters in your contract. However, you can provide
-optional parameters only for the following:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><em>STUB</em> side of the Request</p>
-</li>
-<li>
-<p><em>TEST</em> side of the Response</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The following example shows how to provide optional parameters:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
-	priority 1
-	name "optionals"
-	request {
-		method 'POST'
-		url '/users/password'
-		headers {
-			contentType(applicationJson())
-		}
-		body(
-				email: $(consumer(optional(regex(email()))), producer('abc@abc.com')),
-				callback_url: $(consumer(regex(hostname())), producer('https://partners.com'))
-		)
-	}
-	response {
-		status 404
-		headers {
-			header 'Content-Type': 'application/json'
-		}
-		body(
-				code: value(consumer("123123"), producer(optional("123123")))
-		)
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>By wrapping a part of the body with the <code>optional()</code> method, you create a regular
-expression that must be present 0 or more times.</p>
-</div>
-<div class="paragraph">
-<p>If you use Spock for, the following test would be generated from the previous example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">					"""\
-package com.example
-
-import com.jayway.jsonpath.DocumentContext
-import com.jayway.jsonpath.JsonPath
-import spock.lang.Specification
-import io.restassured.module.mockmvc.specification.MockMvcRequestSpecification
-import io.restassured.response.ResponseOptions
-
-import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat
-import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*
-import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson
-import static io.restassured.module.mockmvc.RestAssuredMockMvc.*
-
-@SuppressWarnings("rawtypes")
-class FooSpec extends Specification {
-
-\tdef validate_optionals() throws Exception {
-\t\tgiven:
-\t\t\tMockMvcRequestSpecification request = given()
-\t\t\t\t\t.header("Content-Type", "application/json")
-\t\t\t\t\t.body('''{"email":"abc@abc.com","callback_url":"https://partners.com"}''')
-
-\t\twhen:
-\t\t\tResponseOptions response = given().spec(request)
-\t\t\t\t\t.post("/users/password")
-
-\t\tthen:
-\t\t\tresponse.statusCode() == 404
-\t\t\tresponse.header("Content-Type") == 'application/json'
-
-\t\tand:
-\t\t\tDocumentContext parsedJson = JsonPath.parse(response.body.asString())
-\t\t\tassertThatJson(parsedJson).field("['code']").matches("(123123)?")
-\t}
-
-}
-"""</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following stub would also be generated:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">					'''
-{
-  "request" : {
-	"url" : "/users/password",
-	"method" : "POST",
-	"bodyPatterns" : [ {
-	  "matchesJsonPath" : "$[?(@.['email'] =~ /([a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\\\.[a-zA-Z]{2,6})?/)]"
-	}, {
-	  "matchesJsonPath" : "$[?(@.['callback_url'] =~ /((http[s]?|ftp):\\\\/)\\\\/?([^:\\\\/\\\\s]+)(:[0-9]{1,5})?/)]"
-	} ],
-	"headers" : {
-	  "Content-Type" : {
-		"equalTo" : "application/json"
-	  }
-	}
-  },
-  "response" : {
-	"status" : 404,
-	"body" : "{\\"code\\":\\"123123\\",\\"message\\":\\"User not found by email == [not.existing@user.com]\\"}",
-	"headers" : {
-	  "Content-Type" : "application/json"
-	}
-  },
-  "priority" : 1
-}
-'''</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_executing_custom_methods_on_the_server_side"><a class="link" href="#_executing_custom_methods_on_the_server_side">8.5.4. Executing Custom Methods on the Server Side</a></h4>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-This section is valid only for Groovy DSL. Check out the
-<a href="#contract-matchers">Dynamic Properties in the Matchers Sections</a> section for YAML examples of a similar feature.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>You can define a method call that executes on the server side during the test. Such a
-method can be added to the class defined as "baseClassForTests" in the configuration. The
-following code shows an example of the contract portion of the test case:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy"></code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following code shows the base class portion of the test case:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">abstract class BaseMockMvcSpec extends Specification {
-
-	def setup() {
-		RestAssuredMockMvc.standaloneSetup(new PairIdController())
-	}
-
-	void isProperCorrelationId(Integer correlationId) {
-		assert correlationId == 123456
-	}
-
-	void isEmpty(String value) {
-		assert value == null
-	}
-
-}</code></pre>
-</div>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-You cannot use both a String and <code>execute</code> to perform concatenation. For
-example, calling <code>header('Authorization', 'Bearer ' + execute('authToken()'))</code> leads to
-improper results. Instead, call <code>header('Authorization', execute('authToken()'))</code> and
-ensure that the <code>authToken()</code> method returns everything you need.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>The type of the object read from the JSON can be one of the following, depending on the
-JSON path:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>String</code>: If you point to a <code>String</code> value in the JSON.</p>
-</li>
-<li>
-<p><code>JSONArray</code>: If you point to a <code>List</code> in the JSON.</p>
-</li>
-<li>
-<p><code>Map</code>: If you point to a <code>Map</code> in the JSON.</p>
-</li>
-<li>
-<p><code>Number</code>: If you point to <code>Integer</code>, <code>Double</code> etc. in the JSON.</p>
-</li>
-<li>
-<p><code>Boolean</code>: If you point to a <code>Boolean</code> in the JSON.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>In the request part of the contract, you can specify that the <code>body</code> should be taken from
-a method.</p>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-You must provide both the consumer and the producer side. The <code>execute</code> part
-is applied for the whole body - not for parts of it.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>The following example shows how to read an object from JSON:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract contractDsl = Contract.make {
-	request {
-		method 'GET'
-		url '/something'
-		body(
-				$(c('foo'), p(execute('hashCode()')))
-		)
-	}
-	response {
-		status OK()
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The preceding example results in calling the <code>hashCode()</code> method in the request body.
-It should resemble the following code:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">// given:
- MockMvcRequestSpecification request = given()
-   .body(hashCode());
-
-// when:
- ResponseOptions response = given().spec(request)
-   .get("/something");
-
-// then:
- assertThat(response.statusCode()).isEqualTo(200);</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_referencing_the_request_from_the_response"><a class="link" href="#_referencing_the_request_from_the_response">8.5.5. Referencing the Request from the Response</a></h4>
-<div class="paragraph">
-<p>The best situation is to provide fixed values, but sometimes you need to reference a
-request in your response.</p>
-</div>
-<div class="paragraph">
-<p>If you&#8217;re writing contracts using Groovy DSL, you can use the <code>fromRequest()</code> method, which lets
-you reference a bunch of elements from the HTTP request. You can use the following
-options:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>fromRequest().url()</code>: Returns the request URL and query parameters.</p>
-</li>
-<li>
-<p><code>fromRequest().query(String key)</code>: Returns the first query parameter with a given name.</p>
-</li>
-<li>
-<p><code>fromRequest().query(String key, int index)</code>: Returns the nth query parameter with a
-given name.</p>
-</li>
-<li>
-<p><code>fromRequest().path()</code>: Returns the full path.</p>
-</li>
-<li>
-<p><code>fromRequest().path(int index)</code>: Returns the nth path element.</p>
-</li>
-<li>
-<p><code>fromRequest().header(String key)</code>: Returns the first header with a given name.</p>
-</li>
-<li>
-<p><code>fromRequest().header(String key, int index)</code>: Returns the nth header with a given name.</p>
-</li>
-<li>
-<p><code>fromRequest().body()</code>: Returns the full request body.</p>
-</li>
-<li>
-<p><code>fromRequest().body(String jsonPath)</code>: Returns the element from the request that
-matches the JSON Path.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>If you&#8217;re using the YAML contract definition you have to use the
-<a href="https://handlebarsjs.com/">Handlebars</a> <code>{{{ }}}</code> notation with custom, Spring Cloud Contract
- functions to achieve this.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>{{{ request.url }}}</code>: Returns the request URL and query parameters.</p>
-</li>
-<li>
-<p><code>{{{ request.query.key.[index] }}}</code>: Returns the nth query parameter with a given name.
-E.g. for key <code>foo</code>, first entry <code>{{{ request.query.foo.[0] }}}</code></p>
-</li>
-<li>
-<p><code>{{{ request.path }}}</code>: Returns the full path.</p>
-</li>
-<li>
-<p><code>{{{ request.path.[index] }}}</code>: Returns the nth path element. E.g.
-for first entry <code>`</code>{{{ request.path.[0] }}}</p>
-</li>
-<li>
-<p><code>{{{ request.headers.key }}}</code>: Returns the first header with a given name.</p>
-</li>
-<li>
-<p><code>{{{ request.headers.key.[index] }}}</code>: Returns the nth header with a given name.</p>
-</li>
-<li>
-<p><code>{{{ request.body }}}</code>: Returns the full request body.</p>
-</li>
-<li>
-<p><code>{{{ jsonpath this 'your.json.path' }}}</code>: Returns the element from the request that
-matches the JSON Path. E.g. for json path <code>$.foo</code> - <code>{{{ jsonpath this '$.foo' }}}</code></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Consider the following contract:</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy"></code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request:
-  method: GET
-  url: /api/v1/xxxx
-  queryParameters:
-    foo:
-      - bar
-      - bar2
-  headers:
-    Authorization:
-      - secret
-      - secret2
-  body:
-    foo: bar
-    baz: 5
-response:
-  status: 200
-  headers:
-    Authorization: "foo {{{ request.headers.Authorization.0 }}} bar"
-  body:
-    url: "{{{ request.url }}}"
-    path: "{{{ request.path }}}"
-    pathIndex: "{{{ request.path.1 }}}"
-    param: "{{{ request.query.foo }}}"
-    paramIndex: "{{{ request.query.foo.1 }}}"
-    authorization: "{{{ request.headers.Authorization.0 }}}"
-    authorization2: "{{{ request.headers.Authorization.1 }}"
-    fullBody: "{{{ request.body }}}"
-    responseFoo: "{{{ jsonpath this '$.foo' }}}"
-    responseBaz: "{{{ jsonpath this '$.baz' }}}"
-    responseBaz2: "Bla bla {{{ jsonpath this '$.foo' }}} bla bla"</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Running a JUnit test generation leads to a test that resembles the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">// given:
- MockMvcRequestSpecification request = given()
-   .header("Authorization", "secret")
-   .header("Authorization", "secret2")
-   .body("{\"foo\":\"bar\",\"baz\":5}");
-
-// when:
- ResponseOptions response = given().spec(request)
-   .queryParam("foo","bar")
-   .queryParam("foo","bar2")
-   .get("/api/v1/xxxx");
-
-// then:
- assertThat(response.statusCode()).isEqualTo(200);
- assertThat(response.header("Authorization")).isEqualTo("foo secret bar");
-// and:
- DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
- assertThatJson(parsedJson).field("['fullBody']").isEqualTo("{\"foo\":\"bar\",\"baz\":5}");
- assertThatJson(parsedJson).field("['authorization']").isEqualTo("secret");
- assertThatJson(parsedJson).field("['authorization2']").isEqualTo("secret2");
- assertThatJson(parsedJson).field("['path']").isEqualTo("/api/v1/xxxx");
- assertThatJson(parsedJson).field("['param']").isEqualTo("bar");
- assertThatJson(parsedJson).field("['paramIndex']").isEqualTo("bar2");
- assertThatJson(parsedJson).field("['pathIndex']").isEqualTo("v1");
- assertThatJson(parsedJson).field("['responseBaz']").isEqualTo(5);
- assertThatJson(parsedJson).field("['responseFoo']").isEqualTo("bar");
- assertThatJson(parsedJson).field("['url']").isEqualTo("/api/v1/xxxx?foo=bar&amp;foo=bar2");
- assertThatJson(parsedJson).field("['responseBaz2']").isEqualTo("Bla bla bar bla bla");</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>As you can see, elements from the request have been properly referenced in the response.</p>
-</div>
-<div class="paragraph">
-<p>The generated WireMock stub should resemble the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
-  "request" : {
-    "urlPath" : "/api/v1/xxxx",
-    "method" : "POST",
-    "headers" : {
-      "Authorization" : {
-        "equalTo" : "secret2"
-      }
-    },
-    "queryParameters" : {
-      "foo" : {
-        "equalTo" : "bar2"
-      }
-    },
-    "bodyPatterns" : [ {
-      "matchesJsonPath" : "$[?(@.['baz'] == 5)]"
-    }, {
-      "matchesJsonPath" : "$[?(@.['foo'] == 'bar')]"
-    } ]
-  },
-  "response" : {
-    "status" : 200,
-    "body" : "{\"authorization\":\"{{{request.headers.Authorization.[0]}}}\",\"path\":\"{{{request.path}}}\",\"responseBaz\":{{{jsonpath this '$.baz'}}} ,\"param\":\"{{{request.query.foo.[0]}}}\",\"pathIndex\":\"{{{request.path.[1]}}}\",\"responseBaz2\":\"Bla bla {{{jsonpath this '$.foo'}}} bla bla\",\"responseFoo\":\"{{{jsonpath this '$.foo'}}}\",\"authorization2\":\"{{{request.headers.Authorization.[1]}}}\",\"fullBody\":\"{{{escapejsonbody}}}\",\"url\":\"{{{request.url}}}\",\"paramIndex\":\"{{{request.query.foo.[1]}}}\"}",
-    "headers" : {
-      "Authorization" : "{{{request.headers.Authorization.[0]}}};foo"
-    },
-    "transformers" : [ "response-template" ]
-  }
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Sending a request such as the one presented in the <code>request</code> part of the contract results
-in sending the following response body:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
-  "url" : "/api/v1/xxxx?foo=bar&amp;foo=bar2",
-  "path" : "/api/v1/xxxx",
-  "pathIndex" : "v1",
-  "param" : "bar",
-  "paramIndex" : "bar2",
-  "authorization" : "secret",
-  "authorization2" : "secret2",
-  "fullBody" : "{\"foo\":\"bar\",\"baz\":5}",
-  "responseFoo" : "bar",
-  "responseBaz" : 5,
-  "responseBaz2" : "Bla bla bar bla bla"
-}</code></pre>
-</div>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-This feature works only with WireMock having a version greater than or equal
-to 2.5.1. The Spring Cloud Contract Verifier uses WireMock&#8217;s
-<code>response-template</code> response transformer. It uses Handlebars to convert the Mustache <code>{{{ }}}</code> templates into
-proper values. Additionally, it registers two helper functions:
-</td>
-</tr>
-</table>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>escapejsonbody</code>: Escapes the request body in a format that can be embedded in a JSON.</p>
-</li>
-<li>
-<p><code>jsonpath</code>: For a given parameter, find an object in the request body.</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_registering_your_own_wiremock_extension"><a class="link" href="#_registering_your_own_wiremock_extension">8.5.6. Registering Your Own WireMock Extension</a></h4>
-<div class="paragraph">
-<p>WireMock lets you register custom extensions. By default, Spring Cloud Contract registers
-the transformer, which lets you reference a request from a response. If you want to
-provide your own extensions, you can register an implementation of the
-<code>org.springframework.cloud.contract.verifier.dsl.wiremock.WireMockExtensions</code> interface.
-Since we use the spring.factories extension approach, you can create an entry in
-<code>META-INF/spring.factories</code> file similar to the following:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.verifier.dsl.wiremock.WireMockExtensions=\
-org.springframework.cloud.contract.stubrunner.provider.wiremock.TestWireMockExtensions
-org.springframework.cloud.contract.spec.ContractConverter=\
-org.springframework.cloud.contract.stubrunner.TestCustomYamlContractConverter</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following is an example of a custom extension:</p>
-</div>
-<div class="listingblock">
-<div class="title">TestWireMockExtensions.groovy</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">/*
- * Copyright 2013-2019 the original author or authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package org.springframework.cloud.contract.verifier.dsl.wiremock
-
-import com.github.tomakehurst.wiremock.extension.Extension
-
-/**
- * Extension that registers the default transformer and the custom one
- */
-class TestWireMockExtensions implements WireMockExtensions {
-	@Override
-	List&lt;Extension&gt; extensions() {
-		return [
-				new DefaultResponseTransformer(),
-				new CustomExtension()
-		]
-	}
-}
-
-class CustomExtension implements Extension {
-
-	@Override
-	String getName() {
-		return "foo-transformer"
-	}
-}</code></pre>
-</div>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-Remember to override the <code>applyGlobally()</code> method and set it to <code>false</code> if you
-want the transformation to be applied only for a mapping that explicitly requires it.
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect3">
-<h4 id="contract-matchers"><a class="link" href="#contract-matchers">8.5.7. Dynamic Properties in the Matchers Sections</a></h4>
-<div class="paragraph">
-<p>If you work with <a href="https://docs.pact.io/">Pact</a>, the following discussion may seem familiar.
-Quite a few users are used to having a separation between the body and setting the
-dynamic parts of a contract.</p>
-</div>
-<div class="paragraph">
-<p>You can use the <code>bodyMatchers</code> section for two reasons:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Define the dynamic values that should end up in a stub.
-You can set it in the <code>request</code> or <code>inputMessage</code> part of your contract.</p>
-</li>
-<li>
-<p>Verify the result of your test.
-This section is present in the <code>response</code> or <code>outputMessage</code> side of the
-contract.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Currently, Spring Cloud Contract Verifier supports only JSON Path-based matchers with the
-following matching possibilities:</p>
-</div>
-<div class="ulist">
-<div class="title">Groovy DSL</div>
-<ul>
-<li>
-<p>For the stubs(in tests on the Consumer&#8217;s side):</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>byEquality()</code>: The value taken from the consumer&#8217;s request via the provided JSON Path must be
-equal to the value provided in the contract.</p>
-</li>
-<li>
-<p><code>byRegex(&#8230;&#8203;)</code>: The value taken from the consumer&#8217;s request via the provided JSON Path must
-match the regex. You can also pass the type of the expected matched value (e.g. <code>asString()</code>, <code>asLong()</code> etc.)</p>
-</li>
-<li>
-<p><code>byDate()</code>: The value taken from the consumer&#8217;s request via the provided JSON Path must
-match the regex for an ISO Date value.</p>
-</li>
-<li>
-<p><code>byTimestamp()</code>: The value taken from the consumer&#8217;s request via the provided JSON Path must
-match the regex for an ISO DateTime value.</p>
-</li>
-<li>
-<p><code>byTime()</code>: The value taken from the consumer&#8217;s request via the provided JSON Path must
-match the regex for an ISO Time value.</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>For the verification(in generated tests on the Producer&#8217;s side):</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>byEquality()</code>: The value taken from the producer&#8217;s response via the provided JSON Path must be
-equal to the provided value in the contract.</p>
-</li>
-<li>
-<p><code>byRegex(&#8230;&#8203;)</code>: The value taken from the producer&#8217;s response via the provided JSON Path must
-match the regex.</p>
-</li>
-<li>
-<p><code>byDate()</code>: The value taken from the producer&#8217;s response via the provided JSON Path must match
-the regex for an ISO Date value.</p>
-</li>
-<li>
-<p><code>byTimestamp()</code>: The value taken from the producer&#8217;s response via the provided JSON Path must
-match the regex for an ISO DateTime value.</p>
-</li>
-<li>
-<p><code>byTime()</code>: The value taken from the producer&#8217;s response via the provided JSON Path must match
-the regex for an ISO Time value.</p>
-</li>
-<li>
-<p><code>byType()</code>: The value taken from the producer&#8217;s response via the provided JSON Path needs to be
-of the same type as the type defined in the body of the response in the contract.
-<code>byType</code> can take a closure, in which you can set <code>minOccurrence</code> and <code>maxOccurrence</code>. For the request side, you should use the closure to assert size of the collection.
-That way, you can assert the size of the flattened collection. To check the size of an
-unflattened collection, use a custom method with the <code>byCommand(&#8230;&#8203;)</code> testMatcher.</p>
-</li>
-<li>
-<p><code>byCommand(&#8230;&#8203;)</code>: The value taken from the producer&#8217;s response via the provided JSON Path is
-passed as an input to the custom method that you provide. For example,
-<code>byCommand('foo($it)')</code> results in calling a <code>foo</code> method to which the value matching the
-JSON Path gets passed. The type of the object read from the JSON can be one of the
-following, depending on the JSON path:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>String</code>: If you point to a <code>String</code> value.</p>
-</li>
-<li>
-<p><code>JSONArray</code>: If you point to a <code>List</code>.</p>
-</li>
-<li>
-<p><code>Map</code>: If you point to a <code>Map</code>.</p>
-</li>
-<li>
-<p><code>Number</code>: If you point to <code>Integer</code>, <code>Double</code>, or other kind of number.</p>
-</li>
-<li>
-<p><code>Boolean</code>: If you point to a <code>Boolean</code>.</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><code>byNull()</code>: The value taken from the response via the provided JSON Path must be null</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<div class="title">YAML</div>
-<p><em>Please read the Groovy section for detailed explanation of
-what the types mean</em></p>
-</div>
-<div class="paragraph">
-<p>For YAML the structure of a matcher looks like this</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">- path: $.foo
-  type: by_regex
-  value: bar
-  regexType: as_string</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Or if you want to use one of the predefined regular expressions
-<code>[only_alpha_unicode, number, any_boolean, ip_address, hostname,
-email, url, uuid, iso_date, iso_date_time, iso_time, iso_8601_with_offset, non_empty, non_blank]</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">- path: $.foo
-  type: by_regex
-  predefined: only_alpha_unicode</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Below you can find the allowed list of `type`s.</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>For <code>stubMatchers</code>:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>by_equality</code></p>
-</li>
-<li>
-<p><code>by_regex</code></p>
-</li>
-<li>
-<p><code>by_date</code></p>
-</li>
-<li>
-<p><code>by_timestamp</code></p>
-</li>
-<li>
-<p><code>by_time</code></p>
-</li>
-<li>
-<p><code>by_type</code></p>
-<div class="ulist">
-<ul>
-<li>
-<p>there are 2 additional fields accepted: <code>minOccurrence</code> and <code>maxOccurrence</code>.</p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p>For <code>testMatchers</code>:</p>
-<div class="ulist">
-<ul>
-<li>
-<p><code>by_equality</code></p>
-</li>
-<li>
-<p><code>by_regex</code></p>
-</li>
-<li>
-<p><code>by_date</code></p>
-</li>
-<li>
-<p><code>by_timestamp</code></p>
-</li>
-<li>
-<p><code>by_time</code></p>
-</li>
-<li>
-<p><code>by_type</code></p>
-<div class="ulist">
-<ul>
-<li>
-<p>there are 2 additional fields accepted: <code>minOccurrence</code> and <code>maxOccurrence</code>.</p>
-</li>
-</ul>
-</div>
-</li>
-<li>
-<p><code>by_command</code></p>
-</li>
-<li>
-<p><code>by_null</code></p>
-</li>
-</ul>
-</div>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>You can also define which type the regular expression corresponds to via the <code>regexType</code> field. Below you can find the allowed list of regular expression types:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>as_integer</p>
-</li>
-<li>
-<p>as_double</p>
-</li>
-<li>
-<p>as_float,</p>
-</li>
-<li>
-<p>as_long</p>
-</li>
-<li>
-<p>as_short</p>
-</li>
-<li>
-<p>as_boolean</p>
-</li>
-<li>
-<p>as_string</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Consider the following example:</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract contractDsl = Contract.make {
-	request {
-		method 'GET'
-		urlPath '/get'
-		body([
-				duck                : 123,
-				alpha               : 'abc',
-				number              : 123,
-				aBoolean            : true,
-				date                : '2017-01-01',
-				dateTime            : '2017-01-01T01:23:45',
-				time                : '01:02:34',
-				valueWithoutAMatcher: 'foo',
-				valueWithTypeMatch  : 'string',
-				key                 : [
-						'complex.key': 'foo'
-				]
-		])
-		bodyMatchers {
-			jsonPath('$.duck', byRegex("[0-9]{3}").asInteger())
-			jsonPath('$.duck', byEquality())
-			jsonPath('$.alpha', byRegex(onlyAlphaUnicode()).asString())
-			jsonPath('$.alpha', byEquality())
-			jsonPath('$.number', byRegex(number()).asInteger())
-			jsonPath('$.aBoolean', byRegex(anyBoolean()).asBooleanType())
-			jsonPath('$.date', byDate())
-			jsonPath('$.dateTime', byTimestamp())
-			jsonPath('$.time', byTime())
-			jsonPath("\$.['key'].['complex.key']", byEquality())
-		}
-		headers {
-			contentType(applicationJson())
-		}
-	}
-	response {
-		status OK()
-		body([
-				duck                 : 123,
-				alpha                : 'abc',
-				number               : 123,
-				positiveInteger      : 1234567890,
-				negativeInteger      : -1234567890,
-				positiveDecimalNumber: 123.4567890,
-				negativeDecimalNumber: -123.4567890,
-				aBoolean             : true,
-				date                 : '2017-01-01',
-				dateTime             : '2017-01-01T01:23:45',
-				time                 : "01:02:34",
-				valueWithoutAMatcher : 'foo',
-				valueWithTypeMatch   : 'string',
-				valueWithMin         : [
-						1, 2, 3
-				],
-				valueWithMax         : [
-						1, 2, 3
-				],
-				valueWithMinMax      : [
-						1, 2, 3
-				],
-				valueWithMinEmpty    : [],
-				valueWithMaxEmpty    : [],
-				key                  : [
-						'complex.key': 'foo'
-				],
-				nullValue            : null
-		])
-		bodyMatchers {
-			// asserts the jsonpath value against manual regex
-			jsonPath('$.duck', byRegex("[0-9]{3}").asInteger())
-			// asserts the jsonpath value against the provided value
-			jsonPath('$.duck', byEquality())
-			// asserts the jsonpath value against some default regex
-			jsonPath('$.alpha', byRegex(onlyAlphaUnicode()).asString())
-			jsonPath('$.alpha', byEquality())
-			jsonPath('$.number', byRegex(number()).asInteger())
-			jsonPath('$.positiveInteger', byRegex(anInteger()).asInteger())
-			jsonPath('$.negativeInteger', byRegex(anInteger()).asInteger())
-			jsonPath('$.positiveDecimalNumber', byRegex(aDouble()).asDouble())
-			jsonPath('$.negativeDecimalNumber', byRegex(aDouble()).asDouble())
-			jsonPath('$.aBoolean', byRegex(anyBoolean()).asBooleanType())
-			// asserts vs inbuilt time related regex
-			jsonPath('$.date', byDate())
-			jsonPath('$.dateTime', byTimestamp())
-			jsonPath('$.time', byTime())
-			// asserts that the resulting type is the same as in response body
-			jsonPath('$.valueWithTypeMatch', byType())
-			jsonPath('$.valueWithMin', byType {
-				// results in verification of size of array (min 1)
-				minOccurrence(1)
-			})
-			jsonPath('$.valueWithMax', byType {
-				// results in verification of size of array (max 3)
-				maxOccurrence(3)
-			})
-			jsonPath('$.valueWithMinMax', byType {
-				// results in verification of size of array (min 1 &amp; max 3)
-				minOccurrence(1)
-				maxOccurrence(3)
-			})
-			jsonPath('$.valueWithMinEmpty', byType {
-				// results in verification of size of array (min 0)
-				minOccurrence(0)
-			})
-			jsonPath('$.valueWithMaxEmpty', byType {
-				// results in verification of size of array (max 0)
-				maxOccurrence(0)
-			})
-			// will execute a method `assertThatValueIsANumber`
-			jsonPath('$.duck', byCommand('assertThatValueIsANumber($it)'))
-			jsonPath("\$.['key'].['complex.key']", byEquality())
-			jsonPath('$.nullValue', byNull())
-		}
-		headers {
-			contentType(applicationJson())
-			header('Some-Header', $(c('someValue'), p(regex('[a-zA-Z]{9}'))))
-		}
-	}
-}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request:
-  method: GET
-  urlPath: /get/1
-  headers:
-    Content-Type: application/json
-  cookies:
-    foo: 2
-    bar: 3
-  queryParameters:
-    limit: 10
-    offset: 20
-    filter: 'email'
-    sort: name
-    search: 55
-    age: 99
-    name: John.Doe
-    email: 'bob@email.com'
-  body:
-    duck: 123
-    alpha: "abc"
-    number: 123
-    aBoolean: true
-    date: "2017-01-01"
-    dateTime: "2017-01-01T01:23:45"
-    time: "01:02:34"
-    valueWithoutAMatcher: "foo"
-    valueWithTypeMatch: "string"
-    key:
-      "complex.key": 'foo'
-    nullValue: null
-    valueWithMin:
-      - 1
-      - 2
-      - 3
-    valueWithMax:
-      - 1
-      - 2
-      - 3
-    valueWithMinMax:
-      - 1
-      - 2
-      - 3
-    valueWithMinEmpty: []
-    valueWithMaxEmpty: []
-  matchers:
-    url:
-      regex: /get/[0-9]
-      # predefined:
-      # execute a method
-      #command: 'equals($it)'
-    queryParameters:
-      - key: limit
-        type: equal_to
-        value: 20
-      - key: offset
-        type: containing
-        value: 20
-      - key: sort
-        type: equal_to
-        value: name
-      - key: search
-        type: not_matching
-        value: '^[0-9]{2}$'
-      - key: age
-        type: not_matching
-        value: '^\\w*$'
-      - key: name
-        type: matching
-        value: 'John.*'
-      - key: hello
-        type: absent
-    cookies:
-      - key: foo
-        regex: '[0-9]'
-      - key: bar
-        command: 'equals($it)'
-    headers:
-      - key: Content-Type
-        regex: "application/json.*"
-    body:
-      - path: $.duck
-        type: by_regex
-        value: "[0-9]{3}"
-      - path: $.duck
-        type: by_equality
-      - path: $.alpha
-        type: by_regex
-        predefined: only_alpha_unicode
-      - path: $.alpha
-        type: by_equality
-      - path: $.number
-        type: by_regex
-        predefined: number
-      - path: $.aBoolean
-        type: by_regex
-        predefined: any_boolean
-      - path: $.date
-        type: by_date
-      - path: $.dateTime
-        type: by_timestamp
-      - path: $.time
-        type: by_time
-      - path: "$.['key'].['complex.key']"
-        type: by_equality
-      - path: $.nullvalue
-        type: by_null
-      - path: $.valueWithMin
-        type: by_type
-        minOccurrence: 1
-      - path: $.valueWithMax
-        type: by_type
-        maxOccurrence: 3
-      - path: $.valueWithMinMax
-        type: by_type
-        minOccurrence: 1
-        maxOccurrence: 3
-response:
-  status: 200
-  cookies:
-    foo: 1
-    bar: 2
-  body:
-    duck: 123
-    alpha: "abc"
-    number: 123
-    aBoolean: true
-    date: "2017-01-01"
-    dateTime: "2017-01-01T01:23:45"
-    time: "01:02:34"
-    valueWithoutAMatcher: "foo"
-    valueWithTypeMatch: "string"
-    valueWithMin:
-      - 1
-      - 2
-      - 3
-    valueWithMax:
-      - 1
-      - 2
-      - 3
-    valueWithMinMax:
-      - 1
-      - 2
-      - 3
-    valueWithMinEmpty: []
-    valueWithMaxEmpty: []
-    key:
-      'complex.key': 'foo'
-    nulValue: null
-  matchers:
-    headers:
-      - key: Content-Type
-        regex: "application/json.*"
-    cookies:
-      - key: foo
-        regex: '[0-9]'
-      - key: bar
-        command: 'equals($it)'
-    body:
-      - path: $.duck
-        type: by_regex
-        value: "[0-9]{3}"
-      - path: $.duck
-        type: by_equality
-      - path: $.alpha
-        type: by_regex
-        predefined: only_alpha_unicode
-      - path: $.alpha
-        type: by_equality
-      - path: $.number
-        type: by_regex
-        predefined: number
-      - path: $.aBoolean
-        type: by_regex
-        predefined: any_boolean
-      - path: $.date
-        type: by_date
-      - path: $.dateTime
-        type: by_timestamp
-      - path: $.time
-        type: by_time
-      - path: $.valueWithTypeMatch
-        type: by_type
-      - path: $.valueWithMin
-        type: by_type
-        minOccurrence: 1
-      - path: $.valueWithMax
-        type: by_type
-        maxOccurrence: 3
-      - path: $.valueWithMinMax
-        type: by_type
-        minOccurrence: 1
-        maxOccurrence: 3
-      - path: $.valueWithMinEmpty
-        type: by_type
-        minOccurrence: 0
-      - path: $.valueWithMaxEmpty
-        type: by_type
-        maxOccurrence: 0
-      - path: $.duck
-        type: by_command
-        value: assertThatValueIsANumber($it)
-      - path: $.nullValue
-        type: by_null
-        value: null
-  headers:
-    Content-Type: application/json</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In the preceding example, you can see the dynamic portions of the contract in the
-<code>matchers</code> sections. For the request part, you can see that, for all fields but
-<code>valueWithoutAMatcher</code>, the values of the regular expressions that the stub should
-contain are explicitly set. For the <code>valueWithoutAMatcher</code>, the verification takes place
-in the same way as without the use of matchers. In that case, the test performs an
-equality check.</p>
-</div>
-<div class="paragraph">
-<p>For the response side in the <code>bodyMatchers</code> section, we define the dynamic parts in a
-similar manner. The only difference is that the <code>byType</code> matchers are also present. The
-verifier engine checks four fields to verify whether the response from the test
-has a value for which the JSON path matches the given field, is of the same type as the one
-defined in the response body, and passes the following check (based on the method being called):</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>For <code>$.valueWithTypeMatch</code>, the engine checks whether the type is the same.</p>
-</li>
-<li>
-<p>For <code>$.valueWithMin</code>, the engine check the type and asserts whether the size is greater
-than or equal to the minimum occurrence.</p>
-</li>
-<li>
-<p>For <code>$.valueWithMax</code>, the engine checks the type and asserts whether the size is
-smaller than or equal to the maximum occurrence.</p>
-</li>
-<li>
-<p>For <code>$.valueWithMinMax</code>, the engine checks the type and asserts whether the size is
-between the min and maximum occurrence.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The resulting test would resemble the following example (note that an <code>and</code> section
-separates the autogenerated assertions and the assertion from matchers):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">// given:
- MockMvcRequestSpecification request = given()
-   .header("Content-Type", "application/json")
-   .body("{\"duck\":123,\"alpha\":\"abc\",\"number\":123,\"aBoolean\":true,\"date\":\"2017-01-01\",\"dateTime\":\"2017-01-01T01:23:45\",\"time\":\"01:02:34\",\"valueWithoutAMatcher\":\"foo\",\"valueWithTypeMatch\":\"string\",\"key\":{\"complex.key\":\"foo\"}}");
-
-// when:
- ResponseOptions response = given().spec(request)
-   .get("/get");
-
-// then:
- assertThat(response.statusCode()).isEqualTo(200);
- assertThat(response.header("Content-Type")).matches("application/json.*");
-// and:
- DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
- assertThatJson(parsedJson).field("['valueWithoutAMatcher']").isEqualTo("foo");
-// and:
- assertThat(parsedJson.read("$.duck", String.class)).matches("[0-9]{3}");
- assertThat(parsedJson.read("$.duck", Integer.class)).isEqualTo(123);
- assertThat(parsedJson.read("$.alpha", String.class)).matches("[\\p{L}]*");
- assertThat(parsedJson.read("$.alpha", String.class)).isEqualTo("abc");
- assertThat(parsedJson.read("$.number", String.class)).matches("-?(\\d*\\.\\d+|\\d+)");
- assertThat(parsedJson.read("$.aBoolean", String.class)).matches("(true|false)");
- assertThat(parsedJson.read("$.date", String.class)).matches("(\\d\\d\\d\\d)-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])");
- assertThat(parsedJson.read("$.dateTime", String.class)).matches("([0-9]{4})-(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9])T(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])");
- assertThat(parsedJson.read("$.time", String.class)).matches("(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])");
- assertThat((Object) parsedJson.read("$.valueWithTypeMatch")).isInstanceOf(java.lang.String.class);
- assertThat((Object) parsedJson.read("$.valueWithMin")).isInstanceOf(java.util.List.class);
- assertThat((java.lang.Iterable) parsedJson.read("$.valueWithMin", java.util.Collection.class)).as("$.valueWithMin").hasSizeGreaterThanOrEqualTo(1);
- assertThat((Object) parsedJson.read("$.valueWithMax")).isInstanceOf(java.util.List.class);
- assertThat((java.lang.Iterable) parsedJson.read("$.valueWithMax", java.util.Collection.class)).as("$.valueWithMax").hasSizeLessThanOrEqualTo(3);
- assertThat((Object) parsedJson.read("$.valueWithMinMax")).isInstanceOf(java.util.List.class);
- assertThat((java.lang.Iterable) parsedJson.read("$.valueWithMinMax", java.util.Collection.class)).as("$.valueWithMinMax").hasSizeBetween(1, 3);
- assertThat((Object) parsedJson.read("$.valueWithMinEmpty")).isInstanceOf(java.util.List.class);
- assertThat((java.lang.Iterable) parsedJson.read("$.valueWithMinEmpty", java.util.Collection.class)).as("$.valueWithMinEmpty").hasSizeGreaterThanOrEqualTo(0);
- assertThat((Object) parsedJson.read("$.valueWithMaxEmpty")).isInstanceOf(java.util.List.class);
- assertThat((java.lang.Iterable) parsedJson.read("$.valueWithMaxEmpty", java.util.Collection.class)).as("$.valueWithMaxEmpty").hasSizeLessThanOrEqualTo(0);
- assertThatValueIsANumber(parsedJson.read("$.duck"));
- assertThat(parsedJson.read("$.['key'].['complex.key']", String.class)).isEqualTo("foo");</code></pre>
-</div>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-Notice that, for the <code>byCommand</code> method, the example calls the
-<code>assertThatValueIsANumber</code>. This method must be defined in the test base class or be
-statically imported to your tests. Notice that the <code>byCommand</code> call was converted to
-<code>assertThatValueIsANumber(parsedJson.read("$.duck"));</code>. That means that the engine took
-the method name and passed the proper JSON path as a parameter to it.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>The resulting WireMock stub is in the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">					'''
-{
-  "request" : {
-    "urlPath" : "/get",
-    "method" : "POST",
-    "headers" : {
-      "Content-Type" : {
-        "matches" : "application/json.*"
-      }
-    },
-    "bodyPatterns" : [ {
-      "matchesJsonPath" : "$.['list'].['some'].['nested'][?(@.['anothervalue'] == 4)]"
-    }, {
-      "matchesJsonPath" : "$[?(@.['valueWithoutAMatcher'] == 'foo')]"
-    }, {
-      "matchesJsonPath" : "$[?(@.['valueWithTypeMatch'] == 'string')]"
-    }, {
-      "matchesJsonPath" : "$.['list'].['someother'].['nested'][?(@.['json'] == 'with value')]"
-    }, {
-      "matchesJsonPath" : "$.['list'].['someother'].['nested'][?(@.['anothervalue'] == 4)]"
-    }, {
-      "matchesJsonPath" : "$[?(@.duck =~ /([0-9]{3})/)]"
-    }, {
-      "matchesJsonPath" : "$[?(@.duck == 123)]"
-    }, {
-      "matchesJsonPath" : "$[?(@.alpha =~ /([\\\\p{L}]*)/)]"
-    }, {
-      "matchesJsonPath" : "$[?(@.alpha == 'abc')]"
-    }, {
-      "matchesJsonPath" : "$[?(@.number =~ /(-?(\\\\d*\\\\.\\\\d+|\\\\d+))/)]"
-    }, {
-      "matchesJsonPath" : "$[?(@.aBoolean =~ /((true|false))/)]"
-    }, {
-      "matchesJsonPath" : "$[?(@.date =~ /((\\\\d\\\\d\\\\d\\\\d)-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01]))/)]"
-    }, {
-      "matchesJsonPath" : "$[?(@.dateTime =~ /(([0-9]{4})-(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9])T(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9]))/)]"
-    }, {
-      "matchesJsonPath" : "$[?(@.time =~ /((2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9]))/)]"
-    }, {
-      "matchesJsonPath" : "$.list.some.nested[?(@.json =~ /(.*)/)]"
-    }, {
-      "matchesJsonPath" : "$[?(@.valueWithMin.size() &gt;= 1)]"
-    }, {
-      "matchesJsonPath" : "$[?(@.valueWithMax.size() &lt;= 3)]"
-    }, {
-      "matchesJsonPath" : "$[?(@.valueWithMinMax.size() &gt;= 1 &amp;&amp; @.valueWithMinMax.size() &lt;= 3)]"
-    }, {
-      "matchesJsonPath" : "$[?(@.valueWithOccurrence.size() &gt;= 4 &amp;&amp; @.valueWithOccurrence.size() &lt;= 4)]"
-    } ]
-  },
-  "response" : {
-    "status" : 200,
-    "body" : "{\\"date\\":\\"2017-01-01\\",\\"dateTime\\":\\"2017-01-01T01:23:45\\",\\"aBoolean\\":true,\\"valueWithMax\\":[1,2,3],\\"valueWithOccurrence\\":[1,2,3,4],\\"number\\":123,\\"duck\\":123,\\"alpha\\":\\"abc\\",\\"valueWithMin\\":[1,2,3],\\"time\\":\\"01:02:34\\",\\"valueWithTypeMatch\\":\\"string\\",\\"valueWithMinMax\\":[1,2,3],\\"valueWithoutAMatcher\\":\\"foo\\"}",
-    "headers" : {
-      "Content-Type" : "application/json"
-    },
-    "transformers" : [ "response-template" ]
-  }
-}
-'''</code></pre>
-</div>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-If you use a <code>matcher</code>, then the part of the request and response that the
-<code>matcher</code> addresses with the JSON Path gets removed from the assertion. In the case of
-verifying a collection, you must create matchers for <strong>all</strong> the elements of the
-collection.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>Consider the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
-    request {
-        method 'GET'
-        url("/foo")
-    }
-    response {
-        status OK()
-        body(events: [[
-                                 operation          : 'EXPORT',
-                                 eventId            : '16f1ed75-0bcc-4f0d-a04d-3121798faf99',
-                                 status             : 'OK'
-                         ], [
-                                 operation          : 'INPUT_PROCESSING',
-                                 eventId            : '3bb4ac82-6652-462f-b6d1-75e424a0024a',
-                                 status             : 'OK'
-                         ]
-                ]
-        )
-        bodyMatchers {
-            jsonPath('$.events[0].operation', byRegex('.+'))
-            jsonPath('$.events[0].eventId', byRegex('^([a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})$'))
-            jsonPath('$.events[0].status', byRegex('.+'))
-        }
-    }
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The preceding code leads to creating the following test (the code block shows only the assertion section):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">and:
-	DocumentContext parsedJson = JsonPath.parse(response.body.asString())
-	assertThatJson(parsedJson).array("['events']").contains("['eventId']").isEqualTo("16f1ed75-0bcc-4f0d-a04d-3121798faf99")
-	assertThatJson(parsedJson).array("['events']").contains("['operation']").isEqualTo("EXPORT")
-	assertThatJson(parsedJson).array("['events']").contains("['operation']").isEqualTo("INPUT_PROCESSING")
-	assertThatJson(parsedJson).array("['events']").contains("['eventId']").isEqualTo("3bb4ac82-6652-462f-b6d1-75e424a0024a")
-	assertThatJson(parsedJson).array("['events']").contains("['status']").isEqualTo("OK")
-and:
-	assertThat(parsedJson.read("\$.events[0].operation", String.class)).matches(".+")
-	assertThat(parsedJson.read("\$.events[0].eventId", String.class)).matches("^([a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})\$")
-	assertThat(parsedJson.read("\$.events[0].status", String.class)).matches(".+")</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>As you can see, the assertion is malformed. Only the first element of the array got
-asserted. In order to fix this, you should apply the assertion to the whole <code>$.events</code>
-collection and assert it with the <code>byCommand(&#8230;&#8203;)</code> method.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_jax_rs_support"><a class="link" href="#_jax_rs_support">8.6. JAX-RS Support</a></h3>
-<div class="paragraph">
-<p>The Spring Cloud Contract Verifier supports the JAX-RS 2 Client API. The base class needs
-to define <code>protected WebTarget webTarget</code> and server initialization. The only option for
-testing JAX-RS API is to start a web server. Also, a request with a body needs to have a
-content type set. Otherwise, the default of <code>application/octet-stream</code> gets used.</p>
-</div>
-<div class="paragraph">
-<p>In order to use JAX-RS mode, use the following settings:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testMode == 'JAXRSCLIENT'</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following example shows a generated test API:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">					"""\
-package com.example;
-
-import com.jayway.jsonpath.DocumentContext;
-import com.jayway.jsonpath.JsonPath;
-import org.junit.Test;
-import org.junit.Rule;
-import javax.ws.rs.client.Entity;
-import javax.ws.rs.core.Response;
-
-import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat;
-import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*;
-import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson;
-import static javax.ws.rs.client.Entity.*;
-
-@SuppressWarnings("rawtypes")
-public class FooTest {
-\tWebTarget webTarget;
-
-\t@Test
-\tpublic void validate_() throws Exception {
-
-\t\t// when:
-\t\t\tResponse response = webTarget
-\t\t\t\t\t\t\t.path("/users")
-\t\t\t\t\t\t\t.queryParam("limit", "10")
-\t\t\t\t\t\t\t.queryParam("offset", "20")
-\t\t\t\t\t\t\t.queryParam("filter", "email")
-\t\t\t\t\t\t\t.queryParam("sort", "name")
-\t\t\t\t\t\t\t.queryParam("search", "55")
-\t\t\t\t\t\t\t.queryParam("age", "99")
-\t\t\t\t\t\t\t.queryParam("name", "Denis.Stepanov")
-\t\t\t\t\t\t\t.queryParam("email", "bob@email.com")
-\t\t\t\t\t\t\t.request()
-\t\t\t\t\t\t\t.build("GET")
-\t\t\t\t\t\t\t.invoke();
-\t\t\tString responseAsString = response.readEntity(String.class);
-
-\t\t// then:
-\t\t\tassertThat(response.getStatus()).isEqualTo(200);
-
-\t\t// and:
-\t\t\tDocumentContext parsedJson = JsonPath.parse(responseAsString);
-\t\t\tassertThatJson(parsedJson).field("['property1']").isEqualTo("a");
-\t}
-
-}
-
-"""</code></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_async_support"><a class="link" href="#_async_support">8.7. Async Support</a></h3>
-<div class="paragraph">
-<p>If you&#8217;re using asynchronous communication on the server side (your controllers are
-returning <code>Callable</code>, <code>DeferredResult</code>, and so on), then, inside your contract, you must
-provide an <code>async()</code> method in the <code>response</code> section. The following code shows an example:</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
-    request {
-        method GET()
-        url '/get'
-    }
-    response {
-        status OK()
-        body 'Passed'
-        async()
-    }
-}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">response:
-    async: true</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can also use the <code>fixedDelayMilliseconds</code> method / property to add delay to your stubs.</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
-    request {
-        method GET()
-        url '/get'
-    }
-    response {
-        status 200
-        body 'Passed'
-        fixedDelayMilliseconds 1000
-    }
-}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">response:
-    fixedDelayMilliseconds: 1000</code></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_working_with_context_paths"><a class="link" href="#_working_with_context_paths">8.8. Working with Context Paths</a></h3>
-<div class="paragraph">
-<p>Spring Cloud Contract supports context paths.</p>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-The only change needed to fully support context paths is the switch on the
-<strong>PRODUCER</strong> side. Also, the autogenerated tests must use <strong>EXPLICIT</strong> mode. The  consumer
-side remains untouched. In order for the generated test to pass, you must use <strong>EXPLICIT</strong>
-mode.
-</td>
-</tr>
-</table>
-</div>
-<div class="listingblock primary">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-    &lt;extensions&gt;true&lt;/extensions&gt;
-    &lt;configuration&gt;
-        &lt;testMode&gt;EXPLICIT&lt;/testMode&gt;
-    &lt;/configuration&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock secondary">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
-		testMode = 'EXPLICIT'
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>That way, you generate a test that <strong>DOES NOT</strong> use MockMvc. It means that you generate
-real requests and you need to setup your generated test&#8217;s base class to work on a real
-socket.</p>
-</div>
-<div class="paragraph">
-<p>Consider the following contract:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
-	request {
-		method 'GET'
-		url '/my-context-path/url'
-	}
-	response {
-		status OK()
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following example shows how to set up a base class and Rest Assured:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">import io.restassured.RestAssured;
-import org.junit.Before;
-import org.springframework.boot.web.server.LocalServerPort;
-import org.springframework.boot.test.context.SpringBootTest;
-
-@SpringBootTest(classes = ContextPathTestingBaseClass.class, webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
-class ContextPathTestingBaseClass {
-
-	@LocalServerPort int port;
-
-	@Before
-	public void setup() {
-		RestAssured.baseURI = "http://localhost";
-		RestAssured.port = this.port;
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you do it this way:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>All of your requests in the autogenerated tests are sent to the real endpoint with your
-context path included (for example, <code>/my-context-path/url</code>).</p>
-</li>
-<li>
-<p>Your contracts reflect that you have a context path. Your generated stubs also have
-that information (for example, in the stubs, you have to call <code>/my-context-path/url</code>).</p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_working_with_webflux"><a class="link" href="#_working_with_webflux">8.9. Working with WebFlux</a></h3>
-<div class="paragraph">
-<p>Spring Cloud Contract offers two ways of working with WebFlux.</p>
-</div>
-<div class="sect3">
-<h4 id="_webflux_with_webtestclient"><a class="link" href="#_webflux_with_webtestclient">8.9.1. WebFlux with WebTestClient</a></h4>
-<div class="paragraph">
-<p>One of them is via the <code>WebTestClient</code> mode.</p>
-</div>
-<div class="listingblock primary">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-    &lt;extensions&gt;true&lt;/extensions&gt;
-    &lt;configuration&gt;
-        &lt;testMode&gt;WEBTESTCLIENT&lt;/testMode&gt;
-    &lt;/configuration&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock secondary">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
-		testMode = 'WEBTESTCLIENT'
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following example shows how to set up a <code>WebTestClient</code> base class and <code>RestAssured</code>
-for WebFlux:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">import io.restassured.module.webtestclient.RestAssuredWebTestClient;
-import org.junit.Before;
-
-public abstract class BeerRestBase {
-
-	@Before
-	public void setup() {
-		RestAssuredWebTestClient.standaloneSetup(
-		new ProducerController(personToCheck -&gt; personToCheck.age &gt;= 20));
-	}
-}
-}</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_webflux_with_explicit_mode"><a class="link" href="#_webflux_with_explicit_mode">8.9.2. WebFlux with Explicit mode</a></h4>
-<div class="paragraph">
-<p>Another way is with the <code>EXPLICIT</code> mode in your generated tests
-to work with WebFlux.</p>
-</div>
-<div class="listingblock primary">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-    &lt;extensions&gt;true&lt;/extensions&gt;
-    &lt;configuration&gt;
-        &lt;testMode&gt;EXPLICIT&lt;/testMode&gt;
-    &lt;/configuration&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock secondary">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
-		testMode = 'EXPLICIT'
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The following example shows how to set up a base class and Rest Assured for Web Flux:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@RunWith(SpringRunner.class)
-@SpringBootTest(classes = BeerRestBase.Config.class,
-		webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT,
-		properties = "server.port=0")
-public abstract class BeerRestBase {
-
-    // your tests go here
-
-    // in this config class you define all controllers and mocked services
-@Configuration
-@EnableAutoConfiguration
-static class Config {
-
-	@Bean
-	PersonCheckingService personCheckingService()  {
-		return personToCheck -&gt; personToCheck.age &gt;= 20;
-	}
-
-	@Bean
-	ProducerController producerController() {
-		return new ProducerController(personCheckingService());
-	}
-}
-
-}</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_xml_support_for_rest"><a class="link" href="#_xml_support_for_rest">8.10. XML Support for REST</a></h3>
-<div class="paragraph">
-<p>For REST contracts, we also support XML request and response body.
-The XML body has to be passed within the <code>body</code> element
-as a <code>String</code> or <code>GString</code>. Also body matchers can be provided for
-both request and response. In place of the <code>jsonPath(&#8230;&#8203;)</code> method, the <code>org.springframework.cloud.contract.spec.internal.BodyMatchers.xPath</code>
-method should be used, with the desired <code>xPath</code> provided as the first argument
-and the appropriate <code>MatchingType</code> as second. All the body matchers apart from <code>byType()</code> are supported.</p>
-</div>
-<div class="paragraph">
-<p>Here is an example of a Groovy DSL contract with XML response body:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">					Contract.make {
-						request {
-							method GET()
-							urlPath '/get'
-							headers {
-								contentType(applicationXml())
-							}
-						}
-						response {
-							status(OK())
-							headers {
-								contentType(applicationXml())
-							}
-							body """
-&lt;test&gt;
-&lt;duck type='xtype'&gt;123&lt;/duck&gt;
-&lt;alpha&gt;abc&lt;/alpha&gt;
-&lt;list&gt;
-&lt;elem&gt;abc&lt;/elem&gt;
-&lt;elem&gt;def&lt;/elem&gt;
-&lt;elem&gt;ghi&lt;/elem&gt;
-&lt;/list&gt;
-&lt;number&gt;123&lt;/number&gt;
-&lt;aBoolean&gt;true&lt;/aBoolean&gt;
-&lt;date&gt;2017-01-01&lt;/date&gt;
-&lt;dateTime&gt;2017-01-01T01:23:45&lt;/dateTime&gt;
-&lt;time&gt;01:02:34&lt;/time&gt;
-&lt;valueWithoutAMatcher&gt;foo&lt;/valueWithoutAMatcher&gt;
-&lt;key&gt;&lt;complex&gt;foo&lt;/complex&gt;&lt;/key&gt;
-&lt;/test&gt;"""
-							bodyMatchers {
-								xPath('/test/duck/text()', byRegex("[0-9]{3}"))
-								xPath('/test/duck/text()', byCommand('equals($it)'))
-								xPath('/test/duck/xxx', byNull())
-								xPath('/test/duck/text()', byEquality())
-								xPath('/test/alpha/text()', byRegex(onlyAlphaUnicode()))
-								xPath('/test/alpha/text()', byEquality())
-								xPath('/test/number/text()', byRegex(number()))
-								xPath('/test/date/text()', byDate())
-								xPath('/test/dateTime/text()', byTimestamp())
-								xPath('/test/time/text()', byTime())
-								xPath('/test/*/complex/text()', byEquality())
-								xPath('/test/duck/@type', byEquality())
-							}
-						}
-					}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And below is an example of a YAML contract with XML request and response bodies:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">include::{verifier_core_path}/src/test/resources/yml/contract_rest_xml.yml</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Here is an example of an automatically generated test for XML response body:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
-public void validate_xmlMatches() throws Exception {
-	// given:
-	MockMvcRequestSpecification request = given()
-				.header("Content-Type", "application/xml");
-
-	// when:
-	ResponseOptions response = given().spec(request).get("/get");
-
-	// then:
-	assertThat(response.statusCode()).isEqualTo(200);
-	// and:
-	DocumentBuilder documentBuilder = DocumentBuilderFactory.newInstance()
-					.newDocumentBuilder();
-	Document parsedXml = documentBuilder.parse(new InputSource(
-				new StringReader(response.getBody().asString())));
-	// and:
-	assertThat(valueFromXPath(parsedXml, "/test/list/elem/text()")).isEqualTo("abc");
-	assertThat(valueFromXPath(parsedXml,"/test/list/elem[2]/text()")).isEqualTo("def");
-	assertThat(valueFromXPath(parsedXml, "/test/duck/text()")).matches("[0-9]{3}");
-	assertThat(nodeFromXPath(parsedXml, "/test/duck/xxx")).isNull();
-	assertThat(valueFromXPath(parsedXml, "/test/alpha/text()")).matches("[\\p{L}]*");
-	assertThat(valueFromXPath(parsedXml, "/test/*/complex/text()")).isEqualTo("foo");
-	assertThat(valueFromXPath(parsedXml, "/test/duck/@type")).isEqualTo("xtype");
-	}</code></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_messaging_top_level_elements"><a class="link" href="#_messaging_top_level_elements">8.11. Messaging Top-Level Elements</a></h3>
-<div class="paragraph">
-<p>The DSL for messaging looks a little bit different than the one that focuses on HTTP. The
-following sections explain the differences:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="#contract-dsl-output-triggered-method">Output Triggered by a Method</a></p>
-</li>
-<li>
-<p><a href="#contract-dsl-output-triggered-message">Output Triggered by a Message</a></p>
-</li>
-<li>
-<p><a href="#contract-dsl-consumer-producer">Consumer/Producer</a></p>
-</li>
-<li>
-<p><a href="#contract-dsl-common">Common</a></p>
-</li>
-</ul>
-</div>
-<div class="sect3">
-<h4 id="contract-dsl-output-triggered-method"><a class="link" href="#contract-dsl-output-triggered-method">8.11.1. Output Triggered by a Method</a></h4>
-<div class="paragraph">
-<p>The output message can be triggered by calling a method (such as a <code>Scheduler</code> when a was
-started and a message was sent), as shown in the following example:</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">def dsl = Contract.make {
-	// Human readable description
-	description 'Some description'
-	// Label by means of which the output message can be triggered
-	label 'some_label'
-	// input to the contract
-	input {
-		// the contract will be triggered by a method
-		triggeredBy('bookReturnedTriggered()')
-	}
-	// output message of the contract
-	outputMessage {
-		// destination to which the output message will be sent
-		sentTo('output')
-		// the body of the output message
-		body('''{ "bookName" : "foo" }''')
-		// the headers of the output message
-		headers {
-			header('BOOK-NAME', 'foo')
-		}
-	}
-}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml"># Human readable description
-description: Some description
-# Label by means of which the output message can be triggered
-label: some_label
-input:
-  # the contract will be triggered by a method
-  triggeredBy: bookReturnedTriggered()
-# output message of the contract
-outputMessage:
-  # destination to which the output message will be sent
-  sentTo: output
-  # the body of the output message
-  body:
-    bookName: foo
-  # the headers of the output message
-  headers:
-    BOOK-NAME: foo</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In the previous example case, the output message is sent to <code>output</code> if a method called
-<code>bookReturnedTriggered</code> is executed. On the message <strong>publisher&#8217;s</strong> side, we generate a
-test that calls that method to trigger the message. On the <strong>consumer</strong> side, you can use
-the <code>some_label</code> to trigger the message.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="contract-dsl-output-triggered-message"><a class="link" href="#contract-dsl-output-triggered-message">8.11.2. Output Triggered by a Message</a></h4>
-<div class="paragraph">
-<p>The output message can be triggered by receiving a message, as shown in the following
-example:</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">def dsl = Contract.make {
-	description 'Some Description'
-	label 'some_label'
-	// input is a message
-	input {
-		// the message was received from this destination
-		messageFrom('input')
-		// has the following body
-		messageBody([
-				bookName: 'foo'
-		])
-		// and the following headers
-		messageHeaders {
-			header('sample', 'header')
-		}
-	}
-	outputMessage {
-		sentTo('output')
-		body([
-				bookName: 'foo'
-		])
-		headers {
-			header('BOOK-NAME', 'foo')
-		}
-	}
-}</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml"># Human readable description
-description: Some description
-# Label by means of which the output message can be triggered
-label: some_label
-# input is a message
-input:
-  messageFrom: input
-  # has the following body
-  messageBody:
-    bookName: 'foo'
-  # and the following headers
-  messageHeaders:
-    sample: 'header'
-# output message of the contract
-outputMessage:
-  # destination to which the output message will be sent
-  sentTo: output
-  # the body of the output message
-  body:
-    bookName: foo
-  # the headers of the output message
-  headers:
-    BOOK-NAME: foo</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In the preceding example, the output message is sent to <code>output</code> if a proper message is
-received on the <code>input</code> destination. On the message <strong>publisher&#8217;s</strong> side, the engine
-generates a test that sends the input message to the defined destination. On the
-<strong>consumer</strong> side, you can either send a message to the input destination or use a label
-(<code>some_label</code> in the example) to trigger the message.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="contract-dsl-consumer-producer"><a class="link" href="#contract-dsl-consumer-producer">8.11.3. Consumer/Producer</a></h4>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-This section is valid only for Groovy DSL.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>In HTTP, you have a notion of <code>client</code>/<code>stub and `server</code>/<code>test</code> notation. You can also
-use those paradigms in messaging. In addition, Spring Cloud Contract Verifier also
-provides the <code>consumer</code> and <code>producer</code> methods, as presented in the following example
-(note that you can use either <code>$</code> or <code>value</code> methods to provide <code>consumer</code> and <code>producer</code>
-parts):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">					Contract.make {
-				name "foo"
-						label 'some_label'
-						input {
-							messageFrom value(consumer('jms:output'), producer('jms:input'))
-							messageBody([
-									bookName: 'foo'
-							])
-							messageHeaders {
-								header('sample', 'header')
-							}
-						}
-						outputMessage {
-							sentTo $(consumer('jms:input'), producer('jms:output'))
-							body([
-									bookName: 'foo'
-							])
-						}
-					}</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="contract-dsl-common"><a class="link" href="#contract-dsl-common">8.11.4. Common</a></h4>
-<div class="paragraph">
-<p>In the <code>input</code> or <code>outputMessage</code> section you can call <code>assertThat</code> with the name
-of a <code>method</code> (e.g. <code>assertThatMessageIsOnTheQueue()</code>) that you have defined in the
-base class or in a static import. Spring Cloud Contract will execute that method
-in the generated test.</p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_multiple_contracts_in_one_file"><a class="link" href="#_multiple_contracts_in_one_file">8.12. Multiple Contracts in One File</a></h3>
-<div class="paragraph">
-<p>You can define multiple contracts in one file. Such a contract might resemble the
-following example:</p>
-</div>
-<div class="listingblock">
-<div class="title">Groovy DSL</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">import org.springframework.cloud.contract.spec.Contract
-
-[
-	Contract.make {
-		name("should post a user")
-		request {
-			method 'POST'
-			url('/users/1')
-		}
-		response {
-			status OK()
-		}
-	},
-	Contract.make {
-		request {
-			method 'POST'
-			url('/users/2')
-		}
-		response {
-			status OK()
-		}
-	}
-]</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">YAML</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">---
-name: should post a user
-request:
-  method: POST
-  url: /users/1
-response:
-  status: 200
----
-request:
-  method: POST
-  url: /users/2
-response:
-  status: 200
----
-request:
-  method: POST
-  url: /users/3
-response:
-  status: 200</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In the preceding example, one contract has the <code>name</code> field and the other does not. This
-leads to generation of two tests that look more or less like this:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package org.springframework.cloud.contract.verifier.tests.com.hello;
-
-import com.example.TestBase;
-import com.jayway.jsonpath.DocumentContext;
-import com.jayway.jsonpath.JsonPath;
-import com.jayway.restassured.module.mockmvc.specification.MockMvcRequestSpecification;
-import com.jayway.restassured.response.ResponseOptions;
-import org.junit.Test;
-
-import static com.jayway.restassured.module.mockmvc.RestAssuredMockMvc.*;
-import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson;
-import static org.assertj.core.api.Assertions.assertThat;
-
-public class V1Test extends TestBase {
-
-	@Test
-	public void validate_should_post_a_user() throws Exception {
-		// given:
-			MockMvcRequestSpecification request = given();
-
-		// when:
-			ResponseOptions response = given().spec(request)
-					.post("/users/1");
-
-		// then:
-			assertThat(response.statusCode()).isEqualTo(200);
-	}
-
-	@Test
-	public void validate_withList_1() throws Exception {
-		// given:
-			MockMvcRequestSpecification request = given();
-
-		// when:
-			ResponseOptions response = given().spec(request)
-					.post("/users/2");
-
-		// then:
-			assertThat(response.statusCode()).isEqualTo(200);
-	}
-
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Notice that, for the contract that has the <code>name</code> field, the generated test method is named
-<code>validate_should_post_a_user</code>. For the one that does not have the name, it is called
-<code>validate_withList_1</code>. It corresponds to the name of the file <code>WithList.groovy</code> and the
-index of the contract in the list.</p>
-</div>
-<div class="paragraph">
-<p>The generated stubs is shown in the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code>should post a user.json
-1_WithList.json</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>As you can see, the first file got the <code>name</code> parameter from the contract. The second
-got the name of the contract file (<code>WithList.groovy</code>) prefixed with the index (in this
-case, the contract had an index of <code>1</code> in the list of contracts in the file).</p>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-As you can see, it is much better if you name your contracts because doing so makes
-your tests far more meaningful.
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_generating_spring_rest_docs_snippets_from_the_contracts"><a class="link" href="#_generating_spring_rest_docs_snippets_from_the_contracts">8.13. Generating Spring REST Docs snippets from the contracts</a></h3>
-<div class="paragraph">
-<p>When you want to include the requests and responses of your API using Spring REST Docs,
-you only need to make some minor changes to your setup if you are using MockMvc and RestAssuredMockMvc.
-Simply include the following dependencies if you haven&#8217;t already.</p>
-</div>
-<div class="listingblock">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
-	&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-cloud-starter-contract-verifier&lt;/artifactId&gt;
-	&lt;scope&gt;test&lt;/scope&gt;
-&lt;/dependency&gt;
-&lt;dependency&gt;
-	&lt;groupId&gt;org.springframework.restdocs&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-restdocs-mockmvc&lt;/artifactId&gt;
-	&lt;optional&gt;true&lt;/optional&gt;
-&lt;/dependency&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile 'org.springframework.cloud:spring-cloud-starter-contract-verifier'
-testCompile 'org.springframework.restdocs:spring-restdocs-mockmvc'</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Next you need to make some changes to your base class like the following example.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package com.example.fraud;
-
-import io.restassured.module.mockmvc.RestAssuredMockMvc;
-import org.junit.Before;
-import org.junit.Rule;
-import org.junit.rules.TestName;
-import org.junit.runner.RunWith;
-
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.boot.test.context.SpringBootTest;
-import org.springframework.restdocs.JUnitRestDocumentation;
-import org.springframework.test.context.junit4.SpringRunner;
-import org.springframework.test.web.servlet.setup.MockMvcBuilders;
-import org.springframework.web.context.WebApplicationContext;
-
-import static org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.document;
-import static org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.documentationConfiguration;
-
-@RunWith(SpringRunner.class)
-@SpringBootTest(classes = Application.class)
-public abstract class FraudBaseWithWebAppSetup {
-
-	private static final String OUTPUT = "target/generated-snippets";
-
-	@Rule
-	public JUnitRestDocumentation restDocumentation = new JUnitRestDocumentation(OUTPUT);
-
-	@Rule
-	public TestName testName = new TestName();
-
-	@Autowired
-	private WebApplicationContext context;
-
-	@Before
-	public void setup() {
-		RestAssuredMockMvc.mockMvc(MockMvcBuilders.webAppContextSetup(this.context)
-				.apply(documentationConfiguration(this.restDocumentation))
-				.alwaysDo(document(
-						getClass().getSimpleName() + "_" + testName.getMethodName()))
-				.build());
-	}
-
-	protected void assertThatRejectionReasonIsNull(Object rejectionReason) {
-		assert rejectionReason == null;
-	}
-
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In case you are using the standalone setup, you can set up RestAssuredMockMvc like this:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package com.example.fraud;
-
-import io.restassured.module.mockmvc.RestAssuredMockMvc;
-import org.junit.Before;
-import org.junit.Rule;
-import org.junit.rules.TestName;
-
-import org.springframework.restdocs.JUnitRestDocumentation;
-import org.springframework.test.web.servlet.setup.MockMvcBuilders;
-
-import static org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.document;
-import static org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.documentationConfiguration;
-
-public abstract class FraudBaseWithStandaloneSetup {
-
-	private static final String OUTPUT = "target/generated-snippets";
-
-	@Rule
-	public JUnitRestDocumentation restDocumentation = new JUnitRestDocumentation(OUTPUT);
-
-	@Rule
-	public TestName testName = new TestName();
-
-	@Before
-	public void setup() {
-		RestAssuredMockMvc.standaloneSetup(MockMvcBuilders
-				.standaloneSetup(new FraudDetectionController())
-				.apply(documentationConfiguration(this.restDocumentation))
-				.alwaysDo(document(
-						getClass().getSimpleName() + "_" + testName.getMethodName())));
-	}
-
-}</code></pre>
-</div>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-You don&#8217;t need to specify the output directory for the generated snippets since version 1.2.0.RELEASE of Spring REST Docs.
-</td>
-</tr>
-</table>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_customization"><a class="link" href="#_customization">9. Customization</a></h2>
-<div class="sectionbody">
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-This section is valid only for Groovy DSL
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>You can customize the Spring Cloud Contract Verifier by extending the DSL, as shown in
-the remainder of this section.</p>
-</div>
-<div class="sect2">
-<h3 id="_extending_the_dsl"><a class="link" href="#_extending_the_dsl">9.1. Extending the DSL</a></h3>
-<div class="paragraph">
-<p>You can provide your own functions to the DSL. The key requirement for this feature is to
-maintain the static compatibility. Later in this document, you can see examples of:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Creating a JAR with reusable classes.</p>
-</li>
-<li>
-<p>Referencing of these classes in the DSLs.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>You can find the full example
-<a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples">here</a>.</p>
-</div>
-<div class="sect3">
-<h4 id="_common_jar"><a class="link" href="#_common_jar">9.1.1. Common JAR</a></h4>
-<div class="paragraph">
-<p>The following examples show three classes that can be reused in the DSLs.</p>
-</div>
-<div class="paragraph">
-<p><strong>PatternUtils</strong> contains functions used by both the <strong>consumer</strong> and the <strong>producer</strong>.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package com.example;
-
-import java.util.regex.Pattern;
-
-/**
- * If you want to use {@link Pattern} directly in your tests
- * then you can create a class resembling this one. It can
- * contain all the {@link Pattern} you want to use in the DSL.
- *
- * &lt;pre&gt;
- * {@code
- * request {
- *     body(
- *         [ age: $(c(PatternUtils.oldEnough()))]
- *     )
- * }
- * &lt;/pre&gt;
- *
- * Notice that we're using both {@code $()} for dynamic values
- * and {@code c()} for the consumer side.
- *
- * @author Marcin Grzejszczak
- */
-//tag::impl[]
-public class PatternUtils {
-
-	public static String tooYoung() {
-		//remove::start[]
-		return "[0-1][0-9]";
-		//remove::end[return]
-	}
-
-	public static Pattern oldEnough() {
-		//remove::start[]
-		return Pattern.compile("[2-9][0-9]");
-		//remove::end[return]
-	}
-
-	/**
-	 * Makes little sense but it's just an example ;)
-	 */
-	public static Pattern ok() {
-		//remove::start[]
-		return Pattern.compile("OK");
-		//remove::end[return]
-	}
-}
-//end::impl[]</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>ConsumerUtils</strong> contains functions used by the <strong>consumer</strong>.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package com.example;
-
-import org.springframework.cloud.contract.spec.internal.ClientDslProperty;
-
-/**
- * DSL Properties passed to the DSL from the consumer's perspective.
- * That means that on the input side {@code Request} for HTTP
- * or {@code Input} for messaging you can have a regular expression.
- * On the {@code Response} for HTTP or {@code Output} for messaging
- * you have to have a concrete value.
- *
- * @author Marcin Grzejszczak
- */
-//tag::impl[]
-public class ConsumerUtils {
-	/**
-	 * Consumer side property. By using the {@link ClientDslProperty}
-	 * you can omit most of boilerplate code from the perspective
-	 * of dynamic values. Example
-	 *
-	 * &lt;pre&gt;
-	 * {@code
-	 * request {
-	 *     body(
-	 *         [ age: $(ConsumerUtils.oldEnough())]
-	 *     )
-	 * }
-	 * &lt;/pre&gt;
-	 *
-	 * That way it's in the implementation that we decide what value we will pass to the consumer
-	 * and which one to the producer.
-	 *
-	 * @author Marcin Grzejszczak
-	 */
-	public static ClientDslProperty oldEnough() {
-		//remove::start[]
-		// this example is not the best one and
-		// theoretically you could just pass the regex instead of `ServerDslProperty` but
-		// it's just to show some new tricks :)
-		return new ClientDslProperty(PatternUtils.oldEnough(), 40);
-		//remove::end[return]
-	}
-
-}
-//end::impl[]</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p><strong>ProducerUtils</strong> contains functions used by the <strong>producer</strong>.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package com.example;
-
-import org.springframework.cloud.contract.spec.internal.ServerDslProperty;
-
-/**
- * DSL Properties passed to the DSL from the producer's perspective.
- * That means that on the input side {@code Request} for HTTP
- * or {@code Input} for messaging you have to have a concrete value.
- * On the {@code Response} for HTTP or {@code Output} for messaging
- * you can have a regular expression.
- *
- * @author Marcin Grzejszczak
- */
-//tag::impl[]
-public class ProducerUtils {
-
-	/**
-	 * Producer side property. By using the {@link ProducerUtils}
-	 * you can omit most of boilerplate code from the perspective
-	 * of dynamic values. Example
-	 *
-	 * &lt;pre&gt;
-	 * {@code
-	 * response {
-	 *     body(
-	 *         [ status: $(ProducerUtils.ok())]
-	 *     )
-	 * }
-	 * &lt;/pre&gt;
-	 *
-	 * That way it's in the implementation that we decide what value we will pass to the consumer
-	 * and which one to the producer.
-	 */
-	public static ServerDslProperty ok() {
-		// this example is not the best one and
-		// theoretically you could just pass the regex instead of `ServerDslProperty` but
-		// it's just to show some new tricks :)
-		return new ServerDslProperty( PatternUtils.ok(), "OK");
-	}
-}
-//end::impl[]</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_adding_the_dependency_to_the_project"><a class="link" href="#_adding_the_dependency_to_the_project">9.1.2. Adding the Dependency to the Project</a></h4>
-<div class="paragraph">
-<p>In order for the plugins and IDE to be able to reference the common JAR classes, you need
-to pass the dependency to your project.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_test_the_dependency_in_the_projects_dependencies"><a class="link" href="#_test_the_dependency_in_the_projects_dependencies">9.1.3. Test the Dependency in the Project&#8217;s Dependencies</a></h4>
-<div class="paragraph">
-<p>First, add the common jar dependency as a test dependency. Because your contracts files
-are available on the test resources path,  the common jar classes automatically become
-visible in your Groovy files. The following examples show how to test the dependency:</p>
-</div>
-<div class="listingblock primary">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
-	&lt;groupId&gt;com.example&lt;/groupId&gt;
-	&lt;artifactId&gt;beer-common&lt;/artifactId&gt;
-	&lt;version&gt;${project.version}&lt;/version&gt;
-	&lt;scope&gt;test&lt;/scope&gt;
-&lt;/dependency&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock secondary">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile("com.example:beer-common:0.0.1.BUILD-SNAPSHOT")</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_test_a_dependency_in_the_plugins_dependencies"><a class="link" href="#_test_a_dependency_in_the_plugins_dependencies">9.1.4. Test a Dependency in the Plugin&#8217;s Dependencies</a></h4>
-<div class="paragraph">
-<p>Now, you must add the dependency for the plugin to reuse at runtime, as shown in the
-following example:</p>
-</div>
-<div class="listingblock primary">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-	&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-	&lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-	&lt;extensions&gt;true&lt;/extensions&gt;
-	&lt;configuration&gt;
-		&lt;packageWithBaseClasses&gt;com.example&lt;/packageWithBaseClasses&gt;
-		&lt;baseClassMappings&gt;
-			&lt;baseClassMapping&gt;
-				&lt;contractPackageRegex&gt;.*intoxication.*&lt;/contractPackageRegex&gt;
-				&lt;baseClassFQN&gt;com.example.intoxication.BeerIntoxicationBase&lt;/baseClassFQN&gt;
-			&lt;/baseClassMapping&gt;
-		&lt;/baseClassMappings&gt;
-	&lt;/configuration&gt;
-	&lt;dependencies&gt;
-		&lt;dependency&gt;
-			&lt;groupId&gt;com.example&lt;/groupId&gt;
-			&lt;artifactId&gt;beer-common&lt;/artifactId&gt;
-			&lt;version&gt;${project.version}&lt;/version&gt;
-			&lt;scope&gt;compile&lt;/scope&gt;
-		&lt;/dependency&gt;
-	&lt;/dependencies&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock secondary">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">classpath "com.example:beer-common:0.0.1.BUILD-SNAPSHOT"</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_referencing_classes_in_dsls"><a class="link" href="#_referencing_classes_in_dsls">9.1.5. Referencing classes in DSLs</a></h4>
-<div class="paragraph">
-<p>You can now reference your classes in your DSL, as shown in the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package contracts.beer.rest
-
-import com.example.ConsumerUtils
-import com.example.ProducerUtils
-import org.springframework.cloud.contract.spec.Contract
-
-Contract.make {
-	description("""
-Represents a successful scenario of getting a beer
-
-```
-given:
-	client is old enough
-when:
-	he applies for a beer
-then:
-	we'll grant him the beer
-```
-
-""")
-	request {
-		method 'POST'
-		url '/check'
-		body(
-				age: $(ConsumerUtils.oldEnough())
-		)
-		headers {
-			contentType(applicationJson())
-		}
-	}
-	response {
-		status 200
-		body("""
-			{
-				"status": "${value(ProducerUtils.ok())}"
-			}
-			""")
-		headers {
-			contentType(applicationJson())
-		}
-	}
-}</code></pre>
-</div>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-You can set the Spring Cloud Contract plugin up by setting <code>convertToYaml</code> to <code>true</code>. That way you will NOT have to add the dependency with the extended functionality to the consumer side, since the consumer side will be using YAML contracts instead of Groovy ones.
-</td>
-</tr>
-</table>
-</div>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_using_the_pluggable_architecture"><a class="link" href="#_using_the_pluggable_architecture">10. Using the Pluggable Architecture</a></h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>You may encounter cases where you have your contracts have been defined in other formats,
-such as YAML, RAML or PACT. In those cases, you still want to benefit from the automatic
-generation of tests and stubs. You can add your own implementation for generating both
-tests and stubs. Also, you can customize the way tests are generated (for example, you
-can generate tests for other languages) and the way stubs are generated (for example, you
-can generate stubs for other HTTP server implementations).</p>
-</div>
-<div class="sect2">
-<h3 id="_custom_contract_converter"><a class="link" href="#_custom_contract_converter">10.1. Custom Contract Converter</a></h3>
-<div class="paragraph">
-<p>The <code>ContractConverter</code> interface lets you register your own implementation of a contract
-structure converter. The following code listing shows the <code>ContractConverter</code> interface:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package org.springframework.cloud.contract.spec;
-
-import java.io.File;
-import java.util.Collection;
-
-/**
- * Converter to be used to convert FROM {@link File} TO {@link Contract} and from
- * {@link Contract} to {@code T}.
- *
- * @param &lt;T&gt; - type to which we want to convert the contract
- * @author Marcin Grzejszczak
- * @since 1.1.0
- */
-public interface ContractConverter&lt;T&gt; extends ContractStorer&lt;T&gt; {
-
-	/**
-	 * Should this file be accepted by the converter. Can use the file extension to check
-	 * if the conversion is possible.
-	 * @param file - file to be considered for conversion
-	 * @return - {@code true} if the given implementation can convert the file
-	 */
-	boolean isAccepted(File file);
-
-	/**
-	 * Converts the given {@link File} to its {@link Contract} representation.
-	 * @param file - file to convert
-	 * @return - {@link Contract} representation of the file
-	 */
-	Collection&lt;Contract&gt; convertFrom(File file);
-
-	/**
-	 * Converts the given {@link Contract} to a {@link T} representation.
-	 * @param contract - the parsed contract
-	 * @return - {@link T} the type to which we do the conversion
-	 */
-	T convertTo(Collection&lt;Contract&gt; contract);
-
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Your implementation must define the condition on which it should start the
-conversion. Also, you must define how to perform that conversion in both directions.</p>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-Once you create your implementation, you must create a
-<code>/META-INF/spring.factories</code> file in which you provide the fully qualified name of your
-implementation.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>The following example shows a typical <code>spring.factories</code> file:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code>org.springframework.cloud.contract.spec.ContractConverter=\
-org.springframework.cloud.contract.verifier.converter.YamlContractConverter</code></pre>
-</div>
-</div>
-<div class="sect3">
-<h4 id="pact-converter"><a class="link" href="#pact-converter">10.1.1. Pact Converter</a></h4>
-<div class="paragraph">
-<p>Spring Cloud Contract includes support for <a href="https://docs.pact.io/">Pact</a> representation of
-contracts up until v4. Instead of using the Groovy DSL, you can use Pact files. In this section, we
-present how to add Pact support for your project. Note however that not all functionality is supported.
-Starting with v3 you can combine multiple matcher for the same element;
-you can use matchers for the body, headers, request and path; and you can use value generators.
-Spring Cloud Contract currently only supports multiple matchers that are combined using the AND rule logic.
-Next to that the request and path matchers are skipped during the conversion.
-When using a date, time or datetime value generator with a given format,
-the given format will be skipped and the ISO format will be used.</p>
-</div>
-<div class="paragraph">
-<p>In order to properly support the Spring Cloud Contract way of doing messaging
-with Pact you&#8217;ll have to provide some additional meta data entries. Below you can find a list of such entries:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>to define the destination to which a message gets sent, you have to
-set a <code>metaData</code> entry in the Pact file, with key <code>sentTo</code> equal to the destination to which a message is to be sent. E.g. <code>"metaData": { "sentTo": "activemq:output" }</code></p>
-</li>
-</ul>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_pact_contract"><a class="link" href="#_pact_contract">10.1.2. Pact Contract</a></h4>
-<div class="paragraph">
-<p>Consider following example of a Pact contract, which is a file under the
-<code>src/test/resources/contracts</code> folder.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">{
-  "provider": {
-    "name": "Provider"
-  },
-  "consumer": {
-    "name": "Consumer"
-  },
-  "interactions": [
-    {
-      "description": "",
-      "request": {
-        "method": "PUT",
-        "path": "/fraudcheck",
-        "headers": {
-          "Content-Type": "application/vnd.fraud.v1+json"
-        },
-        "body": {
-          "clientId": "1234567890",
-          "loanAmount": 99999
-        },
-        "generators": {
-          "body": {
-            "$.clientId": {
-              "type": "Regex",
-              "regex": "[0-9]{10}"
-            }
-          }
-        },
-        "matchingRules": {
-          "header": {
-            "Content-Type": {
-              "matchers": [
-                {
-                  "match": "regex",
-                  "regex": "application/vnd\\.fraud\\.v1\\+json.*"
-                }
-              ],
-              "combine": "AND"
-            }
-          },
-          "body": {
-            "$.clientId": {
-              "matchers": [
-                {
-                  "match": "regex",
-                  "regex": "[0-9]{10}"
-                }
-              ],
-              "combine": "AND"
-            }
-          }
-        }
-      },
-      "response": {
-        "status": 200,
-        "headers": {
-          "Content-Type": "application/vnd.fraud.v1+json"
-        },
-        "body": {
-          "fraudCheckStatus": "FRAUD",
-          "rejectionReason": "Amount too high"
-        },
-        "matchingRules": {
-          "header": {
-            "Content-Type": {
-              "matchers": [
-                {
-                  "match": "regex",
-                  "regex": "application/vnd\\.fraud\\.v1\\+json.*"
-                }
-              ],
-              "combine": "AND"
-            }
-          },
-          "body": {
-            "$.fraudCheckStatus": {
-              "matchers": [
-                {
-                  "match": "regex",
-                  "regex": "FRAUD"
-                }
-              ],
-              "combine": "AND"
-            }
-          }
-        }
-      }
-    }
-  ],
-  "metadata": {
-    "pact-specification": {
-      "version": "3.0.0"
-    },
-    "pact-jvm": {
-      "version": "3.5.13"
-    }
-  }
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The remainder of this section about using Pact refers to the preceding file.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_pact_for_producers"><a class="link" href="#_pact_for_producers">10.1.3. Pact for Producers</a></h4>
-<div class="paragraph">
-<p>On the producer side, you must add two additional dependencies to your plugin
-configuration. One is the Spring Cloud Contract Pact support, and the other represents
-the current Pact version that you use.</p>
-</div>
-<div class="listingblock primary">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
-	&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
-	&lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-	&lt;extensions&gt;true&lt;/extensions&gt;
-	&lt;configuration&gt;
-		&lt;packageWithBaseClasses&gt;com.example.fraud&lt;/packageWithBaseClasses&gt;
-	&lt;/configuration&gt;
-	&lt;dependencies&gt;
-		&lt;dependency&gt;
-			&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-			&lt;artifactId&gt;spring-cloud-contract-pact&lt;/artifactId&gt;
-			&lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
-		&lt;/dependency&gt;
-	&lt;/dependencies&gt;
-&lt;/plugin&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock secondary">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">classpath "org.springframework.cloud:spring-cloud-contract-pact:${findProperty('verifierVersion') ?: verifierVersion}"</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>When you execute the build of your application, a test will be generated. The generated
-test might be as follows:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
-public void validate_shouldMarkClientAsFraud() throws Exception {
-	// given:
-		MockMvcRequestSpecification request = given()
-				.header("Content-Type", "application/vnd.fraud.v1+json")
-				.body("{\"clientId\":\"1234567890\",\"loanAmount\":99999}");
-
-	// when:
-		ResponseOptions response = given().spec(request)
-				.put("/fraudcheck");
-
-	// then:
-		assertThat(response.statusCode()).isEqualTo(200);
-		assertThat(response.header("Content-Type")).matches("application/vnd\\.fraud\\.v1\\+json.*");
-	// and:
-		DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
-		assertThatJson(parsedJson).field("['rejectionReason']").isEqualTo("Amount too high");
-	// and:
-		assertThat(parsedJson.read("$.fraudCheckStatus", String.class)).matches("FRAUD");
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The corresponding generated stub might be as follows:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">{
-  "id" : "996ae5ae-6834-4db6-8fac-358ca187ab62",
-  "uuid" : "996ae5ae-6834-4db6-8fac-358ca187ab62",
-  "request" : {
-    "url" : "/fraudcheck",
-    "method" : "PUT",
-    "headers" : {
-      "Content-Type" : {
-        "matches" : "application/vnd\\.fraud\\.v1\\+json.*"
-      }
-    },
-    "bodyPatterns" : [ {
-      "matchesJsonPath" : "$[?(@.['loanAmount'] == 99999)]"
-    }, {
-      "matchesJsonPath" : "$[?(@.clientId =~ /([0-9]{10})/)]"
-    } ]
-  },
-  "response" : {
-    "status" : 200,
-    "body" : "{\"fraudCheckStatus\":\"FRAUD\",\"rejectionReason\":\"Amount too high\"}",
-    "headers" : {
-      "Content-Type" : "application/vnd.fraud.v1+json;charset=UTF-8"
-    },
-    "transformers" : [ "response-template" ]
-  },
-}</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_pact_for_consumers"><a class="link" href="#_pact_for_consumers">10.1.4. Pact for Consumers</a></h4>
-<div class="paragraph">
-<p>On the producer side, you must add two additional dependencies to your project
-dependencies. One is the Spring Cloud Contract Pact support, and the other represents the
-current Pact version that you use.</p>
-</div>
-<div class="listingblock primary">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
-	&lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-	&lt;artifactId&gt;spring-cloud-contract-pact&lt;/artifactId&gt;
-	&lt;scope&gt;test&lt;/scope&gt;
-&lt;/dependency&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock secondary">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile "org.springframework.cloud:spring-cloud-contract-pact"</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_using_the_custom_test_generator"><a class="link" href="#_using_the_custom_test_generator">10.2. Using the Custom Test Generator</a></h3>
-<div class="paragraph">
-<p>If you want to generate tests for languages other than Java or you are not happy with the
-way the verifier builds Java tests, you can register your own implementation.</p>
-</div>
-<div class="paragraph">
-<p>The <code>SingleTestGenerator</code> interface lets you register your own implementation.  The
-following code listing shows the <code>SingleTestGenerator</code> interface:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package org.springframework.cloud.contract.verifier.builder;
-
-import java.nio.file.Path;
-import java.util.Collection;
-
-import org.springframework.cloud.contract.verifier.config.ContractVerifierConfigProperties;
-import org.springframework.cloud.contract.verifier.file.ContractMetadata;
-
-/**
- * Builds a single test.
- *
- * @since 1.1.0
- */
-public interface SingleTestGenerator {
-
-	/**
-	 * Creates contents of a single test class in which all test scenarios from the
-	 * contract metadata should be placed.
-	 * @param properties - properties passed to the plugin
-	 * @param listOfFiles - list of parsed contracts with additional metadata
-	 * @param className - the name of the generated test class
-	 * @param classPackage - the name of the package in which the test class should be
-	 * stored
-	 * @param includedDirectoryRelativePath - relative path to the included directory
-	 * @return contents of a single test class
-	 * @deprecated use{@link SingleTestGenerator#buildClass(ContractVerifierConfigProperties, Collection, String, GeneratedClassData)}
-	 */
-	@Deprecated
-	String buildClass(ContractVerifierConfigProperties properties,
-			Collection&lt;ContractMetadata&gt; listOfFiles, String className,
-			String classPackage, String includedDirectoryRelativePath);
-
-	/**
-	 * Creates contents of a single test class in which all test scenarios from the
-	 * contract metadata should be placed.
-	 * @param properties - properties passed to the plugin
-	 * @param listOfFiles - list of parsed contracts with additional metadata
-	 * @param generatedClassData - information about the generated class
-	 * @param includedDirectoryRelativePath - relative path to the included directory
-	 * @return contents of a single test class
-	 */
-	default String buildClass(ContractVerifierConfigProperties properties,
-			Collection&lt;ContractMetadata&gt; listOfFiles,
-			String includedDirectoryRelativePath, GeneratedClassData generatedClassData) {
-		String className = generatedClassData.className;
-		String classPackage = generatedClassData.classPackage;
-		String path = includedDirectoryRelativePath;
-		return buildClass(properties, listOfFiles, className, classPackage, path);
-	}
-
-	/**
-	 * Extension that should be appended to the generated test class. E.g. {@code .java}
-	 * or {@code .php}
-	 * @param properties - properties passed to the plugin
-	 */
-	String fileExtension(ContractVerifierConfigProperties properties);
-
-	class GeneratedClassData {
-
-		public final String className;
-
-		public final String classPackage;
-
-		public final Path testClassPath;
-
-		public GeneratedClassData(String className, String classPackage,
-				Path testClassPath) {
-			this.className = className;
-			this.classPackage = classPackage;
-			this.testClassPath = testClassPath;
-		}
-
-	}
-
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Again, you must provide a <code>spring.factories</code> file, such as the one shown in the following
-example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code>org.springframework.cloud.contract.verifier.builder.SingleTestGenerator=/
-com.example.MyGenerator</code></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_using_the_custom_stub_generator"><a class="link" href="#_using_the_custom_stub_generator">10.3. Using the Custom Stub Generator</a></h3>
-<div class="paragraph">
-<p>If you want to generate stubs for stub servers other than WireMock, you can plug in your
-own implementation of the <code>StubGenerator</code> interface. The following code listing shows the
-<code>StubGenerator</code> interface:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package org.springframework.cloud.contract.verifier.converter;
-
-import java.util.Map;
-
-import org.springframework.cloud.contract.spec.Contract;
-import org.springframework.cloud.contract.verifier.file.ContractMetadata;
-
-/**
- * Converts contracts into their stub representation.
- *
- * @since 1.1.0
- */
-public interface StubGenerator {
-
-	/**
-	 * @param fileName - file name
-	 * @return {@code true} if the converter can handle the file to convert it into a
-	 * stub.
-	 */
-	default boolean canHandleFileName(String fileName) {
-		return fileName.endsWith(fileExtension());
-	}
-
-	/**
-	 * @param rootName - root name of the contract
-	 * @param content - metadata of the contract
-	 * @return the collection of converted contracts into stubs. One contract can result
-	 * in multiple stubs.
-	 */
-	Map&lt;Contract, String&gt; convertContents(String rootName, ContractMetadata content);
-
-	/**
-	 * @param inputFileName - name of the input file
-	 * @return the name of the converted stub file. If you have multiple contracts in a
-	 * single file then a prefix will be added to the generated file. If you provide the
-	 * {@link Contract#name} field then that field will override the generated file name.
-	 *
-	 * Example: name of file with 2 contracts is {@code foo.groovy}, it will be converted
-	 * by the implementation to {@code foo.json}. The recursive file converter will create
-	 * two files {@code 0_foo.json} and {@code 1_foo.json}
-	 */
-	String generateOutputFileNameForInput(String inputFileName);
-
-	/**
-	 * Describes the file extension that this stub generator can handle.
-	 * @return string describing the file extension
-	 */
-	default String fileExtension() {
-		return ".json";
-	}
-
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Again, you must provide a <code>spring.factories</code> file, such as the one shown in the following
-example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code># Stub converters
-org.springframework.cloud.contract.verifier.converter.StubGenerator=\
-org.springframework.cloud.contract.verifier.wiremock.DslToWireMockClientConverter</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The default implementation is the WireMock stub generation.</p>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-You can provide multiple stub generator implementations. For example, from a single
-DSL, you can produce both WireMock stubs and Pact files.
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_using_the_custom_stub_runner"><a class="link" href="#_using_the_custom_stub_runner">10.4. Using the Custom Stub Runner</a></h3>
-<div class="paragraph">
-<p>If you decide to use a custom stub generation, you also need a custom way of running
-stubs with your different stub provider.</p>
-</div>
-<div class="paragraph">
-<p>Assume that you use <a href="https://github.com/dreamhead/moco">Moco</a> to build your stubs and that
-you have written a stub generator and placed your stubs in a JAR file.</p>
-</div>
-<div class="paragraph">
-<p>In order for Stub Runner to know how to run your stubs, you have to define a custom
-HTTP Stub server implementation, which might resemble the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package org.springframework.cloud.contract.stubrunner.provider.moco
-
-import com.github.dreamhead.moco.bootstrap.arg.HttpArgs
-import com.github.dreamhead.moco.runner.JsonRunner
-import com.github.dreamhead.moco.runner.RunnerSetting
-import groovy.util.logging.Commons
-
-import org.springframework.cloud.contract.stubrunner.HttpServerStub
-import org.springframework.util.SocketUtils
-
-@Commons
-class MocoHttpServerStub implements HttpServerStub {
-
-	private boolean started
-	private JsonRunner runner
-	private int port
-
-	@Override
-	int port() {
-		if (!isRunning()) {
-			return -1
-		}
-		return port
-	}
-
-	@Override
-	boolean isRunning() {
-		return started
-	}
-
-	@Override
-	HttpServerStub start() {
-		return start(SocketUtils.findAvailableTcpPort())
-	}
-
-	@Override
-	HttpServerStub start(int port) {
-		this.port = port
-		return this
-	}
-
-	@Override
-	HttpServerStub stop() {
-		if (!isRunning()) {
-			return this
-		}
-		this.runner.stop()
-		return this
-	}
-
-	@Override
-	HttpServerStub registerMappings(Collection&lt;File&gt; stubFiles) {
-		List&lt;RunnerSetting&gt; settings = stubFiles.findAll { it.name.endsWith("json") }
-			.collect {
-			log.info("Trying to parse [${it.name}]")
-			try {
-				return RunnerSetting.aRunnerSetting().withStream(it.newInputStream()).
-					build()
-			}
-			catch (Exception e) {
-				log.warn("Exception occurred while trying to parse file [${it.name}]", e)
-				return null
-			}
-		}.findAll { it }
-		this.runner = JsonRunner.newJsonRunnerWithSetting(settings,
-			HttpArgs.httpArgs().withPort(this.port).build())
-		this.runner.run()
-		this.started = true
-		return this
-	}
-
-	@Override
-	String registeredMappings() {
-		return ""
-	}
-
-	@Override
-	boolean isAccepted(File file) {
-		return file.name.endsWith(".json")
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Then, you can register it in your <code>spring.factories</code> file, as shown in the following
-example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code>org.springframework.cloud.contract.stubrunner.HttpServerStub=\
-org.springframework.cloud.contract.stubrunner.provider.moco.MocoHttpServerStub</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Now you can run stubs with Moco.</p>
-</div>
-<div class="admonitionblock important">
+<div class="hdlist">
 <table>
 <tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
+<td class="hdlist1">
+<a href="legal.html#legal-information">Legal</a> 
 </td>
-<td class="content">
-If you do not provide any implementation, then the default (WireMock)
-implementation is used. If you provide more than one, the first one on the list is used.
+<td class="hdlist2">
+<p>Legal information.</p>
 </td>
 </tr>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_using_the_custom_stub_downloader"><a class="link" href="#_using_the_custom_stub_downloader">10.5. Using the Custom Stub Downloader</a></h3>
-<div class="paragraph">
-<p>You can customize the way your stubs are downloaded by creating an implementation of the
-<code>StubDownloaderBuilder</code> interface, as shown in the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package com.example;
-
-class CustomStubDownloaderBuilder implements StubDownloaderBuilder {
-
-	@Override
-	public StubDownloader build(final StubRunnerOptions stubRunnerOptions) {
-		return new StubDownloader() {
-			@Override
-			public Map.Entry&lt;StubConfiguration, File&gt; downloadAndUnpackStubJar(
-					StubConfiguration config) {
-				File unpackedStubs = retrieveStubs();
-				return new AbstractMap.SimpleEntry&lt;&gt;(
-						new StubConfiguration(config.getGroupId(), config.getArtifactId(), version,
-								config.getClassifier()), unpackedStubs);
-			}
-
-			File retrieveStubs() {
-			    // here goes your custom logic to provide a folder where all the stubs reside
-			}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Then you can register it in your <code>spring.factories</code> file, as shown in the following
-example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code># Example of a custom Stub Downloader Provider
-org.springframework.cloud.contract.stubrunner.StubDownloaderBuilder=\
-com.example.CustomStubDownloaderBuilder</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Now you can pick a folder with the source of your stubs.</p>
-</div>
-<div class="admonitionblock important">
-<table>
 <tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
+<td class="hdlist1">
+<a href="documentation-overview.html#contract-documentation">Documentation Overview</a> 
 </td>
-<td class="content">
-If you do not provide any implementation, then the default is used (scan classpath).
-If you provide the <code>stubsMode = StubRunnerProperties.StubsMode.LOCAL</code> or
-<code>, stubsMode = StubRunnerProperties.StubsMode.REMOTE</code> then the Aether implementation will be used
-If you provide more than one, then the first one on the list is used.
+<td class="hdlist2">
+<p>About the Documentation, Getting Help, First Steps, and more.</p>
 </td>
 </tr>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="scm-stub-downloader"><a class="link" href="#scm-stub-downloader">10.6. Using the SCM Stub Downloader</a></h3>
-<div class="paragraph">
-<p>Whenever the <code>repositoryRoot</code> starts with a SCM protocol
-(currently we support only <code>git://</code>), the stub downloader will try
-to clone the repository and use it as a source of contracts
-to generate tests or stubs.</p>
-</div>
-<div class="paragraph">
-<p>Either via environment variables, system properties, properties set
-inside the plugin or contracts repository configuration you can
-tweak the downloader&#8217;s behaviour. Below you can find the list of
-properties</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 1. SCM Stub Downloader properties</caption>
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Type of a property</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Name of the property</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Description</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>git.branch</code> (plugin prop)</p>
-<p class="tableblock">* <code>stubrunner.properties.git.branch</code> (system prop)</p>
-<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_GIT_BRANCH</code> (env prop)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">master</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Which branch to checkout</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>git.username</code> (plugin prop)</p>
-<p class="tableblock">* <code>stubrunner.properties.git.username</code> (system prop)</p>
-<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_GIT_USERNAME</code> (env prop)</p></td>
-<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Git clone username</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>git.password</code> (plugin prop)</p>
-<p class="tableblock">* <code>stubrunner.properties.git.password</code> (system prop)</p>
-<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_GIT_PASSWORD</code> (env prop)</p></td>
-<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Git clone password</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>git.no-of-attempts</code> (plugin prop)</p>
-<p class="tableblock">* <code>stubrunner.properties.git.no-of-attempts</code> (system prop)</p>
-<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_GIT_NO_OF_ATTEMPTS</code> (env prop)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">10</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of attempts to push the commits to <code>origin</code></p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>git.wait-between-attempts</code> (Plugin prop)</p>
-<p class="tableblock">* <code>stubrunner.properties.git.wait-between-attempts</code>  (system prop)</p>
-<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_GIT_WAIT_BETWEEN_ATTEMPTS</code>  (env prop)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">1000</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of millis to wait between attempts to push the commits to <code>origin</code></p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="sect2">
-<h3 id="pact-stub-downloader"><a class="link" href="#pact-stub-downloader">10.7. Using the Pact Stub Downloader</a></h3>
-<div class="paragraph">
-<p>Whenever the <code>repositoryRoot</code> starts with a Pact protocol
-(starts with <code>pact://</code>), the stub downloader will try
-to fetch the Pact contract definitions from the Pact Broker.
-Whatever is set after <code>pact://</code> will be parsed as the Pact Broker URL.</p>
-</div>
-<div class="paragraph">
-<p>Either via environment variables, system properties, properties set
-inside the plugin or contracts repository configuration you can
-tweak the downloader&#8217;s behaviour. Below you can find the list of
-properties</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 2. SCM Stub Downloader properties</caption>
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Name of a property</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Default</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Description</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.host</code> (plugin prop)</p>
-<p class="tableblock">* <code>stubrunner.properties.pactbroker.host</code> (system prop)</p>
-<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_HOST</code> (env prop)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Host from URL passed to <code>repositoryRoot</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">What is the URL of Pact Broker</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.port</code> (plugin prop)</p>
-<p class="tableblock">* <code>stubrunner.properties.pactbroker.port</code> (system prop)</p>
-<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_PORT</code> (env prop)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Port from URL passed to <code>repositoryRoot</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">What is the port of Pact Broker</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.protocol</code> (plugin prop)</p>
-<p class="tableblock">* <code>stubrunner.properties.pactbroker.protocol</code> (system prop)</p>
-<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_PROTOCOL</code> (env prop)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Protocol from URL passed to <code>repositoryRoot</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">What is the protocol of Pact Broker</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.tags</code> (plugin prop)</p>
-<p class="tableblock">* <code>stubrunner.properties.pactbroker.tags</code> (system prop)</p>
-<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_TAGS</code> (env prop)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Version of the stub, or <code>latest</code> if version is <code>+</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">What tags should be used to fetch the stub</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.auth.scheme</code> (plugin prop)</p>
-<p class="tableblock">* <code>stubrunner.properties.pactbroker.auth.scheme</code> (system prop)</p>
-<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_AUTH_SCHEME</code> (env prop)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Basic</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">What kind of authentication should be used to connect to the Pact Broker</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.auth.username</code> (plugin prop)</p>
-<p class="tableblock">* <code>stubrunner.properties.pactbroker.auth.username</code> (system prop)</p>
-<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_AUTH_USERNAME</code> (env prop)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The username passed to <code>contractsRepositoryUsername</code> (maven) or <code>contractRepository.username</code> (gradle)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Username used to connect to the Pact Broker</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.auth.password</code> (plugin prop)</p>
-<p class="tableblock">* <code>stubrunner.properties.pactbroker.auth.password</code> (system prop)</p>
-<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_AUTH_PASSWORD</code> (env prop)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The password passed to <code>contractsRepositoryPassword</code> (maven) or <code>contractRepository.password</code> (gradle)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Password used to connect to the Pact Broker</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.provider-name-with-group-id</code> (plugin prop)</p>
-<p class="tableblock">* <code>stubrunner.properties.pactbroker.provider-name-with-group-id</code> (system prop)</p>
-<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_PROVIDER_NAME_WITH_GROUP_ID</code> (env prop)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">When <code>true</code>, the provider name will be a combination of <code>groupId:artifactId</code>. If <code>false</code>, just <code>artifactId</code> is used</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_spring_cloud_contract_wiremock"><a class="link" href="#_spring_cloud_contract_wiremock">11. Spring Cloud Contract WireMock</a></h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The Spring Cloud Contract WireMock modules let you use <a href="https://github.com/tomakehurst/wiremock">WireMock</a> in a
-Spring Boot application. Check out the
-<a href="https://github.com/spring-cloud/spring-cloud-contract/tree/master/samples">samples</a>
-for more details.</p>
-</div>
-<div class="paragraph">
-<p>If you have a Spring Boot application that uses Tomcat as an embedded server (which is
-the default with <code>spring-boot-starter-web</code>),  you can add
-<code>spring-cloud-starter-contract-stub-runner</code> to your classpath and add <code>@AutoConfigureWireMock</code> in
-order to be able to use Wiremock in your tests. Wiremock runs as a stub server and you
-can register stub behavior using a Java API or via static JSON declarations as part of
-your test. The following code shows an example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
-@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT)
-@AutoConfigureWireMock(port = 0)
-public class WiremockForDocsTests {
-
-	// A service that calls out over HTTP
-	@Autowired
-	private Service service;
-
-	@Before
-	public void setup() {
-		this.service.setBase("http://localhost:"
-				+ this.environment.getProperty("wiremock.server.port"));
-	}
-
-	// Using the WireMock APIs in the normal way:
-	@Test
-	public void contextLoads() throws Exception {
-		// Stubbing WireMock
-		stubFor(get(urlEqualTo("/resource")).willReturn(aResponse()
-				.withHeader("Content-Type", "text/plain").withBody("Hello World!")));
-		// We're asserting if WireMock responded properly
-		assertThat(this.service.go()).isEqualTo("Hello World!");
-	}
-
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>To start the stub server on a different port use (for example),
-<code>@AutoConfigureWireMock(port=9999)</code>. For a random port, use a value of <code>0</code>. The stub
-server port can be bound in the test application context with the "wiremock.server.port"
-property. Using <code>@AutoConfigureWireMock</code> adds a bean of type <code>WiremockConfiguration</code> to
-your test application context, where it will be cached in between methods and classes
-having the same context, the same as for Spring integration tests. Also you can inject a bean of type <code>WireMockServer</code> into your test.</p>
-</div>
-<div class="sect2">
-<h3 id="_registering_stubs_automatically"><a class="link" href="#_registering_stubs_automatically">11.1. Registering Stubs Automatically</a></h3>
-<div class="paragraph">
-<p>If you use <code>@AutoConfigureWireMock</code>, it registers WireMock JSON stubs from the file
-system or classpath (by default, from <code>file:src/test/resources/mappings</code>). You can
-customize the locations using the <code>stubs</code> attribute in the annotation, which can be an
-Ant-style resource pattern or a directory. In the case of a directory, <code><strong>*/</strong>.json</code> is
-appended. The following code shows an example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>@RunWith(SpringRunner.class)
-@SpringBootTest
-@AutoConfigureWireMock(stubs="classpath:/stubs")
-public class WiremockImportApplicationTests {
-
-	@Autowired
-	private Service service;
-
-	@Test
-	public void contextLoads() throws Exception {
-		assertThat(this.service.go()).isEqualTo("Hello World!");
-	}
-
-}</pre>
-</div>
-</div>
-<div class="admonitionblock note">
-<table>
 <tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<td class="hdlist1">
+<a href="getting-started.html#getting-started">Getting Started</a> 
 </td>
-<td class="content">
-Actually, WireMock always loads mappings from <code>src/test/resources/mappings</code> <strong>as
-well as</strong> the custom locations in the stubs attribute. To change this behavior, you can
-also specify a files root as described in the next section of this document.
+<td class="hdlist2">
+<p>Introducing Spring Cloud Contract, Developing Your First Spring Cloud Contract-based Application</p>
 </td>
 </tr>
-</table>
-</div>
-<div class="paragraph">
-<p>If you&#8217;re using Spring Cloud Contract&#8217;s default stub jars, then your
-stubs are stored under <code>/META-INF/group-id/artifact-id/versions/mappings/</code> folder. If you want to register all stubs from that location, from all embedded JARs, then it&#8217;s enough to use the following syntax.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureWireMock(port = 0, stubs = "classpath*:/META-INF/**/mappings/**/*.json")</code></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_using_files_to_specify_the_stub_bodies"><a class="link" href="#_using_files_to_specify_the_stub_bodies">11.2. Using Files to Specify the Stub Bodies</a></h3>
-<div class="paragraph">
-<p>WireMock can read response bodies from files on the classpath or the file system. In that
-case, you can see in the JSON DSL that the response has a <code>bodyFileName</code> instead of a
-(literal) <code>body</code>. The files are resolved relative to a root directory (by default,
-<code>src/test/resources/__files</code>). To customize this location you can set the <code>files</code>
-attribute in the <code>@AutoConfigureWireMock</code> annotation to the location of the parent
-directory (in other words, <code>__files</code> is a subdirectory). You can use Spring resource
-notation to refer to <code>file:&#8230;&#8203;</code> or <code>classpath:&#8230;&#8203;</code> locations. Generic URLs are not
-supported. A list of values can be given, in which case WireMock resolves the first file
-that exists when it needs to find a response body.</p>
-</div>
-<div class="admonitionblock note">
-<table>
 <tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<td class="hdlist1">
+<a href="using.html#using">Using Spring Cloud Contract</a> 
 </td>
-<td class="content">
-When you configure the <code>files</code> root, it also affects the
-automatic loading of stubs, because they come from the root location
-in a subdirectory called "mappings". The value of <code>files</code> has no
-effect on the stubs loaded explicitly from the <code>stubs</code> attribute.
+<td class="hdlist2">
+<p>Spring Cloud Contract usage examples and workflows</p>
 </td>
 </tr>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_alternative_using_junit_rules"><a class="link" href="#_alternative_using_junit_rules">11.3. Alternative: Using JUnit Rules</a></h3>
-<div class="paragraph">
-<p>For a more conventional WireMock experience, you can use JUnit <code>@Rules</code> to start and stop
-the server. To do so, use the <code>WireMockSpring</code> convenience class to obtain an <code>Options</code>
-instance, as shown in the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
-@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT)
-public class WiremockForDocsClassRuleTests {
-
-	// Start WireMock on some dynamic port
-	// for some reason `dynamicPort()` is not working properly
-	@ClassRule
-	public static WireMockClassRule wiremock = new WireMockClassRule(
-			WireMockSpring.options().dynamicPort());
-
-	// A service that calls out over HTTP to wiremock's port
-	@Autowired
-	private Service service;
-
-	@Before
-	public void setup() {
-		this.service.setBase("http://localhost:" + wiremock.port());
-	}
-
-	// Using the WireMock APIs in the normal way:
-	@Test
-	public void contextLoads() throws Exception {
-		// Stubbing WireMock
-		wiremock.stubFor(get(urlEqualTo("/resource")).willReturn(aResponse()
-				.withHeader("Content-Type", "text/plain").withBody("Hello World!")));
-		// We're asserting if WireMock responded properly
-		assertThat(this.service.go()).isEqualTo("Hello World!");
-	}
-
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The <code>@ClassRule</code> means that the server shuts down after all the methods in this class
-have been run.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_relaxed_ssl_validation_for_rest_template"><a class="link" href="#_relaxed_ssl_validation_for_rest_template">11.4. Relaxed SSL Validation for Rest Template</a></h3>
-<div class="paragraph">
-<p>WireMock lets you stub a "secure" server with an "https" URL protocol. If your
-application wants to contact that stub server in an integration test, it will find that
-the SSL certificates are not valid (the usual problem with self-installed certificates).
-The best option is often to re-configure the client to use "http". If that&#8217;s not an
-option, you can ask Spring to configure an HTTP client that ignores SSL validation errors
-(do so only for tests, of course).</p>
-</div>
-<div class="paragraph">
-<p>To make this work with minimum fuss, you need to be using the Spring Boot
-<code>RestTemplateBuilder</code> in your app, as shown in the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Bean
-public RestTemplate restTemplate(RestTemplateBuilder builder) {
-	return builder.build();
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You need <code>RestTemplateBuilder</code> because the builder is passed through callbacks to
-initialize it, so the SSL validation can be set up in the client at that point. This
-happens automatically in your test if you are using the <code>@AutoConfigureWireMock</code>
-annotation or the stub runner. If you use the JUnit <code>@Rule</code> approach, you need to add the
-<code>@AutoConfigureHttpClient</code> annotation as well, as shown in the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
-@SpringBootTest("app.baseUrl=https://localhost:6443")
-@AutoConfigureHttpClient
-public class WiremockHttpsServerApplicationTests {
-
-	@ClassRule
-	public static WireMockClassRule wiremock = new WireMockClassRule(
-			WireMockSpring.options().httpsPort(6443));
-...
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you are using <code>spring-boot-starter-test</code>, you have the Apache HTTP client on the
-classpath and it is selected by the <code>RestTemplateBuilder</code> and configured to ignore SSL
-errors. If you use the default <code>java.net</code> client, you do not need the annotation (but it
-won&#8217;t do any harm). There is no support currently for other clients, but it may be added
-in future releases.</p>
-</div>
-<div class="paragraph">
-<p>To disable the custom <code>RestTemplateBuilder</code>, set the <code>wiremock.rest-template-ssl-enabled</code>
-property to <code>false</code>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_wiremock_and_spring_mvc_mocks"><a class="link" href="#_wiremock_and_spring_mvc_mocks">11.5. WireMock and Spring MVC Mocks</a></h3>
-<div class="paragraph">
-<p>Spring Cloud Contract provides a convenience class that can load JSON WireMock stubs into
-a Spring <code>MockRestServiceServer</code>. The following code shows an example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
-@SpringBootTest(webEnvironment = WebEnvironment.NONE)
-public class WiremockForDocsMockServerApplicationTests {
-
-	@Autowired
-	private RestTemplate restTemplate;
-
-	@Autowired
-	private Service service;
-
-	@Test
-	public void contextLoads() throws Exception {
-		// will read stubs classpath
-		MockRestServiceServer server = WireMockRestServiceServer.with(this.restTemplate)
-				.baseUrl("https://example.org").stubs("classpath:/stubs/resource.json")
-				.build();
-		// We're asserting if WireMock responded properly
-		assertThat(this.service.go()).isEqualTo("Hello World");
-		server.verify();
-	}
-
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The <code>baseUrl</code> value is prepended to all mock calls, and the <code>stubs()</code> method takes a stub
-path resource pattern as an argument. In the preceding example, the stub defined at
-<code>/stubs/resource.json</code> is loaded into the mock server. If the <code>RestTemplate</code> is asked to
-visit <code><a href="https://example.org/" class="bare">https://example.org/</a></code>, it gets the responses as being declared at that URL. More
-than one stub pattern can be specified, and each one can be a directory (for a recursive
-list of all ".json"), a fixed filename (as in the example above), or an Ant-style
-pattern. The JSON format is the normal WireMock format, which you can read about in the
-<a href="https://wiremock.org/docs/stubbing/">WireMock website</a>.</p>
-</div>
-<div class="paragraph">
-<p>Currently, the Spring Cloud Contract Verifier supports Tomcat, Jetty, and Undertow as
-Spring Boot embedded servers, and Wiremock itself has "native" support for a particular
-version of Jetty (currently 9.2). To use the native Jetty, you need to add the native
-Wiremock dependencies and exclude the Spring Boot container (if there is one).</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_customization_of_wiremock_configuration"><a class="link" href="#_customization_of_wiremock_configuration">11.6. Customization of WireMock configuration</a></h3>
-<div class="paragraph">
-<p>You can register a bean of <code>org.springframework.cloud.contract.wiremock.WireMockConfigurationCustomizer</code> type
-in order to customize the WireMock configuration (e.g. add custom transformers).
-Example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">		@Bean
-		WireMockConfigurationCustomizer optionsCustomizer() {
-			return new WireMockConfigurationCustomizer() {
-				@Override
-				public void customize(WireMockConfiguration options) {
-// perform your customization here
-				}
-			};
-		}</code></pre>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_generating_stubs_using_rest_docs"><a class="link" href="#_generating_stubs_using_rest_docs">11.7. Generating Stubs using REST Docs</a></h3>
-<div class="paragraph">
-<p><a href="https://projects.spring.io/spring-restdocs">Spring REST Docs</a> can be used to generate
-documentation (for example in Asciidoctor format) for an HTTP API with Spring MockMvc
-or <code>WebTestClient</code> or Rest Assured. At the same time that you generate documentation for your API, you can also
-generate WireMock stubs by using Spring Cloud Contract WireMock. To do so, write your
-normal REST Docs test cases and use <code>@AutoConfigureRestDocs</code> to have stubs be
-automatically generated in the REST Docs output directory. The following code shows an
-example using <code>MockMvc</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
-@SpringBootTest
-@AutoConfigureRestDocs(outputDir = "target/snippets")
-@AutoConfigureMockMvc
-public class ApplicationTests {
-
-	@Autowired
-	private MockMvc mockMvc;
-
-	@Test
-	public void contextLoads() throws Exception {
-		mockMvc.perform(get("/resource"))
-				.andExpect(content().string("Hello World"))
-				.andDo(document("resource"));
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This test generates a WireMock stub at "target/snippets/stubs/resource.json". It matches
-all GET requests to the "/resource" path. The same example with <code>WebTestClient</code> (used
-for testing Spring WebFlux applications) would look like this:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
-@SpringBootTest
-@AutoConfigureRestDocs(outputDir = "target/snippets")
-@AutoConfigureWebTestClient
-public class ApplicationTests {
-
-	@Autowired
-	private WebTestClient client;
-
-	@Test
-	public void contextLoads() throws Exception {
-		client.get().uri("/resource").exchange()
-				.expectBody(String.class).isEqualTo("Hello World")
- 				.consumeWith(document("resource"));
-	}
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Without any additional configuration, these tests create a stub with a request matcher
-for the HTTP method and all headers except "host" and "content-length". To match the
-request more precisely (for example, to match the body of a POST or PUT), we need to
-explicitly create a request matcher. Doing so has two effects:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Creating a stub that matches only in the way you specify.</p>
-</li>
-<li>
-<p>Asserting that the request in the test case also matches the same conditions.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>The main entry point for this feature is <code>WireMockRestDocs.verify()</code>, which can be used
-as a substitute for the <code>document()</code> convenience method, as shown in the following
-example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">import static org.springframework.cloud.contract.wiremock.restdocs.WireMockRestDocs.verify;</code></pre>
-</div>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>@RunWith(SpringRunner.class)
-@SpringBootTest
-@AutoConfigureRestDocs(outputDir = "target/snippets")
-@AutoConfigureMockMvc
-public class ApplicationTests {
-
-	@Autowired
-	private MockMvc mockMvc;
-
-	@Test
-	public void contextLoads() throws Exception {
-		mockMvc.perform(post("/resource")
-                .content("{\"id\":\"123456\",\"message\":\"Hello World\"}"))
-				.andExpect(status().isOk())
-				.andDo(verify().jsonPath("$.id")
-                        .stub("resource"));
-	}
-}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This contract specifies that any valid POST with an "id" field receives the response
-defined in this test. You can chain together calls to <code>.jsonPath()</code> to add additional
-matchers. If JSON Path is unfamiliar, The <a href="https://github.com/jayway/JsonPath">JayWay
-documentation</a> can help you get up to speed. The <code>WebTestClient</code> version of this test
-has a similar <code>verify()</code> static helper that you insert in the same place.</p>
-</div>
-<div class="paragraph">
-<p>Instead of the <code>jsonPath</code> and <code>contentType</code> convenience methods, you can also use the
-WireMock APIs to verify that the request matches the created stub, as shown in the
-following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
-public void contextLoads() throws Exception {
-	mockMvc.perform(post("/resource")
-               .content("{\"id\":\"123456\",\"message\":\"Hello World\"}"))
-			.andExpect(status().isOk())
-			.andDo(verify()
-					.wiremock(WireMock.post(
-						urlPathEquals("/resource"))
-						.withRequestBody(matchingJsonPath("$.id"))
-                       .stub("post-resource"));
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The WireMock API is rich. You can match headers, query parameters, and request body by
-regex as well as by JSON path. These features can be used to create stubs with a wider
-range of parameters. The above example generates a stub resembling the following example:</p>
-</div>
-<div class="listingblock">
-<div class="title">post-resource.json</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
-  "request" : {
-    "url" : "/resource",
-    "method" : "POST",
-    "bodyPatterns" : [ {
-      "matchesJsonPath" : "$.id"
-    }]
-  },
-  "response" : {
-    "status" : 200,
-    "body" : "Hello World",
-    "headers" : {
-      "X-Application-Context" : "application:-1",
-      "Content-Type" : "text/plain"
-    }
-  }
-}</code></pre>
-</div>
-</div>
-<div class="admonitionblock note">
-<table>
 <tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
+<td class="hdlist1">
+<a href="project-features.html#features">Spring Cloud Contract Features</a> 
 </td>
-<td class="content">
-You can use either the <code>wiremock()</code> method or the <code>jsonPath()</code> and <code>contentType()</code>
-methods to create request matchers, but you can&#8217;t use both approaches.
+<td class="hdlist2">
+<p>Contract DSL, Messaging, Spring Cloud Contract Stub Runner, and Spring Cloud Contract WireMock.</p>
 </td>
 </tr>
-</table>
-</div>
-<div class="paragraph">
-<p>On the consumer side, you can make the <code>resource.json</code> generated earlier in this section
-available on the classpath (by
-&lt;&lt;publishing-stubs-as-jars], for example). After that, you can create a stub using WireMock in a
-number of different ways, including by using
-<code>@AutoConfigureWireMock(stubs="classpath:resource.json")</code>, as described earlier in this
-document.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_generating_contracts_by_using_rest_docs"><a class="link" href="#_generating_contracts_by_using_rest_docs">11.8. Generating Contracts by Using REST Docs</a></h3>
-<div class="paragraph">
-<p>You can also generate Spring Cloud Contract DSL files and documentation with Spring REST
-Docs. If you do so in combination with Spring Cloud WireMock, you get both the contracts
-and the stubs.</p>
-</div>
-<div class="paragraph">
-<p>Why would you want to use this feature? Some people in the community asked questions
-about a situation in which they would like to move to DSL-based contract definition,
-but they already have a lot of Spring MVC tests. Using this feature lets you generate
-the contract files that you can later modify and move to folders (defined in your
-configuration) so that the plugin finds them.</p>
-</div>
-<div class="admonitionblock tip">
-<table>
 <tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
+<td class="hdlist1">
+<a href="project-features.html#features-build-tools">Build Tools</a> 
 </td>
-<td class="content">
-You might wonder why this functionality is in the WireMock module. The functionality
-is there because it makes sense to generate both the contracts and the stubs.
+<td class="hdlist2">
+<p>Maven Plugin, Gradle Plugin, and Docker.</p>
 </td>
 </tr>
-</table>
-</div>
-<div class="paragraph">
-<p>Consider the following test:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">		this.mockMvc
-				.perform(post("/foo").accept(MediaType.APPLICATION_PDF)
-						.accept(MediaType.APPLICATION_JSON)
-						.contentType(MediaType.APPLICATION_JSON)
-						.content("{\"foo\": 23, \"bar\" : \"baz\" }"))
-				.andExpect(status().isOk()).andExpect(content().string("bar"))
-				// first WireMock
-				.andDo(WireMockRestDocs.verify().jsonPath("$[?(@.foo &gt;= 20)]")
-						.jsonPath("$[?(@.bar in ['baz','bazz','bazzz'])]")
-						.contentType(MediaType.valueOf("application/json"))
-						.stub("shouldGrantABeerIfOldEnough"))
-				// then Contract DSL documentation
-				.andDo(document("index", SpringCloudContractRestDocs.dslContract()));</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The preceding test creates the stub presented in the previous section, generating both
-the contract and a documentation file.</p>
-</div>
-<div class="paragraph">
-<p>The contract is called <code>index.groovy</code> and might look like the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">import org.springframework.cloud.contract.spec.Contract
-
-Contract.make {
-    request {
-        method 'POST'
-        url '/foo'
-        body('''
-            {"foo": 23 }
-        ''')
-        headers {
-            header('''Accept''', '''application/json''')
-            header('''Content-Type''', '''application/json''')
-        }
-    }
-    response {
-        status OK()
-        body('''
-        bar
-        ''')
-        headers {
-            header('''Content-Type''', '''application/json;charset=UTF-8''')
-            header('''Content-Length''', '''3''')
-        }
-        testMatchers {
-            jsonPath('$[?(@.foo &gt;= 20)]', byType())
-        }
-    }
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The generated document (formatted in Asciidoc in this case) contains a formatted
-contract. The location of this file would be <code>index/dsl-contract.adoc</code>.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_migrations"><a class="link" href="#_migrations">12. Migrations</a></h2>
-<div class="sectionbody">
-<div class="admonitionblock tip">
-<table>
 <tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
+<td class="hdlist1">
+<a href="howto.html#howto">&#8220;How-to&#8221; Guides</a> 
 </td>
-<td class="content">
-For up to date migration guides please visit
-the project&#8217;s <a href="https://github.com/spring-cloud/spring-cloud-contract/wiki/">wiki page</a>.
+<td class="hdlist2">
+<p>Stubs versioning, Pact integration, Debugging, and more.</p>
 </td>
 </tr>
 </table>
 </div>
-<div class="paragraph">
-<p>This section covers migrating from one version of Spring Cloud Contract Verifier to the
-next version. It covers the following versions upgrade paths:</p>
-</div>
-<div class="sect2">
-<h3 id="cloud-verifier-1.0-1.1"><a class="link" href="#cloud-verifier-1.0-1.1">12.1. 1.0.x &#8594; 1.1.x</a></h3>
-<div class="paragraph">
-<p>This section covers upgrading from version 1.0 to version 1.1.</p>
-</div>
-<div class="sect3">
-<h4 id="_new_structure_of_generated_stubs"><a class="link" href="#_new_structure_of_generated_stubs">12.1.1. New structure of generated stubs</a></h4>
-<div class="paragraph">
-<p>In <code>1.1.x</code> we have introduced a change to the structure of generated stubs. If you have
-been using the  <code>@AutoConfigureWireMock</code> notation to use the stubs from the classpath,
-it no longer works. The following example shows how the <code>@AutoConfigureWireMock</code> notation
-used to work:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureWireMock(stubs = "classpath:/customer-stubs/mappings", port = 8084)</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You must either change the location of the stubs to:
-<code>classpath:&#8230;&#8203;/META-INF/groupId/artifactId/version/mappings</code> or use the new
-classpath-based <code>@AutoConfigureStubRunner</code>, as shown in the following example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureWireMock(stubs = "classpath:customer-stubs/META-INF/travel.components/customer-contract/1.0.2-SNAPSHOT/mappings/", port = 8084)</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>If you do not want to use <code>@AutoConfigureStubRunner</code> and you want to remain with the old
-structure, set your plugin tasks accordingly. The following example would work for the
-structure presented in the previous snippet.</p>
-</div>
-<div class="listingblock primary">
-<div class="title">Maven</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;!-- start of pom.xml --&gt;
-
-&lt;properties&gt;
-    &lt;!-- we don't want the verifier to do a jar for us --&gt;
-    &lt;spring.cloud.contract.verifier.skip&gt;true&lt;/spring.cloud.contract.verifier.skip&gt;
-&lt;/properties&gt;
-
-&lt;!-- ... --&gt;
-
-&lt;!-- You need to set up the assembly plugin --&gt;
-&lt;build&gt;
-    &lt;plugins&gt;
-        &lt;plugin&gt;
-            &lt;groupId&gt;org.apache.maven.plugins&lt;/groupId&gt;
-            &lt;artifactId&gt;maven-assembly-plugin&lt;/artifactId&gt;
-            &lt;executions&gt;
-                &lt;execution&gt;
-                    &lt;id&gt;stub&lt;/id&gt;
-                    &lt;phase&gt;prepare-package&lt;/phase&gt;
-                    &lt;goals&gt;
-                        &lt;goal&gt;single&lt;/goal&gt;
-                    &lt;/goals&gt;
-                    &lt;inherited&gt;false&lt;/inherited&gt;
-                    &lt;configuration&gt;
-                        &lt;attach&gt;true&lt;/attach&gt;
-                        &lt;descriptor&gt;${basedir}/src/assembly/stub.xml&lt;/descriptor&gt;
-                    &lt;/configuration&gt;
-                &lt;/execution&gt;
-            &lt;/executions&gt;
-        &lt;/plugin&gt;
-    &lt;/plugins&gt;
-&lt;/build&gt;
-&lt;!-- end of pom.xml --&gt;
-
-&lt;!-- start of stub.xml--&gt;
-
-&lt;assembly
-	xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3"
-	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-	xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 https://maven.apache.org/xsd/assembly-1.1.3.xsd"&gt;
-	&lt;id&gt;stubs&lt;/id&gt;
-	&lt;formats&gt;
-		&lt;format&gt;jar&lt;/format&gt;
-	&lt;/formats&gt;
-	&lt;includeBaseDirectory&gt;false&lt;/includeBaseDirectory&gt;
-	&lt;fileSets&gt;
-		&lt;fileSet&gt;
-			&lt;directory&gt;${project.build.directory}/snippets/stubs&lt;/directory&gt;
-			&lt;outputDirectory&gt;customer-stubs/mappings&lt;/outputDirectory&gt;
-			&lt;includes&gt;
-				&lt;include&gt;**/*&lt;/include&gt;
-			&lt;/includes&gt;
-		&lt;/fileSet&gt;
-		&lt;fileSet&gt;
-			&lt;directory&gt;${basedir}/src/test/resources/contracts&lt;/directory&gt;
-			&lt;outputDirectory&gt;customer-stubs/contracts&lt;/outputDirectory&gt;
-			&lt;includes&gt;
-				&lt;include&gt;**/*.groovy&lt;/include&gt;
-			&lt;/includes&gt;
-		&lt;/fileSet&gt;
-	&lt;/fileSets&gt;
-&lt;/assembly&gt;
-
-&lt;!-- end of stub.xml--&gt;</code></pre>
-</div>
-</div>
-<div class="listingblock secondary">
-<div class="title">Gradle</div>
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">task copyStubs(type: Copy, dependsOn: 'generateWireMockClientStubs') {
-//    Preserve directory structure from 1.0.X of spring-cloud-contract
-    from "${project.buildDir}/resources/main/customer-stubs/META-INF/${project.group}/${project.name}/${project.version}"
-    into "${project.buildDir}/resources/main/customer-stubs"
-}</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="cloud-verifier-1.1-1.2"><a class="link" href="#cloud-verifier-1.1-1.2">12.2. 1.1.x &#8594; 1.2.x</a></h3>
-<div class="paragraph">
-<p>This section covers upgrading from version 1.1 to version 1.2.</p>
-</div>
-<div class="sect3">
-<h4 id="_custom_httpserverstub"><a class="link" href="#_custom_httpserverstub">12.2.1. Custom <code>HttpServerStub</code></a></h4>
-<div class="paragraph">
-<p><code>HttpServerStub</code> includes a method that was not in version 1.1. The method is
-<code>String registeredMappings()</code> If you have classes that implement <code>HttpServerStub</code>, you
-now have to implement the <code>registeredMappings()</code> method. It should return a <code>String</code>
-representing all mappings available in a single <code>HttpServerStub</code>.</p>
-</div>
-<div class="paragraph">
-<p>See <a href="https://github.com/spring-cloud/spring-cloud-contract/issues/355">issue 355</a> for more
-detail.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_new_packages_for_generated_tests"><a class="link" href="#_new_packages_for_generated_tests">12.2.2. New packages for generated tests</a></h4>
-<div class="paragraph">
-<p>The flow for setting the generated tests package name will look like this:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Set <code>basePackageForTests</code></p>
-</li>
-<li>
-<p>If <code>basePackageForTests</code> was not set, pick the package from <code>baseClassForTests</code></p>
-</li>
-<li>
-<p>If <code>baseClassForTests</code> was not set, pick <code>packageWithBaseClasses</code></p>
-</li>
-<li>
-<p>If nothing got set, pick the default value:
-<code>org.springframework.cloud.contract.verifier.tests</code></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>See <a href="https://github.com/spring-cloud/spring-cloud-contract/issues/260">issue 260</a> for more
-detail.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_new_methods_in_templateprocessor"><a class="link" href="#_new_methods_in_templateprocessor">12.2.3. New Methods in TemplateProcessor</a></h4>
-<div class="paragraph">
-<p>In order to add support for <code>fromRequest.path</code>, the following methods had to be added to the
-<code>TemplateProcessor</code> interface:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><code>path()</code></p>
-</li>
-<li>
-<p><code>path(int index)</code></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>See <a href="https://github.com/spring-cloud/spring-cloud-contract/issues/388">issue 388</a> for more
-detail.</p>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_restassured_3_0"><a class="link" href="#_restassured_3_0">12.2.4. RestAssured 3.0</a></h4>
-<div class="paragraph">
-<p>Rest Assured, used in the generated test classes, got bumped to <code>3.0</code>. If
-you manually set versions of Spring Cloud Contract and the release train
-you might see the following exception:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.1:testCompile (default-testCompile) on project some-project: Compilation failure: Compilation failure:
-[ERROR] /some/path/SomeClass.java:[4,39] package com.jayway.restassured.response does not exist</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This exception will occur due to the fact that the tests got generated with
-an old version of plugin and at test execution time you have an incompatible
-version of the release train (and vice versa).</p>
-</div>
-<div class="paragraph">
-<p>Done via <a href="https://github.com/spring-cloud/spring-cloud-contract/issues/267">issue 267</a></p>
-</div>
-</div>
-</div>
-<div class="sect2">
-<h3 id="cloud-verifier-1.2-2.0"><a class="link" href="#cloud-verifier-1.2-2.0">12.3. 1.2.x &#8594; 2.0.x</a></h3>
-
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_links"><a class="link" href="#_links">13. Links</a></h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The following links may be helpful when working with Spring Cloud Contract:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><a href="https://github.com/spring-cloud/spring-cloud-contract/">Spring Cloud Contract Github
-Repository</a></p>
-</li>
-<li>
-<p><a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/">Spring Cloud
-Contract Samples</a></p>
-</li>
-<li>
-<p><a href="https://gitter.im/spring-cloud/spring-cloud-contract">Spring Cloud Contract Gitter</a></p>
-</li>
-<li>
-<p><a href="https://www.youtube.com/watch?v=sAAklvxmPmk">Spring Cloud Contract WJUG Presentation by
-Marcin Grzejszczak</a></p>
-</li>
-</ul>
-</div>
 </div>
 </div>
 </div>
diff --git a/reference/html/legal.html b/reference/html/legal.html
new file mode 100644
index 0000000000..38fd174a27
--- /dev/null
+++ b/reference/html/legal.html
@@ -0,0 +1,121 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.7.1">
+<title>Legal</title>
+<link rel="stylesheet" href="css/spring.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css">
+
+<style>
+.hidden {
+	display: none;
+}
+
+.switch {
+	border-width: 1px 1px 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+	display: inline-block;
+}
+
+.switch--item {
+	padding: 10px;
+	background-color: #ffffff;
+	color: #7a2518;
+	display: inline-block;
+	cursor: pointer;
+}
+
+.switch--item:not(:first-child) {
+	border-width: 0 0 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+}
+
+.switch--item.selected {
+	background-color: #7a2519;
+	color: #ffffff;
+}
+</style>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/zepto/1.2.0/zepto.min.js"></script>
+<script type="text/javascript">
+function addBlockSwitches() {
+	$('.primary').each(function() {
+		primary = $(this);
+		createSwitchItem(primary, createBlockSwitch(primary)).item.addClass("selected");
+		primary.children('.title').remove();
+	});
+	$('.secondary').each(function(idx, node) {
+		secondary = $(node);
+		primary = findPrimary(secondary);
+		switchItem = createSwitchItem(secondary, primary.children('.switch'));
+		switchItem.content.addClass('hidden');
+		findPrimary(secondary).append(switchItem.content);
+		secondary.remove();
+	});
+}
+
+function createBlockSwitch(primary) {
+	blockSwitch = $('<div class="switch"></div>');
+	primary.prepend(blockSwitch);
+	return blockSwitch;
+}
+
+function findPrimary(secondary) {
+	candidate = secondary.prev();
+	while (!candidate.is('.primary')) {
+		candidate = candidate.prev();
+	}
+	return candidate;
+}
+
+function createSwitchItem(block, blockSwitch) {
+	blockName = block.children('.title').text();
+	content = block.children('.content').first().append(block.next('.colist'));
+	item = $('<div class="switch--item">' + blockName + '</div>');
+	item.on('click', '', content, function(e) {
+		$(this).addClass('selected');
+		$(this).siblings().removeClass('selected');
+		e.data.siblings('.content').addClass('hidden');
+		e.data.removeClass('hidden');
+	});
+	blockSwitch.append(item);
+	return {'item': item, 'content': content};
+}
+
+$(addBlockSwitches);
+</script>
+
+</head>
+<body class="book">
+<div id="header">
+<h1>Legal</h1>
+</div>
+<div id="content">
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>2.2.0.BUILD-SNAPSHOT</p>
+</div>
+<div class="paragraph">
+<p>Copyright &#169; 2012-2019</p>
+</div>
+<div class="paragraph">
+<p>Copies of this document may be made for your own use and for distribution to
+others, provided that you do not charge any fee for such copies and further
+provided that each copy contains this Copyright Notice, whether distributed in
+print or electronically.</p>
+</div>
+</div>
+</div>
+</div>
+<script type="text/javascript" src="js/tocbot/tocbot.min.js"></script>
+<script type="text/javascript" src="js/toc.js"></script>
+<link rel="stylesheet" href="js/highlight/styles/atom-one-dark-reasonable.min.css">
+<script src="js/highlight/highlight.min.js"></script>
+<script>hljs.initHighlighting()</script>
+</body>
+</html>
\ No newline at end of file
diff --git a/reference/html/maven-project.html b/reference/html/maven-project.html
new file mode 100644
index 0000000000..5e39802736
--- /dev/null
+++ b/reference/html/maven-project.html
@@ -0,0 +1,1039 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.7.1">
+<title>Maven Project</title>
+<link rel="stylesheet" href="css/spring.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css">
+
+<style>
+.hidden {
+	display: none;
+}
+
+.switch {
+	border-width: 1px 1px 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+	display: inline-block;
+}
+
+.switch--item {
+	padding: 10px;
+	background-color: #ffffff;
+	color: #7a2518;
+	display: inline-block;
+	cursor: pointer;
+}
+
+.switch--item:not(:first-child) {
+	border-width: 0 0 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+}
+
+.switch--item.selected {
+	background-color: #7a2519;
+	color: #ffffff;
+}
+</style>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/zepto/1.2.0/zepto.min.js"></script>
+<script type="text/javascript">
+function addBlockSwitches() {
+	$('.primary').each(function() {
+		primary = $(this);
+		createSwitchItem(primary, createBlockSwitch(primary)).item.addClass("selected");
+		primary.children('.title').remove();
+	});
+	$('.secondary').each(function(idx, node) {
+		secondary = $(node);
+		primary = findPrimary(secondary);
+		switchItem = createSwitchItem(secondary, primary.children('.switch'));
+		switchItem.content.addClass('hidden');
+		findPrimary(secondary).append(switchItem.content);
+		secondary.remove();
+	});
+}
+
+function createBlockSwitch(primary) {
+	blockSwitch = $('<div class="switch"></div>');
+	primary.prepend(blockSwitch);
+	return blockSwitch;
+}
+
+function findPrimary(secondary) {
+	candidate = secondary.prev();
+	while (!candidate.is('.primary')) {
+		candidate = candidate.prev();
+	}
+	return candidate;
+}
+
+function createSwitchItem(block, blockSwitch) {
+	blockName = block.children('.title').text();
+	content = block.children('.content').first().append(block.next('.colist'));
+	item = $('<div class="switch--item">' + blockName + '</div>');
+	item.on('click', '', content, function(e) {
+		$(this).addClass('selected');
+		$(this).siblings().removeClass('selected');
+		e.data.siblings('.content').addClass('hidden');
+		e.data.removeClass('hidden');
+	});
+	blockSwitch.append(item);
+	return {'item': item, 'content': content};
+}
+
+$(addBlockSwitches);
+</script>
+
+</head>
+<body class="book toc2 toc-left">
+<div id="header">
+<h1>Maven Project</h1>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="#maven-add-plugin">1. Adding the Maven Plugin</a></li>
+<li><a href="#maven-rest-assured">2. Maven and Rest Assured 2.0</a></li>
+<li><a href="#maven-snapshot-versions">3. Using Snapshot and Milestone Versions for Maven</a></li>
+<li><a href="#maven-add-stubs">4. Adding stubs</a></li>
+<li><a href="#maven-run-plugin">5. Run plugin</a></li>
+<li><a href="#maven-configure-plugin">6. Configure plugin</a></li>
+<li><a href="#maven-configuration-options">7. Configuration Options</a></li>
+<li><a href="#maven-single-base">8. Single Base Class for All Tests</a></li>
+<li><a href="#maven-different-base">9. Using Different Base Classes for Contracts</a>
+<ul class="sectlevel2">
+<li><a href="#by-convention">9.1. By Convention</a></li>
+<li><a href="#by-mapping">9.2. By Mapping</a></li>
+</ul>
+</li>
+<li><a href="#maven-invoking-generated-tests">10. Invoking Generated Tests</a></li>
+<li><a href="#maven-pushing-stubs-to-scm">11. Pushing Stubs to SCM</a></li>
+<li><a href="#maven-sts">12. Maven Plugin and STS</a></li>
+<li><a href="#maven-plugin-with-spock-tests">13. Maven Plugin with Spock Tests</a></li>
+</ul>
+</div>
+</div>
+<div id="content">
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>To learn how to set up the Maven project for Spring Cloud Contract Verifier, read the
+following sections:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#maven-add-plugin">Adding the Maven Plugin</a></p>
+</li>
+<li>
+<p><a href="#maven-rest-assured">Maven and Rest Assured 2.0</a></p>
+</li>
+<li>
+<p><a href="#maven-snapshot-versions">Using Snapshot and Milestone Versions for Maven</a></p>
+</li>
+<li>
+<p><a href="#maven-add-stubs">Adding stubs</a></p>
+</li>
+<li>
+<p><a href="#maven-run-plugin">Run plugin</a></p>
+</li>
+<li>
+<p><a href="#maven-configure-plugin">Configure plugin</a></p>
+</li>
+<li>
+<p><a href="#maven-configuration-options">Configuration Options</a></p>
+</li>
+<li>
+<p><a href="#maven-single-base">Single Base Class for All Tests</a></p>
+</li>
+<li>
+<p><a href="#maven-different-base">Using Different Base Classes for Contracts</a></p>
+</li>
+<li>
+<p><a href="#maven-invoking-generated-tests">Invoking Generated Tests</a></p>
+</li>
+<li>
+<p><a href="#maven-pushing-stubs-to-scm">Pushing Stubs to SCM</a></p>
+</li>
+<li>
+<p><a href="#maven-sts">Maven Plugin and STS</a></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="maven-add-plugin"><a class="anchor" href="#maven-add-plugin"></a><a class="link" href="#maven-add-plugin">1. Adding the Maven Plugin</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Add the Spring Cloud Contract BOM in a fashion similar to the following:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependencyManagement&gt;
+    &lt;dependencies&gt;
+        &lt;dependency&gt;
+            &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+            &lt;artifactId&gt;spring-cloud-dependencies&lt;/artifactId&gt;
+            &lt;version&gt;${spring-cloud-release.version}&lt;/version&gt;
+            &lt;type&gt;pom&lt;/type&gt;
+            &lt;scope&gt;import&lt;/scope&gt;
+        &lt;/dependency&gt;
+    &lt;/dependencies&gt;
+&lt;/dependencyManagement&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Next, add the <code>Spring Cloud Contract Verifier</code> Maven plugin, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;packageWithBaseClasses&gt;com.example.fraud&lt;/packageWithBaseClasses&gt;
+        &lt;convertToYaml&gt;true&lt;/convertToYaml&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can read more in the
+spring-cloud-contract-maven-plugin/index.html[Spring
+Cloud Contract Maven Plugin Documentation].</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="maven-rest-assured"><a class="anchor" href="#maven-rest-assured"></a><a class="link" href="#maven-rest-assured">2. Maven and Rest Assured 2.0</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>By default, Rest Assured 3.x is added to the classpath. However, you can use Rest
+Assured 2.x by adding it to the plugins classpath, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;packageWithBaseClasses&gt;com.example&lt;/packageWithBaseClasses&gt;
+    &lt;/configuration&gt;
+    &lt;dependencies&gt;
+        &lt;dependency&gt;
+            &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+            &lt;artifactId&gt;spring-cloud-contract-verifier&lt;/artifactId&gt;
+            &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+        &lt;/dependency&gt;
+        &lt;dependency&gt;
+           &lt;groupId&gt;com.jayway.restassured&lt;/groupId&gt;
+           &lt;artifactId&gt;rest-assured&lt;/artifactId&gt;
+           &lt;version&gt;2.5.0&lt;/version&gt;
+           &lt;scope&gt;compile&lt;/scope&gt;
+        &lt;/dependency&gt;
+        &lt;dependency&gt;
+           &lt;groupId&gt;com.jayway.restassured&lt;/groupId&gt;
+           &lt;artifactId&gt;spring-mock-mvc&lt;/artifactId&gt;
+           &lt;version&gt;2.5.0&lt;/version&gt;
+           &lt;scope&gt;compile&lt;/scope&gt;
+        &lt;/dependency&gt;
+    &lt;/dependencies&gt;
+&lt;/plugin&gt;
+
+&lt;dependencies&gt;
+    &lt;!-- all dependencies --&gt;
+    &lt;!-- you can exclude rest-assured from spring-cloud-contract-verifier --&gt;
+    &lt;dependency&gt;
+       &lt;groupId&gt;com.jayway.restassured&lt;/groupId&gt;
+       &lt;artifactId&gt;rest-assured&lt;/artifactId&gt;
+       &lt;version&gt;2.5.0&lt;/version&gt;
+       &lt;scope&gt;test&lt;/scope&gt;
+    &lt;/dependency&gt;
+    &lt;dependency&gt;
+       &lt;groupId&gt;com.jayway.restassured&lt;/groupId&gt;
+       &lt;artifactId&gt;spring-mock-mvc&lt;/artifactId&gt;
+       &lt;version&gt;2.5.0&lt;/version&gt;
+       &lt;scope&gt;test&lt;/scope&gt;
+    &lt;/dependency&gt;
+&lt;/dependencies&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>That way, the plugin automatically sees that Rest Assured 2.x is present on the classpath
+and modifies the imports accordingly.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="maven-snapshot-versions"><a class="anchor" href="#maven-snapshot-versions"></a><a class="link" href="#maven-snapshot-versions">3. Using Snapshot and Milestone Versions for Maven</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>To use Snapshot and Milestone versions, you have to add the following section to your
+<code>pom.xml</code>:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;repositories&gt;
+    &lt;repository&gt;
+        &lt;id&gt;spring-snapshots&lt;/id&gt;
+        &lt;name&gt;Spring Snapshots&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;true&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/repository&gt;
+    &lt;repository&gt;
+        &lt;id&gt;spring-milestones&lt;/id&gt;
+        &lt;name&gt;Spring Milestones&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/repository&gt;
+    &lt;repository&gt;
+        &lt;id&gt;spring-releases&lt;/id&gt;
+        &lt;name&gt;Spring Releases&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/repository&gt;
+&lt;/repositories&gt;
+&lt;pluginRepositories&gt;
+    &lt;pluginRepository&gt;
+        &lt;id&gt;spring-snapshots&lt;/id&gt;
+        &lt;name&gt;Spring Snapshots&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;true&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/pluginRepository&gt;
+    &lt;pluginRepository&gt;
+        &lt;id&gt;spring-milestones&lt;/id&gt;
+        &lt;name&gt;Spring Milestones&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/pluginRepository&gt;
+    &lt;pluginRepository&gt;
+        &lt;id&gt;spring-releases&lt;/id&gt;
+        &lt;name&gt;Spring Releases&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/pluginRepository&gt;
+&lt;/pluginRepositories&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="maven-add-stubs"><a class="anchor" href="#maven-add-stubs"></a><a class="link" href="#maven-add-stubs">4. Adding stubs</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>By default, Spring Cloud Contract Verifier looks for stubs in the
+<code>src/test/resources/contracts</code> directory. The directory containing stub definitions is
+treated as a class name, and each stub definition is treated as a single test. We assume
+that it contains at least one directory to be used as the test class name. If there is more
+than one level of nested directories, all except the last one is used as the package name.
+Consider the following structure:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">src/test/resources/contracts/myservice/shouldCreateUser.groovy
+src/test/resources/contracts/myservice/shouldReturnUser.groovy</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Given that structure, Spring Cloud Contract Verifier creates a test class named
+<code>defaultBasePackage.MyService</code> with two methods:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>shouldCreateUser()</code></p>
+</li>
+<li>
+<p><code>shouldReturnUser()</code></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="maven-run-plugin"><a class="anchor" href="#maven-run-plugin"></a><a class="link" href="#maven-run-plugin">5. Run plugin</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The <code>generateTests</code> plugin goal is assigned to be invoked in the phase called
+<code>generate-test-sources</code>. If you want it to be part of your build process, you need not do
+anything. If you want only to generate tests, invoke the <code>generateTests</code> goal.</p>
+</div>
+<div class="paragraph">
+<p>If you want to run stubs via Maven it&#8217;s enough to call the <code>run</code> goal with the stubs to run as the <code>spring.cloud.contract.verifier.stubs</code> system property as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="paragraph">
+<p>mvn org.springframework.cloud:spring-cloud-contract-maven-plugin:run \
+-Dspring.cloud.contract.verifier.stubs="com.acme:service-name"</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="maven-configure-plugin"><a class="anchor" href="#maven-configure-plugin"></a><a class="link" href="#maven-configure-plugin">6. Configure plugin</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>To change the default configuration, you can add a <code>configuration</code> section to the plugin
+definition or the <code>execution</code> definition, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;executions&gt;
+        &lt;execution&gt;
+            &lt;goals&gt;
+                &lt;goal&gt;convert&lt;/goal&gt;
+                &lt;goal&gt;generateStubs&lt;/goal&gt;
+                &lt;goal&gt;generateTests&lt;/goal&gt;
+            &lt;/goals&gt;
+        &lt;/execution&gt;
+    &lt;/executions&gt;
+    &lt;configuration&gt;
+        &lt;basePackageForTests&gt;org.springframework.cloud.verifier.twitter.place&lt;/basePackageForTests&gt;
+        &lt;baseClassForTests&gt;org.springframework.cloud.verifier.twitter.place.BaseMockMvcSpec&lt;/baseClassForTests&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="maven-configuration-options"><a class="anchor" href="#maven-configuration-options"></a><a class="link" href="#maven-configuration-options">7. Configuration Options</a></h2>
+<div class="sectionbody">
+<div class="ulist">
+<ul>
+<li>
+<p><code>testMode</code>: Defines the mode for acceptance tests. By default, the mode is <code>MockMvc</code>,
+which is based on Spring&#8217;s MockMvc. You can also change it to <code>WebTestClient</code>, <code>JaxRsClient</code>, or
+<code>Explicit</code> (for real HTTP calls).</p>
+</li>
+<li>
+<p><code>basePackageForTests</code>: Specifies the base package for all generated tests. If not set,
+the value is picked from the package of <code>baseClassForTests</code> and from <code>packageWithBaseClasses</code>.
+If neither of these values are set, the value is set to
+<code>org.springframework.cloud.contract.verifier.tests</code>.</p>
+</li>
+<li>
+<p><code>ruleClassForTests</code>: Specifies a rule that should be added to the generated test
+classes.</p>
+</li>
+<li>
+<p><code>baseClassForTests</code>: Creates a base class for all generated tests. By default, if you
+use Spock classes, the class is <code>spock.lang.Specification</code>.</p>
+</li>
+<li>
+<p>contractsDirectory: Specifies a directory that contains contracts written with the
+Groovyn DSL. The default directory is <code>/src/test/resources/contracts</code>.</p>
+</li>
+<li>
+<p><code>generatedTestSourcesDir</code>: Specifies the test source directory where tests generated
+from the Groovy DSL should be placed. By default, its value is
+<code>$buildDir/generated-test-sources/contracts</code>.</p>
+</li>
+<li>
+<p><code>generatedTestResourcesDir</code>: Specifies the test resource directory for resources used by the generated tests.</p>
+</li>
+<li>
+<p><code>testFramework</code>: Specifies the target test framework to be used. Currently, Spock, JUnit 4 (<code>TestFramework.JUNIT</code>), and
+JUnit 5 are supported, with JUnit 4 being the default framework.</p>
+</li>
+<li>
+<p><code>packageWithBaseClasses</code>: Defines a package where all the base classes reside. This
+setting takes precedence over <code>baseClassForTests</code>. The convention is such that, if you
+have a contract under (for example) <code>src/test/resources/contract/foo/bar/baz/</code> and set
+the value of the <code>packageWithBaseClasses</code> property to <code>com.example.base</code>, Spring
+Cloud Contract Verifier assumes that there is a <code>BarBazBase</code> class under the
+<code>com.example.base</code> package. In other words, the system takes the last two parts of the
+package, if they exist, and forms a class with <code>Base</code> as a suffix.</p>
+</li>
+<li>
+<p><code>baseClassMappings</code>: Specifies a list of base class mappings that provide
+<code>contractPackageRegex</code> (which is checked against the package where the contract is
+located) and <code>baseClassFQN</code>( which maps to the fully qualified name of the base class for
+the matched contract). For example, if you have a contract under
+<code>src/test/resources/contract/foo/bar/baz/</code> and map the
+<code>.* &#8594; com.example.base.BaseClass</code> property, the test class generated from these contracts
+extends <code>com.example.base.BaseClass</code>. This setting takes precedence over
+<code>packageWithBaseClasses</code> and <code>baseClassForTests</code>.</p>
+</li>
+<li>
+<p><code>contractsProperties</code>: A map that contains properties to be passed to Spring Cloud Contract
+components. Those properties might be used by (for example) built-in or custom Stub Downloaders.</p>
+</li>
+<li>
+<p><code>failOnNoContracts</code>: When enabled, will throw an exception when no contracts were found. Defaults to <code>true</code>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>If you want to download your contract definitions from a Maven repository, you can use
+the following options:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>contractDependency</code>: The contract dependency that contains all the packaged contracts.</p>
+</li>
+<li>
+<p><code>contractsPath</code>: The path to the concrete contracts in the JAR with packaged contracts.
+Defaults to <code>groupid/artifactid</code> where <code>gropuid</code> is slash separated.</p>
+</li>
+<li>
+<p><code>contractsMode</code>: Picks the mode in which stubs are found and registered.</p>
+</li>
+<li>
+<p><code>deleteStubsAfterTest</code>: If set to <code>false</code> will not remove any downloaded
+contracts from temporary directories.</p>
+</li>
+<li>
+<p><code>contractsRepositoryUrl</code>: URL to a repository with the artifacts that have contracts. If it is not provided,
+use the current Maven ones.</p>
+</li>
+<li>
+<p><code>contractsRepositoryUsername</code>: The user name to be used to connect to the repo with contracts.</p>
+</li>
+<li>
+<p><code>contractsRepositoryPassword</code>: The password to be used to connect to the repo with contracts.</p>
+</li>
+<li>
+<p><code>contractsRepositoryProxyHost</code>: The proxy host to be used to connect to the repo with contracts.</p>
+</li>
+<li>
+<p><code>contractsRepositoryProxyPort</code>: The proxy port to be used to connect to the repo with contracts.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>We cache only non-snapshot, explicitly provided versions (for example
+<code>+</code> or <code>1.0.0.BUILD-SNAPSHOT</code> do not get cached). By default, this feature is turned on.</p>
+</div>
+<div class="paragraph">
+<p>The following list describes experimental features that you can turn on in the plugin:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>convertToYaml</code>: Converts all DSLs to the declarative YAML format. This can be extremely useful when you use external libraries in your Groovy DSLs. By turning this feature on (by setting it to <code>true</code>) you need not add the library dependency on the consumer side.</p>
+</li>
+<li>
+<p><code>assertJsonSize</code>: You can check the size of JSON arrays in the generated tests. This feature is disabled by default.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="maven-single-base"><a class="anchor" href="#maven-single-base"></a><a class="link" href="#maven-single-base">8. Single Base Class for All Tests</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>When using Spring Cloud Contract Verifier in the default (<code>MockMvc</code>), you need to create a base
+specification for all generated acceptance tests. In this class, you need to point to an
+endpoint, which should be verified. The following example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package org.mycompany.tests
+
+import org.mycompany.ExampleSpringController
+import com.jayway.restassured.module.mockmvc.RestAssuredMockMvc
+import spock.lang.Specification
+
+class MvcSpec extends Specification {
+  def setup() {
+   RestAssuredMockMvc.standaloneSetup(new ExampleSpringController())
+  }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can also setup the whole context if necessary, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">import io.restassured.module.mockmvc.RestAssuredMockMvc;
+import org.junit.Before;
+import org.junit.runner.RunWith;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.test.context.junit4.SpringRunner;
+import org.springframework.web.context.WebApplicationContext;
+
+@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT, classes = SomeConfig.class, properties="some=property")
+public abstract class BaseTestClass {
+
+    @Autowired
+    WebApplicationContext context;
+
+    @Before
+    public void setup() {
+        RestAssuredMockMvc.webAppContextSetup(this.context);
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>If you use <code>EXPLICIT</code> mode, you can use a base class to initialize the whole tested app,
+similar to what you might do in regular integration tests. The following example shows
+how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">import io.restassured.RestAssured;
+import org.junit.Before;
+import org.junit.runner.RunWith;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.boot.web.server.LocalServerPort
+import org.springframework.test.context.junit4.SpringRunner;
+import org.springframework.web.context.WebApplicationContext;
+
+@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT, classes = SomeConfig.class, properties="some=property")
+public abstract class BaseTestClass {
+
+    @LocalServerPort
+    int port;
+
+    @Before
+    public void setup() {
+        RestAssured.baseURI = "http://localhost:" + this.port;
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>If you use the <code>JAXRSCLIENT</code> mode, this base class should also contain a <code>protected WebTarget webTarget</code> field. Right
+now, the only way to test the JAX-RS API is to start a web server.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="maven-different-base"><a class="anchor" href="#maven-different-base"></a><a class="link" href="#maven-different-base">9. Using Different Base Classes for Contracts</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>If your base classes differ between contracts, you can tell the Spring Cloud Contract
+plugin which class should get extended by the autogenerated tests. You have two options:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Follow a convention by providing a value for <code>packageWithBaseClasses</code></p>
+</li>
+<li>
+<p>Provide explicit mapping with <code>baseClassMappings</code></p>
+</li>
+</ul>
+</div>
+<div class="sect2">
+<h3 id="by-convention"><a class="anchor" href="#by-convention"></a><a class="link" href="#by-convention">9.1. By Convention</a></h3>
+<div class="paragraph">
+<p>The convention is such that if you have a contract under (for example)
+<code>src/test/resources/contract/foo/bar/baz/</code> and set the value of the
+<code>packageWithBaseClasses</code> property to <code>com.example.base</code>, then Spring Cloud Contract
+Verifier assumes that there is a <code>BarBazBase</code> class under the <code>com.example.base</code> package.
+In other words, the system takes the last two parts of the package, if they exist, and
+forms a class with a <code>Base</code> suffix. This rule takes precedence over <code>baseClassForTests</code>.
+The following example shows how it works in the <code>contracts</code> closure:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;configuration&gt;
+        &lt;packageWithBaseClasses&gt;hello&lt;/packageWithBaseClasses&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="by-mapping"><a class="anchor" href="#by-mapping"></a><a class="link" href="#by-mapping">9.2. By Mapping</a></h3>
+<div class="paragraph">
+<p>You can manually map a regular expression of the contract&#8217;s package to the fully qualified
+name of the base class for the matched contract. You have to provide a list called
+<code>baseClassMappings</code> that consists of <code>baseClassMapping</code> objects that each take a
+<code>contractPackageRegex</code> to <code>baseClassFQN</code> mapping. Consider the following example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;configuration&gt;
+        &lt;baseClassForTests&gt;com.example.FooBase&lt;/baseClassForTests&gt;
+        &lt;baseClassMappings&gt;
+            &lt;baseClassMapping&gt;
+                &lt;contractPackageRegex&gt;.*com.*&lt;/contractPackageRegex&gt;
+                &lt;baseClassFQN&gt;com.example.TestBase&lt;/baseClassFQN&gt;
+            &lt;/baseClassMapping&gt;
+        &lt;/baseClassMappings&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Assume that you have contracts under these two locations:
+* <code>src/test/resources/contract/com/</code>
+* <code>src/test/resources/contract/foo/</code></p>
+</div>
+<div class="paragraph">
+<p>By providing the <code>baseClassForTests</code>, we have a fallback in case mapping did not succeed.
+(You can also provide the <code>packageWithBaseClasses</code> as a fallback.) That way, the tests
+generated from <code>src/test/resources/contract/com/</code> contracts extend the
+<code>com.example.ComBase</code>, whereas the rest of the tests extend <code>com.example.FooBase</code>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="maven-invoking-generated-tests"><a class="anchor" href="#maven-invoking-generated-tests"></a><a class="link" href="#maven-invoking-generated-tests">10. Invoking Generated Tests</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The Spring Cloud Contract Maven Plugin generates verification code in a directory called
+<code>/generated-test-sources/contractVerifier</code> and attaches this directory to <code>testCompile</code>
+goal.</p>
+</div>
+<div class="paragraph">
+<p>For Groovy Spock code, you can use the following:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.codehaus.gmavenplus&lt;/groupId&gt;
+    &lt;artifactId&gt;gmavenplus-plugin&lt;/artifactId&gt;
+    &lt;version&gt;1.5&lt;/version&gt;
+    &lt;executions&gt;
+        &lt;execution&gt;
+            &lt;goals&gt;
+                &lt;goal&gt;testCompile&lt;/goal&gt;
+            &lt;/goals&gt;
+        &lt;/execution&gt;
+    &lt;/executions&gt;
+    &lt;configuration&gt;
+        &lt;testSources&gt;
+            &lt;testSource&gt;
+                &lt;directory&gt;${project.basedir}/src/test/groovy&lt;/directory&gt;
+                &lt;includes&gt;
+                    &lt;include&gt;**/*.groovy&lt;/include&gt;
+                &lt;/includes&gt;
+            &lt;/testSource&gt;
+            &lt;testSource&gt;
+                &lt;directory&gt;${project.build.directory}/generated-test-sources/contractVerifier&lt;/directory&gt;
+                &lt;includes&gt;
+                    &lt;include&gt;**/*.groovy&lt;/include&gt;
+                &lt;/includes&gt;
+            &lt;/testSource&gt;
+        &lt;/testSources&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>To ensure that the provider side is compliant with defined contracts, you need to invoke
+<code>mvn generateTest test</code>.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="maven-pushing-stubs-to-scm"><a class="anchor" href="#maven-pushing-stubs-to-scm"></a><a class="link" href="#maven-pushing-stubs-to-scm">11. Pushing Stubs to SCM</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>If you use the SCM (Source Control Management) repository to keep the contracts and
+stubs, you might want to automate the step of pushing stubs to
+the repository. To do that, you can add the <code>pushStubsToScm</code>
+goal. The following example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;!-- Base class mappings etc. --&gt;
+
+        &lt;!-- We want to pick contracts from a Git repository --&gt;
+        &lt;contractsRepositoryUrl&gt;git://https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git&lt;/contractsRepositoryUrl&gt;
+
+        &lt;!-- We reuse the contract dependency section to set up the path
+        to the folder that contains the contract definitions. In our case the
+        path will be /groupId/artifactId/version/contracts --&gt;
+        &lt;contractDependency&gt;
+            &lt;groupId&gt;${project.groupId}&lt;/groupId&gt;
+            &lt;artifactId&gt;${project.artifactId}&lt;/artifactId&gt;
+            &lt;version&gt;${project.version}&lt;/version&gt;
+        &lt;/contractDependency&gt;
+
+        &lt;!-- The contracts mode can't be classpath --&gt;
+        &lt;contractsMode&gt;REMOTE&lt;/contractsMode&gt;
+    &lt;/configuration&gt;
+    &lt;executions&gt;
+        &lt;execution&gt;
+            &lt;phase&gt;package&lt;/phase&gt;
+            &lt;goals&gt;
+                &lt;!-- By default we will not push the stubs back to SCM,
+                you have to explicitly add it as a goal --&gt;
+                &lt;goal&gt;pushStubsToScm&lt;/goal&gt;
+            &lt;/goals&gt;
+        &lt;/execution&gt;
+    &lt;/executions&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Under <a href="#scm-stub-downloader">[scm-stub-downloader]</a>, you can find all possible
+configuration options that you can pass through
+the <code>&lt;configuration&gt;&lt;contractProperties&gt;</code> map, a system property,
+or an environment variable.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="maven-sts"><a class="anchor" href="#maven-sts"></a><a class="link" href="#maven-sts">12. Maven Plugin and STS</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The following image shows an exception that you may see when you use STS:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="https://raw.githubusercontent.com/spring-cloud/spring-cloud-contract/${github-tag}/docs/src/main/asciidoc/images/sts_exception.png" alt="STS Exception">
+</div>
+</div>
+<div class="paragraph">
+<p>When you click on the error marker you should see something like the following:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"> plugin:1.1.0.M1:convert:default-convert:process-test-resources) org.apache.maven.plugin.PluginExecutionException: Execution default-convert of goal org.springframework.cloud:spring-
+ cloud-contract-maven-plugin:1.1.0.M1:convert failed. at org.apache.maven.plugin.DefaultBuildPluginManager.executeMojo(DefaultBuildPluginManager.java:145) at
+ org.eclipse.m2e.core.internal.embedder.MavenImpl.execute(MavenImpl.java:331) at org.eclipse.m2e.core.internal.embedder.MavenImpl$11.call(MavenImpl.java:1362) at
+...
+ org.eclipse.core.internal.jobs.Worker.run(Worker.java:55) Caused by: java.lang.NullPointerException at
+ org.eclipse.m2e.core.internal.builder.plexusbuildapi.EclipseIncrementalBuildContext.hasDelta(EclipseIncrementalBuildContext.java:53) at
+ org.sonatype.plexus.build.incremental.ThreadBuildContext.hasDelta(ThreadBuildContext.java:59) at</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In order to fix this issue, provide the following section in your <code>pom.xml</code>:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;build&gt;
+    &lt;pluginManagement&gt;
+        &lt;plugins&gt;
+            &lt;!--This plugin's configuration is used to store Eclipse m2e settings
+                only. It has no influence on the Maven build itself. --&gt;
+            &lt;plugin&gt;
+                &lt;groupId&gt;org.eclipse.m2e&lt;/groupId&gt;
+                &lt;artifactId&gt;lifecycle-mapping&lt;/artifactId&gt;
+                &lt;version&gt;1.0.0&lt;/version&gt;
+                &lt;configuration&gt;
+                    &lt;lifecycleMappingMetadata&gt;
+                        &lt;pluginExecutions&gt;
+                             &lt;pluginExecution&gt;
+                                &lt;pluginExecutionFilter&gt;
+                                    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+                                    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+                                    &lt;versionRange&gt;[1.0,)&lt;/versionRange&gt;
+                                    &lt;goals&gt;
+                                        &lt;goal&gt;convert&lt;/goal&gt;
+                                    &lt;/goals&gt;
+                                &lt;/pluginExecutionFilter&gt;
+                                &lt;action&gt;
+                                    &lt;execute /&gt;
+                                &lt;/action&gt;
+                             &lt;/pluginExecution&gt;
+                        &lt;/pluginExecutions&gt;
+                    &lt;/lifecycleMappingMetadata&gt;
+                &lt;/configuration&gt;
+            &lt;/plugin&gt;
+        &lt;/plugins&gt;
+    &lt;/pluginManagement&gt;
+&lt;/build&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="maven-plugin-with-spock-tests"><a class="anchor" href="#maven-plugin-with-spock-tests"></a><a class="link" href="#maven-plugin-with-spock-tests">13. Maven Plugin with Spock Tests</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>You can select the <a href="http://spockframework.org/">Spock Framework</a> for creating and running the auto-generated contract
+verification tests with both Maven and Gradle. However, whereas using Gradle is straightforward,
+in Maven, you will require some additional setup in order to make the tests compile and execute properly.</p>
+</div>
+<div class="paragraph">
+<p>First of all, you must use a plugin, such as the <a href="https://github.com/groovy/GMavenPlus">GMavenPlus</a> plugin,
+to add Groovy to your project. In GMavenPlus plugin, you need to explicitly set test sources, including both the
+path where your base test classes are defined and the path were the generated contract tests are added.
+The following example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.codehaus.gmavenplus&lt;/groupId&gt;
+    &lt;artifactId&gt;gmavenplus-plugin&lt;/artifactId&gt;
+    &lt;version&gt;1.6.1&lt;/version&gt;
+    &lt;executions&gt;
+        &lt;execution&gt;
+            &lt;goals&gt;
+                &lt;goal&gt;compileTests&lt;/goal&gt;
+                &lt;goal&gt;addTestSources&lt;/goal&gt;
+            &lt;/goals&gt;
+        &lt;/execution&gt;
+    &lt;/executions&gt;
+    &lt;configuration&gt;
+        &lt;testSources&gt;
+            &lt;testSource&gt;
+                &lt;directory&gt;${project.basedir}/src/test/groovy&lt;/directory&gt;
+                &lt;includes&gt;
+                    &lt;include&gt;**/*.groovy&lt;/include&gt;
+                &lt;/includes&gt;
+            &lt;/testSource&gt;
+            &lt;testSource&gt;
+                &lt;directory&gt;
+                    ${project.basedir}/target/generated-test-sources/contracts/com/example/beer
+                &lt;/directory&gt;
+                &lt;includes&gt;
+                    &lt;include&gt;**/*.groovy&lt;/include&gt;
+                    &lt;include&gt;**/*.gvy&lt;/include&gt;
+                &lt;/includes&gt;
+            &lt;/testSource&gt;
+        &lt;/testSources&gt;
+    &lt;/configuration&gt;
+    &lt;dependencies&gt;
+        &lt;dependency&gt;
+            &lt;groupId&gt;org.codehaus.groovy&lt;/groupId&gt;
+            &lt;artifactId&gt;groovy-all&lt;/artifactId&gt;
+            &lt;version&gt;2.4.15&lt;/version&gt;
+            &lt;scope&gt;runtime&lt;/scope&gt;
+            &lt;type&gt;pom&lt;/type&gt;
+        &lt;/dependency&gt;
+    &lt;/dependencies&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>If you uphold the Spock convention of ending the test class names with <code>Spec</code>, you also need to adjust your Maven
+Surefire plugin setup, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.apache.maven.plugins&lt;/groupId&gt;
+    &lt;artifactId&gt;maven-surefire-plugin&lt;/artifactId&gt;
+    &lt;configuration&gt;
+        &lt;includes&gt;
+            &lt;include&gt;**/*Test.java&lt;/include&gt;
+            &lt;include&gt;**/*Spec.java&lt;/include&gt;
+        &lt;/includes&gt;
+        &lt;failIfNoTests&gt;true&lt;/failIfNoTests&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<script type="text/javascript" src="js/tocbot/tocbot.min.js"></script>
+<script type="text/javascript" src="js/toc.js"></script>
+<link rel="stylesheet" href="js/highlight/styles/atom-one-dark-reasonable.min.css">
+<script src="js/highlight/highlight.min.js"></script>
+<script>hljs.initHighlighting()</script>
+</body>
+</html>
\ No newline at end of file
diff --git a/reference/html/project-features.html b/reference/html/project-features.html
new file mode 100644
index 0000000000..e532a868bd
--- /dev/null
+++ b/reference/html/project-features.html
@@ -0,0 +1,8980 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.7.1">
+<title>Spring Cloud Contract Features</title>
+<link rel="stylesheet" href="css/spring.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css">
+
+<style>
+.hidden {
+	display: none;
+}
+
+.switch {
+	border-width: 1px 1px 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+	display: inline-block;
+}
+
+.switch--item {
+	padding: 10px;
+	background-color: #ffffff;
+	color: #7a2518;
+	display: inline-block;
+	cursor: pointer;
+}
+
+.switch--item:not(:first-child) {
+	border-width: 0 0 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+}
+
+.switch--item.selected {
+	background-color: #7a2519;
+	color: #ffffff;
+}
+</style>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/zepto/1.2.0/zepto.min.js"></script>
+<script type="text/javascript">
+function addBlockSwitches() {
+	$('.primary').each(function() {
+		primary = $(this);
+		createSwitchItem(primary, createBlockSwitch(primary)).item.addClass("selected");
+		primary.children('.title').remove();
+	});
+	$('.secondary').each(function(idx, node) {
+		secondary = $(node);
+		primary = findPrimary(secondary);
+		switchItem = createSwitchItem(secondary, primary.children('.switch'));
+		switchItem.content.addClass('hidden');
+		findPrimary(secondary).append(switchItem.content);
+		secondary.remove();
+	});
+}
+
+function createBlockSwitch(primary) {
+	blockSwitch = $('<div class="switch"></div>');
+	primary.prepend(blockSwitch);
+	return blockSwitch;
+}
+
+function findPrimary(secondary) {
+	candidate = secondary.prev();
+	while (!candidate.is('.primary')) {
+		candidate = candidate.prev();
+	}
+	return candidate;
+}
+
+function createSwitchItem(block, blockSwitch) {
+	blockName = block.children('.title').text();
+	content = block.children('.content').first().append(block.next('.colist'));
+	item = $('<div class="switch--item">' + blockName + '</div>');
+	item.on('click', '', content, function(e) {
+		$(this).addClass('selected');
+		$(this).siblings().removeClass('selected');
+		e.data.siblings('.content').addClass('hidden');
+		e.data.removeClass('hidden');
+	});
+	blockSwitch.append(item);
+	return {'item': item, 'content': content};
+}
+
+$(addBlockSwitches);
+</script>
+
+</head>
+<body id="features" class="book toc2 toc-left">
+<div id="header">
+<h1>Spring Cloud Contract Features</h1>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="#contract-dsl">1. Contract DSL</a>
+<ul class="sectlevel2">
+<li><a href="#contract-limitations">1.1. Limitations</a></li>
+<li><a href="#contract-common-top-elements">1.2. Common Top-Level Elements</a>
+<ul class="sectlevel3">
+<li><a href="#contract-dsl-description">1.2.1. Description</a></li>
+<li><a href="#contract-dsl-name">1.2.2. Name</a></li>
+<li><a href="#contract-dsl-ignoring-contracts">1.2.3. Ignoring Contracts</a></li>
+<li><a href="#contract-dsl-in-progress">1.2.4. Contracts in Progress</a></li>
+<li><a href="#contract-dsl-passing-values-from-files">1.2.5. Passing Values from Files</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#features-http">2. Contracts for HTTP</a>
+<ul class="sectlevel2">
+<li><a href="#contract-dsl-http-top-level-elements">2.1. HTTP Top-Level Elements</a></li>
+<li><a href="#contract-dsl-request">2.2. HTTP Request</a></li>
+<li><a href="#contract-dsl-response">2.3. HTTP Response</a></li>
+<li><a href="#contract-dsl-dynamic-properties">2.4. Dynamic properties</a>
+<ul class="sectlevel3">
+<li><a href="#contract-dsl-dynamic-properties-in-body">2.4.1. Dynamic Properties inside the Body</a></li>
+<li><a href="#contract-dsl-regex">2.4.2. Regular Expressions</a>
+<ul class="sectlevel4">
+<li><a href="#contract-dsl-regex-limitations">Limitations</a></li>
+</ul>
+</li>
+<li><a href="#contract-dsl-optional-params">2.4.3. Passing Optional Parameters</a></li>
+<li><a href="#contract-dsl-custom-methods">2.4.4. Executing Custom Methods on the Server Side</a></li>
+<li><a href="#contract-dsl-referencing-request-from-response">2.4.5. Referencing the Request from the Response</a></li>
+<li><a href="#contract-dsl-matchers">2.4.6. Dynamic Properties in the Matchers Sections</a>
+<ul class="sectlevel4">
+<li><a href="#groovy-dsl">Groovy DSL</a></li>
+<li><a href="#yaml">YAML</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#contract-dsl-async">2.5. Asynchronous Support</a></li>
+<li><a href="#contract-dsl-xml">2.6. XML Support for HTTP</a></li>
+<li><a href="#contract-dsl-multiple">2.7. Multiple Contracts in One File</a></li>
+<li><a href="#contract-stateful-contracts">2.8. Stateful Contracts</a></li>
+</ul>
+</li>
+<li><a href="#feature-integrations">3. Integrations</a>
+<ul class="sectlevel2">
+<li><a href="#features-jax-rs">3.1. JAX-RS</a></li>
+<li><a href="#feature-webflux">3.2. WebFlux with WebTestClient</a></li>
+<li><a href="#feature-webflux-explicit">3.3. WebFlux with Explicit Mode</a></li>
+<li><a href="#features-context-paths">3.4. Working with Context Paths</a></li>
+<li><a href="#features-rest-docs">3.5. Working with REST Docs</a>
+<ul class="sectlevel3">
+<li><a href="#features-rest-docs-contracts">3.5.1. Generating Contracts with REST Docs</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#features-messaging">4. Messaging</a>
+<ul class="sectlevel2">
+<li><a href="#contract-dsl-messaging-top-level">4.1. Messaging DSL Top-Level Elements</a>
+<ul class="sectlevel3">
+<li><a href="#contract-dsl-output-triggered-method">4.1.1. Output Triggered by a Method</a></li>
+<li><a href="#contract-dsl-output-triggered-message">4.1.2. Output Triggered by a Message</a></li>
+<li><a href="#contract-dsl-consumer-producer">4.1.3. Consumer/Producer</a></li>
+<li><a href="#contract-dsl-messaging-common">4.1.4. Common</a></li>
+</ul>
+</li>
+<li><a href="#features-messaging-integrations">4.2. Integrations</a>
+<ul class="sectlevel3">
+<li><a href="#features-messaging-manual">4.2.1. Manual Integration Testing</a></li>
+</ul>
+</li>
+<li><a href="#features-messaging-test-generation">4.3. Producer Side  Messaging Test Generation</a>
+<ul class="sectlevel3">
+<li><a href="#features-messaging-scenario1">4.3.1. Scenario 1: No Input Message</a></li>
+<li><a href="#features-messaging-scenario2">4.3.2. Scenario 2: Output Triggered by Input</a></li>
+<li><a href="#features-messaging-scenario3">4.3.3. Scenario 3: No Output Message</a></li>
+</ul>
+</li>
+<li><a href="#features-messaging-consumer">4.4. Consumer Stub Generation</a>
+<ul class="sectlevel3">
+<li><a href="#features-messaging-stub-triggering">4.4.1. Stub triggering</a></li>
+<li><a href="#features-messaging-trigger-label">4.4.2. Trigger by Label</a></li>
+<li><a href="#features-messaging-trigger-group-artifact-ids">4.4.3. Trigger by Group and Artifact Ids</a></li>
+<li><a href="#features-messaging-trigger-artifact-ids">4.4.4. Trigger by Artifact IDs</a></li>
+<li><a href="#features-messaging-trigger-all-messages">4.4.5. Trigger All Messages</a></li>
+</ul>
+</li>
+<li><a href="#features-messaging-stub-runner-camel">4.5. Consumer Side Messaging With Apache Camel</a>
+<ul class="sectlevel3">
+<li><a href="#features-messaging-stub-runner-camel-adding">4.5.1. Adding Apache Camel to the Project</a></li>
+<li><a href="#features-messaging-stub-runner-camel-disabling">4.5.2. Disabling the Functionality</a></li>
+<li><a href="#features-messaging-stub-runner-camel-example">4.5.3. Examples</a>
+<ul class="sectlevel4">
+<li><a href="#features-messaging-stub-runner-camel-scenario1">Scenario 1 (No Input Message)</a></li>
+<li><a href="#features-messaging-stub-runner-camel-scenario2">Scenario 2 (Output Triggered by Input)</a></li>
+<li><a href="#features-messaging-stub-runner-camel-scenario3">Scenario 3 (Input with No Output)</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#features-messaging-stub-runner-integration">4.6. Consumer Side Messaging with Spring Integration</a>
+<ul class="sectlevel3">
+<li><a href="#features-messaging-stub-runner-integration-adding">4.6.1. Adding the Runner to the Project</a></li>
+<li><a href="#features-messaging-stub-runner-integration-disabling">4.6.2. Disabling the Functionality</a></li>
+<li><a href="#features-messaging-stub-runner-integration-example">4.6.3. Examples</a>
+<ul class="sectlevel4">
+<li><a href="#features-messaging-stub-runner-integration-scenario1">Scenario 1 (No Input Message)</a></li>
+<li><a href="#features-messaging-stub-runner-integration-scenario2">Scenario 2 (Output Triggered by Input)</a></li>
+<li><a href="#features-messaging-stub-runner-integration-scenario3">Scenario 3 (Input with No Output)</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#features-messaging-stub-runner-stream">4.7. Consumer Side Messaging With Spring Cloud Stream</a>
+<ul class="sectlevel3">
+<li><a href="#features-messaging-stub-runner-stream-adding">4.7.1. Adding the Runner to the Project</a></li>
+<li><a href="#features-messaging-stub-runner-stream-disabling">4.7.2. Disabling the Functionality</a></li>
+<li><a href="#features-messaging-stub-runner-stream-example">4.7.3. Examples</a>
+<ul class="sectlevel4">
+<li><a href="#features-messaging-stub-runner-stream-scenario1">Scenario 1 (No Input Message)</a></li>
+<li><a href="#features-messaging-stub-runner-stream-scenario2">Scenario 2 (Output Triggered by Input)</a></li>
+<li><a href="#features-messaging-stub-runner-stream-scenario3">Scenario 3 (Input with No Output)</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#features-messaging-stub-runner-amqp">4.8. Consumer Side Messaging With Spring AMQP</a>
+<ul class="sectlevel3">
+<li><a href="#features-messaging-stub-runner-amqp-adding">4.8.1. Adding the Runner to the Project</a></li>
+<li><a href="#features-messaging-stub-runner-amqp-example">4.8.2. Examples</a>
+<ul class="sectlevel4">
+<li><a href="#features-messaging-stub-runner-amqp-triggering">Triggering the Message</a></li>
+<li><a href="#features-messaging-stub-runner-amqp-configuration">Spring AMQP Test Configuration</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#features-stub-runner">5. Spring Cloud Contract Stub Runner</a>
+<ul class="sectlevel2">
+<li><a href="#features-stub-runner-snapshot-versions">5.1. Snapshot Versions</a></li>
+<li><a href="#features-stub-runner-publishing-stubs-as-jars">5.2. Publishing Stubs as JARs</a></li>
+<li><a href="#features-stub-runner-core">5.3. Stub Runner Core</a>
+<ul class="sectlevel3">
+<li><a href="#features-stub-runner-retrieving">5.3.1. Retrieving stubs</a>
+<ul class="sectlevel4">
+<li><a href="#features-stub-runner-downloading-stub">Downloading Stubs</a></li>
+<li><a href="#features-stub-runner-classpath-scanning">Classpath scanning</a></li>
+<li><a href="#features-stub-runner-configuring-http-server-stubs">Configuring HTTP Server Stubs</a></li>
+</ul>
+</li>
+<li><a href="#features-stub-runner-running-stubs">5.3.2. Running stubs</a>
+<ul class="sectlevel4">
+<li><a href="#features-stub-runner-http-stubs">HTTP Stubs</a></li>
+<li><a href="#features-stub-runner-viewing">Viewing Registered Mappings</a></li>
+<li><a href="#features-stub-runner-messaging">Messaging Stubs</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#features-stub-runner-junit">5.4. Stub Runner JUnit Rule and Stub Runner JUnit5 Extension</a>
+<ul class="sectlevel3">
+<li><a href="#features-stub-runner-rule-maven-settings">5.4.1. Maven Settings</a></li>
+<li><a href="#features-stub-runner-rule-fixed-ports">5.4.2. Providing Fixed Ports</a></li>
+<li><a href="#features-stub-runner-rule-fluent-api">5.4.3. Fluent API</a></li>
+<li><a href="#features-stub-runner-rule-spring">5.4.4. Stub Runner with Spring</a></li>
+</ul>
+</li>
+<li><a href="#features-stub-runner-cloud">5.5. Stub Runner Spring Cloud</a>
+<ul class="sectlevel3">
+<li><a href="#features-stub-runner-cloud-stubbing-discovery">5.5.1. Stubbing Service Discovery</a>
+<ul class="sectlevel4">
+<li><a href="#features-stub-runner-cloud-stubbing-profiles">Test Profiles and Service Discovery</a></li>
+</ul>
+</li>
+<li><a href="#features-stub-runner-additional-config">5.5.2. Additional Configuration</a></li>
+</ul>
+</li>
+<li><a href="#features-stub-runner-boot">5.6. Using the Stub Runner Boot Application</a>
+<ul class="sectlevel4">
+<li><a href="#features-stub-runner-boot-server">Stub Runner Server</a></li>
+<li><a href="#features-stub-runner-boot-how-fat-jar">Stub Runner Server Fat Jar</a></li>
+<li><a href="#features-stub-runner-boot-how-cli">Spring Cloud CLI</a></li>
+<li><a href="#features-stub-runner-boot-endpoints">5.6.4. Endpoints</a>
+<ul class="sectlevel4">
+<li><a href="#features-stub-runner-boot-endpoints-http">HTTP</a></li>
+<li><a href="#features-stub-runner-boot-endpoints-messaging">Messaging</a></li>
+</ul>
+</li>
+<li><a href="#features-stub-runner-boot-endpoints-example">5.6.5. Example</a></li>
+<li><a href="#features-stub-runner-boot-service-discovery">5.6.6. Stub Runner Boot with Service Discovery</a></li>
+</ul>
+</li>
+<li><a href="#features-stub-runner-stubs-per-consumer">5.7. Consumer-Driven Contracts: Stubs Per Consumer</a></li>
+<li><a href="#features-stub-runner-stubs-protocol">5.8. Fetching Stubs or Contract Definitions From A Location</a></li>
+<li><a href="#features-stub-runner-generate-stubs-at-runtime">5.9. Generating Stubs at Runtime</a></li>
+<li><a href="#features-stub-runner-fail-on-no-stubs">5.10. Fail On No Stubs</a></li>
+<li><a href="#features-stub-runner-common">5.11. Common Properties</a>
+<ul class="sectlevel3">
+<li><a href="#features-stub-runner-common-properties-junit-spring">5.11.1. Common Properties for JUnit and Spring</a></li>
+<li><a href="#features-stub-runner-stub-runner-stub-ids">5.11.2. Stub Runner Stubs IDs</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#features-wiremock">6. Spring Cloud Contract WireMock</a>
+<ul class="sectlevel2">
+<li><a href="#features-wiremock-registering-stubs">6.1. Registering Stubs Automatically</a></li>
+<li><a href="#features-wiremock-using-files">6.2. Using Files to Specify the Stub Bodies</a></li>
+<li><a href="#features-wiremock-junit-rule">6.3. Alternative: Using JUnit Rules</a></li>
+<li><a href="#features-wiremock-relaxed-ssl">6.4. Relaxed SSL Validation for Rest Template</a></li>
+<li><a href="#features-wiremock-spring-mvc-mocks">6.5. WireMock and Spring MVC Mocks</a></li>
+</ul>
+</li>
+<li><a href="#features-build-tools">7. Build Tools Integration</a></li>
+<li><a href="#features-whats-next">8. What to Read Next</a></li>
+</ul>
+</div>
+</div>
+<div id="content">
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>This section dives into the details of Spring Cloud Contract. Here you can learn about the key
+features that you may want to use and customize. If you have not already done so, you
+might want to read the "<a href="getting-started.html#getting-started">getting-started.html</a>" and
+"<a href="using.html#using">using.html</a>" sections, so that you have a good grounding of the
+basics.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="contract-dsl"><a class="anchor" href="#contract-dsl"></a><a class="link" href="#contract-dsl">1. Contract DSL</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Spring Cloud Contract supports the DSLs written in the following languages:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Groovy</p>
+</li>
+<li>
+<p>YAML</p>
+</li>
+</ul>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+If you are not familiar with Groovy, do not worry - you can use Java syntax in the
+Groovy DSL files as well.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>If you decide to write the contract in Groovy, do not be alarmed if you have not used Groovy
+before. Knowledge of the language is not really needed, as the Contract DSL uses only a
+tiny subset of it (only literals, method calls, and closures). Also, the DSL is statically
+typed, to make it programmer-readable without any knowledge of the DSL itself.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Remember that, inside the Groovy contract file, you have to provide the fully
+qualified name to the <code>Contract</code> class and <code>make</code> static imports, such as
+<code>org.springframework.cloud.spec.Contract.make { &#8230;&#8203; }</code>. You can also provide an import to
+the <code>Contract</code> class (<code>import org.springframework.cloud.spec.Contract</code>) and then call
+<code>Contract.make { &#8230;&#8203; }</code>.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+Spring Cloud Contract supports defining multiple contracts in a single file.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following example shows a contract definition:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method 'PUT'
+        url '/api/12'
+        headers {
+            header 'Content-Type': 'application/vnd.org.springframework.cloud.contract.verifier.twitter-places-analyzer.v1+json'
+        }
+        body '''\
+    [{
+        "created_at": "Sat Jul 26 09:38:57 +0000 2014",
+        "id": 492967299297845248,
+        "id_str": "492967299297845248",
+        "text": "Gonna see you at Warsaw",
+        "place":
+        {
+            "attributes":{},
+            "bounding_box":
+            {
+                "coordinates":
+                    [[
+                        [-77.119759,38.791645],
+                        [-76.909393,38.791645],
+                        [-76.909393,38.995548],
+                        [-77.119759,38.995548]
+                    ]],
+                "type":"Polygon"
+            },
+            "country":"United States",
+            "country_code":"US",
+            "full_name":"Washington, DC",
+            "id":"01fbe706f872cb32",
+            "name":"Washington",
+            "place_type":"city",
+            "url": "https://api.twitter.com/1/geo/id/01fbe706f872cb32.json"
+        }
+    }]
+'''
+    }
+    response {
+        status OK()
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">description: Some description
+name: some name
+priority: 8
+ignored: true
+request:
+  url: /foo
+  queryParameters:
+    a: b
+    b: c
+  method: PUT
+  headers:
+    foo: bar
+    fooReq: baz
+  body:
+    foo: bar
+  matchers:
+    body:
+      - path: $.foo
+        type: by_regex
+        value: bar
+    headers:
+      - key: foo
+        regex: bar
+response:
+  status: 200
+  headers:
+    foo2: bar
+    foo3: foo33
+    fooRes: baz
+  body:
+    foo2: bar
+    foo3: baz
+    nullValue: null
+  matchers:
+    body:
+      - path: $.foo2
+        type: by_regex
+        value: bar
+      - path: $.foo3
+        type: by_command
+        value: executeMe($it)
+      - path: $.nullValue
+        type: by_null
+        value: null
+    headers:
+      - key: foo2
+        regex: bar
+      - key: foo3
+        command: andMeToo($it)</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>You can compile contracts to stubs mapping by using  the following standalone Maven command:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>mvn org.springframework.cloud:spring-cloud-contract-maven-plugin:convert</pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="sect2">
+<h3 id="contract-limitations"><a class="anchor" href="#contract-limitations"></a><a class="link" href="#contract-limitations">1.1. Limitations</a></h3>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title="Warning"></i>
+</td>
+<td class="content">
+The support for verifying the size of JSON arrays is experimental. If you want
+to turn it on, set the value of the following system property to <code>true</code>:
+<code>spring.cloud.contract.verifier.assert.size</code>. By default, this feature is set to <code>false</code>.
+You can also set the <code>assertJsonSize</code> property in the plugin configuration.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title="Warning"></i>
+</td>
+<td class="content">
+Because JSON structure can have any form, it can be impossible to parse it
+properly when using the Groovy DSL and the <code>value(consumer(&#8230;&#8203;), producer(&#8230;&#8203;))</code> notation in <code>GString</code>. That
+is why you should use the Groovy Map notation.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="contract-common-top-elements"><a class="anchor" href="#contract-common-top-elements"></a><a class="link" href="#contract-common-top-elements">1.2. Common Top-Level Elements</a></h3>
+<div class="paragraph">
+<p>The following sections describe the most common top-level elements:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#contract-dsl-description">Description</a></p>
+</li>
+<li>
+<p><a href="#contract-dsl-name">Name</a></p>
+</li>
+<li>
+<p><a href="#contract-dsl-ignoring-contracts">Ignoring Contracts</a></p>
+</li>
+<li>
+<p><a href="#contract-dsl-in-progress">Contracts in Progress</a></p>
+</li>
+<li>
+<p><a href="#contract-dsl-passing-values-from-files">Passing Values from Files</a></p>
+</li>
+</ul>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-description"><a class="anchor" href="#contract-dsl-description"></a><a class="link" href="#contract-dsl-description">1.2.1. Description</a></h4>
+<div class="paragraph">
+<p>You can add a <code>description</code> to your contract. The description is arbitrary text. The
+following code shows an example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">            org.springframework.cloud.contract.spec.Contract.make {
+                description('''
+given:
+    An input
+when:
+    Sth happens
+then:
+    Output
+''')
+            }</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">description: Some description
+name: some name
+priority: 8
+ignored: true
+request:
+  url: /foo
+  queryParameters:
+    a: b
+    b: c
+  method: PUT
+  headers:
+    foo: bar
+    fooReq: baz
+  body:
+    foo: bar
+  matchers:
+    body:
+      - path: $.foo
+        type: by_regex
+        value: bar
+    headers:
+      - key: foo
+        regex: bar
+response:
+  status: 200
+  headers:
+    foo2: bar
+    foo3: foo33
+    fooRes: baz
+  body:
+    foo2: bar
+    foo3: baz
+    nullValue: null
+  matchers:
+    body:
+      - path: $.foo2
+        type: by_regex
+        value: bar
+      - path: $.foo3
+        type: by_command
+        value: executeMe($it)
+      - path: $.nullValue
+        type: by_null
+        value: null
+    headers:
+      - key: foo2
+        regex: bar
+      - key: foo3
+        command: andMeToo($it)</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-name"><a class="anchor" href="#contract-dsl-name"></a><a class="link" href="#contract-dsl-name">1.2.2. Name</a></h4>
+<div class="paragraph">
+<p>You can provide a name for your contract. Assume that you provided the following name:
+<code>should register a user</code>. If you do so, the name of the autogenerated test is
+<code>validate_should_register_a_user</code>. Also, the name of the stub in a WireMock stub is
+<code>should_register_a_user.json</code>.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+You must ensure that the name does not contain any characters that make the
+generated test not compile. Also, remember that, if you provide the same name for
+multiple contracts, your autogenerated tests fail to compile and your generated stubs
+override each other.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following example shows how to add a name to a contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    name("some_special_name")
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">name: some name</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-ignoring-contracts"><a class="anchor" href="#contract-dsl-ignoring-contracts"></a><a class="link" href="#contract-dsl-ignoring-contracts">1.2.3. Ignoring Contracts</a></h4>
+<div class="paragraph">
+<p>If you want to ignore a contract, you can either set a value for ignored contracts in the
+plugin configuration or set the <code>ignored</code> property on the contract itself. The following
+example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    ignored()
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">ignored: true</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-in-progress"><a class="anchor" href="#contract-dsl-in-progress"></a><a class="link" href="#contract-dsl-in-progress">1.2.4. Contracts in Progress</a></h4>
+<div class="paragraph">
+<p>A contract in progress will not generate tests on the producer side, but will allow generation of stubs.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Use this feature with caution as it may lead to false positives. You generate stubs for your consumers to use without actually having the implementation in place!
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>If you want to set a contract in progress the following
+example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    inProgress()
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">inProgress: true</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-passing-values-from-files"><a class="anchor" href="#contract-dsl-passing-values-from-files"></a><a class="link" href="#contract-dsl-passing-values-from-files">1.2.5. Passing Values from Files</a></h4>
+<div class="paragraph">
+<p>Starting with version <code>1.2.0</code>, you can pass values from files. Assume that you have the
+following resources in your project:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── src
+    └── test
+        └── resources
+            └── contracts
+                ├── readFromFile.groovy
+                ├── request.json
+                └── response.json</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Further assume that your contract is as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">/*
+ * Copyright 2013-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import org.springframework.cloud.contract.spec.Contract
+
+Contract.make {
+    request {
+        method('PUT')
+        headers {
+            contentType(applicationJson())
+        }
+        body(file("request.json"))
+        url("/1")
+    }
+    response {
+        status OK()
+        body(file("response.json"))
+        headers {
+            contentType(applicationJson())
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">request:
+  method: GET
+  url: /foo
+  bodyFromFile: request.json
+response:
+  status: 200
+  bodyFromFile: response.json</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Further assume that the JSON files is as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">request.json</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+  "status": "REQUEST"
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">response.json</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">{
+  "status": "RESPONSE"
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>When test or stub generation takes place, the contents of the <code>request.json</code> and <code>response.json</code> files are passed to the body
+of a request or a response. The name of the file needs to be a file with location
+relative to the folder in which the contract lays.</p>
+</div>
+<div class="paragraph">
+<p>If you need to pass the contents of a file in binary form,
+you can use the <code>fileAsBytes</code> method in Groovy DSL or a <code>bodyFromFileAsBytes</code> field in YAML.</p>
+</div>
+<div class="paragraph">
+<p>The following example shows how to pass the contents of binary files:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">import org.springframework.cloud.contract.spec.Contract
+
+Contract.make {
+    request {
+        url("/1")
+        method(PUT())
+        headers {
+            contentType(applicationOctetStream())
+        }
+        body(fileAsBytes("request.pdf"))
+    }
+    response {
+        status 200
+        body(fileAsBytes("response.pdf"))
+        headers {
+            contentType(applicationOctetStream())
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">request:
+  url: /1
+  method: PUT
+  headers:
+    Content-Type: application/octet-stream
+  bodyFromFileAsBytes: request.pdf
+response:
+  status: 200
+  bodyFromFileAsBytes: response.pdf
+  headers:
+    Content-Type: application/octet-stream</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+You should use this approach whenever you want to work with binary payloads,
+ both for HTTP and messaging.
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="features-http"><a class="anchor" href="#features-http"></a><a class="link" href="#features-http">2. Contracts for HTTP</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Spring Cloud Contract lets you verify applications that use REST or HTTP as a
+means of communication. Spring Cloud Contract verifies that, for a request that matches the
+criteria from the <code>request</code> part of the contract, the server provides a response that is in
+keeping with the <code>response</code> part of the contract. Subsequently, the contracts are used to
+generate WireMock stubs that, for any request matching the provided criteria, provide a
+suitable response.</p>
+</div>
+<div class="sect2">
+<h3 id="contract-dsl-http-top-level-elements"><a class="anchor" href="#contract-dsl-http-top-level-elements"></a><a class="link" href="#contract-dsl-http-top-level-elements">2.1. HTTP Top-Level Elements</a></h3>
+<div class="paragraph">
+<p>You can call the following methods in the top-level closure of a contract definition:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>request</code>: Mandatory</p>
+</li>
+<li>
+<p><code>response</code> : Mandatory</p>
+</li>
+<li>
+<p><code>priority</code>: Optional</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The following example shows how to define an HTTP request contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    // Definition of HTTP request part of the contract
+    // (this can be a valid request or invalid depending
+    // on type of contract being specified).
+    request {
+        method GET()
+        url "/foo"
+        //...
+    }
+
+    // Definition of HTTP response part of the contract
+    // (a service implementing this contract should respond
+    // with following response after receiving request
+    // specified in "request" part above).
+    response {
+        status 200
+        //...
+    }
+
+    // Contract priority, which can be used for overriding
+    // contracts (1 is highest). Priority is optional.
+    priority 1
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">priority: 8
+request:
+...
+response:
+...</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+If you want to make your contract have a higher priority,
+you need to pass a lower number to the <code>priority</code> tag or method. For example, a <code>priority</code> with
+a value of <code>5</code> has higher priority than a <code>priority</code> with a value of <code>10</code>.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="contract-dsl-request"><a class="anchor" href="#contract-dsl-request"></a><a class="link" href="#contract-dsl-request">2.2. HTTP Request</a></h3>
+<div class="paragraph">
+<p>The HTTP protocol requires only the method and the URL to be specified in a request. The
+same information is mandatory in request definition of the contract.</p>
+</div>
+<div class="paragraph">
+<p>The following example shows a contract for a request:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        // HTTP request method (GET/POST/PUT/DELETE).
+        method 'GET'
+
+        // Path component of request URL is specified as follows.
+        urlPath('/users')
+    }
+
+    response {
+        //...
+        status 200
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">method: PUT
+url: /foo</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can specify an absolute rather than a relative <code>url</code>, but using <code>urlPath</code> is
+the recommended way, as doing so makes the tests be host-independent.</p>
+</div>
+<div class="paragraph">
+<p>The following example uses <code>url</code>:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method 'GET'
+
+        // Specifying `url` and `urlPath` in one contract is illegal.
+        url('http://localhost:8888/users')
+    }
+
+    response {
+        //...
+        status 200
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">request:
+  method: PUT
+  urlPath: /foo</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p><code>request</code> may contain query parameters, as the following example (which uses <code>urlPath</code>) shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        //...
+        method GET()
+
+        urlPath('/users') {
+
+            // Each parameter is specified in form
+            // `'paramName' : paramValue` where parameter value
+            // may be a simple literal or one of matcher functions,
+            // all of which are used in this example.
+            queryParameters {
+
+                // If a simple literal is used as value
+                // default matcher function is used (equalTo)
+                parameter 'limit': 100
+
+                // `equalTo` function simply compares passed value
+                // using identity operator (==).
+                parameter 'filter': equalTo("email")
+
+                // `containing` function matches strings
+                // that contains passed substring.
+                parameter 'gender': value(consumer(containing("[mf]")), producer('mf'))
+
+                // `matching` function tests parameter
+                // against passed regular expression.
+                parameter 'offset': value(consumer(matching("[0-9]+")), producer(123))
+
+                // `notMatching` functions tests if parameter
+                // does not match passed regular expression.
+                parameter 'loginStartsWith': value(consumer(notMatching(".{0,2}")), producer(3))
+            }
+        }
+
+        //...
+    }
+
+    response {
+        //...
+        status 200
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request:
+...
+queryParameters:
+  a: b
+  b: c</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p><code>request</code> can contain additional request headers, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        //...
+        method GET()
+        url "/foo"
+
+        // Each header is added in form `'Header-Name' : 'Header-Value'`.
+        // there are also some helper methods
+        headers {
+            header 'key': 'value'
+            contentType(applicationJson())
+        }
+
+        //...
+    }
+
+    response {
+        //...
+        status 200
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request:
+...
+headers:
+  foo: bar
+  fooReq: baz</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p><code>request</code> may contain additional request cookies, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        //...
+        method GET()
+        url "/foo"
+
+        // Each Cookies is added in form `'Cookie-Key' : 'Cookie-Value'`.
+        // there are also some helper methods
+        cookies {
+            cookie 'key': 'value'
+            cookie('another_key', 'another_value')
+        }
+
+        //...
+    }
+
+    response {
+        //...
+        status 200
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request:
+...
+cookies:
+  foo: bar
+  fooReq: baz</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p><code>request</code> may contain a request body, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        //...
+        method GET()
+        url "/foo"
+
+        // Currently only JSON format of request body is supported.
+        // Format will be determined from a header or body's content.
+        body '''{ "login" : "john", "name": "John The Contract" }'''
+    }
+
+    response {
+        //...
+        status 200
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request:
+...
+body:
+  foo: bar</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p><code>request</code> can contain multipart elements. To include multipart elements, use the
+<code>multipart</code> method/section, as the following examples show:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract contractDsl = org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method 'PUT'
+        url '/multipart'
+        headers {
+            contentType('multipart/form-data;boundary=AaB03x')
+        }
+        multipart(
+                // key (parameter name), value (parameter value) pair
+                formParameter: $(c(regex('".+"')), p('"formParameterValue"')),
+                someBooleanParameter: $(c(regex(anyBoolean())), p('true')),
+                // a named parameter (e.g. with `file` name) that represents file with
+                // `name` and `content`. You can also call `named("fileName", "fileContent")`
+                file: named(
+                        // name of the file
+                        name: $(c(regex(nonEmpty())), p('filename.csv')),
+                        // content of the file
+                        content: $(c(regex(nonEmpty())), p('file content')),
+                        // content type for the part
+                        contentType: $(c(regex(nonEmpty())), p('application/json')))
+        )
+    }
+    response {
+        status OK()
+    }
+}
+org.springframework.cloud.contract.spec.Contract contractDsl = org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method "PUT"
+        url "/multipart"
+        headers {
+            contentType('multipart/form-data;boundary=AaB03x')
+        }
+        multipart(
+                file: named(
+                        name: value(stub(regex('.+')), test('file')),
+                        content: value(stub(regex('.+')), test([100, 117, 100, 97] as byte[]))
+                )
+        )
+    }
+    response {
+        status 200
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">request:
+  method: PUT
+  url: /multipart
+  headers:
+    Content-Type: multipart/form-data;boundary=AaB03x
+  multipart:
+    params:
+      # key (parameter name), value (parameter value) pair
+      formParameter: '"formParameterValue"'
+      someBooleanParameter: true
+    named:
+      - paramName: file
+        fileName: filename.csv
+        fileContent: file content
+  matchers:
+    multipart:
+      params:
+        - key: formParameter
+          regex: ".+"
+        - key: someBooleanParameter
+          predefined: any_boolean
+      named:
+        - paramName: file
+          fileName:
+            predefined: non_empty
+          fileContent:
+            predefined: non_empty
+response:
+  status: 200</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In the preceding example, we define parameters in either of two ways:</p>
+</div>
+<div class="ulist">
+<div class="title">Groovy DSL</div>
+<ul>
+<li>
+<p>Directly, by using the map notation, where the value can be a dynamic property (such as
+<code>formParameter: $(consumer(&#8230;&#8203;), producer(&#8230;&#8203;))</code>).</p>
+</li>
+<li>
+<p>By using the <code>named(&#8230;&#8203;)</code> method that lets you set a named parameter. A named parameter
+can set a <code>name</code> and <code>content</code>. You can call it either by using a method with two arguments,
+such as <code>named("fileName", "fileContent")</code>, or by using a map notation, such as
+<code>named(name: "fileName", content: "fileContent")</code>.</p>
+</li>
+</ul>
+</div>
+<div class="ulist">
+<div class="title">YAML</div>
+<ul>
+<li>
+<p>The multipart parameters are set in the <code>multipart.params</code> section.</p>
+</li>
+<li>
+<p>The named parameters (the <code>fileName</code> and <code>fileContent</code> for a given parameter name)
+can be set in the <code>multipart.named</code> section. That section contains
+the <code>paramName</code> (the name of the parameter), <code>fileName</code> (the name of the file),
+<code>fileContent</code> (the content of the file) fields.</p>
+</li>
+<li>
+<p>The dynamic bits can be set via the <code>matchers.multipart</code> section.</p>
+<div class="ulist">
+<ul>
+<li>
+<p>For parameters, use the <code>params</code> section, which can accept
+<code>regex</code> or a <code>predefined</code> regular expression.</p>
+</li>
+<li>
+<p>for named params, use the <code>named</code> section where first you
+define the parameter name with <code>paramName</code>. Then you can pass the
+parametrization of either <code>fileName</code> or <code>fileContent</code> in a
+<code>regex</code> or in a <code>predefined</code> regular expression.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>From the contract in the preceding example, the generated test and stubs look as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Test</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">// given:
+  MockMvcRequestSpecification request = given()
+    .header("Content-Type", "multipart/form-data;boundary=AaB03x")
+    .param("formParameter", "\"formParameterValue\"")
+    .param("someBooleanParameter", "true")
+    .multiPart("file", "filename.csv", "file content".getBytes());
+
+ // when:
+  ResponseOptions response = given().spec(request)
+    .put("/multipart");
+
+ // then:
+  assertThat(response.statusCode()).isEqualTo(200);</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Stub</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">            '''
+{
+  "request" : {
+    "url" : "/multipart",
+    "method" : "PUT",
+    "headers" : {
+      "Content-Type" : {
+        "matches" : "multipart/form-data;boundary=AaB03x.*"
+      }
+    },
+    "bodyPatterns" : [ {
+        "matches" : ".*--(.*)\\r\\nContent-Disposition: form-data; name=\\"formParameter\\"\\r\\n(Content-Type: .*\\r\\n)?(Content-Transfer-Encoding: .*\\r\\n)?(Content-Length: \\\\d+\\r\\n)?\\r\\n\\".+\\"\\r\\n--\\\\1.*"
+    }, {
+        "matches" : ".*--(.*)\\r\\nContent-Disposition: form-data; name=\\"someBooleanParameter\\"\\r\\n(Content-Type: .*\\r\\n)?(Content-Transfer-Encoding: .*\\r\\n)?(Content-Length: \\\\d+\\r\\n)?\\r\\n(true|false)\\r\\n--\\\\1.*"
+    }, {
+      "matches" : ".*--(.*)\\r\\nContent-Disposition: form-data; name=\\"file\\"; filename=\\"[\\\\S\\\\s]+\\"\\r\\n(Content-Type: .*\\r\\n)?(Content-Transfer-Encoding: .*\\r\\n)?(Content-Length: \\\\d+\\r\\n)?\\r\\n[\\\\S\\\\s]+\\r\\n--\\\\1.*"
+    } ]
+  },
+  "response" : {
+    "status" : 200,
+    "transformers" : [ "response-template", "foo-transformer" ]
+  }
+}
+    '''</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="contract-dsl-response"><a class="anchor" href="#contract-dsl-response"></a><a class="link" href="#contract-dsl-response">2.3. HTTP Response</a></h3>
+<div class="paragraph">
+<p>The response must contain an HTTP status code and may contain other information. The
+following code shows an example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        //...
+        method GET()
+        url "/foo"
+    }
+    response {
+        // Status code sent by the server
+        // in response to request specified above.
+        status OK()
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">response:
+...
+status: 200</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Besides status, the response may contain headers, cookies, and a body, which are
+specified the same way as in the request (see <a href="#contract-dsl-request">HTTP Request</a>).</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+In the Groovy DSL, you can reference the <code>org.springframework.cloud.contract.spec.internal.HttpStatus</code>
+methods to provide a meaningful status instead of a digit. For example, you can call
+<code>OK()</code> for a status <code>200</code> or <code>BAD_REQUEST()</code> for <code>400</code>.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="contract-dsl-dynamic-properties"><a class="anchor" href="#contract-dsl-dynamic-properties"></a><a class="link" href="#contract-dsl-dynamic-properties">2.4. Dynamic properties</a></h3>
+<div class="paragraph">
+<p>The contract can contain some dynamic properties: timestamps, IDs, and so on. You do not
+want to force the consumers to stub their clocks to always return the same value of time
+so that it gets matched by the stub.</p>
+</div>
+<div class="paragraph">
+<p>For the Groovy DSL, you can provide the dynamic parts in your contracts
+in two ways: pass them directly in the body or set them in a separate section called
+<code>bodyMatchers</code>.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+Before 2.0.0, these were set by using <code>testMatchers</code> and <code>stubMatchers</code>.
+See the <a href="https://github.com/spring-cloud/spring-cloud-contract/wiki/Spring-Cloud-Contract-2.0-Migration-Guide">migration guide</a> for more information.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>For YAML, you can use only the <code>matchers</code> section.</p>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-dynamic-properties-in-body"><a class="anchor" href="#contract-dsl-dynamic-properties-in-body"></a><a class="link" href="#contract-dsl-dynamic-properties-in-body">2.4.1. Dynamic Properties inside the Body</a></h4>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+This section is valid only for the Groovy DSL. Check out the
+<a href="#contract-dsl-matchers">Dynamic Properties in the Matchers Sections</a> section for YAML examples of a similar feature.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>You can set the properties inside the body either with the <code>value</code> method or, if you use
+the Groovy map notation, with <code>$()</code>. The following example shows how to set dynamic
+properties with the value method:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">value</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">value(consumer(...), producer(...))
+value(c(...), p(...))
+value(stub(...), test(...))
+value(client(...), server(...))</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">$</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">$(consumer(...), producer(...))
+$(c(...), p(...))
+$(stub(...), test(...))
+$(client(...), server(...))</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Both approaches work equally well. The <code>stub</code> and <code>client</code> methods are aliases over the <code>consumer</code>
+method. Subsequent sections take a closer look at what you can do with those values.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-regex"><a class="anchor" href="#contract-dsl-regex"></a><a class="link" href="#contract-dsl-regex">2.4.2. Regular Expressions</a></h4>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+This section is valid only for Groovy DSL. Check out the
+<a href="#contract-dsl-matchers">Dynamic Properties in the Matchers Sections</a> section for YAML examples of a similar feature.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>You can use regular expressions to write your requests in the contract DSL. Doing so is
+particularly useful when you want to indicate that a given response should be provided
+for requests that follow a given pattern. Also, you can use regular expressions when you
+need to use patterns and not exact values both for your tests and your server-side tests.</p>
+</div>
+<div class="paragraph">
+<p>Make sure that regex matches a whole region of a sequence, as, internally, a call to
+<a href="https://docs.oracle.com/javase/8/docs/api/java/util/regex/Matcher.html#matches"><code>Pattern.matches()</code></a>
+is called. For instance, <code>abc</code> does not match <code>aabc</code>, but <code>.abc</code> does.
+There are several additional <a href="#contract-dsl-regex-limitations">known limitations</a> as well.</p>
+</div>
+<div class="paragraph">
+<p>The following example shows how to use regular expressions to write a request:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method('GET')
+        url $(consumer(~/\/[0-9]{2}/), producer('/12'))
+    }
+    response {
+        status OK()
+        body(
+                id: $(anyNumber()),
+                surname: $(
+                        consumer('Kowalsky'),
+                        producer(regex('[a-zA-Z]+'))
+                ),
+                name: 'Jan',
+                created: $(consumer('2014-02-02 12:23:43'), producer(execute('currentDate(it)'))),
+                correlationId: value(consumer('5d1f9fef-e0dc-4f3d-a7e4-72d2220dd827'),
+                        producer(regex('[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}'))
+                )
+        )
+        headers {
+            header 'Content-Type': 'text/plain'
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You can also provide only one side of the communication with a regular expression. If you
+do so, then the contract engine automatically provides the generated string that matches
+the provided regular expression. The following code shows an example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method 'PUT'
+        url value(consumer(regex('/foo/[0-9]{5}')))
+        body([
+                requestElement: $(consumer(regex('[0-9]{5}')))
+        ])
+        headers {
+            header('header', $(consumer(regex('application\\/vnd\\.fraud\\.v1\\+json;.*'))))
+        }
+    }
+    response {
+        status OK()
+        body([
+                responseElement: $(producer(regex('[0-9]{7}')))
+        ])
+        headers {
+            contentType("application/vnd.fraud.v1+json")
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In the preceding example, the opposite side of the communication has the respective data
+generated for request and response.</p>
+</div>
+<div class="paragraph">
+<p>Spring Cloud Contract comes with a series of predefined regular expressions that you can
+use in your contracts, as the following example shows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">protected static final Pattern TRUE_OR_FALSE = Pattern.compile("(true|false)");
+
+protected static final Pattern ALPHA_NUMERIC = Pattern.compile("[a-zA-Z0-9]+");
+
+protected static final Pattern ONLY_ALPHA_UNICODE = Pattern.compile("[\\p{L}]*");
+
+protected static final Pattern NUMBER = Pattern.compile("-?(\\d*\\.\\d+|\\d+)");
+
+protected static final Pattern INTEGER = Pattern.compile("-?(\\d+)");
+
+protected static final Pattern POSITIVE_INT = Pattern.compile("([1-9]\\d*)");
+
+protected static final Pattern DOUBLE = Pattern.compile("-?(\\d*\\.\\d+)");
+
+protected static final Pattern HEX = Pattern.compile("[a-fA-F0-9]+");
+
+protected static final Pattern IP_ADDRESS = Pattern.compile(
+        "([01]?\\d\\d?|2[0-4]\\d|25[0-5])\\.([01]?\\d\\d?|2[0-4]\\d|25[0-5])\\.([01]?\\d\\d?|2[0-4]\\d|25[0-5])\\.([01]?\\d\\d?|2[0-4]\\d|25[0-5])");
+
+protected static final Pattern HOSTNAME_PATTERN = Pattern
+        .compile("((http[s]?|ftp):/)/?([^:/\\s]+)(:[0-9]{1,5})?");
+
+protected static final Pattern EMAIL = Pattern
+        .compile("[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,6}");
+
+protected static final Pattern URL = UrlHelper.URL;
+
+protected static final Pattern HTTPS_URL = UrlHelper.HTTPS_URL;
+
+protected static final Pattern UUID = Pattern
+        .compile("[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}");
+
+protected static final Pattern ANY_DATE = Pattern
+        .compile("(\\d\\d\\d\\d)-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])");
+
+protected static final Pattern ANY_DATE_TIME = Pattern.compile(
+        "([0-9]{4})-(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9])T(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])");
+
+protected static final Pattern ANY_TIME = Pattern
+        .compile("(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])");
+
+protected static final Pattern NON_EMPTY = Pattern.compile("[\\S\\s]+");
+
+protected static final Pattern NON_BLANK = Pattern.compile("^\\s*\\S[\\S\\s]*");
+
+protected static final Pattern ISO8601_WITH_OFFSET = Pattern.compile(
+        "([0-9]{4})-(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9])T(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])(\\.\\d{3})?(Z|[+-][01]\\d:[0-5]\\d)");
+
+protected static Pattern anyOf(String... values) {
+    return Pattern.compile(Arrays.stream(values).map(it -&gt; '^' + it + '$')
+            .collect(Collectors.joining("|")));
+}
+
+public static String multipartParam(Object name, Object value) {
+    return ".*--(.*)\r\nContent-Disposition: form-data; name=\"" + name
+            + "\"\r\n(Content-Type: .*\r\n)?(Content-Transfer-Encoding: .*\r\n)?(Content-Length: \\d+\r\n)?\r\n"
+            + value + "\r\n--\\1.*";
+}
+
+public static String multipartFile(Object name, Object filename, Object content,
+        Object contentType) {
+    return ".*--(.*)\r\nContent-Disposition: form-data; name=\"" + name
+            + "\"; filename=\"" + filename + "\"\r\n(Content-Type: "
+            + toContentType(contentType)
+            + "\r\n)?(Content-Transfer-Encoding: .*\r\n)?(Content-Length: \\d+\r\n)?\r\n"
+            + content + "\r\n--\\1.*";
+}
+
+private static String toContentType(Object contentType) {
+    if (contentType == null) {
+        return ".*";
+    }
+    if (contentType instanceof RegexProperty) {
+        return ((RegexProperty) contentType).pattern();
+    }
+    return contentType.toString();
+}
+
+public RegexProperty onlyAlphaUnicode() {
+    return new RegexProperty(ONLY_ALPHA_UNICODE).asString();
+}
+
+public RegexProperty alphaNumeric() {
+    return new RegexProperty(ALPHA_NUMERIC).asString();
+}
+
+public RegexProperty number() {
+    return new RegexProperty(NUMBER).asDouble();
+}
+
+public RegexProperty positiveInt() {
+    return new RegexProperty(POSITIVE_INT).asInteger();
+}
+
+public RegexProperty anyBoolean() {
+    return new RegexProperty(TRUE_OR_FALSE).asBooleanType();
+}
+
+public RegexProperty anInteger() {
+    return new RegexProperty(INTEGER).asInteger();
+}
+
+public RegexProperty aDouble() {
+    return new RegexProperty(DOUBLE).asDouble();
+}
+
+public RegexProperty ipAddress() {
+    return new RegexProperty(IP_ADDRESS).asString();
+}
+
+public RegexProperty hostname() {
+    return new RegexProperty(HOSTNAME_PATTERN).asString();
+}
+
+public RegexProperty email() {
+    return new RegexProperty(EMAIL).asString();
+}
+
+public RegexProperty url() {
+    return new RegexProperty(URL).asString();
+}
+
+public RegexProperty httpsUrl() {
+    return new RegexProperty(HTTPS_URL).asString();
+}
+
+public RegexProperty uuid() {
+    return new RegexProperty(UUID).asString();
+}
+
+public RegexProperty isoDate() {
+    return new RegexProperty(ANY_DATE).asString();
+}
+
+public RegexProperty isoDateTime() {
+    return new RegexProperty(ANY_DATE_TIME).asString();
+}
+
+public RegexProperty isoTime() {
+    return new RegexProperty(ANY_TIME).asString();
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In your contract, you can use it as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract dslWithOptionalsInString = Contract.make {
+    priority 1
+    request {
+        method POST()
+        url '/users/password'
+        headers {
+            contentType(applicationJson())
+        }
+        body(
+                email: $(consumer(optional(regex(email()))), producer('abc@abc.com')),
+                callback_url: $(consumer(regex(hostname())), producer('http://partners.com'))
+        )
+    }
+    response {
+        status 404
+        headers {
+            contentType(applicationJson())
+        }
+        body(
+                code: value(consumer("123123"), producer(optional("123123"))),
+                message: "User not found by email = [${value(producer(regex(email())), consumer('not.existing@user.com'))}]"
+        )
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>To make matters even simpler, you can use a set of predefined objects that automatically
+assume that you want a regular expression to be passed.
+All of those methods start with the <code>any</code> prefix, as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">T anyAlphaUnicode();
+
+T anyAlphaNumeric();
+
+T anyNumber();
+
+T anyInteger();
+
+T anyPositiveInt();
+
+T anyDouble();
+
+T anyHex();
+
+T aBoolean();
+
+T anyIpAddress();
+
+T anyHostname();
+
+T anyEmail();
+
+T anyUrl();
+
+T anyHttpsUrl();
+
+T anyUuid();
+
+T anyDate();
+
+T anyDateTime();
+
+T anyTime();
+
+T anyIso8601WithOffset();
+
+T anyNonBlankString();
+
+T anyNonEmptyString();
+
+T anyOf(String... values);</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example shows how you can reference those methods:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract contractDsl = Contract.make {
+    name "foo"
+    label 'trigger_event'
+    input {
+        triggeredBy('toString()')
+    }
+    outputMessage {
+        sentTo 'topic.rateablequote'
+        body([
+                alpha            : $(anyAlphaUnicode()),
+                number           : $(anyNumber()),
+                anInteger        : $(anyInteger()),
+                positiveInt      : $(anyPositiveInt()),
+                aDouble          : $(anyDouble()),
+                aBoolean         : $(aBoolean()),
+                ip               : $(anyIpAddress()),
+                hostname         : $(anyHostname()),
+                email            : $(anyEmail()),
+                url              : $(anyUrl()),
+                httpsUrl         : $(anyHttpsUrl()),
+                uuid             : $(anyUuid()),
+                date             : $(anyDate()),
+                dateTime         : $(anyDateTime()),
+                time             : $(anyTime()),
+                iso8601WithOffset: $(anyIso8601WithOffset()),
+                nonBlankString   : $(anyNonBlankString()),
+                nonEmptyString   : $(anyNonEmptyString()),
+                anyOf            : $(anyOf('foo', 'bar'))
+        ])
+    }
+}</code></pre>
+</div>
+</div>
+<div class="sect4">
+<h5 id="contract-dsl-regex-limitations"><a class="anchor" href="#contract-dsl-regex-limitations"></a><a class="link" href="#contract-dsl-regex-limitations">Limitations</a></h5>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title="Warning"></i>
+</td>
+<td class="content">
+Due to certain limitations of the <code>Xeger</code> library that generates a string out of
+a regex, do not use the <code>$</code> and <code>^</code> signs in your regex if you rely on automatic
+generation. See <a href="https://github.com/spring-cloud/spring-cloud-contract/issues/899">Issue 899</a>.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title="Warning"></i>
+</td>
+<td class="content">
+Do not use a <code>LocalDate</code> instance as a value for <code>$</code> (for example, <code>$(consumer(LocalDate.now()))</code>).
+It causes a <code>java.lang.StackOverflowError</code>. Use <code>$(consumer(LocalDate.now().toString()))</code> instead.
+See <a href="https://github.com/spring-cloud/spring-cloud-contract/issues/900">Issue 900</a>.
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-optional-params"><a class="anchor" href="#contract-dsl-optional-params"></a><a class="link" href="#contract-dsl-optional-params">2.4.3. Passing Optional Parameters</a></h4>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+This section is valid only for Groovy DSL. Check out the
+<a href="#contract-dsl-matchers">Dynamic Properties in the Matchers Sections</a> section for YAML examples of a similar feature.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>You can provide optional parameters in your contract. However, you can provide
+optional parameters only for the following:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The STUB side of the Request</p>
+</li>
+<li>
+<p>The TEST side of the Response</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The following example shows how to provide optional parameters:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    priority 1
+    name "optionals"
+    request {
+        method 'POST'
+        url '/users/password'
+        headers {
+            contentType(applicationJson())
+        }
+        body(
+                email: $(consumer(optional(regex(email()))), producer('abc@abc.com')),
+                callback_url: $(consumer(regex(hostname())), producer('https://partners.com'))
+        )
+    }
+    response {
+        status 404
+        headers {
+            header 'Content-Type': 'application/json'
+        }
+        body(
+                code: value(consumer("123123"), producer(optional("123123")))
+        )
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>By wrapping a part of the body with the <code>optional()</code> method, you create a regular
+expression that must be present 0 or more times.</p>
+</div>
+<div class="paragraph">
+<p>If you use Spock, the following test would be generated from the previous example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">                    """\
+package com.example
+
+import com.jayway.jsonpath.DocumentContext
+import com.jayway.jsonpath.JsonPath
+import spock.lang.Specification
+import io.restassured.module.mockmvc.specification.MockMvcRequestSpecification
+import io.restassured.response.ResponseOptions
+
+import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*
+import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson
+import static io.restassured.module.mockmvc.RestAssuredMockMvc.*
+
+@SuppressWarnings("rawtypes")
+class FooSpec extends Specification {
+
+\tdef validate_optionals() throws Exception {
+\t\tgiven:
+\t\t\tMockMvcRequestSpecification request = given()
+\t\t\t\t\t.header("Content-Type", "application/json")
+\t\t\t\t\t.body('''{"email":"abc@abc.com","callback_url":"https://partners.com"}''')
+
+\t\twhen:
+\t\t\tResponseOptions response = given().spec(request)
+\t\t\t\t\t.post("/users/password")
+
+\t\tthen:
+\t\t\tresponse.statusCode() == 404
+\t\t\tresponse.header("Content-Type") == 'application/json'
+
+\t\tand:
+\t\t\tDocumentContext parsedJson = JsonPath.parse(response.body.asString())
+\t\t\tassertThatJson(parsedJson).field("['code']").matches("(123123)?")
+\t}
+
+}
+"""</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The following stub would also be generated:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">                    '''
+{
+  "request" : {
+    "url" : "/users/password",
+    "method" : "POST",
+    "bodyPatterns" : [ {
+      "matchesJsonPath" : "$[?(@.['email'] =~ /([a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\\\.[a-zA-Z]{2,6})?/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.['callback_url'] =~ /((http[s]?|ftp):\\\\/)\\\\/?([^:\\\\/\\\\s]+)(:[0-9]{1,5})?/)]"
+    } ],
+    "headers" : {
+      "Content-Type" : {
+        "equalTo" : "application/json"
+      }
+    }
+  },
+  "response" : {
+    "status" : 404,
+    "body" : "{\\"code\\":\\"123123\\",\\"message\\":\\"User not found by email == [not.existing@user.com]\\"}",
+    "headers" : {
+      "Content-Type" : "application/json"
+    }
+  },
+  "priority" : 1
+}
+'''</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-custom-methods"><a class="anchor" href="#contract-dsl-custom-methods"></a><a class="link" href="#contract-dsl-custom-methods">2.4.4. Executing Custom Methods on the Server Side</a></h4>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+This section is valid only for Groovy DSL. Check out the
+<a href="#contract-dsl-matchers">Dynamic Properties in the Matchers Sections</a> section for YAML examples of a similar feature.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>You can define a method call that runs on the server side during the test. Such a
+method can be added to the class defined as <code>baseClassForTests</code> in the configuration. The
+following code shows an example of the contract portion of the test case:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">method GET()</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The following code shows the base class portion of the test case:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">abstract class BaseMockMvcSpec extends Specification {
+
+    def setup() {
+        RestAssuredMockMvc.standaloneSetup(new PairIdController())
+    }
+
+    void isProperCorrelationId(Integer correlationId) {
+        assert correlationId == 123456
+    }
+
+    void isEmpty(String value) {
+        assert value == null
+    }
+
+}</code></pre>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+You cannot use both a <code>String</code> and <code>execute</code> to perform concatenation. For
+example, calling <code>header('Authorization', 'Bearer ' + execute('authToken()'))</code> leads to
+improper results. Instead, call <code>header('Authorization', execute('authToken()'))</code> and
+ensure that the <code>authToken()</code> method returns everything you need.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The type of the object read from the JSON can be one of the following, depending on the
+JSON path:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>String</code>: If you point to a <code>String</code> value in the JSON.</p>
+</li>
+<li>
+<p><code>JSONArray</code>: If you point to a <code>List</code> in the JSON.</p>
+</li>
+<li>
+<p><code>Map</code>: If you point to a <code>Map</code> in the JSON.</p>
+</li>
+<li>
+<p><code>Number</code>: If you point to <code>Integer</code>, <code>Double</code>, and other numeric type in the JSON.</p>
+</li>
+<li>
+<p><code>Boolean</code>: If you point to a <code>Boolean</code> in the JSON.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In the request part of the contract, you can specify that the <code>body</code> should be taken from
+a method.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+You must provide both the consumer and the producer side. The <code>execute</code> part
+is applied for the whole body, not for parts of it.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following example shows how to read an object from JSON:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract contractDsl = Contract.make {
+    request {
+        method 'GET'
+        url '/something'
+        body(
+                $(c('foo'), p(execute('hashCode()')))
+        )
+    }
+    response {
+        status OK()
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The preceding example results in calling the <code>hashCode()</code> method in the request body.
+It should resemble the following code:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">// given:
+ MockMvcRequestSpecification request = given()
+   .body(hashCode());
+
+// when:
+ ResponseOptions response = given().spec(request)
+   .get("/something");
+
+// then:
+ assertThat(response.statusCode()).isEqualTo(200);</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-referencing-request-from-response"><a class="anchor" href="#contract-dsl-referencing-request-from-response"></a><a class="link" href="#contract-dsl-referencing-request-from-response">2.4.5. Referencing the Request from the Response</a></h4>
+<div class="paragraph">
+<p>The best situation is to provide fixed values, but sometimes you need to reference a
+request in your response.</p>
+</div>
+<div class="paragraph">
+<p>If you write contracts in the Groovy DSL, you can use the <code>fromRequest()</code> method, which lets
+you reference a bunch of elements from the HTTP request. You can use the following
+options:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>fromRequest().url()</code>: Returns the request URL and query parameters.</p>
+</li>
+<li>
+<p><code>fromRequest().query(String key)</code>: Returns the first query parameter with a given name.</p>
+</li>
+<li>
+<p><code>fromRequest().query(String key, int index)</code>: Returns the nth query parameter with a
+given name.</p>
+</li>
+<li>
+<p><code>fromRequest().path()</code>: Returns the full path.</p>
+</li>
+<li>
+<p><code>fromRequest().path(int index)</code>: Returns the nth path element.</p>
+</li>
+<li>
+<p><code>fromRequest().header(String key)</code>: Returns the first header with a given name.</p>
+</li>
+<li>
+<p><code>fromRequest().header(String key, int index)</code>: Returns the nth header with a given name.</p>
+</li>
+<li>
+<p><code>fromRequest().body()</code>: Returns the full request body.</p>
+</li>
+<li>
+<p><code>fromRequest().body(String jsonPath)</code>: Returns the element from the request that
+matches the JSON Path.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>If you use the YAML contract definition, you have to use the
+<a href="https://handlebarsjs.com/">Handlebars</a> <code>{{{ }}}</code> notation with custom Spring Cloud Contract
+functions to achieve this. In that case, you can use the following options:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>{{{ request.url }}}</code>: Returns the request URL and query parameters.</p>
+</li>
+<li>
+<p><code>{{{ request.query.key.[index] }}}</code>: Returns the nth query parameter with a given name.
+For example, for a key of <code>thing</code>, the first entry is <code>{{{ request.query.thing.[0] }}}</code></p>
+</li>
+<li>
+<p><code>{{{ request.path }}}</code>: Returns the full path.</p>
+</li>
+<li>
+<p><code>{{{ request.path.[index] }}}</code>: Returns the nth path element. For example,
+the first entry is <code>`</code>{{{ request.path.[0] }}}</p>
+</li>
+<li>
+<p><code>{{{ request.headers.key }}}</code>: Returns the first header with a given name.</p>
+</li>
+<li>
+<p><code>{{{ request.headers.key.[index] }}}</code>: Returns the nth header with a given name.</p>
+</li>
+<li>
+<p><code>{{{ request.body }}}</code>: Returns the full request body.</p>
+</li>
+<li>
+<p><code>{{{ jsonpath this 'your.json.path' }}}</code>: Returns the element from the request that
+matches the JSON Path. For example, for a JSON path of <code>$.here</code>, use <code>{{{ jsonpath this '$.here' }}}</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Consider the following contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract contractDsl = Contract.make {
+    request {
+        method 'GET'
+        url('/api/v1/xxxx') {
+            queryParameters {
+                parameter('foo', 'bar')
+                parameter('foo', 'bar2')
+            }
+        }
+        headers {
+            header(authorization(), 'secret')
+            header(authorization(), 'secret2')
+        }
+        body(foo: 'bar', baz: 5)
+    }
+    response {
+        status OK()
+        headers {
+            header(authorization(), "foo ${fromRequest().header(authorization())} bar")
+        }
+        body(
+                url: fromRequest().url(),
+                path: fromRequest().path(),
+                pathIndex: fromRequest().path(1),
+                param: fromRequest().query('foo'),
+                paramIndex: fromRequest().query('foo', 1),
+                authorization: fromRequest().header('Authorization'),
+                authorization2: fromRequest().header('Authorization', 1),
+                fullBody: fromRequest().body(),
+                responseFoo: fromRequest().body('$.foo'),
+                responseBaz: fromRequest().body('$.baz'),
+                responseBaz2: "Bla bla ${fromRequest().body('$.foo')} bla bla",
+                rawUrl: fromRequest().rawUrl(),
+                rawPath: fromRequest().rawPath(),
+                rawPathIndex: fromRequest().rawPath(1),
+                rawParam: fromRequest().rawQuery('foo'),
+                rawParamIndex: fromRequest().rawQuery('foo', 1),
+                rawAuthorization: fromRequest().rawHeader('Authorization'),
+                rawAuthorization2: fromRequest().rawHeader('Authorization', 1),
+                rawResponseFoo: fromRequest().rawBody('$.foo'),
+                rawResponseBaz: fromRequest().rawBody('$.baz'),
+                rawResponseBaz2: "Bla bla ${fromRequest().rawBody('$.foo')} bla bla"
+        )
+    }
+}
+Contract contractDsl = Contract.make {
+    request {
+        method 'GET'
+        url('/api/v1/xxxx') {
+            queryParameters {
+                parameter('foo', 'bar')
+                parameter('foo', 'bar2')
+            }
+        }
+        headers {
+            header(authorization(), 'secret')
+            header(authorization(), 'secret2')
+        }
+        body(foo: "bar", baz: 5)
+    }
+    response {
+        status OK()
+        headers {
+            contentType(applicationJson())
+        }
+        body('''
+                {
+                    "responseFoo": "{{{ jsonPath request.body '$.foo' }}}",
+                    "responseBaz": {{{ jsonPath request.body '$.baz' }}},
+                    "responseBaz2": "Bla bla {{{ jsonPath request.body '$.foo' }}} bla bla"
+                }
+        '''.toString())
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">request:
+  method: GET
+  url: /api/v1/xxxx
+  queryParameters:
+    foo:
+      - bar
+      - bar2
+  headers:
+    Authorization:
+      - secret
+      - secret2
+  body:
+    foo: bar
+    baz: 5
+response:
+  status: 200
+  headers:
+    Authorization: "foo {{{ request.headers.Authorization.0 }}} bar"
+  body:
+    url: "{{{ request.url }}}"
+    path: "{{{ request.path }}}"
+    pathIndex: "{{{ request.path.1 }}}"
+    param: "{{{ request.query.foo }}}"
+    paramIndex: "{{{ request.query.foo.1 }}}"
+    authorization: "{{{ request.headers.Authorization.0 }}}"
+    authorization2: "{{{ request.headers.Authorization.1 }}"
+    fullBody: "{{{ request.body }}}"
+    responseFoo: "{{{ jsonpath this '$.foo' }}}"
+    responseBaz: "{{{ jsonpath this '$.baz' }}}"
+    responseBaz2: "Bla bla {{{ jsonpath this '$.foo' }}} bla bla"</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Running a JUnit test generation leads to a test that resembles the following example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">// given:
+ MockMvcRequestSpecification request = given()
+   .header("Authorization", "secret")
+   .header("Authorization", "secret2")
+   .body("{\"foo\":\"bar\",\"baz\":5}");
+
+// when:
+ ResponseOptions response = given().spec(request)
+   .queryParam("foo","bar")
+   .queryParam("foo","bar2")
+   .get("/api/v1/xxxx");
+
+// then:
+ assertThat(response.statusCode()).isEqualTo(200);
+ assertThat(response.header("Authorization")).isEqualTo("foo secret bar");
+// and:
+ DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
+ assertThatJson(parsedJson).field("['fullBody']").isEqualTo("{\"foo\":\"bar\",\"baz\":5}");
+ assertThatJson(parsedJson).field("['authorization']").isEqualTo("secret");
+ assertThatJson(parsedJson).field("['authorization2']").isEqualTo("secret2");
+ assertThatJson(parsedJson).field("['path']").isEqualTo("/api/v1/xxxx");
+ assertThatJson(parsedJson).field("['param']").isEqualTo("bar");
+ assertThatJson(parsedJson).field("['paramIndex']").isEqualTo("bar2");
+ assertThatJson(parsedJson).field("['pathIndex']").isEqualTo("v1");
+ assertThatJson(parsedJson).field("['responseBaz']").isEqualTo(5);
+ assertThatJson(parsedJson).field("['responseFoo']").isEqualTo("bar");
+ assertThatJson(parsedJson).field("['url']").isEqualTo("/api/v1/xxxx?foo=bar&amp;foo=bar2");
+ assertThatJson(parsedJson).field("['responseBaz2']").isEqualTo("Bla bla bar bla bla");</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>As you can see, elements from the request have been properly referenced in the response.</p>
+</div>
+<div class="paragraph">
+<p>The generated WireMock stub should resemble the following example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+  "request" : {
+    "urlPath" : "/api/v1/xxxx",
+    "method" : "POST",
+    "headers" : {
+      "Authorization" : {
+        "equalTo" : "secret2"
+      }
+    },
+    "queryParameters" : {
+      "foo" : {
+        "equalTo" : "bar2"
+      }
+    },
+    "bodyPatterns" : [ {
+      "matchesJsonPath" : "$[?(@.['baz'] == 5)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.['foo'] == 'bar')]"
+    } ]
+  },
+  "response" : {
+    "status" : 200,
+    "body" : "{\"authorization\":\"{{{request.headers.Authorization.[0]}}}\",\"path\":\"{{{request.path}}}\",\"responseBaz\":{{{jsonpath this '$.baz'}}} ,\"param\":\"{{{request.query.foo.[0]}}}\",\"pathIndex\":\"{{{request.path.[1]}}}\",\"responseBaz2\":\"Bla bla {{{jsonpath this '$.foo'}}} bla bla\",\"responseFoo\":\"{{{jsonpath this '$.foo'}}}\",\"authorization2\":\"{{{request.headers.Authorization.[1]}}}\",\"fullBody\":\"{{{escapejsonbody}}}\",\"url\":\"{{{request.url}}}\",\"paramIndex\":\"{{{request.query.foo.[1]}}}\"}",
+    "headers" : {
+      "Authorization" : "{{{request.headers.Authorization.[0]}}};foo"
+    },
+    "transformers" : [ "response-template" ]
+  }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Sending a request such as the one presented in the <code>request</code> part of the contract results
+in sending the following response body:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+  "url" : "/api/v1/xxxx?foo=bar&amp;foo=bar2",
+  "path" : "/api/v1/xxxx",
+  "pathIndex" : "v1",
+  "param" : "bar",
+  "paramIndex" : "bar2",
+  "authorization" : "secret",
+  "authorization2" : "secret2",
+  "fullBody" : "{\"foo\":\"bar\",\"baz\":5}",
+  "responseFoo" : "bar",
+  "responseBaz" : 5,
+  "responseBaz2" : "Bla bla bar bla bla"
+}</code></pre>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+This feature works only with WireMock versions greater than or equal
+to 2.5.1. The Spring Cloud Contract Verifier uses WireMock&#8217;s
+<code>response-template</code> response transformer. It uses Handlebars to convert the Mustache <code>{{{ }}}</code> templates into
+proper values. Additionally, it registers two helper functions:
+</td>
+</tr>
+</table>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>escapejsonbody</code>: Escapes the request body in a format that can be embedded in a JSON.</p>
+</li>
+<li>
+<p><code>jsonpath</code>: For a given parameter, find an object in the request body.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-matchers"><a class="anchor" href="#contract-dsl-matchers"></a><a class="link" href="#contract-dsl-matchers">2.4.6. Dynamic Properties in the Matchers Sections</a></h4>
+<div class="paragraph">
+<p>If you work with <a href="https://docs.pact.io/">Pact</a>, the following discussion may seem familiar.
+Quite a few users are used to having a separation between the body and setting the
+dynamic parts of a contract.</p>
+</div>
+<div class="paragraph">
+<p>You can use the <code>bodyMatchers</code> section for two reasons:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Define the dynamic values that should end up in a stub.
+You can set it in the <code>request</code> or <code>inputMessage</code> part of your contract.</p>
+</li>
+<li>
+<p>Verify the result of your test.
+This section is present in the <code>response</code> or <code>outputMessage</code> side of the
+contract.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Currently, Spring Cloud Contract Verifier supports only JSON path-based matchers with the
+following matching possibilities:</p>
+</div>
+<div class="sect4">
+<h5 id="groovy-dsl"><a class="anchor" href="#groovy-dsl"></a><a class="link" href="#groovy-dsl">Groovy DSL</a></h5>
+<div class="ulist">
+<ul>
+<li>
+<p>For the stubs (in tests on the consumer&#8217;s side):</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>byEquality()</code>: The value taken from the consumer&#8217;s request in the provided JSON path must be
+equal to the value provided in the contract.</p>
+</li>
+<li>
+<p><code>byRegex(&#8230;&#8203;)</code>: The value taken from the consumer&#8217;s request in the provided JSON path must
+match the regex. You can also pass the type of the expected matched value (for example, <code>asString()</code>, <code>asLong()</code>, and so on).</p>
+</li>
+<li>
+<p><code>byDate()</code>: The value taken from the consumer&#8217;s request in the provided JSON path must
+match the regex for an ISO Date value.</p>
+</li>
+<li>
+<p><code>byTimestamp()</code>: The value taken from the consumer&#8217;s request in the provided JSON path must
+match the regex for an ISO DateTime value.</p>
+</li>
+<li>
+<p><code>byTime()</code>: The value taken from the consumer&#8217;s request in the provided JSON path must
+match the regex for an ISO Time value.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>For the verification (in generated tests on the Producer&#8217;s side):</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>byEquality()</code>: The value taken from the producer&#8217;s response in the provided JSON path must be
+equal to the provided value in the contract.</p>
+</li>
+<li>
+<p><code>byRegex(&#8230;&#8203;)</code>: The value taken from the producer&#8217;s response in the provided JSON path must
+match the regex.</p>
+</li>
+<li>
+<p><code>byDate()</code>: The value taken from the producer&#8217;s response in the provided JSON path must match
+the regex for an ISO Date value.</p>
+</li>
+<li>
+<p><code>byTimestamp()</code>: The value taken from the producer&#8217;s response in the provided JSON path must
+match the regex for an ISO DateTime value.</p>
+</li>
+<li>
+<p><code>byTime()</code>: The value taken from the producer&#8217;s response in the provided JSON path must match
+the regex for an ISO Time value.</p>
+</li>
+<li>
+<p><code>byType()</code>: The value taken from the producer&#8217;s response in the provided JSON path needs to be
+of the same type as the type defined in the body of the response in the contract.
+<code>byType</code> can take a closure, in which you can set <code>minOccurrence</code> and <code>maxOccurrence</code>. For the
+request side, you should use the closure to assert size of the collection.
+That way, you can assert the size of the flattened collection. To check the size of an
+unflattened collection, use a custom method with the <code>byCommand(&#8230;&#8203;)</code> <code>testMatcher</code>.</p>
+</li>
+<li>
+<p><code>byCommand(&#8230;&#8203;)</code>: The value taken from the producer&#8217;s response in the provided JSON path is
+passed as an input to the custom method that you provide. For example,
+<code>byCommand('thing($it)')</code> results in calling a <code>thing</code> method to which the value matching the
+JSON Path gets passed. The type of the object read from the JSON can be one of the
+following, depending on the JSON path:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>String</code>: If you point to a <code>String</code> value.</p>
+</li>
+<li>
+<p><code>JSONArray</code>: If you point to a <code>List</code>.</p>
+</li>
+<li>
+<p><code>Map</code>: If you point to a <code>Map</code>.</p>
+</li>
+<li>
+<p><code>Number</code>: If you point to <code>Integer</code>, <code>Double</code>, or another kind of number.</p>
+</li>
+<li>
+<p><code>Boolean</code>: If you point to a <code>Boolean</code>.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><code>byNull()</code>: The value taken from the response in the provided JSON path must be null.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="yaml"><a class="anchor" href="#yaml"></a><a class="link" href="#yaml">YAML</a></h5>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+See the Groovy section for detailed explanation of
+what the types mean.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>For YAML, the structure of a matcher resembles the following example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">- path: $.thing1
+  type: by_regex
+  value: thing2
+  regexType: as_string</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Alternatively, if you want to use one of the predefined regular expressions
+<code>[only_alpha_unicode, number, any_boolean, ip_address, hostname,
+email, url, uuid, iso_date, iso_date_time, iso_time, iso_8601_with_offset, non_empty,
+non_blank]</code>, you can use something similar to the following example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">- path: $.thing1
+  type: by_regex
+  predefined: only_alpha_unicode</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The following list shows the allowed list of <code>type</code> values:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>For <code>stubMatchers</code>:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>by_equality</code></p>
+</li>
+<li>
+<p><code>by_regex</code></p>
+</li>
+<li>
+<p><code>by_date</code></p>
+</li>
+<li>
+<p><code>by_timestamp</code></p>
+</li>
+<li>
+<p><code>by_time</code></p>
+</li>
+<li>
+<p><code>by_type</code></p>
+<div class="ulist">
+<ul>
+<li>
+<p>Two additional fields (<code>minOccurrence</code> and <code>maxOccurrence</code>) are accepted.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>For <code>testMatchers</code>:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>by_equality</code></p>
+</li>
+<li>
+<p><code>by_regex</code></p>
+</li>
+<li>
+<p><code>by_date</code></p>
+</li>
+<li>
+<p><code>by_timestamp</code></p>
+</li>
+<li>
+<p><code>by_time</code></p>
+</li>
+<li>
+<p><code>by_type</code></p>
+<div class="ulist">
+<ul>
+<li>
+<p>Two additional fields (<code>minOccurrence</code> and <code>maxOccurrence</code>) are accepted.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><code>by_command</code></p>
+</li>
+<li>
+<p><code>by_null</code></p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>You can also define which type the regular expression corresponds to in the <code>regexType</code>
+field. The following list shows the allowed regular expression types:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>as_integer</code></p>
+</li>
+<li>
+<p><code>as_double</code></p>
+</li>
+<li>
+<p><code>as_float</code></p>
+</li>
+<li>
+<p><code>as_long</code></p>
+</li>
+<li>
+<p><code>as_short</code></p>
+</li>
+<li>
+<p><code>as_boolean</code></p>
+</li>
+<li>
+<p><code>as_string</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Consider the following example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract contractDsl = Contract.make {
+    request {
+        method 'GET'
+        urlPath '/get'
+        body([
+                duck                : 123,
+                alpha               : 'abc',
+                number              : 123,
+                aBoolean            : true,
+                date                : '2017-01-01',
+                dateTime            : '2017-01-01T01:23:45',
+                time                : '01:02:34',
+                valueWithoutAMatcher: 'foo',
+                valueWithTypeMatch  : 'string',
+                key                 : [
+                        'complex.key': 'foo'
+                ]
+        ])
+        bodyMatchers {
+            jsonPath('$.duck', byRegex("[0-9]{3}").asInteger())
+            jsonPath('$.duck', byEquality())
+            jsonPath('$.alpha', byRegex(onlyAlphaUnicode()).asString())
+            jsonPath('$.alpha', byEquality())
+            jsonPath('$.number', byRegex(number()).asInteger())
+            jsonPath('$.aBoolean', byRegex(anyBoolean()).asBooleanType())
+            jsonPath('$.date', byDate())
+            jsonPath('$.dateTime', byTimestamp())
+            jsonPath('$.time', byTime())
+            jsonPath("\$.['key'].['complex.key']", byEquality())
+        }
+        headers {
+            contentType(applicationJson())
+        }
+    }
+    response {
+        status OK()
+        body([
+                duck                 : 123,
+                alpha                : 'abc',
+                number               : 123,
+                positiveInteger      : 1234567890,
+                negativeInteger      : -1234567890,
+                positiveDecimalNumber: 123.4567890,
+                negativeDecimalNumber: -123.4567890,
+                aBoolean             : true,
+                date                 : '2017-01-01',
+                dateTime             : '2017-01-01T01:23:45',
+                time                 : "01:02:34",
+                valueWithoutAMatcher : 'foo',
+                valueWithTypeMatch   : 'string',
+                valueWithMin         : [
+                        1, 2, 3
+                ],
+                valueWithMax         : [
+                        1, 2, 3
+                ],
+                valueWithMinMax      : [
+                        1, 2, 3
+                ],
+                valueWithMinEmpty    : [],
+                valueWithMaxEmpty    : [],
+                key                  : [
+                        'complex.key': 'foo'
+                ],
+                nullValue            : null
+        ])
+        bodyMatchers {
+            // asserts the jsonpath value against manual regex
+            jsonPath('$.duck', byRegex("[0-9]{3}").asInteger())
+            // asserts the jsonpath value against the provided value
+            jsonPath('$.duck', byEquality())
+            // asserts the jsonpath value against some default regex
+            jsonPath('$.alpha', byRegex(onlyAlphaUnicode()).asString())
+            jsonPath('$.alpha', byEquality())
+            jsonPath('$.number', byRegex(number()).asInteger())
+            jsonPath('$.positiveInteger', byRegex(anInteger()).asInteger())
+            jsonPath('$.negativeInteger', byRegex(anInteger()).asInteger())
+            jsonPath('$.positiveDecimalNumber', byRegex(aDouble()).asDouble())
+            jsonPath('$.negativeDecimalNumber', byRegex(aDouble()).asDouble())
+            jsonPath('$.aBoolean', byRegex(anyBoolean()).asBooleanType())
+            // asserts vs inbuilt time related regex
+            jsonPath('$.date', byDate())
+            jsonPath('$.dateTime', byTimestamp())
+            jsonPath('$.time', byTime())
+            // asserts that the resulting type is the same as in response body
+            jsonPath('$.valueWithTypeMatch', byType())
+            jsonPath('$.valueWithMin', byType {
+                // results in verification of size of array (min 1)
+                minOccurrence(1)
+            })
+            jsonPath('$.valueWithMax', byType {
+                // results in verification of size of array (max 3)
+                maxOccurrence(3)
+            })
+            jsonPath('$.valueWithMinMax', byType {
+                // results in verification of size of array (min 1 &amp; max 3)
+                minOccurrence(1)
+                maxOccurrence(3)
+            })
+            jsonPath('$.valueWithMinEmpty', byType {
+                // results in verification of size of array (min 0)
+                minOccurrence(0)
+            })
+            jsonPath('$.valueWithMaxEmpty', byType {
+                // results in verification of size of array (max 0)
+                maxOccurrence(0)
+            })
+            // will execute a method `assertThatValueIsANumber`
+            jsonPath('$.duck', byCommand('assertThatValueIsANumber($it)'))
+            jsonPath("\$.['key'].['complex.key']", byEquality())
+            jsonPath('$.nullValue', byNull())
+        }
+        headers {
+            contentType(applicationJson())
+            header('Some-Header', $(c('someValue'), p(regex('[a-zA-Z]{9}'))))
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">request:
+  method: GET
+  urlPath: /get/1
+  headers:
+    Content-Type: application/json
+  cookies:
+    foo: 2
+    bar: 3
+  queryParameters:
+    limit: 10
+    offset: 20
+    filter: 'email'
+    sort: name
+    search: 55
+    age: 99
+    name: John.Doe
+    email: 'bob@email.com'
+  body:
+    duck: 123
+    alpha: "abc"
+    number: 123
+    aBoolean: true
+    date: "2017-01-01"
+    dateTime: "2017-01-01T01:23:45"
+    time: "01:02:34"
+    valueWithoutAMatcher: "foo"
+    valueWithTypeMatch: "string"
+    key:
+      "complex.key": 'foo'
+    nullValue: null
+    valueWithMin:
+      - 1
+      - 2
+      - 3
+    valueWithMax:
+      - 1
+      - 2
+      - 3
+    valueWithMinMax:
+      - 1
+      - 2
+      - 3
+    valueWithMinEmpty: []
+    valueWithMaxEmpty: []
+  matchers:
+    url:
+      regex: /get/[0-9]
+      # predefined:
+      # execute a method
+      #command: 'equals($it)'
+    queryParameters:
+      - key: limit
+        type: equal_to
+        value: 20
+      - key: offset
+        type: containing
+        value: 20
+      - key: sort
+        type: equal_to
+        value: name
+      - key: search
+        type: not_matching
+        value: '^[0-9]{2}$'
+      - key: age
+        type: not_matching
+        value: '^\\w*$'
+      - key: name
+        type: matching
+        value: 'John.*'
+      - key: hello
+        type: absent
+    cookies:
+      - key: foo
+        regex: '[0-9]'
+      - key: bar
+        command: 'equals($it)'
+    headers:
+      - key: Content-Type
+        regex: "application/json.*"
+    body:
+      - path: $.duck
+        type: by_regex
+        value: "[0-9]{3}"
+      - path: $.duck
+        type: by_equality
+      - path: $.alpha
+        type: by_regex
+        predefined: only_alpha_unicode
+      - path: $.alpha
+        type: by_equality
+      - path: $.number
+        type: by_regex
+        predefined: number
+      - path: $.aBoolean
+        type: by_regex
+        predefined: any_boolean
+      - path: $.date
+        type: by_date
+      - path: $.dateTime
+        type: by_timestamp
+      - path: $.time
+        type: by_time
+      - path: "$.['key'].['complex.key']"
+        type: by_equality
+      - path: $.nullvalue
+        type: by_null
+      - path: $.valueWithMin
+        type: by_type
+        minOccurrence: 1
+      - path: $.valueWithMax
+        type: by_type
+        maxOccurrence: 3
+      - path: $.valueWithMinMax
+        type: by_type
+        minOccurrence: 1
+        maxOccurrence: 3
+response:
+  status: 200
+  cookies:
+    foo: 1
+    bar: 2
+  body:
+    duck: 123
+    alpha: "abc"
+    number: 123
+    aBoolean: true
+    date: "2017-01-01"
+    dateTime: "2017-01-01T01:23:45"
+    time: "01:02:34"
+    valueWithoutAMatcher: "foo"
+    valueWithTypeMatch: "string"
+    valueWithMin:
+      - 1
+      - 2
+      - 3
+    valueWithMax:
+      - 1
+      - 2
+      - 3
+    valueWithMinMax:
+      - 1
+      - 2
+      - 3
+    valueWithMinEmpty: []
+    valueWithMaxEmpty: []
+    key:
+      'complex.key': 'foo'
+    nulValue: null
+  matchers:
+    headers:
+      - key: Content-Type
+        regex: "application/json.*"
+    cookies:
+      - key: foo
+        regex: '[0-9]'
+      - key: bar
+        command: 'equals($it)'
+    body:
+      - path: $.duck
+        type: by_regex
+        value: "[0-9]{3}"
+      - path: $.duck
+        type: by_equality
+      - path: $.alpha
+        type: by_regex
+        predefined: only_alpha_unicode
+      - path: $.alpha
+        type: by_equality
+      - path: $.number
+        type: by_regex
+        predefined: number
+      - path: $.aBoolean
+        type: by_regex
+        predefined: any_boolean
+      - path: $.date
+        type: by_date
+      - path: $.dateTime
+        type: by_timestamp
+      - path: $.time
+        type: by_time
+      - path: $.valueWithTypeMatch
+        type: by_type
+      - path: $.valueWithMin
+        type: by_type
+        minOccurrence: 1
+      - path: $.valueWithMax
+        type: by_type
+        maxOccurrence: 3
+      - path: $.valueWithMinMax
+        type: by_type
+        minOccurrence: 1
+        maxOccurrence: 3
+      - path: $.valueWithMinEmpty
+        type: by_type
+        minOccurrence: 0
+      - path: $.valueWithMaxEmpty
+        type: by_type
+        maxOccurrence: 0
+      - path: $.duck
+        type: by_command
+        value: assertThatValueIsANumber($it)
+      - path: $.nullValue
+        type: by_null
+        value: null
+  headers:
+    Content-Type: application/json</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In the preceding example, you can see the dynamic portions of the contract in the
+<code>matchers</code> sections. For the request part, you can see that, for all fields but
+<code>valueWithoutAMatcher</code>, the values of the regular expressions that the stub should
+contain are explicitly set. For the <code>valueWithoutAMatcher</code>, the verification takes place
+in the same way as without the use of matchers. In that case, the test performs an
+equality check.</p>
+</div>
+<div class="paragraph">
+<p>For the response side in the <code>bodyMatchers</code> section, we define the dynamic parts in a
+similar manner. The only difference is that the <code>byType</code> matchers are also present. The
+verifier engine checks four fields to verify whether the response from the test
+has a value for which the JSON path matches the given field, is of the same type as the one
+defined in the response body, and passes the following check (based on the method being called):</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>For <code>$.valueWithTypeMatch</code>, the engine checks whether the type is the same.</p>
+</li>
+<li>
+<p>For <code>$.valueWithMin</code>, the engine checks the type and asserts whether the size is greater
+than or equal to the minimum occurrence.</p>
+</li>
+<li>
+<p>For <code>$.valueWithMax</code>, the engine checks the type and asserts whether the size is
+smaller than or equal to the maximum occurrence.</p>
+</li>
+<li>
+<p>For <code>$.valueWithMinMax</code>, the engine checks the type and asserts whether the size is
+between the minimum and maximum occurrence.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The resulting test resembles the following example (note that an <code>and</code> section
+separates the autogenerated assertions and the assertion from matchers):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">// given:
+ MockMvcRequestSpecification request = given()
+   .header("Content-Type", "application/json")
+   .body("{\"duck\":123,\"alpha\":\"abc\",\"number\":123,\"aBoolean\":true,\"date\":\"2017-01-01\",\"dateTime\":\"2017-01-01T01:23:45\",\"time\":\"01:02:34\",\"valueWithoutAMatcher\":\"foo\",\"valueWithTypeMatch\":\"string\",\"key\":{\"complex.key\":\"foo\"}}");
+
+// when:
+ ResponseOptions response = given().spec(request)
+   .get("/get");
+
+// then:
+ assertThat(response.statusCode()).isEqualTo(200);
+ assertThat(response.header("Content-Type")).matches("application/json.*");
+// and:
+ DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
+ assertThatJson(parsedJson).field("['valueWithoutAMatcher']").isEqualTo("foo");
+// and:
+ assertThat(parsedJson.read("$.duck", String.class)).matches("[0-9]{3}");
+ assertThat(parsedJson.read("$.duck", Integer.class)).isEqualTo(123);
+ assertThat(parsedJson.read("$.alpha", String.class)).matches("[\\p{L}]*");
+ assertThat(parsedJson.read("$.alpha", String.class)).isEqualTo("abc");
+ assertThat(parsedJson.read("$.number", String.class)).matches("-?(\\d*\\.\\d+|\\d+)");
+ assertThat(parsedJson.read("$.aBoolean", String.class)).matches("(true|false)");
+ assertThat(parsedJson.read("$.date", String.class)).matches("(\\d\\d\\d\\d)-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])");
+ assertThat(parsedJson.read("$.dateTime", String.class)).matches("([0-9]{4})-(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9])T(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])");
+ assertThat(parsedJson.read("$.time", String.class)).matches("(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])");
+ assertThat((Object) parsedJson.read("$.valueWithTypeMatch")).isInstanceOf(java.lang.String.class);
+ assertThat((Object) parsedJson.read("$.valueWithMin")).isInstanceOf(java.util.List.class);
+ assertThat((java.lang.Iterable) parsedJson.read("$.valueWithMin", java.util.Collection.class)).as("$.valueWithMin").hasSizeGreaterThanOrEqualTo(1);
+ assertThat((Object) parsedJson.read("$.valueWithMax")).isInstanceOf(java.util.List.class);
+ assertThat((java.lang.Iterable) parsedJson.read("$.valueWithMax", java.util.Collection.class)).as("$.valueWithMax").hasSizeLessThanOrEqualTo(3);
+ assertThat((Object) parsedJson.read("$.valueWithMinMax")).isInstanceOf(java.util.List.class);
+ assertThat((java.lang.Iterable) parsedJson.read("$.valueWithMinMax", java.util.Collection.class)).as("$.valueWithMinMax").hasSizeBetween(1, 3);
+ assertThat((Object) parsedJson.read("$.valueWithMinEmpty")).isInstanceOf(java.util.List.class);
+ assertThat((java.lang.Iterable) parsedJson.read("$.valueWithMinEmpty", java.util.Collection.class)).as("$.valueWithMinEmpty").hasSizeGreaterThanOrEqualTo(0);
+ assertThat((Object) parsedJson.read("$.valueWithMaxEmpty")).isInstanceOf(java.util.List.class);
+ assertThat((java.lang.Iterable) parsedJson.read("$.valueWithMaxEmpty", java.util.Collection.class)).as("$.valueWithMaxEmpty").hasSizeLessThanOrEqualTo(0);
+ assertThatValueIsANumber(parsedJson.read("$.duck"));
+ assertThat(parsedJson.read("$.['key'].['complex.key']", String.class)).isEqualTo("foo");</code></pre>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Notice that, for the <code>byCommand</code> method, the example calls the
+<code>assertThatValueIsANumber</code>. This method must be defined in the test base class or be
+statically imported to your tests. Notice that the <code>byCommand</code> call was converted to
+<code>assertThatValueIsANumber(parsedJson.read("$.duck"));</code>. That means that the engine took
+the method name and passed the proper JSON path as a parameter to it.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The resulting WireMock stub is in the following example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">                    '''
+{
+  "request" : {
+    "urlPath" : "/get",
+    "method" : "POST",
+    "headers" : {
+      "Content-Type" : {
+        "matches" : "application/json.*"
+      }
+    },
+    "bodyPatterns" : [ {
+      "matchesJsonPath" : "$.['list'].['some'].['nested'][?(@.['anothervalue'] == 4)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.['valueWithoutAMatcher'] == 'foo')]"
+    }, {
+      "matchesJsonPath" : "$[?(@.['valueWithTypeMatch'] == 'string')]"
+    }, {
+      "matchesJsonPath" : "$.['list'].['someother'].['nested'][?(@.['json'] == 'with value')]"
+    }, {
+      "matchesJsonPath" : "$.['list'].['someother'].['nested'][?(@.['anothervalue'] == 4)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.duck =~ /([0-9]{3})/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.duck == 123)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.alpha =~ /([\\\\p{L}]*)/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.alpha == 'abc')]"
+    }, {
+      "matchesJsonPath" : "$[?(@.number =~ /(-?(\\\\d*\\\\.\\\\d+|\\\\d+))/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.aBoolean =~ /((true|false))/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.date =~ /((\\\\d\\\\d\\\\d\\\\d)-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01]))/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.dateTime =~ /(([0-9]{4})-(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9])T(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9]))/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.time =~ /((2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9]))/)]"
+    }, {
+      "matchesJsonPath" : "$.list.some.nested[?(@.json =~ /(.*)/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.valueWithMin.size() &gt;= 1)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.valueWithMax.size() &lt;= 3)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.valueWithMinMax.size() &gt;= 1 &amp;&amp; @.valueWithMinMax.size() &lt;= 3)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.valueWithOccurrence.size() &gt;= 4 &amp;&amp; @.valueWithOccurrence.size() &lt;= 4)]"
+    } ]
+  },
+  "response" : {
+    "status" : 200,
+    "body" : "{\\"date\\":\\"2017-01-01\\",\\"dateTime\\":\\"2017-01-01T01:23:45\\",\\"aBoolean\\":true,\\"valueWithMax\\":[1,2,3],\\"valueWithOccurrence\\":[1,2,3,4],\\"number\\":123,\\"duck\\":123,\\"alpha\\":\\"abc\\",\\"valueWithMin\\":[1,2,3],\\"time\\":\\"01:02:34\\",\\"valueWithTypeMatch\\":\\"string\\",\\"valueWithMinMax\\":[1,2,3],\\"valueWithoutAMatcher\\":\\"foo\\"}",
+    "headers" : {
+      "Content-Type" : "application/json"
+    },
+    "transformers" : [ "response-template" ]
+  }
+}
+'''</code></pre>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+If you use a <code>matcher</code>, the part of the request and response that the
+<code>matcher</code> addresses with the JSON Path gets removed from the assertion. In the case of
+verifying a collection, you must create matchers for <strong>all</strong> the elements of the
+collection.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Consider the following example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
+    request {
+        method 'GET'
+        url("/foo")
+    }
+    response {
+        status OK()
+        body(events: [[
+                                 operation          : 'EXPORT',
+                                 eventId            : '16f1ed75-0bcc-4f0d-a04d-3121798faf99',
+                                 status             : 'OK'
+                         ], [
+                                 operation          : 'INPUT_PROCESSING',
+                                 eventId            : '3bb4ac82-6652-462f-b6d1-75e424a0024a',
+                                 status             : 'OK'
+                         ]
+                ]
+        )
+        bodyMatchers {
+            jsonPath('$.events[0].operation', byRegex('.+'))
+            jsonPath('$.events[0].eventId', byRegex('^([a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})$'))
+            jsonPath('$.events[0].status', byRegex('.+'))
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The preceding code leads to creating the following test (the code block shows only the assertion section):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">and:
+    DocumentContext parsedJson = JsonPath.parse(response.body.asString())
+    assertThatJson(parsedJson).array("['events']").contains("['eventId']").isEqualTo("16f1ed75-0bcc-4f0d-a04d-3121798faf99")
+    assertThatJson(parsedJson).array("['events']").contains("['operation']").isEqualTo("EXPORT")
+    assertThatJson(parsedJson).array("['events']").contains("['operation']").isEqualTo("INPUT_PROCESSING")
+    assertThatJson(parsedJson).array("['events']").contains("['eventId']").isEqualTo("3bb4ac82-6652-462f-b6d1-75e424a0024a")
+    assertThatJson(parsedJson).array("['events']").contains("['status']").isEqualTo("OK")
+and:
+    assertThat(parsedJson.read("\$.events[0].operation", String.class)).matches(".+")
+    assertThat(parsedJson.read("\$.events[0].eventId", String.class)).matches("^([a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})\$")
+    assertThat(parsedJson.read("\$.events[0].status", String.class)).matches(".+")</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>As you can see, the assertion is malformed. Only the first element of the array got
+asserted. In order to fix this, you should apply the assertion to the whole <code>$.events</code>
+collection and assert it with the <code>byCommand(&#8230;&#8203;)</code> method.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="contract-dsl-async"><a class="anchor" href="#contract-dsl-async"></a><a class="link" href="#contract-dsl-async">2.5. Asynchronous Support</a></h3>
+<div class="paragraph">
+<p>If you use asynchronous communication on the server side (your controllers are
+returning <code>Callable</code>, <code>DeferredResult</code>, and so on), then, inside your contract, you must
+provide an <code>async()</code> method in the <code>response</code> section. The following code shows an example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method GET()
+        url '/get'
+    }
+    response {
+        status OK()
+        body 'Passed'
+        async()
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">response:
+    async: true</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can also use the <code>fixedDelayMilliseconds</code> method or property to add delay to your stubs.
+The following example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method GET()
+        url '/get'
+    }
+    response {
+        status 200
+        body 'Passed'
+        fixedDelayMilliseconds 1000
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">response:
+    fixedDelayMilliseconds: 1000</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="contract-dsl-xml"><a class="anchor" href="#contract-dsl-xml"></a><a class="link" href="#contract-dsl-xml">2.6. XML Support for HTTP</a></h3>
+<div class="paragraph">
+<p>For HTTP contracts, we also support using XML in the request and response body.
+The XML body has to be passed within the <code>body</code> element
+as a <code>String</code> or <code>GString</code>. Also, body matchers can be provided for
+both the request and the response. In place of the <code>jsonPath(&#8230;&#8203;)</code> method, the <code>org.springframework.cloud.contract.spec.internal.BodyMatchers.xPath</code>
+method should be used, with the desired <code>xPath</code> provided as the first argument
+and the appropriate <code>MatchingType</code> as second. All the body matchers apart from <code>byType()</code> are supported.</p>
+</div>
+<div class="paragraph">
+<p>The following example shows a Groovy DSL contract with XML in the response body:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">                    Contract.make {
+                        request {
+                            method GET()
+                            urlPath '/get'
+                            headers {
+                                contentType(applicationXml())
+                            }
+                        }
+                        response {
+                            status(OK())
+                            headers {
+                                contentType(applicationXml())
+                            }
+                            body """
+&lt;test&gt;
+&lt;duck type='xtype'&gt;123&lt;/duck&gt;
+&lt;alpha&gt;abc&lt;/alpha&gt;
+&lt;list&gt;
+&lt;elem&gt;abc&lt;/elem&gt;
+&lt;elem&gt;def&lt;/elem&gt;
+&lt;elem&gt;ghi&lt;/elem&gt;
+&lt;/list&gt;
+&lt;number&gt;123&lt;/number&gt;
+&lt;aBoolean&gt;true&lt;/aBoolean&gt;
+&lt;date&gt;2017-01-01&lt;/date&gt;
+&lt;dateTime&gt;2017-01-01T01:23:45&lt;/dateTime&gt;
+&lt;time&gt;01:02:34&lt;/time&gt;
+&lt;valueWithoutAMatcher&gt;foo&lt;/valueWithoutAMatcher&gt;
+&lt;key&gt;&lt;complex&gt;foo&lt;/complex&gt;&lt;/key&gt;
+&lt;/test&gt;"""
+                            bodyMatchers {
+                                xPath('/test/duck/text()', byRegex("[0-9]{3}"))
+                                xPath('/test/duck/text()', byCommand('equals($it)'))
+                                xPath('/test/duck/xxx', byNull())
+                                xPath('/test/duck/text()', byEquality())
+                                xPath('/test/alpha/text()', byRegex(onlyAlphaUnicode()))
+                                xPath('/test/alpha/text()', byEquality())
+                                xPath('/test/number/text()', byRegex(number()))
+                                xPath('/test/date/text()', byDate())
+                                xPath('/test/dateTime/text()', byTimestamp())
+                                xPath('/test/time/text()', byTime())
+                                xPath('/test/*/complex/text()', byEquality())
+                                xPath('/test/duck/@type', byEquality())
+                            }
+                        }
+                    }</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">include::/home/marcin/repo/spring-cloud-contract/spring-cloud-contract-verifier/src/test/resources/yml/contract_rest_xml.yml</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example shows an automatically generated test for XML in the response body:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
+public void validate_xmlMatches() throws Exception {
+    // given:
+    MockMvcRequestSpecification request = given()
+                .header("Content-Type", "application/xml");
+
+    // when:
+    ResponseOptions response = given().spec(request).get("/get");
+
+    // then:
+    assertThat(response.statusCode()).isEqualTo(200);
+    // and:
+    DocumentBuilder documentBuilder = DocumentBuilderFactory.newInstance()
+                    .newDocumentBuilder();
+    Document parsedXml = documentBuilder.parse(new InputSource(
+                new StringReader(response.getBody().asString())));
+    // and:
+    assertThat(valueFromXPath(parsedXml, "/test/list/elem/text()")).isEqualTo("abc");
+    assertThat(valueFromXPath(parsedXml,"/test/list/elem[2]/text()")).isEqualTo("def");
+    assertThat(valueFromXPath(parsedXml, "/test/duck/text()")).matches("[0-9]{3}");
+    assertThat(nodeFromXPath(parsedXml, "/test/duck/xxx")).isNull();
+    assertThat(valueFromXPath(parsedXml, "/test/alpha/text()")).matches("[\\p{L}]*");
+    assertThat(valueFromXPath(parsedXml, "/test/*/complex/text()")).isEqualTo("foo");
+    assertThat(valueFromXPath(parsedXml, "/test/duck/@type")).isEqualTo("xtype");
+    }</code></pre>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="contract-dsl-multiple"><a class="anchor" href="#contract-dsl-multiple"></a><a class="link" href="#contract-dsl-multiple">2.7. Multiple Contracts in One File</a></h3>
+<div class="paragraph">
+<p>You can define multiple contracts in one file. Such a contract might resemble the
+following example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">import org.springframework.cloud.contract.spec.Contract
+
+[
+    Contract.make {
+        name("should post a user")
+        request {
+            method 'POST'
+            url('/users/1')
+        }
+        response {
+            status OK()
+        }
+    },
+    Contract.make {
+        request {
+            method 'POST'
+            url('/users/2')
+        }
+        response {
+            status OK()
+        }
+    }
+]</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">---
+name: should post a user
+request:
+  method: POST
+  url: /users/1
+response:
+  status: 200
+---
+request:
+  method: POST
+  url: /users/2
+response:
+  status: 200
+---
+request:
+  method: POST
+  url: /users/3
+response:
+  status: 200</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In the preceding example, one contract has the <code>name</code> field and the other does not. This
+leads to generation of two tests that look more or less like the following:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package org.springframework.cloud.contract.verifier.tests.com.hello;
+
+import com.example.TestBase;
+import com.jayway.jsonpath.DocumentContext;
+import com.jayway.jsonpath.JsonPath;
+import com.jayway.restassured.module.mockmvc.specification.MockMvcRequestSpecification;
+import com.jayway.restassured.response.ResponseOptions;
+import org.junit.Test;
+
+import static com.jayway.restassured.module.mockmvc.RestAssuredMockMvc.*;
+import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson;
+import static org.assertj.core.api.Assertions.assertThat;
+
+public class V1Test extends TestBase {
+
+    @Test
+    public void validate_should_post_a_user() throws Exception {
+        // given:
+            MockMvcRequestSpecification request = given();
+
+        // when:
+            ResponseOptions response = given().spec(request)
+                    .post("/users/1");
+
+        // then:
+            assertThat(response.statusCode()).isEqualTo(200);
+    }
+
+    @Test
+    public void validate_withList_1() throws Exception {
+        // given:
+            MockMvcRequestSpecification request = given();
+
+        // when:
+            ResponseOptions response = given().spec(request)
+                    .post("/users/2");
+
+        // then:
+            assertThat(response.statusCode()).isEqualTo(200);
+    }
+
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Notice that, for the contract that has the <code>name</code> field, the generated test method is named
+<code>validate_should_post_a_user</code>. The one that does not have the <code>name</code> field is called
+<code>validate_withList_1</code>. It corresponds to the name of the file <code>WithList.groovy</code> and the
+index of the contract in the list.</p>
+</div>
+<div class="paragraph">
+<p>The generated stubs are shown in the following example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code>should post a user.json
+1_WithList.json</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The first file got the <code>name</code> parameter from the contract. The second
+got the name of the contract file (<code>WithList.groovy</code>) prefixed with the index (in this
+case, the contract had an index of <code>1</code> in the list of contracts in the file).</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+It is much better to name your contracts, because doing so makes
+your tests far more meaningful.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="contract-stateful-contracts"><a class="anchor" href="#contract-stateful-contracts"></a><a class="link" href="#contract-stateful-contracts">2.8. Stateful Contracts</a></h3>
+<div class="paragraph">
+<p>Stateful contracts (known also as scenarios) are contract definitions that should be read
+in order. This might be useful in the following situations:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>You want to execute the contract in a precisely defined order, since you use Spring
+Cloud Contract to test your stateful application</p>
+</li>
+</ul>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+We really discourage you from doing that, since contract tests should be stateless.
+</td>
+</tr>
+</table>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>You want the same endpoint to return different results for the same request.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>To create stateful contracts (or scenarios), you need to
+use the proper naming convention while creating your contracts. The convention
+requires including an order number followed by an underscore. This works regardless
+of whether you work with YAML or Groovy. The following listing shows an example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code>my_contracts_dir\
+  scenario1\
+    1_login.groovy
+    2_showCart.groovy
+    3_logout.groovy</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Such a tree causes Spring Cloud Contract Verifier to generate WireMock&#8217;s scenario with a
+name of <code>scenario1</code> and the three following steps:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>login, marked as <code>Started</code> pointing to&#8230;&#8203;</p>
+</li>
+<li>
+<p>showCart, marked as <code>Step1</code> pointing to&#8230;&#8203;</p>
+</li>
+<li>
+<p>logout, marked as <code>Step2</code> (which closes the scenario).</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>You can find nore details about WireMock scenarios at
+<a href="https://wiremock.org/docs/stateful-behaviour/">https://wiremock.org/docs/stateful-behaviour/</a>.</p>
+</div>
+<div class="paragraph">
+<p>Spring Cloud Contract also generates tests with a guaranteed order of execution.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="feature-integrations"><a class="anchor" href="#feature-integrations"></a><a class="link" href="#feature-integrations">3. Integrations</a></h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="features-jax-rs"><a class="anchor" href="#features-jax-rs"></a><a class="link" href="#features-jax-rs">3.1. JAX-RS</a></h3>
+<div class="paragraph">
+<p>The Spring Cloud Contract supports the JAX-RS 2 Client API. The base class needs
+to define <code>protected WebTarget webTarget</code> and server initialization. The only option for
+testing JAX-RS API is to start a web server. Also, a request with a body needs to have a
+content type be set. Otherwise, the default of <code>application/octet-stream</code> gets used.</p>
+</div>
+<div class="paragraph">
+<p>In order to use JAX-RS mode, use the following settings:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testMode == 'JAXRSCLIENT'</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example shows a generated test API:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">                    """\
+package com.example;
+
+import com.jayway.jsonpath.DocumentContext;
+import com.jayway.jsonpath.JsonPath;
+import org.junit.Test;
+import org.junit.Rule;
+import javax.ws.rs.client.Entity;
+import javax.ws.rs.core.Response;
+
+import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat;
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*;
+import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson;
+import static javax.ws.rs.client.Entity.*;
+
+@SuppressWarnings("rawtypes")
+public class FooTest {
+\tWebTarget webTarget;
+
+\t@Test
+\tpublic void validate_() throws Exception {
+
+\t\t// when:
+\t\t\tResponse response = webTarget
+\t\t\t\t\t\t\t.path("/users")
+\t\t\t\t\t\t\t.queryParam("limit", "10")
+\t\t\t\t\t\t\t.queryParam("offset", "20")
+\t\t\t\t\t\t\t.queryParam("filter", "email")
+\t\t\t\t\t\t\t.queryParam("sort", "name")
+\t\t\t\t\t\t\t.queryParam("search", "55")
+\t\t\t\t\t\t\t.queryParam("age", "99")
+\t\t\t\t\t\t\t.queryParam("name", "Denis.Stepanov")
+\t\t\t\t\t\t\t.queryParam("email", "bob@email.com")
+\t\t\t\t\t\t\t.request()
+\t\t\t\t\t\t\t.build("GET")
+\t\t\t\t\t\t\t.invoke();
+\t\t\tString responseAsString = response.readEntity(String.class);
+
+\t\t// then:
+\t\t\tassertThat(response.getStatus()).isEqualTo(200);
+
+\t\t// and:
+\t\t\tDocumentContext parsedJson = JsonPath.parse(responseAsString);
+\t\t\tassertThatJson(parsedJson).field("['property1']").isEqualTo("a");
+\t}
+
+}
+
+"""</code></pre>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="feature-webflux"><a class="anchor" href="#feature-webflux"></a><a class="link" href="#feature-webflux">3.2. WebFlux with WebTestClient</a></h3>
+<div class="paragraph">
+<p>You can work with WebFlux by using WebTestClient. The following listing shows how to
+configure WebTestClient as the test mode:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;testMode&gt;WEBTESTCLIENT&lt;/testMode&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+        testMode = 'WEBTESTCLIENT'
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example shows how to set up a WebTestClient base class and RestAssured
+for WebFlux:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">import io.restassured.module.webtestclient.RestAssuredWebTestClient;
+import org.junit.Before;
+
+public abstract class BeerRestBase {
+
+    @Before
+    public void setup() {
+        RestAssuredWebTestClient.standaloneSetup(
+        new ProducerController(personToCheck -&gt; personToCheck.age &gt;= 20));
+    }
+}
+}</code></pre>
+</div>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+The <code>WebTestClient</code> mode is faster than the <code>EXPLICIT</code> mode.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="feature-webflux-explicit"><a class="anchor" href="#feature-webflux-explicit"></a><a class="link" href="#feature-webflux-explicit">3.3. WebFlux with Explicit Mode</a></h3>
+<div class="paragraph">
+<p>You can also use WebFlux with the explicit mode in your generated tests
+to work with WebFlux. The following example shows how to configure using explicit mode:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;testMode&gt;EXPLICIT&lt;/testMode&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+        testMode = 'EXPLICIT'
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example shows how to set up a base class and RestAssured for Web Flux:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@RunWith(SpringRunner.class)
+@SpringBootTest(classes = BeerRestBase.Config.class,
+        webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT,
+        properties = "server.port=0")
+public abstract class BeerRestBase {
+
+    // your tests go here
+
+    // in this config class you define all controllers and mocked services
+@Configuration
+@EnableAutoConfiguration
+static class Config {
+
+    @Bean
+    PersonCheckingService personCheckingService()  {
+        return personToCheck -&gt; personToCheck.age &gt;= 20;
+    }
+
+    @Bean
+    ProducerController producerController() {
+        return new ProducerController(personCheckingService());
+    }
+}
+
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-context-paths"><a class="anchor" href="#features-context-paths"></a><a class="link" href="#features-context-paths">3.4. Working with Context Paths</a></h3>
+<div class="paragraph">
+<p>Spring Cloud Contract supports context paths.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>The only change needed to fully support context paths is the switch on the
+producer side. Also, the autogenerated tests must use explicit mode. The  consumer
+side remains untouched. In order for the generated test to pass, you must use explicit
+mode. The following example shows how to set the test mode to <code>EXPLICIT</code>:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;testMode&gt;EXPLICIT&lt;/testMode&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+        testMode = 'EXPLICIT'
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>That way, you generate a test that does not use MockMvc. It means that you generate
+real requests and you need to set up your generated test&#8217;s base class to work on a real
+socket.</p>
+</div>
+<div class="paragraph">
+<p>Consider the following contract:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method 'GET'
+        url '/my-context-path/url'
+    }
+    response {
+        status OK()
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example shows how to set up a base class and RestAssured:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">import io.restassured.RestAssured;
+import org.junit.Before;
+import org.springframework.boot.web.server.LocalServerPort;
+import org.springframework.boot.test.context.SpringBootTest;
+
+@SpringBootTest(classes = ContextPathTestingBaseClass.class, webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
+class ContextPathTestingBaseClass {
+
+    @LocalServerPort int port;
+
+    @Before
+    public void setup() {
+        RestAssured.baseURI = "http://localhost";
+        RestAssured.port = this.port;
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>If you do it this way:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>All of your requests in the autogenerated tests are sent to the real endpoint with your
+context path included (for example, <code>/my-context-path/url</code>).</p>
+</li>
+<li>
+<p>Your contracts reflect that you have a context path. Your generated stubs also have
+that information (for example, in the stubs, you have to call <code>/my-context-path/url</code>).</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-rest-docs"><a class="anchor" href="#features-rest-docs"></a><a class="link" href="#features-rest-docs">3.5. Working with REST Docs</a></h3>
+<div class="paragraph">
+<p>You can use <a href="https://projects.spring.io/spring-restdocs">Spring REST Docs</a> to generate
+documentation (for example, in Asciidoc format) for an HTTP API with Spring MockMvc,
+<code>WebTestClient</code>, or RestAssured. At the same time that you generate documentation for your API, you can also
+generate WireMock stubs by using Spring Cloud Contract WireMock. To do so, write your
+normal REST Docs test cases and use <code>@AutoConfigureRestDocs</code> to have stubs be
+automatically generated in the REST Docs output directory.</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/rest-docs.png" alt="rest docs" width="1237" height="835">
+</div>
+</div>
+<div class="paragraph">
+<p>The following example uses <code>MockMvc</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
+@SpringBootTest
+@AutoConfigureRestDocs(outputDir = "target/snippets")
+@AutoConfigureMockMvc
+public class ApplicationTests {
+
+    @Autowired
+    private MockMvc mockMvc;
+
+    @Test
+    public void contextLoads() throws Exception {
+        mockMvc.perform(get("/resource"))
+                .andExpect(content().string("Hello World"))
+                .andDo(document("resource"));
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This test generates a WireMock stub at <code>target/snippets/stubs/resource.json</code>. It matches
+all <code>GET</code> requests to the <code>/resource</code> path. The same example with <code>WebTestClient</code> (used
+for testing Spring WebFlux applications) would be as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
+@SpringBootTest
+@AutoConfigureRestDocs(outputDir = "target/snippets")
+@AutoConfigureWebTestClient
+public class ApplicationTests {
+
+    @Autowired
+    private WebTestClient client;
+
+    @Test
+    public void contextLoads() throws Exception {
+        client.get().uri("/resource").exchange()
+                .expectBody(String.class).isEqualTo("Hello World")
+                .consumeWith(document("resource"));
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Without any additional configuration, these tests create a stub with a request matcher
+for the HTTP method and all headers except <code>host</code> and <code>content-length</code>. To match the
+request more precisely (for example, to match the body of a POST or PUT), we need to
+explicitly create a request matcher. Doing so has two effects:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Creating a stub that matches only in the way you specify.</p>
+</li>
+<li>
+<p>Asserting that the request in the test case also matches the same conditions.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The main entry point for this feature is <code>WireMockRestDocs.verify()</code>, which can be used
+as a substitute for the <code>document()</code> convenience method, as the following
+example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">import static org.springframework.cloud.contract.wiremock.restdocs.WireMockRestDocs.verify;
+
+@RunWith(SpringRunner.class)
+@SpringBootTest
+@AutoConfigureRestDocs(outputDir = "target/snippets")
+@AutoConfigureMockMvc
+public class ApplicationTests {
+
+    @Autowired
+    private MockMvc mockMvc;
+
+    @Test
+    public void contextLoads() throws Exception {
+        mockMvc.perform(post("/resource")
+                .content("{\"id\":\"123456\",\"message\":\"Hello World\"}"))
+                .andExpect(status().isOk())
+                .andDo(verify().jsonPath("$.id")
+                        .stub("resource"));
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The preceding contract specifies that any valid POST with an <code>id</code> field receives the response
+defined in this test. You can chain together calls to <code>.jsonPath()</code> to add additional
+matchers. If JSON Path is unfamiliar, the <a href="https://github.com/jayway/JsonPath">JayWay
+documentation</a> can help you get up to speed. The <code>WebTestClient</code> version of this test
+has a similar <code>verify()</code> static helper that you insert in the same place.</p>
+</div>
+<div class="paragraph">
+<p>Instead of the <code>jsonPath</code> and <code>contentType</code> convenience methods, you can also use the
+WireMock APIs to verify that the request matches the created stub, as the
+following example shows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
+public void contextLoads() throws Exception {
+    mockMvc.perform(post("/resource")
+            .content("{\"id\":\"123456\",\"message\":\"Hello World\"}"))
+            .andExpect(status().isOk())
+            .andDo(verify()
+                    .wiremock(WireMock.post(
+                        urlPathEquals("/resource"))
+                        .withRequestBody(matchingJsonPath("$.id"))
+                    .stub("post-resource"));
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The WireMock API is rich. You can match headers, query parameters, and the request body by
+regex as well as by JSON path. You can use these features to create stubs with a wider
+range of parameters. The preceding example generates a stub resembling the following example:</p>
+</div>
+<div class="listingblock">
+<div class="title">post-resource.json</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+  "request" : {
+    "url" : "/resource",
+    "method" : "POST",
+    "bodyPatterns" : [ {
+      "matchesJsonPath" : "$.id"
+    }]
+  },
+  "response" : {
+    "status" : 200,
+    "body" : "Hello World",
+    "headers" : {
+      "X-Application-Context" : "application:-1",
+      "Content-Type" : "text/plain"
+    }
+  }
+}</code></pre>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+You can use either the <code>wiremock()</code> method or the <code>jsonPath()</code> and <code>contentType()</code>
+methods to create request matchers, but you cannot use both approaches.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>On the consumer side, you can make the <code>resource.json</code> generated earlier in this section
+available on the classpath (by
+<a href="#features-stub-runner-publishing-stubs-as-jars">Publishing Stubs as JARs</a>, for example). After that, you can create a stub that uses WireMock in a
+number of different ways, including by using
+<code>@AutoConfigureWireMock(stubs="classpath:resource.json")</code>, as described earlier in this
+document.</p>
+</div>
+<div class="sect3">
+<h4 id="features-rest-docs-contracts"><a class="anchor" href="#features-rest-docs-contracts"></a><a class="link" href="#features-rest-docs-contracts">3.5.1. Generating Contracts with REST Docs</a></h4>
+<div class="paragraph">
+<p>You can also generate Spring Cloud Contract DSL files and documentation with Spring REST
+Docs. If you do so in combination with Spring Cloud WireMock, you get both the contracts
+and the stubs.</p>
+</div>
+<div class="paragraph">
+<p>Why would you want to use this feature? Some people in the community asked questions
+about a situation in which they would like to move to DSL-based contract definition,
+but they already have a lot of Spring MVC tests. Using this feature lets you generate
+the contract files that you can later modify and move to folders (defined in your
+configuration) so that the plugin finds them.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+You might wonder why this functionality is in the WireMock module. The functionality
+is there because it makes sense to generate both the contracts and the stubs.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Consider the following test:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">        this.mockMvc
+                .perform(post("/foo").accept(MediaType.APPLICATION_PDF)
+                        .accept(MediaType.APPLICATION_JSON)
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content("{\"foo\": 23, \"bar\" : \"baz\" }"))
+                .andExpect(status().isOk()).andExpect(content().string("bar"))
+                // first WireMock
+                .andDo(WireMockRestDocs.verify().jsonPath("$[?(@.foo &gt;= 20)]")
+                        .jsonPath("$[?(@.bar in ['baz','bazz','bazzz'])]")
+                        .contentType(MediaType.valueOf("application/json"))
+                        .stub("shouldGrantABeerIfOldEnough"))
+                // then Contract DSL documentation
+                .andDo(document("index", SpringCloudContractRestDocs.dslContract()));</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The preceding test creates the stub presented in the previous section, generating both
+the contract and a documentation file.</p>
+</div>
+<div class="paragraph">
+<p>The contract is called <code>index.groovy</code> and might resemble the following example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">import org.springframework.cloud.contract.spec.Contract
+
+Contract.make {
+    request {
+        method 'POST'
+        url '/foo'
+        body('''
+            {"foo": 23 }
+        ''')
+        headers {
+            header('''Accept''', '''application/json''')
+            header('''Content-Type''', '''application/json''')
+        }
+    }
+    response {
+        status OK()
+        body('''
+        bar
+        ''')
+        headers {
+            header('''Content-Type''', '''application/json;charset=UTF-8''')
+            header('''Content-Length''', '''3''')
+        }
+        testMatchers {
+            jsonPath('$[?(@.foo &gt;= 20)]', byType())
+        }
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The generated document (formatted in Asciidoc in this case) contains a formatted
+contract. The location of this file would be <code>index/dsl-contract.adoc</code>.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="features-messaging"><a class="anchor" href="#features-messaging"></a><a class="link" href="#features-messaging">4. Messaging</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Spring Cloud Contract lets you verify applications that use messaging as a
+means of communication. All of the integrations shown in this document work with Spring,
+but you can also create one of your own and use that.</p>
+</div>
+<div class="sect2">
+<h3 id="contract-dsl-messaging-top-level"><a class="anchor" href="#contract-dsl-messaging-top-level"></a><a class="link" href="#contract-dsl-messaging-top-level">4.1. Messaging DSL Top-Level Elements</a></h3>
+<div class="paragraph">
+<p>The DSL for messaging looks a little bit different than the one that focuses on HTTP. The
+following sections explain the differences:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#contract-dsl-output-triggered-method">Output Triggered by a Method</a></p>
+</li>
+<li>
+<p><a href="#contract-dsl-output-triggered-message">Output Triggered by a Message</a></p>
+</li>
+<li>
+<p><a href="#contract-dsl-consumer-producer">Consumer/Producer</a></p>
+</li>
+<li>
+<p><a href="#contract-dsl-messaging-common">Common</a></p>
+</li>
+</ul>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-output-triggered-method"><a class="anchor" href="#contract-dsl-output-triggered-method"></a><a class="link" href="#contract-dsl-output-triggered-method">4.1.1. Output Triggered by a Method</a></h4>
+<div class="paragraph">
+<p>The output message can be triggered by calling a method (such as a <code>Scheduler</code> when a contract was
+started and a message was sent), as shown in the following example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">def dsl = Contract.make {
+    // Human readable description
+    description 'Some description'
+    // Label by means of which the output message can be triggered
+    label 'some_label'
+    // input to the contract
+    input {
+        // the contract will be triggered by a method
+        triggeredBy('bookReturnedTriggered()')
+    }
+    // output message of the contract
+    outputMessage {
+        // destination to which the output message will be sent
+        sentTo('output')
+        // the body of the output message
+        body('''{ "bookName" : "foo" }''')
+        // the headers of the output message
+        headers {
+            header('BOOK-NAME', 'foo')
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy"># Human readable description
+description: Some description
+# Label by means of which the output message can be triggered
+label: some_label
+input:
+  # the contract will be triggered by a method
+  triggeredBy: bookReturnedTriggered()
+# output message of the contract
+outputMessage:
+  # destination to which the output message will be sent
+  sentTo: output
+  # the body of the output message
+  body:
+    bookName: foo
+  # the headers of the output message
+  headers:
+    BOOK-NAME: foo</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In the previous example case, the output message is sent to <code>output</code> if a method called
+<code>bookReturnedTriggered</code> is executed. On the message publisher&#8217;s side, we generate a
+test that calls that method to trigger the message. On the consumer side, you can use
+the <code>some_label</code> to trigger the message.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-output-triggered-message"><a class="anchor" href="#contract-dsl-output-triggered-message"></a><a class="link" href="#contract-dsl-output-triggered-message">4.1.2. Output Triggered by a Message</a></h4>
+<div class="paragraph">
+<p>The output message can be triggered by receiving a message, as shown in the following
+example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">def dsl = Contract.make {
+    description 'Some Description'
+    label 'some_label'
+    // input is a message
+    input {
+        // the message was received from this destination
+        messageFrom('input')
+        // has the following body
+        messageBody([
+                bookName: 'foo'
+        ])
+        // and the following headers
+        messageHeaders {
+            header('sample', 'header')
+        }
+    }
+    outputMessage {
+        sentTo('output')
+        body([
+                bookName: 'foo'
+        ])
+        headers {
+            header('BOOK-NAME', 'foo')
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy"># Human readable description
+description: Some description
+# Label by means of which the output message can be triggered
+label: some_label
+# input is a message
+input:
+  messageFrom: input
+  # has the following body
+  messageBody:
+    bookName: 'foo'
+  # and the following headers
+  messageHeaders:
+    sample: 'header'
+# output message of the contract
+outputMessage:
+  # destination to which the output message will be sent
+  sentTo: output
+  # the body of the output message
+  body:
+    bookName: foo
+  # the headers of the output message
+  headers:
+    BOOK-NAME: foo</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In the preceding example, the output message is sent to <code>output</code> if a proper message is
+received on the <code>input</code> destination. On the message publisher&#8217;s side, the engine
+generates a test that sends the input message to the defined destination. On the
+consumer side, you can either send a message to the input destination or use a label
+(<code>some_label</code> in the example) to trigger the message.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-consumer-producer"><a class="anchor" href="#contract-dsl-consumer-producer"></a><a class="link" href="#contract-dsl-consumer-producer">4.1.3. Consumer/Producer</a></h4>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+This section is valid only for Groovy DSL.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>In HTTP, you have a notion of <code>client</code>/<code>stub and `server</code>/<code>test</code> notation. You can also
+use those paradigms in messaging. In addition, Spring Cloud Contract Verifier also
+provides the <code>consumer</code> and <code>producer</code> methods, as presented in the following example
+(note that you can use either <code>$</code> or <code>value</code> methods to provide <code>consumer</code> and <code>producer</code>
+parts):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">                    Contract.make {
+                name "foo"
+                        label 'some_label'
+                        input {
+                            messageFrom value(consumer('jms:output'), producer('jms:input'))
+                            messageBody([
+                                    bookName: 'foo'
+                            ])
+                            messageHeaders {
+                                header('sample', 'header')
+                            }
+                        }
+                        outputMessage {
+                            sentTo $(consumer('jms:input'), producer('jms:output'))
+                            body([
+                                    bookName: 'foo'
+                            ])
+                        }
+                    }</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-messaging-common"><a class="anchor" href="#contract-dsl-messaging-common"></a><a class="link" href="#contract-dsl-messaging-common">4.1.4. Common</a></h4>
+<div class="paragraph">
+<p>In the <code>input</code> or <code>outputMessage</code> section, you can call <code>assertThat</code> with the name
+of a <code>method</code> (for example, <code>assertThatMessageIsOnTheQueue()</code>) that you have defined in the
+base class or in a static import. Spring Cloud Contract runs that method
+in the generated test.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-messaging-integrations"><a class="anchor" href="#features-messaging-integrations"></a><a class="link" href="#features-messaging-integrations">4.2. Integrations</a></h3>
+<div class="paragraph">
+<p>You can use one of the following four integration configurations:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Apache Camel</p>
+</li>
+<li>
+<p>Spring Integration</p>
+</li>
+<li>
+<p>Spring Cloud Stream</p>
+</li>
+<li>
+<p>Spring AMQP</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Since we use Spring Boot, if you have added one of these libraries to the classpath, all
+the messaging configuration is automatically set up.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Remember to put <code>@AutoConfigureMessageVerifier</code> on the base class of your
+generated tests. Otherwise, the messaging part of Spring Cloud Contract does not
+work.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>If you want to use Spring Cloud Stream, remember to add a dependency on
+<code>org.springframework.cloud:spring-cloud-stream-test-support</code>, as  follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-stream-test-support&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile "org.springframework.cloud:spring-cloud-stream-test-support"</code></pre>
+</div>
+</div>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-manual"><a class="anchor" href="#features-messaging-manual"></a><a class="link" href="#features-messaging-manual">4.2.1. Manual Integration Testing</a></h4>
+<div class="paragraph">
+<p>The main interface used by the tests is
+<code>org.springframework.cloud.contract.verifier.messaging.MessageVerifier</code>.
+It defines how to send and receive messages. You can create your own implementation to
+achieve the same goal.</p>
+</div>
+<div class="paragraph">
+<p>In a test, you can inject a <code>ContractVerifierMessageExchange</code> to send and receive
+messages that follow the contract. Then add <code>@AutoConfigureMessageVerifier</code> to your test.
+The following example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringTestRunner.class)
+@SpringBootTest
+@AutoConfigureMessageVerifier
+public static class MessagingContractTests {
+
+  @Autowired
+  private MessageVerifier verifier;
+  ...
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+If your tests require stubs as well, then <code>@AutoConfigureStubRunner</code> includes the
+messaging configuration, so you only need the one annotation.
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-messaging-test-generation"><a class="anchor" href="#features-messaging-test-generation"></a><a class="link" href="#features-messaging-test-generation">4.3. Producer Side  Messaging Test Generation</a></h3>
+<div class="paragraph">
+<p>Having the <code>input</code> or <code>outputMessage</code> sections in your DSL results in creation of tests
+on the publisher&#8217;s side. By default, JUnit 4 tests are created. However, there is also a
+possibility to create JUnit 5, TestNG, or Spock tests.</p>
+</div>
+<div class="paragraph">
+<p>There are three main scenarios that we should take into consideration:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Scenario 1: There is no input message that produces an output message. The output
+message  is triggered by a component inside the application (for example, a scheduler).</p>
+</li>
+<li>
+<p>Scenario 2: The input message triggers an output message.</p>
+</li>
+<li>
+<p>Scenario 3: The input message is consumed, and there is no output message.</p>
+</li>
+</ul>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+The destination passed to <code>messageFrom</code> or <code>sentTo</code> can have different
+meanings for different messaging implementations. For Stream and Integration, it is
+first resolved as a <code>destination</code> of a channel. Then, if there is no such <code>destination</code>
+it is resolved as a channel name. For Camel, that&#8217;s a certain component (for example,
+<code>jms</code>).
+</td>
+</tr>
+</table>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-scenario1"><a class="anchor" href="#features-messaging-scenario1"></a><a class="link" href="#features-messaging-scenario1">4.3.1. Scenario 1: No Input Message</a></h4>
+<div class="paragraph">
+<p>Consider the following contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">def contractDsl = Contract.make {
+    name "foo"
+    label 'some_label'
+    input {
+        triggeredBy('bookReturnedTriggered()')
+    }
+    outputMessage {
+        sentTo('activemq:output')
+        body('''{ "bookName" : "foo" }''')
+        headers {
+            header('BOOK-NAME', 'foo')
+            messagingContentType(applicationJson())
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">label: some_label
+input:
+  triggeredBy: bookReturnedTriggered
+outputMessage:
+  sentTo: activemq:output
+  body:
+    bookName: foo
+  headers:
+    BOOK-NAME: foo
+    contentType: application/json</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>For the preceding example, the following test would be created:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">JUnit</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">                    '''\
+package com.example;
+
+import com.jayway.jsonpath.DocumentContext;
+import com.jayway.jsonpath.JsonPath;
+import org.junit.Test;
+import org.junit.Rule;
+import javax.inject.Inject;
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierObjectMapper;
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessage;
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessaging;
+
+import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat;
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*;
+import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson;
+import static org.springframework.cloud.contract.verifier.messaging.util.ContractVerifierMessagingUtil.headers;
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.fileToBytes;
+
+@SuppressWarnings("rawtypes")
+public class FooTest {
+\t@Inject ContractVerifierMessaging contractVerifierMessaging;
+\t@Inject ContractVerifierObjectMapper contractVerifierObjectMapper;
+
+\t@Test
+\tpublic void validate_foo() throws Exception {
+\t\t// when:
+\t\t\tbookReturnedTriggered();
+
+\t\t// then:
+\t\t\tContractVerifierMessage response = contractVerifierMessaging.receive("activemq:output");
+\t\t\tassertThat(response).isNotNull();
+
+\t\t// and:
+\t\t\tassertThat(response.getHeader("BOOK-NAME")).isNotNull();
+\t\t\tassertThat(response.getHeader("BOOK-NAME").toString()).isEqualTo("foo");
+\t\t\tassertThat(response.getHeader("contentType")).isNotNull();
+\t\t\tassertThat(response.getHeader("contentType").toString()).isEqualTo("application/json");
+
+\t\t// and:
+\t\t\tDocumentContext parsedJson = JsonPath.parse(contractVerifierObjectMapper.writeValueAsString(response.getPayload()));
+\t\t\tassertThatJson(parsedJson).field("['bookName']").isEqualTo("foo");
+\t}
+
+}
+
+'''</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Spock</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">                    '''\
+package com.example
+
+import com.jayway.jsonpath.DocumentContext
+import com.jayway.jsonpath.JsonPath
+import spock.lang.Specification
+import javax.inject.Inject
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierObjectMapper
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessage
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessaging
+
+import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*
+import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson
+import static org.springframework.cloud.contract.verifier.messaging.util.ContractVerifierMessagingUtil.headers
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.fileToBytes
+
+@SuppressWarnings("rawtypes")
+class FooSpec extends Specification {
+\t@Inject ContractVerifierMessaging contractVerifierMessaging
+\t@Inject ContractVerifierObjectMapper contractVerifierObjectMapper
+
+\tdef validate_foo() throws Exception {
+\t\twhen:
+\t\t\tbookReturnedTriggered()
+
+\t\tthen:
+\t\t\tContractVerifierMessage response = contractVerifierMessaging.receive("activemq:output")
+\t\t\tresponse != null
+
+\t\tand:
+\t\t\tresponse.getHeader("BOOK-NAME") != null
+\t\t\tresponse.getHeader("BOOK-NAME").toString() == 'foo'
+\t\t\tresponse.getHeader("contentType") != null
+\t\t\tresponse.getHeader("contentType").toString() == 'application/json'
+
+\t\tand:
+\t\t\tDocumentContext parsedJson = JsonPath.parse(contractVerifierObjectMapper.writeValueAsString(response.getPayload()))
+\t\t\tassertThatJson(parsedJson).field("['bookName']").isEqualTo("foo")
+\t}
+
+}
+
+'''</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-scenario2"><a class="anchor" href="#features-messaging-scenario2"></a><a class="link" href="#features-messaging-scenario2">4.3.2. Scenario 2: Output Triggered by Input</a></h4>
+<div class="paragraph">
+<p>Consider the following contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">def contractDsl = Contract.make {
+    name "foo"
+    label 'some_label'
+    input {
+        messageFrom('jms:input')
+        messageBody([
+                bookName: 'foo'
+        ])
+        messageHeaders {
+            header('sample', 'header')
+        }
+    }
+    outputMessage {
+        sentTo('jms:output')
+        body([
+                bookName: 'foo'
+        ])
+        headers {
+            header('BOOK-NAME', 'foo')
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">label: some_label
+input:
+  messageFrom: jms:input
+  messageBody:
+    bookName: 'foo'
+  messageHeaders:
+    sample: header
+outputMessage:
+  sentTo: jms:output
+  body:
+    bookName: foo
+  headers:
+    BOOK-NAME: foo</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>For the preceding contract, the following test would be created:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">JUnit</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">                    '''\
+package com.example;
+
+import com.jayway.jsonpath.DocumentContext;
+import com.jayway.jsonpath.JsonPath;
+import org.junit.Test;
+import org.junit.Rule;
+import javax.inject.Inject;
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierObjectMapper;
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessage;
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessaging;
+
+import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat;
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*;
+import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson;
+import static org.springframework.cloud.contract.verifier.messaging.util.ContractVerifierMessagingUtil.headers;
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.fileToBytes;
+
+@SuppressWarnings("rawtypes")
+public class FooTest {
+\t@Inject ContractVerifierMessaging contractVerifierMessaging;
+\t@Inject ContractVerifierObjectMapper contractVerifierObjectMapper;
+
+\t@Test
+\tpublic void validate_foo() throws Exception {
+\t\t// given:
+\t\t\tContractVerifierMessage inputMessage = contractVerifierMessaging.create(
+\t\t\t\t\t"{\\"bookName\\":\\"foo\\"}"
+\t\t\t\t\t\t, headers()
+\t\t\t\t\t\t\t.header("sample", "header")
+\t\t\t);
+
+\t\t// when:
+\t\t\tcontractVerifierMessaging.send(inputMessage, "jms:input");
+
+\t\t// then:
+\t\t\tContractVerifierMessage response = contractVerifierMessaging.receive("jms:output");
+\t\t\tassertThat(response).isNotNull();
+
+\t\t// and:
+\t\t\tassertThat(response.getHeader("BOOK-NAME")).isNotNull();
+\t\t\tassertThat(response.getHeader("BOOK-NAME").toString()).isEqualTo("foo");
+
+\t\t// and:
+\t\t\tDocumentContext parsedJson = JsonPath.parse(contractVerifierObjectMapper.writeValueAsString(response.getPayload()));
+\t\t\tassertThatJson(parsedJson).field("['bookName']").isEqualTo("foo");
+\t}
+
+}
+
+'''</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Spock</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">                    """\
+package com.example
+
+import com.jayway.jsonpath.DocumentContext
+import com.jayway.jsonpath.JsonPath
+import spock.lang.Specification
+import javax.inject.Inject
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierObjectMapper
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessage
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessaging
+
+import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*
+import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson
+import static org.springframework.cloud.contract.verifier.messaging.util.ContractVerifierMessagingUtil.headers
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.fileToBytes
+
+@SuppressWarnings("rawtypes")
+class FooSpec extends Specification {
+\t@Inject ContractVerifierMessaging contractVerifierMessaging
+\t@Inject ContractVerifierObjectMapper contractVerifierObjectMapper
+
+\tdef validate_foo() throws Exception {
+\t\tgiven:
+\t\t\tContractVerifierMessage inputMessage = contractVerifierMessaging.create(
+\t\t\t\t\t'''{"bookName":"foo"}'''
+\t\t\t\t\t\t, headers()
+\t\t\t\t\t\t\t.header("sample", "header")
+\t\t\t)
+
+\t\twhen:
+\t\t\tcontractVerifierMessaging.send(inputMessage, "jms:input")
+
+\t\tthen:
+\t\t\tContractVerifierMessage response = contractVerifierMessaging.receive("jms:output")
+\t\t\tresponse != null
+
+\t\tand:
+\t\t\tresponse.getHeader("BOOK-NAME") != null
+\t\t\tresponse.getHeader("BOOK-NAME").toString() == 'foo'
+
+\t\tand:
+\t\t\tDocumentContext parsedJson = JsonPath.parse(contractVerifierObjectMapper.writeValueAsString(response.getPayload()))
+\t\t\tassertThatJson(parsedJson).field("['bookName']").isEqualTo("foo")
+\t}
+
+}
+
+"""</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-scenario3"><a class="anchor" href="#features-messaging-scenario3"></a><a class="link" href="#features-messaging-scenario3">4.3.3. Scenario 3: No Output Message</a></h4>
+<div class="paragraph">
+<p>Consider the following contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">def contractDsl = Contract.make {
+    name "foo"
+    label 'some_label'
+    input {
+        messageFrom('jms:delete')
+        messageBody([
+                bookName: 'foo'
+        ])
+        messageHeaders {
+            header('sample', 'header')
+        }
+        assertThat('bookWasDeleted()')
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">label: some_label
+input:
+  messageFrom: jms:delete
+  messageBody:
+    bookName: 'foo'
+  messageHeaders:
+    sample: header
+  assertThat: bookWasDeleted()</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>For the preceding contract, the following test would be created:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">JUnit</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">                    """\
+package com.example;
+
+import com.jayway.jsonpath.DocumentContext;
+import com.jayway.jsonpath.JsonPath;
+import org.junit.Test;
+import org.junit.Rule;
+import javax.inject.Inject;
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierObjectMapper;
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessage;
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessaging;
+
+import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat;
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*;
+import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson;
+import static org.springframework.cloud.contract.verifier.messaging.util.ContractVerifierMessagingUtil.headers;
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.fileToBytes;
+
+@SuppressWarnings("rawtypes")
+public class FooTest {
+\t@Inject ContractVerifierMessaging contractVerifierMessaging;
+\t@Inject ContractVerifierObjectMapper contractVerifierObjectMapper;
+
+\t@Test
+\tpublic void validate_foo() throws Exception {
+\t\t// given:
+\t\t\tContractVerifierMessage inputMessage = contractVerifierMessaging.create(
+\t\t\t\t\t"{\\"bookName\\":\\"foo\\"}"
+\t\t\t\t\t\t, headers()
+\t\t\t\t\t\t\t.header("sample", "header")
+\t\t\t);
+
+\t\t// when:
+\t\t\tcontractVerifierMessaging.send(inputMessage, "jms:delete");
+\t\t\tbookWasDeleted();
+
+\t}
+
+}
+
+"""</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Spock</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">                    """\
+package com.example
+
+import com.jayway.jsonpath.DocumentContext
+import com.jayway.jsonpath.JsonPath
+import spock.lang.Specification
+import javax.inject.Inject
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierObjectMapper
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessage
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessaging
+
+import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*
+import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson
+import static org.springframework.cloud.contract.verifier.messaging.util.ContractVerifierMessagingUtil.headers
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.fileToBytes
+
+@SuppressWarnings("rawtypes")
+class FooSpec extends Specification {
+\t@Inject ContractVerifierMessaging contractVerifierMessaging
+\t@Inject ContractVerifierObjectMapper contractVerifierObjectMapper
+
+\tdef validate_foo() throws Exception {
+\t\tgiven:
+\t\t\tContractVerifierMessage inputMessage = contractVerifierMessaging.create(
+\t\t\t\t\t'''{"bookName":"foo"}'''
+\t\t\t\t\t\t, headers()
+\t\t\t\t\t\t\t.header("sample", "header")
+\t\t\t)
+
+\t\twhen:
+\t\t\tcontractVerifierMessaging.send(inputMessage, "jms:delete")
+\t\t\tbookWasDeleted()
+
+\t\tthen:
+\t\t\tnoExceptionThrown()
+\t}
+
+}
+"""</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-messaging-consumer"><a class="anchor" href="#features-messaging-consumer"></a><a class="link" href="#features-messaging-consumer">4.4. Consumer Stub Generation</a></h3>
+<div class="paragraph">
+<p>Unlike in the HTTP part, in messaging, we need to publish the contract definition inside the JAR with
+a stub. Then it is parsed on the consumer side, and proper stubbed routes are created.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+If you have multiple frameworks on the classpath, Stub Runner needs to
+define which one should be used. Assume that you have AMQP, Spring Cloud Stream, and Spring Integration
+on the classpath and that you want to use Spring AMQP. Then you need to set
+<code>stubrunner.stream.enabled=false</code> and <code>stubrunner.integration.enabled=false</code>.
+That way, the only remaining framework is Spring AMQP.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-stub-triggering"><a class="anchor" href="#features-messaging-stub-triggering"></a><a class="link" href="#features-messaging-stub-triggering">4.4.1. Stub triggering</a></h4>
+<div class="paragraph">
+<p>To trigger a message, use the <code>StubTrigger</code> interface, as the following example shows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package org.springframework.cloud.contract.stubrunner;
+
+import java.util.Collection;
+import java.util.Map;
+
+/**
+ * Contract for triggering stub messages.
+ *
+ * @author Marcin Grzejszczak
+ */
+public interface StubTrigger {
+
+    /**
+     * Triggers an event by a given label for a given {@code groupid:artifactid} notation.
+     * You can use only {@code artifactId} too.
+     *
+     * Feature related to messaging.
+     * @param ivyNotation ivy notation of a stub
+     * @param labelName name of the label to trigger
+     * @return true - if managed to run a trigger
+     */
+    boolean trigger(String ivyNotation, String labelName);
+
+    /**
+     * Triggers an event by a given label.
+     *
+     * Feature related to messaging.
+     * @param labelName name of the label to trigger
+     * @return true - if managed to run a trigger
+     */
+    boolean trigger(String labelName);
+
+    /**
+     * Triggers all possible events.
+     *
+     * Feature related to messaging.
+     * @return true - if managed to run a trigger
+     */
+    boolean trigger();
+
+    /**
+     * Feature related to messaging.
+     * @return a mapping of ivy notation of a dependency to all the labels it has.
+     */
+    Map&lt;String, Collection&lt;String&gt;&gt; labels();
+
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>For convenience, the <code>StubFinder</code> interface extends <code>StubTrigger</code>, so you only need one
+or the other in your tests.</p>
+</div>
+<div class="paragraph">
+<p><code>StubTrigger</code> gives you the following options to trigger a message:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#features-messaging-trigger-label">Trigger by Label</a></p>
+</li>
+<li>
+<p><a href="#features-messaging-trigger-group-artifact-ids">Trigger by Group and Artifact Ids</a></p>
+</li>
+<li>
+<p><a href="#features-messaging-trigger-artifact-ids">Trigger by Artifact IDs</a></p>
+</li>
+<li>
+<p><a href="#features-messaging-trigger-all-messages">Trigger All Messages</a></p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-trigger-label"><a class="anchor" href="#features-messaging-trigger-label"></a><a class="link" href="#features-messaging-trigger-label">4.4.2. Trigger by Label</a></h4>
+<div class="paragraph">
+<p>The following example shows how to trigger a message with a label:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger('return_book_1')</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-trigger-group-artifact-ids"><a class="anchor" href="#features-messaging-trigger-group-artifact-ids"></a><a class="link" href="#features-messaging-trigger-group-artifact-ids">4.4.3. Trigger by Group and Artifact Ids</a></h4>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger('org.springframework.cloud.contract.verifier.stubs:streamService', 'return_book_1')</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-trigger-artifact-ids"><a class="anchor" href="#features-messaging-trigger-artifact-ids"></a><a class="link" href="#features-messaging-trigger-artifact-ids">4.4.4. Trigger by Artifact IDs</a></h4>
+<div class="paragraph">
+<p>The following example shows how to trigger a message from artifact IDs:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger('streamService', 'return_book_1')</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-trigger-all-messages"><a class="anchor" href="#features-messaging-trigger-all-messages"></a><a class="link" href="#features-messaging-trigger-all-messages">4.4.5. Trigger All Messages</a></h4>
+<div class="paragraph">
+<p>The following example shows how to trigger all messages:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger()</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-messaging-stub-runner-camel"><a class="anchor" href="#features-messaging-stub-runner-camel"></a><a class="link" href="#features-messaging-stub-runner-camel">4.5. Consumer Side Messaging With Apache Camel</a></h3>
+<div class="paragraph">
+<p>Spring Cloud Contract Stub Runner&#8217;s messaging module gives you an easy way to integrate with Apache Camel.
+For the provided artifacts, it automatically downloads the stubs and registers the required
+routes.</p>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-stub-runner-camel-adding"><a class="anchor" href="#features-messaging-stub-runner-camel-adding"></a><a class="link" href="#features-messaging-stub-runner-camel-adding">4.5.1. Adding Apache Camel to the Project</a></h4>
+<div class="paragraph">
+<p>You can have both Apache Camel and Spring Cloud Contract Stub Runner on the classpath.
+Remember to annotate your test class with <code>@AutoConfigureStubRunner</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-stub-runner-camel-disabling"><a class="anchor" href="#features-messaging-stub-runner-camel-disabling"></a><a class="link" href="#features-messaging-stub-runner-camel-disabling">4.5.2. Disabling the Functionality</a></h4>
+<div class="paragraph">
+<p>If you need to disable this functionality, set the <code>stubrunner.camel.enabled=false</code> property.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-stub-runner-camel-example"><a class="anchor" href="#features-messaging-stub-runner-camel-example"></a><a class="link" href="#features-messaging-stub-runner-camel-example">4.5.3. Examples</a></h4>
+<div class="paragraph">
+<p>Assume that we have the following Maven repository with deployed stubs for the
+<code>camelService</code> application.</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── .m2
+    └── repository
+        └── io
+            └── codearte
+                └── accurest
+                    └── stubs
+                        └── camelService
+                            ├── 0.0.1-SNAPSHOT
+                            │   ├── camelService-0.0.1-SNAPSHOT.pom
+                            │   ├── camelService-0.0.1-SNAPSHOT-stubs.jar
+                            │   └── maven-metadata-local.xml
+                            └── maven-metadata-local.xml</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Further assume that the stubs contain the following structure:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">├── META-INF
+│   └── MANIFEST.MF
+└── repository
+    ├── accurest
+    │   ├── bookDeleted.groovy
+    │   ├── bookReturned1.groovy
+    │   └── bookReturned2.groovy
+    └── mappings</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Now consider the following contracts (we number them 1 and 2):</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
+    label 'return_book_1'
+    input {
+        triggeredBy('bookReturnedTriggered()')
+    }
+    outputMessage {
+        sentTo('jms:output')
+        body('''{ "bookName" : "foo" }''')
+        headers {
+            header('BOOK-NAME', 'foo')
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
+    label 'return_book_2'
+    input {
+        messageFrom('jms:input')
+        messageBody([
+                bookName: 'foo'
+        ])
+        messageHeaders {
+            header('sample', 'header')
+        }
+    }
+    outputMessage {
+        sentTo('jms:output')
+        body([
+                bookName: 'foo'
+        ])
+        headers {
+            header('BOOK-NAME', 'foo')
+        }
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-camel-scenario1"><a class="anchor" href="#features-messaging-stub-runner-camel-scenario1"></a><a class="link" href="#features-messaging-stub-runner-camel-scenario1">Scenario 1 (No Input Message)</a></h5>
+<div class="paragraph">
+<p>To trigger a message from the <code>return_book_1</code> label, we use the <code>StubTigger</code> interface, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger('return_book_1')</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Next, we want to listen to the output of the message sent to <code>jms:output</code>:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Exchange receivedMessage = consumerTemplate.receive('jms:output', 5000)</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The received message would then pass the following assertions:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">receivedMessage != null
+assertThatBodyContainsBookNameFoo(receivedMessage.in.body)
+receivedMessage.in.headers.get('BOOK-NAME') == 'foo'</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-camel-scenario2"><a class="anchor" href="#features-messaging-stub-runner-camel-scenario2"></a><a class="link" href="#features-messaging-stub-runner-camel-scenario2">Scenario 2 (Output Triggered by Input)</a></h5>
+<div class="paragraph">
+<p>Since the route is set for you, you can send a message to the <code>jms:output</code> destination.</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">producerTemplate.
+        sendBodyAndHeaders('jms:input', new BookReturned('foo'), [sample: 'header'])</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Next, we want to listen to the output of the message sent to <code>jms:output</code>, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Exchange receivedMessage = consumerTemplate.receive('jms:output', 5000)</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The received message would pass the following assertions:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">receivedMessage != null
+assertThatBodyContainsBookNameFoo(receivedMessage.in.body)
+receivedMessage.in.headers.get('BOOK-NAME') == 'foo'</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-camel-scenario3"><a class="anchor" href="#features-messaging-stub-runner-camel-scenario3"></a><a class="link" href="#features-messaging-stub-runner-camel-scenario3">Scenario 3 (Input with No Output)</a></h5>
+<div class="paragraph">
+<p>Since the route is set for you, you can send a message to the <code>jms:output</code> destination, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">producerTemplate.
+        sendBodyAndHeaders('jms:delete', new BookReturned('foo'), [sample: 'header'])</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-messaging-stub-runner-integration"><a class="anchor" href="#features-messaging-stub-runner-integration"></a><a class="link" href="#features-messaging-stub-runner-integration">4.6. Consumer Side Messaging with Spring Integration</a></h3>
+<div class="paragraph">
+<p>Spring Cloud Contract Stub Runner&#8217;s messaging module gives you an easy way to
+integrate with Spring Integration. For the provided artifacts, it automatically downloads
+the stubs and registers the required routes.</p>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-stub-runner-integration-adding"><a class="anchor" href="#features-messaging-stub-runner-integration-adding"></a><a class="link" href="#features-messaging-stub-runner-integration-adding">4.6.1. Adding the Runner to the Project</a></h4>
+<div class="paragraph">
+<p>You can have both Spring Integration and Spring Cloud Contract Stub Runner on the
+classpath. Remember to annotate your test class with <code>@AutoConfigureStubRunner</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-stub-runner-integration-disabling"><a class="anchor" href="#features-messaging-stub-runner-integration-disabling"></a><a class="link" href="#features-messaging-stub-runner-integration-disabling">4.6.2. Disabling the Functionality</a></h4>
+<div class="paragraph">
+<p>If you need to disable this functionality, set the
+<code>stubrunner.integration.enabled=false</code> property.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-stub-runner-integration-example"><a class="anchor" href="#features-messaging-stub-runner-integration-example"></a><a class="link" href="#features-messaging-stub-runner-integration-example">4.6.3. Examples</a></h4>
+<div class="paragraph">
+<p>Assume that you have the following Maven repository with deployed stubs for the
+<code>integrationService</code> application:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── .m2
+    └── repository
+        └── io
+            └── codearte
+                └── accurest
+                    └── stubs
+                        └── integrationService
+                            ├── 0.0.1-SNAPSHOT
+                            │   ├── integrationService-0.0.1-SNAPSHOT.pom
+                            │   ├── integrationService-0.0.1-SNAPSHOT-stubs.jar
+                            │   └── maven-metadata-local.xml
+                            └── maven-metadata-local.xml</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Further assume the stubs contain the following structure:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">├── META-INF
+│   └── MANIFEST.MF
+└── repository
+    ├── accurest
+    │   ├── bookDeleted.groovy
+    │   ├── bookReturned1.groovy
+    │   └── bookReturned2.groovy
+    └── mappings</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Consider the following contracts (numbered 1 and 2):</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
+    label 'return_book_1'
+    input {
+        triggeredBy('bookReturnedTriggered()')
+    }
+    outputMessage {
+        sentTo('output')
+        body('''{ "bookName" : "foo" }''')
+        headers {
+            header('BOOK-NAME', 'foo')
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
+    label 'return_book_2'
+    input {
+        messageFrom('input')
+        messageBody([
+                bookName: 'foo'
+        ])
+        messageHeaders {
+            header('sample', 'header')
+        }
+    }
+    outputMessage {
+        sentTo('output')
+        body([
+                bookName: 'foo'
+        ])
+        headers {
+            header('BOOK-NAME', 'foo')
+        }
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Now consider the following Spring Integration Route:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;?xml version="1.0" encoding="UTF-8"?&gt;
+&lt;beans:beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+             xmlns:beans="http://www.springframework.org/schema/beans"
+             xmlns="http://www.springframework.org/schema/integration"
+             xsi:schemaLocation="http://www.springframework.org/schema/beans
+            https://www.springframework.org/schema/beans/spring-beans.xsd
+            http://www.springframework.org/schema/integration
+            http://www.springframework.org/schema/integration/spring-integration.xsd"&gt;
+
+
+    &lt;!-- REQUIRED FOR TESTING --&gt;
+    &lt;bridge input-channel="output"
+            output-channel="outputTest"/&gt;
+
+    &lt;channel id="outputTest"&gt;
+        &lt;queue/&gt;
+    &lt;/channel&gt;
+
+&lt;/beans:beans&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>These examples lend themselves to three scenarios:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><a href="#features-messaging-stub-runner-integration-scenario1">Scenario 1 (No Input Message)</a></p>
+</li>
+<li>
+<p><a href="#features-messaging-stub-runner-integration-scenario2">Scenario 2 (Output Triggered by Input)</a></p>
+</li>
+<li>
+<p><a href="#features-messaging-stub-runner-integration-scenario3">Scenario 3 (Input with No Output)</a></p>
+</li>
+</ol>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-integration-scenario1"><a class="anchor" href="#features-messaging-stub-runner-integration-scenario1"></a><a class="link" href="#features-messaging-stub-runner-integration-scenario1">Scenario 1 (No Input Message)</a></h5>
+<div class="paragraph">
+<p>To trigger a message from the <code>return_book_1</code> label, use the <code>StubTigger</code> interface, as
+follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger('return_book_1')</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following listing shows how to listen to the output of the message sent to <code>jms:output</code>:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Message&lt;?&gt; receivedMessage = messaging.receive('outputTest')</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The received message would pass the following assertions:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">receivedMessage != null
+assertJsons(receivedMessage.payload)
+receivedMessage.headers.get('BOOK-NAME') == 'foo'</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-integration-scenario2"><a class="anchor" href="#features-messaging-stub-runner-integration-scenario2"></a><a class="link" href="#features-messaging-stub-runner-integration-scenario2">Scenario 2 (Output Triggered by Input)</a></h5>
+<div class="paragraph">
+<p>Since the route is set for you, you can send a message to the <code>jms:output</code>
+destination, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">messaging.send(new BookReturned('foo'), [sample: 'header'], 'input')</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following listing shows how to listen to the output of the message sent to <code>jms:output</code>:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Message&lt;?&gt; receivedMessage = messaging.receive('outputTest')</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The received message passes the following assertions:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">receivedMessage != null
+assertJsons(receivedMessage.payload)
+receivedMessage.headers.get('BOOK-NAME') == 'foo'</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-integration-scenario3"><a class="anchor" href="#features-messaging-stub-runner-integration-scenario3"></a><a class="link" href="#features-messaging-stub-runner-integration-scenario3">Scenario 3 (Input with No Output)</a></h5>
+<div class="paragraph">
+<p>Since the route is set for you, you can send a message to the <code>jms:input</code> destination, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">messaging.send(new BookReturned('foo'), [sample: 'header'], 'delete')</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-messaging-stub-runner-stream"><a class="anchor" href="#features-messaging-stub-runner-stream"></a><a class="link" href="#features-messaging-stub-runner-stream">4.7. Consumer Side Messaging With Spring Cloud Stream</a></h3>
+<div class="paragraph">
+<p>Spring Cloud Contract Stub Runner&#8217;s messaging module gives you an easy way to
+integrate with Spring Stream. For the provided artifacts, it automatically downloads the
+stubs and registers the required routes.</p>
+</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title="Warning"></i>
+</td>
+<td class="content">
+If Stub Runner&#8217;s integration with the Stream <code>messageFrom</code> or <code>sentTo</code> strings
+are resolved first as the <code>destination</code> of a channel and no such <code>destination</code> exists, the
+destination is resolved as a channel name.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>If you want to use Spring Cloud Stream, remember to add a dependency on
+<code>org.springframework.cloud:spring-cloud-stream-test-support</code>, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-stream-test-support&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile "org.springframework.cloud:spring-cloud-stream-test-support"</code></pre>
+</div>
+</div>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-stub-runner-stream-adding"><a class="anchor" href="#features-messaging-stub-runner-stream-adding"></a><a class="link" href="#features-messaging-stub-runner-stream-adding">4.7.1. Adding the Runner to the Project</a></h4>
+<div class="paragraph">
+<p>You can have both Spring Cloud Stream and Spring Cloud Contract Stub Runner on the
+classpath. Remember to annotate your test class with <code>@AutoConfigureStubRunner</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-stub-runner-stream-disabling"><a class="anchor" href="#features-messaging-stub-runner-stream-disabling"></a><a class="link" href="#features-messaging-stub-runner-stream-disabling">4.7.2. Disabling the Functionality</a></h4>
+<div class="paragraph">
+<p>If you need to disable this functionality, set the <code>stubrunner.stream.enabled=false</code>
+property.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-stub-runner-stream-example"><a class="anchor" href="#features-messaging-stub-runner-stream-example"></a><a class="link" href="#features-messaging-stub-runner-stream-example">4.7.3. Examples</a></h4>
+<div class="paragraph">
+<p>Assume that you have the following Maven repository with deployed stubs for the
+<code>streamService</code> application:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── .m2
+    └── repository
+        └── io
+            └── codearte
+                └── accurest
+                    └── stubs
+                        └── streamService
+                            ├── 0.0.1-SNAPSHOT
+                            │   ├── streamService-0.0.1-SNAPSHOT.pom
+                            │   ├── streamService-0.0.1-SNAPSHOT-stubs.jar
+                            │   └── maven-metadata-local.xml
+                            └── maven-metadata-local.xml</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Further assume the stubs contain the following structure:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">├── META-INF
+│   └── MANIFEST.MF
+└── repository
+    ├── accurest
+    │   ├── bookDeleted.groovy
+    │   ├── bookReturned1.groovy
+    │   └── bookReturned2.groovy
+    └── mappings</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Consider the following contracts (numbered 1 and 2):</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
+    label 'return_book_1'
+    input { triggeredBy('bookReturnedTriggered()') }
+    outputMessage {
+        sentTo('returnBook')
+        body('''{ "bookName" : "foo" }''')
+        headers { header('BOOK-NAME', 'foo') }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
+    label 'return_book_2'
+    input {
+        messageFrom('bookStorage')
+        messageBody([
+                bookName: 'foo'
+        ])
+        messageHeaders { header('sample', 'header') }
+    }
+    outputMessage {
+        sentTo('returnBook')
+        body([
+                bookName: 'foo'
+        ])
+        headers { header('BOOK-NAME', 'foo') }
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Now consider the following Spring configuration:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">stubrunner.repositoryRoot: classpath:m2repo/repository/
+stubrunner.ids: org.springframework.cloud.contract.verifier.stubs:streamService:0.0.1-SNAPSHOT:stubs
+stubrunner.stubs-mode: remote
+spring:
+  cloud:
+    stream:
+      bindings:
+        output:
+          destination: returnBook
+        input:
+          destination: bookStorage
+
+server:
+  port: 0
+
+debug: true</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>These examples lend themselves to three scenarios:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#features-messaging-stub-runner-stream-scenario1">Scenario 1 (No Input Message)</a></p>
+</li>
+<li>
+<p><a href="#features-messaging-stub-runner-stream-scenario2">Scenario 2 (Output Triggered by Input)</a></p>
+</li>
+<li>
+<p><a href="#features-messaging-stub-runner-stream-scenario3">Scenario 3 (Input with No Output)</a></p>
+</li>
+</ul>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-stream-scenario1"><a class="anchor" href="#features-messaging-stub-runner-stream-scenario1"></a><a class="link" href="#features-messaging-stub-runner-stream-scenario1">Scenario 1 (No Input Message)</a></h5>
+<div class="paragraph">
+<p>To trigger a message from the <code>return_book_1</code> label, use the <code>StubTrigger</code> interface as
+follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger('return_book_1')</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example shows how to listen to the output of the message sent to a channel whose <code>destination</code> is
+<code>returnBook</code>:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Message&lt;?&gt; receivedMessage = messaging.receive('returnBook')</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The received message passes the following assertions:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">receivedMessage != null
+assertJsons(receivedMessage.payload)
+receivedMessage.headers.get('BOOK-NAME') == 'foo'</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-stream-scenario2"><a class="anchor" href="#features-messaging-stub-runner-stream-scenario2"></a><a class="link" href="#features-messaging-stub-runner-stream-scenario2">Scenario 2 (Output Triggered by Input)</a></h5>
+<div class="paragraph">
+<p>Since the route is set for you, you can send a message to the <code>bookStorage</code>
+<code>destination</code>, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">messaging.send(new BookReturned('foo'), [sample: 'header'], 'bookStorage')</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example shows how to listen to the output of the message sent to <code>returnBook</code>:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Message&lt;?&gt; receivedMessage = messaging.receive('returnBook')</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The received message passes the following assertions:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">receivedMessage != null
+assertJsons(receivedMessage.payload)
+receivedMessage.headers.get('BOOK-NAME') == 'foo'</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-stream-scenario3"><a class="anchor" href="#features-messaging-stub-runner-stream-scenario3"></a><a class="link" href="#features-messaging-stub-runner-stream-scenario3">Scenario 3 (Input with No Output)</a></h5>
+<div class="paragraph">
+<p>Since the route is set for you, you can send a message to the <code>jms:output</code>
+destination, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">messaging.send(new BookReturned('foo'), [sample: 'header'], 'delete')</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-messaging-stub-runner-amqp"><a class="anchor" href="#features-messaging-stub-runner-amqp"></a><a class="link" href="#features-messaging-stub-runner-amqp">4.8. Consumer Side Messaging With Spring AMQP</a></h3>
+<div class="paragraph">
+<p>Spring Cloud Contract Stub Runner&#8217;s messaging module provides an easy way to
+integrate with Spring AMQP&#8217;s Rabbit Template. For the provided artifacts, it
+automatically downloads the stubs and registers the required routes.</p>
+</div>
+<div class="paragraph">
+<p>The integration tries to work standalone (that is, without interaction with a running
+RabbitMQ message broker). It expects a <code>RabbitTemplate</code> on the application context and
+uses it as a spring boot test named <code>@SpyBean</code>. As a result, it can use the Mockito spy
+functionality to verify and inspect messages sent by the application.</p>
+</div>
+<div class="paragraph">
+<p>On the message consumer side, the stub runner considers all <code>@RabbitListener</code> annotated
+endpoints and all <code>SimpleMessageListenerContainer</code> objects on the application context.</p>
+</div>
+<div class="paragraph">
+<p>As messages are usually sent to exchanges in AMQP, the message contract contains the
+exchange name as the destination. Message listeners on the other side are bound to
+queues. Bindings connect an exchange to a queue. If message contracts are triggered, the
+Spring AMQP stub runner integration looks for bindings on the application context that
+matches this exchange. Then it collects the queues from the Spring exchanges and tries to
+find message listeners bound to these queues. The message is triggered for all matching
+message listeners.</p>
+</div>
+<div class="paragraph">
+<p>If you need to work with routing keys, you can pass them by using the <code>amqp_receivedRoutingKey</code>
+messaging header.</p>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-stub-runner-amqp-adding"><a class="anchor" href="#features-messaging-stub-runner-amqp-adding"></a><a class="link" href="#features-messaging-stub-runner-amqp-adding">4.8.1. Adding the Runner to the Project</a></h4>
+<div class="paragraph">
+<p>You can have both Spring AMQP and Spring Cloud Contract Stub Runner on the classpath and
+set the property <code>stubrunner.amqp.enabled=true</code>. Remember to annotate your test class
+with <code>@AutoConfigureStubRunner</code>.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+If you already have Stream and Integration on the classpath, you need
+to disable them explicitly by setting the  <code>stubrunner.stream.enabled=false</code> and
+<code>stubrunner.integration.enabled=false</code> properties.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-stub-runner-amqp-example"><a class="anchor" href="#features-messaging-stub-runner-amqp-example"></a><a class="link" href="#features-messaging-stub-runner-amqp-example">4.8.2. Examples</a></h4>
+<div class="paragraph">
+<p>Assume that you have the following Maven repository with a deployed stubs for the
+<code>spring-cloud-contract-amqp-test</code> application:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── .m2
+    └── repository
+        └── com
+            └── example
+                └── spring-cloud-contract-amqp-test
+                    ├── 0.4.0-SNAPSHOT
+                    │   ├── spring-cloud-contract-amqp-test-0.4.0-SNAPSHOT.pom
+                    │   ├── spring-cloud-contract-amqp-test-0.4.0-SNAPSHOT-stubs.jar
+                    │   └── maven-metadata-local.xml
+                    └── maven-metadata-local.xml</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Further assume that the stubs contain the following structure:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">├── META-INF
+│   └── MANIFEST.MF
+└── contracts
+    └── shouldProduceValidPersonData.groovy</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Then consider the following contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
+    // Human readable description
+    description 'Should produce valid person data'
+    // Label by means of which the output message can be triggered
+    label 'contract-test.person.created.event'
+    // input to the contract
+    input {
+        // the contract will be triggered by a method
+        triggeredBy('createPerson()')
+    }
+    // output message of the contract
+    outputMessage {
+        // destination to which the output message will be sent
+        sentTo 'contract-test.exchange'
+        headers {
+            header('contentType': 'application/json')
+            header('__TypeId__': 'org.springframework.cloud.contract.stubrunner.messaging.amqp.Person')
+        }
+        // the body of the output message
+        body([
+                id  : $(consumer(9), producer(regex("[0-9]+"))),
+                name: "me"
+        ])
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Now consider the following Spring configuration:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">stubrunner:
+  repositoryRoot: classpath:m2repo/repository/
+  ids: org.springframework.cloud.contract.verifier.stubs.amqp:spring-cloud-contract-amqp-test:0.4.0-SNAPSHOT:stubs
+  stubs-mode: remote
+  amqp:
+    enabled: true
+server:
+  port: 0</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-amqp-triggering"><a class="anchor" href="#features-messaging-stub-runner-amqp-triggering"></a><a class="link" href="#features-messaging-stub-runner-amqp-triggering">Triggering the Message</a></h5>
+<div class="paragraph">
+<p>To trigger a message using the contract in the preceding section, use the <code>StubTrigger</code> interface as
+follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubTrigger.trigger("contract-test.person.created.event")</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The message has a destination of <code>contract-test.exchange</code>, so the Spring AMQP stub runner
+integration looks for bindings related to this exchange, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Bean
+public Binding binding() {
+    return BindingBuilder.bind(new Queue("test.queue"))
+            .to(new DirectExchange("contract-test.exchange")).with("#");
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The binding definition binds the queue called <code>test.queue</code>. As a result, the following listener
+definition is matched and invoked with the contract message:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Bean
+public SimpleMessageListenerContainer simpleMessageListenerContainer(
+        ConnectionFactory connectionFactory,
+        MessageListenerAdapter listenerAdapter) {
+    SimpleMessageListenerContainer container = new SimpleMessageListenerContainer();
+    container.setConnectionFactory(connectionFactory);
+    container.setQueueNames("test.queue");
+    container.setMessageListener(listenerAdapter);
+
+    return container;
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Also, the following annotated listener matches and is invoked:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RabbitListener(bindings = @QueueBinding(value = @Queue("test.queue"),
+        exchange = @Exchange(value = "contract-test.exchange",
+                ignoreDeclarationExceptions = "true")))
+public void handlePerson(Person person) {
+    this.person = person;
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+The message is directly handed over to the <code>onMessage</code> method of the
+<code>MessageListener</code> associated with the matching <code>SimpleMessageListenerContainer</code>.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-amqp-configuration"><a class="anchor" href="#features-messaging-stub-runner-amqp-configuration"></a><a class="link" href="#features-messaging-stub-runner-amqp-configuration">Spring AMQP Test Configuration</a></h5>
+<div class="paragraph">
+<p>In order to avoid Spring AMQP trying to connect to a running broker during our tests, we
+configure a mock <code>ConnectionFactory</code>.</p>
+</div>
+<div class="paragraph">
+<p>To disable the mocked <code>ConnectionFactory</code>, set the following property:
+<code>stubrunner.amqp.mockConnection=false</code>, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">stubrunner:
+  amqp:
+    mockConnection: false</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="features-stub-runner"><a class="anchor" href="#features-stub-runner"></a><a class="link" href="#features-stub-runner">5. Spring Cloud Contract Stub Runner</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>One of the issues that you might encounter while using Spring Cloud Contract Verifier is
+passing the generated WireMock JSON stubs from the server side to the client side (or to
+various clients). The same takes place in terms of client-side generation for messaging.</p>
+</div>
+<div class="paragraph">
+<p>Copying the JSON files and setting the client side for messaging manually is out of the
+question. That is why we introduced Spring Cloud Contract Stub Runner. It can
+automatically download and run the stubs for you.</p>
+</div>
+<div class="sect2">
+<h3 id="features-stub-runner-snapshot-versions"><a class="anchor" href="#features-stub-runner-snapshot-versions"></a><a class="link" href="#features-stub-runner-snapshot-versions">5.1. Snapshot Versions</a></h3>
+<div class="paragraph">
+<p>You can add the additional snapshot repository to your <code>build.gradle</code> file to use snapshot
+versions, which are automatically uploaded after every successful build, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;repositories&gt;
+    &lt;repository&gt;
+        &lt;id&gt;spring-snapshots&lt;/id&gt;
+        &lt;name&gt;Spring Snapshots&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;true&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/repository&gt;
+    &lt;repository&gt;
+        &lt;id&gt;spring-milestones&lt;/id&gt;
+        &lt;name&gt;Spring Milestones&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/repository&gt;
+    &lt;repository&gt;
+        &lt;id&gt;spring-releases&lt;/id&gt;
+        &lt;name&gt;Spring Releases&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/repository&gt;
+&lt;/repositories&gt;
+&lt;pluginRepositories&gt;
+    &lt;pluginRepository&gt;
+        &lt;id&gt;spring-snapshots&lt;/id&gt;
+        &lt;name&gt;Spring Snapshots&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;true&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/pluginRepository&gt;
+    &lt;pluginRepository&gt;
+        &lt;id&gt;spring-milestones&lt;/id&gt;
+        &lt;name&gt;Spring Milestones&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/pluginRepository&gt;
+    &lt;pluginRepository&gt;
+        &lt;id&gt;spring-releases&lt;/id&gt;
+        &lt;name&gt;Spring Releases&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/pluginRepository&gt;
+&lt;/pluginRepositories&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">buildscript {
+    repositories {
+        mavenCentral()
+        mavenLocal()
+        maven { url "https://repo.spring.io/snapshot" }
+        maven { url "https://repo.spring.io/milestone" }
+        maven { url "https://repo.spring.io/release" }
+    }</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-stub-runner-publishing-stubs-as-jars"><a class="anchor" href="#features-stub-runner-publishing-stubs-as-jars"></a><a class="link" href="#features-stub-runner-publishing-stubs-as-jars">5.2. Publishing Stubs as JARs</a></h3>
+<div class="paragraph">
+<p>The easiest approach to publishing stubs as jars is to centralize the way stubs are kept.
+For example, you can keep them as jars in a Maven repository.</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+For both Maven and Gradle, the setup comes ready to work. However, you can customize
+it if you want to.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following example shows how to publish stubs as jars:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;!-- First disable the default jar setup in the properties section --&gt;
+&lt;!-- we don't want the verifier to do a jar for us --&gt;
+&lt;spring.cloud.contract.verifier.skip&gt;true&lt;/spring.cloud.contract.verifier.skip&gt;
+
+&lt;!-- Next add the assembly plugin to your build --&gt;
+&lt;!-- we want the assembly plugin to generate the JAR --&gt;
+&lt;plugin&gt;
+    &lt;groupId&gt;org.apache.maven.plugins&lt;/groupId&gt;
+    &lt;artifactId&gt;maven-assembly-plugin&lt;/artifactId&gt;
+    &lt;executions&gt;
+        &lt;execution&gt;
+            &lt;id&gt;stub&lt;/id&gt;
+            &lt;phase&gt;prepare-package&lt;/phase&gt;
+            &lt;goals&gt;
+                &lt;goal&gt;single&lt;/goal&gt;
+            &lt;/goals&gt;
+            &lt;inherited&gt;false&lt;/inherited&gt;
+            &lt;configuration&gt;
+                &lt;attach&gt;true&lt;/attach&gt;
+                &lt;descriptors&gt;
+                    ${basedir}/src/assembly/stub.xml
+                &lt;/descriptors&gt;
+            &lt;/configuration&gt;
+        &lt;/execution&gt;
+    &lt;/executions&gt;
+&lt;/plugin&gt;
+
+&lt;!-- Finally setup your assembly. Below you can find the contents of src/main/assembly/stub.xml --&gt;
+&lt;assembly
+    xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 https://maven.apache.org/xsd/assembly-1.1.3.xsd"&gt;
+    &lt;id&gt;stubs&lt;/id&gt;
+    &lt;formats&gt;
+        &lt;format&gt;jar&lt;/format&gt;
+    &lt;/formats&gt;
+    &lt;includeBaseDirectory&gt;false&lt;/includeBaseDirectory&gt;
+    &lt;fileSets&gt;
+        &lt;fileSet&gt;
+            &lt;directory&gt;src/main/java&lt;/directory&gt;
+            &lt;outputDirectory&gt;/&lt;/outputDirectory&gt;
+            &lt;includes&gt;
+                &lt;include&gt;**com/example/model/*.*&lt;/include&gt;
+            &lt;/includes&gt;
+        &lt;/fileSet&gt;
+        &lt;fileSet&gt;
+            &lt;directory&gt;${project.build.directory}/classes&lt;/directory&gt;
+            &lt;outputDirectory&gt;/&lt;/outputDirectory&gt;
+            &lt;includes&gt;
+                &lt;include&gt;**com/example/model/*.*&lt;/include&gt;
+            &lt;/includes&gt;
+        &lt;/fileSet&gt;
+        &lt;fileSet&gt;
+            &lt;directory&gt;${project.build.directory}/snippets/stubs&lt;/directory&gt;
+            &lt;outputDirectory&gt;META-INF/${project.groupId}/${project.artifactId}/${project.version}/mappings&lt;/outputDirectory&gt;
+            &lt;includes&gt;
+                &lt;include&gt;**/*&lt;/include&gt;
+            &lt;/includes&gt;
+        &lt;/fileSet&gt;
+        &lt;fileSet&gt;
+            &lt;directory&gt;${basedir}/src/test/resources/contracts&lt;/directory&gt;
+            &lt;outputDirectory&gt;META-INF/${project.groupId}/${project.artifactId}/${project.version}/contracts&lt;/outputDirectory&gt;
+            &lt;includes&gt;
+                &lt;include&gt;**/*.groovy&lt;/include&gt;
+            &lt;/includes&gt;
+        &lt;/fileSet&gt;
+    &lt;/fileSets&gt;
+&lt;/assembly&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">ext {
+    contractsDir = file("mappings")
+    stubsOutputDirRoot = file("${project.buildDir}/production/${project.name}-stubs/")
+}
+
+// Automatically added by plugin:
+// copyContracts - copies contracts to the output folder from which JAR will be created
+// verifierStubsJar - JAR with a provided stub suffix
+// the presented publication is also added by the plugin but you can modify it as you wish
+
+publishing {
+    publications {
+        stubs(MavenPublication) {
+            artifactId "${project.name}-stubs"
+            artifact verifierStubsJar
+        }
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-stub-runner-core"><a class="anchor" href="#features-stub-runner-core"></a><a class="link" href="#features-stub-runner-core">5.3. Stub Runner Core</a></h3>
+<div class="paragraph">
+<p>The stub runner core runs stubs for service collaborators. Treating stubs as contracts of
+services lets you use stub-runner as an implementation of
+<a href="https://martinfowler.com/articles/consumerDrivenContracts.html">Consumer-driven Contracts</a>.</p>
+</div>
+<div class="paragraph">
+<p>Stub Runner lets you automatically download the stubs of the provided dependencies (or
+pick those from the classpath), start WireMock servers for them, and feed them with proper
+stub definitions. For messaging, special stub routes are defined.</p>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-retrieving"><a class="anchor" href="#features-stub-runner-retrieving"></a><a class="link" href="#features-stub-runner-retrieving">5.3.1. Retrieving stubs</a></h4>
+<div class="paragraph">
+<p>You can pick from the following options of acquiring stubs:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Aether-based solution that downloads JARs with stubs from Artifactory or Nexus</p>
+</li>
+<li>
+<p>Classpath-scanning solution that searches the classpath with a pattern to retrieve stubs</p>
+</li>
+<li>
+<p>Writing your own implementation of the <code>org.springframework.cloud.contract.stubrunner.StubDownloaderBuilder</code> for full customization</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The latter example is described in the <a href="advanced.html#customization-custom-stub-runner">Custom Stub Runner</a> section.</p>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-downloading-stub"><a class="anchor" href="#features-stub-runner-downloading-stub"></a><a class="link" href="#features-stub-runner-downloading-stub">Downloading Stubs</a></h5>
+<div class="paragraph">
+<p>You can control the downloading of stubs with the <code>stubsMode</code> switch. It picks value from the
+<code>StubRunnerProperties.StubsMode</code> enumeration. You can use the following options:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>StubRunnerProperties.StubsMode.CLASSPATH</code> (default value): Picks stubs from the classpath</p>
+</li>
+<li>
+<p><code>StubRunnerProperties.StubsMode.LOCAL</code>: Picks stubs from a local storage (for example, <code>.m2</code>)</p>
+</li>
+<li>
+<p><code>StubRunnerProperties.StubsMode.REMOTE</code>: Picks stubs from a remote location</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The following example picks stubs from a local location:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(repositoryRoot="https://foo.bar", ids = "com.example:beer-api-producer:+:stubs:8095", stubsMode = StubRunnerProperties.StubsMode.LOCAL)</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-classpath-scanning"><a class="anchor" href="#features-stub-runner-classpath-scanning"></a><a class="link" href="#features-stub-runner-classpath-scanning">Classpath scanning</a></h5>
+<div class="paragraph">
+<p>If you set the <code>stubsMode</code> property to <code>StubRunnerProperties.StubsMode.CLASSPATH</code>
+(or set nothing since <code>CLASSPATH</code> is the default value), the classpath is scanned.
+Consider the following example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(ids = {
+    "com.example:beer-api-producer:+:stubs:8095",
+    "com.example.foo:bar:1.0.0:superstubs:8096"
+})</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can add the dependencies to your classpath, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;com.example&lt;/groupId&gt;
+    &lt;artifactId&gt;beer-api-producer-restdocs&lt;/artifactId&gt;
+    &lt;classifier&gt;stubs&lt;/classifier&gt;
+    &lt;version&gt;0.0.1-SNAPSHOT&lt;/version&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+    &lt;exclusions&gt;
+        &lt;exclusion&gt;
+            &lt;groupId&gt;*&lt;/groupId&gt;
+            &lt;artifactId&gt;*&lt;/artifactId&gt;
+        &lt;/exclusion&gt;
+    &lt;/exclusions&gt;
+&lt;/dependency&gt;
+&lt;dependency&gt;
+    &lt;groupId&gt;com.example.thing1&lt;/groupId&gt;
+    &lt;artifactId&gt;thing2&lt;/artifactId&gt;
+    &lt;classifier&gt;superstubs&lt;/classifier&gt;
+    &lt;version&gt;1.0.0&lt;/version&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+    &lt;exclusions&gt;
+        &lt;exclusion&gt;
+            &lt;groupId&gt;*&lt;/groupId&gt;
+            &lt;artifactId&gt;*&lt;/artifactId&gt;
+        &lt;/exclusion&gt;
+    &lt;/exclusions&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile("com.example:beer-api-producer-restdocs:0.0.1-SNAPSHOT:stubs") {
+    transitive = false
+}
+testCompile("com.example.thing1:thing2:1.0.0:superstubs") {
+    transitive = false
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Then the specified locations on your classpath get scanned. For <code>com.example:beer-api-producer-restdocs</code>,
+the following locations are scanned:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>/META-INF/com.example/beer-api-producer-restdocs/<strong>*/</strong>.*</p>
+</li>
+<li>
+<p>/contracts/com.example/beer-api-producer-restdocs/<strong>*/</strong>.*</p>
+</li>
+<li>
+<p>/mappings/com.example/beer-api-producer-restdocs/<strong>*/</strong>.*</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For <code>com.example.thing1:thing2</code>, the following locations are scanned:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>/META-INF/com.example.thing1/thing2/<strong>*/</strong>.*</p>
+</li>
+<li>
+<p>/contracts/com.example.thing1/thing2/<strong>*/</strong>.*</p>
+</li>
+<li>
+<p>/mappings/com.example.thing1/thing2/<strong>*/</strong>.*</p>
+</li>
+</ul>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+You have to explicitly provide the group and artifact IDs when you package the
+producer stubs.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>To achieve proper stub packaging, the producer would set up the contracts as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── src
+    └── test
+        └── resources
+            └── contracts
+                └── com.example
+                    └── beer-api-producer-restdocs
+                        └── nested
+                            └── contract3.groovy</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>By using the <a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/blob/2.2.x/producer_with_restdocs/pom.xml">Maven <code>assembly</code> plugin</a> or
+<a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/blob/2.2.x/producer_with_restdocs/build.gradle">Gradle Jar</a> task, you have to create the following
+structure in your stubs jar:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── META-INF
+    └── com.example
+        └── beer-api-producer-restdocs
+            └── 2.0.0
+                ├── contracts
+                │   └── nested
+                │       └── contract2.groovy
+                └── mappings
+                    └── mapping.json</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>By maintaining this structure, the classpath gets scanned and you can profit from the messaging or
+HTTP stubs without the need to download artifacts.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-configuring-http-server-stubs"><a class="anchor" href="#features-stub-runner-configuring-http-server-stubs"></a><a class="link" href="#features-stub-runner-configuring-http-server-stubs">Configuring HTTP Server Stubs</a></h5>
+<div class="paragraph">
+<p>Stub Runner has a notion of a <code>HttpServerStub</code> that abstracts the underlying
+concrete implementation of the HTTP server (for example, WireMock is one of the implementations).
+Sometimes, you need to perform some additional tuning (which is concrete for the given implementation) of the stub servers.
+To do that, Stub Runner gives you
+the <code>httpServerStubConfigurer</code> property that is available in the annotation and the
+JUnit rule and is accessible through system properties, where you can provide
+your implementation of the <code>org.springframework.cloud.contract.stubrunner.HttpServerStubConfigurer</code>
+interface. The implementations can alter
+the configuration files for the given HTTP server stub.</p>
+</div>
+<div class="paragraph">
+<p>Spring Cloud Contract Stub Runner comes with an implementation that you
+can extend for WireMock:
+<code>org.springframework.cloud.contract.stubrunner.provider.wiremock.WireMockHttpServerStubConfigurer</code>.
+In the <code>configure</code> method,
+you can provide your own custom configuration for the given stub. The use
+case might be starting WireMock for the given artifact ID, on an HTTPS port. The following
+example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 1. WireMockHttpServerStubConfigurer implementation</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@CompileStatic
+static class HttpsForFraudDetection extends WireMockHttpServerStubConfigurer {
+
+    private static final Log log = LogFactory.getLog(HttpsForFraudDetection)
+
+    @Override
+    WireMockConfiguration configure(WireMockConfiguration httpStubConfiguration, HttpServerStubConfiguration httpServerStubConfiguration) {
+        if (httpServerStubConfiguration.stubConfiguration.artifactId == "fraudDetectionServer") {
+            int httpsPort = SocketUtils.findAvailableTcpPort()
+            log.info("Will set HTTPs port [" + httpsPort + "] for fraud detection server")
+            return httpStubConfiguration
+                    .httpsPort(httpsPort)
+        }
+        return httpStubConfiguration
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can then reuse it with the <code>@AutoConfigureStubRunner</code> annotation, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@AutoConfigureStubRunner(mappingsOutputFolder = "target/outputmappings/",
+        httpServerStubConfigurer = HttpsForFraudDetection)</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Whenever an HTTPS port is found, it takes precedence over the HTTP port.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-running-stubs"><a class="anchor" href="#features-stub-runner-running-stubs"></a><a class="link" href="#features-stub-runner-running-stubs">5.3.2. Running stubs</a></h4>
+<div class="paragraph">
+<p>This section describes how to run stubs. It contains the following topics:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#features-stub-runner-http-stubs">HTTP Stubs</a></p>
+</li>
+<li>
+<p><a href="#features-stub-runner-viewing">Viewing Registered Mappings</a></p>
+</li>
+<li>
+<p><a href="#features-stub-runner-messaging">Messaging Stubs</a></p>
+</li>
+</ul>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-http-stubs"><a class="anchor" href="#features-stub-runner-http-stubs"></a><a class="link" href="#features-stub-runner-http-stubs">HTTP Stubs</a></h5>
+<div class="paragraph">
+<p>Stubs are defined in JSON documents, whose syntax is defined in <a href="http://wiremock.org/stubbing.html">WireMock documentation</a></p>
+</div>
+<div class="paragraph">
+<p>The following example defines a stub in JSON:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">{
+    "request": {
+        "method": "GET",
+        "url": "/ping"
+    },
+    "response": {
+        "status": 200,
+        "body": "pong",
+        "headers": {
+            "Content-Type": "text/plain"
+        }
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-viewing"><a class="anchor" href="#features-stub-runner-viewing"></a><a class="link" href="#features-stub-runner-viewing">Viewing Registered Mappings</a></h5>
+<div class="paragraph">
+<p>Every stubbed collaborator exposes a list of defined mappings under the <code>__/admin/</code> endpoint.</p>
+</div>
+<div class="paragraph">
+<p>You can also use the <code>mappingsOutputFolder</code> property to dump the mappings to files.
+For the annotation-based approach, it would resembling the following example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(ids="a.b.c:loanIssuance,a.b.c:fraudDetectionServer",
+mappingsOutputFolder = "target/outputmappings/")</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>For the JUnit approach, it resembles the following example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@ClassRule @Shared StubRunnerRule rule = new StubRunnerRule()
+            .repoRoot("https://some_url")
+            .downloadStub("a.b.c", "loanIssuance")
+            .downloadStub("a.b.c:fraudDetectionServer")
+            .withMappingsOutputFolder("target/outputmappings")</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Then, if you check out the <code>target/outputmappings</code> folder, you would see the following structure;</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">.
+├── fraudDetectionServer_13705
+└── loanIssuance_12255</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>That means that there were two stubs registered. <code>fraudDetectionServer</code> was registered at port <code>13705</code>
+and <code>loanIssuance</code> at port <code>12255</code>. If we take a look at one of the files, we would see (for WireMock)
+the mappings available for the given server:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">[{
+  "id" : "f9152eb9-bf77-4c38-8289-90be7d10d0d7",
+  "request" : {
+    "url" : "/name",
+    "method" : "GET"
+  },
+  "response" : {
+    "status" : 200,
+    "body" : "fraudDetectionServer"
+  },
+  "uuid" : "f9152eb9-bf77-4c38-8289-90be7d10d0d7"
+},
+...
+]</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-messaging"><a class="anchor" href="#features-stub-runner-messaging"></a><a class="link" href="#features-stub-runner-messaging">Messaging Stubs</a></h5>
+<div class="paragraph">
+<p>Depending on the provided Stub Runner dependency and the DSL, the messaging routes are automatically set up.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-stub-runner-junit"><a class="anchor" href="#features-stub-runner-junit"></a><a class="link" href="#features-stub-runner-junit">5.4. Stub Runner JUnit Rule and Stub Runner JUnit5 Extension</a></h3>
+<div class="paragraph">
+<p>Stub Runner comes with a JUnit rule that lets you can download and run stubs for a given
+group and artifact ID, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@ClassRule
+public static StubRunnerRule rule = new StubRunnerRule().repoRoot(repoRoot())
+        .stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+        .downloadStub("org.springframework.cloud.contract.verifier.stubs",
+                "loanIssuance")
+        .downloadStub(
+                "org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer");
+
+@BeforeClass
+@AfterClass
+public static void setupProps() {
+    System.clearProperty("stubrunner.repository.root");
+    System.clearProperty("stubrunner.classifier");
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>A <code>StubRunnerExtension</code> is also available for JUnit 5. <code>StubRunnerRule</code> and
+<code>StubRunnerExtension</code> work in a very similar fashion. After the rule or extension is
+executed, Stub Runner connects to your Maven repository and, for the given list of
+dependencies, tries to:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Download them</p>
+</li>
+<li>
+<p>Cache them locally</p>
+</li>
+<li>
+<p>Unzip them to a temporary folder</p>
+</li>
+<li>
+<p>Start a WireMock server for each Maven dependency on a random port from the provided
+range of ports or the provided port</p>
+</li>
+<li>
+<p>Feed the WireMock server with all JSON files that are valid WireMock definitions</p>
+</li>
+<li>
+<p>Send messages (remember to pass an implementation of <code>MessageVerifier</code> interface)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Stub Runner uses the <a href="https://wiki.eclipse.org/Aether">Eclipse Aether</a> mechanism to download the Maven dependencies.
+Check their <a href="https://wiki.eclipse.org/Aether">docs</a> for more information.</p>
+</div>
+<div class="paragraph">
+<p>Since the <code>StubRunnerRule</code> and <code>StubRunnerExtension</code> implement the <code>StubFinder</code> they let
+you find the started stubs, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package org.springframework.cloud.contract.stubrunner;
+
+import java.net.URL;
+import java.util.Collection;
+import java.util.Map;
+
+import org.springframework.cloud.contract.spec.Contract;
+
+/**
+ * Contract for finding registered stubs.
+ *
+ * @author Marcin Grzejszczak
+ */
+public interface StubFinder extends StubTrigger {
+
+    /**
+     * For the given groupId and artifactId tries to find the matching URL of the running
+     * stub.
+     * @param groupId - might be null. In that case a search only via artifactId takes
+     * place
+     * @param artifactId - artifact id of the stub
+     * @return URL of a running stub or throws exception if not found
+     * @throws StubNotFoundException in case of not finding a stub
+     */
+    URL findStubUrl(String groupId, String artifactId) throws StubNotFoundException;
+
+    /**
+     * For the given Ivy notation {@code [groupId]:artifactId:[version]:[classifier]}
+     * tries to find the matching URL of the running stub. You can also pass only
+     * {@code artifactId}.
+     * @param ivyNotation - Ivy representation of the Maven artifact
+     * @return URL of a running stub or throws exception if not found
+     * @throws StubNotFoundException in case of not finding a stub
+     */
+    URL findStubUrl(String ivyNotation) throws StubNotFoundException;
+
+    /**
+     * @return all running stubs
+     */
+    RunningStubs findAllRunningStubs();
+
+    /**
+     * @return the list of Contracts
+     */
+    Map&lt;StubConfiguration, Collection&lt;Contract&gt;&gt; getContracts();
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following examples provide more detail about using Stub Runner:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">spock</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@ClassRule
+@Shared
+StubRunnerRule rule = new StubRunnerRule()
+        .stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+        .repoRoot(StubRunnerRuleSpec.getResource("/m2repo/repository").toURI().toString())
+        .downloadStub("org.springframework.cloud.contract.verifier.stubs", "loanIssuance")
+        .downloadStub("org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer")
+        .withMappingsOutputFolder("target/outputmappingsforrule")
+
+
+def 'should start WireMock servers'() {
+    expect: 'WireMocks are running'
+        rule.findStubUrl('org.springframework.cloud.contract.verifier.stubs', 'loanIssuance') != null
+        rule.findStubUrl('loanIssuance') != null
+        rule.findStubUrl('loanIssuance') == rule.findStubUrl('org.springframework.cloud.contract.verifier.stubs', 'loanIssuance')
+        rule.findStubUrl('org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer') != null
+    and:
+        rule.findAllRunningStubs().isPresent('loanIssuance')
+        rule.findAllRunningStubs().isPresent('org.springframework.cloud.contract.verifier.stubs', 'fraudDetectionServer')
+        rule.findAllRunningStubs().isPresent('org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer')
+    and: 'Stubs were registered'
+        "${rule.findStubUrl('loanIssuance').toString()}/name".toURL().text == 'loanIssuance'
+        "${rule.findStubUrl('fraudDetectionServer').toString()}/name".toURL().text == 'fraudDetectionServer'
+}
+
+def 'should output mappings to output folder'() {
+    when:
+        def url = rule.findStubUrl('fraudDetectionServer')
+    then:
+        new File("target/outputmappingsforrule", "fraudDetectionServer_${url.port}").exists()
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">junit 4</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
+public void should_start_wiremock_servers() throws Exception {
+    // expect: 'WireMocks are running'
+    then(rule.findStubUrl("org.springframework.cloud.contract.verifier.stubs",
+            "loanIssuance")).isNotNull();
+    then(rule.findStubUrl("loanIssuance")).isNotNull();
+    then(rule.findStubUrl("loanIssuance")).isEqualTo(rule.findStubUrl(
+            "org.springframework.cloud.contract.verifier.stubs", "loanIssuance"));
+    then(rule.findStubUrl(
+            "org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer"))
+                    .isNotNull();
+    // and:
+    then(rule.findAllRunningStubs().isPresent("loanIssuance")).isTrue();
+    then(rule.findAllRunningStubs().isPresent(
+            "org.springframework.cloud.contract.verifier.stubs",
+            "fraudDetectionServer")).isTrue();
+    then(rule.findAllRunningStubs().isPresent(
+            "org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer"))
+                    .isTrue();
+    // and: 'Stubs were registered'
+    then(httpGet(rule.findStubUrl("loanIssuance").toString() + "/name"))
+            .isEqualTo("loanIssuance");
+    then(httpGet(rule.findStubUrl("fraudDetectionServer").toString() + "/name"))
+            .isEqualTo("fraudDetectionServer");
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">junit 5</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">// Visible for Junit
+@RegisterExtension
+static StubRunnerExtension stubRunnerExtension = new StubRunnerExtension()
+        .repoRoot(repoRoot()).stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+        .downloadStub("org.springframework.cloud.contract.verifier.stubs",
+                "loanIssuance")
+        .downloadStub(
+                "org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer")
+        .withMappingsOutputFolder("target/outputmappingsforrule");
+
+@BeforeAll
+@AfterAll
+static void setupProps() {
+    System.clearProperty("stubrunner.repository.root");
+    System.clearProperty("stubrunner.classifier");
+}
+
+private static String repoRoot() {
+    try {
+        return StubRunnerRuleJUnitTest.class.getResource("/m2repo/repository/")
+                .toURI().toString();
+    }
+    catch (Exception e) {
+        return "";
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>See the <a href="#features-stub-runner-common-properties-junit-spring">Common Properties for JUnit and Spring</a> for more information on
+how to apply global configuration of Stub Runner.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+To use the JUnit rule or JUnit 5 extension together with messaging, you have to provide an implementation of the
+<code>MessageVerifier</code> interface to the rule builder (for example, <code>rule.messageVerifier(new MyMessageVerifier())</code>).
+If you do not do this, then, whenever you try to send a message, an exception is thrown.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-rule-maven-settings"><a class="anchor" href="#features-stub-runner-rule-maven-settings"></a><a class="link" href="#features-stub-runner-rule-maven-settings">5.4.1. Maven Settings</a></h4>
+<div class="paragraph">
+<p>The stub downloader honors Maven settings for a different local repository folder.
+Authentication details for repositories and profiles are currently not taken into account,
+so you need to specify it by using the properties mentioned above.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-rule-fixed-ports"><a class="anchor" href="#features-stub-runner-rule-fixed-ports"></a><a class="link" href="#features-stub-runner-rule-fixed-ports">5.4.2. Providing Fixed Ports</a></h4>
+<div class="paragraph">
+<p>You can also run your stubs on fixed ports. You can do it in two different ways.
+One is to pass it in the properties, and the other is to use the fluent API of
+JUnit rule.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-rule-fluent-api"><a class="anchor" href="#features-stub-runner-rule-fluent-api"></a><a class="link" href="#features-stub-runner-rule-fluent-api">5.4.3. Fluent API</a></h4>
+<div class="paragraph">
+<p>When using the <code>StubRunnerRule</code> or <code>StubRunnerExtension</code>, you can add a stub to download
+and then pass the port for the last downloaded stub. The following example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@ClassRule
+public static StubRunnerRule rule = new StubRunnerRule().repoRoot(repoRoot())
+        .stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+        .downloadStub("org.springframework.cloud.contract.verifier.stubs",
+                "loanIssuance")
+        .withPort(12345).downloadStub(
+                "org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer:12346");
+
+@BeforeClass
+@AfterClass
+public static void setupProps() {
+    System.clearProperty("stubrunner.repository.root");
+    System.clearProperty("stubrunner.classifier");
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>For the preceding example, the following test is valid:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">then(rule.findStubUrl("loanIssuance"))
+        .isEqualTo(URI.create("http://localhost:12345").toURL());
+then(rule.findStubUrl("fraudDetectionServer"))
+        .isEqualTo(URI.create("http://localhost:12346").toURL());</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-rule-spring"><a class="anchor" href="#features-stub-runner-rule-spring"></a><a class="link" href="#features-stub-runner-rule-spring">5.4.4. Stub Runner with Spring</a></h4>
+<div class="paragraph">
+<p>Stub Runner with Spring sets up Spring configuration of the Stub Runner project.</p>
+</div>
+<div class="paragraph">
+<p>By providing a list of stubs inside your configuration file, Stub Runner automatically downloads
+and registers in WireMock the selected stubs.</p>
+</div>
+<div class="paragraph">
+<p>If you want to find the URL of your stubbed dependency, you can autowire the <code>StubFinder</code> interface and use
+its methods, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@ContextConfiguration(classes = Config, loader = SpringBootContextLoader)
+@SpringBootTest(properties = [" stubrunner.cloud.enabled=false",
+        'foo=${stubrunner.runningstubs.fraudDetectionServer.port}',
+        'fooWithGroup=${stubrunner.runningstubs.org.springframework.cloud.contract.verifier.stubs.fraudDetectionServer.port}'])
+@AutoConfigureStubRunner(mappingsOutputFolder = "target/outputmappings/",
+        httpServerStubConfigurer = HttpsForFraudDetection)
+@ActiveProfiles("test")
+class StubRunnerConfigurationSpec extends Specification {
+
+    @Autowired
+    StubFinder stubFinder
+    @Autowired
+    Environment environment
+    @StubRunnerPort("fraudDetectionServer")
+    int fraudDetectionServerPort
+    @StubRunnerPort("org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer")
+    int fraudDetectionServerPortWithGroupId
+    @Value('${foo}')
+    Integer foo
+
+    @BeforeClass
+    @AfterClass
+    void setupProps() {
+        System.clearProperty("stubrunner.repository.root")
+        System.clearProperty("stubrunner.classifier")
+    }
+
+    def 'should start WireMock servers'() {
+        expect: 'WireMocks are running'
+            stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs', 'loanIssuance') != null
+            stubFinder.findStubUrl('loanIssuance') != null
+            stubFinder.findStubUrl('loanIssuance') == stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs', 'loanIssuance')
+            stubFinder.findStubUrl('loanIssuance') == stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs:loanIssuance')
+            stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs:loanIssuance:0.0.1-SNAPSHOT') == stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs:loanIssuance:0.0.1-SNAPSHOT:stubs')
+            stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer') != null
+        and:
+            stubFinder.findAllRunningStubs().isPresent('loanIssuance')
+            stubFinder.findAllRunningStubs().isPresent('org.springframework.cloud.contract.verifier.stubs', 'fraudDetectionServer')
+            stubFinder.findAllRunningStubs().isPresent('org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer')
+        and: 'Stubs were registered'
+            "${stubFinder.findStubUrl('loanIssuance').toString()}/name".toURL().text == 'loanIssuance'
+            "${stubFinder.findStubUrl('fraudDetectionServer').toString()}/name".toURL().text == 'fraudDetectionServer'
+        and: 'Fraud Detection is an HTTPS endpoint'
+            stubFinder.findStubUrl('fraudDetectionServer').toString().startsWith("https")
+    }
+
+    def 'should throw an exception when stub is not found'() {
+        when:
+            stubFinder.findStubUrl('nonExistingService')
+        then:
+            thrown(StubNotFoundException)
+        when:
+            stubFinder.findStubUrl('nonExistingGroupId', 'nonExistingArtifactId')
+        then:
+            thrown(StubNotFoundException)
+    }
+
+    def 'should register started servers as environment variables'() {
+        expect:
+            environment.getProperty("stubrunner.runningstubs.loanIssuance.port") != null
+            stubFinder.findAllRunningStubs().getPort("loanIssuance") == (environment.getProperty("stubrunner.runningstubs.loanIssuance.port") as Integer)
+        and:
+            environment.getProperty("stubrunner.runningstubs.fraudDetectionServer.port") != null
+            stubFinder.findAllRunningStubs().getPort("fraudDetectionServer") == (environment.getProperty("stubrunner.runningstubs.fraudDetectionServer.port") as Integer)
+        and:
+            environment.getProperty("stubrunner.runningstubs.fraudDetectionServer.port") != null
+            stubFinder.findAllRunningStubs().getPort("fraudDetectionServer") == (environment.getProperty("stubrunner.runningstubs.org.springframework.cloud.contract.verifier.stubs.fraudDetectionServer.port") as Integer)
+    }
+
+    def 'should be able to interpolate a running stub in the passed test property'() {
+        given:
+            int fraudPort = stubFinder.findAllRunningStubs().getPort("fraudDetectionServer")
+        expect:
+            fraudPort &gt; 0
+            environment.getProperty("foo", Integer) == fraudPort
+            environment.getProperty("fooWithGroup", Integer) == fraudPort
+            foo == fraudPort
+    }
+
+    @Issue("#573")
+    def 'should be able to retrieve the port of a running stub via an annotation'() {
+        given:
+            int fraudPort = stubFinder.findAllRunningStubs().getPort("fraudDetectionServer")
+        expect:
+            fraudPort &gt; 0
+            fraudDetectionServerPort == fraudPort
+            fraudDetectionServerPortWithGroupId == fraudPort
+    }
+
+    def 'should dump all mappings to a file'() {
+        when:
+            def url = stubFinder.findStubUrl("fraudDetectionServer")
+        then:
+            new File("target/outputmappings/", "fraudDetectionServer_${url.port}").exists()
+    }
+
+    @Configuration
+    @EnableAutoConfiguration
+    static class Config {}
+
+    @CompileStatic
+    static class HttpsForFraudDetection extends WireMockHttpServerStubConfigurer {
+
+        private static final Log log = LogFactory.getLog(HttpsForFraudDetection)
+
+        @Override
+        WireMockConfiguration configure(WireMockConfiguration httpStubConfiguration, HttpServerStubConfiguration httpServerStubConfiguration) {
+            if (httpServerStubConfiguration.stubConfiguration.artifactId == "fraudDetectionServer") {
+                int httpsPort = SocketUtils.findAvailableTcpPort()
+                log.info("Will set HTTPs port [" + httpsPort + "] for fraud detection server")
+                return httpStubConfiguration
+                        .httpsPort(httpsPort)
+            }
+            return httpStubConfiguration
+        }
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Doing so depends on the following configuration file:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">stubrunner:
+  repositoryRoot: classpath:m2repo/repository/
+  ids:
+    - org.springframework.cloud.contract.verifier.stubs:loanIssuance
+    - org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer
+    - org.springframework.cloud.contract.verifier.stubs:bootService
+  stubs-mode: remote</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Instead of using the properties, you can also use the properties inside the <code>@AutoConfigureStubRunner</code>.
+The following example achieves the same result by setting values on the annotation:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@AutoConfigureStubRunner(
+        ids = ["org.springframework.cloud.contract.verifier.stubs:loanIssuance",
+                "org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer",
+                "org.springframework.cloud.contract.verifier.stubs:bootService"],
+        stubsMode = StubRunnerProperties.StubsMode.REMOTE,
+        repositoryRoot = "classpath:m2repo/repository/")</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Stub Runner Spring registers environment variables in the following manner
+for every registered WireMock server. The following example shows Stub Runner IDs for
+<code>com.example:thing1</code> and <code>com.example:thing2</code>:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>stubrunner.runningstubs.thing1.port</code></p>
+</li>
+<li>
+<p><code>stubrunner.runningstubs.com.example.thing1.port</code></p>
+</li>
+<li>
+<p><code>stubrunner.runningstubs.thing2.port</code></p>
+</li>
+<li>
+<p><code>stubrunner.runningstubs.com.example.thing2.port</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>You can reference these values in your code.</p>
+</div>
+<div class="paragraph">
+<p>You can also use the <code>@StubRunnerPort</code> annotation to inject the port of a running stub.
+The value of the annotation can be the <code>groupid:artifactid</code> or just the <code>artifactid</code>.
+The following example works shows Stub Runner IDs for
+<code>com.example:thing1</code> and <code>com.example:thing2</code>.</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@StubRunnerPort("thing1")
+int thing1Port;
+@StubRunnerPort("com.example:thing2")
+int thing2Port;</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-stub-runner-cloud"><a class="anchor" href="#features-stub-runner-cloud"></a><a class="link" href="#features-stub-runner-cloud">5.5. Stub Runner Spring Cloud</a></h3>
+<div class="paragraph">
+<p>Stub Runner can integrate with Spring Cloud.</p>
+</div>
+<div class="paragraph">
+<p>For real life examples, see:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x/producer">The producer app sample</a></p>
+</li>
+<li>
+<p><a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x/consumer_with_discovery">The consumer app sample</a></p>
+</li>
+</ul>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-cloud-stubbing-discovery"><a class="anchor" href="#features-stub-runner-cloud-stubbing-discovery"></a><a class="link" href="#features-stub-runner-cloud-stubbing-discovery">5.5.1. Stubbing Service Discovery</a></h4>
+<div class="paragraph">
+<p>The most important feature of <code>Stub Runner Spring Cloud</code> is the fact that it stubs:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>DiscoveryClient</code></p>
+</li>
+<li>
+<p><code>Ribbon</code> <code>ServerList</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>That means that, regardless of whether you use Zookeeper, Consul, Eureka, or anything
+else, you do not need that in your tests. We are starting WireMock instances of your
+dependencies and we are telling your application, whenever you use <code>Feign</code>, to load a
+balanced <code>RestTemplate</code> or <code>DiscoveryClient</code> directly, to call those stubbed servers
+instead of calling the real Service Discovery tool.</p>
+</div>
+<div class="paragraph">
+<p>For example, the following test passes:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">def 'should make service discovery work'() {
+    expect: 'WireMocks are running'
+        "${stubFinder.findStubUrl('loanIssuance').toString()}/name".toURL().text == 'loanIssuance'
+        "${stubFinder.findStubUrl('fraudDetectionServer').toString()}/name".toURL().text == 'fraudDetectionServer'
+    and: 'Stubs can be reached via load service discovery'
+        restTemplate.getForObject('http://loanIssuance/name', String) == 'loanIssuance'
+        restTemplate.getForObject('http://someNameThatShouldMapFraudDetectionServer/name', String) == 'fraudDetectionServer'
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that the preceding example requires the following configuration file:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">stubrunner:
+  idsToServiceIds:
+    ivyNotation: someValueInsideYourCode
+    fraudDetectionServer: someNameThatShouldMapFraudDetectionServer</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-cloud-stubbing-profiles"><a class="anchor" href="#features-stub-runner-cloud-stubbing-profiles"></a><a class="link" href="#features-stub-runner-cloud-stubbing-profiles">Test Profiles and Service Discovery</a></h5>
+<div class="paragraph">
+<p>In your integration tests, you typically do not want to call either a discovery service (such as Eureka)
+or Config Server. That is why you create an additional test configuration in which you want to disable
+these features.</p>
+</div>
+<div class="paragraph">
+<p>Due to certain limitations of <a href="https://github.com/spring-cloud/spring-cloud-commons/issues/156"><code>spring-cloud-commons</code></a>,
+to achieve this, you have to disable these properties
+in a static block such as the following example (for Eureka):</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">    //Hack to work around https://github.com/spring-cloud/spring-cloud-commons/issues/156
+    static {
+        System.setProperty("eureka.client.enabled", "false");
+        System.setProperty("spring.cloud.config.failFast", "false");
+    }</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-additional-config"><a class="anchor" href="#features-stub-runner-additional-config"></a><a class="link" href="#features-stub-runner-additional-config">5.5.2. Additional Configuration</a></h4>
+<div class="paragraph">
+<p>You can match the <code>artifactId</code> of the stub with the name of your application by using the <code>stubrunner.idsToServiceIds:</code> map.
+You can disable Stub Runner Ribbon support by setting <code>stubrunner.cloud.ribbon.enabled</code> to <code>false</code>
+You can disable Stub Runner support by setting <code>stubrunner.cloud.enabled</code> to <code>false</code></p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+By default, all service discovery is stubbed. This means that, regardless of whether you have
+an existing <code>DiscoveryClient</code>, its results are ignored. However, if you want to reuse it, you can set
+ <code>stubrunner.cloud.delegate.enabled</code> to <code>true</code>, and then your existing <code>DiscoveryClient</code> results are
+ merged with the stubbed ones.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The default Maven configuration used by Stub Runner can be tweaked either
+by setting the following system properties or by setting the corresponding environment variables:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>maven.repo.local</code>: Path to the custom maven local repository location</p>
+</li>
+<li>
+<p><code>org.apache.maven.user-settings</code>: Path to custom maven user settings location</p>
+</li>
+<li>
+<p><code>org.apache.maven.global-settings</code>: Path to maven global settings location</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-stub-runner-boot"><a class="anchor" href="#features-stub-runner-boot"></a><a class="link" href="#features-stub-runner-boot">5.6. Using the Stub Runner Boot Application</a></h3>
+<div class="paragraph">
+<p>Spring Cloud Contract Stub Runner Boot is a Spring Boot application that exposes REST endpoints to
+trigger the messaging labels and to access WireMock servers.</p>
+</div>
+<div class="paragraph">
+<p>One of the use cases is to run some smoke (end-to-end) tests on a deployed application.
+You can check out the <a href="https://github.com/spring-cloud/spring-cloud-pipelines">Spring Cloud Pipelines</a>
+project for more information.</p>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-boot-server"><a class="anchor" href="#features-stub-runner-boot-server"></a><a class="link" href="#features-stub-runner-boot-server">Stub Runner Server</a></h5>
+<div class="paragraph">
+<p>To use the Stub Runner Server, add the following dependency:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">compile "org.springframework.cloud:spring-cloud-starter-stub-runner"</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Then annotate a class with <code>@EnableStubRunnerServer</code>, build a fat jar, and it is ready to work.</p>
+</div>
+<div class="paragraph">
+<p>For the properties, see the <a href="#features-stub-runner-rule-spring">Stub Runner Spring</a> section.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-boot-how-fat-jar"><a class="anchor" href="#features-stub-runner-boot-how-fat-jar"></a><a class="link" href="#features-stub-runner-boot-how-fat-jar">Stub Runner Server Fat Jar</a></h5>
+<div class="paragraph">
+<p>You can download a standalone JAR from Maven (for example, for version 2.0.1.RELEASE)
+by running the following commands:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ wget -O stub-runner.jar 'https://search.maven.org/remotecontent?filepath=org/springframework/cloud/spring-cloud-contract-stub-runner-boot/2.0.1.RELEASE/spring-cloud-contract-stub-runner-boot-2.0.1.RELEASE.jar'
+$ java -jar stub-runner.jar --stubrunner.ids=... --stubrunner.repositoryRoot=...</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-boot-how-cli"><a class="anchor" href="#features-stub-runner-boot-how-cli"></a><a class="link" href="#features-stub-runner-boot-how-cli">Spring Cloud CLI</a></h5>
+<div class="paragraph">
+<p>Starting from the <code>1.4.0.RELEASE</code> version of the <a href="https://cloud.spring.io/spring-cloud-cli">Spring Cloud CLI</a>
+project, you can start Stub Runner Boot by running <code>spring cloud stubrunner</code>.</p>
+</div>
+<div class="paragraph">
+<p>In order to pass the configuration, you can create a <code>stubrunner.yml</code> file in the current working directory,
+in a subdirectory called <code>config</code>, or in <code>~/.spring-cloud</code>. The file could resemble the following
+example for running stubs installed locally:</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 2. stubrunner.yml</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">stubrunner:
+  stubsMode: LOCAL
+  ids:
+    - com.example:beer-api-producer:+:9876</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Then you can call <code>spring cloud stubrunner</code> from your terminal window to start
+the Stub Runner server. It is available at port <code>8750</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-boot-endpoints"><a class="anchor" href="#features-stub-runner-boot-endpoints"></a><a class="link" href="#features-stub-runner-boot-endpoints">5.6.4. Endpoints</a></h4>
+<div class="paragraph">
+<p>Stub Runner Boot offers two endpoints:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#features-stub-runner-boot-endpoints-http">HTTP</a></p>
+</li>
+<li>
+<p><a href="#features-stub-runner-boot-endpoints-messaging">Messaging</a></p>
+</li>
+</ul>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-boot-endpoints-http"><a class="anchor" href="#features-stub-runner-boot-endpoints-http"></a><a class="link" href="#features-stub-runner-boot-endpoints-http">HTTP</a></h5>
+<div class="paragraph">
+<p>For HTTP, Stub Runner Boot makes the following endpoints available:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>GET <code>/stubs</code>: Returns a list of all running stubs in <code>ivy:integer</code> notation</p>
+</li>
+<li>
+<p>GET <code>/stubs/{ivy}</code>: Returns a port for the given <code>ivy</code> notation (when calling the endpoint <code>ivy</code> can also be <code>artifactId</code> only)</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-boot-endpoints-messaging"><a class="anchor" href="#features-stub-runner-boot-endpoints-messaging"></a><a class="link" href="#features-stub-runner-boot-endpoints-messaging">Messaging</a></h5>
+<div class="paragraph">
+<p>For Messaging, Stub Runner Boot makes the following endpoints available:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>GET <code>/triggers</code>: Returns a list of all running labels in <code>ivy : [ label1, label2 &#8230;&#8203;]</code> notation</p>
+</li>
+<li>
+<p>POST <code>/triggers/{label}</code>: Runs a trigger with <code>label</code></p>
+</li>
+<li>
+<p>POST <code>/triggers/{ivy}/{label}</code>: Runs a trigger with a <code>label</code> for the given <code>ivy</code> notation
+(when calling the endpoint, <code>ivy</code> can also be <code>artifactId</code> only)</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-boot-endpoints-example"><a class="anchor" href="#features-stub-runner-boot-endpoints-example"></a><a class="link" href="#features-stub-runner-boot-endpoints-example">5.6.5. Example</a></h4>
+<div class="paragraph">
+<p>The following example shows typical usage of Stub Runner Boot:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@ContextConfiguration(classes = StubRunnerBoot, loader = SpringBootContextLoader)
+@SpringBootTest(properties = "spring.cloud.zookeeper.enabled=false")
+@ActiveProfiles("test")
+class StubRunnerBootSpec extends Specification {
+
+    @Autowired
+    StubRunning stubRunning
+
+    def setup() {
+        RestAssuredMockMvc.standaloneSetup(new HttpStubsController(stubRunning),
+                new TriggerController(stubRunning))
+    }
+
+    def 'should return a list of running stub servers in "full ivy:port" notation'() {
+        when:
+            String response = RestAssuredMockMvc.get('/stubs').body.asString()
+        then:
+            def root = new JsonSlurper().parseText(response)
+            root.'org.springframework.cloud.contract.verifier.stubs:bootService:0.0.1-SNAPSHOT:stubs' instanceof Integer
+    }
+
+    def 'should return a port on which a [#stubId] stub is running'() {
+        when:
+            def response = RestAssuredMockMvc.get("/stubs/${stubId}")
+        then:
+            response.statusCode == 200
+            Integer.valueOf(response.body.asString()) &gt; 0
+        where:
+            stubId &lt;&lt; ['org.springframework.cloud.contract.verifier.stubs:bootService:+:stubs',
+                       'org.springframework.cloud.contract.verifier.stubs:bootService:0.0.1-SNAPSHOT:stubs',
+                       'org.springframework.cloud.contract.verifier.stubs:bootService:+',
+                       'org.springframework.cloud.contract.verifier.stubs:bootService',
+                       'bootService']
+    }
+
+    def 'should return 404 when missing stub was called'() {
+        when:
+            def response = RestAssuredMockMvc.get("/stubs/a:b:c:d")
+        then:
+            response.statusCode == 404
+    }
+
+    def 'should return a list of messaging labels that can be triggered when version and classifier are passed'() {
+        when:
+            String response = RestAssuredMockMvc.get('/triggers').body.asString()
+        then:
+            def root = new JsonSlurper().parseText(response)
+            root.'org.springframework.cloud.contract.verifier.stubs:bootService:0.0.1-SNAPSHOT:stubs'?.containsAll(["delete_book", "return_book_1", "return_book_2"])
+    }
+
+    def 'should trigger a messaging label'() {
+        given:
+            StubRunning stubRunning = Mock()
+            RestAssuredMockMvc.standaloneSetup(new HttpStubsController(stubRunning), new TriggerController(stubRunning))
+        when:
+            def response = RestAssuredMockMvc.post("/triggers/delete_book")
+        then:
+            response.statusCode == 200
+        and:
+            1 * stubRunning.trigger('delete_book')
+    }
+
+    def 'should trigger a messaging label for a stub with [#stubId] ivy notation'() {
+        given:
+            StubRunning stubRunning = Mock()
+            RestAssuredMockMvc.standaloneSetup(new HttpStubsController(stubRunning), new TriggerController(stubRunning))
+        when:
+            def response = RestAssuredMockMvc.post("/triggers/$stubId/delete_book")
+        then:
+            response.statusCode == 200
+        and:
+            1 * stubRunning.trigger(stubId, 'delete_book')
+        where:
+            stubId &lt;&lt; ['org.springframework.cloud.contract.verifier.stubs:bootService:stubs', 'org.springframework.cloud.contract.verifier.stubs:bootService', 'bootService']
+    }
+
+    def 'should throw exception when trigger is missing'() {
+        when:
+            RestAssuredMockMvc.post("/triggers/missing_label")
+        then:
+            Exception e = thrown(Exception)
+            e.message.contains("Exception occurred while trying to return [missing_label] label.")
+            e.message.contains("Available labels are")
+            e.message.contains("org.springframework.cloud.contract.verifier.stubs:loanIssuance:0.0.1-SNAPSHOT:stubs=[]")
+            e.message.contains("org.springframework.cloud.contract.verifier.stubs:bootService:0.0.1-SNAPSHOT:stubs=")
+    }
+
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-boot-service-discovery"><a class="anchor" href="#features-stub-runner-boot-service-discovery"></a><a class="link" href="#features-stub-runner-boot-service-discovery">5.6.6. Stub Runner Boot with Service Discovery</a></h4>
+<div class="paragraph">
+<p>One way to use Stub Runner Boot is to use it as a feed of stubs for &#8220;smoke tests&#8221;. What does that mean?
+Assume that you do not want to deploy 50 microservices to a test environment in order
+to see whether your application works. You have already executed a suite of tests during the build process,
+but you would also like to ensure that the packaging of your application works. You can
+deploy your application to an environment, start it, and run a couple of tests on it to see whether
+it works. We can call those tests &#8220;smoke tests&#8221;, because their purpose is to check only a handful
+of testing scenarios.</p>
+</div>
+<div class="paragraph">
+<p>The problem with this approach is thatm if you use microservices, you most likely also
+use a service discovery tool. Stub Runner Boot lets you solve this issue by starting the
+required stubs and registering them in a service discovery tool. Consider the following example of
+such a setup with Eureka (assume that Eureka is already running):</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@SpringBootApplication
+@EnableStubRunnerServer
+@EnableEurekaClient
+@AutoConfigureStubRunner
+public class StubRunnerBootEurekaExample {
+
+    public static void main(String[] args) {
+        SpringApplication.run(StubRunnerBootEurekaExample.class, args);
+    }
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>We want to start a Stub Runner Boot server (<code>@EnableStubRunnerServer</code>), enable the Eureka client (<code>@EnableEurekaClient</code>),
+and have the stub runner feature turned on (<code>@AutoConfigureStubRunner</code>).</p>
+</div>
+<div class="paragraph">
+<p>Now assume that we want to start this application so that the stubs get automatically registered.
+We can do so by running the application with <code>java -jar ${SYSTEM_PROPS} stub-runner-boot-eureka-example.jar</code>, where
+<code>${SYSTEM_PROPS}</code> contains the following list of properties:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">* -Dstubrunner.repositoryRoot=https://repo.spring.io/snapshot (1)
+* -Dstubrunner.cloud.stubbed.discovery.enabled=false (2)
+* -Dstubrunner.ids=org.springframework.cloud.contract.verifier.stubs:loanIssuance,org.
+* springframework.cloud.contract.verifier.stubs:fraudDetectionServer,org.springframework.
+* cloud.contract.verifier.stubs:bootService (3)
+* -Dstubrunner.idsToServiceIds.fraudDetectionServer=
+* someNameThatShouldMapFraudDetectionServer (4)
+*
+* (1) - we tell Stub Runner where all the stubs reside (2) - we don't want the default
+* behaviour where the discovery service is stubbed. That's why the stub registration will
+* be picked (3) - we provide a list of stubs to download (4) - we provide a list of</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>That way, your deployed application can send requests to started WireMock servers through service
+discovery. Most likely, points 1 through 3 could be set by default in <code>application.yml</code>, because they are not
+likely to change. That way, you can provide only the list of stubs to download whenever you start
+the Stub Runner Boot.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-stub-runner-stubs-per-consumer"><a class="anchor" href="#features-stub-runner-stubs-per-consumer"></a><a class="link" href="#features-stub-runner-stubs-per-consumer">5.7. Consumer-Driven Contracts: Stubs Per Consumer</a></h3>
+<div class="paragraph">
+<p>There are cases in which two consumers of the same endpoint want to have two different responses.</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+This approach also lets you immediately know which consumer uses which part of your API.
+You can remove part of a response that your API produces and see which of your autogenerated tests
+fails. If none fails, you can safely delete that part of the response, because nobody uses it.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Consider the following example of a contract defined for the producer called <code>producer</code>,
+which has two consumers (<code>foo-consumer</code> and <code>bar-consumer</code>):</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="title">Consumer <code>foo-service</code></div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">request {
+   url '/foo'
+   method GET()
+}
+response {
+    status OK()
+    body(
+       foo: "foo"
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="title">Consumer <code>bar-service</code></div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">request {
+   url '/bar'
+   method GET()
+}
+response {
+    status OK()
+    body(
+       bar: "bar"
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You cannot produce two different responses for the same request. That is why you can properly package the
+contracts and then profit from the <code>stubsPerConsumer</code> feature.</p>
+</div>
+<div class="paragraph">
+<p>On the producer side, the consumers can have a folder that contains contracts related only to them.
+By setting the <code>stubrunner.stubs-per-consumer</code> flag to <code>true</code>, we no longer register all stubs but only those that
+correspond to the consumer application&#8217;s name. In other words, we scan the path of every stub and,
+if it contains a subfolder with name of the consumer in the path, only then is it registered.</p>
+</div>
+<div class="paragraph">
+<p>On the <code>foo</code> producer side the contracts would look like this</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">.
+└── contracts
+    ├── bar-consumer
+    │   ├── bookReturnedForBar.groovy
+    │   └── shouldCallBar.groovy
+    └── foo-consumer
+        ├── bookReturnedForFoo.groovy
+        └── shouldCallFoo.groovy</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The <code>bar-consumer</code> consumer can either set the <code>spring.application.name</code> or the <code>stubrunner.consumer-name</code> to <code>bar-consumer</code>
+Alternatively, you can set the test as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@ContextConfiguration(classes = Config, loader = SpringBootContextLoader)
+@SpringBootTest(properties = ["spring.application.name=bar-consumer"])
+@AutoConfigureStubRunner(ids = "org.springframework.cloud.contract.verifier.stubs:producerWithMultipleConsumers",
+        repositoryRoot = "classpath:m2repo/repository/",
+        stubsMode = StubRunnerProperties.StubsMode.REMOTE,
+        stubsPerConsumer = true)
+class StubRunnerStubsPerConsumerSpec extends Specification {
+...
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Then only the stubs registered under a path that contains <code>bar-consumer</code> in its name (that is, those from the
+<code>src/test/resources/contracts/bar-consumer/some/contracts/&#8230;&#8203;</code> folder) are allowed to be referenced.</p>
+</div>
+<div class="paragraph">
+<p>You can also set the consumer name explicitly, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@ContextConfiguration(classes = Config, loader = SpringBootContextLoader)
+@SpringBootTest
+@AutoConfigureStubRunner(ids = "org.springframework.cloud.contract.verifier.stubs:producerWithMultipleConsumers",
+        repositoryRoot = "classpath:m2repo/repository/",
+        consumerName = "foo-consumer",
+        stubsMode = StubRunnerProperties.StubsMode.REMOTE,
+        stubsPerConsumer = true)
+class StubRunnerStubsPerConsumerWithConsumerNameSpec extends Specification {
+...
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Then only the stubs registered under a path that contains the <code>foo-consumer</code> in its name (that is, those from the
+<code>src/test/resources/contracts/foo-consumer/some/contracts/&#8230;&#8203;</code> folder) are allowed to be referenced.</p>
+</div>
+<div class="paragraph">
+<p>See <a href="https://github.com/spring-cloud/spring-cloud-contract/issues/224">issue 224</a> for more
+information about the reasons behind this change.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-stub-runner-stubs-protocol"><a class="anchor" href="#features-stub-runner-stubs-protocol"></a><a class="link" href="#features-stub-runner-stubs-protocol">5.8. Fetching Stubs or Contract Definitions From A Location</a></h3>
+<div class="paragraph">
+<p>Instead of picking the stubs or contract definitions from
+Artifactory / Nexus or Git, one can just want to point to
+a location on drive or classpath. This can be especially useful in a multimodule project, where one module wants
+to reuse stubs or contracts from another module without
+the need to actually install those in a local maven
+repository ot commit those changes to Git.</p>
+</div>
+<div class="paragraph">
+<p>In order to achieve this it&#8217;s enough to use the <code>stubs://</code>
+protocol when the repository root parameter is set either
+in Stub Runner or in a Spring Cloud Contract plugin.</p>
+</div>
+<div class="paragraph">
+<p>In this example the <code>producer</code> project has been successfully
+built and stubs were generated under the <code>target/stubs</code> folder. As a consumer one can setup the Stub Runner to pick the stubs from that location using the <code>stubs://</code> protocol.</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Annotation</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(
+stubsMode = StubRunnerProperties.StubsMode.REMOTE,
+        repositoryRoot = "stubs://file://location/to/the/producer/target/stubs/",
+        ids = "com.example:some-producer")</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 4 Rule</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Rule
+    public StubRunnerRule rule = new StubRunnerRule()
+            .downloadStub("com.example:some-producer")
+            .repoRoot("stubs://file://location/to/the/producer/target/stubs/")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE);</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 5 Extension</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RegisterExtension
+    public StubRunnerExtension stubRunnerExtension = new StubRunnerExtension()
+            .downloadStub("com.example:some-producer")
+            .repoRoot("stubs://file://location/to/the/producer/target/stubs/")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE);</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Contracts and stubs may be stored in a location, where each producer has its own, dedicated folder for contracts and stub mappings. Under that folder each consumer can have its own setup. To make Stub Runner find the dedicated folder from the provided ids one can pass a property <code>stubs.find-producer=true</code> or a system property <code>stubrunner.stubs.find-producer=true</code> .</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="paragraph">
+<p>└── com.example &lt;1&gt;
+    ├── some-artifact-id &lt;2&gt;
+    │   └── 0.0.1
+    │       ├── contracts &lt;3&gt;
+    │       │   └── shouldReturnStuffForArtifactId.groovy
+    │       └── mappings &lt;4&gt;
+    │           └── shouldReturnStuffForArtifactId.json
+    └── some-other-artifact-id &lt;5&gt;
+        ├── contracts
+        │   └── shouldReturnStuffForOtherArtifactId.groovy
+        └── mappings
+            └── shouldReturnStuffForOtherArtifactId.json</p>
+</div>
+</div>
+</div>
+<div class="colist arabic">
+<table>
+<tr>
+<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>group id of the consumers</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="2"></i><b>2</b></td>
+<td>consumer with artifact id [some-artifact-id]</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="3"></i><b>3</b></td>
+<td>contracts for the consumer with artifact id [some-artifact-id]</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="4"></i><b>4</b></td>
+<td>mappings for the consumer with artifact id [some-artifact-id]</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="5"></i><b>5</b></td>
+<td>consumer with artifact id [some-other-artifact-id]</td>
+</tr>
+</table>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Annotation</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(
+stubsMode = StubRunnerProperties.StubsMode.REMOTE,
+        repositoryRoot = "stubs://file://location/to/the/contracts/directory",
+        ids = "com.example:some-producer",
+        properties="stubs.find-producer=true")</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 4 Rule</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">    static Map&lt;String, String&gt; contractProperties() {
+        Map&lt;String, String&gt; map = new HashMap&lt;&gt;();
+        map.put("stubs.find-producer", "true");
+        return map;
+    }
+
+@Rule
+    public StubRunnerRule rule = new StubRunnerRule()
+            .downloadStub("com.example:some-producer")
+            .repoRoot("stubs://file://location/to/the/contracts/directory")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+            .properties(contractProperties());</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 5 Extension</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">    static Map&lt;String, String&gt; contractProperties() {
+        Map&lt;String, String&gt; map = new HashMap&lt;&gt;();
+        map.put("stubs.find-producer", "true");
+        return map;
+    }
+
+@RegisterExtension
+    public StubRunnerExtension stubRunnerExtension = new StubRunnerExtension()
+            .downloadStub("com.example:some-producer")
+            .repoRoot("stubs://file://location/to/the/contracts/directory")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+            .properties(contractProperties());</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-stub-runner-generate-stubs-at-runtime"><a class="anchor" href="#features-stub-runner-generate-stubs-at-runtime"></a><a class="link" href="#features-stub-runner-generate-stubs-at-runtime">5.9. Generating Stubs at Runtime</a></h3>
+<div class="paragraph">
+<p>As a consumer, you might not want to wait for the producer to finish its implementation and then publish their stubs. A solution to this problem can be generation of stubs at runtime.</p>
+</div>
+<div class="paragraph">
+<p>As a producer, when a contract is defined, you are required to make the generated tests pass in order for the stubs to be published. There are cases where you would like to unblock the consumers so that they can fetch the stubs before your tests are actually passing. In this case you should set such contracts as in progress. You can read more about this under the <a href="#contract-dsl-in-progress">Contracts in Progress</a> section. That way your tests will not be generated, but the stubs will.</p>
+</div>
+<div class="paragraph">
+<p>As a consumer, you can toggle a switch to generate stubs at runtime. Stub Runner will ignore all the existing stub mappings and will generate new ones for all the contract definitions. Another option is to pass the <code>stubrunner.generate-stubs</code> system property. Below you can find an example of such setup.</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Annotation</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(
+stubsMode = StubRunnerProperties.StubsMode.REMOTE,
+        repositoryRoot = "stubs://file://location/to/the/contracts",
+        ids = "com.example:some-producer",
+        generateStubs = true)</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 4 Rule</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Rule
+    public StubRunnerRule rule = new StubRunnerRule()
+            .downloadStub("com.example:some-producer")
+            .repoRoot("stubs://file://location/to/the/contracts")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+            .withGenerateStubs(true);</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 5 Extension</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RegisterExtension
+    public StubRunnerExtension stubRunnerExtension = new StubRunnerExtension()
+            .downloadStub("com.example:some-producer")
+            .repoRoot("stubs://file://location/to/the/contracts")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+            .withGenerateStubs(true);</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-stub-runner-fail-on-no-stubs"><a class="anchor" href="#features-stub-runner-fail-on-no-stubs"></a><a class="link" href="#features-stub-runner-fail-on-no-stubs">5.10. Fail On No Stubs</a></h3>
+<div class="paragraph">
+<p>By default Stub Runner will fail if no stubs were found. In order to change that behaviour, just set to <code>false</code> the <code>failOnNoStubs</code> property in the annotation or call the <code>withFailOnNoStubs(false)</code> method on a JUnit Rule or Extension.</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Annotation</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(
+stubsMode = StubRunnerProperties.StubsMode.REMOTE,
+        repositoryRoot = "stubs://file://location/to/the/contracts",
+        ids = "com.example:some-producer",
+        failOnNoStubs = false)</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 4 Rule</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Rule
+    public StubRunnerRule rule = new StubRunnerRule()
+            .downloadStub("com.example:some-producer")
+            .repoRoot("stubs://file://location/to/the/contracts")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+            .withFailOnNoStubs(false);</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 5 Extension</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RegisterExtension
+    public StubRunnerExtension stubRunnerExtension = new StubRunnerExtension()
+            .downloadStub("com.example:some-producer")
+            .repoRoot("stubs://file://location/to/the/contracts")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+            .withFailOnNoStubs(false);</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-stub-runner-common"><a class="anchor" href="#features-stub-runner-common"></a><a class="link" href="#features-stub-runner-common">5.11. Common Properties</a></h3>
+<div class="paragraph">
+<p>This section briefly describes common properties, including:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#features-stub-runner-common-properties-junit-spring">Common Properties for JUnit and Spring</a></p>
+</li>
+<li>
+<p><a href="#features-stub-runner-stub-runner-stub-ids">Stub Runner Stubs IDs</a></p>
+</li>
+</ul>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-common-properties-junit-spring"><a class="anchor" href="#features-stub-runner-common-properties-junit-spring"></a><a class="link" href="#features-stub-runner-common-properties-junit-spring">5.11.1. Common Properties for JUnit and Spring</a></h4>
+<div class="paragraph">
+<p>You can set repetitive properties by using system properties or Spring configuration
+properties. The following table shows their names with their default values:</p>
+</div>
+<table class="tableblock frame-topbot grid-all stretch">
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Property name</th>
+<th class="tableblock halign-left valign-top">Default value</th>
+<th class="tableblock halign-left valign-top">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.minPort</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">10000</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Minimum value of a port for a started WireMock with stubs.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.maxPort</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">15000</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Maximum value of a port for a started WireMock with stubs.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.repositoryRoot</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Maven repo URL. If blank, then call the local Maven repo.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.classifier</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubs</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Default classifier for the stub artifacts.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.stubsMode</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">CLASSPATH</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The way you want to fetch and register the stubs</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.ids</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Ivy notation stubs to download.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.username</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Optional username to access the tool that stores the JARs with
+stubs.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.password</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Optional password to access the tool that stores the JARs with
+stubs.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.stubsPerConsumer</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>false</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Set to <code>true</code> if you want to use different stubs for
+each consumer instead of registering all stubs for every consumer.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.consumerName</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">If you want to use a stub for each consumer and want to
+override the consumer name, change this value.</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-stub-runner-stub-ids"><a class="anchor" href="#features-stub-runner-stub-runner-stub-ids"></a><a class="link" href="#features-stub-runner-stub-runner-stub-ids">5.11.2. Stub Runner Stubs IDs</a></h4>
+<div class="paragraph">
+<p>You can set the stubs to download in the <code>stubrunner.ids</code> system property. They
+use the following pattern:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">groupId:artifactId:version:classifier:port</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that <code>version</code>, <code>classifier</code>, and <code>port</code> are optional.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>If you do not provide the <code>port</code>, a random one is picked.</p>
+</li>
+<li>
+<p>If you do not provide the <code>classifier</code>, the default is used. (Note that you can
+pass an empty classifier this way: <code>groupId:artifactId:version:</code>).</p>
+</li>
+<li>
+<p>If you do not provide the <code>version</code>, then <code>+</code> is passed, and the latest one is
+downloaded.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p><code>port</code> means the port of the WireMock server.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Starting with version 1.0.4, you can provide a range of versions that you
+would like the Stub Runner to take into consideration. You can read more about the
+<a href="https://wiki.eclipse.org/Aether/New_and_Noteworthy#Version_Ranges">Aether versioning
+ranges here</a>.
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="features-wiremock"><a class="anchor" href="#features-wiremock"></a><a class="link" href="#features-wiremock">6. Spring Cloud Contract WireMock</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The Spring Cloud Contract WireMock modules let you use <a href="https://github.com/tomakehurst/wiremock">WireMock</a> in a
+Spring Boot application. Check out the
+<a href="https://github.com/spring-cloud/spring-cloud-contract/tree/{branch}/samples">samples</a>
+for more details.</p>
+</div>
+<div class="paragraph">
+<p>If you have a Spring Boot application that uses Tomcat as an embedded server (which is
+the default with <code>spring-boot-starter-web</code>), you can add
+<code>spring-cloud-starter-contract-stub-runner</code> to your classpath and add <code>@AutoConfigureWireMock</code>
+to use Wiremock in your tests. Wiremock runs as a stub server, and you
+can register stub behavior by using a Java API or by using static JSON declarations as part of
+your test. The following code shows an example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT)
+@AutoConfigureWireMock(port = 0)
+public class WiremockForDocsTests {
+
+    // A service that calls out over HTTP
+    @Autowired
+    private Service service;
+
+    @Before
+    public void setup() {
+        this.service.setBase("http://localhost:"
+                + this.environment.getProperty("wiremock.server.port"));
+    }
+
+    // Using the WireMock APIs in the normal way:
+    @Test
+    public void contextLoads() throws Exception {
+        // Stubbing WireMock
+        stubFor(get(urlEqualTo("/resource")).willReturn(aResponse()
+                .withHeader("Content-Type", "text/plain").withBody("Hello World!")));
+        // We're asserting if WireMock responded properly
+        assertThat(this.service.go()).isEqualTo("Hello World!");
+    }
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>To start the stub server on a different port, use (for example),
+<code>@AutoConfigureWireMock(port=9999)</code>. For a random port, use a value of <code>0</code>. The stub
+server port can be bound in the test application context with the "wiremock.server.port"
+property. Using <code>@AutoConfigureWireMock</code> adds a bean of type <code>WiremockConfiguration</code> to
+your test application context, where it is cached between methods and classes
+having the same context. The same is true for Spring integration tests. Also, you can
+inject a bean of type <code>WireMockServer</code> into your test.</p>
+</div>
+<div class="sect2">
+<h3 id="features-wiremock-registering-stubs"><a class="anchor" href="#features-wiremock-registering-stubs"></a><a class="link" href="#features-wiremock-registering-stubs">6.1. Registering Stubs Automatically</a></h3>
+<div class="paragraph">
+<p>If you use <code>@AutoConfigureWireMock</code>, it registers WireMock JSON stubs from the file
+system or classpath (by default, from <code>file:src/test/resources/mappings</code>). You can
+customize the locations byusing the <code>stubs</code> attribute in the annotation, which can be an
+Ant-style resource pattern or a directory. In the case of a directory, <code><strong>*/</strong>.json</code> is
+appended. The following code shows an example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre>@RunWith(SpringRunner.class)
+@SpringBootTest
+@AutoConfigureWireMock(stubs="classpath:/stubs")
+public class WiremockImportApplicationTests {
+
+    @Autowired
+    private Service service;
+
+    @Test
+    public void contextLoads() throws Exception {
+        assertThat(this.service.go()).isEqualTo("Hello World!");
+    }
+
+}</pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+Actually, WireMock always loads mappings from <code>src/test/resources/mappings</code> <strong>as
+well as</strong> the custom locations in the <code>stubs</code> attribute. To change this behavior, you can
+also specify a files root, as described in the next section of this document.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>If you use Spring Cloud Contract&#8217;s default stub jars, your
+stubs are stored in the <code>/META-INF/group-id/artifact-id/versions/mappings/</code> folder.
+If you want to register all stubs from that location, from all embedded JARs, you can use
+the following syntax:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureWireMock(port = 0, stubs = "classpath*:/META-INF/**/mappings/**/*.json")</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-wiremock-using-files"><a class="anchor" href="#features-wiremock-using-files"></a><a class="link" href="#features-wiremock-using-files">6.2. Using Files to Specify the Stub Bodies</a></h3>
+<div class="paragraph">
+<p>WireMock can read response bodies from files on the classpath or the file system. In the
+case of the file system, you can see in the JSON DSL that the response has a <code>bodyFileName</code> instead of a
+(literal) <code>body</code>. The files are resolved relative to a root directory (by default,
+<code>src/test/resources/__files</code>). To customize this location, you can set the <code>files</code>
+attribute in the <code>@AutoConfigureWireMock</code> annotation to the location of the parent
+directory (in other words, <code>__files</code> is a subdirectory). You can use Spring resource
+notation to refer to <code>file:&#8230;&#8203;</code> or <code>classpath:&#8230;&#8203;</code> locations. Generic URLs are not
+supported. A list of values can be given&#8201;&#8212;&#8201;in which case, WireMock resolves the first file
+that exists when it needs to find a response body.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+When you configure the <code>files</code> root, it also affects the
+automatic loading of stubs, because they come from the root location
+in a subdirectory called <code>mappings</code>. The value of <code>files</code> has no
+effect on the stubs loaded explicitly from the <code>stubs</code> attribute.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-wiremock-junit-rule"><a class="anchor" href="#features-wiremock-junit-rule"></a><a class="link" href="#features-wiremock-junit-rule">6.3. Alternative: Using JUnit Rules</a></h3>
+<div class="paragraph">
+<p>For a more conventional WireMock experience, you can use JUnit <code>@Rules</code> to start and stop
+the server. To do so, use the <code>WireMockSpring</code> convenience class to obtain an <code>Options</code>
+instance, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT)
+public class WiremockForDocsClassRuleTests {
+
+    // Start WireMock on some dynamic port
+    // for some reason `dynamicPort()` is not working properly
+    @ClassRule
+    public static WireMockClassRule wiremock = new WireMockClassRule(
+            WireMockSpring.options().dynamicPort());
+
+    // A service that calls out over HTTP to wiremock's port
+    @Autowired
+    private Service service;
+
+    @Before
+    public void setup() {
+        this.service.setBase("http://localhost:" + wiremock.port());
+    }
+
+    // Using the WireMock APIs in the normal way:
+    @Test
+    public void contextLoads() throws Exception {
+        // Stubbing WireMock
+        wiremock.stubFor(get(urlEqualTo("/resource")).willReturn(aResponse()
+                .withHeader("Content-Type", "text/plain").withBody("Hello World!")));
+        // We're asserting if WireMock responded properly
+        assertThat(this.service.go()).isEqualTo("Hello World!");
+    }
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The <code>@ClassRule</code> means that the server shuts down after all the methods in this class
+have been run.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-wiremock-relaxed-ssl"><a class="anchor" href="#features-wiremock-relaxed-ssl"></a><a class="link" href="#features-wiremock-relaxed-ssl">6.4. Relaxed SSL Validation for Rest Template</a></h3>
+<div class="paragraph">
+<p>WireMock lets you stub a &#8220;secure&#8221; server with an <code>https</code> URL protocol. If your
+application wants to contact that stub server in an integration test, it will find that
+the SSL certificates are not valid (the usual problem with self-installed certificates).
+The best option is often to re-configure the client to use <code>http</code>. If that is not an
+option, you can ask Spring to configure an HTTP client that ignores SSL validation errors
+(do so only for tests, of course).</p>
+</div>
+<div class="paragraph">
+<p>To make this work with minimum fuss, you need to use the Spring Boot
+<code>RestTemplateBuilder</code> in your application, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Bean
+public RestTemplate restTemplate(RestTemplateBuilder builder) {
+    return builder.build();
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You need <code>RestTemplateBuilder</code> because the builder is passed through callbacks to
+initialize it, so the SSL validation can be set up in the client at that point. This
+happens automatically in your test if you use the <code>@AutoConfigureWireMock</code>
+annotation or the stub runner. If you use the JUnit <code>@Rule</code> approach, you need to add the
+<code>@AutoConfigureHttpClient</code> annotation as well, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
+@SpringBootTest("app.baseUrl=https://localhost:6443")
+@AutoConfigureHttpClient
+public class WiremockHttpsServerApplicationTests {
+
+    @ClassRule
+    public static WireMockClassRule wiremock = new WireMockClassRule(
+            WireMockSpring.options().httpsPort(6443));
+...
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>If you use <code>spring-boot-starter-test</code>, you have the Apache HTTP client on the
+classpath, and it is selected by the <code>RestTemplateBuilder</code> and configured to ignore SSL
+errors. If you use the default <code>java.net</code> client, you do not need the annotation (but it
+does no harm). There is currently no support for other clients, but it may be added
+in future releases.</p>
+</div>
+<div class="paragraph">
+<p>To disable the custom <code>RestTemplateBuilder</code>, set the <code>wiremock.rest-template-ssl-enabled</code>
+property to <code>false</code>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-wiremock-spring-mvc-mocks"><a class="anchor" href="#features-wiremock-spring-mvc-mocks"></a><a class="link" href="#features-wiremock-spring-mvc-mocks">6.5. WireMock and Spring MVC Mocks</a></h3>
+<div class="paragraph">
+<p>Spring Cloud Contract provides a convenience class that can load JSON WireMock stubs into
+a Spring <code>MockRestServiceServer</code>. The following code shows an example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment = WebEnvironment.NONE)
+public class WiremockForDocsMockServerApplicationTests {
+
+    @Autowired
+    private RestTemplate restTemplate;
+
+    @Autowired
+    private Service service;
+
+    @Test
+    public void contextLoads() throws Exception {
+        // will read stubs classpath
+        MockRestServiceServer server = WireMockRestServiceServer.with(this.restTemplate)
+                .baseUrl("https://example.org").stubs("classpath:/stubs/resource.json")
+                .build();
+        // We're asserting if WireMock responded properly
+        assertThat(this.service.go()).isEqualTo("Hello World");
+        server.verify();
+    }
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The <code>baseUrl</code> value is prepended to all mock calls, and the <code>stubs()</code> method takes a stub
+path resource pattern as an argument. In the preceding example, the stub defined at
+<code>/stubs/resource.json</code> is loaded into the mock server. If the <code>RestTemplate</code> is asked to
+visit <code><a href="https://example.org/" class="bare">example.org/</a></code>, it gets the responses as being declared at that URL. More
+than one stub pattern can be specified, and each one can be a directory (for a recursive
+list of all <code>.json</code>), a fixed filename (as in the preceding example), or an Ant-style
+pattern. The JSON format is the normal WireMock format, which you can read about at the
+<a href="https://wiremock.org/docs/stubbing/">WireMock website</a>.</p>
+</div>
+<div class="paragraph">
+<p>Currently, the Spring Cloud Contract Verifier supports Tomcat, Jetty, and Undertow as
+Spring Boot embedded servers, and Wiremock itself has &#8220;native&#8221; support for a particular
+version of Jetty (currently 9.2). To use the native Jetty, you need to add the native
+Wiremock dependencies and exclude the Spring Boot container (if there is one).</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="features-build-tools"><a class="anchor" href="#features-build-tools"></a><a class="link" href="#features-build-tools">7. Build Tools Integration</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>You can run test generation and stub execution in various ways. The most common ones are
+as follows:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="maven-project.html">Maven</a></p>
+</li>
+<li>
+<p><a href="gradle-project.html">Gradle</a></p>
+</li>
+<li>
+<p><a href="docker-project.html">Docker</a></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="features-whats-next"><a class="anchor" href="#features-whats-next"></a><a class="link" href="#features-whats-next">8. What to Read Next</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>If you want to learn more about any of the classes discussed in this section, you can browse the
+<a href="https://github.com/spring-cloud/spring-cloud-contract/tree/${github-tag}">source code directly</a>. If you have specific questions, see the
+<a href="howto.html#howto">how-to</a> section.</p>
+</div>
+<div class="paragraph">
+<p>If you are comfortable with Spring Cloud Contract&#8217;s core features, you can continue on and read
+about
+<a href="#advanced.adoc">Spring Cloud Contract&#8217;s advanced features</a>.</p>
+</div>
+</div>
+</div>
+</div>
+<script type="text/javascript" src="js/tocbot/tocbot.min.js"></script>
+<script type="text/javascript" src="js/toc.js"></script>
+<link rel="stylesheet" href="js/highlight/styles/atom-one-dark-reasonable.min.css">
+<script src="js/highlight/highlight.min.js"></script>
+<script>hljs.initHighlighting()</script>
+</body>
+</html>
\ No newline at end of file
diff --git a/reference/html/sagan-boot.html b/reference/html/sagan-boot.html
index f35bb626fc..3a3428ba01 100644
--- a/reference/html/sagan-boot.html
+++ b/reference/html/sagan-boot.html
@@ -5,7 +5,7 @@
 <!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <meta name="generator" content="Asciidoctor 1.5.7.1">
-<title>Untitled</title>
+<title>Adding Sleuth to Your Classpath:</title>
 <link rel="stylesheet" href="css/spring.css">
 <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css">
 
@@ -90,18 +90,35 @@ $(addBlockSwitches);
 </script>
 
 </head>
-<body class="book">
+<body class="book toc2 toc-left">
 <div id="header">
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="#_adding_sleuth_to_your_classpath">Adding Sleuth to Your Classpath:</a>
+<ul class="sectlevel2">
+<li><a href="#_maven">Maven</a></li>
+<li><a href="#_gradle">Gradle</a></li>
+</ul>
+</li>
+</ul>
+</div>
 </div>
 <div id="content">
-<div id="preamble">
+<div class="sect1">
+<h2 id="_adding_sleuth_to_your_classpath"><a class="link" href="#_adding_sleuth_to_your_classpath">Adding Sleuth to Your Classpath:</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
-<p>Add Sleuth to your classpath:</p>
+<p>This section details how to add Sleuth to your class path for both Maven and Gradle</p>
 </div>
+<div class="sect2">
+<h3 id="_maven"><a class="link" href="#_maven">Maven</a></h3>
 <div class="paragraph">
-<p>Maven</p>
+<p>To add Sleuth to your classpath with Maven, add the following elements
+to your <code>pom.xml</code> file:</p>
 </div>
+<div class="exampleblock">
+<div class="content">
 <div class="listingblock">
 <div class="content">
 <pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependencyManagement&gt;
@@ -123,12 +140,20 @@ $(addBlockSwitches);
 &lt;/dependencies&gt;</code></pre>
 </div>
 </div>
-<div class="paragraph">
-<p>Gradle</p>
 </div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_gradle"><a class="link" href="#_gradle">Gradle</a></h3>
+<div class="paragraph">
+<p>To add Sleuth to your classpath with Gradle, add the following
+to your <code>build.gradle</code> file:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
 <div class="listingblock">
 <div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">buildscript {
+<pre>buildscript {
     dependencies {
         classpath "io.spring.gradle:dependency-management-plugin:0.5.2.RELEASE"
     }
@@ -143,15 +168,20 @@ dependencyManagement {
 }
 dependencies {
     compile 'org.springframework.cloud:spring-cloud-starter-sleuth'
-}</code></pre>
+}</pre>
+</div>
+</div>
 </div>
 </div>
 <div class="paragraph">
-<p>As long as Spring Cloud Sleuth is on the classpath any Spring Boot application will generate trace data:</p>
+<p>As long as Spring Cloud Sleuth is on the classpath, any Spring Boot application can
+generate trace data. The following example shows how to do so:</p>
 </div>
+<div class="exampleblock">
+<div class="content">
 <div class="listingblock">
 <div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@SpringBootApplication
+<pre>@SpringBootApplication
 @RestController
 public class Application {
 
@@ -167,11 +197,16 @@ public class Application {
     SpringApplication.run(Application.class, args);
   }
 
-}</code></pre>
+}</pre>
+</div>
+</div>
 </div>
 </div>
 <div class="paragraph">
-<p>Run this app and then hit the home page. You will see traceId and spanId populated in the logs. If this app calls out to another one (e.g. with <code>RestTemplate</code>) it will send the trace data in headers and if the receiver is another Sleuth app you will see the trace continue there.</p>
+<p>Now you can run this application and visit the home page. In the logs, you can see
+<code>traceId</code> and <code>spanId</code> populated. If this application calls out to another one (for
+example, with <code>RestTemplate</code>), it sends the trace data in headers, and, if the receiver is
+another Sleuth application, you can see the trace continue there.</p>
 </div>
 <div class="admonitionblock important">
 <table>
@@ -180,7 +215,8 @@ public class Application {
 <i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
-instead of logging the request in the handler explicitly, you could set <code>logging.level.org.springframework.web.servlet.DispatcherServlet=DEBUG</code>
+instead of logging the request in the handler explicitly, you could set
+<code>logging.level.org.springframework.web.servlet.DispatcherServlet=DEBUG</code>
 </td>
 </tr>
 </table>
@@ -192,7 +228,10 @@ instead of logging the request in the handler explicitly, you could set <code>lo
 <i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
-If you use Zipkin, configure the probability of spans exported by setting (for <code>2.0.x</code>) <code>spring.sleuth.sampler.probability</code> or (up till <code>2.0.x</code>)<code>spring.sleuth.sampler.percentage</code> (default: 0.1, which is 10 percent). Otherwise, you might think that Sleuth is not working because it omits some spans.
+If you use Zipkin, you can configure the probability of spans being exported by
+setting (for <code>2.0.x</code>) <code>spring.sleuth.sampler.probability</code> or (up till <code>2.0.x</code>)
+<code>spring.sleuth.sampler.percentage</code> (default: 0.1, which is 10 percent). Otherwise, you
+might think that Sleuth is not working because it omits some spans.
 </td>
 </tr>
 </table>
@@ -204,7 +243,8 @@ If you use Zipkin, configure the probability of spans exported by setting (for <
 <i class="fa icon-important" title="Important"></i>
 </td>
 <td class="content">
-Set <code>spring.application.name=bar</code> (for instance) to see the service name as well as the trace and span ids.
+Set <code>spring.application.name=bar</code> (for instance) to see the service name as
+well as the trace and span IDs.
 </td>
 </tr>
 </table>
@@ -212,6 +252,7 @@ Set <code>spring.application.name=bar</code> (for instance) to see the service n
 </div>
 </div>
 </div>
+</div>
 <script type="text/javascript" src="js/tocbot/tocbot.min.js"></script>
 <script type="text/javascript" src="js/toc.js"></script>
 <link rel="stylesheet" href="js/highlight/styles/atom-one-dark-reasonable.min.css">
diff --git a/reference/html/sagan-index.html b/reference/html/sagan-index.html
index 2a8d4f86af..186f857e20 100644
--- a/reference/html/sagan-index.html
+++ b/reference/html/sagan-index.html
@@ -103,7 +103,11 @@ $(addBlockSwitches);
 <div id="preamble">
 <div class="sectionbody">
 <div class="paragraph">
-<p>Spring Cloud Sleuth implements a distributed tracing solution for Spring Cloud, borrowing heavily from <a href="https://research.google.com/pubs/pub36356.html">Dapper</a>, <a href="https://github.com/openzipkin/zipkin">Zipkin</a> and HTrace. For most users Sleuth should be invisible, and all your interactions with external systems should be instrumented automatically. You can capture data simply in logs, or by sending it to a remote collector service.</p>
+<p>Spring Cloud Sleuth implements a distributed tracing solution for Spring Cloud, borrowing
+heavily from <a href="https://research.google.com/pubs/pub36356.html">Dapper</a>,
+<a href="https://github.com/openzipkin/zipkin">Zipkin</a>, and HTrace. For most users, Sleuth should be
+invisible, and all your interactions with external systems should be instrumented
+automatically. You can capture data in logs or by sending it to a remote collector service.</p>
 </div>
 </div>
 </div>
@@ -111,24 +115,38 @@ $(addBlockSwitches);
 <h2 id="_features"><a class="link" href="#_features">Features</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
-<p>A Span is the basic unit of work. For example, sending an RPC is a new span, as is sending a response to an RPC. Span’s are identified by a unique 64-bit ID for the span and another 64-bit ID for the trace the span is a part of. Spans also have other data, such as descriptions, key-value annotations, the ID of the span that caused them, and process ID’s (normally IP address). Spans are started and stopped, and they keep track of their timing information. Once you create a span, you must stop it at some point in the future. A set of spans forming a tree-like structure called a Trace. For example, if you are running a distributed big-data store, a trace might be formed by a put request.</p>
+<p>A span is the basic unit of work. For example, sending an RPC is a new span, as is sending
+a response to an RPC. Spans are identified by a unique 64-bit ID for the span and another
+64-bit ID for the trace of which the span is a part. Spans also have other data, such as
+descriptions, key-value annotations, the ID of the span that caused them, and process IDs
+(normally IP addresses). Spans are started and stopped, and they keep track of their
+timing information. Once you create a span, you must stop it at some point in the future.
+A set of spans (which form a tree-like structure) is called a trace. For example, if you
+run a distributed big-data store, a trace might be formed by a <code>PUT</code> request.</p>
 </div>
 <div class="paragraph">
-<p>Spring Cloud Sleuth features:</p>
+<p>Spring Cloud Sleuth:</p>
 </div>
 <div class="ulist">
 <ul>
 <li>
-<p>Adds trace and span ids to the Slf4J MDC, so you can extract all the logs from a given trace or span in a log aggregator.</p>
+<p>Adds trace and span IDs to the Slf4J MDC so that you can extract all the logs from a
+given trace or span in a log aggregator.</p>
 </li>
 <li>
-<p>Provides an abstraction over common distributed tracing data models: traces, spans (forming a DAG), annotations, key-value annotations. Loosely based on HTrace, but Zipkin (Dapper) compatible.</p>
+<p>Provides an abstraction over common distributed tracing data models: traces, spans
+(forming a DAG), annotations, and key-value annotations. This is loosely based on HTrace
+but is Zipkin (Dapper) compatible.</p>
 </li>
 <li>
-<p>Instruments common ingress and egress points from Spring applications (servlet filter, rest template, scheduled actions, message channels, zuul filters, feign client).</p>
+<p>Instruments common ingress and egress points from Spring applications (servlet filter,
+rest template, scheduled actions, message channels, zuul filters, and the feign client).</p>
 </li>
 <li>
-<p>If <code>spring-cloud-sleuth-zipkin</code> is available then the app will generate and collect Zipkin-compatible traces via HTTP. By default it sends them to a Zipkin collector service on localhost (port 9411). Configure the location of the service using <code>spring.zipkin.baseUrl</code>.</p>
+<p>If <code>spring-cloud-sleuth-zipkin</code> is available, the app generates and collects
+Zipkin-compatible traces over HTTP. By default, it sends them to a Zipkin collector
+service on localhost (port 9411). You can configure the location of the service using
+<code>spring.zipkin.baseUrl</code>.</p>
 </li>
 </ul>
 </div>
diff --git a/reference/html/using.html b/reference/html/using.html
new file mode 100644
index 0000000000..4fa59dbe2d
--- /dev/null
+++ b/reference/html/using.html
@@ -0,0 +1,1217 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.7.1">
+<title>Using Spring Cloud Contract</title>
+<link rel="stylesheet" href="css/spring.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css">
+
+<style>
+.hidden {
+	display: none;
+}
+
+.switch {
+	border-width: 1px 1px 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+	display: inline-block;
+}
+
+.switch--item {
+	padding: 10px;
+	background-color: #ffffff;
+	color: #7a2518;
+	display: inline-block;
+	cursor: pointer;
+}
+
+.switch--item:not(:first-child) {
+	border-width: 0 0 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+}
+
+.switch--item.selected {
+	background-color: #7a2519;
+	color: #ffffff;
+}
+</style>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/zepto/1.2.0/zepto.min.js"></script>
+<script type="text/javascript">
+function addBlockSwitches() {
+	$('.primary').each(function() {
+		primary = $(this);
+		createSwitchItem(primary, createBlockSwitch(primary)).item.addClass("selected");
+		primary.children('.title').remove();
+	});
+	$('.secondary').each(function(idx, node) {
+		secondary = $(node);
+		primary = findPrimary(secondary);
+		switchItem = createSwitchItem(secondary, primary.children('.switch'));
+		switchItem.content.addClass('hidden');
+		findPrimary(secondary).append(switchItem.content);
+		secondary.remove();
+	});
+}
+
+function createBlockSwitch(primary) {
+	blockSwitch = $('<div class="switch"></div>');
+	primary.prepend(blockSwitch);
+	return blockSwitch;
+}
+
+function findPrimary(secondary) {
+	candidate = secondary.prev();
+	while (!candidate.is('.primary')) {
+		candidate = candidate.prev();
+	}
+	return candidate;
+}
+
+function createSwitchItem(block, blockSwitch) {
+	blockName = block.children('.title').text();
+	content = block.children('.content').first().append(block.next('.colist'));
+	item = $('<div class="switch--item">' + blockName + '</div>');
+	item.on('click', '', content, function(e) {
+		$(this).addClass('selected');
+		$(this).siblings().removeClass('selected');
+		e.data.siblings('.content').addClass('hidden');
+		e.data.removeClass('hidden');
+	});
+	blockSwitch.append(item);
+	return {'item': item, 'content': content};
+}
+
+$(addBlockSwitches);
+</script>
+
+</head>
+<body id="using" class="book toc2 toc-left">
+<div id="header">
+<h1>Using Spring Cloud Contract</h1>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="#flows-provider-nexus">1. Provider Contract Testing with Stubs in Nexus or Artifactory</a></li>
+<li><a href="#flows-provider-git">2. Provider Contract Testing with Stubs in Git</a>
+<ul class="sectlevel2">
+<li><a href="#prerequisites">2.1. Prerequisites</a></li>
+<li><a href="#flows-provider-git-flow">2.2. The Flow</a></li>
+<li><a href="#flows-provider-git-consumer">2.3. Consumer setup</a></li>
+<li><a href="#flows-provider-git-producer">2.4. Setting up the Producer</a></li>
+</ul>
+</li>
+<li><a href="#flows-cdc-contracts-producer">3. Consumer Driven Contracts with Contracts on the Producer Side</a></li>
+<li><a href="#flows-cdc-contracts-external">4. Consumer Driven Contracts with Contracts in an External Repository</a>
+<ul class="sectlevel2">
+<li><a href="#prerequisites-2">4.1. Prerequisites</a></li>
+<li><a href="#flows-cdc-contracts-external-consumer">4.2. Consumer Flow</a></li>
+<li><a href="#flows-cdc-contracts-external-producer">4.3. Producer Flow</a></li>
+</ul>
+</li>
+<li><a href="#flows-cdc-contracts-stubs-git">5. Consumer Driven Contracts with Contracts on the Producer Side, Pushed to Git</a></li>
+<li><a href="#flows-provider-non-spring">6. Provider Contract Testing with Stubs in Artifactory for a non-Spring Application</a>
+<ul class="sectlevel2">
+<li><a href="#flows-provider-non-spring-flow">6.1. The Flow</a></li>
+<li><a href="#flows-provider-non-spring-consumer">6.2. Setting up the Consumer</a></li>
+<li><a href="#flows-provider-non-spring-producer">6.3. Setting up the Producer</a></li>
+</ul>
+</li>
+<li><a href="#flows-provider-non-jvm">7. Provider Contract Testing with Stubs in Artifactory in a non-JVM World</a>
+<ul class="sectlevel2">
+<li><a href="#flows-provider-non-jvm-producer">7.1. Producer Flow</a></li>
+<li><a href="#flows-provider-non-jvm-consumer">7.2. Consumer Flow</a></li>
+</ul>
+</li>
+<li><a href="#flows-provider-rest-docs">8. Provider Contract Testing with REST Docs and Stubs in Nexus or Artifactory</a>
+<ul class="sectlevel2">
+<li><a href="#flows-provider-rest-docs-producer">8.1. Producer Flow</a></li>
+<li><a href="#flows-provider-rest-docs-consumer">8.2. Consumer Flow</a></li>
+</ul>
+</li>
+<li><a href="#using-whats-next">9. What to Read Next</a></li>
+</ul>
+</div>
+</div>
+<div id="content">
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>This section goes into more detail about how you should use Spring Cloud Contract. It covers topics
+such as flows of how to work with Spring Cloud Contract. We also
+cover some Spring Cloud Contract best practices.</p>
+</div>
+<div class="paragraph">
+<p>If you are starting out with Spring Cloud Contract, you should probably read the
+<a href="getting-started.html#getting-started">Getting Started</a> guide before diving into this
+section.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="flows-provider-nexus"><a class="anchor" href="#flows-provider-nexus"></a><a class="link" href="#flows-provider-nexus">1. Provider Contract Testing with Stubs in Nexus or Artifactory</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>You can check the <a href="getting-started.html#getting-started-first-application">Developing Your First Spring Cloud Contract based application</a> link to see the provider contract testing with stubs in the Nexus or Artifactory flow.</p>
+</div>
+<div class="paragraph">
+<p>You can also check the <a href="https://cloud-samples.spring.io/spring-cloud-contract-samples/tutorials/contracts_on_the_producer_side.html">workshop page</a> for a step-by-step instruction on how to do this flow.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="flows-provider-git"><a class="anchor" href="#flows-provider-git"></a><a class="link" href="#flows-provider-git">2. Provider Contract Testing with Stubs in Git</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>In this flow, we perform the provider contract testing (the producer has no knowledge of how consumers use their API). The stubs are uploaded to a separate repository (they are not uploaded to Artifactory or Nexus).</p>
+</div>
+<div class="sect2">
+<h3 id="prerequisites"><a class="anchor" href="#prerequisites"></a><a class="link" href="#prerequisites">2.1. Prerequisites</a></h3>
+<div class="paragraph">
+<p>Before testing provider contracts with stubs in git, you must provide a git repository
+that contains all the stubs for each producer. For an example of such a project, see
+<a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x//contract_git">this samples </a> or <a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x//contract_git">this sample</a>.
+As a result of pushing stubs there, the repository has the following structure:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre>$ tree .
+└── META-INF
+   └── folder.with.group.id.as.its.name
+       └── folder-with-artifact-id
+           └── folder-with-version
+               ├── contractA.groovy
+               ├── contractB.yml
+               └── contractC.groovy</pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You must also provide consumer code that has Spring Cloud Contract Stub Runner set up. For
+an example of such a project, see <a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x//consumer">this sample</a> and search for a
+<code>BeerControllerGitTest</code> test. You must also provide producer code that has Spring Cloud
+Contract set up, together with a plugin. For an example of such a project, see
+<a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x//producer_with_empty_git">this sample</a>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="flows-provider-git-flow"><a class="anchor" href="#flows-provider-git-flow"></a><a class="link" href="#flows-provider-git-flow">2.2. The Flow</a></h3>
+<div class="paragraph">
+<p>The flow looks exactly as the one presented in
+<a href="getting-started.html#getting-started-first-application">Developing Your First Spring Cloud Contract based application</a>,
+but the <code>Stub Storage</code> implementation is a git repository.</p>
+</div>
+<div class="paragraph">
+<p>You can read more about setting up a git repository and setting consumer and producer side
+in the <a href="howto.html#how-to-use-git-as-storage">How To page</a> of the documentation.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="flows-provider-git-consumer"><a class="anchor" href="#flows-provider-git-consumer"></a><a class="link" href="#flows-provider-git-consumer">2.3. Consumer setup</a></h3>
+<div class="paragraph">
+<p>In order to fetch the stubs from a git repository instead of Nexus or Artifactory, you
+need to use the <code>git</code> protocol in the URL of the <code>repositoryRoot</code> property in Stub Runner.
+The following example shows how to set it up:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Annotation</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(
+stubsMode = StubRunnerProperties.StubsMode.REMOTE,
+        repositoryRoot = "git://git@github.com:spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git",
+        ids = "com.example:artifact-id:0.0.1")</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 4 Rule</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Rule
+    public StubRunnerRule rule = new StubRunnerRule()
+            .downloadStub("com.example","artifact-id", "0.0.1")
+            .repoRoot("git://git@github.com:spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE);</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 5 Extension</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RegisterExtension
+    public StubRunnerExtension stubRunnerExtension = new StubRunnerExtension()
+            .downloadStub("com.example","artifact-id", "0.0.1")
+            .repoRoot("git://git@github.com:spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE);</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="flows-provider-git-producer"><a class="anchor" href="#flows-provider-git-producer"></a><a class="link" href="#flows-provider-git-producer">2.4. Setting up the Producer</a></h3>
+<div class="paragraph">
+<p>In order to push the stubs to a git repository instead of Nexus or Artifactory, you need
+to use the <code>git</code> protocol in the URL of the plugin setup. Also you need to explicitly tell
+the plugin to push the stubs at the end of the build process. The following example shows
+how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;!-- Base class mappings etc. --&gt;
+
+        &lt;!-- We want to pick contracts from a Git repository --&gt;
+        &lt;contractsRepositoryUrl&gt;git://git://git@github.com:spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git&lt;/contractsRepositoryUrl&gt;
+
+        &lt;!-- We reuse the contract dependency section to set up the path
+        to the folder that contains the contract definitions. In our case the
+        path will be /groupId/artifactId/version/contracts --&gt;
+        &lt;contractDependency&gt;
+            &lt;groupId&gt;${project.groupId}&lt;/groupId&gt;
+            &lt;artifactId&gt;${project.artifactId}&lt;/artifactId&gt;
+            &lt;version&gt;${project.version}&lt;/version&gt;
+        &lt;/contractDependency&gt;
+
+        &lt;!-- The contracts mode can't be classpath --&gt;
+        &lt;contractsMode&gt;REMOTE&lt;/contractsMode&gt;
+    &lt;/configuration&gt;
+    &lt;executions&gt;
+        &lt;execution&gt;
+            &lt;phase&gt;package&lt;/phase&gt;
+            &lt;goals&gt;
+                &lt;!-- By default we will not push the stubs back to SCM,
+                you have to explicitly add it as a goal --&gt;
+                &lt;goal&gt;pushStubsToScm&lt;/goal&gt;
+            &lt;/goals&gt;
+        &lt;/execution&gt;
+    &lt;/executions&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+    // We want to pick contracts from a Git repository
+    contractDependency {
+        stringNotation = "${project.group}:${project.name}:${project.version}"
+    }
+    /*
+    We reuse the contract dependency section to set up the path
+    to the folder that contains the contract definitions. In our case the
+    path will be /groupId/artifactId/version/contracts
+     */
+    contractRepository {
+        repositoryUrl = "git://git://git@github.com:spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git"
+    }
+    // The mode can't be classpath
+    contractsMode = "REMOTE"
+    // Base class mappings etc.
+}
+
+/*
+In this scenario we want to publish stubs to SCM whenever
+the `publish` task is executed
+*/
+publish.dependsOn("publishStubsToScm")</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can read more about setting up a git repository in the
+<a href="howto.html#how-to-use-git-as-storage">How To page</a> of the documentation.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="flows-cdc-contracts-producer"><a class="anchor" href="#flows-cdc-contracts-producer"></a><a class="link" href="#flows-cdc-contracts-producer">3. Consumer Driven Contracts with Contracts on the Producer Side</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>See <a href="getting-started.html#getting-started-cdc">Step-by-step Guide to Consumer Driven
+Contracts (CDC) with Contracts on the Producer Side</a> to see the Consumer Driven Contracts
+with contracts on the producer side flow.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="flows-cdc-contracts-external"><a class="anchor" href="#flows-cdc-contracts-external"></a><a class="link" href="#flows-cdc-contracts-external">4. Consumer Driven Contracts with Contracts in an External Repository</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>In this flow, we perform Consumer Driven Contract testing. The contract definitions are
+stored in a separate repository.</p>
+</div>
+<div class="paragraph">
+<p>See the <a href="https://cloud-samples.spring.io/spring-cloud-contract-samples/tutorials/contracts_on_the_producer_side.html">workshop page</a>
+for step-by-step instructions on how to do this flow.</p>
+</div>
+<div class="sect2">
+<h3 id="prerequisites-2"><a class="anchor" href="#prerequisites-2"></a><a class="link" href="#prerequisites-2">4.1. Prerequisites</a></h3>
+<div class="paragraph">
+<p>To use consumer-driven contracts with the contracts held in an external repository, you need to set up a git repository that:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Contains all the contract definitions for each producer.</p>
+</li>
+<li>
+<p>Can package the contract definitions in a JAR.</p>
+</li>
+<li>
+<p>For each contract producer, contains a way (for example, <code>pom.xml</code>) to install stubs
+locally through the Spring Cloud Contract Plugin (SCC Plugin)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For more information, see the <a href="howto.html#how-to-common-repo-with-contracts">How To section</a>,
+where we describe how to set up such a repository
+For an example of such a project, see <a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x//beer_contracts">this sample</a>.</p>
+</div>
+<div class="paragraph">
+<p>You also need consumer code that has Spring Cloud Contract Stub Runner set up.
+For an example of such a project, see <a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x//consumer">this sample</a>.
+You also need producer code that has Spring Cloud Contract set up, together with a plugin.
+For an example of such a project, see <a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x//producer_with_external_contracts">this sample</a>.
+The stub storage is Nexus or Artifactory</p>
+</div>
+<div class="paragraph">
+<p>At a high level, the flow looks as follows:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The consumer works with the contract definitions from the separate repository</p>
+</li>
+<li>
+<p>Once the consumer&#8217;s work is done, a branch with working code is done on the consumer
+side and a pull request is made to the separate repository that holds the contract definitions.</p>
+</li>
+<li>
+<p>The producer takes over the pull request to the separate repository with contract
+definitions and installs the JAR with all contracts locally.</p>
+</li>
+<li>
+<p>The producer generates tests from the locally stored JAR and writes the missing
+implementation to make the tests pass.</p>
+</li>
+<li>
+<p>Once the producer&#8217;s work is done, the pull request to the repository that holds the
+contract definitions is merged.</p>
+</li>
+<li>
+<p>After the CI tool builds the repository with the contract definitions and the JAR with
+contract definitions gets uploaded to Nexus or Artifactory, the producer can merge its branch.</p>
+</li>
+<li>
+<p>Finally, the consumer can switch to working online to fetch stubs of the producer from a
+remote location, and the branch can be merged to master.</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect2">
+<h3 id="flows-cdc-contracts-external-consumer"><a class="anchor" href="#flows-cdc-contracts-external-consumer"></a><a class="link" href="#flows-cdc-contracts-external-consumer">4.2. Consumer Flow</a></h3>
+<div class="paragraph">
+<p>The consumer:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Writes a test that would send a request to the producer.</p>
+<div class="paragraph">
+<p>The test fails due to no server being present.</p>
+</div>
+</li>
+<li>
+<p>Clones the repository that holds the contract definitions.</p>
+</li>
+<li>
+<p>Set up the requirements as contracts under the folder with the consumer name as a subfolder of the producer.</p>
+<div class="paragraph">
+<p>For example, for a producer named <code>producer</code> and a consumer named <code>consumer</code>, the contracts would be stored under <code>src/main/resources/contracts/producer/consumer/</code>)</p>
+</div>
+</li>
+<li>
+<p>Once the contracts are defined, installs the producer stubs to local storage, as the following example shows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre>$ cd src/main/resource/contracts/producer
+$ ./mvnw clean install</pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Sets up Spring Cloud Contract (SCC) Stub Runner in the consumer tests, to:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Fetch the producer stubs from local storage.</p>
+</li>
+<li>
+<p>Work in the stubs-per-consumer mode (this enables consumer driven contracts mode).</p>
+<div class="paragraph">
+<p>The SCC Stub Runner:</p>
+</div>
+</li>
+<li>
+<p>Fetches the producer stubs.</p>
+</li>
+<li>
+<p>Runs an in-memory HTTP server stub with the producer stubs.</p>
+</li>
+<li>
+<p>Now your test communicates with the HTTP server stub and your tests pass</p>
+</li>
+<li>
+<p>Create a pull request to the repository with contract definitions, with the new contracts for the producer</p>
+</li>
+<li>
+<p>Branch your consumer code, until the producer team has merged their code</p>
+</li>
+</ul>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The following UML diagram shows the consumer flow:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/flow-overview-consumer-cdc-external-consumer.png" alt="flow overview consumer cdc external consumer" width="886" height="676">
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="flows-cdc-contracts-external-producer"><a class="anchor" href="#flows-cdc-contracts-external-producer"></a><a class="link" href="#flows-cdc-contracts-external-producer">4.3. Producer Flow</a></h3>
+<div class="paragraph">
+<p>The producer:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Takes over the pull request to the repository with contract definitions. You can do it
+from the command line, as follows</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre>$ git checkout -b the_branch_with_pull_request master
+git pull https://github.com/user_id/project_name.git the_branch_with_pull_request</pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Installs the contract definitions, as follows</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre>$ ./mvnw clean install</pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Sets up the plugin to fetch the contract definitions from a JAR instead of from
+<code>src/test/resources/contracts</code>, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;!-- We want to use the JAR with contracts with the following coordinates --&gt;
+        &lt;contractDependency&gt;
+            &lt;groupId&gt;com.example&lt;/groupId&gt;
+            &lt;artifactId&gt;beer-contracts&lt;/artifactId&gt;
+        &lt;/contractDependency&gt;
+        &lt;!-- The JAR with contracts should be taken from Maven local --&gt;
+        &lt;contractsMode&gt;LOCAL&lt;/contractsMode&gt;
+        &lt;!-- ... additional configuration --&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+    // We want to use the JAR with contracts with the following coordinates
+    // group id `com.example`, artifact id `beer-contracts`, LATEST version and NO classifier
+    contractDependency {
+        stringNotation = 'com.example:beer-contracts:+:'
+    }
+    // The JAR with contracts should be taken from Maven local
+    contractsMode = "LOCAL"
+    // Additional configuration
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Runs the build to generate tests and stubs, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./mvnw clean install</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">./gradlew clean build</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Writes the missing implementation, to make the tests pass.</p>
+</li>
+<li>
+<p>Merges the pull request to the repository with contract definitions, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre>$ git commit -am "Finished the implementation to make the contract tests pass"
+$ git checkout master
+$ git merge --no-ff the_branch_with_pull_request
+$ git push origin master</pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>The CI system builds the project with the contract definitions and uploads the JAR with
+the contract definitions to Nexus or Artifactory.</p>
+</li>
+<li>
+<p>Switches to working remotely.</p>
+</li>
+<li>
+<p>Sets up the plugin so that the contract definitions are no longer taken from the local
+storage but from a remote location, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;!-- We want to use the JAR with contracts with the following coordinates --&gt;
+        &lt;contractDependency&gt;
+            &lt;groupId&gt;com.example&lt;/groupId&gt;
+            &lt;artifactId&gt;beer-contracts&lt;/artifactId&gt;
+        &lt;/contractDependency&gt;
+        &lt;!-- The JAR with contracts should be taken from a remote location --&gt;
+        &lt;contractsMode&gt;REMOTE&lt;/contractsMode&gt;
+        &lt;!-- ... additional configuration --&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+    // We want to use the JAR with contracts with the following coordinates
+    // group id `com.example`, artifact id `beer-contracts`, LATEST version and NO classifier
+    contractDependency {
+        stringNotation = 'com.example:beer-contracts:+:'
+    }
+    // The JAR with contracts should be taken from a remote location
+    contractsMode = "REMOTE"
+    // Additional configuration
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Merges the producer code with the new implementation.</p>
+</li>
+<li>
+<p>The CI system:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Builds the project</p>
+</li>
+<li>
+<p>Generates tests, stubs, and the stub JAR</p>
+</li>
+<li>
+<p>Uploads the artifact with the application and the stubs to Nexus or Artifactory.</p>
+</li>
+</ul>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The following UML diagram shows the producer process:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/flow-overview-consumer-cdc-external-producer.png" alt="flow overview consumer cdc external producer" width="1213" height="1341">
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="flows-cdc-contracts-stubs-git"><a class="anchor" href="#flows-cdc-contracts-stubs-git"></a><a class="link" href="#flows-cdc-contracts-stubs-git">5. Consumer Driven Contracts with Contracts on the Producer Side, Pushed to Git</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>You can check <a href="getting-started.html#getting-started-cdc">Step-by-step Guide to Consumer Driven Contracts (CDC) with contracts laying on the producer side</a> to see the consumer driven contracts with contracts on the producer side flow.</p>
+</div>
+<div class="paragraph">
+<p>The stub storage implementation is a git repository. We describe its setup in the
+<a href="#flows-provider-git">Provider Contract Testing with Stubs in Git</a> section.</p>
+</div>
+<div class="paragraph">
+<p>You can read more about setting up a git repository for the consumer and producer sides in
+the <a href="howto.html#how-to-use-git-as-storage">How To page</a> of the documentation.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="flows-provider-non-spring"><a class="anchor" href="#flows-provider-non-spring"></a><a class="link" href="#flows-provider-non-spring">6. Provider Contract Testing with Stubs in Artifactory for a non-Spring Application</a></h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="flows-provider-non-spring-flow"><a class="anchor" href="#flows-provider-non-spring-flow"></a><a class="link" href="#flows-provider-non-spring-flow">6.1. The Flow</a></h3>
+<div class="paragraph">
+<p>You can check <a href="getting-started.html#getting-started-first-application">Developing Your First Spring Cloud Contract based application</a> to see the flow for provider contract testing with stubs in Nexus or Artifactory.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="flows-provider-non-spring-consumer"><a class="anchor" href="#flows-provider-non-spring-consumer"></a><a class="link" href="#flows-provider-non-spring-consumer">6.2. Setting up the Consumer</a></h3>
+<div class="paragraph">
+<p>For the consumer side, you can use a JUnit rule. That way, you need not start a Spring context. The follwoing listing shows such a rule (in JUnit4 and JUnit 5);</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">JUnit 4 Rule</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Rule
+    public StubRunnerRule rule = new StubRunnerRule()
+            .downloadStub("com.example","artifact-id", "0.0.1")
+            .repoRoot("git://git@github.com:spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE);</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 5 Extension</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Rule
+    public StubRunnerExtension stubRunnerExtension = new StubRunnerExtension()
+            .downloadStub("com.example","artifact-id", "0.0.1")
+            .repoRoot("git://git@github.com:spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE);</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="flows-provider-non-spring-producer"><a class="anchor" href="#flows-provider-non-spring-producer"></a><a class="link" href="#flows-provider-non-spring-producer">6.3. Setting up the Producer</a></h3>
+<div class="paragraph">
+<p>By default, the Spring Cloud Contract Plugin uses Rest Assured&#8217;s <code>MockMvc</code> setup for the
+generated tests. Since non-Spring applications do not use <code>MockMvc</code>, you can change the
+<code>testMode</code> to <code>EXPLICIT</code> to send a real request to an application bound at a specific port.</p>
+</div>
+<div class="paragraph">
+<p>In this example, we use a framework called <a href="https://javalin.io">Javalin</a> to start a
+non-Spring HTTP server.</p>
+</div>
+<div class="paragraph">
+<p>Assume that we have the following application:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package com.example.demo;
+
+import io.javalin.Javalin;
+
+public class DemoApplication {
+
+    public static void main(String[] args) {
+        new DemoApplication().run(7000);
+    }
+
+    public Javalin start(int port) {
+        return Javalin.create().start(port);
+    }
+
+    public Javalin registerGet(Javalin app) {
+        return app.get("/", ctx -&gt; ctx.result("Hello World"));
+    }
+
+    public Javalin run(int port) {
+        return registerGet(start(port));
+    }
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Given that application, we can set up the plugin to use the <code>EXPLICIT</code> mode (that is, to
+send out requests to a real port), as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;baseClassForTests&gt;com.example.demo.BaseClass&lt;/baseClassForTests&gt;
+        &lt;!-- This will setup the EXPLICIT mode for the tests --&gt;
+        &lt;testMode&gt;EXPLICIT&lt;/testMode&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+    // This will setup the EXPLICIT mode for the tests
+    testMode = "EXPLICIT"
+    baseClassForTests = "com.example.demo.BaseClass"
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The base class might resemble the following:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">import io.javalin.Javalin;
+import io.restassured.RestAssured;
+import org.junit.After;
+import org.junit.Before;
+import org.springframework.util.SocketUtils;
+
+public class BaseClass {
+
+    Javalin app;
+
+    @Before
+    public void setup() {
+        // pick a random port
+        int port = SocketUtils.findAvailableTcpPort();
+        // start the application at a random port
+        this.app = start(port);
+        // tell Rest Assured where the started application is
+        RestAssured.baseURI = "http://localhost:" + port;
+    }
+
+    @After
+    public void close() {
+        // stop the server after each test
+        this.app.stop();
+    }
+
+    private Javalin start(int port) {
+        // reuse the production logic to start a server
+        return new DemoApplication().run(port);
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>With such a setup:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>We have setup the Spring Cloud Contract plugin to use the <code>EXPLICIT</code> mode to send real
+requests instead of mocked ones.</p>
+</li>
+<li>
+<p>We have defined a base class that:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Starts the HTTP server on a random port for each test.</p>
+</li>
+<li>
+<p>Sets Rest Assured to send requests to that port.</p>
+</li>
+<li>
+<p>Closes the HTTP server after each test.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="flows-provider-non-jvm"><a class="anchor" href="#flows-provider-non-jvm"></a><a class="link" href="#flows-provider-non-jvm">7. Provider Contract Testing with Stubs in Artifactory in a non-JVM World</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>In this flow, we assume that:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The API Producer and API Consumer are non-JVM applications.</p>
+</li>
+<li>
+<p>The contract definitions are written in YAML.</p>
+</li>
+<li>
+<p>The Stub Storage is Artifactory or Nexus.</p>
+</li>
+<li>
+<p>Spring Cloud Contract Docker (SCC Docker) and Spring Cloud Contract Stub Runner Docker
+(SCC Stub Runner Docker) images are used.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>You can read more about how to use Spring Cloud Contract with Docker
+<a href="#docker-project.adoc">in this page</a>.</p>
+</div>
+<div class="paragraph">
+<p><a href="https://spring.io/blog/2018/02/13/spring-cloud-contract-in-a-polyglot-world">Here</a>, you can
+read a blog post about how to use Spring Cloud Contract in a polyglot world.</p>
+</div>
+<div class="paragraph">
+<p><a href="https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs/">Here</a>, you can find
+a sample of a NodeJS application that uses Spring Cloud Contract both as a producer and a
+consumer.</p>
+</div>
+<div class="sect2">
+<h3 id="flows-provider-non-jvm-producer"><a class="anchor" href="#flows-provider-non-jvm-producer"></a><a class="link" href="#flows-provider-non-jvm-producer">7.1. Producer Flow</a></h3>
+<div class="paragraph">
+<p>At a high level, the producer:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Writes contract definitions (for example, in YAML).</p>
+</li>
+<li>
+<p>Sets up the build tool to:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>Start the application with mocked services on a given port.</p>
+<div class="paragraph">
+<p>If mocking is not possible, you can setup the infrastructure and define tests in a stateful way.</p>
+</div>
+</li>
+<li>
+<p>Run the Spring Cloud Contract Docker image and pass the port of a running application as an environment variable.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The SCC Docker image:
+* Generates the tests from the attached volume.
+* Runs the tests against the running application.</p>
+</div>
+<div class="paragraph">
+<p>Upon test completion, stubs get uploaded to a stub storage site (such as Artifactory or Git).</p>
+</div>
+<div class="paragraph">
+<p>The following UML diagram shows the producer flow:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/flows-provider-non-jvm-producer.png" alt="flows provider non jvm producer" width="930" height="810">
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="flows-provider-non-jvm-consumer"><a class="anchor" href="#flows-provider-non-jvm-consumer"></a><a class="link" href="#flows-provider-non-jvm-consumer">7.2. Consumer Flow</a></h3>
+<div class="paragraph">
+<p>At a high level, the consumer:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Sets up the build tool to:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Start the Spring Cloud Contract Stub Runner Docker image and start the stubs.</p>
+<div class="paragraph">
+<p>The environment variables configure:</p>
+</div>
+</li>
+<li>
+<p>The stubs to fetch.</p>
+</li>
+<li>
+<p>The location of the repositories.</p>
+<div class="paragraph">
+<p>Note that:</p>
+</div>
+</li>
+<li>
+<p>To use the local storage, you can also attach it as a volume.</p>
+</li>
+<li>
+<p>The ports at which the stubs are running need to be exposed.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Run the application tests against the running stubs.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The following UML diagram shows the consumer flow:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/flows-provider-non-jvm-consumer.png" alt="flows provider non jvm consumer" width="815" height="618">
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="flows-provider-rest-docs"><a class="anchor" href="#flows-provider-rest-docs"></a><a class="link" href="#flows-provider-rest-docs">8. Provider Contract Testing with REST Docs and Stubs in Nexus or Artifactory</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>In this flow, we do not use a Spring Cloud Contract plugin to generate tests and stubs. We write <a href="https://spring.io/projects/spring-restdocs">Spring RESTDocs</a> and, from them, we automatically generate stubs. Finally, we set up our builds to package the stubs and upload them to the stub storage site&#8201;&#8212;&#8201;in our case, Nexus or Artifactory.</p>
+</div>
+<div class="paragraph">
+<p>See the <a href="https://cloud-samples.spring.io/spring-cloud-contract-samples/tutorials/rest_docs.html">workshop page</a> for a step-by-step instruction on how to use this flow.</p>
+</div>
+<div class="sect2">
+<h3 id="flows-provider-rest-docs-producer"><a class="anchor" href="#flows-provider-rest-docs-producer"></a><a class="link" href="#flows-provider-rest-docs-producer">8.1. Producer Flow</a></h3>
+<div class="paragraph">
+<p>As a producer, we:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>We write RESTDocs tests of our API.</p>
+</li>
+<li>
+<p>We add Spring Cloud Contract Stub Runner starter to our build (<code>spring-cloud-starter-contract-stub-runner</code>), as follows</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependencies&gt;
+    &lt;dependency&gt;
+        &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+        &lt;artifactId&gt;spring-cloud-starter-contract-stub-runner&lt;/artifactId&gt;
+        &lt;scope&gt;test&lt;/scope&gt;
+    &lt;/dependency&gt;
+&lt;/dependencies&gt;
+
+&lt;dependencyManagement&gt;
+    &lt;dependencies&gt;
+        &lt;dependency&gt;
+            &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+            &lt;artifactId&gt;spring-cloud-dependencies&lt;/artifactId&gt;
+            &lt;version&gt;${spring-cloud.version}&lt;/version&gt;
+            &lt;type&gt;pom&lt;/type&gt;
+            &lt;scope&gt;import&lt;/scope&gt;
+        &lt;/dependency&gt;
+    &lt;/dependencies&gt;
+&lt;/dependencyManagement&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">dependencies {
+    testImplementation 'org.springframework.cloud:spring-cloud-starter-contract-stub-runner'
+}
+
+dependencyManagement {
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>We set up the build tool to package our stubs, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;!-- pom.xml --&gt;
+&lt;plugins&gt;
+    &lt;plugin&gt;
+        &lt;groupId&gt;org.apache.maven.plugins&lt;/groupId&gt;
+        &lt;artifactId&gt;maven-assembly-plugin&lt;/artifactId&gt;
+        &lt;executions&gt;
+            &lt;execution&gt;
+                &lt;id&gt;stub&lt;/id&gt;
+                &lt;phase&gt;prepare-package&lt;/phase&gt;
+                &lt;goals&gt;
+                    &lt;goal&gt;single&lt;/goal&gt;
+                &lt;/goals&gt;
+                &lt;inherited&gt;false&lt;/inherited&gt;
+                &lt;configuration&gt;
+                    &lt;attach&gt;true&lt;/attach&gt;
+                    &lt;descriptors&gt;
+                        ${basedir}/src/assembly/stub.xml
+                    &lt;/descriptors&gt;
+                &lt;/configuration&gt;
+            &lt;/execution&gt;
+        &lt;/executions&gt;
+    &lt;/plugin&gt;
+&lt;/plugins&gt;
+
+&lt;!-- src/assembly/stub.xml --&gt;
+&lt;assembly
+    xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 http://maven.apache.org/xsd/assembly-1.1.3.xsd"&gt;
+    &lt;id&gt;stubs&lt;/id&gt;
+    &lt;formats&gt;
+        &lt;format&gt;jar&lt;/format&gt;
+    &lt;/formats&gt;
+    &lt;includeBaseDirectory&gt;false&lt;/includeBaseDirectory&gt;
+    &lt;fileSets&gt;
+        &lt;fileSet&gt;
+            &lt;directory&gt;${project.build.directory}/generated-snippets/stubs&lt;/directory&gt;
+            &lt;outputDirectory&gt;META-INF/${project.groupId}/${project.artifactId}/${project.version}/mappings&lt;/outputDirectory&gt;
+            &lt;includes&gt;
+                &lt;include&gt;**/*&lt;/include&gt;
+            &lt;/includes&gt;
+        &lt;/fileSet&gt;
+    &lt;/fileSets&gt;
+&lt;/assembly&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">task stubsJar(type: Jar) {
+    classifier = "stubs"
+    into("META-INF/${project.group}/${project.name}/${project.version}/mappings") {
+        include('**/*.*')
+        from("${project.buildDir}/generated-snippets/stubs")
+    }
+}
+// we need the tests to pass to build the stub jar
+stubsJar.dependsOn(test)
+bootJar.dependsOn(stubsJar)</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Now, when we run the tests, stubs are automatically published and packaged.</p>
+</div>
+<div class="paragraph">
+<p>The following UML diagram shows the producer flow:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/flows-provider-rest-docs-producer.png" alt="flows provider rest docs producer" width="783" height="677">
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="flows-provider-rest-docs-consumer"><a class="anchor" href="#flows-provider-rest-docs-consumer"></a><a class="link" href="#flows-provider-rest-docs-consumer">8.2. Consumer Flow</a></h3>
+<div class="paragraph">
+<p>Since the consumer flow is not affected by the tool used to generate the stubs, you can check <a href="getting-started.html#getting-started-first-application-consumer">Developing Your First Spring Cloud Contract based application</a> to see the flow for consumer side of the provider contract testing with stubs in Nexus or Artifactory.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="using-whats-next"><a class="anchor" href="#using-whats-next"></a><a class="link" href="#using-whats-next">9. What to Read Next</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>You should now understand how you can use Spring Cloud Contract and some best practices that you
+should follow. You can now go on to learn about specific
+<a href="project-features.html#project-features">Spring Cloud Contract features</a>, or you could
+skip ahead and read about the <a href="advanced.html">advanced features of Spring Cloud Contract</a>.</p>
+</div>
+</div>
+</div>
+</div>
+<script type="text/javascript" src="js/tocbot/tocbot.min.js"></script>
+<script type="text/javascript" src="js/toc.js"></script>
+<link rel="stylesheet" href="js/highlight/styles/atom-one-dark-reasonable.min.css">
+<script src="js/highlight/highlight.min.js"></script>
+<script>hljs.initHighlighting()</script>
+</body>
+</html>
\ No newline at end of file
diff --git a/reference/htmlsingle/.asciidoctor/diagram/flow-overview-consumer-cdc-external-consumer.png.cache b/reference/htmlsingle/.asciidoctor/diagram/flow-overview-consumer-cdc-external-consumer.png.cache
new file mode 100644
index 0000000000..ca8988965c
--- /dev/null
+++ b/reference/htmlsingle/.asciidoctor/diagram/flow-overview-consumer-cdc-external-consumer.png.cache
@@ -0,0 +1 @@
+{"checksum":"23a7e5a52b04e1a55f2d102255d7ea04","width":886,"height":676}
\ No newline at end of file
diff --git a/reference/htmlsingle/.asciidoctor/diagram/flow-overview-consumer-cdc-external-producer.png.cache b/reference/htmlsingle/.asciidoctor/diagram/flow-overview-consumer-cdc-external-producer.png.cache
new file mode 100644
index 0000000000..a17e22fcb1
--- /dev/null
+++ b/reference/htmlsingle/.asciidoctor/diagram/flow-overview-consumer-cdc-external-producer.png.cache
@@ -0,0 +1 @@
+{"checksum":"c9ffba1bc9383435e35a7973e5641dd8","width":1213,"height":1341}
\ No newline at end of file
diff --git a/reference/htmlsingle/.asciidoctor/diagram/flows-provider-non-jvm-consumer.png.cache b/reference/htmlsingle/.asciidoctor/diagram/flows-provider-non-jvm-consumer.png.cache
new file mode 100644
index 0000000000..2f99cba6c4
--- /dev/null
+++ b/reference/htmlsingle/.asciidoctor/diagram/flows-provider-non-jvm-consumer.png.cache
@@ -0,0 +1 @@
+{"checksum":"30b3d3322b3ecb24a6c5346a8571ba98","width":815,"height":618}
\ No newline at end of file
diff --git a/reference/htmlsingle/.asciidoctor/diagram/flows-provider-non-jvm-producer.png.cache b/reference/htmlsingle/.asciidoctor/diagram/flows-provider-non-jvm-producer.png.cache
new file mode 100644
index 0000000000..5a3310d3c6
--- /dev/null
+++ b/reference/htmlsingle/.asciidoctor/diagram/flows-provider-non-jvm-producer.png.cache
@@ -0,0 +1 @@
+{"checksum":"37241bc45c73dbad7383a4733a05d559","width":930,"height":810}
\ No newline at end of file
diff --git a/reference/htmlsingle/.asciidoctor/diagram/flows-provider-rest-docs-producer.png.cache b/reference/htmlsingle/.asciidoctor/diagram/flows-provider-rest-docs-producer.png.cache
new file mode 100644
index 0000000000..2d6b2f9d08
--- /dev/null
+++ b/reference/htmlsingle/.asciidoctor/diagram/flows-provider-rest-docs-producer.png.cache
@@ -0,0 +1 @@
+{"checksum":"b137ec966db7960885422f991695d28f","width":783,"height":677}
\ No newline at end of file
diff --git a/reference/htmlsingle/.asciidoctor/diagram/getting-started-cdc-client-final.png.cache b/reference/htmlsingle/.asciidoctor/diagram/getting-started-cdc-client-final.png.cache
new file mode 100644
index 0000000000..eac3cd74e2
--- /dev/null
+++ b/reference/htmlsingle/.asciidoctor/diagram/getting-started-cdc-client-final.png.cache
@@ -0,0 +1 @@
+{"checksum":"a46f733654d99c8861184f0e4e04bb95","width":590,"height":685}
\ No newline at end of file
diff --git a/reference/htmlsingle/.asciidoctor/diagram/getting-started-cdc-client.png.cache b/reference/htmlsingle/.asciidoctor/diagram/getting-started-cdc-client.png.cache
new file mode 100644
index 0000000000..89ce0d961d
--- /dev/null
+++ b/reference/htmlsingle/.asciidoctor/diagram/getting-started-cdc-client.png.cache
@@ -0,0 +1 @@
+{"checksum":"b1418561d3b01d5d71885b4b7bb1be93","width":1138,"height":1223}
\ No newline at end of file
diff --git a/reference/htmlsingle/.asciidoctor/diagram/getting-started-cdc-server.png.cache b/reference/htmlsingle/.asciidoctor/diagram/getting-started-cdc-server.png.cache
new file mode 100644
index 0000000000..0b7b2d7806
--- /dev/null
+++ b/reference/htmlsingle/.asciidoctor/diagram/getting-started-cdc-server.png.cache
@@ -0,0 +1 @@
+{"checksum":"7a8cb19e9d604071d61e4aa9201ee623","width":688,"height":903}
\ No newline at end of file
diff --git a/reference/htmlsingle/.asciidoctor/diagram/getting-started-three-second.png.cache b/reference/htmlsingle/.asciidoctor/diagram/getting-started-three-second.png.cache
new file mode 100644
index 0000000000..3e5f4a8ff5
--- /dev/null
+++ b/reference/htmlsingle/.asciidoctor/diagram/getting-started-three-second.png.cache
@@ -0,0 +1 @@
+{"checksum":"27396daead141eee677aa6311403d175","width":986,"height":704}
\ No newline at end of file
diff --git a/reference/htmlsingle/.asciidoctor/diagram/how-to-common-repo.png.cache b/reference/htmlsingle/.asciidoctor/diagram/how-to-common-repo.png.cache
new file mode 100644
index 0000000000..c23499f956
--- /dev/null
+++ b/reference/htmlsingle/.asciidoctor/diagram/how-to-common-repo.png.cache
@@ -0,0 +1 @@
+{"checksum":"89bbfd25e4c214245543ed34208e2afa","width":1588,"height":1421}
\ No newline at end of file
diff --git a/reference/htmlsingle/.asciidoctor/diagram/rest-docs.png.cache b/reference/htmlsingle/.asciidoctor/diagram/rest-docs.png.cache
new file mode 100644
index 0000000000..74da30c065
--- /dev/null
+++ b/reference/htmlsingle/.asciidoctor/diagram/rest-docs.png.cache
@@ -0,0 +1 @@
+{"checksum":"e3500a52c420af0a5337450779a25536","width":1237,"height":835}
\ No newline at end of file
diff --git a/reference/htmlsingle/images/flow-overview-consumer-cdc-external-consumer.png b/reference/htmlsingle/images/flow-overview-consumer-cdc-external-consumer.png
new file mode 100644
index 0000000000000000000000000000000000000000..6304c4a33d763650066de3dfe85d2afc7d06ed10
GIT binary patch
literal 38637
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

literal 0
HcmV?d00001

diff --git a/reference/htmlsingle/images/flow-overview-consumer-cdc-external-producer.png b/reference/htmlsingle/images/flow-overview-consumer-cdc-external-producer.png
new file mode 100644
index 0000000000000000000000000000000000000000..df52a241142e937f992547d695e11cf8a464d5b2
GIT binary patch
literal 78892
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
D4THoj

literal 0
HcmV?d00001

diff --git a/reference/htmlsingle/images/flows-provider-non-jvm-consumer.png b/reference/htmlsingle/images/flows-provider-non-jvm-consumer.png
new file mode 100644
index 0000000000000000000000000000000000000000..0390d902a080cd5009f9b9795c24b6e7e396ad3a
GIT binary patch
literal 36164
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

literal 0
HcmV?d00001

diff --git a/reference/htmlsingle/images/flows-provider-non-jvm-producer.png b/reference/htmlsingle/images/flows-provider-non-jvm-producer.png
new file mode 100644
index 0000000000000000000000000000000000000000..98d31a4856301ad2e62687676fcbc643242b6a89
GIT binary patch
literal 45592
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
W=LLssEgOk1Iebt_Cg#A&EB_1oI~2tL

literal 0
HcmV?d00001

diff --git a/reference/htmlsingle/images/flows-provider-rest-docs-producer.png b/reference/htmlsingle/images/flows-provider-rest-docs-producer.png
new file mode 100644
index 0000000000000000000000000000000000000000..9f9ccd432c86a8dbe56e529aee3285096a9bad56
GIT binary patch
literal 38280
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

literal 0
HcmV?d00001

diff --git a/reference/htmlsingle/images/getting-started-cdc-client-final.png b/reference/htmlsingle/images/getting-started-cdc-client-final.png
new file mode 100644
index 0000000000000000000000000000000000000000..4736d615c6172f61bbea0cb580fc0843d7170319
GIT binary patch
literal 29859
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
NMp8i{{g&SI{|BsI!oL6j

literal 0
HcmV?d00001

diff --git a/reference/htmlsingle/images/getting-started-cdc-client.png b/reference/htmlsingle/images/getting-started-cdc-client.png
new file mode 100644
index 0000000000000000000000000000000000000000..447d7ecfdf50029e7037be5f8f7f831f43d79e31
GIT binary patch
literal 73373
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

literal 0
HcmV?d00001

diff --git a/reference/htmlsingle/images/getting-started-cdc-server.png b/reference/htmlsingle/images/getting-started-cdc-server.png
new file mode 100644
index 0000000000000000000000000000000000000000..7dadee02cf515ebcffc12fab3f0cd4115aca270c
GIT binary patch
literal 39245
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
GbNwIRe087z

literal 0
HcmV?d00001

diff --git a/reference/htmlsingle/images/getting-started-three-second.png b/reference/htmlsingle/images/getting-started-three-second.png
new file mode 100644
index 0000000000000000000000000000000000000000..f04d2a1c7aa6182ef70ec0d55ef167706af70953
GIT binary patch
literal 41948
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
LPsN<LdguQG)kZm5

literal 0
HcmV?d00001

diff --git a/reference/htmlsingle/images/how-to-common-repo.png b/reference/htmlsingle/images/how-to-common-repo.png
new file mode 100644
index 0000000000000000000000000000000000000000..3f4fbd5db37244ce5bd59c53f51872c9962a5d59
GIT binary patch
literal 104779
zcmdSBbzGEN)IUn7sDN}xhk$emj3^*V#~=*dC0#>GqbQQ1fFLk{5{@7x-JlGhAl<D)
zcX!>5agN7x-ut`n{oH@<^T#<j3{UL6_FCUq`w6)VmBqhEbrAyt17BWFN(}?!+%*i0
zvk~X9z$dM0oKxU`?5@(<u4ax-o_6;vTrp(tIoxwLalL2GVCu<W<?8Ar%FF9yXX4=M
zW^c!1=4emEcbx_U1KY=1UEB57=NOpaH1`onn#wA}w+O5C=KU$*>~bjO)Hhi4S#L0<
z*kgjv@F;88FT%C+J-UwqrpG<{+=<O@lr2RV++3;N^GZ}1;=5;;P_?!lG{MUkb$gh!
z*KlTHOzur4=_@Dp9jx<Y0)cf5vGR{DS}?_4j8%{kPM`3g5aWSL=yqlY+eqHH`Vs5V
z)A5#9OIL^*^<QE0g+7*{$ksqS%q4q@%b^(+Ancwi*+{l0_~Gmo0rO?t%mJ(m@5A%Y
zR=u83Qj%e&WOM%@jbHV2s(Unq)DfTS?ki_EfwvLcrB{U1nX0(V)UB^>PMsKOyyWD>
z;Ip~fALfG59%?!2dX?m25H+Wi=E?PLO8fmNmM*L~TlUw4e&MWDI4+UpMe%QUP!Z3f
ztaG^Y?uhiX%Aa{dFI4tC``IFwh2A-3h}12!eG#hRju&J-JaYUmY@~ayr$C!tsfwu*
z^hKS7JmRyZeEK-Z4GwXEwWVrkzOuV^l9oXwEk%;H8s~O4<pOizIW6mxJDzfZ_Gby=
zzg-*G?|!UCNmZ&1W21O^TU#K9JyDZ4*z-2M-cWi@pQXccsRis-cBS4EzC|KQ@q4)6
zoVn79&*kk5oHfLA>|0#6Ni&Wuu5Ebkepw3hFjP8w{BcC3D6NL~Rm=QiYH__}sfGa2
z<nkM^i{S|=yj$eg^v2`gTBv^Dc&(*xI}xjH-al1uYDe2YWIK0u^1WcH?<R$x->9eY
z{41#*i)>!E85IJLG);Io+AW*R?a84UBaNhHzd@AEme8KIqd@C;|J(OI<Ey2;tCxbL
zxjzYv2v#dy2~*%$XSG*+iJu!qP$X9*p<~W`7^ZW6-Md2=Pjz8{HD?2=Sa!=wJGvQC
zn-GK>Nj875-h8b%TN29hV9^pbMp6(qT|?oh5|}PB#wJj)s1+vyeaTm<6?Y5zDoJST
z(67{E(L-V}h5eG2-Pxm^jvJS}Mqfz;bk3PyTn@x`^oP(rZBvm{e0Td%ux;Azi0C@@
z%0n@J%b*}6W!)BWL&N9(t+R+ww%l|%Rmv6gvdzJVCp$^)BXw6whbrIE%<#mKKPzFb
zJt*`TS@}{a7WvSsSpPWsh49OBPM;qiEg7hk5MkG@5QvUSmX6c97TlYB?eUPmFof~)
z>+q}M0mE}TGoLEWO--yBv2J~fn5DgDBYl#1-yh>cXT0yX76P!U12E*JB-QT^EhgdX
zllGUN#8E_id?<5vd|m<nJ!1kfT95P@p>p+GM&e={(~!QmAynZnSUKJ(GuuaJeHNlm
zlyPy4&^Al8&L6Pym0ZI|o!e5_qJN=9MkwhS&47A*Vm<A??CN2uO=uE-<R`JQR_JXp
z{Uv_Jv(4p_gk?J=6<GE^j-m6|tiOH^D8YhX#6Uc(C}>9Cxoo%N^^P--X&^xAgN!LA
zhOwL}7Y2$Q149w@Y&+8gGF&~Di!>*+yOnCp{2l{??+QOT2AUKjU<vbhVW*Fjem`c(
z(9Wo~GRPDA+0_9#E({Dj`S7y=kh2)CgzCb+<<uOL4p$H4(jLbA>kD-l<FOk-wbciz
zHa7Ef-AG=;D($;>@2aXwE@Fl}j6h*w)ICFKV+6y%IahP8ISw3852dH4Pfkuov#Eq;
z-jSET@E+&NMPXuG42(O(W|$06Oboud(yl6#mi2L;_0Mb}At9#oPWzj44<BNg63CI-
zT_MN72)fdUbqj%oVI1I?;d$p{fsy~=T9fJgvzVBegoK2|M8*HU`0iqyEvm|7W4d*?
z)KLWrt+~I(^dDCjbi`m#eWs0pK^aAfivfl?05jPW8{^00d|kcMwb34#B53*ZZj0tI
z{EzlOuqY<`e|@kr>S5GW<Lk=?#S^>lWOn1oW%)5hvarvS%F4tPBYL>eix*8VMKFrm
zjIb_WP6-|pu~B~|({y;eb5OHAgj?#6p)h4)a>q3#?sO7%9OTrfO$m{wx9~~~e^o2@
zu+@B?j82?O$ZbPp9C7vPK&ki6K3fXS_EM=)F$}J-uUDG8ydwMb@V)mA4{z<w7oOO+
z7J^}^mH5=cpL%<@M#?3I7he_^vk}k?bYz6VJ5#Nx&@pZ6#35%fz9xslgr88N*iQ%6
zN(I|TUA=6V`R?JKrOV3F@Z9_Noz-4$D+BNAJ6;onF&d2tS$tVdIW+%R*e*V|Fq~tn
zm6xIDAC*!&6K|Qky16)ljBGzxsT~VvF6P}qhp7r$K3y3s^p2!6F!H=t(JBGsKJN3~
z>YYK2el}{I4i~cZV-*V{B3wO+pdP>5$7{hTal8f-7vJ$%=$k6;H!O3Rc_*XSP=!f|
zoXn{ZRX&to?XRsl>48OtIplWoo0(e3(ZZAw6^T{pu~)Yj_m0dW#U{UXejcwKA9m!8
zZN|pNIbQb2YeuRhZZq%Y5gm|drG-eVFHBACp-ArR1)jn9Iu-&WzZ33uu8&e270et&
z08jt4>M|qFSx|kG#wwhY=_Jpfa`OX@a+0VUjj&zEb7p_LHTZ+~r?XSXer~t9*=%{)
zq4vl=d?<K#Bc-+@&#1kpr&Yuu{ct^Qqk%9nsalave{@8jgcvQ&Qt6)K0*4d%f3zRo
zF4?W{Jy?l}gbw(pZ%?6~`yWmul99=(AmmoJw-579_V1;U#59DZkoc!H8;$#HWIUm#
zV}RDWac*_Ij`Z<aKADUjZ{DKDJGaKR(3<$9foIJ!=cUHAA&zPM00@g?qDUUG*i>6m
zo>VP)(z}vv^9@vH<rhU^lE-fgU1ko({7>9EcU+v0D}44;RFa1J-a_tKqPw76Xq3bu
zWA5czURIDZ?sOT1!pJXco9*5QlSX&{t2c<>m>3%3LRo&cB3XoP`MNZ}nUa!EY1N^X
z*M4lAVL}&r0?Q2ZG|#~BRxR6nSY^f~PCRp3zpW-ZLW5284nMHR-Q1rgKm~9U<hF|+
zq*vK?yuwNL=DB@5RO`PIDZVcq{nT#LSylDhI*)37w$Ae*iG>?pn<)|t(YAzJ-d^rw
zr7HvqIW~&}M9xR`LHJP~Av$v7H8l|>p`O?b(9grOosl8sHJkOJ$zqita)&IMNV_+4
z4XVkxcHbvJ+~PbxTcmz!9%7mQ(lTtXnppDl!6o)P<@}m4F*+`yV;Ts}o<9%@ikzP>
zf+mUj?a$p%D}O7ighfq;bQo1w8riD>gVg4Qu=xN&p)Ru_v!Xzu^YVbM(`h~)8p1`@
z@_0XJ#PHwWM4|~wcx&>HWWR#QE+079>JM@LtjMeEIiJ}y^<fLd_%n~QI1>9|Mqdi|
z*iw>Yh3A}cDUNr+a_Z0~g_(AxJMq`w<>_6Vp5_pK5Ed4;D{6epsN8RAUftB0c{?_a
zzSltmHiPfV-$+^=3ZvjXmfp-hJQVBdzt>`M(&Qhm<_-JM?k8NBHD8th>3!%a4<)s5
zk&%*eN)Z=Fcgf2ypvD=ugJIiOa%D(bqFCBXA3~%Z7*qI4uLLFOAPTOdw9SnpzA+2B
zJQ;ZLV#~k1K?OlM^cJ$!t9A0_gxr>^WVfvDO1HddwqzPxe(_g#F_ypw<-QST>_ivN
zQepc@H>gIWw9DNob|y`c@Gm&56*G16J=)S~t{q8#!fF=^+ol;zZ?O)Bb&XdD39*$p
z9JTuHxQ)~td35F0p7_3dYow%XH<ta@Xy0EL7p_pLp`0Yr(Lf2?<bZ}OTkm?H!u9*I
zdir7ubjHB5#b5n0jn|nsfu25GeL}E3H^H2N6(({04b)eG9Xc3YMy1TvtgxK)*Asd=
zE8M`g#iQ@ynM%b6Iq{~N+}_FI9xqq!aKQvtv=ZA~zAn0_e<g<~>A@0DY2LU&ecd>n
zEEd|xvig>HK*}|Fw{IqMdozz7-7mj#b(V3e-BMQ*Vbe85MTShb-&;@F-*+eRUuae_
z$}_B%vd=YMD->Uwu}#ad8LN80)A%w~5S|56H%PJLB}?{UMtjwJ(~7NxNL@bOOqS5s
zcj#kd?flUpuQ@fps2-!zGSTX3AsIpq?9RA*kIGs2!yy^5Kf?6dd&MP7UmNDfF((p-
zP8khudhYthQFB*l`<!@>XP&iI@ba(TXg@&|Ubo=waJTh4PG0fNv%J5XUsUucA%W!a
z;{%TsL*8@HISoyTlRey{gB@`=)3@o?`r7^87IIvI(rid?ddna?R70I+YpvXWs+l4q
z4_z@fmaJEL{01z3hvm51lcV+0F<s;L3|=~eMAnk7-nzY2p4bNA{L+?t68vkUPib!i
zJ7jR_SGs4;Lb~*L6FH#8>V{Dy(l+zco*T(xzWcDXrq7wMVXv)uo{HM5{u2@9ety1f
zDJQpG4|jJTH<LLnspt>=F#?R()_C+`6elYWXEQQlaZ_!>Nx^UtZG5RcoRVmGv@!Wv
z;xle)>DM1&%7s?v-23Xd;s+pu*Z!t;XV}Gy7dbdMD3S5EI&f*4bNX{>3F}t_Fnt?R
z;(Ygam0l7iAgUz&?j3YxNX!j(Z*vao=_3kGoZUlVrh28zLIjb}vu6*|^A`Gfy?4K1
zruy->YZqB1lzEgNryOs_XTnm5qr(qYcAiE=#E##}>jddJoPE;&z1Y#F)zn2;S8Vi#
z7JuN$@VMVN9y}{!JqmGE%Hw#o{sq&p>#|SE>_P2r!%caiciA_EU8Z+I8r$FABD)|t
zA}5GqUqXS!D$ZC+h(P5B2E(Z8W!>BoUgA(i&{ccy++S<B%J2TE{z0RhiLhnWMw=<W
zy4!pY92NZG6e=_{on?)Oc9{?%bwA?_kLxGK#9Z;}{2a~pm|8(W;m2?|y-Tyt*$}x>
zW30q@QpgB>uJVc74#j6ue<k|TyT$xqSk7c1cZ>hVXSS3ptgIJB5aPZSuU-Yf6P^bc
z2IvtX2Pk2mPV9nVlO)c#)ci^Ve4o?nnV`i{1jMmNx|=NDf&eD$>FF66(QmYt!Scd%
zkVcrA{rgg3kSXmA4&y7YD86b=<J+AMpD>Dj{X+TU*3V`y^G%}W?EIt<Ox9Ryk&uSQ
zst03d&ak0Lr&&^-=>?m743cN1Mw9wppu8}9woJptdpe$toaYce-1jQcvtCT-tl7oA
z+M{D}3V0TN=}ZbeZ|za2&us^5qxU@z0}C24?0t=bVNd~DX@pI(=gP>Qf@?gOO<_tr
zHkD)fQnb2EBOCgXY{bQ)tNz~}Bk{+-EiZ2$t?c+N6;psxk<;&^yuP)76UXIw`~auM
zW89baV0$YG!oT_TL&TxZrAs%6XT?p4kVT~h1<Xtshll%M(#Ky(5**HJ@rDuKsIPDP
zs;Za{WrA9VQ`id?C-5=4uAygUl_yU$XOF4k@+B@Uks@O<W%O0`OAFRtE;nSxCVa@E
zjf9+4#)tZ%q8h5tqsHr*C^C?al86cllL@=-PV#tj1&_@ZqqaE3r!;$MSJ}Bn#x>1G
zKvfC}iSJDB%<8nx>Z&sGd9S&N;?z3sTO==8q}eqLfdOpkHjpowo0~h+b~HFmPxent
zd8aZz=5r6{O&@KrpdD+jtKQ9b+*#gI5x>4T>{yF#cXq0KUU!*^9IoK)y+79}ariCJ
z|Ky+#6xofLT0-WL%9X|;61r`iNL?nk)hE7$NJ^M1FSPjfPJbDynh=>@qp7vy!7sTo
zRvq?obj}cAlX*FNXe}7lfd^N>d2cTEkb-Q<f4Mx^VYFhTCTUC!`x-i?8!D@(fSB*e
zOzWIweAq3CV*eIa?JZ%|W!0N*J-_0&GY=r6s|dFp4mxHQn@RL!zkesiYkm!&+SD~!
zX{9fCCh&;YVjLX$Gz_9at+*lj<kZxo@3eM6GQ*?Y&z~i04(Si$m1#v>ud!@j7V~oT
zoq93n963}tv-1&$jxOo&=%D&&+cfhgpVO<=2%r5TYl$dW;@f#PiTKsULKRRT7KVBi
zM^yce={gr~irv_mo7gx$$ZN5TZ@p~Wcc>H<kBwDR3!k8F-VVMfU2JHWta6h-=7CWj
z^M_HX>?9M5ljp4q4CMZG+9>-p$>RxniKz*f+Lty}fLVAf`}A5Vy0Suhdk{_@9tXP<
zrFP4`mk5@sx38#8+1+ABj#j)7wbe|g^pdXol5~&_Q5?(2{?Nt%r-3Ule~}u={egW=
z+ZfL|^Y=b$o@r0vIzpxd53Ehx;n5!$oE_=+I-`0lk$+1Gv$!%@I;G1hFbH|gi^)tu
zk0ta+gg(8q6cV9Z(Kl<GSF?|Zv7u5Hpc=emrp2k0O4Yi-4GGk^F}81bO(5v}1rr{4
zx*Ksveywh!ZP4S-Y?oM|#S7X6p1e2&4y1bubi3DdQ@1B$8hx)9LZ%*dcg7MU{WjB{
z1I&oM=WiN=j?o>UpkNDw?o220${V#K_LOMy0md$J9Dl=P@;*uYC^OhTaXzQf>Ru;K
z4icxplTC$=IWFv=D>-K9%Q+80oMQmHGhROG=}V3wAncA>W31OTL=07VYSj9PHAu<c
zZ$L*WQw?!)Muzxp4Uadzbqh&3IXnx0{Ws#5rZKl%iE<nRv@6ozr!W;g8$xmclu7h)
zhUg8C8kIv#-u*k!HlsM+lQ~f7sFKXe%gb4>pu$`{mUL&(X!OFc{cuTXgBCncp;+zA
zR6PL!VI0W|deP12WjiY3dpY_ckTnAT;6lGE$q$S~m_HcE{0xFwhCXzR^oR{k`6mUY
z>ai+M?M32=C!fAXlt@{kW8_9m-x8YT2&@c}&_$e6!EHN-;x|3h{Am}k@(zFxVfU5o
zg^g97L7qY~h%7j@YOZ1lfReqwo;Ek9XXs@e+E6YneK6DNt%-6s7#$Zvu@@7e(Ebrc
zmB~Ze#-r!(RjfCq8e>WnNOL-lgm_G7pA3;u7rW+k_DfBn9kFjLXtmH$RqC1$_gW=8
zf^}Q+${5Z|b$Oy!D<wKQAiq}Ng4KW#_k>XW$4L?#3gnO~m(F-gu`Q0@dh~@<4QE-~
zAV>z>sErGH{hMo11}YOiA+tQV;cfCLuNGQFh`jdE5YhEI@L+9%UP}uZV)kgN*wM&d
z-1>cvZt?1%Ws2Rr)xA+1A-}$z#PKQtbGZPwqrPahV!MvT>rNWIa9-Z_b_pZqC2nr9
zE0@OB7y7}pQ;F^K&y^;8R5GP2G;6X+j10y_x-ZQa8-IxG4cZp86esCiosq~Z_Iv?S
z9izi7hzyVCW+(lpH$)=zWMn)mUd!d@*%b;3+(Se+*4_1b-iS4+1vP-w9y~Oe2LRUb
zY?_hW(%R-?mE$=5qyf{zrl+)wTI*@_5tGlYeIw6!Tz<d(NGBSr;4&>r7opY&R=2p_
z0K=47s_((R@DTCQQTB?8|9)}4+Rm~86LURk+^=h(&+5L_O7Ct?guwG5L2AM@V{lUO
zgGJiRLy&=q?*tFo)g?2)2~SryiaYFb03|N9FKa_<s|Muu9fTUSWDK@Tnt_TvSN`cb
zF7gKJn40x;9oxiNWkK!<8rY^Mq{*J_6^b96PN+?#uH~-@ZCvZaey7_==s)Q?-?P@O
zaw2je*y~Xu6&Y!dfZ+z0k~sV-Jj<Xds@3wQ_tt!JY^<@0=6iOi^>|$LNp}0-n>6mL
z&=3MpE9}-M`4!*_Hx@HaYWILd5?Ug*TDN1aA-A;MI~`3vJP|3eK7Mj!0h8ri5FfyU
zH+!jN3CGnWUSF;9Y!B_uXkX~7?yK~Oe2AS=ln-%RLmQ#&Cudfk*YM~GA4nXV#SEbn
zBn}3@WMxg*+&P%*P6=hM-Tmmkv)d#gPT~Ecy8w{bb)Yb`h@1@B@_wp(g#C#63gdMq
zrZN?JdiY#=x*JpGpkR}lCK=7)EH8k2q7e$VQ6b(GiFFMP(mu3&uk!Ri10ux?o%6n8
z^&waTSMVUx&JgE4IWh)5Z1s#Yj+rPeW<bx-PrZ_*!bi_Y{xc&#8=<D}s$}#hw^I-;
zQ-8-hZ=0jRnW@-P_*s1U9mLgh(o<PyYzi^GAEH1Bi{Lw$f9Kzr(@H;yYa2YgvsP|&
z(c%Fm#kJE_DRrGsWN3@45vy3(>b^oHo4}hQ`_!`jQKKbdWiq7Q8`~ubW;W%EaVI#%
z@+55cw(k!2ibh|x-zolzr#W#y%)9dwWuLq;8r30l_H1!@|4rOz6&fi-mn4@?<kzl1
zGJ^_AUIPW2WJrduQB_WRCYU%*XwuC+HlhJ*>k9>t4BG9en2kXC-4KKA*&Le<`7kZJ
z3-!(Kj0Poib#^2V8rX~FGaL2y9j5C*W<f=ek}gJ@XZIVW^sd`NLlp2&o;pR@-MB&T
z7h4h<nnp!HuE3vDwYRsy)?$NbFimNOkasdno50~Ne!KNJ(n{x<b)U5LWU8>wXg6m)
z45Zh{{l=TJyHo2(w)EV_whNtxcUW=xf-awF@5e94%!#9t*U%-M3~|TxD0Cj}QtYf6
zBC7O;$8kBs^Cz-M$J!%>8#jw~hW09jBL)Ky-EGOEJR`3Ubuye;E%~YQ+2l?~;=CZc
zLwm}}M_p@yc&`vuL6M!7p`qxHI<%r?EhGZPLP)!(49yS9<qcHQ@Tro!mP5kXFGXEl
zR^8F6lu85I0;<uXLUX~^w5{50!EsXh+G3^=xA)s6n<V*|k^^0*bMI6gPE+HZp^Vtv
z-o?DwwFFC(^^iMa*L!o#<d+P+HfJlGr@|sE$nfC`OErW@gpKG>0XpW&l?b|{mt0Wm
zC)EST<0l8VwFkhu#*5p=ixHlQZnp1!V}wsHUUoU{g&Tbl4AJ#6ChJ~cWjuBZE3rMq
z%_h;+6gLd!=H|cB`|hB`-cj$S8*3h6Uk{^C*OgwD!Stp^Vq)}E)T>udVj?33Nt*6F
z5$ED&+y*k5R`$y@AFP~Abj)Va@O-Z#xFb)jPBkL$9khCwD`8kY6~1%Wcu27Nu$AH_
zH#Ee4qESR&Uq5}uTj*n2XSH$?{@bY{Rx#Ppr>Bt}joz*&(9%UX@2%7E6B<_SQp~;E
zOt~EaWJ+1WZ<Shx@nhl1xt*s4XGf}$v`L<HC-uPA==Rfk88%_z?qYW%y_!R0P0c7O
zg=f2GTpga}#;QuSY`b<jJL%y=nZ~!dP?E|Xzk>AVllB%>(>gDGy1;dDB3X*P=K!$u
zsgluDJ<v&M^ksxz?{zI|XvkEIixPEpiZg%p@#E2uiIJYS^QUJ4bKOnV2M%^|JTiMb
zUQ~?sF5;OZZ<H<{yfdmE3GZyKAkbAJ=m88(KC{)%NyNq2+WX|FALr6ytyO2yvuCn;
z$M(J<AuFMf!rk`LV%xawm2o{UA|=?9RiNFB9~ic;u9|@51QZb|^Tn}h!;zPpDUVK>
zdFnI?8?nRKO)iAx`>(OB5UBF#O~<i9q>4X>oyUBS@HgE#q9&2CmkTrfGeF2_Zhnet
z;#KGQY*A~&&|F<DR_bsRk$(%Y_0(y=)dL_?>LkIjp#zl^$b^1Lsw5LDobsZNxwBGT
z7b~}mr2HKhNb2inQu2uQ48FumeY|jfx8^X+b!oL@Y`AAIKn5C3w@Q8?zi9KWon2Am
z#h4{IMAs!je!<nX@)KVFJ(V?&t<TZ^QRHw^!4SZj$o(C)G-yv!P6l}_@W71PFb7k5
z+_@7Nqu4bxxK%X#>Kl7R@~4+wnjxuV6}8(eT<E*rrfIRcLi-7`;;HnX+aUuI@B&%H
z=~4+g(DgZIi+uGeiT{yG#@Rq=;(YBzo%&;8!SB_^S{5A>*c3I?z7N=CB<*mIm0}OM
zRDT&So4;O4p|UI>@lm<GnJ`&TN!N&c3hu@JJmjp0g-g&|NlGIsNRI<R519!1P}`6?
z2Y?qxak$^$*q~#!)781DuX$hMvPbion8Rhe=5@Kbpx?PXFI@&V+e{w1@p!v*T*T~r
zoZ%G1vS(dDO={<FIs$z6r;hOMqJ880SuJ|MGPOg@@$wB{CQZM!FwZE8$C8$9G~>nZ
zw1B1=My?Dyp6~VJzGe4IUl2=mR*kf}iH<2eYWED2vI`4_wazkZAMV7-JUiJ$wksv=
zw|hi~^{@tA_N45#3OP<ji2Cf-J|;qy@kE86$0ouv?I>ouNi{m0ema4bZk!rD#@D<y
zmq#ZWDAG_294B?i>R=c-fuN$`g$O<pm&YDsI$U_1jkQF~=URB{Pt{j7zA(6Y_(F1W
zQZY#9L{j0Escc^NU89WBY%Tk{9ez=OAJ74i)Zm{K04fA(GwXa@?2~+dv^f&edolVd
z{!Z~OUZ0<&B(qs?EyrWz<ds)Gy%j-6y#j`U05w<}p<|evqPEWS9B-4mEsyLauWP_<
zxK&Az*Ops8ry!h5=4Jsmd_-GSb@LuvfqRjFcK_4p=n|mUUHoWc{*vSU{;+GOv&rsw
zu;XvFA<eQKuG#0?Ve0kj{d7#@>3oi~(r6DQ`}<X$$F}}Z5NqTTx-@q5;oQ=iC2d=w
zwTdiFEd>Or*B~e8WbB_vpj>2<n-(@20obV=sZwgfQHi+lsTM)WYBx0Ds%{zmMa#(7
zVXVqBDLq<zt7oFXJOm=$b%vEN7}hq`hm9kgZB(0G1}V>XIyu#4ffi5Y8^?`Szp+kg
zb}{6kJSm#gMIGoR=opx?tefy>pH<0jqvQ1ys6fA)o7)jsJWu~R-|Q)Qe);k;K!gCA
zl93BfqC(Edwz#>zuUz|&v&Ea2G%4R7A0FOVDy0}+kwvjbu@as@J8_*j(WKQE<Vb^I
zcBfj+cd5qQMM;7Q`uy61U0I;YjNNj?dPoAlxDf?3pdS(tK0LJMO!%2itdZub2NC>_
z58H#jt5Nwx^^fqQl~C*mg|0JbdU$ArCw6tn>2Du<J{Y-;M<T2wFi41$OQ@5(#aoy2
zh5EZpbmk_Sbnnr~NARt*cylJGiBuFT$$6mj2v6g0vaU-24QKDnuS@4BqcVXQ%iLyJ
z*`oaN`GZ=qr)N;LZ9qYCqv4&vZ6sZn7_L5le?<0F9IM|aL7t~(jc=Qf<%WmmoE15D
z>@Gr_KbH;Uq^322AL7<%SU{8S_h-+R0Cz0^W@ERr1frp3=qAQ;XXto)Sr%wymG|}>
zPo*n$RNohS7#6m__k-R3d*B(KPTceP@bdPtWhDh><iRJlNpe$dmG7hIDl9=owM3Sg
znJF(Xp8~ASCa3=Mf)~v$Mo&*q3qVV8gZ&M*u}0=0hK&@b!dBT|CpZ<hLOO@y=&31?
z&=m0`1OoB$<<+)vJdX!_ulUmV-tbvVN@AM1R0jO>9-ep;t(HXs35zl40(ff59N)e7
zaQHmBA&gBWnbeY%g~k3!<t@s)FI6dFFN@OCAH6R(xOKQt@Y`tA|2=l6Ga24jb2v~2
z(YSk;q3ycwzN?LmO~IY@HAT*-VeF3qAHzSs{FqKgMi$<>gw+&z;@)$X21!wbTUsJ}
zB3$3{bP*S)^d^Yx+i@4tGqA?^M`!Yv8Gtl5<h|YDi&yG70Fk>nYY{b9lvZAH`mCr<
z78VwC(a6Y1*rm@Emm&@92+m_){61u3HNJ`9ZolrXjX$jjnAm*i{;h9&cHH9r;B((^
zUt=wm7*%Hl9u%q9-FS0A(?<)YQ_;Jft|IcAFab4A2+pXIK$82l{_QkL9N#Tiy;I|L
zCyQCEU5fmh7$)I2FwSc+(B=CdoP}Qu;K4Zkl&~@2*QbdOAZKq;U>xFV)15b~qs4f{
zNk}kI+u9Kb*@_gAU^4s={~GtJQQbPmBmQL!2K@*3>yDQwu#?aIH12=+_CNnIgm-Gv
z|2V7!fzkW(c-3kw>55T-aeAIxl-R${V;@9^VmGwA0KH^@ae@_#!w?R~!T5F&g}v=q
z3w-mAv)@1cNa^(J)6-MVVg>kPwqTp!m0<@soke3FlwJmAyenp1ZNSt6zH=j(x5}{A
z0*;39$fa;z;bI)0<sx{*|Me2aN3vj?#c>PD)uO<=T3QsewD#AiaPX<p;RC@$%;Ni>
zWUR=^$S&grMMV*FUHEz5OXpGSvL=9NVq#)WO-&6wVFYge_ah+r7Q#m0P7vN;ku@w#
zi<*K$#I`S6hTsnHntvQ(4<Nnf%g-UjR-LJP8#5wal)yRsam-#w;te)bRV5-JnV6aB
zFShOX+?XD%a8o2bckW!S_IoBSt}j;C9EMABva%Ft%mm^qT;~K#K0X44U`~H+(3r2R
ztSq=&D@Rwu$cXnMQaRCLmx5U)oRGx^$@yOA#TF(p91c%SFDtv>7=Bq?T)d{Hrn9qC
z#9`#wQ}s~T<HwKDQoOu*0RaJ93;iuXT8id!K+N{zXWtDz9a+N0zed(*lL2a7rOhuO
zAaLc%<Vd;8y?ghlh3y84ZMEt>sFZ>8^ORn~Z>EiQO$ZnbOiWB{Y{=A9)48q;Nl8hI
zLY-Vm8khMVc7Okq9KBKn7IGD+bxJO(f`bK@f=6BaIvF{+u;1bC!-o%B;&`7tc@oyH
zR<4G)h>xFi)6*F|f~IC)$Ll+w_T|Wvi(IOB;8BVGGZ4kXV0(Le=K{ZVWhjzQJ$Ue7
zZEdY<hEppy*bKNI>3J4~gTuoIi-U#a$ZWk*hoK_tF3Sway_q>14R+N~*x=w`>JWfY
zbG8;1Z+3OHwFh1iA`1!%qyP<j@A~BdHqI5eLYjOtHBJH9AHn-HAh{v4{s}>4dAZI>
z5Dy<8A0wmWzR%<*qChf`5Ka5Hmxco$KD;R=mhtiHSK~R-3?TDV5Eo~~Ty4mVi6Qmy
z@bJ`9R*ryhiiuTAGD1Vlq#m#H1Ia83lF@l(Dgt}(;wrDPCqp=<2L@s8t((UFvUTz)
zh@paeVLsvS-q~7PXEyNn=Nh=UxF{+qWrHIx&wr(QC!Org8Q>j91NhRtl&ui56%9*u
zo_i;z0%c)iQ$)weM8}9+GUxnbxzJ*QkQ9dlZrstaG1DFw7w0%qrfTS-klCq}a7~`Z
z{oBXK^YinkJuZ2rj^k~ut!{Am_4})@b`c2)HUjbH((D2P&OjU(_dCdGoNE@gQqMq{
zwq|yw$%fhB;^JlqAwhVgJ5MFRK79B9Lqe<lj=bF6w^zT_PYEG=5*|S^w6tFn{+R_R
zH+{Xq!owx!n(fasDs>p0ZcpK@%~8qhRM*sOY;3$l$ye9i?Scv>y5X@L)2x+eI9h1g
z4g_rR<J}1$%4TI>rM=<4`1%Q*vxi5VLJw3cRr3WgE<Ee)TPx6lBj&Zay0#X7-Q`WX
zsL)|0#BFQ7H#qqGLg`kf&;`&2@#CPu|Fcc$=P&-5?p$jaL<0nGQJjt}=6SQf5)rQ#
z5b+GNwSP-GJ=05E92`;oTsU}Lq6Qd$%rlPc47vwA0~Qumb4v^D>!h5_hRv06BYjRj
zzK-X#9(niz7GEe;YmrE{f5pfX=^3=TzWzwIP9aTtQVth%X|S*<)u}g2BNa1I#8H#{
zDYZ!3Dy>W!eDc$Cc6N5>Jy1P!Y&CC;@#9Cu#s)#o{<A#PGN-w~Z8}q>K~Q)+b1%t(
z+!IbbIy?joU4k|}SMQZ`-PTZ7Kkwq{?M(r4pcUY<kseBcAbbBa@veNG^_1MaK*CCS
zEUmAPxXRAMlgw`x6d4(rm*?o}x*0(&lFp2cjjfffO+-#^agD0fe)vtc)S_;UkEfhm
za9o_$-Mby{&6@0zQ#D;oOkP_BK|~lBjF0xW3dp-bKmyfKu}Qz&Svn@}#S0-H<Sq(@
z+TGi8TN-i$dNBwb;>Q{q8mS%T0&a6%(mk<pas5_>ISrYkl^zn?17^j=#lTl=`|>5G
z<pq<vn_F>MSW8>d4eCWgB-c~$JdhAb!^Ovc*3*VpE5mwaPOsNLXXfYUuT3;jkdo@x
z_*}nvQ{U&bLkAnkfo_MpYalkYdl=kD{ZEdbT%rZBcmH6iw7R-F&#2bHH&nOv_3PJQ
zVe#<rv^6(ViMm>)=_;9<o6E_4DtDPd^@CQY#i3$FQW<G!X(=htXcjEYWl(YL>eWwn
z!nPvAx(Ki7c*_#IK_+ojQ&a7FGpDmBZYb=M6(JkZuL3;83%vrpXK6`|7xa&0x0>{p
zh@RfD@Z8*I_C4EMx9WoMskxx4@2+!lD*8P0-*W$2hiT8vDj{LyQ|3AsRe;$w2D;Yf
z-VNGqZ*PlxZ)dv~a--PcUbTKlAUU9By1Kf=efNDfT17zHLHnkuscBVJ6>wVmjK|ye
zW14Qfk^Bo2(9p0EBh}Q@Mn*@c41|P)&IK}pJoxQ~Dl;SF2Mc`Dep&jX@jI?0tV;JM
zB1BGaN+*W%#dC1`_T1ATYdAPKY;A2dpQE|%j53y1Q;RyimCVvHua?vx<wRlm%E_~B
z(lFU@%I63KSDY<xumilxjOxs<MP2s+UcrW3-`L2=164_0!n06Dw^8mm%g0$kTsp@h
z4CirFbo4#$#_@5ZF4&pNmoHNh0Gy|#)!)^nmS_*NEm1=VB(}0f&w--2J_e#MlIFVF
zzFm9!&LaDd`2Ue3AP_G@!s-t;-!q{K0`fjT|E}(Nb|$9V9R1|T3b%#Ws3<iZopP@&
z8(v;s&sO#+b{ioa92}J-Q4K^?Qj(a@u9Hq!yudvLb#-+e9UVi%v4QtyQ!KGkEFfxt
zX$AgjybPXJgz8F{kCxhdj7yRA?wv~VP4*f9DJwrXz~@_dYp=yCHCKZemq}CIXCDEi
zlBS7)EBMkMOFb|R2d*&D5K4|#S5@uYoa^@9oc%U2A?Px#Bu{Q_rG(HevD0yK%I~!D
z+3b`B4{W+YTATnt02L9D$&qu#;^JaQ$6W$~$Pa-y{;MBw3dmuGhBd|?9{L^ayDju7
z7wLOlHvkC2&TcUP6Fc3gOCI-`$N)D~T1JK=f`Q`V#I+GYc(Wv4S8hXQLTXnwL2a3V
zn!AVr#%2;4<9A%LfPtOcC36SE**tr^Zw67c!-iCNnk>J#mew-|Z+If`Ni$sLA350V
z0$QE9$OztS%op5v!-bws&?3CZ$-A;9%=VzG)PrU#et4qNpKohH$iHBZfh_H88j-Ol
z#z)GZmG@*D_w?^!@Qa%$kA3yk8M-tNiECRfc}@#BnUvg=5&yWmQlsycK>XPz`|}s5
z?S7op<1WjG>yjK50W}|Lwdn%*8h@f}qw(3v&+Nj&mc!yZlt=CU)hSgK8+>~|8)U&!
z`AVney!nM<G<m<u<!!o>@3a8Aee9c2_2E;om38bN5$0qLzDPqWAHP4IvQ;itv(p)W
zll$zC-&J73FV?+gzwTwx<Uydc_Vy<Loh1g?*hxR#^368BujGL$`+wb;xuh$aY*SWQ
z)w=JA(ZI%AQiEILUyZm3Zc$GB1k-tr{~I_Cn8CjZz&YGh?EirIc=!Km5+1tvKT(R)
zw$2|%fN<d1P7QVr4gpF$z_3K!YXwIpMq$4d++QevHcgmcfRl8d`Y`PG8od=khsyNc
zG;OHtA>H3u;e`_5;klZ3kJ^r!e|gED>ZhX8?oMkAfW-Op=dbee_KRoZH?WT_WjU_$
z{?1zZMS@{jBh`>%%XYf3j~eeZLqtU!$FjL-L>v&`ZiLHBe0t6dQ&XE<ZwRB%>(6%g
zSr|_fOV7wCPJjrRe|iSeR`LB}fO`uqT5UG@Q0#TzqXkf!Q%)9el!%Fr;o#<h#<yBX
zNYq|;nGUBCQqbWEy9*d<7&-U)_BJRX4jrUOJG$}x9V-G+ARavjDPnxqBp4Rp{~mBb
zK$=duAjW|Rc2XG3_h5Up*1vXhulWV%xxm-i*-Ac_@bEwty?6h98K{tT53qNZM>%O>
z+S(A4k7raV2?_H7Y}0|g&B_W53E_`dGN^DR!kL_!l5Yz0()_)2R}~dQioJK1o9Mi=
zOG-*SR>tDv<DJXZ9%bd`y2Igv<t~<iw7@Y~BaiqGC{VPb+Nuej3Oxp(Muq#5sN+}_
zK<`4I8GumPYQqiHstn!bN?>!)N7UH#X6^5LsY2|BuGQC4@|!-AVSX`?-Mo(xQdS00
zO|{U@0KI_^q)M><obombseVGF5-ZHh%L~X)K0Z}>d3osykAi}r$v4ZvA9Hfr&UU;m
zctZ&8gox;QbTmv=^}Xv{*Q-|yg@atZ-S4#WCYmD0%Uzn#U47^t!S<Vl_gcu;B=y%`
zXc<0l(YuRK6K3V&vI7X<?Afz%yhfJ@2q;oAU_Hy=>7GA-&dA6()0RYHBw{y^Z`+^C
zdRa;tQJ|C4FlVFnoUjQY>ef6y?!VBNqZZN-4I2W~E?436$H%xYRG^ucHQAxX#tftP
zC@_4HkbjVK(K>)ix(Shexdxms#;ZJGF-Fy1LO%*RlLsj1@~~%6uB%s{HMd$6mX_`e
z7FuR_p(iHn4To+ch><%B{du{$P#+#{?xk*IyU4f?^OD-J5-%%jV@u1zP_Zrk_EENq
zXH^0JDR*iGe5I@Z%NM1!Vo=zY=z8s5q@?hQ>sPqS4+gMaM!kXDE7T3^7RpUE2mH4C
zjdHX&X9N2U6|Hv)A!-OULA$`)2%EuMKNoU`NE;_qo`C-XkYTR8zQV#H&7L+nJ*|-N
z@j0_Bo+kJ}e(TDWD+5(Uk0D!qdX73h3@umJv1ZWofc?rrp|LH+6jG%S!$C?o@AC5U
zI(wJc8zl1GXj($fC3<ntXKJx#R{Hy06@V20W>Ymsosx!zD=C!}dF=;709?&t;M`+K
zZ^45zKXS|~M^_%`-oZhOmz0c55a_I3t5bA#E=XseoSCVtsECb?)$PyAZo&fOQaDkW
zwHrXU$?Aih75eMW>6?SeDJz4pT)XhifJm$IO^qc0x4>B4+aN-+UQW+cfqq85GnfK{
z3s4Q%AMgUSqi$^hE|*;NF~)cx-voG%opRn;YNkh%F~ug-Jt>HamcIv0lmhuiDV~^&
zOhZ!>09z6FMQwYyg3qN(my$)@<^jhqEG&FNK+l6K63wcd0D+_b&mcj*AAp22X|j>z
z_B>o%F|jhC!NJd(drt#5HR>M}QJ1FKFYs;7_3!g+Z^$Ad(%;Z9_4Pv_+Qr5ui!VF-
zDk$$fIt7!!rSF9p44#X~iqX!#o?)R4s313`+|LxgFEfLiYH4ZtBq+%1{(U^Uo4bJo
z;#TU23IL3xq#kW4_Hl4>nwgp5;88LhML~4~ssOa%5D-wyboc}whsUnW^53XsPUhO_
z9sh$sq73BndJD(@P9)9qz3;rY7Y6~kXrlK&?A0=QL6%|G^i*uK;|>TSwUD7Xg&r{U
zjQ{tm?iK+$#;iuWbKl;#EhGVQwqgb7RR2i1!`SGa>Qw)eV*qslk&E~4e93Q?{&-ma
z>M0xlfeR=xf28MO095~<OLcn>XF&o35)Ytt9j_!&*JjByucH2>q33+Z$NplK7p#5`
zJO+-`UyRX7@aKmCW~qO%zNXe+-+USZ6p#Ncg-cIOWdgaQy*&@4IIvNr5<p&eF(A<3
z5fJRGuTw#szK&IUXRHH&7(#XP=FQu;Zv(X{{bP;q!SZ;m(Z0`AGg;@Sf&zieC>F)o
zU}iBfF>EX>C_vH{tyJ)QkiY-}2bs)OK||w()yvQ3^IaKXW!->x$gKQCK^S$N9bkz5
zN6pF8*x2}QDJzVMiJAG%?c0F<X=!SfnA8UuRJvRD0~M~TyZha{cM}s6zP`Q-3k$sZ
zWk8*J0z##?rw3H=hQ>w(9NS=+pP!$R?-pR2y+C%VuBw`DOY)v*j0mIP4V7^iuQ3p1
z`L|XU<&XjAef3`o$gCuy>;C&xHAHh;8)(h^J>TYkyCKOYE<U!ud3fjp|B|5?7xQ>%
zE8Cz_lcUyi<IUAtuy&x(r%2=s$no49pxBN1?igeqg1ZJlp=(0-;Y^CZ-(bPL_0#&K
zR{ovU#qzv%=Y3^%zm)To!2b>Q#{J+-a1IuhhS5=jF%1~ZjE@qG2XzgJD={%~wu*$$
zZhm5-p096p!QIMaZoQJLEi5LS?CjPfWpJR9#*2Ax#|v7fV}m}9@~EPsYbq)#d%7;u
zUv#SOzu$HGE}Ee^sCKaaEld$2y`4D#1Kqb-Lq%ufuy@{f&g%369dVBa?Z~|Wiw1Mj
zpyluHFApUKtofQef>_JL&5fIzyV#*{s2by65(y3}1jYVgwlj?liqO{9zM6Ad-5Fol
zo)<;${xh|?G$(tR!)?ZEe1SemK@TSHXswCf1Au~4U6$`&bIjYfZ-H6}f(>L3VQ}SB
zt*i)0Ww^b)y{Ddpk@OLMFzm-e{jLd-wG}gX{Xw$60OdJT|4s)xFRxL)u_WNsfF81D
zMaB9TAn9}vSvfhrGf5tYM@K+T;JPHIq!e@MQ(N05eEhA|Rmz+9S8?clIzUeVSSrH8
z?sWl}=l~*SnZ=Rv!cK3@>W}}SUIZY2irE;ia()NX*uO|J2FCwN;Tov*_YeF)NJ%Mo
zYxop5e-v+~z<SvBFVuhO>2X6Q2ncP`T-{<o$?V3ebaWsNBanIz%7{i#>ffZNf0_d8
zr9{UQU^6hO0EL2wKK#TSS#`8M40a4DR~8!T>QbRe|D4^El8<vJ_QJu%nHdqwHiT-L
z413ExqAVav0}X3zY^<T70e>DH^LD%DU|A2y>OV@Mpr9atXUCwMuK30RXa>*u(|EXp
zfFg!~LIgT$HTCp{D?L^K<|)@_zpbIARasVcI?9sLh^)N4osA9ey{R~R!=nFC-%lkW
ztz7-fbacy8Q$kK(>%bWmrU1etDfYa7|IwpI;8Eos{~MKOnFC=JEeBW#(CkUrpg`P{
zp;=s767yKr2S_wYO+$l>gybJSK{-CBX7+hpTtTXc;Szh>TL>n-KNPv~H?uyHuD0-b
zupbBHfUsRcdis-Q&b&`k%EU;J{4Bu&@9MHMy!LMdyIxm!EBbRxax%|6h1Sm2R!&}C
zt<$&LK-&WKMH2>N<_M37cyXzZ5P5ibShGL>E-Nbwq#$ok&(@?HJB<<46ugFuz3)yH
z@(friC=g6c&d$ytE5`B|P?3^enbSnO!a*Z$)5=IWGi?YYW93iRsy5K9V`oVx7zPp-
z&;UUSAW2bFR6N+6W6mSaIMgvxQVItI1~@BJ>Znt-J@A9m-uk@-P76!RFoQpmsEO6m
zP_f!xYodtsUhg|C7iVW6+P5c**{VhcLAI7FR}`keqX9#r9MrDOt-YBPqY}G#pQ<vQ
z%n>_bZ*OnKI6`DoQxhleBe28t$6+7r5(0Cq-irM;4jiKBB1J>O(H}zf=g*&=J)@Hm
z3i9%Bph?&E_4EWYcYjZ%LFrFQCf60?ctYBNgMjAvGjS5*8d$d>uB*XLwU_+c`qH9e
zz;hTh{)-`7-9gCxmoAlEvRdAl00R}UNZiotS2~@HQHCoxBo8bsEg2XXaM$b~94I<R
zF)%Zy$)jV+Dt>qjZW}Sk;q0Fv7;K*fRp3uWsah`@l^L`$*4Lj2L-rf_9|1`j<i8Wp
zb_h5jV|9+>=4>YjTP}bk`w*u{5(?TQm%x_Qz4a+{J@`QasP&g<Mb$MlLa_gUvIDFk
zu!r)|tRcd3j>I=T*VA`7<{kgeRyg$`<WiC0;Rp%;ng-0&yIvSspj(SUOzdb5nX=rM
zqX!rkz31d}k1<bK-4B1t{uc7`A+A-*@T`&&O~mZV3NHr{4%qIYfMfnA63v2W=;&Og
zroLfZhcTxW+J#;Qd0q4|*~K;B(fqCyg#k-5f`U`GHiv-g7Q$KECRCwN{1ELfKRD`&
z+2Ik2{d-Z(!`|eD0?!ewC#)e>v&Qh}eF06RPvt*%3L3dmdo$d3=p1t`Ap55p<!@kG
zr-AWQ34G~>=;L4pmBsCz`2Mj{AY2&)be{j0<y+SY1fc15gC?K({j&30?IW_ZltN8t
zphsc+^Ta3HVSp3kbl^mZ13^sg`O9N=)$#~+aXD#<4v}4oe<*O&NjI-IG)~(MyYKj4
z)JXA`@N}CoSr_^d{6PJ$6PxsEX1AVVf4{UzTiU%NQRCyZ-fw$s-d=h5bBWMg25~DZ
ztM;a(GEzxE?5KP#<cEC62ewY19<$is3s0uKnlqPZWqs%OA(09{3RVD*39yr!GA3u^
zQOgoGoBux*u$-7qeW*{yd|;Qi70vH*m6TIa!r;&1TxShWJ=?jYD(?=qg%T3pH8kY$
zrR6t8$<n{y9yWLYnS%V=K#~GvB#BqENR}leEG$vTHr8xx`WfRLVf&#;D~;md!Pjp8
zF3RW8J+<$Dc-1$i?U|sMX=ne50P`dO0|u5Ycoo8jmKM&R?u)|j#fRzAr<N9y$LPRs
zMyQ4cp~HjreXL(4kH?1kC)RgP)X)JN>KUJ|ZEOHVVWG-%1MF*Ixd^s^T7G#66z7SB
z1!`Ja--$;22wWhFDLW)uy>J}}CFA_~@gq>tO6-Tz8$s0#ewVFVoK;g}xYX6B0Ssm+
z&DU?=h=_@!o<BDkJ^r0Qz)f{@;)9eE%-t8f84sR;@^1R~qP>NUjuF=<qoNY^T%QEn
z6o8WoV0|-(JW$-Fq@<uwsI+tgu$O_E`^BR0s?m4DhaDH*Y%Y+2L~3bifz*GnzpsGx
zOjkqUKe$84$A6haeKpS-CZOni!)h;D3BN;7ZJl55`uydT+vw}+^a5le>N@MRIPf04
z0idX;Xkb9wR?sFGCY(5=UN~Gu!2k++!|z=gZBB{6YY^k)Y%%5|rJztWBA|gVWL}A?
zQUl#BFA`fV935AHIVyaO6`BJ$0<dYOl~wCO!4t}g`rO`5(R8ZX=)6oy;=Twx<%~Qa
z*r9EK)i(5)$}R*3e05<*pC2L)tg=X2<NEdM$;rv&_9eIOAPO981i$3Md7Xe*|HI7W
z$NJUe@ibDhX$QC*=(#y||JK&l7wS>WvQH_q<rEZbfTwWkXK$9jc_TyYdo3&K`ga<U
zczEMRx&5hvqm}t_bJMjLS7?A333$e29w-_F7cUa;a27K{Alj!BA95~|S_DekmMnGv
zJjuS;9ztYx;t*b;-pJ21f&n4$B1dx3eUk?Yk$M#1N<VCz1y}+H)LNY-ZEZ4UfW^1?
zzH{>%h>+a?AJ~j54ji|Ci!m=_hN5BQ8uBk&EmU8ZmI9Vh+`t2vhYq~u)29w{WP*wN
zJ+U9T3*)Q$sdxP^ue%`<NHEuc&wk2AwX{-hdaC(U`yRO8>26>L%1AKw?K^kcQzVRl
zaRT;%SbsyF8tCgEKi;-(%>>T$67Jt>O0hWC-(pJ_Xv1QSmM2E`@Z@CwVk~ilGk)Mb
z611YOK(H;aI*DOFMO)3y&FkyyjZbOcaYKdb7f;`0@%?~?wKZe{O%v>()~*%K{fkF{
zSqAdjK)DOj)d%d%1Pu%^adEub`LB#>{XjgBY$-Y}aB^@Yi2Hg)(uw)__*k?d*oBlP
zZiBuV@7dQ+P946|E%viXAk=mMB?g2!5)}M*c{LniFk#-DY*2l-lRU=Oc6I>XD|{=+
z&)->b1k^=faM97x1>z7Ke+?u6+l~`#-2Xy4Na=Q99Y8L)VxBfG{cWk#9;M>ILn-tg
zM&J3j5&z$PLg1YL%7*sm(4+%za&vh^MTe}eU81@sH^DcRu%-|i8anCL@!%AWo|eOa
z8{b=y@@uI?jR>oMNjuL1N<IT==aDafkvSeq1Mis`7+zIX=~tcu-PotH&_CLjZa{!A
zV|a3W1jfcpwaliMBk)7M=Z3|-Z)NZaym6CjRI*QL;-jLN;=rp&1}vuL=H`HQ418-a
zSR2fdH`lj^9sPmhy3{6RZEY>wkO`WDbP6qmyhQ)%HyXi*vi%=igS!++sp6eck8zOb
zfUt4bz#u6;zT9VT9lXaNdo*5789^-bQo`Ra4axkg1*&fJt1G%^d9;$=d-46y&=8Pu
zEG;aWrxb{?Dk_E=8twt;h0lRj2bw@i$~bT#?KV;Y{SpMP*#OC8Yb)aEQxM}p>U5Np
zWzJL0tE*0+DG7AkfHP`wfL@QJx2^T{%s}r2atz1faOukN(LqK#;7|ONc)&$e19A`-
zkt`sH=gyo#K;WjW2|{RNkmG>zn$T)77XwJg%a@eVpL>8X0#qyDQhc`8es3zRt^Kmo
zYNW(oFEA9s0_8sp15$rPqT0{KD7Z(e36Q|!8rTo0e>!X!Z9&~3u=bl9Ut+oSP)~Mu
zceM;XrFk5qAfRjadf<m=v9T5#sU{{SzzyKNdbP}F&l&h9yIe1D&Yeq8dIJ)eYHe8s
z=yUM(J^DSXQ>mKR*=4)t2SKK0W_Ez^2sESCWU=9v7Te{Ka?q|-c7M$j2va4F<2*?~
z-u=^rkS`@hhSmS<z?zdQW<!$m=)VOH_R^aew7QiQFc+giO)V@a2)aZI*4nnnuckc&
z{t<6*E-4bUNbPSefD*<g9v2(CJ=ZO3$fB@USOdll%monagx&_jK$i&UuUemK>C^hs
z)<$0G{9AD_srS(R0#aqhI%qBlT?g4?dUEo<mshfwcV8+UK71ZT)Qe^UT2W9~ofrDJ
z=N2~FC2H*k1@`X43;$A_7@?pKM9c6K9k8F@n8Sh6t4OL)`<Rpl;&h7`nb1RNwf1iU
z_?KDTqvu$CZ`T8Wn=4CE6jD2zn>75UQb3#6A4_NZ)nbq*BqW6Xw7Iz%v{FPl_nN!>
z5Cl5f1@sM+H3MX1(Vpx({pIo;2H1F#i@L3q0N(D>)APMf5o$e$s>sRR6(0C`dkQpZ
z*=!;rTL0snO-P|*2JM97mB0ds-T^A6Kj^jTvMhewF4Tw61@K{Ot?P~qXj|*j3S&cp
z7ezR4pbSCa&d=Md^@4^2HK)^t1Hi&jy?~biTAP!Iyg6#YBG9J-9jsyp^9*_uSm0Um
z5tyf4X}=K)C*gw|&mmh=aYhMBtW#q{L%M05SC3HH@@VyX566Xtp3Lrryjs6CbOUJD
z0B>cX2O`0<u|5&7@g{_XjhviZp+yk%n8+aqNRfb?mx4%M`v!ghx;Xr_b0sSag$aA3
z6cQQ==BTBmh5ClOT{IBWPFoMC(?u>MpO!PSEs<+lh^{jB|L*l#bj14ufCUr|j)$N!
zKYfzR7-FJOAh;!@fgnytA|;MCyFr0j_?hS0Zmh_0YJ+8<oFZN=8%YNm8wD-fV$LL-
zBl~|x;5>k&KN_R<m&Y)?|KImk4%~8Eu;azb<^MqD@b+t}L6QPpHvdWJyys`r2f)j%
zw14Im*APq+42S@WY`fhG-#jdiNd74K*sC>V(ev5Q*0Wc%pgH&JYz&Q9VZF;HGU!{1
z_tUYl>oGW)KT7s36+pF$u+4oH>{7~~?iOl62-JR3B=L^V!}|jR2$zGAgU|175ER~i
z{YUo!Jv@sx7>44UO^iyj6yLdYBB9(Y$d$Q*I@zf_0~&(<qbUGf4I)|~P@D$)v<+pH
zO+JoqNPxLw$}s=Kfn1{a&f8KP7b<yo!GB>lIix9!uVMWbsEc{jr(Fwi;L60668DZk
zcflXjwblW2AUCYry;A%!=pU1J);iB_;{Ox#?l=CgMNDl%+W&A?UjKiD8hQ)>H46sY
zwm<E=C=!9ncCRItJUjn4B=J^kzv36`d-j@=`xGz#Eg<;&zS=n3x$@XJUDLmk5cwD9
zbEtmz9bQQ4cRu&^&1=ZyH){;u2WE&{_t{(H?3aFL{k50)zFH^ZT^2A0hHC^}pB=op
zZ6E9k3jM(aTMa<F(s-d|r1ZBejdytG>Ze;1Upxj5g`m%qPAkw)Wv-wQst;ZzX1b8j
z`_%DV&g!JPuC8t+$=}^%!LX9fcfUHDhez&l|0lXgy$zBYAXMj+;my-)t*7sm`hMK9
zoYnuoSbOhys{22FSW{c2qJf5zhEcLdlZK8&ltO7CBaZCQrK^-xMv8+<I!Q<}vQAyu
zLMVHbE!o)z_w#cO(zx&Y`+Gco{<t3J63*v*#_RohJ=dFZbdEgKx_{+?P#GuSP$v()
z!l%ne{(ZK~OYy$YE?Z~^7AXKW#@JUCZ@0rFD`0S_w>80j)ULUoQ2llhOi>O2*Yn*L
zWt}kt>QBWm(p-G>-$%;<0bU&2781;>=IvF(C1>3~7ZvpaXx_eEML_-b5g=IqZ2{_R
z@DlTlxK>5w<oVMe=EM<D2O0uf7LI8mKxS(|pa<OXr4m%RjX8b@`r4{|{MfPea}IA%
z@e$D6YiMO<WvaTd{38)W$N2gfFYY6L{(obZ%57gYV^E}${JZ-4s^hPOUKthzmEHnc
zr;Ro`vghUk2r&tGysD}ST3Pi_l>?A7_jlILoij&3J9!m1w}9-SdIAC*%?!C1U?p#D
zbm)G|xKaTmXfXiSf6weFTlL!{EV_wMXx+Geog!sHvaNi1<~<aBd(Vtd$8Im{CWhlH
zD_7vLW`1dK@M$cR5fZu#aJ8Tj?ZJw9H-704YWBJYR$^=?MA=0><x8mFUuX}37=H<n
z8=A*wpZPs8i|S`!WK6zr;lk|*2-oKyUi4?v(&%TLeAk@c{wW9a^!4@7d`8b4vMZuW
zYgK4M)nV?34k(3n;GzTTf>oH(Ao@$a36Pb4<?7a@7Q9z?_~qb~c}(#(yrb)0v*hpU
zAO@!Aq|!Bb7>&fM>vz4pM9`nD*>mFqbM7pdvaBZmr{cRhWd<wj$>NCKC|R3txI$i6
zfSP=D6{|WDssft|L86Upsx(0Jx<`enTI^`gn17E$oMYx93;1Ei6^n5R*RM}+6?HZZ
zR`v4p!@$NRYYXq|;gQPV6ow{Z)=G`nyB^EjR!J;B_7{292nYCqUTYg0^mxt@ge*Mz
zKH53};OjSRP=mg{xR};gWmB+QdH&%O3pIo6uF+_;C*HF_!Fttv!X01t9zE2jZ(er;
zc4y_~`6P?hX7VdXWuB9?Xrm-rU}`~+<Rx3)-7RC2<;|^pDGE{*Al$FS&ll>722vLP
zi$s;+;NUXDJHTwmJtjNjbfy!AluI?=Yd!&|xhJSCAX|YKFu=EgokSn}-lApMR;Fse
zu)j@@i-W@lgW&D6M^#h~Z}1$h@sjD8`x{bB2z_un0ZhY$i&+zNgC@;RGmNwzI)(rY
z2*5I4+o?cJplU>AG)cG1RolYC!gj21El~Q}_Af*h4PU-|0f>EjWnOMBx2$d47Lfjj
zRTr;VVLd`0z|;(x^1(|aOz;Q12plLreh@u&P3TLlX*ElJ^9LBZMmeiMbJ?EQ?M9>7
zqZdq_0&PdZl%HeqdM<qk&cTEM<f+AHANdv<0jX~3343#Mb6wqMH*cmxNFmq%Wm>R!
zv_a`B*a(91`<sH?xg|{Z29egI-V{=m+Vg{My1VBA{8+z(%2Y)Z3<@c4BpE{!;icg>
zF3^mT-4W#d%j9kWY(8RQ&M#1!8@#lXSeFSE{v_AUB|^_w;@(p}NMT1S^v6}yd0V(T
zf1LYk`XJBAP*+NIjunEBl4u*oUhgE_Mq{s8Fl2wCogpieZ$4i*{_jd4rG7ls-{Yk6
zFzT;8|MMBzFG^x+J~83Uz15DQ-+!N|W4Ae}jADQ%+RU*}vM`);3Ss~8B~~8&J%3qw
zqTL1mB1!MUz>i@Fay!(#TtBgPFba<^|95@%OviVKMDU6jTZwkBCs;fMNLQFF-uSX5
zekf>4jr=dlIP+#E#^U5Rf7UF^(c!*SVQ3Z~CxTLbUCorIQ~Z2<6pZ=)VC>ZXTrJLX
zr8ji`W%N`Suh`))UKrrHPcU!wP@<6=b8&ZrLWUq-U-Qw2$<yc<#u!pjlgS@F(`jWh
zb45t47ZKoEwMzQx;17(&Q0TDn$evmTm(TC4-8oUe=8iw;`||03T?L+V1){buAZmLS
z$k)_jAiDtOItd%kiq;c2yw`e#FIKMh^z^K4Zno<EegY*>Jh+IZSsqfgXu+)-8$*@<
zsjEBJ+~U1iJ>@1;>0?~n$=K;;g})oeEH0xpmzis#pM7s@L8Gtl3cnSewzg<<5)u+l
z32+4l1laX=oDmZfYf%Wtw9UO_NgdG2VF5vL@sju{2R%GIKw64Hq6ro=P=YMK2{tPI
z`FD(XLB9<Z)R<w);_>wJ+k8s}SdH-UH7oYqWM$sb4x&>`vU)oU91o$ZIr^s8Q{``#
zoqa(oR-9Z|X&~yn0Y-}PS{(&MGJeW3vB&0mnECdOmD207W6z5CRH#kU0l8V%q};;V
zSm2?wXwjmhZ#K@GKVQav#Ma7c07q@nTITKN*Mjl8<I6jsr_`rUF&i3=s~Sc}zgNyZ
zqH5vWKm0yt`rzY*yV%cW$H};<QuLQU-pR6DK5Dwj@_}@E{)%k-itkPG+xH&o)!Y>p
zt6x`HpmWMuHEWK>$rW7cj&4HY8zL-t!xrS$yo!%sQ&GQxV}|c*hq8{5wC)B)C9%pF
zOFiA>z{f``<#Gr73-h|^Zrhc(NX|jdt$nTKjc~yg7H;ov(o@4tX5aDUS~vU4k=3LH
zTwGi-b=#@S1huw24SV)X$S()@&m!a0<S|C_%Q6w_Dx>Oxf>+RGVuYQ^$||UxeCo~I
z5U`g3gkUt9KWC0cl65rQ@G1~%2;f$T8J$v9{e-!aB1Q$}3G+yJam(=VaO#PrOO|BR
zLPG^}3oLV8ZEmEugO1`7Kd`D)Sv7LG%CBo!Qtp&jURk*{4LzN_d>TaZ$2NJF#JzlZ
z=e*Fio)|OLtL85vl01(vu95Wpn{o@eUV-|YK6B>co66MTmac!)M|uki4u>^nAD?=5
z*}(cPmh*~|ELlrGP3!D42>3{;ao&1!LH5`87;twyP=s_1V&K7!_iVQ^b<KuU^^&Vk
z-b@N2eXwlztEQW0tPD9ml{@)frr=%Hjb{s{90`BO?L<=ulBkcAl#~R05B3FoY!7e`
zXmJ;LDu2rx4lxm~X=EE5y`tK!GDQ47{nGTcY)8_bOnZ20m(0S^eCLKGLUS^P`IW!b
zP<6jOu2v$wO1^u0{ac#+>PZL7lO+8_B9%?<Y^y@sF|N-eFCsgpj%sv7EOL_Gx!iMs
zgXxT(ope3Y8+P}Lj_H?1<LSpgmMaX`*5!WUs8UYf@PRhixnLld|DMCeb+o<Q4_ywh
z?tJr)_3Dv;!)puQ&f>FpT6Z!yx#N~>Ps6C*NY~;sj1|OkrmxCdr=pQ719ug~6i-xd
zVyq<&=?^7lxSVR$_TfnE>TPbKHL5XOs1DS}`2LZktz5?fxoXG0cd_<b6U!l%I*z^E
zUc&pw-qfgeb`F1X$>OuC4mr^O$(ZIP+|063{Rmr%{SW+!m(zFJ?W)_g+|i81Yx6VK
zns!kUD$6~V3_&O9jc4zSebmYu4NKlGW*L}qm-YO-@hef@vD3_9JxkZzwQO0OV<*@?
z_HG8!^og&Ee;dXW`4#wWhp)~qE)|%|hFdPCo)!Z5<seQV1rDr15;H7cHRcPMipb?K
zKG|C##vc~C?&RbI4T-FI)EP1ADN10&5+CtN*V5j-aqM$dbRVB8LXAtgmf^T<W;09u
z9DKIXRGc=;uEj5nI6*-}{lLe|t1IHWeES6oU>xqeoSgainl;PG)phIU&Ft%dE*JEr
z%+ukOkT{Xp+ts!BBv`vEr%%7Nvs1|7S8oX1c0LP%+4Zd}SFA{}ym*mnn+pm_N5Lfb
z>({UHLHYTV-|jT!+YL*;WFC6^R3f;r`QV{LITy(2dtiG4da`fdzkz{)`MOZKBmsrO
zYL?h}$3hf#m=268)=491jC#A-N-3r$c6>P@Z{NNp3~Ck@#^o`GLqEqvM@#s6+Pm(o
zo04^Z?5fGF$frz|wwhfcLQK_bXvsEx;k*Z2U0u=8Z}R>I5K~l2av&-J?riAOh6ZjL
zklu*Xx}~UIIar*~`>o2!{Ou8NwOlPZ_5q}6A+fRQ9#68e4t8R^-zY3BymqZleU>+#
z;I5gXIYCgu0O9sNxPEl27KX%Oy4%Q$JnsR25$cOZMG~nBG+2;C`f1!~KM%Qm3h%c0
zmO|>jD%+e>*V=`C)`!s1QVJm&!B%ENy@otIfmrxFGev}iUXmM01G|(RmAZDC@paF&
zPD+0EY`>kRn%ad*3fkeLqMq#(QxQJmt~)J)d)o3<x+q3TN$&>___coY^Z@M3gGQ4|
zRWP{Y;qeNN9ac7Or(*Q4T3TA@UD?YCc92^5rix;E-tG+aNFbd2{r#akg*o%35t2e@
zEal+vQ+!IHta6nvEGlZyB@yrTR(CIXPRBWSLsCy)pE2Z*5yeA8L(ZtmbL!@U%thM@
zIc2@9Dv6W}7?BVMEnOOIR4G~Pry`K6t*MFDpJU-dA-Jod!#p8I6*a2hWM>aj3%!^Z
zpn3FY&AFd%L%bggi_!aO`BVOQJk!{HRcs^Ir-|QVJfjoUa<pk5dCuwC#ADBRG#HP4
zwV^I)%9d+1&aOud>-2XM&+kNmv}fCc4^+3l<4MvQUzJleJ113!(SJIL2fl-&&5#5f
z^?PN4&vnyV>wcEaG*$ZgZS!~TA~T?nj(><-^1&5jXaFFBlR!5Sln>!tEryERSYty&
zO@`s>G9C$xV&DYUx#Je6QmIf$W1c(%S7-IrK7UT!KlgYuv$GGm7>_-XyDwqH)5*pp
zT~bnl4qq7F&J9<UzSq}HPhri>%DN4_J@hl7YBFnrjrPeC-p(`c|NBpNppHHAu#HUu
zXM1z=qQ;2A<}`O6!QQaY&>-encEx!K`0)D!>r{}w+;j-M2>MCU9XoIgoAFT+@1?`+
zqI32voW%L1r4M|3Ea?3v=ldW<2k(6>qL@e8@}u2u3^Bhy>e5E!Mz0|Dg*@lF>N24f
zTXK_Z+I0W^eGoZ#vLU(4gEm)>6#VolW@(6T&G6ipyj&wKU7-_sWD{`@d=Ws2R=Q9~
zDT_RNlRgMa$%A)?sHkLFa(ujo!I6_EH@kzq)J!xqG767~;1C3y?Y~L{4dB+TIV01T
z{45EzMLGNme5>v6eE)9HcyrmsXJ$dyL850F6GhG$2VjNw)Q#2{+Rj*@5{0A}a^dDU
zT}Y9<{KbJD50*HC+w;{`*va88*(PADt)XH4^}iWBJUl}u!vRISfBzmG1l__46{DB$
zG@6`WYsbSY<gEPJ89e7OYv;0UHOFPk62)U_N`C(2$=+A%NH-3x`ehwT9lz1}4xKK^
z;U7o~hCRlrV!&Soolb9OC;!HcLJt(7L<F|w#j|2Ze;n)MlUtBnsu5O%1~e9;+{icN
ztdZ#kvQ9yJq~gg36`NXHEA#W;tzR&C&0IG<hySgo&)b)ND*r*jv23db(r&lNb%8EA
zz|G+Z8xy=w-@kn$WRpOaE?v3=Ei?eE;^Jb9=7RP9q{c)Eg!YC&NNHjgIgIHaC6ZwC
zcw}<)q3L7emcDE^wTLGr^HESx&`sNhPmq<Rz6Sn(A&M|8)r6I(yAU=*6#mA=tdmyQ
zQ4SZz!tzBA4uh>*0rmJ}`oDa+100rj!kzf|_@Wmlw&T4YK70tAAiKKA$J2AWUcnQS
z+BDpa==O50$j>pe16j0AssbZJIks!pHEAP}6_AuRx3p|-Z)=+VLe9x^4{*2^P}ljo
zB08i<*Z#!H%1WJzbKB0JJEs^Zs~LRsmMgsP^{slOv4xjeUA7X{WlEj}`gSaJzjOzq
zi=0>=PuntuEy;;T*7iq}vS+5MmX<84ADbNg&M!sEe!2%53HML=`FHQ#TgJ)RKiGo$
zO|3>i;C<p5csmP~mw17ah?4ckE22y)X-y?CiFJZBdKa5rhod&VhQofaF!09Jhj^TU
z?PNr(Tf3G(MLphcbJ=d|%hp4m`rmpt`%^3v3u}9+^dpH>j*~hr<X6)dv$KQSKim13
zMjHhzmzj~#(bFS?1-E0tUh+4I*6d$?*QLI{kg+Il%;8V19v!Y$g46Z%>79v2f2n=O
zkerJeS5fZVd6=(z;lq8CuDSzOr%(ohgAY`rb$TtK3xfz4y%Mo4TfTcL$u25?9UJT1
z3H<^nSbvh39lam!>G*ib#+&3<SK*ZrUmmS-wdv!U&dnyXz;{CYjccF9lQS}pE9dFu
zt3EIro4gpWp|95TMOWit8;xT@d$@WQ(Jedlv)y9$Fv${EFr*&v7-_U0x!9o`r3VrC
z;lqb9$R6Cke_=$u;k=oSB<kj^TY)x0+5qd9X?l996crX}h+fNziqteU2{~`Dgg4|q
zUS6syDutDmNpK&aYj94jsk=;yfmnoa4&uIewn{ZI*}CVsR)m~o$Co=7n{-7lg?~Sa
zjRhJTFN&;yBo$K-1u`gFM37-zN~inW@t&Ne#@K!Qh<jRNs}Fjd6Inqh=$%0pTG7D<
z*BFw?-Cu&*h!lmoPRI;ycc!Ju`#s>=K}D7HHv06XFG;8~=Fy{FiMsmw9_d?`Ije;x
znYa1|y_cw#m6Ec_$n(P&IC1+MqzmL9k5;t;v<o^KLTPW&T`6Efubn!+mOAv8qZ@bN
z6P%)8LAnYJ1LOf1ys|8fjUzY(w{GRK{WL6rGTLK#{(NxG2RC089gS#>utZ>X-hL`T
zO+5SoLnz!NCl7;m^WFn17E(k)RX17r0kj#~Znn)Yh^_t{N2m6p<B^@H8K5k0&daz{
ze)(1{4~N6H4P5AizfDQ04%qv23Y#bfO)U&d*RD+&$PHl>&4%0%v`H8TyZ2g<ZcW2%
zZeeCt(!Q<k>#2$npuM0V(f2@iWBbfs%3@RA+gGxC_@X2RkGNN+>O?vfe$<af0EzNW
zgBZr@P(n2F+kz#opq3ja4>SahGzY$*g~8lt1^=eLk<q<C32%gzyC)P7^57G&008v-
z&bH#`6udxPS^12pU&N_5YpZ&DdL$$$o6C!fima`yZ~!Da%rA!|{YiSHQp%&CQi|=f
zH5Mqcst7j`-_vOgBLmDSAdN(aB+D9Lu!5pP_B<o(rifVBw+IU>kJ!BS(X!?j5&6M^
zcy{Ex^VP@xQAErA@!TzUO@pOlaB#59{$%yf5m_`NGjmY_`V?mqXvFW{6-KNQ+TPwx
zTeg_liL1wOq^uz%P(aUNo`CCzzws>jhT8>l*P|O1!M_yU11P$~$!;-^Bp72}FAmYt
z4bC6XYWr7x|83ajtVJ{acClp|oPK}Q%~kV57^8QUEZ1;fj<#0K;`FSk<1L`jh1&M<
zF=_wFsel|X=>Q>&pp9TT8pQGi+b)Jno=$i6<<g>OMn1b+%(Ggz)JI%x+4y6%lP<F|
zhaaP!g+6oC9jMjW%S~g>uaR%=-lo5LHMwFk7J#@16@ik2P0OCk#Xd_6dSU!zE$zjY
z@w@U`zm2G`iUZ%4DR$D|8#A))ja0{`Y#;FvlPTi|??f9LXpPK=R72<&uhum7zxJx8
z#dl=$B=zMO+ik9v*k^a*#AK9V@q?KxVjfZ|3R-Sbo$oE&^%o0lt^8!2?DCRWBRHjS
za1Q14H{0v`ip~UXY&jWBeEYN_aT(h3N3K}COQF>>r|Gk+Fppk#th(p+JkQM}lrhZy
zb>!{5-mpa5;Fhr4dSaCRIpN4zqXRxZbv12u*F%?GV>pP#N?(;fM|3P<f41q2YySJt
zz5m>pd%SHomOY`@85tSC*h^@3Y9KoyFmfVnZbE5zXNUZ6Rw6E|a+Da$<6AQE^J$bn
zhHCt{!!B;81uv%y&FnrzzU@6jVD)N7?YP$OzKRLj2&Y9(PcyI!TPZ)&k=T%F_Uzd!
zTrVJh2{s_FbO<W<?AZh38rtFPtgMv%8XCSoWP}|#p-Eg8fyOB19*8h5PR^Hs)ym{7
z?*Xdf15@nbU^R5(#!TU=(o+6FG9Ka*WeOS6qI_L55x&iHe}X35Xn5W(eyf`kahQCN
zTIhZ6o^MVA;u!ASxq}<|_U$=xa&kfWCFSKdP~5w?%(JRp({5nh-|-dgPmlF5@)}wj
zd0t7>*U(A6D)<eU#@pN4s$vZN)Itp}T_XSbZULCv$KOpKY(`fLR*8cipP*1>6na4A
z7ovhZ<r1>NR2@1L6=<K);N{#cMI#?9g$G~@BB}E!zuf7Y7#BQf2Tc?K7z2l4>hj=)
zne}!t+A;JefHlGG;`e;SUg~i}EXAzy1IC?LKEF3w{J3~E{6qT_iSsfSO-;KX(!!|z
z^Z9n7QEM2O5B`3*2=&}D=Y4dw(9h6_b(+IXaj?5-QYF`e7ZBram*eA^fpyoKNDUl6
ztgk97-=)XDc<~`#0?yoEgALUZ^}3{A9)52uAg8^o4Ul#fqCyB~_i1aR+K#ofDKpU&
zj{%#OnkP?UlO{qr7MX*A#!S+`g+Na@?rk~Y;p<ygT6#iVJ@)jwsVxnv*mn$bL*}`x
z%uIBchK7c24TKTnO9-COx4Jzg4XQ}i!ol}gCxNyrK|8y%>aDH_K2%|Gv3lE{`noz8
z(g+Klva&J=3UU&0i9u|mIY*)ykVT*#K3B;4ApbFb=to<_2a9Eu^z&_4((W*y?w)9i
z#Y7Kz`Z`b}7S5ApGyy@&`d0F6o|pi^b;JYbP|g^BS-PYeUfXNh)zz20*CNk#WFH+G
zt&*v8Ro%;dYUfVLoo}WB>a-Ug?-|d|zN0;F&roqa%};3brNyT+5gCGXo!r#Xpq$@-
zg;6x`R0|($Q@Z+<ed|A4?7D`l2y8OLaqg`BtQ*xGfFBCZB<irk-2iPnt&Tk9*1Q#S
z1z)~;E4Oep*TYj&zFq65aWc`ncFxagwmo@D0oI@H4Ei@vXGA0p-=qy_SJN9}D<l|C
z_`_4PrvmRAT|554mht<CRMULT_Aa&O-<sX<K;_rZ1hj^Q^HSOEh=!r0D<x6|gUl*v
zM2!1FF*qq&9a-hQu?!c(<+-@$9fY661_ynMI$Oa&GF?{T&=_A|L@`JHS?(sEw1rkb
zmkM{S{~3||__un?sBOQ4oWwFwBE&fltU2d3zGcgozd@|UP;t1fp59&FkfbDkI$_&i
zHwR0ALm2SKfY)b!h;*Z$$9JWt;k%rBVC=%|FjSJGMfX<`2;jswF_(1X7#xJLA~62<
z^pmfQr!(L|HJ~^2;NuPV7-%5~ledfFgKhP|+PivzNa`d;MUgv{$(tb5`2H+k_rLe=
zUFCy<Bn*#>xuozyXh1^8?KuXcga;mn640`>zJ7g71%|b^Zyko|MG-dE)^M+0k*tJ1
zA~hKxR+lB29A&wgv>KyBp_1Iy#|=w1&!tbBQZOZJDKPa>=dY6x;<C_Z&pNuh;jKfZ
zf^jf6BjZlGq0tf30?M3u^Q6JOSXlJIrSMwA@Z?FqAc?S25vrM_CKB694RT@GoIQIv
zC+FqPlyl(H635&4hs1HIsHk{)cp&~DW%dN3;nWF5FSb{S#nk`&`L`TIGW>CLxWi7*
zemkxE<U|49-e%1>Lq98Sk%6xYB24aRS0~x1D^``1G}YWXF<zpzt+obQ;mxIuB9Fh;
z2ov86H#H{^DDU(<iUgKk;?ZTY6g<}$&!Oc7JLlWCG45eLR0}_aU?Ksw_$taPJBrG9
z4c5y6P$V7q9Kfie)`=6%HMb^}?qNphR@d_J^4f2nq6~pf>bxupKB5Tq?TqQ;WW*vT
zVySW9Yb@4@B-Efk%XX2>>Le{~RaIV^z~;?SMkFYL`Ta62ND{t<zMFGG(gR8WX<oIp
z1<t6rp%C~mpoe-^<@u7jq|e30n2?B0p5l_@uL2w~nEAXD(*RcVos4G>XVZoOPkaD=
zim3#)Oi*~BQk*&=F+i#UMz5V!2LBrpdI|XF8&jP>;8Y1?(rg%AwO;Eg0|qNKNH(p%
zZMnI3X)Vezk^dk*0HG!X%|LZ8Pnj}KN-ze0%Yc!Q5q!p$9&1<-9N%HFSna-YyeH3U
z4Zv^W#=+ABH8><O+3^z505~uhMQad}1GtU($Qm{V<g8To?99vuB6<Z7oP*Z|#obrZ
z;Du!;Bjdj8)%b(Ki)%qIc3Co}>w=EtFgD^Tb|$Ktd~9-WE_y#S;|m!GL(n4P!4K2O
z^U*vW7yiXNwwxxw$7sjo`BCtMvVKHcR8{m2v}+%d{l4_U=+Sxp3`PTS_<LE8PvzV(
z;BD-kWzR1<8hrnKK}As6bV-%Tt%AGx&vr{%mX;NERAE}ft=KL$fBs(<WYizVDo`C%
z7RWEdZ>LqqR?j+ejb)tsn1NLc?OZ{3d2!VM+GLwkK3!6VyOWJySBObG_D%Qy<y~!9
zm<`GX8hAUGkWsS~xi*Wk>4U%i&`f5FnAH_pvA?I$xMgMEvf*EjN@2$>#c6LhuCLyI
zWlNLcAj5beFG!r0cr34Kpble$9U0UiCjqqLEaN;AQ1sZVzjnKpyUDi&V^TQN7ZY9d
z&pw|giMd{CFSI(6Hr}l!%x6p~zd%m*vFPmo<hcI20AYoD@a{BxTr4JxV`33poD)J@
z%vc*ZTjwx~KMRW>cMku}vEu)M3QY5OqNND{xa+goL8SWQ)~i<sY=f>SBC+c>pdxpO
zk+C@p;cAGaS%3c^V7Cyg2Lqbw(xdmr(t;WIGt1k;hZ6N4$@-+>oN9Uw@I1h<c)THM
zfb@N%yFK>q6HNM1fEYWti9cNE#$yV30j<AgZX?a~e8a_Z%3y!3d+J=16$mW86&o8X
zzWg9lk224XPj2BbQUTykxTB4c{Dj97LXbU(Lj&1x73}$!AU8#5rXVTP2$MByy3=*>
zDw7j?$O%)%0VSp4W;0j-un%i^XlRt&V@{58XpsKBabt`pyWj}^-Ff~<x7=vqg;NIn
z<^$k$TN}-~HmhHV8C?xwH6n;#)62(O{+nxY?4qJ-LHXBj-dyP_KNJL*?43>|kU9Dg
zZ8U*il=*sXKL!mQjk|6L5X>qUUtzK2qMu@<ndXVHnQHdb@uE@JeZ9deNKh>iycbYu
zxH2rcmM-mi&od$<D5#W(b%}J~z};AwEAXeF{;WZ^DeLIq0~JxRRewd==UJT+{yZ^2
z7~1U+5?W0<3vD@8#J1MfV`;$s*BtQRd>xpR8FA`C>4>9v^V%6RX9mdGYuUcV)z*tH
zi-{5S3o5CQsBdXOBx1F!xrRSUT|;A&`J%gQvuEG6F?UPjN-f=>a{2riL$hJl_|kA!
zsq4EcHWl<6?KK`Ps;rc;qeHTaa;(z<<#;n+pzT`Y(?XoDqN2Q8fnC)Z9m4WPFCx(T
zGDzSgBtplSKEPXPFp7Wcv4+g2si~=YxXnW6WnA3x4+vk{I@Ib<&+>l28u&y4Tv><#
zMDiQ@x?b?-Q5J)%>bogNf9I`d0YcH8SXNz}yUj$}cymP`fDFHbNAG8kW;2t`m}H1v
z9A<lzQ^>+dkoKc$!`6RDFv$#VJgaH2{y@rl-bNuO1P@6j36n?8*9n#&aTl0F&q5gE
zMt&43q4$7OZ1e}Q=2>+d@Kq_QR=rQ5BqD>#?}4`zm9XSo?W;si*v39#i3e&{UdISr
zE#k$C|Ib78mmpt2mLN`%w{gLP9hZu*9%$RN?l?cqkLqwzj6lPJewcl0X~FwTNlH>E
zX@6O0FG@>@K`{i<WZ>P=8tGQC%Z!_RVD&#*5$a|7SgeaQpS*an<@|Oaf5f@80glFB
zF8-jXr@_lpJfSPmJY4O!dUi#6;9ApeZS6qJI%=WA*w0F^(;Qq=O%KR1ulW=a!s}5K
zp)DvUripsf`FNjmU3+!{V@2H%E30N`7=}myB2u%TId@$pKaY%5Ry4&YLftXHa^-4o
z=|xCEyXGq(z~wU>OZ2=^dLEHzE1qIM+Gl?eJq7{?o7BTU7<BLYV_*}2(Q@*@MhcKv
zKjdRSz|koT%F|z|#hRRTfTBm5Z~PnGXn);PdW1b0+TE=8F$jsoQ`4h;Q(_XtmL;=c
zGMFYmXYSlqckka=3!@Av>PW{;IVTl#p`Y}lF*XO<kG$y$g%E@`lt6<J7}DX<PIvo6
zG&2x{$n>ha`<FI2!ibojnmS|p^bfu}aNRX=Z6J3_OG$b5`5P2ZXwgan6AzQ0Q>hn0
zSp;6~ebB8J_)MaHWA50z(y@Q>8s>W7kbvf%@zSCE=PS$pY5CV89sU4+tag*LGC4LU
zzohEMzJ9&m<5N{tZq_>|jo$zvp0BzjnU!b^KhLT2A=DYfuy=%Q^~n33<Zq>x;e<7k
zp@V1-324}u*D>$i_zyCRAE!zuRiek>BjvF~>iEA*{E07L+4hQY&co0i85z04bpu#L
zU6HI>h*&*%A=sWM-#ZCK#L{(`n{|A^s9L>5{H~0QCbiI&M^5WI(tY{d!5=!u>NLRa
zt0XsUmeHVUVG&!R{y_rK-3SB3vxvG99eo7_0KQOA0C3-68)!Gvn6aUSoXg~Xb%eHV
zJv^v&?%b2a6O$L5pgbLW-Jy^ry)@GwA+3Ar&S}J5{mZR1RLh7I_+1gfPrEu9@kuTJ
z3oaCeJu9(uB@}YPnOH<IS^?hYba!^P!NH$Ac@jw;Rfu<8<43r{aK2ztYx@5ELw2^5
z9X*cI#oZmM*fXFm00+aan{uh%;L0y^&t0j*qJ8Uc<!n$2u<fkbXENd@>m0Nv!LISs
zoxn0>r#J=<hn>~k8^x&Gwr}^2g|rbDL9`q(a8HASZ*fd8vqdyRUEMppP$3+!yTq7T
zN}fVO=@J_glT{0vF4CCj^PS&8kkRrE3%T%dkiImePRCo8gQpB^olI|}y?f+KWP$Io
z)2fe}XVtXJ$4|vgw&%{86;GJhGs}(aZa)>9UV8nqIB-bFH*(^@Gyq}CChvnIXR%QQ
zr<EgmXQU3}R)i!GIc&~%i4yKs@&ZfA_wWy=PM*9}O^Lt!^&gnsx-87MMFxQp?ux;5
z^!>PohGc)SQiex*eVfNsvOf5MtnxK-*>`Soo4t{!Z&G1f{&*MqMB?jooHUJrLnV5*
zQ{t}<#kjjG0VvNrw}O+CFzM!adTd#i4VV*ST&V%r?Y`dLwx*_+4@$vifV!5=_gAS=
z?>gzXqHsPZP#cy5dv~cyQEwQKavp3?$HZpP&=e&ePtLlqNrAY}ZqB>gt;g&@DIIjy
z$1qj=D)c}g4inINgDDAQYqOc;n@0o?_Td9Yr-Q=D#?`V|Spx#Ng^9LepYt*p74GLW
z5O$4NooT|{?CjlDHtn}&gN6e1CIuQM#ceWu983Q~ML_<oP6YT3JWxS2N>=HD(#Z^o
z82QJERa|8kHeC{>t>{vbnse7v?`zd>!mH6mxuC{L$Y_Jwq9RUs!v^^<HN?CmfJf)f
z`)vZ^6Epio8|a4hsVi-RC;z&2XAvBZt8Q=t1`u~KQBi0RBt~PBA#}%Lspv1cW8+3$
z$hx~?d!k>zMpCmGY9^j{cv94RO+Qh#t#E~H4U(H<$ze*RAM!7nnCbe3yeOsXXDGF9
z+)H};uZ_=d+A;<4TdE+8iGE^ID?j&tZsoa0cAA~uavDh6<c7pui`%r(%f|lrR>pnB
z@_yZ-f2iY>@#zwj+^u7`9Lsxo@;5!;<%}QX6y<grd96!2<06PdB9t)%v__Dja`V}&
zRuA5nk=(h+<JY&+7ol!k^5=~4_wSy4Eb+Ox>O@azWYxU|b7q_h`xTjzdrT}RCoy4a
z#D_2^OzM#@A(p$>5aPQDVq~;wy;U9c+og7TgBVTbk$vAw3stBm4O7(vt0Tu}s(F4?
zw1y{x-JaDtKNXPt&UFQ_Wn<ZciRZp!31p7J6`PK6QY^RVj-1g8@3)%bA2R+hvM9a7
zJ>~i@N1c&Zg5Ab-j1%PWwet?^<GyGMt?aU6K>P-h^G)A3%?)g-K74<a9^kmZ<=Oh3
z3kmt)Px?rKUrCpAqB_BB=tE#`3cYJCEq0{hahKa;xql-a%KLu%VZqFGD!~=|*UMSm
z9$6BnaqU-Kz&Q_TsbjHu^k##K=Vx~r7Y0sM-~8*n<G!=t`2J(sHWxo%Ot(HMx$)BF
z=&8Rb7e}3H*0AlRY6;(qoc{ZJV}@mX%(t53XL0h3`ty7L7p7I$n_^V>XK6aAbD}kd
z(^eWw*DEtQoPa)oyz2>WbBQjIkdN*Hu>6lTOQ-!&?kb9;Y2AJ#yCLSGkOvY=;sh;5
zC(aN)g6<uC(A~lM*tqO<^Kf6a{r7q3lh6!ZNp{`L#p7ocVC9+N-M#9G#E#yM>%U6B
zM)MDKeRuE6SKtZLN*avx8-F4$&s8#F?5<E<j;yC&hCvP*#8d2!m=m)uz_zdRBq8CX
z!7@0ke)a^8?vk?12H>Nv2&PYQgdF93{oZKuI{Oaw%sM!YDLe6HU|?|KMCqMwNF;uN
zLRDmq7|hTrF-GSi>C4W%I!V&>+z`w)8r6T76l~MAP&kVHu#v`%W=~Q|s=KQTUUJ#~
zXSG4U%P}2rJnfVfrW^{?M__G#!#+7pe@ZZ&2Z-SQ&-&$MWvg-+%reUt`LoX?*2fw{
z*H9M=@+I`MR)V=<M}(g&LQZv}utfNU;Gz=iaWQg&mzIl&ik2Cit){%HPR-QY2ryK2
zlXuRSFP<WdmS94SIsVs)>ISj|QBLQm*w%sg!yE#qkTDQR+nhDHi-b94kLXK^G}tHn
zz2ofb04wPH$6TY?Bxs%up8{m;Zygv%EobLx{n35`cdxH=UK-}7f<wlH0FJoVk611-
zW^tEOUInD*3y?_f15$MsZHE{vs?<P^hCwG@gBWyjLKuS%#Lf!j|Dyh=?Qz1ND2pL*
zPek?(I<lxzBJr{_25|u$`FoyXo*Dh}ZkpBh$ivvx0U}*w&BCr2CQbepnZxgAwW_tI
zNn{C>oLL_}ELrK?Ie}7^<k65ChjtEwJrqwf<}N!fM#WAm09qkkM=Yd#kRF5C`@MWr
zyQZm;k!>@fVS@P&LvPk3VSMZtAm(9!6|u-;qZb{E`tm{IG(5m*a3k%>udb#c(j-Z%
z9f?{Spf}?*9r<6t$bUkY618TMrh5O{V}B6AZ8d1vS<|Neq2pYCSC4V$v&3O#9D6lC
zC*&PMcq5KS?haF<b*8Nh>ZG64(BM6wZ*0ux&G@0ypB_o<u!KV&Z98nbL)t{*kO!~h
zJ0Xv}Q7g>5$k=aC4^j1EDyS?QELRVHd3xBd%6@csjr|V8ve(#WB<sRu@M|8tS4RdK
ziyRram3}lN`0?odmX88*YQ1RwdRQpYL5d15rXo4Z@%Q_nG6M^V(m?8Mo~u9dA#uJ*
z_r6Nb(uqVIwH-umM3h`lT*38kZEefg^`jveD%wTO30V`%14;as1kKD}SCa_bRQi9>
zP|bv)Cb%8PoOyv`sNs{3w%vedApHptIK)p7&G9y)%InzJKub#t7=<HLlm;;vj<E3n
zB0Kb>2Vu_J6A<+g4Rr1)z*7JIdv&mxdXTK2<;71`3cMGqr>ncL7P4SRca77)#E{^E
z4IGX~>wgA+!8a4EOUgqMb)}qL;{7m$OjqSMteUAuGQr|Q_#hygCwvf2qvY*3e2Ksz
zm{kq*^}*Vx?cV*5<yQ9y>?F}6MYS904&(tDkcjxpk<Sr!!7g&|8$LlZi-!mk&K|zT
zRU90B$n8V$xZ1H}1V#k-J^0C!l(e)e#E~ZEjLj>GP-q=I_&g+}8D#g%GkZX-L$)J#
z6RSJXblk%F>}W<f8CYsYD_p!Ah>byb4*<mPDhHeE9E&s~N2LM^DwHpRmf@;SZE<sR
zE7r1UMHWg|#EVfyK}?82`LH(He2kWBiK?nPEre(}DY?ey&o_1M9@zdCt)Mt_QsDr%
zT*S9}RLyqnKv=3yzJ4?&@hAz_<vIL+EOMl@tZDg(_JDHQo7hOigBO(l0@(xPZ^g8c
z=pV%(-8PRNw0isIVDN1h7inzNv8|1Mtx2>T(F8b5DY=WnMwOe8D0-!8Y$C}6G1fC1
z#KwMeSl$eBcgd5pru{CWR@k8D@<b(hZU{2B?4(?zs9Tmflc)&@ap@|D5m7-wAv;2I
zpj$>gZT?J0`b9@l?%2$+DThBvOHl0obqvmYP*UxJG2G2<L1W`;D54loVF0_{ciT_s
z^0#Wdeuf>D?ChW&_K<GVA%9D`#V+ZeI~WU#j()Vph)P^zKE>2Dm&uT5VJN+Fr3V?n
z-VL9S5DclAl$2D<w{Od~9Dj(Cueg|l!vb;)bmst<v-2n#2%P1N_-Q3Vau;qv#(d+z
zp*wE}6;^jB@+1+_1TScPwoi5?g%}4h@AmrL+7&tUg?x!5A=$`OO%EBjgocN^IXlmt
zHS0dwe@Gv^8UUvh14wyF@+ZP9W&efsXku{a3S5?@bdG0ytkhb4YoYj=QNyce*~e;D
z2gSvk^)Xu>{BOJmu%E%%H+zW+Bp2uZdD~2)Xb>&#odtx`XV%nC`>OvlN;vJkpGqIL
z5{lIMS0l_08><AgNFdL=4JZ$<(kv$A_EU(%b4?l=-SN^G-gtGv-!K>gK&i&z4z<%p
zr{=y(8b@PZ>85W9II{mYz0ZMw;ZE7XrXT>vG>2*99TexxUpgp&(349J^nNhz&0Vkn
z%;||pom5EO>bO!b;2Csxbv+iM3Xp&ZGqLaXs|Hbw24kelhxYpTmfrMNZR;g`V-gai
zAbJxKF@te4R4r@}rNPVd2OKQ5<D#378W4h)Y+Jp0Ck0I91I`174ynjKEy>QDU1Dpi
zaMQ@ZK=I(g0$q`sDEqEVJ{`Z_UUT89!oqdA+GF_7NkC|W%qdwZ^L;x-Bf&hZ$6p0n
zAf|*JzLiIoD|vX3lltG&r%&;|>v?&dinA`DM2>dyjOG^>Mw!+hbd~SU)*k7?6ilFw
zB{Fhy)gwELl6Vygk%`MJUqMk(+XV&NL0o6G)!2q>B|R^0fmT{q?h){Z|6t<K6~X2_
zTFJH&$W7vog_Jw9@zqGb+X60j_9(dIP!yS*;-;LCakR%5kTNXypc&Xosm$*Fa^?L?
z#FjzX5g5zYA3&|}uGSip%-<6mDz+b1x1!Sry0KDpX_EdE#15}$Bg=U9Hxp+Z1tReo
zfM(Me_z=+iin42jhJ+}Gs1h}8d8`phV)Rs2x`mmp$&G_z2gOmK=)WmSqve==tOFmh
z-p3k~T9F2Br+Mns_m-AWI>9M>Ji%T(R#DSf7i83ea!?CV&APy2+wl%5?gsX&gMI3B
z%dmieEZJx;NzKU1W5ezXH}8xJ5L+2s*uC<1X%Q>ByIeV+u1+p4jql-Vq27l2moC*a
z`$`4MyhFOziE(%G1nzzrT%>7N>h0bf{@@ng>NBd?j*k}o=DjX-_X>pztQtT41scC8
zKVP=(S`!*!$|JQ<$boBGDH3FZHj4H4MpH9g;NiDsGokf35tr~kFbt#bqSWh?>ZB-9
zCx<U6l~GK$g>kw#J0~DJ3<U_52X_FIe_}I@Ibh33=Pz6UvUvON=F67A?EiPsz0c+u
z#5noO-0vz}NzvESJApuDRBJ~^M_iBa3V|P9#CZU){<BxCc~RGR{107H73EudJM>Zs
zS`mGHeH?rze&w<g61v_{Rt<uPAk6ggL5s+@4S5d`tx)YmVO_ggrxr1J0_=aR++Ms#
zXCUgEDH|oUhI_d=B{20qmz63it~#)sd~6C+mcO0A6@)1T$T9~HxWO|dG0_%I0Uo>l
zHNt0rvo5wey;pBEJ`tFMl0vvaf2CE{{m?l~+hUOa-lu2aQ&<PBtdLMgPq8)<&S@6y
z+`>~>PCvnK(f9AHIHT9rE;8GGuzs{Q%T*QY-a1CrcTjH5>r*;RFAw?_$bGMYyVq^d
zem?E8-MXcqe=`_}%<0!2Ln<?N8IQh^Tc0!h-)4`MA^5jvwHVSHZ{h&IGXA4L&k#F0
z?!`RB!NT&9V!g{!dgYkuDgFNEA47As`{lC@Lj*4-tBah^_mLZ{CInAi{wiL=>Pwlf
zO@$e3Z^*Z;Q;(-HC}mDRm^PJrlxXvYsuiMV``k0qm(iA=IBoXmpU3E9;X#q%k=+1U
zwEOqMoVoAk&k&X~Cj29um65kAmUis+wua|Z8GhAK!Xd`gI-M11Hf(-2`2GIo>U4#l
zzpeV^Z=TI{f9>~wcK#Eu7|Md*C8mH|I#cg))*hcqSV4bEDT6r1U^OM@L<ZCSR>(Zj
zeslyJ(<l9&mBxu*-(?z(DWEEA3$tcipST64PW&bvrWiQEXV0CBPGm*zBW%&R;edzu
zwY#eV8!IWk$SS_C9enhSOxUTNanG5iQn^iI$}G!!cio+wO29}tR~MJz5BZ52S|cVP
zu;C-(e1;GaVK5W6f=vesklt@316$Nana66OxcATydUqm4qQvfkLOI*}xpCxgV93Ma
z4E-R5CbE$!Z?V}lruORGvQF-~pUT+0fj^Hj=A4SGi@|rSJc-y}rKt8G`*YwGtKd1p
zs<A-QkTn0zu#k&?!xD~#<A2V54xtnKasn%+XEMj~<^1vxO;2d6FmB)s)NTDu|9YdM
z*ca{{u;aIqV&L@?68fSWuq#yHMyUZv=o4|5zhYi!)IICBCxeJ}lh-(T(r4?*Wvf=L
zTD<s`PU>w~mo|2TjY~~W5B>ZN(KjcQbgC(XUD<;6U7mqI`ub=H9VbF?(!%_X)JUf)
zY~HeEmDwX~Qj(ODDK6Pa>;yAq$BM%U$e{+>Jr^PNPhrSy{l>U=iT-CZHZ11*ZwC{m
z$(&;5b$G}@T%YvD!$N_|>*fL5r1_G-wM@t*1Pi}|G6ZcbEO{O|nnDCAao_-`3fO_L
zUFs}0w%FraU|fRuUOp%iTUOw*AmMFK+okre?{8w$%Fiu5uv;!M=E_+oMl_%V$6`-U
zw_jo-QCd<4k!Dys1(v<v$d&UWnVx*wiI&O%rM_3m-x}pc-&F8tPnwCmdWa7@Sv_{}
zdVORL^3c6t3tTB?<P-~XCEcCJ!YgOZv~A}g1xl3CBaLzNtF9tBUL!0fEG)<SHK1RY
z%LLnJdGE!_`KA{iP4F(Qz?hgAjpf&K+I&a{EG#HUnXAy95nDq4!YWq+74fzv-Lsbf
zgn)-J>H1}U>Y@|0OD_C!ivzC$PC#?Y5dm5mGZe9XR3`1!$o3@IcU<MkaAWN%hH2K?
zrp435EEgd$HUD;9bO6_5Qbk1XGhBRON^g}#36Dn(KSy^PJ(vG{6y|ztoU2}d`CaHg
zqT&2<;+2ue_^6W-kz&uz&YqgaR2aur7t7-^VG=wT?7@dY{%-nBO8RLb=xCb}-_z9G
z92syf!!-;>R3ItD{H5K~+k3kf`~PHhw<GE=qx-cUX?U=h7BkSF#j47ESwL3x+_^e5
z*xn|MXk<#O2G6bXkK&9qT8g|WNn?^`+~s%a=?Vkonduh_Wmhw7!NgT)E$#N9l6d*}
zj7wjoj$ME;O-{`Tc{@V69P|h&SmosjK|$~H)0R2cW4|tjiLd<orPe<+&7y3<KxnW7
zo)r<ZzjW!9zBbK9*60iNjb8n;zz0cDSIImmkC#}#;7MUK>=}>fy^vgDSDCI$>La#!
z-X@IGE^0yYm$6aPBQ^I}zj?>&<?Stj7W05;>$Dn7n7Q4ub^P<~M$c_Nza4;Aqh9^g
z|9Vz2g9VfcsC?Xlo9c8M`5RgA8^Hy-nx@I*>zSe*BGIE9T++`rr5M+~ySv-d*yL5I
zy7G8WBM~{wB=Rd@ZFaBN9C>`pXb0QqYOU<U%N16hjIwI@1Y=@KCTQ90JYzte9_g9}
zBzOULQ=a!2gOdNOA59n2%|l#59p$W!4oIk^$=xvmMxQ)=3QKy?=g(V@zueh8{ni0Q
zh8a~QmVW+>yVD3{)Se6EkM&TuTUnSLtl0=K3>GHzBz$}dLHSPZwbDd|517V?4VYZv
z#l}e>?;(YW7N(0QC^N64ZBi!$=moqJ>cmz)zKalL5ZlPyzO8|5)WmB+RxfPUV+0z_
zcenfW@#7afVWK%9xDRno(Cr9|i(5kMZz^^X$ES*@lOBVthvHfPztbz}$e+{e<PWLi
z^P4n4{DJ4(S;geB)?pDSBO+bl{Vm%Gdcnzi2j=9Jew5J@JXkn3jhU`iFqcbbK4;tP
z%z~(HHKaF~4;4$>mK9A5zY?>E&4_s_atTQ&aTXWatB)H@eAZTjB^t56dUWBB-ZK$z
z6zH{0ir1J*a6%lAcO9a9mdoMw=b9hH%J%=)7Y0Eg-9$M3pSX(zmS=f^;3|Yf>eWI7
zZ6C88BB$mlkBUnYEbH4Sn8H~c)`%?A5`R8i8ffg@H9RV%LhsoA&F**xiak;4gN|$4
zG>Xv%T5s_rpXBT!o!S4GKHBS^xT;*u*82<o3QOLcvDU*<v5v`Cp}C>%i>GDxxjvN}
zlbADzvps~WG5m^)$(AWy&K&Gk_43c(S1AwFRz3dZ$JobY-T_+>MWs3;g1%Kro|R)E
z6Asu(4}|QFh?{W!x;Hr@DGIuBWM8B(w7X;M$cn$}#2Jp$UuT;HSK{OmUkocX^A(YM
z@yDyb>I8p9C2Y_Xd+<ib#=3_WVh<xiP@d-Y3k)%fpJU-zXvSz0TsTBKSd+O{4x9QN
z@BlfmUv{*y^1y?!#!04J?`GvBmZxbxex2EnOgSq$^7AD9A2v))Pq2G$X-@-U-&26#
z@g$T^YQHWWK!ZleM+pW=Vyx%wJa-qP>4`1(pj&5??f()MTlI=t-S-F<e)Ls$;hr%x
z<T5J*bux5@^HL7~qHy3Ia>X7{pH6_C|Bb~J;G*{Cgb+?#KDmJdaCRUe+j@BL%K3`;
z+1OJKCLySPSV6j#8W=;@_UaXqkUs18Aglf_?NLSo-0XaOe3wLgnQ|1><|pGKdeNUE
z`ng+v2S!p(D=E2ieqtyYIilbd$&@Oiynk5RpbCWK{`S?YSBr|qV5dkI?0Chn-I|%A
z@IgJJqtMAeF2xVK)vek9OvsbdWXW2-^vXmlG7wzxHkakwvA1Hg^b@8NghANdAY2n~
z*`e1MrZ>v@wD)CB>R=|Jx}Bo3vUb0@YBf=g35^@jaAea$7~lQ3?uNthuMJsmqfpaB
ziDQ#Yv#B%Dm375I6HfBo%d|mpC{+J+K~bZbd|EwddbdypNw%+K-(qYQHgo1o%5}p2
zmbZ|=@d8|+mI?{c`(GOxWJn_p%UA`wupBrFof^G&%!o^d4Bzq*efbwSEfH4))m^GH
zp=e>hW4~GU?oTyiDaFwMdLwKn&*^0m+3<(-{{{3cyX)w2g#JIhy((#Q+RBwH{eL^+
zG4R++z@^K9?0s<Q^5sPE*7=HoY59f(3jiX;M;mDzfJ`?f{6N>!3IStk+?CL0F)>9}
z<Zsya3WnIO;a#^Uw2KlMtA<YmmT1}DnUKX~J7OZ~{XUSL)B=sw$ru9@5$cW>NK+R|
z$c1;k*laa~56HI$u<+aM#O&+9ceax9>i8B(|27CNvy7DjWkJ7frJ2{~^_>Eg<ew2c
z14^H4W3Ebu2RqpFadAuiOwS`~Y7KR{{KCxeg0J*d=W=<R1lF#LDJD$0CldV;@eJ!z
zhRO>1NTyoW1&qLM4X=rA=&BQir#M-np7#kZsO60@9y`@@Usb%sm70{<{-le;<s&0@
z(HdJv=a+Tsl4b*7J_!jwEF|=u;2C(Wq&IA6Nb0LX=mFs204a;`f&(XBojZU&83}5d
znw9^|nCs={a-UZ~pbhD(NO{J%2lH<<6s*Epzc_s7$5&t{P{P7{0Ve2@OA{VmNB02Z
zXl71JhM$DwdJ`}BziMi9pcC};49eF{NheOM-$jxH)G)PWVpPg?uStvJ9X=6izs{kt
z6=#(d7*sR~SCsZHKZUF~qD}Ziy;8OwX*n2ddbPKz|CY<b&-Gxk{$;=IoPqK|Y^}<S
z$f}py>J^wF+l0)D$p+u=#KshpEDMCR(kn#(bBW8XTgsuIAyyLL=Qr7gPr<l7B-+r`
zE3B!XI(58u5;w@$QejMh=$_qjE$_Pv%L|kt9!c&c39LSq$KaGY`{w<!DtPi{o)$v-
zzz1x#V0U?FG`*^lW#5&?TUEwYA|DU4E8ktdfvc$1B)F#P-oAa)GQQm3m6Cl>@1Ls9
z&e`=BC=brv@{-=MTd~1PO<#R3m$N~ZtEX@1=6FuqYwJDFUFCan_Y2oNXR(l7Po~uG
zo4&@3TKLeco6g5qSRPwFec#G>THv==B%a)Xz(QJeyZt9^E|SV7?))LW_st#NK3bMx
zjYnn1*RyN=N>^~?PZ^4!rvX(;E3=;Rt?D~@RG6>TS(8S#Ubpo8hhsCC9X9_ptmKLe
zlv43PQlKbB^{JD6R5H)Y*9IE@)Viwvgm|damt$&Yx&QdZFn{wE9qY$_1faySfsau9
zh@Tm*mKD@e>AZ6E&EudN_6^%uSP0V}i$nUezQP;qUG>$KqDv`e)@fPQqx%|o`nc<J
zQS^lVWe7g+d%W-u>3SeYnRP;|TPJx)upNN%eG2guEg_t`>7Tl(#w~umbdym_vDkyk
zX{U}cjYWZr6B#)Y|D_AhAb4Qg!|l}h_1m>Azl0r~eB?Mp6-IuS%B_%u_Ot|QdY3By
zPb5x-fMNK5%iMCudMz~LR~=EiFwwfq`7Qb9?74CGZ~);3W_)o^#Ai%;MZ{+?FUwED
zS|$zFWsEqst5g^{V%%G5fj{?E)sAjGb!@B!vz)k`lYWl~4`ZC2N#SAXIGy(yQiP5-
z+lq8WFbSYw&iVH-;;A-m`Uc9Yz@6AP$1@YF&yyVUwhHVL0r-a4ESaDc7n~ouboFeh
zmI0Cpk%zF+CmS=4?9lfpINEQsAKBzhcrQu~?ul;aoQG(<P2O<mqa8>J3o|^GfE0ab
z<V@fPg*pc66e2CFmbLoT`D~P~7kuUjXmN00X}K2n+#!^8Ct~CHZcN;J{il|r?SShV
zijTW@7j+iFlpK5%tppMS5T%7}Oq^47#Jn`g->#KA8$J#S8ii<?bKVWc{_!8Nw?aL@
zYoIqAR8=*#4Tks7T->|&w6GcBeu%K)Ub%Afj)1f{8wfVQlY{NU=Oy;XxW^?I$GIy+
z6(nJ^Ld`}HJvHM9qbJ|GLR`sYq>wFHwoIcs9^-X+tdd4`b+up-VFa6hzL;YDrB?@`
zdJSR)T^ON=o$E#hFEzI+ArA#9(#P{2MMbG-7>oLOA3T5dY%QmSv7X+d1jtPfwt$!3
zPz9J<!mdMI`zo=`vCbJ?U0vwPA<TFzibbT0A&crqG8P$oUACMQW9a+!k}}UNZo$=Q
zz47W2N#?RmIfHXBebb|Wb<t|Lr#N*tDCZBm&Y!R6w1{~A9J=n;;Xb)f!ozbr9ql_)
zIh162Ksp3+k^u)`lf<CO?^V9c{h?ZDaFP2FZSD5X235p5q59&dhqhZpCzv&QaqiVH
zwrKQfW#t*}<zT_D``x+I5vo0W`#-F`>&A{afjbAi2#hG$%mR)ASpAwi8@yhcx0ZqK
z6xp!@*OVdTguVT2^;JxqI(<-4G(S)Q>qC-@>lhhoSJ=C^e_%i&U=vQnwuw4$GtWCx
z(;cGT^`KUHdC$H3X9fm?`|}8@I1sxSBMc?-n)qJqy%c9on9-3tjeQTXQ9}|E!K<pY
zs640QEZQNGt^+hXj-s~nS1}?Kzt-L#!*zMeK7Kr6X=$ma$3NzTsaC;9V^+x{X|j-5
zU~dsYJW#Wx=lGl9Ze|RblYit}2sHpSIvv5g<AH(P#KQAO>6rLzlb_-YM%tf{fLrw-
zD+>!Zre55Mr)`PTD@0f+Sy=jCgNMVud6njeZEfih_QRJvGkM7yR<C~h*;-GeIc)c%
z<H!NSezKo#%R>Z&hMzkQssNO0MzhHh*zjE9e8L4-A&73OqSz$q%4-Ntp+h(vqT2i8
zhvFk$qB4KUB%%+QrBhZj%{@e7J*TTYl(|qHB_sjO0)&iK7M4zIZX4`9({T+@jNqft
zfnb{}m`@M105Ju^0YB~TN0!*+5-KZQE(K~KcE!eH;AYYXKCX{?*W3Gi(jvv_yIx?M
z2qGr>^)S@nDT9br(JMj5Yvfrx8rb(lE%ZuvKFSAeIxzt!G{TvN1V&jmexgcWQ{b=V
zt00sW@NX9AM}v%kRR}&Mjle&u!6i{Y1)AYB$ds^^qKk_Q;9vBJ!`NuV$K0wVEEegz
z!o8L0rYp=XNN@B=IndZ6C8g#vS}wIs-WF{YCObB$FYWMIO<efCi3{Ivw)|w^;`5hw
z+l2{YkU}5|Ahnp4O;9(Vf_YXq;pn#^GjsEU#>nJ58sZfLhdxeK(N=Bi=Jmoaj=wy<
z1zYEQ$M#L>(FsF^oLov|>|$FTe?n351M(I$T{Dl(ps$}rq|eAqtZ29_>~@V_pQ=2v
z>vbq#FU8xi?I6D>kbU5~MiAFrdLA0ewep-!RK9WfPEZVyZ9~|S79L&XLiB@<1r?4d
zC@0R`!hS_itsV(YsQqxjKIE7njj35*F?`b(!CeG8(gq}SY;|egW@k$)Y78hfK)a>9
z$r~7TQc@*EToDm@CfgGf+?|s^Eh8*28c!as<-yJA$@oYMjbU6hD5o3^{e0B((6fk$
zSVIyLRF8{!woyzcpVEoP;-->MC%X}WABy6(d-KK$d(?D%eUE!;rsJ*`+UPqWo4}%h
zSU>^;JQ?}!SyY=xi40aJUS6W;#hZRlNRV^IMTU0^<H#YuFm0Ob_U+`;rypY3Lfm3Z
zPDn>b2h=qTbMO)bcQ@v8sh>4HHpPB6F>YEY$rHGSZ7GgpJ{wzmX_P{k8Y?R+7Obu=
zQ@tduh`j7<KQ!z=h8&90pGlefglp3TJTn7q+9b-o&sJ9s>%l)Z(A|h~c(A&txS+rT
zyNiOAIQ{M)FwrHVM7ZQ#L{uHw2uI>^P0iK|ioj3+%rILCOVqbNUjZg!UW=dFi#|?c
z21C_hqBw=HYsPIlo0q(QiuzK5Guuf||L14N@PT*j>M?Eye|^07xqo2q&aqrs&WRh$
zOW4!NVJyXTa{JT3Q#js+^>H#<!?)KN(wsCHuyMQ_7#~1L9=!`1y-uQRIS7N(!$%9c
zVa;lkXjAs7vQK;_mH1W~5n;wGuxJJPPCbvX5*{_{pNo!E`e{%h1<Nv1=f!EYhkV<9
z@a<T`CzQ60`x{q(ZB-C0(9fzuE_sV?ssHm(#kEYx5Q#X5n;H9f?Sf~U)k4_2>TWx!
zMvkPY+;WfJo{ICp6r#IxP5fZQ*0U{PN9(@|QoIB?E(IuFyp8k1Y{ht_CeDl2$+Up0
zcc+GL8vFej6IZ08jB!xaqt!M`7lo1(58YWI-_E*4s^^D0Pc`}DyJIsLu;gf`2ZN4`
zC?<!D)ZErimfQMu*daK5*ry;6+=(YE<Fad?NxJ(jt~xM4dY?UdOU0Rt^Jz=U3m!Zq
zXBTbTF!u*eutPdS7So};Cuy2km5kxHwsp7$ZyhI|qshyQB~GDW%ysv(bADC#D{20p
z_nDLLK9GceHq6@q)iA!4&`&d8p|k$C6SWVqAt_A2P;r*83TI#@c6xPpw{MrRo58Su
zJA`CWd7J`#eFqU!R~~-L-F>tt!rpM(gLAplr%#X55Om#;bZp}i=zQQY^3^y4C4-b%
z)5mFIwYmJpzP~AQ`^52Z$o$~g9IsC*4JYEliO`q6E2oUP3}G{lF4j`n<PBs?WuuD-
z)%No53w5n7>98&NpwJ3eP(9$~%x&OkfqL!c_3POE6?-Ba+B|>e9%y6_1_N?Cq@-kg
z>5^v=N(A(?$Q=K7cPE%eV*7VVHxjiQv8Dj|YTICFZc|!^eUYr!-JkW(adt2)2zk*P
zg4X9&5AqfZUcxb?lMbX1K{;V+Ee%1XucUayYO#;o_Vw%cxyUj5_Tv^7@m0OWgQpC^
zy&&0dgBpx@#J(Oi#~};(!wj(;9KUH!2sA|xAFd8lyR_{AWGj$zKk30ji5^VS-{|t?
z%ivGo*18a7^`l(v5O$e9d^iW&EdgT$!y`9JC+qpdR#{(4y}cAY+!pE?bcKEm`9SLg
zG~;;}#DeMwK5E4%q-Bgl4pqe#Z<33U7|QJCYc3>dlCzpc;Y9}Dxv;Smf!yaZ7yGLG
z%DM+i+aiIcpCx4WKy)&NLcytkBf8w^VPSKfsnyxDL9GWv1Pc*%lmuA}MuxJnem&N<
zIoK!Vr4GE$(wJWmjm=fu)~0mUOgbk79YxCpXaT{Wn(cVHHKE&NJF)fWlOD(gb*|!?
z`t_LS@TVL4`uQ0qD5GV;B>Ri~eKgaN^|4Z&zsgaYLjpd|CIYA8zQm~$Sj!dx0Rbtg
z1SH+P2ni22H@I^vN1kRFjU94Q;@hDzl15Y}9AIE5ZbAr)_`2FMEDtVjREhILt(K6#
zBIE68sIXzFzq?;&Sl(-o07XQcd}o|16F;m`|L#5`V+4q(ZwJ+K_alp6gRrX(H)Kov
z-&&Zte=f{V{fJYPB1*OWN=)tedMW_raX0~<m162?XlQ^YjWB=Dn6Z4`%t$+AM<9Mu
zPhTI-C1(2i%%I%(Lppsh!XaP^H$qERWP96)2sRA?`wJ3O&@cwT6zpHXP(i3+EiV&w
z2R4i+n~|oZjCCIxzEiGx*=@EJE^<(^M<!xZIBFhckZM0jrO~r#b(j|L<-nTHxW93p
z5n2I1D)zu|l~+O9NLX=857=vLY2a<g^Kp>#N_txX?EdGsm6G#hE+#NKh52D>QuZTs
zglsmK4}w=mkpJ%8yCDt5-s@A!8}i{ffK749oK!%UkhxX5j2+O|oDj^s*k)*xh={7~
zTZ9Zo+FibU<i+Sfo_&D7f6g(+v9YjuESlQyg<#Ih$oVQTRa8{8v5|t{2VZX;Z3nM4
zbu0q8E(bq{R)n#x?(vtW-$5rgS8&KdaZ0;9LtpGU79XDEC&s|z;t-GO<L$izdqMMn
zJxAwLz`<qB{?y_3yTkS8`acmj4#dFM64XOcyW>hYHrou5V({oliA?jVFZwgO4o%8k
zYwtk`OzcDiG;~q$-$DH?+%jRWWe!Rm(f!>!f7}wQYWM`%3sLgqvKH0W)L^6TA9Z~*
zFi8C3#dY5=|CF!7(oZEKskaPLEuMNO#_EQ1v1A|lo74(dqCz1%{LvAwd-t#z5Q3rs
zGA~<pFCd_*sAz-XhI`lvDKJpm%<Knbw2&6RP7Vz{MBgYPA_6oODXVvVRYto6N6~6c
zZCQi1jC<k2(_C5RJ2P>3Yl@I@{|91Gxc#-;9n2$KYh-1$UYK0z0y|stdSb}&Z)=HT
zE@*FS_b?7|!?ta&o<6;B?%dwQ90b!II#k$f200t56qKeYN=2@zqR?v`3;m4TGtVO4
z_3P0Ohf}GIfTj`Q=-~^+Cli9uTPd82?X_014HKKXR7rSKD2V#`1~&%oEQmRs&QmYy
zX1BHRQTeJreOdycFe&ZaHb?>*>gy%iTJ%>kZZU`S>kXeQL{=Oo_O7u-9Ki#{qKW$W
zDl#(P$OjY%{3Vf>v0HNFRd6@2u~SWVk#>s>vM|ITo>_L|#trPqYK7f})Ay8%67rIi
zWGHG2%3<}s6$|Xy{Gx7p%)7d8byp<)PYGDim&6Rkmoc}B{348SrfMwj7&Y$R!y|Hj
z0YX4i-4Tg{B)fXkH?OxL>G{Qr=g${kda)-uCPu?gMccMBRYge#n7sPYquU_Qz?~?;
zT^1v;{sw_xjAWeKcIy!&sNZuxx*0lV=43j{A@(RW4MGqQQ*Ok2C;!oUEW%vxdq+_1
z6Qk28Fr5H1Dn)?_EtoZHqo5!P!ZPRc@Xi*HeZRLcgzc@<@*zR`32kIGKjLbqEaqFC
z6rDiMvc6#s<Bfr#&>Kms&Dba@jWPV>8)>VTzvcJ?+xrJs;{Rdoy#uM<<NtBhy}5NO
z4Yy=AiA1`RV|E)<bd)10p-4kUwh+2a36)h@x6nx<%E(q$2w7Pfk-b+ozsLI=Wc2%d
z$M4r)UAdfd-tYJ8^?W^M>q%+CApiE<VT4KKU5F#X1;mAg3(Lxy8yd`EZVf|asy5;-
zcT!OVb7KuY3ut+X{7iTLFg<eo_}DP;G|hAfkf^sKt?CP*1WJ7hPmlk3BFB~_xmOhw
z6g0D7N6n495lxhhX6A-<?nsJaXJ$UTou&1MX~fbwjy9n#`})Eo9Z8Pn3Z5~;Uv;&L
zhw`SD$E-SdDKO^b58)VxI0$(t%9`>6pze7qLZ$aaw8D!zlm}oC{nf``seEhxY?d8J
z7X=fU0N5Gu|GaUkg*~`P2kC%ZEG%2RoeNyJI5{iPSa32J+U(VP(JmxT+`5FDaE75n
ztEMhH&_}M%V^`c!sTQ7iU(436gFuY1s^eYD^G*H_6HOR*5;;1o*A3zQ09zitFeZnA
zdz<GE>*9_GAF*8ysc(=YkDP3(^BzXd0y=E^)Ap&fzUNKu#tJ@w*EQ0@(vp(3=^cy$
zEhGI35*AVfUIxTSmg{QDJ-VCq^7qZzyf`7a<&N}^4;YNsjwWfRYs*PgKBoV>ofYo9
z<`)Cs{f$x$OCJ^}jH`@f5Rpw#tRRqD_6D9)Y@e=yv9I-e#;p{6bVrL-t_=L?b9I>*
z?Ga|+{8-L;r&8VWhu<R)r(r=!0aYW#u8l*K&fg`T5{b^!+9sO2Z`Hfjs<lM!QuO}g
zAh`dIG(r8@bN!AE@-eHX(!XtcY~6CLul>RRy7J-Ro|jX{GT9T?XB(?{{#qM2ar&P&
z^D`S*q0iv@Byu*{$U*VAH|h8!kTcqwO49n(-~NveC}~v43%OmOpxUu_YWJB;W^i_@
zFB|}HHCt`0u<i+^_U|H33OwRSu-CLSo^4*;^nO8J`t5pVq<;~r-Ji}+Tg{BP;oASr
zVILC;)@k^!h~6jE6yy&9*bIBDvKIR#x=2O!$o5N9kQpOw_>O2M;9s5YvZ8hk7IGe*
zt;~0Ug&n7UYrc%+MVQ)MBBM=P+*PC@bgZuxwfTV+yVMuz#lJIXpQl~=6=Q-hhF9(Y
zBF^NW18Ie3?c!Cien<+1Ws04hFcASZE7j#3jlANo2rXUnJsB<FJt#CQ)PlMRvLH2N
z$v~ciEcWj(`@?UFs;QSn&1l>vjVayZTD$fHg|bn^*qAkBS;I?GoeBGKUo;BRuc&`b
zb~dj!na3jw)Ue+1Lwepw1ZqNr06?;Q5oDQydCVUI?HP7LRyG~KC1ua#Zo@PZkwD*u
z()%<=pu+B_eyhJs_N0WQ84i`oPTFe@re)dE`o^G)oH1Ivla_lr+LTN1@$x<}6MihO
zc@=t5FyE&HqLxAa*c?tm80c!?{*kT=<qsUVEU{K-4DEOR+W3TNzeiunsrEb<Qru{7
zg?p{9#k!bZqgm8!-dNSg#Ef4;geRE6SbOD4wEAlZG=V3X5AEYA?^5%=<(V8<q!ZY(
zsSszuY~Ed5>0NIfqVUu|C)Hh@V>B<U19o{_<CVq#!2pesTN8Z`-%{6T#G$%FPA&`P
zC3a5=HfEejiOz#sXi-iCC`yKs>gt70ap;3_!HEv%NJvV6xQ9#Oz$F?YWhEmcqp#l%
zSJ&fjl{Y%fHqQtF^Nop%Che4vh(mN^#7Xpcy~?|gnUxiQ#84?gK?77u7)47+NhLgc
zw&!HWOHvW-#92R9J_HjO=!?JM6a*KdkFA0qZ;`m4v6q1YMtBKoKac}v7eT*`)Pjm~
ze5G-J-#2Kf#jrWO@n$?@x6DiKx7bb?rEEE>4gMtlbut5d`FNm1eWAY$A_gZccRxpB
z1&QTXn}ITM`O;MTKSkQ=bQBL)yP8*+%9+&8TfeTFcI{8k$9aLla`SKOwEvWlQm-U>
zPYEc&ueEziJmHA_-+<cPj@JWVqx}e})GV$$QY24G<RwhCQAk%xzsgapDvL+bx-FvE
z^^i6mI_5)A@;gtG3X^GT3P#vFjQUdV!p!u=(;0f5)F()z$Fq~;BPou480ZGzc)nUK
zfX54~1c(qEz3@eG<NABy0q;*EN*kUTJmWY_67jD*osXVS{>{74+tY&x%Fyzlcke{8
zfukc`NGJ?i(9yuV&dNuQ-1qW&b!3aW&0rl0IZmeMHJKnP5O<c=*ZA=8!qJPO3q>Xf
z#2<i8R<;1k^gjcAWvbJLYQO|1gWVnS_9{%cU4FYZS)enR5hs4k%)A8)96AMK-oC{v
z^~7t|9K05LL73I;5SlrVK99x&WI|$oSNSDY-*(IL!!PlQ5b`l=BCDCk8a}`)MwyT;
z{IvN3Fu#5Q$&;2atU^u}2-SZ=fldCMNz+5ouV4z@4%K0)e#dDTv0=u&->)nM6D*|q
z8E5k=c7K3$C#4)K_^#M{HsxDOqYQk*zk>cVYiew~|AZHw)qKmhrLUCuu=;_HliHm5
z<;KWK4KkUG!z#!^y<MN1OpKzxwhMptdO2|6{{ZTb{`D(^V2L&kAF$-RqNe8UsU|a?
zE4%I>q1!?MoVb}c2JN<6Pdde^{tGhdjD&J<E!q25Hmnm_#kGC{mM}DaS>wm?zs4i_
zDy_!*wnoq)3GU*JA<8pN50#m?$BD+@Sj2{vmj^_Jw0pg&&@S9>d}v7x^r*$f4Pz;s
zRj>P^&x?4blD4`X^2=+iS8C&w6!?La0{WCfIHIBC=L=>Z1~QW@6bg@WSx(STQlK^`
zP}XY}jOY9PY~^UzPuL({Ex~#a<0ky-^m$nF@)|7IVR2?{Cxy_6Fm2*KyQ^@DNzm}}
z5p|gYETEDqQCk@c$_8*=N#zld9~Bk8x71F9P{#d8+P?ksmoJg9+LhNUffmFrqy8G~
z-{Pf9>mC!*PjHk%f(B${(@lc>%Zuqn3?Lt~(Q6NO7dRZ#*VJRihh7&q)YWC9jAm%F
zc)DN?+tr%v!0AYZVHxV5@-2@OFDVA@>H)i4$$qakI$Y8^zx;p69%S>=wzMRNj6X0a
zBr$6?x5sw1H$APKw+H_nN2KgB*zrDxDx&}hw?l6GNHygd{^hxtpe<&(Kk2ia6iv4A
z{vhUB^6lVvL;Y6Xl?SG|a}ISvf1sheh%23$0PH#s=Z{jf3s&xn=44Va<JNy$F;hA+
zg_={`3Vp=}+qNmy^d)G-waxr4!HZ;KK&DU1D_^ft7!5o+At)IWe?Klj=O(D6{V!?i
zmIsWSe&y#|5{4tBN*^-$WDoRr1dlboRv!T!@RgK0C2_ei#VyDmR6O6DLOIAacDW+s
zvuhSxWn;9G!cW&w<^uwex8rS4@DBX1!I_aiBK{aa_tShd-eP-duT9wz97ddIdCc<r
zX<)_kl@#+T9HNYgEc;GEElc}TJ)J8-j0oK?rZrQq@-xhZirsyJX#LqSM@UEJQpQts
z<Ii9pt0hz9!?fX?&dT7`*ims3X2o7oWz`|s!Ny2?fdisXDC(H0i1u7-GuoH7lk&W}
zjfAN$XcHy__usxY2rj5TjTH?D3o?#J-};WWw!BVUy%oNEv}(bH*$R~&GA4*5!!i}W
zJcMp>b8~0bb;D!?GE*1AL5#D90=m%}E##S9TPFXCL=e1mU_u1>k8KIS<6x}-vI~zQ
zq6B5i(tZ>-dij`HTE?)X<mM{8szT&Aax%7}l=-YJw@fHodNz-#<+4cKbY200)r?CQ
zEn49llaMf$S9@x5Cqp+}TP5p~g+i`0Kz<chG(0Iq>)EAa*VHb$IddtacmPP_9CG;U
z?;SfpWh4620VpJDG>8-hP3<|NkpM@q+W0`Y#yS~kGE5E_pfb0<{))pegb$dZk>OEW
z_GylWB{2JJ`4S_`vWL^h?1PtD+d1EGOuVI6wGc=^wsSG!Bx-yR1?}O{-)Ok{8YcY}
zzNuY$bEo^l4r9wds^GqxJIGl_k%}rSK}8Zs_VLK@@H=iZP#nK1vx7EpKp$ukREt3q
z3QxtnO(VTj=?XMpg-fJme-);Jz~%`?D94%>IBaC}p8P{rC@13-g({rzR-6aMT*M?9
zRlgV_lm3)|fv&DslIR-9Wun5bZvFiw)GwBx+T9KXh=vC}!nuqV7$m=ZQWD|f+aW?l
zftU+)L9tf<VtYgRWUv9+n&r6x9I=f?$|0X|L-1=jiL>gyWJl_jc7qC%%hLLa4>vO=
z*2E;RK~rxbNmB1Ajz`EnWhW2qk3|3V#rUB5LKf-3Hd4u(_ys}85ZJl%82c959{4S<
z)|yb%IO|p^A3vVOe#bBN?xJj7x|n_1=wjI5>LPBL;_M$~X5K4*+W1hg@^NM5Ls`gk
z(J~;DB(cLAF#h(NtA_{jlz}iHg|mg?4s@s$2PsCI{4inaCa6YR1C;n2Woq}OmbM3%
zpcx7jxdDHm$w=!QUS`o??}EJIS0`LtU3=@0vjH?NakR}Kfbp+w8VRRfbu>3W^tlNj
zlv_^%nq>gj=g*y626!wYBKTCaQEN6Ym0B^0Dy3p7%<>RKvCSo8zKt6Z3Dl3in|#%B
z!?f;$TqRy&RzGxYY!XU#vky(u>1UqRv<^U|6QTJUC1rkj7DT9wGJA2+`c|pfJ4D{D
z)@!dciKm}qAJDA4ljW2h+&y*dM2v3YNS&bXmHNkE(+SF-={D@Pb2K;?Ywh(2ohWe7
zn>TLotAtj=f>f(Re4f96n!-=E0h+`Kh69~9{Jy={W^R^YT4=2OEv>XGc#4Go<CW-b
zs8e>`4jpb)|4PpvJKYS_owmX;SS<bpnSM_JovWS8=&bp)Q%2TIY2MF@PvV5ZqnlXB
zM2zn<Y|T<qWnMcT%kMZpfByV5aV5I;=F#>^FddDabnf?dk~hT<`7h;=$L;MP|2)b}
zrH6dRfz+kmb<RYeKZJ8LGH1b~AUY78Lt)$mfmnPDA;SfFt#{_7rr|iK`IZhaT#T3T
zBOn4YS$PXHfU}UC_wFT|rKL6436LC5Oi)pb^o;^z<CuI9h$%<ulE4j4JLt^f0phVo
z7HCQ)*7K+;8&!6A5k3A)SDHPS^{-p|*i4u3h(n&$WD)~05uT6qv^2De%q1Ef^-wJt
z;pjJW9Ry}g;~5<X9t0VOvh8c#0ZIeufcAPse323#SkKz#<>cJ#qDAF9sY-muFazgZ
zfCBN}ojdnq)FzljSzWlw-<-u0O}pZq%i(_5MWw4A5m^-wg=aEQNkl}XnULiOtZp@f
z2qn5K&5aI6Ts%P&{KZH!##RJ~Q(qZC0lAD*qVeZ1CYHo)@SHoWYH4h|psyd<CIds>
zwTZKz#UH}dR!<6~i%v|35S+^_z0wvRKw4@lk`Z<Z3m+&imn3-4$SFKr*a$|4aCN^t
zu!P^QHJp}f)g1P=oZtdI_lipHqHb+_LUdQ<zv*2!2(oR02Q;~KY3s~)i9sA3CdBrq
z^q@MFJ9G%UU)}{~LUq$Ru-hb7@0EU40>|>@N7U6(V7zU07S@CSo@0(<zLNhj`dl~l
zKsRWMYEusHuG^Q5_06_op{SW){I;(r?#J`wVBA+|Nk$Bgj33dDRnvxz8&*Y}1))kz
z?S?z``oI68x~xQWYT3~&EfP`w2~)7qVG0sHb}`1-zt_YfMB@0dV@-Vo*o>bBtL{57
z;+{19z@$sIuhY(Q@A|~sF-PvQj$rg_)@&6Mp@Jh+SFeP=wa(~@wY4>Z@l{B3Aq>Ze
z$>k)~JtQ&=nUccb8lX_xhR8(#79q%b%zf`vq79}7chlmVnlO*xO6o8B*8BC8cc;n|
z3JMBOMd%#6aN)(kK+PS^(dz1TYn%c_XX}Ljk;?O8ZRU8_)qas;?(4BRH^jH@AHsAG
zg8ZG%Bz8TOUSt7M@@0eKC{Iun@Y$#R1q(ame9n7Penka_uuh^LlS_rPdSxl`+XjsK
z6UT=83!H~jJq{~$X66*Wpn6hZI0cq~)9=80CY$>%E+Cz&E*H&Nkh;1f8K22T9dbLY
z!0+j^PSHZ~aZRu{Z&K52u)J_XkCXG6_+!myKX%u?*_`i?LkB&QHbIXU=yX?s%y(SH
zN|BCr6QlgVwj~S<NZqw3ULr<wt`|GVyp+uO9tX$QiLckl@ur`l7+fBI%92vZ4Y1U!
zA2;40+T^<9=GfGa)??b|p<>`aR1np7*ve;&IgU+X%cdD;ci>itT&sVuINwo;nym4k
z^zVXcl>IZ42&n>(1^snim{&srez@YQ>(1FpX10nC9`H@dp{DAW3F*oldP%5qaJNYk
zbvsRXK7Ej<X`!(85L5RAAwcM|X{(Xlw7(Ii#5tn#E};3INL&ZT1El1y#i;}{-S0<}
zgj?MsMRJTAa{VdgG<VjEL+lPxL$ORFTkMeK@Fq4WujT;cOy9w(?5eb=#e88lwDAe$
zA*|jo!wY?jo)rmMwGltDuk6xmy^5HkCg%&}gBNJ2TQkb48L#v#KnzWRw(SojE#8Zv
z)k05_wA?=+D=}t2j6(rNOKxtEibz0$)cWF8l&K?B+rN&`xo9n2vgDpqFllod|MY!|
z><1<{?yq!5dwazHo2RU|w6dyTFDnuS9}9yq(8L-FpjL;S1W>lz-sNnWRq2Ere)@p<
zDOS1?rZ^p|2G^ilN9Rt@rMi)9KqiRl7brY6J(2jd)h!b%&^;+5W4=jhHzoVxY~I%L
zGy$e!8H5xO4(drB_Mo^?1O2A$1m{o{VM=T{eUn>G+0xAwB<-tgt5zAK93W3tpA0g)
zti8no4f9`@x8P9a-v_G9yb5Ya=!9Id>YRMhtxn&_@bmnz80}z0>X+Hxi^8ns3n_Gw
zCTZwnb|9KJ4`hXq{g7xZ;Gt@MQBThlKc>ep#TQmKOzd>7G~a3BfJ&$&SoI7Hu#t7N
zv=~df_FAL2t;L%{pfDNm#&a3a>S9ltnGz~k!g7wh7|TXR8+Op1%U%*gt)E3K03aM(
zi9bn{IE1bHY1z~lLj8d;wxF;OMUk}H!DUOAmM+CkG*i&=qW9D6DYpBmCq<vUk&bdR
z-@ZiK%IyIdH-9FllV~%m4J=bCQq}{PanyT%dO6#9kaP9*m5H{#8P#rdsq)Vgw2K#x
zc3-W-YFIoe)9~w4uMp>TnH?9twImF`?VqPd_)onHMbYocs#ySw#3AF%qKhUbCNM9O
zY*c-N_KI_y2MUA~V8r!_imI?j#l@XsJv9x??#Z0>SdSkh%e+kc81mpdFCn#n45MoG
ztRpB#c3>EW%Gt4Pz6elALwDM2_SW{p6<F-%X(Z9mm!AzDzA<Odmbo1?qW9`C*sbY7
zIDSw^9@`|*(K%q)P-tsUgSYSZwXM2DF6A(PxP;DvbpH0)Ye;Ys!SLB`fa5>%A{w$i
zdA4ErqHw!laKBTBbG>|^5<YR;!usMNxJq#-S9Y=~M<hR-Y+%3c8p2ypYjFodAS7Fu
zRgsu6bY6P66fpWWWys6ts4l|83g&rpMom+DJf~6}xS)Qs_iIHFjb_+8vGCd>c=k1~
zPYu4A6{=mc<5mNSnLQ*yB`h%!PL0I)cr|{UZF|wV@a_F|##AE!<0ys?cWnEc%HH9n
z7>Im6QyIUbtt(foIHR}ZguUSu05DHzfRW33oig`q=(=>&&M6&&;#YxzAl}15n6swj
z9md8N%AW#^hUgDb+8JjNfra2eEoG~%3FU6Hc-x0p%wK|a>y51%h1_mCKfgTxD~&|;
zS0gaz_x>n1kYjs?1S`UF0(-wl##uNRBd?==#K8?2f{|NQp~=WZ2W%4&ra?!k7l?62
zg@%4^B2bZ>%uFNG3$afp&*f)#%%ME}fkOturh<zR_UxG^n!#~%0*XWc8RDuD^B53*
zZMfdG?=h}>M%dck3?5&|E=wxNh|&0qh2_H4t!>E5Z8*0(y_OSr@(?V(#1UM;LoV^P
z$Nl@&&7Yn2f`r5Hd)JM=_<Yit9T(@TOYB>apFm>}hX9uRZE_%qO7NEY6UVQ%EQB^2
zc%X9-HufCeCi6wI91x0&{pVR*nQ&En-Matq=)Eph<#z{{CCB7qWZK|babzXdr-jIW
zmGOIEpN;H(Wc5s25bo}hUarQ%%DQ;jGO(26gTCXul_0AQ^W(r%8gor=;<S9+^2ksl
zM9?3AEkgp9Fw&iceYH6%aWuHMnu?4+hd#()^8cpdaP*a_vHso9@s{g56dFkTM)HeT
zc-xT)LB{Rn!<<sqqFc70xP5zA{K~oG%USjDMH&|0esA$hmmcZd`&j<mu$*yZHt&=m
zttF}+)E*An8lwoSv#x)99_uNQ>vL6A1MOi5-#>@R9FQF1NWqUEVvA+{oNajX7sqNZ
z&N8zX(@|%kb62jA-dgGinf6y$^!Fa=V0cPf)GdV8u4mv5COm}a6E2g2{)5jjkNz*4
zpHPzg&8W>fCqDP2kJj40R_{-bmyLb^yc8UpHc(2J3P`bed=5#pC-x$ddFY13W13}<
zfuS-5<iRqF+Z{ucH=Aor#dP-%zVa=pJdn!VsZW=PO#-H|(0d;m;u05Bm+G^uvJD*Q
z@i*Epo62Jy6*NoUCQLo>SM?df!e}`J`3Ap>7)AS9u1D@rM#Qcvw{|bh#hp<rrsro9
zkZaOe9@FQ9!lHf6xXtIDHSPxSSI2CHejh0RV|v0<B~EwS1N&^sI;qsdgWJO5kKN@>
zs*;)Boz%|?Yv7|eOKCk(j<FA^-+jv~`0#dkXT6<_kHXtYk7I@j`Fm5aBK@OWI<bW^
zbmESqeQCzueyOVlO<3cw?WbvJN_s(rQO(+aY=7-##6mwuu|%`vU1LP7G@;IZEXV#c
zJ97637b9ldNn-+`e_PzCMpsl=R-c>LHk_Hz@oqj5(r5woeUdED(2OyDLQaRmqcvGT
zCosUlxdDfEzWbMY*Srg#K7Le*w?qP(?KXh6Q!+p9A4HR=#38Vy5X<2~;#jdF3?MOV
zICtGpvoaoc`P-fr5k!4rsgH;#%6?SC4)f1L7ni>l?<d?_v|Pg1kao<g@}5sd95sYe
zD9=L|lUeJda2Xx4skyn}$?!%Z2dQNDuZ==&GIC_Hdc39S`SaKacOg43<&8>dRh2Z#
zYI3E=PnFdp!Qmv*F^7dxiC|1Pid3A*Ga@WII3{6#$zJBmJ(sRxAH&$1|3(JsExF?k
zi31LpJ5_hRgWyA+yQQ_&wGvgM0g9#Y42d6*lXEDMiP?PU9lS0U<wZrC-QgDsz?2<!
zI!wg}1vGxL&M{mRuf1o^%#5>7?8mufpq)AN5*Z_7YFb)mol%qdDCDdDePEBVM-$Z2
z`_rNNr;s9GeB{K5i{ds|+~JJr!{)WJys)Uqz7FYN7U1=hlan!-GX44IaJ{F&S7+Xw
zZ>Tt)ImA>#KT{n`ISmfyOFfZei1Jz}2Ou0s)htc4P3&FwGS7f*ujX6iMxx{(JTXz@
zWNBq3kzNC~@SHVphp>R&FF$g4-<GmN3XdoRtYkQU^j*^$>fT!#ow8zjInpk49e0qg
zO*wlU>aZQcBn18l^CoyfNFho^sF1m!)vIc>qRPGwg%TG>=S-(}ueL3N2+t_&@bTjw
zm`P!lZE;3}5@dkTefnDkesw-*ym-cXa2J$Pg81)K@MM6L($S-Nuv8J8CK5AIRaLr^
z>R$)XQQ}ZgBJzmcRlZD9*J;)QqfFmxVs4Jk#xqC^gmJwx{2~QyOMSAS9kJijXulsJ
zX}xvz%pRiC)DN~D+%#({7K%>hU#%BEzeZa*5_&dqiE(mqjU%jxBygSnNYj&3sxNi*
zPw;rVj#3a&;~_ddty2059%?)}^k@7{LI9~RX}O`j*135<`*c=0(Js1OeWAtPl+8|$
zfB)I-pa6!+&Y65|Qn}=e5wR@V_&lx%2y)~s;SSuWcX2z5k&zM5JjCxK2M&}+?FG#$
zsLE4P_Jx5_fa}lgi|qdWAneH}6YxQbenB;3V+qtSpC-)}M^Bz?ZWaayoT6&@6-Qw6
z$}6($&!VD=v!ALtQcj&>$MCdr<p!z!s4y#-`wr+AbJ{!@78<&J!-fy&V<!YOb1V_1
z`dh*}CaeyTrSVo#ih)q%<TN6Q4PwYkIyw;8eD#u1RLsYP$9qCDRv4n%8AYgGPB;}o
zx$9q~gGhDgGt||6=Dr{@3}?P|C0=EdiUXGnNH+W<$>+~g!z*<~a6(N>lZk!m{}Z1S
zC60iQQI%iiP(b7po92|Rx1G>bLC*mpLYMJjTy0{5v7kLXMm?W+;Txs#Lz6<?wp%NQ
z%S0X_j*l<}5=T^s1@;lAK&%Y-88LEjA7Cu>bly0IFzmmCki7zz;bqnh#LuN!zy?Av
zvq^^%+|$IfZL_6m@W_{_FXB{mOhvdH)6kHv#AIoG%KKJ@Hw6xhP<%9;L)W;{bwwPm
zV|Id8fMxm*oO;OR47^3CDcy6PVcH3E^AGs*;Caq(=|fa27!b^7NW-7b;b-2~Cr6VU
z=|bD1>>&XG+US47CPbX;8d^)=;>c0cbGL3v8<4)7Muu{;gJF%cUA&}k*;kAH@WAph
zv-Q&kvp#^Cz%S$C;(%*lnGMqh1X;U2B?0Lv2M!!KvV|GW%vT{H?q5(^HG}$a&i67h
zWySr8yUYo37Q{h!?R1H3`Zhs9bJh(4hM!RM4kDSBCWQ0fgo(@e@82y2iZm)aWiUd4
zpYBx2eLr>3bQPSrLaXBuuf9n+4Ft^D%GpMEJfMGpyZd3e#<79!S}8_knAZ%LGfayx
zzl<?Xedq7~ssZGi!J@08qBV0~_Al@-9UJCRsAdNuWM5k~Z(0m{GIkt`WaiLHzP|Tw
zZLQ3@#;<Bx{;M*WB1WlRDGN8jPXZ(j{a(Bs-M74{AC&K0Qr@4!*Tpj-k-fAsVSs1r
z0M}~5UTdIFp10ks_f%zPntk=AmPEU(WDSe?x&P2u?CKSmG~({I+uC$~V=Ct8caWZx
z$`W^@-9ch;x~Xg6FSg?0KEgf+Cn8Zw6Ze?-Ke)!*Y`vD*LJmv(!)c?MYmIjO3fG=i
zUSsR<5i#vwu~oouddWNvD>Kq2rh|T1b7x}@|9`UgbJ0T}ik<IL($f?BE3KTe^e+fM
zL6XBB+J}+=cM`EXrIl>AydX?{N82_h@0{^#lW#(Dkaszf&Ko~JWz-jOugA#=_u`?$
zhp!?;K(835ZaHq3(U!!qpo(*E41Q;19PiT@?}Is+=na^bLqXK-GP6YS=6Rt60D~P7
zLjVbuxBfX{RwPpE!7&E?`-2%V$W~zClFX@gddUX>!O+ZXn~}9$8FvME{DUtD44Q7O
zqhWk+q*racvlFa{W+@~Ay3v=41sqaqL=y_2em)XHPCmUI-l7*uFR^kPzJu{Q-C3*H
z3!&l8WAz4O=iqd<sv7pu8_qEM8^gu&<(&rTfIL;R`};r0>z{D9LKjHvcJO}9)}^5b
zk^;C1*~^dRkwpm)QGVL&ak6$mE73T!OE`saF=2%8ChrmzeTQ-lSohHGK?|=SerbSb
zXo{#UssTIRJvM1jI(@ntOm1|_wU5_{r<*Plp+FXmNh&FX6oDqJi_w^rxLr(5Os1UV
zQGT8pEnDfwe0Ez<zv%_U@Th`jHP<hm#O&B)p^UR*Sl8dV62={sl3`zqi~C1AY{%j0
z4%3I9>{40y#l-Q^j#<C?I<ibUPv9eHN%oN^c=${D`m3`rKF$CU7n*Sd0QbQ=1A}I2
zjfs*y-S*CT@(Be$U}*Kby&hE@!O`7z;I?gOd8H+D%Q<-F3C|@Vf0vQjLUW1`!;4)9
ztDNy6O(?_^pc0s%s&w1>pj@7PyjO5$<xn-wG~05Vnm4tvjMb{dl52F2@fE>0ab`3R
zt1oPw=b|2O-@bi0C#Owk^*?uM>$e0-eX3(Qr-*MAKmcMtK}7J5bP!R4AGriWgM&zy
zJgRF<GiK}zsdsHV;um6dc8-r@>$3B^Tq9a~k)?dMAapdZvomzh)B857KDXy7jSo1F
zZxLC|c7&)tW~g34++2N0^@U)^AqgwgF}-{_w1faK%1}{F7s4KC-V4tKN@C9A;(++9
zKq2_MCls^2(K^4_U5?<A)HM24iNrxgr_)af>jpBwVS0g#DnAI%;)mN~3uy-+i{EJK
zAoUGU?S_WV@(<{MahMQtA%6fxjR?~I3?19db`a`nVu3rIshVgr+Mm!Lk6~<PU6%q0
z?{DsDl2{uoSRxe!xL$`zY~eUn^YZ}C@PtBH=zRXVvz0X^>2L#<5&D!n*$k%e2M(Lt
zS5MBK-YX%)Hul-Hmv%XIv50Ty7N*iI1xdBLaTGnuqu}GU%fKg`P)Eb`l%K!BU3$3n
zZ}?DQ@Hy(4a}=VL*4&iLJOfXP=4+bd=!j4bK5cfU2R=Rmk^MbA4o*&$G_lcxFU|p^
zouZ<TTwFGqS);MU_QzXaVrA4Mw7auUqlehUCD&3LrmK(CynSk)a@^*FK#2|02Hhk~
zp;Z!he#Xm|Lax>Sh*0V^eC*1ZT8UBxU;_G5@8mt5GAAu-c}d!wvtCH3%Rw-Kg@t7~
z&kqDK-*H3e4`lr9t*scc&mp5r#mshxQv*9)%umk9ZX!tnnVLgh9G!T1^wsBd-n0FQ
z!xbIK(1B|=<pZQmshM1(jj{%bqmcwOSV)*=>mcvPhn<)AtzLzGtaVC8>NAoX9p-@$
z{*~-VpPbg^1<7xPuTR0=@}&V2R^E*sqUTmmn>`w*HmY9ck}$1weCS*G_>_ZB7FASm
zaB}KzXL+vRI|d@_5P_7Q@Fl?u=p|w@#jE%JX$TV6DS2$Xwc^hsO6OxbhwH@_EOlJD
z-#9GU?5*Sx!<WhH))cJcie7TDYx&?kHcI&$%>WsmC(C&QhyHy+F<q#WU~#8>gLXhl
zA+KXv-hWzui=Fc@-&a_@mOqkHGWqhwBLYT8{|o!Q@K#S+pLUy1Lf)3APlv~YLIT@U
z%R5fCT=9vr&*fJx*CTsN+g74xp;_@25+iJFZ2_$ofW+rv)Ux_S^oZG5n3?N|7h!V+
znU<P{z{ldkLO4M)=T8=QAgL2EFiBP(Nsu_7&whd!H_N6set1w}ABpSy@MkweR?bmm
z!903G!CKqZ(^JsWC*x-brUFLp{E8<sK5d!2O&!Z+bwj+~SZyaemF9gT#TaGk@Y$E@
zu3iN`$0Z|0mVN7=gn)1&cS;P;bcfn}xEVom@wqiikM~HYX5sXHrvXt(4;fX=oY1%l
z<3#{lfb+Z0Ug#b{njdhQzpSDmwLTea7EjvDf8q@W-a4?E(7*!qd8j`Uej#r|7($~C
z$27Q-sm3<MtI7CQS`ksFglG5@>}#>hJ1X9uSAf;R)>fL!kf?K?8ep0*`ovi-BI3ro
z+md0H4LPy}DZbfnjFnEDSj)lDh6*X$o{AT?Uyg&|hYuOYMHH0cW#0=V6(Rc=S`fg^
z5FH?dNqHzT0o@mWZB+&Zs0Ew@K8aQctrm)lvGAm~e(!8;FEe_HqXZO9GW+*KnP*Sx
zvy`0mk^&9)nh+_f(=80PQAh7XOiKKj(Jn=or7*mM0fa#zInVJEPcC5ygX;7e+p`7y
z*SH)bcI`91>r6ZHPcDYee=5+UJ&g2E%x~8t<4Hqdkmn3ap=tp>7?t@7*Xx<N3<<Pi
z@;Y*@!F6;`a^|<%3)ly72{>v@m<9}MZuFqNf};bWFYs<agpcQoNO`_!rJ+G6*|9Go
zSr-6>@%Y%)Fd_7VJUs$3`c4}@2|z-Tt4<Ot+(z6YKud6jOm#<rbE-m0tQWhT=mWqv
z=mEcV;|9Cv<)pk2a2DVrL`!i(M`o$wy{6{omE{OkPVGV@I|jF|N(j%SYE({4J5jtt
zrby^-HfM{7&=?#+5$i)cobPF`E#dHe@+1bHI%Ii*Nrt+~z9IhyrY}r_NCbqt7i&Db
zxS71oFgn)ZKR|+Y1XOzEi?lJsp_Lb74Wwl#p2*3{a*0$`Lv1QUiv1@a$zjYXn&xD)
z;36GZ8}q<keEtmDY27X=rXCY9H7zYI4UH-+Ncc<kxxZ)L4Yt;_yP<O<B#79+{TtvV
zrEFn_3&tr80-!td;P)+q+1<434M+nN7fA#L1sT67fc^-dUHO9hJ4HnJ+%hq2oY0HX
zMR5>A(>`QMcz2v+fBMyNB>|emqm4PzBEPJRPj8oJHop1Cfq^?(+S6c}+ynnSpLef>
zF5r}e_cF9x>tVWwhX+3Htnz>^e3F3ku;aar|NauwDu|mvr9-wJ)FK@{rlfrON(AS&
z@@sW97{K(xCte6@qFStrYudoSce7l7ziuZL0o=?YDesTa%=g<9u(b{3QFc-N|MY<B
zG@vc#wO0%Zi+z24)n6mR8utujlOFo4J9m^V%|i~7=q7}t?RcD$H85Ziw3VvMl+?VB
zy{#<IjiQO-?yB~7eI42mW220lc%(7Vlkx#A-6+z|hXK5z`yjR8V0mg9E;KySc#zx6
zB3iInEWD0@bmBOV8`DET4Yy8?CuL%7v078x-&(qA`SQ;Ial60kE5keM%qeMP!{E+S
zbG8@<^>C})KzNw$qV4X|VeSGVSV*o*{Sb{LO#{BpAZ_VRgrg0^VR8=Z20|V1J(<VX
zgLMhPorp^Was?OAEg=|0^94LU5ER1$g`|tim0ql@tYtB#mz0#0aHbGN?2w=ygktxc
zoPPB8dsMbJGVm*;WP}(1_XG`i8+0lumBlatIv&kfK;`tTA;m!E>sgtZFIEvt2aEYv
z=od#eZ!amLB=&sVEpGc%BnG!UGOfIwClI~=PR(mZG9=67Izo2eogUrXU1j~swmmrH
z&z-+zo?$>Iko7=l-UTq5$W0zYLC8m0cKTuONC-pU?h&3P*n<{$B%MB<>-g_@tgd_e
ze+nO-YH$}kHVQ#wlDN1Pm_xz%UPUrF2m0xOI}0Arf@d=S`j7L@_zeOaC|ubndi-j8
zu=Ak>5mkemIeHHd6@>3<l<!)>xPgg)2k5z!8TT-+FOu7xpw#?X@L{T4*FcWJdT(AE
zHsYMb{m0a|Ib+SFR0jN|x-3ZD!%|Vg0=kOpjLsQ@)zT;4Cx-4uPMDRE@nYf?S0xPm
z5FB?kJv-!i`(H)>@js;ePo+RHK&-tqpx~%j&M}QsKDJvd9*jjtH7d}7A8DLY7#|Ay
zi#2+xunw?}($?=Jf24hPp3T3hG}J%@ZWBM`k=MKRV%39kr$d9NHVqH1{m|D;o&5Od
zQRh5tlb=2^yJs8Pn3Gl#S(np-dWbf3m0A85bI{v!`VIAym*&lz-Mm&IgB5^yU9;o3
zCE}qQeVsT~_9J=~-J^M98S!oFh|9BM4Vz5u4r#iqFo{xqtC2x2$q6DM5ERa0pWNzQ
zi<EK!6DTN*e|J&fj{=sth50U0OVV^6)z~9WR%5jJIF9|>X1tYg|2pU~k=3T&-k>s{
z@{ELVYN!LH2db|laxS}lyGsV4cpe%WLSK~k%xYRA$RaGdSBC1cToitS7H#M-P_RxI
zY|$H({{yQg3}EP8!=jI_h_KD#;;LP%gszuBWWU~L7+ckYiLI&!gIFoKu5mkBnvIQ&
zZ~{|Nc~pYc&84kLWhXTOMthC%p<;N<LF>e64`&!XD%Jhb(=%MlH9qwmOk7BWp4#yU
z&I_t{JsBMG@+B0%aCc!s$MW`ztz}_(yis#kZ8~%Uj(6{tfeL9G3DF>FTd`<b;Y>oN
zUP7a4OH27XLoJ$JH}Xm5OHv;U!w1%!vA-fUHlS60Cf|($f1B<2aMj@CQ$?@B`Hoz{
z&hMK~7kQN-cDi>2DdY(J#AX;41|uMPQ?r{L$z!ix!}ljHUT$Vn3|r!D!{Hx#UH%af
z$IA3YJdg3YwH-YHShX5s5mtaB5(rPU`F3*+Cwdl`Tm*|@IvYX9*oRqn^EQ2OxVSPp
z<cwWbs1gUt2{lE{;Oxy~X=w8nlnp}s1!Om{)(=}ugY8`_a>i{~L!O4NU-n6dFRQ)~
z;Dl9BSGW52Gv40bm{J^&1vN4t#5EIx^I`@-aXN&qtshYeP<$-U-L(VcVms03mkw;`
zbupV`8rEMBP;%zZtcJlPZIYW`GL*VM`uf`1+s$mmjEWDk2cHa1Kn>xDA37tpA(%<$
z(dUAKRh*paii&%Li02`R_Q{_0L*j{#1X4x>eU>a+hT1zG=neqLEcu8@BRl(QZ{q_C
zoJF8Ig+p^|+Nl_mgTczqf%v6GcWOCHp(^v>KcR>w_Z^QzPDO7}zguzQ@Md#w^yUgI
zOYWA%?S{QHUt|8siYLuXwgcB$_!rV4gYAoO$dxF4ksUZ={G4YQug(gtZer5ydkQxl
zcz-A|9=W=PpGm$Yw3GVkIlVQU9(IH4t9kasiN|e91bo)9QGrz*dsD<vV97g-AuBxV
zm4MNK&Vcs&pd{^`Z^Av5<oe*zBXBYY*gN?bmc_Q1bFOV|UQa-!Nt@mi>rE2#b_t1*
zWF~2-LcFA|J{hT5YpV8wv~sNe<|jvvhL`pd0}S&f5v?`}I&_+KC3&Sqe}%a(Y?^qO
z?`zz1z~&P$?=?s7L5ZRK@v-qy4XZZw1N*<fXZ(Y(_1jsl8(W2umRKG8WYpH^EaP2c
z-^sa{%sZ-mx9z6VK2B>pJEC#(1!Il05T*})Nb&_Y_fu19#j8@1*N<m+@8R3PB(-}t
zPBrrj7j*fuV31HynUAf4B|ZI2QOh>%hQYe|V{D5EZ9Z~oZ6P44`JvlsL=-Df3rwHZ
zhw^1(9+~-@a2qmI-~68A>Ssj@ICw<-SO)cmbc2@Rn_mW_`iQlc{>93GmOYNxQQj#L
z2=t>(1ZWZWakrKEXwJq{e8k=%&xsA3-e)xp1=O4T%w`vA)68N-WyW-6i#}l%LkGgY
z(}6_2i4SBts~5X;*FMI%`^xV`x-<UR#bVo`|Bcvy?CkG9dNcrPzFf+DKO$82JZ)@l
z-f)kB;nk%fYkW7u!F~TIF)&Dg_GcK#Q(=?Io!mX{)5l<WtkBT!x48#`Q<5J1zA9@Q
z7Uab@YX~Hg^|{4{En6CoCk_?CUC`qGhlHu|q3<5`%!#KMG9OI>v+pNAh-mXg@;>#h
zrMgbYR;|9ygvy_tvB~n>1#rtWwX|5l@NVy%gz0mi4XlJ&zyGv<a}x7Jyxf1UUlYlk
zNSy-0hNEG$?RY{-NnTzTxY2Ac(%&#xLk9)%t=mFmx6R&dG_}mkB5R0>pZw72N1Jsx
z7L9yFBTs9<fB&7fuqeq3(W4UQq6Pm>o{RLHtFWY_JRCbrA}2B?0g-PjS8z}MbndOM
zZxz@0fNXgwKbwr1!k6~-rJRv|6thC2;cm^-BSA$Ft<}T>t;zoZV7p6^J;~wje-Lg#
z0pjuJPZC1%FB(9w8zNU&*5DWi^9ZUHfmPfh5Mc?Z$GwY)=z}30$G@6rVVL!hjRh0}
zJ~I^+mK7`3N2t9DVOyDuyxgmx@S#1=VoU7-j)ZeBniQ)tLbg#MXj}TnAE;?$XJL5<
z${h4%TbJriY9%zffV%B@YC30cS9<5)B5}{>mEYbsR&}mzyy7}!2tr^H!G3_o9=uNc
z1#*Wl$<3R!OW$bYG@80N8<EjC@J_#iK9E6H2gv=01JlzZP$rzv*G0G~8){>Fy8%tr
zXsfE0e{`|QCXQTfIC8Bj$8l4pbte^Pr?&Pm`u3L>68v08R~PCqMDiFLEq2ci#NqMR
z+n)Z!wx?+>f_=UX6znD*+b=x6-FL3j)D5ZMYpMg<AngrMv{xgf$ZdG(iZ&R!4;$ar
z5cny|>{lYj^Zd=1$40Io`(w~KXA?ZW*v-4MkZ^l*&(UMYc6R$~Y*h2uWZ)4a2jCn=
z!c0LlCE$1oSiF!8akfroa{!_epMSNDn<12oui?s|WF$jsOjMq6aT#1W=J5#uzx`+1
zI3E_BDVMBU!I&Kg#lg*`VQU`zA#~kK<NEvEvtQ)m9ZM~Ec#f0pxef{j10*Vcjl{($
zZ0^a(e5h?`pcc2l#|HQs2AF`@9kaosvwa(*TQ;TPp2FGtqcmagMnqchtwjh`#BK~Z
zQRF<s0KBOC{7mI}yw0K*$o5ADhK9_{%~d(>)wxkV0Es1*M#vhJu$Fd2pp1O_xlS&o
zs{lv86yhOh@}Y=%lUZ9|Xt;o&_w*cY%-dLgX6~uah?>@p+g9vK_gTX2cGIE**gLFQ
z7y*NwG}^^Dq-{>g>ks;2hrNG)d6PotEB(WL5R3k^Wc7kq=hz@TZX{lA2CsNbLm{^E
z{ld_+|2z_gA;SXY+;MN;zJ2->+xUbDNP##USYKC@>=Soh60WM@Q}DlmI=QlKaC$-k
zBmoYMxHqEuGLmmVy9X#A?P}bcH|v#z{?lGqLZD<A8gR_SED5#KO5^4}%kmyf<ZFzb
zBrY=9AADuQCxWaqo0R9IBE%Ks=p!dWxmH#WP{O95KSaf}WwUwx@*dFxvjY@)Bat3=
zka${vY#?Y^UVcf{7lKGkx=surCvZ%3$m(&vkyvE<G_5B`Ku9PrFT0p_w4nTstwiGT
zq9ta1BW(@_<2!b>{AZwfG3i52cMzvpCZ=IR$+&wr0b0gypJCVN-{eDAu+{N<*qH<t
zuGiK%u`i~?rqLtAr}*(oqM`+5g*KQ2E8W2z+U?-xm<X)pBxY~^d4r0)R|iyYyE&w+
zW@?x3nkm@xL9-r?kJX{grh)5IaUe9b?(CYm$NMk7e3ACT6UQ5hwO1H$EiODX{$ec0
z;G6IB_-_yT|7n;h7nEE?yjPt?CSE~O!$UD0^Cyn4&!lIc@<`Z9C7i9-7yaYQ)j^MK
zo#35mAEvRvt77T?)e{Fv+K@SQub8i*k<>|Nr|JWKeYQ)Z_oBtI%h5^$W;zq;t(nt^
zO`?Qp&hZem&)gH|<^LTVGwE-f#IV{Q9<f3V9uAT@<3&}Km4IQPz&U_s9#A#J?eq6x
z)C0a*PxN9DTn#Z(Fs)d#hR6mT+<Y8Q`t#p#f|z`@$$RtvF<xwKNeq0H2lT2D3z9qS
zOuVI**L#_x%v)Hs5XJ%|4!Oy3uxTSJ|DlZu&N4Umz=pDMDcqEDCr_TFtBa6RcxI=<
z<c>|Q%&)5QMa_wF5ZDX^NI<6D%6SZ8M1+%DKxd?j{Lb(SfZ{`M6R^UB{V8-1x!c%1
zu@5!PBSN=VLs>Zq^0v$0mhpRxd`U=MxTI|)YTgZRycIZOKNXUY(B0|Q=0-8Adg$f`
zmV=dz4c0u^=2_U-V2jps)&W|AXLFU76!KKv4i%M_l6L$cN>wu93Weea-92mgRj^Pi
zFcJCNk<*5`%jd=D5q~532aR>$UCaLgBEh~5D5Ek3syE%L4cVnr_+T^iGLf=wIKw2O
zCk6Q{Yu9QSzeMBm62eFt>5J*Tp4pd^NQu_NGe0>Te#<d|u7I`~c?(m&d+vr+=S~~W
zc*+z~bc5@NJF%rWLVj4r=~j2u4<9Pg74bkwgbLXoHZBSK_ox3OrBZ46_^Q)J+*{%W
zXG~kV5XcsNOi4{m@_D@ys0*BQ5OPNc{TdkgD;CMw@M>TM?u5I!8R#_9E_)gJ7-|gU
z=*Y&dH#%g3<%E<Hdkp3yz!3G|Kd>XvA-y-=rQO@WqpG1t2Ng*fXJd%)J(8&C1uG?N
zN!WyuTaFij#7-~~e#yorxlmijVy@|`gj)$da)2!is`Oje9KUU+urQc}-xwKleWi)6
zEmn&0OL)u0#LB9wG{z#OVhw~?9cLc8D*T3!oDgwR@4$hN_&-jfJ8Gnpoz@v|BE~^1
zw3jDigBZR}sIwUGH-Zb8h|`(O28wl@^;Bq0_MahjWoq_MQ#ve*IlV&l9!iNXW17Xj
zgxZeGzuP}F+q7|BWKZ57O>5CwJZ)8wFET+>DTkQJ7H;n6Xd5jx{{}Ok;gU7<?lRtK
zNR-gAf^RQK5s=~bSHS@il}@7~$_F1Ux<rmP+Adw7Byh{Y=yzPF@xQ+j@X^FM<++X+
z-Zs(W4t2lNkl7Q8*5ZjDfBxCJ0xS-8Y}#kfZed=`#pMe~2im@G-_Bf&l|kn5%%^(2
z9>SGZ8LVJ~H5bw8XUe@Ea=YpxxKy{PqazpjNA!uAiaUZfu}km^2_4nN`CwIY${8Zb
z5Gr{hEYXO?y)_}s&#xBbhbPJS94g!pzu8_H-|{_9mq}(xIRu%g6TpSLwt$g+e}-9c
zBn3fm4)fq^0mBL}mRYUAT7e)nanggYUrz~90m?=by~+t#nxIEG8lX7(BPtOYpoJm~
z@93%M)ixlk5-j_4V1Xmdx7%19Wsoay?AT-Z=k#dgz>O{sAHLBoedFZh1VHTfKUbH;
z8|mO=<L)tk?%;eVcvaBWdtl)}zZiUdhgA>)Wuw*-A)ec3GTPaoTY&}hYgw5kyyk%U
zyS@%yIl*y{MFcJZ=w$DH6t#a?p{7bcrmD&YTkwe!2)ntAMvk~RiSlaIn^`)=Wb&pR
zJGzO634jDBPr>M6J6v7`l&K$pO{|3#bk@g~G6(>r!zGko4Q2{-Nxm^wYrS%jra^ok
z^Wy!OWg)$^$cJ%Hj}T7dQ3nm+AVkDb$RR^XF%bE!BHhl1y|4lZK`57_!xww|3@NFd
zjg6HxMdteZb@6dFqcIkxNIN~d2SGeYH|^O%5<8a_h-DRPjY)zNlJvi;iAz5q#5Ep~
zzT)ONIFiMjl^=+*9gaeHiL2#8hBa8;@H)Q|BHszl<HYkKoq#rX8iaK}W;<2|P5%+~
z>+iSg7{5fw*_m22dv6>sNg>&e#ev3XJ9gBJDcQ)bV%ObT^hSVwHb9oC(T=Bj#yUtl
z$?^N%_$c`KN*+&03PeH>dIj^h$nVhNTqzdt`3UF8ww`W~^w!-OJha<l+Jk;sRqPj|
zcKIep(F-*yY9v$8lSe%%u>auP1g}n{m9w+6d0i%NLpJZ^+%6#cM*L~rdzGce%$sG?
zvHzq%QMm{RP{vuKmAF-7EjDm|@v13UKp-KfCr2=qiRKfkz8IX_&d#|obTcwC!a3!y
z9OS)=nqo{_7P}EeOJ5g{x050ub4J~1;g>H6A0+x*JT%QWD(IKE(x>r@k63UY8zJwj
zva%AM@r-^iqe?HM-n9J=tL@vMe9aGj0y40t=ZzRk)*14%v*yL_6mN+uJCIG#x+l&Y
z{yH#paI@zmYxn(rGsNr8?VYssA1nmRjEz_p%4-Oy5gmeGD56_JT(^LL{nP@|U}VAy
zPko2!q)88L*4?^wE1FC2!vnm*8U3VeYT7V%JC=F98BUu`3cE7p=iN|d)GAtU#Jo8+
zHquK6qcR>UK$sxMHOcYn2A=bAA&!$VdJgE#uNmi`wp~vx;b48IW{AlEji~9%<YYFA
zz8`H(#JzfX4Y3O`*oklE=C*+X#pTK#1_l}(hOe3v&s`@nd+>J#b0Y&|zz+I2{hpo2
zP%Sfa$DNq2>^#z|W=)S>uH@U=f`PwS3AgIO9GaDpVSn$Q7izU(hH6Jvw+PaXY3nps
zSUer@Fxw-C2Ve6na^oT9MgdXDLvQck0ecG%mj&>WV9kZF5IH?0#Q*uJK?B=p5(B6I
z|40NM`j<ZT?3l)Qe0{tuOI=Y%rx^sTs;VkDG62imK62$~8=AcW4z|r$YV~+r5tY2~
zx8KkZh18T&3DzW(!<6Zp*17r-uMrA-#F;%S@pe(W6j2620Ge7vgoP252W2%R?B3*J
zG+-AOM;X?p(IkEH$2w_qp~gh{C;_}-uvy>#5Ck9d;+yYJ-;cy8Of60qG$K@V3W(qI
z`lNB{l$W=+-p;21kZ?nqgi@rSHg}ZNF>denCqV??2zvF8I(^s6^`F)@)d9p#b%C$p
zVk}ZM1C=6W=SxZMmQ1=-tMGHjr~gunT)3g@+Q4W7|9|<i8Nn%-Zo7SRG7yGDM-qC?
zufVIUvu7*v@DC%3)4@R%#uijShUdK@$Zr`R5XS$n4DVmWaL&->G5wH$Ik?D;Sd#M1
z8jh1I<|6RB99h@4-D*US0K!1QR3pjR1KGmL$H}FfNgok#V&T!FCLUvSNWKvaNJYir
zwe(N5N`MYXe*O5y1A38XSZWY-b1=#}zsV%uEKF#+q(lsEp7*CaySm^IZUq$t$Q?TK
zp87(VSCLDBI{B0VjOxItv0yt(M0*}X{3XU#FD^T6<IIc@qLrxMhk{A*uL8h9lj~Vc
zygw(66~m+T&IJ!heEe1P9Uw~K5fCF}U(^NNhbz4}Sala<s{lqY*r4ELw(3OGfQ*o8
z*jRRgDu=}#+V(!ni&ognO-$f{N$fR~WjtN#W%Q;6XZm=wHUNy!Bn!zrJ<{9PXWu5{
zCq$3kM7zNffvsCNb}%r|s+<@YYC8tHY73|eJj-0t>2NYIha2-JPmf6hqM$<&$l)lX
zh4u#A55#F)b4Q>F4W|EMfBZOW0*Nd<8-8Zt!sdca96#9>Eed#`K?Ln?=J5nlfBRp`
zGQO3|7zKyU)Qz9fX{s(*U~Rp^HmV1!9^&8x(^nF4a5U_z7;HdZ?m+gp`{Uf1-Tx`n
z^yg&-3-~`f^$)t=79qX!Ct7W1{$PkQ)EQ;dsvvnq1?YeDzs`a+((k9OppWjDbXE&J
z<{Da?xMF;m8d|KHnbXrW&&HF$>-}jzi-_&z=19tY(U;qh*rTx}v-`7PIFGv86?yN$
ztG$V1Kqvw_y8TYQPhW$*Z`$Ixu*q)C12M|b<0gFfAbz%BaLHH0kS9jJb7`bhITBDm
z{>1GYwmrqS)VfVPaZ{FD07Ftd9j&rEe!u;?zEvPI!#hG7fIpqq3)(7x{ag-YwmV3l
z`|#EO4>SFgF!<Ma{{Qu!f>(8!Ae8aPE)dP4#Lkg2uaib);A<3+wn@p;A9w!+mjh2t
zLyA5Dcn_qV`%``Zw1O!Ok+I0<fAAo$uyB)O@daVX!4JyGtulCw<P`f=JpOIuG=s8m
zUgY_1+VmaKPc^cdYakkftdUOBYRXTY*v~D%$8Y<xbIz@0XU}^a1Bqtp-Kl{jngrx*
z?ipLwN7xfYFCrT=&Z4W32nu4AC#PY!AS6E6AKcCPd^F-M@o4HmB$~e(5)}6Ag;EK3
z#+9&N{=7pOWCV**TM^B+8740o%PTYa(;__iSUWv|J#*_Nns@lHKz&+cZH*zdA|7gX
zG`Py;Zu6v&C*BeYMJ8bnsL%a8F5%30;J}@c{L|YH(1BXwR1GvwgfM`!A|rQQWN}du
zi3>kl{mL2|xf_P{fE8RSMpuk~Z?6##%&}?bw133x^0JD+Tm76D4Z_O3j0{I0-i5uY
z*D^lu0y~^030GrHZu1g#2l`~v<E40<#{>VJHkGd9u#>BcfzvX!-|J)ybbXuUeuAJ`
zI12$>=3SG{wqzj=ZrDZda;ecc(5&o0Fr;w6VY4|X$T9J$KAjkAj(>$Wsx7Jt#vMl|
zCjmY_#VyRUB`#>k;NQB{B@L88^bYmqv5$6MQa*k9G<;R?I)ATM0%9Y|06FDF2ftDV
z`M>Bx5QCQ4$UqkW$5o6Bx$u7wH+RxzbiK^hwj7XWkPxTe{0ts&;^86@C2#>A>X{iC
zS30Zb3C-(lg`{IHN@lT#R-ojewTK9fqeGL;cZv>w;gP|~d*s+H%Fw=n0ZmErl4+yM
z0mkaEx<kfyEl*35ZKfT)?=MRVFmiNoD91^u;P5bi$5r=5JhsL<JAD7((ij<{QHVdm
zJA7{dscr*ma>lei%us!t?lsEJ$x$9bt}hO|(+<K2DImC`kF%5#u^kZ{wKuk|A`Ytr
zj+Tb~Syi{AscG$%`~uig*BC6prEzo&e)Y;knEIEYjOI!%E-s;0w1H2hOo00<?O6Wg
z(Ph{+c*tJ&BT@KgA9cqO%{p*Bh2mDrvhVCleeIl~Frh>V35`kP*}7GZS^$X~$auZ4
z?}S7|zUYb+&l${ef5bbbmDFY4*hsb#!$u^H&`8mbgx@wm(bUW=#)e_Wa2K#mb5F!c
zwPVL1B?I3B9ixB3u~|6UX}qEidj^+@&C^bfzkG{g6(NGKyhw;3h=-Vdmb9q(KKa}I
z)Glvga-d^o1@rDnM2qo4U}A}PKPk4*lm+I7Ou(9hva+|sN70T10w?402AX_;xcRDA
zW{Dhv9qdCIgb}IEDdR-6#e48-A%THmS6}-HIlbHQ)Ws*KSYy1HO9l{#^^el?A?&+B
z(?Jb_o<Q>9prS+N+d4*tu@2ZMA?g=hHZqwVJ6V>Pjlas>#xq}@xS@zY0-$U>%C}5C
z@=gmqv+DuX1`_h#vwiBaT3*IdXOxs&3t3m87I2%D7)JAlw-2siceG^qg>HE1QyF$)
z>Z=ehF~m!|u%YzGo`EudCV%Xaxf9bj0tWH+^0P2|37mN2k9zO3JJh0$_Q$cavrEwE
z7aPR2StLLmY-eW&(Rfh57;BI8c*FQegYDS)An%wRPdnRVJ5X8O*V~H_%=p22Pj^Xg
zj8)J~`{k)9DWRILthBW00{QXeu=k4PG7h0g^@<~H_QBLn<T7LcFn}RN7eO+l6;cTU
zeL|b(KCekBu9v0;u)@F@sGS_75+$O-!r`VZUtYX;flLx4-4wUzRkd9B)M3*f3w5??
zTcO*c)GVBZK~Q1fgbbSqK*Y-h%%Buh1n7`Rvw)d{Tptdd-%J&984)oJM<zKTI9HA5
zL;9LTDQ>9DrjW7&jN5rLcLIouj(*I1gsC%fpx`Ga`;Qns1^53#2)3#gvmk`qix(}r
zQs;I&&Ac9~b!I=muP%SbQ>l3-Vio8K-6A5te&S}5_M;2MG>+S{Pa%U1B@Vr&*IYio
z6{hn0H9Uj(1V|ukmlUf<eDryUAq|dOB4xX6>;jJe9f{*(?-Z>1nu{9Hh=^C<(jdR>
zaHkt(546P?(0TVyt=zR42eaz^oTW}eCjL$#7P)V>qs6w~O6PSh)_77t*AG^7*vRr~
zzNE?0rt}ZhiqVq?QaW%re~>9%m^B+-Y()wM7H-rkz8J7KS+!-5slY!<PQ;+H_3Q^=
zD1?XJa7qYZgTbRH+`SUESER)-b!Xuw?J}dyGu&nvXU<v);7J$r7NEBaWeFxS7Z44;
zi{uOq!$f_4O3+e&+*c<GZK&jfwWuB07Kvu$16{Nwl{wa7az)*iCEa4Yc?<=%%T=Mg
z8ARt#H?dj<ewcMS7iwbQesc;WgEc-w+>k`pi7MV6)UEJKZm|*8G?sjzZKVx}FcPOK
z@+08iUS8I40V6mb*(IoQa1@P~=jG;3>rRsgST5!rg2;Bnkm6ft6>p`@+o09Q(FVdR
z997_&fLit!I<`nvj)yMwg;?Tpy~TN)8qk+|JWxq9(WyRM6O!4ZwStH++_Yf>hIgB*
zw5$4a<2wDR?j-H#yG;^PA=Gl+&S?Nzo`g>E`AaW{kv5y&JgKT0;6Y>6iKIcJxJO^#
zumSm6+mIbdJ279}nekEO2?ah~cUe_M#hMG`txo!P+Bc1D1V7LxR5W7*V(`dBWYHwj
zmqkPRpm_vN*S#G=I5QrJ2~f`?n}p`mt~9o8-#+95Zqa3zv@A5T{yCT38#;eg^Hy)K
ziQ$rorQ7NN`3c2+>2r9Kk%;uE-3vww7v~d}ueEzm-5dY-ZtMgXZ3AbRvDssrj-RWC
z?if95n%n^i^zkPYCvFpyI#=9@xKH`3maD~80Cb3rEzcl1^=0xthFjzOOT|E#^V-(K
z<(#1w3fUv%bGX~T6DmPmj1986eFHe>t{<XQS@_T{hQu_cjW%)yO|GFo56ph`2cR9H
zAC3JzKt_|fPk}kXHj3N}D=RDWwzAC?#+f=N<!nb=G|qo|w0`^oN`W+Qm6ai^*o26S
zRczg(I}TwE66Tg(`~?2Lt<pHt=w2%xbX+hnN1EW@Cl2D}ocXaG37&3lMKHY-7WN`n
z;-m-_kv3UbSvau*SVPKU$!kAS@W(u3$*~X8qXp95qJ|SU7t{*GhIe`YEcCDX1xayI
z9B0s{cXgwP?U#lN9{@sPIfu25M?&J%y+p`<+QOAn(xg$(mTx?l4By740Joy$a9b4c
z?o_Xu?ZB`>OcBZtz*f-E_&s|Df+8gY+<WYK^hMu?`xYA=n&S`?l=+6#*F^P2k{YN=
z)O$xfd-fs2E3#p;Y;Nj+#=FbkG{)*QbUWrT$)B89YAKZvKeUPjpE9J+t_nFlsGuOC
zHqv_CK{0x`yNhxC{kc*N^6t~encS{tz{yR#|D+an2-y(f3nmLKWJppXQYJS^e2k2Y
z1Y3&Owr>rO;^_Lb9Kp)ZIMrI(S<yjo1`BT#Y@k9N!*XJ8z8sq4FeN|Im9;?ZC0;rB
zo$-e9{lzz*<ZE1D8rn2Ac=Mj8uWj;8rORt(-cGJT9?daFj8)vsjyyOr^rv2v;6pt@
z|7V;k&a0B<u4Y?~OYDr6-Yf|e;Z59q+CU65;I!?plc_HAdb+b3A6=X`P*a@#+sq@A
zYfwM&3lBse&^h2XBq*`+$55C@)nNIWDx*5)7Q+uS7lF(oxeV_>>6`I3TP_@}vmNJB
z?)Rd-IJ+6g9EQ4PN1KtzgrwqSL)<6T`SweOa`O26OK&o&){7A+Z1lCt`k}~sx@O`7
zOp09+ZeH9Wq1iv}iwt&zZjQJ(_}k3GGfmrW8`U-EL`&b(ePgBp9{)3B46XLG6C{x-
zT+<;k1JanV66+D@g`Ht9Zjoa_%7|PB6}UB56zNz*pM|UpKrOYWM@&pj56f?&9?7R#
ze!=VZnNI*2X$6=EG&MDWars{5L&L#|{X1YaY<Vp^XuHh&o?%^^zWfljLH_w0c1RVy
zt-p(4$-STal=ueU;b*KQj#l@mSUNBO4ErrZAvKOTQ9VMdzIYkcolZ07J6^^vAY(M2
ztP}UJJq15!gloKuOPTG@#f$g3g2`pea)e&>E)P+^h+bsOyat5kT=%@0@EGsCS~m)e
zJI@K$=`8UOu_$m|?ac$vEz2QetWzj*+u?zioeS%0e{t}GaHa!b;Ii&~f9ZAnxo9>0
zJs8;SM_($v1j)973TJ7pFYPUNPEnS%s|WAhTav0kEW(k14IAJtr<;@tU{VSb!YP2$
z{n4W>JC~(|f~_QKu1~zJ2c@@B;R%Hfdi=R`sW%<<(Cxp_@AylbRcOT`z1dWwze{&l
z*9t4dHnVVYnuT8~59G&YY#*2sLMJ@eN0C}@eH3}<ZtKyoWk)wl`NlBo;YT$anZZpK
zK%)%XR!B$)=guZ_ebkayb(?S=A%?Kx#IZgsUf8s4VLrMNtG$W<W8+-i+`uo9?RS_7
zS2mw!=XmS)s&tz~Y+$%mO=YQ9O%FRQu-aBZpWKz|P8Y=<{A&=Nbyf9!E|Zu`s&qXP
zEa|!iI1F1d(1b`PLtibUprCN@U<T}){<irJwhhyn&S;_UBaSdJgNW4E(~CE4QATl<
zg+Tuwt>g=)+cit*1J1xem(~?O3!ACoN4zw`rNs@w@Njy=cY0JqBN6qE(b?a&>{EUa
z4y~c&iYy^zS<OK|p;RiA9FS|jd1C~hJ!09gpZjrFWQ;^!a|2rl)gnhz49Rd4m+eSc
z+*SE(-lJ*6p3Yd?_=rP0TmJ_~K>m-E__w6g1`=V+UpMA7v9Pe@epLOzi!kMFV?u&s
z?*-$T$B$qXB6|LGyiv#EaE7Lmu(!=OK(?Hv4IKDF2*yq&XhV<+cO2mXv%E6l0n5&~
zflGw&me}*hX(LkG_eUH%sZf8US`0E}l6|GNMUcF1e7s_u*>3+X-;4E<^#td6AY@a;
z;E2=wOGREQ=V1rQL2OBC4;J+`>J~)aVZJl}xco#FJxT>P3g9f4rpkHGPs_}8XKbnY
z!$ak((7#RZ2j4cK{Gh)#nyt%;Q&Oi$>?iT*-tPsSf2bZ~$yFq;BbERzK1(g2Yc7lQ
zJSh;MxM{dg3jLb~B2EUoXhFuhQdYb4-gcHHik`^_?|AK^w)))JnjJ{J<1Fffc}nOT
zSY>49c=6z^xL=Ea({Bht1qOeu8a(x#&C9{!t_yMajH@_`w{MYk-O%Kd)0=a<hRKQ-
zt!nV((|W-Zkw!<`Kx)@s$&%WSh)|5T=H^jtp~OrTLZcpy>RbmN^yW8ba>TAW$$76R
z6e+I*gM&?dmVSAn2#ZFwSJP^;lT)b<-{Yd4qC^tK>-UDt&(7<TPjJ|S<<Pq8Ot7iG
zG_UOU??=?Us_tqVA8I`itX%cZaPL@CAccyRYKtUSUs{8*cI$<>y7!`D=Xg%MRdsZl
z`D!P&Pa&TNQ96Oh!ZJY!4W4msmnI@oyAEfGk1nb|5J@0q*?WMMI}NInuW?u2Mn#$9
z7VDOz;!|XgH-tf3(+Yt}Cgbb8$>+;AhI)N&KFxm{6}%HjTyg@<hU?y8qHkWTOgRA^
zDM|r4U^BdM0kJgqJJi2#*_T`5^+s%E7MCNh)PzG$A?0Y>q|c%1O1|1-;(a!QYuJ$E
zE{(Da93UTz?bFBe62$gQ6$Gwqdh3=;W^X&TxM2pDV5Esgst6ez%C?{lEbNfj@wu`s
zPT`C&D|)8ubG)~X9(6Mj)Ok83o@ws8WBcv(ly~lbB4T3}k-5XgSb~)I%o_b*&xBi7
zhfj`nOw0LURmFa@ajhq1Vl6m7gRr$jf!nr)L3>TLZMM1-NTqyM>32s>!HrsQI+p62
zZpV#q^h@ixs-t|gGP(xhaJyXuzJ{&i!{eW&`<07tvOc?JcxG7dst=lV85lxgnqXk?
zn9xEx$B*RvQ<ajRRNN?khCLqnk&AEcL8(G=MgmS5`Af?(#2Faw6NAEO=KKJ~+y6ok
z*xGmf?v1^f`%Rt`vqRS;zSk<N4jbHol9qt6KbiPeHp*XPT7G{S{h>|wo~8*(&1D`;
zepwuFiy3nq%?WpVm-K+(-Z2t1WJ+*GbpP4E&n7gep}wJNWN<JQHn{KOqT;U()n@W`
z&YPb<kM=B$i-J=oh6|xX-^Fu|`4(SQ9CG+hyb*=zzZhHxjmiFhczf@7toQhRT&FtP
zDpILv8WoatQ${64+(IZjlARH<X~|Y0Wu!9hj7S+}q~b<OvQmWHMn)2u8Tapc)6hBR
z_x*kzzsK+U_0Q>4a=*vxIj-k*UC*$M{CWrN-*BZ3tknFj`f>K0pDPY*rc@#fCHzIK
zPMv!bH#J*TME}LH{->l_YS%yB4@GX`s*M4=<G=VK1P%ZC)qg78{!g<Zdws_dST*ix
zu2{Yt)l=&3mLt=`Ii=yop&<v54{K`nrzsar5A>hDY)K_RZpTm<Yf}pg2Zn|u#|TC<
z21B2Tx9H>FFtvb(p~K4~5Usk?Cx(lSG>K}7!O?;EYu2+xu@>bAQR-#-jPKkb0*D-C
zI*J+Wl+wa>DS!dgA`~%j0kQ%;1QIj=JlQV8DFnYCB%&=i3)9XzfM}Pl0a1B{6nKpx
zURcxjdk6!Fn05eD7z6(4Aq+t_R|BfCYU$dwaPWmapr!rS%2!uW%=z(R%4|TMhDF@#
z0E-OI>$#cH@bI({1#7Z6b$y>r1HdTQ@i>?LjC5~Hu&o4Mx`>o96bdCawiPm61H*rh
z^3Myi1^g+hQ=z=*%HAwsfnA9pGr5kBq~$8_&i}=siuw$NKDJ*1R)qHhgtiEA*s=AV
zoeo(5Z)zld6EkBV*|>M0ru$EAWzIZca;7%$_3MgAupvP*#wv%qsi}JR^=FmwNJ>wW
zFc|tc`XC$mIo7;hQX(oUiani}1HB9YPGS&)5x*`Ji&G>1HBOaJ-UAd)p8z+?zy<3W
zz4NAMN(~aMQxl+Fbs05B@G-Cq31upoT=qcB9%Cc{V;HIpR9c8&S4(HlwJPztshepG
zzSO(MAABjHKR(ot+Fu~PBznqMLTPf>F1a7+7<G>H?ZZdZ)B?s^bZ*4<sQ49Uie+GG
zG-~t<PoBI_PO8C=={Yh@16a8R!bIpG4P6L5#FR`x;CxLwUV`DzFz~#y`Sn5f)F~z>
z<Gg7-*LnhMnW7XIu{iyt9;HAs5b68BkPJwQWxKwZ={Et%z{~cK>s8bE#*hLp#U4qz
z=e<~XRaa>O${8@kXJ43B0WGC3`;p=e1I96eLj89Nj=dn(!wIVM%OR}NUS3~cR~PF-
z?z9s(y&uzl<QJG>@jE4A>9Fq9bP78<4}itfHH}Odtfb|EJ1~FVypG=9EOGZF7czE2
z98mzr<d<%5xQ_jHgU&ATT?bC1vj^0C<|jeq&yV^0jUS%LEt-;pXQlj$LvYhCW=QcD
z7Cmn1*1zNSKQ!Z)fmEHb6s!3IdWdw+YaAN67p^*!An@w2x;m$2miXSB90xmxz;^6H
z0nqHK#lf+j2u{ro(}QW`sKZRj#V@3P3}(KHKv*|Wo@dYFqFVge?9Qy=X*wT+r)byq
zd`-5mbx39TGQ4AGu(NG9toV9*>U86LhvCni!P#eY3!WT*PTN;{gfI4-){p-8smny_
zWXQ%ny8|!er9}6w;fsAfr{xDF)ZrlAtq2<NsYKO$F{sxyxRB1Sp4X`2aFf2aEqb;P
zMSEg+_TU13I+xI%U!;Q46-t!uy=9>2_eC}BO%PP;qKCT|S*3Vns%G2%2b3WF*qJ9m
z(Eg2RCkO~<W~D|QOCNgONxwu);dcCZp?<39oMS+6kZQCn<$Bhy!qatjkkt2&e!R;b
zAi&!B9^DpQy~%u`Qy2oFK%dFf?b4Z6OWL%Jjof8?+cM|yWz*?2_Wx=FGWExg{#%y!
z|F>fN<Nmg~pIrSS8!~8`a2N~npU<I}Ts;5j9}~r=ex;%9)z=L$q3E{xi@QXK_?#c#
zPkWEJ(3*Cs8)7i)s2>bv8_TnCF*XO!ZX&<ot7ukPLPEs6a8+ymsl<l79!e0x<O~e%
zy!$s1KlTd#Q6#nB#M&nFT}8gv4=)-*CtLuPi`S(~aXtUxUXo7O$mH&~0ImH!ww5)>
z`fp<#qWSUP6t|aW^FVk_%cD>Z)LB9O;~4X9|1`}XkRm~?;r0>uokio`gWnbs9*)_O
z?Z>CH4qQoJGpClhSzf`@=SM}dV@WdKyBGhJO#Tg(KP2XQne6|>?EjhAUP9LML-Phe
z0?z06Eejvn>Te=PsQ#RJzW+V*wA~0~AH-u~SHw3Ao(OA`aLehe$imgZeU*Ifqx?o~
zpZPnE|2eky-}hK^NG7&O@mHovL^PVR8IkWReBrV#z$SJ|AE)J<Qei@n7$gW11IY``
z92QLV#m2<!t8@Q8U|LVyUXh)3p{o7&!QI1fL0Ksl0RF4PSmT<Z^GY4`wcWoy#uWO!
z<DVQ;ImR8UOKTo*sSw(4n}H7HzD<4kgfRK*bRTGeIh%hRY}G-sgE*-yd5YpN?2g9s
zvZmB8cCLQbvX;`b0PSJQ<srQ6hxR~Osr3i#t!Z;<p#?h9b;4Hzr)~@JivMezuD`Za
zn9z><pl63R16s6QY!)IB!#(vNa|2?p!M(ZiU#vC_Hk&t*53=Pupi3Z6UML$q3oKqP
zV8iX~?79bH8Kza7PS@?)s_$~qT1$CGx3Aq_DYsNx?n1XfbBmuI2Q$#y8MFdCALJ@5
zb|ShxXILlwgIEg_lj+VZH7SX?{Fix&6*12}@k{h(@bo9|EyOXU#ti6K<4@xn{d#Yk
zwx<`)G`Wdx+m?j#D<Pp1Yk*+ta`Dn7n8H9XKec-4a9XOelFZT#@^W&I;T&dV)eBm7
zs|)#<`*3u_LGk(Lw)t3Z;dFKF>o)uoV)YaV>DJd!f}nYJ&)bzPpjgTtH~_1eLpsa<
z0M`LF`2@^VuT`1|5qS*b_M<=?z%Ttx@Q{Uz7(o;j=W0^;RC?AY3?&zeHN=Q-pUUYN
zmu-(w#a@X7^(0KJoG^ZcJ6Pl^(*!ih4cYeaWSP&zq?hAx4=EK4nVc(j%jak;$AQM;
zrrP2Qe{yayLUf2sdXjGN5Xl5FeknHuKOVV1V%}4qXDK)H-THcl>Gl2R-Q^%xZxB1S
zUxC3N8+3?p$1oOqC~nE6_;vI!qf72LRM_su3C`93@B<|tpFOIQ0AuQrcQ0=+u9#2T
zW4z#LIUr!-8$af!heSywJ5Su&*!+fHH8zul$;$oy#vQZ%Ji+7p9xrhi)Seje+jKnD
z<5MuVJ@*pEIAkKfv0LBz=F;e=36|77?O%c^NJGXI+UlG?Klgd0#yG($@A3A4hi?%7
zQhGEtz|No`TdSw^Upyi;c~9@~f(ahUC(`4^KRdf=KNf=U6{JH7eH7kJfgdZqZ-&+c
zytJajDN{m6y2sF$xqQCgw8uwm1)Br8O@x-4SIB2vTFP(2Fh9X(Pjcwp{mka+B6WBB
zmWw5L-%JmUPcySE5m;Gfnn%5BQfLq?)cEz>dJ*oLE-CJn%CnY*M9evSmR|n~O5q&A
z?X?#hnuY~Aq;eiUJna;1+<0cl=0<~t>JfRZD@?a0>gRxxfF)e6dtROw`n#FopvGmU
z^!)c7-cu=yf#KCf+SJ{~ue|>2S4iPlX!qn++a9*_)(o-RN*L>!EVkb!QJJ)!m)a~?
zs`sX!!Bm07P`RRYc2ASNa^zqC{$Ypz_|3X4Iw0aoeZRYSk~`t<-Gh{>(2$U&>$3Ul
znl}FV?f9EKWa1(eiGG<pi}+#d1NM+S9pq~Hlq1=|Xoq*&uKL7|C;DnVshcW^*T!>5
z+Gc?#5BGGoRjACeYC^Lq7nG`(pHkI{j;GMj!-I|xjqR-(8ntMRLPA(fR~y+RK6>N`
z)tN4~r8PF9!X}KQgrqiZ+?$MDeeoXjNenk(=X|*xTReTk3KvX_kK+UAr<2r_mEmE%
zu}_wXDF`l`=y5a*_Ze_$q-d{ZW#xP;X7c71;pz3t-`BTtBKVz_X&NZh*aegQ=n)KF
zRV{}XiCR8N1R9s-38J>i4S?(YjEDExOttv>%L8afz&*sD;1D-Dck_yhW&sQmo^-L<
ziuM&lF*K%tzTg_j929B}U(aWdD4?M`^ZDI|G7PM5>~^w6SMA_1gh59DD}|FBxeD9X
z`)K>q)}ZOz4c>W?S0VZP$Ve=O0tO9KOHM8>heA2?Qg``Kork};byf4E9b(HdwyP>t
zLpctW7(h3u4dFMl|G<G@DNi=v>9Zbe;&EDD7cO<g{5-&yc7#k0JW2wWT=OFao-|XC
z{u;lxw6tJESa=>#TbeXFX(2j3mlri*eB4#w8!*1o8*FQq?|KXuKhsI@@e0TBA%)ns
z5yoz-C0w0`{ZDCHsX@gCf+KvoxGX(62{#2*hQgKUyAK*JUGg;6u7;b;)62U8D-q0U
z5@q+>bfKY!YN7uxa4Ttf$fz_Mj83GbJ<;?JFxo(+P}y$~nClA7{&5=u&2w;Y=x=&2
zCnU1j!4|XY(oq%r7xzgSknM~nR5S=?n--`+wGDwj`BkKZiv!yChLt8B!q*N*(k}5H
zZzIk1<~MQj6yjVfT^x(G-Bv0pR|l~4Z{M*<VjV*6^*T`sT=e7Sw(<)#<T_QoCZxk@
zFi^XFyE*Di<CQOOV~3~KRta@SsCun2JHk&6SS7GGm9&LFKGVglDY8;4G!`1g<Tqty
z_p-CYzbs78S7xCw{5~QK!Ik!<Av`D?@xai-!V@9+0jaIC(+O*xa0o!?f+Cfz@w6FC
zx|lf?xVLW)IW>0$IFBPe8h20&0^bJRAR;`xtEFX=n#TqB7Xicd9fX&V|5~xi4hc%(
z0`N!p&<g76K0#9NEK-sct-h-p8BVgHK@Z;BlyCLudeN8F4e7ROXl77`E{lM7;R7ST
z^XK<rPY!X%VsK1ngcr^@H2-AKJ%fX*uzMLpRyQLXGl;J6gs_hp`xZtBqHJ3zH33N(
zgQdaG@2g(EG%xaBZ5wBb{jAuO(S^;Sca>vcgSJt_1NQRE*x6Gi%-v8OAvgBcrbbgJ
zpWyu&tJkese_7LJE6Pk98RG3o9em+u`uS#s;x-L64UMdmWo$6|gWGc2YxwPF^S_xi
z`}5P@lh?>Qx1{5V^qA<vKZC4hXbKCZgz?Sfz1u&6(%W04xwnLW1SN*27C(Mfr=zTV
zr6M9c%j?*aG$Y#Cua*x`n89wN3QI9dE^la+N=HZ}!dm(+U)6Q8qnmtAei#5z04!Cg
z8syxCeEtm3JvURzwvu7!XaRnaBH!BtUsdO^4=eJ;jMCq0MKXcY0%XjrK%&_-UH?Dc
z)=x?rzN%5t6(_B1B(e63;4fM};))Dn^{25s<zb*L)MSqpn8&EEk}WGEgZg95nh4DG
z;2)TM`}Ur2EJMz>Z7YQdAp+~3^MAXIwuM!WV|vraDo}->P~f##)?6GC2LnqyW>hNx
z*9^#@+<l3LM2Q*+(^PhGyMvmOK&K4c!8J>7xPE<ApKO}Xbd=7p&m2Cx>dV7AtV1Ri
zM71K6eEGun)@iUyt)M}57oUI!m^#o1;9bE4V>=(;O-Z+G6mgJkq8KFzN4)Xl_2L<2
z;IVj*(!NUU-VMYZcU-4n-{JQ2vVJ^g<Qmh{b2mf(X1F-McmAiCxiO@<)(bpG&Rt_P
zUG#jG&?X&@-Hz5npO1m_fJ1fg^!UVto2x4fTww7CSHRr7ytvAJ5Jmz$!CV&s<`NUf
zsiRfsj%=;156a15st49L+;p$Cce~lh#*k{jZpEnrT`a57`DIyI4>%NN-4?a8O@)Tw
zMv&x-e89w1URJhZEEljPZUq{TJhjyle5M$l<taspZyD0wjS3Ks4X%6kJj2n3T(Z!x
zv!|36QrG@F+*e$k4)@YA^P3`f))|!QsGM?sc5bd0{!jaSr_1wElV^Xv;br97k&zL|
zfIG1?jKB=ziot{gY=S<k<n?P-CNMGLMsa~6$(@+Uz-0rlo32$`{7MRj<E>P@rO<TW
z&3x@3aaq=o%2S{ww@dHv;q_&ysi|j9pBDU}7E`>X3|gDulkKgo-fB3ca!UN#kJjI0
zWn~rFx>d$3;w9*|->@m~j@vx5(Ob0!{d~gVhY|nwJsi65t>WCjLcij{gY)LivvzQ}
zHrYx@O2Sif^Hm_@IdX~wDa=t7cPj+>if}TR(vRSAg_8ns3nLEG_)aQMTY2Sv8JT3w
z40+3_9=G*u!;x1tusU*n)U32D=Oh*41taw23TYZdyx3XEiO0TX#fps?Ww`erUcV+!
z7Kmp|zez80s_!0)+?nllvWIw!s+LV59n!%-=1h%^!{8rv>=>*wzrxC_WO(*YP49}a
z=M`5r9S}O@t*fWU|Mp{hyE<0S+zdqAKNj(Ia4>Wm3CE?BRt;yxR%)x&s?|EiE*##C
zl52Dz)qisDo~5a2f`e+(x-i?QO6U?7#8G7P#o_>Q_HOH3xA(MGvT`0NF4L?1%lz#t
zs8eDL>8k$z{(r>!7@ewRL0D58PmUslv4FVoq1fKqVbSj@X68+-tlc0tPe*XImaO3o
z1nnJ2dmJ@h;l^^fD66YGU>uF1_EtYtknFH7HYqt-8@&dO$GdBF;`M{li-wO`ss(c@
zhVMAOS6yA*-hL4C*+SK{HO@&powWo04!tE{SmdpS{g3j)kqelZ!rHfO!<)b?_-DQ$
zD>+|!^MTbI$<Z|V_A!^g4(<O@GF`<H7(&a8GATwjKodl*VBsjd`|!0jA1}djvIcZh
zu5NCGpN>4X+Qp5cc>>^;i3QFgSAv6?moKNawhGyGyaCTg4>|jZs}uYv{rq0G1WCE$
zeF(76?4AxpTc_lbjEh!%{QP<QwGZ&GYyPrYB1QJR{9%mX;1BCO^trRGP1vw#kyBU*
z@uq}^g+U^p5BVEz4}x?KCKAmXgtDk?!t`V%%f)34%ttr>sHf~UI<JUsC+b|no2ck@
za{OJPu>!Y@Ek;5YFZ>z!W6ilL!)b)}_tK?ea7SNUBB!*TXs3Kp;#e)%+uodCIZ4F(
zGfp$B6NXMRIZf?Ic)-Ns;-C~Qxx{z7^~A|@1;KYNGP_8+9Iv?~n}5(~OOKMxf{!c=
zeRFx4Dpy^Yy<TUJ<n=u-Uc8ccZ78#;_rd%RJzry+S0-?iZ4w!Xe4f5r8tsCo-P}=6
zhk?}Z)mf_NCW1@(Rg@!XM`jTXf+?z_zneXU<F_$02S1K)7>bcvBeZ|_NOj94(IE~B
zsm93KMdYX$c@~j!)(6aIl+Hfq+HvPKpC*53++?-!c$%@^#KYd!az=V<w>`(9rbrsl
z)2S~LeifsxhrNmtJ5M%J*rgPrShXS}k6-LTTQK$Kw_<dB#|-yoah<6TQg>G?75|Z8
z89EMc;S$7En`h{SR{kiz8E&;yvxJ`XcvK#qzcudCKkoVOZm75a|6@1wqaXXTMf&lZ
z1Vid~T}#|e>9L4_z=Kn+uMAJMr;7;IZ98^+jS2D}Pjx{tL8ffu;pyDUXp7W<V}%}L
z(dwPCbBh-;biDfU_xB&Wm3Ez0{i}*llyYE@*4Q(3dpdGq-Afs}2D&S>&Zx$_ySo)V
za;Pj614BcYYuC_P<}%ow1fA;F>kuWn7S+C1u49^`HH1RwrqH3l1MJ46gC7s!A4pUY
zypp<aTs&QGP3#gp#7*uixOU$*@-L!dmuAzlCbiN+PM|KupyDb!0H$Hoew8iVwW-~9
z*(i!-2c^2VO(~SD5i7oZtG|Ezd<6}*7_RtnQIU~w5)<6HGhGyWrZzapZtrbw7C@H5
z6fv<3^7G|_NY5V{8mN-mdCqEvr@aKJT6T06_>9of&Nt2`x>mIrcVG6?;!FJzs+b6Y
zD}vN;Mc3?<&DPDEPxQCGKnDWY2=h+S?SxU+uRh4z5^a#Vl?j#%qo~0kjztLx(h*o`
z#tl^9@Y6uM0>(RrX$xTymYOP>EtcVS^uGRC{3I4ihlI4`o5^bzW|UasRwQ6cas*d;
zY`FIjzi<)>ATcj1Hy_`%b`D9`clSx55fNC2<_hDiJhvU$x6wWIeI&Z4Edj4X8dZ>F
zCGJfnS!OK(;-}pr?eCq{e|9KKe@35B;Z(4}gK#^M<l+KpRX}Q@Qz<SiTrHB2jiPkP
zt%KV^jK|xskdV!pB#U?V(OF_vX=c$e-6NssD9u_E<usilH)NEpj*_$Sow})3&j^_2
zXUT}`8TcYL2ys9BQV#~9JB?c&bQw~(WUHwqN*H|r<%RD7s)D4H6!rScolTL;1)+t9
zJwi>Oveju><E|AH1u=)|w<u@9x+{bypE&Ph5@tV_!@^b)%3_wyc|t~|At0UMwL!ZM
zi<-<AE@U53a+Ek>?}qs>b^!}*C$HP>xPz0E5UK*81|`kL+WIb*BfWcbVLmfD!x>%8
zkczA^Ib2BYRe5P?VoHi6_%@DPMULB@HXFO85xKMN-7E&3xl`%%*0-y@Vn&9BEj>LF
zaQMOlAy&~v!aR$MivqeJ;i9U@O8L=}^qISX2L<AO-{2tDmw-m6q@YmUc-YBl6fo`B
zVE3oaPBE*--JO?4{a+_fc_6dz&?g$!cX7zKNtR?wjsaiQ__ezjZY80)z|FX>XDN4V
z=+c;(ue|932G5M!)4!`)5!QL>ye|23pTdh53YxPS^e@hQG_RHh)?Iz@s$;~hq4-N>
zz=xJqdyN(hu&?LP&*-t5Pvvocw_H6?b*cb9*pjj$@D6_!)7;mMmQtFp6gpVb%Y%Cr
z&Js^NIeUWVcQY5W>G=i^HM6V+sZte#y6&I<ru3NVZ!Admzy-t9`YQTJV#owtE&lp-
z@o$A<3uT$>qG>F*r(h%^OJt^7S6>Tp%lpz&{x|u3(>7O+Uh9N8m*4Pqv_G?}W1RY=
zWj*CH0HTW9&D`YI2cuYXYTFWKH{A%)mkR&RLY%UvrS*CTVljsC4CL~-ViwkOch04X
zYVZow{id)leRAc>gyk;Q#&!&zp?CflHx+mLApw(87>Gvya?$#=44n&bx<uFfGrBP^
znU33MbY`5pJwNa=E0O>CZ_W(4(;4{9<jEMcm*Q)HXF&{k=2a%TD5>uqn+l4FMCTcZ
zkS<O6k;sx6@shTS;tYeS@KT9~Ec{-E_*?n{$O=28d{xUVHxmDUe-(bv{YKTNO-&wP
zup^!UXMtFrq7<#0bxH?HxP}iOblpeW(1e(#p$~&;#puY$qnw-rGBQMjbtkO9_wL)L
zqpc0?h7(f5*RR%qmC_P{v1?3$eI~g&tSeT;jZvOHl{PJdLB=9rSLSPkOx_Th**q?1
z#uX?vm&oUeu3x`?%a;A&{DIv+Q-Yr*)U3kc>XDVZR5BU>Td*j_v0_o+`44}YMW|~j
z{mKf3%Gg}vJ;ElkY?U@c<@KM~rNPm?HohF07edYZcs^piV!j6*v~*mD8Ky<xh61VU
z$Iax|dqQLo_#Bz0A)G*J1+^wxGzf3z&Y5%2ep{bI+B*Oun9;7k`S;wp$ah5FHXUF>
z4hfoBY3v+t4+#oVg4HArI>?Iv-}mi1?~}B=7yAiZV6AnOSdVFY`ZRM+^}8-wNdLha
zhfV)TG*%BtMs^YqreHXa8Wr#r5))kTR9r{fS<Ww%X8ZYiX>IjY^&GtU7nH`t4w3<q
znArQGqIO7)Dy!hPV*?B&fWAE*p411wA*JIPVy_N=o&+BsIot#CgvYF#AW)HUPV95o
zQb4Qz+3GDbCz>Rmq^nQFwn!1F7e35}Nq(yRR}y<<Aqu(<&xY+~a8tVPU?XoSF^$TV
zw%j36KmK*O=;v#CEr7<NpGWcRe@n*4$NSWO2s4OdQxyY|I?l$%Ztm<sXBB)+3W*18
z^Y{=FPl8YkK23lNxu&|>I}1)%)Iv3%;jIf5rl~w;7WOvsl6VQ0^4_wLemu8Y<em+Q
z)&vg<9}(D(5uhBE=kJvS3O9W?vn+7hx+Uf+@Q~X+eF7l@Gd#0=ot_9)HY*J_0Rx#}
zDi5>9mIe-a_pKhMOKWR2Qcgf~D3nFo(i>EFs>AKH{Ha+PilR;=<SK)hQ>RX8*%vI1
zn74@UHv(=YfY?f0D-V_Dcx9{{ptX|Ui35mQy~)=IXDFCOoXdGKvbHHkl5B9y;JGCF
zLEtgTh?ZFB0>`ePb-UD$9eeE1qluFPM@Q9o1^A3W@tXsH3t*;}c4XzdfN4yQEz`3u
zJ|N{2+}%MhqB&AqV9rV+ks^<!J-hGobmoI#-G}IxWMp77ZO!HU)N_`>S?mBoLRs@f
z2U}F@PM1r3>go~)Lk>Mumt8g}F9BKGu)Ey*3<xDJ^WPe$lZ;C7Au&T^XJKij(fUVP
zf}%+_d&A)%_ebNDFHGghXgEBnd%M5(d$owAoy5$9$5OATpdeKDI|f}#&5YfS=0<pb
z+`3FEWJAfoWloA6&D(qRG0Tb-JoMMgi1>61QwseTzQKZl5@TitLB{grlbOSr_~c;n
zGy>R!uA0cT;G&%rJ2Blxy~#j*xBalC+<R(`$2(+@u(A>fCdM<;M)KUeys(PwYRnsh
zwk{i98iZZ@_G0pMtB}nK!phNVp2KK@$6r0aaB5FZk8IC_b%P1TOuOQD&dnwfy~!RD
z(VH;zH0}Hes1@?8NA4@%_l%Zs-Jw1pey5Q@U)-{3K={Y2NK|2mNOOm>C3tIMF^nL-
z#Cr<&FC4irw|`c;6qV<xflCq+b84;I_@`c(FWr(3L5ALTb8|m6f7B{|T`6g2Gjk@B
zF9@7!`lH&InZ07C2>3|cye&yJnL{9U0n$GQG@}4ap8lmYYt-*Zj>T-|wX&+wcl>7m
z?&{u5MqNXL!K(0mV~u3F@gqU;shfTp$?)hCe4Nir!!<0Sl~W@l&)5H#CPx3;9_gdr
zROY+8_^tYpBe7MT@b*n#`E7U@*~;amh|M3ZP^e3Nc*8BfmRElf!-C5x>p7&yvaaHq
zFWcXq(G+RrXGP^sRR9b``115H?WI-UKVCqH9;7T4)wo4O9I(8?(zZJOa}k0hE5B}X
z<U=s;Z2SQ`)MzOT^By=*%rX9vk;7wLK#r)-80wH}N5c4yL~25N1Pr>a^{&?8$i&oC
zq#-)Y6K=Zp%f<Ksd(MY-A5=;(Us<0@e53Siybo6g|J4~4S-r%O7eJCm=7J{_Qbgs>
zQrZz4n?5KJ^RRO>FArpG!ji$%T}I}@(V&0;MKnzq2sFHTv%ZWU>671Q1(v$OLG{^v
z5_*)lF|M=?rlRW8!>dN&AHyrn2gr~hRf7qMzQ`a7|3b|!K2wg(K$I&J)sv4dV`J;0
z(H>yGScWimFZwk&*xD{HzKKl(Wk>24Z^@%o!?Sd<kXZ@-#1j1_n@anGZPQRg?An#1
zBsqFv_Z;Fn7ZbHdtE%*WgQ5X+-N*(1f;rp5{{hINe&<xWsXZkZkbuu0bG}$xOH1(0
zo4PtW>sGG()YHQonvG?&uwcc0Ch8YN%kAse-@-V>N)0@d!|tc$lM@k4p!{FHD?ZZ;
z21ksHmq03kEoM5V?j0sQ4TmeYktarqrLH}(*m8}~H!ofp{6x&i%E|+K@v=!o*1@b5
zCE={}{J(#eglrVgAyLXtRP^0lZgLwy&x@da$Ij*Z0eW`blfo_Dx>bHRfv+xvZspK7
zCJspp0~^BUuCfKNws+PCQ0nW-&z<|r)E!jFh=_WKtOwPNjz$8GRb@|TW<yay=v6h0
z>_i8yDYH@v!_iRSk|g>b;R;~ofCaVzx!1=-Q?T%9Vzk^N-p|l_*6;IRP6U&Fo?FV1
zDverOr=7ns&Z`Ej_qnI1ZLXP_S)mKDkE;dy+dMrP;17{7hZ*e`FMoT<OE64@;TcrP
z2~&UDpZOhtH7jL`KlAqJ`H?fY1OrjnX-D0-kpSQ?LY0-`{w<=Z<DRx8w^JHUkmAkV
zPKDmfDn%c6(1-#Ks1q@Ko*u$nb6o&?<Wi$3K;sw?0rc-Tz*MZXygZEca=w`Tw{}Im
zSCD8UAwY>v>^#nP3279i1g;e`NGAy!6nb;|sT#!KjKMIZ?ttY{0KGM>Y=o}lIr2LE
z3j@lwlYNFU6xGJML-$UUpGewowG@^r_H=gg2yfR}OO#*J7#BmG-eTf_DxKv~jmMtz
zYoVb!FpnZ8ZL|=Kn+P;?+cwN-VYg)FSe^iQQ{noK+xPDu&i-@+Ysgx%^n4zqrHMHY
zn4se|GfRYd-I2)UP*DPf-TD@zUqRc}gE7<u48PEt4q)U`shW}aCRQ%EF#h3#2e2zB
z$Lgb-zGa>F<YNes7hq;lVWGF8ck!?0*39ChP1nP6N#+ChTod3TNTu%oZoVf^OO<dF
zFgTvZ@Xss4NNf8jOUa8Dm?7KP+Omn;b&U1qr*0?n>OI-b&0RvJw)GWrNMTP_dhP=f
zCMrT8P6JeOc5*7aF0d~}=$=kaCJ||}?bisKRfCw?N~^}m6f#y}_j^hhg{<D~cpsb3
z#?9SillG#lM`1hr??u4wSr5TWt?BEVbU#(uS`esa%;H=@lWTSn_En|nugSlc%9FKi
znILsih>eAU8eV2L6rPu$Lq<i0VGY4az*JUz<Km+m@>G_Dv#eUh-DJIvh%|4!5R2b>
z(?U9d8$d?X^YNqg$k*fOj`3Bu7EhB+IdW%12#+eeQ|lG1Fq%$zZ`h|XG^k50W;W6D
zrtryI6J<rqeO1TrZ%NkP74;YEIK>0hCs_}L!=0%3K`F4av01(I#5|p~#;m{Jo%{)u
zC&}Mg=3$jc$EKE0$8G#%XiTuLBNYMsh1bqF0Y#@>(@$r*+-K;v@IYxpc}ibBO@U~m
ztV2Uoe~K}=G=z2p8&d$~iWlsupb9)<h!yxr`Y@UrWsP(As>)-N6ZS#s8k4xEgVpa6
znTWveRP~WE&;PynDmx}GDwHZBP8FjAbU1xF2V25oXys*?zuM6^pA>P|id^0cUy;-H
z_A9za`(N@e7KJ>S*y)Y8)Wy;9Rn#u97jg_v{#Q;q9<xm-yJ0390&52L=AJM#+?4qM
zm9Cf9-x-Q)QslAM>~ONYMcwoa(bfi!T0XfLUkwd9+pRJE6Hu+Yi=ka+UlW~A>7J1g
zo9gJ$$&8?-%#w<0<AZ}$VZJ9T`}h3vKZ;>l6vKz?KfPXus+@q&9INjt!#x?HDaLW_
z%9WxvG#T(hDhj_ws3InVHGr@{;{`dy_V_{0x6D%<3MyneY5n*v?;DsqVzCrIH#h2N
zP3+HcOwQX|&;!r7vFZd>ka;f~`xe9E1HD57=$J+E!cS6JmM`Dw)Q=(>>&-sH|KTMy
z;or?B;h#VHBQd3tj0U8Mt5bPc2fG+p3~ku51$*Q;30;qPcp-s_=^w{Cdd*_wYqQ5l
z0SBmK1o(L#k;(gplEh#&gyq|KZ|Ov8=DX(&j6nJ(9`yy7Z)xbKPoMm5fV86g`qhgU
z%LIwEL_r0zR0+%yVRe&74d6k>Tw;dP4XT99PT4`)5p;k@pFDbm<@7i^2_$<$wTGre
zIvj)Z-u89}Xs(OmeN|<d3h`Q=uICaJt$qLgSlt%lkljB>l)#y;qy5lW69v%YPdCAE
z=^q#XXzSc@`w}AEX5xbaRZ{~4|L7ud_wh$aYmK!D!1chu<Ch9;yngd$N*ZqSDQF4Z
z!-2IeT}n)1CPImYqjm9XY7pjA3)xyJkT<H>bYU-&_-t$&3s77^@n`qup(e1V2fd3X
zdd3ylQL_tHiOIk3;b#z2z$nlJP&*JBiME39EJgP0|Etuw)O*<`0Hu{9?I8nM7Xton
zTC_8JZ$J;A?tig4PBq73kejFWV&I9GeQU|G1k#qbhUVt*3NstIrp`(k7?SCQcc~eN
z9AN}oGfnB3ew1=VH~E4h4U1;Daw5|=O%93n5t2AsA12yub3+D0rjx>vY-Q&dz;(x;
zUziVDV>ml+<>zloHx0IHp%CM=QTR$!N`xZ#W@y|^Ye0LA**#L4?`%0m#lgP5D-goj
zRbj{pMsYYc6kw?%-0fro*YY%-HbWz8pav8I2LR>dG9_vzo0bj&4s+X~GP7tTn<r~`
z>h50Zl410c6}1vJXV~6+HuvY)=GFwS&lVQS$nir*#d=gf-Y~v-rT5*$d*f)R5!yJ)
zc>FkjkKa6mQ(w@I{0juF{SNE}HV$vG`I4VMb+zEhgTm_rR+w369L;gCB=`sR-6Cey
zcVUHCLgk5xc&im!Ih|@2d)!N%lF|{)E}#dR4gmGAYgR@!@>WVA0M^~$J*oR<@Y@s&
z%d!yLXs>?#-O=yU0Fy3!q8Yu<&N{ul|C)l?-Mt!oV=OyJacau6XC}P)gKW2scMQut
ziN0~o;OKC?d)^nr7`<2^Bnf{Jyn;&5=YFKBx<f;7l6XJoixa8!;o0EfY_HYsS3sf)
zd)D(_e+H+Bs4H*#UF}lMvD-wo`<UkA;d~;u-;Y?OAzizE&;Z_GzrR>_^f-}Z#>ddI
zT78x}wI$jNC@pdR7_JwWo$s9Aa4z=2k#iFrZWt6gel9l4y7k})4(8O?E9n#kx30+n
z_F@5^a=OY`@z~GFF~CKKZ~EV*-0zi(yjk#{ld(%n)NFU2jxJ`37*AvomFe9%_5A-a
z(Ax{F`k~YZ<5G>d<k*?`@o%mng4qm)&<_IQfBxowCS)SWPhE^Y-_Og^Cs5bv-<$C(
z+`V5Tt!o^Cf6#F5X@`RUfaM-O2{-TD*%(FE0DV9}`PMK4CURQKe-`*ZCtA#boWB$J
zV3Nu<GS*bM4_p~^_ZE&L#jTvHs;OXjW60dvnF(Y}55^f36Myo`KrE`VY|MT9SgXQO
zV>*}DoygIF%@42n)3-#15Ajj%@H~HK>ZhOCii`Ql`>N=CUeQiXxVUg7mcXSdW*)LB
z<yQ4o<&?cWd&%@zrYT{@tjkNRU>OGoAW#oXC?KpwH7&q}-eXt^QZWNE8b(J8q~dFU
zb?pIN4(I}C{*|o#K@jWJ+1c516>M|?RA0Z_LmGUbQrQ|#!P)Dmf<<*ffg!w`iOoSG
zaGC!HJxD#o!ze!U)%0PdDu4?Nn7GzNxVS?WI3Q|{FCc|rq5{AW;~{g4lCRPsi!+Ee
zb4chzdUIk3Y7c5+Y{7d#z^)|Oh}s<s;?u9^`ZwR?ZfZ;(5(u{+VAmJAJyGU8V|H6$
z(F|1XUwoW36M?S~%#a8Gk>(f{FL^xh1|TrpihRP@g!7L*gqXhVjKi<q5$Os-dseuE
z>*-lN@<JfSLTEj}n#su)z`fyLbXf%Sxj$OZ6=w$Id1b@qBg#Tm@hi%j0#>slcCGxg
zgxHWbyTY6s7n^Mwpbj?oA8gLH0%ddEJnrk22Bk*GB1Bbi0D3)%rzU&HBK)QY#qC#r
z4+=-w=3e<t=<z^{%+srKZ9g`mfEtUyA4@@Xg8rvclDqaYRwA(GU@JglVxeqpsvf_@
z6PWWHZAYyT@OK<*fl*;%NX=c0(^j!k{7(sSaUFPt1)RY*bst&p+0DCsd-c231+<U{
zxBW9Ib$y8$W`EQQoz_C(8abqz6G@3HDB<;zX2%#A+7VrGDtABt8H<EWaM%FJL)THM
zkhfFjH(ygjhu~|v;$5_?&wSx`<7lKfdXU$i?-u6?ul+&82^PK4e^V83x$T|<snrIL
zUZDj8BG5Y6+SZ0X)c@3x+=|9VUH7f`c1TF*7#c6~Q!Vw{S$ET{IO%O7Q7|lGIuPTO
z;isyYnW$-#IJd`8sQcHzy<G#o3XsHO%#D7o&kk*>?P?mB$Y727`1qia!CbUA_gkRr
zw@rC2!P}bR4jf~J#}!NfQKkuND?I)?z>1uaOsXlh!kZOKaVClfL1)F=+6wn1Y63Ox
zsSN^e=LnSjmid4bm&N7W6ltbDwyI2=VaLiTNYnE@tZn{dfN3^9)P4Xib9pGz(Nw+w
zID@A0?om!*;Tjme-y_AjhOy^8C_&@Msc`*rXsDWwjvEZ5`i>-juwHC%1I{-1ZZK5f
zLn`;=(~*~Gv-;ri9+CSgq#_`2wV>=PKt>^75?Da0%)_gx%oksAQ&#j|MIxRF&WZ5u
zwHfV}zjJH#gC$^?|9SH6CM7|h8vqIzN}Bw94>WW_QomT3Dh((8$>Y3(-o_>Ds_wDa
znTgz>nLw>|_RXvncpCZWntA|1&}+MVdHf0LT&jBE9-mPFTh2LVb}?wjplj-W|Bw<E
zR*SuUtyizrc?~R)NxfZNSJe?Otf@BIa=sMQQ1iy=!t5VM>Sr1AD~%n{7(gLo-`g1F
zK#*cQhbS}Yf)&a=_swh3`@vNmMu3-=tosg)^c&7;Bx6S4-a`^Uh|viA@X#y~ZY`Lq
zxqT}WO`ku7Aps8lHxYyo#r@>kBa;7ta$fK<+rkz+&2CuHImPwYmj#;v%g?v*^HX><
zWk+M|g*X}P_D`q6)4l-#QBasLT9}~yK}W#vG3vM57;`m34fRr)X)S37-XZHru&StJ
zfJSO9c?MZ<aQV<4kdUUyAf5ALT3Q93_ouRm+F5JZL{DjBcd+}{^T6l6N{1V!(5h?o
zJbK#N)b#XHMfF~F{suh*vdoWM(X6_T5A&1Na*}!3vfE=6BDWM{6#2j7b>=B=&xAM#
zoPJ<YNFvaP!7?EQluv{+%=8`{Z=m$m)2gvOhTY|}z-Z9N5Ng8A>7`#@w)0@(^<yAT
zWai*-o8E|?_-u@ZDdb4~@_Jw&mxTxdqyZhPg$r8{MA6>v5)<=rds$Ml!@1fZMmE1`
zVDwY8R9_)8<{Ux0`%939TSrSpR!caie=tBs4e*uf7PL?>4TRG9T^w?xsF2XXZOM1<
zE@j+y()m}bjP}_%sm8>~$r!42LA#E_PEwdgS{NI139n;#YB#e^X<t-~ZEzuaLw&=;
zy$w0T7)Zvl9mb9y&@<o_1cefKl$`7@{RVrRh@~vJ;BX0-%%r4lcnZ0K*bY6oUl!Nq
z&8tok&mG|c_M}S}dY_q67eF|+d-rZcxjT0ZuxJGMvdTqb4r|bc?t)m;jJg|Td2Aa*
z1>jr2%@WFEK!Xsd-HC|_VDHD;c(lLfBzm#bWZIE=$mcGAN^9z5dbg2FAx0LCm&xsh
zl@0s`Y4761n7PQX=$Uew|Acyg9gESeGuU|fd;LvhAuqSdtvqz60Y-^p&P+SPJ%_CL
z{#kdO>9j^NLN^^-j6p2y2%$W1c5Z$?w=W$4g63y<>RxNdj>GzQ?><1J;rtzHNbD&4
zV7*Vp28-;Ex0YOiMSvOV-`FmdJ$ufkpZEo@#!;+t`-))74EA8qTCt6(WhORTr`uWg
z7-i6nfRH67Cs#-CXEs7<g6h$y7|<g2c>rCrT2vpKHcI7@!*CjGXGbEn4h?~P;=GVs
zBdMXkG-{bvq=2E9<6$5X=*ftM9F4R6Id4rwfS2%#MDuF(5{zbnp~e=2R{0QQMZLs?
z1h8=dO;j56>(%22itXC<(hpv4##mG6wdN|~_cM?IL6QRPWW!1d7C+q<ybLx^9+vyu
z1<Yz#<gc8f*i-(!FsIO~FdX;<5LwelYw#X8!fSQ$CwjYRentJP$46o<f{WT&DDV%(
zk~o=`gWDEi!I~hfW>4YGr29ly)R<-E+8Se*;>gzmCb+WsS`T#99NL;v;o?~_C*9-W
zpM~dfK(0yT%HcDF4gwjl$<)S1-Vv)G^_)AmJSJ@sIsT(VPQj)Z<7hYa?evmOK`@{6
zxcmun#L}81RIB)V`G-E=jEK;}UWLX56vc=kDf%}lFD-D)A7f*|?oZRWt%wElab)Ru
z7RrCnZx4zFtBkdW*k*8M=5B_f26!csS^jt%e<up5zv}Ym&geD@BAefElZD+~T;k_5
zbFzS<dPWiyRZ;Eaxzq$O8Fml6*#}-Hd}zRL-7Er8-_I1Ao|&osiawa?(evrk8ASQk
z))ScRj!L%ubG92ttA;-j{HzK~sV-R-?`a=Du5b7t??9h)V`5?&EpIy!?KX4+5V0*8
zwy`)=11rxtTkf=>6+-0bt0t#Z<Ev`0O+-Wl76vPJ1&4=keapXsGRG$NPgtOwC$A>F
zvj1vB&KVdO`dO}K%_S%@7*P<L>t-aD+d7ei{!qkH6W-vMDZ%4kSw+R*(b0vzs?UMy
zVpWNDB;I}hz(9hbbW{y~QV5RJS9p`5F`0y8QP{O(z)>)uj*HL&mWZJN_z8>Gi4S1w
zXPB?*A9G<BOhWHwF+t2*8l4r4`FO=wU1fuKleGmR0B)A$9JjJc9X5CK3g8J$`Gqcr
zkaQoD)O2+v;WCKDy-v=~zHM=vDz)zM@baVc&;^_cJ*4T6z_EIoJoZKaOHwnSFj%<j
zE_@o5lwjR?X1N}N$?EC3v3Lp2JLvUBatB~-cpv{R1PYo(_ukBUx*e|sYE|il660SB
zz~7%7|5gspm5IRgccO}2gVFI%-GIMC)*;c#T;>f7d5qA{<ySob*Uymm(Yv^1KXpQz
zXCGWe^nxqFVgA*Iva&C^I&1SH;#-LE?$3X2(LyH17Yxh)ZUuGm#tg-r*TqZcPcY1%
z4IWbOtC`L4_T6h;Gv`eIY{6+J`qKvl>(%b$boyU-0HyaE;@`qWz4|?f?@6=81$n-P
z`U8KUPo}<Dols=}imaCH&WBMV1ZDKi4NR1O6(`p>tOYq)FLi9>8+<#n8o;mOT1bzq
zbk{;%G~MkQp9D%(r1_iMo1;#OO_lGlclqvjyGqi2VZEhP_D7{+xxWdjpJz?x%;LvR
zhSZuWzeVDE4F403jC%L<>+ffU^8CC>!82}>f8e}JPF#B#rhh19=51ZKEHL~|rQm7W
zQ1<SOdd|aJS8Z{YtV$W)!#K^v)FE7)e;xqYOI|IS&#&-%k?W0i$-B0`>+WY6<eB<t
zp;`IUE!H}v$&EF94J8uf4b?NrWVOo!*RGvZ0ZZYo(kzB#<|&%s({Zyyr4OV&5DHDG
z=8`cv!o9`U^_d0TZ>8o>zETSdp~9T?i^-JVjgsrvEAf05G08UZcnH$p|L`~eo4+=F
zG{7EvjCeiuxjf(h{?#gea>KTy?c~?`W(A$PPAlHORl7`Qbz)um_BFGS!L#do>E+ez
z^OZ(AlsdFZj#qm5DX=AW7gadg$mbe|o!YFrhMW~>v}4Da6|MREZ_d4t@lEE&(H-$`
z=z<vso-<2+Xa3G=dp*5*W3X3OwoUa`2-sg|(^_>D?nORvcUd>vLu2jy5|4$u7S1#O
z<g+tPU*R_0*evJ*m+Ju60B`FK(}Mk+0dMVF?y6xVVP!&kSzX%MUZJyST*qefdOGjt
z?dy}HxJnDp30$0vPLNoB^J_))o2<(Pv5QyU5Yns-*hEcO;`>amagtkDm{^z&h6^7z
zH`1hj<jKt+@y%~n|N9aTl}=ryx!=@x?|Gj3mTSwFbz-)yDBU(Lf=1B4%70Ge+zU10
zF$&vPsdmtB)NN{>&oMFIZK0TjoR~tL^%YY~n^;oK9)Wl4-`csNU9ZA9@wqhs6U=vu
zOlALi{nvA|C}mDof1UxlLeG`27lI})Jh`|wGj=Vf<)f1HOp;1u*R53+T9fq{WP9(}
zJT(t!Z)+1E3of^2U8>&g|F1iBe@h#2v*I(TS7=8Vsrtifx@8t+o@xMoZjBlUMWNvT
z?3-DlI7={zQqUH)7CGA*OWOaf^4Bd@V4;x0o*sO9O#0~KQ~CzPv${jt@3FV(xy+Ja
z5$zKyksI&Yg|DackOhv7+ZSM=ef7DyQq2~BtwSb#Etoe#8xcFrNjxGus<v6do@0id
zBD?u~Rn@OzaG>cRBH{Qo)LVb}%PDj#uWkhKW|Bg$^!bpUb43r-M$jt{NmaVNY;63p
ztEqGBdpCbWUc}Zirp4<{+NouoT89}b6@KLvm)N`BW~B}TF+UJ=ie@M#-g8jDZ?$;_
zmFJLe@`G&{LI#miN=rjhY#VL~=w44EK~nm_v2S6d;sBkKti8#;opwZP{{c%UUsaP+
zwwkhho$LJ8OES^FUfNVum8BZlb$!E&tIHFj_;$u|I=2Kk^+z&uO>(!hu(I#0wV9x;
zRAuE2Z%nR8eDU%~+v;?yCTAN?-TcWg*52dwy0f!1Y`Q`<;voPkeEW8YMpX)Mzk4@n
z*Xfb3vS-eOU0fI=<mFJIA}N_y@LV=F{?tT!MAh86j8b&hf-0q;M;`QTlGkFG1LwTG
zoc8uu<b(Sqr8-~oTs&5^oC;$9a;GYugpjySHIl}bAh?oJw^iKirE26}q;%HHhrBj9
zDp%ZIsXK3Yz%KQkqE*tYa9RjYfYmIYYIkbFC5|ucG}`8?4})1Kh1~SEuwGH~bhEcc
zUA-Rptv+0TXPsoqk+w<97FUcNi>8l%5iIxD%=}DY<JgL;<<rzQGzs!w#Jte^5MRui
z<!;C9240~-w(D-+;W{!*HRa47DBuVjA1&Wx{AyKGl19)?2?<>{`*7ELL)4YMKC4J#
z5}&*4d+%kj9{M&h!RYg@#45<wSzWTKFwy;cl{ZKxb@laC1qEtrmE9*--qFIUs?Sx$
z-3@0vc=D5;NE$X|*T&MH4tyJX9j}-aGPX&bTOCvR@oLqA)g!$2n@tpp!mpo<=YRiz
zSw?JiyJfK4WN`HEmbMxlZL{3T?}wP!U29rz+J(|WF78)PeW~-Hb#B5ok+f~*z1&&J
zq`0)%H1D^mdLq`hf*!Rmo&ESx_2u^R2+?ET^<-?ew-hrP8}(TA*VS6jQJ$2#4}*Tm
z9)`{+Rkktf;Zt47$C#=6uO9RS2Uhp<)!jQx3%v#6f>%-=$(p?tR$;_L+JT3(hCNv}
zR>pdNY~fX}C{NkL)y}!B7d$6pRaa25?f6zpT#Gp%>eH;mJ|Z+ELogeQ_uG`7V@{ax
zRV|m?^}Vk+pNk%L52#XR7L|HHMr)!=BmeTvlPABhF5J9%TsKG2KQPm|>hbBE!sa#i
z8qNIGofVB8Z)}a;6U;?Fe3L)$(Ab@7lcidx7mw%D$Gk>_lr_%C>PovlS;evYPLH1|
zTJA5ksbM398}Ho7dU0}bPiQC)Y~b?88a8HZA1|l7%2{v=W4TFvaigQ*&64wxk+b`s
zfr&ZU7nGlPm*n()Ktxp3*k-&^eBC;Z<r;@*ccesz%LN3acDXnh2d~rxh*+OV^%-U-
zEwutNo$}P-i|e7?D;V!4tNX@|PYyGBm-&Qpad~VGoCsEO=Sr2y?K{t8u$b=Pb+*Ys
z_MH03WFOO$->>qL_5ks7c1ntBy`!<bp*w0<G4&8_c2LK&h!4SV7I=_b(q;eHZ)N^^
z$(T~5GWND>D=0z^`fa7remaT@t~t5mC!D_z>5UusHoExvE-8x|%O!Q83QPoHX3d^~
z$=ZXvq|FS^HcNW1`*`iSKLf)G0XdmHN0!zuSiL$L-B<ol-J**A{-?3aHWh`Cb%{fG
ztoGnK?MSnv4ik?h)w_-c9OOOLf9}J4Z?f$B`6hGr-zzrXGp|EQ+{q?!VcXT_G+17a
zP^1Eux@?Iy;pHZqu3bsxSxAl@+D1m_{N0bgk-4C|R*wss385kNT<WuDlhp~lH8rLN
zH;z5zG|Td-Gf5J?r<?Z?h{dTdCPwe<*gW12w@0KdS<`O($i2W%C1ZW&2-~B?u8^dp
zZ&>>ot8wU1F!g!8$Cz{dN=lKx)86k|iWLg9+2{$(115QW<|SUb)IB~brM#w2Q1FbO
z#mGR_plnuunJ9%i%lm1`X?Bls7uzcD^Ems#dd|%kt$7YTc*x{!ubcP%absONe{P7W
zz=@JG)Vfwmki<~Q0gj2Vbg9>`0~wjzZ;gA3I#}Gwy=ol2u1q7I*JZPbQBnBSlV$QH
ztdZ-zs60lEA~#w$$u3fMS4_9k>*XAdJ;XxU&i|k^Wu*0m$M~`6T(8$l+gMrf45b&1
z(-uhkU#trQI831$TP!mVfJ%1Wowe5^7G178dMk^`AS=iI^t(KlfPu=1F+HDWx@_0e
z4GXVVzVK7k-Xz@3mT=xr)pEtUfVRbq>KO-pn8cW*K3LYK(7WdpI?H&}w|<h&U{5vL
za7(K52sME(>X6rP<Z`$uT)CE67LrnAVk1BHh?{)OdSiyUjr?xM@14ttqjfB@vQev3
z$~pgA)Dwdp6JO47geL7Zv%Dix*QFREJModpV?^!rfo%ox=6h^Pzur00qnRyS`}FiD
zN&ZGYiNGL_i7N-3S=Ua+2Kd4InJ%|h7QwHws_mt*)bNL3vop<ZJsGRj)F{<nL#IDE
z_-q;O5p-`J9M11ukt)Aman$R0`EEgZ$r0dla_(|-q%Z9GzE{)H@o==Hu0fTYTpw+%
zVB7OUj}vd*DyDbmx3f9KR7$)kO!JewpO&^viE&ZKw$u}yl`DD3$A%8R@mig9Z90M$
z-Y3Pqs^<*Wc52!v@YzS><x3^AUb!$_z3z#@lqFn>3xer}v4S#>A)pCZH`0~lvGz)Z
zR7t+|@$w*dp`w>bId<32ty(GMt7^8%+gAV7PHAVuvvrbCZl^tRy%NUaCpSCT!GD#i
z_-Pwo^VoLXP4*{j5*NqBq~$g~Gm|O3&wPEyhS(S7XU!yZU+$ImsFeGW-5w247a)ah
z)3~Y$Xju|P1#9HN9vxzni(#6SscAj*XhV(iagn`lsrimCLY$LuT!zncZB*%RNLApt
zw<zNE0A8B?2}K!p<|${9>iuT(aFe)0)7(d29<%f)=Sfp($Y<Vjwf=P>ztkbs{ZzSt
z)Z{~yOZ^{#jc(UyDSYN9A@F^^;)(Mk(ks^N`Xn`Jc&lW7g|`>{*t!Hu7xK3y7G4bN
zXP@j}L;qg8&cGu!WA()4RPFh*^Y;hNvAmvUHWkGr_Xzc8zStZ#$tas@aXXJo=MKrp
z=}Kshwm`_2cYX2WS$$EPONr?4+0#xYjIT#9S!i@*fHmf%Zlkfiy)palk<w?+bSLko
zI+XLoOx<C1Pobga@zFVH>}}DqrD2|R0tO15uc$mJSHfKas;^KJMEnDbT=UM?c!vyJ
ztsqNp;{JJW6P}3G#GRJwIqEz#aP)Eir#hEAI+0LJ|Gc+X7sweF?FIyuKCG@l@1^&g
zwsn4orA*oyNh>HJJeGFpYUBt}x^rvEZQfPH9WJDW6zxyYBy!Dm(JSvRJv2TeZ)MR!
zt40yi(~wjAI?Afkty|&AzN4oveU%G7Vl~9$W@%BMNpd1fKh<xmEm9c0AcB%2PRkpt
zm#-_fwR7j6efwb{e`ozE_#(!UjLKFnwG2(W$A3Ki#r!*2M}y^3h8gwlBw5-jWtT3l
z;NAYfS?83(tMc4D394}ed3hTv{aAFxy32tb1xy-Ud2MwW{Dsnvqy5pbluC~U!Vr6l
zpYtAY9IP?rEny6Bdo%J-vS*b*yj>lQrS>52BiXL|v?CD*iVMrnvRz3`Av5zQOw0|?
zBog?wi%8%LS5U;A_!8C~LV4ET&!!Vl7d`khtS{jv>pZ^N`ca=h^z4F#Os2h-It@3D
z7mUX%t{EPxuYd<ae^a+<Y<fk7x|rgPokO+x?s0QtLXTJR@T-C<SGO`w_WZkWbA40i
z;Rd}WYy<C}UsQhfEGTOtb#M#k6JEY}oXoAp7z2JzD`vmqUXk#4pCbZDkYwGq?G`ec
zb(!JeRT~8*>8|HVJ376F=%dm6KElzGc|EVAS~fa5i+<SY+#DL7ZU5!Nr}C)!Ep=Z$
zzmM9O-kY~_Q+ulBpe>Lq0LB{X4jcJSo$dc}D&8ZL<y*st$TOcERnw*MG8&ZSkCwTj
zwzr>Ep}xBQ`*PWr<jb6lfA?$-I~B@H-q@-BKK`?u2I9-n6NA~%;RNgIHnh>Rg<L|k
zT=&^!tXrz_H;sWlK%ui9aBhE9T&cL08Y+X{0F^^hqWEA|{ub|TUZ8v;j;uPfZ|`3r
zXO;^KNY{<6chLVR&5?Gyva+?K<3{OOxlOYEJW-h>s<6t!lq=#G(Y03y^qs!t5G&KP
zvBBl2-Cxeb>~H7!R{V(Yd#MTJn}^Ii-eT$yarMFD7ZS=j8?uXRP(pl^>GGt72$3Ym
ztwl$@I@nycIb`VN>)v_X)h$@aMr2SnQgxk-WxAR!hp(lN!>MOP8g>p#Fr)JH{K&sY
z!wU`WT%j(LJ5y_hHy=S!c64P>Wk|%Bv5mgR=t~#gRnOz1ZI>4B)|b{xt8)A9xL@YN
zTCoSplQ&w8Ub@#Mh4n>m6>@IglJX88Bkqx=t)1(^)>5nv(&q8Kvj-J6#Ikkhfbc%_
z-;)TpZ{8BWc+E8r`q=EkN$*g<LGLIE$;gs}T({Y<KK4SzIp)F;dd8cB{g{mut5PI4
zIrCLy_>@=nr`|F9`Fs}Vd>9$2jf!NyHrZAGS@{%d&0(XHo$`AP84EL>hYS1d|6Dk-
zauw;w<l>g|j8d1EsQSkkXu~kHnva|iu-@RqioWHGx#|8XKC>ztFXfz3r9R7kM3U$~
zSRPH^t+F=0-)d`(0n)K4k&ZJyvLzJws#>zItCC_glOdW8yT`U%x5jH60&d+MbmW~k
zYeKGeE7`tXd*|9`RAZ~O*Art+%9HaF>TcdeZ4~H73z^HMQjAXK^&@!KLa~ykNS-V~
z<JeK5Sh>^SxXqRE`X;_=6XuKx^_!UA9sW+e&FZi2rARq*BhjXuCt&JPwX+=!*LAhY
zE#dB5VnQT<c!#`{y&80DgJ-Ij+_KjvvvL?293RltIRCdq{CH&f6j0Kh|F&2L4e?&|
z!`Iez@Ku-`x|X}+%$INK%X5rxuHI5Bz(cMuJ$J>E#&SH4RI{2=a7pykyZgD1Mh+ft
zzFn&u(cCd|I5=PY)%Cpxp6zErlveK4y3S2r*1_j?Ma=qEdGzE!le+Ca?ART{2{;^i
zr)tioSyZ0q@-~Uz$S4N=SQUHgYwN+s6|#HRSyexUPe8*TApf&T*L=E}&ju&8$=N)u
z6EMYo%KZMOt$-v-?PnV^cW`r)1%87l3Q>ZAP%{hdnN*E5pk<$ZIDa!2l_xxG3a=o*
ziW6WxJ)ScKX(WoRo;dq>iSF#$#Y8iGZDRN_zE$Z5ZWRAeC(!l^q{O!>O>JlG`Aapj
zGP<;syj|zJ0b<G8bsTIvTXXU!2e%mnj)SRofSS}a@g;^yqWT`nKPY%xqi<UFt2tfu
z@Ol3S1R!tY>mxw@yly{Z<Rn{!xA(kbxg!@vwv%~s*wXf=HI$aJ_^JX+;?mZ-S`Z~=
zncQO=;-}!NIwzDIyl~#~>$H%`ff$Z}(IEP&k=pz(cT>nYcBV~htX{c{^_X<Vb=T5q
zEmgY^G0nQ(T0IfdIc)v)Te;}&i2?7i;e4}xwY;RWZ{8fI?LqLyqs-39*{;2+rZH}d
zuWF>C$xg9d9|vmR$+%$pl+xaqmw%JgSIjQ)LC?u(E0qV(7;_5mi{{tSB5xhUO7}zB
zc21u1V(y&z3N~F$@rci8v$QhDi#n37Tsdx#yK<A;LS12J;q{7m$SbX?bJ)HPa}10%
z@m~q^@pX219Vu7Yg0lrhe+P|LO$n-f$uGs<xFtVU`~1kr_ixb$USAh@qLIoDIycs}
z2^DlNPgz5X=%DZF$7j4SF7<ACpR!C0^HSq1$MNX~xuL2G8@TnHzkW>O%n9FeNcVDf
zIOnd_0gd}w;=X_Px9`>so=j~l@7)z4a!*CQ3d0RfZJnrSXEPFUbt$|zN{$Dlr#*kE
z%(s(=95DX9$DTF;;7>+y=hrjTE1u(7_aEL;EZW-FT-wmE-#-KO%YbfTvcj^J3yAJA
z#;V#q!!q^n!kx4hJ=r3Fa4%BxME1D`s^zfV&&Zf);qXvXw&@?}v^;g{HGM4K%I<`X
zud2U5oVlClXU{4<LuR<(RPwR=Fw+4oG(A4OTWoZb&Ex!24d#jt!Uk=$hi84dHM%8)
zbidc6y7x`=GA$LPa<Qgi-(Z8(XzQ8&9Qde6j;w$CwRZtDJ$I~bOEuSBU7PuN!;1y{
z2OgKCUu9NLB2lZom}h&0t(kv)`{(T@N%VuGBP~sE%^B)wmb5XrJMwvWu-2z?{MD-l
zgAWr#1Jx8akyzAJ=N)7X!o{~w^uofVS$zqqTB4U4a%vBL!&EmBImJw4HXeFEo37&q
zZS6MV%6tUkUb^Mno=x`1P=tOFf`_G}Thfj;J!!1dDSHu2M{QD7oBGz}Zr%XVq1mk4
zJ#u!uGSz+1FU@dv+Zl<m&mEcHA4+mgy>!R@IId0~g>7QT16ESLglaU1U)!MgqSvyX
z-cJ9lJve6h(&J?{&9s{_LS~WVXlwAaKO9J=MV(~7@vM@Ew-)EOX{lV@o-)7izBtg4
zyu1dNUaI$vPp^BHw@f^7D=K#B(a7jk8Lu-JOiU!-a1^#~e$L)k^!fAb(wyaYbruug
zOTU4^6UPig92WzB9-Uz&tGclPje42WAn)WH@L^hEz*ve7gP!m)R_-{B*?a1NRqK|P
zjL29#N2#fB4uf|`aiq#ookL+y-hHRBxGkKRUwf?;fav|9%O}*rVzf_azL=k6-k(gu
zR!wg=a8n%V>gnf9q$~XI2<#7LWntMtJ~O{HpBg#0r;n=xaL^XnQ(Tlw#FMx~i!Bn3
z%h0QtWY4JJ5Ut2zyDmPs+O$N<LvoMy;?~yjZZrMo7nWuu&1&Nf-t_?QebMzwdq344
zx9>@ocV5s!KFmL8oHanNhf6?gN_>3#K;Swn$$`UJ7cMkKJaW%y+}9JAKWTsI-KBiG
zo7L&wkBzi7rEjv{L|a?REzx>$`NZNMpTFMDMqXwD2sAAUBeVG?b1OXWtln?v%gM{b
zbKK&~@)8d}v4wS=lioOr(4G80oA_?BQRbv;wrX4BbKhM(5bVzzzY$olUV7YLzn=B}
z;&(hpfn&7Crsze@$y$CnzFK(wJ}cik&$Yq^z<b|-O%BtWSC1U|bLRH#;F=P{)W2tS
z{W{m3y!dh9*6itJ5rtj*TK~0Vdl%iPYE$XnFY{FCvX|eDW!=HRLkl0-K0i0t+t=5&
zDNKM@V^*NavW!c>{iesB={5e@K4bHOwRLOr&&*K&_AVB9y_z_%zFN65`tP58%J<Dw
z?f-YX%fA&BGgH#dogJ}h!-osc=jRJFulur={cZT{YSRr_S5E_%2kk7$jE}t8xnl?G
zsoOqY@gMAfqez*VMI~Q+daVP>fV&r$OC)=R|5UlaxP1RNH8K4<MHLl?eW^R#)D=Lt
z%c<NIi2Z4QJ1f=~*n`tw|4uvn-<>I6&4K%Ymzm$2@%-7dJ;}#sKYgnH`IBAs`@J*n
z|4FO+ExP<g^b7wT+f>?hOFcG$i?g*)T5@+;s7}+<)D+AI-r%;o2jO4fyd%QDz~$k8
ze#kHLt99#n-Pgy@D{&#bCPt+B-Tq_eX15=eG29Q#_ja{=fLkQ`WNv0WT77nxlz@By
zN-OTv{wMpZ%|q85JbLsca7f_apXU>SD-oytKd@X_Y`MiziQruq>VwM<yj;Jr6FBzf
z=-6*<X{)36@u)guub;!5yY|0t_8+a<vu9WN`*&(~q7r{o^A4|5v-?-N@n2I@^R2l)
zz!hOhw>BjH{J!7bVN1gg1LbR)x0V107r*F2YE3a4mB`yqHN<Cz6&-pdp~&!I=H;N}
zz~bMrS<d*^(oVDaQGX<b7A#I!l+4KBEjuZy-ttsLf+}z}HKAeqikBZA_DY-S=<C@9
zMO3`ldOgj;%C6+=tLHUsETE<aBZG5L_#T;59nf(XJRf57fxW2cEg4n7QVm!-E?jun
zZ~nbw=^hPzO~C0&1C`Q?rvr~M0p~9dFq}V9%KSoO#)}As2F1>e48Tdx2F7`>*?=nh
zTKiZToQ0AZlYtE*hJ=RnN4pqHM0`qg7!FK062Sn`UCQj>?s%Mufyc9l6=FAV#sjFi
z6R1~Wk_0#CWFd(MJM$P`Xdqd!U^D-R`2BnRc=CPT8g_1bif-@%(*wp^zhk)UKu7h{
zP~a??NARcW+u!#8w6_lbTX*}@eWR^!w|s5(eYET0WPdy0&4XURd+Sf1R{rkbe$WNU
zZU3JEr>@-p)mxW!95&!#Vf^s_yoPS4NS>5HQeIL@iip^ar4OeC8GLTJni;+;Xj|^-
zJ+%?KE7fkR%$ajs;vKJRV-ll*=Qf7(nhovOZdJ~c+*W&k|C(tblXHdq&K3K8Z(HQB
zkzs~Pbi;Fz1BWG)Cx>O*_ATBJ7390k)50?T`qO&>A{t^0lT)}q%weiHG2^V|=B&Nn
zk7aq9-c)<|q~`wiYUjWO5ez<)bPs@UFln%V3c3q};Xt+xcu96e?{o0h;`Kin?^Ze%
U?-OTH1kFKuy85}Sb4q9e0K#M_IRF3v

literal 0
HcmV?d00001

diff --git a/reference/htmlsingle/images/rest-docs.png b/reference/htmlsingle/images/rest-docs.png
new file mode 100644
index 0000000000000000000000000000000000000000..2ab7d3d3f104ee2611b2e4f1fc53eb57e00a2dcb
GIT binary patch
literal 55044
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
QYBNejLE}QsdDDCU0U=C-!vFvP

literal 0
HcmV?d00001

diff --git a/reference/htmlsingle/index.html b/reference/htmlsingle/index.html
new file mode 100644
index 0000000000..331fd21248
--- /dev/null
+++ b/reference/htmlsingle/index.html
@@ -0,0 +1,14911 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="generator" content="Asciidoctor 1.5.7.1">
+<meta name="author" content="Adam Dudczak, Mathias Düsterhöft, Marcin Grzejszczak, Dennis Kieselhorst, Jakub Kubryński, Karol Lassak, Olga Maciaszek-Sharma, Mariusz Smykuła, Dave Syer, Jay Bryant">
+<title>Spring Cloud Contract Reference Documentation</title>
+<link rel="stylesheet" href="css/spring.css">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css">
+
+<style>
+.hidden {
+	display: none;
+}
+
+.switch {
+	border-width: 1px 1px 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+	display: inline-block;
+}
+
+.switch--item {
+	padding: 10px;
+	background-color: #ffffff;
+	color: #7a2518;
+	display: inline-block;
+	cursor: pointer;
+}
+
+.switch--item:not(:first-child) {
+	border-width: 0 0 0 1px;
+	border-style: solid;
+	border-color: #7a2518;
+}
+
+.switch--item.selected {
+	background-color: #7a2519;
+	color: #ffffff;
+}
+</style>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/zepto/1.2.0/zepto.min.js"></script>
+<script type="text/javascript">
+function addBlockSwitches() {
+	$('.primary').each(function() {
+		primary = $(this);
+		createSwitchItem(primary, createBlockSwitch(primary)).item.addClass("selected");
+		primary.children('.title').remove();
+	});
+	$('.secondary').each(function(idx, node) {
+		secondary = $(node);
+		primary = findPrimary(secondary);
+		switchItem = createSwitchItem(secondary, primary.children('.switch'));
+		switchItem.content.addClass('hidden');
+		findPrimary(secondary).append(switchItem.content);
+		secondary.remove();
+	});
+}
+
+function createBlockSwitch(primary) {
+	blockSwitch = $('<div class="switch"></div>');
+	primary.prepend(blockSwitch);
+	return blockSwitch;
+}
+
+function findPrimary(secondary) {
+	candidate = secondary.prev();
+	while (!candidate.is('.primary')) {
+		candidate = candidate.prev();
+	}
+	return candidate;
+}
+
+function createSwitchItem(block, blockSwitch) {
+	blockName = block.children('.title').text();
+	content = block.children('.content').first().append(block.next('.colist'));
+	item = $('<div class="switch--item">' + blockName + '</div>');
+	item.on('click', '', content, function(e) {
+		$(this).addClass('selected');
+		$(this).siblings().removeClass('selected');
+		e.data.siblings('.content').addClass('hidden');
+		e.data.removeClass('hidden');
+	});
+	blockSwitch.append(item);
+	return {'item': item, 'content': content};
+}
+
+$(addBlockSwitches);
+</script>
+
+</head>
+<body id="spring-cloud-contract-reference-documentation" class="book toc2 toc-left">
+<div id="header">
+<h1>Spring Cloud Contract Reference Documentation</h1>
+<div class="details">
+<span id="author" class="author">Adam Dudczak, Mathias Düsterhöft, Marcin Grzejszczak, Dennis Kieselhorst, Jakub Kubryński, Karol Lassak, Olga Maciaszek-Sharma, Mariusz Smykuła, Dave Syer, Jay Bryant</span><br>
+</div>
+<div id="toc" class="toc2">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="#legal">Legal</a></li>
+<li><a href="#documentation">1. Spring Cloud Contract Documentation</a>
+<ul class="sectlevel2">
+<li><a href="#contract-documentation-about">1.1. About the Documentation</a></li>
+<li><a href="#documentation-getting-help">1.2. Getting Help</a></li>
+<li><a href="#contract-documentation-first-steps">1.3. First Steps</a></li>
+<li><a href="#working-with-spring-cloud-contract">1.4. Working with Spring Cloud Contract</a></li>
+<li><a href="#learning-about-spring-cloud-contract-features">1.5. Learning about Spring Cloud Contract Features</a></li>
+<li><a href="#advanced-topics">1.6. Advanced Topics</a></li>
+</ul>
+</li>
+<li><a href="#getting-started">2. Getting Started</a>
+<ul class="sectlevel2">
+<li><a href="#getting-started-introducing-spring-cloud-contract">2.1. Introducing Spring Cloud Contract</a>
+<ul class="sectlevel3">
+<li><a href="#getting-started-introducing-spring-cloud-contract-history">2.1.1. History</a>
+<ul class="sectlevel4">
+<li><a href="#getting-started-introducing-spring-cloud-contract-why">Why Do You Need It?</a></li>
+<li><a href="#getting-started-introducing-spring-cloud-contract-testing-issues">Testing Issues</a></li>
+</ul>
+</li>
+<li><a href="#getting-started-introducing-spring-cloud-contract-purposes">2.1.2. Purposes</a></li>
+<li><a href="#getting-started-what-is-a-contract">2.1.3. What Is a Contract?</a></li>
+</ul>
+</li>
+<li><a href="#getting-started-three-second-tour">2.2. A Three-second Tour</a>
+<ul class="sectlevel3">
+<li><a href="#getting-started-three-second-tour-producer">2.2.1. On the Producer Side</a></li>
+<li><a href="#getting-started-three-second-tour-consumer">2.2.2. On the Consumer Side</a></li>
+</ul>
+</li>
+<li><a href="#getting-started-first-application">2.3. Developing Your First Spring Cloud Contract-based Application</a>
+<ul class="sectlevel3">
+<li><a href="#getting-started-first-application-producer">2.3.1. On the Producer Side</a></li>
+<li><a href="#getting-started-first-application-consumer">2.3.2. On the Consumer Side</a></li>
+</ul>
+</li>
+<li><a href="#getting-started-cdc">2.4. Step-by-step Guide to Consumer Driven Contracts (CDC) with Contracts on the Producer Side</a>
+<ul class="sectlevel3">
+<li><a href="#getting-started-cdc-technical-note">2.4.1. Technical Note</a></li>
+<li><a href="#getting-started-cdc-consumer">2.4.2. The Consumer Side (Loan Issuance)</a>
+<ul class="sectlevel4">
+<li><a href="#getting-started-cdc-consumer-start">Start Doing TDD by Writing a Test for Your Feature</a></li>
+<li><a href="#getting-started-cdc-consumer-write">Write the Missing Implementation</a></li>
+<li><a href="#getting-started-cdc-consumer-clone">Clone the Fraud Detection service repository locally</a></li>
+<li><a href="#getting-started-cdc-consumer-define">Define the Contract Locally in the Repository of the Fraud Detection Service</a></li>
+<li><a href="#getting-started-cdc-consumer-add">Add the Spring Cloud Contract Verifier Plugin</a></li>
+<li><a href="#getting-started-cdc-consumer-run">Running the Integration Tests</a></li>
+<li><a href="#getting-started-cdc-consumer-file">Filing a Pull Request</a></li>
+</ul>
+</li>
+<li><a href="#getting-started-cdc-producer">2.4.3. The Producer Side (Fraud Detection server)</a>
+<ul class="sectlevel4">
+<li><a href="#getting-started-cdc-producer-pr">Taking over the Pull Request</a></li>
+<li><a href="#getting-started-cdc-producer-impl">Write the Missing Implementation</a></li>
+<li><a href="#getting-started-cdc-producer-deploy">Deploying Your Application</a></li>
+</ul>
+</li>
+<li><a href="#getting-started-cdc-consumer-final">2.4.4. Consumer Side (Loan Issuance), Final Step</a>
+<ul class="sectlevel4">
+<li><a href="#getting-started-cdc-consumer-final-merge">Merging a Branch to Master</a></li>
+<li><a href="#getting-started-cdc-consumer-final-online">Working Online</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#getting-started-whats-next">2.5. Next Steps</a></li>
+</ul>
+</li>
+<li><a href="#using">3. Using Spring Cloud Contract</a>
+<ul class="sectlevel2">
+<li><a href="#flows-provider-nexus">3.1. Provider Contract Testing with Stubs in Nexus or Artifactory</a></li>
+<li><a href="#flows-provider-git">3.2. Provider Contract Testing with Stubs in Git</a>
+<ul class="sectlevel3">
+<li><a href="#prerequisites">3.2.1. Prerequisites</a></li>
+<li><a href="#flows-provider-git-flow">3.2.2. The Flow</a></li>
+<li><a href="#flows-provider-git-consumer">3.2.3. Consumer setup</a></li>
+<li><a href="#flows-provider-git-producer">3.2.4. Setting up the Producer</a></li>
+</ul>
+</li>
+<li><a href="#flows-cdc-contracts-producer">3.3. Consumer Driven Contracts with Contracts on the Producer Side</a></li>
+<li><a href="#flows-cdc-contracts-external">3.4. Consumer Driven Contracts with Contracts in an External Repository</a>
+<ul class="sectlevel3">
+<li><a href="#prerequisites-2">3.4.1. Prerequisites</a></li>
+<li><a href="#flows-cdc-contracts-external-consumer">3.4.2. Consumer Flow</a></li>
+<li><a href="#flows-cdc-contracts-external-producer">3.4.3. Producer Flow</a></li>
+</ul>
+</li>
+<li><a href="#flows-cdc-contracts-stubs-git">3.5. Consumer Driven Contracts with Contracts on the Producer Side, Pushed to Git</a></li>
+<li><a href="#flows-provider-non-spring">3.6. Provider Contract Testing with Stubs in Artifactory for a non-Spring Application</a>
+<ul class="sectlevel3">
+<li><a href="#flows-provider-non-spring-flow">3.6.1. The Flow</a></li>
+<li><a href="#flows-provider-non-spring-consumer">3.6.2. Setting up the Consumer</a></li>
+<li><a href="#flows-provider-non-spring-producer">3.6.3. Setting up the Producer</a></li>
+</ul>
+</li>
+<li><a href="#flows-provider-non-jvm">3.7. Provider Contract Testing with Stubs in Artifactory in a non-JVM World</a>
+<ul class="sectlevel3">
+<li><a href="#flows-provider-non-jvm-producer">3.7.1. Producer Flow</a></li>
+<li><a href="#flows-provider-non-jvm-consumer">3.7.2. Consumer Flow</a></li>
+</ul>
+</li>
+<li><a href="#flows-provider-rest-docs">3.8. Provider Contract Testing with REST Docs and Stubs in Nexus or Artifactory</a>
+<ul class="sectlevel3">
+<li><a href="#flows-provider-rest-docs-producer">3.8.1. Producer Flow</a></li>
+<li><a href="#flows-provider-rest-docs-consumer">3.8.2. Consumer Flow</a></li>
+</ul>
+</li>
+<li><a href="#using-whats-next">3.9. What to Read Next</a></li>
+</ul>
+</li>
+<li><a href="#features">4. Spring Cloud Contract Features</a>
+<ul class="sectlevel2">
+<li><a href="#contract-dsl">4.1. Contract DSL</a>
+<ul class="sectlevel3">
+<li><a href="#contract-limitations">4.1.1. Limitations</a></li>
+<li><a href="#contract-common-top-elements">4.1.2. Common Top-Level Elements</a>
+<ul class="sectlevel4">
+<li><a href="#contract-dsl-description">Description</a></li>
+<li><a href="#contract-dsl-name">Name</a></li>
+<li><a href="#contract-dsl-ignoring-contracts">Ignoring Contracts</a></li>
+<li><a href="#contract-dsl-in-progress">Contracts in Progress</a></li>
+<li><a href="#contract-dsl-passing-values-from-files">Passing Values from Files</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#features-http">4.2. Contracts for HTTP</a>
+<ul class="sectlevel3">
+<li><a href="#contract-dsl-http-top-level-elements">4.2.1. HTTP Top-Level Elements</a></li>
+<li><a href="#contract-dsl-request">4.2.2. HTTP Request</a></li>
+<li><a href="#contract-dsl-response">4.2.3. HTTP Response</a></li>
+<li><a href="#contract-dsl-dynamic-properties">4.2.4. Dynamic properties</a>
+<ul class="sectlevel4">
+<li><a href="#contract-dsl-dynamic-properties-in-body">Dynamic Properties inside the Body</a></li>
+<li><a href="#contract-dsl-regex">Regular Expressions</a></li>
+<li><a href="#contract-dsl-optional-params">Passing Optional Parameters</a></li>
+<li><a href="#contract-dsl-custom-methods">Executing Custom Methods on the Server Side</a></li>
+<li><a href="#contract-dsl-referencing-request-from-response">Referencing the Request from the Response</a></li>
+<li><a href="#contract-dsl-matchers">Dynamic Properties in the Matchers Sections</a></li>
+</ul>
+</li>
+<li><a href="#contract-dsl-async">4.2.5. Asynchronous Support</a></li>
+<li><a href="#contract-dsl-xml">4.2.6. XML Support for HTTP</a></li>
+<li><a href="#contract-dsl-multiple">4.2.7. Multiple Contracts in One File</a></li>
+<li><a href="#contract-stateful-contracts">4.2.8. Stateful Contracts</a></li>
+</ul>
+</li>
+<li><a href="#feature-integrations">4.3. Integrations</a>
+<ul class="sectlevel3">
+<li><a href="#features-jax-rs">4.3.1. JAX-RS</a></li>
+<li><a href="#feature-webflux">4.3.2. WebFlux with WebTestClient</a></li>
+<li><a href="#feature-webflux-explicit">4.3.3. WebFlux with Explicit Mode</a></li>
+<li><a href="#features-context-paths">4.3.4. Working with Context Paths</a></li>
+<li><a href="#features-rest-docs">4.3.5. Working with REST Docs</a>
+<ul class="sectlevel4">
+<li><a href="#features-rest-docs-contracts">Generating Contracts with REST Docs</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#features-messaging">4.4. Messaging</a>
+<ul class="sectlevel3">
+<li><a href="#contract-dsl-messaging-top-level">4.4.1. Messaging DSL Top-Level Elements</a>
+<ul class="sectlevel4">
+<li><a href="#contract-dsl-output-triggered-method">Output Triggered by a Method</a></li>
+<li><a href="#contract-dsl-output-triggered-message">Output Triggered by a Message</a></li>
+<li><a href="#contract-dsl-consumer-producer">Consumer/Producer</a></li>
+<li><a href="#contract-dsl-messaging-common">Common</a></li>
+</ul>
+</li>
+<li><a href="#features-messaging-integrations">4.4.2. Integrations</a>
+<ul class="sectlevel4">
+<li><a href="#features-messaging-manual">Manual Integration Testing</a></li>
+</ul>
+</li>
+<li><a href="#features-messaging-test-generation">4.4.3. Producer Side  Messaging Test Generation</a>
+<ul class="sectlevel4">
+<li><a href="#features-messaging-scenario1">Scenario 1: No Input Message</a></li>
+<li><a href="#features-messaging-scenario2">Scenario 2: Output Triggered by Input</a></li>
+<li><a href="#features-messaging-scenario3">Scenario 3: No Output Message</a></li>
+</ul>
+</li>
+<li><a href="#features-messaging-consumer">4.4.4. Consumer Stub Generation</a>
+<ul class="sectlevel4">
+<li><a href="#features-messaging-stub-triggering">Stub triggering</a></li>
+<li><a href="#features-messaging-trigger-label">Trigger by Label</a></li>
+<li><a href="#features-messaging-trigger-group-artifact-ids">Trigger by Group and Artifact Ids</a></li>
+<li><a href="#features-messaging-trigger-artifact-ids">Trigger by Artifact IDs</a></li>
+<li><a href="#features-messaging-trigger-all-messages">Trigger All Messages</a></li>
+</ul>
+</li>
+<li><a href="#features-messaging-stub-runner-camel">4.4.5. Consumer Side Messaging With Apache Camel</a>
+<ul class="sectlevel4">
+<li><a href="#features-messaging-stub-runner-camel-adding">Adding Apache Camel to the Project</a></li>
+<li><a href="#features-messaging-stub-runner-camel-disabling">Disabling the Functionality</a></li>
+<li><a href="#features-messaging-stub-runner-camel-example">Examples</a></li>
+</ul>
+</li>
+<li><a href="#features-messaging-stub-runner-integration">4.4.6. Consumer Side Messaging with Spring Integration</a>
+<ul class="sectlevel4">
+<li><a href="#features-messaging-stub-runner-integration-adding">Adding the Runner to the Project</a></li>
+<li><a href="#features-messaging-stub-runner-integration-disabling">Disabling the Functionality</a></li>
+<li><a href="#features-messaging-stub-runner-integration-example">Examples</a></li>
+</ul>
+</li>
+<li><a href="#features-messaging-stub-runner-stream">4.4.7. Consumer Side Messaging With Spring Cloud Stream</a>
+<ul class="sectlevel4">
+<li><a href="#features-messaging-stub-runner-stream-adding">Adding the Runner to the Project</a></li>
+<li><a href="#features-messaging-stub-runner-stream-disabling">Disabling the Functionality</a></li>
+<li><a href="#features-messaging-stub-runner-stream-example">Examples</a></li>
+</ul>
+</li>
+<li><a href="#features-messaging-stub-runner-amqp">4.4.8. Consumer Side Messaging With Spring AMQP</a>
+<ul class="sectlevel4">
+<li><a href="#features-messaging-stub-runner-amqp-adding">Adding the Runner to the Project</a></li>
+<li><a href="#features-messaging-stub-runner-amqp-example">Examples</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#features-stub-runner">4.5. Spring Cloud Contract Stub Runner</a>
+<ul class="sectlevel3">
+<li><a href="#features-stub-runner-snapshot-versions">4.5.1. Snapshot Versions</a></li>
+<li><a href="#features-stub-runner-publishing-stubs-as-jars">4.5.2. Publishing Stubs as JARs</a></li>
+<li><a href="#features-stub-runner-core">4.5.3. Stub Runner Core</a>
+<ul class="sectlevel4">
+<li><a href="#features-stub-runner-retrieving">Retrieving stubs</a></li>
+<li><a href="#features-stub-runner-running-stubs">Running stubs</a></li>
+</ul>
+</li>
+<li><a href="#features-stub-runner-junit">4.5.4. Stub Runner JUnit Rule and Stub Runner JUnit5 Extension</a>
+<ul class="sectlevel4">
+<li><a href="#features-stub-runner-rule-maven-settings">Maven Settings</a></li>
+<li><a href="#features-stub-runner-rule-fixed-ports">Providing Fixed Ports</a></li>
+<li><a href="#features-stub-runner-rule-fluent-api">Fluent API</a></li>
+<li><a href="#features-stub-runner-rule-spring">Stub Runner with Spring</a></li>
+</ul>
+</li>
+<li><a href="#features-stub-runner-cloud">4.5.5. Stub Runner Spring Cloud</a>
+<ul class="sectlevel4">
+<li><a href="#features-stub-runner-cloud-stubbing-discovery">Stubbing Service Discovery</a></li>
+<li><a href="#features-stub-runner-additional-config">Additional Configuration</a></li>
+</ul>
+</li>
+<li><a href="#features-stub-runner-boot">4.5.6. Using the Stub Runner Boot Application</a>
+<ul class="sectlevel5">
+<li><a href="#features-stub-runner-boot-server">Stub Runner Server</a></li>
+<li><a href="#features-stub-runner-boot-how-fat-jar">Stub Runner Server Fat Jar</a></li>
+<li><a href="#features-stub-runner-boot-how-cli">Spring Cloud CLI</a></li>
+<li><a href="#features-stub-runner-boot-endpoints">Endpoints</a></li>
+<li><a href="#features-stub-runner-boot-endpoints-example">Example</a></li>
+<li><a href="#features-stub-runner-boot-service-discovery">Stub Runner Boot with Service Discovery</a></li>
+</ul>
+</li>
+<li><a href="#features-stub-runner-stubs-per-consumer">4.5.7. Consumer-Driven Contracts: Stubs Per Consumer</a></li>
+<li><a href="#features-stub-runner-stubs-protocol">4.5.8. Fetching Stubs or Contract Definitions From A Location</a></li>
+<li><a href="#features-stub-runner-generate-stubs-at-runtime">4.5.9. Generating Stubs at Runtime</a></li>
+<li><a href="#features-stub-runner-fail-on-no-stubs">4.5.10. Fail On No Stubs</a></li>
+<li><a href="#features-stub-runner-common">4.5.11. Common Properties</a>
+<ul class="sectlevel4">
+<li><a href="#features-stub-runner-common-properties-junit-spring">Common Properties for JUnit and Spring</a></li>
+<li><a href="#features-stub-runner-stub-runner-stub-ids">Stub Runner Stubs IDs</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#features-wiremock">4.6. Spring Cloud Contract WireMock</a>
+<ul class="sectlevel3">
+<li><a href="#features-wiremock-registering-stubs">4.6.1. Registering Stubs Automatically</a></li>
+<li><a href="#features-wiremock-using-files">4.6.2. Using Files to Specify the Stub Bodies</a></li>
+<li><a href="#features-wiremock-junit-rule">4.6.3. Alternative: Using JUnit Rules</a></li>
+<li><a href="#features-wiremock-relaxed-ssl">4.6.4. Relaxed SSL Validation for Rest Template</a></li>
+<li><a href="#features-wiremock-spring-mvc-mocks">4.6.5. WireMock and Spring MVC Mocks</a></li>
+</ul>
+</li>
+<li><a href="#features-build-tools">4.7. Build Tools Integration</a></li>
+<li><a href="#features-whats-next">4.8. What to Read Next</a></li>
+</ul>
+</li>
+<li><a href="#howto">5. &#8220;How-to&#8221; Guides</a>
+<ul class="sectlevel2">
+<li><a href="#why-spring-cloud-contract">5.1. Why use Spring Cloud Contract?</a></li>
+<li><a href="#how-to-not-write-contracts-in-groovy">5.2. How Can I Write Contracts in a Language Other than Groovy?</a></li>
+<li><a href="#how-to-provide-dynamic-values">5.3. How Can I Provide Dynamic Values to a Contract?</a></li>
+<li><a href="#how-to-do-stubs-versioning">5.4. How to Do Stubs versioning?</a>
+<ul class="sectlevel3">
+<li><a href="#how-to-api-versioning">5.4.1. API Versioning</a></li>
+<li><a href="#how-to-jar-versioning">5.4.2. JAR versioning</a></li>
+<li><a href="#how-to-dev-or-prod-stubs">5.4.3. Development or Production Stubs</a></li>
+</ul>
+</li>
+<li><a href="#how-to-common-repo-with-contracts">5.5. How Can I use a Common Repository with Contracts Instead of Storing Them with the Producer?</a>
+<ul class="sectlevel3">
+<li><a href="#how-to-repo-structure">5.5.1. Repo Structure</a></li>
+<li><a href="#how-to-workflow">5.5.2. Workflow</a></li>
+<li><a href="#how-to-workflow-consumer">5.5.3. Consumer</a></li>
+<li><a href="#how-to-workflow-producer">5.5.4. Producer</a></li>
+<li><a href="#how-to-define-messaging-contracts-per-topic">5.5.5. How Can I Define Messaging Contracts per Topic Rather than per Producer?</a>
+<ul class="sectlevel4">
+<li><a href="#how-to-define-messaging-contracts-per-topic-maven">For Maven Projects</a></li>
+<li><a href="#how-to-define-messaging-contracts-per-topic-gradle">For Gradle Projects</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#how-to-use-git-as-storage">5.6. How Can I Use Git as the Storage for Contracts and Stubs?</a>
+<ul class="sectlevel3">
+<li><a href="#how-to-protocol-convention">5.6.1. Protocol Convention</a></li>
+<li><a href="#how-to-protocol-convention-producer">5.6.2. Producer</a></li>
+<li><a href="#how-to-protocol-convention-producer-with-contracts-stored-locally">5.6.3. Producer with Contracts Stored Locally</a></li>
+<li><a href="#how-to-protocol-convention-contracts-producer-stubs-external">5.6.4. Keeping Contracts with the Producer and Stubs in an External Repository</a></li>
+<li><a href="#how-to-protocol-convention-contracts-producer-stubs-external-consumer">5.6.5. Consumer</a></li>
+</ul>
+</li>
+<li><a href="#how-to-use-pact-broker">5.7. How Can I Use the Pact Broker?</a>
+<ul class="sectlevel3">
+<li><a href="#how-to-use-pact-broker-pact">5.7.1. How to Work with Pact</a></li>
+<li><a href="#how-to-use-pact-broker-pact-converter">5.7.2. Pact Converter</a></li>
+<li><a href="#how-to-use-pact-broker-pact-contract">5.7.3. Pact Contract</a></li>
+<li><a href="#how-to-use-pact-broker-pact-for-producers">5.7.4. Pact for Producers</a></li>
+<li><a href="#how-to-use-pact-broker-pact-consumers">5.7.5. Pact for Consumers</a></li>
+<li><a href="#pact-stub-downloader">5.7.6. Communicating with the Pact Broker</a></li>
+<li><a href="#how-to-pact-consumer">5.7.7. Flow: Consumer Contract approach with Pact Broker | Consumer Side</a></li>
+<li><a href="#how-to-pact-producer">5.7.8. Flow: Consumer Contract Approach with Pact Broker on the Producer Side</a></li>
+<li><a href="#how-to-pact-consumer-producer-contract">5.7.9. Flow: Producer Contract approach with Pact on the Consumer Side</a></li>
+</ul>
+</li>
+<li><a href="#how-to-debug">5.8. How Can I Debug the Request/Response Being Sent by the Generated Tests Client?</a></li>
+<li><a href="#how-to-debug-wiremock">5.9. How Can I Debug the Mapping, Request, or Response Being Sent by WireMock?</a></li>
+<li><a href="#how-to-see-registered-stubs">5.10. How Can I See What Got Registered in the HTTP Server Stub?</a></li>
+<li><a href="#how-to-reference-text-from-file">5.11. How Can I Reference Text from File?</a></li>
+<li><a href="#how-to-generate-pact-from-scc">5.12. How Can I Generate Pact, YAML, or X files from Spring Cloud Contract Contracts?</a></li>
+<li><a href="#how-to-work-with-transitivie">5.13. How Can I Work with Transitive Dependencies?</a>
+<ul class="sectlevel3">
+<li><a href="#how-to-work-with-transitivie-optional">5.13.1. How Can I Mark All Application Dependencies as Optional?</a></li>
+<li><a href="#how-to-work-with-transitivie-separate">5.13.2. How can I Create a Separate <code>artifactid</code> for the Stubs?</a></li>
+<li><a href="#how-to-work-with-transitivie-exclude">5.13.3. How can I Exclude Dependencies on the Consumer Side?</a></li>
+</ul>
+</li>
+<li><a href="#contract-dsl-rest-docs">5.14. How can I Generate Spring REST Docs Snippets from the Contracts?</a></li>
+<li><a href="#how-to-use-stubs-from-a-location">5.15. How can I Use Stubs from a Location</a></li>
+<li><a href="#how-to-generate-stubs-at-runtime">5.16. How can I Generate Stubs at Runtime</a></li>
+<li><a href="#how-to-use-the-failonnostubs-feature">5.17. How can I Make The Build Pass if There Are No Contracts or Stubs</a></li>
+</ul>
+</li>
+</ul>
+</div>
+</div>
+<div id="content">
+<div class="sect1">
+<h2 id="legal"><a class="anchor" href="#legal"></a><a class="link" href="#legal">Legal</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>2.2.0.BUILD-SNAPSHOT</p>
+</div>
+<div class="paragraph">
+<p>Copyright &#169; 2012-2019</p>
+</div>
+<div class="paragraph">
+<p>Copies of this document may be made for your own use and for distribution to
+others, provided that you do not charge any fee for such copies and further
+provided that each copy contains this Copyright Notice, whether distributed in
+print or electronically.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="documentation"><a class="anchor" href="#documentation"></a><a class="link" href="#documentation">1. Spring Cloud Contract Documentation</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This section provides a brief overview of Spring Cloud Contract reference documentation. It serves
+as a map for the rest of the document.</p>
+</div>
+<div class="sect2">
+<h3 id="contract-documentation-about"><a class="anchor" href="#contract-documentation-about"></a><a class="link" href="#contract-documentation-about">1.1. About the Documentation</a></h3>
+<div class="paragraph">
+<p>The Spring Cloud Contract reference guide is available as</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="https://cloud.spring.io/spring-cloud-contract/${git.branch}//html">Multi-page HTML</a></p>
+</li>
+<li>
+<p><a href="https://cloud.spring.io/spring-cloud-contract/${git.branch}//htmlsingle">Single-page HTML</a></p>
+</li>
+<li>
+<p><a href="https://cloud.spring.io/spring-cloud-contract/${git.branch}//pdf/spring-cloud-contract.pdf">PDF</a></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Copies of this document may be made for your own use and for distribution to others,
+provided that you do not charge any fee for such copies and further provided that each
+copy contains this Copyright Notice, whether distributed in print or electronically.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="documentation-getting-help"><a class="anchor" href="#documentation-getting-help"></a><a class="link" href="#documentation-getting-help">1.2. Getting Help</a></h3>
+<div class="paragraph">
+<p>If you have trouble with Spring Cloud Contract, we would like to help.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Try the <a href="#howto">How-to documents</a>. They provide solutions to the most
+common questions.</p>
+</li>
+<li>
+<p>Learn the Spring Cloud Contract basics. If you are
+starting out with Spring Cloud Contract, try one of the <a href="https://spring.io/guides">guides</a>.</p>
+</li>
+<li>
+<p>Ask a question. We monitor <a href="https://stackoverflow.com">stackoverflow.com</a> for questions
+tagged with <a href="https://stackoverflow.com/tags/spring-cloud-contract"><code>spring-cloud-contract</code></a>.</p>
+</li>
+<li>
+<p>Report bugs with Spring Cloud Contract at <a href="https://github.com/spring-cloud/spring-cloud-contract/issues" class="bare">github.com/spring-cloud/spring-cloud-contract/issues</a>.</p>
+</li>
+<li>
+<p>Chat with us at <a href="http://https://gitter.im/spring-cloud/spring-cloud-contract">Spring Cloud Contract Gitter</a></p>
+</li>
+</ul>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+All of Spring Cloud Contract is open source, including the documentation. If you find
+problems with the docs or if you want to improve them, please <a href="https://github.com/spring-cloud/spring-cloud-contract/tree/${github-tag}">get
+involved</a>.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="contract-documentation-first-steps"><a class="anchor" href="#contract-documentation-first-steps"></a><a class="link" href="#contract-documentation-first-steps">1.3. First Steps</a></h3>
+<div class="paragraph">
+<p>If you are getting started with Spring Cloud Contract or 'Spring' in general, start with
+<a href="#getting-started">the following topics</a>:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>From scratch:</strong>
+<a href="#getting-started-introducing-spring-cloud-contract">Overview</a> |
+<a href="#getting-started-three-second-tour">Three-second Tour</a> |
+<a href="#getting-started-first-application">First application</a></p>
+</li>
+<li>
+<p><strong>Tutorial:</strong>
+<a href="#getting-started-cdc">Introduction</a> |
+<a href="#consumer-side-loan-issuance">Consumer, Part 1</a> |
+<a href="#producer-side-fraud-detection-server">Producer</a> |
+<a href="#consumer-side-loan-issuance-final-step">Consumer, Part 2</a></p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="working-with-spring-cloud-contract"><a class="anchor" href="#working-with-spring-cloud-contract"></a><a class="link" href="#working-with-spring-cloud-contract">1.4. Working with Spring Cloud Contract</a></h3>
+<div class="paragraph">
+<p>Ready to actually start using Spring Cloud Contract? <a href="#using">We have
+you covered</a>:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>Provider contract testing:</strong></p>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#flows-provider-nexus">Provider contract testing with stubs in Nexus or Artifactory</a></p>
+</li>
+<li>
+<p><a href="#flows-provider-git">Provider contract testing with stubs in Git</a></p>
+</li>
+<li>
+<p><a href="#flows-provider-non-spring">Provider contract testing with stubs in Artifactory for a non-Spring application</a></p>
+</li>
+<li>
+<p><a href="#flows-provider-non-jvm">Provider contract testing with stubs in Artifactory in non JVM world</a></p>
+</li>
+<li>
+<p><a href="#flows-provider-rest-docs">Provider contract testing with REST Docs and stubs in Nexus / Artifactory</a></p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><strong>Consumer-Driven contract testing:</strong></p>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#flows-cdc-contracts-producer">Consumer Driven Contracts with contracts on the producer side</a></p>
+</li>
+<li>
+<p><a href="#flows-cdc-contracts-external">Consumer Driven Contracts with contracts in external repo</a></p>
+</li>
+<li>
+<p><a href="#flows-cdc-contracts-stubs-git">Consumer Driven Contracts with contracts on the producer side, pushed to git</a></p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+We talk about <strong>Provider Contracts</strong> when it is the producer of the API that defines the contracts and
+publishes it for all its consumers to use. This approach is useful for producers that cannot
+directly collaborate with their consumers&#8201;&#8212;&#8201;for example, when there are too many consumers or
+the consumers are external (do not work within the same company).
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+We use the term, <strong>Consumer-Driven Contracts</strong>, to refer to workflows where the consumers of an API
+play a vital role in the process of creating the contracts. We recommended this approach, because it is easy
+to implement when both producer and consumer teams work for the same organizations and the number
+of consumers is not extremely large.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="learning-about-spring-cloud-contract-features"><a class="anchor" href="#learning-about-spring-cloud-contract-features"></a><a class="link" href="#learning-about-spring-cloud-contract-features">1.5. Learning about Spring Cloud Contract Features</a></h3>
+<div class="paragraph">
+<p>Need more details about Spring Cloud Contract&#8217;s core features?
+<a href="#features">The following content is for you</a>:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>Core Features:</strong>
+<a href="#contract-dsl">Contract DSL</a> |
+<a href="#features-http">Contracts for HTTP</a> |
+<a href="#features-messaging">Contracts for Messaging</a></p>
+</li>
+<li>
+<p><strong>Integrations:</strong>
+<a href="#features-jax-rs">JAX-RS</a> |
+<a href="#features-context-paths">Context Paths</a> |
+<a href="#features-rest-docs">RESTDocs</a>
+<a href="#how-to-generate-pact-from-scc">Pact</a></p>
+</li>
+<li>
+<p><strong>Modules:</strong>
+<a href="#features-stub-runner">Stub Runner</a> |
+<a href="#features-wiremock">WireMock</a></p>
+</li>
+<li>
+<p><strong>Build Tools:</strong>
+<a href="maven-project.html">Contract Verifier - Maven</a> |
+<a href="gradle-project.html">Contract Verifier - Gradle</a> |
+<a href="docker-project.html">Docker</a></p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="advanced-topics"><a class="anchor" href="#advanced-topics"></a><a class="link" href="#advanced-topics">1.6. Advanced Topics</a></h3>
+<div class="paragraph">
+<p>Finally, we have a few topics for more advanced users:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><strong>Customizing the DSL:</strong>
+<a href="advanced.html#contract-dsl-customization">DSL Customization</a> |
+<a href="advanced.html#contract-dsl-extending-common-jar">Common JAR</a> |
+<a href="advanced.html#contract-dsl-test-dep">Test Dependency</a> |
+<a href="advanced.html#contract-dsl-plugin-dep">Plugin Dependency</a> |
+<a href="advanced.html#contract-dsl-referencing">Referencing the DSL</a></p>
+</li>
+<li>
+<p><strong>Customizing WireMock:</strong>
+<a href="advanced.html#customization-wiremock-extension">Extensions</a> |
+<a href="advanced.html#customization-wiremock-configuration">Configuration</a></p>
+</li>
+<li>
+<p><strong>Customizing Spring Cloud Contract:</strong>
+<a href="advanced.html#contract-dsl-pluggable-architecture">Pluggable Architecture</a> |
+<a href="advanced.html#contract-dsl-custom-contract-converter">Contract Converter</a> |
+<a href="advanced.html#contract-dsl-custom-test-generator">Test Generator</a> |
+<a href="advanced.html#contract-dsl-custom-stub-generator">Stub Generator</a> |
+<a href="advanced.html#contract-dsl-custom-stub-runner">Stub Runner</a> |
+<a href="advanced.html#contract-dsl-custom-stub-downloader">Stub Downloader</a></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="getting-started"><a class="anchor" href="#getting-started"></a><a class="link" href="#getting-started">2. Getting Started</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>If you are getting started with Spring Cloud Contract, or Spring in general, start by reading
+this section. It answers the basic &#8220;what?&#8221;, &#8220;how?&#8221; and &#8220;why?&#8221; questions. It
+includes an introduction to Spring Cloud Contract, along with installation instructions. We then
+walk you through building your first Spring Cloud Contract application, discussing some core
+principles as we go.</p>
+</div>
+<div class="sect2">
+<h3 id="getting-started-introducing-spring-cloud-contract"><a class="anchor" href="#getting-started-introducing-spring-cloud-contract"></a><a class="link" href="#getting-started-introducing-spring-cloud-contract">2.1. Introducing Spring Cloud Contract</a></h3>
+<div class="paragraph">
+<p>Spring Cloud Contract moves TDD to the level of software architecture.
+It lets you perform consumer-driven and producer-driven contract testing.</p>
+</div>
+<div class="sect3">
+<h4 id="getting-started-introducing-spring-cloud-contract-history"><a class="anchor" href="#getting-started-introducing-spring-cloud-contract-history"></a><a class="link" href="#getting-started-introducing-spring-cloud-contract-history">2.1.1. History</a></h4>
+<div class="paragraph">
+<p>Before becoming Spring Cloud Contract, this project was called <a href="https://github.com/Codearte/accurest">Accurest</a>.
+It was created by <a href="https://twitter.com/mgrzejszczak">Marcin Grzejszczak</a> and <a href="https://twitter.com/jkubrynski">Jakub Kubrynski</a>
+from (<a href="https://github.com/Codearte">Codearte</a>).</p>
+</div>
+<div class="paragraph">
+<p>The <code>0.1.0</code> release took place on 26 Jan 2015 and it became stable with <code>1.0.0</code> release on 29 Feb 2016.</p>
+</div>
+<div class="sect4">
+<h5 id="getting-started-introducing-spring-cloud-contract-why"><a class="anchor" href="#getting-started-introducing-spring-cloud-contract-why"></a><a class="link" href="#getting-started-introducing-spring-cloud-contract-why">Why Do You Need It?</a></h5>
+<div class="paragraph">
+<p>Assume that we have a system that consists of multiple microservices, as the following
+image shows:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/Deps.png" alt="Microservices Architecture">
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="getting-started-introducing-spring-cloud-contract-testing-issues"><a class="anchor" href="#getting-started-introducing-spring-cloud-contract-testing-issues"></a><a class="link" href="#getting-started-introducing-spring-cloud-contract-testing-issues">Testing Issues</a></h5>
+<div class="paragraph">
+<p>If we want to test the application in the top left corner of the image in the preceding
+section to determine whether it can communicate with other services, we could do one of
+two things:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Deploy all microservices and perform end-to-end tests.</p>
+</li>
+<li>
+<p>Mock other microservices in unit and integration tests.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Both have their advantages but also a lot of disadvantages.</p>
+</div>
+<div class="paragraph">
+<p><strong>Deploy all microservices and perform end to end tests</strong></p>
+</div>
+<div class="paragraph">
+<p>Advantages:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Simulates production.</p>
+</li>
+<li>
+<p>Tests real communication between services.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Disadvantages:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>To test one microservice, we have to deploy six microservices, a couple of databases,
+and other items.</p>
+</li>
+<li>
+<p>The environment where the tests run is locked for a single suite of tests (nobody else
+would be able to run the tests in the meantime).</p>
+</li>
+<li>
+<p>They take a long time to run.</p>
+</li>
+<li>
+<p>The feedback comes very late in the process.</p>
+</li>
+<li>
+<p>They are extremely hard to debug.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p><strong>Mock other microservices in unit and integration tests</strong></p>
+</div>
+<div class="paragraph">
+<p>Advantages:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>They provide very fast feedback.</p>
+</li>
+<li>
+<p>They have no infrastructure requirements.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Disadvantages:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The implementor of the service creates stubs that might have nothing to do with
+reality.</p>
+</li>
+<li>
+<p>You can go to production with passing tests and failing production.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>To solve the aforementioned issues, Spring Cloud Contract was created. The main idea is to
+give you very fast feedback, without the need to set up the
+whole world of microservices. If you work on stubs, then the only applications you need
+are those that your application directly uses. The following image shows the relationship
+of stubs to an application:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/Stubs2.png" alt="Stubbed Services">
+</div>
+</div>
+<div class="paragraph">
+<p>Spring Cloud Contract gives you the certainty that the stubs that you use were
+created by the service that you call. Also, if you can use them, it means that they
+were tested against the producer&#8217;s side. In short, you can trust those stubs.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-introducing-spring-cloud-contract-purposes"><a class="anchor" href="#getting-started-introducing-spring-cloud-contract-purposes"></a><a class="link" href="#getting-started-introducing-spring-cloud-contract-purposes">2.1.2. Purposes</a></h4>
+<div class="paragraph">
+<p>The main purposes of Spring Cloud Contract are:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>To ensure that HTTP and Messaging stubs (used when developing the client) do exactly
+what the actual server-side implementation does.</p>
+</li>
+<li>
+<p>To promote the ATDD (acceptance test-driven developement) method and the microservices architectural style.</p>
+</li>
+<li>
+<p>To provide a way to publish changes in contracts that are immediately visible on both sides.</p>
+</li>
+<li>
+<p>To generate boilerplate test code to be used on the server side.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>By default, Spring Cloud Contract integrates with <a href="http://wiremock.org">Wiremock</a> as the HTTP server stub.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Spring Cloud Contract&#8217;s purpose is NOT to start writing business
+features in the contracts. Assume that we have a business use case of fraud check. If a
+user can be a fraud for 100 different reasons, we would assume that you would create two
+contracts, one for the positive case and one for the negative case. Contract tests are
+used to test contracts between applications and not to simulate full behavior.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-what-is-a-contract"><a class="anchor" href="#getting-started-what-is-a-contract"></a><a class="link" href="#getting-started-what-is-a-contract">2.1.3. What Is a Contract?</a></h4>
+<div class="paragraph">
+<p>As consumers of services, we need to define what exactly we want to achieve. We need to
+formulate our expectations. That is why we write contracts. In other words, a contract is
+an agreement on how the API or message communication should look. Consider the following example:</p>
+</div>
+<div class="paragraph">
+<p>Assume that you want to send a request that contains the ID of a client company and the
+amount it wants to borrow from us. You also want to send it to the <code>/fraudcheck</code> URL via
+the <code>PUT</code> method. The following listing shows a contract to check whether a client should
+be marked as a fraud in both Groovy and YAML:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">/*
+ * Copyright 2013-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package contracts
+
+org.springframework.cloud.contract.spec.Contract.make {
+    request { // (1)
+        method 'PUT' // (2)
+        url '/fraudcheck' // (3)
+        body([ // (4)
+               "client.id": $(regex('[0-9]{10}')),
+               loanAmount : 99999
+        ])
+        headers { // (5)
+            contentType('application/json')
+        }
+    }
+    response { // (6)
+        status OK() // (7)
+        body([ // (8)
+               fraudCheckStatus  : "FRAUD",
+               "rejection.reason": "Amount too high"
+        ])
+        headers { // (9)
+            contentType('application/json')
+        }
+    }
+}
+
+/*
+From the Consumer perspective, when shooting a request in the integration test:
+
+(1) - If the consumer sends a request
+(2) - With the "PUT" method
+(3) - to the URL "/fraudcheck"
+(4) - with the JSON body that
+ * has a field `client.id` that matches a regular expression `[0-9]{10}`
+ * has a field `loanAmount` that is equal to `99999`
+(5) - with header `Content-Type` equal to `application/json`
+(6) - then the response will be sent with
+(7) - status equal `200`
+(8) - and JSON body equal to
+ { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+(9) - with header `Content-Type` equal to `application/json`
+
+From the Producer perspective, in the autogenerated producer-side test:
+
+(1) - A request will be sent to the producer
+(2) - With the "PUT" method
+(3) - to the URL "/fraudcheck"
+(4) - with the JSON body that
+ * has a field `client.id` that will have a generated value that matches a regular expression `[0-9]{10}`
+ * has a field `loanAmount` that is equal to `99999`
+(5) - with header `Content-Type` equal to `application/json`
+(6) - then the test will assert if the response has been sent with
+(7) - status equal `200`
+(8) - and JSON body equal to
+ { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+(9) - with header `Content-Type` matching `application/json.*`
+ */</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yaml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">request: # (1)
+  method: PUT # (2)
+  url: /fraudcheck # (3)
+  body: # (4)
+    "client.id": 1234567890
+    loanAmount: 99999
+  headers: # (5)
+    Content-Type: application/json
+  matchers:
+    body:
+      - path: $.['client.id'] # (6)
+        type: by_regex
+        value: "[0-9]{10}"
+response: # (7)
+  status: 200 # (8)
+  body:  # (9)
+    fraudCheckStatus: "FRAUD"
+    "rejection.reason": "Amount too high"
+  headers: # (10)
+    Content-Type: application/json
+
+
+#From the Consumer perspective, when shooting a request in the integration test:
+#
+#(1) - If the consumer sends a request
+#(2) - With the "PUT" method
+#(3) - to the URL "/fraudcheck"
+#(4) - with the JSON body that
+# * has a field `client.id`
+# * has a field `loanAmount` that is equal to `99999`
+#(5) - with header `Content-Type` equal to `application/json`
+#(6) - and a `client.id` json entry matches the regular expression `[0-9]{10}`
+#(7) - then the response will be sent with
+#(8) - status equal `200`
+#(9) - and JSON body equal to
+# { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+#(10) - with header `Content-Type` equal to `application/json`
+#
+#From the Producer perspective, in the autogenerated producer-side test:
+#
+#(1) - A request will be sent to the producer
+#(2) - With the "PUT" method
+#(3) - to the URL "/fraudcheck"
+#(4) - with the JSON body that
+# * has a field `client.id` `1234567890`
+# * has a field `loanAmount` that is equal to `99999`
+#(5) - with header `Content-Type` equal to `application/json`
+#(7) - then the test will assert if the response has been sent with
+#(8) - status equal `200`
+#(9) - and JSON body equal to
+# { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+#(10) - with header `Content-Type` equal to `application/json`</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="getting-started-three-second-tour"><a class="anchor" href="#getting-started-three-second-tour"></a><a class="link" href="#getting-started-three-second-tour">2.2. A Three-second Tour</a></h3>
+<div class="paragraph">
+<p>This very brief tour walks through using Spring Cloud Contract. It consists of the
+following topics:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#getting-started-three-second-tour-producer">On the Producer Side</a></p>
+</li>
+<li>
+<p><a href="#getting-started-three-second-tour-consumer">On the Consumer Side</a></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>You can find a somewhat longer tour
+<a href="#getting-started-first-application">here</a>.</p>
+</div>
+<div class="paragraph">
+<p>The following UML diagram shows the relationship of the parts within Spring Cloud Contract:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/getting-started-three-second.png" alt="getting started three second" width="986" height="704">
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-three-second-tour-producer"><a class="anchor" href="#getting-started-three-second-tour-producer"></a><a class="link" href="#getting-started-three-second-tour-producer">2.2.1. On the Producer Side</a></h4>
+<div class="paragraph">
+<p>To start working with Spring Cloud Contract, you can add files with REST or messaging contracts
+expressed in either Groovy DSL or YAML to the contracts directory, which is set by the
+<code>contractsDslDir</code> property. By default, it is <code>$rootDir/src/test/resources/contracts</code>.</p>
+</div>
+<div class="paragraph">
+<p>Then you can add the Spring Cloud Contract Verifier dependency and plugin to your build file, as
+the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-starter-contract-verifier&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following listing shows how to add the plugin, which should go in the build/plugins
+portion of the file:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Running <code>./mvnw clean install</code> automatically generates tests that verify the application
+compliance with the added contracts. By default, the tests get generated under
+<code>org.springframework.cloud.contract.verifier.tests.</code>.</p>
+</div>
+<div class="paragraph">
+<p>As the implementation of the functionalities described by the contracts is not yet
+present, the tests fail.</p>
+</div>
+<div class="paragraph">
+<p>To make them pass, you must add the correct implementation of either handling HTTP
+requests or messages. Also, you must add a correct base test class for auto-generated
+tests to the project. This class is extended by all the auto-generated tests, and it
+should contain all the setup information necessary to run them (for example <code>RestAssuredMockMvc</code>
+controller setup or messaging test setup).</p>
+</div>
+<div class="paragraph">
+<p>Once the implementation and the test base class are in place, the tests pass, and both the
+application and the stub artifacts are built and installed in the local Maven repository.
+You can now merge the changes, and you can publish both the application and the stub artifacts
+in an online repository.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-three-second-tour-consumer"><a class="anchor" href="#getting-started-three-second-tour-consumer"></a><a class="link" href="#getting-started-three-second-tour-consumer">2.2.2. On the Consumer Side</a></h4>
+<div class="paragraph">
+<p>You can use <code>Spring Cloud Contract Stub Runner</code> in the integration tests to get a running
+WireMock instance or messaging route that simulates the actual service.</p>
+</div>
+<div class="paragraph">
+<p>To do so, add the dependency to <code>Spring Cloud Contract Stub Runner</code>, as the
+following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-starter-contract-stub-runner&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can get the Producer-side stubs installed in your Maven repository in either of two
+ways:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>By checking out the Producer side repository and adding contracts and generating the stubs
+by running the following commands:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ cd local-http-server-repo
+$ ./mvnw clean install -DskipTests</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+The tests are being skipped because the producer-side contract implementation is not
+in place yet, so the automatically-generated contract tests fail.
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>By getting already-existing producer service stubs from a remote repository. To do so,
+pass the stub artifact IDs and artifact repository URL as <code>Spring Cloud Contract
+Stub Runner</code> properties, as the following example shows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">stubrunner:
+  ids: 'com.example:http-server-dsl:+:stubs:8080'
+  repositoryRoot: https://repo.spring.io/libs-snapshot</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Now you can annotate your test class with <code>@AutoConfigureStubRunner</code>. In the annotation,
+provide the <code>group-id</code> and <code>artifact-id</code> values for <code>Spring Cloud Contract Stub Runner</code> to
+run the collaborators' stubs for you, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment=WebEnvironment.NONE)
+@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:stubs:6565"},
+        stubsMode = StubRunnerProperties.StubsMode.LOCAL)
+public class LoanApplicationServiceTests {</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+Use the <code>REMOTE</code> <code>stubsMode</code> when downloading stubs from an online repository and
+<code>LOCAL</code> for offline work.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Now, in your integration test, you can receive stubbed versions of HTTP responses or
+messages that are expected to be emitted by the collaborator service.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="getting-started-first-application"><a class="anchor" href="#getting-started-first-application"></a><a class="link" href="#getting-started-first-application">2.3. Developing Your First Spring Cloud Contract-based Application</a></h3>
+<div class="paragraph">
+<p>This brief tour walks through using Spring Cloud Contract. It consists of the following topics:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#getting-started-first-application-producer">On the Producer Side</a></p>
+</li>
+<li>
+<p><a href="#getting-started-first-application-consumer">On the Consumer Side</a></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>You can find an even more brief tour
+<a href="#getting-started-three-second-tour">here</a>.</p>
+</div>
+<div class="paragraph">
+<p>For the sake of this example, the <code>Stub Storage</code> is Nexus/Artifactory.</p>
+</div>
+<div class="paragraph">
+<p>The following UML diagram shows the relationship of the parts of Spring Cloud Contract:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/getting-started-three-second.png" alt="Getting started first application">
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-first-application-producer"><a class="anchor" href="#getting-started-first-application-producer"></a><a class="link" href="#getting-started-first-application-producer">2.3.1. On the Producer Side</a></h4>
+<div class="paragraph">
+<p>To start working with <code>Spring Cloud Contract</code>, you can add Spring Cloud Contract Verifier
+dependency and plugin to your build file, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-starter-contract-verifier&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following listing shows how to add the plugin, which should go in the build/plugins
+portion of the file:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Now you can add files with <code>REST/</code> messaging contracts
+expressed in either Groovy DSL or YAML to the contracts directory, which is set by the
+<code>contractsDslDir</code> property. By default, it is <code>$rootDir/src/test/resources/contracts</code>.</p>
+</div>
+<div class="paragraph">
+<p>For the HTTP stubs, a contract defines what kind of response should be returned for a
+given request (taking into account the HTTP methods, URLs, headers, status codes, and so
+on). The following example shows an HTTP stub contract in both Groovy and YAML:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package contracts
+
+org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method 'PUT'
+        url '/fraudcheck'
+        body([
+               "client.id": $(regex('[0-9]{10}')),
+               loanAmount: 99999
+        ])
+        headers {
+            contentType('application/json')
+        }
+    }
+    response {
+        status OK()
+        body([
+               fraudCheckStatus: "FRAUD",
+               "rejection.reason": "Amount too high"
+        ])
+        headers {
+            contentType('application/json')
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yaml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">request:
+  method: PUT
+  url: /fraudcheck
+  body:
+    "client.id": 1234567890
+    loanAmount: 99999
+  headers:
+    Content-Type: application/json
+  matchers:
+    body:
+      - path: $.['client.id']
+        type: by_regex
+        value: "[0-9]{10}"
+response:
+  status: 200
+  body:
+    fraudCheckStatus: "FRAUD"
+    "rejection.reason": "Amount too high"
+  headers:
+    Content-Type: application/json;charset=UTF-8</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In the case of messaging, you can define:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The input and output messages (taking into account from and where it
+was sent, the message body, and the header).</p>
+</li>
+<li>
+<p>The methods that should be called after the message is received.</p>
+</li>
+<li>
+<p>The methods that, when called, should trigger a message.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The following example shows a Camel messaging contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">def contractDsl = Contract.make {
+    name "foo"
+    label 'some_label'
+    input {
+        messageFrom('jms:delete')
+        messageBody([
+                bookName: 'foo'
+        ])
+        messageHeaders {
+            header('sample', 'header')
+        }
+        assertThat('bookWasDeleted()')
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yaml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">label: some_label
+input:
+  messageFrom: jms:delete
+  messageBody:
+    bookName: 'foo'
+  messageHeaders:
+    sample: header
+  assertThat: bookWasDeleted()</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Running <code>./mvnw clean install</code> automatically generates tests that verify the application
+compliance with the added contracts. By default, the generated tests are under
+<code>org.springframework.cloud.contract.verifier.tests.</code>.</p>
+</div>
+<div class="paragraph">
+<p>The generated tests may differ, depending on which framework and test type you have setup in your plugin.</p>
+</div>
+<div class="paragraph">
+<p>In the next listing, you can find:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The default test mode for HTTP contracts in <code>MockMvc</code></p>
+</li>
+<li>
+<p>A JAX-RS client with the <code>JAXRS</code> test mode</p>
+</li>
+<li>
+<p>A <code>WebTestClient</code>-based test (this is particularly recommended while working with
+Reactive, <code>Web-Flux</code>-based applications) set with the <code>WEBTESTCLIENT</code> test mode</p>
+</li>
+<li>
+<p>A Spock-based test with the <code>testFramework</code> property set to <code>SPOCK</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The following listing shows all these samples:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">mockmvc</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
+public void validate_shouldMarkClientAsFraud() throws Exception {
+    // given:
+        MockMvcRequestSpecification request = given()
+                .header("Content-Type", "application/vnd.fraud.v1+json")
+                .body("{\"client.id\":\"1234567890\",\"loanAmount\":99999}");
+
+    // when:
+        ResponseOptions response = given().spec(request)
+                .put("/fraudcheck");
+
+    // then:
+        assertThat(response.statusCode()).isEqualTo(200);
+        assertThat(response.header("Content-Type")).matches("application/vnd.fraud.v1.json.*");
+    // and:
+        DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
+        assertThatJson(parsedJson).field("['fraudCheckStatus']").matches("[A-Z]{5}");
+        assertThatJson(parsedJson).field("['rejection.reason']").isEqualTo("Amount too high");
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">jaxrs</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@SuppressWarnings("rawtypes")
+public class FooTest {
+  WebTarget webTarget;
+
+  @Test
+  public void validate_() throws Exception {
+
+    // when:
+      Response response = webTarget
+              .path("/users")
+              .queryParam("limit", "10")
+              .queryParam("offset", "20")
+              .queryParam("filter", "email")
+              .queryParam("sort", "name")
+              .queryParam("search", "55")
+              .queryParam("age", "99")
+              .queryParam("name", "Denis.Stepanov")
+              .queryParam("email", "bob@email.com")
+              .request()
+              .build("GET")
+              .invoke();
+      String responseAsString = response.readEntity(String.class);
+
+    // then:
+      assertThat(response.getStatus()).isEqualTo(200);
+
+    // and:
+      DocumentContext parsedJson = JsonPath.parse(responseAsString);
+      assertThatJson(parsedJson).field("['property1']").isEqualTo("a");
+  }
+
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">webtestclient</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
+    public void validate_shouldRejectABeerIfTooYoung() throws Exception {
+        // given:
+            WebTestClientRequestSpecification request = given()
+                    .header("Content-Type", "application/json")
+                    .body("{\"age\":10}");
+
+        // when:
+            WebTestClientResponse response = given().spec(request)
+                    .post("/check");
+
+        // then:
+            assertThat(response.statusCode()).isEqualTo(200);
+            assertThat(response.header("Content-Type")).matches("application/json.*");
+        // and:
+            DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
+            assertThatJson(parsedJson).field("['status']").isEqualTo("NOT_OK");
+    }</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">spock</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">given:
+     ContractVerifierMessage inputMessage = contractVerifierMessaging.create(
+        \'\'\'{"bookName":"foo"}\'\'\',
+        ['sample': 'header']
+    )
+
+when:
+     contractVerifierMessaging.send(inputMessage, 'jms:delete')
+
+then:
+     noExceptionThrown()
+     bookWasDeleted()</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>As the implementation of the functionalities described by the contracts is not yet
+present, the tests fail.</p>
+</div>
+<div class="paragraph">
+<p>To make them pass, you must add the correct implementation of handling either HTTP
+requests or messages. Also, you must add a correct base test class for auto-generated
+tests to the project. This class is extended by all the auto-generated tests and should
+contain all the setup necessary information needed to run them (for example,
+<code>RestAssuredMockMvc</code> controller setup or messaging test setup).</p>
+</div>
+<div class="paragraph">
+<p>Once the implementation and the test base class are in place, the tests pass, and both the
+application and the stub artifacts are built and installed in the local Maven repository.
+Information about installing the stubs jar to the local repository appears in the logs, as
+the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">[INFO] --- spring-cloud-contract-maven-plugin:1.0.0.BUILD-SNAPSHOT:generateStubs (default-generateStubs) @ http-server ---
+[INFO] Building jar: /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar
+[INFO]
+[INFO] --- maven-jar-plugin:2.6:jar (default-jar) @ http-server ---
+[INFO] Building jar: /some/path/http-server/target/http-server-0.0.1-SNAPSHOT.jar
+[INFO]
+[INFO] --- spring-boot-maven-plugin:1.5.5.BUILD-SNAPSHOT:repackage (default) @ http-server ---
+[INFO]
+[INFO] --- maven-install-plugin:2.5.2:install (default-install) @ http-server ---
+[INFO] Installing /some/path/http-server/target/http-server-0.0.1-SNAPSHOT.jar to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT.jar
+[INFO] Installing /some/path/http-server/pom.xml to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT.pom
+[INFO] Installing /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can now merge the changes and publish both the application and the stub artifacts
+in an online repository.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-first-application-consumer"><a class="anchor" href="#getting-started-first-application-consumer"></a><a class="link" href="#getting-started-first-application-consumer">2.3.2. On the Consumer Side</a></h4>
+<div class="paragraph">
+<p>You can use Spring Cloud Contract Stub Runner in the integration tests to get a running
+WireMock instance or messaging route that simulates the actual service.</p>
+</div>
+<div class="paragraph">
+<p>To get started, add the dependency to <code>Spring Cloud Contract Stub Runner</code>, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-starter-contract-stub-runner&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can get the Producer-side stubs installed in your Maven repository in either of two
+ways:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>By checking out the Producer side repository and adding contracts and generating the
+stubs by running the following commands:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ cd local-http-server-repo
+$ ./mvnw clean install -DskipTests</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+The tests are skipped because the Producer-side contract implementation is not yet
+in place, so the automatically-generated contract tests fail.
+</td>
+</tr>
+</table>
+</div>
+</li>
+<li>
+<p>Getting already existing producer service stubs from a remote repository. To do so,
+pass the stub artifact IDs and artifact repository URl as <code>Spring Cloud Contract Stub
+Runner</code> properties, as the following example shows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">stubrunner:
+  ids: 'com.example:http-server-dsl:+:stubs:8080'
+  repositoryRoot: https://repo.spring.io/libs-snapshot</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Now you can annotate your test class with <code>@AutoConfigureStubRunner</code>. In the annotation,
+provide the <code>group-id</code> and <code>artifact-id</code> for <code>Spring Cloud Contract Stub Runner</code> to run
+the collaborators' stubs for you, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment=WebEnvironment.NONE)
+@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:stubs:6565"},
+        stubsMode = StubRunnerProperties.StubsMode.LOCAL)
+public class LoanApplicationServiceTests {</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+Use the <code>REMOTE</code> <code>stubsMode</code> when downloading stubs from an online repository and
+<code>LOCAL</code> for offline work.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>In your integration test, you can receive stubbed versions of HTTP responses or messages
+that are expected to be emitted by the collaborator service. You can see entries similar
+to the following in the build logs:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">2016-07-19 14:22:25.403  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Desired version is + - will try to resolve the latest version
+2016-07-19 14:22:25.438  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolved version is 0.0.1-SNAPSHOT
+2016-07-19 14:22:25.439  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolving artifact com.example:http-server:jar:stubs:0.0.1-SNAPSHOT using remote repositories []
+2016-07-19 14:22:25.451  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolved artifact com.example:http-server:jar:stubs:0.0.1-SNAPSHOT to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar
+2016-07-19 14:22:25.465  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Unpacking stub from JAR [URI: file:/path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar]
+2016-07-19 14:22:25.475  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Unpacked file to [/var/folders/0p/xwq47sq106x1_g3dtv6qfm940000gq/T/contracts100276532569594265]
+2016-07-19 14:22:27.737  INFO 41050 --- [           main] o.s.c.c.stubrunner.StubRunnerExecutor    : All stubs are now running RunningStubs [namesAndPorts={com.example:http-server:0.0.1-SNAPSHOT:stubs=8080}]</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="getting-started-cdc"><a class="anchor" href="#getting-started-cdc"></a><a class="link" href="#getting-started-cdc">2.4. Step-by-step Guide to Consumer Driven Contracts (CDC) with Contracts on the Producer Side</a></h3>
+<div class="paragraph">
+<p>Consider an example of fraud detection and the loan issuance process. The business
+scenario is such that we want to issue loans to people but do not want them to steal from
+us. The current implementation of our system grants loans to everybody.</p>
+</div>
+<div class="paragraph">
+<p>Assume that <code>Loan Issuance</code> is a client to the <code>Fraud Detection</code> server. In the current
+sprint, we must develop a new feature: if a client wants to borrow too much money,
+we mark the client as a fraud.</p>
+</div>
+<div class="paragraph">
+<p>Technical remarks</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Fraud Detection has an <code>artifact-id</code> of <code>http-server</code></p>
+</li>
+<li>
+<p>Loan Issuance has an artifact-id of <code>http-client</code></p>
+</li>
+<li>
+<p>Both have a <code>group-id</code> of <code>com.example</code></p>
+</li>
+<li>
+<p>For the sake of this example the <code>Stub Storage</code> is Nexus/Artifactory</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Social remarks</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Both the client and the server development teams need to communicate directly and
+discuss changes while going through the process</p>
+</li>
+<li>
+<p>CDC is all about communication</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The <a href="https://github.com/spring-cloud/spring-cloud-contract/tree/{branch}/samples/standalone/dsl/http-server">server-side
+code is available here</a> and <a href="https://github.com/spring-cloud/spring-cloud-contract/tree/{branch}/samples/standalone/dsl/http-client">the client code  is available here</a>.</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+In this case, the producer owns the contracts. Physically, all of the contracts are
+in the producer&#8217;s repository.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect3">
+<h4 id="getting-started-cdc-technical-note"><a class="anchor" href="#getting-started-cdc-technical-note"></a><a class="link" href="#getting-started-cdc-technical-note">2.4.1. Technical Note</a></h4>
+<div class="paragraph">
+<p>If you use the SNAPSHOT, Milestone, or Release Candidate versions you need to add the
+following section to your build:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;repositories&gt;
+    &lt;repository&gt;
+        &lt;id&gt;spring-snapshots&lt;/id&gt;
+        &lt;name&gt;Spring Snapshots&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;true&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/repository&gt;
+    &lt;repository&gt;
+        &lt;id&gt;spring-milestones&lt;/id&gt;
+        &lt;name&gt;Spring Milestones&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/repository&gt;
+    &lt;repository&gt;
+        &lt;id&gt;spring-releases&lt;/id&gt;
+        &lt;name&gt;Spring Releases&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/repository&gt;
+&lt;/repositories&gt;
+&lt;pluginRepositories&gt;
+    &lt;pluginRepository&gt;
+        &lt;id&gt;spring-snapshots&lt;/id&gt;
+        &lt;name&gt;Spring Snapshots&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;true&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/pluginRepository&gt;
+    &lt;pluginRepository&gt;
+        &lt;id&gt;spring-milestones&lt;/id&gt;
+        &lt;name&gt;Spring Milestones&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/pluginRepository&gt;
+    &lt;pluginRepository&gt;
+        &lt;id&gt;spring-releases&lt;/id&gt;
+        &lt;name&gt;Spring Releases&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/pluginRepository&gt;
+&lt;/pluginRepositories&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">repositories {
+    mavenCentral()
+    mavenLocal()
+    maven { url "https://repo.spring.io/snapshot" }
+    maven { url "https://repo.spring.io/milestone" }
+    maven { url "https://repo.spring.io/release" }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>For simplicity, we use the following acronyms:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Loan Issuance (LI): The HTTP client</p>
+</li>
+<li>
+<p>Fraud Detection (FD): The HTTP server</p>
+</li>
+<li>
+<p>Spring Cloud Contract (SCC)</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-cdc-consumer"><a class="anchor" href="#getting-started-cdc-consumer"></a><a class="link" href="#getting-started-cdc-consumer">2.4.2. The Consumer Side (Loan Issuance)</a></h4>
+<div class="paragraph">
+<p>As a developer of the Loan Issuance service (a consumer of the Fraud Detection server), you might do the following steps:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Start doing TDD by writing a test for your feature.</p>
+</li>
+<li>
+<p>Write the missing implementation.</p>
+</li>
+<li>
+<p>Clone the Fraud Detection service repository locally.</p>
+</li>
+<li>
+<p>Define the contract locally in the repo of the fraud detection service.</p>
+</li>
+<li>
+<p>Add the Spring Cloud Contract (SCC) plugin.</p>
+</li>
+<li>
+<p>Run the integration tests.</p>
+</li>
+<li>
+<p>File a pull request.</p>
+</li>
+<li>
+<p>Create an initial implementation.</p>
+</li>
+<li>
+<p>Take over the pull request.</p>
+</li>
+<li>
+<p>Write the missing implementation.</p>
+</li>
+<li>
+<p>Deploy your app.</p>
+</li>
+<li>
+<p>Work online.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>We start with the loan issuance flow, which the following UML diagram shows:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/getting-started-cdc-client.png" alt="getting started cdc client" width="1138" height="1223">
+</div>
+</div>
+<div class="sect4">
+<h5 id="getting-started-cdc-consumer-start"><a class="anchor" href="#getting-started-cdc-consumer-start"></a><a class="link" href="#getting-started-cdc-consumer-start">Start Doing TDD by Writing a Test for Your Feature</a></h5>
+<div class="paragraph">
+<p>The following listing shows a test that we might use to check whether a loan amount is too
+large:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@Test
+public void shouldBeRejectedDueToAbnormalLoanAmount() {
+    // given:
+    LoanApplication application = new LoanApplication(new Client("1234567890"),
+            99999);
+    // when:
+    LoanApplicationResult loanApplication = service.loanApplication(application);
+    // then:
+    assertThat(loanApplication.getLoanApplicationStatus())
+            .isEqualTo(LoanApplicationStatus.LOAN_APPLICATION_REJECTED);
+    assertThat(loanApplication.getRejectionReason()).isEqualTo("Amount too high");
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Assume that you have written a test of your new feature. If a loan application for a big
+amount is received, the system should reject that loan application with some description.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="getting-started-cdc-consumer-write"><a class="anchor" href="#getting-started-cdc-consumer-write"></a><a class="link" href="#getting-started-cdc-consumer-write">Write the Missing Implementation</a></h5>
+<div class="paragraph">
+<p>At some point in time, you need to send a request to the Fraud Detection service. Assume
+that you need to send the request containing the ID of the client and the amount the
+client wants to borrow. You want to send it to the <code>/fraudcheck</code> URL by using the <code>PUT</code> method.
+To do so, you might use code similar to the following:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">ResponseEntity&lt;FraudServiceResponse&gt; response = restTemplate.exchange(
+        "http://localhost:" + port + "/fraudcheck", HttpMethod.PUT,
+        new HttpEntity&lt;&gt;(request, httpHeaders), FraudServiceResponse.class);</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>For simplicity, the port of the Fraud Detection service is set to <code>8080</code>, and the
+application runs on <code>8090</code>.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+If you start the test at this point, it breaks, because no service currently runs on port
+<code>8080</code>.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="getting-started-cdc-consumer-clone"><a class="anchor" href="#getting-started-cdc-consumer-clone"></a><a class="link" href="#getting-started-cdc-consumer-clone">Clone the Fraud Detection service repository locally</a></h5>
+<div class="paragraph">
+<p>You can start by playing around with the server side contract. To do so, you must first
+clone it, by running the following command:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ git clone https://your-git-server.com/server-side.git local-http-server-repo</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="getting-started-cdc-consumer-define"><a class="anchor" href="#getting-started-cdc-consumer-define"></a><a class="link" href="#getting-started-cdc-consumer-define">Define the Contract Locally in the Repository of the Fraud Detection Service</a></h5>
+<div class="paragraph">
+<p>As a consumer, you need to define what exactly you want to achieve. You need to formulate
+your expectations. To do so, write the following contract:</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Place the contract in the <code>src/test/resources/contracts/fraud</code> folder. The <code>fraud</code> folder
+is important because the producer&#8217;s test base class name references that folder.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following example shows our contract, in both Groovy and YAML:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">/*
+ * Copyright 2013-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package contracts
+
+org.springframework.cloud.contract.spec.Contract.make {
+    request { // (1)
+        method 'PUT' // (2)
+        url '/fraudcheck' // (3)
+        body([ // (4)
+               "client.id": $(regex('[0-9]{10}')),
+               loanAmount : 99999
+        ])
+        headers { // (5)
+            contentType('application/json')
+        }
+    }
+    response { // (6)
+        status OK() // (7)
+        body([ // (8)
+               fraudCheckStatus  : "FRAUD",
+               "rejection.reason": "Amount too high"
+        ])
+        headers { // (9)
+            contentType('application/json')
+        }
+    }
+}
+
+/*
+From the Consumer perspective, when shooting a request in the integration test:
+
+(1) - If the consumer sends a request
+(2) - With the "PUT" method
+(3) - to the URL "/fraudcheck"
+(4) - with the JSON body that
+ * has a field `client.id` that matches a regular expression `[0-9]{10}`
+ * has a field `loanAmount` that is equal to `99999`
+(5) - with header `Content-Type` equal to `application/json`
+(6) - then the response will be sent with
+(7) - status equal `200`
+(8) - and JSON body equal to
+ { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+(9) - with header `Content-Type` equal to `application/json`
+
+From the Producer perspective, in the autogenerated producer-side test:
+
+(1) - A request will be sent to the producer
+(2) - With the "PUT" method
+(3) - to the URL "/fraudcheck"
+(4) - with the JSON body that
+ * has a field `client.id` that will have a generated value that matches a regular expression `[0-9]{10}`
+ * has a field `loanAmount` that is equal to `99999`
+(5) - with header `Content-Type` equal to `application/json`
+(6) - then the test will assert if the response has been sent with
+(7) - status equal `200`
+(8) - and JSON body equal to
+ { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+(9) - with header `Content-Type` matching `application/json.*`
+ */</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yaml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">request: # (1)
+  method: PUT # (2)
+  url: /fraudcheck # (3)
+  body: # (4)
+    "client.id": 1234567890
+    loanAmount: 99999
+  headers: # (5)
+    Content-Type: application/json
+  matchers:
+    body:
+      - path: $.['client.id'] # (6)
+        type: by_regex
+        value: "[0-9]{10}"
+response: # (7)
+  status: 200 # (8)
+  body:  # (9)
+    fraudCheckStatus: "FRAUD"
+    "rejection.reason": "Amount too high"
+  headers: # (10)
+    Content-Type: application/json
+
+
+#From the Consumer perspective, when shooting a request in the integration test:
+#
+#(1) - If the consumer sends a request
+#(2) - With the "PUT" method
+#(3) - to the URL "/fraudcheck"
+#(4) - with the JSON body that
+# * has a field `client.id`
+# * has a field `loanAmount` that is equal to `99999`
+#(5) - with header `Content-Type` equal to `application/json`
+#(6) - and a `client.id` json entry matches the regular expression `[0-9]{10}`
+#(7) - then the response will be sent with
+#(8) - status equal `200`
+#(9) - and JSON body equal to
+# { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+#(10) - with header `Content-Type` equal to `application/json`
+#
+#From the Producer perspective, in the autogenerated producer-side test:
+#
+#(1) - A request will be sent to the producer
+#(2) - With the "PUT" method
+#(3) - to the URL "/fraudcheck"
+#(4) - with the JSON body that
+# * has a field `client.id` `1234567890`
+# * has a field `loanAmount` that is equal to `99999`
+#(5) - with header `Content-Type` equal to `application/json`
+#(7) - then the test will assert if the response has been sent with
+#(8) - status equal `200`
+#(9) - and JSON body equal to
+# { "fraudCheckStatus": "FRAUD", "rejectionReason": "Amount too high" }
+#(10) - with header `Content-Type` equal to `application/json`</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The YML contract is quite straightforward. However, when you take a look at the Contract
+written with a statically typed Groovy DSL, you might wonder what the
+<code>value(client(&#8230;&#8203;), server(&#8230;&#8203;))</code> parts are. By using this notation, Spring Cloud
+Contract lets you define parts of a JSON block, a URL, or other structure that is dynamic. In case
+of an identifier or a timestamp, you need not hardcode a value. You want to allow some
+different ranges of values. To enable ranges of values, you can set regular expressions
+that match those values for the consumer side. You can provide the body by means of either
+a map notation or String with interpolations. We highly recommend using the map notation.</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+You must understand the map notation in order to set up contracts. See the
+<a href="https://groovy-lang.org/json.html">Groovy docs regarding JSON</a>.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The previously shown contract is an agreement between two sides that:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>If an HTTP request is sent with all of</p>
+<div class="ulist">
+<ul>
+<li>
+<p>A <code>PUT</code> method on the <code>/fraudcheck</code> endpoint</p>
+</li>
+<li>
+<p>A JSON body with a <code>client.id</code> that matches the regular expression <code>[0-9]{10}</code> and
+<code>loanAmount</code> equal to <code>99999</code>,</p>
+</li>
+<li>
+<p>A <code>Content-Type</code> header with a value of <code>application/vnd.fraud.v1+json</code></p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Then an HTTP response is sent to the consumer that</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Has status <code>200</code></p>
+</li>
+<li>
+<p>Contains a JSON body with the <code>fraudCheckStatus</code> field containing a value of <code>FRAUD</code> and
+the <code>rejectionReason</code> field having a value of <code>Amount too high</code></p>
+</li>
+<li>
+<p>Has a <code>Content-Type</code> header with a value of <code>application/vnd.fraud.v1+json</code></p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Once you are ready to check the API in practice in the integration tests, you need to
+install the stubs locally.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="getting-started-cdc-consumer-add"><a class="anchor" href="#getting-started-cdc-consumer-add"></a><a class="link" href="#getting-started-cdc-consumer-add">Add the Spring Cloud Contract Verifier Plugin</a></h5>
+<div class="paragraph">
+<p>We can add either a Maven or a Gradle plugin. In this example, we show how to add Maven.
+First, we add the <code>Spring Cloud Contract</code> BOM, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependencyManagement&gt;
+    &lt;dependencies&gt;
+        &lt;dependency&gt;
+            &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+            &lt;artifactId&gt;spring-cloud-dependencies&lt;/artifactId&gt;
+            &lt;version&gt;${spring-cloud-release.version}&lt;/version&gt;
+            &lt;type&gt;pom&lt;/type&gt;
+            &lt;scope&gt;import&lt;/scope&gt;
+        &lt;/dependency&gt;
+    &lt;/dependencies&gt;
+&lt;/dependencyManagement&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Next, add the <code>Spring Cloud Contract Verifier</code> Maven plugin, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;packageWithBaseClasses&gt;com.example.fraud&lt;/packageWithBaseClasses&gt;
+        &lt;convertToYaml&gt;true&lt;/convertToYaml&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Since the plugin was added, you get the <code>Spring Cloud Contract Verifier</code> features, which,
+from the provided contracts:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Generate and run tests</p>
+</li>
+<li>
+<p>Produce and install stubs</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>You do not want to generate tests, since you, as the consumer, want only to play with the
+stubs. You need to skip the test generation and execution. To do so, run the following commands:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ cd local-http-server-repo
+$ ./mvnw clean install -DskipTests</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Once you run those commands, you should you see something like the following content in the logs:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">[INFO] --- spring-cloud-contract-maven-plugin:1.0.0.BUILD-SNAPSHOT:generateStubs (default-generateStubs) @ http-server ---
+[INFO] Building jar: /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar
+[INFO]
+[INFO] --- maven-jar-plugin:2.6:jar (default-jar) @ http-server ---
+[INFO] Building jar: /some/path/http-server/target/http-server-0.0.1-SNAPSHOT.jar
+[INFO]
+[INFO] --- spring-boot-maven-plugin:1.5.5.BUILD-SNAPSHOT:repackage (default) @ http-server ---
+[INFO]
+[INFO] --- maven-install-plugin:2.5.2:install (default-install) @ http-server ---
+[INFO] Installing /some/path/http-server/target/http-server-0.0.1-SNAPSHOT.jar to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT.jar
+[INFO] Installing /some/path/http-server/pom.xml to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT.pom
+[INFO] Installing /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following line is extremely important:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">[INFO] Installing /some/path/http-server/target/http-server-0.0.1-SNAPSHOT-stubs.jar to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>It confirms that the stubs of the <code>http-server</code> have been installed in the local
+repository.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="getting-started-cdc-consumer-run"><a class="anchor" href="#getting-started-cdc-consumer-run"></a><a class="link" href="#getting-started-cdc-consumer-run">Running the Integration Tests</a></h5>
+<div class="paragraph">
+<p>In order to profit from the Spring Cloud Contract Stub Runner functionality of automatic
+stub downloading, you must do the following in your consumer side project (<code>Loan
+Application service</code>):</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Add the <code>Spring Cloud Contract</code> BOM, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependencyManagement&gt;
+    &lt;dependencies&gt;
+        &lt;dependency&gt;
+            &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+            &lt;artifactId&gt;spring-cloud-dependencies&lt;/artifactId&gt;
+            &lt;version&gt;${spring-cloud-release-train.version}&lt;/version&gt;
+            &lt;type&gt;pom&lt;/type&gt;
+            &lt;scope&gt;import&lt;/scope&gt;
+        &lt;/dependency&gt;
+    &lt;/dependencies&gt;
+&lt;/dependencyManagement&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Add the dependency to <code>Spring Cloud Contract Stub Runner</code>, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-starter-contract-stub-runner&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Annotate your test class with <code>@AutoConfigureStubRunner</code>. In the annotation, provide the
+<code>group-id</code> and <code>artifact-id</code> for the Stub Runner to download the stubs of your
+collaborators. (Optional step) Because you are playing with the collaborators offline, you
+can also provide the offline work switch (<code>StubRunnerProperties.StubsMode.LOCAL</code>).</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment = WebEnvironment.NONE)
+@AutoConfigureStubRunner(ids = {
+        "com.example:http-server-dsl:+:stubs:6565" }, stubsMode = StubRunnerProperties.StubsMode.LOCAL)
+public class LoanApplicationServiceTests {</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Now, when you run your tests, you see something like the following output in the logs:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">2016-07-19 14:22:25.403  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Desired version is + - will try to resolve the latest version
+2016-07-19 14:22:25.438  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolved version is 0.0.1-SNAPSHOT
+2016-07-19 14:22:25.439  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolving artifact com.example:http-server:jar:stubs:0.0.1-SNAPSHOT using remote repositories []
+2016-07-19 14:22:25.451  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Resolved artifact com.example:http-server:jar:stubs:0.0.1-SNAPSHOT to /path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar
+2016-07-19 14:22:25.465  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Unpacking stub from JAR [URI: file:/path/to/your/.m2/repository/com/example/http-server/0.0.1-SNAPSHOT/http-server-0.0.1-SNAPSHOT-stubs.jar]
+2016-07-19 14:22:25.475  INFO 41050 --- [           main] o.s.c.c.stubrunner.AetherStubDownloader  : Unpacked file to [/var/folders/0p/xwq47sq106x1_g3dtv6qfm940000gq/T/contracts100276532569594265]
+2016-07-19 14:22:27.737  INFO 41050 --- [           main] o.s.c.c.stubrunner.StubRunnerExecutor    : All stubs are now running RunningStubs [namesAndPorts={com.example:http-server:0.0.1-SNAPSHOT:stubs=8080}]</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>This output means that Stub Runner has found your stubs and started a server for your application
+with a group ID of <code>com.example</code> and an artifact ID of <code>http-server</code> with version <code>0.0.1-SNAPSHOT</code> of
+the stubs and with the <code>stubs</code> classifier on port <code>8080</code>.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="getting-started-cdc-consumer-file"><a class="anchor" href="#getting-started-cdc-consumer-file"></a><a class="link" href="#getting-started-cdc-consumer-file">Filing a Pull Request</a></h5>
+<div class="paragraph">
+<p>What you have done until now is an iterative process. You can play around with the
+contract, install it locally, and work on the consumer side until the contract works as
+you wish.</p>
+</div>
+<div class="paragraph">
+<p>Once you are satisfied with the results and the test passes, you can publish a pull request to
+the server side. Currently, the consumer side work is done.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-cdc-producer"><a class="anchor" href="#getting-started-cdc-producer"></a><a class="link" href="#getting-started-cdc-producer">2.4.3. The Producer Side (Fraud Detection server)</a></h4>
+<div class="paragraph">
+<p>As a developer of the Fraud Detection server (a server to the Loan Issuance service), you
+might want to do the following</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Take over the pull request</p>
+</li>
+<li>
+<p>Write the missing implementation</p>
+</li>
+<li>
+<p>Deploy the application</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The following UML diagram shows the fraud detection flow:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/getting-started-cdc-server.png" alt="getting started cdc server" width="688" height="903">
+</div>
+</div>
+<div class="sect4">
+<h5 id="getting-started-cdc-producer-pr"><a class="anchor" href="#getting-started-cdc-producer-pr"></a><a class="link" href="#getting-started-cdc-producer-pr">Taking over the Pull Request</a></h5>
+<div class="paragraph">
+<p>As a reminder, the following listing shows the initial implementation:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RequestMapping(value = "/fraudcheck", method = PUT)
+public FraudCheckResult fraudCheck(@RequestBody FraudCheck fraudCheck) {
+return new FraudCheckResult(FraudCheckStatus.OK, NO_REASON);
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Then you can run the following commands:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ git checkout -b contract-change-pr master
+$ git pull https://your-git-server.com/server-side-fork.git contract-change-pr</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You must add the dependencies needed by the autogenerated tests, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-starter-contract-verifier&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In the configuration of the Maven plugin, you must pass the <code>packageWithBaseClasses</code> property, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;packageWithBaseClasses&gt;com.example.fraud&lt;/packageWithBaseClasses&gt;
+        &lt;convertToYaml&gt;true&lt;/convertToYaml&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+This example uses &#8220;convention-based&#8221; naming by setting the
+<code>packageWithBaseClasses</code> property. Doing so means that the two last packages combine to
+make the name of the base test class. In our case, the contracts were placed under
+<code>src/test/resources/contracts/fraud</code>. Since you do not have two packages starting from
+the <code>contracts</code> folder, pick only one, which should be <code>fraud</code>. Add the <code>Base</code> suffix and
+capitalize <code>fraud</code>. That gives you the <code>FraudBase</code> test class name.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>All the generated tests extend that class. Over there, you can set up your Spring Context
+or whatever is necessary. In this case, you should use <a href="https://github.com/rest-assured/rest-assured">Rest Assured MVC</a> to
+start the server side <code>FraudDetectionController</code>. The following listing shows the
+<code>FraudBase</code> class:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">/*
+ * Copyright 2013-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.fraud;
+
+import io.restassured.module.mockmvc.RestAssuredMockMvc;
+import org.junit.Before;
+
+public class FraudBase {
+
+    @Before
+    public void setup() {
+        RestAssuredMockMvc.standaloneSetup(new FraudDetectionController(),
+                new FraudStatsController(stubbedStatsProvider()));
+    }
+
+    private StatsProvider stubbedStatsProvider() {
+        return fraudType -&gt; {
+            switch (fraudType) {
+            case DRUNKS:
+                return 100;
+            case ALL:
+                return 200;
+            }
+            return 0;
+        };
+    }
+
+    public void assertThatRejectionReasonIsNull(Object rejectionReason) {
+        assert rejectionReason == null;
+    }
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Now, if you run the <code>./mvnw clean install</code>, you get something like the following output:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">Results :
+
+Tests in error:
+  ContractVerifierTest.validate_shouldMarkClientAsFraud:32 » IllegalState Parsed...</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>This error occurs because you have a new contract from which a test was generated and it
+failed since you have not implemented the feature. The auto-generated test would look
+like the following test method:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
+public void validate_shouldMarkClientAsFraud() throws Exception {
+    // given:
+        MockMvcRequestSpecification request = given()
+                .header("Content-Type", "application/vnd.fraud.v1+json")
+                .body("{\"client.id\":\"1234567890\",\"loanAmount\":99999}");
+
+    // when:
+        ResponseOptions response = given().spec(request)
+                .put("/fraudcheck");
+
+    // then:
+        assertThat(response.statusCode()).isEqualTo(200);
+        assertThat(response.header("Content-Type")).matches("application/vnd.fraud.v1.json.*");
+    // and:
+        DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
+        assertThatJson(parsedJson).field("['fraudCheckStatus']").matches("[A-Z]{5}");
+        assertThatJson(parsedJson).field("['rejection.reason']").isEqualTo("Amount too high");
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>If you used the Groovy DSL, you can see that all of the <code>producer()</code> parts of the Contract that were present in the
+<code>value(consumer(&#8230;&#8203;), producer(&#8230;&#8203;))</code> blocks got injected into the test.
+In case of using YAML, the same applied for the <code>matchers</code> sections of the <code>response</code>.</p>
+</div>
+<div class="paragraph">
+<p>Note that, on the producer side, you are also doing TDD. The expectations are expressed
+in the form of a test. This test sends a request to our own application with the URL,
+headers, and body defined in the contract. It is also expecting precisely defined values
+in the response. In other words, you have the <code>red</code> part of <code>red</code>, <code>green</code>, and
+<code>refactor</code>. It is time to convert the <code>red</code> into the <code>green</code>.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="getting-started-cdc-producer-impl"><a class="anchor" href="#getting-started-cdc-producer-impl"></a><a class="link" href="#getting-started-cdc-producer-impl">Write the Missing Implementation</a></h5>
+<div class="paragraph">
+<p>Because you know the expected input and expected output, you can write the missing
+implementation as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RequestMapping(value = "/fraudcheck", method = PUT)
+public FraudCheckResult fraudCheck(@RequestBody FraudCheck fraudCheck) {
+if (amountGreaterThanThreshold(fraudCheck)) {
+    return new FraudCheckResult(FraudCheckStatus.FRAUD, AMOUNT_TOO_HIGH);
+}
+return new FraudCheckResult(FraudCheckStatus.OK, NO_REASON);
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>When you run <code>./mvnw clean install</code> again, the tests pass. Since the <code>Spring Cloud
+Contract Verifier</code> plugin adds the tests to the <code>generated-test-sources</code>, you can
+actually run those tests from your IDE.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="getting-started-cdc-producer-deploy"><a class="anchor" href="#getting-started-cdc-producer-deploy"></a><a class="link" href="#getting-started-cdc-producer-deploy">Deploying Your Application</a></h5>
+<div class="paragraph">
+<p>Once you finish your work, you can deploy your changes. To do so, you must first merge the
+branch by running the following commands:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ git checkout master
+$ git merge --no-ff contract-change-pr
+$ git push origin master</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Your CI might run something a command such as <code>./mvnw clean deploy</code>, which would publish both the
+application and the stub artifacts.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="getting-started-cdc-consumer-final"><a class="anchor" href="#getting-started-cdc-consumer-final"></a><a class="link" href="#getting-started-cdc-consumer-final">2.4.4. Consumer Side (Loan Issuance), Final Step</a></h4>
+<div class="paragraph">
+<p>As a developer of the loan issuance service (a consumer of the Fraud Detection server), I want to:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Merge our feature branch to <code>master</code></p>
+</li>
+<li>
+<p>Switch to online mode of working</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The following UML diagram shows the final state of the process:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/getting-started-cdc-client-final.png" alt="getting started cdc client final" width="590" height="685">
+</div>
+</div>
+<div class="sect4">
+<h5 id="getting-started-cdc-consumer-final-merge"><a class="anchor" href="#getting-started-cdc-consumer-final-merge"></a><a class="link" href="#getting-started-cdc-consumer-final-merge">Merging a Branch to Master</a></h5>
+<div class="paragraph">
+<p>The following commands show one way to merge a branch into master with Git:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ git checkout master
+$ git merge --no-ff contract-change-pr</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="getting-started-cdc-consumer-final-online"><a class="anchor" href="#getting-started-cdc-consumer-final-online"></a><a class="link" href="#getting-started-cdc-consumer-final-online">Working Online</a></h5>
+<div class="paragraph">
+<p>Now you can disable the offline work for Spring Cloud Contract Stub Runner and indicate
+where the repository with your stubs is located. At this moment, the stubs of the server
+side are automatically downloaded from Nexus/Artifactory. You can set the value of
+<code>stubsMode</code> to <code>REMOTE</code>. The following code shows an example of
+achieving the same thing by changing the properties:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">stubrunner:
+  ids: 'com.example:http-server-dsl:+:stubs:8080'
+  repositoryRoot: https://repo.spring.io/libs-snapshot</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>That&#8217;s it. You have finished the tutorial.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="getting-started-whats-next"><a class="anchor" href="#getting-started-whats-next"></a><a class="link" href="#getting-started-whats-next">2.5. Next Steps</a></h3>
+<div class="paragraph">
+<p>Hopefully, this section provided some of the Spring Cloud Contract basics and got you on your way
+to writing your own applications. If you are a task-oriented type of developer, you might
+want to jump over to <a href="https://spring.io" class="bare">spring.io</a> and check out some of the
+<a href="https://spring.io/guides/">getting started</a> guides that solve specific &#8220;How do I do that
+with Spring?&#8221; problems. We also have Spring Cloud Contract-specific
+&#8220;<a href="#howto">how-to</a>&#8221; reference documentation.</p>
+</div>
+<div class="paragraph">
+<p>Otherwise, the next logical step is to read <a href="#using">Using Spring Cloud Contract</a>. If
+you are really impatient, you could also jump ahead and read about
+<a href="#project-features">Spring Cloud Contract features</a>.</p>
+</div>
+<div class="paragraph">
+<p>In addition to that you can check out the following videos:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>"Consumer Driven Contracts and Your Microservice Architecture" by Olga Maciaszek-Sharma and Marcin Grzejszczak</p>
+</li>
+</ul>
+</div>
+<div class="videoblock">
+<div class="content">
+<iframe width="640" height="480" src="https://www.youtube.com/embed/pDkC_00hhvA?rel=0" frameborder="0" allowfullscreen></iframe>
+</div>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>"Contract Tests in the Enterprise" by Marcin Grzejszczak</p>
+</li>
+</ul>
+</div>
+<div class="videoblock">
+<div class="content">
+<iframe width="640" height="480" src="https://www.youtube.com/embed/ZyHG-VOzPZg?rel=0" frameborder="0" allowfullscreen></iframe>
+</div>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>"Why Contract Tests Matter?" by Marcin Grzejszczak</p>
+</li>
+</ul>
+</div>
+<div class="videoblock">
+<div class="content">
+<iframe width="640" height="480" src="https://www.youtube.com/embed/TvpkZu1e2Dc?rel=0&amp;start=6262" frameborder="0" allowfullscreen></iframe>
+</div>
+</div>
+<div class="paragraph">
+<p>You can find the default project samples at
+<a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples">samples</a>.</p>
+</div>
+<div class="paragraph">
+<p>You can find the Spring Cloud Contract workshops <a href="https://cloud-samples.spring.io/spring-cloud-contract-samples/">here</a>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="using"><a class="anchor" href="#using"></a><a class="link" href="#using">3. Using Spring Cloud Contract</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This section goes into more detail about how you should use Spring Cloud Contract. It covers topics
+such as flows of how to work with Spring Cloud Contract. We also
+cover some Spring Cloud Contract best practices.</p>
+</div>
+<div class="paragraph">
+<p>If you are starting out with Spring Cloud Contract, you should probably read the
+<a href="#getting-started">Getting Started</a> guide before diving into this
+section.</p>
+</div>
+<div class="sect2">
+<h3 id="flows-provider-nexus"><a class="anchor" href="#flows-provider-nexus"></a><a class="link" href="#flows-provider-nexus">3.1. Provider Contract Testing with Stubs in Nexus or Artifactory</a></h3>
+<div class="paragraph">
+<p>You can check the <a href="#getting-started-first-application">Developing Your First Spring Cloud Contract based application</a> link to see the provider contract testing with stubs in the Nexus or Artifactory flow.</p>
+</div>
+<div class="paragraph">
+<p>You can also check the <a href="https://cloud-samples.spring.io/spring-cloud-contract-samples/tutorials/contracts_on_the_producer_side.html">workshop page</a> for a step-by-step instruction on how to do this flow.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="flows-provider-git"><a class="anchor" href="#flows-provider-git"></a><a class="link" href="#flows-provider-git">3.2. Provider Contract Testing with Stubs in Git</a></h3>
+<div class="paragraph">
+<p>In this flow, we perform the provider contract testing (the producer has no knowledge of how consumers use their API). The stubs are uploaded to a separate repository (they are not uploaded to Artifactory or Nexus).</p>
+</div>
+<div class="sect3">
+<h4 id="prerequisites"><a class="anchor" href="#prerequisites"></a><a class="link" href="#prerequisites">3.2.1. Prerequisites</a></h4>
+<div class="paragraph">
+<p>Before testing provider contracts with stubs in git, you must provide a git repository
+that contains all the stubs for each producer. For an example of such a project, see
+<a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x//contract_git">this samples </a> or <a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x//contract_git">this sample</a>.
+As a result of pushing stubs there, the repository has the following structure:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre>$ tree .
+└── META-INF
+   └── folder.with.group.id.as.its.name
+       └── folder-with-artifact-id
+           └── folder-with-version
+               ├── contractA.groovy
+               ├── contractB.yml
+               └── contractC.groovy</pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You must also provide consumer code that has Spring Cloud Contract Stub Runner set up. For
+an example of such a project, see <a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x//consumer">this sample</a> and search for a
+<code>BeerControllerGitTest</code> test. You must also provide producer code that has Spring Cloud
+Contract set up, together with a plugin. For an example of such a project, see
+<a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x//producer_with_empty_git">this sample</a>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="flows-provider-git-flow"><a class="anchor" href="#flows-provider-git-flow"></a><a class="link" href="#flows-provider-git-flow">3.2.2. The Flow</a></h4>
+<div class="paragraph">
+<p>The flow looks exactly as the one presented in
+<a href="#getting-started-first-application">Developing Your First Spring Cloud Contract based application</a>,
+but the <code>Stub Storage</code> implementation is a git repository.</p>
+</div>
+<div class="paragraph">
+<p>You can read more about setting up a git repository and setting consumer and producer side
+in the <a href="#how-to-use-git-as-storage">How To page</a> of the documentation.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="flows-provider-git-consumer"><a class="anchor" href="#flows-provider-git-consumer"></a><a class="link" href="#flows-provider-git-consumer">3.2.3. Consumer setup</a></h4>
+<div class="paragraph">
+<p>In order to fetch the stubs from a git repository instead of Nexus or Artifactory, you
+need to use the <code>git</code> protocol in the URL of the <code>repositoryRoot</code> property in Stub Runner.
+The following example shows how to set it up:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Annotation</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(
+stubsMode = StubRunnerProperties.StubsMode.REMOTE,
+        repositoryRoot = "git://git@github.com:spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git",
+        ids = "com.example:artifact-id:0.0.1")</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 4 Rule</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Rule
+    public StubRunnerRule rule = new StubRunnerRule()
+            .downloadStub("com.example","artifact-id", "0.0.1")
+            .repoRoot("git://git@github.com:spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE);</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 5 Extension</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RegisterExtension
+    public StubRunnerExtension stubRunnerExtension = new StubRunnerExtension()
+            .downloadStub("com.example","artifact-id", "0.0.1")
+            .repoRoot("git://git@github.com:spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE);</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="flows-provider-git-producer"><a class="anchor" href="#flows-provider-git-producer"></a><a class="link" href="#flows-provider-git-producer">3.2.4. Setting up the Producer</a></h4>
+<div class="paragraph">
+<p>In order to push the stubs to a git repository instead of Nexus or Artifactory, you need
+to use the <code>git</code> protocol in the URL of the plugin setup. Also you need to explicitly tell
+the plugin to push the stubs at the end of the build process. The following example shows
+how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;!-- Base class mappings etc. --&gt;
+
+        &lt;!-- We want to pick contracts from a Git repository --&gt;
+        &lt;contractsRepositoryUrl&gt;git://git://git@github.com:spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git&lt;/contractsRepositoryUrl&gt;
+
+        &lt;!-- We reuse the contract dependency section to set up the path
+        to the folder that contains the contract definitions. In our case the
+        path will be /groupId/artifactId/version/contracts --&gt;
+        &lt;contractDependency&gt;
+            &lt;groupId&gt;${project.groupId}&lt;/groupId&gt;
+            &lt;artifactId&gt;${project.artifactId}&lt;/artifactId&gt;
+            &lt;version&gt;${project.version}&lt;/version&gt;
+        &lt;/contractDependency&gt;
+
+        &lt;!-- The contracts mode can't be classpath --&gt;
+        &lt;contractsMode&gt;REMOTE&lt;/contractsMode&gt;
+    &lt;/configuration&gt;
+    &lt;executions&gt;
+        &lt;execution&gt;
+            &lt;phase&gt;package&lt;/phase&gt;
+            &lt;goals&gt;
+                &lt;!-- By default we will not push the stubs back to SCM,
+                you have to explicitly add it as a goal --&gt;
+                &lt;goal&gt;pushStubsToScm&lt;/goal&gt;
+            &lt;/goals&gt;
+        &lt;/execution&gt;
+    &lt;/executions&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+    // We want to pick contracts from a Git repository
+    contractDependency {
+        stringNotation = "${project.group}:${project.name}:${project.version}"
+    }
+    /*
+    We reuse the contract dependency section to set up the path
+    to the folder that contains the contract definitions. In our case the
+    path will be /groupId/artifactId/version/contracts
+     */
+    contractRepository {
+        repositoryUrl = "git://git://git@github.com:spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git"
+    }
+    // The mode can't be classpath
+    contractsMode = "REMOTE"
+    // Base class mappings etc.
+}
+
+/*
+In this scenario we want to publish stubs to SCM whenever
+the `publish` task is executed
+*/
+publish.dependsOn("publishStubsToScm")</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can read more about setting up a git repository in the
+<a href="#how-to-use-git-as-storage">How To page</a> of the documentation.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="flows-cdc-contracts-producer"><a class="anchor" href="#flows-cdc-contracts-producer"></a><a class="link" href="#flows-cdc-contracts-producer">3.3. Consumer Driven Contracts with Contracts on the Producer Side</a></h3>
+<div class="paragraph">
+<p>See <a href="#getting-started-cdc">Step-by-step Guide to Consumer Driven
+Contracts (CDC) with Contracts on the Producer Side</a> to see the Consumer Driven Contracts
+with contracts on the producer side flow.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="flows-cdc-contracts-external"><a class="anchor" href="#flows-cdc-contracts-external"></a><a class="link" href="#flows-cdc-contracts-external">3.4. Consumer Driven Contracts with Contracts in an External Repository</a></h3>
+<div class="paragraph">
+<p>In this flow, we perform Consumer Driven Contract testing. The contract definitions are
+stored in a separate repository.</p>
+</div>
+<div class="paragraph">
+<p>See the <a href="https://cloud-samples.spring.io/spring-cloud-contract-samples/tutorials/contracts_on_the_producer_side.html">workshop page</a>
+for step-by-step instructions on how to do this flow.</p>
+</div>
+<div class="sect3">
+<h4 id="prerequisites-2"><a class="anchor" href="#prerequisites-2"></a><a class="link" href="#prerequisites-2">3.4.1. Prerequisites</a></h4>
+<div class="paragraph">
+<p>To use consumer-driven contracts with the contracts held in an external repository, you need to set up a git repository that:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Contains all the contract definitions for each producer.</p>
+</li>
+<li>
+<p>Can package the contract definitions in a JAR.</p>
+</li>
+<li>
+<p>For each contract producer, contains a way (for example, <code>pom.xml</code>) to install stubs
+locally through the Spring Cloud Contract Plugin (SCC Plugin)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For more information, see the <a href="#how-to-common-repo-with-contracts">How To section</a>,
+where we describe how to set up such a repository
+For an example of such a project, see <a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x//beer_contracts">this sample</a>.</p>
+</div>
+<div class="paragraph">
+<p>You also need consumer code that has Spring Cloud Contract Stub Runner set up.
+For an example of such a project, see <a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x//consumer">this sample</a>.
+You also need producer code that has Spring Cloud Contract set up, together with a plugin.
+For an example of such a project, see <a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x//producer_with_external_contracts">this sample</a>.
+The stub storage is Nexus or Artifactory</p>
+</div>
+<div class="paragraph">
+<p>At a high level, the flow looks as follows:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>The consumer works with the contract definitions from the separate repository</p>
+</li>
+<li>
+<p>Once the consumer&#8217;s work is done, a branch with working code is done on the consumer
+side and a pull request is made to the separate repository that holds the contract definitions.</p>
+</li>
+<li>
+<p>The producer takes over the pull request to the separate repository with contract
+definitions and installs the JAR with all contracts locally.</p>
+</li>
+<li>
+<p>The producer generates tests from the locally stored JAR and writes the missing
+implementation to make the tests pass.</p>
+</li>
+<li>
+<p>Once the producer&#8217;s work is done, the pull request to the repository that holds the
+contract definitions is merged.</p>
+</li>
+<li>
+<p>After the CI tool builds the repository with the contract definitions and the JAR with
+contract definitions gets uploaded to Nexus or Artifactory, the producer can merge its branch.</p>
+</li>
+<li>
+<p>Finally, the consumer can switch to working online to fetch stubs of the producer from a
+remote location, and the branch can be merged to master.</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect3">
+<h4 id="flows-cdc-contracts-external-consumer"><a class="anchor" href="#flows-cdc-contracts-external-consumer"></a><a class="link" href="#flows-cdc-contracts-external-consumer">3.4.2. Consumer Flow</a></h4>
+<div class="paragraph">
+<p>The consumer:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Writes a test that would send a request to the producer.</p>
+<div class="paragraph">
+<p>The test fails due to no server being present.</p>
+</div>
+</li>
+<li>
+<p>Clones the repository that holds the contract definitions.</p>
+</li>
+<li>
+<p>Set up the requirements as contracts under the folder with the consumer name as a subfolder of the producer.</p>
+<div class="paragraph">
+<p>For example, for a producer named <code>producer</code> and a consumer named <code>consumer</code>, the contracts would be stored under <code>src/main/resources/contracts/producer/consumer/</code>)</p>
+</div>
+</li>
+<li>
+<p>Once the contracts are defined, installs the producer stubs to local storage, as the following example shows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre>$ cd src/main/resource/contracts/producer
+$ ./mvnw clean install</pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Sets up Spring Cloud Contract (SCC) Stub Runner in the consumer tests, to:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Fetch the producer stubs from local storage.</p>
+</li>
+<li>
+<p>Work in the stubs-per-consumer mode (this enables consumer driven contracts mode).</p>
+<div class="paragraph">
+<p>The SCC Stub Runner:</p>
+</div>
+</li>
+<li>
+<p>Fetches the producer stubs.</p>
+</li>
+<li>
+<p>Runs an in-memory HTTP server stub with the producer stubs.</p>
+</li>
+<li>
+<p>Now your test communicates with the HTTP server stub and your tests pass</p>
+</li>
+<li>
+<p>Create a pull request to the repository with contract definitions, with the new contracts for the producer</p>
+</li>
+<li>
+<p>Branch your consumer code, until the producer team has merged their code</p>
+</li>
+</ul>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The following UML diagram shows the consumer flow:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/flow-overview-consumer-cdc-external-consumer.png" alt="flow overview consumer cdc external consumer" width="886" height="676">
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="flows-cdc-contracts-external-producer"><a class="anchor" href="#flows-cdc-contracts-external-producer"></a><a class="link" href="#flows-cdc-contracts-external-producer">3.4.3. Producer Flow</a></h4>
+<div class="paragraph">
+<p>The producer:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Takes over the pull request to the repository with contract definitions. You can do it
+from the command line, as follows</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre>$ git checkout -b the_branch_with_pull_request master
+git pull https://github.com/user_id/project_name.git the_branch_with_pull_request</pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Installs the contract definitions, as follows</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre>$ ./mvnw clean install</pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Sets up the plugin to fetch the contract definitions from a JAR instead of from
+<code>src/test/resources/contracts</code>, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;!-- We want to use the JAR with contracts with the following coordinates --&gt;
+        &lt;contractDependency&gt;
+            &lt;groupId&gt;com.example&lt;/groupId&gt;
+            &lt;artifactId&gt;beer-contracts&lt;/artifactId&gt;
+        &lt;/contractDependency&gt;
+        &lt;!-- The JAR with contracts should be taken from Maven local --&gt;
+        &lt;contractsMode&gt;LOCAL&lt;/contractsMode&gt;
+        &lt;!-- ... additional configuration --&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+    // We want to use the JAR with contracts with the following coordinates
+    // group id `com.example`, artifact id `beer-contracts`, LATEST version and NO classifier
+    contractDependency {
+        stringNotation = 'com.example:beer-contracts:+:'
+    }
+    // The JAR with contracts should be taken from Maven local
+    contractsMode = "LOCAL"
+    // Additional configuration
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Runs the build to generate tests and stubs, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./mvnw clean install</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">./gradlew clean build</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Writes the missing implementation, to make the tests pass.</p>
+</li>
+<li>
+<p>Merges the pull request to the repository with contract definitions, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre>$ git commit -am "Finished the implementation to make the contract tests pass"
+$ git checkout master
+$ git merge --no-ff the_branch_with_pull_request
+$ git push origin master</pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>The CI system builds the project with the contract definitions and uploads the JAR with
+the contract definitions to Nexus or Artifactory.</p>
+</li>
+<li>
+<p>Switches to working remotely.</p>
+</li>
+<li>
+<p>Sets up the plugin so that the contract definitions are no longer taken from the local
+storage but from a remote location, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;!-- We want to use the JAR with contracts with the following coordinates --&gt;
+        &lt;contractDependency&gt;
+            &lt;groupId&gt;com.example&lt;/groupId&gt;
+            &lt;artifactId&gt;beer-contracts&lt;/artifactId&gt;
+        &lt;/contractDependency&gt;
+        &lt;!-- The JAR with contracts should be taken from a remote location --&gt;
+        &lt;contractsMode&gt;REMOTE&lt;/contractsMode&gt;
+        &lt;!-- ... additional configuration --&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+    // We want to use the JAR with contracts with the following coordinates
+    // group id `com.example`, artifact id `beer-contracts`, LATEST version and NO classifier
+    contractDependency {
+        stringNotation = 'com.example:beer-contracts:+:'
+    }
+    // The JAR with contracts should be taken from a remote location
+    contractsMode = "REMOTE"
+    // Additional configuration
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Merges the producer code with the new implementation.</p>
+</li>
+<li>
+<p>The CI system:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Builds the project</p>
+</li>
+<li>
+<p>Generates tests, stubs, and the stub JAR</p>
+</li>
+<li>
+<p>Uploads the artifact with the application and the stubs to Nexus or Artifactory.</p>
+</li>
+</ul>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The following UML diagram shows the producer process:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/flow-overview-consumer-cdc-external-producer.png" alt="flow overview consumer cdc external producer" width="1213" height="1341">
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="flows-cdc-contracts-stubs-git"><a class="anchor" href="#flows-cdc-contracts-stubs-git"></a><a class="link" href="#flows-cdc-contracts-stubs-git">3.5. Consumer Driven Contracts with Contracts on the Producer Side, Pushed to Git</a></h3>
+<div class="paragraph">
+<p>You can check <a href="#getting-started-cdc">Step-by-step Guide to Consumer Driven Contracts (CDC) with contracts laying on the producer side</a> to see the consumer driven contracts with contracts on the producer side flow.</p>
+</div>
+<div class="paragraph">
+<p>The stub storage implementation is a git repository. We describe its setup in the
+<a href="#flows-provider-git">Provider Contract Testing with Stubs in Git</a> section.</p>
+</div>
+<div class="paragraph">
+<p>You can read more about setting up a git repository for the consumer and producer sides in
+the <a href="#how-to-use-git-as-storage">How To page</a> of the documentation.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="flows-provider-non-spring"><a class="anchor" href="#flows-provider-non-spring"></a><a class="link" href="#flows-provider-non-spring">3.6. Provider Contract Testing with Stubs in Artifactory for a non-Spring Application</a></h3>
+<div class="sect3">
+<h4 id="flows-provider-non-spring-flow"><a class="anchor" href="#flows-provider-non-spring-flow"></a><a class="link" href="#flows-provider-non-spring-flow">3.6.1. The Flow</a></h4>
+<div class="paragraph">
+<p>You can check <a href="#getting-started-first-application">Developing Your First Spring Cloud Contract based application</a> to see the flow for provider contract testing with stubs in Nexus or Artifactory.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="flows-provider-non-spring-consumer"><a class="anchor" href="#flows-provider-non-spring-consumer"></a><a class="link" href="#flows-provider-non-spring-consumer">3.6.2. Setting up the Consumer</a></h4>
+<div class="paragraph">
+<p>For the consumer side, you can use a JUnit rule. That way, you need not start a Spring context. The follwoing listing shows such a rule (in JUnit4 and JUnit 5);</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">JUnit 4 Rule</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Rule
+    public StubRunnerRule rule = new StubRunnerRule()
+            .downloadStub("com.example","artifact-id", "0.0.1")
+            .repoRoot("git://git@github.com:spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE);</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 5 Extension</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Rule
+    public StubRunnerExtension stubRunnerExtension = new StubRunnerExtension()
+            .downloadStub("com.example","artifact-id", "0.0.1")
+            .repoRoot("git://git@github.com:spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE);</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="flows-provider-non-spring-producer"><a class="anchor" href="#flows-provider-non-spring-producer"></a><a class="link" href="#flows-provider-non-spring-producer">3.6.3. Setting up the Producer</a></h4>
+<div class="paragraph">
+<p>By default, the Spring Cloud Contract Plugin uses Rest Assured&#8217;s <code>MockMvc</code> setup for the
+generated tests. Since non-Spring applications do not use <code>MockMvc</code>, you can change the
+<code>testMode</code> to <code>EXPLICIT</code> to send a real request to an application bound at a specific port.</p>
+</div>
+<div class="paragraph">
+<p>In this example, we use a framework called <a href="https://javalin.io">Javalin</a> to start a
+non-Spring HTTP server.</p>
+</div>
+<div class="paragraph">
+<p>Assume that we have the following application:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package com.example.demo;
+
+import io.javalin.Javalin;
+
+public class DemoApplication {
+
+    public static void main(String[] args) {
+        new DemoApplication().run(7000);
+    }
+
+    public Javalin start(int port) {
+        return Javalin.create().start(port);
+    }
+
+    public Javalin registerGet(Javalin app) {
+        return app.get("/", ctx -&gt; ctx.result("Hello World"));
+    }
+
+    public Javalin run(int port) {
+        return registerGet(start(port));
+    }
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Given that application, we can set up the plugin to use the <code>EXPLICIT</code> mode (that is, to
+send out requests to a real port), as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;baseClassForTests&gt;com.example.demo.BaseClass&lt;/baseClassForTests&gt;
+        &lt;!-- This will setup the EXPLICIT mode for the tests --&gt;
+        &lt;testMode&gt;EXPLICIT&lt;/testMode&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+    // This will setup the EXPLICIT mode for the tests
+    testMode = "EXPLICIT"
+    baseClassForTests = "com.example.demo.BaseClass"
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The base class might resemble the following:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">import io.javalin.Javalin;
+import io.restassured.RestAssured;
+import org.junit.After;
+import org.junit.Before;
+import org.springframework.util.SocketUtils;
+
+public class BaseClass {
+
+    Javalin app;
+
+    @Before
+    public void setup() {
+        // pick a random port
+        int port = SocketUtils.findAvailableTcpPort();
+        // start the application at a random port
+        this.app = start(port);
+        // tell Rest Assured where the started application is
+        RestAssured.baseURI = "http://localhost:" + port;
+    }
+
+    @After
+    public void close() {
+        // stop the server after each test
+        this.app.stop();
+    }
+
+    private Javalin start(int port) {
+        // reuse the production logic to start a server
+        return new DemoApplication().run(port);
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>With such a setup:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>We have setup the Spring Cloud Contract plugin to use the <code>EXPLICIT</code> mode to send real
+requests instead of mocked ones.</p>
+</li>
+<li>
+<p>We have defined a base class that:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Starts the HTTP server on a random port for each test.</p>
+</li>
+<li>
+<p>Sets Rest Assured to send requests to that port.</p>
+</li>
+<li>
+<p>Closes the HTTP server after each test.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="flows-provider-non-jvm"><a class="anchor" href="#flows-provider-non-jvm"></a><a class="link" href="#flows-provider-non-jvm">3.7. Provider Contract Testing with Stubs in Artifactory in a non-JVM World</a></h3>
+<div class="paragraph">
+<p>In this flow, we assume that:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The API Producer and API Consumer are non-JVM applications.</p>
+</li>
+<li>
+<p>The contract definitions are written in YAML.</p>
+</li>
+<li>
+<p>The Stub Storage is Artifactory or Nexus.</p>
+</li>
+<li>
+<p>Spring Cloud Contract Docker (SCC Docker) and Spring Cloud Contract Stub Runner Docker
+(SCC Stub Runner Docker) images are used.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>You can read more about how to use Spring Cloud Contract with Docker
+<a href="#docker-project.adoc">in this page</a>.</p>
+</div>
+<div class="paragraph">
+<p><a href="https://spring.io/blog/2018/02/13/spring-cloud-contract-in-a-polyglot-world">Here</a>, you can
+read a blog post about how to use Spring Cloud Contract in a polyglot world.</p>
+</div>
+<div class="paragraph">
+<p><a href="https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs/">Here</a>, you can find
+a sample of a NodeJS application that uses Spring Cloud Contract both as a producer and a
+consumer.</p>
+</div>
+<div class="sect3">
+<h4 id="flows-provider-non-jvm-producer"><a class="anchor" href="#flows-provider-non-jvm-producer"></a><a class="link" href="#flows-provider-non-jvm-producer">3.7.1. Producer Flow</a></h4>
+<div class="paragraph">
+<p>At a high level, the producer:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Writes contract definitions (for example, in YAML).</p>
+</li>
+<li>
+<p>Sets up the build tool to:</p>
+<div class="olist loweralpha">
+<ol class="loweralpha" type="a">
+<li>
+<p>Start the application with mocked services on a given port.</p>
+<div class="paragraph">
+<p>If mocking is not possible, you can setup the infrastructure and define tests in a stateful way.</p>
+</div>
+</li>
+<li>
+<p>Run the Spring Cloud Contract Docker image and pass the port of a running application as an environment variable.</p>
+</li>
+</ol>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The SCC Docker image:
+* Generates the tests from the attached volume.
+* Runs the tests against the running application.</p>
+</div>
+<div class="paragraph">
+<p>Upon test completion, stubs get uploaded to a stub storage site (such as Artifactory or Git).</p>
+</div>
+<div class="paragraph">
+<p>The following UML diagram shows the producer flow:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/flows-provider-non-jvm-producer.png" alt="flows provider non jvm producer" width="930" height="810">
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="flows-provider-non-jvm-consumer"><a class="anchor" href="#flows-provider-non-jvm-consumer"></a><a class="link" href="#flows-provider-non-jvm-consumer">3.7.2. Consumer Flow</a></h4>
+<div class="paragraph">
+<p>At a high level, the consumer:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Sets up the build tool to:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Start the Spring Cloud Contract Stub Runner Docker image and start the stubs.</p>
+<div class="paragraph">
+<p>The environment variables configure:</p>
+</div>
+</li>
+<li>
+<p>The stubs to fetch.</p>
+</li>
+<li>
+<p>The location of the repositories.</p>
+<div class="paragraph">
+<p>Note that:</p>
+</div>
+</li>
+<li>
+<p>To use the local storage, you can also attach it as a volume.</p>
+</li>
+<li>
+<p>The ports at which the stubs are running need to be exposed.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Run the application tests against the running stubs.</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>The following UML diagram shows the consumer flow:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/flows-provider-non-jvm-consumer.png" alt="flows provider non jvm consumer" width="815" height="618">
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="flows-provider-rest-docs"><a class="anchor" href="#flows-provider-rest-docs"></a><a class="link" href="#flows-provider-rest-docs">3.8. Provider Contract Testing with REST Docs and Stubs in Nexus or Artifactory</a></h3>
+<div class="paragraph">
+<p>In this flow, we do not use a Spring Cloud Contract plugin to generate tests and stubs. We write <a href="https://spring.io/projects/spring-restdocs">Spring RESTDocs</a> and, from them, we automatically generate stubs. Finally, we set up our builds to package the stubs and upload them to the stub storage site&#8201;&#8212;&#8201;in our case, Nexus or Artifactory.</p>
+</div>
+<div class="paragraph">
+<p>See the <a href="https://cloud-samples.spring.io/spring-cloud-contract-samples/tutorials/rest_docs.html">workshop page</a> for a step-by-step instruction on how to use this flow.</p>
+</div>
+<div class="sect3">
+<h4 id="flows-provider-rest-docs-producer"><a class="anchor" href="#flows-provider-rest-docs-producer"></a><a class="link" href="#flows-provider-rest-docs-producer">3.8.1. Producer Flow</a></h4>
+<div class="paragraph">
+<p>As a producer, we:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>We write RESTDocs tests of our API.</p>
+</li>
+<li>
+<p>We add Spring Cloud Contract Stub Runner starter to our build (<code>spring-cloud-starter-contract-stub-runner</code>), as follows</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependencies&gt;
+    &lt;dependency&gt;
+        &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+        &lt;artifactId&gt;spring-cloud-starter-contract-stub-runner&lt;/artifactId&gt;
+        &lt;scope&gt;test&lt;/scope&gt;
+    &lt;/dependency&gt;
+&lt;/dependencies&gt;
+
+&lt;dependencyManagement&gt;
+    &lt;dependencies&gt;
+        &lt;dependency&gt;
+            &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+            &lt;artifactId&gt;spring-cloud-dependencies&lt;/artifactId&gt;
+            &lt;version&gt;${spring-cloud.version}&lt;/version&gt;
+            &lt;type&gt;pom&lt;/type&gt;
+            &lt;scope&gt;import&lt;/scope&gt;
+        &lt;/dependency&gt;
+    &lt;/dependencies&gt;
+&lt;/dependencyManagement&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">dependencies {
+    testImplementation 'org.springframework.cloud:spring-cloud-starter-contract-stub-runner'
+}
+
+dependencyManagement {
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>We set up the build tool to package our stubs, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;!-- pom.xml --&gt;
+&lt;plugins&gt;
+    &lt;plugin&gt;
+        &lt;groupId&gt;org.apache.maven.plugins&lt;/groupId&gt;
+        &lt;artifactId&gt;maven-assembly-plugin&lt;/artifactId&gt;
+        &lt;executions&gt;
+            &lt;execution&gt;
+                &lt;id&gt;stub&lt;/id&gt;
+                &lt;phase&gt;prepare-package&lt;/phase&gt;
+                &lt;goals&gt;
+                    &lt;goal&gt;single&lt;/goal&gt;
+                &lt;/goals&gt;
+                &lt;inherited&gt;false&lt;/inherited&gt;
+                &lt;configuration&gt;
+                    &lt;attach&gt;true&lt;/attach&gt;
+                    &lt;descriptors&gt;
+                        ${basedir}/src/assembly/stub.xml
+                    &lt;/descriptors&gt;
+                &lt;/configuration&gt;
+            &lt;/execution&gt;
+        &lt;/executions&gt;
+    &lt;/plugin&gt;
+&lt;/plugins&gt;
+
+&lt;!-- src/assembly/stub.xml --&gt;
+&lt;assembly
+    xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 http://maven.apache.org/xsd/assembly-1.1.3.xsd"&gt;
+    &lt;id&gt;stubs&lt;/id&gt;
+    &lt;formats&gt;
+        &lt;format&gt;jar&lt;/format&gt;
+    &lt;/formats&gt;
+    &lt;includeBaseDirectory&gt;false&lt;/includeBaseDirectory&gt;
+    &lt;fileSets&gt;
+        &lt;fileSet&gt;
+            &lt;directory&gt;${project.build.directory}/generated-snippets/stubs&lt;/directory&gt;
+            &lt;outputDirectory&gt;META-INF/${project.groupId}/${project.artifactId}/${project.version}/mappings&lt;/outputDirectory&gt;
+            &lt;includes&gt;
+                &lt;include&gt;**/*&lt;/include&gt;
+            &lt;/includes&gt;
+        &lt;/fileSet&gt;
+    &lt;/fileSets&gt;
+&lt;/assembly&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">task stubsJar(type: Jar) {
+    classifier = "stubs"
+    into("META-INF/${project.group}/${project.name}/${project.version}/mappings") {
+        include('**/*.*')
+        from("${project.buildDir}/generated-snippets/stubs")
+    }
+}
+// we need the tests to pass to build the stub jar
+stubsJar.dependsOn(test)
+bootJar.dependsOn(stubsJar)</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>Now, when we run the tests, stubs are automatically published and packaged.</p>
+</div>
+<div class="paragraph">
+<p>The following UML diagram shows the producer flow:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/flows-provider-rest-docs-producer.png" alt="flows provider rest docs producer" width="783" height="677">
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="flows-provider-rest-docs-consumer"><a class="anchor" href="#flows-provider-rest-docs-consumer"></a><a class="link" href="#flows-provider-rest-docs-consumer">3.8.2. Consumer Flow</a></h4>
+<div class="paragraph">
+<p>Since the consumer flow is not affected by the tool used to generate the stubs, you can check <a href="#getting-started-first-application-consumer">Developing Your First Spring Cloud Contract based application</a> to see the flow for consumer side of the provider contract testing with stubs in Nexus or Artifactory.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="using-whats-next"><a class="anchor" href="#using-whats-next"></a><a class="link" href="#using-whats-next">3.9. What to Read Next</a></h3>
+<div class="paragraph">
+<p>You should now understand how you can use Spring Cloud Contract and some best practices that you
+should follow. You can now go on to learn about specific
+<a href="#project-features">Spring Cloud Contract features</a>, or you could
+skip ahead and read about the <a href="advanced.html">advanced features of Spring Cloud Contract</a>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="features"><a class="anchor" href="#features"></a><a class="link" href="#features">4. Spring Cloud Contract Features</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This section dives into the details of Spring Cloud Contract. Here you can learn about the key
+features that you may want to use and customize. If you have not already done so, you
+might want to read the "<a href="#getting-started">Getting Started</a>" and
+"<a href="#using">Using Spring Cloud Contract</a>" sections, so that you have a good grounding of the
+basics.</p>
+</div>
+<div class="sect2">
+<h3 id="contract-dsl"><a class="anchor" href="#contract-dsl"></a><a class="link" href="#contract-dsl">4.1. Contract DSL</a></h3>
+<div class="paragraph">
+<p>Spring Cloud Contract supports the DSLs written in the following languages:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Groovy</p>
+</li>
+<li>
+<p>YAML</p>
+</li>
+</ul>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+If you are not familiar with Groovy, do not worry - you can use Java syntax in the
+Groovy DSL files as well.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>If you decide to write the contract in Groovy, do not be alarmed if you have not used Groovy
+before. Knowledge of the language is not really needed, as the Contract DSL uses only a
+tiny subset of it (only literals, method calls, and closures). Also, the DSL is statically
+typed, to make it programmer-readable without any knowledge of the DSL itself.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Remember that, inside the Groovy contract file, you have to provide the fully
+qualified name to the <code>Contract</code> class and <code>make</code> static imports, such as
+<code>org.springframework.cloud.spec.Contract.make { &#8230;&#8203; }</code>. You can also provide an import to
+the <code>Contract</code> class (<code>import org.springframework.cloud.spec.Contract</code>) and then call
+<code>Contract.make { &#8230;&#8203; }</code>.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+Spring Cloud Contract supports defining multiple contracts in a single file.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following example shows a contract definition:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method 'PUT'
+        url '/api/12'
+        headers {
+            header 'Content-Type': 'application/vnd.org.springframework.cloud.contract.verifier.twitter-places-analyzer.v1+json'
+        }
+        body '''\
+    [{
+        "created_at": "Sat Jul 26 09:38:57 +0000 2014",
+        "id": 492967299297845248,
+        "id_str": "492967299297845248",
+        "text": "Gonna see you at Warsaw",
+        "place":
+        {
+            "attributes":{},
+            "bounding_box":
+            {
+                "coordinates":
+                    [[
+                        [-77.119759,38.791645],
+                        [-76.909393,38.791645],
+                        [-76.909393,38.995548],
+                        [-77.119759,38.995548]
+                    ]],
+                "type":"Polygon"
+            },
+            "country":"United States",
+            "country_code":"US",
+            "full_name":"Washington, DC",
+            "id":"01fbe706f872cb32",
+            "name":"Washington",
+            "place_type":"city",
+            "url": "https://api.twitter.com/1/geo/id/01fbe706f872cb32.json"
+        }
+    }]
+'''
+    }
+    response {
+        status OK()
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">description: Some description
+name: some name
+priority: 8
+ignored: true
+request:
+  url: /foo
+  queryParameters:
+    a: b
+    b: c
+  method: PUT
+  headers:
+    foo: bar
+    fooReq: baz
+  body:
+    foo: bar
+  matchers:
+    body:
+      - path: $.foo
+        type: by_regex
+        value: bar
+    headers:
+      - key: foo
+        regex: bar
+response:
+  status: 200
+  headers:
+    foo2: bar
+    foo3: foo33
+    fooRes: baz
+  body:
+    foo2: bar
+    foo3: baz
+    nullValue: null
+  matchers:
+    body:
+      - path: $.foo2
+        type: by_regex
+        value: bar
+      - path: $.foo3
+        type: by_command
+        value: executeMe($it)
+      - path: $.nullValue
+        type: by_null
+        value: null
+    headers:
+      - key: foo2
+        regex: bar
+      - key: foo3
+        command: andMeToo($it)</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>You can compile contracts to stubs mapping by using  the following standalone Maven command:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>mvn org.springframework.cloud:spring-cloud-contract-maven-plugin:convert</pre>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="sect3">
+<h4 id="contract-limitations"><a class="anchor" href="#contract-limitations"></a><a class="link" href="#contract-limitations">4.1.1. Limitations</a></h4>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title="Warning"></i>
+</td>
+<td class="content">
+The support for verifying the size of JSON arrays is experimental. If you want
+to turn it on, set the value of the following system property to <code>true</code>:
+<code>spring.cloud.contract.verifier.assert.size</code>. By default, this feature is set to <code>false</code>.
+You can also set the <code>assertJsonSize</code> property in the plugin configuration.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title="Warning"></i>
+</td>
+<td class="content">
+Because JSON structure can have any form, it can be impossible to parse it
+properly when using the Groovy DSL and the <code>value(consumer(&#8230;&#8203;), producer(&#8230;&#8203;))</code> notation in <code>GString</code>. That
+is why you should use the Groovy Map notation.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-common-top-elements"><a class="anchor" href="#contract-common-top-elements"></a><a class="link" href="#contract-common-top-elements">4.1.2. Common Top-Level Elements</a></h4>
+<div class="paragraph">
+<p>The following sections describe the most common top-level elements:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#contract-dsl-description">Description</a></p>
+</li>
+<li>
+<p><a href="#contract-dsl-name">Name</a></p>
+</li>
+<li>
+<p><a href="#contract-dsl-ignoring-contracts">Ignoring Contracts</a></p>
+</li>
+<li>
+<p><a href="#contract-dsl-in-progress">Contracts in Progress</a></p>
+</li>
+<li>
+<p><a href="#contract-dsl-passing-values-from-files">Passing Values from Files</a></p>
+</li>
+</ul>
+</div>
+<div class="sect4">
+<h5 id="contract-dsl-description"><a class="anchor" href="#contract-dsl-description"></a><a class="link" href="#contract-dsl-description">Description</a></h5>
+<div class="paragraph">
+<p>You can add a <code>description</code> to your contract. The description is arbitrary text. The
+following code shows an example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">            org.springframework.cloud.contract.spec.Contract.make {
+                description('''
+given:
+    An input
+when:
+    Sth happens
+then:
+    Output
+''')
+            }</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">description: Some description
+name: some name
+priority: 8
+ignored: true
+request:
+  url: /foo
+  queryParameters:
+    a: b
+    b: c
+  method: PUT
+  headers:
+    foo: bar
+    fooReq: baz
+  body:
+    foo: bar
+  matchers:
+    body:
+      - path: $.foo
+        type: by_regex
+        value: bar
+    headers:
+      - key: foo
+        regex: bar
+response:
+  status: 200
+  headers:
+    foo2: bar
+    foo3: foo33
+    fooRes: baz
+  body:
+    foo2: bar
+    foo3: baz
+    nullValue: null
+  matchers:
+    body:
+      - path: $.foo2
+        type: by_regex
+        value: bar
+      - path: $.foo3
+        type: by_command
+        value: executeMe($it)
+      - path: $.nullValue
+        type: by_null
+        value: null
+    headers:
+      - key: foo2
+        regex: bar
+      - key: foo3
+        command: andMeToo($it)</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="contract-dsl-name"><a class="anchor" href="#contract-dsl-name"></a><a class="link" href="#contract-dsl-name">Name</a></h5>
+<div class="paragraph">
+<p>You can provide a name for your contract. Assume that you provided the following name:
+<code>should register a user</code>. If you do so, the name of the autogenerated test is
+<code>validate_should_register_a_user</code>. Also, the name of the stub in a WireMock stub is
+<code>should_register_a_user.json</code>.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+You must ensure that the name does not contain any characters that make the
+generated test not compile. Also, remember that, if you provide the same name for
+multiple contracts, your autogenerated tests fail to compile and your generated stubs
+override each other.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following example shows how to add a name to a contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    name("some_special_name")
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">name: some name</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="contract-dsl-ignoring-contracts"><a class="anchor" href="#contract-dsl-ignoring-contracts"></a><a class="link" href="#contract-dsl-ignoring-contracts">Ignoring Contracts</a></h5>
+<div class="paragraph">
+<p>If you want to ignore a contract, you can either set a value for ignored contracts in the
+plugin configuration or set the <code>ignored</code> property on the contract itself. The following
+example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    ignored()
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">ignored: true</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="contract-dsl-in-progress"><a class="anchor" href="#contract-dsl-in-progress"></a><a class="link" href="#contract-dsl-in-progress">Contracts in Progress</a></h5>
+<div class="paragraph">
+<p>A contract in progress will not generate tests on the producer side, but will allow generation of stubs.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Use this feature with caution as it may lead to false positives. You generate stubs for your consumers to use without actually having the implementation in place!
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>If you want to set a contract in progress the following
+example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    inProgress()
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">inProgress: true</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="contract-dsl-passing-values-from-files"><a class="anchor" href="#contract-dsl-passing-values-from-files"></a><a class="link" href="#contract-dsl-passing-values-from-files">Passing Values from Files</a></h5>
+<div class="paragraph">
+<p>Starting with version <code>1.2.0</code>, you can pass values from files. Assume that you have the
+following resources in your project:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── src
+    └── test
+        └── resources
+            └── contracts
+                ├── readFromFile.groovy
+                ├── request.json
+                └── response.json</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Further assume that your contract is as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">/*
+ * Copyright 2013-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import org.springframework.cloud.contract.spec.Contract
+
+Contract.make {
+    request {
+        method('PUT')
+        headers {
+            contentType(applicationJson())
+        }
+        body(file("request.json"))
+        url("/1")
+    }
+    response {
+        status OK()
+        body(file("response.json"))
+        headers {
+            contentType(applicationJson())
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">request:
+  method: GET
+  url: /foo
+  bodyFromFile: request.json
+response:
+  status: 200
+  bodyFromFile: response.json</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Further assume that the JSON files is as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">request.json</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+  "status": "REQUEST"
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">response.json</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">{
+  "status": "RESPONSE"
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>When test or stub generation takes place, the contents of the <code>request.json</code> and <code>response.json</code> files are passed to the body
+of a request or a response. The name of the file needs to be a file with location
+relative to the folder in which the contract lays.</p>
+</div>
+<div class="paragraph">
+<p>If you need to pass the contents of a file in binary form,
+you can use the <code>fileAsBytes</code> method in Groovy DSL or a <code>bodyFromFileAsBytes</code> field in YAML.</p>
+</div>
+<div class="paragraph">
+<p>The following example shows how to pass the contents of binary files:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">import org.springframework.cloud.contract.spec.Contract
+
+Contract.make {
+    request {
+        url("/1")
+        method(PUT())
+        headers {
+            contentType(applicationOctetStream())
+        }
+        body(fileAsBytes("request.pdf"))
+    }
+    response {
+        status 200
+        body(fileAsBytes("response.pdf"))
+        headers {
+            contentType(applicationOctetStream())
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">request:
+  url: /1
+  method: PUT
+  headers:
+    Content-Type: application/octet-stream
+  bodyFromFileAsBytes: request.pdf
+response:
+  status: 200
+  bodyFromFileAsBytes: response.pdf
+  headers:
+    Content-Type: application/octet-stream</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+You should use this approach whenever you want to work with binary payloads,
+ both for HTTP and messaging.
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-http"><a class="anchor" href="#features-http"></a><a class="link" href="#features-http">4.2. Contracts for HTTP</a></h3>
+<div class="paragraph">
+<p>Spring Cloud Contract lets you verify applications that use REST or HTTP as a
+means of communication. Spring Cloud Contract verifies that, for a request that matches the
+criteria from the <code>request</code> part of the contract, the server provides a response that is in
+keeping with the <code>response</code> part of the contract. Subsequently, the contracts are used to
+generate WireMock stubs that, for any request matching the provided criteria, provide a
+suitable response.</p>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-http-top-level-elements"><a class="anchor" href="#contract-dsl-http-top-level-elements"></a><a class="link" href="#contract-dsl-http-top-level-elements">4.2.1. HTTP Top-Level Elements</a></h4>
+<div class="paragraph">
+<p>You can call the following methods in the top-level closure of a contract definition:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>request</code>: Mandatory</p>
+</li>
+<li>
+<p><code>response</code> : Mandatory</p>
+</li>
+<li>
+<p><code>priority</code>: Optional</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The following example shows how to define an HTTP request contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    // Definition of HTTP request part of the contract
+    // (this can be a valid request or invalid depending
+    // on type of contract being specified).
+    request {
+        method GET()
+        url "/foo"
+        //...
+    }
+
+    // Definition of HTTP response part of the contract
+    // (a service implementing this contract should respond
+    // with following response after receiving request
+    // specified in "request" part above).
+    response {
+        status 200
+        //...
+    }
+
+    // Contract priority, which can be used for overriding
+    // contracts (1 is highest). Priority is optional.
+    priority 1
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">priority: 8
+request:
+...
+response:
+...</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+If you want to make your contract have a higher priority,
+you need to pass a lower number to the <code>priority</code> tag or method. For example, a <code>priority</code> with
+a value of <code>5</code> has higher priority than a <code>priority</code> with a value of <code>10</code>.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-request"><a class="anchor" href="#contract-dsl-request"></a><a class="link" href="#contract-dsl-request">4.2.2. HTTP Request</a></h4>
+<div class="paragraph">
+<p>The HTTP protocol requires only the method and the URL to be specified in a request. The
+same information is mandatory in request definition of the contract.</p>
+</div>
+<div class="paragraph">
+<p>The following example shows a contract for a request:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        // HTTP request method (GET/POST/PUT/DELETE).
+        method 'GET'
+
+        // Path component of request URL is specified as follows.
+        urlPath('/users')
+    }
+
+    response {
+        //...
+        status 200
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">method: PUT
+url: /foo</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can specify an absolute rather than a relative <code>url</code>, but using <code>urlPath</code> is
+the recommended way, as doing so makes the tests be host-independent.</p>
+</div>
+<div class="paragraph">
+<p>The following example uses <code>url</code>:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method 'GET'
+
+        // Specifying `url` and `urlPath` in one contract is illegal.
+        url('http://localhost:8888/users')
+    }
+
+    response {
+        //...
+        status 200
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">request:
+  method: PUT
+  urlPath: /foo</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p><code>request</code> may contain query parameters, as the following example (which uses <code>urlPath</code>) shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        //...
+        method GET()
+
+        urlPath('/users') {
+
+            // Each parameter is specified in form
+            // `'paramName' : paramValue` where parameter value
+            // may be a simple literal or one of matcher functions,
+            // all of which are used in this example.
+            queryParameters {
+
+                // If a simple literal is used as value
+                // default matcher function is used (equalTo)
+                parameter 'limit': 100
+
+                // `equalTo` function simply compares passed value
+                // using identity operator (==).
+                parameter 'filter': equalTo("email")
+
+                // `containing` function matches strings
+                // that contains passed substring.
+                parameter 'gender': value(consumer(containing("[mf]")), producer('mf'))
+
+                // `matching` function tests parameter
+                // against passed regular expression.
+                parameter 'offset': value(consumer(matching("[0-9]+")), producer(123))
+
+                // `notMatching` functions tests if parameter
+                // does not match passed regular expression.
+                parameter 'loginStartsWith': value(consumer(notMatching(".{0,2}")), producer(3))
+            }
+        }
+
+        //...
+    }
+
+    response {
+        //...
+        status 200
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request:
+...
+queryParameters:
+  a: b
+  b: c</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p><code>request</code> can contain additional request headers, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        //...
+        method GET()
+        url "/foo"
+
+        // Each header is added in form `'Header-Name' : 'Header-Value'`.
+        // there are also some helper methods
+        headers {
+            header 'key': 'value'
+            contentType(applicationJson())
+        }
+
+        //...
+    }
+
+    response {
+        //...
+        status 200
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request:
+...
+headers:
+  foo: bar
+  fooReq: baz</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p><code>request</code> may contain additional request cookies, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        //...
+        method GET()
+        url "/foo"
+
+        // Each Cookies is added in form `'Cookie-Key' : 'Cookie-Value'`.
+        // there are also some helper methods
+        cookies {
+            cookie 'key': 'value'
+            cookie('another_key', 'another_value')
+        }
+
+        //...
+    }
+
+    response {
+        //...
+        status 200
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request:
+...
+cookies:
+  foo: bar
+  fooReq: baz</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p><code>request</code> may contain a request body, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        //...
+        method GET()
+        url "/foo"
+
+        // Currently only JSON format of request body is supported.
+        // Format will be determined from a header or body's content.
+        body '''{ "login" : "john", "name": "John The Contract" }'''
+    }
+
+    response {
+        //...
+        status 200
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">request:
+...
+body:
+  foo: bar</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p><code>request</code> can contain multipart elements. To include multipart elements, use the
+<code>multipart</code> method/section, as the following examples show:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract contractDsl = org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method 'PUT'
+        url '/multipart'
+        headers {
+            contentType('multipart/form-data;boundary=AaB03x')
+        }
+        multipart(
+                // key (parameter name), value (parameter value) pair
+                formParameter: $(c(regex('".+"')), p('"formParameterValue"')),
+                someBooleanParameter: $(c(regex(anyBoolean())), p('true')),
+                // a named parameter (e.g. with `file` name) that represents file with
+                // `name` and `content`. You can also call `named("fileName", "fileContent")`
+                file: named(
+                        // name of the file
+                        name: $(c(regex(nonEmpty())), p('filename.csv')),
+                        // content of the file
+                        content: $(c(regex(nonEmpty())), p('file content')),
+                        // content type for the part
+                        contentType: $(c(regex(nonEmpty())), p('application/json')))
+        )
+    }
+    response {
+        status OK()
+    }
+}
+org.springframework.cloud.contract.spec.Contract contractDsl = org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method "PUT"
+        url "/multipart"
+        headers {
+            contentType('multipart/form-data;boundary=AaB03x')
+        }
+        multipart(
+                file: named(
+                        name: value(stub(regex('.+')), test('file')),
+                        content: value(stub(regex('.+')), test([100, 117, 100, 97] as byte[]))
+                )
+        )
+    }
+    response {
+        status 200
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">request:
+  method: PUT
+  url: /multipart
+  headers:
+    Content-Type: multipart/form-data;boundary=AaB03x
+  multipart:
+    params:
+      # key (parameter name), value (parameter value) pair
+      formParameter: '"formParameterValue"'
+      someBooleanParameter: true
+    named:
+      - paramName: file
+        fileName: filename.csv
+        fileContent: file content
+  matchers:
+    multipart:
+      params:
+        - key: formParameter
+          regex: ".+"
+        - key: someBooleanParameter
+          predefined: any_boolean
+      named:
+        - paramName: file
+          fileName:
+            predefined: non_empty
+          fileContent:
+            predefined: non_empty
+response:
+  status: 200</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In the preceding example, we define parameters in either of two ways:</p>
+</div>
+<div class="ulist">
+<div class="title">Groovy DSL</div>
+<ul>
+<li>
+<p>Directly, by using the map notation, where the value can be a dynamic property (such as
+<code>formParameter: $(consumer(&#8230;&#8203;), producer(&#8230;&#8203;))</code>).</p>
+</li>
+<li>
+<p>By using the <code>named(&#8230;&#8203;)</code> method that lets you set a named parameter. A named parameter
+can set a <code>name</code> and <code>content</code>. You can call it either by using a method with two arguments,
+such as <code>named("fileName", "fileContent")</code>, or by using a map notation, such as
+<code>named(name: "fileName", content: "fileContent")</code>.</p>
+</li>
+</ul>
+</div>
+<div class="ulist">
+<div class="title">YAML</div>
+<ul>
+<li>
+<p>The multipart parameters are set in the <code>multipart.params</code> section.</p>
+</li>
+<li>
+<p>The named parameters (the <code>fileName</code> and <code>fileContent</code> for a given parameter name)
+can be set in the <code>multipart.named</code> section. That section contains
+the <code>paramName</code> (the name of the parameter), <code>fileName</code> (the name of the file),
+<code>fileContent</code> (the content of the file) fields.</p>
+</li>
+<li>
+<p>The dynamic bits can be set via the <code>matchers.multipart</code> section.</p>
+<div class="ulist">
+<ul>
+<li>
+<p>For parameters, use the <code>params</code> section, which can accept
+<code>regex</code> or a <code>predefined</code> regular expression.</p>
+</li>
+<li>
+<p>for named params, use the <code>named</code> section where first you
+define the parameter name with <code>paramName</code>. Then you can pass the
+parametrization of either <code>fileName</code> or <code>fileContent</code> in a
+<code>regex</code> or in a <code>predefined</code> regular expression.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>From the contract in the preceding example, the generated test and stubs look as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Test</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">// given:
+  MockMvcRequestSpecification request = given()
+    .header("Content-Type", "multipart/form-data;boundary=AaB03x")
+    .param("formParameter", "\"formParameterValue\"")
+    .param("someBooleanParameter", "true")
+    .multiPart("file", "filename.csv", "file content".getBytes());
+
+ // when:
+  ResponseOptions response = given().spec(request)
+    .put("/multipart");
+
+ // then:
+  assertThat(response.statusCode()).isEqualTo(200);</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Stub</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">            '''
+{
+  "request" : {
+    "url" : "/multipart",
+    "method" : "PUT",
+    "headers" : {
+      "Content-Type" : {
+        "matches" : "multipart/form-data;boundary=AaB03x.*"
+      }
+    },
+    "bodyPatterns" : [ {
+        "matches" : ".*--(.*)\\r\\nContent-Disposition: form-data; name=\\"formParameter\\"\\r\\n(Content-Type: .*\\r\\n)?(Content-Transfer-Encoding: .*\\r\\n)?(Content-Length: \\\\d+\\r\\n)?\\r\\n\\".+\\"\\r\\n--\\\\1.*"
+    }, {
+        "matches" : ".*--(.*)\\r\\nContent-Disposition: form-data; name=\\"someBooleanParameter\\"\\r\\n(Content-Type: .*\\r\\n)?(Content-Transfer-Encoding: .*\\r\\n)?(Content-Length: \\\\d+\\r\\n)?\\r\\n(true|false)\\r\\n--\\\\1.*"
+    }, {
+      "matches" : ".*--(.*)\\r\\nContent-Disposition: form-data; name=\\"file\\"; filename=\\"[\\\\S\\\\s]+\\"\\r\\n(Content-Type: .*\\r\\n)?(Content-Transfer-Encoding: .*\\r\\n)?(Content-Length: \\\\d+\\r\\n)?\\r\\n[\\\\S\\\\s]+\\r\\n--\\\\1.*"
+    } ]
+  },
+  "response" : {
+    "status" : 200,
+    "transformers" : [ "response-template", "foo-transformer" ]
+  }
+}
+    '''</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-response"><a class="anchor" href="#contract-dsl-response"></a><a class="link" href="#contract-dsl-response">4.2.3. HTTP Response</a></h4>
+<div class="paragraph">
+<p>The response must contain an HTTP status code and may contain other information. The
+following code shows an example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        //...
+        method GET()
+        url "/foo"
+    }
+    response {
+        // Status code sent by the server
+        // in response to request specified above.
+        status OK()
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">response:
+...
+status: 200</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Besides status, the response may contain headers, cookies, and a body, which are
+specified the same way as in the request (see <a href="#contract-dsl-request">HTTP Request</a>).</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+In the Groovy DSL, you can reference the <code>org.springframework.cloud.contract.spec.internal.HttpStatus</code>
+methods to provide a meaningful status instead of a digit. For example, you can call
+<code>OK()</code> for a status <code>200</code> or <code>BAD_REQUEST()</code> for <code>400</code>.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-dynamic-properties"><a class="anchor" href="#contract-dsl-dynamic-properties"></a><a class="link" href="#contract-dsl-dynamic-properties">4.2.4. Dynamic properties</a></h4>
+<div class="paragraph">
+<p>The contract can contain some dynamic properties: timestamps, IDs, and so on. You do not
+want to force the consumers to stub their clocks to always return the same value of time
+so that it gets matched by the stub.</p>
+</div>
+<div class="paragraph">
+<p>For the Groovy DSL, you can provide the dynamic parts in your contracts
+in two ways: pass them directly in the body or set them in a separate section called
+<code>bodyMatchers</code>.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+Before 2.0.0, these were set by using <code>testMatchers</code> and <code>stubMatchers</code>.
+See the <a href="https://github.com/spring-cloud/spring-cloud-contract/wiki/Spring-Cloud-Contract-2.0-Migration-Guide">migration guide</a> for more information.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>For YAML, you can use only the <code>matchers</code> section.</p>
+</div>
+<div class="sect4">
+<h5 id="contract-dsl-dynamic-properties-in-body"><a class="anchor" href="#contract-dsl-dynamic-properties-in-body"></a><a class="link" href="#contract-dsl-dynamic-properties-in-body">Dynamic Properties inside the Body</a></h5>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+This section is valid only for the Groovy DSL. Check out the
+<a href="#contract-dsl-matchers">Dynamic Properties in the Matchers Sections</a> section for YAML examples of a similar feature.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>You can set the properties inside the body either with the <code>value</code> method or, if you use
+the Groovy map notation, with <code>$()</code>. The following example shows how to set dynamic
+properties with the value method:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">value</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">value(consumer(...), producer(...))
+value(c(...), p(...))
+value(stub(...), test(...))
+value(client(...), server(...))</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">$</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">$(consumer(...), producer(...))
+$(c(...), p(...))
+$(stub(...), test(...))
+$(client(...), server(...))</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Both approaches work equally well. The <code>stub</code> and <code>client</code> methods are aliases over the <code>consumer</code>
+method. Subsequent sections take a closer look at what you can do with those values.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="contract-dsl-regex"><a class="anchor" href="#contract-dsl-regex"></a><a class="link" href="#contract-dsl-regex">Regular Expressions</a></h5>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+This section is valid only for Groovy DSL. Check out the
+<a href="#contract-dsl-matchers">Dynamic Properties in the Matchers Sections</a> section for YAML examples of a similar feature.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>You can use regular expressions to write your requests in the contract DSL. Doing so is
+particularly useful when you want to indicate that a given response should be provided
+for requests that follow a given pattern. Also, you can use regular expressions when you
+need to use patterns and not exact values both for your tests and your server-side tests.</p>
+</div>
+<div class="paragraph">
+<p>Make sure that regex matches a whole region of a sequence, as, internally, a call to
+<a href="https://docs.oracle.com/javase/8/docs/api/java/util/regex/Matcher.html#matches"><code>Pattern.matches()</code></a>
+is called. For instance, <code>abc</code> does not match <code>aabc</code>, but <code>.abc</code> does.
+There are several additional <a href="#contract-dsl-regex-limitations">known limitations</a> as well.</p>
+</div>
+<div class="paragraph">
+<p>The following example shows how to use regular expressions to write a request:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method('GET')
+        url $(consumer(~/\/[0-9]{2}/), producer('/12'))
+    }
+    response {
+        status OK()
+        body(
+                id: $(anyNumber()),
+                surname: $(
+                        consumer('Kowalsky'),
+                        producer(regex('[a-zA-Z]+'))
+                ),
+                name: 'Jan',
+                created: $(consumer('2014-02-02 12:23:43'), producer(execute('currentDate(it)'))),
+                correlationId: value(consumer('5d1f9fef-e0dc-4f3d-a7e4-72d2220dd827'),
+                        producer(regex('[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}'))
+                )
+        )
+        headers {
+            header 'Content-Type': 'text/plain'
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You can also provide only one side of the communication with a regular expression. If you
+do so, then the contract engine automatically provides the generated string that matches
+the provided regular expression. The following code shows an example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method 'PUT'
+        url value(consumer(regex('/foo/[0-9]{5}')))
+        body([
+                requestElement: $(consumer(regex('[0-9]{5}')))
+        ])
+        headers {
+            header('header', $(consumer(regex('application\\/vnd\\.fraud\\.v1\\+json;.*'))))
+        }
+    }
+    response {
+        status OK()
+        body([
+                responseElement: $(producer(regex('[0-9]{7}')))
+        ])
+        headers {
+            contentType("application/vnd.fraud.v1+json")
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In the preceding example, the opposite side of the communication has the respective data
+generated for request and response.</p>
+</div>
+<div class="paragraph">
+<p>Spring Cloud Contract comes with a series of predefined regular expressions that you can
+use in your contracts, as the following example shows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">protected static final Pattern TRUE_OR_FALSE = Pattern.compile("(true|false)");
+
+protected static final Pattern ALPHA_NUMERIC = Pattern.compile("[a-zA-Z0-9]+");
+
+protected static final Pattern ONLY_ALPHA_UNICODE = Pattern.compile("[\\p{L}]*");
+
+protected static final Pattern NUMBER = Pattern.compile("-?(\\d*\\.\\d+|\\d+)");
+
+protected static final Pattern INTEGER = Pattern.compile("-?(\\d+)");
+
+protected static final Pattern POSITIVE_INT = Pattern.compile("([1-9]\\d*)");
+
+protected static final Pattern DOUBLE = Pattern.compile("-?(\\d*\\.\\d+)");
+
+protected static final Pattern HEX = Pattern.compile("[a-fA-F0-9]+");
+
+protected static final Pattern IP_ADDRESS = Pattern.compile(
+        "([01]?\\d\\d?|2[0-4]\\d|25[0-5])\\.([01]?\\d\\d?|2[0-4]\\d|25[0-5])\\.([01]?\\d\\d?|2[0-4]\\d|25[0-5])\\.([01]?\\d\\d?|2[0-4]\\d|25[0-5])");
+
+protected static final Pattern HOSTNAME_PATTERN = Pattern
+        .compile("((http[s]?|ftp):/)/?([^:/\\s]+)(:[0-9]{1,5})?");
+
+protected static final Pattern EMAIL = Pattern
+        .compile("[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,6}");
+
+protected static final Pattern URL = UrlHelper.URL;
+
+protected static final Pattern HTTPS_URL = UrlHelper.HTTPS_URL;
+
+protected static final Pattern UUID = Pattern
+        .compile("[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}");
+
+protected static final Pattern ANY_DATE = Pattern
+        .compile("(\\d\\d\\d\\d)-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])");
+
+protected static final Pattern ANY_DATE_TIME = Pattern.compile(
+        "([0-9]{4})-(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9])T(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])");
+
+protected static final Pattern ANY_TIME = Pattern
+        .compile("(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])");
+
+protected static final Pattern NON_EMPTY = Pattern.compile("[\\S\\s]+");
+
+protected static final Pattern NON_BLANK = Pattern.compile("^\\s*\\S[\\S\\s]*");
+
+protected static final Pattern ISO8601_WITH_OFFSET = Pattern.compile(
+        "([0-9]{4})-(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9])T(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])(\\.\\d{3})?(Z|[+-][01]\\d:[0-5]\\d)");
+
+protected static Pattern anyOf(String... values) {
+    return Pattern.compile(Arrays.stream(values).map(it -&gt; '^' + it + '$')
+            .collect(Collectors.joining("|")));
+}
+
+public static String multipartParam(Object name, Object value) {
+    return ".*--(.*)\r\nContent-Disposition: form-data; name=\"" + name
+            + "\"\r\n(Content-Type: .*\r\n)?(Content-Transfer-Encoding: .*\r\n)?(Content-Length: \\d+\r\n)?\r\n"
+            + value + "\r\n--\\1.*";
+}
+
+public static String multipartFile(Object name, Object filename, Object content,
+        Object contentType) {
+    return ".*--(.*)\r\nContent-Disposition: form-data; name=\"" + name
+            + "\"; filename=\"" + filename + "\"\r\n(Content-Type: "
+            + toContentType(contentType)
+            + "\r\n)?(Content-Transfer-Encoding: .*\r\n)?(Content-Length: \\d+\r\n)?\r\n"
+            + content + "\r\n--\\1.*";
+}
+
+private static String toContentType(Object contentType) {
+    if (contentType == null) {
+        return ".*";
+    }
+    if (contentType instanceof RegexProperty) {
+        return ((RegexProperty) contentType).pattern();
+    }
+    return contentType.toString();
+}
+
+public RegexProperty onlyAlphaUnicode() {
+    return new RegexProperty(ONLY_ALPHA_UNICODE).asString();
+}
+
+public RegexProperty alphaNumeric() {
+    return new RegexProperty(ALPHA_NUMERIC).asString();
+}
+
+public RegexProperty number() {
+    return new RegexProperty(NUMBER).asDouble();
+}
+
+public RegexProperty positiveInt() {
+    return new RegexProperty(POSITIVE_INT).asInteger();
+}
+
+public RegexProperty anyBoolean() {
+    return new RegexProperty(TRUE_OR_FALSE).asBooleanType();
+}
+
+public RegexProperty anInteger() {
+    return new RegexProperty(INTEGER).asInteger();
+}
+
+public RegexProperty aDouble() {
+    return new RegexProperty(DOUBLE).asDouble();
+}
+
+public RegexProperty ipAddress() {
+    return new RegexProperty(IP_ADDRESS).asString();
+}
+
+public RegexProperty hostname() {
+    return new RegexProperty(HOSTNAME_PATTERN).asString();
+}
+
+public RegexProperty email() {
+    return new RegexProperty(EMAIL).asString();
+}
+
+public RegexProperty url() {
+    return new RegexProperty(URL).asString();
+}
+
+public RegexProperty httpsUrl() {
+    return new RegexProperty(HTTPS_URL).asString();
+}
+
+public RegexProperty uuid() {
+    return new RegexProperty(UUID).asString();
+}
+
+public RegexProperty isoDate() {
+    return new RegexProperty(ANY_DATE).asString();
+}
+
+public RegexProperty isoDateTime() {
+    return new RegexProperty(ANY_DATE_TIME).asString();
+}
+
+public RegexProperty isoTime() {
+    return new RegexProperty(ANY_TIME).asString();
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In your contract, you can use it as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract dslWithOptionalsInString = Contract.make {
+    priority 1
+    request {
+        method POST()
+        url '/users/password'
+        headers {
+            contentType(applicationJson())
+        }
+        body(
+                email: $(consumer(optional(regex(email()))), producer('abc@abc.com')),
+                callback_url: $(consumer(regex(hostname())), producer('http://partners.com'))
+        )
+    }
+    response {
+        status 404
+        headers {
+            contentType(applicationJson())
+        }
+        body(
+                code: value(consumer("123123"), producer(optional("123123"))),
+                message: "User not found by email = [${value(producer(regex(email())), consumer('not.existing@user.com'))}]"
+        )
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>To make matters even simpler, you can use a set of predefined objects that automatically
+assume that you want a regular expression to be passed.
+All of those methods start with the <code>any</code> prefix, as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">T anyAlphaUnicode();
+
+T anyAlphaNumeric();
+
+T anyNumber();
+
+T anyInteger();
+
+T anyPositiveInt();
+
+T anyDouble();
+
+T anyHex();
+
+T aBoolean();
+
+T anyIpAddress();
+
+T anyHostname();
+
+T anyEmail();
+
+T anyUrl();
+
+T anyHttpsUrl();
+
+T anyUuid();
+
+T anyDate();
+
+T anyDateTime();
+
+T anyTime();
+
+T anyIso8601WithOffset();
+
+T anyNonBlankString();
+
+T anyNonEmptyString();
+
+T anyOf(String... values);</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example shows how you can reference those methods:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract contractDsl = Contract.make {
+    name "foo"
+    label 'trigger_event'
+    input {
+        triggeredBy('toString()')
+    }
+    outputMessage {
+        sentTo 'topic.rateablequote'
+        body([
+                alpha            : $(anyAlphaUnicode()),
+                number           : $(anyNumber()),
+                anInteger        : $(anyInteger()),
+                positiveInt      : $(anyPositiveInt()),
+                aDouble          : $(anyDouble()),
+                aBoolean         : $(aBoolean()),
+                ip               : $(anyIpAddress()),
+                hostname         : $(anyHostname()),
+                email            : $(anyEmail()),
+                url              : $(anyUrl()),
+                httpsUrl         : $(anyHttpsUrl()),
+                uuid             : $(anyUuid()),
+                date             : $(anyDate()),
+                dateTime         : $(anyDateTime()),
+                time             : $(anyTime()),
+                iso8601WithOffset: $(anyIso8601WithOffset()),
+                nonBlankString   : $(anyNonBlankString()),
+                nonEmptyString   : $(anyNonEmptyString()),
+                anyOf            : $(anyOf('foo', 'bar'))
+        ])
+    }
+}</code></pre>
+</div>
+</div>
+<div class="sect5">
+<h6 id="contract-dsl-regex-limitations"><a class="anchor" href="#contract-dsl-regex-limitations"></a><a class="link" href="#contract-dsl-regex-limitations">Limitations</a></h6>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title="Warning"></i>
+</td>
+<td class="content">
+Due to certain limitations of the <code>Xeger</code> library that generates a string out of
+a regex, do not use the <code>$</code> and <code>^</code> signs in your regex if you rely on automatic
+generation. See <a href="https://github.com/spring-cloud/spring-cloud-contract/issues/899">Issue 899</a>.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title="Warning"></i>
+</td>
+<td class="content">
+Do not use a <code>LocalDate</code> instance as a value for <code>$</code> (for example, <code>$(consumer(LocalDate.now()))</code>).
+It causes a <code>java.lang.StackOverflowError</code>. Use <code>$(consumer(LocalDate.now().toString()))</code> instead.
+See <a href="https://github.com/spring-cloud/spring-cloud-contract/issues/900">Issue 900</a>.
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="contract-dsl-optional-params"><a class="anchor" href="#contract-dsl-optional-params"></a><a class="link" href="#contract-dsl-optional-params">Passing Optional Parameters</a></h5>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+This section is valid only for Groovy DSL. Check out the
+<a href="#contract-dsl-matchers">Dynamic Properties in the Matchers Sections</a> section for YAML examples of a similar feature.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>You can provide optional parameters in your contract. However, you can provide
+optional parameters only for the following:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The STUB side of the Request</p>
+</li>
+<li>
+<p>The TEST side of the Response</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The following example shows how to provide optional parameters:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    priority 1
+    name "optionals"
+    request {
+        method 'POST'
+        url '/users/password'
+        headers {
+            contentType(applicationJson())
+        }
+        body(
+                email: $(consumer(optional(regex(email()))), producer('abc@abc.com')),
+                callback_url: $(consumer(regex(hostname())), producer('https://partners.com'))
+        )
+    }
+    response {
+        status 404
+        headers {
+            header 'Content-Type': 'application/json'
+        }
+        body(
+                code: value(consumer("123123"), producer(optional("123123")))
+        )
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>By wrapping a part of the body with the <code>optional()</code> method, you create a regular
+expression that must be present 0 or more times.</p>
+</div>
+<div class="paragraph">
+<p>If you use Spock, the following test would be generated from the previous example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">                    """\
+package com.example
+
+import com.jayway.jsonpath.DocumentContext
+import com.jayway.jsonpath.JsonPath
+import spock.lang.Specification
+import io.restassured.module.mockmvc.specification.MockMvcRequestSpecification
+import io.restassured.response.ResponseOptions
+
+import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*
+import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson
+import static io.restassured.module.mockmvc.RestAssuredMockMvc.*
+
+@SuppressWarnings("rawtypes")
+class FooSpec extends Specification {
+
+\tdef validate_optionals() throws Exception {
+\t\tgiven:
+\t\t\tMockMvcRequestSpecification request = given()
+\t\t\t\t\t.header("Content-Type", "application/json")
+\t\t\t\t\t.body('''{"email":"abc@abc.com","callback_url":"https://partners.com"}''')
+
+\t\twhen:
+\t\t\tResponseOptions response = given().spec(request)
+\t\t\t\t\t.post("/users/password")
+
+\t\tthen:
+\t\t\tresponse.statusCode() == 404
+\t\t\tresponse.header("Content-Type") == 'application/json'
+
+\t\tand:
+\t\t\tDocumentContext parsedJson = JsonPath.parse(response.body.asString())
+\t\t\tassertThatJson(parsedJson).field("['code']").matches("(123123)?")
+\t}
+
+}
+"""</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The following stub would also be generated:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">                    '''
+{
+  "request" : {
+    "url" : "/users/password",
+    "method" : "POST",
+    "bodyPatterns" : [ {
+      "matchesJsonPath" : "$[?(@.['email'] =~ /([a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\\\.[a-zA-Z]{2,6})?/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.['callback_url'] =~ /((http[s]?|ftp):\\\\/)\\\\/?([^:\\\\/\\\\s]+)(:[0-9]{1,5})?/)]"
+    } ],
+    "headers" : {
+      "Content-Type" : {
+        "equalTo" : "application/json"
+      }
+    }
+  },
+  "response" : {
+    "status" : 404,
+    "body" : "{\\"code\\":\\"123123\\",\\"message\\":\\"User not found by email == [not.existing@user.com]\\"}",
+    "headers" : {
+      "Content-Type" : "application/json"
+    }
+  },
+  "priority" : 1
+}
+'''</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="contract-dsl-custom-methods"><a class="anchor" href="#contract-dsl-custom-methods"></a><a class="link" href="#contract-dsl-custom-methods">Executing Custom Methods on the Server Side</a></h5>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+This section is valid only for Groovy DSL. Check out the
+<a href="#contract-dsl-matchers">Dynamic Properties in the Matchers Sections</a> section for YAML examples of a similar feature.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>You can define a method call that runs on the server side during the test. Such a
+method can be added to the class defined as <code>baseClassForTests</code> in the configuration. The
+following code shows an example of the contract portion of the test case:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">method GET()</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The following code shows the base class portion of the test case:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">abstract class BaseMockMvcSpec extends Specification {
+
+    def setup() {
+        RestAssuredMockMvc.standaloneSetup(new PairIdController())
+    }
+
+    void isProperCorrelationId(Integer correlationId) {
+        assert correlationId == 123456
+    }
+
+    void isEmpty(String value) {
+        assert value == null
+    }
+
+}</code></pre>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+You cannot use both a <code>String</code> and <code>execute</code> to perform concatenation. For
+example, calling <code>header('Authorization', 'Bearer ' + execute('authToken()'))</code> leads to
+improper results. Instead, call <code>header('Authorization', execute('authToken()'))</code> and
+ensure that the <code>authToken()</code> method returns everything you need.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The type of the object read from the JSON can be one of the following, depending on the
+JSON path:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>String</code>: If you point to a <code>String</code> value in the JSON.</p>
+</li>
+<li>
+<p><code>JSONArray</code>: If you point to a <code>List</code> in the JSON.</p>
+</li>
+<li>
+<p><code>Map</code>: If you point to a <code>Map</code> in the JSON.</p>
+</li>
+<li>
+<p><code>Number</code>: If you point to <code>Integer</code>, <code>Double</code>, and other numeric type in the JSON.</p>
+</li>
+<li>
+<p><code>Boolean</code>: If you point to a <code>Boolean</code> in the JSON.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In the request part of the contract, you can specify that the <code>body</code> should be taken from
+a method.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+You must provide both the consumer and the producer side. The <code>execute</code> part
+is applied for the whole body, not for parts of it.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following example shows how to read an object from JSON:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract contractDsl = Contract.make {
+    request {
+        method 'GET'
+        url '/something'
+        body(
+                $(c('foo'), p(execute('hashCode()')))
+        )
+    }
+    response {
+        status OK()
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The preceding example results in calling the <code>hashCode()</code> method in the request body.
+It should resemble the following code:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">// given:
+ MockMvcRequestSpecification request = given()
+   .body(hashCode());
+
+// when:
+ ResponseOptions response = given().spec(request)
+   .get("/something");
+
+// then:
+ assertThat(response.statusCode()).isEqualTo(200);</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="contract-dsl-referencing-request-from-response"><a class="anchor" href="#contract-dsl-referencing-request-from-response"></a><a class="link" href="#contract-dsl-referencing-request-from-response">Referencing the Request from the Response</a></h5>
+<div class="paragraph">
+<p>The best situation is to provide fixed values, but sometimes you need to reference a
+request in your response.</p>
+</div>
+<div class="paragraph">
+<p>If you write contracts in the Groovy DSL, you can use the <code>fromRequest()</code> method, which lets
+you reference a bunch of elements from the HTTP request. You can use the following
+options:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>fromRequest().url()</code>: Returns the request URL and query parameters.</p>
+</li>
+<li>
+<p><code>fromRequest().query(String key)</code>: Returns the first query parameter with a given name.</p>
+</li>
+<li>
+<p><code>fromRequest().query(String key, int index)</code>: Returns the nth query parameter with a
+given name.</p>
+</li>
+<li>
+<p><code>fromRequest().path()</code>: Returns the full path.</p>
+</li>
+<li>
+<p><code>fromRequest().path(int index)</code>: Returns the nth path element.</p>
+</li>
+<li>
+<p><code>fromRequest().header(String key)</code>: Returns the first header with a given name.</p>
+</li>
+<li>
+<p><code>fromRequest().header(String key, int index)</code>: Returns the nth header with a given name.</p>
+</li>
+<li>
+<p><code>fromRequest().body()</code>: Returns the full request body.</p>
+</li>
+<li>
+<p><code>fromRequest().body(String jsonPath)</code>: Returns the element from the request that
+matches the JSON Path.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>If you use the YAML contract definition, you have to use the
+<a href="https://handlebarsjs.com/">Handlebars</a> <code>{{{ }}}</code> notation with custom Spring Cloud Contract
+functions to achieve this. In that case, you can use the following options:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>{{{ request.url }}}</code>: Returns the request URL and query parameters.</p>
+</li>
+<li>
+<p><code>{{{ request.query.key.[index] }}}</code>: Returns the nth query parameter with a given name.
+For example, for a key of <code>thing</code>, the first entry is <code>{{{ request.query.thing.[0] }}}</code></p>
+</li>
+<li>
+<p><code>{{{ request.path }}}</code>: Returns the full path.</p>
+</li>
+<li>
+<p><code>{{{ request.path.[index] }}}</code>: Returns the nth path element. For example,
+the first entry is <code>`</code>{{{ request.path.[0] }}}</p>
+</li>
+<li>
+<p><code>{{{ request.headers.key }}}</code>: Returns the first header with a given name.</p>
+</li>
+<li>
+<p><code>{{{ request.headers.key.[index] }}}</code>: Returns the nth header with a given name.</p>
+</li>
+<li>
+<p><code>{{{ request.body }}}</code>: Returns the full request body.</p>
+</li>
+<li>
+<p><code>{{{ jsonpath this 'your.json.path' }}}</code>: Returns the element from the request that
+matches the JSON Path. For example, for a JSON path of <code>$.here</code>, use <code>{{{ jsonpath this '$.here' }}}</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Consider the following contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract contractDsl = Contract.make {
+    request {
+        method 'GET'
+        url('/api/v1/xxxx') {
+            queryParameters {
+                parameter('foo', 'bar')
+                parameter('foo', 'bar2')
+            }
+        }
+        headers {
+            header(authorization(), 'secret')
+            header(authorization(), 'secret2')
+        }
+        body(foo: 'bar', baz: 5)
+    }
+    response {
+        status OK()
+        headers {
+            header(authorization(), "foo ${fromRequest().header(authorization())} bar")
+        }
+        body(
+                url: fromRequest().url(),
+                path: fromRequest().path(),
+                pathIndex: fromRequest().path(1),
+                param: fromRequest().query('foo'),
+                paramIndex: fromRequest().query('foo', 1),
+                authorization: fromRequest().header('Authorization'),
+                authorization2: fromRequest().header('Authorization', 1),
+                fullBody: fromRequest().body(),
+                responseFoo: fromRequest().body('$.foo'),
+                responseBaz: fromRequest().body('$.baz'),
+                responseBaz2: "Bla bla ${fromRequest().body('$.foo')} bla bla",
+                rawUrl: fromRequest().rawUrl(),
+                rawPath: fromRequest().rawPath(),
+                rawPathIndex: fromRequest().rawPath(1),
+                rawParam: fromRequest().rawQuery('foo'),
+                rawParamIndex: fromRequest().rawQuery('foo', 1),
+                rawAuthorization: fromRequest().rawHeader('Authorization'),
+                rawAuthorization2: fromRequest().rawHeader('Authorization', 1),
+                rawResponseFoo: fromRequest().rawBody('$.foo'),
+                rawResponseBaz: fromRequest().rawBody('$.baz'),
+                rawResponseBaz2: "Bla bla ${fromRequest().rawBody('$.foo')} bla bla"
+        )
+    }
+}
+Contract contractDsl = Contract.make {
+    request {
+        method 'GET'
+        url('/api/v1/xxxx') {
+            queryParameters {
+                parameter('foo', 'bar')
+                parameter('foo', 'bar2')
+            }
+        }
+        headers {
+            header(authorization(), 'secret')
+            header(authorization(), 'secret2')
+        }
+        body(foo: "bar", baz: 5)
+    }
+    response {
+        status OK()
+        headers {
+            contentType(applicationJson())
+        }
+        body('''
+                {
+                    "responseFoo": "{{{ jsonPath request.body '$.foo' }}}",
+                    "responseBaz": {{{ jsonPath request.body '$.baz' }}},
+                    "responseBaz2": "Bla bla {{{ jsonPath request.body '$.foo' }}} bla bla"
+                }
+        '''.toString())
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">request:
+  method: GET
+  url: /api/v1/xxxx
+  queryParameters:
+    foo:
+      - bar
+      - bar2
+  headers:
+    Authorization:
+      - secret
+      - secret2
+  body:
+    foo: bar
+    baz: 5
+response:
+  status: 200
+  headers:
+    Authorization: "foo {{{ request.headers.Authorization.0 }}} bar"
+  body:
+    url: "{{{ request.url }}}"
+    path: "{{{ request.path }}}"
+    pathIndex: "{{{ request.path.1 }}}"
+    param: "{{{ request.query.foo }}}"
+    paramIndex: "{{{ request.query.foo.1 }}}"
+    authorization: "{{{ request.headers.Authorization.0 }}}"
+    authorization2: "{{{ request.headers.Authorization.1 }}"
+    fullBody: "{{{ request.body }}}"
+    responseFoo: "{{{ jsonpath this '$.foo' }}}"
+    responseBaz: "{{{ jsonpath this '$.baz' }}}"
+    responseBaz2: "Bla bla {{{ jsonpath this '$.foo' }}} bla bla"</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Running a JUnit test generation leads to a test that resembles the following example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">// given:
+ MockMvcRequestSpecification request = given()
+   .header("Authorization", "secret")
+   .header("Authorization", "secret2")
+   .body("{\"foo\":\"bar\",\"baz\":5}");
+
+// when:
+ ResponseOptions response = given().spec(request)
+   .queryParam("foo","bar")
+   .queryParam("foo","bar2")
+   .get("/api/v1/xxxx");
+
+// then:
+ assertThat(response.statusCode()).isEqualTo(200);
+ assertThat(response.header("Authorization")).isEqualTo("foo secret bar");
+// and:
+ DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
+ assertThatJson(parsedJson).field("['fullBody']").isEqualTo("{\"foo\":\"bar\",\"baz\":5}");
+ assertThatJson(parsedJson).field("['authorization']").isEqualTo("secret");
+ assertThatJson(parsedJson).field("['authorization2']").isEqualTo("secret2");
+ assertThatJson(parsedJson).field("['path']").isEqualTo("/api/v1/xxxx");
+ assertThatJson(parsedJson).field("['param']").isEqualTo("bar");
+ assertThatJson(parsedJson).field("['paramIndex']").isEqualTo("bar2");
+ assertThatJson(parsedJson).field("['pathIndex']").isEqualTo("v1");
+ assertThatJson(parsedJson).field("['responseBaz']").isEqualTo(5);
+ assertThatJson(parsedJson).field("['responseFoo']").isEqualTo("bar");
+ assertThatJson(parsedJson).field("['url']").isEqualTo("/api/v1/xxxx?foo=bar&amp;foo=bar2");
+ assertThatJson(parsedJson).field("['responseBaz2']").isEqualTo("Bla bla bar bla bla");</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>As you can see, elements from the request have been properly referenced in the response.</p>
+</div>
+<div class="paragraph">
+<p>The generated WireMock stub should resemble the following example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+  "request" : {
+    "urlPath" : "/api/v1/xxxx",
+    "method" : "POST",
+    "headers" : {
+      "Authorization" : {
+        "equalTo" : "secret2"
+      }
+    },
+    "queryParameters" : {
+      "foo" : {
+        "equalTo" : "bar2"
+      }
+    },
+    "bodyPatterns" : [ {
+      "matchesJsonPath" : "$[?(@.['baz'] == 5)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.['foo'] == 'bar')]"
+    } ]
+  },
+  "response" : {
+    "status" : 200,
+    "body" : "{\"authorization\":\"{{{request.headers.Authorization.[0]}}}\",\"path\":\"{{{request.path}}}\",\"responseBaz\":{{{jsonpath this '$.baz'}}} ,\"param\":\"{{{request.query.foo.[0]}}}\",\"pathIndex\":\"{{{request.path.[1]}}}\",\"responseBaz2\":\"Bla bla {{{jsonpath this '$.foo'}}} bla bla\",\"responseFoo\":\"{{{jsonpath this '$.foo'}}}\",\"authorization2\":\"{{{request.headers.Authorization.[1]}}}\",\"fullBody\":\"{{{escapejsonbody}}}\",\"url\":\"{{{request.url}}}\",\"paramIndex\":\"{{{request.query.foo.[1]}}}\"}",
+    "headers" : {
+      "Authorization" : "{{{request.headers.Authorization.[0]}}};foo"
+    },
+    "transformers" : [ "response-template" ]
+  }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Sending a request such as the one presented in the <code>request</code> part of the contract results
+in sending the following response body:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+  "url" : "/api/v1/xxxx?foo=bar&amp;foo=bar2",
+  "path" : "/api/v1/xxxx",
+  "pathIndex" : "v1",
+  "param" : "bar",
+  "paramIndex" : "bar2",
+  "authorization" : "secret",
+  "authorization2" : "secret2",
+  "fullBody" : "{\"foo\":\"bar\",\"baz\":5}",
+  "responseFoo" : "bar",
+  "responseBaz" : 5,
+  "responseBaz2" : "Bla bla bar bla bla"
+}</code></pre>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+This feature works only with WireMock versions greater than or equal
+to 2.5.1. The Spring Cloud Contract Verifier uses WireMock&#8217;s
+<code>response-template</code> response transformer. It uses Handlebars to convert the Mustache <code>{{{ }}}</code> templates into
+proper values. Additionally, it registers two helper functions:
+</td>
+</tr>
+</table>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>escapejsonbody</code>: Escapes the request body in a format that can be embedded in a JSON.</p>
+</li>
+<li>
+<p><code>jsonpath</code>: For a given parameter, find an object in the request body.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="contract-dsl-matchers"><a class="anchor" href="#contract-dsl-matchers"></a><a class="link" href="#contract-dsl-matchers">Dynamic Properties in the Matchers Sections</a></h5>
+<div class="paragraph">
+<p>If you work with <a href="https://docs.pact.io/">Pact</a>, the following discussion may seem familiar.
+Quite a few users are used to having a separation between the body and setting the
+dynamic parts of a contract.</p>
+</div>
+<div class="paragraph">
+<p>You can use the <code>bodyMatchers</code> section for two reasons:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Define the dynamic values that should end up in a stub.
+You can set it in the <code>request</code> or <code>inputMessage</code> part of your contract.</p>
+</li>
+<li>
+<p>Verify the result of your test.
+This section is present in the <code>response</code> or <code>outputMessage</code> side of the
+contract.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Currently, Spring Cloud Contract Verifier supports only JSON path-based matchers with the
+following matching possibilities:</p>
+</div>
+<div class="sect5">
+<h6 id="groovy-dsl"><a class="anchor" href="#groovy-dsl"></a><a class="link" href="#groovy-dsl">Groovy DSL</a></h6>
+<div class="ulist">
+<ul>
+<li>
+<p>For the stubs (in tests on the consumer&#8217;s side):</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>byEquality()</code>: The value taken from the consumer&#8217;s request in the provided JSON path must be
+equal to the value provided in the contract.</p>
+</li>
+<li>
+<p><code>byRegex(&#8230;&#8203;)</code>: The value taken from the consumer&#8217;s request in the provided JSON path must
+match the regex. You can also pass the type of the expected matched value (for example, <code>asString()</code>, <code>asLong()</code>, and so on).</p>
+</li>
+<li>
+<p><code>byDate()</code>: The value taken from the consumer&#8217;s request in the provided JSON path must
+match the regex for an ISO Date value.</p>
+</li>
+<li>
+<p><code>byTimestamp()</code>: The value taken from the consumer&#8217;s request in the provided JSON path must
+match the regex for an ISO DateTime value.</p>
+</li>
+<li>
+<p><code>byTime()</code>: The value taken from the consumer&#8217;s request in the provided JSON path must
+match the regex for an ISO Time value.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>For the verification (in generated tests on the Producer&#8217;s side):</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>byEquality()</code>: The value taken from the producer&#8217;s response in the provided JSON path must be
+equal to the provided value in the contract.</p>
+</li>
+<li>
+<p><code>byRegex(&#8230;&#8203;)</code>: The value taken from the producer&#8217;s response in the provided JSON path must
+match the regex.</p>
+</li>
+<li>
+<p><code>byDate()</code>: The value taken from the producer&#8217;s response in the provided JSON path must match
+the regex for an ISO Date value.</p>
+</li>
+<li>
+<p><code>byTimestamp()</code>: The value taken from the producer&#8217;s response in the provided JSON path must
+match the regex for an ISO DateTime value.</p>
+</li>
+<li>
+<p><code>byTime()</code>: The value taken from the producer&#8217;s response in the provided JSON path must match
+the regex for an ISO Time value.</p>
+</li>
+<li>
+<p><code>byType()</code>: The value taken from the producer&#8217;s response in the provided JSON path needs to be
+of the same type as the type defined in the body of the response in the contract.
+<code>byType</code> can take a closure, in which you can set <code>minOccurrence</code> and <code>maxOccurrence</code>. For the
+request side, you should use the closure to assert size of the collection.
+That way, you can assert the size of the flattened collection. To check the size of an
+unflattened collection, use a custom method with the <code>byCommand(&#8230;&#8203;)</code> <code>testMatcher</code>.</p>
+</li>
+<li>
+<p><code>byCommand(&#8230;&#8203;)</code>: The value taken from the producer&#8217;s response in the provided JSON path is
+passed as an input to the custom method that you provide. For example,
+<code>byCommand('thing($it)')</code> results in calling a <code>thing</code> method to which the value matching the
+JSON Path gets passed. The type of the object read from the JSON can be one of the
+following, depending on the JSON path:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>String</code>: If you point to a <code>String</code> value.</p>
+</li>
+<li>
+<p><code>JSONArray</code>: If you point to a <code>List</code>.</p>
+</li>
+<li>
+<p><code>Map</code>: If you point to a <code>Map</code>.</p>
+</li>
+<li>
+<p><code>Number</code>: If you point to <code>Integer</code>, <code>Double</code>, or another kind of number.</p>
+</li>
+<li>
+<p><code>Boolean</code>: If you point to a <code>Boolean</code>.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><code>byNull()</code>: The value taken from the response in the provided JSON path must be null.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect5">
+<h6 id="yaml"><a class="anchor" href="#yaml"></a><a class="link" href="#yaml">YAML</a></h6>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+See the Groovy section for detailed explanation of
+what the types mean.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>For YAML, the structure of a matcher resembles the following example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">- path: $.thing1
+  type: by_regex
+  value: thing2
+  regexType: as_string</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Alternatively, if you want to use one of the predefined regular expressions
+<code>[only_alpha_unicode, number, any_boolean, ip_address, hostname,
+email, url, uuid, iso_date, iso_date_time, iso_time, iso_8601_with_offset, non_empty,
+non_blank]</code>, you can use something similar to the following example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">- path: $.thing1
+  type: by_regex
+  predefined: only_alpha_unicode</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The following list shows the allowed list of <code>type</code> values:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>For <code>stubMatchers</code>:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>by_equality</code></p>
+</li>
+<li>
+<p><code>by_regex</code></p>
+</li>
+<li>
+<p><code>by_date</code></p>
+</li>
+<li>
+<p><code>by_timestamp</code></p>
+</li>
+<li>
+<p><code>by_time</code></p>
+</li>
+<li>
+<p><code>by_type</code></p>
+<div class="ulist">
+<ul>
+<li>
+<p>Two additional fields (<code>minOccurrence</code> and <code>maxOccurrence</code>) are accepted.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>For <code>testMatchers</code>:</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>by_equality</code></p>
+</li>
+<li>
+<p><code>by_regex</code></p>
+</li>
+<li>
+<p><code>by_date</code></p>
+</li>
+<li>
+<p><code>by_timestamp</code></p>
+</li>
+<li>
+<p><code>by_time</code></p>
+</li>
+<li>
+<p><code>by_type</code></p>
+<div class="ulist">
+<ul>
+<li>
+<p>Two additional fields (<code>minOccurrence</code> and <code>maxOccurrence</code>) are accepted.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><code>by_command</code></p>
+</li>
+<li>
+<p><code>by_null</code></p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>You can also define which type the regular expression corresponds to in the <code>regexType</code>
+field. The following list shows the allowed regular expression types:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>as_integer</code></p>
+</li>
+<li>
+<p><code>as_double</code></p>
+</li>
+<li>
+<p><code>as_float</code></p>
+</li>
+<li>
+<p><code>as_long</code></p>
+</li>
+<li>
+<p><code>as_short</code></p>
+</li>
+<li>
+<p><code>as_boolean</code></p>
+</li>
+<li>
+<p><code>as_string</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Consider the following example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract contractDsl = Contract.make {
+    request {
+        method 'GET'
+        urlPath '/get'
+        body([
+                duck                : 123,
+                alpha               : 'abc',
+                number              : 123,
+                aBoolean            : true,
+                date                : '2017-01-01',
+                dateTime            : '2017-01-01T01:23:45',
+                time                : '01:02:34',
+                valueWithoutAMatcher: 'foo',
+                valueWithTypeMatch  : 'string',
+                key                 : [
+                        'complex.key': 'foo'
+                ]
+        ])
+        bodyMatchers {
+            jsonPath('$.duck', byRegex("[0-9]{3}").asInteger())
+            jsonPath('$.duck', byEquality())
+            jsonPath('$.alpha', byRegex(onlyAlphaUnicode()).asString())
+            jsonPath('$.alpha', byEquality())
+            jsonPath('$.number', byRegex(number()).asInteger())
+            jsonPath('$.aBoolean', byRegex(anyBoolean()).asBooleanType())
+            jsonPath('$.date', byDate())
+            jsonPath('$.dateTime', byTimestamp())
+            jsonPath('$.time', byTime())
+            jsonPath("\$.['key'].['complex.key']", byEquality())
+        }
+        headers {
+            contentType(applicationJson())
+        }
+    }
+    response {
+        status OK()
+        body([
+                duck                 : 123,
+                alpha                : 'abc',
+                number               : 123,
+                positiveInteger      : 1234567890,
+                negativeInteger      : -1234567890,
+                positiveDecimalNumber: 123.4567890,
+                negativeDecimalNumber: -123.4567890,
+                aBoolean             : true,
+                date                 : '2017-01-01',
+                dateTime             : '2017-01-01T01:23:45',
+                time                 : "01:02:34",
+                valueWithoutAMatcher : 'foo',
+                valueWithTypeMatch   : 'string',
+                valueWithMin         : [
+                        1, 2, 3
+                ],
+                valueWithMax         : [
+                        1, 2, 3
+                ],
+                valueWithMinMax      : [
+                        1, 2, 3
+                ],
+                valueWithMinEmpty    : [],
+                valueWithMaxEmpty    : [],
+                key                  : [
+                        'complex.key': 'foo'
+                ],
+                nullValue            : null
+        ])
+        bodyMatchers {
+            // asserts the jsonpath value against manual regex
+            jsonPath('$.duck', byRegex("[0-9]{3}").asInteger())
+            // asserts the jsonpath value against the provided value
+            jsonPath('$.duck', byEquality())
+            // asserts the jsonpath value against some default regex
+            jsonPath('$.alpha', byRegex(onlyAlphaUnicode()).asString())
+            jsonPath('$.alpha', byEquality())
+            jsonPath('$.number', byRegex(number()).asInteger())
+            jsonPath('$.positiveInteger', byRegex(anInteger()).asInteger())
+            jsonPath('$.negativeInteger', byRegex(anInteger()).asInteger())
+            jsonPath('$.positiveDecimalNumber', byRegex(aDouble()).asDouble())
+            jsonPath('$.negativeDecimalNumber', byRegex(aDouble()).asDouble())
+            jsonPath('$.aBoolean', byRegex(anyBoolean()).asBooleanType())
+            // asserts vs inbuilt time related regex
+            jsonPath('$.date', byDate())
+            jsonPath('$.dateTime', byTimestamp())
+            jsonPath('$.time', byTime())
+            // asserts that the resulting type is the same as in response body
+            jsonPath('$.valueWithTypeMatch', byType())
+            jsonPath('$.valueWithMin', byType {
+                // results in verification of size of array (min 1)
+                minOccurrence(1)
+            })
+            jsonPath('$.valueWithMax', byType {
+                // results in verification of size of array (max 3)
+                maxOccurrence(3)
+            })
+            jsonPath('$.valueWithMinMax', byType {
+                // results in verification of size of array (min 1 &amp; max 3)
+                minOccurrence(1)
+                maxOccurrence(3)
+            })
+            jsonPath('$.valueWithMinEmpty', byType {
+                // results in verification of size of array (min 0)
+                minOccurrence(0)
+            })
+            jsonPath('$.valueWithMaxEmpty', byType {
+                // results in verification of size of array (max 0)
+                maxOccurrence(0)
+            })
+            // will execute a method `assertThatValueIsANumber`
+            jsonPath('$.duck', byCommand('assertThatValueIsANumber($it)'))
+            jsonPath("\$.['key'].['complex.key']", byEquality())
+            jsonPath('$.nullValue', byNull())
+        }
+        headers {
+            contentType(applicationJson())
+            header('Some-Header', $(c('someValue'), p(regex('[a-zA-Z]{9}'))))
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">request:
+  method: GET
+  urlPath: /get/1
+  headers:
+    Content-Type: application/json
+  cookies:
+    foo: 2
+    bar: 3
+  queryParameters:
+    limit: 10
+    offset: 20
+    filter: 'email'
+    sort: name
+    search: 55
+    age: 99
+    name: John.Doe
+    email: 'bob@email.com'
+  body:
+    duck: 123
+    alpha: "abc"
+    number: 123
+    aBoolean: true
+    date: "2017-01-01"
+    dateTime: "2017-01-01T01:23:45"
+    time: "01:02:34"
+    valueWithoutAMatcher: "foo"
+    valueWithTypeMatch: "string"
+    key:
+      "complex.key": 'foo'
+    nullValue: null
+    valueWithMin:
+      - 1
+      - 2
+      - 3
+    valueWithMax:
+      - 1
+      - 2
+      - 3
+    valueWithMinMax:
+      - 1
+      - 2
+      - 3
+    valueWithMinEmpty: []
+    valueWithMaxEmpty: []
+  matchers:
+    url:
+      regex: /get/[0-9]
+      # predefined:
+      # execute a method
+      #command: 'equals($it)'
+    queryParameters:
+      - key: limit
+        type: equal_to
+        value: 20
+      - key: offset
+        type: containing
+        value: 20
+      - key: sort
+        type: equal_to
+        value: name
+      - key: search
+        type: not_matching
+        value: '^[0-9]{2}$'
+      - key: age
+        type: not_matching
+        value: '^\\w*$'
+      - key: name
+        type: matching
+        value: 'John.*'
+      - key: hello
+        type: absent
+    cookies:
+      - key: foo
+        regex: '[0-9]'
+      - key: bar
+        command: 'equals($it)'
+    headers:
+      - key: Content-Type
+        regex: "application/json.*"
+    body:
+      - path: $.duck
+        type: by_regex
+        value: "[0-9]{3}"
+      - path: $.duck
+        type: by_equality
+      - path: $.alpha
+        type: by_regex
+        predefined: only_alpha_unicode
+      - path: $.alpha
+        type: by_equality
+      - path: $.number
+        type: by_regex
+        predefined: number
+      - path: $.aBoolean
+        type: by_regex
+        predefined: any_boolean
+      - path: $.date
+        type: by_date
+      - path: $.dateTime
+        type: by_timestamp
+      - path: $.time
+        type: by_time
+      - path: "$.['key'].['complex.key']"
+        type: by_equality
+      - path: $.nullvalue
+        type: by_null
+      - path: $.valueWithMin
+        type: by_type
+        minOccurrence: 1
+      - path: $.valueWithMax
+        type: by_type
+        maxOccurrence: 3
+      - path: $.valueWithMinMax
+        type: by_type
+        minOccurrence: 1
+        maxOccurrence: 3
+response:
+  status: 200
+  cookies:
+    foo: 1
+    bar: 2
+  body:
+    duck: 123
+    alpha: "abc"
+    number: 123
+    aBoolean: true
+    date: "2017-01-01"
+    dateTime: "2017-01-01T01:23:45"
+    time: "01:02:34"
+    valueWithoutAMatcher: "foo"
+    valueWithTypeMatch: "string"
+    valueWithMin:
+      - 1
+      - 2
+      - 3
+    valueWithMax:
+      - 1
+      - 2
+      - 3
+    valueWithMinMax:
+      - 1
+      - 2
+      - 3
+    valueWithMinEmpty: []
+    valueWithMaxEmpty: []
+    key:
+      'complex.key': 'foo'
+    nulValue: null
+  matchers:
+    headers:
+      - key: Content-Type
+        regex: "application/json.*"
+    cookies:
+      - key: foo
+        regex: '[0-9]'
+      - key: bar
+        command: 'equals($it)'
+    body:
+      - path: $.duck
+        type: by_regex
+        value: "[0-9]{3}"
+      - path: $.duck
+        type: by_equality
+      - path: $.alpha
+        type: by_regex
+        predefined: only_alpha_unicode
+      - path: $.alpha
+        type: by_equality
+      - path: $.number
+        type: by_regex
+        predefined: number
+      - path: $.aBoolean
+        type: by_regex
+        predefined: any_boolean
+      - path: $.date
+        type: by_date
+      - path: $.dateTime
+        type: by_timestamp
+      - path: $.time
+        type: by_time
+      - path: $.valueWithTypeMatch
+        type: by_type
+      - path: $.valueWithMin
+        type: by_type
+        minOccurrence: 1
+      - path: $.valueWithMax
+        type: by_type
+        maxOccurrence: 3
+      - path: $.valueWithMinMax
+        type: by_type
+        minOccurrence: 1
+        maxOccurrence: 3
+      - path: $.valueWithMinEmpty
+        type: by_type
+        minOccurrence: 0
+      - path: $.valueWithMaxEmpty
+        type: by_type
+        maxOccurrence: 0
+      - path: $.duck
+        type: by_command
+        value: assertThatValueIsANumber($it)
+      - path: $.nullValue
+        type: by_null
+        value: null
+  headers:
+    Content-Type: application/json</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In the preceding example, you can see the dynamic portions of the contract in the
+<code>matchers</code> sections. For the request part, you can see that, for all fields but
+<code>valueWithoutAMatcher</code>, the values of the regular expressions that the stub should
+contain are explicitly set. For the <code>valueWithoutAMatcher</code>, the verification takes place
+in the same way as without the use of matchers. In that case, the test performs an
+equality check.</p>
+</div>
+<div class="paragraph">
+<p>For the response side in the <code>bodyMatchers</code> section, we define the dynamic parts in a
+similar manner. The only difference is that the <code>byType</code> matchers are also present. The
+verifier engine checks four fields to verify whether the response from the test
+has a value for which the JSON path matches the given field, is of the same type as the one
+defined in the response body, and passes the following check (based on the method being called):</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>For <code>$.valueWithTypeMatch</code>, the engine checks whether the type is the same.</p>
+</li>
+<li>
+<p>For <code>$.valueWithMin</code>, the engine checks the type and asserts whether the size is greater
+than or equal to the minimum occurrence.</p>
+</li>
+<li>
+<p>For <code>$.valueWithMax</code>, the engine checks the type and asserts whether the size is
+smaller than or equal to the maximum occurrence.</p>
+</li>
+<li>
+<p>For <code>$.valueWithMinMax</code>, the engine checks the type and asserts whether the size is
+between the minimum and maximum occurrence.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The resulting test resembles the following example (note that an <code>and</code> section
+separates the autogenerated assertions and the assertion from matchers):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">// given:
+ MockMvcRequestSpecification request = given()
+   .header("Content-Type", "application/json")
+   .body("{\"duck\":123,\"alpha\":\"abc\",\"number\":123,\"aBoolean\":true,\"date\":\"2017-01-01\",\"dateTime\":\"2017-01-01T01:23:45\",\"time\":\"01:02:34\",\"valueWithoutAMatcher\":\"foo\",\"valueWithTypeMatch\":\"string\",\"key\":{\"complex.key\":\"foo\"}}");
+
+// when:
+ ResponseOptions response = given().spec(request)
+   .get("/get");
+
+// then:
+ assertThat(response.statusCode()).isEqualTo(200);
+ assertThat(response.header("Content-Type")).matches("application/json.*");
+// and:
+ DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
+ assertThatJson(parsedJson).field("['valueWithoutAMatcher']").isEqualTo("foo");
+// and:
+ assertThat(parsedJson.read("$.duck", String.class)).matches("[0-9]{3}");
+ assertThat(parsedJson.read("$.duck", Integer.class)).isEqualTo(123);
+ assertThat(parsedJson.read("$.alpha", String.class)).matches("[\\p{L}]*");
+ assertThat(parsedJson.read("$.alpha", String.class)).isEqualTo("abc");
+ assertThat(parsedJson.read("$.number", String.class)).matches("-?(\\d*\\.\\d+|\\d+)");
+ assertThat(parsedJson.read("$.aBoolean", String.class)).matches("(true|false)");
+ assertThat(parsedJson.read("$.date", String.class)).matches("(\\d\\d\\d\\d)-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])");
+ assertThat(parsedJson.read("$.dateTime", String.class)).matches("([0-9]{4})-(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9])T(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])");
+ assertThat(parsedJson.read("$.time", String.class)).matches("(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9])");
+ assertThat((Object) parsedJson.read("$.valueWithTypeMatch")).isInstanceOf(java.lang.String.class);
+ assertThat((Object) parsedJson.read("$.valueWithMin")).isInstanceOf(java.util.List.class);
+ assertThat((java.lang.Iterable) parsedJson.read("$.valueWithMin", java.util.Collection.class)).as("$.valueWithMin").hasSizeGreaterThanOrEqualTo(1);
+ assertThat((Object) parsedJson.read("$.valueWithMax")).isInstanceOf(java.util.List.class);
+ assertThat((java.lang.Iterable) parsedJson.read("$.valueWithMax", java.util.Collection.class)).as("$.valueWithMax").hasSizeLessThanOrEqualTo(3);
+ assertThat((Object) parsedJson.read("$.valueWithMinMax")).isInstanceOf(java.util.List.class);
+ assertThat((java.lang.Iterable) parsedJson.read("$.valueWithMinMax", java.util.Collection.class)).as("$.valueWithMinMax").hasSizeBetween(1, 3);
+ assertThat((Object) parsedJson.read("$.valueWithMinEmpty")).isInstanceOf(java.util.List.class);
+ assertThat((java.lang.Iterable) parsedJson.read("$.valueWithMinEmpty", java.util.Collection.class)).as("$.valueWithMinEmpty").hasSizeGreaterThanOrEqualTo(0);
+ assertThat((Object) parsedJson.read("$.valueWithMaxEmpty")).isInstanceOf(java.util.List.class);
+ assertThat((java.lang.Iterable) parsedJson.read("$.valueWithMaxEmpty", java.util.Collection.class)).as("$.valueWithMaxEmpty").hasSizeLessThanOrEqualTo(0);
+ assertThatValueIsANumber(parsedJson.read("$.duck"));
+ assertThat(parsedJson.read("$.['key'].['complex.key']", String.class)).isEqualTo("foo");</code></pre>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Notice that, for the <code>byCommand</code> method, the example calls the
+<code>assertThatValueIsANumber</code>. This method must be defined in the test base class or be
+statically imported to your tests. Notice that the <code>byCommand</code> call was converted to
+<code>assertThatValueIsANumber(parsedJson.read("$.duck"));</code>. That means that the engine took
+the method name and passed the proper JSON path as a parameter to it.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The resulting WireMock stub is in the following example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">                    '''
+{
+  "request" : {
+    "urlPath" : "/get",
+    "method" : "POST",
+    "headers" : {
+      "Content-Type" : {
+        "matches" : "application/json.*"
+      }
+    },
+    "bodyPatterns" : [ {
+      "matchesJsonPath" : "$.['list'].['some'].['nested'][?(@.['anothervalue'] == 4)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.['valueWithoutAMatcher'] == 'foo')]"
+    }, {
+      "matchesJsonPath" : "$[?(@.['valueWithTypeMatch'] == 'string')]"
+    }, {
+      "matchesJsonPath" : "$.['list'].['someother'].['nested'][?(@.['json'] == 'with value')]"
+    }, {
+      "matchesJsonPath" : "$.['list'].['someother'].['nested'][?(@.['anothervalue'] == 4)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.duck =~ /([0-9]{3})/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.duck == 123)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.alpha =~ /([\\\\p{L}]*)/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.alpha == 'abc')]"
+    }, {
+      "matchesJsonPath" : "$[?(@.number =~ /(-?(\\\\d*\\\\.\\\\d+|\\\\d+))/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.aBoolean =~ /((true|false))/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.date =~ /((\\\\d\\\\d\\\\d\\\\d)-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01]))/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.dateTime =~ /(([0-9]{4})-(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9])T(2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9]))/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.time =~ /((2[0-3]|[01][0-9]):([0-5][0-9]):([0-5][0-9]))/)]"
+    }, {
+      "matchesJsonPath" : "$.list.some.nested[?(@.json =~ /(.*)/)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.valueWithMin.size() &gt;= 1)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.valueWithMax.size() &lt;= 3)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.valueWithMinMax.size() &gt;= 1 &amp;&amp; @.valueWithMinMax.size() &lt;= 3)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.valueWithOccurrence.size() &gt;= 4 &amp;&amp; @.valueWithOccurrence.size() &lt;= 4)]"
+    } ]
+  },
+  "response" : {
+    "status" : 200,
+    "body" : "{\\"date\\":\\"2017-01-01\\",\\"dateTime\\":\\"2017-01-01T01:23:45\\",\\"aBoolean\\":true,\\"valueWithMax\\":[1,2,3],\\"valueWithOccurrence\\":[1,2,3,4],\\"number\\":123,\\"duck\\":123,\\"alpha\\":\\"abc\\",\\"valueWithMin\\":[1,2,3],\\"time\\":\\"01:02:34\\",\\"valueWithTypeMatch\\":\\"string\\",\\"valueWithMinMax\\":[1,2,3],\\"valueWithoutAMatcher\\":\\"foo\\"}",
+    "headers" : {
+      "Content-Type" : "application/json"
+    },
+    "transformers" : [ "response-template" ]
+  }
+}
+'''</code></pre>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+If you use a <code>matcher</code>, the part of the request and response that the
+<code>matcher</code> addresses with the JSON Path gets removed from the assertion. In the case of
+verifying a collection, you must create matchers for <strong>all</strong> the elements of the
+collection.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Consider the following example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
+    request {
+        method 'GET'
+        url("/foo")
+    }
+    response {
+        status OK()
+        body(events: [[
+                                 operation          : 'EXPORT',
+                                 eventId            : '16f1ed75-0bcc-4f0d-a04d-3121798faf99',
+                                 status             : 'OK'
+                         ], [
+                                 operation          : 'INPUT_PROCESSING',
+                                 eventId            : '3bb4ac82-6652-462f-b6d1-75e424a0024a',
+                                 status             : 'OK'
+                         ]
+                ]
+        )
+        bodyMatchers {
+            jsonPath('$.events[0].operation', byRegex('.+'))
+            jsonPath('$.events[0].eventId', byRegex('^([a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})$'))
+            jsonPath('$.events[0].status', byRegex('.+'))
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The preceding code leads to creating the following test (the code block shows only the assertion section):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">and:
+    DocumentContext parsedJson = JsonPath.parse(response.body.asString())
+    assertThatJson(parsedJson).array("['events']").contains("['eventId']").isEqualTo("16f1ed75-0bcc-4f0d-a04d-3121798faf99")
+    assertThatJson(parsedJson).array("['events']").contains("['operation']").isEqualTo("EXPORT")
+    assertThatJson(parsedJson).array("['events']").contains("['operation']").isEqualTo("INPUT_PROCESSING")
+    assertThatJson(parsedJson).array("['events']").contains("['eventId']").isEqualTo("3bb4ac82-6652-462f-b6d1-75e424a0024a")
+    assertThatJson(parsedJson).array("['events']").contains("['status']").isEqualTo("OK")
+and:
+    assertThat(parsedJson.read("\$.events[0].operation", String.class)).matches(".+")
+    assertThat(parsedJson.read("\$.events[0].eventId", String.class)).matches("^([a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})\$")
+    assertThat(parsedJson.read("\$.events[0].status", String.class)).matches(".+")</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>As you can see, the assertion is malformed. Only the first element of the array got
+asserted. In order to fix this, you should apply the assertion to the whole <code>$.events</code>
+collection and assert it with the <code>byCommand(&#8230;&#8203;)</code> method.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-async"><a class="anchor" href="#contract-dsl-async"></a><a class="link" href="#contract-dsl-async">4.2.5. Asynchronous Support</a></h4>
+<div class="paragraph">
+<p>If you use asynchronous communication on the server side (your controllers are
+returning <code>Callable</code>, <code>DeferredResult</code>, and so on), then, inside your contract, you must
+provide an <code>async()</code> method in the <code>response</code> section. The following code shows an example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method GET()
+        url '/get'
+    }
+    response {
+        status OK()
+        body 'Passed'
+        async()
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">response:
+    async: true</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can also use the <code>fixedDelayMilliseconds</code> method or property to add delay to your stubs.
+The following example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method GET()
+        url '/get'
+    }
+    response {
+        status 200
+        body 'Passed'
+        fixedDelayMilliseconds 1000
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">response:
+    fixedDelayMilliseconds: 1000</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-xml"><a class="anchor" href="#contract-dsl-xml"></a><a class="link" href="#contract-dsl-xml">4.2.6. XML Support for HTTP</a></h4>
+<div class="paragraph">
+<p>For HTTP contracts, we also support using XML in the request and response body.
+The XML body has to be passed within the <code>body</code> element
+as a <code>String</code> or <code>GString</code>. Also, body matchers can be provided for
+both the request and the response. In place of the <code>jsonPath(&#8230;&#8203;)</code> method, the <code>org.springframework.cloud.contract.spec.internal.BodyMatchers.xPath</code>
+method should be used, with the desired <code>xPath</code> provided as the first argument
+and the appropriate <code>MatchingType</code> as second. All the body matchers apart from <code>byType()</code> are supported.</p>
+</div>
+<div class="paragraph">
+<p>The following example shows a Groovy DSL contract with XML in the response body:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">                    Contract.make {
+                        request {
+                            method GET()
+                            urlPath '/get'
+                            headers {
+                                contentType(applicationXml())
+                            }
+                        }
+                        response {
+                            status(OK())
+                            headers {
+                                contentType(applicationXml())
+                            }
+                            body """
+&lt;test&gt;
+&lt;duck type='xtype'&gt;123&lt;/duck&gt;
+&lt;alpha&gt;abc&lt;/alpha&gt;
+&lt;list&gt;
+&lt;elem&gt;abc&lt;/elem&gt;
+&lt;elem&gt;def&lt;/elem&gt;
+&lt;elem&gt;ghi&lt;/elem&gt;
+&lt;/list&gt;
+&lt;number&gt;123&lt;/number&gt;
+&lt;aBoolean&gt;true&lt;/aBoolean&gt;
+&lt;date&gt;2017-01-01&lt;/date&gt;
+&lt;dateTime&gt;2017-01-01T01:23:45&lt;/dateTime&gt;
+&lt;time&gt;01:02:34&lt;/time&gt;
+&lt;valueWithoutAMatcher&gt;foo&lt;/valueWithoutAMatcher&gt;
+&lt;key&gt;&lt;complex&gt;foo&lt;/complex&gt;&lt;/key&gt;
+&lt;/test&gt;"""
+                            bodyMatchers {
+                                xPath('/test/duck/text()', byRegex("[0-9]{3}"))
+                                xPath('/test/duck/text()', byCommand('equals($it)'))
+                                xPath('/test/duck/xxx', byNull())
+                                xPath('/test/duck/text()', byEquality())
+                                xPath('/test/alpha/text()', byRegex(onlyAlphaUnicode()))
+                                xPath('/test/alpha/text()', byEquality())
+                                xPath('/test/number/text()', byRegex(number()))
+                                xPath('/test/date/text()', byDate())
+                                xPath('/test/dateTime/text()', byTimestamp())
+                                xPath('/test/time/text()', byTime())
+                                xPath('/test/*/complex/text()', byEquality())
+                                xPath('/test/duck/@type', byEquality())
+                            }
+                        }
+                    }</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">include::/home/marcin/repo/spring-cloud-contract/spring-cloud-contract-verifier/src/test/resources/yml/contract_rest_xml.yml</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example shows an automatically generated test for XML in the response body:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
+public void validate_xmlMatches() throws Exception {
+    // given:
+    MockMvcRequestSpecification request = given()
+                .header("Content-Type", "application/xml");
+
+    // when:
+    ResponseOptions response = given().spec(request).get("/get");
+
+    // then:
+    assertThat(response.statusCode()).isEqualTo(200);
+    // and:
+    DocumentBuilder documentBuilder = DocumentBuilderFactory.newInstance()
+                    .newDocumentBuilder();
+    Document parsedXml = documentBuilder.parse(new InputSource(
+                new StringReader(response.getBody().asString())));
+    // and:
+    assertThat(valueFromXPath(parsedXml, "/test/list/elem/text()")).isEqualTo("abc");
+    assertThat(valueFromXPath(parsedXml,"/test/list/elem[2]/text()")).isEqualTo("def");
+    assertThat(valueFromXPath(parsedXml, "/test/duck/text()")).matches("[0-9]{3}");
+    assertThat(nodeFromXPath(parsedXml, "/test/duck/xxx")).isNull();
+    assertThat(valueFromXPath(parsedXml, "/test/alpha/text()")).matches("[\\p{L}]*");
+    assertThat(valueFromXPath(parsedXml, "/test/*/complex/text()")).isEqualTo("foo");
+    assertThat(valueFromXPath(parsedXml, "/test/duck/@type")).isEqualTo("xtype");
+    }</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-multiple"><a class="anchor" href="#contract-dsl-multiple"></a><a class="link" href="#contract-dsl-multiple">4.2.7. Multiple Contracts in One File</a></h4>
+<div class="paragraph">
+<p>You can define multiple contracts in one file. Such a contract might resemble the
+following example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">import org.springframework.cloud.contract.spec.Contract
+
+[
+    Contract.make {
+        name("should post a user")
+        request {
+            method 'POST'
+            url('/users/1')
+        }
+        response {
+            status OK()
+        }
+    },
+    Contract.make {
+        request {
+            method 'POST'
+            url('/users/2')
+        }
+        response {
+            status OK()
+        }
+    }
+]</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">---
+name: should post a user
+request:
+  method: POST
+  url: /users/1
+response:
+  status: 200
+---
+request:
+  method: POST
+  url: /users/2
+response:
+  status: 200
+---
+request:
+  method: POST
+  url: /users/3
+response:
+  status: 200</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In the preceding example, one contract has the <code>name</code> field and the other does not. This
+leads to generation of two tests that look more or less like the following:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package org.springframework.cloud.contract.verifier.tests.com.hello;
+
+import com.example.TestBase;
+import com.jayway.jsonpath.DocumentContext;
+import com.jayway.jsonpath.JsonPath;
+import com.jayway.restassured.module.mockmvc.specification.MockMvcRequestSpecification;
+import com.jayway.restassured.response.ResponseOptions;
+import org.junit.Test;
+
+import static com.jayway.restassured.module.mockmvc.RestAssuredMockMvc.*;
+import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson;
+import static org.assertj.core.api.Assertions.assertThat;
+
+public class V1Test extends TestBase {
+
+    @Test
+    public void validate_should_post_a_user() throws Exception {
+        // given:
+            MockMvcRequestSpecification request = given();
+
+        // when:
+            ResponseOptions response = given().spec(request)
+                    .post("/users/1");
+
+        // then:
+            assertThat(response.statusCode()).isEqualTo(200);
+    }
+
+    @Test
+    public void validate_withList_1() throws Exception {
+        // given:
+            MockMvcRequestSpecification request = given();
+
+        // when:
+            ResponseOptions response = given().spec(request)
+                    .post("/users/2");
+
+        // then:
+            assertThat(response.statusCode()).isEqualTo(200);
+    }
+
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Notice that, for the contract that has the <code>name</code> field, the generated test method is named
+<code>validate_should_post_a_user</code>. The one that does not have the <code>name</code> field is called
+<code>validate_withList_1</code>. It corresponds to the name of the file <code>WithList.groovy</code> and the
+index of the contract in the list.</p>
+</div>
+<div class="paragraph">
+<p>The generated stubs are shown in the following example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code>should post a user.json
+1_WithList.json</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The first file got the <code>name</code> parameter from the contract. The second
+got the name of the contract file (<code>WithList.groovy</code>) prefixed with the index (in this
+case, the contract had an index of <code>1</code> in the list of contracts in the file).</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+It is much better to name your contracts, because doing so makes
+your tests far more meaningful.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect3">
+<h4 id="contract-stateful-contracts"><a class="anchor" href="#contract-stateful-contracts"></a><a class="link" href="#contract-stateful-contracts">4.2.8. Stateful Contracts</a></h4>
+<div class="paragraph">
+<p>Stateful contracts (known also as scenarios) are contract definitions that should be read
+in order. This might be useful in the following situations:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>You want to execute the contract in a precisely defined order, since you use Spring
+Cloud Contract to test your stateful application</p>
+</li>
+</ul>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+We really discourage you from doing that, since contract tests should be stateless.
+</td>
+</tr>
+</table>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>You want the same endpoint to return different results for the same request.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>To create stateful contracts (or scenarios), you need to
+use the proper naming convention while creating your contracts. The convention
+requires including an order number followed by an underscore. This works regardless
+of whether you work with YAML or Groovy. The following listing shows an example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code>my_contracts_dir\
+  scenario1\
+    1_login.groovy
+    2_showCart.groovy
+    3_logout.groovy</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Such a tree causes Spring Cloud Contract Verifier to generate WireMock&#8217;s scenario with a
+name of <code>scenario1</code> and the three following steps:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>login, marked as <code>Started</code> pointing to&#8230;&#8203;</p>
+</li>
+<li>
+<p>showCart, marked as <code>Step1</code> pointing to&#8230;&#8203;</p>
+</li>
+<li>
+<p>logout, marked as <code>Step2</code> (which closes the scenario).</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>You can find nore details about WireMock scenarios at
+<a href="https://wiremock.org/docs/stateful-behaviour/">https://wiremock.org/docs/stateful-behaviour/</a>.</p>
+</div>
+<div class="paragraph">
+<p>Spring Cloud Contract also generates tests with a guaranteed order of execution.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="feature-integrations"><a class="anchor" href="#feature-integrations"></a><a class="link" href="#feature-integrations">4.3. Integrations</a></h3>
+<div class="sect3">
+<h4 id="features-jax-rs"><a class="anchor" href="#features-jax-rs"></a><a class="link" href="#features-jax-rs">4.3.1. JAX-RS</a></h4>
+<div class="paragraph">
+<p>The Spring Cloud Contract supports the JAX-RS 2 Client API. The base class needs
+to define <code>protected WebTarget webTarget</code> and server initialization. The only option for
+testing JAX-RS API is to start a web server. Also, a request with a body needs to have a
+content type be set. Otherwise, the default of <code>application/octet-stream</code> gets used.</p>
+</div>
+<div class="paragraph">
+<p>In order to use JAX-RS mode, use the following settings:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testMode == 'JAXRSCLIENT'</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example shows a generated test API:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">                    """\
+package com.example;
+
+import com.jayway.jsonpath.DocumentContext;
+import com.jayway.jsonpath.JsonPath;
+import org.junit.Test;
+import org.junit.Rule;
+import javax.ws.rs.client.Entity;
+import javax.ws.rs.core.Response;
+
+import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat;
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*;
+import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson;
+import static javax.ws.rs.client.Entity.*;
+
+@SuppressWarnings("rawtypes")
+public class FooTest {
+\tWebTarget webTarget;
+
+\t@Test
+\tpublic void validate_() throws Exception {
+
+\t\t// when:
+\t\t\tResponse response = webTarget
+\t\t\t\t\t\t\t.path("/users")
+\t\t\t\t\t\t\t.queryParam("limit", "10")
+\t\t\t\t\t\t\t.queryParam("offset", "20")
+\t\t\t\t\t\t\t.queryParam("filter", "email")
+\t\t\t\t\t\t\t.queryParam("sort", "name")
+\t\t\t\t\t\t\t.queryParam("search", "55")
+\t\t\t\t\t\t\t.queryParam("age", "99")
+\t\t\t\t\t\t\t.queryParam("name", "Denis.Stepanov")
+\t\t\t\t\t\t\t.queryParam("email", "bob@email.com")
+\t\t\t\t\t\t\t.request()
+\t\t\t\t\t\t\t.build("GET")
+\t\t\t\t\t\t\t.invoke();
+\t\t\tString responseAsString = response.readEntity(String.class);
+
+\t\t// then:
+\t\t\tassertThat(response.getStatus()).isEqualTo(200);
+
+\t\t// and:
+\t\t\tDocumentContext parsedJson = JsonPath.parse(responseAsString);
+\t\t\tassertThatJson(parsedJson).field("['property1']").isEqualTo("a");
+\t}
+
+}
+
+"""</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="feature-webflux"><a class="anchor" href="#feature-webflux"></a><a class="link" href="#feature-webflux">4.3.2. WebFlux with WebTestClient</a></h4>
+<div class="paragraph">
+<p>You can work with WebFlux by using WebTestClient. The following listing shows how to
+configure WebTestClient as the test mode:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;testMode&gt;WEBTESTCLIENT&lt;/testMode&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+        testMode = 'WEBTESTCLIENT'
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example shows how to set up a WebTestClient base class and RestAssured
+for WebFlux:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">import io.restassured.module.webtestclient.RestAssuredWebTestClient;
+import org.junit.Before;
+
+public abstract class BeerRestBase {
+
+    @Before
+    public void setup() {
+        RestAssuredWebTestClient.standaloneSetup(
+        new ProducerController(personToCheck -&gt; personToCheck.age &gt;= 20));
+    }
+}
+}</code></pre>
+</div>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+The <code>WebTestClient</code> mode is faster than the <code>EXPLICIT</code> mode.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect3">
+<h4 id="feature-webflux-explicit"><a class="anchor" href="#feature-webflux-explicit"></a><a class="link" href="#feature-webflux-explicit">4.3.3. WebFlux with Explicit Mode</a></h4>
+<div class="paragraph">
+<p>You can also use WebFlux with the explicit mode in your generated tests
+to work with WebFlux. The following example shows how to configure using explicit mode:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;testMode&gt;EXPLICIT&lt;/testMode&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+        testMode = 'EXPLICIT'
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example shows how to set up a base class and RestAssured for Web Flux:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@RunWith(SpringRunner.class)
+@SpringBootTest(classes = BeerRestBase.Config.class,
+        webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT,
+        properties = "server.port=0")
+public abstract class BeerRestBase {
+
+    // your tests go here
+
+    // in this config class you define all controllers and mocked services
+@Configuration
+@EnableAutoConfiguration
+static class Config {
+
+    @Bean
+    PersonCheckingService personCheckingService()  {
+        return personToCheck -&gt; personToCheck.age &gt;= 20;
+    }
+
+    @Bean
+    ProducerController producerController() {
+        return new ProducerController(personCheckingService());
+    }
+}
+
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-context-paths"><a class="anchor" href="#features-context-paths"></a><a class="link" href="#features-context-paths">4.3.4. Working with Context Paths</a></h4>
+<div class="paragraph">
+<p>Spring Cloud Contract supports context paths.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>The only change needed to fully support context paths is the switch on the
+producer side. Also, the autogenerated tests must use explicit mode. The  consumer
+side remains untouched. In order for the generated test to pass, you must use explicit
+mode. The following example shows how to set the test mode to <code>EXPLICIT</code>:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;testMode&gt;EXPLICIT&lt;/testMode&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+        testMode = 'EXPLICIT'
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>That way, you generate a test that does not use MockMvc. It means that you generate
+real requests and you need to set up your generated test&#8217;s base class to work on a real
+socket.</p>
+</div>
+<div class="paragraph">
+<p>Consider the following contract:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">org.springframework.cloud.contract.spec.Contract.make {
+    request {
+        method 'GET'
+        url '/my-context-path/url'
+    }
+    response {
+        status OK()
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example shows how to set up a base class and RestAssured:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">import io.restassured.RestAssured;
+import org.junit.Before;
+import org.springframework.boot.web.server.LocalServerPort;
+import org.springframework.boot.test.context.SpringBootTest;
+
+@SpringBootTest(classes = ContextPathTestingBaseClass.class, webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
+class ContextPathTestingBaseClass {
+
+    @LocalServerPort int port;
+
+    @Before
+    public void setup() {
+        RestAssured.baseURI = "http://localhost";
+        RestAssured.port = this.port;
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>If you do it this way:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>All of your requests in the autogenerated tests are sent to the real endpoint with your
+context path included (for example, <code>/my-context-path/url</code>).</p>
+</li>
+<li>
+<p>Your contracts reflect that you have a context path. Your generated stubs also have
+that information (for example, in the stubs, you have to call <code>/my-context-path/url</code>).</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-rest-docs"><a class="anchor" href="#features-rest-docs"></a><a class="link" href="#features-rest-docs">4.3.5. Working with REST Docs</a></h4>
+<div class="paragraph">
+<p>You can use <a href="https://projects.spring.io/spring-restdocs">Spring REST Docs</a> to generate
+documentation (for example, in Asciidoc format) for an HTTP API with Spring MockMvc,
+<code>WebTestClient</code>, or RestAssured. At the same time that you generate documentation for your API, you can also
+generate WireMock stubs by using Spring Cloud Contract WireMock. To do so, write your
+normal REST Docs test cases and use <code>@AutoConfigureRestDocs</code> to have stubs be
+automatically generated in the REST Docs output directory.</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/rest-docs.png" alt="rest docs" width="1237" height="835">
+</div>
+</div>
+<div class="paragraph">
+<p>The following example uses <code>MockMvc</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
+@SpringBootTest
+@AutoConfigureRestDocs(outputDir = "target/snippets")
+@AutoConfigureMockMvc
+public class ApplicationTests {
+
+    @Autowired
+    private MockMvc mockMvc;
+
+    @Test
+    public void contextLoads() throws Exception {
+        mockMvc.perform(get("/resource"))
+                .andExpect(content().string("Hello World"))
+                .andDo(document("resource"));
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This test generates a WireMock stub at <code>target/snippets/stubs/resource.json</code>. It matches
+all <code>GET</code> requests to the <code>/resource</code> path. The same example with <code>WebTestClient</code> (used
+for testing Spring WebFlux applications) would be as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
+@SpringBootTest
+@AutoConfigureRestDocs(outputDir = "target/snippets")
+@AutoConfigureWebTestClient
+public class ApplicationTests {
+
+    @Autowired
+    private WebTestClient client;
+
+    @Test
+    public void contextLoads() throws Exception {
+        client.get().uri("/resource").exchange()
+                .expectBody(String.class).isEqualTo("Hello World")
+                .consumeWith(document("resource"));
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Without any additional configuration, these tests create a stub with a request matcher
+for the HTTP method and all headers except <code>host</code> and <code>content-length</code>. To match the
+request more precisely (for example, to match the body of a POST or PUT), we need to
+explicitly create a request matcher. Doing so has two effects:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Creating a stub that matches only in the way you specify.</p>
+</li>
+<li>
+<p>Asserting that the request in the test case also matches the same conditions.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The main entry point for this feature is <code>WireMockRestDocs.verify()</code>, which can be used
+as a substitute for the <code>document()</code> convenience method, as the following
+example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">import static org.springframework.cloud.contract.wiremock.restdocs.WireMockRestDocs.verify;
+
+@RunWith(SpringRunner.class)
+@SpringBootTest
+@AutoConfigureRestDocs(outputDir = "target/snippets")
+@AutoConfigureMockMvc
+public class ApplicationTests {
+
+    @Autowired
+    private MockMvc mockMvc;
+
+    @Test
+    public void contextLoads() throws Exception {
+        mockMvc.perform(post("/resource")
+                .content("{\"id\":\"123456\",\"message\":\"Hello World\"}"))
+                .andExpect(status().isOk())
+                .andDo(verify().jsonPath("$.id")
+                        .stub("resource"));
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The preceding contract specifies that any valid POST with an <code>id</code> field receives the response
+defined in this test. You can chain together calls to <code>.jsonPath()</code> to add additional
+matchers. If JSON Path is unfamiliar, the <a href="https://github.com/jayway/JsonPath">JayWay
+documentation</a> can help you get up to speed. The <code>WebTestClient</code> version of this test
+has a similar <code>verify()</code> static helper that you insert in the same place.</p>
+</div>
+<div class="paragraph">
+<p>Instead of the <code>jsonPath</code> and <code>contentType</code> convenience methods, you can also use the
+WireMock APIs to verify that the request matches the created stub, as the
+following example shows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
+public void contextLoads() throws Exception {
+    mockMvc.perform(post("/resource")
+            .content("{\"id\":\"123456\",\"message\":\"Hello World\"}"))
+            .andExpect(status().isOk())
+            .andDo(verify()
+                    .wiremock(WireMock.post(
+                        urlPathEquals("/resource"))
+                        .withRequestBody(matchingJsonPath("$.id"))
+                    .stub("post-resource"));
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The WireMock API is rich. You can match headers, query parameters, and the request body by
+regex as well as by JSON path. You can use these features to create stubs with a wider
+range of parameters. The preceding example generates a stub resembling the following example:</p>
+</div>
+<div class="listingblock">
+<div class="title">post-resource.json</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+  "request" : {
+    "url" : "/resource",
+    "method" : "POST",
+    "bodyPatterns" : [ {
+      "matchesJsonPath" : "$.id"
+    }]
+  },
+  "response" : {
+    "status" : 200,
+    "body" : "Hello World",
+    "headers" : {
+      "X-Application-Context" : "application:-1",
+      "Content-Type" : "text/plain"
+    }
+  }
+}</code></pre>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+You can use either the <code>wiremock()</code> method or the <code>jsonPath()</code> and <code>contentType()</code>
+methods to create request matchers, but you cannot use both approaches.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>On the consumer side, you can make the <code>resource.json</code> generated earlier in this section
+available on the classpath (by
+<a href="#features-stub-runner-publishing-stubs-as-jars">Publishing Stubs as JARs</a>, for example). After that, you can create a stub that uses WireMock in a
+number of different ways, including by using
+<code>@AutoConfigureWireMock(stubs="classpath:resource.json")</code>, as described earlier in this
+document.</p>
+</div>
+<div class="sect4">
+<h5 id="features-rest-docs-contracts"><a class="anchor" href="#features-rest-docs-contracts"></a><a class="link" href="#features-rest-docs-contracts">Generating Contracts with REST Docs</a></h5>
+<div class="paragraph">
+<p>You can also generate Spring Cloud Contract DSL files and documentation with Spring REST
+Docs. If you do so in combination with Spring Cloud WireMock, you get both the contracts
+and the stubs.</p>
+</div>
+<div class="paragraph">
+<p>Why would you want to use this feature? Some people in the community asked questions
+about a situation in which they would like to move to DSL-based contract definition,
+but they already have a lot of Spring MVC tests. Using this feature lets you generate
+the contract files that you can later modify and move to folders (defined in your
+configuration) so that the plugin finds them.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+You might wonder why this functionality is in the WireMock module. The functionality
+is there because it makes sense to generate both the contracts and the stubs.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Consider the following test:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">        this.mockMvc
+                .perform(post("/foo").accept(MediaType.APPLICATION_PDF)
+                        .accept(MediaType.APPLICATION_JSON)
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content("{\"foo\": 23, \"bar\" : \"baz\" }"))
+                .andExpect(status().isOk()).andExpect(content().string("bar"))
+                // first WireMock
+                .andDo(WireMockRestDocs.verify().jsonPath("$[?(@.foo &gt;= 20)]")
+                        .jsonPath("$[?(@.bar in ['baz','bazz','bazzz'])]")
+                        .contentType(MediaType.valueOf("application/json"))
+                        .stub("shouldGrantABeerIfOldEnough"))
+                // then Contract DSL documentation
+                .andDo(document("index", SpringCloudContractRestDocs.dslContract()));</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The preceding test creates the stub presented in the previous section, generating both
+the contract and a documentation file.</p>
+</div>
+<div class="paragraph">
+<p>The contract is called <code>index.groovy</code> and might resemble the following example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">import org.springframework.cloud.contract.spec.Contract
+
+Contract.make {
+    request {
+        method 'POST'
+        url '/foo'
+        body('''
+            {"foo": 23 }
+        ''')
+        headers {
+            header('''Accept''', '''application/json''')
+            header('''Content-Type''', '''application/json''')
+        }
+    }
+    response {
+        status OK()
+        body('''
+        bar
+        ''')
+        headers {
+            header('''Content-Type''', '''application/json;charset=UTF-8''')
+            header('''Content-Length''', '''3''')
+        }
+        testMatchers {
+            jsonPath('$[?(@.foo &gt;= 20)]', byType())
+        }
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The generated document (formatted in Asciidoc in this case) contains a formatted
+contract. The location of this file would be <code>index/dsl-contract.adoc</code>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-messaging"><a class="anchor" href="#features-messaging"></a><a class="link" href="#features-messaging">4.4. Messaging</a></h3>
+<div class="paragraph">
+<p>Spring Cloud Contract lets you verify applications that use messaging as a
+means of communication. All of the integrations shown in this document work with Spring,
+but you can also create one of your own and use that.</p>
+</div>
+<div class="sect3">
+<h4 id="contract-dsl-messaging-top-level"><a class="anchor" href="#contract-dsl-messaging-top-level"></a><a class="link" href="#contract-dsl-messaging-top-level">4.4.1. Messaging DSL Top-Level Elements</a></h4>
+<div class="paragraph">
+<p>The DSL for messaging looks a little bit different than the one that focuses on HTTP. The
+following sections explain the differences:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#contract-dsl-output-triggered-method">Output Triggered by a Method</a></p>
+</li>
+<li>
+<p><a href="#contract-dsl-output-triggered-message">Output Triggered by a Message</a></p>
+</li>
+<li>
+<p><a href="#contract-dsl-consumer-producer">Consumer/Producer</a></p>
+</li>
+<li>
+<p><a href="#contract-dsl-messaging-common">Common</a></p>
+</li>
+</ul>
+</div>
+<div class="sect4">
+<h5 id="contract-dsl-output-triggered-method"><a class="anchor" href="#contract-dsl-output-triggered-method"></a><a class="link" href="#contract-dsl-output-triggered-method">Output Triggered by a Method</a></h5>
+<div class="paragraph">
+<p>The output message can be triggered by calling a method (such as a <code>Scheduler</code> when a contract was
+started and a message was sent), as shown in the following example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">def dsl = Contract.make {
+    // Human readable description
+    description 'Some description'
+    // Label by means of which the output message can be triggered
+    label 'some_label'
+    // input to the contract
+    input {
+        // the contract will be triggered by a method
+        triggeredBy('bookReturnedTriggered()')
+    }
+    // output message of the contract
+    outputMessage {
+        // destination to which the output message will be sent
+        sentTo('output')
+        // the body of the output message
+        body('''{ "bookName" : "foo" }''')
+        // the headers of the output message
+        headers {
+            header('BOOK-NAME', 'foo')
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy"># Human readable description
+description: Some description
+# Label by means of which the output message can be triggered
+label: some_label
+input:
+  # the contract will be triggered by a method
+  triggeredBy: bookReturnedTriggered()
+# output message of the contract
+outputMessage:
+  # destination to which the output message will be sent
+  sentTo: output
+  # the body of the output message
+  body:
+    bookName: foo
+  # the headers of the output message
+  headers:
+    BOOK-NAME: foo</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In the previous example case, the output message is sent to <code>output</code> if a method called
+<code>bookReturnedTriggered</code> is executed. On the message publisher&#8217;s side, we generate a
+test that calls that method to trigger the message. On the consumer side, you can use
+the <code>some_label</code> to trigger the message.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="contract-dsl-output-triggered-message"><a class="anchor" href="#contract-dsl-output-triggered-message"></a><a class="link" href="#contract-dsl-output-triggered-message">Output Triggered by a Message</a></h5>
+<div class="paragraph">
+<p>The output message can be triggered by receiving a message, as shown in the following
+example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">def dsl = Contract.make {
+    description 'Some Description'
+    label 'some_label'
+    // input is a message
+    input {
+        // the message was received from this destination
+        messageFrom('input')
+        // has the following body
+        messageBody([
+                bookName: 'foo'
+        ])
+        // and the following headers
+        messageHeaders {
+            header('sample', 'header')
+        }
+    }
+    outputMessage {
+        sentTo('output')
+        body([
+                bookName: 'foo'
+        ])
+        headers {
+            header('BOOK-NAME', 'foo')
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy"># Human readable description
+description: Some description
+# Label by means of which the output message can be triggered
+label: some_label
+# input is a message
+input:
+  messageFrom: input
+  # has the following body
+  messageBody:
+    bookName: 'foo'
+  # and the following headers
+  messageHeaders:
+    sample: 'header'
+# output message of the contract
+outputMessage:
+  # destination to which the output message will be sent
+  sentTo: output
+  # the body of the output message
+  body:
+    bookName: foo
+  # the headers of the output message
+  headers:
+    BOOK-NAME: foo</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In the preceding example, the output message is sent to <code>output</code> if a proper message is
+received on the <code>input</code> destination. On the message publisher&#8217;s side, the engine
+generates a test that sends the input message to the defined destination. On the
+consumer side, you can either send a message to the input destination or use a label
+(<code>some_label</code> in the example) to trigger the message.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="contract-dsl-consumer-producer"><a class="anchor" href="#contract-dsl-consumer-producer"></a><a class="link" href="#contract-dsl-consumer-producer">Consumer/Producer</a></h5>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+This section is valid only for Groovy DSL.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>In HTTP, you have a notion of <code>client</code>/<code>stub and `server</code>/<code>test</code> notation. You can also
+use those paradigms in messaging. In addition, Spring Cloud Contract Verifier also
+provides the <code>consumer</code> and <code>producer</code> methods, as presented in the following example
+(note that you can use either <code>$</code> or <code>value</code> methods to provide <code>consumer</code> and <code>producer</code>
+parts):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">                    Contract.make {
+                name "foo"
+                        label 'some_label'
+                        input {
+                            messageFrom value(consumer('jms:output'), producer('jms:input'))
+                            messageBody([
+                                    bookName: 'foo'
+                            ])
+                            messageHeaders {
+                                header('sample', 'header')
+                            }
+                        }
+                        outputMessage {
+                            sentTo $(consumer('jms:input'), producer('jms:output'))
+                            body([
+                                    bookName: 'foo'
+                            ])
+                        }
+                    }</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="contract-dsl-messaging-common"><a class="anchor" href="#contract-dsl-messaging-common"></a><a class="link" href="#contract-dsl-messaging-common">Common</a></h5>
+<div class="paragraph">
+<p>In the <code>input</code> or <code>outputMessage</code> section, you can call <code>assertThat</code> with the name
+of a <code>method</code> (for example, <code>assertThatMessageIsOnTheQueue()</code>) that you have defined in the
+base class or in a static import. Spring Cloud Contract runs that method
+in the generated test.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-integrations"><a class="anchor" href="#features-messaging-integrations"></a><a class="link" href="#features-messaging-integrations">4.4.2. Integrations</a></h4>
+<div class="paragraph">
+<p>You can use one of the following four integration configurations:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Apache Camel</p>
+</li>
+<li>
+<p>Spring Integration</p>
+</li>
+<li>
+<p>Spring Cloud Stream</p>
+</li>
+<li>
+<p>Spring AMQP</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Since we use Spring Boot, if you have added one of these libraries to the classpath, all
+the messaging configuration is automatically set up.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Remember to put <code>@AutoConfigureMessageVerifier</code> on the base class of your
+generated tests. Otherwise, the messaging part of Spring Cloud Contract does not
+work.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>If you want to use Spring Cloud Stream, remember to add a dependency on
+<code>org.springframework.cloud:spring-cloud-stream-test-support</code>, as  follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-stream-test-support&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile "org.springframework.cloud:spring-cloud-stream-test-support"</code></pre>
+</div>
+</div>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-manual"><a class="anchor" href="#features-messaging-manual"></a><a class="link" href="#features-messaging-manual">Manual Integration Testing</a></h5>
+<div class="paragraph">
+<p>The main interface used by the tests is
+<code>org.springframework.cloud.contract.verifier.messaging.MessageVerifier</code>.
+It defines how to send and receive messages. You can create your own implementation to
+achieve the same goal.</p>
+</div>
+<div class="paragraph">
+<p>In a test, you can inject a <code>ContractVerifierMessageExchange</code> to send and receive
+messages that follow the contract. Then add <code>@AutoConfigureMessageVerifier</code> to your test.
+The following example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringTestRunner.class)
+@SpringBootTest
+@AutoConfigureMessageVerifier
+public static class MessagingContractTests {
+
+  @Autowired
+  private MessageVerifier verifier;
+  ...
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+If your tests require stubs as well, then <code>@AutoConfigureStubRunner</code> includes the
+messaging configuration, so you only need the one annotation.
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-test-generation"><a class="anchor" href="#features-messaging-test-generation"></a><a class="link" href="#features-messaging-test-generation">4.4.3. Producer Side  Messaging Test Generation</a></h4>
+<div class="paragraph">
+<p>Having the <code>input</code> or <code>outputMessage</code> sections in your DSL results in creation of tests
+on the publisher&#8217;s side. By default, JUnit 4 tests are created. However, there is also a
+possibility to create JUnit 5, TestNG, or Spock tests.</p>
+</div>
+<div class="paragraph">
+<p>There are three main scenarios that we should take into consideration:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Scenario 1: There is no input message that produces an output message. The output
+message  is triggered by a component inside the application (for example, a scheduler).</p>
+</li>
+<li>
+<p>Scenario 2: The input message triggers an output message.</p>
+</li>
+<li>
+<p>Scenario 3: The input message is consumed, and there is no output message.</p>
+</li>
+</ul>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+The destination passed to <code>messageFrom</code> or <code>sentTo</code> can have different
+meanings for different messaging implementations. For Stream and Integration, it is
+first resolved as a <code>destination</code> of a channel. Then, if there is no such <code>destination</code>
+it is resolved as a channel name. For Camel, that&#8217;s a certain component (for example,
+<code>jms</code>).
+</td>
+</tr>
+</table>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-scenario1"><a class="anchor" href="#features-messaging-scenario1"></a><a class="link" href="#features-messaging-scenario1">Scenario 1: No Input Message</a></h5>
+<div class="paragraph">
+<p>Consider the following contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">def contractDsl = Contract.make {
+    name "foo"
+    label 'some_label'
+    input {
+        triggeredBy('bookReturnedTriggered()')
+    }
+    outputMessage {
+        sentTo('activemq:output')
+        body('''{ "bookName" : "foo" }''')
+        headers {
+            header('BOOK-NAME', 'foo')
+            messagingContentType(applicationJson())
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">label: some_label
+input:
+  triggeredBy: bookReturnedTriggered
+outputMessage:
+  sentTo: activemq:output
+  body:
+    bookName: foo
+  headers:
+    BOOK-NAME: foo
+    contentType: application/json</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>For the preceding example, the following test would be created:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">JUnit</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">                    '''\
+package com.example;
+
+import com.jayway.jsonpath.DocumentContext;
+import com.jayway.jsonpath.JsonPath;
+import org.junit.Test;
+import org.junit.Rule;
+import javax.inject.Inject;
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierObjectMapper;
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessage;
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessaging;
+
+import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat;
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*;
+import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson;
+import static org.springframework.cloud.contract.verifier.messaging.util.ContractVerifierMessagingUtil.headers;
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.fileToBytes;
+
+@SuppressWarnings("rawtypes")
+public class FooTest {
+\t@Inject ContractVerifierMessaging contractVerifierMessaging;
+\t@Inject ContractVerifierObjectMapper contractVerifierObjectMapper;
+
+\t@Test
+\tpublic void validate_foo() throws Exception {
+\t\t// when:
+\t\t\tbookReturnedTriggered();
+
+\t\t// then:
+\t\t\tContractVerifierMessage response = contractVerifierMessaging.receive("activemq:output");
+\t\t\tassertThat(response).isNotNull();
+
+\t\t// and:
+\t\t\tassertThat(response.getHeader("BOOK-NAME")).isNotNull();
+\t\t\tassertThat(response.getHeader("BOOK-NAME").toString()).isEqualTo("foo");
+\t\t\tassertThat(response.getHeader("contentType")).isNotNull();
+\t\t\tassertThat(response.getHeader("contentType").toString()).isEqualTo("application/json");
+
+\t\t// and:
+\t\t\tDocumentContext parsedJson = JsonPath.parse(contractVerifierObjectMapper.writeValueAsString(response.getPayload()));
+\t\t\tassertThatJson(parsedJson).field("['bookName']").isEqualTo("foo");
+\t}
+
+}
+
+'''</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Spock</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">                    '''\
+package com.example
+
+import com.jayway.jsonpath.DocumentContext
+import com.jayway.jsonpath.JsonPath
+import spock.lang.Specification
+import javax.inject.Inject
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierObjectMapper
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessage
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessaging
+
+import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*
+import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson
+import static org.springframework.cloud.contract.verifier.messaging.util.ContractVerifierMessagingUtil.headers
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.fileToBytes
+
+@SuppressWarnings("rawtypes")
+class FooSpec extends Specification {
+\t@Inject ContractVerifierMessaging contractVerifierMessaging
+\t@Inject ContractVerifierObjectMapper contractVerifierObjectMapper
+
+\tdef validate_foo() throws Exception {
+\t\twhen:
+\t\t\tbookReturnedTriggered()
+
+\t\tthen:
+\t\t\tContractVerifierMessage response = contractVerifierMessaging.receive("activemq:output")
+\t\t\tresponse != null
+
+\t\tand:
+\t\t\tresponse.getHeader("BOOK-NAME") != null
+\t\t\tresponse.getHeader("BOOK-NAME").toString() == 'foo'
+\t\t\tresponse.getHeader("contentType") != null
+\t\t\tresponse.getHeader("contentType").toString() == 'application/json'
+
+\t\tand:
+\t\t\tDocumentContext parsedJson = JsonPath.parse(contractVerifierObjectMapper.writeValueAsString(response.getPayload()))
+\t\t\tassertThatJson(parsedJson).field("['bookName']").isEqualTo("foo")
+\t}
+
+}
+
+'''</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-scenario2"><a class="anchor" href="#features-messaging-scenario2"></a><a class="link" href="#features-messaging-scenario2">Scenario 2: Output Triggered by Input</a></h5>
+<div class="paragraph">
+<p>Consider the following contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">def contractDsl = Contract.make {
+    name "foo"
+    label 'some_label'
+    input {
+        messageFrom('jms:input')
+        messageBody([
+                bookName: 'foo'
+        ])
+        messageHeaders {
+            header('sample', 'header')
+        }
+    }
+    outputMessage {
+        sentTo('jms:output')
+        body([
+                bookName: 'foo'
+        ])
+        headers {
+            header('BOOK-NAME', 'foo')
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">label: some_label
+input:
+  messageFrom: jms:input
+  messageBody:
+    bookName: 'foo'
+  messageHeaders:
+    sample: header
+outputMessage:
+  sentTo: jms:output
+  body:
+    bookName: foo
+  headers:
+    BOOK-NAME: foo</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>For the preceding contract, the following test would be created:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">JUnit</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">                    '''\
+package com.example;
+
+import com.jayway.jsonpath.DocumentContext;
+import com.jayway.jsonpath.JsonPath;
+import org.junit.Test;
+import org.junit.Rule;
+import javax.inject.Inject;
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierObjectMapper;
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessage;
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessaging;
+
+import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat;
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*;
+import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson;
+import static org.springframework.cloud.contract.verifier.messaging.util.ContractVerifierMessagingUtil.headers;
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.fileToBytes;
+
+@SuppressWarnings("rawtypes")
+public class FooTest {
+\t@Inject ContractVerifierMessaging contractVerifierMessaging;
+\t@Inject ContractVerifierObjectMapper contractVerifierObjectMapper;
+
+\t@Test
+\tpublic void validate_foo() throws Exception {
+\t\t// given:
+\t\t\tContractVerifierMessage inputMessage = contractVerifierMessaging.create(
+\t\t\t\t\t"{\\"bookName\\":\\"foo\\"}"
+\t\t\t\t\t\t, headers()
+\t\t\t\t\t\t\t.header("sample", "header")
+\t\t\t);
+
+\t\t// when:
+\t\t\tcontractVerifierMessaging.send(inputMessage, "jms:input");
+
+\t\t// then:
+\t\t\tContractVerifierMessage response = contractVerifierMessaging.receive("jms:output");
+\t\t\tassertThat(response).isNotNull();
+
+\t\t// and:
+\t\t\tassertThat(response.getHeader("BOOK-NAME")).isNotNull();
+\t\t\tassertThat(response.getHeader("BOOK-NAME").toString()).isEqualTo("foo");
+
+\t\t// and:
+\t\t\tDocumentContext parsedJson = JsonPath.parse(contractVerifierObjectMapper.writeValueAsString(response.getPayload()));
+\t\t\tassertThatJson(parsedJson).field("['bookName']").isEqualTo("foo");
+\t}
+
+}
+
+'''</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Spock</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">                    """\
+package com.example
+
+import com.jayway.jsonpath.DocumentContext
+import com.jayway.jsonpath.JsonPath
+import spock.lang.Specification
+import javax.inject.Inject
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierObjectMapper
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessage
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessaging
+
+import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*
+import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson
+import static org.springframework.cloud.contract.verifier.messaging.util.ContractVerifierMessagingUtil.headers
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.fileToBytes
+
+@SuppressWarnings("rawtypes")
+class FooSpec extends Specification {
+\t@Inject ContractVerifierMessaging contractVerifierMessaging
+\t@Inject ContractVerifierObjectMapper contractVerifierObjectMapper
+
+\tdef validate_foo() throws Exception {
+\t\tgiven:
+\t\t\tContractVerifierMessage inputMessage = contractVerifierMessaging.create(
+\t\t\t\t\t'''{"bookName":"foo"}'''
+\t\t\t\t\t\t, headers()
+\t\t\t\t\t\t\t.header("sample", "header")
+\t\t\t)
+
+\t\twhen:
+\t\t\tcontractVerifierMessaging.send(inputMessage, "jms:input")
+
+\t\tthen:
+\t\t\tContractVerifierMessage response = contractVerifierMessaging.receive("jms:output")
+\t\t\tresponse != null
+
+\t\tand:
+\t\t\tresponse.getHeader("BOOK-NAME") != null
+\t\t\tresponse.getHeader("BOOK-NAME").toString() == 'foo'
+
+\t\tand:
+\t\t\tDocumentContext parsedJson = JsonPath.parse(contractVerifierObjectMapper.writeValueAsString(response.getPayload()))
+\t\t\tassertThatJson(parsedJson).field("['bookName']").isEqualTo("foo")
+\t}
+
+}
+
+"""</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-scenario3"><a class="anchor" href="#features-messaging-scenario3"></a><a class="link" href="#features-messaging-scenario3">Scenario 3: No Output Message</a></h5>
+<div class="paragraph">
+<p>Consider the following contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">groovy</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">def contractDsl = Contract.make {
+    name "foo"
+    label 'some_label'
+    input {
+        messageFrom('jms:delete')
+        messageBody([
+                bookName: 'foo'
+        ])
+        messageHeaders {
+            header('sample', 'header')
+        }
+        assertThat('bookWasDeleted()')
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">yml</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">label: some_label
+input:
+  messageFrom: jms:delete
+  messageBody:
+    bookName: 'foo'
+  messageHeaders:
+    sample: header
+  assertThat: bookWasDeleted()</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>For the preceding contract, the following test would be created:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">JUnit</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">                    """\
+package com.example;
+
+import com.jayway.jsonpath.DocumentContext;
+import com.jayway.jsonpath.JsonPath;
+import org.junit.Test;
+import org.junit.Rule;
+import javax.inject.Inject;
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierObjectMapper;
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessage;
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessaging;
+
+import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat;
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*;
+import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson;
+import static org.springframework.cloud.contract.verifier.messaging.util.ContractVerifierMessagingUtil.headers;
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.fileToBytes;
+
+@SuppressWarnings("rawtypes")
+public class FooTest {
+\t@Inject ContractVerifierMessaging contractVerifierMessaging;
+\t@Inject ContractVerifierObjectMapper contractVerifierObjectMapper;
+
+\t@Test
+\tpublic void validate_foo() throws Exception {
+\t\t// given:
+\t\t\tContractVerifierMessage inputMessage = contractVerifierMessaging.create(
+\t\t\t\t\t"{\\"bookName\\":\\"foo\\"}"
+\t\t\t\t\t\t, headers()
+\t\t\t\t\t\t\t.header("sample", "header")
+\t\t\t);
+
+\t\t// when:
+\t\t\tcontractVerifierMessaging.send(inputMessage, "jms:delete");
+\t\t\tbookWasDeleted();
+
+\t}
+
+}
+
+"""</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Spock</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">                    """\
+package com.example
+
+import com.jayway.jsonpath.DocumentContext
+import com.jayway.jsonpath.JsonPath
+import spock.lang.Specification
+import javax.inject.Inject
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierObjectMapper
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessage
+import org.springframework.cloud.contract.verifier.messaging.internal.ContractVerifierMessaging
+
+import static org.springframework.cloud.contract.verifier.assertion.SpringCloudContractAssertions.assertThat
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.*
+import static com.toomuchcoding.jsonassert.JsonAssertion.assertThatJson
+import static org.springframework.cloud.contract.verifier.messaging.util.ContractVerifierMessagingUtil.headers
+import static org.springframework.cloud.contract.verifier.util.ContractVerifierUtil.fileToBytes
+
+@SuppressWarnings("rawtypes")
+class FooSpec extends Specification {
+\t@Inject ContractVerifierMessaging contractVerifierMessaging
+\t@Inject ContractVerifierObjectMapper contractVerifierObjectMapper
+
+\tdef validate_foo() throws Exception {
+\t\tgiven:
+\t\t\tContractVerifierMessage inputMessage = contractVerifierMessaging.create(
+\t\t\t\t\t'''{"bookName":"foo"}'''
+\t\t\t\t\t\t, headers()
+\t\t\t\t\t\t\t.header("sample", "header")
+\t\t\t)
+
+\t\twhen:
+\t\t\tcontractVerifierMessaging.send(inputMessage, "jms:delete")
+\t\t\tbookWasDeleted()
+
+\t\tthen:
+\t\t\tnoExceptionThrown()
+\t}
+
+}
+"""</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-consumer"><a class="anchor" href="#features-messaging-consumer"></a><a class="link" href="#features-messaging-consumer">4.4.4. Consumer Stub Generation</a></h4>
+<div class="paragraph">
+<p>Unlike in the HTTP part, in messaging, we need to publish the contract definition inside the JAR with
+a stub. Then it is parsed on the consumer side, and proper stubbed routes are created.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+If you have multiple frameworks on the classpath, Stub Runner needs to
+define which one should be used. Assume that you have AMQP, Spring Cloud Stream, and Spring Integration
+on the classpath and that you want to use Spring AMQP. Then you need to set
+<code>stubrunner.stream.enabled=false</code> and <code>stubrunner.integration.enabled=false</code>.
+That way, the only remaining framework is Spring AMQP.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-triggering"><a class="anchor" href="#features-messaging-stub-triggering"></a><a class="link" href="#features-messaging-stub-triggering">Stub triggering</a></h5>
+<div class="paragraph">
+<p>To trigger a message, use the <code>StubTrigger</code> interface, as the following example shows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package org.springframework.cloud.contract.stubrunner;
+
+import java.util.Collection;
+import java.util.Map;
+
+/**
+ * Contract for triggering stub messages.
+ *
+ * @author Marcin Grzejszczak
+ */
+public interface StubTrigger {
+
+    /**
+     * Triggers an event by a given label for a given {@code groupid:artifactid} notation.
+     * You can use only {@code artifactId} too.
+     *
+     * Feature related to messaging.
+     * @param ivyNotation ivy notation of a stub
+     * @param labelName name of the label to trigger
+     * @return true - if managed to run a trigger
+     */
+    boolean trigger(String ivyNotation, String labelName);
+
+    /**
+     * Triggers an event by a given label.
+     *
+     * Feature related to messaging.
+     * @param labelName name of the label to trigger
+     * @return true - if managed to run a trigger
+     */
+    boolean trigger(String labelName);
+
+    /**
+     * Triggers all possible events.
+     *
+     * Feature related to messaging.
+     * @return true - if managed to run a trigger
+     */
+    boolean trigger();
+
+    /**
+     * Feature related to messaging.
+     * @return a mapping of ivy notation of a dependency to all the labels it has.
+     */
+    Map&lt;String, Collection&lt;String&gt;&gt; labels();
+
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>For convenience, the <code>StubFinder</code> interface extends <code>StubTrigger</code>, so you only need one
+or the other in your tests.</p>
+</div>
+<div class="paragraph">
+<p><code>StubTrigger</code> gives you the following options to trigger a message:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#features-messaging-trigger-label">Trigger by Label</a></p>
+</li>
+<li>
+<p><a href="#features-messaging-trigger-group-artifact-ids">Trigger by Group and Artifact Ids</a></p>
+</li>
+<li>
+<p><a href="#features-messaging-trigger-artifact-ids">Trigger by Artifact IDs</a></p>
+</li>
+<li>
+<p><a href="#features-messaging-trigger-all-messages">Trigger All Messages</a></p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-trigger-label"><a class="anchor" href="#features-messaging-trigger-label"></a><a class="link" href="#features-messaging-trigger-label">Trigger by Label</a></h5>
+<div class="paragraph">
+<p>The following example shows how to trigger a message with a label:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger('return_book_1')</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-trigger-group-artifact-ids"><a class="anchor" href="#features-messaging-trigger-group-artifact-ids"></a><a class="link" href="#features-messaging-trigger-group-artifact-ids">Trigger by Group and Artifact Ids</a></h5>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger('org.springframework.cloud.contract.verifier.stubs:streamService', 'return_book_1')</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-trigger-artifact-ids"><a class="anchor" href="#features-messaging-trigger-artifact-ids"></a><a class="link" href="#features-messaging-trigger-artifact-ids">Trigger by Artifact IDs</a></h5>
+<div class="paragraph">
+<p>The following example shows how to trigger a message from artifact IDs:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger('streamService', 'return_book_1')</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-trigger-all-messages"><a class="anchor" href="#features-messaging-trigger-all-messages"></a><a class="link" href="#features-messaging-trigger-all-messages">Trigger All Messages</a></h5>
+<div class="paragraph">
+<p>The following example shows how to trigger all messages:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger()</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-stub-runner-camel"><a class="anchor" href="#features-messaging-stub-runner-camel"></a><a class="link" href="#features-messaging-stub-runner-camel">4.4.5. Consumer Side Messaging With Apache Camel</a></h4>
+<div class="paragraph">
+<p>Spring Cloud Contract Stub Runner&#8217;s messaging module gives you an easy way to integrate with Apache Camel.
+For the provided artifacts, it automatically downloads the stubs and registers the required
+routes.</p>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-camel-adding"><a class="anchor" href="#features-messaging-stub-runner-camel-adding"></a><a class="link" href="#features-messaging-stub-runner-camel-adding">Adding Apache Camel to the Project</a></h5>
+<div class="paragraph">
+<p>You can have both Apache Camel and Spring Cloud Contract Stub Runner on the classpath.
+Remember to annotate your test class with <code>@AutoConfigureStubRunner</code>.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-camel-disabling"><a class="anchor" href="#features-messaging-stub-runner-camel-disabling"></a><a class="link" href="#features-messaging-stub-runner-camel-disabling">Disabling the Functionality</a></h5>
+<div class="paragraph">
+<p>If you need to disable this functionality, set the <code>stubrunner.camel.enabled=false</code> property.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-camel-example"><a class="anchor" href="#features-messaging-stub-runner-camel-example"></a><a class="link" href="#features-messaging-stub-runner-camel-example">Examples</a></h5>
+<div class="paragraph">
+<p>Assume that we have the following Maven repository with deployed stubs for the
+<code>camelService</code> application.</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── .m2
+    └── repository
+        └── io
+            └── codearte
+                └── accurest
+                    └── stubs
+                        └── camelService
+                            ├── 0.0.1-SNAPSHOT
+                            │   ├── camelService-0.0.1-SNAPSHOT.pom
+                            │   ├── camelService-0.0.1-SNAPSHOT-stubs.jar
+                            │   └── maven-metadata-local.xml
+                            └── maven-metadata-local.xml</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Further assume that the stubs contain the following structure:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">├── META-INF
+│   └── MANIFEST.MF
+└── repository
+    ├── accurest
+    │   ├── bookDeleted.groovy
+    │   ├── bookReturned1.groovy
+    │   └── bookReturned2.groovy
+    └── mappings</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Now consider the following contracts (we number them 1 and 2):</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
+    label 'return_book_1'
+    input {
+        triggeredBy('bookReturnedTriggered()')
+    }
+    outputMessage {
+        sentTo('jms:output')
+        body('''{ "bookName" : "foo" }''')
+        headers {
+            header('BOOK-NAME', 'foo')
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
+    label 'return_book_2'
+    input {
+        messageFrom('jms:input')
+        messageBody([
+                bookName: 'foo'
+        ])
+        messageHeaders {
+            header('sample', 'header')
+        }
+    }
+    outputMessage {
+        sentTo('jms:output')
+        body([
+                bookName: 'foo'
+        ])
+        headers {
+            header('BOOK-NAME', 'foo')
+        }
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="features-messaging-stub-runner-camel-scenario1"><a class="anchor" href="#features-messaging-stub-runner-camel-scenario1"></a><a class="link" href="#features-messaging-stub-runner-camel-scenario1">Scenario 1 (No Input Message)</a></h6>
+<div class="paragraph">
+<p>To trigger a message from the <code>return_book_1</code> label, we use the <code>StubTigger</code> interface, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger('return_book_1')</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Next, we want to listen to the output of the message sent to <code>jms:output</code>:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Exchange receivedMessage = consumerTemplate.receive('jms:output', 5000)</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The received message would then pass the following assertions:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">receivedMessage != null
+assertThatBodyContainsBookNameFoo(receivedMessage.in.body)
+receivedMessage.in.headers.get('BOOK-NAME') == 'foo'</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="features-messaging-stub-runner-camel-scenario2"><a class="anchor" href="#features-messaging-stub-runner-camel-scenario2"></a><a class="link" href="#features-messaging-stub-runner-camel-scenario2">Scenario 2 (Output Triggered by Input)</a></h6>
+<div class="paragraph">
+<p>Since the route is set for you, you can send a message to the <code>jms:output</code> destination.</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">producerTemplate.
+        sendBodyAndHeaders('jms:input', new BookReturned('foo'), [sample: 'header'])</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Next, we want to listen to the output of the message sent to <code>jms:output</code>, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Exchange receivedMessage = consumerTemplate.receive('jms:output', 5000)</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The received message would pass the following assertions:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">receivedMessage != null
+assertThatBodyContainsBookNameFoo(receivedMessage.in.body)
+receivedMessage.in.headers.get('BOOK-NAME') == 'foo'</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="features-messaging-stub-runner-camel-scenario3"><a class="anchor" href="#features-messaging-stub-runner-camel-scenario3"></a><a class="link" href="#features-messaging-stub-runner-camel-scenario3">Scenario 3 (Input with No Output)</a></h6>
+<div class="paragraph">
+<p>Since the route is set for you, you can send a message to the <code>jms:output</code> destination, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">producerTemplate.
+        sendBodyAndHeaders('jms:delete', new BookReturned('foo'), [sample: 'header'])</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-stub-runner-integration"><a class="anchor" href="#features-messaging-stub-runner-integration"></a><a class="link" href="#features-messaging-stub-runner-integration">4.4.6. Consumer Side Messaging with Spring Integration</a></h4>
+<div class="paragraph">
+<p>Spring Cloud Contract Stub Runner&#8217;s messaging module gives you an easy way to
+integrate with Spring Integration. For the provided artifacts, it automatically downloads
+the stubs and registers the required routes.</p>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-integration-adding"><a class="anchor" href="#features-messaging-stub-runner-integration-adding"></a><a class="link" href="#features-messaging-stub-runner-integration-adding">Adding the Runner to the Project</a></h5>
+<div class="paragraph">
+<p>You can have both Spring Integration and Spring Cloud Contract Stub Runner on the
+classpath. Remember to annotate your test class with <code>@AutoConfigureStubRunner</code>.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-integration-disabling"><a class="anchor" href="#features-messaging-stub-runner-integration-disabling"></a><a class="link" href="#features-messaging-stub-runner-integration-disabling">Disabling the Functionality</a></h5>
+<div class="paragraph">
+<p>If you need to disable this functionality, set the
+<code>stubrunner.integration.enabled=false</code> property.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-integration-example"><a class="anchor" href="#features-messaging-stub-runner-integration-example"></a><a class="link" href="#features-messaging-stub-runner-integration-example">Examples</a></h5>
+<div class="paragraph">
+<p>Assume that you have the following Maven repository with deployed stubs for the
+<code>integrationService</code> application:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── .m2
+    └── repository
+        └── io
+            └── codearte
+                └── accurest
+                    └── stubs
+                        └── integrationService
+                            ├── 0.0.1-SNAPSHOT
+                            │   ├── integrationService-0.0.1-SNAPSHOT.pom
+                            │   ├── integrationService-0.0.1-SNAPSHOT-stubs.jar
+                            │   └── maven-metadata-local.xml
+                            └── maven-metadata-local.xml</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Further assume the stubs contain the following structure:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">├── META-INF
+│   └── MANIFEST.MF
+└── repository
+    ├── accurest
+    │   ├── bookDeleted.groovy
+    │   ├── bookReturned1.groovy
+    │   └── bookReturned2.groovy
+    └── mappings</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Consider the following contracts (numbered 1 and 2):</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
+    label 'return_book_1'
+    input {
+        triggeredBy('bookReturnedTriggered()')
+    }
+    outputMessage {
+        sentTo('output')
+        body('''{ "bookName" : "foo" }''')
+        headers {
+            header('BOOK-NAME', 'foo')
+        }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
+    label 'return_book_2'
+    input {
+        messageFrom('input')
+        messageBody([
+                bookName: 'foo'
+        ])
+        messageHeaders {
+            header('sample', 'header')
+        }
+    }
+    outputMessage {
+        sentTo('output')
+        body([
+                bookName: 'foo'
+        ])
+        headers {
+            header('BOOK-NAME', 'foo')
+        }
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Now consider the following Spring Integration Route:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;?xml version="1.0" encoding="UTF-8"?&gt;
+&lt;beans:beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+             xmlns:beans="http://www.springframework.org/schema/beans"
+             xmlns="http://www.springframework.org/schema/integration"
+             xsi:schemaLocation="http://www.springframework.org/schema/beans
+            https://www.springframework.org/schema/beans/spring-beans.xsd
+            http://www.springframework.org/schema/integration
+            http://www.springframework.org/schema/integration/spring-integration.xsd"&gt;
+
+
+    &lt;!-- REQUIRED FOR TESTING --&gt;
+    &lt;bridge input-channel="output"
+            output-channel="outputTest"/&gt;
+
+    &lt;channel id="outputTest"&gt;
+        &lt;queue/&gt;
+    &lt;/channel&gt;
+
+&lt;/beans:beans&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>These examples lend themselves to three scenarios:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p><a href="#features-messaging-stub-runner-integration-scenario1">Scenario 1 (No Input Message)</a></p>
+</li>
+<li>
+<p><a href="#features-messaging-stub-runner-integration-scenario2">Scenario 2 (Output Triggered by Input)</a></p>
+</li>
+<li>
+<p><a href="#features-messaging-stub-runner-integration-scenario3">Scenario 3 (Input with No Output)</a></p>
+</li>
+</ol>
+</div>
+<div class="sect5">
+<h6 id="features-messaging-stub-runner-integration-scenario1"><a class="anchor" href="#features-messaging-stub-runner-integration-scenario1"></a><a class="link" href="#features-messaging-stub-runner-integration-scenario1">Scenario 1 (No Input Message)</a></h6>
+<div class="paragraph">
+<p>To trigger a message from the <code>return_book_1</code> label, use the <code>StubTigger</code> interface, as
+follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger('return_book_1')</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following listing shows how to listen to the output of the message sent to <code>jms:output</code>:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Message&lt;?&gt; receivedMessage = messaging.receive('outputTest')</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The received message would pass the following assertions:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">receivedMessage != null
+assertJsons(receivedMessage.payload)
+receivedMessage.headers.get('BOOK-NAME') == 'foo'</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="features-messaging-stub-runner-integration-scenario2"><a class="anchor" href="#features-messaging-stub-runner-integration-scenario2"></a><a class="link" href="#features-messaging-stub-runner-integration-scenario2">Scenario 2 (Output Triggered by Input)</a></h6>
+<div class="paragraph">
+<p>Since the route is set for you, you can send a message to the <code>jms:output</code>
+destination, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">messaging.send(new BookReturned('foo'), [sample: 'header'], 'input')</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following listing shows how to listen to the output of the message sent to <code>jms:output</code>:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Message&lt;?&gt; receivedMessage = messaging.receive('outputTest')</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The received message passes the following assertions:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">receivedMessage != null
+assertJsons(receivedMessage.payload)
+receivedMessage.headers.get('BOOK-NAME') == 'foo'</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="features-messaging-stub-runner-integration-scenario3"><a class="anchor" href="#features-messaging-stub-runner-integration-scenario3"></a><a class="link" href="#features-messaging-stub-runner-integration-scenario3">Scenario 3 (Input with No Output)</a></h6>
+<div class="paragraph">
+<p>Since the route is set for you, you can send a message to the <code>jms:input</code> destination, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">messaging.send(new BookReturned('foo'), [sample: 'header'], 'delete')</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-stub-runner-stream"><a class="anchor" href="#features-messaging-stub-runner-stream"></a><a class="link" href="#features-messaging-stub-runner-stream">4.4.7. Consumer Side Messaging With Spring Cloud Stream</a></h4>
+<div class="paragraph">
+<p>Spring Cloud Contract Stub Runner&#8217;s messaging module gives you an easy way to
+integrate with Spring Stream. For the provided artifacts, it automatically downloads the
+stubs and registers the required routes.</p>
+</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title="Warning"></i>
+</td>
+<td class="content">
+If Stub Runner&#8217;s integration with the Stream <code>messageFrom</code> or <code>sentTo</code> strings
+are resolved first as the <code>destination</code> of a channel and no such <code>destination</code> exists, the
+destination is resolved as a channel name.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>If you want to use Spring Cloud Stream, remember to add a dependency on
+<code>org.springframework.cloud:spring-cloud-stream-test-support</code>, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-stream-test-support&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile "org.springframework.cloud:spring-cloud-stream-test-support"</code></pre>
+</div>
+</div>
+</div>
+</div>
+</td>
+</tr>
+</table>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-stream-adding"><a class="anchor" href="#features-messaging-stub-runner-stream-adding"></a><a class="link" href="#features-messaging-stub-runner-stream-adding">Adding the Runner to the Project</a></h5>
+<div class="paragraph">
+<p>You can have both Spring Cloud Stream and Spring Cloud Contract Stub Runner on the
+classpath. Remember to annotate your test class with <code>@AutoConfigureStubRunner</code>.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-stream-disabling"><a class="anchor" href="#features-messaging-stub-runner-stream-disabling"></a><a class="link" href="#features-messaging-stub-runner-stream-disabling">Disabling the Functionality</a></h5>
+<div class="paragraph">
+<p>If you need to disable this functionality, set the <code>stubrunner.stream.enabled=false</code>
+property.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-stream-example"><a class="anchor" href="#features-messaging-stub-runner-stream-example"></a><a class="link" href="#features-messaging-stub-runner-stream-example">Examples</a></h5>
+<div class="paragraph">
+<p>Assume that you have the following Maven repository with deployed stubs for the
+<code>streamService</code> application:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── .m2
+    └── repository
+        └── io
+            └── codearte
+                └── accurest
+                    └── stubs
+                        └── streamService
+                            ├── 0.0.1-SNAPSHOT
+                            │   ├── streamService-0.0.1-SNAPSHOT.pom
+                            │   ├── streamService-0.0.1-SNAPSHOT-stubs.jar
+                            │   └── maven-metadata-local.xml
+                            └── maven-metadata-local.xml</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Further assume the stubs contain the following structure:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">├── META-INF
+│   └── MANIFEST.MF
+└── repository
+    ├── accurest
+    │   ├── bookDeleted.groovy
+    │   ├── bookReturned1.groovy
+    │   └── bookReturned2.groovy
+    └── mappings</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Consider the following contracts (numbered 1 and 2):</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
+    label 'return_book_1'
+    input { triggeredBy('bookReturnedTriggered()') }
+    outputMessage {
+        sentTo('returnBook')
+        body('''{ "bookName" : "foo" }''')
+        headers { header('BOOK-NAME', 'foo') }
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
+    label 'return_book_2'
+    input {
+        messageFrom('bookStorage')
+        messageBody([
+                bookName: 'foo'
+        ])
+        messageHeaders { header('sample', 'header') }
+    }
+    outputMessage {
+        sentTo('returnBook')
+        body([
+                bookName: 'foo'
+        ])
+        headers { header('BOOK-NAME', 'foo') }
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Now consider the following Spring configuration:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">stubrunner.repositoryRoot: classpath:m2repo/repository/
+stubrunner.ids: org.springframework.cloud.contract.verifier.stubs:streamService:0.0.1-SNAPSHOT:stubs
+stubrunner.stubs-mode: remote
+spring:
+  cloud:
+    stream:
+      bindings:
+        output:
+          destination: returnBook
+        input:
+          destination: bookStorage
+
+server:
+  port: 0
+
+debug: true</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>These examples lend themselves to three scenarios:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#features-messaging-stub-runner-stream-scenario1">Scenario 1 (No Input Message)</a></p>
+</li>
+<li>
+<p><a href="#features-messaging-stub-runner-stream-scenario2">Scenario 2 (Output Triggered by Input)</a></p>
+</li>
+<li>
+<p><a href="#features-messaging-stub-runner-stream-scenario3">Scenario 3 (Input with No Output)</a></p>
+</li>
+</ul>
+</div>
+<div class="sect5">
+<h6 id="features-messaging-stub-runner-stream-scenario1"><a class="anchor" href="#features-messaging-stub-runner-stream-scenario1"></a><a class="link" href="#features-messaging-stub-runner-stream-scenario1">Scenario 1 (No Input Message)</a></h6>
+<div class="paragraph">
+<p>To trigger a message from the <code>return_book_1</code> label, use the <code>StubTrigger</code> interface as
+follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubFinder.trigger('return_book_1')</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example shows how to listen to the output of the message sent to a channel whose <code>destination</code> is
+<code>returnBook</code>:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Message&lt;?&gt; receivedMessage = messaging.receive('returnBook')</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The received message passes the following assertions:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">receivedMessage != null
+assertJsons(receivedMessage.payload)
+receivedMessage.headers.get('BOOK-NAME') == 'foo'</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="features-messaging-stub-runner-stream-scenario2"><a class="anchor" href="#features-messaging-stub-runner-stream-scenario2"></a><a class="link" href="#features-messaging-stub-runner-stream-scenario2">Scenario 2 (Output Triggered by Input)</a></h6>
+<div class="paragraph">
+<p>Since the route is set for you, you can send a message to the <code>bookStorage</code>
+<code>destination</code>, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">messaging.send(new BookReturned('foo'), [sample: 'header'], 'bookStorage')</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example shows how to listen to the output of the message sent to <code>returnBook</code>:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Message&lt;?&gt; receivedMessage = messaging.receive('returnBook')</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The received message passes the following assertions:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">receivedMessage != null
+assertJsons(receivedMessage.payload)
+receivedMessage.headers.get('BOOK-NAME') == 'foo'</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="features-messaging-stub-runner-stream-scenario3"><a class="anchor" href="#features-messaging-stub-runner-stream-scenario3"></a><a class="link" href="#features-messaging-stub-runner-stream-scenario3">Scenario 3 (Input with No Output)</a></h6>
+<div class="paragraph">
+<p>Since the route is set for you, you can send a message to the <code>jms:output</code>
+destination, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">messaging.send(new BookReturned('foo'), [sample: 'header'], 'delete')</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-messaging-stub-runner-amqp"><a class="anchor" href="#features-messaging-stub-runner-amqp"></a><a class="link" href="#features-messaging-stub-runner-amqp">4.4.8. Consumer Side Messaging With Spring AMQP</a></h4>
+<div class="paragraph">
+<p>Spring Cloud Contract Stub Runner&#8217;s messaging module provides an easy way to
+integrate with Spring AMQP&#8217;s Rabbit Template. For the provided artifacts, it
+automatically downloads the stubs and registers the required routes.</p>
+</div>
+<div class="paragraph">
+<p>The integration tries to work standalone (that is, without interaction with a running
+RabbitMQ message broker). It expects a <code>RabbitTemplate</code> on the application context and
+uses it as a spring boot test named <code>@SpyBean</code>. As a result, it can use the Mockito spy
+functionality to verify and inspect messages sent by the application.</p>
+</div>
+<div class="paragraph">
+<p>On the message consumer side, the stub runner considers all <code>@RabbitListener</code> annotated
+endpoints and all <code>SimpleMessageListenerContainer</code> objects on the application context.</p>
+</div>
+<div class="paragraph">
+<p>As messages are usually sent to exchanges in AMQP, the message contract contains the
+exchange name as the destination. Message listeners on the other side are bound to
+queues. Bindings connect an exchange to a queue. If message contracts are triggered, the
+Spring AMQP stub runner integration looks for bindings on the application context that
+matches this exchange. Then it collects the queues from the Spring exchanges and tries to
+find message listeners bound to these queues. The message is triggered for all matching
+message listeners.</p>
+</div>
+<div class="paragraph">
+<p>If you need to work with routing keys, you can pass them by using the <code>amqp_receivedRoutingKey</code>
+messaging header.</p>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-amqp-adding"><a class="anchor" href="#features-messaging-stub-runner-amqp-adding"></a><a class="link" href="#features-messaging-stub-runner-amqp-adding">Adding the Runner to the Project</a></h5>
+<div class="paragraph">
+<p>You can have both Spring AMQP and Spring Cloud Contract Stub Runner on the classpath and
+set the property <code>stubrunner.amqp.enabled=true</code>. Remember to annotate your test class
+with <code>@AutoConfigureStubRunner</code>.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+If you already have Stream and Integration on the classpath, you need
+to disable them explicitly by setting the  <code>stubrunner.stream.enabled=false</code> and
+<code>stubrunner.integration.enabled=false</code> properties.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-messaging-stub-runner-amqp-example"><a class="anchor" href="#features-messaging-stub-runner-amqp-example"></a><a class="link" href="#features-messaging-stub-runner-amqp-example">Examples</a></h5>
+<div class="paragraph">
+<p>Assume that you have the following Maven repository with a deployed stubs for the
+<code>spring-cloud-contract-amqp-test</code> application:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── .m2
+    └── repository
+        └── com
+            └── example
+                └── spring-cloud-contract-amqp-test
+                    ├── 0.4.0-SNAPSHOT
+                    │   ├── spring-cloud-contract-amqp-test-0.4.0-SNAPSHOT.pom
+                    │   ├── spring-cloud-contract-amqp-test-0.4.0-SNAPSHOT-stubs.jar
+                    │   └── maven-metadata-local.xml
+                    └── maven-metadata-local.xml</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Further assume that the stubs contain the following structure:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">├── META-INF
+│   └── MANIFEST.MF
+└── contracts
+    └── shouldProduceValidPersonData.groovy</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Then consider the following contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">Contract.make {
+    // Human readable description
+    description 'Should produce valid person data'
+    // Label by means of which the output message can be triggered
+    label 'contract-test.person.created.event'
+    // input to the contract
+    input {
+        // the contract will be triggered by a method
+        triggeredBy('createPerson()')
+    }
+    // output message of the contract
+    outputMessage {
+        // destination to which the output message will be sent
+        sentTo 'contract-test.exchange'
+        headers {
+            header('contentType': 'application/json')
+            header('__TypeId__': 'org.springframework.cloud.contract.stubrunner.messaging.amqp.Person')
+        }
+        // the body of the output message
+        body([
+                id  : $(consumer(9), producer(regex("[0-9]+"))),
+                name: "me"
+        ])
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Now consider the following Spring configuration:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">stubrunner:
+  repositoryRoot: classpath:m2repo/repository/
+  ids: org.springframework.cloud.contract.verifier.stubs.amqp:spring-cloud-contract-amqp-test:0.4.0-SNAPSHOT:stubs
+  stubs-mode: remote
+  amqp:
+    enabled: true
+server:
+  port: 0</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="features-messaging-stub-runner-amqp-triggering"><a class="anchor" href="#features-messaging-stub-runner-amqp-triggering"></a><a class="link" href="#features-messaging-stub-runner-amqp-triggering">Triggering the Message</a></h6>
+<div class="paragraph">
+<p>To trigger a message using the contract in the preceding section, use the <code>StubTrigger</code> interface as
+follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">stubTrigger.trigger("contract-test.person.created.event")</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The message has a destination of <code>contract-test.exchange</code>, so the Spring AMQP stub runner
+integration looks for bindings related to this exchange, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Bean
+public Binding binding() {
+    return BindingBuilder.bind(new Queue("test.queue"))
+            .to(new DirectExchange("contract-test.exchange")).with("#");
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The binding definition binds the queue called <code>test.queue</code>. As a result, the following listener
+definition is matched and invoked with the contract message:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Bean
+public SimpleMessageListenerContainer simpleMessageListenerContainer(
+        ConnectionFactory connectionFactory,
+        MessageListenerAdapter listenerAdapter) {
+    SimpleMessageListenerContainer container = new SimpleMessageListenerContainer();
+    container.setConnectionFactory(connectionFactory);
+    container.setQueueNames("test.queue");
+    container.setMessageListener(listenerAdapter);
+
+    return container;
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Also, the following annotated listener matches and is invoked:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RabbitListener(bindings = @QueueBinding(value = @Queue("test.queue"),
+        exchange = @Exchange(value = "contract-test.exchange",
+                ignoreDeclarationExceptions = "true")))
+public void handlePerson(Person person) {
+    this.person = person;
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+The message is directly handed over to the <code>onMessage</code> method of the
+<code>MessageListener</code> associated with the matching <code>SimpleMessageListenerContainer</code>.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect5">
+<h6 id="features-messaging-stub-runner-amqp-configuration"><a class="anchor" href="#features-messaging-stub-runner-amqp-configuration"></a><a class="link" href="#features-messaging-stub-runner-amqp-configuration">Spring AMQP Test Configuration</a></h6>
+<div class="paragraph">
+<p>In order to avoid Spring AMQP trying to connect to a running broker during our tests, we
+configure a mock <code>ConnectionFactory</code>.</p>
+</div>
+<div class="paragraph">
+<p>To disable the mocked <code>ConnectionFactory</code>, set the following property:
+<code>stubrunner.amqp.mockConnection=false</code>, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">stubrunner:
+  amqp:
+    mockConnection: false</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-stub-runner"><a class="anchor" href="#features-stub-runner"></a><a class="link" href="#features-stub-runner">4.5. Spring Cloud Contract Stub Runner</a></h3>
+<div class="paragraph">
+<p>One of the issues that you might encounter while using Spring Cloud Contract Verifier is
+passing the generated WireMock JSON stubs from the server side to the client side (or to
+various clients). The same takes place in terms of client-side generation for messaging.</p>
+</div>
+<div class="paragraph">
+<p>Copying the JSON files and setting the client side for messaging manually is out of the
+question. That is why we introduced Spring Cloud Contract Stub Runner. It can
+automatically download and run the stubs for you.</p>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-snapshot-versions"><a class="anchor" href="#features-stub-runner-snapshot-versions"></a><a class="link" href="#features-stub-runner-snapshot-versions">4.5.1. Snapshot Versions</a></h4>
+<div class="paragraph">
+<p>You can add the additional snapshot repository to your <code>build.gradle</code> file to use snapshot
+versions, which are automatically uploaded after every successful build, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;repositories&gt;
+    &lt;repository&gt;
+        &lt;id&gt;spring-snapshots&lt;/id&gt;
+        &lt;name&gt;Spring Snapshots&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;true&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/repository&gt;
+    &lt;repository&gt;
+        &lt;id&gt;spring-milestones&lt;/id&gt;
+        &lt;name&gt;Spring Milestones&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/repository&gt;
+    &lt;repository&gt;
+        &lt;id&gt;spring-releases&lt;/id&gt;
+        &lt;name&gt;Spring Releases&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/repository&gt;
+&lt;/repositories&gt;
+&lt;pluginRepositories&gt;
+    &lt;pluginRepository&gt;
+        &lt;id&gt;spring-snapshots&lt;/id&gt;
+        &lt;name&gt;Spring Snapshots&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;true&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/pluginRepository&gt;
+    &lt;pluginRepository&gt;
+        &lt;id&gt;spring-milestones&lt;/id&gt;
+        &lt;name&gt;Spring Milestones&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/pluginRepository&gt;
+    &lt;pluginRepository&gt;
+        &lt;id&gt;spring-releases&lt;/id&gt;
+        &lt;name&gt;Spring Releases&lt;/name&gt;
+        &lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
+        &lt;snapshots&gt;
+            &lt;enabled&gt;false&lt;/enabled&gt;
+        &lt;/snapshots&gt;
+    &lt;/pluginRepository&gt;
+&lt;/pluginRepositories&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">buildscript {
+    repositories {
+        mavenCentral()
+        mavenLocal()
+        maven { url "https://repo.spring.io/snapshot" }
+        maven { url "https://repo.spring.io/milestone" }
+        maven { url "https://repo.spring.io/release" }
+    }</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-publishing-stubs-as-jars"><a class="anchor" href="#features-stub-runner-publishing-stubs-as-jars"></a><a class="link" href="#features-stub-runner-publishing-stubs-as-jars">4.5.2. Publishing Stubs as JARs</a></h4>
+<div class="paragraph">
+<p>The easiest approach to publishing stubs as jars is to centralize the way stubs are kept.
+For example, you can keep them as jars in a Maven repository.</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+For both Maven and Gradle, the setup comes ready to work. However, you can customize
+it if you want to.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following example shows how to publish stubs as jars:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;!-- First disable the default jar setup in the properties section --&gt;
+&lt;!-- we don't want the verifier to do a jar for us --&gt;
+&lt;spring.cloud.contract.verifier.skip&gt;true&lt;/spring.cloud.contract.verifier.skip&gt;
+
+&lt;!-- Next add the assembly plugin to your build --&gt;
+&lt;!-- we want the assembly plugin to generate the JAR --&gt;
+&lt;plugin&gt;
+    &lt;groupId&gt;org.apache.maven.plugins&lt;/groupId&gt;
+    &lt;artifactId&gt;maven-assembly-plugin&lt;/artifactId&gt;
+    &lt;executions&gt;
+        &lt;execution&gt;
+            &lt;id&gt;stub&lt;/id&gt;
+            &lt;phase&gt;prepare-package&lt;/phase&gt;
+            &lt;goals&gt;
+                &lt;goal&gt;single&lt;/goal&gt;
+            &lt;/goals&gt;
+            &lt;inherited&gt;false&lt;/inherited&gt;
+            &lt;configuration&gt;
+                &lt;attach&gt;true&lt;/attach&gt;
+                &lt;descriptors&gt;
+                    ${basedir}/src/assembly/stub.xml
+                &lt;/descriptors&gt;
+            &lt;/configuration&gt;
+        &lt;/execution&gt;
+    &lt;/executions&gt;
+&lt;/plugin&gt;
+
+&lt;!-- Finally setup your assembly. Below you can find the contents of src/main/assembly/stub.xml --&gt;
+&lt;assembly
+    xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 https://maven.apache.org/xsd/assembly-1.1.3.xsd"&gt;
+    &lt;id&gt;stubs&lt;/id&gt;
+    &lt;formats&gt;
+        &lt;format&gt;jar&lt;/format&gt;
+    &lt;/formats&gt;
+    &lt;includeBaseDirectory&gt;false&lt;/includeBaseDirectory&gt;
+    &lt;fileSets&gt;
+        &lt;fileSet&gt;
+            &lt;directory&gt;src/main/java&lt;/directory&gt;
+            &lt;outputDirectory&gt;/&lt;/outputDirectory&gt;
+            &lt;includes&gt;
+                &lt;include&gt;**com/example/model/*.*&lt;/include&gt;
+            &lt;/includes&gt;
+        &lt;/fileSet&gt;
+        &lt;fileSet&gt;
+            &lt;directory&gt;${project.build.directory}/classes&lt;/directory&gt;
+            &lt;outputDirectory&gt;/&lt;/outputDirectory&gt;
+            &lt;includes&gt;
+                &lt;include&gt;**com/example/model/*.*&lt;/include&gt;
+            &lt;/includes&gt;
+        &lt;/fileSet&gt;
+        &lt;fileSet&gt;
+            &lt;directory&gt;${project.build.directory}/snippets/stubs&lt;/directory&gt;
+            &lt;outputDirectory&gt;META-INF/${project.groupId}/${project.artifactId}/${project.version}/mappings&lt;/outputDirectory&gt;
+            &lt;includes&gt;
+                &lt;include&gt;**/*&lt;/include&gt;
+            &lt;/includes&gt;
+        &lt;/fileSet&gt;
+        &lt;fileSet&gt;
+            &lt;directory&gt;${basedir}/src/test/resources/contracts&lt;/directory&gt;
+            &lt;outputDirectory&gt;META-INF/${project.groupId}/${project.artifactId}/${project.version}/contracts&lt;/outputDirectory&gt;
+            &lt;includes&gt;
+                &lt;include&gt;**/*.groovy&lt;/include&gt;
+            &lt;/includes&gt;
+        &lt;/fileSet&gt;
+    &lt;/fileSets&gt;
+&lt;/assembly&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">ext {
+    contractsDir = file("mappings")
+    stubsOutputDirRoot = file("${project.buildDir}/production/${project.name}-stubs/")
+}
+
+// Automatically added by plugin:
+// copyContracts - copies contracts to the output folder from which JAR will be created
+// verifierStubsJar - JAR with a provided stub suffix
+// the presented publication is also added by the plugin but you can modify it as you wish
+
+publishing {
+    publications {
+        stubs(MavenPublication) {
+            artifactId "${project.name}-stubs"
+            artifact verifierStubsJar
+        }
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-core"><a class="anchor" href="#features-stub-runner-core"></a><a class="link" href="#features-stub-runner-core">4.5.3. Stub Runner Core</a></h4>
+<div class="paragraph">
+<p>The stub runner core runs stubs for service collaborators. Treating stubs as contracts of
+services lets you use stub-runner as an implementation of
+<a href="https://martinfowler.com/articles/consumerDrivenContracts.html">Consumer-driven Contracts</a>.</p>
+</div>
+<div class="paragraph">
+<p>Stub Runner lets you automatically download the stubs of the provided dependencies (or
+pick those from the classpath), start WireMock servers for them, and feed them with proper
+stub definitions. For messaging, special stub routes are defined.</p>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-retrieving"><a class="anchor" href="#features-stub-runner-retrieving"></a><a class="link" href="#features-stub-runner-retrieving">Retrieving stubs</a></h5>
+<div class="paragraph">
+<p>You can pick from the following options of acquiring stubs:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Aether-based solution that downloads JARs with stubs from Artifactory or Nexus</p>
+</li>
+<li>
+<p>Classpath-scanning solution that searches the classpath with a pattern to retrieve stubs</p>
+</li>
+<li>
+<p>Writing your own implementation of the <code>org.springframework.cloud.contract.stubrunner.StubDownloaderBuilder</code> for full customization</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The latter example is described in the <a href="advanced.html#customization-custom-stub-runner">Custom Stub Runner</a> section.</p>
+</div>
+<div class="sect5">
+<h6 id="features-stub-runner-downloading-stub"><a class="anchor" href="#features-stub-runner-downloading-stub"></a><a class="link" href="#features-stub-runner-downloading-stub">Downloading Stubs</a></h6>
+<div class="paragraph">
+<p>You can control the downloading of stubs with the <code>stubsMode</code> switch. It picks value from the
+<code>StubRunnerProperties.StubsMode</code> enumeration. You can use the following options:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>StubRunnerProperties.StubsMode.CLASSPATH</code> (default value): Picks stubs from the classpath</p>
+</li>
+<li>
+<p><code>StubRunnerProperties.StubsMode.LOCAL</code>: Picks stubs from a local storage (for example, <code>.m2</code>)</p>
+</li>
+<li>
+<p><code>StubRunnerProperties.StubsMode.REMOTE</code>: Picks stubs from a remote location</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The following example picks stubs from a local location:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(repositoryRoot="https://foo.bar", ids = "com.example:beer-api-producer:+:stubs:8095", stubsMode = StubRunnerProperties.StubsMode.LOCAL)</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="features-stub-runner-classpath-scanning"><a class="anchor" href="#features-stub-runner-classpath-scanning"></a><a class="link" href="#features-stub-runner-classpath-scanning">Classpath scanning</a></h6>
+<div class="paragraph">
+<p>If you set the <code>stubsMode</code> property to <code>StubRunnerProperties.StubsMode.CLASSPATH</code>
+(or set nothing since <code>CLASSPATH</code> is the default value), the classpath is scanned.
+Consider the following example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(ids = {
+    "com.example:beer-api-producer:+:stubs:8095",
+    "com.example.foo:bar:1.0.0:superstubs:8096"
+})</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can add the dependencies to your classpath, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;com.example&lt;/groupId&gt;
+    &lt;artifactId&gt;beer-api-producer-restdocs&lt;/artifactId&gt;
+    &lt;classifier&gt;stubs&lt;/classifier&gt;
+    &lt;version&gt;0.0.1-SNAPSHOT&lt;/version&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+    &lt;exclusions&gt;
+        &lt;exclusion&gt;
+            &lt;groupId&gt;*&lt;/groupId&gt;
+            &lt;artifactId&gt;*&lt;/artifactId&gt;
+        &lt;/exclusion&gt;
+    &lt;/exclusions&gt;
+&lt;/dependency&gt;
+&lt;dependency&gt;
+    &lt;groupId&gt;com.example.thing1&lt;/groupId&gt;
+    &lt;artifactId&gt;thing2&lt;/artifactId&gt;
+    &lt;classifier&gt;superstubs&lt;/classifier&gt;
+    &lt;version&gt;1.0.0&lt;/version&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+    &lt;exclusions&gt;
+        &lt;exclusion&gt;
+            &lt;groupId&gt;*&lt;/groupId&gt;
+            &lt;artifactId&gt;*&lt;/artifactId&gt;
+        &lt;/exclusion&gt;
+    &lt;/exclusions&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile("com.example:beer-api-producer-restdocs:0.0.1-SNAPSHOT:stubs") {
+    transitive = false
+}
+testCompile("com.example.thing1:thing2:1.0.0:superstubs") {
+    transitive = false
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Then the specified locations on your classpath get scanned. For <code>com.example:beer-api-producer-restdocs</code>,
+the following locations are scanned:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>/META-INF/com.example/beer-api-producer-restdocs/<strong>*/</strong>.*</p>
+</li>
+<li>
+<p>/contracts/com.example/beer-api-producer-restdocs/<strong>*/</strong>.*</p>
+</li>
+<li>
+<p>/mappings/com.example/beer-api-producer-restdocs/<strong>*/</strong>.*</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For <code>com.example.thing1:thing2</code>, the following locations are scanned:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>/META-INF/com.example.thing1/thing2/<strong>*/</strong>.*</p>
+</li>
+<li>
+<p>/contracts/com.example.thing1/thing2/<strong>*/</strong>.*</p>
+</li>
+<li>
+<p>/mappings/com.example.thing1/thing2/<strong>*/</strong>.*</p>
+</li>
+</ul>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+You have to explicitly provide the group and artifact IDs when you package the
+producer stubs.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>To achieve proper stub packaging, the producer would set up the contracts as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── src
+    └── test
+        └── resources
+            └── contracts
+                └── com.example
+                    └── beer-api-producer-restdocs
+                        └── nested
+                            └── contract3.groovy</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>By using the <a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/blob/2.2.x/producer_with_restdocs/pom.xml">Maven <code>assembly</code> plugin</a> or
+<a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/blob/2.2.x/producer_with_restdocs/build.gradle">Gradle Jar</a> task, you have to create the following
+structure in your stubs jar:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">└── META-INF
+    └── com.example
+        └── beer-api-producer-restdocs
+            └── 2.0.0
+                ├── contracts
+                │   └── nested
+                │       └── contract2.groovy
+                └── mappings
+                    └── mapping.json</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>By maintaining this structure, the classpath gets scanned and you can profit from the messaging or
+HTTP stubs without the need to download artifacts.</p>
+</div>
+</div>
+<div class="sect5">
+<h6 id="features-stub-runner-configuring-http-server-stubs"><a class="anchor" href="#features-stub-runner-configuring-http-server-stubs"></a><a class="link" href="#features-stub-runner-configuring-http-server-stubs">Configuring HTTP Server Stubs</a></h6>
+<div class="paragraph">
+<p>Stub Runner has a notion of a <code>HttpServerStub</code> that abstracts the underlying
+concrete implementation of the HTTP server (for example, WireMock is one of the implementations).
+Sometimes, you need to perform some additional tuning (which is concrete for the given implementation) of the stub servers.
+To do that, Stub Runner gives you
+the <code>httpServerStubConfigurer</code> property that is available in the annotation and the
+JUnit rule and is accessible through system properties, where you can provide
+your implementation of the <code>org.springframework.cloud.contract.stubrunner.HttpServerStubConfigurer</code>
+interface. The implementations can alter
+the configuration files for the given HTTP server stub.</p>
+</div>
+<div class="paragraph">
+<p>Spring Cloud Contract Stub Runner comes with an implementation that you
+can extend for WireMock:
+<code>org.springframework.cloud.contract.stubrunner.provider.wiremock.WireMockHttpServerStubConfigurer</code>.
+In the <code>configure</code> method,
+you can provide your own custom configuration for the given stub. The use
+case might be starting WireMock for the given artifact ID, on an HTTPS port. The following
+example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 1. WireMockHttpServerStubConfigurer implementation</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@CompileStatic
+static class HttpsForFraudDetection extends WireMockHttpServerStubConfigurer {
+
+    private static final Log log = LogFactory.getLog(HttpsForFraudDetection)
+
+    @Override
+    WireMockConfiguration configure(WireMockConfiguration httpStubConfiguration, HttpServerStubConfiguration httpServerStubConfiguration) {
+        if (httpServerStubConfiguration.stubConfiguration.artifactId == "fraudDetectionServer") {
+            int httpsPort = SocketUtils.findAvailableTcpPort()
+            log.info("Will set HTTPs port [" + httpsPort + "] for fraud detection server")
+            return httpStubConfiguration
+                    .httpsPort(httpsPort)
+        }
+        return httpStubConfiguration
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can then reuse it with the <code>@AutoConfigureStubRunner</code> annotation, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@AutoConfigureStubRunner(mappingsOutputFolder = "target/outputmappings/",
+        httpServerStubConfigurer = HttpsForFraudDetection)</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Whenever an HTTPS port is found, it takes precedence over the HTTP port.</p>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-running-stubs"><a class="anchor" href="#features-stub-runner-running-stubs"></a><a class="link" href="#features-stub-runner-running-stubs">Running stubs</a></h5>
+<div class="paragraph">
+<p>This section describes how to run stubs. It contains the following topics:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#features-stub-runner-http-stubs">HTTP Stubs</a></p>
+</li>
+<li>
+<p><a href="#features-stub-runner-viewing">Viewing Registered Mappings</a></p>
+</li>
+<li>
+<p><a href="#features-stub-runner-messaging">Messaging Stubs</a></p>
+</li>
+</ul>
+</div>
+<div class="sect5">
+<h6 id="features-stub-runner-http-stubs"><a class="anchor" href="#features-stub-runner-http-stubs"></a><a class="link" href="#features-stub-runner-http-stubs">HTTP Stubs</a></h6>
+<div class="paragraph">
+<p>Stubs are defined in JSON documents, whose syntax is defined in <a href="http://wiremock.org/stubbing.html">WireMock documentation</a></p>
+</div>
+<div class="paragraph">
+<p>The following example defines a stub in JSON:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">{
+    "request": {
+        "method": "GET",
+        "url": "/ping"
+    },
+    "response": {
+        "status": 200,
+        "body": "pong",
+        "headers": {
+            "Content-Type": "text/plain"
+        }
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="features-stub-runner-viewing"><a class="anchor" href="#features-stub-runner-viewing"></a><a class="link" href="#features-stub-runner-viewing">Viewing Registered Mappings</a></h6>
+<div class="paragraph">
+<p>Every stubbed collaborator exposes a list of defined mappings under the <code>__/admin/</code> endpoint.</p>
+</div>
+<div class="paragraph">
+<p>You can also use the <code>mappingsOutputFolder</code> property to dump the mappings to files.
+For the annotation-based approach, it would resembling the following example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(ids="a.b.c:loanIssuance,a.b.c:fraudDetectionServer",
+mappingsOutputFolder = "target/outputmappings/")</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>For the JUnit approach, it resembles the following example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@ClassRule @Shared StubRunnerRule rule = new StubRunnerRule()
+            .repoRoot("https://some_url")
+            .downloadStub("a.b.c", "loanIssuance")
+            .downloadStub("a.b.c:fraudDetectionServer")
+            .withMappingsOutputFolder("target/outputmappings")</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Then, if you check out the <code>target/outputmappings</code> folder, you would see the following structure;</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">.
+├── fraudDetectionServer_13705
+└── loanIssuance_12255</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>That means that there were two stubs registered. <code>fraudDetectionServer</code> was registered at port <code>13705</code>
+and <code>loanIssuance</code> at port <code>12255</code>. If we take a look at one of the files, we would see (for WireMock)
+the mappings available for the given server:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">[{
+  "id" : "f9152eb9-bf77-4c38-8289-90be7d10d0d7",
+  "request" : {
+    "url" : "/name",
+    "method" : "GET"
+  },
+  "response" : {
+    "status" : 200,
+    "body" : "fraudDetectionServer"
+  },
+  "uuid" : "f9152eb9-bf77-4c38-8289-90be7d10d0d7"
+},
+...
+]</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="features-stub-runner-messaging"><a class="anchor" href="#features-stub-runner-messaging"></a><a class="link" href="#features-stub-runner-messaging">Messaging Stubs</a></h6>
+<div class="paragraph">
+<p>Depending on the provided Stub Runner dependency and the DSL, the messaging routes are automatically set up.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-junit"><a class="anchor" href="#features-stub-runner-junit"></a><a class="link" href="#features-stub-runner-junit">4.5.4. Stub Runner JUnit Rule and Stub Runner JUnit5 Extension</a></h4>
+<div class="paragraph">
+<p>Stub Runner comes with a JUnit rule that lets you can download and run stubs for a given
+group and artifact ID, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@ClassRule
+public static StubRunnerRule rule = new StubRunnerRule().repoRoot(repoRoot())
+        .stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+        .downloadStub("org.springframework.cloud.contract.verifier.stubs",
+                "loanIssuance")
+        .downloadStub(
+                "org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer");
+
+@BeforeClass
+@AfterClass
+public static void setupProps() {
+    System.clearProperty("stubrunner.repository.root");
+    System.clearProperty("stubrunner.classifier");
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>A <code>StubRunnerExtension</code> is also available for JUnit 5. <code>StubRunnerRule</code> and
+<code>StubRunnerExtension</code> work in a very similar fashion. After the rule or extension is
+executed, Stub Runner connects to your Maven repository and, for the given list of
+dependencies, tries to:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Download them</p>
+</li>
+<li>
+<p>Cache them locally</p>
+</li>
+<li>
+<p>Unzip them to a temporary folder</p>
+</li>
+<li>
+<p>Start a WireMock server for each Maven dependency on a random port from the provided
+range of ports or the provided port</p>
+</li>
+<li>
+<p>Feed the WireMock server with all JSON files that are valid WireMock definitions</p>
+</li>
+<li>
+<p>Send messages (remember to pass an implementation of <code>MessageVerifier</code> interface)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Stub Runner uses the <a href="https://wiki.eclipse.org/Aether">Eclipse Aether</a> mechanism to download the Maven dependencies.
+Check their <a href="https://wiki.eclipse.org/Aether">docs</a> for more information.</p>
+</div>
+<div class="paragraph">
+<p>Since the <code>StubRunnerRule</code> and <code>StubRunnerExtension</code> implement the <code>StubFinder</code> they let
+you find the started stubs, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">package org.springframework.cloud.contract.stubrunner;
+
+import java.net.URL;
+import java.util.Collection;
+import java.util.Map;
+
+import org.springframework.cloud.contract.spec.Contract;
+
+/**
+ * Contract for finding registered stubs.
+ *
+ * @author Marcin Grzejszczak
+ */
+public interface StubFinder extends StubTrigger {
+
+    /**
+     * For the given groupId and artifactId tries to find the matching URL of the running
+     * stub.
+     * @param groupId - might be null. In that case a search only via artifactId takes
+     * place
+     * @param artifactId - artifact id of the stub
+     * @return URL of a running stub or throws exception if not found
+     * @throws StubNotFoundException in case of not finding a stub
+     */
+    URL findStubUrl(String groupId, String artifactId) throws StubNotFoundException;
+
+    /**
+     * For the given Ivy notation {@code [groupId]:artifactId:[version]:[classifier]}
+     * tries to find the matching URL of the running stub. You can also pass only
+     * {@code artifactId}.
+     * @param ivyNotation - Ivy representation of the Maven artifact
+     * @return URL of a running stub or throws exception if not found
+     * @throws StubNotFoundException in case of not finding a stub
+     */
+    URL findStubUrl(String ivyNotation) throws StubNotFoundException;
+
+    /**
+     * @return all running stubs
+     */
+    RunningStubs findAllRunningStubs();
+
+    /**
+     * @return the list of Contracts
+     */
+    Map&lt;StubConfiguration, Collection&lt;Contract&gt;&gt; getContracts();
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following examples provide more detail about using Stub Runner:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">spock</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@ClassRule
+@Shared
+StubRunnerRule rule = new StubRunnerRule()
+        .stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+        .repoRoot(StubRunnerRuleSpec.getResource("/m2repo/repository").toURI().toString())
+        .downloadStub("org.springframework.cloud.contract.verifier.stubs", "loanIssuance")
+        .downloadStub("org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer")
+        .withMappingsOutputFolder("target/outputmappingsforrule")
+
+
+def 'should start WireMock servers'() {
+    expect: 'WireMocks are running'
+        rule.findStubUrl('org.springframework.cloud.contract.verifier.stubs', 'loanIssuance') != null
+        rule.findStubUrl('loanIssuance') != null
+        rule.findStubUrl('loanIssuance') == rule.findStubUrl('org.springframework.cloud.contract.verifier.stubs', 'loanIssuance')
+        rule.findStubUrl('org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer') != null
+    and:
+        rule.findAllRunningStubs().isPresent('loanIssuance')
+        rule.findAllRunningStubs().isPresent('org.springframework.cloud.contract.verifier.stubs', 'fraudDetectionServer')
+        rule.findAllRunningStubs().isPresent('org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer')
+    and: 'Stubs were registered'
+        "${rule.findStubUrl('loanIssuance').toString()}/name".toURL().text == 'loanIssuance'
+        "${rule.findStubUrl('fraudDetectionServer').toString()}/name".toURL().text == 'fraudDetectionServer'
+}
+
+def 'should output mappings to output folder'() {
+    when:
+        def url = rule.findStubUrl('fraudDetectionServer')
+    then:
+        new File("target/outputmappingsforrule", "fraudDetectionServer_${url.port}").exists()
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">junit 4</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
+public void should_start_wiremock_servers() throws Exception {
+    // expect: 'WireMocks are running'
+    then(rule.findStubUrl("org.springframework.cloud.contract.verifier.stubs",
+            "loanIssuance")).isNotNull();
+    then(rule.findStubUrl("loanIssuance")).isNotNull();
+    then(rule.findStubUrl("loanIssuance")).isEqualTo(rule.findStubUrl(
+            "org.springframework.cloud.contract.verifier.stubs", "loanIssuance"));
+    then(rule.findStubUrl(
+            "org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer"))
+                    .isNotNull();
+    // and:
+    then(rule.findAllRunningStubs().isPresent("loanIssuance")).isTrue();
+    then(rule.findAllRunningStubs().isPresent(
+            "org.springframework.cloud.contract.verifier.stubs",
+            "fraudDetectionServer")).isTrue();
+    then(rule.findAllRunningStubs().isPresent(
+            "org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer"))
+                    .isTrue();
+    // and: 'Stubs were registered'
+    then(httpGet(rule.findStubUrl("loanIssuance").toString() + "/name"))
+            .isEqualTo("loanIssuance");
+    then(httpGet(rule.findStubUrl("fraudDetectionServer").toString() + "/name"))
+            .isEqualTo("fraudDetectionServer");
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">junit 5</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">// Visible for Junit
+@RegisterExtension
+static StubRunnerExtension stubRunnerExtension = new StubRunnerExtension()
+        .repoRoot(repoRoot()).stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+        .downloadStub("org.springframework.cloud.contract.verifier.stubs",
+                "loanIssuance")
+        .downloadStub(
+                "org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer")
+        .withMappingsOutputFolder("target/outputmappingsforrule");
+
+@BeforeAll
+@AfterAll
+static void setupProps() {
+    System.clearProperty("stubrunner.repository.root");
+    System.clearProperty("stubrunner.classifier");
+}
+
+private static String repoRoot() {
+    try {
+        return StubRunnerRuleJUnitTest.class.getResource("/m2repo/repository/")
+                .toURI().toString();
+    }
+    catch (Exception e) {
+        return "";
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>See the <a href="#features-stub-runner-common-properties-junit-spring">Common Properties for JUnit and Spring</a> for more information on
+how to apply global configuration of Stub Runner.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+To use the JUnit rule or JUnit 5 extension together with messaging, you have to provide an implementation of the
+<code>MessageVerifier</code> interface to the rule builder (for example, <code>rule.messageVerifier(new MyMessageVerifier())</code>).
+If you do not do this, then, whenever you try to send a message, an exception is thrown.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-rule-maven-settings"><a class="anchor" href="#features-stub-runner-rule-maven-settings"></a><a class="link" href="#features-stub-runner-rule-maven-settings">Maven Settings</a></h5>
+<div class="paragraph">
+<p>The stub downloader honors Maven settings for a different local repository folder.
+Authentication details for repositories and profiles are currently not taken into account,
+so you need to specify it by using the properties mentioned above.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-rule-fixed-ports"><a class="anchor" href="#features-stub-runner-rule-fixed-ports"></a><a class="link" href="#features-stub-runner-rule-fixed-ports">Providing Fixed Ports</a></h5>
+<div class="paragraph">
+<p>You can also run your stubs on fixed ports. You can do it in two different ways.
+One is to pass it in the properties, and the other is to use the fluent API of
+JUnit rule.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-rule-fluent-api"><a class="anchor" href="#features-stub-runner-rule-fluent-api"></a><a class="link" href="#features-stub-runner-rule-fluent-api">Fluent API</a></h5>
+<div class="paragraph">
+<p>When using the <code>StubRunnerRule</code> or <code>StubRunnerExtension</code>, you can add a stub to download
+and then pass the port for the last downloaded stub. The following example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@ClassRule
+public static StubRunnerRule rule = new StubRunnerRule().repoRoot(repoRoot())
+        .stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+        .downloadStub("org.springframework.cloud.contract.verifier.stubs",
+                "loanIssuance")
+        .withPort(12345).downloadStub(
+                "org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer:12346");
+
+@BeforeClass
+@AfterClass
+public static void setupProps() {
+    System.clearProperty("stubrunner.repository.root");
+    System.clearProperty("stubrunner.classifier");
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>For the preceding example, the following test is valid:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">then(rule.findStubUrl("loanIssuance"))
+        .isEqualTo(URI.create("http://localhost:12345").toURL());
+then(rule.findStubUrl("fraudDetectionServer"))
+        .isEqualTo(URI.create("http://localhost:12346").toURL());</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-rule-spring"><a class="anchor" href="#features-stub-runner-rule-spring"></a><a class="link" href="#features-stub-runner-rule-spring">Stub Runner with Spring</a></h5>
+<div class="paragraph">
+<p>Stub Runner with Spring sets up Spring configuration of the Stub Runner project.</p>
+</div>
+<div class="paragraph">
+<p>By providing a list of stubs inside your configuration file, Stub Runner automatically downloads
+and registers in WireMock the selected stubs.</p>
+</div>
+<div class="paragraph">
+<p>If you want to find the URL of your stubbed dependency, you can autowire the <code>StubFinder</code> interface and use
+its methods, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@ContextConfiguration(classes = Config, loader = SpringBootContextLoader)
+@SpringBootTest(properties = [" stubrunner.cloud.enabled=false",
+        'foo=${stubrunner.runningstubs.fraudDetectionServer.port}',
+        'fooWithGroup=${stubrunner.runningstubs.org.springframework.cloud.contract.verifier.stubs.fraudDetectionServer.port}'])
+@AutoConfigureStubRunner(mappingsOutputFolder = "target/outputmappings/",
+        httpServerStubConfigurer = HttpsForFraudDetection)
+@ActiveProfiles("test")
+class StubRunnerConfigurationSpec extends Specification {
+
+    @Autowired
+    StubFinder stubFinder
+    @Autowired
+    Environment environment
+    @StubRunnerPort("fraudDetectionServer")
+    int fraudDetectionServerPort
+    @StubRunnerPort("org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer")
+    int fraudDetectionServerPortWithGroupId
+    @Value('${foo}')
+    Integer foo
+
+    @BeforeClass
+    @AfterClass
+    void setupProps() {
+        System.clearProperty("stubrunner.repository.root")
+        System.clearProperty("stubrunner.classifier")
+    }
+
+    def 'should start WireMock servers'() {
+        expect: 'WireMocks are running'
+            stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs', 'loanIssuance') != null
+            stubFinder.findStubUrl('loanIssuance') != null
+            stubFinder.findStubUrl('loanIssuance') == stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs', 'loanIssuance')
+            stubFinder.findStubUrl('loanIssuance') == stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs:loanIssuance')
+            stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs:loanIssuance:0.0.1-SNAPSHOT') == stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs:loanIssuance:0.0.1-SNAPSHOT:stubs')
+            stubFinder.findStubUrl('org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer') != null
+        and:
+            stubFinder.findAllRunningStubs().isPresent('loanIssuance')
+            stubFinder.findAllRunningStubs().isPresent('org.springframework.cloud.contract.verifier.stubs', 'fraudDetectionServer')
+            stubFinder.findAllRunningStubs().isPresent('org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer')
+        and: 'Stubs were registered'
+            "${stubFinder.findStubUrl('loanIssuance').toString()}/name".toURL().text == 'loanIssuance'
+            "${stubFinder.findStubUrl('fraudDetectionServer').toString()}/name".toURL().text == 'fraudDetectionServer'
+        and: 'Fraud Detection is an HTTPS endpoint'
+            stubFinder.findStubUrl('fraudDetectionServer').toString().startsWith("https")
+    }
+
+    def 'should throw an exception when stub is not found'() {
+        when:
+            stubFinder.findStubUrl('nonExistingService')
+        then:
+            thrown(StubNotFoundException)
+        when:
+            stubFinder.findStubUrl('nonExistingGroupId', 'nonExistingArtifactId')
+        then:
+            thrown(StubNotFoundException)
+    }
+
+    def 'should register started servers as environment variables'() {
+        expect:
+            environment.getProperty("stubrunner.runningstubs.loanIssuance.port") != null
+            stubFinder.findAllRunningStubs().getPort("loanIssuance") == (environment.getProperty("stubrunner.runningstubs.loanIssuance.port") as Integer)
+        and:
+            environment.getProperty("stubrunner.runningstubs.fraudDetectionServer.port") != null
+            stubFinder.findAllRunningStubs().getPort("fraudDetectionServer") == (environment.getProperty("stubrunner.runningstubs.fraudDetectionServer.port") as Integer)
+        and:
+            environment.getProperty("stubrunner.runningstubs.fraudDetectionServer.port") != null
+            stubFinder.findAllRunningStubs().getPort("fraudDetectionServer") == (environment.getProperty("stubrunner.runningstubs.org.springframework.cloud.contract.verifier.stubs.fraudDetectionServer.port") as Integer)
+    }
+
+    def 'should be able to interpolate a running stub in the passed test property'() {
+        given:
+            int fraudPort = stubFinder.findAllRunningStubs().getPort("fraudDetectionServer")
+        expect:
+            fraudPort &gt; 0
+            environment.getProperty("foo", Integer) == fraudPort
+            environment.getProperty("fooWithGroup", Integer) == fraudPort
+            foo == fraudPort
+    }
+
+    @Issue("#573")
+    def 'should be able to retrieve the port of a running stub via an annotation'() {
+        given:
+            int fraudPort = stubFinder.findAllRunningStubs().getPort("fraudDetectionServer")
+        expect:
+            fraudPort &gt; 0
+            fraudDetectionServerPort == fraudPort
+            fraudDetectionServerPortWithGroupId == fraudPort
+    }
+
+    def 'should dump all mappings to a file'() {
+        when:
+            def url = stubFinder.findStubUrl("fraudDetectionServer")
+        then:
+            new File("target/outputmappings/", "fraudDetectionServer_${url.port}").exists()
+    }
+
+    @Configuration
+    @EnableAutoConfiguration
+    static class Config {}
+
+    @CompileStatic
+    static class HttpsForFraudDetection extends WireMockHttpServerStubConfigurer {
+
+        private static final Log log = LogFactory.getLog(HttpsForFraudDetection)
+
+        @Override
+        WireMockConfiguration configure(WireMockConfiguration httpStubConfiguration, HttpServerStubConfiguration httpServerStubConfiguration) {
+            if (httpServerStubConfiguration.stubConfiguration.artifactId == "fraudDetectionServer") {
+                int httpsPort = SocketUtils.findAvailableTcpPort()
+                log.info("Will set HTTPs port [" + httpsPort + "] for fraud detection server")
+                return httpStubConfiguration
+                        .httpsPort(httpsPort)
+            }
+            return httpStubConfiguration
+        }
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Doing so depends on the following configuration file:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">stubrunner:
+  repositoryRoot: classpath:m2repo/repository/
+  ids:
+    - org.springframework.cloud.contract.verifier.stubs:loanIssuance
+    - org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer
+    - org.springframework.cloud.contract.verifier.stubs:bootService
+  stubs-mode: remote</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Instead of using the properties, you can also use the properties inside the <code>@AutoConfigureStubRunner</code>.
+The following example achieves the same result by setting values on the annotation:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@AutoConfigureStubRunner(
+        ids = ["org.springframework.cloud.contract.verifier.stubs:loanIssuance",
+                "org.springframework.cloud.contract.verifier.stubs:fraudDetectionServer",
+                "org.springframework.cloud.contract.verifier.stubs:bootService"],
+        stubsMode = StubRunnerProperties.StubsMode.REMOTE,
+        repositoryRoot = "classpath:m2repo/repository/")</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Stub Runner Spring registers environment variables in the following manner
+for every registered WireMock server. The following example shows Stub Runner IDs for
+<code>com.example:thing1</code> and <code>com.example:thing2</code>:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>stubrunner.runningstubs.thing1.port</code></p>
+</li>
+<li>
+<p><code>stubrunner.runningstubs.com.example.thing1.port</code></p>
+</li>
+<li>
+<p><code>stubrunner.runningstubs.thing2.port</code></p>
+</li>
+<li>
+<p><code>stubrunner.runningstubs.com.example.thing2.port</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>You can reference these values in your code.</p>
+</div>
+<div class="paragraph">
+<p>You can also use the <code>@StubRunnerPort</code> annotation to inject the port of a running stub.
+The value of the annotation can be the <code>groupid:artifactid</code> or just the <code>artifactid</code>.
+The following example works shows Stub Runner IDs for
+<code>com.example:thing1</code> and <code>com.example:thing2</code>.</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@StubRunnerPort("thing1")
+int thing1Port;
+@StubRunnerPort("com.example:thing2")
+int thing2Port;</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-cloud"><a class="anchor" href="#features-stub-runner-cloud"></a><a class="link" href="#features-stub-runner-cloud">4.5.5. Stub Runner Spring Cloud</a></h4>
+<div class="paragraph">
+<p>Stub Runner can integrate with Spring Cloud.</p>
+</div>
+<div class="paragraph">
+<p>For real life examples, see:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x/producer">The producer app sample</a></p>
+</li>
+<li>
+<p><a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x/consumer_with_discovery">The consumer app sample</a></p>
+</li>
+</ul>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-cloud-stubbing-discovery"><a class="anchor" href="#features-stub-runner-cloud-stubbing-discovery"></a><a class="link" href="#features-stub-runner-cloud-stubbing-discovery">Stubbing Service Discovery</a></h5>
+<div class="paragraph">
+<p>The most important feature of <code>Stub Runner Spring Cloud</code> is the fact that it stubs:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>DiscoveryClient</code></p>
+</li>
+<li>
+<p><code>Ribbon</code> <code>ServerList</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>That means that, regardless of whether you use Zookeeper, Consul, Eureka, or anything
+else, you do not need that in your tests. We are starting WireMock instances of your
+dependencies and we are telling your application, whenever you use <code>Feign</code>, to load a
+balanced <code>RestTemplate</code> or <code>DiscoveryClient</code> directly, to call those stubbed servers
+instead of calling the real Service Discovery tool.</p>
+</div>
+<div class="paragraph">
+<p>For example, the following test passes:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">def 'should make service discovery work'() {
+    expect: 'WireMocks are running'
+        "${stubFinder.findStubUrl('loanIssuance').toString()}/name".toURL().text == 'loanIssuance'
+        "${stubFinder.findStubUrl('fraudDetectionServer').toString()}/name".toURL().text == 'fraudDetectionServer'
+    and: 'Stubs can be reached via load service discovery'
+        restTemplate.getForObject('http://loanIssuance/name', String) == 'loanIssuance'
+        restTemplate.getForObject('http://someNameThatShouldMapFraudDetectionServer/name', String) == 'fraudDetectionServer'
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that the preceding example requires the following configuration file:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">stubrunner:
+  idsToServiceIds:
+    ivyNotation: someValueInsideYourCode
+    fraudDetectionServer: someNameThatShouldMapFraudDetectionServer</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="features-stub-runner-cloud-stubbing-profiles"><a class="anchor" href="#features-stub-runner-cloud-stubbing-profiles"></a><a class="link" href="#features-stub-runner-cloud-stubbing-profiles">Test Profiles and Service Discovery</a></h6>
+<div class="paragraph">
+<p>In your integration tests, you typically do not want to call either a discovery service (such as Eureka)
+or Config Server. That is why you create an additional test configuration in which you want to disable
+these features.</p>
+</div>
+<div class="paragraph">
+<p>Due to certain limitations of <a href="https://github.com/spring-cloud/spring-cloud-commons/issues/156"><code>spring-cloud-commons</code></a>,
+to achieve this, you have to disable these properties
+in a static block such as the following example (for Eureka):</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">    //Hack to work around https://github.com/spring-cloud/spring-cloud-commons/issues/156
+    static {
+        System.setProperty("eureka.client.enabled", "false");
+        System.setProperty("spring.cloud.config.failFast", "false");
+    }</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-additional-config"><a class="anchor" href="#features-stub-runner-additional-config"></a><a class="link" href="#features-stub-runner-additional-config">Additional Configuration</a></h5>
+<div class="paragraph">
+<p>You can match the <code>artifactId</code> of the stub with the name of your application by using the <code>stubrunner.idsToServiceIds:</code> map.
+You can disable Stub Runner Ribbon support by setting <code>stubrunner.cloud.ribbon.enabled</code> to <code>false</code>
+You can disable Stub Runner support by setting <code>stubrunner.cloud.enabled</code> to <code>false</code></p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+By default, all service discovery is stubbed. This means that, regardless of whether you have
+an existing <code>DiscoveryClient</code>, its results are ignored. However, if you want to reuse it, you can set
+ <code>stubrunner.cloud.delegate.enabled</code> to <code>true</code>, and then your existing <code>DiscoveryClient</code> results are
+ merged with the stubbed ones.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The default Maven configuration used by Stub Runner can be tweaked either
+by setting the following system properties or by setting the corresponding environment variables:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>maven.repo.local</code>: Path to the custom maven local repository location</p>
+</li>
+<li>
+<p><code>org.apache.maven.user-settings</code>: Path to custom maven user settings location</p>
+</li>
+<li>
+<p><code>org.apache.maven.global-settings</code>: Path to maven global settings location</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-boot"><a class="anchor" href="#features-stub-runner-boot"></a><a class="link" href="#features-stub-runner-boot">4.5.6. Using the Stub Runner Boot Application</a></h4>
+<div class="paragraph">
+<p>Spring Cloud Contract Stub Runner Boot is a Spring Boot application that exposes REST endpoints to
+trigger the messaging labels and to access WireMock servers.</p>
+</div>
+<div class="paragraph">
+<p>One of the use cases is to run some smoke (end-to-end) tests on a deployed application.
+You can check out the <a href="https://github.com/spring-cloud/spring-cloud-pipelines">Spring Cloud Pipelines</a>
+project for more information.</p>
+</div>
+<div class="sect5">
+<h6 id="features-stub-runner-boot-server"><a class="anchor" href="#features-stub-runner-boot-server"></a><a class="link" href="#features-stub-runner-boot-server">Stub Runner Server</a></h6>
+<div class="paragraph">
+<p>To use the Stub Runner Server, add the following dependency:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">compile "org.springframework.cloud:spring-cloud-starter-stub-runner"</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Then annotate a class with <code>@EnableStubRunnerServer</code>, build a fat jar, and it is ready to work.</p>
+</div>
+<div class="paragraph">
+<p>For the properties, see the <a href="#features-stub-runner-rule-spring">Stub Runner Spring</a> section.</p>
+</div>
+</div>
+<div class="sect5">
+<h6 id="features-stub-runner-boot-how-fat-jar"><a class="anchor" href="#features-stub-runner-boot-how-fat-jar"></a><a class="link" href="#features-stub-runner-boot-how-fat-jar">Stub Runner Server Fat Jar</a></h6>
+<div class="paragraph">
+<p>You can download a standalone JAR from Maven (for example, for version 2.0.1.RELEASE)
+by running the following commands:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">$ wget -O stub-runner.jar 'https://search.maven.org/remotecontent?filepath=org/springframework/cloud/spring-cloud-contract-stub-runner-boot/2.0.1.RELEASE/spring-cloud-contract-stub-runner-boot-2.0.1.RELEASE.jar'
+$ java -jar stub-runner.jar --stubrunner.ids=... --stubrunner.repositoryRoot=...</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect5">
+<h6 id="features-stub-runner-boot-how-cli"><a class="anchor" href="#features-stub-runner-boot-how-cli"></a><a class="link" href="#features-stub-runner-boot-how-cli">Spring Cloud CLI</a></h6>
+<div class="paragraph">
+<p>Starting from the <code>1.4.0.RELEASE</code> version of the <a href="https://cloud.spring.io/spring-cloud-cli">Spring Cloud CLI</a>
+project, you can start Stub Runner Boot by running <code>spring cloud stubrunner</code>.</p>
+</div>
+<div class="paragraph">
+<p>In order to pass the configuration, you can create a <code>stubrunner.yml</code> file in the current working directory,
+in a subdirectory called <code>config</code>, or in <code>~/.spring-cloud</code>. The file could resemble the following
+example for running stubs installed locally:</p>
+</div>
+<div class="exampleblock">
+<div class="title">Example 2. stubrunner.yml</div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-yml hljs" data-lang="yml">stubrunner:
+  stubsMode: LOCAL
+  ids:
+    - com.example:beer-api-producer:+:9876</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Then you can call <code>spring cloud stubrunner</code> from your terminal window to start
+the Stub Runner server. It is available at port <code>8750</code>.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-boot-endpoints"><a class="anchor" href="#features-stub-runner-boot-endpoints"></a><a class="link" href="#features-stub-runner-boot-endpoints">Endpoints</a></h5>
+<div class="paragraph">
+<p>Stub Runner Boot offers two endpoints:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#features-stub-runner-boot-endpoints-http">HTTP</a></p>
+</li>
+<li>
+<p><a href="#features-stub-runner-boot-endpoints-messaging">Messaging</a></p>
+</li>
+</ul>
+</div>
+<div class="sect5">
+<h6 id="features-stub-runner-boot-endpoints-http"><a class="anchor" href="#features-stub-runner-boot-endpoints-http"></a><a class="link" href="#features-stub-runner-boot-endpoints-http">HTTP</a></h6>
+<div class="paragraph">
+<p>For HTTP, Stub Runner Boot makes the following endpoints available:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>GET <code>/stubs</code>: Returns a list of all running stubs in <code>ivy:integer</code> notation</p>
+</li>
+<li>
+<p>GET <code>/stubs/{ivy}</code>: Returns a port for the given <code>ivy</code> notation (when calling the endpoint <code>ivy</code> can also be <code>artifactId</code> only)</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect5">
+<h6 id="features-stub-runner-boot-endpoints-messaging"><a class="anchor" href="#features-stub-runner-boot-endpoints-messaging"></a><a class="link" href="#features-stub-runner-boot-endpoints-messaging">Messaging</a></h6>
+<div class="paragraph">
+<p>For Messaging, Stub Runner Boot makes the following endpoints available:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>GET <code>/triggers</code>: Returns a list of all running labels in <code>ivy : [ label1, label2 &#8230;&#8203;]</code> notation</p>
+</li>
+<li>
+<p>POST <code>/triggers/{label}</code>: Runs a trigger with <code>label</code></p>
+</li>
+<li>
+<p>POST <code>/triggers/{ivy}/{label}</code>: Runs a trigger with a <code>label</code> for the given <code>ivy</code> notation
+(when calling the endpoint, <code>ivy</code> can also be <code>artifactId</code> only)</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-boot-endpoints-example"><a class="anchor" href="#features-stub-runner-boot-endpoints-example"></a><a class="link" href="#features-stub-runner-boot-endpoints-example">Example</a></h5>
+<div class="paragraph">
+<p>The following example shows typical usage of Stub Runner Boot:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@ContextConfiguration(classes = StubRunnerBoot, loader = SpringBootContextLoader)
+@SpringBootTest(properties = "spring.cloud.zookeeper.enabled=false")
+@ActiveProfiles("test")
+class StubRunnerBootSpec extends Specification {
+
+    @Autowired
+    StubRunning stubRunning
+
+    def setup() {
+        RestAssuredMockMvc.standaloneSetup(new HttpStubsController(stubRunning),
+                new TriggerController(stubRunning))
+    }
+
+    def 'should return a list of running stub servers in "full ivy:port" notation'() {
+        when:
+            String response = RestAssuredMockMvc.get('/stubs').body.asString()
+        then:
+            def root = new JsonSlurper().parseText(response)
+            root.'org.springframework.cloud.contract.verifier.stubs:bootService:0.0.1-SNAPSHOT:stubs' instanceof Integer
+    }
+
+    def 'should return a port on which a [#stubId] stub is running'() {
+        when:
+            def response = RestAssuredMockMvc.get("/stubs/${stubId}")
+        then:
+            response.statusCode == 200
+            Integer.valueOf(response.body.asString()) &gt; 0
+        where:
+            stubId &lt;&lt; ['org.springframework.cloud.contract.verifier.stubs:bootService:+:stubs',
+                       'org.springframework.cloud.contract.verifier.stubs:bootService:0.0.1-SNAPSHOT:stubs',
+                       'org.springframework.cloud.contract.verifier.stubs:bootService:+',
+                       'org.springframework.cloud.contract.verifier.stubs:bootService',
+                       'bootService']
+    }
+
+    def 'should return 404 when missing stub was called'() {
+        when:
+            def response = RestAssuredMockMvc.get("/stubs/a:b:c:d")
+        then:
+            response.statusCode == 404
+    }
+
+    def 'should return a list of messaging labels that can be triggered when version and classifier are passed'() {
+        when:
+            String response = RestAssuredMockMvc.get('/triggers').body.asString()
+        then:
+            def root = new JsonSlurper().parseText(response)
+            root.'org.springframework.cloud.contract.verifier.stubs:bootService:0.0.1-SNAPSHOT:stubs'?.containsAll(["delete_book", "return_book_1", "return_book_2"])
+    }
+
+    def 'should trigger a messaging label'() {
+        given:
+            StubRunning stubRunning = Mock()
+            RestAssuredMockMvc.standaloneSetup(new HttpStubsController(stubRunning), new TriggerController(stubRunning))
+        when:
+            def response = RestAssuredMockMvc.post("/triggers/delete_book")
+        then:
+            response.statusCode == 200
+        and:
+            1 * stubRunning.trigger('delete_book')
+    }
+
+    def 'should trigger a messaging label for a stub with [#stubId] ivy notation'() {
+        given:
+            StubRunning stubRunning = Mock()
+            RestAssuredMockMvc.standaloneSetup(new HttpStubsController(stubRunning), new TriggerController(stubRunning))
+        when:
+            def response = RestAssuredMockMvc.post("/triggers/$stubId/delete_book")
+        then:
+            response.statusCode == 200
+        and:
+            1 * stubRunning.trigger(stubId, 'delete_book')
+        where:
+            stubId &lt;&lt; ['org.springframework.cloud.contract.verifier.stubs:bootService:stubs', 'org.springframework.cloud.contract.verifier.stubs:bootService', 'bootService']
+    }
+
+    def 'should throw exception when trigger is missing'() {
+        when:
+            RestAssuredMockMvc.post("/triggers/missing_label")
+        then:
+            Exception e = thrown(Exception)
+            e.message.contains("Exception occurred while trying to return [missing_label] label.")
+            e.message.contains("Available labels are")
+            e.message.contains("org.springframework.cloud.contract.verifier.stubs:loanIssuance:0.0.1-SNAPSHOT:stubs=[]")
+            e.message.contains("org.springframework.cloud.contract.verifier.stubs:bootService:0.0.1-SNAPSHOT:stubs=")
+    }
+
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-boot-service-discovery"><a class="anchor" href="#features-stub-runner-boot-service-discovery"></a><a class="link" href="#features-stub-runner-boot-service-discovery">Stub Runner Boot with Service Discovery</a></h5>
+<div class="paragraph">
+<p>One way to use Stub Runner Boot is to use it as a feed of stubs for &#8220;smoke tests&#8221;. What does that mean?
+Assume that you do not want to deploy 50 microservices to a test environment in order
+to see whether your application works. You have already executed a suite of tests during the build process,
+but you would also like to ensure that the packaging of your application works. You can
+deploy your application to an environment, start it, and run a couple of tests on it to see whether
+it works. We can call those tests &#8220;smoke tests&#8221;, because their purpose is to check only a handful
+of testing scenarios.</p>
+</div>
+<div class="paragraph">
+<p>The problem with this approach is thatm if you use microservices, you most likely also
+use a service discovery tool. Stub Runner Boot lets you solve this issue by starting the
+required stubs and registering them in a service discovery tool. Consider the following example of
+such a setup with Eureka (assume that Eureka is already running):</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@SpringBootApplication
+@EnableStubRunnerServer
+@EnableEurekaClient
+@AutoConfigureStubRunner
+public class StubRunnerBootEurekaExample {
+
+    public static void main(String[] args) {
+        SpringApplication.run(StubRunnerBootEurekaExample.class, args);
+    }
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>We want to start a Stub Runner Boot server (<code>@EnableStubRunnerServer</code>), enable the Eureka client (<code>@EnableEurekaClient</code>),
+and have the stub runner feature turned on (<code>@AutoConfigureStubRunner</code>).</p>
+</div>
+<div class="paragraph">
+<p>Now assume that we want to start this application so that the stubs get automatically registered.
+We can do so by running the application with <code>java -jar ${SYSTEM_PROPS} stub-runner-boot-eureka-example.jar</code>, where
+<code>${SYSTEM_PROPS}</code> contains the following list of properties:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">* -Dstubrunner.repositoryRoot=https://repo.spring.io/snapshot (1)
+* -Dstubrunner.cloud.stubbed.discovery.enabled=false (2)
+* -Dstubrunner.ids=org.springframework.cloud.contract.verifier.stubs:loanIssuance,org.
+* springframework.cloud.contract.verifier.stubs:fraudDetectionServer,org.springframework.
+* cloud.contract.verifier.stubs:bootService (3)
+* -Dstubrunner.idsToServiceIds.fraudDetectionServer=
+* someNameThatShouldMapFraudDetectionServer (4)
+*
+* (1) - we tell Stub Runner where all the stubs reside (2) - we don't want the default
+* behaviour where the discovery service is stubbed. That's why the stub registration will
+* be picked (3) - we provide a list of stubs to download (4) - we provide a list of</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>That way, your deployed application can send requests to started WireMock servers through service
+discovery. Most likely, points 1 through 3 could be set by default in <code>application.yml</code>, because they are not
+likely to change. That way, you can provide only the list of stubs to download whenever you start
+the Stub Runner Boot.</p>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-stubs-per-consumer"><a class="anchor" href="#features-stub-runner-stubs-per-consumer"></a><a class="link" href="#features-stub-runner-stubs-per-consumer">4.5.7. Consumer-Driven Contracts: Stubs Per Consumer</a></h4>
+<div class="paragraph">
+<p>There are cases in which two consumers of the same endpoint want to have two different responses.</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+This approach also lets you immediately know which consumer uses which part of your API.
+You can remove part of a response that your API produces and see which of your autogenerated tests
+fails. If none fails, you can safely delete that part of the response, because nobody uses it.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Consider the following example of a contract defined for the producer called <code>producer</code>,
+which has two consumers (<code>foo-consumer</code> and <code>bar-consumer</code>):</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="title">Consumer <code>foo-service</code></div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">request {
+   url '/foo'
+   method GET()
+}
+response {
+    status OK()
+    body(
+       foo: "foo"
+    }
+}</code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="title">Consumer <code>bar-service</code></div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">request {
+   url '/bar'
+   method GET()
+}
+response {
+    status OK()
+    body(
+       bar: "bar"
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You cannot produce two different responses for the same request. That is why you can properly package the
+contracts and then profit from the <code>stubsPerConsumer</code> feature.</p>
+</div>
+<div class="paragraph">
+<p>On the producer side, the consumers can have a folder that contains contracts related only to them.
+By setting the <code>stubrunner.stubs-per-consumer</code> flag to <code>true</code>, we no longer register all stubs but only those that
+correspond to the consumer application&#8217;s name. In other words, we scan the path of every stub and,
+if it contains a subfolder with name of the consumer in the path, only then is it registered.</p>
+</div>
+<div class="paragraph">
+<p>On the <code>foo</code> producer side the contracts would look like this</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">.
+└── contracts
+    ├── bar-consumer
+    │   ├── bookReturnedForBar.groovy
+    │   └── shouldCallBar.groovy
+    └── foo-consumer
+        ├── bookReturnedForFoo.groovy
+        └── shouldCallFoo.groovy</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The <code>bar-consumer</code> consumer can either set the <code>spring.application.name</code> or the <code>stubrunner.consumer-name</code> to <code>bar-consumer</code>
+Alternatively, you can set the test as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@ContextConfiguration(classes = Config, loader = SpringBootContextLoader)
+@SpringBootTest(properties = ["spring.application.name=bar-consumer"])
+@AutoConfigureStubRunner(ids = "org.springframework.cloud.contract.verifier.stubs:producerWithMultipleConsumers",
+        repositoryRoot = "classpath:m2repo/repository/",
+        stubsMode = StubRunnerProperties.StubsMode.REMOTE,
+        stubsPerConsumer = true)
+class StubRunnerStubsPerConsumerSpec extends Specification {
+...
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Then only the stubs registered under a path that contains <code>bar-consumer</code> in its name (that is, those from the
+<code>src/test/resources/contracts/bar-consumer/some/contracts/&#8230;&#8203;</code> folder) are allowed to be referenced.</p>
+</div>
+<div class="paragraph">
+<p>You can also set the consumer name explicitly, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">@ContextConfiguration(classes = Config, loader = SpringBootContextLoader)
+@SpringBootTest
+@AutoConfigureStubRunner(ids = "org.springframework.cloud.contract.verifier.stubs:producerWithMultipleConsumers",
+        repositoryRoot = "classpath:m2repo/repository/",
+        consumerName = "foo-consumer",
+        stubsMode = StubRunnerProperties.StubsMode.REMOTE,
+        stubsPerConsumer = true)
+class StubRunnerStubsPerConsumerWithConsumerNameSpec extends Specification {
+...
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Then only the stubs registered under a path that contains the <code>foo-consumer</code> in its name (that is, those from the
+<code>src/test/resources/contracts/foo-consumer/some/contracts/&#8230;&#8203;</code> folder) are allowed to be referenced.</p>
+</div>
+<div class="paragraph">
+<p>See <a href="https://github.com/spring-cloud/spring-cloud-contract/issues/224">issue 224</a> for more
+information about the reasons behind this change.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-stubs-protocol"><a class="anchor" href="#features-stub-runner-stubs-protocol"></a><a class="link" href="#features-stub-runner-stubs-protocol">4.5.8. Fetching Stubs or Contract Definitions From A Location</a></h4>
+<div class="paragraph">
+<p>Instead of picking the stubs or contract definitions from
+Artifactory / Nexus or Git, one can just want to point to
+a location on drive or classpath. This can be especially useful in a multimodule project, where one module wants
+to reuse stubs or contracts from another module without
+the need to actually install those in a local maven
+repository ot commit those changes to Git.</p>
+</div>
+<div class="paragraph">
+<p>In order to achieve this it&#8217;s enough to use the <code>stubs://</code>
+protocol when the repository root parameter is set either
+in Stub Runner or in a Spring Cloud Contract plugin.</p>
+</div>
+<div class="paragraph">
+<p>In this example the <code>producer</code> project has been successfully
+built and stubs were generated under the <code>target/stubs</code> folder. As a consumer one can setup the Stub Runner to pick the stubs from that location using the <code>stubs://</code> protocol.</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Annotation</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(
+stubsMode = StubRunnerProperties.StubsMode.REMOTE,
+        repositoryRoot = "stubs://file://location/to/the/producer/target/stubs/",
+        ids = "com.example:some-producer")</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 4 Rule</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Rule
+    public StubRunnerRule rule = new StubRunnerRule()
+            .downloadStub("com.example:some-producer")
+            .repoRoot("stubs://file://location/to/the/producer/target/stubs/")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE);</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 5 Extension</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RegisterExtension
+    public StubRunnerExtension stubRunnerExtension = new StubRunnerExtension()
+            .downloadStub("com.example:some-producer")
+            .repoRoot("stubs://file://location/to/the/producer/target/stubs/")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE);</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Contracts and stubs may be stored in a location, where each producer has its own, dedicated folder for contracts and stub mappings. Under that folder each consumer can have its own setup. To make Stub Runner find the dedicated folder from the provided ids one can pass a property <code>stubs.find-producer=true</code> or a system property <code>stubrunner.stubs.find-producer=true</code> .</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="paragraph">
+<p>└── com.example &lt;1&gt;
+    ├── some-artifact-id &lt;2&gt;
+    │   └── 0.0.1
+    │       ├── contracts &lt;3&gt;
+    │       │   └── shouldReturnStuffForArtifactId.groovy
+    │       └── mappings &lt;4&gt;
+    │           └── shouldReturnStuffForArtifactId.json
+    └── some-other-artifact-id &lt;5&gt;
+        ├── contracts
+        │   └── shouldReturnStuffForOtherArtifactId.groovy
+        └── mappings
+            └── shouldReturnStuffForOtherArtifactId.json</p>
+</div>
+</div>
+</div>
+<div class="colist arabic">
+<table>
+<tr>
+<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>group id of the consumers</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="2"></i><b>2</b></td>
+<td>consumer with artifact id [some-artifact-id]</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="3"></i><b>3</b></td>
+<td>contracts for the consumer with artifact id [some-artifact-id]</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="4"></i><b>4</b></td>
+<td>mappings for the consumer with artifact id [some-artifact-id]</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="5"></i><b>5</b></td>
+<td>consumer with artifact id [some-other-artifact-id]</td>
+</tr>
+</table>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Annotation</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(
+stubsMode = StubRunnerProperties.StubsMode.REMOTE,
+        repositoryRoot = "stubs://file://location/to/the/contracts/directory",
+        ids = "com.example:some-producer",
+        properties="stubs.find-producer=true")</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 4 Rule</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">    static Map&lt;String, String&gt; contractProperties() {
+        Map&lt;String, String&gt; map = new HashMap&lt;&gt;();
+        map.put("stubs.find-producer", "true");
+        return map;
+    }
+
+@Rule
+    public StubRunnerRule rule = new StubRunnerRule()
+            .downloadStub("com.example:some-producer")
+            .repoRoot("stubs://file://location/to/the/contracts/directory")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+            .properties(contractProperties());</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 5 Extension</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">    static Map&lt;String, String&gt; contractProperties() {
+        Map&lt;String, String&gt; map = new HashMap&lt;&gt;();
+        map.put("stubs.find-producer", "true");
+        return map;
+    }
+
+@RegisterExtension
+    public StubRunnerExtension stubRunnerExtension = new StubRunnerExtension()
+            .downloadStub("com.example:some-producer")
+            .repoRoot("stubs://file://location/to/the/contracts/directory")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+            .properties(contractProperties());</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-generate-stubs-at-runtime"><a class="anchor" href="#features-stub-runner-generate-stubs-at-runtime"></a><a class="link" href="#features-stub-runner-generate-stubs-at-runtime">4.5.9. Generating Stubs at Runtime</a></h4>
+<div class="paragraph">
+<p>As a consumer, you might not want to wait for the producer to finish its implementation and then publish their stubs. A solution to this problem can be generation of stubs at runtime.</p>
+</div>
+<div class="paragraph">
+<p>As a producer, when a contract is defined, you are required to make the generated tests pass in order for the stubs to be published. There are cases where you would like to unblock the consumers so that they can fetch the stubs before your tests are actually passing. In this case you should set such contracts as in progress. You can read more about this under the <a href="#contract-dsl-in-progress">Contracts in Progress</a> section. That way your tests will not be generated, but the stubs will.</p>
+</div>
+<div class="paragraph">
+<p>As a consumer, you can toggle a switch to generate stubs at runtime. Stub Runner will ignore all the existing stub mappings and will generate new ones for all the contract definitions. Another option is to pass the <code>stubrunner.generate-stubs</code> system property. Below you can find an example of such setup.</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Annotation</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(
+stubsMode = StubRunnerProperties.StubsMode.REMOTE,
+        repositoryRoot = "stubs://file://location/to/the/contracts",
+        ids = "com.example:some-producer",
+        generateStubs = true)</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 4 Rule</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Rule
+    public StubRunnerRule rule = new StubRunnerRule()
+            .downloadStub("com.example:some-producer")
+            .repoRoot("stubs://file://location/to/the/contracts")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+            .withGenerateStubs(true);</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 5 Extension</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RegisterExtension
+    public StubRunnerExtension stubRunnerExtension = new StubRunnerExtension()
+            .downloadStub("com.example:some-producer")
+            .repoRoot("stubs://file://location/to/the/contracts")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+            .withGenerateStubs(true);</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-fail-on-no-stubs"><a class="anchor" href="#features-stub-runner-fail-on-no-stubs"></a><a class="link" href="#features-stub-runner-fail-on-no-stubs">4.5.10. Fail On No Stubs</a></h4>
+<div class="paragraph">
+<p>By default Stub Runner will fail if no stubs were found. In order to change that behaviour, just set to <code>false</code> the <code>failOnNoStubs</code> property in the annotation or call the <code>withFailOnNoStubs(false)</code> method on a JUnit Rule or Extension.</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Annotation</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(
+stubsMode = StubRunnerProperties.StubsMode.REMOTE,
+        repositoryRoot = "stubs://file://location/to/the/contracts",
+        ids = "com.example:some-producer",
+        failOnNoStubs = false)</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 4 Rule</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Rule
+    public StubRunnerRule rule = new StubRunnerRule()
+            .downloadStub("com.example:some-producer")
+            .repoRoot("stubs://file://location/to/the/contracts")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+            .withFailOnNoStubs(false);</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">JUnit 5 Extension</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RegisterExtension
+    public StubRunnerExtension stubRunnerExtension = new StubRunnerExtension()
+            .downloadStub("com.example:some-producer")
+            .repoRoot("stubs://file://location/to/the/contracts")
+            .stubsMode(StubRunnerProperties.StubsMode.REMOTE)
+            .withFailOnNoStubs(false);</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-stub-runner-common"><a class="anchor" href="#features-stub-runner-common"></a><a class="link" href="#features-stub-runner-common">4.5.11. Common Properties</a></h4>
+<div class="paragraph">
+<p>This section briefly describes common properties, including:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#features-stub-runner-common-properties-junit-spring">Common Properties for JUnit and Spring</a></p>
+</li>
+<li>
+<p><a href="#features-stub-runner-stub-runner-stub-ids">Stub Runner Stubs IDs</a></p>
+</li>
+</ul>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-common-properties-junit-spring"><a class="anchor" href="#features-stub-runner-common-properties-junit-spring"></a><a class="link" href="#features-stub-runner-common-properties-junit-spring">Common Properties for JUnit and Spring</a></h5>
+<div class="paragraph">
+<p>You can set repetitive properties by using system properties or Spring configuration
+properties. The following table shows their names with their default values:</p>
+</div>
+<table class="tableblock frame-topbot grid-all stretch">
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Property name</th>
+<th class="tableblock halign-left valign-top">Default value</th>
+<th class="tableblock halign-left valign-top">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.minPort</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">10000</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Minimum value of a port for a started WireMock with stubs.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.maxPort</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">15000</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Maximum value of a port for a started WireMock with stubs.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.repositoryRoot</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Maven repo URL. If blank, then call the local Maven repo.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.classifier</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubs</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Default classifier for the stub artifacts.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.stubsMode</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">CLASSPATH</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The way you want to fetch and register the stubs</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.ids</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Ivy notation stubs to download.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.username</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Optional username to access the tool that stores the JARs with
+stubs.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.password</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Optional password to access the tool that stores the JARs with
+stubs.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.stubsPerConsumer</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>false</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Set to <code>true</code> if you want to use different stubs for
+each consumer instead of registering all stubs for every consumer.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">stubrunner.consumerName</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">If you want to use a stub for each consumer and want to
+override the consumer name, change this value.</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect4">
+<h5 id="features-stub-runner-stub-runner-stub-ids"><a class="anchor" href="#features-stub-runner-stub-runner-stub-ids"></a><a class="link" href="#features-stub-runner-stub-runner-stub-ids">Stub Runner Stubs IDs</a></h5>
+<div class="paragraph">
+<p>You can set the stubs to download in the <code>stubrunner.ids</code> system property. They
+use the following pattern:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">groupId:artifactId:version:classifier:port</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that <code>version</code>, <code>classifier</code>, and <code>port</code> are optional.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>If you do not provide the <code>port</code>, a random one is picked.</p>
+</li>
+<li>
+<p>If you do not provide the <code>classifier</code>, the default is used. (Note that you can
+pass an empty classifier this way: <code>groupId:artifactId:version:</code>).</p>
+</li>
+<li>
+<p>If you do not provide the <code>version</code>, then <code>+</code> is passed, and the latest one is
+downloaded.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p><code>port</code> means the port of the WireMock server.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Starting with version 1.0.4, you can provide a range of versions that you
+would like the Stub Runner to take into consideration. You can read more about the
+<a href="https://wiki.eclipse.org/Aether/New_and_Noteworthy#Version_Ranges">Aether versioning
+ranges here</a>.
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-wiremock"><a class="anchor" href="#features-wiremock"></a><a class="link" href="#features-wiremock">4.6. Spring Cloud Contract WireMock</a></h3>
+<div class="paragraph">
+<p>The Spring Cloud Contract WireMock modules let you use <a href="https://github.com/tomakehurst/wiremock">WireMock</a> in a
+Spring Boot application. Check out the
+<a href="https://github.com/spring-cloud/spring-cloud-contract/tree/{branch}/samples">samples</a>
+for more details.</p>
+</div>
+<div class="paragraph">
+<p>If you have a Spring Boot application that uses Tomcat as an embedded server (which is
+the default with <code>spring-boot-starter-web</code>), you can add
+<code>spring-cloud-starter-contract-stub-runner</code> to your classpath and add <code>@AutoConfigureWireMock</code>
+to use Wiremock in your tests. Wiremock runs as a stub server, and you
+can register stub behavior by using a Java API or by using static JSON declarations as part of
+your test. The following code shows an example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT)
+@AutoConfigureWireMock(port = 0)
+public class WiremockForDocsTests {
+
+    // A service that calls out over HTTP
+    @Autowired
+    private Service service;
+
+    @Before
+    public void setup() {
+        this.service.setBase("http://localhost:"
+                + this.environment.getProperty("wiremock.server.port"));
+    }
+
+    // Using the WireMock APIs in the normal way:
+    @Test
+    public void contextLoads() throws Exception {
+        // Stubbing WireMock
+        stubFor(get(urlEqualTo("/resource")).willReturn(aResponse()
+                .withHeader("Content-Type", "text/plain").withBody("Hello World!")));
+        // We're asserting if WireMock responded properly
+        assertThat(this.service.go()).isEqualTo("Hello World!");
+    }
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>To start the stub server on a different port, use (for example),
+<code>@AutoConfigureWireMock(port=9999)</code>. For a random port, use a value of <code>0</code>. The stub
+server port can be bound in the test application context with the "wiremock.server.port"
+property. Using <code>@AutoConfigureWireMock</code> adds a bean of type <code>WiremockConfiguration</code> to
+your test application context, where it is cached between methods and classes
+having the same context. The same is true for Spring integration tests. Also, you can
+inject a bean of type <code>WireMockServer</code> into your test.</p>
+</div>
+<div class="sect3">
+<h4 id="features-wiremock-registering-stubs"><a class="anchor" href="#features-wiremock-registering-stubs"></a><a class="link" href="#features-wiremock-registering-stubs">4.6.1. Registering Stubs Automatically</a></h4>
+<div class="paragraph">
+<p>If you use <code>@AutoConfigureWireMock</code>, it registers WireMock JSON stubs from the file
+system or classpath (by default, from <code>file:src/test/resources/mappings</code>). You can
+customize the locations byusing the <code>stubs</code> attribute in the annotation, which can be an
+Ant-style resource pattern or a directory. In the case of a directory, <code><strong>*/</strong>.json</code> is
+appended. The following code shows an example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre>@RunWith(SpringRunner.class)
+@SpringBootTest
+@AutoConfigureWireMock(stubs="classpath:/stubs")
+public class WiremockImportApplicationTests {
+
+    @Autowired
+    private Service service;
+
+    @Test
+    public void contextLoads() throws Exception {
+        assertThat(this.service.go()).isEqualTo("Hello World!");
+    }
+
+}</pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+Actually, WireMock always loads mappings from <code>src/test/resources/mappings</code> <strong>as
+well as</strong> the custom locations in the <code>stubs</code> attribute. To change this behavior, you can
+also specify a files root, as described in the next section of this document.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>If you use Spring Cloud Contract&#8217;s default stub jars, your
+stubs are stored in the <code>/META-INF/group-id/artifact-id/versions/mappings/</code> folder.
+If you want to register all stubs from that location, from all embedded JARs, you can use
+the following syntax:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureWireMock(port = 0, stubs = "classpath*:/META-INF/**/mappings/**/*.json")</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-wiremock-using-files"><a class="anchor" href="#features-wiremock-using-files"></a><a class="link" href="#features-wiremock-using-files">4.6.2. Using Files to Specify the Stub Bodies</a></h4>
+<div class="paragraph">
+<p>WireMock can read response bodies from files on the classpath or the file system. In the
+case of the file system, you can see in the JSON DSL that the response has a <code>bodyFileName</code> instead of a
+(literal) <code>body</code>. The files are resolved relative to a root directory (by default,
+<code>src/test/resources/__files</code>). To customize this location, you can set the <code>files</code>
+attribute in the <code>@AutoConfigureWireMock</code> annotation to the location of the parent
+directory (in other words, <code>__files</code> is a subdirectory). You can use Spring resource
+notation to refer to <code>file:&#8230;&#8203;</code> or <code>classpath:&#8230;&#8203;</code> locations. Generic URLs are not
+supported. A list of values can be given&#8201;&#8212;&#8201;in which case, WireMock resolves the first file
+that exists when it needs to find a response body.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+When you configure the <code>files</code> root, it also affects the
+automatic loading of stubs, because they come from the root location
+in a subdirectory called <code>mappings</code>. The value of <code>files</code> has no
+effect on the stubs loaded explicitly from the <code>stubs</code> attribute.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-wiremock-junit-rule"><a class="anchor" href="#features-wiremock-junit-rule"></a><a class="link" href="#features-wiremock-junit-rule">4.6.3. Alternative: Using JUnit Rules</a></h4>
+<div class="paragraph">
+<p>For a more conventional WireMock experience, you can use JUnit <code>@Rules</code> to start and stop
+the server. To do so, use the <code>WireMockSpring</code> convenience class to obtain an <code>Options</code>
+instance, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT)
+public class WiremockForDocsClassRuleTests {
+
+    // Start WireMock on some dynamic port
+    // for some reason `dynamicPort()` is not working properly
+    @ClassRule
+    public static WireMockClassRule wiremock = new WireMockClassRule(
+            WireMockSpring.options().dynamicPort());
+
+    // A service that calls out over HTTP to wiremock's port
+    @Autowired
+    private Service service;
+
+    @Before
+    public void setup() {
+        this.service.setBase("http://localhost:" + wiremock.port());
+    }
+
+    // Using the WireMock APIs in the normal way:
+    @Test
+    public void contextLoads() throws Exception {
+        // Stubbing WireMock
+        wiremock.stubFor(get(urlEqualTo("/resource")).willReturn(aResponse()
+                .withHeader("Content-Type", "text/plain").withBody("Hello World!")));
+        // We're asserting if WireMock responded properly
+        assertThat(this.service.go()).isEqualTo("Hello World!");
+    }
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The <code>@ClassRule</code> means that the server shuts down after all the methods in this class
+have been run.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-wiremock-relaxed-ssl"><a class="anchor" href="#features-wiremock-relaxed-ssl"></a><a class="link" href="#features-wiremock-relaxed-ssl">4.6.4. Relaxed SSL Validation for Rest Template</a></h4>
+<div class="paragraph">
+<p>WireMock lets you stub a &#8220;secure&#8221; server with an <code>https</code> URL protocol. If your
+application wants to contact that stub server in an integration test, it will find that
+the SSL certificates are not valid (the usual problem with self-installed certificates).
+The best option is often to re-configure the client to use <code>http</code>. If that is not an
+option, you can ask Spring to configure an HTTP client that ignores SSL validation errors
+(do so only for tests, of course).</p>
+</div>
+<div class="paragraph">
+<p>To make this work with minimum fuss, you need to use the Spring Boot
+<code>RestTemplateBuilder</code> in your application, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Bean
+public RestTemplate restTemplate(RestTemplateBuilder builder) {
+    return builder.build();
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You need <code>RestTemplateBuilder</code> because the builder is passed through callbacks to
+initialize it, so the SSL validation can be set up in the client at that point. This
+happens automatically in your test if you use the <code>@AutoConfigureWireMock</code>
+annotation or the stub runner. If you use the JUnit <code>@Rule</code> approach, you need to add the
+<code>@AutoConfigureHttpClient</code> annotation as well, as the following example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
+@SpringBootTest("app.baseUrl=https://localhost:6443")
+@AutoConfigureHttpClient
+public class WiremockHttpsServerApplicationTests {
+
+    @ClassRule
+    public static WireMockClassRule wiremock = new WireMockClassRule(
+            WireMockSpring.options().httpsPort(6443));
+...
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>If you use <code>spring-boot-starter-test</code>, you have the Apache HTTP client on the
+classpath, and it is selected by the <code>RestTemplateBuilder</code> and configured to ignore SSL
+errors. If you use the default <code>java.net</code> client, you do not need the annotation (but it
+does no harm). There is currently no support for other clients, but it may be added
+in future releases.</p>
+</div>
+<div class="paragraph">
+<p>To disable the custom <code>RestTemplateBuilder</code>, set the <code>wiremock.rest-template-ssl-enabled</code>
+property to <code>false</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="features-wiremock-spring-mvc-mocks"><a class="anchor" href="#features-wiremock-spring-mvc-mocks"></a><a class="link" href="#features-wiremock-spring-mvc-mocks">4.6.5. WireMock and Spring MVC Mocks</a></h4>
+<div class="paragraph">
+<p>Spring Cloud Contract provides a convenience class that can load JSON WireMock stubs into
+a Spring <code>MockRestServiceServer</code>. The following code shows an example:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
+@SpringBootTest(webEnvironment = WebEnvironment.NONE)
+public class WiremockForDocsMockServerApplicationTests {
+
+    @Autowired
+    private RestTemplate restTemplate;
+
+    @Autowired
+    private Service service;
+
+    @Test
+    public void contextLoads() throws Exception {
+        // will read stubs classpath
+        MockRestServiceServer server = WireMockRestServiceServer.with(this.restTemplate)
+                .baseUrl("https://example.org").stubs("classpath:/stubs/resource.json")
+                .build();
+        // We're asserting if WireMock responded properly
+        assertThat(this.service.go()).isEqualTo("Hello World");
+        server.verify();
+    }
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The <code>baseUrl</code> value is prepended to all mock calls, and the <code>stubs()</code> method takes a stub
+path resource pattern as an argument. In the preceding example, the stub defined at
+<code>/stubs/resource.json</code> is loaded into the mock server. If the <code>RestTemplate</code> is asked to
+visit <code><a href="https://example.org/" class="bare">example.org/</a></code>, it gets the responses as being declared at that URL. More
+than one stub pattern can be specified, and each one can be a directory (for a recursive
+list of all <code>.json</code>), a fixed filename (as in the preceding example), or an Ant-style
+pattern. The JSON format is the normal WireMock format, which you can read about at the
+<a href="https://wiremock.org/docs/stubbing/">WireMock website</a>.</p>
+</div>
+<div class="paragraph">
+<p>Currently, the Spring Cloud Contract Verifier supports Tomcat, Jetty, and Undertow as
+Spring Boot embedded servers, and Wiremock itself has &#8220;native&#8221; support for a particular
+version of Jetty (currently 9.2). To use the native Jetty, you need to add the native
+Wiremock dependencies and exclude the Spring Boot container (if there is one).</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-build-tools"><a class="anchor" href="#features-build-tools"></a><a class="link" href="#features-build-tools">4.7. Build Tools Integration</a></h3>
+<div class="paragraph">
+<p>You can run test generation and stub execution in various ways. The most common ones are
+as follows:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="maven-project.html">Maven</a></p>
+</li>
+<li>
+<p><a href="gradle-project.html">Gradle</a></p>
+</li>
+<li>
+<p><a href="docker-project.html">Docker</a></p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="features-whats-next"><a class="anchor" href="#features-whats-next"></a><a class="link" href="#features-whats-next">4.8. What to Read Next</a></h3>
+<div class="paragraph">
+<p>If you want to learn more about any of the classes discussed in this section, you can browse the
+<a href="https://github.com/spring-cloud/spring-cloud-contract/tree/${github-tag}">source code directly</a>. If you have specific questions, see the
+<a href="#howto">how-to</a> section.</p>
+</div>
+<div class="paragraph">
+<p>If you are comfortable with Spring Cloud Contract&#8217;s core features, you can continue on and read
+about
+<a href="#advanced.adoc">Spring Cloud Contract&#8217;s advanced features</a>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="howto"><a class="anchor" href="#howto"></a><a class="link" href="#howto">5. &#8220;How-to&#8221; Guides</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This section provides answers to some common &#8220;how do I do that&#8230;&#8203;&#8221; questions
+that often arise when using Spring Cloud Contract. Its coverage is not exhaustive, but it
+does cover quite a lot.</p>
+</div>
+<div class="paragraph">
+<p>If you have a specific problem that we do not cover here, you might want to check out
+<a href="https://stackoverflow.com/tags/spring-cloud-contract">stackoverflow.com</a> to see if someone has
+already provided an answer. Stack Overflow is also a great place to ask new questions (please use
+the <code>spring-cloud-contract</code> tag).</p>
+</div>
+<div class="paragraph">
+<p>We are also more than happy to extend this section. If you want to add a &#8220;how-to&#8221;,
+send us a <a href="https://github.com/spring-cloud/spring-cloud-contract/tree/${github-tag}">pull request</a>.</p>
+</div>
+<div class="sect2">
+<h3 id="why-spring-cloud-contract"><a class="anchor" href="#why-spring-cloud-contract"></a><a class="link" href="#why-spring-cloud-contract">5.1. Why use Spring Cloud Contract?</a></h3>
+<div class="paragraph">
+<p>Spring Cloud Contract works great in a polyglot environment. This project has a lot of
+really interesting features. Quite a few of these features definitely make
+Spring Cloud Contract Verifier stand out on the market of Consumer Driven Contract
+(CDC) tooling. The most interesting features include the following:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Ability to do CDC with messaging.</p>
+</li>
+<li>
+<p>Clear and easy to use, statically typed DSL.</p>
+</li>
+<li>
+<p>Ability to copy-paste your current JSON file to the contract and only edit its elements.</p>
+</li>
+<li>
+<p>Automatic generation of tests from the defined Contract.</p>
+</li>
+<li>
+<p>Stub Runner functionality: The stubs are automatically downloaded at runtime from Nexus/Artifactory.</p>
+</li>
+<li>
+<p>Spring Cloud integration: No discovery service is needed for integration tests.</p>
+</li>
+<li>
+<p>Spring Cloud Contract integrates with Pact and provides easy hooks to extend its functionality.</p>
+</li>
+<li>
+<p>Ability to add support for any language &amp; framework through Docker.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-not-write-contracts-in-groovy"><a class="anchor" href="#how-to-not-write-contracts-in-groovy"></a><a class="link" href="#how-to-not-write-contracts-in-groovy">5.2. How Can I Write Contracts in a Language Other than Groovy?</a></h3>
+<div class="paragraph">
+<p>You can write a contract in YAML. See <a href="#contract-dsl">this section</a> for more information.</p>
+</div>
+<div class="paragraph">
+<p>We are working on allowing more ways of describing the contracts. You can check the <a href="https://github.com/spring-cloud/spring-cloud-contract/issues/">github-issues</a> for more information.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-provide-dynamic-values"><a class="anchor" href="#how-to-provide-dynamic-values"></a><a class="link" href="#how-to-provide-dynamic-values">5.3. How Can I Provide Dynamic Values to a Contract?</a></h3>
+<div class="paragraph">
+<p>One of the biggest challenges related to stubs is their reusability. Only if they can be widely used can they serve their purpose.
+The hard-coded values (such as dates and IDs) of request and response elements generally make that difficult.
+Consider the following JSON request:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+    "time" : "2016-10-10 20:10:15",
+    "id" : "9febab1c-6f36-4a0b-88d6-3b6a6d81cd4a",
+    "body" : "foo"
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Now consider the following JSON response:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+    "time" : "2016-10-10 21:10:15",
+    "id" : "c4231e1f-3ca9-48d3-b7e7-567d55f0d051",
+    "body" : "bar"
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Imagine the pain required to set the proper value of the <code>time</code> field (assume that this content is generated by the
+database) by changing the clock in the system or by providing stub implementations of data providers. The same is related
+to the field called <code>id</code>. You could create a stubbed implementation of UUID generator, but doing so makes little sense.</p>
+</div>
+<div class="paragraph">
+<p>So, as a consumer, you want to send a request that matches any form of a time or any UUID. That way, your system
+works as usual, generating data without you having to stub out anything. Assume that, in case of the aforementioned
+JSON, the most important part is the <code>body</code> field. You can focus on that and provide matching for other fields. In other words,
+you would like the stub to work as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+    "time" : "SOMETHING THAT MATCHES TIME",
+    "id" : "SOMETHING THAT MATCHES UUID",
+    "body" : "foo"
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>As far as the response goes, as a consumer, you need a concrete value on which you can operate.
+Consequently, the following JSON is valid:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+    "time" : "2016-10-10 21:10:15",
+    "id" : "c4231e1f-3ca9-48d3-b7e7-567d55f0d051",
+    "body" : "bar"
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In the previous sections, we generated tests from contracts. So, from the producer&#8217;s side, the situation looks
+much different. We parse the provided contract, and, in the test, we want to send a real request to your endpoints.
+So, for the case of a producer for the request, we cannot have any sort of matching. We need concrete values on which the
+producer&#8217;s backend can work. Consequently, the following JSON would be valid:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+    "time" : "2016-10-10 20:10:15",
+    "id" : "9febab1c-6f36-4a0b-88d6-3b6a6d81cd4a",
+    "body" : "foo"
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>On the other hand, from the point of view of the validity of the contract, the response does not necessarily have to
+contain concrete values for <code>time</code> or <code>id</code>. Suppose you generate those on the producer side. Again, you
+have to do a lot of stubbing to ensure that you always return the same values. That is why, from the producer&#8217;s side
+you might want the following response:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+    "time" : "SOMETHING THAT MATCHES TIME",
+    "id" : "SOMETHING THAT MATCHES UUID",
+    "body" : "bar"
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>How can you then provide a matcher for the consumer and a concrete value for the producer (and the opposite at some other time)?
+Spring Cloud Contract lets you provide a dynamic value. That means that it can differ for both
+sides of the communication.</p>
+</div>
+<div class="paragraph">
+<p>You can read more about this in the <a href="#contract-dsl">Contract DSL</a> section.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Read the <a href="https://groovy-lang.org/json.html">Groovy docs related to JSON</a> to understand how to
+properly structure the request and response bodies.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-do-stubs-versioning"><a class="anchor" href="#how-to-do-stubs-versioning"></a><a class="link" href="#how-to-do-stubs-versioning">5.4. How to Do Stubs versioning?</a></h3>
+<div class="paragraph">
+<p>This section covers version of the stubs, which you can handle in a number of different ways:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#how-to-api-versioning">API Versioning</a></p>
+</li>
+<li>
+<p><a href="#how-to-jar-versioning">JAR versioning</a></p>
+</li>
+<li>
+<p><a href="#how-to-dev-or-prod-stubs">Development or Production Stubs</a></p>
+</li>
+</ul>
+</div>
+<div class="sect3">
+<h4 id="how-to-api-versioning"><a class="anchor" href="#how-to-api-versioning"></a><a class="link" href="#how-to-api-versioning">5.4.1. API Versioning</a></h4>
+<div class="paragraph">
+<p>What does versioning really mean? If you refer to the API version, there are
+different approaches:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Use hypermedia links and do not version your API by any means</p>
+</li>
+<li>
+<p>Pass the version through headers and URLs</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>We do not try to answer the question of which approach is better. You should pick whatever
+suits your needs and lets you generate business value.</p>
+</div>
+<div class="paragraph">
+<p>Assume that you do version your API. In that case, you should provide as many contracts with as many versions as you support.
+You can create a subfolder for every version or append it to the contract name&#8201;&#8212;&#8201;whatever suits you best.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="how-to-jar-versioning"><a class="anchor" href="#how-to-jar-versioning"></a><a class="link" href="#how-to-jar-versioning">5.4.2. JAR versioning</a></h4>
+<div class="paragraph">
+<p>If, by versioning, you mean the version of the JAR that contains the stubs, then there are essentially two main approaches.</p>
+</div>
+<div class="paragraph">
+<p>Assume that you do continuous delivery and deployment, which means that you generate a new version of
+the jar each time you go through the pipeline and that the jar can go to production at any time. For example, your jar version
+looks like the following (because it got built on the 20.10.2016 at 20:15:21) :</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">1.0.0.20161020-201521-RELEASE</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In that case your, generated stub jar should look like the following:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">1.0.0.20161020-201521-RELEASE-stubs.jar</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>In this case, you should, inside your <code>application.yml</code> or <code>@AutoConfigureStubRunner</code> when
+referencing stubs, provide the latest version of the stubs. You can do that by passing the
+<code>+</code> sign. the following example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:stubs:8080"})</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>If the versioning, however, is fixed (for example, <code>1.0.4.RELEASE</code> or <code>2.1.1</code>), you have to set the concrete value of the jar
+version. The following example shows how to do so for version 2.1.1:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:2.1.1:stubs:8080"})</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="how-to-dev-or-prod-stubs"><a class="anchor" href="#how-to-dev-or-prod-stubs"></a><a class="link" href="#how-to-dev-or-prod-stubs">5.4.3. Development or Production Stubs</a></h4>
+<div class="paragraph">
+<p>You can manipulate the classifier to run the tests against current the development version
+of the stubs of other services or the ones that were deployed to production. If you alter
+your build to deploy the stubs with the <code>prod-stubs</code> classifier once you reach production
+deployment, you can run tests in one case with development stubs and one with production stubs.</p>
+</div>
+<div class="paragraph">
+<p>The following example works for tests that use the development version of the stubs:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:stubs:8080"})</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>The following example works for tests that use the production version of stubs:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(ids = {"com.example:http-server-dsl:+:prod-stubs:8080"})</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can also pass those values also in properties from your deployment pipeline.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-common-repo-with-contracts"><a class="anchor" href="#how-to-common-repo-with-contracts"></a><a class="link" href="#how-to-common-repo-with-contracts">5.5. How Can I use a Common Repository with Contracts Instead of Storing Them with the Producer?</a></h3>
+<div class="paragraph">
+<p>Another way of storing contracts, rather than having them with the producer, is to keep
+them in a common place. This situation can be related to security issues (where the
+consumers cannot clone the producer&#8217;s code). Also if you keep contracts in a single place,
+then you, as a producer, know how many consumers you have and which consumer you may break
+with your local changes.</p>
+</div>
+<div class="sect3">
+<h4 id="how-to-repo-structure"><a class="anchor" href="#how-to-repo-structure"></a><a class="link" href="#how-to-repo-structure">5.5.1. Repo Structure</a></h4>
+<div class="paragraph">
+<p>Assume that we have a producer with coordinates of <code>com.example:server</code> and three
+consumers: <code>client1</code>, <code>client2</code>, and <code>client3</code>. Then, in the repository with common
+contracts, you could have the following setup (which you can check out
+<a href="https://github.com/spring-cloud/spring-cloud-contract/tree/{branch}/samples/standalone/contracts">here</a>).
+The following listing shows such a structure:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">├── com
+│   └── example
+│       └── server
+│           ├── client1
+│           │   └── expectation.groovy
+│           ├── client2
+│           │   └── expectation.groovy
+│           ├── client3
+│           │   └── expectation.groovy
+│           └── pom.xml
+├── mvnw
+├── mvnw.cmd
+├── pom.xml
+└── src
+    └── assembly
+        └── contracts.xml</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>As you can see under the slash-delimited <code>groupid/artifact id</code> folder (<code>com/example/server</code>) you have
+expectations of the three consumers (<code>client1</code>, <code>client2</code>, and <code>client3</code>). Expectations are the standard Groovy DSL
+contract files, as described throughout this documentation. This repository has to produce a JAR file that maps
+one-to-one to the contents of the repository.</p>
+</div>
+<div class="paragraph">
+<p>The following example shows a <code>pom.xml</code> inside the <code>server</code> folder:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;?xml version="1.0" encoding="UTF-8"?&gt;
+&lt;project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xmlns="http://maven.apache.org/POM/4.0.0"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"&gt;
+    &lt;modelVersion&gt;4.0.0&lt;/modelVersion&gt;
+
+    &lt;groupId&gt;com.example&lt;/groupId&gt;
+    &lt;artifactId&gt;server&lt;/artifactId&gt;
+    &lt;version&gt;0.0.1-SNAPSHOT&lt;/version&gt;
+
+    &lt;name&gt;Server Stubs&lt;/name&gt;
+    &lt;description&gt;POM used to install locally stubs for consumer side&lt;/description&gt;
+
+    &lt;parent&gt;
+        &lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;
+        &lt;artifactId&gt;spring-boot-starter-parent&lt;/artifactId&gt;
+        &lt;version&gt;2.2.0.BUILD-SNAPSHOT&lt;/version&gt;
+        &lt;relativePath/&gt;
+    &lt;/parent&gt;
+
+    &lt;properties&gt;
+        &lt;project.build.sourceEncoding&gt;UTF-8&lt;/project.build.sourceEncoding&gt;
+        &lt;java.version&gt;1.8&lt;/java.version&gt;
+        &lt;spring-cloud-contract.version&gt;2.2.0.BUILD-SNAPSHOT&lt;/spring-cloud-contract.version&gt;
+        &lt;spring-cloud-release.version&gt;Hoxton.BUILD-SNAPSHOT&lt;/spring-cloud-release.version&gt;
+        &lt;excludeBuildFolders&gt;true&lt;/excludeBuildFolders&gt;
+    &lt;/properties&gt;
+
+    &lt;dependencyManagement&gt;
+        &lt;dependencies&gt;
+            &lt;dependency&gt;
+                &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+                &lt;artifactId&gt;spring-cloud-dependencies&lt;/artifactId&gt;
+                &lt;version&gt;${spring-cloud-release.version}&lt;/version&gt;
+                &lt;type&gt;pom&lt;/type&gt;
+                &lt;scope&gt;import&lt;/scope&gt;
+            &lt;/dependency&gt;
+        &lt;/dependencies&gt;
+    &lt;/dependencyManagement&gt;
+
+    &lt;build&gt;
+        &lt;plugins&gt;
+            &lt;plugin&gt;
+                &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+                &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+                &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+                &lt;extensions&gt;true&lt;/extensions&gt;
+                &lt;configuration&gt;
+                    &lt;!-- By default it would search under src/test/resources/ --&gt;
+                    &lt;contractsDirectory&gt;${project.basedir}&lt;/contractsDirectory&gt;
+                &lt;/configuration&gt;
+            &lt;/plugin&gt;
+        &lt;/plugins&gt;
+    &lt;/build&gt;
+
+    &lt;repositories&gt;
+        &lt;repository&gt;
+            &lt;id&gt;spring-snapshots&lt;/id&gt;
+            &lt;name&gt;Spring Snapshots&lt;/name&gt;
+            &lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
+            &lt;snapshots&gt;
+                &lt;enabled&gt;true&lt;/enabled&gt;
+            &lt;/snapshots&gt;
+        &lt;/repository&gt;
+        &lt;repository&gt;
+            &lt;id&gt;spring-milestones&lt;/id&gt;
+            &lt;name&gt;Spring Milestones&lt;/name&gt;
+            &lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
+            &lt;snapshots&gt;
+                &lt;enabled&gt;false&lt;/enabled&gt;
+            &lt;/snapshots&gt;
+        &lt;/repository&gt;
+        &lt;repository&gt;
+            &lt;id&gt;spring-releases&lt;/id&gt;
+            &lt;name&gt;Spring Releases&lt;/name&gt;
+            &lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
+            &lt;snapshots&gt;
+                &lt;enabled&gt;false&lt;/enabled&gt;
+            &lt;/snapshots&gt;
+        &lt;/repository&gt;
+    &lt;/repositories&gt;
+    &lt;pluginRepositories&gt;
+        &lt;pluginRepository&gt;
+            &lt;id&gt;spring-snapshots&lt;/id&gt;
+            &lt;name&gt;Spring Snapshots&lt;/name&gt;
+            &lt;url&gt;https://repo.spring.io/snapshot&lt;/url&gt;
+            &lt;snapshots&gt;
+                &lt;enabled&gt;true&lt;/enabled&gt;
+            &lt;/snapshots&gt;
+        &lt;/pluginRepository&gt;
+        &lt;pluginRepository&gt;
+            &lt;id&gt;spring-milestones&lt;/id&gt;
+            &lt;name&gt;Spring Milestones&lt;/name&gt;
+            &lt;url&gt;https://repo.spring.io/milestone&lt;/url&gt;
+            &lt;snapshots&gt;
+                &lt;enabled&gt;false&lt;/enabled&gt;
+            &lt;/snapshots&gt;
+        &lt;/pluginRepository&gt;
+        &lt;pluginRepository&gt;
+            &lt;id&gt;spring-releases&lt;/id&gt;
+            &lt;name&gt;Spring Releases&lt;/name&gt;
+            &lt;url&gt;https://repo.spring.io/release&lt;/url&gt;
+            &lt;snapshots&gt;
+                &lt;enabled&gt;false&lt;/enabled&gt;
+            &lt;/snapshots&gt;
+        &lt;/pluginRepository&gt;
+    &lt;/pluginRepositories&gt;
+
+&lt;/project&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>There are no dependencies other than the Spring Cloud Contract Maven Plugin.
+Those pom files are necessary for the consumer side to run <code>mvn clean install -DskipTests</code> to locally install
+the stubs of the producer project.</p>
+</div>
+<div class="paragraph">
+<p>The <code>pom.xml</code> in the root folder can look like the following:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;?xml version="1.0" encoding="UTF-8"?&gt;
+&lt;project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xmlns="http://maven.apache.org/POM/4.0.0"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"&gt;
+    &lt;modelVersion&gt;4.0.0&lt;/modelVersion&gt;
+
+    &lt;groupId&gt;com.example.standalone&lt;/groupId&gt;
+    &lt;artifactId&gt;contracts&lt;/artifactId&gt;
+    &lt;version&gt;0.0.1-SNAPSHOT&lt;/version&gt;
+
+    &lt;name&gt;Contracts&lt;/name&gt;
+    &lt;description&gt;Contains all the Spring Cloud Contracts, well, contracts. JAR used by the
+        producers to generate tests and stubs
+    &lt;/description&gt;
+
+    &lt;properties&gt;
+        &lt;project.build.sourceEncoding&gt;UTF-8&lt;/project.build.sourceEncoding&gt;
+    &lt;/properties&gt;
+
+    &lt;build&gt;
+        &lt;plugins&gt;
+            &lt;plugin&gt;
+                &lt;groupId&gt;org.apache.maven.plugins&lt;/groupId&gt;
+                &lt;artifactId&gt;maven-assembly-plugin&lt;/artifactId&gt;
+                &lt;executions&gt;
+                    &lt;execution&gt;
+                        &lt;id&gt;contracts&lt;/id&gt;
+                        &lt;phase&gt;prepare-package&lt;/phase&gt;
+                        &lt;goals&gt;
+                            &lt;goal&gt;single&lt;/goal&gt;
+                        &lt;/goals&gt;
+                        &lt;configuration&gt;
+                            &lt;attach&gt;true&lt;/attach&gt;
+                            &lt;descriptor&gt;${basedir}/src/assembly/contracts.xml&lt;/descriptor&gt;
+                            &lt;!-- If you want an explicit classifier remove the following line --&gt;
+                            &lt;appendAssemblyId&gt;false&lt;/appendAssemblyId&gt;
+                        &lt;/configuration&gt;
+                    &lt;/execution&gt;
+                &lt;/executions&gt;
+            &lt;/plugin&gt;
+        &lt;/plugins&gt;
+    &lt;/build&gt;
+
+&lt;/project&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>It uses the assembly plugin to build the JAR with all the contracts. The following example
+shows such a setup:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;assembly xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+          xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3"
+          xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 https://maven.apache.org/xsd/assembly-1.1.3.xsd"&gt;
+    &lt;id&gt;project&lt;/id&gt;
+    &lt;formats&gt;
+        &lt;format&gt;jar&lt;/format&gt;
+    &lt;/formats&gt;
+    &lt;includeBaseDirectory&gt;false&lt;/includeBaseDirectory&gt;
+    &lt;fileSets&gt;
+        &lt;fileSet&gt;
+            &lt;directory&gt;${project.basedir}&lt;/directory&gt;
+            &lt;outputDirectory&gt;/&lt;/outputDirectory&gt;
+            &lt;useDefaultExcludes&gt;true&lt;/useDefaultExcludes&gt;
+            &lt;excludes&gt;
+                &lt;exclude&gt;**/${project.build.directory}/**&lt;/exclude&gt;
+                &lt;exclude&gt;mvnw&lt;/exclude&gt;
+                &lt;exclude&gt;mvnw.cmd&lt;/exclude&gt;
+                &lt;exclude&gt;.mvn/**&lt;/exclude&gt;
+                &lt;exclude&gt;src/**&lt;/exclude&gt;
+            &lt;/excludes&gt;
+        &lt;/fileSet&gt;
+    &lt;/fileSets&gt;
+&lt;/assembly&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="how-to-workflow"><a class="anchor" href="#how-to-workflow"></a><a class="link" href="#how-to-workflow">5.5.2. Workflow</a></h4>
+<div class="paragraph">
+<p>The workflow assumes that Spring Cloud Contract is set up both on the consumer and on the
+producer side. There is also the proper plugin setup in the common repository with
+contracts. The CI jobs are set for a common repository to build an artifact of all
+contracts and upload it to Nexus/Artifactory. The following image shows the UML for this
+workflow:</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="./images/how-to-common-repo.png" alt="how to common repo" width="1588" height="1421">
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="how-to-workflow-consumer"><a class="anchor" href="#how-to-workflow-consumer"></a><a class="link" href="#how-to-workflow-consumer">5.5.3. Consumer</a></h4>
+<div class="paragraph">
+<p>When the consumer wants to work on the contracts offline, instead of cloning the producer
+code, the consumer team clones the common repository, goes to the required producer&#8217;s
+folder (for example, <code>com/example/server</code>) and runs <code>mvn clean install -DskipTests</code> to
+locally install the stubs converted from the contracts.</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+You need to have <a href="https://maven.apache.org/download.cgi">Maven installed locally</a>
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect3">
+<h4 id="how-to-workflow-producer"><a class="anchor" href="#how-to-workflow-producer"></a><a class="link" href="#how-to-workflow-producer">5.5.4. Producer</a></h4>
+<div class="paragraph">
+<p>As a producer, you can to alter the Spring Cloud Contract Verifier to provide the URL and
+the dependency of the JAR that contains the contracts, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;configuration&gt;
+        &lt;contractsMode&gt;REMOTE&lt;/contractsMode&gt;
+        &lt;contractsRepositoryUrl&gt;
+            https://link/to/your/nexus/or/artifactory/or/sth
+        &lt;/contractsRepositoryUrl&gt;
+        &lt;contractDependency&gt;
+            &lt;groupId&gt;com.example.standalone&lt;/groupId&gt;
+            &lt;artifactId&gt;contracts&lt;/artifactId&gt;
+        &lt;/contractDependency&gt;
+    &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>With this setup, the JAR with a groupid of <code>com.example.standalone</code> and artifactid
+<code>contracts</code> is downloaded from <code><a href="https://link/to/your/nexus/or/artifactory/or/sth" class="bare">link/to/your/nexus/or/artifactory/or/sth</a></code>. It is
+then unpacked in a local temporary folder, and the contracts present in
+<code>com/example/server</code> are picked as the ones used to generate the tests and the stubs. Due
+to this convention, the producer team can know which consumer teams will be broken when
+some incompatible changes are made.</p>
+</div>
+<div class="paragraph">
+<p>The rest of the flow looks the same.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="how-to-define-messaging-contracts-per-topic"><a class="anchor" href="#how-to-define-messaging-contracts-per-topic"></a><a class="link" href="#how-to-define-messaging-contracts-per-topic">5.5.5. How Can I Define Messaging Contracts per Topic Rather than per Producer?</a></h4>
+<div class="paragraph">
+<p>To avoid messaging contracts duplication in the common repository, when a few producers write messages to one topic,
+we could create a structure in which the REST contracts are placed in a folder per producer and messaging
+contracts are placed in the folder per topic.</p>
+</div>
+<div class="sect4">
+<h5 id="how-to-define-messaging-contracts-per-topic-maven"><a class="anchor" href="#how-to-define-messaging-contracts-per-topic-maven"></a><a class="link" href="#how-to-define-messaging-contracts-per-topic-maven">For Maven Projects</a></h5>
+<div class="paragraph">
+<p>To make it possible to work on the producer side, we should specify an inclusion pattern for
+filtering common repository jar files by messaging topics we are interested in. The
+<code>includedFiles</code> property of the Maven Spring Cloud Contract plugin
+lets us do so. Also, <code>contractsPath</code> need to be specified, since the default path would be
+the common repository <code>groupid/artifactid</code>. The following example shows a Maven
+plugin for Spring Cloud Contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+   &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+   &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+   &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+   &lt;configuration&gt;
+      &lt;contractsMode&gt;REMOTE&lt;/contractsMode&gt;
+      &lt;contractsRepositoryUrl&gt;https://link/to/your/nexus/or/artifactory/or/sth&lt;/contractsRepositoryUrl&gt;
+      &lt;contractDependency&gt;
+         &lt;groupId&gt;com.example&lt;/groupId&gt;
+         &lt;artifactId&gt;common-repo-with-contracts&lt;/artifactId&gt;
+         &lt;version&gt;+&lt;/version&gt;
+      &lt;/contractDependency&gt;
+      &lt;contractsPath&gt;/&lt;/contractsPath&gt;
+      &lt;baseClassMappings&gt;
+         &lt;baseClassMapping&gt;
+            &lt;contractPackageRegex&gt;.*messaging.*&lt;/contractPackageRegex&gt;
+            &lt;baseClassFQN&gt;com.example.services.MessagingBase&lt;/baseClassFQN&gt;
+         &lt;/baseClassMapping&gt;
+         &lt;baseClassMapping&gt;
+            &lt;contractPackageRegex&gt;.*rest.*&lt;/contractPackageRegex&gt;
+            &lt;baseClassFQN&gt;com.example.services.TestBase&lt;/baseClassFQN&gt;
+         &lt;/baseClassMapping&gt;
+      &lt;/baseClassMappings&gt;
+      &lt;includedFiles&gt;
+         &lt;includedFile&gt;**/${project.artifactId}/**&lt;/includedFile&gt;
+         &lt;includedFile&gt;**/${first-topic}/**&lt;/includedFile&gt;
+         &lt;includedFile&gt;**/${second-topic}/**&lt;/includedFile&gt;
+      &lt;/includedFiles&gt;
+   &lt;/configuration&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+Many of the values in the preceding Maven plugin can be changed. We included it for
+illustration purposes rather than trying to provide a &#8220;typical&#8221; example.
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect4">
+<h5 id="how-to-define-messaging-contracts-per-topic-gradle"><a class="anchor" href="#how-to-define-messaging-contracts-per-topic-gradle"></a><a class="link" href="#how-to-define-messaging-contracts-per-topic-gradle">For Gradle Projects</a></h5>
+<div class="paragraph">
+<p>To work with a Gradle project:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Add a custom configuration for the common repository dependency, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">ext {
+    conractsGroupId = "com.example"
+    contractsArtifactId = "common-repo"
+    contractsVersion = "1.2.3"
+}
+
+configurations {
+    contracts {
+        transitive = false
+    }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Add the common repository dependency to your classpath, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">dependencies {
+    contracts "${conractsGroupId}:${contractsArtifactId}:${contractsVersion}"
+    testCompile "${conractsGroupId}:${contractsArtifactId}:${contractsVersion}"
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Download the dependency to an appropriate folder, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">task getContracts(type: Copy) {
+    from configurations.contracts
+    into new File(project.buildDir, "downloadedContracts")
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Unzip the JAR, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">task unzipContracts(type: Copy) {
+    def zipFile = new File(project.buildDir, "downloadedContracts/${contractsArtifactId}-${contractsVersion}.jar")
+    def outputDir = file("${buildDir}/unpackedContracts")
+
+    from zipTree(zipFile)
+    into outputDir
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Cleanup unused contracts, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">task deleteUnwantedContracts(type: Delete) {
+    delete fileTree(dir: "${buildDir}/unpackedContracts",
+        include: "**/*",
+        excludes: [
+            "**/${project.name}/**"",
+            "**/${first-topic}/**",
+            "**/${second-topic}/**"])
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Create task dependencies, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">unzipContracts.dependsOn("getContracts")
+deleteUnwantedContracts.dependsOn("unzipContracts")
+build.dependsOn("deleteUnwantedContracts")</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+<li>
+<p>Configure the plugin by specifying the directory that contains the contracts, by setting
+the <code>contractsDslDir</code> property, as follows:</p>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+    contractsDslDir = new File("${buildDir}/unpackedContracts")
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-use-git-as-storage"><a class="anchor" href="#how-to-use-git-as-storage"></a><a class="link" href="#how-to-use-git-as-storage">5.6. How Can I Use Git as the Storage for Contracts and Stubs?</a></h3>
+<div class="paragraph">
+<p>In the polyglot world, there are languages that do not use binary storages, as
+Artifactory or Nexus do. Starting from Spring Cloud Contract version 2.0.0, we provide
+mechanisms to store contracts and stubs in a SCM (Source Control Management) repository. Currently, the
+only supported SCM is Git.</p>
+</div>
+<div class="paragraph">
+<p>The repository would have to have the following setup
+(which you can checkout from <a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x/contracts_git/">here</a>):</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code>.
+└── META-INF
+    └── com.example
+        └── beer-api-producer-git
+            └── 0.0.1-SNAPSHOT
+                ├── contracts
+                │   └── beer-api-consumer
+                │       ├── messaging
+                │       │   ├── shouldSendAcceptedVerification.groovy
+                │       │   └── shouldSendRejectedVerification.groovy
+                │       └── rest
+                │           ├── shouldGrantABeerIfOldEnough.groovy
+                │           └── shouldRejectABeerIfTooYoung.groovy
+                └── mappings
+                    └── beer-api-consumer
+                        └── rest
+                            ├── shouldGrantABeerIfOldEnough.json
+                            └── shouldRejectABeerIfTooYoung.json</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Under the <code>META-INF</code> folder:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>We group applications by <code>groupId</code> (such as <code>com.example</code>).</p>
+</li>
+<li>
+<p>Each application is represented by its <code>artifactId</code> (for example, <code>beer-api-producer-git</code>).</p>
+</li>
+<li>
+<p>Next, each application is organized by its version (such as <code>0.0.1-SNAPSHOT</code>). Starting
+from Spring Cloud Contract version <code>2.1.0</code>, you can specify the versions as follows
+(assuming that your versions follow semantic versioning):</p>
+<div class="ulist">
+<ul>
+<li>
+<p><code>+</code> or <code>latest</code>: To find the latest version of your stubs (assuming that the snapshots
+are always the latest artifact for a given revision number). That means:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>If you have <code>1.0.0.RELEASE</code>, <code>2.0.0.BUILD-SNAPSHOT</code>, and <code>2.0.0.RELEASE</code>, we assume
+that the latest is <code>2.0.0.BUILD-SNAPSHOT</code>.</p>
+</li>
+<li>
+<p>If you have <code>1.0.0.RELEASE</code> and <code>2.0.0.RELEASE</code>, we assume that the latest is <code>2.0.0.RELEASE</code>.</p>
+</li>
+<li>
+<p>If you have a version called <code>latest</code> or <code>+</code>, we will pick that folder.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><code>release</code>: To find the latest release version of your stubs. That means:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>If you have <code>1.0.0.RELEASE</code>, <code>2.0.0.BUILD-SNAPSHOT</code>, and <code>2.0.0.RELEASE</code> we assume
+that the latest is <code>2.0.0.RELEASE</code>.</p>
+</li>
+<li>
+<p>If you have a version called <code>release</code>, we pick that folder.</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Finally, there are two folders:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>contracts</code>: The good practice is to store the contracts required by each
+consumer in the folder with the consumer name (such as <code>beer-api-consumer</code>). That way, you
+can use the <code>stubs-per-consumer</code> feature. Further directory structure is arbitrary.</p>
+</li>
+<li>
+<p><code>mappings</code>: The Maven or Gradle Spring Cloud Contract plugins push
+the stub server mappings in this folder. On the consumer side, Stub Runner scans this folder
+to start stub servers with stub definitions. The folder structure is a copy
+of the one created in the <code>contracts</code> subfolder.</p>
+</li>
+</ul>
+</div>
+<div class="sect3">
+<h4 id="how-to-protocol-convention"><a class="anchor" href="#how-to-protocol-convention"></a><a class="link" href="#how-to-protocol-convention">5.6.1. Protocol Convention</a></h4>
+<div class="paragraph">
+<p>To control the type and location of the source of contracts (whether
+binary storage or an SCM repository), you can use the protocol in the URL of
+the repository. Spring Cloud Contract iterates over registered protocol resolvers
+and tries to fetch the contracts (by using a plugin) or stubs (from Stub Runner).</p>
+</div>
+<div class="paragraph">
+<p>For the SCM functionality, currently, we support the Git repository. To use it,
+in the property where the repository URL needs to be placed, you have to prefix
+the connection URL with <code>git://</code>. The following listing shows some examples:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code>git://file:///foo/bar
+git://https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git
+git://git@github.com:spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="how-to-protocol-convention-producer"><a class="anchor" href="#how-to-protocol-convention-producer"></a><a class="link" href="#how-to-protocol-convention-producer">5.6.2. Producer</a></h4>
+<div class="paragraph">
+<p>For the producer, to use the SCM (Source Control Management) approach, we can reuse the
+same mechanism we use for external contracts. We route Spring Cloud Contract
+to use the SCM implementation from the URL that starts with
+the <code>git://</code> protocol.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+You have to manually add the <code>pushStubsToScm</code>
+goal in Maven or execute (bind) the <code>pushStubsToScm</code> task in
+Gradle. We do not push stubs to the <code>origin</code> of your git
+repository.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>The following listing includes the relevant parts both Maven and Gradle build files:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;!-- Base class mappings etc. --&gt;
+
+        &lt;!-- We want to pick contracts from a Git repository --&gt;
+        &lt;contractsRepositoryUrl&gt;git://https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git&lt;/contractsRepositoryUrl&gt;
+
+        &lt;!-- We reuse the contract dependency section to set up the path
+        to the folder that contains the contract definitions. In our case the
+        path will be /groupId/artifactId/version/contracts --&gt;
+        &lt;contractDependency&gt;
+            &lt;groupId&gt;${project.groupId}&lt;/groupId&gt;
+            &lt;artifactId&gt;${project.artifactId}&lt;/artifactId&gt;
+            &lt;version&gt;${project.version}&lt;/version&gt;
+        &lt;/contractDependency&gt;
+
+        &lt;!-- The contracts mode can't be classpath --&gt;
+        &lt;contractsMode&gt;REMOTE&lt;/contractsMode&gt;
+    &lt;/configuration&gt;
+    &lt;executions&gt;
+        &lt;execution&gt;
+            &lt;phase&gt;package&lt;/phase&gt;
+            &lt;goals&gt;
+                &lt;!-- By default we will not push the stubs back to SCM,
+                you have to explicitly add it as a goal --&gt;
+                &lt;goal&gt;pushStubsToScm&lt;/goal&gt;
+            &lt;/goals&gt;
+        &lt;/execution&gt;
+    &lt;/executions&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+    // We want to pick contracts from a Git repository
+    contractDependency {
+        stringNotation = "${project.group}:${project.name}:${project.version}"
+    }
+    /*
+    We reuse the contract dependency section to set up the path
+    to the folder that contains the contract definitions. In our case the
+    path will be /groupId/artifactId/version/contracts
+     */
+    contractRepository {
+        repositoryUrl = "git://https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git"
+    }
+    // The mode can't be classpath
+    contractsMode = "REMOTE"
+    // Base class mappings etc.
+}
+
+/*
+In this scenario we want to publish stubs to SCM whenever
+the `publish` task is executed
+*/
+publish.dependsOn("publishStubsToScm")</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>With such a setup:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>A git project is cloned to a temporary directory</p>
+</li>
+<li>
+<p>The SCM stub downloader goes to <code>META-INF/groupId/artifactId/version/contracts</code> folder
+to find contracts. For example, for <code>com.example:foo:1.0.0</code>, the path would be
+<code>META-INF/com.example/foo/1.0.0/contracts</code>.</p>
+</li>
+<li>
+<p>Tests are generated from the contracts.</p>
+</li>
+<li>
+<p>Stubs are created from the contracts.</p>
+</li>
+<li>
+<p>Once the tests pass, the stubs are committed in the cloned repository.</p>
+</li>
+<li>
+<p>Finally, a push is sent to that repo&#8217;s <code>origin</code>.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="how-to-protocol-convention-producer-with-contracts-stored-locally"><a class="anchor" href="#how-to-protocol-convention-producer-with-contracts-stored-locally"></a><a class="link" href="#how-to-protocol-convention-producer-with-contracts-stored-locally">5.6.3. Producer with Contracts Stored Locally</a></h4>
+<div class="paragraph">
+<p>Another option to use the SCM as the destination for stubs and contracts is to store the
+contracts locally, with the producer, and only push the contracts and the stubs to SCM.
+The following listing shows the setup required to achieve this with Maven and Gradle:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;!-- In the default configuration, we want to use the contracts stored locally --&gt;
+    &lt;configuration&gt;
+        &lt;baseClassMappings&gt;
+            &lt;baseClassMapping&gt;
+                &lt;contractPackageRegex&gt;.*messaging.*&lt;/contractPackageRegex&gt;
+                &lt;baseClassFQN&gt;com.example.BeerMessagingBase&lt;/baseClassFQN&gt;
+            &lt;/baseClassMapping&gt;
+            &lt;baseClassMapping&gt;
+                &lt;contractPackageRegex&gt;.*rest.*&lt;/contractPackageRegex&gt;
+                &lt;baseClassFQN&gt;com.example.BeerRestBase&lt;/baseClassFQN&gt;
+            &lt;/baseClassMapping&gt;
+        &lt;/baseClassMappings&gt;
+        &lt;basePackageForTests&gt;com.example&lt;/basePackageForTests&gt;
+    &lt;/configuration&gt;
+    &lt;executions&gt;
+        &lt;execution&gt;
+            &lt;phase&gt;package&lt;/phase&gt;
+            &lt;goals&gt;
+                &lt;!-- By default we will not push the stubs back to SCM,
+                you have to explicitly add it as a goal --&gt;
+                &lt;goal&gt;pushStubsToScm&lt;/goal&gt;
+            &lt;/goals&gt;
+            &lt;configuration&gt;
+                &lt;!-- We want to pick contracts from a Git repository --&gt;
+                &lt;contractsRepositoryUrl&gt;git://file://${env.ROOT}/target/contract_empty_git/
+                &lt;/contractsRepositoryUrl&gt;
+                &lt;!-- Example of URL via git protocol --&gt;
+                &lt;!--&lt;contractsRepositoryUrl&gt;git://git@github.com:spring-cloud-samples/spring-cloud-contract-samples.git&lt;/contractsRepositoryUrl&gt;--&gt;
+                &lt;!-- Example of URL via http protocol --&gt;
+                &lt;!--&lt;contractsRepositoryUrl&gt;git://https://github.com/spring-cloud-samples/spring-cloud-contract-samples.git&lt;/contractsRepositoryUrl&gt;--&gt;
+                &lt;!-- We reuse the contract dependency section to set up the path
+                to the folder that contains the contract definitions. In our case the
+                path will be /groupId/artifactId/version/contracts --&gt;
+                &lt;contractDependency&gt;
+                    &lt;groupId&gt;${project.groupId}&lt;/groupId&gt;
+                    &lt;artifactId&gt;${project.artifactId}&lt;/artifactId&gt;
+                    &lt;version&gt;${project.version}&lt;/version&gt;
+                &lt;/contractDependency&gt;
+                &lt;!-- The mode can't be classpath --&gt;
+                &lt;contractsMode&gt;LOCAL&lt;/contractsMode&gt;
+            &lt;/configuration&gt;
+        &lt;/execution&gt;
+    &lt;/executions&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">contracts {
+        // Base package for generated tests
+    basePackageForTests = "com.example"
+    baseClassMappings {
+        baseClassMapping(".*messaging.*", "com.example.BeerMessagingBase")
+        baseClassMapping(".*rest.*", "com.example.BeerRestBase")
+    }
+}
+
+/*
+In this scenario we want to publish stubs to SCM whenever
+the `publish` task is executed
+*/
+publishStubsToScm {
+    // We want to modify the default set up of the plugin when publish stubs to scm is called
+    customize {
+        // We want to pick contracts from a Git repository
+        contractDependency {
+            stringNotation = "${project.group}:${project.name}:${project.version}"
+        }
+        /*
+        We reuse the contract dependency section to set up the path
+        to the folder that contains the contract definitions. In our case the
+        path will be /groupId/artifactId/version/contracts
+         */
+        contractRepository {
+            repositoryUrl = "git://file://${System.getenv("ROOT")}/target/contract_empty_git/"
+        }
+        // The mode can't be classpath
+        contractsMode = "LOCAL"
+    }
+}
+
+publish.dependsOn("publishStubsToScm")
+publishToMavenLocal.dependsOn("publishStubsToScm")</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>With such a setup:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Contracts from the default <code>src/test/resources/contracts</code> directory are picked.</p>
+</li>
+<li>
+<p>Tests are generated from the contracts.</p>
+</li>
+<li>
+<p>Stubs are created from the contracts.</p>
+</li>
+<li>
+<p>Once the tests pass:</p>
+<div class="ulist">
+<ul>
+<li>
+<p>The git project is cloned to a temporary directory.</p>
+</li>
+<li>
+<p>The stubs and contracts are committed in the cloned repository.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p>Finally, a push is done to that repository&#8217;s <code>origin</code>.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="how-to-protocol-convention-contracts-producer-stubs-external"><a class="anchor" href="#how-to-protocol-convention-contracts-producer-stubs-external"></a><a class="link" href="#how-to-protocol-convention-contracts-producer-stubs-external">5.6.4. Keeping Contracts with the Producer and Stubs in an External Repository</a></h4>
+<div class="paragraph">
+<p>You can also keep the contracts in the producer repository but keep the stubs in an external git repository.
+This is most useful when you want to use the base consumer-producer collaboration flow but cannot
+use an artifact repository to store the stubs.</p>
+</div>
+<div class="paragraph">
+<p>To do so, use the usual producer setup and then add the <code>pushStubsToScm</code> goal and set
+<code>contractsRepositoryUrl</code> to the repository where you want to keep the stubs.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="how-to-protocol-convention-contracts-producer-stubs-external-consumer"><a class="anchor" href="#how-to-protocol-convention-contracts-producer-stubs-external-consumer"></a><a class="link" href="#how-to-protocol-convention-contracts-producer-stubs-external-consumer">5.6.5. Consumer</a></h4>
+<div class="paragraph">
+<p>On the consumer side, when passing the <code>repositoryRoot</code> parameter,
+either from the <code>@AutoConfigureStubRunner</code> annotation, the
+JUnit rule, JUnit 5 extension, or properties, you can pass the URL of the
+SCM repository, prefixed with the <code>git://</code> protocol. The following example shows how to do so:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@AutoConfigureStubRunner(
+    stubsMode="REMOTE",
+    repositoryRoot="git://https://github.com/spring-cloud-samples/spring-cloud-contract-nodejs-contracts-git.git",
+    ids="com.example:bookstore:0.0.1.RELEASE"
+)</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>With such a setup:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The git project is cloned to a temporary directory.</p>
+</li>
+<li>
+<p>The SCM stub downloader goes to thje <code>META-INF/groupId/artifactId/version/</code> folder
+to find stub definitions and contracts. For example, for <code>com.example:foo:1.0.0</code>, the path would be
+<code>META-INF/com.example/foo/1.0.0/</code>.</p>
+</li>
+<li>
+<p>Stub servers are started and fed with mappings.</p>
+</li>
+<li>
+<p>Messaging definitions are read and used in the messaging tests.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-use-pact-broker"><a class="anchor" href="#how-to-use-pact-broker"></a><a class="link" href="#how-to-use-pact-broker">5.7. How Can I Use the Pact Broker?</a></h3>
+<div class="paragraph">
+<p>When using <a href="https://pact.io/">Pact</a>, you can use the <a href="https://github.com/pact-foundation/pact_broker">Pact Broker</a>
+to store and share Pact definitions. Starting from Spring Cloud Contract
+2.0.0, you can fetch Pact files from the Pact Broker to generate
+tests and stubs.</p>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+Pact follows the consumer contract convention. That means
+that the consumer creates the Pact definitions first and then
+shares the files with the Producer. Those expectations are generated
+from the Consumer&#8217;s code and can break the Producer if the expectations
+are not met.
+</td>
+</tr>
+</table>
+</div>
+<div class="sect3">
+<h4 id="how-to-use-pact-broker-pact"><a class="anchor" href="#how-to-use-pact-broker-pact"></a><a class="link" href="#how-to-use-pact-broker-pact">5.7.1. How to Work with Pact</a></h4>
+<div class="paragraph">
+<p>Spring Cloud Contract includes support for the <a href="https://docs.pact.io/">Pact</a> representation of
+contracts up until version 4. Instead of using the DSL, you can use Pact files. In this section, we
+show how to add Pact support for your project. Note, however, that not all functionality is supported.
+Starting with version 3, you can combine multiple matchers for the same element;
+you can use matchers for the body, headers, request and path; and you can use value generators.
+Spring Cloud Contract currently only supports multiple matchers that are combined by using the <code>AND</code> rule logic.
+Next to that, the request and path matchers are skipped during the conversion.
+When using a date, time, or datetime value generator with a given format,
+the given format is skipped and the ISO format is used.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="how-to-use-pact-broker-pact-converter"><a class="anchor" href="#how-to-use-pact-broker-pact-converter"></a><a class="link" href="#how-to-use-pact-broker-pact-converter">5.7.2. Pact Converter</a></h4>
+<div class="paragraph">
+<p>In order to properly support the Spring Cloud Contract way of doing messaging
+with Pact, you have to provide some additional meta data entries.</p>
+</div>
+<div class="paragraph">
+<p>To define the destination to which a message gets sent, you have to
+set a <code>metaData</code> entry in the Pact file with the <code>sentTo</code> key equal to the destination to
+ which a message is to be sent (for example, <code>"metaData": { "sentTo": "activemq:output" }</code>).</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="how-to-use-pact-broker-pact-contract"><a class="anchor" href="#how-to-use-pact-broker-pact-contract"></a><a class="link" href="#how-to-use-pact-broker-pact-contract">5.7.3. Pact Contract</a></h4>
+<div class="paragraph">
+<p>Spring Cloud Contract can read the Pact JSON definition. You can place the file in the
+<code>src/test/resources/contracts</code> folder. The following example shows such a Pact contract:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">{
+  "provider": {
+    "name": "Provider"
+  },
+  "consumer": {
+    "name": "Consumer"
+  },
+  "interactions": [
+    {
+      "description": "",
+      "request": {
+        "method": "PUT",
+        "path": "/fraudcheck",
+        "headers": {
+          "Content-Type": "application/vnd.fraud.v1+json"
+        },
+        "body": {
+          "clientId": "1234567890",
+          "loanAmount": 99999
+        },
+        "generators": {
+          "body": {
+            "$.clientId": {
+              "type": "Regex",
+              "regex": "[0-9]{10}"
+            }
+          }
+        },
+        "matchingRules": {
+          "header": {
+            "Content-Type": {
+              "matchers": [
+                {
+                  "match": "regex",
+                  "regex": "application/vnd\\.fraud\\.v1\\+json.*"
+                }
+              ],
+              "combine": "AND"
+            }
+          },
+          "body": {
+            "$.clientId": {
+              "matchers": [
+                {
+                  "match": "regex",
+                  "regex": "[0-9]{10}"
+                }
+              ],
+              "combine": "AND"
+            }
+          }
+        }
+      },
+      "response": {
+        "status": 200,
+        "headers": {
+          "Content-Type": "application/vnd.fraud.v1+json"
+        },
+        "body": {
+          "fraudCheckStatus": "FRAUD",
+          "rejectionReason": "Amount too high"
+        },
+        "matchingRules": {
+          "header": {
+            "Content-Type": {
+              "matchers": [
+                {
+                  "match": "regex",
+                  "regex": "application/vnd\\.fraud\\.v1\\+json.*"
+                }
+              ],
+              "combine": "AND"
+            }
+          },
+          "body": {
+            "$.fraudCheckStatus": {
+              "matchers": [
+                {
+                  "match": "regex",
+                  "regex": "FRAUD"
+                }
+              ],
+              "combine": "AND"
+            }
+          }
+        }
+      }
+    }
+  ],
+  "metadata": {
+    "pact-specification": {
+      "version": "3.0.0"
+    },
+    "pact-jvm": {
+      "version": "3.5.13"
+    }
+  }
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="how-to-use-pact-broker-pact-for-producers"><a class="anchor" href="#how-to-use-pact-broker-pact-for-producers"></a><a class="link" href="#how-to-use-pact-broker-pact-for-producers">5.7.4. Pact for Producers</a></h4>
+<div class="paragraph">
+<p>On the producer side, you must add two additional dependencies to your plugin
+configuration. One is the Spring Cloud Contract Pact support, and the other represents
+the current Pact version that you use. The following listing shows how to do so for both
+Maven and Gradle:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;packageWithBaseClasses&gt;com.example.fraud&lt;/packageWithBaseClasses&gt;
+    &lt;/configuration&gt;
+    &lt;dependencies&gt;
+        &lt;dependency&gt;
+            &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+            &lt;artifactId&gt;spring-cloud-contract-pact&lt;/artifactId&gt;
+            &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+        &lt;/dependency&gt;
+    &lt;/dependencies&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">classpath "org.springframework.cloud:spring-cloud-contract-pact:${findProperty('verifierVersion') ?: verifierVersion}"</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>When you execute the build of your application, a test and stub is generated. The following
+example shows a test and stub that came from this process:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">test</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Test
+    public void validate_shouldMarkClientAsFraud() throws Exception {
+        // given:
+            MockMvcRequestSpecification request = given()
+                    .header("Content-Type", "application/vnd.fraud.v1+json")
+                    .body("{\"clientId\":\"1234567890\",\"loanAmount\":99999}");
+
+        // when:
+            ResponseOptions response = given().spec(request)
+                    .put("/fraudcheck");
+
+        // then:
+            assertThat(response.statusCode()).isEqualTo(200);
+            assertThat(response.header("Content-Type")).matches("application/vnd\\.fraud\\.v1\\+json.*");
+        // and:
+            DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());
+            assertThatJson(parsedJson).field("['rejectionReason']").isEqualTo("Amount too high");
+        // and:
+            assertThat(parsedJson.read("$.fraudCheckStatus", String.class)).matches("FRAUD");
+    }</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">stub</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">{
+  "id" : "996ae5ae-6834-4db6-8fac-358ca187ab62",
+  "uuid" : "996ae5ae-6834-4db6-8fac-358ca187ab62",
+  "request" : {
+    "url" : "/fraudcheck",
+    "method" : "PUT",
+    "headers" : {
+      "Content-Type" : {
+        "matches" : "application/vnd\\.fraud\\.v1\\+json.*"
+      }
+    },
+    "bodyPatterns" : [ {
+      "matchesJsonPath" : "$[?(@.['loanAmount'] = 99999)]"
+    }, {
+      "matchesJsonPath" : "$[?(@.clientId =~ /([0-9]{10})/)]"
+    } ]
+  },
+  "response" : {
+    "status" : 200,
+    "body" : "{\"fraudCheckStatus\":\"FRAUD\",\"rejectionReason\":\"Amount too high\"}",
+    "headers" : {
+      "Content-Type" : "application/vnd.fraud.v1+json;charset=UTF-8"
+    },
+    "transformers" : [ "response-template" ]
+  },
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="how-to-use-pact-broker-pact-consumers"><a class="anchor" href="#how-to-use-pact-broker-pact-consumers"></a><a class="link" href="#how-to-use-pact-broker-pact-consumers">5.7.5. Pact for Consumers</a></h4>
+<div class="paragraph">
+<p>On the producer side, you must add two additional dependencies to your project
+dependencies. One is the Spring Cloud Contract Pact support, and the other represents the
+current Pact version that you use. The following listing shows how to do so for both
+Maven and Gradle:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">Maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-pact&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile "org.springframework.cloud:spring-cloud-contract-pact"</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="pact-stub-downloader"><a class="anchor" href="#pact-stub-downloader"></a><a class="link" href="#pact-stub-downloader">5.7.6. Communicating with the Pact Broker</a></h4>
+<div class="paragraph">
+<p>Whenever the <code>repositoryRoot</code> property starts with a Pact protocol
+(starts with <code>pact://</code>), the stub downloader tries
+to fetch the Pact contract definitions from the Pact Broker.
+Whatever is set after <code>pact://</code> is parsed as the Pact Broker URL.</p>
+</div>
+<div class="paragraph">
+<p>By setting environment variables, system properties, or properties set
+inside the plugin or contracts repository configuration, you can
+tweak the downloader&#8217;s behavior. The following table describes the
+properties:</p>
+</div>
+<table class="tableblock frame-all grid-all stretch">
+<caption class="title">Table 1. Pact Stub Downloader properties</caption>
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Name of a property</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Default</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Description</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.host</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.pactbroker.host</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_HOST</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Host from URL passed to <code>repositoryRoot</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The URL of the Pact Broker.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.port</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.pactbroker.port</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_PORT</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Port from URL passed to <code>repositoryRoot</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The port of Pact Broker.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.protocol</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.pactbroker.protocol</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_PROTOCOL</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Protocol from URL passed to <code>repositoryRoot</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The protocol of Pact Broker.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.tags</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.pactbroker.tags</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_TAGS</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Version of the stub, or <code>latest</code> if version is <code>+</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The tags that should be used to fetch the stub.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.auth.scheme</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.pactbroker.auth.scheme</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_AUTH_SCHEME</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Basic</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The kind of authentication that should be used to connect to the Pact Broker.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.auth.username</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.pactbroker.auth.username</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_AUTH_USERNAME</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The username passed to <code>contractsRepositoryUsername</code> (maven) or <code>contractRepository.username</code> (gradle)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The username to use when connecting to the Pact Broker.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.auth.password</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.pactbroker.auth.password</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_AUTH_PASSWORD</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The password passed to <code>contractsRepositoryPassword</code> (maven) or <code>contractRepository.password</code> (gradle)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The password to use when connecting to the Pact Broker.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">* <code>pactbroker.provider-name-with-group-id</code> (plugin prop)</p>
+<p class="tableblock">* <code>stubrunner.properties.pactbroker.provider-name-with-group-id</code> (system prop)</p>
+<p class="tableblock">* <code>STUBRUNNER_PROPERTIES_PACTBROKER_PROVIDER_NAME_WITH_GROUP_ID</code> (env prop)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">When <code>true</code>, the provider name is a combination of <code>groupId:artifactId</code>. If <code>false</code>, only <code>artifactId</code> is used.</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect3">
+<h4 id="how-to-pact-consumer"><a class="anchor" href="#how-to-pact-consumer"></a><a class="link" href="#how-to-pact-consumer">5.7.7. Flow: Consumer Contract approach with Pact Broker | Consumer Side</a></h4>
+<div class="paragraph">
+<p>The consumer uses the Pact framework to generate Pact files. The
+Pact files are sent to the Pact Broker. You can find an example of such a setup
+<a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x/consumer_pact">here</a>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="how-to-pact-producer"><a class="anchor" href="#how-to-pact-producer"></a><a class="link" href="#how-to-pact-producer">5.7.8. Flow: Consumer Contract Approach with Pact Broker on the Producer Side</a></h4>
+<div class="paragraph">
+<p>For the producer to use the Pact files from the Pact Broker, we can reuse the
+same mechanism we use for external contracts. We route Spring Cloud Contract
+to use the Pact implementation with the URL that contains
+the <code>pact://</code> protocol. You can pass the URL to the
+Pact Broker. You can find an example of such a setup
+<a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x/producer_pact">here</a>.
+The following listing shows the configuration details for both Maven and Gradle:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-contract-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    &lt;configuration&gt;
+        &lt;!-- Base class mappings etc. --&gt;
+
+        &lt;!-- We want to pick contracts from a Git repository --&gt;
+        &lt;contractsRepositoryUrl&gt;pact://http://localhost:8085&lt;/contractsRepositoryUrl&gt;
+
+        &lt;!-- We reuse the contract dependency section to set up the path
+        to the folder that contains the contract definitions. In our case the
+        path will be /groupId/artifactId/version/contracts --&gt;
+        &lt;contractDependency&gt;
+            &lt;groupId&gt;${project.groupId}&lt;/groupId&gt;
+            &lt;artifactId&gt;${project.artifactId}&lt;/artifactId&gt;
+            &lt;!-- When + is passed, a latest tag will be applied when fetching pacts --&gt;
+            &lt;version&gt;+&lt;/version&gt;
+        &lt;/contractDependency&gt;
+
+        &lt;!-- The contracts mode can't be classpath --&gt;
+        &lt;contractsMode&gt;REMOTE&lt;/contractsMode&gt;
+    &lt;/configuration&gt;
+    &lt;!-- Don't forget to add spring-cloud-contract-pact to the classpath! --&gt;
+    &lt;dependencies&gt;
+        &lt;dependency&gt;
+            &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+            &lt;artifactId&gt;spring-cloud-contract-pact&lt;/artifactId&gt;
+            &lt;version&gt;${spring-cloud-contract.version}&lt;/version&gt;
+        &lt;/dependency&gt;
+    &lt;/dependencies&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">buildscript {
+    repositories {
+        //...
+    }
+
+    dependencies {
+        // ...
+        // Don't forget to add spring-cloud-contract-pact to the classpath!
+        classpath "org.springframework.cloud:spring-cloud-contract-pact:${contractVersion}"
+    }
+}
+
+contracts {
+    // When + is passed, a latest tag will be applied when fetching pacts
+    contractDependency {
+        stringNotation = "${project.group}:${project.name}:+"
+    }
+    contractRepository {
+        repositoryUrl = "pact://http://localhost:8085"
+    }
+    // The mode can't be classpath
+    contractsMode = "REMOTE"
+    // Base class mappings etc.
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>With such a setup:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Pact files are downloaded from the Pact Broker.</p>
+</li>
+<li>
+<p>Spring Cloud Contract converts the Pact files into tests and stubs.</p>
+</li>
+<li>
+<p>The JAR with the stubs gets automatically created, as usual.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect3">
+<h4 id="how-to-pact-consumer-producer-contract"><a class="anchor" href="#how-to-pact-consumer-producer-contract"></a><a class="link" href="#how-to-pact-consumer-producer-contract">5.7.9. Flow: Producer Contract approach with Pact on the Consumer Side</a></h4>
+<div class="paragraph">
+<p>In the scenario where you do not want to do the consumer contract approach
+(for every single consumer, define the expectations) but you prefer
+to do producer contracts (the producer provides the contracts and
+publishes stubs), you can use Spring Cloud Contract with the
+Stub Runner option. You can find an example of such a setup
+<a href="https://github.com/spring-cloud-samples/spring-cloud-contract-samples/tree/2.2.x/consumer_pact_stubrunner">here</a>.</p>
+</div>
+<div class="paragraph">
+<p>Remember to add the Stub Runner and Spring Cloud Contract Pact modules
+as test dependencies.</p>
+</div>
+<div class="paragraph">
+<p>The following listing shows the configuration details for both Maven and Gradle:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependencyManagement&gt;
+    &lt;dependencies&gt;
+        &lt;dependency&gt;
+            &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+            &lt;artifactId&gt;spring-cloud-dependencies&lt;/artifactId&gt;
+            &lt;version&gt;${spring-cloud.version}&lt;/version&gt;
+            &lt;type&gt;pom&lt;/type&gt;
+            &lt;scope&gt;import&lt;/scope&gt;
+        &lt;/dependency&gt;
+    &lt;/dependencies&gt;
+&lt;/dependencyManagement&gt;
+
+&lt;!-- Don't forget to add spring-cloud-contract-pact to the classpath! --&gt;
+&lt;dependencies&gt;
+    &lt;!-- ... --&gt;
+    &lt;dependency&gt;
+        &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+        &lt;artifactId&gt;spring-cloud-starter-contract-stub-runner&lt;/artifactId&gt;
+        &lt;scope&gt;test&lt;/scope&gt;
+    &lt;/dependency&gt;
+    &lt;dependency&gt;
+        &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+        &lt;artifactId&gt;spring-cloud-contract-pact&lt;/artifactId&gt;
+        &lt;scope&gt;test&lt;/scope&gt;
+    &lt;/dependency&gt;
+&lt;/dependencies&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">dependencyManagement {
+    imports {
+        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
+    }
+}
+
+dependencies {
+    //...
+    testCompile("org.springframework.cloud:spring-cloud-starter-contract-stub-runner")
+    // Don't forget to add spring-cloud-contract-pact to the classpath!
+    testCompile("org.springframework.cloud:spring-cloud-contract-pact")
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Next, you can pass the URL of the Pact Broker to <code>repositoryRoot</code>, prefixed
+with <code>pact://</code> protocol (for example, <code>pact://http://localhost:8085</code>), as the following
+example shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(SpringRunner.class)
+@SpringBootTest
+@AutoConfigureStubRunner(stubsMode = StubRunnerProperties.StubsMode.REMOTE,
+        ids = "com.example:beer-api-producer-pact",
+        repositoryRoot = "pact://http://localhost:8085")
+public class BeerControllerTest {
+    //Inject the port of the running stub
+    @StubRunnerPort("beer-api-producer-pact") int producerPort;
+    //...
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>With such a setup:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Pact files are downloaded from the Pact Broker.</p>
+</li>
+<li>
+<p>Spring Cloud Contract converts the Pact files into stub definitions.</p>
+</li>
+<li>
+<p>The stub servers are started and fed with stubs.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-debug"><a class="anchor" href="#how-to-debug"></a><a class="link" href="#how-to-debug">5.8. How Can I Debug the Request/Response Being Sent by the Generated Tests Client?</a></h3>
+<div class="paragraph">
+<p>The generated tests all boil down to RestAssured in some form or fashion. RestAssured
+relies on the <a href="https://hc.apache.org/httpcomponents-client-ga/">Apache HttpClient</a>.
+HttpClient has a facility called
+<a href="https://hc.apache.org/httpcomponents-client-ga/logging.html#Wire_Logging">wire logging</a>,
+which logs the entire request and response to HttpClient. Spring Boot has a logging
+<a href="https://docs.spring.io/spring-boot/docs/current/reference/html/common-application-properties.html">common application property</a>
+for doing this sort of thing. To use it, add this to your application properties, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties">logging.level.org.apache.http.wire=DEBUG</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-debug-wiremock"><a class="anchor" href="#how-to-debug-wiremock"></a><a class="link" href="#how-to-debug-wiremock">5.9. How Can I Debug the Mapping, Request, or Response Being Sent by WireMock?</a></h3>
+<div class="paragraph">
+<p>Starting from version <code>1.2.0</code>, we turn on WireMock logging to
+<code>info</code> and set the WireMock notifier to being verbose. Now you can
+exactly know what request was received by the WireMock server and which
+matching response definition was picked.</p>
+</div>
+<div class="paragraph">
+<p>To turn off this feature, set WireMock logging to <code>ERROR</code>, as follows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties">logging.level.com.github.tomakehurst.wiremock=ERROR</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-see-registered-stubs"><a class="anchor" href="#how-to-see-registered-stubs"></a><a class="link" href="#how-to-see-registered-stubs">5.10. How Can I See What Got Registered in the HTTP Server Stub?</a></h3>
+<div class="paragraph">
+<p>You can use the <code>mappingsOutputFolder</code> property on <code>@AutoConfigureStubRunner</code>, <code>StubRunnerRule</code>, or
+`StubRunnerExtension`to dump all mappings per artifact ID. Also the port at which the given stub server
+was started is attached.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-reference-text-from-file"><a class="anchor" href="#how-to-reference-text-from-file"></a><a class="link" href="#how-to-reference-text-from-file">5.11. How Can I Reference Text from File?</a></h3>
+<div class="paragraph">
+<p>In version 1.2.0, we added this ability. You can call a <code>file(&#8230;&#8203;)</code> method in the
+DSL and provide a path relative to where the contract lies.
+If you use YAML, you can use the <code>bodyFromFile</code> property.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-generate-pact-from-scc"><a class="anchor" href="#how-to-generate-pact-from-scc"></a><a class="link" href="#how-to-generate-pact-from-scc">5.12. How Can I Generate Pact, YAML, or X files from Spring Cloud Contract Contracts?</a></h3>
+<div class="paragraph">
+<p>Spring Cloud Contract comes with a <code>ToFileContractsTransformer</code> class that lets you dump
+contracts as files for the given <code>ContractConverter</code>. It contains a <code>static void main</code>
+method that lets you execute the transformer as an executable. It takes the following
+arguments:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>argument 1 : <code>FQN</code>: Fully qualified name of the <code>ContractConverter</code> (for example, <code>PactContractConverter</code>). <strong>REQUIRED</strong>.</p>
+</li>
+<li>
+<p>argument 2 : <code>path</code>: Path where the dumped files should be stored. <strong>OPTIONAL</strong>&#8201;&#8212;&#8201;defaults to <code>target/converted-contracts</code>.</p>
+</li>
+<li>
+<p>argument 3 : <code>path</code>: Path were the contracts should be searched for. <strong>OPTIONAL</strong>&#8201;&#8212;&#8201;defaults to <code>src/test/resources/contracts</code>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>After executing the transformer, the Spring Cloud Contract files are processed and,
+depending on the provided FQN of the <code>ContractTransformer</code>, the contracts are transformed
+to the required format and dumped to the provided folder.</p>
+</div>
+<div class="paragraph">
+<p>The following example shows how to configure Pact integration for both Maven and Gradle:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;plugin&gt;
+    &lt;groupId&gt;org.codehaus.mojo&lt;/groupId&gt;
+    &lt;artifactId&gt;exec-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;1.6.0&lt;/version&gt;
+    &lt;executions&gt;
+        &lt;execution&gt;
+            &lt;id&gt;convert-dsl-to-pact&lt;/id&gt;
+            &lt;phase&gt;process-test-classes&lt;/phase&gt;
+            &lt;configuration&gt;
+                &lt;classpathScope&gt;test&lt;/classpathScope&gt;
+                &lt;mainClass&gt;
+                    org.springframework.cloud.contract.verifier.util.ToFileContractsTransformer
+                &lt;/mainClass&gt;
+                &lt;arguments&gt;
+                    &lt;argument&gt;
+                        org.springframework.cloud.contract.verifier.spec.pact.PactContractConverter
+                    &lt;/argument&gt;
+                    &lt;argument&gt;${project.basedir}/target/pacts&lt;/argument&gt;
+                    &lt;argument&gt;
+                        ${project.basedir}/src/test/resources/contracts
+                    &lt;/argument&gt;
+                &lt;/arguments&gt;
+            &lt;/configuration&gt;
+            &lt;goals&gt;
+                &lt;goal&gt;java&lt;/goal&gt;
+            &lt;/goals&gt;
+        &lt;/execution&gt;
+    &lt;/executions&gt;
+&lt;/plugin&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">task convertContracts(type: JavaExec) {
+    main = "org.springframework.cloud.contract.verifier.util.ToFileContractsTransformer"
+    classpath = sourceSets.test.compileClasspath
+    args("org.springframework.cloud.contract.verifier.spec.pact.PactContractConverter",
+            "${project.rootDir}/build/pacts", "${project.rootDir}/src/test/resources/contracts")
+}
+
+test.dependsOn("convertContracts")</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-work-with-transitivie"><a class="anchor" href="#how-to-work-with-transitivie"></a><a class="link" href="#how-to-work-with-transitivie">5.13. How Can I Work with Transitive Dependencies?</a></h3>
+<div class="paragraph">
+<p>The Spring Cloud Contract plugins add the tasks that create the stubs jar for you. One
+problem that arises is that, when reusing the stubs, you can mistakenly import all of
+that stub&#8217;s dependencies. When building a Maven artifact, even though you have a couple
+of different jars, all of them share one pom, as the following listing shows:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">├── producer-0.0.1.BUILD-20160903.075506-1-stubs.jar
+├── producer-0.0.1.BUILD-20160903.075506-1-stubs.jar.sha1
+├── producer-0.0.1.BUILD-20160903.075655-2-stubs.jar
+├── producer-0.0.1.BUILD-20160903.075655-2-stubs.jar.sha1
+├── producer-0.0.1.BUILD-SNAPSHOT.jar
+├── producer-0.0.1.BUILD-SNAPSHOT.pom
+├── producer-0.0.1.BUILD-SNAPSHOT-stubs.jar
+├── ...
+└── ...</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>There are three possibilities of working with those dependencies so as not to have any
+issues with transitive dependencies:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Mark all application dependencies as optional</p>
+</li>
+<li>
+<p>Create a separate artifactid for the stubs</p>
+</li>
+<li>
+<p>Exclude dependencies on the consumer side</p>
+</li>
+</ul>
+</div>
+<div class="sect3">
+<h4 id="how-to-work-with-transitivie-optional"><a class="anchor" href="#how-to-work-with-transitivie-optional"></a><a class="link" href="#how-to-work-with-transitivie-optional">5.13.1. How Can I Mark All Application Dependencies as Optional?</a></h4>
+<div class="paragraph">
+<p>If, in the <code>producer</code> application, you mark all of your dependencies as optional,
+when you include the <code>producer</code> stubs in another application (or when that
+dependency gets downloaded by Stub Runner) then, since all of the dependencies are
+optional, they do not get downloaded.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="how-to-work-with-transitivie-separate"><a class="anchor" href="#how-to-work-with-transitivie-separate"></a><a class="link" href="#how-to-work-with-transitivie-separate">5.13.2. How can I Create a Separate <code>artifactid</code> for the Stubs?</a></h4>
+<div class="paragraph">
+<p>If you create a separate <code>artifactid</code>, you can set it up in whatever way you wish.
+For example, you might decide to have no dependencies at all.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="how-to-work-with-transitivie-exclude"><a class="anchor" href="#how-to-work-with-transitivie-exclude"></a><a class="link" href="#how-to-work-with-transitivie-exclude">5.13.3. How can I Exclude Dependencies on the Consumer Side?</a></h4>
+<div class="paragraph">
+<p>As a consumer, if you add the stub dependency to your classpath, you can explicitly exclude the unwanted dependencies.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="contract-dsl-rest-docs"><a class="anchor" href="#contract-dsl-rest-docs"></a><a class="link" href="#contract-dsl-rest-docs">5.14. How can I Generate Spring REST Docs Snippets from the Contracts?</a></h3>
+<div class="paragraph">
+<p>When you want to include the requests and responses of your API by using Spring REST Docs,
+you only need to make some minor changes to your setup if you are using MockMvc and RestAssuredMockMvc.
+To do so, include the following dependencies (if you have not already done so):</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">maven</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-cloud-starter-contract-verifier&lt;/artifactId&gt;
+    &lt;scope&gt;test&lt;/scope&gt;
+&lt;/dependency&gt;
+&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.restdocs&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-restdocs-mockmvc&lt;/artifactId&gt;
+    &lt;optional&gt;true&lt;/optional&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">gradle</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">testCompile 'org.springframework.cloud:spring-cloud-starter-contract-verifier'
+testCompile 'org.springframework.restdocs:spring-restdocs-mockmvc'</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>Next, you need to make some changes to your base class. The following examples use
+<code>WebAppContext</code> and the standalone option with RestAssured:</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="listingblock primary">
+<div class="title">WebAppContext</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package com.example.fraud;
+
+import io.restassured.module.mockmvc.RestAssuredMockMvc;
+import org.junit.Before;
+import org.junit.Rule;
+import org.junit.rules.TestName;
+import org.junit.runner.RunWith;
+
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.restdocs.JUnitRestDocumentation;
+import org.springframework.test.context.junit4.SpringRunner;
+import org.springframework.test.web.servlet.setup.MockMvcBuilders;
+import org.springframework.web.context.WebApplicationContext;
+
+import static org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.document;
+import static org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.documentationConfiguration;
+
+@RunWith(SpringRunner.class)
+@SpringBootTest(classes = Application.class)
+public abstract class FraudBaseWithWebAppSetup {
+
+    private static final String OUTPUT = "target/generated-snippets";
+
+    @Rule
+    public JUnitRestDocumentation restDocumentation = new JUnitRestDocumentation(OUTPUT);
+
+    @Rule
+    public TestName testName = new TestName();
+
+    @Autowired
+    private WebApplicationContext context;
+
+    @Before
+    public void setup() {
+        RestAssuredMockMvc.mockMvc(MockMvcBuilders.webAppContextSetup(this.context)
+                .apply(documentationConfiguration(this.restDocumentation))
+                .alwaysDo(document(
+                        getClass().getSimpleName() + "_" + testName.getMethodName()))
+                .build());
+    }
+
+    protected void assertThatRejectionReasonIsNull(Object rejectionReason) {
+        assert rejectionReason == null;
+    }
+
+}</code></pre>
+</div>
+</div>
+<div class="listingblock secondary">
+<div class="title">Standalone</div>
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">package com.example.fraud;
+
+import io.restassured.module.mockmvc.RestAssuredMockMvc;
+import org.junit.Before;
+import org.junit.Rule;
+import org.junit.rules.TestName;
+
+import org.springframework.restdocs.JUnitRestDocumentation;
+import org.springframework.test.web.servlet.setup.MockMvcBuilders;
+
+import static org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.document;
+import static org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.documentationConfiguration;
+
+public abstract class FraudBaseWithStandaloneSetup {
+
+    private static final String OUTPUT = "target/generated-snippets";
+
+    @Rule
+    public JUnitRestDocumentation restDocumentation = new JUnitRestDocumentation(OUTPUT);
+
+    @Rule
+    public TestName testName = new TestName();
+
+    @Before
+    public void setup() {
+        RestAssuredMockMvc.standaloneSetup(MockMvcBuilders
+                .standaloneSetup(new FraudDetectionController())
+                .apply(documentationConfiguration(this.restDocumentation))
+                .alwaysDo(document(
+                        getClass().getSimpleName() + "_" + testName.getMethodName())));
+    }
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+You need not specify the output directory for the generated snippets (since version 1.2.0.RELEASE of Spring REST Docs).
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-use-stubs-from-a-location"><a class="anchor" href="#how-to-use-stubs-from-a-location"></a><a class="link" href="#how-to-use-stubs-from-a-location">5.15. How can I Use Stubs from a Location</a></h3>
+<div class="paragraph">
+<p>If you want to fetch contracts or stubs from a given location without cloning a repo or fetching a JAR, just use the <code>stubs://</code> protocol when providing the repository root argument for Stub Runner or the Spring Cloud Contract plugin. You can read more about this in <a href="#features-stub-runner-stubs-protocol">this section</a> of the documentation.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-generate-stubs-at-runtime"><a class="anchor" href="#how-to-generate-stubs-at-runtime"></a><a class="link" href="#how-to-generate-stubs-at-runtime">5.16. How can I Generate Stubs at Runtime</a></h3>
+<div class="paragraph">
+<p>If you want to generate stubs at runtime for contracts, it&#8217;s enough to switch the <code>generateStubs</code> property in the <code>@AutoConfigureStubRunner</code> annotation, or call the <code>withGenerateStubs(true)</code> method on the JUnit Rule or Extension. You can read more about this in <a href="#features-stub-runner-generate-stubs-at-runtime">this section</a> of the documentation.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="how-to-use-the-failonnostubs-feature"><a class="anchor" href="#how-to-use-the-failonnostubs-feature"></a><a class="link" href="#how-to-use-the-failonnostubs-feature">5.17. How can I Make The Build Pass if There Are No Contracts or Stubs</a></h3>
+<div class="paragraph">
+<p>If you want Stub Runner not to fail if no stubs were found, it&#8217;s enough to switch the <code>generateStubs</code> property in the <code>@AutoConfigureStubRunner</code> annotation, or call the <code>withFailOnNoStubs(false)</code> method on the JUnit Rule or Extension. You can read more about this in <a href="#features-stub-runner-fail-on-no-stubs">this section</a> of the documentation.</p>
+</div>
+<div class="paragraph">
+<p>If you want the plugins not to fail the build when no contracts were found, you can set the <code>failOnNoStubs</code> flag in Maven or call the <code>contractRepository { failOnNoStubs(false) }</code> Closure in Gradle.</p>
+</div>
+</div>
+</div>
+</div>
+</div>
+<script type="text/javascript" src="js/tocbot/tocbot.min.js"></script>
+<script type="text/javascript" src="js/toc.js"></script>
+<link rel="stylesheet" href="js/highlight/styles/atom-one-dark-reasonable.min.css">
+<script src="js/highlight/highlight.min.js"></script>
+<script>hljs.initHighlighting()</script>
+</body>
+</html>
\ No newline at end of file
diff --git a/spring-cloud-contract-maven-plugin/apidocs/allclasses-frame.html b/spring-cloud-contract-maven-plugin/apidocs/allclasses-frame.html
index 943f8dfd60..5832015a65 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/allclasses-frame.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/allclasses-frame.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>All Classes (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/allclasses-index.html b/spring-cloud-contract-maven-plugin/apidocs/allclasses-index.html
new file mode 100644
index 0000000000..f5bcd8cf5b
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/allclasses-index.html
@@ -0,0 +1,225 @@
+<!DOCTYPE HTML>
+<!-- NewPage -->
+<html lang="en">
+<head>
+<!-- Generated by javadoc (11.0.2) on Wed Aug 07 23:11:49 CEST 2019 -->
+<title>All Classes (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta name="dc.created" content="2019-08-07">
+<link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
+<link rel="stylesheet" type="text/css" href="jquery/jquery-ui.css" title="Style">
+<script type="text/javascript" src="script.js"></script>
+<script type="text/javascript" src="jquery/jszip/dist/jszip.min.js"></script>
+<script type="text/javascript" src="jquery/jszip-utils/dist/jszip-utils.min.js"></script>
+<!--[if IE]>
+<script type="text/javascript" src="jquery/jszip-utils/dist/jszip-utils-ie.min.js"></script>
+<![endif]-->
+<script type="text/javascript" src="jquery/jquery-3.3.1.js"></script>
+<script type="text/javascript" src="jquery/jquery-migrate-3.0.1.js"></script>
+<script type="text/javascript" src="jquery/jquery-ui.js"></script>
+</head>
+<body>
+<script type="text/javascript"><!--
+    try {
+        if (location.href.indexOf('is-external=true') == -1) {
+            parent.document.title="All Classes (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)";
+        }
+    }
+    catch(err) {
+    }
+//-->
+var pathtoroot = "./";
+var useModuleDirectories = true;
+loadScripts(document, 'script');</script>
+<noscript>
+<div>JavaScript is disabled on your browser.</div>
+</noscript>
+<header role="banner">
+<nav role="navigation">
+<div class="fixedNav">
+<!-- ========= START OF TOP NAVBAR ======= -->
+<div class="topNav"><a id="navbar.top">
+<!--   -->
+</a>
+<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
+<a id="navbar.top.firstrow">
+<!--   -->
+</a>
+<ul class="navList" title="Navigation">
+<li><a href="index.html">Overview</a></li>
+<li>Package</li>
+<li>Class</li>
+<li>Use</li>
+<li><a href="overview-tree.html">Tree</a></li>
+<li><a href="deprecated-list.html">Deprecated</a></li>
+<li><a href="index-all.html">Index</a></li>
+<li><a href="help-doc.html">Help</a></li>
+</ul>
+</div>
+<div class="subNav">
+<ul class="navList" id="allclasses_navbar_top">
+<li><a href="allclasses.html">All&nbsp;Classes</a></li>
+</ul>
+<ul class="navListSearch">
+<li><label for="search">SEARCH:</label>
+<input type="text" id="search" value="search" disabled="disabled">
+<input type="reset" id="reset" value="reset" disabled="disabled">
+</li>
+</ul>
+<div>
+<script type="text/javascript"><!--
+  allClassesLink = document.getElementById("allclasses_navbar_top");
+  if(window==top) {
+    allClassesLink.style.display = "block";
+  }
+  else {
+    allClassesLink.style.display = "none";
+  }
+  //-->
+</script>
+<noscript>
+<div>JavaScript is disabled on your browser.</div>
+</noscript>
+</div>
+<a id="skip.navbar.top">
+<!--   -->
+</a></div>
+<!-- ========= END OF TOP NAVBAR ========= -->
+</div>
+<div class="navPadding">&nbsp;</div>
+<script type="text/javascript"><!--
+$('.navPadding').css('padding-top', $('.fixedNav').css("height"));
+//-->
+</script>
+</nav>
+</header>
+<main role="main">
+<div class="header">
+<h1 title="All&amp;nbsp;Classes" class="title">All&nbsp;Classes</h1>
+</div>
+<div class="allClassesContainer">
+<ul class="blockList">
+<li class="blockList">
+<table class="typeSummary">
+<caption><span>Class Summary</span><span class="tabEnd">&nbsp;</span></caption>
+<tr>
+<th class="colFirst" scope="col">Class</th>
+<th class="colLast" scope="col">Description</th>
+</tr>
+<tr id="i0" class="altColor">
+<td class="colFirst"><a href="org/springframework/cloud/contract/maven/verifier/stubrunner/AetherStubDownloaderFactory.html" title="class in org.springframework.cloud.contract.maven.verifier.stubrunner">AetherStubDownloaderFactory</a></td>
+<th class="colLast" scope="row">
+<div class="block">Builds <code>StubDownloaderBuilder</code> for a Maven project.</div>
+</th>
+</tr>
+<tr id="i1" class="rowColor">
+<td class="colFirst"><a href="org/springframework/cloud/contract/maven/verifier/BaseClassMapping.html" title="class in org.springframework.cloud.contract.maven.verifier">BaseClassMapping</a></td>
+<th class="colLast" scope="row">
+<div class="block">Represents a single mapping of regex on package where contracts reside to the FQN of
+ the base test class.</div>
+</th>
+</tr>
+<tr id="i2" class="altColor">
+<td class="colFirst"><a href="org/springframework/cloud/contract/maven/verifier/ConvertMojo.html" title="class in org.springframework.cloud.contract.maven.verifier">ConvertMojo</a></td>
+<th class="colLast" scope="row">
+<div class="block">Convert Spring Cloud Contract Verifier contracts into stubs mappings.</div>
+</th>
+</tr>
+<tr id="i3" class="rowColor">
+<td class="colFirst"><a href="org/springframework/cloud/contract/maven/verifier/GenerateStubsMojo.html" title="class in org.springframework.cloud.contract.maven.verifier">GenerateStubsMojo</a></td>
+<th class="colLast" scope="row">
+<div class="block">Picks the converted .json files and creates a jar.</div>
+</th>
+</tr>
+<tr id="i4" class="altColor">
+<td class="colFirst"><a href="org/springframework/cloud/contract/maven/verifier/GenerateTestsMojo.html" title="class in org.springframework.cloud.contract.maven.verifier">GenerateTestsMojo</a></td>
+<th class="colLast" scope="row">
+<div class="block">From the provided directory with contracts generates the acceptance tests on the
+ producer side.</div>
+</th>
+</tr>
+<tr id="i5" class="rowColor">
+<td class="colFirst"><a href="org/springframework/cloud/contract/maven/verifier/HelpMojo.html" title="class in org.springframework.cloud.contract.maven.verifier">HelpMojo</a></td>
+<th class="colLast" scope="row">
+<div class="block">Display help information on spring-cloud-contract-maven-plugin.<br>
+ Call <code>mvn spring-cloud-contract:help -Ddetail=true -Dgoal=&lt;goal-name&gt;</code> to display parameter details.</div>
+</th>
+</tr>
+<tr id="i6" class="altColor">
+<td class="colFirst"><a href="org/springframework/cloud/contract/maven/verifier/stubrunner/LocalStubRunner.html" title="class in org.springframework.cloud.contract.maven.verifier.stubrunner">LocalStubRunner</a></td>
+<th class="colLast" scope="row">
+<div class="block">Allows running stubs from the given directory.</div>
+</th>
+</tr>
+<tr id="i7" class="rowColor">
+<td class="colFirst"><a href="org/springframework/cloud/contract/maven/verifier/PushStubsToScmMojo.html" title="class in org.springframework.cloud.contract.maven.verifier">PushStubsToScmMojo</a></td>
+<th class="colLast" scope="row">
+<div class="block">The generated stubs get committed to the SCM repo and pushed to origin.</div>
+</th>
+</tr>
+<tr id="i8" class="altColor">
+<td class="colFirst"><a href="org/springframework/cloud/contract/maven/verifier/stubrunner/RemoteStubRunner.html" title="class in org.springframework.cloud.contract.maven.verifier.stubrunner">RemoteStubRunner</a></td>
+<th class="colLast" scope="row">
+<div class="block">Fetches stubs from a remote location.</div>
+</th>
+</tr>
+<tr id="i9" class="rowColor">
+<td class="colFirst"><a href="org/springframework/cloud/contract/maven/verifier/RunMojo.html" title="class in org.springframework.cloud.contract.maven.verifier">RunMojo</a></td>
+<th class="colLast" scope="row">
+<div class="block">Mojo for running stubs.</div>
+</th>
+</tr>
+</table>
+</li>
+</ul>
+</div>
+</main>
+<footer role="contentinfo">
+<nav role="navigation">
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<div class="bottomNav"><a id="navbar.bottom">
+<!--   -->
+</a>
+<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
+<a id="navbar.bottom.firstrow">
+<!--   -->
+</a>
+<ul class="navList" title="Navigation">
+<li><a href="index.html">Overview</a></li>
+<li>Package</li>
+<li>Class</li>
+<li>Use</li>
+<li><a href="overview-tree.html">Tree</a></li>
+<li><a href="deprecated-list.html">Deprecated</a></li>
+<li><a href="index-all.html">Index</a></li>
+<li><a href="help-doc.html">Help</a></li>
+</ul>
+</div>
+<div class="subNav">
+<ul class="navList" id="allclasses_navbar_bottom">
+<li><a href="allclasses.html">All&nbsp;Classes</a></li>
+</ul>
+<div>
+<script type="text/javascript"><!--
+  allClassesLink = document.getElementById("allclasses_navbar_bottom");
+  if(window==top) {
+    allClassesLink.style.display = "block";
+  }
+  else {
+    allClassesLink.style.display = "none";
+  }
+  //-->
+</script>
+<noscript>
+<div>JavaScript is disabled on your browser.</div>
+</noscript>
+</div>
+<a id="skip.navbar.bottom">
+<!--   -->
+</a></div>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+</nav>
+<p class="legalCopy"><small>Copyright &#169; 2016&#x2013;2019 <a href="https://spring.io/">Spring</a>. All rights reserved.</small></p>
+</footer>
+</body>
+</html>
diff --git a/spring-cloud-contract-maven-plugin/apidocs/allclasses-noframe.html b/spring-cloud-contract-maven-plugin/apidocs/allclasses-noframe.html
index 1c43a84cfa..29afd0e20d 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/allclasses-noframe.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/allclasses-noframe.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>All Classes (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/allclasses.html b/spring-cloud-contract-maven-plugin/apidocs/allclasses.html
new file mode 100644
index 0000000000..7bab557513
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/allclasses.html
@@ -0,0 +1,38 @@
+<!DOCTYPE HTML>
+<!-- NewPage -->
+<html lang="en">
+<head>
+<!-- Generated by javadoc (11.0.2) on Wed Aug 07 23:11:49 CEST 2019 -->
+<title>All Classes (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta name="dc.created" content="2019-08-07">
+<link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
+<link rel="stylesheet" type="text/css" href="jquery/jquery-ui.css" title="Style">
+<script type="text/javascript" src="script.js"></script>
+<script type="text/javascript" src="jquery/jszip/dist/jszip.min.js"></script>
+<script type="text/javascript" src="jquery/jszip-utils/dist/jszip-utils.min.js"></script>
+<!--[if IE]>
+<script type="text/javascript" src="jquery/jszip-utils/dist/jszip-utils-ie.min.js"></script>
+<![endif]-->
+<script type="text/javascript" src="jquery/jquery-3.3.1.js"></script>
+<script type="text/javascript" src="jquery/jquery-migrate-3.0.1.js"></script>
+<script type="text/javascript" src="jquery/jquery-ui.js"></script>
+</head>
+<body>
+<h1 class="bar">All&nbsp;Classes</h1>
+<main role="main" class="indexContainer">
+<ul>
+<li><a href="org/springframework/cloud/contract/maven/verifier/stubrunner/AetherStubDownloaderFactory.html" title="class in org.springframework.cloud.contract.maven.verifier.stubrunner">AetherStubDownloaderFactory</a></li>
+<li><a href="org/springframework/cloud/contract/maven/verifier/BaseClassMapping.html" title="class in org.springframework.cloud.contract.maven.verifier">BaseClassMapping</a></li>
+<li><a href="org/springframework/cloud/contract/maven/verifier/ConvertMojo.html" title="class in org.springframework.cloud.contract.maven.verifier">ConvertMojo</a></li>
+<li><a href="org/springframework/cloud/contract/maven/verifier/GenerateStubsMojo.html" title="class in org.springframework.cloud.contract.maven.verifier">GenerateStubsMojo</a></li>
+<li><a href="org/springframework/cloud/contract/maven/verifier/GenerateTestsMojo.html" title="class in org.springframework.cloud.contract.maven.verifier">GenerateTestsMojo</a></li>
+<li><a href="org/springframework/cloud/contract/maven/verifier/HelpMojo.html" title="class in org.springframework.cloud.contract.maven.verifier">HelpMojo</a></li>
+<li><a href="org/springframework/cloud/contract/maven/verifier/stubrunner/LocalStubRunner.html" title="class in org.springframework.cloud.contract.maven.verifier.stubrunner">LocalStubRunner</a></li>
+<li><a href="org/springframework/cloud/contract/maven/verifier/PushStubsToScmMojo.html" title="class in org.springframework.cloud.contract.maven.verifier">PushStubsToScmMojo</a></li>
+<li><a href="org/springframework/cloud/contract/maven/verifier/stubrunner/RemoteStubRunner.html" title="class in org.springframework.cloud.contract.maven.verifier.stubrunner">RemoteStubRunner</a></li>
+<li><a href="org/springframework/cloud/contract/maven/verifier/RunMojo.html" title="class in org.springframework.cloud.contract.maven.verifier">RunMojo</a></li>
+</ul>
+</main>
+</body>
+</html>
diff --git a/spring-cloud-contract-maven-plugin/apidocs/allpackages-index.html b/spring-cloud-contract-maven-plugin/apidocs/allpackages-index.html
new file mode 100644
index 0000000000..d717c3ade3
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/allpackages-index.html
@@ -0,0 +1,172 @@
+<!DOCTYPE HTML>
+<!-- NewPage -->
+<html lang="en">
+<head>
+<!-- Generated by javadoc (11.0.2) on Wed Aug 07 23:11:49 CEST 2019 -->
+<title>All Packages (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta name="dc.created" content="2019-08-07">
+<link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
+<link rel="stylesheet" type="text/css" href="jquery/jquery-ui.css" title="Style">
+<script type="text/javascript" src="script.js"></script>
+<script type="text/javascript" src="jquery/jszip/dist/jszip.min.js"></script>
+<script type="text/javascript" src="jquery/jszip-utils/dist/jszip-utils.min.js"></script>
+<!--[if IE]>
+<script type="text/javascript" src="jquery/jszip-utils/dist/jszip-utils-ie.min.js"></script>
+<![endif]-->
+<script type="text/javascript" src="jquery/jquery-3.3.1.js"></script>
+<script type="text/javascript" src="jquery/jquery-migrate-3.0.1.js"></script>
+<script type="text/javascript" src="jquery/jquery-ui.js"></script>
+</head>
+<body>
+<script type="text/javascript"><!--
+    try {
+        if (location.href.indexOf('is-external=true') == -1) {
+            parent.document.title="All Packages (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)";
+        }
+    }
+    catch(err) {
+    }
+//-->
+var pathtoroot = "./";
+var useModuleDirectories = true;
+loadScripts(document, 'script');</script>
+<noscript>
+<div>JavaScript is disabled on your browser.</div>
+</noscript>
+<header role="banner">
+<nav role="navigation">
+<div class="fixedNav">
+<!-- ========= START OF TOP NAVBAR ======= -->
+<div class="topNav"><a id="navbar.top">
+<!--   -->
+</a>
+<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
+<a id="navbar.top.firstrow">
+<!--   -->
+</a>
+<ul class="navList" title="Navigation">
+<li><a href="index.html">Overview</a></li>
+<li>Package</li>
+<li>Class</li>
+<li>Use</li>
+<li><a href="overview-tree.html">Tree</a></li>
+<li><a href="deprecated-list.html">Deprecated</a></li>
+<li><a href="index-all.html">Index</a></li>
+<li><a href="help-doc.html">Help</a></li>
+</ul>
+</div>
+<div class="subNav">
+<ul class="navList" id="allclasses_navbar_top">
+<li><a href="allclasses.html">All&nbsp;Classes</a></li>
+</ul>
+<ul class="navListSearch">
+<li><label for="search">SEARCH:</label>
+<input type="text" id="search" value="search" disabled="disabled">
+<input type="reset" id="reset" value="reset" disabled="disabled">
+</li>
+</ul>
+<div>
+<script type="text/javascript"><!--
+  allClassesLink = document.getElementById("allclasses_navbar_top");
+  if(window==top) {
+    allClassesLink.style.display = "block";
+  }
+  else {
+    allClassesLink.style.display = "none";
+  }
+  //-->
+</script>
+<noscript>
+<div>JavaScript is disabled on your browser.</div>
+</noscript>
+</div>
+<a id="skip.navbar.top">
+<!--   -->
+</a></div>
+<!-- ========= END OF TOP NAVBAR ========= -->
+</div>
+<div class="navPadding">&nbsp;</div>
+<script type="text/javascript"><!--
+$('.navPadding').css('padding-top', $('.fixedNav').css("height"));
+//-->
+</script>
+</nav>
+</header>
+<main role="main">
+<div class="header">
+<h1 title="All&amp;nbsp;Packages" class="title">All&nbsp;Packages</h1>
+</div>
+<div class="allPackagesContainer">
+<ul class="blockList">
+<li class="blockList">
+<table class="packagesSummary">
+<caption><span>Package Summary</span><span class="tabEnd">&nbsp;</span></caption>
+<tr>
+<th class="colFirst" scope="col">Package</th>
+<th class="colLast" scope="col">Description</th>
+</tr>
+<tbody>
+<tr class="altColor">
+<th class="colFirst" scope="row"><a href="org/springframework/cloud/contract/maven/verifier/package-summary.html">org.springframework.cloud.contract.maven.verifier</a></th>
+<td class="colLast">&nbsp;</td>
+</tr>
+<tr class="rowColor">
+<th class="colFirst" scope="row"><a href="org/springframework/cloud/contract/maven/verifier/stubrunner/package-summary.html">org.springframework.cloud.contract.maven.verifier.stubrunner</a></th>
+<td class="colLast">&nbsp;</td>
+</tr>
+</tbody>
+</table>
+</li>
+</ul>
+</div>
+</main>
+<footer role="contentinfo">
+<nav role="navigation">
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<div class="bottomNav"><a id="navbar.bottom">
+<!--   -->
+</a>
+<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
+<a id="navbar.bottom.firstrow">
+<!--   -->
+</a>
+<ul class="navList" title="Navigation">
+<li><a href="index.html">Overview</a></li>
+<li>Package</li>
+<li>Class</li>
+<li>Use</li>
+<li><a href="overview-tree.html">Tree</a></li>
+<li><a href="deprecated-list.html">Deprecated</a></li>
+<li><a href="index-all.html">Index</a></li>
+<li><a href="help-doc.html">Help</a></li>
+</ul>
+</div>
+<div class="subNav">
+<ul class="navList" id="allclasses_navbar_bottom">
+<li><a href="allclasses.html">All&nbsp;Classes</a></li>
+</ul>
+<div>
+<script type="text/javascript"><!--
+  allClassesLink = document.getElementById("allclasses_navbar_bottom");
+  if(window==top) {
+    allClassesLink.style.display = "block";
+  }
+  else {
+    allClassesLink.style.display = "none";
+  }
+  //-->
+</script>
+<noscript>
+<div>JavaScript is disabled on your browser.</div>
+</noscript>
+</div>
+<a id="skip.navbar.bottom">
+<!--   -->
+</a></div>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+</nav>
+<p class="legalCopy"><small>Copyright &#169; 2016&#x2013;2019 <a href="https://spring.io/">Spring</a>. All rights reserved.</small></p>
+</footer>
+</body>
+</html>
diff --git a/spring-cloud-contract-maven-plugin/apidocs/constant-values.html b/spring-cloud-contract-maven-plugin/apidocs/constant-values.html
index 724f3e114a..584753a363 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/constant-values.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/constant-values.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Constant Field Values (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/deprecated-list.html b/spring-cloud-contract-maven-plugin/apidocs/deprecated-list.html
index 91ba15a846..880d1e59d0 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/deprecated-list.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/deprecated-list.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Deprecated List (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/element-list b/spring-cloud-contract-maven-plugin/apidocs/element-list
new file mode 100644
index 0000000000..cdc46a23e5
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/element-list
@@ -0,0 +1,2 @@
+org.springframework.cloud.contract.maven.verifier
+org.springframework.cloud.contract.maven.verifier.stubrunner
diff --git a/spring-cloud-contract-maven-plugin/apidocs/help-doc.html b/spring-cloud-contract-maven-plugin/apidocs/help-doc.html
index 53315ddf9f..9b0b5cc4fc 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/help-doc.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/help-doc.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>API Help (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/index-all.html b/spring-cloud-contract-maven-plugin/apidocs/index-all.html
index 7df501e3a0..18f08ab19f 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/index-all.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/index-all.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Index (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/index.html b/spring-cloud-contract-maven-plugin/apidocs/index.html
index 350f0f9749..f256d5c8ec 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/index.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/index.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API</title>
 <script type="text/javascript">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/external/jquery/jquery.js b/spring-cloud-contract-maven-plugin/apidocs/jquery/external/jquery/jquery.js
new file mode 100644
index 0000000000..9b5206bcc6
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/jquery/external/jquery/jquery.js
@@ -0,0 +1,10364 @@
+/*!
+ * jQuery JavaScript Library v3.3.1
+ * https://jquery.com/
+ *
+ * Includes Sizzle.js
+ * https://sizzlejs.com/
+ *
+ * Copyright JS Foundation and other contributors
+ * Released under the MIT license
+ * https://jquery.org/license
+ *
+ * Date: 2018-01-20T17:24Z
+ */
+( function( global, factory ) {
+
+	"use strict";
+
+	if ( typeof module === "object" && typeof module.exports === "object" ) {
+
+		// For CommonJS and CommonJS-like environments where a proper `window`
+		// is present, execute the factory and get jQuery.
+		// For environments that do not have a `window` with a `document`
+		// (such as Node.js), expose a factory as module.exports.
+		// This accentuates the need for the creation of a real `window`.
+		// e.g. var jQuery = require("jquery")(window);
+		// See ticket #14549 for more info.
+		module.exports = global.document ?
+			factory( global, true ) :
+			function( w ) {
+				if ( !w.document ) {
+					throw new Error( "jQuery requires a window with a document" );
+				}
+				return factory( w );
+			};
+	} else {
+		factory( global );
+	}
+
+// Pass this if window is not defined yet
+} )( typeof window !== "undefined" ? window : this, function( window, noGlobal ) {
+
+// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1
+// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode
+// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common
+// enough that all such attempts are guarded in a try block.
+"use strict";
+
+var arr = [];
+
+var document = window.document;
+
+var getProto = Object.getPrototypeOf;
+
+var slice = arr.slice;
+
+var concat = arr.concat;
+
+var push = arr.push;
+
+var indexOf = arr.indexOf;
+
+var class2type = {};
+
+var toString = class2type.toString;
+
+var hasOwn = class2type.hasOwnProperty;
+
+var fnToString = hasOwn.toString;
+
+var ObjectFunctionString = fnToString.call( Object );
+
+var support = {};
+
+var isFunction = function isFunction( obj ) {
+
+      // Support: Chrome <=57, Firefox <=52
+      // In some browsers, typeof returns "function" for HTML <object> elements
+      // (i.e., `typeof document.createElement( "object" ) === "function"`).
+      // We don't want to classify *any* DOM node as a function.
+      return typeof obj === "function" && typeof obj.nodeType !== "number";
+  };
+
+
+var isWindow = function isWindow( obj ) {
+		return obj != null && obj === obj.window;
+	};
+
+
+
+
+	var preservedScriptAttributes = {
+		type: true,
+		src: true,
+		noModule: true
+	};
+
+	function DOMEval( code, doc, node ) {
+		doc = doc || document;
+
+		var i,
+			script = doc.createElement( "script" );
+
+		script.text = code;
+		if ( node ) {
+			for ( i in preservedScriptAttributes ) {
+				if ( node[ i ] ) {
+					script[ i ] = node[ i ];
+				}
+			}
+		}
+		doc.head.appendChild( script ).parentNode.removeChild( script );
+	}
+
+
+function toType( obj ) {
+	if ( obj == null ) {
+		return obj + "";
+	}
+
+	// Support: Android <=2.3 only (functionish RegExp)
+	return typeof obj === "object" || typeof obj === "function" ?
+		class2type[ toString.call( obj ) ] || "object" :
+		typeof obj;
+}
+/* global Symbol */
+// Defining this global in .eslintrc.json would create a danger of using the global
+// unguarded in another place, it seems safer to define global only for this module
+
+
+
+var
+	version = "3.3.1",
+
+	// Define a local copy of jQuery
+	jQuery = function( selector, context ) {
+
+		// The jQuery object is actually just the init constructor 'enhanced'
+		// Need init if jQuery is called (just allow error to be thrown if not included)
+		return new jQuery.fn.init( selector, context );
+	},
+
+	// Support: Android <=4.0 only
+	// Make sure we trim BOM and NBSP
+	rtrim = /^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g;
+
+jQuery.fn = jQuery.prototype = {
+
+	// The current version of jQuery being used
+	jquery: version,
+
+	constructor: jQuery,
+
+	// The default length of a jQuery object is 0
+	length: 0,
+
+	toArray: function() {
+		return slice.call( this );
+	},
+
+	// Get the Nth element in the matched element set OR
+	// Get the whole matched element set as a clean array
+	get: function( num ) {
+
+		// Return all the elements in a clean array
+		if ( num == null ) {
+			return slice.call( this );
+		}
+
+		// Return just the one element from the set
+		return num < 0 ? this[ num + this.length ] : this[ num ];
+	},
+
+	// Take an array of elements and push it onto the stack
+	// (returning the new matched element set)
+	pushStack: function( elems ) {
+
+		// Build a new jQuery matched element set
+		var ret = jQuery.merge( this.constructor(), elems );
+
+		// Add the old object onto the stack (as a reference)
+		ret.prevObject = this;
+
+		// Return the newly-formed element set
+		return ret;
+	},
+
+	// Execute a callback for every element in the matched set.
+	each: function( callback ) {
+		return jQuery.each( this, callback );
+	},
+
+	map: function( callback ) {
+		return this.pushStack( jQuery.map( this, function( elem, i ) {
+			return callback.call( elem, i, elem );
+		} ) );
+	},
+
+	slice: function() {
+		return this.pushStack( slice.apply( this, arguments ) );
+	},
+
+	first: function() {
+		return this.eq( 0 );
+	},
+
+	last: function() {
+		return this.eq( -1 );
+	},
+
+	eq: function( i ) {
+		var len = this.length,
+			j = +i + ( i < 0 ? len : 0 );
+		return this.pushStack( j >= 0 && j < len ? [ this[ j ] ] : [] );
+	},
+
+	end: function() {
+		return this.prevObject || this.constructor();
+	},
+
+	// For internal use only.
+	// Behaves like an Array's method, not like a jQuery method.
+	push: push,
+	sort: arr.sort,
+	splice: arr.splice
+};
+
+jQuery.extend = jQuery.fn.extend = function() {
+	var options, name, src, copy, copyIsArray, clone,
+		target = arguments[ 0 ] || {},
+		i = 1,
+		length = arguments.length,
+		deep = false;
+
+	// Handle a deep copy situation
+	if ( typeof target === "boolean" ) {
+		deep = target;
+
+		// Skip the boolean and the target
+		target = arguments[ i ] || {};
+		i++;
+	}
+
+	// Handle case when target is a string or something (possible in deep copy)
+	if ( typeof target !== "object" && !isFunction( target ) ) {
+		target = {};
+	}
+
+	// Extend jQuery itself if only one argument is passed
+	if ( i === length ) {
+		target = this;
+		i--;
+	}
+
+	for ( ; i < length; i++ ) {
+
+		// Only deal with non-null/undefined values
+		if ( ( options = arguments[ i ] ) != null ) {
+
+			// Extend the base object
+			for ( name in options ) {
+				src = target[ name ];
+				copy = options[ name ];
+
+				// Prevent never-ending loop
+				if ( target === copy ) {
+					continue;
+				}
+
+				// Recurse if we're merging plain objects or arrays
+				if ( deep && copy && ( jQuery.isPlainObject( copy ) ||
+					( copyIsArray = Array.isArray( copy ) ) ) ) {
+
+					if ( copyIsArray ) {
+						copyIsArray = false;
+						clone = src && Array.isArray( src ) ? src : [];
+
+					} else {
+						clone = src && jQuery.isPlainObject( src ) ? src : {};
+					}
+
+					// Never move original objects, clone them
+					target[ name ] = jQuery.extend( deep, clone, copy );
+
+				// Don't bring in undefined values
+				} else if ( copy !== undefined ) {
+					target[ name ] = copy;
+				}
+			}
+		}
+	}
+
+	// Return the modified object
+	return target;
+};
+
+jQuery.extend( {
+
+	// Unique for each copy of jQuery on the page
+	expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ),
+
+	// Assume jQuery is ready without the ready module
+	isReady: true,
+
+	error: function( msg ) {
+		throw new Error( msg );
+	},
+
+	noop: function() {},
+
+	isPlainObject: function( obj ) {
+		var proto, Ctor;
+
+		// Detect obvious negatives
+		// Use toString instead of jQuery.type to catch host objects
+		if ( !obj || toString.call( obj ) !== "[object Object]" ) {
+			return false;
+		}
+
+		proto = getProto( obj );
+
+		// Objects with no prototype (e.g., `Object.create( null )`) are plain
+		if ( !proto ) {
+			return true;
+		}
+
+		// Objects with prototype are plain iff they were constructed by a global Object function
+		Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor;
+		return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString;
+	},
+
+	isEmptyObject: function( obj ) {
+
+		/* eslint-disable no-unused-vars */
+		// See https://github.com/eslint/eslint/issues/6125
+		var name;
+
+		for ( name in obj ) {
+			return false;
+		}
+		return true;
+	},
+
+	// Evaluates a script in a global context
+	globalEval: function( code ) {
+		DOMEval( code );
+	},
+
+	each: function( obj, callback ) {
+		var length, i = 0;
+
+		if ( isArrayLike( obj ) ) {
+			length = obj.length;
+			for ( ; i < length; i++ ) {
+				if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) {
+					break;
+				}
+			}
+		} else {
+			for ( i in obj ) {
+				if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) {
+					break;
+				}
+			}
+		}
+
+		return obj;
+	},
+
+	// Support: Android <=4.0 only
+	trim: function( text ) {
+		return text == null ?
+			"" :
+			( text + "" ).replace( rtrim, "" );
+	},
+
+	// results is for internal usage only
+	makeArray: function( arr, results ) {
+		var ret = results || [];
+
+		if ( arr != null ) {
+			if ( isArrayLike( Object( arr ) ) ) {
+				jQuery.merge( ret,
+					typeof arr === "string" ?
+					[ arr ] : arr
+				);
+			} else {
+				push.call( ret, arr );
+			}
+		}
+
+		return ret;
+	},
+
+	inArray: function( elem, arr, i ) {
+		return arr == null ? -1 : indexOf.call( arr, elem, i );
+	},
+
+	// Support: Android <=4.0 only, PhantomJS 1 only
+	// push.apply(_, arraylike) throws on ancient WebKit
+	merge: function( first, second ) {
+		var len = +second.length,
+			j = 0,
+			i = first.length;
+
+		for ( ; j < len; j++ ) {
+			first[ i++ ] = second[ j ];
+		}
+
+		first.length = i;
+
+		return first;
+	},
+
+	grep: function( elems, callback, invert ) {
+		var callbackInverse,
+			matches = [],
+			i = 0,
+			length = elems.length,
+			callbackExpect = !invert;
+
+		// Go through the array, only saving the items
+		// that pass the validator function
+		for ( ; i < length; i++ ) {
+			callbackInverse = !callback( elems[ i ], i );
+			if ( callbackInverse !== callbackExpect ) {
+				matches.push( elems[ i ] );
+			}
+		}
+
+		return matches;
+	},
+
+	// arg is for internal usage only
+	map: function( elems, callback, arg ) {
+		var length, value,
+			i = 0,
+			ret = [];
+
+		// Go through the array, translating each of the items to their new values
+		if ( isArrayLike( elems ) ) {
+			length = elems.length;
+			for ( ; i < length; i++ ) {
+				value = callback( elems[ i ], i, arg );
+
+				if ( value != null ) {
+					ret.push( value );
+				}
+			}
+
+		// Go through every key on the object,
+		} else {
+			for ( i in elems ) {
+				value = callback( elems[ i ], i, arg );
+
+				if ( value != null ) {
+					ret.push( value );
+				}
+			}
+		}
+
+		// Flatten any nested arrays
+		return concat.apply( [], ret );
+	},
+
+	// A global GUID counter for objects
+	guid: 1,
+
+	// jQuery.support is not used in Core but other projects attach their
+	// properties to it so it needs to exist.
+	support: support
+} );
+
+if ( typeof Symbol === "function" ) {
+	jQuery.fn[ Symbol.iterator ] = arr[ Symbol.iterator ];
+}
+
+// Populate the class2type map
+jQuery.each( "Boolean Number String Function Array Date RegExp Object Error Symbol".split( " " ),
+function( i, name ) {
+	class2type[ "[object " + name + "]" ] = name.toLowerCase();
+} );
+
+function isArrayLike( obj ) {
+
+	// Support: real iOS 8.2 only (not reproducible in simulator)
+	// `in` check used to prevent JIT error (gh-2145)
+	// hasOwn isn't used here due to false negatives
+	// regarding Nodelist length in IE
+	var length = !!obj && "length" in obj && obj.length,
+		type = toType( obj );
+
+	if ( isFunction( obj ) || isWindow( obj ) ) {
+		return false;
+	}
+
+	return type === "array" || length === 0 ||
+		typeof length === "number" && length > 0 && ( length - 1 ) in obj;
+}
+var Sizzle =
+/*!
+ * Sizzle CSS Selector Engine v2.3.3
+ * https://sizzlejs.com/
+ *
+ * Copyright jQuery Foundation and other contributors
+ * Released under the MIT license
+ * http://jquery.org/license
+ *
+ * Date: 2016-08-08
+ */
+(function( window ) {
+
+var i,
+	support,
+	Expr,
+	getText,
+	isXML,
+	tokenize,
+	compile,
+	select,
+	outermostContext,
+	sortInput,
+	hasDuplicate,
+
+	// Local document vars
+	setDocument,
+	document,
+	docElem,
+	documentIsHTML,
+	rbuggyQSA,
+	rbuggyMatches,
+	matches,
+	contains,
+
+	// Instance-specific data
+	expando = "sizzle" + 1 * new Date(),
+	preferredDoc = window.document,
+	dirruns = 0,
+	done = 0,
+	classCache = createCache(),
+	tokenCache = createCache(),
+	compilerCache = createCache(),
+	sortOrder = function( a, b ) {
+		if ( a === b ) {
+			hasDuplicate = true;
+		}
+		return 0;
+	},
+
+	// Instance methods
+	hasOwn = ({}).hasOwnProperty,
+	arr = [],
+	pop = arr.pop,
+	push_native = arr.push,
+	push = arr.push,
+	slice = arr.slice,
+	// Use a stripped-down indexOf as it's faster than native
+	// https://jsperf.com/thor-indexof-vs-for/5
+	indexOf = function( list, elem ) {
+		var i = 0,
+			len = list.length;
+		for ( ; i < len; i++ ) {
+			if ( list[i] === elem ) {
+				return i;
+			}
+		}
+		return -1;
+	},
+
+	booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",
+
+	// Regular expressions
+
+	// http://www.w3.org/TR/css3-selectors/#whitespace
+	whitespace = "[\\x20\\t\\r\\n\\f]",
+
+	// http://www.w3.org/TR/CSS21/syndata.html#value-def-identifier
+	identifier = "(?:\\\\.|[\\w-]|[^\0-\\xa0])+",
+
+	// Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors
+	attributes = "\\[" + whitespace + "*(" + identifier + ")(?:" + whitespace +
+		// Operator (capture 2)
+		"*([*^$|!~]?=)" + whitespace +
+		// "Attribute values must be CSS identifiers [capture 5] or strings [capture 3 or capture 4]"
+		"*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|(" + identifier + "))|)" + whitespace +
+		"*\\]",
+
+	pseudos = ":(" + identifier + ")(?:\\((" +
+		// To reduce the number of selectors needing tokenize in the preFilter, prefer arguments:
+		// 1. quoted (capture 3; capture 4 or capture 5)
+		"('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|" +
+		// 2. simple (capture 6)
+		"((?:\\\\.|[^\\\\()[\\]]|" + attributes + ")*)|" +
+		// 3. anything else (capture 2)
+		".*" +
+		")\\)|)",
+
+	// Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter
+	rwhitespace = new RegExp( whitespace + "+", "g" ),
+	rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + whitespace + "+$", "g" ),
+
+	rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ),
+	rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace + "*" ),
+
+	rattributeQuotes = new RegExp( "=" + whitespace + "*([^\\]'\"]*?)" + whitespace + "*\\]", "g" ),
+
+	rpseudo = new RegExp( pseudos ),
+	ridentifier = new RegExp( "^" + identifier + "$" ),
+
+	matchExpr = {
+		"ID": new RegExp( "^#(" + identifier + ")" ),
+		"CLASS": new RegExp( "^\\.(" + identifier + ")" ),
+		"TAG": new RegExp( "^(" + identifier + "|[*])" ),
+		"ATTR": new RegExp( "^" + attributes ),
+		"PSEUDO": new RegExp( "^" + pseudos ),
+		"CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" + whitespace +
+			"*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + whitespace +
+			"*(\\d+)|))" + whitespace + "*\\)|)", "i" ),
+		"bool": new RegExp( "^(?:" + booleans + ")$", "i" ),
+		// For use in libraries implementing .is()
+		// We use this for POS matching in `select`
+		"needsContext": new RegExp( "^" + whitespace + "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" +
+			whitespace + "*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" )
+	},
+
+	rinputs = /^(?:input|select|textarea|button)$/i,
+	rheader = /^h\d$/i,
+
+	rnative = /^[^{]+\{\s*\[native \w/,
+
+	// Easily-parseable/retrievable ID or TAG or CLASS selectors
+	rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,
+
+	rsibling = /[+~]/,
+
+	// CSS escapes
+	// http://www.w3.org/TR/CSS21/syndata.html#escaped-characters
+	runescape = new RegExp( "\\\\([\\da-f]{1,6}" + whitespace + "?|(" + whitespace + ")|.)", "ig" ),
+	funescape = function( _, escaped, escapedWhitespace ) {
+		var high = "0x" + escaped - 0x10000;
+		// NaN means non-codepoint
+		// Support: Firefox<24
+		// Workaround erroneous numeric interpretation of +"0x"
+		return high !== high || escapedWhitespace ?
+			escaped :
+			high < 0 ?
+				// BMP codepoint
+				String.fromCharCode( high + 0x10000 ) :
+				// Supplemental Plane codepoint (surrogate pair)
+				String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 );
+	},
+
+	// CSS string/identifier serialization
+	// https://drafts.csswg.org/cssom/#common-serializing-idioms
+	rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,
+	fcssescape = function( ch, asCodePoint ) {
+		if ( asCodePoint ) {
+
+			// U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER
+			if ( ch === "\0" ) {
+				return "\uFFFD";
+			}
+
+			// Control characters and (dependent upon position) numbers get escaped as code points
+			return ch.slice( 0, -1 ) + "\\" + ch.charCodeAt( ch.length - 1 ).toString( 16 ) + " ";
+		}
+
+		// Other potentially-special ASCII characters get backslash-escaped
+		return "\\" + ch;
+	},
+
+	// Used for iframes
+	// See setDocument()
+	// Removing the function wrapper causes a "Permission Denied"
+	// error in IE
+	unloadHandler = function() {
+		setDocument();
+	},
+
+	disabledAncestor = addCombinator(
+		function( elem ) {
+			return elem.disabled === true && ("form" in elem || "label" in elem);
+		},
+		{ dir: "parentNode", next: "legend" }
+	);
+
+// Optimize for push.apply( _, NodeList )
+try {
+	push.apply(
+		(arr = slice.call( preferredDoc.childNodes )),
+		preferredDoc.childNodes
+	);
+	// Support: Android<4.0
+	// Detect silently failing push.apply
+	arr[ preferredDoc.childNodes.length ].nodeType;
+} catch ( e ) {
+	push = { apply: arr.length ?
+
+		// Leverage slice if possible
+		function( target, els ) {
+			push_native.apply( target, slice.call(els) );
+		} :
+
+		// Support: IE<9
+		// Otherwise append directly
+		function( target, els ) {
+			var j = target.length,
+				i = 0;
+			// Can't trust NodeList.length
+			while ( (target[j++] = els[i++]) ) {}
+			target.length = j - 1;
+		}
+	};
+}
+
+function Sizzle( selector, context, results, seed ) {
+	var m, i, elem, nid, match, groups, newSelector,
+		newContext = context && context.ownerDocument,
+
+		// nodeType defaults to 9, since context defaults to document
+		nodeType = context ? context.nodeType : 9;
+
+	results = results || [];
+
+	// Return early from calls with invalid selector or context
+	if ( typeof selector !== "string" || !selector ||
+		nodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) {
+
+		return results;
+	}
+
+	// Try to shortcut find operations (as opposed to filters) in HTML documents
+	if ( !seed ) {
+
+		if ( ( context ? context.ownerDocument || context : preferredDoc ) !== document ) {
+			setDocument( context );
+		}
+		context = context || document;
+
+		if ( documentIsHTML ) {
+
+			// If the selector is sufficiently simple, try using a "get*By*" DOM method
+			// (excepting DocumentFragment context, where the methods don't exist)
+			if ( nodeType !== 11 && (match = rquickExpr.exec( selector )) ) {
+
+				// ID selector
+				if ( (m = match[1]) ) {
+
+					// Document context
+					if ( nodeType === 9 ) {
+						if ( (elem = context.getElementById( m )) ) {
+
+							// Support: IE, Opera, Webkit
+							// TODO: identify versions
+							// getElementById can match elements by name instead of ID
+							if ( elem.id === m ) {
+								results.push( elem );
+								return results;
+							}
+						} else {
+							return results;
+						}
+
+					// Element context
+					} else {
+
+						// Support: IE, Opera, Webkit
+						// TODO: identify versions
+						// getElementById can match elements by name instead of ID
+						if ( newContext && (elem = newContext.getElementById( m )) &&
+							contains( context, elem ) &&
+							elem.id === m ) {
+
+							results.push( elem );
+							return results;
+						}
+					}
+
+				// Type selector
+				} else if ( match[2] ) {
+					push.apply( results, context.getElementsByTagName( selector ) );
+					return results;
+
+				// Class selector
+				} else if ( (m = match[3]) && support.getElementsByClassName &&
+					context.getElementsByClassName ) {
+
+					push.apply( results, context.getElementsByClassName( m ) );
+					return results;
+				}
+			}
+
+			// Take advantage of querySelectorAll
+			if ( support.qsa &&
+				!compilerCache[ selector + " " ] &&
+				(!rbuggyQSA || !rbuggyQSA.test( selector )) ) {
+
+				if ( nodeType !== 1 ) {
+					newContext = context;
+					newSelector = selector;
+
+				// qSA looks outside Element context, which is not what we want
+				// Thanks to Andrew Dupont for this workaround technique
+				// Support: IE <=8
+				// Exclude object elements
+				} else if ( context.nodeName.toLowerCase() !== "object" ) {
+
+					// Capture the context ID, setting it first if necessary
+					if ( (nid = context.getAttribute( "id" )) ) {
+						nid = nid.replace( rcssescape, fcssescape );
+					} else {
+						context.setAttribute( "id", (nid = expando) );
+					}
+
+					// Prefix every selector in the list
+					groups = tokenize( selector );
+					i = groups.length;
+					while ( i-- ) {
+						groups[i] = "#" + nid + " " + toSelector( groups[i] );
+					}
+					newSelector = groups.join( "," );
+
+					// Expand context for sibling selectors
+					newContext = rsibling.test( selector ) && testContext( context.parentNode ) ||
+						context;
+				}
+
+				if ( newSelector ) {
+					try {
+						push.apply( results,
+							newContext.querySelectorAll( newSelector )
+						);
+						return results;
+					} catch ( qsaError ) {
+					} finally {
+						if ( nid === expando ) {
+							context.removeAttribute( "id" );
+						}
+					}
+				}
+			}
+		}
+	}
+
+	// All others
+	return select( selector.replace( rtrim, "$1" ), context, results, seed );
+}
+
+/**
+ * Create key-value caches of limited size
+ * @returns {function(string, object)} Returns the Object data after storing it on itself with
+ *	property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength)
+ *	deleting the oldest entry
+ */
+function createCache() {
+	var keys = [];
+
+	function cache( key, value ) {
+		// Use (key + " ") to avoid collision with native prototype properties (see Issue #157)
+		if ( keys.push( key + " " ) > Expr.cacheLength ) {
+			// Only keep the most recent entries
+			delete cache[ keys.shift() ];
+		}
+		return (cache[ key + " " ] = value);
+	}
+	return cache;
+}
+
+/**
+ * Mark a function for special use by Sizzle
+ * @param {Function} fn The function to mark
+ */
+function markFunction( fn ) {
+	fn[ expando ] = true;
+	return fn;
+}
+
+/**
+ * Support testing using an element
+ * @param {Function} fn Passed the created element and returns a boolean result
+ */
+function assert( fn ) {
+	var el = document.createElement("fieldset");
+
+	try {
+		return !!fn( el );
+	} catch (e) {
+		return false;
+	} finally {
+		// Remove from its parent by default
+		if ( el.parentNode ) {
+			el.parentNode.removeChild( el );
+		}
+		// release memory in IE
+		el = null;
+	}
+}
+
+/**
+ * Adds the same handler for all of the specified attrs
+ * @param {String} attrs Pipe-separated list of attributes
+ * @param {Function} handler The method that will be applied
+ */
+function addHandle( attrs, handler ) {
+	var arr = attrs.split("|"),
+		i = arr.length;
+
+	while ( i-- ) {
+		Expr.attrHandle[ arr[i] ] = handler;
+	}
+}
+
+/**
+ * Checks document order of two siblings
+ * @param {Element} a
+ * @param {Element} b
+ * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b
+ */
+function siblingCheck( a, b ) {
+	var cur = b && a,
+		diff = cur && a.nodeType === 1 && b.nodeType === 1 &&
+			a.sourceIndex - b.sourceIndex;
+
+	// Use IE sourceIndex if available on both nodes
+	if ( diff ) {
+		return diff;
+	}
+
+	// Check if b follows a
+	if ( cur ) {
+		while ( (cur = cur.nextSibling) ) {
+			if ( cur === b ) {
+				return -1;
+			}
+		}
+	}
+
+	return a ? 1 : -1;
+}
+
+/**
+ * Returns a function to use in pseudos for input types
+ * @param {String} type
+ */
+function createInputPseudo( type ) {
+	return function( elem ) {
+		var name = elem.nodeName.toLowerCase();
+		return name === "input" && elem.type === type;
+	};
+}
+
+/**
+ * Returns a function to use in pseudos for buttons
+ * @param {String} type
+ */
+function createButtonPseudo( type ) {
+	return function( elem ) {
+		var name = elem.nodeName.toLowerCase();
+		return (name === "input" || name === "button") && elem.type === type;
+	};
+}
+
+/**
+ * Returns a function to use in pseudos for :enabled/:disabled
+ * @param {Boolean} disabled true for :disabled; false for :enabled
+ */
+function createDisabledPseudo( disabled ) {
+
+	// Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable
+	return function( elem ) {
+
+		// Only certain elements can match :enabled or :disabled
+		// https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled
+		// https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled
+		if ( "form" in elem ) {
+
+			// Check for inherited disabledness on relevant non-disabled elements:
+			// * listed form-associated elements in a disabled fieldset
+			//   https://html.spec.whatwg.org/multipage/forms.html#category-listed
+			//   https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled
+			// * option elements in a disabled optgroup
+			//   https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled
+			// All such elements have a "form" property.
+			if ( elem.parentNode && elem.disabled === false ) {
+
+				// Option elements defer to a parent optgroup if present
+				if ( "label" in elem ) {
+					if ( "label" in elem.parentNode ) {
+						return elem.parentNode.disabled === disabled;
+					} else {
+						return elem.disabled === disabled;
+					}
+				}
+
+				// Support: IE 6 - 11
+				// Use the isDisabled shortcut property to check for disabled fieldset ancestors
+				return elem.isDisabled === disabled ||
+
+					// Where there is no isDisabled, check manually
+					/* jshint -W018 */
+					elem.isDisabled !== !disabled &&
+						disabledAncestor( elem ) === disabled;
+			}
+
+			return elem.disabled === disabled;
+
+		// Try to winnow out elements that can't be disabled before trusting the disabled property.
+		// Some victims get caught in our net (label, legend, menu, track), but it shouldn't
+		// even exist on them, let alone have a boolean value.
+		} else if ( "label" in elem ) {
+			return elem.disabled === disabled;
+		}
+
+		// Remaining elements are neither :enabled nor :disabled
+		return false;
+	};
+}
+
+/**
+ * Returns a function to use in pseudos for positionals
+ * @param {Function} fn
+ */
+function createPositionalPseudo( fn ) {
+	return markFunction(function( argument ) {
+		argument = +argument;
+		return markFunction(function( seed, matches ) {
+			var j,
+				matchIndexes = fn( [], seed.length, argument ),
+				i = matchIndexes.length;
+
+			// Match elements found at the specified indexes
+			while ( i-- ) {
+				if ( seed[ (j = matchIndexes[i]) ] ) {
+					seed[j] = !(matches[j] = seed[j]);
+				}
+			}
+		});
+	});
+}
+
+/**
+ * Checks a node for validity as a Sizzle context
+ * @param {Element|Object=} context
+ * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value
+ */
+function testContext( context ) {
+	return context && typeof context.getElementsByTagName !== "undefined" && context;
+}
+
+// Expose support vars for convenience
+support = Sizzle.support = {};
+
+/**
+ * Detects XML nodes
+ * @param {Element|Object} elem An element or a document
+ * @returns {Boolean} True iff elem is a non-HTML XML node
+ */
+isXML = Sizzle.isXML = function( elem ) {
+	// documentElement is verified for cases where it doesn't yet exist
+	// (such as loading iframes in IE - #4833)
+	var documentElement = elem && (elem.ownerDocument || elem).documentElement;
+	return documentElement ? documentElement.nodeName !== "HTML" : false;
+};
+
+/**
+ * Sets document-related variables once based on the current document
+ * @param {Element|Object} [doc] An element or document object to use to set the document
+ * @returns {Object} Returns the current document
+ */
+setDocument = Sizzle.setDocument = function( node ) {
+	var hasCompare, subWindow,
+		doc = node ? node.ownerDocument || node : preferredDoc;
+
+	// Return early if doc is invalid or already selected
+	if ( doc === document || doc.nodeType !== 9 || !doc.documentElement ) {
+		return document;
+	}
+
+	// Update global variables
+	document = doc;
+	docElem = document.documentElement;
+	documentIsHTML = !isXML( document );
+
+	// Support: IE 9-11, Edge
+	// Accessing iframe documents after unload throws "permission denied" errors (jQuery #13936)
+	if ( preferredDoc !== document &&
+		(subWindow = document.defaultView) && subWindow.top !== subWindow ) {
+
+		// Support: IE 11, Edge
+		if ( subWindow.addEventListener ) {
+			subWindow.addEventListener( "unload", unloadHandler, false );
+
+		// Support: IE 9 - 10 only
+		} else if ( subWindow.attachEvent ) {
+			subWindow.attachEvent( "onunload", unloadHandler );
+		}
+	}
+
+	/* Attributes
+	---------------------------------------------------------------------- */
+
+	// Support: IE<8
+	// Verify that getAttribute really returns attributes and not properties
+	// (excepting IE8 booleans)
+	support.attributes = assert(function( el ) {
+		el.className = "i";
+		return !el.getAttribute("className");
+	});
+
+	/* getElement(s)By*
+	---------------------------------------------------------------------- */
+
+	// Check if getElementsByTagName("*") returns only elements
+	support.getElementsByTagName = assert(function( el ) {
+		el.appendChild( document.createComment("") );
+		return !el.getElementsByTagName("*").length;
+	});
+
+	// Support: IE<9
+	support.getElementsByClassName = rnative.test( document.getElementsByClassName );
+
+	// Support: IE<10
+	// Check if getElementById returns elements by name
+	// The broken getElementById methods don't pick up programmatically-set names,
+	// so use a roundabout getElementsByName test
+	support.getById = assert(function( el ) {
+		docElem.appendChild( el ).id = expando;
+		return !document.getElementsByName || !document.getElementsByName( expando ).length;
+	});
+
+	// ID filter and find
+	if ( support.getById ) {
+		Expr.filter["ID"] = function( id ) {
+			var attrId = id.replace( runescape, funescape );
+			return function( elem ) {
+				return elem.getAttribute("id") === attrId;
+			};
+		};
+		Expr.find["ID"] = function( id, context ) {
+			if ( typeof context.getElementById !== "undefined" && documentIsHTML ) {
+				var elem = context.getElementById( id );
+				return elem ? [ elem ] : [];
+			}
+		};
+	} else {
+		Expr.filter["ID"] =  function( id ) {
+			var attrId = id.replace( runescape, funescape );
+			return function( elem ) {
+				var node = typeof elem.getAttributeNode !== "undefined" &&
+					elem.getAttributeNode("id");
+				return node && node.value === attrId;
+			};
+		};
+
+		// Support: IE 6 - 7 only
+		// getElementById is not reliable as a find shortcut
+		Expr.find["ID"] = function( id, context ) {
+			if ( typeof context.getElementById !== "undefined" && documentIsHTML ) {
+				var node, i, elems,
+					elem = context.getElementById( id );
+
+				if ( elem ) {
+
+					// Verify the id attribute
+					node = elem.getAttributeNode("id");
+					if ( node && node.value === id ) {
+						return [ elem ];
+					}
+
+					// Fall back on getElementsByName
+					elems = context.getElementsByName( id );
+					i = 0;
+					while ( (elem = elems[i++]) ) {
+						node = elem.getAttributeNode("id");
+						if ( node && node.value === id ) {
+							return [ elem ];
+						}
+					}
+				}
+
+				return [];
+			}
+		};
+	}
+
+	// Tag
+	Expr.find["TAG"] = support.getElementsByTagName ?
+		function( tag, context ) {
+			if ( typeof context.getElementsByTagName !== "undefined" ) {
+				return context.getElementsByTagName( tag );
+
+			// DocumentFragment nodes don't have gEBTN
+			} else if ( support.qsa ) {
+				return context.querySelectorAll( tag );
+			}
+		} :
+
+		function( tag, context ) {
+			var elem,
+				tmp = [],
+				i = 0,
+				// By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too
+				results = context.getElementsByTagName( tag );
+
+			// Filter out possible comments
+			if ( tag === "*" ) {
+				while ( (elem = results[i++]) ) {
+					if ( elem.nodeType === 1 ) {
+						tmp.push( elem );
+					}
+				}
+
+				return tmp;
+			}
+			return results;
+		};
+
+	// Class
+	Expr.find["CLASS"] = support.getElementsByClassName && function( className, context ) {
+		if ( typeof context.getElementsByClassName !== "undefined" && documentIsHTML ) {
+			return context.getElementsByClassName( className );
+		}
+	};
+
+	/* QSA/matchesSelector
+	---------------------------------------------------------------------- */
+
+	// QSA and matchesSelector support
+
+	// matchesSelector(:active) reports false when true (IE9/Opera 11.5)
+	rbuggyMatches = [];
+
+	// qSa(:focus) reports false when true (Chrome 21)
+	// We allow this because of a bug in IE8/9 that throws an error
+	// whenever `document.activeElement` is accessed on an iframe
+	// So, we allow :focus to pass through QSA all the time to avoid the IE error
+	// See https://bugs.jquery.com/ticket/13378
+	rbuggyQSA = [];
+
+	if ( (support.qsa = rnative.test( document.querySelectorAll )) ) {
+		// Build QSA regex
+		// Regex strategy adopted from Diego Perini
+		assert(function( el ) {
+			// Select is set to empty string on purpose
+			// This is to test IE's treatment of not explicitly
+			// setting a boolean content attribute,
+			// since its presence should be enough
+			// https://bugs.jquery.com/ticket/12359
+			docElem.appendChild( el ).innerHTML = "<a id='" + expando + "'></a>" +
+				"<select id='" + expando + "-\r\\' msallowcapture=''>" +
+				"<option selected=''></option></select>";
+
+			// Support: IE8, Opera 11-12.16
+			// Nothing should be selected when empty strings follow ^= or $= or *=
+			// The test attribute must be unknown in Opera but "safe" for WinRT
+			// https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section
+			if ( el.querySelectorAll("[msallowcapture^='']").length ) {
+				rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" );
+			}
+
+			// Support: IE8
+			// Boolean attributes and "value" are not treated correctly
+			if ( !el.querySelectorAll("[selected]").length ) {
+				rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" );
+			}
+
+			// Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+
+			if ( !el.querySelectorAll( "[id~=" + expando + "-]" ).length ) {
+				rbuggyQSA.push("~=");
+			}
+
+			// Webkit/Opera - :checked should return selected option elements
+			// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked
+			// IE8 throws error here and will not see later tests
+			if ( !el.querySelectorAll(":checked").length ) {
+				rbuggyQSA.push(":checked");
+			}
+
+			// Support: Safari 8+, iOS 8+
+			// https://bugs.webkit.org/show_bug.cgi?id=136851
+			// In-page `selector#id sibling-combinator selector` fails
+			if ( !el.querySelectorAll( "a#" + expando + "+*" ).length ) {
+				rbuggyQSA.push(".#.+[+~]");
+			}
+		});
+
+		assert(function( el ) {
+			el.innerHTML = "<a href='' disabled='disabled'></a>" +
+				"<select disabled='disabled'><option/></select>";
+
+			// Support: Windows 8 Native Apps
+			// The type and name attributes are restricted during .innerHTML assignment
+			var input = document.createElement("input");
+			input.setAttribute( "type", "hidden" );
+			el.appendChild( input ).setAttribute( "name", "D" );
+
+			// Support: IE8
+			// Enforce case-sensitivity of name attribute
+			if ( el.querySelectorAll("[name=d]").length ) {
+				rbuggyQSA.push( "name" + whitespace + "*[*^$|!~]?=" );
+			}
+
+			// FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled)
+			// IE8 throws error here and will not see later tests
+			if ( el.querySelectorAll(":enabled").length !== 2 ) {
+				rbuggyQSA.push( ":enabled", ":disabled" );
+			}
+
+			// Support: IE9-11+
+			// IE's :disabled selector does not pick up the children of disabled fieldsets
+			docElem.appendChild( el ).disabled = true;
+			if ( el.querySelectorAll(":disabled").length !== 2 ) {
+				rbuggyQSA.push( ":enabled", ":disabled" );
+			}
+
+			// Opera 10-11 does not throw on post-comma invalid pseudos
+			el.querySelectorAll("*,:x");
+			rbuggyQSA.push(",.*:");
+		});
+	}
+
+	if ( (support.matchesSelector = rnative.test( (matches = docElem.matches ||
+		docElem.webkitMatchesSelector ||
+		docElem.mozMatchesSelector ||
+		docElem.oMatchesSelector ||
+		docElem.msMatchesSelector) )) ) {
+
+		assert(function( el ) {
+			// Check to see if it's possible to do matchesSelector
+			// on a disconnected node (IE 9)
+			support.disconnectedMatch = matches.call( el, "*" );
+
+			// This should fail with an exception
+			// Gecko does not error, returns false instead
+			matches.call( el, "[s!='']:x" );
+			rbuggyMatches.push( "!=", pseudos );
+		});
+	}
+
+	rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join("|") );
+	rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join("|") );
+
+	/* Contains
+	---------------------------------------------------------------------- */
+	hasCompare = rnative.test( docElem.compareDocumentPosition );
+
+	// Element contains another
+	// Purposefully self-exclusive
+	// As in, an element does not contain itself
+	contains = hasCompare || rnative.test( docElem.contains ) ?
+		function( a, b ) {
+			var adown = a.nodeType === 9 ? a.documentElement : a,
+				bup = b && b.parentNode;
+			return a === bup || !!( bup && bup.nodeType === 1 && (
+				adown.contains ?
+					adown.contains( bup ) :
+					a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16
+			));
+		} :
+		function( a, b ) {
+			if ( b ) {
+				while ( (b = b.parentNode) ) {
+					if ( b === a ) {
+						return true;
+					}
+				}
+			}
+			return false;
+		};
+
+	/* Sorting
+	---------------------------------------------------------------------- */
+
+	// Document order sorting
+	sortOrder = hasCompare ?
+	function( a, b ) {
+
+		// Flag for duplicate removal
+		if ( a === b ) {
+			hasDuplicate = true;
+			return 0;
+		}
+
+		// Sort on method existence if only one input has compareDocumentPosition
+		var compare = !a.compareDocumentPosition - !b.compareDocumentPosition;
+		if ( compare ) {
+			return compare;
+		}
+
+		// Calculate position if both inputs belong to the same document
+		compare = ( a.ownerDocument || a ) === ( b.ownerDocument || b ) ?
+			a.compareDocumentPosition( b ) :
+
+			// Otherwise we know they are disconnected
+			1;
+
+		// Disconnected nodes
+		if ( compare & 1 ||
+			(!support.sortDetached && b.compareDocumentPosition( a ) === compare) ) {
+
+			// Choose the first element that is related to our preferred document
+			if ( a === document || a.ownerDocument === preferredDoc && contains(preferredDoc, a) ) {
+				return -1;
+			}
+			if ( b === document || b.ownerDocument === preferredDoc && contains(preferredDoc, b) ) {
+				return 1;
+			}
+
+			// Maintain original order
+			return sortInput ?
+				( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) :
+				0;
+		}
+
+		return compare & 4 ? -1 : 1;
+	} :
+	function( a, b ) {
+		// Exit early if the nodes are identical
+		if ( a === b ) {
+			hasDuplicate = true;
+			return 0;
+		}
+
+		var cur,
+			i = 0,
+			aup = a.parentNode,
+			bup = b.parentNode,
+			ap = [ a ],
+			bp = [ b ];
+
+		// Parentless nodes are either documents or disconnected
+		if ( !aup || !bup ) {
+			return a === document ? -1 :
+				b === document ? 1 :
+				aup ? -1 :
+				bup ? 1 :
+				sortInput ?
+				( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) :
+				0;
+
+		// If the nodes are siblings, we can do a quick check
+		} else if ( aup === bup ) {
+			return siblingCheck( a, b );
+		}
+
+		// Otherwise we need full lists of their ancestors for comparison
+		cur = a;
+		while ( (cur = cur.parentNode) ) {
+			ap.unshift( cur );
+		}
+		cur = b;
+		while ( (cur = cur.parentNode) ) {
+			bp.unshift( cur );
+		}
+
+		// Walk down the tree looking for a discrepancy
+		while ( ap[i] === bp[i] ) {
+			i++;
+		}
+
+		return i ?
+			// Do a sibling check if the nodes have a common ancestor
+			siblingCheck( ap[i], bp[i] ) :
+
+			// Otherwise nodes in our document sort first
+			ap[i] === preferredDoc ? -1 :
+			bp[i] === preferredDoc ? 1 :
+			0;
+	};
+
+	return document;
+};
+
+Sizzle.matches = function( expr, elements ) {
+	return Sizzle( expr, null, null, elements );
+};
+
+Sizzle.matchesSelector = function( elem, expr ) {
+	// Set document vars if needed
+	if ( ( elem.ownerDocument || elem ) !== document ) {
+		setDocument( elem );
+	}
+
+	// Make sure that attribute selectors are quoted
+	expr = expr.replace( rattributeQuotes, "='$1']" );
+
+	if ( support.matchesSelector && documentIsHTML &&
+		!compilerCache[ expr + " " ] &&
+		( !rbuggyMatches || !rbuggyMatches.test( expr ) ) &&
+		( !rbuggyQSA     || !rbuggyQSA.test( expr ) ) ) {
+
+		try {
+			var ret = matches.call( elem, expr );
+
+			// IE 9's matchesSelector returns false on disconnected nodes
+			if ( ret || support.disconnectedMatch ||
+					// As well, disconnected nodes are said to be in a document
+					// fragment in IE 9
+					elem.document && elem.document.nodeType !== 11 ) {
+				return ret;
+			}
+		} catch (e) {}
+	}
+
+	return Sizzle( expr, document, null, [ elem ] ).length > 0;
+};
+
+Sizzle.contains = function( context, elem ) {
+	// Set document vars if needed
+	if ( ( context.ownerDocument || context ) !== document ) {
+		setDocument( context );
+	}
+	return contains( context, elem );
+};
+
+Sizzle.attr = function( elem, name ) {
+	// Set document vars if needed
+	if ( ( elem.ownerDocument || elem ) !== document ) {
+		setDocument( elem );
+	}
+
+	var fn = Expr.attrHandle[ name.toLowerCase() ],
+		// Don't get fooled by Object.prototype properties (jQuery #13807)
+		val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ?
+			fn( elem, name, !documentIsHTML ) :
+			undefined;
+
+	return val !== undefined ?
+		val :
+		support.attributes || !documentIsHTML ?
+			elem.getAttribute( name ) :
+			(val = elem.getAttributeNode(name)) && val.specified ?
+				val.value :
+				null;
+};
+
+Sizzle.escape = function( sel ) {
+	return (sel + "").replace( rcssescape, fcssescape );
+};
+
+Sizzle.error = function( msg ) {
+	throw new Error( "Syntax error, unrecognized expression: " + msg );
+};
+
+/**
+ * Document sorting and removing duplicates
+ * @param {ArrayLike} results
+ */
+Sizzle.uniqueSort = function( results ) {
+	var elem,
+		duplicates = [],
+		j = 0,
+		i = 0;
+
+	// Unless we *know* we can detect duplicates, assume their presence
+	hasDuplicate = !support.detectDuplicates;
+	sortInput = !support.sortStable && results.slice( 0 );
+	results.sort( sortOrder );
+
+	if ( hasDuplicate ) {
+		while ( (elem = results[i++]) ) {
+			if ( elem === results[ i ] ) {
+				j = duplicates.push( i );
+			}
+		}
+		while ( j-- ) {
+			results.splice( duplicates[ j ], 1 );
+		}
+	}
+
+	// Clear input after sorting to release objects
+	// See https://github.com/jquery/sizzle/pull/225
+	sortInput = null;
+
+	return results;
+};
+
+/**
+ * Utility function for retrieving the text value of an array of DOM nodes
+ * @param {Array|Element} elem
+ */
+getText = Sizzle.getText = function( elem ) {
+	var node,
+		ret = "",
+		i = 0,
+		nodeType = elem.nodeType;
+
+	if ( !nodeType ) {
+		// If no nodeType, this is expected to be an array
+		while ( (node = elem[i++]) ) {
+			// Do not traverse comment nodes
+			ret += getText( node );
+		}
+	} else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) {
+		// Use textContent for elements
+		// innerText usage removed for consistency of new lines (jQuery #11153)
+		if ( typeof elem.textContent === "string" ) {
+			return elem.textContent;
+		} else {
+			// Traverse its children
+			for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) {
+				ret += getText( elem );
+			}
+		}
+	} else if ( nodeType === 3 || nodeType === 4 ) {
+		return elem.nodeValue;
+	}
+	// Do not include comment or processing instruction nodes
+
+	return ret;
+};
+
+Expr = Sizzle.selectors = {
+
+	// Can be adjusted by the user
+	cacheLength: 50,
+
+	createPseudo: markFunction,
+
+	match: matchExpr,
+
+	attrHandle: {},
+
+	find: {},
+
+	relative: {
+		">": { dir: "parentNode", first: true },
+		" ": { dir: "parentNode" },
+		"+": { dir: "previousSibling", first: true },
+		"~": { dir: "previousSibling" }
+	},
+
+	preFilter: {
+		"ATTR": function( match ) {
+			match[1] = match[1].replace( runescape, funescape );
+
+			// Move the given value to match[3] whether quoted or unquoted
+			match[3] = ( match[3] || match[4] || match[5] || "" ).replace( runescape, funescape );
+
+			if ( match[2] === "~=" ) {
+				match[3] = " " + match[3] + " ";
+			}
+
+			return match.slice( 0, 4 );
+		},
+
+		"CHILD": function( match ) {
+			/* matches from matchExpr["CHILD"]
+				1 type (only|nth|...)
+				2 what (child|of-type)
+				3 argument (even|odd|\d*|\d*n([+-]\d+)?|...)
+				4 xn-component of xn+y argument ([+-]?\d*n|)
+				5 sign of xn-component
+				6 x of xn-component
+				7 sign of y-component
+				8 y of y-component
+			*/
+			match[1] = match[1].toLowerCase();
+
+			if ( match[1].slice( 0, 3 ) === "nth" ) {
+				// nth-* requires argument
+				if ( !match[3] ) {
+					Sizzle.error( match[0] );
+				}
+
+				// numeric x and y parameters for Expr.filter.CHILD
+				// remember that false/true cast respectively to 0/1
+				match[4] = +( match[4] ? match[5] + (match[6] || 1) : 2 * ( match[3] === "even" || match[3] === "odd" ) );
+				match[5] = +( ( match[7] + match[8] ) || match[3] === "odd" );
+
+			// other types prohibit arguments
+			} else if ( match[3] ) {
+				Sizzle.error( match[0] );
+			}
+
+			return match;
+		},
+
+		"PSEUDO": function( match ) {
+			var excess,
+				unquoted = !match[6] && match[2];
+
+			if ( matchExpr["CHILD"].test( match[0] ) ) {
+				return null;
+			}
+
+			// Accept quoted arguments as-is
+			if ( match[3] ) {
+				match[2] = match[4] || match[5] || "";
+
+			// Strip excess characters from unquoted arguments
+			} else if ( unquoted && rpseudo.test( unquoted ) &&
+				// Get excess from tokenize (recursively)
+				(excess = tokenize( unquoted, true )) &&
+				// advance to the next closing parenthesis
+				(excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length) ) {
+
+				// excess is a negative index
+				match[0] = match[0].slice( 0, excess );
+				match[2] = unquoted.slice( 0, excess );
+			}
+
+			// Return only captures needed by the pseudo filter method (type and argument)
+			return match.slice( 0, 3 );
+		}
+	},
+
+	filter: {
+
+		"TAG": function( nodeNameSelector ) {
+			var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase();
+			return nodeNameSelector === "*" ?
+				function() { return true; } :
+				function( elem ) {
+					return elem.nodeName && elem.nodeName.toLowerCase() === nodeName;
+				};
+		},
+
+		"CLASS": function( className ) {
+			var pattern = classCache[ className + " " ];
+
+			return pattern ||
+				(pattern = new RegExp( "(^|" + whitespace + ")" + className + "(" + whitespace + "|$)" )) &&
+				classCache( className, function( elem ) {
+					return pattern.test( typeof elem.className === "string" && elem.className || typeof elem.getAttribute !== "undefined" && elem.getAttribute("class") || "" );
+				});
+		},
+
+		"ATTR": function( name, operator, check ) {
+			return function( elem ) {
+				var result = Sizzle.attr( elem, name );
+
+				if ( result == null ) {
+					return operator === "!=";
+				}
+				if ( !operator ) {
+					return true;
+				}
+
+				result += "";
+
+				return operator === "=" ? result === check :
+					operator === "!=" ? result !== check :
+					operator === "^=" ? check && result.indexOf( check ) === 0 :
+					operator === "*=" ? check && result.indexOf( check ) > -1 :
+					operator === "$=" ? check && result.slice( -check.length ) === check :
+					operator === "~=" ? ( " " + result.replace( rwhitespace, " " ) + " " ).indexOf( check ) > -1 :
+					operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" :
+					false;
+			};
+		},
+
+		"CHILD": function( type, what, argument, first, last ) {
+			var simple = type.slice( 0, 3 ) !== "nth",
+				forward = type.slice( -4 ) !== "last",
+				ofType = what === "of-type";
+
+			return first === 1 && last === 0 ?
+
+				// Shortcut for :nth-*(n)
+				function( elem ) {
+					return !!elem.parentNode;
+				} :
+
+				function( elem, context, xml ) {
+					var cache, uniqueCache, outerCache, node, nodeIndex, start,
+						dir = simple !== forward ? "nextSibling" : "previousSibling",
+						parent = elem.parentNode,
+						name = ofType && elem.nodeName.toLowerCase(),
+						useCache = !xml && !ofType,
+						diff = false;
+
+					if ( parent ) {
+
+						// :(first|last|only)-(child|of-type)
+						if ( simple ) {
+							while ( dir ) {
+								node = elem;
+								while ( (node = node[ dir ]) ) {
+									if ( ofType ?
+										node.nodeName.toLowerCase() === name :
+										node.nodeType === 1 ) {
+
+										return false;
+									}
+								}
+								// Reverse direction for :only-* (if we haven't yet done so)
+								start = dir = type === "only" && !start && "nextSibling";
+							}
+							return true;
+						}
+
+						start = [ forward ? parent.firstChild : parent.lastChild ];
+
+						// non-xml :nth-child(...) stores cache data on `parent`
+						if ( forward && useCache ) {
+
+							// Seek `elem` from a previously-cached index
+
+							// ...in a gzip-friendly way
+							node = parent;
+							outerCache = node[ expando ] || (node[ expando ] = {});
+
+							// Support: IE <9 only
+							// Defend against cloned attroperties (jQuery gh-1709)
+							uniqueCache = outerCache[ node.uniqueID ] ||
+								(outerCache[ node.uniqueID ] = {});
+
+							cache = uniqueCache[ type ] || [];
+							nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ];
+							diff = nodeIndex && cache[ 2 ];
+							node = nodeIndex && parent.childNodes[ nodeIndex ];
+
+							while ( (node = ++nodeIndex && node && node[ dir ] ||
+
+								// Fallback to seeking `elem` from the start
+								(diff = nodeIndex = 0) || start.pop()) ) {
+
+								// When found, cache indexes on `parent` and break
+								if ( node.nodeType === 1 && ++diff && node === elem ) {
+									uniqueCache[ type ] = [ dirruns, nodeIndex, diff ];
+									break;
+								}
+							}
+
+						} else {
+							// Use previously-cached element index if available
+							if ( useCache ) {
+								// ...in a gzip-friendly way
+								node = elem;
+								outerCache = node[ expando ] || (node[ expando ] = {});
+
+								// Support: IE <9 only
+								// Defend against cloned attroperties (jQuery gh-1709)
+								uniqueCache = outerCache[ node.uniqueID ] ||
+									(outerCache[ node.uniqueID ] = {});
+
+								cache = uniqueCache[ type ] || [];
+								nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ];
+								diff = nodeIndex;
+							}
+
+							// xml :nth-child(...)
+							// or :nth-last-child(...) or :nth(-last)?-of-type(...)
+							if ( diff === false ) {
+								// Use the same loop as above to seek `elem` from the start
+								while ( (node = ++nodeIndex && node && node[ dir ] ||
+									(diff = nodeIndex = 0) || start.pop()) ) {
+
+									if ( ( ofType ?
+										node.nodeName.toLowerCase() === name :
+										node.nodeType === 1 ) &&
+										++diff ) {
+
+										// Cache the index of each encountered element
+										if ( useCache ) {
+											outerCache = node[ expando ] || (node[ expando ] = {});
+
+											// Support: IE <9 only
+											// Defend against cloned attroperties (jQuery gh-1709)
+											uniqueCache = outerCache[ node.uniqueID ] ||
+												(outerCache[ node.uniqueID ] = {});
+
+											uniqueCache[ type ] = [ dirruns, diff ];
+										}
+
+										if ( node === elem ) {
+											break;
+										}
+									}
+								}
+							}
+						}
+
+						// Incorporate the offset, then check against cycle size
+						diff -= last;
+						return diff === first || ( diff % first === 0 && diff / first >= 0 );
+					}
+				};
+		},
+
+		"PSEUDO": function( pseudo, argument ) {
+			// pseudo-class names are case-insensitive
+			// http://www.w3.org/TR/selectors/#pseudo-classes
+			// Prioritize by case sensitivity in case custom pseudos are added with uppercase letters
+			// Remember that setFilters inherits from pseudos
+			var args,
+				fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] ||
+					Sizzle.error( "unsupported pseudo: " + pseudo );
+
+			// The user may use createPseudo to indicate that
+			// arguments are needed to create the filter function
+			// just as Sizzle does
+			if ( fn[ expando ] ) {
+				return fn( argument );
+			}
+
+			// But maintain support for old signatures
+			if ( fn.length > 1 ) {
+				args = [ pseudo, pseudo, "", argument ];
+				return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ?
+					markFunction(function( seed, matches ) {
+						var idx,
+							matched = fn( seed, argument ),
+							i = matched.length;
+						while ( i-- ) {
+							idx = indexOf( seed, matched[i] );
+							seed[ idx ] = !( matches[ idx ] = matched[i] );
+						}
+					}) :
+					function( elem ) {
+						return fn( elem, 0, args );
+					};
+			}
+
+			return fn;
+		}
+	},
+
+	pseudos: {
+		// Potentially complex pseudos
+		"not": markFunction(function( selector ) {
+			// Trim the selector passed to compile
+			// to avoid treating leading and trailing
+			// spaces as combinators
+			var input = [],
+				results = [],
+				matcher = compile( selector.replace( rtrim, "$1" ) );
+
+			return matcher[ expando ] ?
+				markFunction(function( seed, matches, context, xml ) {
+					var elem,
+						unmatched = matcher( seed, null, xml, [] ),
+						i = seed.length;
+
+					// Match elements unmatched by `matcher`
+					while ( i-- ) {
+						if ( (elem = unmatched[i]) ) {
+							seed[i] = !(matches[i] = elem);
+						}
+					}
+				}) :
+				function( elem, context, xml ) {
+					input[0] = elem;
+					matcher( input, null, xml, results );
+					// Don't keep the element (issue #299)
+					input[0] = null;
+					return !results.pop();
+				};
+		}),
+
+		"has": markFunction(function( selector ) {
+			return function( elem ) {
+				return Sizzle( selector, elem ).length > 0;
+			};
+		}),
+
+		"contains": markFunction(function( text ) {
+			text = text.replace( runescape, funescape );
+			return function( elem ) {
+				return ( elem.textContent || elem.innerText || getText( elem ) ).indexOf( text ) > -1;
+			};
+		}),
+
+		// "Whether an element is represented by a :lang() selector
+		// is based solely on the element's language value
+		// being equal to the identifier C,
+		// or beginning with the identifier C immediately followed by "-".
+		// The matching of C against the element's language value is performed case-insensitively.
+		// The identifier C does not have to be a valid language name."
+		// http://www.w3.org/TR/selectors/#lang-pseudo
+		"lang": markFunction( function( lang ) {
+			// lang value must be a valid identifier
+			if ( !ridentifier.test(lang || "") ) {
+				Sizzle.error( "unsupported lang: " + lang );
+			}
+			lang = lang.replace( runescape, funescape ).toLowerCase();
+			return function( elem ) {
+				var elemLang;
+				do {
+					if ( (elemLang = documentIsHTML ?
+						elem.lang :
+						elem.getAttribute("xml:lang") || elem.getAttribute("lang")) ) {
+
+						elemLang = elemLang.toLowerCase();
+						return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0;
+					}
+				} while ( (elem = elem.parentNode) && elem.nodeType === 1 );
+				return false;
+			};
+		}),
+
+		// Miscellaneous
+		"target": function( elem ) {
+			var hash = window.location && window.location.hash;
+			return hash && hash.slice( 1 ) === elem.id;
+		},
+
+		"root": function( elem ) {
+			return elem === docElem;
+		},
+
+		"focus": function( elem ) {
+			return elem === document.activeElement && (!document.hasFocus || document.hasFocus()) && !!(elem.type || elem.href || ~elem.tabIndex);
+		},
+
+		// Boolean properties
+		"enabled": createDisabledPseudo( false ),
+		"disabled": createDisabledPseudo( true ),
+
+		"checked": function( elem ) {
+			// In CSS3, :checked should return both checked and selected elements
+			// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked
+			var nodeName = elem.nodeName.toLowerCase();
+			return (nodeName === "input" && !!elem.checked) || (nodeName === "option" && !!elem.selected);
+		},
+
+		"selected": function( elem ) {
+			// Accessing this property makes selected-by-default
+			// options in Safari work properly
+			if ( elem.parentNode ) {
+				elem.parentNode.selectedIndex;
+			}
+
+			return elem.selected === true;
+		},
+
+		// Contents
+		"empty": function( elem ) {
+			// http://www.w3.org/TR/selectors/#empty-pseudo
+			// :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5),
+			//   but not by others (comment: 8; processing instruction: 7; etc.)
+			// nodeType < 6 works because attributes (2) do not appear as children
+			for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) {
+				if ( elem.nodeType < 6 ) {
+					return false;
+				}
+			}
+			return true;
+		},
+
+		"parent": function( elem ) {
+			return !Expr.pseudos["empty"]( elem );
+		},
+
+		// Element/input types
+		"header": function( elem ) {
+			return rheader.test( elem.nodeName );
+		},
+
+		"input": function( elem ) {
+			return rinputs.test( elem.nodeName );
+		},
+
+		"button": function( elem ) {
+			var name = elem.nodeName.toLowerCase();
+			return name === "input" && elem.type === "button" || name === "button";
+		},
+
+		"text": function( elem ) {
+			var attr;
+			return elem.nodeName.toLowerCase() === "input" &&
+				elem.type === "text" &&
+
+				// Support: IE<8
+				// New HTML5 attribute values (e.g., "search") appear with elem.type === "text"
+				( (attr = elem.getAttribute("type")) == null || attr.toLowerCase() === "text" );
+		},
+
+		// Position-in-collection
+		"first": createPositionalPseudo(function() {
+			return [ 0 ];
+		}),
+
+		"last": createPositionalPseudo(function( matchIndexes, length ) {
+			return [ length - 1 ];
+		}),
+
+		"eq": createPositionalPseudo(function( matchIndexes, length, argument ) {
+			return [ argument < 0 ? argument + length : argument ];
+		}),
+
+		"even": createPositionalPseudo(function( matchIndexes, length ) {
+			var i = 0;
+			for ( ; i < length; i += 2 ) {
+				matchIndexes.push( i );
+			}
+			return matchIndexes;
+		}),
+
+		"odd": createPositionalPseudo(function( matchIndexes, length ) {
+			var i = 1;
+			for ( ; i < length; i += 2 ) {
+				matchIndexes.push( i );
+			}
+			return matchIndexes;
+		}),
+
+		"lt": createPositionalPseudo(function( matchIndexes, length, argument ) {
+			var i = argument < 0 ? argument + length : argument;
+			for ( ; --i >= 0; ) {
+				matchIndexes.push( i );
+			}
+			return matchIndexes;
+		}),
+
+		"gt": createPositionalPseudo(function( matchIndexes, length, argument ) {
+			var i = argument < 0 ? argument + length : argument;
+			for ( ; ++i < length; ) {
+				matchIndexes.push( i );
+			}
+			return matchIndexes;
+		})
+	}
+};
+
+Expr.pseudos["nth"] = Expr.pseudos["eq"];
+
+// Add button/input type pseudos
+for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) {
+	Expr.pseudos[ i ] = createInputPseudo( i );
+}
+for ( i in { submit: true, reset: true } ) {
+	Expr.pseudos[ i ] = createButtonPseudo( i );
+}
+
+// Easy API for creating new setFilters
+function setFilters() {}
+setFilters.prototype = Expr.filters = Expr.pseudos;
+Expr.setFilters = new setFilters();
+
+tokenize = Sizzle.tokenize = function( selector, parseOnly ) {
+	var matched, match, tokens, type,
+		soFar, groups, preFilters,
+		cached = tokenCache[ selector + " " ];
+
+	if ( cached ) {
+		return parseOnly ? 0 : cached.slice( 0 );
+	}
+
+	soFar = selector;
+	groups = [];
+	preFilters = Expr.preFilter;
+
+	while ( soFar ) {
+
+		// Comma and first run
+		if ( !matched || (match = rcomma.exec( soFar )) ) {
+			if ( match ) {
+				// Don't consume trailing commas as valid
+				soFar = soFar.slice( match[0].length ) || soFar;
+			}
+			groups.push( (tokens = []) );
+		}
+
+		matched = false;
+
+		// Combinators
+		if ( (match = rcombinators.exec( soFar )) ) {
+			matched = match.shift();
+			tokens.push({
+				value: matched,
+				// Cast descendant combinators to space
+				type: match[0].replace( rtrim, " " )
+			});
+			soFar = soFar.slice( matched.length );
+		}
+
+		// Filters
+		for ( type in Expr.filter ) {
+			if ( (match = matchExpr[ type ].exec( soFar )) && (!preFilters[ type ] ||
+				(match = preFilters[ type ]( match ))) ) {
+				matched = match.shift();
+				tokens.push({
+					value: matched,
+					type: type,
+					matches: match
+				});
+				soFar = soFar.slice( matched.length );
+			}
+		}
+
+		if ( !matched ) {
+			break;
+		}
+	}
+
+	// Return the length of the invalid excess
+	// if we're just parsing
+	// Otherwise, throw an error or return tokens
+	return parseOnly ?
+		soFar.length :
+		soFar ?
+			Sizzle.error( selector ) :
+			// Cache the tokens
+			tokenCache( selector, groups ).slice( 0 );
+};
+
+function toSelector( tokens ) {
+	var i = 0,
+		len = tokens.length,
+		selector = "";
+	for ( ; i < len; i++ ) {
+		selector += tokens[i].value;
+	}
+	return selector;
+}
+
+function addCombinator( matcher, combinator, base ) {
+	var dir = combinator.dir,
+		skip = combinator.next,
+		key = skip || dir,
+		checkNonElements = base && key === "parentNode",
+		doneName = done++;
+
+	return combinator.first ?
+		// Check against closest ancestor/preceding element
+		function( elem, context, xml ) {
+			while ( (elem = elem[ dir ]) ) {
+				if ( elem.nodeType === 1 || checkNonElements ) {
+					return matcher( elem, context, xml );
+				}
+			}
+			return false;
+		} :
+
+		// Check against all ancestor/preceding elements
+		function( elem, context, xml ) {
+			var oldCache, uniqueCache, outerCache,
+				newCache = [ dirruns, doneName ];
+
+			// We can't set arbitrary data on XML nodes, so they don't benefit from combinator caching
+			if ( xml ) {
+				while ( (elem = elem[ dir ]) ) {
+					if ( elem.nodeType === 1 || checkNonElements ) {
+						if ( matcher( elem, context, xml ) ) {
+							return true;
+						}
+					}
+				}
+			} else {
+				while ( (elem = elem[ dir ]) ) {
+					if ( elem.nodeType === 1 || checkNonElements ) {
+						outerCache = elem[ expando ] || (elem[ expando ] = {});
+
+						// Support: IE <9 only
+						// Defend against cloned attroperties (jQuery gh-1709)
+						uniqueCache = outerCache[ elem.uniqueID ] || (outerCache[ elem.uniqueID ] = {});
+
+						if ( skip && skip === elem.nodeName.toLowerCase() ) {
+							elem = elem[ dir ] || elem;
+						} else if ( (oldCache = uniqueCache[ key ]) &&
+							oldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) {
+
+							// Assign to newCache so results back-propagate to previous elements
+							return (newCache[ 2 ] = oldCache[ 2 ]);
+						} else {
+							// Reuse newcache so results back-propagate to previous elements
+							uniqueCache[ key ] = newCache;
+
+							// A match means we're done; a fail means we have to keep checking
+							if ( (newCache[ 2 ] = matcher( elem, context, xml )) ) {
+								return true;
+							}
+						}
+					}
+				}
+			}
+			return false;
+		};
+}
+
+function elementMatcher( matchers ) {
+	return matchers.length > 1 ?
+		function( elem, context, xml ) {
+			var i = matchers.length;
+			while ( i-- ) {
+				if ( !matchers[i]( elem, context, xml ) ) {
+					return false;
+				}
+			}
+			return true;
+		} :
+		matchers[0];
+}
+
+function multipleContexts( selector, contexts, results ) {
+	var i = 0,
+		len = contexts.length;
+	for ( ; i < len; i++ ) {
+		Sizzle( selector, contexts[i], results );
+	}
+	return results;
+}
+
+function condense( unmatched, map, filter, context, xml ) {
+	var elem,
+		newUnmatched = [],
+		i = 0,
+		len = unmatched.length,
+		mapped = map != null;
+
+	for ( ; i < len; i++ ) {
+		if ( (elem = unmatched[i]) ) {
+			if ( !filter || filter( elem, context, xml ) ) {
+				newUnmatched.push( elem );
+				if ( mapped ) {
+					map.push( i );
+				}
+			}
+		}
+	}
+
+	return newUnmatched;
+}
+
+function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) {
+	if ( postFilter && !postFilter[ expando ] ) {
+		postFilter = setMatcher( postFilter );
+	}
+	if ( postFinder && !postFinder[ expando ] ) {
+		postFinder = setMatcher( postFinder, postSelector );
+	}
+	return markFunction(function( seed, results, context, xml ) {
+		var temp, i, elem,
+			preMap = [],
+			postMap = [],
+			preexisting = results.length,
+
+			// Get initial elements from seed or context
+			elems = seed || multipleContexts( selector || "*", context.nodeType ? [ context ] : context, [] ),
+
+			// Prefilter to get matcher input, preserving a map for seed-results synchronization
+			matcherIn = preFilter && ( seed || !selector ) ?
+				condense( elems, preMap, preFilter, context, xml ) :
+				elems,
+
+			matcherOut = matcher ?
+				// If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results,
+				postFinder || ( seed ? preFilter : preexisting || postFilter ) ?
+
+					// ...intermediate processing is necessary
+					[] :
+
+					// ...otherwise use results directly
+					results :
+				matcherIn;
+
+		// Find primary matches
+		if ( matcher ) {
+			matcher( matcherIn, matcherOut, context, xml );
+		}
+
+		// Apply postFilter
+		if ( postFilter ) {
+			temp = condense( matcherOut, postMap );
+			postFilter( temp, [], context, xml );
+
+			// Un-match failing elements by moving them back to matcherIn
+			i = temp.length;
+			while ( i-- ) {
+				if ( (elem = temp[i]) ) {
+					matcherOut[ postMap[i] ] = !(matcherIn[ postMap[i] ] = elem);
+				}
+			}
+		}
+
+		if ( seed ) {
+			if ( postFinder || preFilter ) {
+				if ( postFinder ) {
+					// Get the final matcherOut by condensing this intermediate into postFinder contexts
+					temp = [];
+					i = matcherOut.length;
+					while ( i-- ) {
+						if ( (elem = matcherOut[i]) ) {
+							// Restore matcherIn since elem is not yet a final match
+							temp.push( (matcherIn[i] = elem) );
+						}
+					}
+					postFinder( null, (matcherOut = []), temp, xml );
+				}
+
+				// Move matched elements from seed to results to keep them synchronized
+				i = matcherOut.length;
+				while ( i-- ) {
+					if ( (elem = matcherOut[i]) &&
+						(temp = postFinder ? indexOf( seed, elem ) : preMap[i]) > -1 ) {
+
+						seed[temp] = !(results[temp] = elem);
+					}
+				}
+			}
+
+		// Add elements to results, through postFinder if defined
+		} else {
+			matcherOut = condense(
+				matcherOut === results ?
+					matcherOut.splice( preexisting, matcherOut.length ) :
+					matcherOut
+			);
+			if ( postFinder ) {
+				postFinder( null, results, matcherOut, xml );
+			} else {
+				push.apply( results, matcherOut );
+			}
+		}
+	});
+}
+
+function matcherFromTokens( tokens ) {
+	var checkContext, matcher, j,
+		len = tokens.length,
+		leadingRelative = Expr.relative[ tokens[0].type ],
+		implicitRelative = leadingRelative || Expr.relative[" "],
+		i = leadingRelative ? 1 : 0,
+
+		// The foundational matcher ensures that elements are reachable from top-level context(s)
+		matchContext = addCombinator( function( elem ) {
+			return elem === checkContext;
+		}, implicitRelative, true ),
+		matchAnyContext = addCombinator( function( elem ) {
+			return indexOf( checkContext, elem ) > -1;
+		}, implicitRelative, true ),
+		matchers = [ function( elem, context, xml ) {
+			var ret = ( !leadingRelative && ( xml || context !== outermostContext ) ) || (
+				(checkContext = context).nodeType ?
+					matchContext( elem, context, xml ) :
+					matchAnyContext( elem, context, xml ) );
+			// Avoid hanging onto element (issue #299)
+			checkContext = null;
+			return ret;
+		} ];
+
+	for ( ; i < len; i++ ) {
+		if ( (matcher = Expr.relative[ tokens[i].type ]) ) {
+			matchers = [ addCombinator(elementMatcher( matchers ), matcher) ];
+		} else {
+			matcher = Expr.filter[ tokens[i].type ].apply( null, tokens[i].matches );
+
+			// Return special upon seeing a positional matcher
+			if ( matcher[ expando ] ) {
+				// Find the next relative operator (if any) for proper handling
+				j = ++i;
+				for ( ; j < len; j++ ) {
+					if ( Expr.relative[ tokens[j].type ] ) {
+						break;
+					}
+				}
+				return setMatcher(
+					i > 1 && elementMatcher( matchers ),
+					i > 1 && toSelector(
+						// If the preceding token was a descendant combinator, insert an implicit any-element `*`
+						tokens.slice( 0, i - 1 ).concat({ value: tokens[ i - 2 ].type === " " ? "*" : "" })
+					).replace( rtrim, "$1" ),
+					matcher,
+					i < j && matcherFromTokens( tokens.slice( i, j ) ),
+					j < len && matcherFromTokens( (tokens = tokens.slice( j )) ),
+					j < len && toSelector( tokens )
+				);
+			}
+			matchers.push( matcher );
+		}
+	}
+
+	return elementMatcher( matchers );
+}
+
+function matcherFromGroupMatchers( elementMatchers, setMatchers ) {
+	var bySet = setMatchers.length > 0,
+		byElement = elementMatchers.length > 0,
+		superMatcher = function( seed, context, xml, results, outermost ) {
+			var elem, j, matcher,
+				matchedCount = 0,
+				i = "0",
+				unmatched = seed && [],
+				setMatched = [],
+				contextBackup = outermostContext,
+				// We must always have either seed elements or outermost context
+				elems = seed || byElement && Expr.find["TAG"]( "*", outermost ),
+				// Use integer dirruns iff this is the outermost matcher
+				dirrunsUnique = (dirruns += contextBackup == null ? 1 : Math.random() || 0.1),
+				len = elems.length;
+
+			if ( outermost ) {
+				outermostContext = context === document || context || outermost;
+			}
+
+			// Add elements passing elementMatchers directly to results
+			// Support: IE<9, Safari
+			// Tolerate NodeList properties (IE: "length"; Safari: <number>) matching elements by id
+			for ( ; i !== len && (elem = elems[i]) != null; i++ ) {
+				if ( byElement && elem ) {
+					j = 0;
+					if ( !context && elem.ownerDocument !== document ) {
+						setDocument( elem );
+						xml = !documentIsHTML;
+					}
+					while ( (matcher = elementMatchers[j++]) ) {
+						if ( matcher( elem, context || document, xml) ) {
+							results.push( elem );
+							break;
+						}
+					}
+					if ( outermost ) {
+						dirruns = dirrunsUnique;
+					}
+				}
+
+				// Track unmatched elements for set filters
+				if ( bySet ) {
+					// They will have gone through all possible matchers
+					if ( (elem = !matcher && elem) ) {
+						matchedCount--;
+					}
+
+					// Lengthen the array for every element, matched or not
+					if ( seed ) {
+						unmatched.push( elem );
+					}
+				}
+			}
+
+			// `i` is now the count of elements visited above, and adding it to `matchedCount`
+			// makes the latter nonnegative.
+			matchedCount += i;
+
+			// Apply set filters to unmatched elements
+			// NOTE: This can be skipped if there are no unmatched elements (i.e., `matchedCount`
+			// equals `i`), unless we didn't visit _any_ elements in the above loop because we have
+			// no element matchers and no seed.
+			// Incrementing an initially-string "0" `i` allows `i` to remain a string only in that
+			// case, which will result in a "00" `matchedCount` that differs from `i` but is also
+			// numerically zero.
+			if ( bySet && i !== matchedCount ) {
+				j = 0;
+				while ( (matcher = setMatchers[j++]) ) {
+					matcher( unmatched, setMatched, context, xml );
+				}
+
+				if ( seed ) {
+					// Reintegrate element matches to eliminate the need for sorting
+					if ( matchedCount > 0 ) {
+						while ( i-- ) {
+							if ( !(unmatched[i] || setMatched[i]) ) {
+								setMatched[i] = pop.call( results );
+							}
+						}
+					}
+
+					// Discard index placeholder values to get only actual matches
+					setMatched = condense( setMatched );
+				}
+
+				// Add matches to results
+				push.apply( results, setMatched );
+
+				// Seedless set matches succeeding multiple successful matchers stipulate sorting
+				if ( outermost && !seed && setMatched.length > 0 &&
+					( matchedCount + setMatchers.length ) > 1 ) {
+
+					Sizzle.uniqueSort( results );
+				}
+			}
+
+			// Override manipulation of globals by nested matchers
+			if ( outermost ) {
+				dirruns = dirrunsUnique;
+				outermostContext = contextBackup;
+			}
+
+			return unmatched;
+		};
+
+	return bySet ?
+		markFunction( superMatcher ) :
+		superMatcher;
+}
+
+compile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) {
+	var i,
+		setMatchers = [],
+		elementMatchers = [],
+		cached = compilerCache[ selector + " " ];
+
+	if ( !cached ) {
+		// Generate a function of recursive functions that can be used to check each element
+		if ( !match ) {
+			match = tokenize( selector );
+		}
+		i = match.length;
+		while ( i-- ) {
+			cached = matcherFromTokens( match[i] );
+			if ( cached[ expando ] ) {
+				setMatchers.push( cached );
+			} else {
+				elementMatchers.push( cached );
+			}
+		}
+
+		// Cache the compiled function
+		cached = compilerCache( selector, matcherFromGroupMatchers( elementMatchers, setMatchers ) );
+
+		// Save selector and tokenization
+		cached.selector = selector;
+	}
+	return cached;
+};
+
+/**
+ * A low-level selection function that works with Sizzle's compiled
+ *  selector functions
+ * @param {String|Function} selector A selector or a pre-compiled
+ *  selector function built with Sizzle.compile
+ * @param {Element} context
+ * @param {Array} [results]
+ * @param {Array} [seed] A set of elements to match against
+ */
+select = Sizzle.select = function( selector, context, results, seed ) {
+	var i, tokens, token, type, find,
+		compiled = typeof selector === "function" && selector,
+		match = !seed && tokenize( (selector = compiled.selector || selector) );
+
+	results = results || [];
+
+	// Try to minimize operations if there is only one selector in the list and no seed
+	// (the latter of which guarantees us context)
+	if ( match.length === 1 ) {
+
+		// Reduce context if the leading compound selector is an ID
+		tokens = match[0] = match[0].slice( 0 );
+		if ( tokens.length > 2 && (token = tokens[0]).type === "ID" &&
+				context.nodeType === 9 && documentIsHTML && Expr.relative[ tokens[1].type ] ) {
+
+			context = ( Expr.find["ID"]( token.matches[0].replace(runescape, funescape), context ) || [] )[0];
+			if ( !context ) {
+				return results;
+
+			// Precompiled matchers will still verify ancestry, so step up a level
+			} else if ( compiled ) {
+				context = context.parentNode;
+			}
+
+			selector = selector.slice( tokens.shift().value.length );
+		}
+
+		// Fetch a seed set for right-to-left matching
+		i = matchExpr["needsContext"].test( selector ) ? 0 : tokens.length;
+		while ( i-- ) {
+			token = tokens[i];
+
+			// Abort if we hit a combinator
+			if ( Expr.relative[ (type = token.type) ] ) {
+				break;
+			}
+			if ( (find = Expr.find[ type ]) ) {
+				// Search, expanding context for leading sibling combinators
+				if ( (seed = find(
+					token.matches[0].replace( runescape, funescape ),
+					rsibling.test( tokens[0].type ) && testContext( context.parentNode ) || context
+				)) ) {
+
+					// If seed is empty or no tokens remain, we can return early
+					tokens.splice( i, 1 );
+					selector = seed.length && toSelector( tokens );
+					if ( !selector ) {
+						push.apply( results, seed );
+						return results;
+					}
+
+					break;
+				}
+			}
+		}
+	}
+
+	// Compile and execute a filtering function if one is not provided
+	// Provide `match` to avoid retokenization if we modified the selector above
+	( compiled || compile( selector, match ) )(
+		seed,
+		context,
+		!documentIsHTML,
+		results,
+		!context || rsibling.test( selector ) && testContext( context.parentNode ) || context
+	);
+	return results;
+};
+
+// One-time assignments
+
+// Sort stability
+support.sortStable = expando.split("").sort( sortOrder ).join("") === expando;
+
+// Support: Chrome 14-35+
+// Always assume duplicates if they aren't passed to the comparison function
+support.detectDuplicates = !!hasDuplicate;
+
+// Initialize against the default document
+setDocument();
+
+// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27)
+// Detached nodes confoundingly follow *each other*
+support.sortDetached = assert(function( el ) {
+	// Should return 1, but returns 4 (following)
+	return el.compareDocumentPosition( document.createElement("fieldset") ) & 1;
+});
+
+// Support: IE<8
+// Prevent attribute/property "interpolation"
+// https://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx
+if ( !assert(function( el ) {
+	el.innerHTML = "<a href='#'></a>";
+	return el.firstChild.getAttribute("href") === "#" ;
+}) ) {
+	addHandle( "type|href|height|width", function( elem, name, isXML ) {
+		if ( !isXML ) {
+			return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 );
+		}
+	});
+}
+
+// Support: IE<9
+// Use defaultValue in place of getAttribute("value")
+if ( !support.attributes || !assert(function( el ) {
+	el.innerHTML = "<input/>";
+	el.firstChild.setAttribute( "value", "" );
+	return el.firstChild.getAttribute( "value" ) === "";
+}) ) {
+	addHandle( "value", function( elem, name, isXML ) {
+		if ( !isXML && elem.nodeName.toLowerCase() === "input" ) {
+			return elem.defaultValue;
+		}
+	});
+}
+
+// Support: IE<9
+// Use getAttributeNode to fetch booleans when getAttribute lies
+if ( !assert(function( el ) {
+	return el.getAttribute("disabled") == null;
+}) ) {
+	addHandle( booleans, function( elem, name, isXML ) {
+		var val;
+		if ( !isXML ) {
+			return elem[ name ] === true ? name.toLowerCase() :
+					(val = elem.getAttributeNode( name )) && val.specified ?
+					val.value :
+				null;
+		}
+	});
+}
+
+return Sizzle;
+
+})( window );
+
+
+
+jQuery.find = Sizzle;
+jQuery.expr = Sizzle.selectors;
+
+// Deprecated
+jQuery.expr[ ":" ] = jQuery.expr.pseudos;
+jQuery.uniqueSort = jQuery.unique = Sizzle.uniqueSort;
+jQuery.text = Sizzle.getText;
+jQuery.isXMLDoc = Sizzle.isXML;
+jQuery.contains = Sizzle.contains;
+jQuery.escapeSelector = Sizzle.escape;
+
+
+
+
+var dir = function( elem, dir, until ) {
+	var matched = [],
+		truncate = until !== undefined;
+
+	while ( ( elem = elem[ dir ] ) && elem.nodeType !== 9 ) {
+		if ( elem.nodeType === 1 ) {
+			if ( truncate && jQuery( elem ).is( until ) ) {
+				break;
+			}
+			matched.push( elem );
+		}
+	}
+	return matched;
+};
+
+
+var siblings = function( n, elem ) {
+	var matched = [];
+
+	for ( ; n; n = n.nextSibling ) {
+		if ( n.nodeType === 1 && n !== elem ) {
+			matched.push( n );
+		}
+	}
+
+	return matched;
+};
+
+
+var rneedsContext = jQuery.expr.match.needsContext;
+
+
+
+function nodeName( elem, name ) {
+
+  return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase();
+
+};
+var rsingleTag = ( /^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i );
+
+
+
+// Implement the identical functionality for filter and not
+function winnow( elements, qualifier, not ) {
+	if ( isFunction( qualifier ) ) {
+		return jQuery.grep( elements, function( elem, i ) {
+			return !!qualifier.call( elem, i, elem ) !== not;
+		} );
+	}
+
+	// Single element
+	if ( qualifier.nodeType ) {
+		return jQuery.grep( elements, function( elem ) {
+			return ( elem === qualifier ) !== not;
+		} );
+	}
+
+	// Arraylike of elements (jQuery, arguments, Array)
+	if ( typeof qualifier !== "string" ) {
+		return jQuery.grep( elements, function( elem ) {
+			return ( indexOf.call( qualifier, elem ) > -1 ) !== not;
+		} );
+	}
+
+	// Filtered directly for both simple and complex selectors
+	return jQuery.filter( qualifier, elements, not );
+}
+
+jQuery.filter = function( expr, elems, not ) {
+	var elem = elems[ 0 ];
+
+	if ( not ) {
+		expr = ":not(" + expr + ")";
+	}
+
+	if ( elems.length === 1 && elem.nodeType === 1 ) {
+		return jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : [];
+	}
+
+	return jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) {
+		return elem.nodeType === 1;
+	} ) );
+};
+
+jQuery.fn.extend( {
+	find: function( selector ) {
+		var i, ret,
+			len = this.length,
+			self = this;
+
+		if ( typeof selector !== "string" ) {
+			return this.pushStack( jQuery( selector ).filter( function() {
+				for ( i = 0; i < len; i++ ) {
+					if ( jQuery.contains( self[ i ], this ) ) {
+						return true;
+					}
+				}
+			} ) );
+		}
+
+		ret = this.pushStack( [] );
+
+		for ( i = 0; i < len; i++ ) {
+			jQuery.find( selector, self[ i ], ret );
+		}
+
+		return len > 1 ? jQuery.uniqueSort( ret ) : ret;
+	},
+	filter: function( selector ) {
+		return this.pushStack( winnow( this, selector || [], false ) );
+	},
+	not: function( selector ) {
+		return this.pushStack( winnow( this, selector || [], true ) );
+	},
+	is: function( selector ) {
+		return !!winnow(
+			this,
+
+			// If this is a positional/relative selector, check membership in the returned set
+			// so $("p:first").is("p:last") won't return true for a doc with two "p".
+			typeof selector === "string" && rneedsContext.test( selector ) ?
+				jQuery( selector ) :
+				selector || [],
+			false
+		).length;
+	}
+} );
+
+
+// Initialize a jQuery object
+
+
+// A central reference to the root jQuery(document)
+var rootjQuery,
+
+	// A simple way to check for HTML strings
+	// Prioritize #id over <tag> to avoid XSS via location.hash (#9521)
+	// Strict HTML recognition (#11290: must start with <)
+	// Shortcut simple #id case for speed
+	rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/,
+
+	init = jQuery.fn.init = function( selector, context, root ) {
+		var match, elem;
+
+		// HANDLE: $(""), $(null), $(undefined), $(false)
+		if ( !selector ) {
+			return this;
+		}
+
+		// Method init() accepts an alternate rootjQuery
+		// so migrate can support jQuery.sub (gh-2101)
+		root = root || rootjQuery;
+
+		// Handle HTML strings
+		if ( typeof selector === "string" ) {
+			if ( selector[ 0 ] === "<" &&
+				selector[ selector.length - 1 ] === ">" &&
+				selector.length >= 3 ) {
+
+				// Assume that strings that start and end with <> are HTML and skip the regex check
+				match = [ null, selector, null ];
+
+			} else {
+				match = rquickExpr.exec( selector );
+			}
+
+			// Match html or make sure no context is specified for #id
+			if ( match && ( match[ 1 ] || !context ) ) {
+
+				// HANDLE: $(html) -> $(array)
+				if ( match[ 1 ] ) {
+					context = context instanceof jQuery ? context[ 0 ] : context;
+
+					// Option to run scripts is true for back-compat
+					// Intentionally let the error be thrown if parseHTML is not present
+					jQuery.merge( this, jQuery.parseHTML(
+						match[ 1 ],
+						context && context.nodeType ? context.ownerDocument || context : document,
+						true
+					) );
+
+					// HANDLE: $(html, props)
+					if ( rsingleTag.test( match[ 1 ] ) && jQuery.isPlainObject( context ) ) {
+						for ( match in context ) {
+
+							// Properties of context are called as methods if possible
+							if ( isFunction( this[ match ] ) ) {
+								this[ match ]( context[ match ] );
+
+							// ...and otherwise set as attributes
+							} else {
+								this.attr( match, context[ match ] );
+							}
+						}
+					}
+
+					return this;
+
+				// HANDLE: $(#id)
+				} else {
+					elem = document.getElementById( match[ 2 ] );
+
+					if ( elem ) {
+
+						// Inject the element directly into the jQuery object
+						this[ 0 ] = elem;
+						this.length = 1;
+					}
+					return this;
+				}
+
+			// HANDLE: $(expr, $(...))
+			} else if ( !context || context.jquery ) {
+				return ( context || root ).find( selector );
+
+			// HANDLE: $(expr, context)
+			// (which is just equivalent to: $(context).find(expr)
+			} else {
+				return this.constructor( context ).find( selector );
+			}
+
+		// HANDLE: $(DOMElement)
+		} else if ( selector.nodeType ) {
+			this[ 0 ] = selector;
+			this.length = 1;
+			return this;
+
+		// HANDLE: $(function)
+		// Shortcut for document ready
+		} else if ( isFunction( selector ) ) {
+			return root.ready !== undefined ?
+				root.ready( selector ) :
+
+				// Execute immediately if ready is not present
+				selector( jQuery );
+		}
+
+		return jQuery.makeArray( selector, this );
+	};
+
+// Give the init function the jQuery prototype for later instantiation
+init.prototype = jQuery.fn;
+
+// Initialize central reference
+rootjQuery = jQuery( document );
+
+
+var rparentsprev = /^(?:parents|prev(?:Until|All))/,
+
+	// Methods guaranteed to produce a unique set when starting from a unique set
+	guaranteedUnique = {
+		children: true,
+		contents: true,
+		next: true,
+		prev: true
+	};
+
+jQuery.fn.extend( {
+	has: function( target ) {
+		var targets = jQuery( target, this ),
+			l = targets.length;
+
+		return this.filter( function() {
+			var i = 0;
+			for ( ; i < l; i++ ) {
+				if ( jQuery.contains( this, targets[ i ] ) ) {
+					return true;
+				}
+			}
+		} );
+	},
+
+	closest: function( selectors, context ) {
+		var cur,
+			i = 0,
+			l = this.length,
+			matched = [],
+			targets = typeof selectors !== "string" && jQuery( selectors );
+
+		// Positional selectors never match, since there's no _selection_ context
+		if ( !rneedsContext.test( selectors ) ) {
+			for ( ; i < l; i++ ) {
+				for ( cur = this[ i ]; cur && cur !== context; cur = cur.parentNode ) {
+
+					// Always skip document fragments
+					if ( cur.nodeType < 11 && ( targets ?
+						targets.index( cur ) > -1 :
+
+						// Don't pass non-elements to Sizzle
+						cur.nodeType === 1 &&
+							jQuery.find.matchesSelector( cur, selectors ) ) ) {
+
+						matched.push( cur );
+						break;
+					}
+				}
+			}
+		}
+
+		return this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched );
+	},
+
+	// Determine the position of an element within the set
+	index: function( elem ) {
+
+		// No argument, return index in parent
+		if ( !elem ) {
+			return ( this[ 0 ] && this[ 0 ].parentNode ) ? this.first().prevAll().length : -1;
+		}
+
+		// Index in selector
+		if ( typeof elem === "string" ) {
+			return indexOf.call( jQuery( elem ), this[ 0 ] );
+		}
+
+		// Locate the position of the desired element
+		return indexOf.call( this,
+
+			// If it receives a jQuery object, the first element is used
+			elem.jquery ? elem[ 0 ] : elem
+		);
+	},
+
+	add: function( selector, context ) {
+		return this.pushStack(
+			jQuery.uniqueSort(
+				jQuery.merge( this.get(), jQuery( selector, context ) )
+			)
+		);
+	},
+
+	addBack: function( selector ) {
+		return this.add( selector == null ?
+			this.prevObject : this.prevObject.filter( selector )
+		);
+	}
+} );
+
+function sibling( cur, dir ) {
+	while ( ( cur = cur[ dir ] ) && cur.nodeType !== 1 ) {}
+	return cur;
+}
+
+jQuery.each( {
+	parent: function( elem ) {
+		var parent = elem.parentNode;
+		return parent && parent.nodeType !== 11 ? parent : null;
+	},
+	parents: function( elem ) {
+		return dir( elem, "parentNode" );
+	},
+	parentsUntil: function( elem, i, until ) {
+		return dir( elem, "parentNode", until );
+	},
+	next: function( elem ) {
+		return sibling( elem, "nextSibling" );
+	},
+	prev: function( elem ) {
+		return sibling( elem, "previousSibling" );
+	},
+	nextAll: function( elem ) {
+		return dir( elem, "nextSibling" );
+	},
+	prevAll: function( elem ) {
+		return dir( elem, "previousSibling" );
+	},
+	nextUntil: function( elem, i, until ) {
+		return dir( elem, "nextSibling", until );
+	},
+	prevUntil: function( elem, i, until ) {
+		return dir( elem, "previousSibling", until );
+	},
+	siblings: function( elem ) {
+		return siblings( ( elem.parentNode || {} ).firstChild, elem );
+	},
+	children: function( elem ) {
+		return siblings( elem.firstChild );
+	},
+	contents: function( elem ) {
+        if ( nodeName( elem, "iframe" ) ) {
+            return elem.contentDocument;
+        }
+
+        // Support: IE 9 - 11 only, iOS 7 only, Android Browser <=4.3 only
+        // Treat the template element as a regular one in browsers that
+        // don't support it.
+        if ( nodeName( elem, "template" ) ) {
+            elem = elem.content || elem;
+        }
+
+        return jQuery.merge( [], elem.childNodes );
+	}
+}, function( name, fn ) {
+	jQuery.fn[ name ] = function( until, selector ) {
+		var matched = jQuery.map( this, fn, until );
+
+		if ( name.slice( -5 ) !== "Until" ) {
+			selector = until;
+		}
+
+		if ( selector && typeof selector === "string" ) {
+			matched = jQuery.filter( selector, matched );
+		}
+
+		if ( this.length > 1 ) {
+
+			// Remove duplicates
+			if ( !guaranteedUnique[ name ] ) {
+				jQuery.uniqueSort( matched );
+			}
+
+			// Reverse order for parents* and prev-derivatives
+			if ( rparentsprev.test( name ) ) {
+				matched.reverse();
+			}
+		}
+
+		return this.pushStack( matched );
+	};
+} );
+var rnothtmlwhite = ( /[^\x20\t\r\n\f]+/g );
+
+
+
+// Convert String-formatted options into Object-formatted ones
+function createOptions( options ) {
+	var object = {};
+	jQuery.each( options.match( rnothtmlwhite ) || [], function( _, flag ) {
+		object[ flag ] = true;
+	} );
+	return object;
+}
+
+/*
+ * Create a callback list using the following parameters:
+ *
+ *	options: an optional list of space-separated options that will change how
+ *			the callback list behaves or a more traditional option object
+ *
+ * By default a callback list will act like an event callback list and can be
+ * "fired" multiple times.
+ *
+ * Possible options:
+ *
+ *	once:			will ensure the callback list can only be fired once (like a Deferred)
+ *
+ *	memory:			will keep track of previous values and will call any callback added
+ *					after the list has been fired right away with the latest "memorized"
+ *					values (like a Deferred)
+ *
+ *	unique:			will ensure a callback can only be added once (no duplicate in the list)
+ *
+ *	stopOnFalse:	interrupt callings when a callback returns false
+ *
+ */
+jQuery.Callbacks = function( options ) {
+
+	// Convert options from String-formatted to Object-formatted if needed
+	// (we check in cache first)
+	options = typeof options === "string" ?
+		createOptions( options ) :
+		jQuery.extend( {}, options );
+
+	var // Flag to know if list is currently firing
+		firing,
+
+		// Last fire value for non-forgettable lists
+		memory,
+
+		// Flag to know if list was already fired
+		fired,
+
+		// Flag to prevent firing
+		locked,
+
+		// Actual callback list
+		list = [],
+
+		// Queue of execution data for repeatable lists
+		queue = [],
+
+		// Index of currently firing callback (modified by add/remove as needed)
+		firingIndex = -1,
+
+		// Fire callbacks
+		fire = function() {
+
+			// Enforce single-firing
+			locked = locked || options.once;
+
+			// Execute callbacks for all pending executions,
+			// respecting firingIndex overrides and runtime changes
+			fired = firing = true;
+			for ( ; queue.length; firingIndex = -1 ) {
+				memory = queue.shift();
+				while ( ++firingIndex < list.length ) {
+
+					// Run callback and check for early termination
+					if ( list[ firingIndex ].apply( memory[ 0 ], memory[ 1 ] ) === false &&
+						options.stopOnFalse ) {
+
+						// Jump to end and forget the data so .add doesn't re-fire
+						firingIndex = list.length;
+						memory = false;
+					}
+				}
+			}
+
+			// Forget the data if we're done with it
+			if ( !options.memory ) {
+				memory = false;
+			}
+
+			firing = false;
+
+			// Clean up if we're done firing for good
+			if ( locked ) {
+
+				// Keep an empty list if we have data for future add calls
+				if ( memory ) {
+					list = [];
+
+				// Otherwise, this object is spent
+				} else {
+					list = "";
+				}
+			}
+		},
+
+		// Actual Callbacks object
+		self = {
+
+			// Add a callback or a collection of callbacks to the list
+			add: function() {
+				if ( list ) {
+
+					// If we have memory from a past run, we should fire after adding
+					if ( memory && !firing ) {
+						firingIndex = list.length - 1;
+						queue.push( memory );
+					}
+
+					( function add( args ) {
+						jQuery.each( args, function( _, arg ) {
+							if ( isFunction( arg ) ) {
+								if ( !options.unique || !self.has( arg ) ) {
+									list.push( arg );
+								}
+							} else if ( arg && arg.length && toType( arg ) !== "string" ) {
+
+								// Inspect recursively
+								add( arg );
+							}
+						} );
+					} )( arguments );
+
+					if ( memory && !firing ) {
+						fire();
+					}
+				}
+				return this;
+			},
+
+			// Remove a callback from the list
+			remove: function() {
+				jQuery.each( arguments, function( _, arg ) {
+					var index;
+					while ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) {
+						list.splice( index, 1 );
+
+						// Handle firing indexes
+						if ( index <= firingIndex ) {
+							firingIndex--;
+						}
+					}
+				} );
+				return this;
+			},
+
+			// Check if a given callback is in the list.
+			// If no argument is given, return whether or not list has callbacks attached.
+			has: function( fn ) {
+				return fn ?
+					jQuery.inArray( fn, list ) > -1 :
+					list.length > 0;
+			},
+
+			// Remove all callbacks from the list
+			empty: function() {
+				if ( list ) {
+					list = [];
+				}
+				return this;
+			},
+
+			// Disable .fire and .add
+			// Abort any current/pending executions
+			// Clear all callbacks and values
+			disable: function() {
+				locked = queue = [];
+				list = memory = "";
+				return this;
+			},
+			disabled: function() {
+				return !list;
+			},
+
+			// Disable .fire
+			// Also disable .add unless we have memory (since it would have no effect)
+			// Abort any pending executions
+			lock: function() {
+				locked = queue = [];
+				if ( !memory && !firing ) {
+					list = memory = "";
+				}
+				return this;
+			},
+			locked: function() {
+				return !!locked;
+			},
+
+			// Call all callbacks with the given context and arguments
+			fireWith: function( context, args ) {
+				if ( !locked ) {
+					args = args || [];
+					args = [ context, args.slice ? args.slice() : args ];
+					queue.push( args );
+					if ( !firing ) {
+						fire();
+					}
+				}
+				return this;
+			},
+
+			// Call all the callbacks with the given arguments
+			fire: function() {
+				self.fireWith( this, arguments );
+				return this;
+			},
+
+			// To know if the callbacks have already been called at least once
+			fired: function() {
+				return !!fired;
+			}
+		};
+
+	return self;
+};
+
+
+function Identity( v ) {
+	return v;
+}
+function Thrower( ex ) {
+	throw ex;
+}
+
+function adoptValue( value, resolve, reject, noValue ) {
+	var method;
+
+	try {
+
+		// Check for promise aspect first to privilege synchronous behavior
+		if ( value && isFunction( ( method = value.promise ) ) ) {
+			method.call( value ).done( resolve ).fail( reject );
+
+		// Other thenables
+		} else if ( value && isFunction( ( method = value.then ) ) ) {
+			method.call( value, resolve, reject );
+
+		// Other non-thenables
+		} else {
+
+			// Control `resolve` arguments by letting Array#slice cast boolean `noValue` to integer:
+			// * false: [ value ].slice( 0 ) => resolve( value )
+			// * true: [ value ].slice( 1 ) => resolve()
+			resolve.apply( undefined, [ value ].slice( noValue ) );
+		}
+
+	// For Promises/A+, convert exceptions into rejections
+	// Since jQuery.when doesn't unwrap thenables, we can skip the extra checks appearing in
+	// Deferred#then to conditionally suppress rejection.
+	} catch ( value ) {
+
+		// Support: Android 4.0 only
+		// Strict mode functions invoked without .call/.apply get global-object context
+		reject.apply( undefined, [ value ] );
+	}
+}
+
+jQuery.extend( {
+
+	Deferred: function( func ) {
+		var tuples = [
+
+				// action, add listener, callbacks,
+				// ... .then handlers, argument index, [final state]
+				[ "notify", "progress", jQuery.Callbacks( "memory" ),
+					jQuery.Callbacks( "memory" ), 2 ],
+				[ "resolve", "done", jQuery.Callbacks( "once memory" ),
+					jQuery.Callbacks( "once memory" ), 0, "resolved" ],
+				[ "reject", "fail", jQuery.Callbacks( "once memory" ),
+					jQuery.Callbacks( "once memory" ), 1, "rejected" ]
+			],
+			state = "pending",
+			promise = {
+				state: function() {
+					return state;
+				},
+				always: function() {
+					deferred.done( arguments ).fail( arguments );
+					return this;
+				},
+				"catch": function( fn ) {
+					return promise.then( null, fn );
+				},
+
+				// Keep pipe for back-compat
+				pipe: function( /* fnDone, fnFail, fnProgress */ ) {
+					var fns = arguments;
+
+					return jQuery.Deferred( function( newDefer ) {
+						jQuery.each( tuples, function( i, tuple ) {
+
+							// Map tuples (progress, done, fail) to arguments (done, fail, progress)
+							var fn = isFunction( fns[ tuple[ 4 ] ] ) && fns[ tuple[ 4 ] ];
+
+							// deferred.progress(function() { bind to newDefer or newDefer.notify })
+							// deferred.done(function() { bind to newDefer or newDefer.resolve })
+							// deferred.fail(function() { bind to newDefer or newDefer.reject })
+							deferred[ tuple[ 1 ] ]( function() {
+								var returned = fn && fn.apply( this, arguments );
+								if ( returned && isFunction( returned.promise ) ) {
+									returned.promise()
+										.progress( newDefer.notify )
+										.done( newDefer.resolve )
+										.fail( newDefer.reject );
+								} else {
+									newDefer[ tuple[ 0 ] + "With" ](
+										this,
+										fn ? [ returned ] : arguments
+									);
+								}
+							} );
+						} );
+						fns = null;
+					} ).promise();
+				},
+				then: function( onFulfilled, onRejected, onProgress ) {
+					var maxDepth = 0;
+					function resolve( depth, deferred, handler, special ) {
+						return function() {
+							var that = this,
+								args = arguments,
+								mightThrow = function() {
+									var returned, then;
+
+									// Support: Promises/A+ section 2.3.3.3.3
+									// https://promisesaplus.com/#point-59
+									// Ignore double-resolution attempts
+									if ( depth < maxDepth ) {
+										return;
+									}
+
+									returned = handler.apply( that, args );
+
+									// Support: Promises/A+ section 2.3.1
+									// https://promisesaplus.com/#point-48
+									if ( returned === deferred.promise() ) {
+										throw new TypeError( "Thenable self-resolution" );
+									}
+
+									// Support: Promises/A+ sections 2.3.3.1, 3.5
+									// https://promisesaplus.com/#point-54
+									// https://promisesaplus.com/#point-75
+									// Retrieve `then` only once
+									then = returned &&
+
+										// Support: Promises/A+ section 2.3.4
+										// https://promisesaplus.com/#point-64
+										// Only check objects and functions for thenability
+										( typeof returned === "object" ||
+											typeof returned === "function" ) &&
+										returned.then;
+
+									// Handle a returned thenable
+									if ( isFunction( then ) ) {
+
+										// Special processors (notify) just wait for resolution
+										if ( special ) {
+											then.call(
+												returned,
+												resolve( maxDepth, deferred, Identity, special ),
+												resolve( maxDepth, deferred, Thrower, special )
+											);
+
+										// Normal processors (resolve) also hook into progress
+										} else {
+
+											// ...and disregard older resolution values
+											maxDepth++;
+
+											then.call(
+												returned,
+												resolve( maxDepth, deferred, Identity, special ),
+												resolve( maxDepth, deferred, Thrower, special ),
+												resolve( maxDepth, deferred, Identity,
+													deferred.notifyWith )
+											);
+										}
+
+									// Handle all other returned values
+									} else {
+
+										// Only substitute handlers pass on context
+										// and multiple values (non-spec behavior)
+										if ( handler !== Identity ) {
+											that = undefined;
+											args = [ returned ];
+										}
+
+										// Process the value(s)
+										// Default process is resolve
+										( special || deferred.resolveWith )( that, args );
+									}
+								},
+
+								// Only normal processors (resolve) catch and reject exceptions
+								process = special ?
+									mightThrow :
+									function() {
+										try {
+											mightThrow();
+										} catch ( e ) {
+
+											if ( jQuery.Deferred.exceptionHook ) {
+												jQuery.Deferred.exceptionHook( e,
+													process.stackTrace );
+											}
+
+											// Support: Promises/A+ section 2.3.3.3.4.1
+											// https://promisesaplus.com/#point-61
+											// Ignore post-resolution exceptions
+											if ( depth + 1 >= maxDepth ) {
+
+												// Only substitute handlers pass on context
+												// and multiple values (non-spec behavior)
+												if ( handler !== Thrower ) {
+													that = undefined;
+													args = [ e ];
+												}
+
+												deferred.rejectWith( that, args );
+											}
+										}
+									};
+
+							// Support: Promises/A+ section 2.3.3.3.1
+							// https://promisesaplus.com/#point-57
+							// Re-resolve promises immediately to dodge false rejection from
+							// subsequent errors
+							if ( depth ) {
+								process();
+							} else {
+
+								// Call an optional hook to record the stack, in case of exception
+								// since it's otherwise lost when execution goes async
+								if ( jQuery.Deferred.getStackHook ) {
+									process.stackTrace = jQuery.Deferred.getStackHook();
+								}
+								window.setTimeout( process );
+							}
+						};
+					}
+
+					return jQuery.Deferred( function( newDefer ) {
+
+						// progress_handlers.add( ... )
+						tuples[ 0 ][ 3 ].add(
+							resolve(
+								0,
+								newDefer,
+								isFunction( onProgress ) ?
+									onProgress :
+									Identity,
+								newDefer.notifyWith
+							)
+						);
+
+						// fulfilled_handlers.add( ... )
+						tuples[ 1 ][ 3 ].add(
+							resolve(
+								0,
+								newDefer,
+								isFunction( onFulfilled ) ?
+									onFulfilled :
+									Identity
+							)
+						);
+
+						// rejected_handlers.add( ... )
+						tuples[ 2 ][ 3 ].add(
+							resolve(
+								0,
+								newDefer,
+								isFunction( onRejected ) ?
+									onRejected :
+									Thrower
+							)
+						);
+					} ).promise();
+				},
+
+				// Get a promise for this deferred
+				// If obj is provided, the promise aspect is added to the object
+				promise: function( obj ) {
+					return obj != null ? jQuery.extend( obj, promise ) : promise;
+				}
+			},
+			deferred = {};
+
+		// Add list-specific methods
+		jQuery.each( tuples, function( i, tuple ) {
+			var list = tuple[ 2 ],
+				stateString = tuple[ 5 ];
+
+			// promise.progress = list.add
+			// promise.done = list.add
+			// promise.fail = list.add
+			promise[ tuple[ 1 ] ] = list.add;
+
+			// Handle state
+			if ( stateString ) {
+				list.add(
+					function() {
+
+						// state = "resolved" (i.e., fulfilled)
+						// state = "rejected"
+						state = stateString;
+					},
+
+					// rejected_callbacks.disable
+					// fulfilled_callbacks.disable
+					tuples[ 3 - i ][ 2 ].disable,
+
+					// rejected_handlers.disable
+					// fulfilled_handlers.disable
+					tuples[ 3 - i ][ 3 ].disable,
+
+					// progress_callbacks.lock
+					tuples[ 0 ][ 2 ].lock,
+
+					// progress_handlers.lock
+					tuples[ 0 ][ 3 ].lock
+				);
+			}
+
+			// progress_handlers.fire
+			// fulfilled_handlers.fire
+			// rejected_handlers.fire
+			list.add( tuple[ 3 ].fire );
+
+			// deferred.notify = function() { deferred.notifyWith(...) }
+			// deferred.resolve = function() { deferred.resolveWith(...) }
+			// deferred.reject = function() { deferred.rejectWith(...) }
+			deferred[ tuple[ 0 ] ] = function() {
+				deferred[ tuple[ 0 ] + "With" ]( this === deferred ? undefined : this, arguments );
+				return this;
+			};
+
+			// deferred.notifyWith = list.fireWith
+			// deferred.resolveWith = list.fireWith
+			// deferred.rejectWith = list.fireWith
+			deferred[ tuple[ 0 ] + "With" ] = list.fireWith;
+		} );
+
+		// Make the deferred a promise
+		promise.promise( deferred );
+
+		// Call given func if any
+		if ( func ) {
+			func.call( deferred, deferred );
+		}
+
+		// All done!
+		return deferred;
+	},
+
+	// Deferred helper
+	when: function( singleValue ) {
+		var
+
+			// count of uncompleted subordinates
+			remaining = arguments.length,
+
+			// count of unprocessed arguments
+			i = remaining,
+
+			// subordinate fulfillment data
+			resolveContexts = Array( i ),
+			resolveValues = slice.call( arguments ),
+
+			// the master Deferred
+			master = jQuery.Deferred(),
+
+			// subordinate callback factory
+			updateFunc = function( i ) {
+				return function( value ) {
+					resolveContexts[ i ] = this;
+					resolveValues[ i ] = arguments.length > 1 ? slice.call( arguments ) : value;
+					if ( !( --remaining ) ) {
+						master.resolveWith( resolveContexts, resolveValues );
+					}
+				};
+			};
+
+		// Single- and empty arguments are adopted like Promise.resolve
+		if ( remaining <= 1 ) {
+			adoptValue( singleValue, master.done( updateFunc( i ) ).resolve, master.reject,
+				!remaining );
+
+			// Use .then() to unwrap secondary thenables (cf. gh-3000)
+			if ( master.state() === "pending" ||
+				isFunction( resolveValues[ i ] && resolveValues[ i ].then ) ) {
+
+				return master.then();
+			}
+		}
+
+		// Multiple arguments are aggregated like Promise.all array elements
+		while ( i-- ) {
+			adoptValue( resolveValues[ i ], updateFunc( i ), master.reject );
+		}
+
+		return master.promise();
+	}
+} );
+
+
+// These usually indicate a programmer mistake during development,
+// warn about them ASAP rather than swallowing them by default.
+var rerrorNames = /^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;
+
+jQuery.Deferred.exceptionHook = function( error, stack ) {
+
+	// Support: IE 8 - 9 only
+	// Console exists when dev tools are open, which can happen at any time
+	if ( window.console && window.console.warn && error && rerrorNames.test( error.name ) ) {
+		window.console.warn( "jQuery.Deferred exception: " + error.message, error.stack, stack );
+	}
+};
+
+
+
+
+jQuery.readyException = function( error ) {
+	window.setTimeout( function() {
+		throw error;
+	} );
+};
+
+
+
+
+// The deferred used on DOM ready
+var readyList = jQuery.Deferred();
+
+jQuery.fn.ready = function( fn ) {
+
+	readyList
+		.then( fn )
+
+		// Wrap jQuery.readyException in a function so that the lookup
+		// happens at the time of error handling instead of callback
+		// registration.
+		.catch( function( error ) {
+			jQuery.readyException( error );
+		} );
+
+	return this;
+};
+
+jQuery.extend( {
+
+	// Is the DOM ready to be used? Set to true once it occurs.
+	isReady: false,
+
+	// A counter to track how many items to wait for before
+	// the ready event fires. See #6781
+	readyWait: 1,
+
+	// Handle when the DOM is ready
+	ready: function( wait ) {
+
+		// Abort if there are pending holds or we're already ready
+		if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) {
+			return;
+		}
+
+		// Remember that the DOM is ready
+		jQuery.isReady = true;
+
+		// If a normal DOM Ready event fired, decrement, and wait if need be
+		if ( wait !== true && --jQuery.readyWait > 0 ) {
+			return;
+		}
+
+		// If there are functions bound, to execute
+		readyList.resolveWith( document, [ jQuery ] );
+	}
+} );
+
+jQuery.ready.then = readyList.then;
+
+// The ready event handler and self cleanup method
+function completed() {
+	document.removeEventListener( "DOMContentLoaded", completed );
+	window.removeEventListener( "load", completed );
+	jQuery.ready();
+}
+
+// Catch cases where $(document).ready() is called
+// after the browser event has already occurred.
+// Support: IE <=9 - 10 only
+// Older IE sometimes signals "interactive" too soon
+if ( document.readyState === "complete" ||
+	( document.readyState !== "loading" && !document.documentElement.doScroll ) ) {
+
+	// Handle it asynchronously to allow scripts the opportunity to delay ready
+	window.setTimeout( jQuery.ready );
+
+} else {
+
+	// Use the handy event callback
+	document.addEventListener( "DOMContentLoaded", completed );
+
+	// A fallback to window.onload, that will always work
+	window.addEventListener( "load", completed );
+}
+
+
+
+
+// Multifunctional method to get and set values of a collection
+// The value/s can optionally be executed if it's a function
+var access = function( elems, fn, key, value, chainable, emptyGet, raw ) {
+	var i = 0,
+		len = elems.length,
+		bulk = key == null;
+
+	// Sets many values
+	if ( toType( key ) === "object" ) {
+		chainable = true;
+		for ( i in key ) {
+			access( elems, fn, i, key[ i ], true, emptyGet, raw );
+		}
+
+	// Sets one value
+	} else if ( value !== undefined ) {
+		chainable = true;
+
+		if ( !isFunction( value ) ) {
+			raw = true;
+		}
+
+		if ( bulk ) {
+
+			// Bulk operations run against the entire set
+			if ( raw ) {
+				fn.call( elems, value );
+				fn = null;
+
+			// ...except when executing function values
+			} else {
+				bulk = fn;
+				fn = function( elem, key, value ) {
+					return bulk.call( jQuery( elem ), value );
+				};
+			}
+		}
+
+		if ( fn ) {
+			for ( ; i < len; i++ ) {
+				fn(
+					elems[ i ], key, raw ?
+					value :
+					value.call( elems[ i ], i, fn( elems[ i ], key ) )
+				);
+			}
+		}
+	}
+
+	if ( chainable ) {
+		return elems;
+	}
+
+	// Gets
+	if ( bulk ) {
+		return fn.call( elems );
+	}
+
+	return len ? fn( elems[ 0 ], key ) : emptyGet;
+};
+
+
+// Matches dashed string for camelizing
+var rmsPrefix = /^-ms-/,
+	rdashAlpha = /-([a-z])/g;
+
+// Used by camelCase as callback to replace()
+function fcamelCase( all, letter ) {
+	return letter.toUpperCase();
+}
+
+// Convert dashed to camelCase; used by the css and data modules
+// Support: IE <=9 - 11, Edge 12 - 15
+// Microsoft forgot to hump their vendor prefix (#9572)
+function camelCase( string ) {
+	return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase );
+}
+var acceptData = function( owner ) {
+
+	// Accepts only:
+	//  - Node
+	//    - Node.ELEMENT_NODE
+	//    - Node.DOCUMENT_NODE
+	//  - Object
+	//    - Any
+	return owner.nodeType === 1 || owner.nodeType === 9 || !( +owner.nodeType );
+};
+
+
+
+
+function Data() {
+	this.expando = jQuery.expando + Data.uid++;
+}
+
+Data.uid = 1;
+
+Data.prototype = {
+
+	cache: function( owner ) {
+
+		// Check if the owner object already has a cache
+		var value = owner[ this.expando ];
+
+		// If not, create one
+		if ( !value ) {
+			value = {};
+
+			// We can accept data for non-element nodes in modern browsers,
+			// but we should not, see #8335.
+			// Always return an empty object.
+			if ( acceptData( owner ) ) {
+
+				// If it is a node unlikely to be stringify-ed or looped over
+				// use plain assignment
+				if ( owner.nodeType ) {
+					owner[ this.expando ] = value;
+
+				// Otherwise secure it in a non-enumerable property
+				// configurable must be true to allow the property to be
+				// deleted when data is removed
+				} else {
+					Object.defineProperty( owner, this.expando, {
+						value: value,
+						configurable: true
+					} );
+				}
+			}
+		}
+
+		return value;
+	},
+	set: function( owner, data, value ) {
+		var prop,
+			cache = this.cache( owner );
+
+		// Handle: [ owner, key, value ] args
+		// Always use camelCase key (gh-2257)
+		if ( typeof data === "string" ) {
+			cache[ camelCase( data ) ] = value;
+
+		// Handle: [ owner, { properties } ] args
+		} else {
+
+			// Copy the properties one-by-one to the cache object
+			for ( prop in data ) {
+				cache[ camelCase( prop ) ] = data[ prop ];
+			}
+		}
+		return cache;
+	},
+	get: function( owner, key ) {
+		return key === undefined ?
+			this.cache( owner ) :
+
+			// Always use camelCase key (gh-2257)
+			owner[ this.expando ] && owner[ this.expando ][ camelCase( key ) ];
+	},
+	access: function( owner, key, value ) {
+
+		// In cases where either:
+		//
+		//   1. No key was specified
+		//   2. A string key was specified, but no value provided
+		//
+		// Take the "read" path and allow the get method to determine
+		// which value to return, respectively either:
+		//
+		//   1. The entire cache object
+		//   2. The data stored at the key
+		//
+		if ( key === undefined ||
+				( ( key && typeof key === "string" ) && value === undefined ) ) {
+
+			return this.get( owner, key );
+		}
+
+		// When the key is not a string, or both a key and value
+		// are specified, set or extend (existing objects) with either:
+		//
+		//   1. An object of properties
+		//   2. A key and value
+		//
+		this.set( owner, key, value );
+
+		// Since the "set" path can have two possible entry points
+		// return the expected data based on which path was taken[*]
+		return value !== undefined ? value : key;
+	},
+	remove: function( owner, key ) {
+		var i,
+			cache = owner[ this.expando ];
+
+		if ( cache === undefined ) {
+			return;
+		}
+
+		if ( key !== undefined ) {
+
+			// Support array or space separated string of keys
+			if ( Array.isArray( key ) ) {
+
+				// If key is an array of keys...
+				// We always set camelCase keys, so remove that.
+				key = key.map( camelCase );
+			} else {
+				key = camelCase( key );
+
+				// If a key with the spaces exists, use it.
+				// Otherwise, create an array by matching non-whitespace
+				key = key in cache ?
+					[ key ] :
+					( key.match( rnothtmlwhite ) || [] );
+			}
+
+			i = key.length;
+
+			while ( i-- ) {
+				delete cache[ key[ i ] ];
+			}
+		}
+
+		// Remove the expando if there's no more data
+		if ( key === undefined || jQuery.isEmptyObject( cache ) ) {
+
+			// Support: Chrome <=35 - 45
+			// Webkit & Blink performance suffers when deleting properties
+			// from DOM nodes, so set to undefined instead
+			// https://bugs.chromium.org/p/chromium/issues/detail?id=378607 (bug restricted)
+			if ( owner.nodeType ) {
+				owner[ this.expando ] = undefined;
+			} else {
+				delete owner[ this.expando ];
+			}
+		}
+	},
+	hasData: function( owner ) {
+		var cache = owner[ this.expando ];
+		return cache !== undefined && !jQuery.isEmptyObject( cache );
+	}
+};
+var dataPriv = new Data();
+
+var dataUser = new Data();
+
+
+
+//	Implementation Summary
+//
+//	1. Enforce API surface and semantic compatibility with 1.9.x branch
+//	2. Improve the module's maintainability by reducing the storage
+//		paths to a single mechanism.
+//	3. Use the same single mechanism to support "private" and "user" data.
+//	4. _Never_ expose "private" data to user code (TODO: Drop _data, _removeData)
+//	5. Avoid exposing implementation details on user objects (eg. expando properties)
+//	6. Provide a clear path for implementation upgrade to WeakMap in 2014
+
+var rbrace = /^(?:\{[\w\W]*\}|\[[\w\W]*\])$/,
+	rmultiDash = /[A-Z]/g;
+
+function getData( data ) {
+	if ( data === "true" ) {
+		return true;
+	}
+
+	if ( data === "false" ) {
+		return false;
+	}
+
+	if ( data === "null" ) {
+		return null;
+	}
+
+	// Only convert to a number if it doesn't change the string
+	if ( data === +data + "" ) {
+		return +data;
+	}
+
+	if ( rbrace.test( data ) ) {
+		return JSON.parse( data );
+	}
+
+	return data;
+}
+
+function dataAttr( elem, key, data ) {
+	var name;
+
+	// If nothing was found internally, try to fetch any
+	// data from the HTML5 data-* attribute
+	if ( data === undefined && elem.nodeType === 1 ) {
+		name = "data-" + key.replace( rmultiDash, "-$&" ).toLowerCase();
+		data = elem.getAttribute( name );
+
+		if ( typeof data === "string" ) {
+			try {
+				data = getData( data );
+			} catch ( e ) {}
+
+			// Make sure we set the data so it isn't changed later
+			dataUser.set( elem, key, data );
+		} else {
+			data = undefined;
+		}
+	}
+	return data;
+}
+
+jQuery.extend( {
+	hasData: function( elem ) {
+		return dataUser.hasData( elem ) || dataPriv.hasData( elem );
+	},
+
+	data: function( elem, name, data ) {
+		return dataUser.access( elem, name, data );
+	},
+
+	removeData: function( elem, name ) {
+		dataUser.remove( elem, name );
+	},
+
+	// TODO: Now that all calls to _data and _removeData have been replaced
+	// with direct calls to dataPriv methods, these can be deprecated.
+	_data: function( elem, name, data ) {
+		return dataPriv.access( elem, name, data );
+	},
+
+	_removeData: function( elem, name ) {
+		dataPriv.remove( elem, name );
+	}
+} );
+
+jQuery.fn.extend( {
+	data: function( key, value ) {
+		var i, name, data,
+			elem = this[ 0 ],
+			attrs = elem && elem.attributes;
+
+		// Gets all values
+		if ( key === undefined ) {
+			if ( this.length ) {
+				data = dataUser.get( elem );
+
+				if ( elem.nodeType === 1 && !dataPriv.get( elem, "hasDataAttrs" ) ) {
+					i = attrs.length;
+					while ( i-- ) {
+
+						// Support: IE 11 only
+						// The attrs elements can be null (#14894)
+						if ( attrs[ i ] ) {
+							name = attrs[ i ].name;
+							if ( name.indexOf( "data-" ) === 0 ) {
+								name = camelCase( name.slice( 5 ) );
+								dataAttr( elem, name, data[ name ] );
+							}
+						}
+					}
+					dataPriv.set( elem, "hasDataAttrs", true );
+				}
+			}
+
+			return data;
+		}
+
+		// Sets multiple values
+		if ( typeof key === "object" ) {
+			return this.each( function() {
+				dataUser.set( this, key );
+			} );
+		}
+
+		return access( this, function( value ) {
+			var data;
+
+			// The calling jQuery object (element matches) is not empty
+			// (and therefore has an element appears at this[ 0 ]) and the
+			// `value` parameter was not undefined. An empty jQuery object
+			// will result in `undefined` for elem = this[ 0 ] which will
+			// throw an exception if an attempt to read a data cache is made.
+			if ( elem && value === undefined ) {
+
+				// Attempt to get data from the cache
+				// The key will always be camelCased in Data
+				data = dataUser.get( elem, key );
+				if ( data !== undefined ) {
+					return data;
+				}
+
+				// Attempt to "discover" the data in
+				// HTML5 custom data-* attrs
+				data = dataAttr( elem, key );
+				if ( data !== undefined ) {
+					return data;
+				}
+
+				// We tried really hard, but the data doesn't exist.
+				return;
+			}
+
+			// Set the data...
+			this.each( function() {
+
+				// We always store the camelCased key
+				dataUser.set( this, key, value );
+			} );
+		}, null, value, arguments.length > 1, null, true );
+	},
+
+	removeData: function( key ) {
+		return this.each( function() {
+			dataUser.remove( this, key );
+		} );
+	}
+} );
+
+
+jQuery.extend( {
+	queue: function( elem, type, data ) {
+		var queue;
+
+		if ( elem ) {
+			type = ( type || "fx" ) + "queue";
+			queue = dataPriv.get( elem, type );
+
+			// Speed up dequeue by getting out quickly if this is just a lookup
+			if ( data ) {
+				if ( !queue || Array.isArray( data ) ) {
+					queue = dataPriv.access( elem, type, jQuery.makeArray( data ) );
+				} else {
+					queue.push( data );
+				}
+			}
+			return queue || [];
+		}
+	},
+
+	dequeue: function( elem, type ) {
+		type = type || "fx";
+
+		var queue = jQuery.queue( elem, type ),
+			startLength = queue.length,
+			fn = queue.shift(),
+			hooks = jQuery._queueHooks( elem, type ),
+			next = function() {
+				jQuery.dequeue( elem, type );
+			};
+
+		// If the fx queue is dequeued, always remove the progress sentinel
+		if ( fn === "inprogress" ) {
+			fn = queue.shift();
+			startLength--;
+		}
+
+		if ( fn ) {
+
+			// Add a progress sentinel to prevent the fx queue from being
+			// automatically dequeued
+			if ( type === "fx" ) {
+				queue.unshift( "inprogress" );
+			}
+
+			// Clear up the last queue stop function
+			delete hooks.stop;
+			fn.call( elem, next, hooks );
+		}
+
+		if ( !startLength && hooks ) {
+			hooks.empty.fire();
+		}
+	},
+
+	// Not public - generate a queueHooks object, or return the current one
+	_queueHooks: function( elem, type ) {
+		var key = type + "queueHooks";
+		return dataPriv.get( elem, key ) || dataPriv.access( elem, key, {
+			empty: jQuery.Callbacks( "once memory" ).add( function() {
+				dataPriv.remove( elem, [ type + "queue", key ] );
+			} )
+		} );
+	}
+} );
+
+jQuery.fn.extend( {
+	queue: function( type, data ) {
+		var setter = 2;
+
+		if ( typeof type !== "string" ) {
+			data = type;
+			type = "fx";
+			setter--;
+		}
+
+		if ( arguments.length < setter ) {
+			return jQuery.queue( this[ 0 ], type );
+		}
+
+		return data === undefined ?
+			this :
+			this.each( function() {
+				var queue = jQuery.queue( this, type, data );
+
+				// Ensure a hooks for this queue
+				jQuery._queueHooks( this, type );
+
+				if ( type === "fx" && queue[ 0 ] !== "inprogress" ) {
+					jQuery.dequeue( this, type );
+				}
+			} );
+	},
+	dequeue: function( type ) {
+		return this.each( function() {
+			jQuery.dequeue( this, type );
+		} );
+	},
+	clearQueue: function( type ) {
+		return this.queue( type || "fx", [] );
+	},
+
+	// Get a promise resolved when queues of a certain type
+	// are emptied (fx is the type by default)
+	promise: function( type, obj ) {
+		var tmp,
+			count = 1,
+			defer = jQuery.Deferred(),
+			elements = this,
+			i = this.length,
+			resolve = function() {
+				if ( !( --count ) ) {
+					defer.resolveWith( elements, [ elements ] );
+				}
+			};
+
+		if ( typeof type !== "string" ) {
+			obj = type;
+			type = undefined;
+		}
+		type = type || "fx";
+
+		while ( i-- ) {
+			tmp = dataPriv.get( elements[ i ], type + "queueHooks" );
+			if ( tmp && tmp.empty ) {
+				count++;
+				tmp.empty.add( resolve );
+			}
+		}
+		resolve();
+		return defer.promise( obj );
+	}
+} );
+var pnum = ( /[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/ ).source;
+
+var rcssNum = new RegExp( "^(?:([+-])=|)(" + pnum + ")([a-z%]*)$", "i" );
+
+
+var cssExpand = [ "Top", "Right", "Bottom", "Left" ];
+
+var isHiddenWithinTree = function( elem, el ) {
+
+		// isHiddenWithinTree might be called from jQuery#filter function;
+		// in that case, element will be second argument
+		elem = el || elem;
+
+		// Inline style trumps all
+		return elem.style.display === "none" ||
+			elem.style.display === "" &&
+
+			// Otherwise, check computed style
+			// Support: Firefox <=43 - 45
+			// Disconnected elements can have computed display: none, so first confirm that elem is
+			// in the document.
+			jQuery.contains( elem.ownerDocument, elem ) &&
+
+			jQuery.css( elem, "display" ) === "none";
+	};
+
+var swap = function( elem, options, callback, args ) {
+	var ret, name,
+		old = {};
+
+	// Remember the old values, and insert the new ones
+	for ( name in options ) {
+		old[ name ] = elem.style[ name ];
+		elem.style[ name ] = options[ name ];
+	}
+
+	ret = callback.apply( elem, args || [] );
+
+	// Revert the old values
+	for ( name in options ) {
+		elem.style[ name ] = old[ name ];
+	}
+
+	return ret;
+};
+
+
+
+
+function adjustCSS( elem, prop, valueParts, tween ) {
+	var adjusted, scale,
+		maxIterations = 20,
+		currentValue = tween ?
+			function() {
+				return tween.cur();
+			} :
+			function() {
+				return jQuery.css( elem, prop, "" );
+			},
+		initial = currentValue(),
+		unit = valueParts && valueParts[ 3 ] || ( jQuery.cssNumber[ prop ] ? "" : "px" ),
+
+		// Starting value computation is required for potential unit mismatches
+		initialInUnit = ( jQuery.cssNumber[ prop ] || unit !== "px" && +initial ) &&
+			rcssNum.exec( jQuery.css( elem, prop ) );
+
+	if ( initialInUnit && initialInUnit[ 3 ] !== unit ) {
+
+		// Support: Firefox <=54
+		// Halve the iteration target value to prevent interference from CSS upper bounds (gh-2144)
+		initial = initial / 2;
+
+		// Trust units reported by jQuery.css
+		unit = unit || initialInUnit[ 3 ];
+
+		// Iteratively approximate from a nonzero starting point
+		initialInUnit = +initial || 1;
+
+		while ( maxIterations-- ) {
+
+			// Evaluate and update our best guess (doubling guesses that zero out).
+			// Finish if the scale equals or crosses 1 (making the old*new product non-positive).
+			jQuery.style( elem, prop, initialInUnit + unit );
+			if ( ( 1 - scale ) * ( 1 - ( scale = currentValue() / initial || 0.5 ) ) <= 0 ) {
+				maxIterations = 0;
+			}
+			initialInUnit = initialInUnit / scale;
+
+		}
+
+		initialInUnit = initialInUnit * 2;
+		jQuery.style( elem, prop, initialInUnit + unit );
+
+		// Make sure we update the tween properties later on
+		valueParts = valueParts || [];
+	}
+
+	if ( valueParts ) {
+		initialInUnit = +initialInUnit || +initial || 0;
+
+		// Apply relative offset (+=/-=) if specified
+		adjusted = valueParts[ 1 ] ?
+			initialInUnit + ( valueParts[ 1 ] + 1 ) * valueParts[ 2 ] :
+			+valueParts[ 2 ];
+		if ( tween ) {
+			tween.unit = unit;
+			tween.start = initialInUnit;
+			tween.end = adjusted;
+		}
+	}
+	return adjusted;
+}
+
+
+var defaultDisplayMap = {};
+
+function getDefaultDisplay( elem ) {
+	var temp,
+		doc = elem.ownerDocument,
+		nodeName = elem.nodeName,
+		display = defaultDisplayMap[ nodeName ];
+
+	if ( display ) {
+		return display;
+	}
+
+	temp = doc.body.appendChild( doc.createElement( nodeName ) );
+	display = jQuery.css( temp, "display" );
+
+	temp.parentNode.removeChild( temp );
+
+	if ( display === "none" ) {
+		display = "block";
+	}
+	defaultDisplayMap[ nodeName ] = display;
+
+	return display;
+}
+
+function showHide( elements, show ) {
+	var display, elem,
+		values = [],
+		index = 0,
+		length = elements.length;
+
+	// Determine new display value for elements that need to change
+	for ( ; index < length; index++ ) {
+		elem = elements[ index ];
+		if ( !elem.style ) {
+			continue;
+		}
+
+		display = elem.style.display;
+		if ( show ) {
+
+			// Since we force visibility upon cascade-hidden elements, an immediate (and slow)
+			// check is required in this first loop unless we have a nonempty display value (either
+			// inline or about-to-be-restored)
+			if ( display === "none" ) {
+				values[ index ] = dataPriv.get( elem, "display" ) || null;
+				if ( !values[ index ] ) {
+					elem.style.display = "";
+				}
+			}
+			if ( elem.style.display === "" && isHiddenWithinTree( elem ) ) {
+				values[ index ] = getDefaultDisplay( elem );
+			}
+		} else {
+			if ( display !== "none" ) {
+				values[ index ] = "none";
+
+				// Remember what we're overwriting
+				dataPriv.set( elem, "display", display );
+			}
+		}
+	}
+
+	// Set the display of the elements in a second loop to avoid constant reflow
+	for ( index = 0; index < length; index++ ) {
+		if ( values[ index ] != null ) {
+			elements[ index ].style.display = values[ index ];
+		}
+	}
+
+	return elements;
+}
+
+jQuery.fn.extend( {
+	show: function() {
+		return showHide( this, true );
+	},
+	hide: function() {
+		return showHide( this );
+	},
+	toggle: function( state ) {
+		if ( typeof state === "boolean" ) {
+			return state ? this.show() : this.hide();
+		}
+
+		return this.each( function() {
+			if ( isHiddenWithinTree( this ) ) {
+				jQuery( this ).show();
+			} else {
+				jQuery( this ).hide();
+			}
+		} );
+	}
+} );
+var rcheckableType = ( /^(?:checkbox|radio)$/i );
+
+var rtagName = ( /<([a-z][^\/\0>\x20\t\r\n\f]+)/i );
+
+var rscriptType = ( /^$|^module$|\/(?:java|ecma)script/i );
+
+
+
+// We have to close these tags to support XHTML (#13200)
+var wrapMap = {
+
+	// Support: IE <=9 only
+	option: [ 1, "<select multiple='multiple'>", "</select>" ],
+
+	// XHTML parsers do not magically insert elements in the
+	// same way that tag soup parsers do. So we cannot shorten
+	// this by omitting <tbody> or other required elements.
+	thead: [ 1, "<table>", "</table>" ],
+	col: [ 2, "<table><colgroup>", "</colgroup></table>" ],
+	tr: [ 2, "<table><tbody>", "</tbody></table>" ],
+	td: [ 3, "<table><tbody><tr>", "</tr></tbody></table>" ],
+
+	_default: [ 0, "", "" ]
+};
+
+// Support: IE <=9 only
+wrapMap.optgroup = wrapMap.option;
+
+wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead;
+wrapMap.th = wrapMap.td;
+
+
+function getAll( context, tag ) {
+
+	// Support: IE <=9 - 11 only
+	// Use typeof to avoid zero-argument method invocation on host objects (#15151)
+	var ret;
+
+	if ( typeof context.getElementsByTagName !== "undefined" ) {
+		ret = context.getElementsByTagName( tag || "*" );
+
+	} else if ( typeof context.querySelectorAll !== "undefined" ) {
+		ret = context.querySelectorAll( tag || "*" );
+
+	} else {
+		ret = [];
+	}
+
+	if ( tag === undefined || tag && nodeName( context, tag ) ) {
+		return jQuery.merge( [ context ], ret );
+	}
+
+	return ret;
+}
+
+
+// Mark scripts as having already been evaluated
+function setGlobalEval( elems, refElements ) {
+	var i = 0,
+		l = elems.length;
+
+	for ( ; i < l; i++ ) {
+		dataPriv.set(
+			elems[ i ],
+			"globalEval",
+			!refElements || dataPriv.get( refElements[ i ], "globalEval" )
+		);
+	}
+}
+
+
+var rhtml = /<|&#?\w+;/;
+
+function buildFragment( elems, context, scripts, selection, ignored ) {
+	var elem, tmp, tag, wrap, contains, j,
+		fragment = context.createDocumentFragment(),
+		nodes = [],
+		i = 0,
+		l = elems.length;
+
+	for ( ; i < l; i++ ) {
+		elem = elems[ i ];
+
+		if ( elem || elem === 0 ) {
+
+			// Add nodes directly
+			if ( toType( elem ) === "object" ) {
+
+				// Support: Android <=4.0 only, PhantomJS 1 only
+				// push.apply(_, arraylike) throws on ancient WebKit
+				jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem );
+
+			// Convert non-html into a text node
+			} else if ( !rhtml.test( elem ) ) {
+				nodes.push( context.createTextNode( elem ) );
+
+			// Convert html into DOM nodes
+			} else {
+				tmp = tmp || fragment.appendChild( context.createElement( "div" ) );
+
+				// Deserialize a standard representation
+				tag = ( rtagName.exec( elem ) || [ "", "" ] )[ 1 ].toLowerCase();
+				wrap = wrapMap[ tag ] || wrapMap._default;
+				tmp.innerHTML = wrap[ 1 ] + jQuery.htmlPrefilter( elem ) + wrap[ 2 ];
+
+				// Descend through wrappers to the right content
+				j = wrap[ 0 ];
+				while ( j-- ) {
+					tmp = tmp.lastChild;
+				}
+
+				// Support: Android <=4.0 only, PhantomJS 1 only
+				// push.apply(_, arraylike) throws on ancient WebKit
+				jQuery.merge( nodes, tmp.childNodes );
+
+				// Remember the top-level container
+				tmp = fragment.firstChild;
+
+				// Ensure the created nodes are orphaned (#12392)
+				tmp.textContent = "";
+			}
+		}
+	}
+
+	// Remove wrapper from fragment
+	fragment.textContent = "";
+
+	i = 0;
+	while ( ( elem = nodes[ i++ ] ) ) {
+
+		// Skip elements already in the context collection (trac-4087)
+		if ( selection && jQuery.inArray( elem, selection ) > -1 ) {
+			if ( ignored ) {
+				ignored.push( elem );
+			}
+			continue;
+		}
+
+		contains = jQuery.contains( elem.ownerDocument, elem );
+
+		// Append to fragment
+		tmp = getAll( fragment.appendChild( elem ), "script" );
+
+		// Preserve script evaluation history
+		if ( contains ) {
+			setGlobalEval( tmp );
+		}
+
+		// Capture executables
+		if ( scripts ) {
+			j = 0;
+			while ( ( elem = tmp[ j++ ] ) ) {
+				if ( rscriptType.test( elem.type || "" ) ) {
+					scripts.push( elem );
+				}
+			}
+		}
+	}
+
+	return fragment;
+}
+
+
+( function() {
+	var fragment = document.createDocumentFragment(),
+		div = fragment.appendChild( document.createElement( "div" ) ),
+		input = document.createElement( "input" );
+
+	// Support: Android 4.0 - 4.3 only
+	// Check state lost if the name is set (#11217)
+	// Support: Windows Web Apps (WWA)
+	// `name` and `type` must use .setAttribute for WWA (#14901)
+	input.setAttribute( "type", "radio" );
+	input.setAttribute( "checked", "checked" );
+	input.setAttribute( "name", "t" );
+
+	div.appendChild( input );
+
+	// Support: Android <=4.1 only
+	// Older WebKit doesn't clone checked state correctly in fragments
+	support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked;
+
+	// Support: IE <=11 only
+	// Make sure textarea (and checkbox) defaultValue is properly cloned
+	div.innerHTML = "<textarea>x</textarea>";
+	support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue;
+} )();
+var documentElement = document.documentElement;
+
+
+
+var
+	rkeyEvent = /^key/,
+	rmouseEvent = /^(?:mouse|pointer|contextmenu|drag|drop)|click/,
+	rtypenamespace = /^([^.]*)(?:\.(.+)|)/;
+
+function returnTrue() {
+	return true;
+}
+
+function returnFalse() {
+	return false;
+}
+
+// Support: IE <=9 only
+// See #13393 for more info
+function safeActiveElement() {
+	try {
+		return document.activeElement;
+	} catch ( err ) { }
+}
+
+function on( elem, types, selector, data, fn, one ) {
+	var origFn, type;
+
+	// Types can be a map of types/handlers
+	if ( typeof types === "object" ) {
+
+		// ( types-Object, selector, data )
+		if ( typeof selector !== "string" ) {
+
+			// ( types-Object, data )
+			data = data || selector;
+			selector = undefined;
+		}
+		for ( type in types ) {
+			on( elem, type, selector, data, types[ type ], one );
+		}
+		return elem;
+	}
+
+	if ( data == null && fn == null ) {
+
+		// ( types, fn )
+		fn = selector;
+		data = selector = undefined;
+	} else if ( fn == null ) {
+		if ( typeof selector === "string" ) {
+
+			// ( types, selector, fn )
+			fn = data;
+			data = undefined;
+		} else {
+
+			// ( types, data, fn )
+			fn = data;
+			data = selector;
+			selector = undefined;
+		}
+	}
+	if ( fn === false ) {
+		fn = returnFalse;
+	} else if ( !fn ) {
+		return elem;
+	}
+
+	if ( one === 1 ) {
+		origFn = fn;
+		fn = function( event ) {
+
+			// Can use an empty set, since event contains the info
+			jQuery().off( event );
+			return origFn.apply( this, arguments );
+		};
+
+		// Use same guid so caller can remove using origFn
+		fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ );
+	}
+	return elem.each( function() {
+		jQuery.event.add( this, types, fn, data, selector );
+	} );
+}
+
+/*
+ * Helper functions for managing events -- not part of the public interface.
+ * Props to Dean Edwards' addEvent library for many of the ideas.
+ */
+jQuery.event = {
+
+	global: {},
+
+	add: function( elem, types, handler, data, selector ) {
+
+		var handleObjIn, eventHandle, tmp,
+			events, t, handleObj,
+			special, handlers, type, namespaces, origType,
+			elemData = dataPriv.get( elem );
+
+		// Don't attach events to noData or text/comment nodes (but allow plain objects)
+		if ( !elemData ) {
+			return;
+		}
+
+		// Caller can pass in an object of custom data in lieu of the handler
+		if ( handler.handler ) {
+			handleObjIn = handler;
+			handler = handleObjIn.handler;
+			selector = handleObjIn.selector;
+		}
+
+		// Ensure that invalid selectors throw exceptions at attach time
+		// Evaluate against documentElement in case elem is a non-element node (e.g., document)
+		if ( selector ) {
+			jQuery.find.matchesSelector( documentElement, selector );
+		}
+
+		// Make sure that the handler has a unique ID, used to find/remove it later
+		if ( !handler.guid ) {
+			handler.guid = jQuery.guid++;
+		}
+
+		// Init the element's event structure and main handler, if this is the first
+		if ( !( events = elemData.events ) ) {
+			events = elemData.events = {};
+		}
+		if ( !( eventHandle = elemData.handle ) ) {
+			eventHandle = elemData.handle = function( e ) {
+
+				// Discard the second event of a jQuery.event.trigger() and
+				// when an event is called after a page has unloaded
+				return typeof jQuery !== "undefined" && jQuery.event.triggered !== e.type ?
+					jQuery.event.dispatch.apply( elem, arguments ) : undefined;
+			};
+		}
+
+		// Handle multiple events separated by a space
+		types = ( types || "" ).match( rnothtmlwhite ) || [ "" ];
+		t = types.length;
+		while ( t-- ) {
+			tmp = rtypenamespace.exec( types[ t ] ) || [];
+			type = origType = tmp[ 1 ];
+			namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort();
+
+			// There *must* be a type, no attaching namespace-only handlers
+			if ( !type ) {
+				continue;
+			}
+
+			// If event changes its type, use the special event handlers for the changed type
+			special = jQuery.event.special[ type ] || {};
+
+			// If selector defined, determine special event api type, otherwise given type
+			type = ( selector ? special.delegateType : special.bindType ) || type;
+
+			// Update special based on newly reset type
+			special = jQuery.event.special[ type ] || {};
+
+			// handleObj is passed to all event handlers
+			handleObj = jQuery.extend( {
+				type: type,
+				origType: origType,
+				data: data,
+				handler: handler,
+				guid: handler.guid,
+				selector: selector,
+				needsContext: selector && jQuery.expr.match.needsContext.test( selector ),
+				namespace: namespaces.join( "." )
+			}, handleObjIn );
+
+			// Init the event handler queue if we're the first
+			if ( !( handlers = events[ type ] ) ) {
+				handlers = events[ type ] = [];
+				handlers.delegateCount = 0;
+
+				// Only use addEventListener if the special events handler returns false
+				if ( !special.setup ||
+					special.setup.call( elem, data, namespaces, eventHandle ) === false ) {
+
+					if ( elem.addEventListener ) {
+						elem.addEventListener( type, eventHandle );
+					}
+				}
+			}
+
+			if ( special.add ) {
+				special.add.call( elem, handleObj );
+
+				if ( !handleObj.handler.guid ) {
+					handleObj.handler.guid = handler.guid;
+				}
+			}
+
+			// Add to the element's handler list, delegates in front
+			if ( selector ) {
+				handlers.splice( handlers.delegateCount++, 0, handleObj );
+			} else {
+				handlers.push( handleObj );
+			}
+
+			// Keep track of which events have ever been used, for event optimization
+			jQuery.event.global[ type ] = true;
+		}
+
+	},
+
+	// Detach an event or set of events from an element
+	remove: function( elem, types, handler, selector, mappedTypes ) {
+
+		var j, origCount, tmp,
+			events, t, handleObj,
+			special, handlers, type, namespaces, origType,
+			elemData = dataPriv.hasData( elem ) && dataPriv.get( elem );
+
+		if ( !elemData || !( events = elemData.events ) ) {
+			return;
+		}
+
+		// Once for each type.namespace in types; type may be omitted
+		types = ( types || "" ).match( rnothtmlwhite ) || [ "" ];
+		t = types.length;
+		while ( t-- ) {
+			tmp = rtypenamespace.exec( types[ t ] ) || [];
+			type = origType = tmp[ 1 ];
+			namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort();
+
+			// Unbind all events (on this namespace, if provided) for the element
+			if ( !type ) {
+				for ( type in events ) {
+					jQuery.event.remove( elem, type + types[ t ], handler, selector, true );
+				}
+				continue;
+			}
+
+			special = jQuery.event.special[ type ] || {};
+			type = ( selector ? special.delegateType : special.bindType ) || type;
+			handlers = events[ type ] || [];
+			tmp = tmp[ 2 ] &&
+				new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" );
+
+			// Remove matching events
+			origCount = j = handlers.length;
+			while ( j-- ) {
+				handleObj = handlers[ j ];
+
+				if ( ( mappedTypes || origType === handleObj.origType ) &&
+					( !handler || handler.guid === handleObj.guid ) &&
+					( !tmp || tmp.test( handleObj.namespace ) ) &&
+					( !selector || selector === handleObj.selector ||
+						selector === "**" && handleObj.selector ) ) {
+					handlers.splice( j, 1 );
+
+					if ( handleObj.selector ) {
+						handlers.delegateCount--;
+					}
+					if ( special.remove ) {
+						special.remove.call( elem, handleObj );
+					}
+				}
+			}
+
+			// Remove generic event handler if we removed something and no more handlers exist
+			// (avoids potential for endless recursion during removal of special event handlers)
+			if ( origCount && !handlers.length ) {
+				if ( !special.teardown ||
+					special.teardown.call( elem, namespaces, elemData.handle ) === false ) {
+
+					jQuery.removeEvent( elem, type, elemData.handle );
+				}
+
+				delete events[ type ];
+			}
+		}
+
+		// Remove data and the expando if it's no longer used
+		if ( jQuery.isEmptyObject( events ) ) {
+			dataPriv.remove( elem, "handle events" );
+		}
+	},
+
+	dispatch: function( nativeEvent ) {
+
+		// Make a writable jQuery.Event from the native event object
+		var event = jQuery.event.fix( nativeEvent );
+
+		var i, j, ret, matched, handleObj, handlerQueue,
+			args = new Array( arguments.length ),
+			handlers = ( dataPriv.get( this, "events" ) || {} )[ event.type ] || [],
+			special = jQuery.event.special[ event.type ] || {};
+
+		// Use the fix-ed jQuery.Event rather than the (read-only) native event
+		args[ 0 ] = event;
+
+		for ( i = 1; i < arguments.length; i++ ) {
+			args[ i ] = arguments[ i ];
+		}
+
+		event.delegateTarget = this;
+
+		// Call the preDispatch hook for the mapped type, and let it bail if desired
+		if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) {
+			return;
+		}
+
+		// Determine handlers
+		handlerQueue = jQuery.event.handlers.call( this, event, handlers );
+
+		// Run delegates first; they may want to stop propagation beneath us
+		i = 0;
+		while ( ( matched = handlerQueue[ i++ ] ) && !event.isPropagationStopped() ) {
+			event.currentTarget = matched.elem;
+
+			j = 0;
+			while ( ( handleObj = matched.handlers[ j++ ] ) &&
+				!event.isImmediatePropagationStopped() ) {
+
+				// Triggered event must either 1) have no namespace, or 2) have namespace(s)
+				// a subset or equal to those in the bound event (both can have no namespace).
+				if ( !event.rnamespace || event.rnamespace.test( handleObj.namespace ) ) {
+
+					event.handleObj = handleObj;
+					event.data = handleObj.data;
+
+					ret = ( ( jQuery.event.special[ handleObj.origType ] || {} ).handle ||
+						handleObj.handler ).apply( matched.elem, args );
+
+					if ( ret !== undefined ) {
+						if ( ( event.result = ret ) === false ) {
+							event.preventDefault();
+							event.stopPropagation();
+						}
+					}
+				}
+			}
+		}
+
+		// Call the postDispatch hook for the mapped type
+		if ( special.postDispatch ) {
+			special.postDispatch.call( this, event );
+		}
+
+		return event.result;
+	},
+
+	handlers: function( event, handlers ) {
+		var i, handleObj, sel, matchedHandlers, matchedSelectors,
+			handlerQueue = [],
+			delegateCount = handlers.delegateCount,
+			cur = event.target;
+
+		// Find delegate handlers
+		if ( delegateCount &&
+
+			// Support: IE <=9
+			// Black-hole SVG <use> instance trees (trac-13180)
+			cur.nodeType &&
+
+			// Support: Firefox <=42
+			// Suppress spec-violating clicks indicating a non-primary pointer button (trac-3861)
+			// https://www.w3.org/TR/DOM-Level-3-Events/#event-type-click
+			// Support: IE 11 only
+			// ...but not arrow key "clicks" of radio inputs, which can have `button` -1 (gh-2343)
+			!( event.type === "click" && event.button >= 1 ) ) {
+
+			for ( ; cur !== this; cur = cur.parentNode || this ) {
+
+				// Don't check non-elements (#13208)
+				// Don't process clicks on disabled elements (#6911, #8165, #11382, #11764)
+				if ( cur.nodeType === 1 && !( event.type === "click" && cur.disabled === true ) ) {
+					matchedHandlers = [];
+					matchedSelectors = {};
+					for ( i = 0; i < delegateCount; i++ ) {
+						handleObj = handlers[ i ];
+
+						// Don't conflict with Object.prototype properties (#13203)
+						sel = handleObj.selector + " ";
+
+						if ( matchedSelectors[ sel ] === undefined ) {
+							matchedSelectors[ sel ] = handleObj.needsContext ?
+								jQuery( sel, this ).index( cur ) > -1 :
+								jQuery.find( sel, this, null, [ cur ] ).length;
+						}
+						if ( matchedSelectors[ sel ] ) {
+							matchedHandlers.push( handleObj );
+						}
+					}
+					if ( matchedHandlers.length ) {
+						handlerQueue.push( { elem: cur, handlers: matchedHandlers } );
+					}
+				}
+			}
+		}
+
+		// Add the remaining (directly-bound) handlers
+		cur = this;
+		if ( delegateCount < handlers.length ) {
+			handlerQueue.push( { elem: cur, handlers: handlers.slice( delegateCount ) } );
+		}
+
+		return handlerQueue;
+	},
+
+	addProp: function( name, hook ) {
+		Object.defineProperty( jQuery.Event.prototype, name, {
+			enumerable: true,
+			configurable: true,
+
+			get: isFunction( hook ) ?
+				function() {
+					if ( this.originalEvent ) {
+							return hook( this.originalEvent );
+					}
+				} :
+				function() {
+					if ( this.originalEvent ) {
+							return this.originalEvent[ name ];
+					}
+				},
+
+			set: function( value ) {
+				Object.defineProperty( this, name, {
+					enumerable: true,
+					configurable: true,
+					writable: true,
+					value: value
+				} );
+			}
+		} );
+	},
+
+	fix: function( originalEvent ) {
+		return originalEvent[ jQuery.expando ] ?
+			originalEvent :
+			new jQuery.Event( originalEvent );
+	},
+
+	special: {
+		load: {
+
+			// Prevent triggered image.load events from bubbling to window.load
+			noBubble: true
+		},
+		focus: {
+
+			// Fire native event if possible so blur/focus sequence is correct
+			trigger: function() {
+				if ( this !== safeActiveElement() && this.focus ) {
+					this.focus();
+					return false;
+				}
+			},
+			delegateType: "focusin"
+		},
+		blur: {
+			trigger: function() {
+				if ( this === safeActiveElement() && this.blur ) {
+					this.blur();
+					return false;
+				}
+			},
+			delegateType: "focusout"
+		},
+		click: {
+
+			// For checkbox, fire native event so checked state will be right
+			trigger: function() {
+				if ( this.type === "checkbox" && this.click && nodeName( this, "input" ) ) {
+					this.click();
+					return false;
+				}
+			},
+
+			// For cross-browser consistency, don't fire native .click() on links
+			_default: function( event ) {
+				return nodeName( event.target, "a" );
+			}
+		},
+
+		beforeunload: {
+			postDispatch: function( event ) {
+
+				// Support: Firefox 20+
+				// Firefox doesn't alert if the returnValue field is not set.
+				if ( event.result !== undefined && event.originalEvent ) {
+					event.originalEvent.returnValue = event.result;
+				}
+			}
+		}
+	}
+};
+
+jQuery.removeEvent = function( elem, type, handle ) {
+
+	// This "if" is needed for plain objects
+	if ( elem.removeEventListener ) {
+		elem.removeEventListener( type, handle );
+	}
+};
+
+jQuery.Event = function( src, props ) {
+
+	// Allow instantiation without the 'new' keyword
+	if ( !( this instanceof jQuery.Event ) ) {
+		return new jQuery.Event( src, props );
+	}
+
+	// Event object
+	if ( src && src.type ) {
+		this.originalEvent = src;
+		this.type = src.type;
+
+		// Events bubbling up the document may have been marked as prevented
+		// by a handler lower down the tree; reflect the correct value.
+		this.isDefaultPrevented = src.defaultPrevented ||
+				src.defaultPrevented === undefined &&
+
+				// Support: Android <=2.3 only
+				src.returnValue === false ?
+			returnTrue :
+			returnFalse;
+
+		// Create target properties
+		// Support: Safari <=6 - 7 only
+		// Target should not be a text node (#504, #13143)
+		this.target = ( src.target && src.target.nodeType === 3 ) ?
+			src.target.parentNode :
+			src.target;
+
+		this.currentTarget = src.currentTarget;
+		this.relatedTarget = src.relatedTarget;
+
+	// Event type
+	} else {
+		this.type = src;
+	}
+
+	// Put explicitly provided properties onto the event object
+	if ( props ) {
+		jQuery.extend( this, props );
+	}
+
+	// Create a timestamp if incoming event doesn't have one
+	this.timeStamp = src && src.timeStamp || Date.now();
+
+	// Mark it as fixed
+	this[ jQuery.expando ] = true;
+};
+
+// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding
+// https://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html
+jQuery.Event.prototype = {
+	constructor: jQuery.Event,
+	isDefaultPrevented: returnFalse,
+	isPropagationStopped: returnFalse,
+	isImmediatePropagationStopped: returnFalse,
+	isSimulated: false,
+
+	preventDefault: function() {
+		var e = this.originalEvent;
+
+		this.isDefaultPrevented = returnTrue;
+
+		if ( e && !this.isSimulated ) {
+			e.preventDefault();
+		}
+	},
+	stopPropagation: function() {
+		var e = this.originalEvent;
+
+		this.isPropagationStopped = returnTrue;
+
+		if ( e && !this.isSimulated ) {
+			e.stopPropagation();
+		}
+	},
+	stopImmediatePropagation: function() {
+		var e = this.originalEvent;
+
+		this.isImmediatePropagationStopped = returnTrue;
+
+		if ( e && !this.isSimulated ) {
+			e.stopImmediatePropagation();
+		}
+
+		this.stopPropagation();
+	}
+};
+
+// Includes all common event props including KeyEvent and MouseEvent specific props
+jQuery.each( {
+	altKey: true,
+	bubbles: true,
+	cancelable: true,
+	changedTouches: true,
+	ctrlKey: true,
+	detail: true,
+	eventPhase: true,
+	metaKey: true,
+	pageX: true,
+	pageY: true,
+	shiftKey: true,
+	view: true,
+	"char": true,
+	charCode: true,
+	key: true,
+	keyCode: true,
+	button: true,
+	buttons: true,
+	clientX: true,
+	clientY: true,
+	offsetX: true,
+	offsetY: true,
+	pointerId: true,
+	pointerType: true,
+	screenX: true,
+	screenY: true,
+	targetTouches: true,
+	toElement: true,
+	touches: true,
+
+	which: function( event ) {
+		var button = event.button;
+
+		// Add which for key events
+		if ( event.which == null && rkeyEvent.test( event.type ) ) {
+			return event.charCode != null ? event.charCode : event.keyCode;
+		}
+
+		// Add which for click: 1 === left; 2 === middle; 3 === right
+		if ( !event.which && button !== undefined && rmouseEvent.test( event.type ) ) {
+			if ( button & 1 ) {
+				return 1;
+			}
+
+			if ( button & 2 ) {
+				return 3;
+			}
+
+			if ( button & 4 ) {
+				return 2;
+			}
+
+			return 0;
+		}
+
+		return event.which;
+	}
+}, jQuery.event.addProp );
+
+// Create mouseenter/leave events using mouseover/out and event-time checks
+// so that event delegation works in jQuery.
+// Do the same for pointerenter/pointerleave and pointerover/pointerout
+//
+// Support: Safari 7 only
+// Safari sends mouseenter too often; see:
+// https://bugs.chromium.org/p/chromium/issues/detail?id=470258
+// for the description of the bug (it existed in older Chrome versions as well).
+jQuery.each( {
+	mouseenter: "mouseover",
+	mouseleave: "mouseout",
+	pointerenter: "pointerover",
+	pointerleave: "pointerout"
+}, function( orig, fix ) {
+	jQuery.event.special[ orig ] = {
+		delegateType: fix,
+		bindType: fix,
+
+		handle: function( event ) {
+			var ret,
+				target = this,
+				related = event.relatedTarget,
+				handleObj = event.handleObj;
+
+			// For mouseenter/leave call the handler if related is outside the target.
+			// NB: No relatedTarget if the mouse left/entered the browser window
+			if ( !related || ( related !== target && !jQuery.contains( target, related ) ) ) {
+				event.type = handleObj.origType;
+				ret = handleObj.handler.apply( this, arguments );
+				event.type = fix;
+			}
+			return ret;
+		}
+	};
+} );
+
+jQuery.fn.extend( {
+
+	on: function( types, selector, data, fn ) {
+		return on( this, types, selector, data, fn );
+	},
+	one: function( types, selector, data, fn ) {
+		return on( this, types, selector, data, fn, 1 );
+	},
+	off: function( types, selector, fn ) {
+		var handleObj, type;
+		if ( types && types.preventDefault && types.handleObj ) {
+
+			// ( event )  dispatched jQuery.Event
+			handleObj = types.handleObj;
+			jQuery( types.delegateTarget ).off(
+				handleObj.namespace ?
+					handleObj.origType + "." + handleObj.namespace :
+					handleObj.origType,
+				handleObj.selector,
+				handleObj.handler
+			);
+			return this;
+		}
+		if ( typeof types === "object" ) {
+
+			// ( types-object [, selector] )
+			for ( type in types ) {
+				this.off( type, selector, types[ type ] );
+			}
+			return this;
+		}
+		if ( selector === false || typeof selector === "function" ) {
+
+			// ( types [, fn] )
+			fn = selector;
+			selector = undefined;
+		}
+		if ( fn === false ) {
+			fn = returnFalse;
+		}
+		return this.each( function() {
+			jQuery.event.remove( this, types, fn, selector );
+		} );
+	}
+} );
+
+
+var
+
+	/* eslint-disable max-len */
+
+	// See https://github.com/eslint/eslint/issues/3229
+	rxhtmlTag = /<(?!area|br|col|embed|hr|img|input|link|meta|param)(([a-z][^\/\0>\x20\t\r\n\f]*)[^>]*)\/>/gi,
+
+	/* eslint-enable */
+
+	// Support: IE <=10 - 11, Edge 12 - 13 only
+	// In IE/Edge using regex groups here causes severe slowdowns.
+	// See https://connect.microsoft.com/IE/feedback/details/1736512/
+	rnoInnerhtml = /<script|<style|<link/i,
+
+	// checked="checked" or checked
+	rchecked = /checked\s*(?:[^=]|=\s*.checked.)/i,
+	rcleanScript = /^\s*<!(?:\[CDATA\[|--)|(?:\]\]|--)>\s*$/g;
+
+// Prefer a tbody over its parent table for containing new rows
+function manipulationTarget( elem, content ) {
+	if ( nodeName( elem, "table" ) &&
+		nodeName( content.nodeType !== 11 ? content : content.firstChild, "tr" ) ) {
+
+		return jQuery( elem ).children( "tbody" )[ 0 ] || elem;
+	}
+
+	return elem;
+}
+
+// Replace/restore the type attribute of script elements for safe DOM manipulation
+function disableScript( elem ) {
+	elem.type = ( elem.getAttribute( "type" ) !== null ) + "/" + elem.type;
+	return elem;
+}
+function restoreScript( elem ) {
+	if ( ( elem.type || "" ).slice( 0, 5 ) === "true/" ) {
+		elem.type = elem.type.slice( 5 );
+	} else {
+		elem.removeAttribute( "type" );
+	}
+
+	return elem;
+}
+
+function cloneCopyEvent( src, dest ) {
+	var i, l, type, pdataOld, pdataCur, udataOld, udataCur, events;
+
+	if ( dest.nodeType !== 1 ) {
+		return;
+	}
+
+	// 1. Copy private data: events, handlers, etc.
+	if ( dataPriv.hasData( src ) ) {
+		pdataOld = dataPriv.access( src );
+		pdataCur = dataPriv.set( dest, pdataOld );
+		events = pdataOld.events;
+
+		if ( events ) {
+			delete pdataCur.handle;
+			pdataCur.events = {};
+
+			for ( type in events ) {
+				for ( i = 0, l = events[ type ].length; i < l; i++ ) {
+					jQuery.event.add( dest, type, events[ type ][ i ] );
+				}
+			}
+		}
+	}
+
+	// 2. Copy user data
+	if ( dataUser.hasData( src ) ) {
+		udataOld = dataUser.access( src );
+		udataCur = jQuery.extend( {}, udataOld );
+
+		dataUser.set( dest, udataCur );
+	}
+}
+
+// Fix IE bugs, see support tests
+function fixInput( src, dest ) {
+	var nodeName = dest.nodeName.toLowerCase();
+
+	// Fails to persist the checked state of a cloned checkbox or radio button.
+	if ( nodeName === "input" && rcheckableType.test( src.type ) ) {
+		dest.checked = src.checked;
+
+	// Fails to return the selected option to the default selected state when cloning options
+	} else if ( nodeName === "input" || nodeName === "textarea" ) {
+		dest.defaultValue = src.defaultValue;
+	}
+}
+
+function domManip( collection, args, callback, ignored ) {
+
+	// Flatten any nested arrays
+	args = concat.apply( [], args );
+
+	var fragment, first, scripts, hasScripts, node, doc,
+		i = 0,
+		l = collection.length,
+		iNoClone = l - 1,
+		value = args[ 0 ],
+		valueIsFunction = isFunction( value );
+
+	// We can't cloneNode fragments that contain checked, in WebKit
+	if ( valueIsFunction ||
+			( l > 1 && typeof value === "string" &&
+				!support.checkClone && rchecked.test( value ) ) ) {
+		return collection.each( function( index ) {
+			var self = collection.eq( index );
+			if ( valueIsFunction ) {
+				args[ 0 ] = value.call( this, index, self.html() );
+			}
+			domManip( self, args, callback, ignored );
+		} );
+	}
+
+	if ( l ) {
+		fragment = buildFragment( args, collection[ 0 ].ownerDocument, false, collection, ignored );
+		first = fragment.firstChild;
+
+		if ( fragment.childNodes.length === 1 ) {
+			fragment = first;
+		}
+
+		// Require either new content or an interest in ignored elements to invoke the callback
+		if ( first || ignored ) {
+			scripts = jQuery.map( getAll( fragment, "script" ), disableScript );
+			hasScripts = scripts.length;
+
+			// Use the original fragment for the last item
+			// instead of the first because it can end up
+			// being emptied incorrectly in certain situations (#8070).
+			for ( ; i < l; i++ ) {
+				node = fragment;
+
+				if ( i !== iNoClone ) {
+					node = jQuery.clone( node, true, true );
+
+					// Keep references to cloned scripts for later restoration
+					if ( hasScripts ) {
+
+						// Support: Android <=4.0 only, PhantomJS 1 only
+						// push.apply(_, arraylike) throws on ancient WebKit
+						jQuery.merge( scripts, getAll( node, "script" ) );
+					}
+				}
+
+				callback.call( collection[ i ], node, i );
+			}
+
+			if ( hasScripts ) {
+				doc = scripts[ scripts.length - 1 ].ownerDocument;
+
+				// Reenable scripts
+				jQuery.map( scripts, restoreScript );
+
+				// Evaluate executable scripts on first document insertion
+				for ( i = 0; i < hasScripts; i++ ) {
+					node = scripts[ i ];
+					if ( rscriptType.test( node.type || "" ) &&
+						!dataPriv.access( node, "globalEval" ) &&
+						jQuery.contains( doc, node ) ) {
+
+						if ( node.src && ( node.type || "" ).toLowerCase()  !== "module" ) {
+
+							// Optional AJAX dependency, but won't run scripts if not present
+							if ( jQuery._evalUrl ) {
+								jQuery._evalUrl( node.src );
+							}
+						} else {
+							DOMEval( node.textContent.replace( rcleanScript, "" ), doc, node );
+						}
+					}
+				}
+			}
+		}
+	}
+
+	return collection;
+}
+
+function remove( elem, selector, keepData ) {
+	var node,
+		nodes = selector ? jQuery.filter( selector, elem ) : elem,
+		i = 0;
+
+	for ( ; ( node = nodes[ i ] ) != null; i++ ) {
+		if ( !keepData && node.nodeType === 1 ) {
+			jQuery.cleanData( getAll( node ) );
+		}
+
+		if ( node.parentNode ) {
+			if ( keepData && jQuery.contains( node.ownerDocument, node ) ) {
+				setGlobalEval( getAll( node, "script" ) );
+			}
+			node.parentNode.removeChild( node );
+		}
+	}
+
+	return elem;
+}
+
+jQuery.extend( {
+	htmlPrefilter: function( html ) {
+		return html.replace( rxhtmlTag, "<$1></$2>" );
+	},
+
+	clone: function( elem, dataAndEvents, deepDataAndEvents ) {
+		var i, l, srcElements, destElements,
+			clone = elem.cloneNode( true ),
+			inPage = jQuery.contains( elem.ownerDocument, elem );
+
+		// Fix IE cloning issues
+		if ( !support.noCloneChecked && ( elem.nodeType === 1 || elem.nodeType === 11 ) &&
+				!jQuery.isXMLDoc( elem ) ) {
+
+			// We eschew Sizzle here for performance reasons: https://jsperf.com/getall-vs-sizzle/2
+			destElements = getAll( clone );
+			srcElements = getAll( elem );
+
+			for ( i = 0, l = srcElements.length; i < l; i++ ) {
+				fixInput( srcElements[ i ], destElements[ i ] );
+			}
+		}
+
+		// Copy the events from the original to the clone
+		if ( dataAndEvents ) {
+			if ( deepDataAndEvents ) {
+				srcElements = srcElements || getAll( elem );
+				destElements = destElements || getAll( clone );
+
+				for ( i = 0, l = srcElements.length; i < l; i++ ) {
+					cloneCopyEvent( srcElements[ i ], destElements[ i ] );
+				}
+			} else {
+				cloneCopyEvent( elem, clone );
+			}
+		}
+
+		// Preserve script evaluation history
+		destElements = getAll( clone, "script" );
+		if ( destElements.length > 0 ) {
+			setGlobalEval( destElements, !inPage && getAll( elem, "script" ) );
+		}
+
+		// Return the cloned set
+		return clone;
+	},
+
+	cleanData: function( elems ) {
+		var data, elem, type,
+			special = jQuery.event.special,
+			i = 0;
+
+		for ( ; ( elem = elems[ i ] ) !== undefined; i++ ) {
+			if ( acceptData( elem ) ) {
+				if ( ( data = elem[ dataPriv.expando ] ) ) {
+					if ( data.events ) {
+						for ( type in data.events ) {
+							if ( special[ type ] ) {
+								jQuery.event.remove( elem, type );
+
+							// This is a shortcut to avoid jQuery.event.remove's overhead
+							} else {
+								jQuery.removeEvent( elem, type, data.handle );
+							}
+						}
+					}
+
+					// Support: Chrome <=35 - 45+
+					// Assign undefined instead of using delete, see Data#remove
+					elem[ dataPriv.expando ] = undefined;
+				}
+				if ( elem[ dataUser.expando ] ) {
+
+					// Support: Chrome <=35 - 45+
+					// Assign undefined instead of using delete, see Data#remove
+					elem[ dataUser.expando ] = undefined;
+				}
+			}
+		}
+	}
+} );
+
+jQuery.fn.extend( {
+	detach: function( selector ) {
+		return remove( this, selector, true );
+	},
+
+	remove: function( selector ) {
+		return remove( this, selector );
+	},
+
+	text: function( value ) {
+		return access( this, function( value ) {
+			return value === undefined ?
+				jQuery.text( this ) :
+				this.empty().each( function() {
+					if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {
+						this.textContent = value;
+					}
+				} );
+		}, null, value, arguments.length );
+	},
+
+	append: function() {
+		return domManip( this, arguments, function( elem ) {
+			if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {
+				var target = manipulationTarget( this, elem );
+				target.appendChild( elem );
+			}
+		} );
+	},
+
+	prepend: function() {
+		return domManip( this, arguments, function( elem ) {
+			if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {
+				var target = manipulationTarget( this, elem );
+				target.insertBefore( elem, target.firstChild );
+			}
+		} );
+	},
+
+	before: function() {
+		return domManip( this, arguments, function( elem ) {
+			if ( this.parentNode ) {
+				this.parentNode.insertBefore( elem, this );
+			}
+		} );
+	},
+
+	after: function() {
+		return domManip( this, arguments, function( elem ) {
+			if ( this.parentNode ) {
+				this.parentNode.insertBefore( elem, this.nextSibling );
+			}
+		} );
+	},
+
+	empty: function() {
+		var elem,
+			i = 0;
+
+		for ( ; ( elem = this[ i ] ) != null; i++ ) {
+			if ( elem.nodeType === 1 ) {
+
+				// Prevent memory leaks
+				jQuery.cleanData( getAll( elem, false ) );
+
+				// Remove any remaining nodes
+				elem.textContent = "";
+			}
+		}
+
+		return this;
+	},
+
+	clone: function( dataAndEvents, deepDataAndEvents ) {
+		dataAndEvents = dataAndEvents == null ? false : dataAndEvents;
+		deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents;
+
+		return this.map( function() {
+			return jQuery.clone( this, dataAndEvents, deepDataAndEvents );
+		} );
+	},
+
+	html: function( value ) {
+		return access( this, function( value ) {
+			var elem = this[ 0 ] || {},
+				i = 0,
+				l = this.length;
+
+			if ( value === undefined && elem.nodeType === 1 ) {
+				return elem.innerHTML;
+			}
+
+			// See if we can take a shortcut and just use innerHTML
+			if ( typeof value === "string" && !rnoInnerhtml.test( value ) &&
+				!wrapMap[ ( rtagName.exec( value ) || [ "", "" ] )[ 1 ].toLowerCase() ] ) {
+
+				value = jQuery.htmlPrefilter( value );
+
+				try {
+					for ( ; i < l; i++ ) {
+						elem = this[ i ] || {};
+
+						// Remove element nodes and prevent memory leaks
+						if ( elem.nodeType === 1 ) {
+							jQuery.cleanData( getAll( elem, false ) );
+							elem.innerHTML = value;
+						}
+					}
+
+					elem = 0;
+
+				// If using innerHTML throws an exception, use the fallback method
+				} catch ( e ) {}
+			}
+
+			if ( elem ) {
+				this.empty().append( value );
+			}
+		}, null, value, arguments.length );
+	},
+
+	replaceWith: function() {
+		var ignored = [];
+
+		// Make the changes, replacing each non-ignored context element with the new content
+		return domManip( this, arguments, function( elem ) {
+			var parent = this.parentNode;
+
+			if ( jQuery.inArray( this, ignored ) < 0 ) {
+				jQuery.cleanData( getAll( this ) );
+				if ( parent ) {
+					parent.replaceChild( elem, this );
+				}
+			}
+
+		// Force callback invocation
+		}, ignored );
+	}
+} );
+
+jQuery.each( {
+	appendTo: "append",
+	prependTo: "prepend",
+	insertBefore: "before",
+	insertAfter: "after",
+	replaceAll: "replaceWith"
+}, function( name, original ) {
+	jQuery.fn[ name ] = function( selector ) {
+		var elems,
+			ret = [],
+			insert = jQuery( selector ),
+			last = insert.length - 1,
+			i = 0;
+
+		for ( ; i <= last; i++ ) {
+			elems = i === last ? this : this.clone( true );
+			jQuery( insert[ i ] )[ original ]( elems );
+
+			// Support: Android <=4.0 only, PhantomJS 1 only
+			// .get() because push.apply(_, arraylike) throws on ancient WebKit
+			push.apply( ret, elems.get() );
+		}
+
+		return this.pushStack( ret );
+	};
+} );
+var rnumnonpx = new RegExp( "^(" + pnum + ")(?!px)[a-z%]+$", "i" );
+
+var getStyles = function( elem ) {
+
+		// Support: IE <=11 only, Firefox <=30 (#15098, #14150)
+		// IE throws on elements created in popups
+		// FF meanwhile throws on frame elements through "defaultView.getComputedStyle"
+		var view = elem.ownerDocument.defaultView;
+
+		if ( !view || !view.opener ) {
+			view = window;
+		}
+
+		return view.getComputedStyle( elem );
+	};
+
+var rboxStyle = new RegExp( cssExpand.join( "|" ), "i" );
+
+
+
+( function() {
+
+	// Executing both pixelPosition & boxSizingReliable tests require only one layout
+	// so they're executed at the same time to save the second computation.
+	function computeStyleTests() {
+
+		// This is a singleton, we need to execute it only once
+		if ( !div ) {
+			return;
+		}
+
+		container.style.cssText = "position:absolute;left:-11111px;width:60px;" +
+			"margin-top:1px;padding:0;border:0";
+		div.style.cssText =
+			"position:relative;display:block;box-sizing:border-box;overflow:scroll;" +
+			"margin:auto;border:1px;padding:1px;" +
+			"width:60%;top:1%";
+		documentElement.appendChild( container ).appendChild( div );
+
+		var divStyle = window.getComputedStyle( div );
+		pixelPositionVal = divStyle.top !== "1%";
+
+		// Support: Android 4.0 - 4.3 only, Firefox <=3 - 44
+		reliableMarginLeftVal = roundPixelMeasures( divStyle.marginLeft ) === 12;
+
+		// Support: Android 4.0 - 4.3 only, Safari <=9.1 - 10.1, iOS <=7.0 - 9.3
+		// Some styles come back with percentage values, even though they shouldn't
+		div.style.right = "60%";
+		pixelBoxStylesVal = roundPixelMeasures( divStyle.right ) === 36;
+
+		// Support: IE 9 - 11 only
+		// Detect misreporting of content dimensions for box-sizing:border-box elements
+		boxSizingReliableVal = roundPixelMeasures( divStyle.width ) === 36;
+
+		// Support: IE 9 only
+		// Detect overflow:scroll screwiness (gh-3699)
+		div.style.position = "absolute";
+		scrollboxSizeVal = div.offsetWidth === 36 || "absolute";
+
+		documentElement.removeChild( container );
+
+		// Nullify the div so it wouldn't be stored in the memory and
+		// it will also be a sign that checks already performed
+		div = null;
+	}
+
+	function roundPixelMeasures( measure ) {
+		return Math.round( parseFloat( measure ) );
+	}
+
+	var pixelPositionVal, boxSizingReliableVal, scrollboxSizeVal, pixelBoxStylesVal,
+		reliableMarginLeftVal,
+		container = document.createElement( "div" ),
+		div = document.createElement( "div" );
+
+	// Finish early in limited (non-browser) environments
+	if ( !div.style ) {
+		return;
+	}
+
+	// Support: IE <=9 - 11 only
+	// Style of cloned element affects source element cloned (#8908)
+	div.style.backgroundClip = "content-box";
+	div.cloneNode( true ).style.backgroundClip = "";
+	support.clearCloneStyle = div.style.backgroundClip === "content-box";
+
+	jQuery.extend( support, {
+		boxSizingReliable: function() {
+			computeStyleTests();
+			return boxSizingReliableVal;
+		},
+		pixelBoxStyles: function() {
+			computeStyleTests();
+			return pixelBoxStylesVal;
+		},
+		pixelPosition: function() {
+			computeStyleTests();
+			return pixelPositionVal;
+		},
+		reliableMarginLeft: function() {
+			computeStyleTests();
+			return reliableMarginLeftVal;
+		},
+		scrollboxSize: function() {
+			computeStyleTests();
+			return scrollboxSizeVal;
+		}
+	} );
+} )();
+
+
+function curCSS( elem, name, computed ) {
+	var width, minWidth, maxWidth, ret,
+
+		// Support: Firefox 51+
+		// Retrieving style before computed somehow
+		// fixes an issue with getting wrong values
+		// on detached elements
+		style = elem.style;
+
+	computed = computed || getStyles( elem );
+
+	// getPropertyValue is needed for:
+	//   .css('filter') (IE 9 only, #12537)
+	//   .css('--customProperty) (#3144)
+	if ( computed ) {
+		ret = computed.getPropertyValue( name ) || computed[ name ];
+
+		if ( ret === "" && !jQuery.contains( elem.ownerDocument, elem ) ) {
+			ret = jQuery.style( elem, name );
+		}
+
+		// A tribute to the "awesome hack by Dean Edwards"
+		// Android Browser returns percentage for some values,
+		// but width seems to be reliably pixels.
+		// This is against the CSSOM draft spec:
+		// https://drafts.csswg.org/cssom/#resolved-values
+		if ( !support.pixelBoxStyles() && rnumnonpx.test( ret ) && rboxStyle.test( name ) ) {
+
+			// Remember the original values
+			width = style.width;
+			minWidth = style.minWidth;
+			maxWidth = style.maxWidth;
+
+			// Put in the new values to get a computed value out
+			style.minWidth = style.maxWidth = style.width = ret;
+			ret = computed.width;
+
+			// Revert the changed values
+			style.width = width;
+			style.minWidth = minWidth;
+			style.maxWidth = maxWidth;
+		}
+	}
+
+	return ret !== undefined ?
+
+		// Support: IE <=9 - 11 only
+		// IE returns zIndex value as an integer.
+		ret + "" :
+		ret;
+}
+
+
+function addGetHookIf( conditionFn, hookFn ) {
+
+	// Define the hook, we'll check on the first run if it's really needed.
+	return {
+		get: function() {
+			if ( conditionFn() ) {
+
+				// Hook not needed (or it's not possible to use it due
+				// to missing dependency), remove it.
+				delete this.get;
+				return;
+			}
+
+			// Hook needed; redefine it so that the support test is not executed again.
+			return ( this.get = hookFn ).apply( this, arguments );
+		}
+	};
+}
+
+
+var
+
+	// Swappable if display is none or starts with table
+	// except "table", "table-cell", or "table-caption"
+	// See here for display values: https://developer.mozilla.org/en-US/docs/CSS/display
+	rdisplayswap = /^(none|table(?!-c[ea]).+)/,
+	rcustomProp = /^--/,
+	cssShow = { position: "absolute", visibility: "hidden", display: "block" },
+	cssNormalTransform = {
+		letterSpacing: "0",
+		fontWeight: "400"
+	},
+
+	cssPrefixes = [ "Webkit", "Moz", "ms" ],
+	emptyStyle = document.createElement( "div" ).style;
+
+// Return a css property mapped to a potentially vendor prefixed property
+function vendorPropName( name ) {
+
+	// Shortcut for names that are not vendor prefixed
+	if ( name in emptyStyle ) {
+		return name;
+	}
+
+	// Check for vendor prefixed names
+	var capName = name[ 0 ].toUpperCase() + name.slice( 1 ),
+		i = cssPrefixes.length;
+
+	while ( i-- ) {
+		name = cssPrefixes[ i ] + capName;
+		if ( name in emptyStyle ) {
+			return name;
+		}
+	}
+}
+
+// Return a property mapped along what jQuery.cssProps suggests or to
+// a vendor prefixed property.
+function finalPropName( name ) {
+	var ret = jQuery.cssProps[ name ];
+	if ( !ret ) {
+		ret = jQuery.cssProps[ name ] = vendorPropName( name ) || name;
+	}
+	return ret;
+}
+
+function setPositiveNumber( elem, value, subtract ) {
+
+	// Any relative (+/-) values have already been
+	// normalized at this point
+	var matches = rcssNum.exec( value );
+	return matches ?
+
+		// Guard against undefined "subtract", e.g., when used as in cssHooks
+		Math.max( 0, matches[ 2 ] - ( subtract || 0 ) ) + ( matches[ 3 ] || "px" ) :
+		value;
+}
+
+function boxModelAdjustment( elem, dimension, box, isBorderBox, styles, computedVal ) {
+	var i = dimension === "width" ? 1 : 0,
+		extra = 0,
+		delta = 0;
+
+	// Adjustment may not be necessary
+	if ( box === ( isBorderBox ? "border" : "content" ) ) {
+		return 0;
+	}
+
+	for ( ; i < 4; i += 2 ) {
+
+		// Both box models exclude margin
+		if ( box === "margin" ) {
+			delta += jQuery.css( elem, box + cssExpand[ i ], true, styles );
+		}
+
+		// If we get here with a content-box, we're seeking "padding" or "border" or "margin"
+		if ( !isBorderBox ) {
+
+			// Add padding
+			delta += jQuery.css( elem, "padding" + cssExpand[ i ], true, styles );
+
+			// For "border" or "margin", add border
+			if ( box !== "padding" ) {
+				delta += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles );
+
+			// But still keep track of it otherwise
+			} else {
+				extra += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles );
+			}
+
+		// If we get here with a border-box (content + padding + border), we're seeking "content" or
+		// "padding" or "margin"
+		} else {
+
+			// For "content", subtract padding
+			if ( box === "content" ) {
+				delta -= jQuery.css( elem, "padding" + cssExpand[ i ], true, styles );
+			}
+
+			// For "content" or "padding", subtract border
+			if ( box !== "margin" ) {
+				delta -= jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles );
+			}
+		}
+	}
+
+	// Account for positive content-box scroll gutter when requested by providing computedVal
+	if ( !isBorderBox && computedVal >= 0 ) {
+
+		// offsetWidth/offsetHeight is a rounded sum of content, padding, scroll gutter, and border
+		// Assuming integer scroll gutter, subtract the rest and round down
+		delta += Math.max( 0, Math.ceil(
+			elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] -
+			computedVal -
+			delta -
+			extra -
+			0.5
+		) );
+	}
+
+	return delta;
+}
+
+function getWidthOrHeight( elem, dimension, extra ) {
+
+	// Start with computed style
+	var styles = getStyles( elem ),
+		val = curCSS( elem, dimension, styles ),
+		isBorderBox = jQuery.css( elem, "boxSizing", false, styles ) === "border-box",
+		valueIsBorderBox = isBorderBox;
+
+	// Support: Firefox <=54
+	// Return a confounding non-pixel value or feign ignorance, as appropriate.
+	if ( rnumnonpx.test( val ) ) {
+		if ( !extra ) {
+			return val;
+		}
+		val = "auto";
+	}
+
+	// Check for style in case a browser which returns unreliable values
+	// for getComputedStyle silently falls back to the reliable elem.style
+	valueIsBorderBox = valueIsBorderBox &&
+		( support.boxSizingReliable() || val === elem.style[ dimension ] );
+
+	// Fall back to offsetWidth/offsetHeight when value is "auto"
+	// This happens for inline elements with no explicit setting (gh-3571)
+	// Support: Android <=4.1 - 4.3 only
+	// Also use offsetWidth/offsetHeight for misreported inline dimensions (gh-3602)
+	if ( val === "auto" ||
+		!parseFloat( val ) && jQuery.css( elem, "display", false, styles ) === "inline" ) {
+
+		val = elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ];
+
+		// offsetWidth/offsetHeight provide border-box values
+		valueIsBorderBox = true;
+	}
+
+	// Normalize "" and auto
+	val = parseFloat( val ) || 0;
+
+	// Adjust for the element's box model
+	return ( val +
+		boxModelAdjustment(
+			elem,
+			dimension,
+			extra || ( isBorderBox ? "border" : "content" ),
+			valueIsBorderBox,
+			styles,
+
+			// Provide the current computed size to request scroll gutter calculation (gh-3589)
+			val
+		)
+	) + "px";
+}
+
+jQuery.extend( {
+
+	// Add in style property hooks for overriding the default
+	// behavior of getting and setting a style property
+	cssHooks: {
+		opacity: {
+			get: function( elem, computed ) {
+				if ( computed ) {
+
+					// We should always get a number back from opacity
+					var ret = curCSS( elem, "opacity" );
+					return ret === "" ? "1" : ret;
+				}
+			}
+		}
+	},
+
+	// Don't automatically add "px" to these possibly-unitless properties
+	cssNumber: {
+		"animationIterationCount": true,
+		"columnCount": true,
+		"fillOpacity": true,
+		"flexGrow": true,
+		"flexShrink": true,
+		"fontWeight": true,
+		"lineHeight": true,
+		"opacity": true,
+		"order": true,
+		"orphans": true,
+		"widows": true,
+		"zIndex": true,
+		"zoom": true
+	},
+
+	// Add in properties whose names you wish to fix before
+	// setting or getting the value
+	cssProps: {},
+
+	// Get and set the style property on a DOM Node
+	style: function( elem, name, value, extra ) {
+
+		// Don't set styles on text and comment nodes
+		if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) {
+			return;
+		}
+
+		// Make sure that we're working with the right name
+		var ret, type, hooks,
+			origName = camelCase( name ),
+			isCustomProp = rcustomProp.test( name ),
+			style = elem.style;
+
+		// Make sure that we're working with the right name. We don't
+		// want to query the value if it is a CSS custom property
+		// since they are user-defined.
+		if ( !isCustomProp ) {
+			name = finalPropName( origName );
+		}
+
+		// Gets hook for the prefixed version, then unprefixed version
+		hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ];
+
+		// Check if we're setting a value
+		if ( value !== undefined ) {
+			type = typeof value;
+
+			// Convert "+=" or "-=" to relative numbers (#7345)
+			if ( type === "string" && ( ret = rcssNum.exec( value ) ) && ret[ 1 ] ) {
+				value = adjustCSS( elem, name, ret );
+
+				// Fixes bug #9237
+				type = "number";
+			}
+
+			// Make sure that null and NaN values aren't set (#7116)
+			if ( value == null || value !== value ) {
+				return;
+			}
+
+			// If a number was passed in, add the unit (except for certain CSS properties)
+			if ( type === "number" ) {
+				value += ret && ret[ 3 ] || ( jQuery.cssNumber[ origName ] ? "" : "px" );
+			}
+
+			// background-* props affect original clone's values
+			if ( !support.clearCloneStyle && value === "" && name.indexOf( "background" ) === 0 ) {
+				style[ name ] = "inherit";
+			}
+
+			// If a hook was provided, use that value, otherwise just set the specified value
+			if ( !hooks || !( "set" in hooks ) ||
+				( value = hooks.set( elem, value, extra ) ) !== undefined ) {
+
+				if ( isCustomProp ) {
+					style.setProperty( name, value );
+				} else {
+					style[ name ] = value;
+				}
+			}
+
+		} else {
+
+			// If a hook was provided get the non-computed value from there
+			if ( hooks && "get" in hooks &&
+				( ret = hooks.get( elem, false, extra ) ) !== undefined ) {
+
+				return ret;
+			}
+
+			// Otherwise just get the value from the style object
+			return style[ name ];
+		}
+	},
+
+	css: function( elem, name, extra, styles ) {
+		var val, num, hooks,
+			origName = camelCase( name ),
+			isCustomProp = rcustomProp.test( name );
+
+		// Make sure that we're working with the right name. We don't
+		// want to modify the value if it is a CSS custom property
+		// since they are user-defined.
+		if ( !isCustomProp ) {
+			name = finalPropName( origName );
+		}
+
+		// Try prefixed name followed by the unprefixed name
+		hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ];
+
+		// If a hook was provided get the computed value from there
+		if ( hooks && "get" in hooks ) {
+			val = hooks.get( elem, true, extra );
+		}
+
+		// Otherwise, if a way to get the computed value exists, use that
+		if ( val === undefined ) {
+			val = curCSS( elem, name, styles );
+		}
+
+		// Convert "normal" to computed value
+		if ( val === "normal" && name in cssNormalTransform ) {
+			val = cssNormalTransform[ name ];
+		}
+
+		// Make numeric if forced or a qualifier was provided and val looks numeric
+		if ( extra === "" || extra ) {
+			num = parseFloat( val );
+			return extra === true || isFinite( num ) ? num || 0 : val;
+		}
+
+		return val;
+	}
+} );
+
+jQuery.each( [ "height", "width" ], function( i, dimension ) {
+	jQuery.cssHooks[ dimension ] = {
+		get: function( elem, computed, extra ) {
+			if ( computed ) {
+
+				// Certain elements can have dimension info if we invisibly show them
+				// but it must have a current display style that would benefit
+				return rdisplayswap.test( jQuery.css( elem, "display" ) ) &&
+
+					// Support: Safari 8+
+					// Table columns in Safari have non-zero offsetWidth & zero
+					// getBoundingClientRect().width unless display is changed.
+					// Support: IE <=11 only
+					// Running getBoundingClientRect on a disconnected node
+					// in IE throws an error.
+					( !elem.getClientRects().length || !elem.getBoundingClientRect().width ) ?
+						swap( elem, cssShow, function() {
+							return getWidthOrHeight( elem, dimension, extra );
+						} ) :
+						getWidthOrHeight( elem, dimension, extra );
+			}
+		},
+
+		set: function( elem, value, extra ) {
+			var matches,
+				styles = getStyles( elem ),
+				isBorderBox = jQuery.css( elem, "boxSizing", false, styles ) === "border-box",
+				subtract = extra && boxModelAdjustment(
+					elem,
+					dimension,
+					extra,
+					isBorderBox,
+					styles
+				);
+
+			// Account for unreliable border-box dimensions by comparing offset* to computed and
+			// faking a content-box to get border and padding (gh-3699)
+			if ( isBorderBox && support.scrollboxSize() === styles.position ) {
+				subtract -= Math.ceil(
+					elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] -
+					parseFloat( styles[ dimension ] ) -
+					boxModelAdjustment( elem, dimension, "border", false, styles ) -
+					0.5
+				);
+			}
+
+			// Convert to pixels if value adjustment is needed
+			if ( subtract && ( matches = rcssNum.exec( value ) ) &&
+				( matches[ 3 ] || "px" ) !== "px" ) {
+
+				elem.style[ dimension ] = value;
+				value = jQuery.css( elem, dimension );
+			}
+
+			return setPositiveNumber( elem, value, subtract );
+		}
+	};
+} );
+
+jQuery.cssHooks.marginLeft = addGetHookIf( support.reliableMarginLeft,
+	function( elem, computed ) {
+		if ( computed ) {
+			return ( parseFloat( curCSS( elem, "marginLeft" ) ) ||
+				elem.getBoundingClientRect().left -
+					swap( elem, { marginLeft: 0 }, function() {
+						return elem.getBoundingClientRect().left;
+					} )
+				) + "px";
+		}
+	}
+);
+
+// These hooks are used by animate to expand properties
+jQuery.each( {
+	margin: "",
+	padding: "",
+	border: "Width"
+}, function( prefix, suffix ) {
+	jQuery.cssHooks[ prefix + suffix ] = {
+		expand: function( value ) {
+			var i = 0,
+				expanded = {},
+
+				// Assumes a single number if not a string
+				parts = typeof value === "string" ? value.split( " " ) : [ value ];
+
+			for ( ; i < 4; i++ ) {
+				expanded[ prefix + cssExpand[ i ] + suffix ] =
+					parts[ i ] || parts[ i - 2 ] || parts[ 0 ];
+			}
+
+			return expanded;
+		}
+	};
+
+	if ( prefix !== "margin" ) {
+		jQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber;
+	}
+} );
+
+jQuery.fn.extend( {
+	css: function( name, value ) {
+		return access( this, function( elem, name, value ) {
+			var styles, len,
+				map = {},
+				i = 0;
+
+			if ( Array.isArray( name ) ) {
+				styles = getStyles( elem );
+				len = name.length;
+
+				for ( ; i < len; i++ ) {
+					map[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles );
+				}
+
+				return map;
+			}
+
+			return value !== undefined ?
+				jQuery.style( elem, name, value ) :
+				jQuery.css( elem, name );
+		}, name, value, arguments.length > 1 );
+	}
+} );
+
+
+function Tween( elem, options, prop, end, easing ) {
+	return new Tween.prototype.init( elem, options, prop, end, easing );
+}
+jQuery.Tween = Tween;
+
+Tween.prototype = {
+	constructor: Tween,
+	init: function( elem, options, prop, end, easing, unit ) {
+		this.elem = elem;
+		this.prop = prop;
+		this.easing = easing || jQuery.easing._default;
+		this.options = options;
+		this.start = this.now = this.cur();
+		this.end = end;
+		this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" );
+	},
+	cur: function() {
+		var hooks = Tween.propHooks[ this.prop ];
+
+		return hooks && hooks.get ?
+			hooks.get( this ) :
+			Tween.propHooks._default.get( this );
+	},
+	run: function( percent ) {
+		var eased,
+			hooks = Tween.propHooks[ this.prop ];
+
+		if ( this.options.duration ) {
+			this.pos = eased = jQuery.easing[ this.easing ](
+				percent, this.options.duration * percent, 0, 1, this.options.duration
+			);
+		} else {
+			this.pos = eased = percent;
+		}
+		this.now = ( this.end - this.start ) * eased + this.start;
+
+		if ( this.options.step ) {
+			this.options.step.call( this.elem, this.now, this );
+		}
+
+		if ( hooks && hooks.set ) {
+			hooks.set( this );
+		} else {
+			Tween.propHooks._default.set( this );
+		}
+		return this;
+	}
+};
+
+Tween.prototype.init.prototype = Tween.prototype;
+
+Tween.propHooks = {
+	_default: {
+		get: function( tween ) {
+			var result;
+
+			// Use a property on the element directly when it is not a DOM element,
+			// or when there is no matching style property that exists.
+			if ( tween.elem.nodeType !== 1 ||
+				tween.elem[ tween.prop ] != null && tween.elem.style[ tween.prop ] == null ) {
+				return tween.elem[ tween.prop ];
+			}
+
+			// Passing an empty string as a 3rd parameter to .css will automatically
+			// attempt a parseFloat and fallback to a string if the parse fails.
+			// Simple values such as "10px" are parsed to Float;
+			// complex values such as "rotate(1rad)" are returned as-is.
+			result = jQuery.css( tween.elem, tween.prop, "" );
+
+			// Empty strings, null, undefined and "auto" are converted to 0.
+			return !result || result === "auto" ? 0 : result;
+		},
+		set: function( tween ) {
+
+			// Use step hook for back compat.
+			// Use cssHook if its there.
+			// Use .style if available and use plain properties where available.
+			if ( jQuery.fx.step[ tween.prop ] ) {
+				jQuery.fx.step[ tween.prop ]( tween );
+			} else if ( tween.elem.nodeType === 1 &&
+				( tween.elem.style[ jQuery.cssProps[ tween.prop ] ] != null ||
+					jQuery.cssHooks[ tween.prop ] ) ) {
+				jQuery.style( tween.elem, tween.prop, tween.now + tween.unit );
+			} else {
+				tween.elem[ tween.prop ] = tween.now;
+			}
+		}
+	}
+};
+
+// Support: IE <=9 only
+// Panic based approach to setting things on disconnected nodes
+Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = {
+	set: function( tween ) {
+		if ( tween.elem.nodeType && tween.elem.parentNode ) {
+			tween.elem[ tween.prop ] = tween.now;
+		}
+	}
+};
+
+jQuery.easing = {
+	linear: function( p ) {
+		return p;
+	},
+	swing: function( p ) {
+		return 0.5 - Math.cos( p * Math.PI ) / 2;
+	},
+	_default: "swing"
+};
+
+jQuery.fx = Tween.prototype.init;
+
+// Back compat <1.8 extension point
+jQuery.fx.step = {};
+
+
+
+
+var
+	fxNow, inProgress,
+	rfxtypes = /^(?:toggle|show|hide)$/,
+	rrun = /queueHooks$/;
+
+function schedule() {
+	if ( inProgress ) {
+		if ( document.hidden === false && window.requestAnimationFrame ) {
+			window.requestAnimationFrame( schedule );
+		} else {
+			window.setTimeout( schedule, jQuery.fx.interval );
+		}
+
+		jQuery.fx.tick();
+	}
+}
+
+// Animations created synchronously will run synchronously
+function createFxNow() {
+	window.setTimeout( function() {
+		fxNow = undefined;
+	} );
+	return ( fxNow = Date.now() );
+}
+
+// Generate parameters to create a standard animation
+function genFx( type, includeWidth ) {
+	var which,
+		i = 0,
+		attrs = { height: type };
+
+	// If we include width, step value is 1 to do all cssExpand values,
+	// otherwise step value is 2 to skip over Left and Right
+	includeWidth = includeWidth ? 1 : 0;
+	for ( ; i < 4; i += 2 - includeWidth ) {
+		which = cssExpand[ i ];
+		attrs[ "margin" + which ] = attrs[ "padding" + which ] = type;
+	}
+
+	if ( includeWidth ) {
+		attrs.opacity = attrs.width = type;
+	}
+
+	return attrs;
+}
+
+function createTween( value, prop, animation ) {
+	var tween,
+		collection = ( Animation.tweeners[ prop ] || [] ).concat( Animation.tweeners[ "*" ] ),
+		index = 0,
+		length = collection.length;
+	for ( ; index < length; index++ ) {
+		if ( ( tween = collection[ index ].call( animation, prop, value ) ) ) {
+
+			// We're done with this property
+			return tween;
+		}
+	}
+}
+
+function defaultPrefilter( elem, props, opts ) {
+	var prop, value, toggle, hooks, oldfire, propTween, restoreDisplay, display,
+		isBox = "width" in props || "height" in props,
+		anim = this,
+		orig = {},
+		style = elem.style,
+		hidden = elem.nodeType && isHiddenWithinTree( elem ),
+		dataShow = dataPriv.get( elem, "fxshow" );
+
+	// Queue-skipping animations hijack the fx hooks
+	if ( !opts.queue ) {
+		hooks = jQuery._queueHooks( elem, "fx" );
+		if ( hooks.unqueued == null ) {
+			hooks.unqueued = 0;
+			oldfire = hooks.empty.fire;
+			hooks.empty.fire = function() {
+				if ( !hooks.unqueued ) {
+					oldfire();
+				}
+			};
+		}
+		hooks.unqueued++;
+
+		anim.always( function() {
+
+			// Ensure the complete handler is called before this completes
+			anim.always( function() {
+				hooks.unqueued--;
+				if ( !jQuery.queue( elem, "fx" ).length ) {
+					hooks.empty.fire();
+				}
+			} );
+		} );
+	}
+
+	// Detect show/hide animations
+	for ( prop in props ) {
+		value = props[ prop ];
+		if ( rfxtypes.test( value ) ) {
+			delete props[ prop ];
+			toggle = toggle || value === "toggle";
+			if ( value === ( hidden ? "hide" : "show" ) ) {
+
+				// Pretend to be hidden if this is a "show" and
+				// there is still data from a stopped show/hide
+				if ( value === "show" && dataShow && dataShow[ prop ] !== undefined ) {
+					hidden = true;
+
+				// Ignore all other no-op show/hide data
+				} else {
+					continue;
+				}
+			}
+			orig[ prop ] = dataShow && dataShow[ prop ] || jQuery.style( elem, prop );
+		}
+	}
+
+	// Bail out if this is a no-op like .hide().hide()
+	propTween = !jQuery.isEmptyObject( props );
+	if ( !propTween && jQuery.isEmptyObject( orig ) ) {
+		return;
+	}
+
+	// Restrict "overflow" and "display" styles during box animations
+	if ( isBox && elem.nodeType === 1 ) {
+
+		// Support: IE <=9 - 11, Edge 12 - 15
+		// Record all 3 overflow attributes because IE does not infer the shorthand
+		// from identically-valued overflowX and overflowY and Edge just mirrors
+		// the overflowX value there.
+		opts.overflow = [ style.overflow, style.overflowX, style.overflowY ];
+
+		// Identify a display type, preferring old show/hide data over the CSS cascade
+		restoreDisplay = dataShow && dataShow.display;
+		if ( restoreDisplay == null ) {
+			restoreDisplay = dataPriv.get( elem, "display" );
+		}
+		display = jQuery.css( elem, "display" );
+		if ( display === "none" ) {
+			if ( restoreDisplay ) {
+				display = restoreDisplay;
+			} else {
+
+				// Get nonempty value(s) by temporarily forcing visibility
+				showHide( [ elem ], true );
+				restoreDisplay = elem.style.display || restoreDisplay;
+				display = jQuery.css( elem, "display" );
+				showHide( [ elem ] );
+			}
+		}
+
+		// Animate inline elements as inline-block
+		if ( display === "inline" || display === "inline-block" && restoreDisplay != null ) {
+			if ( jQuery.css( elem, "float" ) === "none" ) {
+
+				// Restore the original display value at the end of pure show/hide animations
+				if ( !propTween ) {
+					anim.done( function() {
+						style.display = restoreDisplay;
+					} );
+					if ( restoreDisplay == null ) {
+						display = style.display;
+						restoreDisplay = display === "none" ? "" : display;
+					}
+				}
+				style.display = "inline-block";
+			}
+		}
+	}
+
+	if ( opts.overflow ) {
+		style.overflow = "hidden";
+		anim.always( function() {
+			style.overflow = opts.overflow[ 0 ];
+			style.overflowX = opts.overflow[ 1 ];
+			style.overflowY = opts.overflow[ 2 ];
+		} );
+	}
+
+	// Implement show/hide animations
+	propTween = false;
+	for ( prop in orig ) {
+
+		// General show/hide setup for this element animation
+		if ( !propTween ) {
+			if ( dataShow ) {
+				if ( "hidden" in dataShow ) {
+					hidden = dataShow.hidden;
+				}
+			} else {
+				dataShow = dataPriv.access( elem, "fxshow", { display: restoreDisplay } );
+			}
+
+			// Store hidden/visible for toggle so `.stop().toggle()` "reverses"
+			if ( toggle ) {
+				dataShow.hidden = !hidden;
+			}
+
+			// Show elements before animating them
+			if ( hidden ) {
+				showHide( [ elem ], true );
+			}
+
+			/* eslint-disable no-loop-func */
+
+			anim.done( function() {
+
+			/* eslint-enable no-loop-func */
+
+				// The final step of a "hide" animation is actually hiding the element
+				if ( !hidden ) {
+					showHide( [ elem ] );
+				}
+				dataPriv.remove( elem, "fxshow" );
+				for ( prop in orig ) {
+					jQuery.style( elem, prop, orig[ prop ] );
+				}
+			} );
+		}
+
+		// Per-property setup
+		propTween = createTween( hidden ? dataShow[ prop ] : 0, prop, anim );
+		if ( !( prop in dataShow ) ) {
+			dataShow[ prop ] = propTween.start;
+			if ( hidden ) {
+				propTween.end = propTween.start;
+				propTween.start = 0;
+			}
+		}
+	}
+}
+
+function propFilter( props, specialEasing ) {
+	var index, name, easing, value, hooks;
+
+	// camelCase, specialEasing and expand cssHook pass
+	for ( index in props ) {
+		name = camelCase( index );
+		easing = specialEasing[ name ];
+		value = props[ index ];
+		if ( Array.isArray( value ) ) {
+			easing = value[ 1 ];
+			value = props[ index ] = value[ 0 ];
+		}
+
+		if ( index !== name ) {
+			props[ name ] = value;
+			delete props[ index ];
+		}
+
+		hooks = jQuery.cssHooks[ name ];
+		if ( hooks && "expand" in hooks ) {
+			value = hooks.expand( value );
+			delete props[ name ];
+
+			// Not quite $.extend, this won't overwrite existing keys.
+			// Reusing 'index' because we have the correct "name"
+			for ( index in value ) {
+				if ( !( index in props ) ) {
+					props[ index ] = value[ index ];
+					specialEasing[ index ] = easing;
+				}
+			}
+		} else {
+			specialEasing[ name ] = easing;
+		}
+	}
+}
+
+function Animation( elem, properties, options ) {
+	var result,
+		stopped,
+		index = 0,
+		length = Animation.prefilters.length,
+		deferred = jQuery.Deferred().always( function() {
+
+			// Don't match elem in the :animated selector
+			delete tick.elem;
+		} ),
+		tick = function() {
+			if ( stopped ) {
+				return false;
+			}
+			var currentTime = fxNow || createFxNow(),
+				remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ),
+
+				// Support: Android 2.3 only
+				// Archaic crash bug won't allow us to use `1 - ( 0.5 || 0 )` (#12497)
+				temp = remaining / animation.duration || 0,
+				percent = 1 - temp,
+				index = 0,
+				length = animation.tweens.length;
+
+			for ( ; index < length; index++ ) {
+				animation.tweens[ index ].run( percent );
+			}
+
+			deferred.notifyWith( elem, [ animation, percent, remaining ] );
+
+			// If there's more to do, yield
+			if ( percent < 1 && length ) {
+				return remaining;
+			}
+
+			// If this was an empty animation, synthesize a final progress notification
+			if ( !length ) {
+				deferred.notifyWith( elem, [ animation, 1, 0 ] );
+			}
+
+			// Resolve the animation and report its conclusion
+			deferred.resolveWith( elem, [ animation ] );
+			return false;
+		},
+		animation = deferred.promise( {
+			elem: elem,
+			props: jQuery.extend( {}, properties ),
+			opts: jQuery.extend( true, {
+				specialEasing: {},
+				easing: jQuery.easing._default
+			}, options ),
+			originalProperties: properties,
+			originalOptions: options,
+			startTime: fxNow || createFxNow(),
+			duration: options.duration,
+			tweens: [],
+			createTween: function( prop, end ) {
+				var tween = jQuery.Tween( elem, animation.opts, prop, end,
+						animation.opts.specialEasing[ prop ] || animation.opts.easing );
+				animation.tweens.push( tween );
+				return tween;
+			},
+			stop: function( gotoEnd ) {
+				var index = 0,
+
+					// If we are going to the end, we want to run all the tweens
+					// otherwise we skip this part
+					length = gotoEnd ? animation.tweens.length : 0;
+				if ( stopped ) {
+					return this;
+				}
+				stopped = true;
+				for ( ; index < length; index++ ) {
+					animation.tweens[ index ].run( 1 );
+				}
+
+				// Resolve when we played the last frame; otherwise, reject
+				if ( gotoEnd ) {
+					deferred.notifyWith( elem, [ animation, 1, 0 ] );
+					deferred.resolveWith( elem, [ animation, gotoEnd ] );
+				} else {
+					deferred.rejectWith( elem, [ animation, gotoEnd ] );
+				}
+				return this;
+			}
+		} ),
+		props = animation.props;
+
+	propFilter( props, animation.opts.specialEasing );
+
+	for ( ; index < length; index++ ) {
+		result = Animation.prefilters[ index ].call( animation, elem, props, animation.opts );
+		if ( result ) {
+			if ( isFunction( result.stop ) ) {
+				jQuery._queueHooks( animation.elem, animation.opts.queue ).stop =
+					result.stop.bind( result );
+			}
+			return result;
+		}
+	}
+
+	jQuery.map( props, createTween, animation );
+
+	if ( isFunction( animation.opts.start ) ) {
+		animation.opts.start.call( elem, animation );
+	}
+
+	// Attach callbacks from options
+	animation
+		.progress( animation.opts.progress )
+		.done( animation.opts.done, animation.opts.complete )
+		.fail( animation.opts.fail )
+		.always( animation.opts.always );
+
+	jQuery.fx.timer(
+		jQuery.extend( tick, {
+			elem: elem,
+			anim: animation,
+			queue: animation.opts.queue
+		} )
+	);
+
+	return animation;
+}
+
+jQuery.Animation = jQuery.extend( Animation, {
+
+	tweeners: {
+		"*": [ function( prop, value ) {
+			var tween = this.createTween( prop, value );
+			adjustCSS( tween.elem, prop, rcssNum.exec( value ), tween );
+			return tween;
+		} ]
+	},
+
+	tweener: function( props, callback ) {
+		if ( isFunction( props ) ) {
+			callback = props;
+			props = [ "*" ];
+		} else {
+			props = props.match( rnothtmlwhite );
+		}
+
+		var prop,
+			index = 0,
+			length = props.length;
+
+		for ( ; index < length; index++ ) {
+			prop = props[ index ];
+			Animation.tweeners[ prop ] = Animation.tweeners[ prop ] || [];
+			Animation.tweeners[ prop ].unshift( callback );
+		}
+	},
+
+	prefilters: [ defaultPrefilter ],
+
+	prefilter: function( callback, prepend ) {
+		if ( prepend ) {
+			Animation.prefilters.unshift( callback );
+		} else {
+			Animation.prefilters.push( callback );
+		}
+	}
+} );
+
+jQuery.speed = function( speed, easing, fn ) {
+	var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : {
+		complete: fn || !fn && easing ||
+			isFunction( speed ) && speed,
+		duration: speed,
+		easing: fn && easing || easing && !isFunction( easing ) && easing
+	};
+
+	// Go to the end state if fx are off
+	if ( jQuery.fx.off ) {
+		opt.duration = 0;
+
+	} else {
+		if ( typeof opt.duration !== "number" ) {
+			if ( opt.duration in jQuery.fx.speeds ) {
+				opt.duration = jQuery.fx.speeds[ opt.duration ];
+
+			} else {
+				opt.duration = jQuery.fx.speeds._default;
+			}
+		}
+	}
+
+	// Normalize opt.queue - true/undefined/null -> "fx"
+	if ( opt.queue == null || opt.queue === true ) {
+		opt.queue = "fx";
+	}
+
+	// Queueing
+	opt.old = opt.complete;
+
+	opt.complete = function() {
+		if ( isFunction( opt.old ) ) {
+			opt.old.call( this );
+		}
+
+		if ( opt.queue ) {
+			jQuery.dequeue( this, opt.queue );
+		}
+	};
+
+	return opt;
+};
+
+jQuery.fn.extend( {
+	fadeTo: function( speed, to, easing, callback ) {
+
+		// Show any hidden elements after setting opacity to 0
+		return this.filter( isHiddenWithinTree ).css( "opacity", 0 ).show()
+
+			// Animate to the value specified
+			.end().animate( { opacity: to }, speed, easing, callback );
+	},
+	animate: function( prop, speed, easing, callback ) {
+		var empty = jQuery.isEmptyObject( prop ),
+			optall = jQuery.speed( speed, easing, callback ),
+			doAnimation = function() {
+
+				// Operate on a copy of prop so per-property easing won't be lost
+				var anim = Animation( this, jQuery.extend( {}, prop ), optall );
+
+				// Empty animations, or finishing resolves immediately
+				if ( empty || dataPriv.get( this, "finish" ) ) {
+					anim.stop( true );
+				}
+			};
+			doAnimation.finish = doAnimation;
+
+		return empty || optall.queue === false ?
+			this.each( doAnimation ) :
+			this.queue( optall.queue, doAnimation );
+	},
+	stop: function( type, clearQueue, gotoEnd ) {
+		var stopQueue = function( hooks ) {
+			var stop = hooks.stop;
+			delete hooks.stop;
+			stop( gotoEnd );
+		};
+
+		if ( typeof type !== "string" ) {
+			gotoEnd = clearQueue;
+			clearQueue = type;
+			type = undefined;
+		}
+		if ( clearQueue && type !== false ) {
+			this.queue( type || "fx", [] );
+		}
+
+		return this.each( function() {
+			var dequeue = true,
+				index = type != null && type + "queueHooks",
+				timers = jQuery.timers,
+				data = dataPriv.get( this );
+
+			if ( index ) {
+				if ( data[ index ] && data[ index ].stop ) {
+					stopQueue( data[ index ] );
+				}
+			} else {
+				for ( index in data ) {
+					if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) {
+						stopQueue( data[ index ] );
+					}
+				}
+			}
+
+			for ( index = timers.length; index--; ) {
+				if ( timers[ index ].elem === this &&
+					( type == null || timers[ index ].queue === type ) ) {
+
+					timers[ index ].anim.stop( gotoEnd );
+					dequeue = false;
+					timers.splice( index, 1 );
+				}
+			}
+
+			// Start the next in the queue if the last step wasn't forced.
+			// Timers currently will call their complete callbacks, which
+			// will dequeue but only if they were gotoEnd.
+			if ( dequeue || !gotoEnd ) {
+				jQuery.dequeue( this, type );
+			}
+		} );
+	},
+	finish: function( type ) {
+		if ( type !== false ) {
+			type = type || "fx";
+		}
+		return this.each( function() {
+			var index,
+				data = dataPriv.get( this ),
+				queue = data[ type + "queue" ],
+				hooks = data[ type + "queueHooks" ],
+				timers = jQuery.timers,
+				length = queue ? queue.length : 0;
+
+			// Enable finishing flag on private data
+			data.finish = true;
+
+			// Empty the queue first
+			jQuery.queue( this, type, [] );
+
+			if ( hooks && hooks.stop ) {
+				hooks.stop.call( this, true );
+			}
+
+			// Look for any active animations, and finish them
+			for ( index = timers.length; index--; ) {
+				if ( timers[ index ].elem === this && timers[ index ].queue === type ) {
+					timers[ index ].anim.stop( true );
+					timers.splice( index, 1 );
+				}
+			}
+
+			// Look for any animations in the old queue and finish them
+			for ( index = 0; index < length; index++ ) {
+				if ( queue[ index ] && queue[ index ].finish ) {
+					queue[ index ].finish.call( this );
+				}
+			}
+
+			// Turn off finishing flag
+			delete data.finish;
+		} );
+	}
+} );
+
+jQuery.each( [ "toggle", "show", "hide" ], function( i, name ) {
+	var cssFn = jQuery.fn[ name ];
+	jQuery.fn[ name ] = function( speed, easing, callback ) {
+		return speed == null || typeof speed === "boolean" ?
+			cssFn.apply( this, arguments ) :
+			this.animate( genFx( name, true ), speed, easing, callback );
+	};
+} );
+
+// Generate shortcuts for custom animations
+jQuery.each( {
+	slideDown: genFx( "show" ),
+	slideUp: genFx( "hide" ),
+	slideToggle: genFx( "toggle" ),
+	fadeIn: { opacity: "show" },
+	fadeOut: { opacity: "hide" },
+	fadeToggle: { opacity: "toggle" }
+}, function( name, props ) {
+	jQuery.fn[ name ] = function( speed, easing, callback ) {
+		return this.animate( props, speed, easing, callback );
+	};
+} );
+
+jQuery.timers = [];
+jQuery.fx.tick = function() {
+	var timer,
+		i = 0,
+		timers = jQuery.timers;
+
+	fxNow = Date.now();
+
+	for ( ; i < timers.length; i++ ) {
+		timer = timers[ i ];
+
+		// Run the timer and safely remove it when done (allowing for external removal)
+		if ( !timer() && timers[ i ] === timer ) {
+			timers.splice( i--, 1 );
+		}
+	}
+
+	if ( !timers.length ) {
+		jQuery.fx.stop();
+	}
+	fxNow = undefined;
+};
+
+jQuery.fx.timer = function( timer ) {
+	jQuery.timers.push( timer );
+	jQuery.fx.start();
+};
+
+jQuery.fx.interval = 13;
+jQuery.fx.start = function() {
+	if ( inProgress ) {
+		return;
+	}
+
+	inProgress = true;
+	schedule();
+};
+
+jQuery.fx.stop = function() {
+	inProgress = null;
+};
+
+jQuery.fx.speeds = {
+	slow: 600,
+	fast: 200,
+
+	// Default speed
+	_default: 400
+};
+
+
+// Based off of the plugin by Clint Helfers, with permission.
+// https://web.archive.org/web/20100324014747/http://blindsignals.com/index.php/2009/07/jquery-delay/
+jQuery.fn.delay = function( time, type ) {
+	time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time;
+	type = type || "fx";
+
+	return this.queue( type, function( next, hooks ) {
+		var timeout = window.setTimeout( next, time );
+		hooks.stop = function() {
+			window.clearTimeout( timeout );
+		};
+	} );
+};
+
+
+( function() {
+	var input = document.createElement( "input" ),
+		select = document.createElement( "select" ),
+		opt = select.appendChild( document.createElement( "option" ) );
+
+	input.type = "checkbox";
+
+	// Support: Android <=4.3 only
+	// Default value for a checkbox should be "on"
+	support.checkOn = input.value !== "";
+
+	// Support: IE <=11 only
+	// Must access selectedIndex to make default options select
+	support.optSelected = opt.selected;
+
+	// Support: IE <=11 only
+	// An input loses its value after becoming a radio
+	input = document.createElement( "input" );
+	input.value = "t";
+	input.type = "radio";
+	support.radioValue = input.value === "t";
+} )();
+
+
+var boolHook,
+	attrHandle = jQuery.expr.attrHandle;
+
+jQuery.fn.extend( {
+	attr: function( name, value ) {
+		return access( this, jQuery.attr, name, value, arguments.length > 1 );
+	},
+
+	removeAttr: function( name ) {
+		return this.each( function() {
+			jQuery.removeAttr( this, name );
+		} );
+	}
+} );
+
+jQuery.extend( {
+	attr: function( elem, name, value ) {
+		var ret, hooks,
+			nType = elem.nodeType;
+
+		// Don't get/set attributes on text, comment and attribute nodes
+		if ( nType === 3 || nType === 8 || nType === 2 ) {
+			return;
+		}
+
+		// Fallback to prop when attributes are not supported
+		if ( typeof elem.getAttribute === "undefined" ) {
+			return jQuery.prop( elem, name, value );
+		}
+
+		// Attribute hooks are determined by the lowercase version
+		// Grab necessary hook if one is defined
+		if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) {
+			hooks = jQuery.attrHooks[ name.toLowerCase() ] ||
+				( jQuery.expr.match.bool.test( name ) ? boolHook : undefined );
+		}
+
+		if ( value !== undefined ) {
+			if ( value === null ) {
+				jQuery.removeAttr( elem, name );
+				return;
+			}
+
+			if ( hooks && "set" in hooks &&
+				( ret = hooks.set( elem, value, name ) ) !== undefined ) {
+				return ret;
+			}
+
+			elem.setAttribute( name, value + "" );
+			return value;
+		}
+
+		if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) {
+			return ret;
+		}
+
+		ret = jQuery.find.attr( elem, name );
+
+		// Non-existent attributes return null, we normalize to undefined
+		return ret == null ? undefined : ret;
+	},
+
+	attrHooks: {
+		type: {
+			set: function( elem, value ) {
+				if ( !support.radioValue && value === "radio" &&
+					nodeName( elem, "input" ) ) {
+					var val = elem.value;
+					elem.setAttribute( "type", value );
+					if ( val ) {
+						elem.value = val;
+					}
+					return value;
+				}
+			}
+		}
+	},
+
+	removeAttr: function( elem, value ) {
+		var name,
+			i = 0,
+
+			// Attribute names can contain non-HTML whitespace characters
+			// https://html.spec.whatwg.org/multipage/syntax.html#attributes-2
+			attrNames = value && value.match( rnothtmlwhite );
+
+		if ( attrNames && elem.nodeType === 1 ) {
+			while ( ( name = attrNames[ i++ ] ) ) {
+				elem.removeAttribute( name );
+			}
+		}
+	}
+} );
+
+// Hooks for boolean attributes
+boolHook = {
+	set: function( elem, value, name ) {
+		if ( value === false ) {
+
+			// Remove boolean attributes when set to false
+			jQuery.removeAttr( elem, name );
+		} else {
+			elem.setAttribute( name, name );
+		}
+		return name;
+	}
+};
+
+jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( i, name ) {
+	var getter = attrHandle[ name ] || jQuery.find.attr;
+
+	attrHandle[ name ] = function( elem, name, isXML ) {
+		var ret, handle,
+			lowercaseName = name.toLowerCase();
+
+		if ( !isXML ) {
+
+			// Avoid an infinite loop by temporarily removing this function from the getter
+			handle = attrHandle[ lowercaseName ];
+			attrHandle[ lowercaseName ] = ret;
+			ret = getter( elem, name, isXML ) != null ?
+				lowercaseName :
+				null;
+			attrHandle[ lowercaseName ] = handle;
+		}
+		return ret;
+	};
+} );
+
+
+
+
+var rfocusable = /^(?:input|select|textarea|button)$/i,
+	rclickable = /^(?:a|area)$/i;
+
+jQuery.fn.extend( {
+	prop: function( name, value ) {
+		return access( this, jQuery.prop, name, value, arguments.length > 1 );
+	},
+
+	removeProp: function( name ) {
+		return this.each( function() {
+			delete this[ jQuery.propFix[ name ] || name ];
+		} );
+	}
+} );
+
+jQuery.extend( {
+	prop: function( elem, name, value ) {
+		var ret, hooks,
+			nType = elem.nodeType;
+
+		// Don't get/set properties on text, comment and attribute nodes
+		if ( nType === 3 || nType === 8 || nType === 2 ) {
+			return;
+		}
+
+		if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) {
+
+			// Fix name and attach hooks
+			name = jQuery.propFix[ name ] || name;
+			hooks = jQuery.propHooks[ name ];
+		}
+
+		if ( value !== undefined ) {
+			if ( hooks && "set" in hooks &&
+				( ret = hooks.set( elem, value, name ) ) !== undefined ) {
+				return ret;
+			}
+
+			return ( elem[ name ] = value );
+		}
+
+		if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) {
+			return ret;
+		}
+
+		return elem[ name ];
+	},
+
+	propHooks: {
+		tabIndex: {
+			get: function( elem ) {
+
+				// Support: IE <=9 - 11 only
+				// elem.tabIndex doesn't always return the
+				// correct value when it hasn't been explicitly set
+				// https://web.archive.org/web/20141116233347/http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/
+				// Use proper attribute retrieval(#12072)
+				var tabindex = jQuery.find.attr( elem, "tabindex" );
+
+				if ( tabindex ) {
+					return parseInt( tabindex, 10 );
+				}
+
+				if (
+					rfocusable.test( elem.nodeName ) ||
+					rclickable.test( elem.nodeName ) &&
+					elem.href
+				) {
+					return 0;
+				}
+
+				return -1;
+			}
+		}
+	},
+
+	propFix: {
+		"for": "htmlFor",
+		"class": "className"
+	}
+} );
+
+// Support: IE <=11 only
+// Accessing the selectedIndex property
+// forces the browser to respect setting selected
+// on the option
+// The getter ensures a default option is selected
+// when in an optgroup
+// eslint rule "no-unused-expressions" is disabled for this code
+// since it considers such accessions noop
+if ( !support.optSelected ) {
+	jQuery.propHooks.selected = {
+		get: function( elem ) {
+
+			/* eslint no-unused-expressions: "off" */
+
+			var parent = elem.parentNode;
+			if ( parent && parent.parentNode ) {
+				parent.parentNode.selectedIndex;
+			}
+			return null;
+		},
+		set: function( elem ) {
+
+			/* eslint no-unused-expressions: "off" */
+
+			var parent = elem.parentNode;
+			if ( parent ) {
+				parent.selectedIndex;
+
+				if ( parent.parentNode ) {
+					parent.parentNode.selectedIndex;
+				}
+			}
+		}
+	};
+}
+
+jQuery.each( [
+	"tabIndex",
+	"readOnly",
+	"maxLength",
+	"cellSpacing",
+	"cellPadding",
+	"rowSpan",
+	"colSpan",
+	"useMap",
+	"frameBorder",
+	"contentEditable"
+], function() {
+	jQuery.propFix[ this.toLowerCase() ] = this;
+} );
+
+
+
+
+	// Strip and collapse whitespace according to HTML spec
+	// https://infra.spec.whatwg.org/#strip-and-collapse-ascii-whitespace
+	function stripAndCollapse( value ) {
+		var tokens = value.match( rnothtmlwhite ) || [];
+		return tokens.join( " " );
+	}
+
+
+function getClass( elem ) {
+	return elem.getAttribute && elem.getAttribute( "class" ) || "";
+}
+
+function classesToArray( value ) {
+	if ( Array.isArray( value ) ) {
+		return value;
+	}
+	if ( typeof value === "string" ) {
+		return value.match( rnothtmlwhite ) || [];
+	}
+	return [];
+}
+
+jQuery.fn.extend( {
+	addClass: function( value ) {
+		var classes, elem, cur, curValue, clazz, j, finalValue,
+			i = 0;
+
+		if ( isFunction( value ) ) {
+			return this.each( function( j ) {
+				jQuery( this ).addClass( value.call( this, j, getClass( this ) ) );
+			} );
+		}
+
+		classes = classesToArray( value );
+
+		if ( classes.length ) {
+			while ( ( elem = this[ i++ ] ) ) {
+				curValue = getClass( elem );
+				cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " );
+
+				if ( cur ) {
+					j = 0;
+					while ( ( clazz = classes[ j++ ] ) ) {
+						if ( cur.indexOf( " " + clazz + " " ) < 0 ) {
+							cur += clazz + " ";
+						}
+					}
+
+					// Only assign if different to avoid unneeded rendering.
+					finalValue = stripAndCollapse( cur );
+					if ( curValue !== finalValue ) {
+						elem.setAttribute( "class", finalValue );
+					}
+				}
+			}
+		}
+
+		return this;
+	},
+
+	removeClass: function( value ) {
+		var classes, elem, cur, curValue, clazz, j, finalValue,
+			i = 0;
+
+		if ( isFunction( value ) ) {
+			return this.each( function( j ) {
+				jQuery( this ).removeClass( value.call( this, j, getClass( this ) ) );
+			} );
+		}
+
+		if ( !arguments.length ) {
+			return this.attr( "class", "" );
+		}
+
+		classes = classesToArray( value );
+
+		if ( classes.length ) {
+			while ( ( elem = this[ i++ ] ) ) {
+				curValue = getClass( elem );
+
+				// This expression is here for better compressibility (see addClass)
+				cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " );
+
+				if ( cur ) {
+					j = 0;
+					while ( ( clazz = classes[ j++ ] ) ) {
+
+						// Remove *all* instances
+						while ( cur.indexOf( " " + clazz + " " ) > -1 ) {
+							cur = cur.replace( " " + clazz + " ", " " );
+						}
+					}
+
+					// Only assign if different to avoid unneeded rendering.
+					finalValue = stripAndCollapse( cur );
+					if ( curValue !== finalValue ) {
+						elem.setAttribute( "class", finalValue );
+					}
+				}
+			}
+		}
+
+		return this;
+	},
+
+	toggleClass: function( value, stateVal ) {
+		var type = typeof value,
+			isValidValue = type === "string" || Array.isArray( value );
+
+		if ( typeof stateVal === "boolean" && isValidValue ) {
+			return stateVal ? this.addClass( value ) : this.removeClass( value );
+		}
+
+		if ( isFunction( value ) ) {
+			return this.each( function( i ) {
+				jQuery( this ).toggleClass(
+					value.call( this, i, getClass( this ), stateVal ),
+					stateVal
+				);
+			} );
+		}
+
+		return this.each( function() {
+			var className, i, self, classNames;
+
+			if ( isValidValue ) {
+
+				// Toggle individual class names
+				i = 0;
+				self = jQuery( this );
+				classNames = classesToArray( value );
+
+				while ( ( className = classNames[ i++ ] ) ) {
+
+					// Check each className given, space separated list
+					if ( self.hasClass( className ) ) {
+						self.removeClass( className );
+					} else {
+						self.addClass( className );
+					}
+				}
+
+			// Toggle whole class name
+			} else if ( value === undefined || type === "boolean" ) {
+				className = getClass( this );
+				if ( className ) {
+
+					// Store className if set
+					dataPriv.set( this, "__className__", className );
+				}
+
+				// If the element has a class name or if we're passed `false`,
+				// then remove the whole classname (if there was one, the above saved it).
+				// Otherwise bring back whatever was previously saved (if anything),
+				// falling back to the empty string if nothing was stored.
+				if ( this.setAttribute ) {
+					this.setAttribute( "class",
+						className || value === false ?
+						"" :
+						dataPriv.get( this, "__className__" ) || ""
+					);
+				}
+			}
+		} );
+	},
+
+	hasClass: function( selector ) {
+		var className, elem,
+			i = 0;
+
+		className = " " + selector + " ";
+		while ( ( elem = this[ i++ ] ) ) {
+			if ( elem.nodeType === 1 &&
+				( " " + stripAndCollapse( getClass( elem ) ) + " " ).indexOf( className ) > -1 ) {
+					return true;
+			}
+		}
+
+		return false;
+	}
+} );
+
+
+
+
+var rreturn = /\r/g;
+
+jQuery.fn.extend( {
+	val: function( value ) {
+		var hooks, ret, valueIsFunction,
+			elem = this[ 0 ];
+
+		if ( !arguments.length ) {
+			if ( elem ) {
+				hooks = jQuery.valHooks[ elem.type ] ||
+					jQuery.valHooks[ elem.nodeName.toLowerCase() ];
+
+				if ( hooks &&
+					"get" in hooks &&
+					( ret = hooks.get( elem, "value" ) ) !== undefined
+				) {
+					return ret;
+				}
+
+				ret = elem.value;
+
+				// Handle most common string cases
+				if ( typeof ret === "string" ) {
+					return ret.replace( rreturn, "" );
+				}
+
+				// Handle cases where value is null/undef or number
+				return ret == null ? "" : ret;
+			}
+
+			return;
+		}
+
+		valueIsFunction = isFunction( value );
+
+		return this.each( function( i ) {
+			var val;
+
+			if ( this.nodeType !== 1 ) {
+				return;
+			}
+
+			if ( valueIsFunction ) {
+				val = value.call( this, i, jQuery( this ).val() );
+			} else {
+				val = value;
+			}
+
+			// Treat null/undefined as ""; convert numbers to string
+			if ( val == null ) {
+				val = "";
+
+			} else if ( typeof val === "number" ) {
+				val += "";
+
+			} else if ( Array.isArray( val ) ) {
+				val = jQuery.map( val, function( value ) {
+					return value == null ? "" : value + "";
+				} );
+			}
+
+			hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ];
+
+			// If set returns undefined, fall back to normal setting
+			if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) {
+				this.value = val;
+			}
+		} );
+	}
+} );
+
+jQuery.extend( {
+	valHooks: {
+		option: {
+			get: function( elem ) {
+
+				var val = jQuery.find.attr( elem, "value" );
+				return val != null ?
+					val :
+
+					// Support: IE <=10 - 11 only
+					// option.text throws exceptions (#14686, #14858)
+					// Strip and collapse whitespace
+					// https://html.spec.whatwg.org/#strip-and-collapse-whitespace
+					stripAndCollapse( jQuery.text( elem ) );
+			}
+		},
+		select: {
+			get: function( elem ) {
+				var value, option, i,
+					options = elem.options,
+					index = elem.selectedIndex,
+					one = elem.type === "select-one",
+					values = one ? null : [],
+					max = one ? index + 1 : options.length;
+
+				if ( index < 0 ) {
+					i = max;
+
+				} else {
+					i = one ? index : 0;
+				}
+
+				// Loop through all the selected options
+				for ( ; i < max; i++ ) {
+					option = options[ i ];
+
+					// Support: IE <=9 only
+					// IE8-9 doesn't update selected after form reset (#2551)
+					if ( ( option.selected || i === index ) &&
+
+							// Don't return options that are disabled or in a disabled optgroup
+							!option.disabled &&
+							( !option.parentNode.disabled ||
+								!nodeName( option.parentNode, "optgroup" ) ) ) {
+
+						// Get the specific value for the option
+						value = jQuery( option ).val();
+
+						// We don't need an array for one selects
+						if ( one ) {
+							return value;
+						}
+
+						// Multi-Selects return an array
+						values.push( value );
+					}
+				}
+
+				return values;
+			},
+
+			set: function( elem, value ) {
+				var optionSet, option,
+					options = elem.options,
+					values = jQuery.makeArray( value ),
+					i = options.length;
+
+				while ( i-- ) {
+					option = options[ i ];
+
+					/* eslint-disable no-cond-assign */
+
+					if ( option.selected =
+						jQuery.inArray( jQuery.valHooks.option.get( option ), values ) > -1
+					) {
+						optionSet = true;
+					}
+
+					/* eslint-enable no-cond-assign */
+				}
+
+				// Force browsers to behave consistently when non-matching value is set
+				if ( !optionSet ) {
+					elem.selectedIndex = -1;
+				}
+				return values;
+			}
+		}
+	}
+} );
+
+// Radios and checkboxes getter/setter
+jQuery.each( [ "radio", "checkbox" ], function() {
+	jQuery.valHooks[ this ] = {
+		set: function( elem, value ) {
+			if ( Array.isArray( value ) ) {
+				return ( elem.checked = jQuery.inArray( jQuery( elem ).val(), value ) > -1 );
+			}
+		}
+	};
+	if ( !support.checkOn ) {
+		jQuery.valHooks[ this ].get = function( elem ) {
+			return elem.getAttribute( "value" ) === null ? "on" : elem.value;
+		};
+	}
+} );
+
+
+
+
+// Return jQuery for attributes-only inclusion
+
+
+support.focusin = "onfocusin" in window;
+
+
+var rfocusMorph = /^(?:focusinfocus|focusoutblur)$/,
+	stopPropagationCallback = function( e ) {
+		e.stopPropagation();
+	};
+
+jQuery.extend( jQuery.event, {
+
+	trigger: function( event, data, elem, onlyHandlers ) {
+
+		var i, cur, tmp, bubbleType, ontype, handle, special, lastElement,
+			eventPath = [ elem || document ],
+			type = hasOwn.call( event, "type" ) ? event.type : event,
+			namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split( "." ) : [];
+
+		cur = lastElement = tmp = elem = elem || document;
+
+		// Don't do events on text and comment nodes
+		if ( elem.nodeType === 3 || elem.nodeType === 8 ) {
+			return;
+		}
+
+		// focus/blur morphs to focusin/out; ensure we're not firing them right now
+		if ( rfocusMorph.test( type + jQuery.event.triggered ) ) {
+			return;
+		}
+
+		if ( type.indexOf( "." ) > -1 ) {
+
+			// Namespaced trigger; create a regexp to match event type in handle()
+			namespaces = type.split( "." );
+			type = namespaces.shift();
+			namespaces.sort();
+		}
+		ontype = type.indexOf( ":" ) < 0 && "on" + type;
+
+		// Caller can pass in a jQuery.Event object, Object, or just an event type string
+		event = event[ jQuery.expando ] ?
+			event :
+			new jQuery.Event( type, typeof event === "object" && event );
+
+		// Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true)
+		event.isTrigger = onlyHandlers ? 2 : 3;
+		event.namespace = namespaces.join( "." );
+		event.rnamespace = event.namespace ?
+			new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ) :
+			null;
+
+		// Clean up the event in case it is being reused
+		event.result = undefined;
+		if ( !event.target ) {
+			event.target = elem;
+		}
+
+		// Clone any incoming data and prepend the event, creating the handler arg list
+		data = data == null ?
+			[ event ] :
+			jQuery.makeArray( data, [ event ] );
+
+		// Allow special events to draw outside the lines
+		special = jQuery.event.special[ type ] || {};
+		if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) {
+			return;
+		}
+
+		// Determine event propagation path in advance, per W3C events spec (#9951)
+		// Bubble up to document, then to window; watch for a global ownerDocument var (#9724)
+		if ( !onlyHandlers && !special.noBubble && !isWindow( elem ) ) {
+
+			bubbleType = special.delegateType || type;
+			if ( !rfocusMorph.test( bubbleType + type ) ) {
+				cur = cur.parentNode;
+			}
+			for ( ; cur; cur = cur.parentNode ) {
+				eventPath.push( cur );
+				tmp = cur;
+			}
+
+			// Only add window if we got to document (e.g., not plain obj or detached DOM)
+			if ( tmp === ( elem.ownerDocument || document ) ) {
+				eventPath.push( tmp.defaultView || tmp.parentWindow || window );
+			}
+		}
+
+		// Fire handlers on the event path
+		i = 0;
+		while ( ( cur = eventPath[ i++ ] ) && !event.isPropagationStopped() ) {
+			lastElement = cur;
+			event.type = i > 1 ?
+				bubbleType :
+				special.bindType || type;
+
+			// jQuery handler
+			handle = ( dataPriv.get( cur, "events" ) || {} )[ event.type ] &&
+				dataPriv.get( cur, "handle" );
+			if ( handle ) {
+				handle.apply( cur, data );
+			}
+
+			// Native handler
+			handle = ontype && cur[ ontype ];
+			if ( handle && handle.apply && acceptData( cur ) ) {
+				event.result = handle.apply( cur, data );
+				if ( event.result === false ) {
+					event.preventDefault();
+				}
+			}
+		}
+		event.type = type;
+
+		// If nobody prevented the default action, do it now
+		if ( !onlyHandlers && !event.isDefaultPrevented() ) {
+
+			if ( ( !special._default ||
+				special._default.apply( eventPath.pop(), data ) === false ) &&
+				acceptData( elem ) ) {
+
+				// Call a native DOM method on the target with the same name as the event.
+				// Don't do default actions on window, that's where global variables be (#6170)
+				if ( ontype && isFunction( elem[ type ] ) && !isWindow( elem ) ) {
+
+					// Don't re-trigger an onFOO event when we call its FOO() method
+					tmp = elem[ ontype ];
+
+					if ( tmp ) {
+						elem[ ontype ] = null;
+					}
+
+					// Prevent re-triggering of the same event, since we already bubbled it above
+					jQuery.event.triggered = type;
+
+					if ( event.isPropagationStopped() ) {
+						lastElement.addEventListener( type, stopPropagationCallback );
+					}
+
+					elem[ type ]();
+
+					if ( event.isPropagationStopped() ) {
+						lastElement.removeEventListener( type, stopPropagationCallback );
+					}
+
+					jQuery.event.triggered = undefined;
+
+					if ( tmp ) {
+						elem[ ontype ] = tmp;
+					}
+				}
+			}
+		}
+
+		return event.result;
+	},
+
+	// Piggyback on a donor event to simulate a different one
+	// Used only for `focus(in | out)` events
+	simulate: function( type, elem, event ) {
+		var e = jQuery.extend(
+			new jQuery.Event(),
+			event,
+			{
+				type: type,
+				isSimulated: true
+			}
+		);
+
+		jQuery.event.trigger( e, null, elem );
+	}
+
+} );
+
+jQuery.fn.extend( {
+
+	trigger: function( type, data ) {
+		return this.each( function() {
+			jQuery.event.trigger( type, data, this );
+		} );
+	},
+	triggerHandler: function( type, data ) {
+		var elem = this[ 0 ];
+		if ( elem ) {
+			return jQuery.event.trigger( type, data, elem, true );
+		}
+	}
+} );
+
+
+// Support: Firefox <=44
+// Firefox doesn't have focus(in | out) events
+// Related ticket - https://bugzilla.mozilla.org/show_bug.cgi?id=687787
+//
+// Support: Chrome <=48 - 49, Safari <=9.0 - 9.1
+// focus(in | out) events fire after focus & blur events,
+// which is spec violation - http://www.w3.org/TR/DOM-Level-3-Events/#events-focusevent-event-order
+// Related ticket - https://bugs.chromium.org/p/chromium/issues/detail?id=449857
+if ( !support.focusin ) {
+	jQuery.each( { focus: "focusin", blur: "focusout" }, function( orig, fix ) {
+
+		// Attach a single capturing handler on the document while someone wants focusin/focusout
+		var handler = function( event ) {
+			jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ) );
+		};
+
+		jQuery.event.special[ fix ] = {
+			setup: function() {
+				var doc = this.ownerDocument || this,
+					attaches = dataPriv.access( doc, fix );
+
+				if ( !attaches ) {
+					doc.addEventListener( orig, handler, true );
+				}
+				dataPriv.access( doc, fix, ( attaches || 0 ) + 1 );
+			},
+			teardown: function() {
+				var doc = this.ownerDocument || this,
+					attaches = dataPriv.access( doc, fix ) - 1;
+
+				if ( !attaches ) {
+					doc.removeEventListener( orig, handler, true );
+					dataPriv.remove( doc, fix );
+
+				} else {
+					dataPriv.access( doc, fix, attaches );
+				}
+			}
+		};
+	} );
+}
+var location = window.location;
+
+var nonce = Date.now();
+
+var rquery = ( /\?/ );
+
+
+
+// Cross-browser xml parsing
+jQuery.parseXML = function( data ) {
+	var xml;
+	if ( !data || typeof data !== "string" ) {
+		return null;
+	}
+
+	// Support: IE 9 - 11 only
+	// IE throws on parseFromString with invalid input.
+	try {
+		xml = ( new window.DOMParser() ).parseFromString( data, "text/xml" );
+	} catch ( e ) {
+		xml = undefined;
+	}
+
+	if ( !xml || xml.getElementsByTagName( "parsererror" ).length ) {
+		jQuery.error( "Invalid XML: " + data );
+	}
+	return xml;
+};
+
+
+var
+	rbracket = /\[\]$/,
+	rCRLF = /\r?\n/g,
+	rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i,
+	rsubmittable = /^(?:input|select|textarea|keygen)/i;
+
+function buildParams( prefix, obj, traditional, add ) {
+	var name;
+
+	if ( Array.isArray( obj ) ) {
+
+		// Serialize array item.
+		jQuery.each( obj, function( i, v ) {
+			if ( traditional || rbracket.test( prefix ) ) {
+
+				// Treat each array item as a scalar.
+				add( prefix, v );
+
+			} else {
+
+				// Item is non-scalar (array or object), encode its numeric index.
+				buildParams(
+					prefix + "[" + ( typeof v === "object" && v != null ? i : "" ) + "]",
+					v,
+					traditional,
+					add
+				);
+			}
+		} );
+
+	} else if ( !traditional && toType( obj ) === "object" ) {
+
+		// Serialize object item.
+		for ( name in obj ) {
+			buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add );
+		}
+
+	} else {
+
+		// Serialize scalar item.
+		add( prefix, obj );
+	}
+}
+
+// Serialize an array of form elements or a set of
+// key/values into a query string
+jQuery.param = function( a, traditional ) {
+	var prefix,
+		s = [],
+		add = function( key, valueOrFunction ) {
+
+			// If value is a function, invoke it and use its return value
+			var value = isFunction( valueOrFunction ) ?
+				valueOrFunction() :
+				valueOrFunction;
+
+			s[ s.length ] = encodeURIComponent( key ) + "=" +
+				encodeURIComponent( value == null ? "" : value );
+		};
+
+	// If an array was passed in, assume that it is an array of form elements.
+	if ( Array.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) {
+
+		// Serialize the form elements
+		jQuery.each( a, function() {
+			add( this.name, this.value );
+		} );
+
+	} else {
+
+		// If traditional, encode the "old" way (the way 1.3.2 or older
+		// did it), otherwise encode params recursively.
+		for ( prefix in a ) {
+			buildParams( prefix, a[ prefix ], traditional, add );
+		}
+	}
+
+	// Return the resulting serialization
+	return s.join( "&" );
+};
+
+jQuery.fn.extend( {
+	serialize: function() {
+		return jQuery.param( this.serializeArray() );
+	},
+	serializeArray: function() {
+		return this.map( function() {
+
+			// Can add propHook for "elements" to filter or add form elements
+			var elements = jQuery.prop( this, "elements" );
+			return elements ? jQuery.makeArray( elements ) : this;
+		} )
+		.filter( function() {
+			var type = this.type;
+
+			// Use .is( ":disabled" ) so that fieldset[disabled] works
+			return this.name && !jQuery( this ).is( ":disabled" ) &&
+				rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) &&
+				( this.checked || !rcheckableType.test( type ) );
+		} )
+		.map( function( i, elem ) {
+			var val = jQuery( this ).val();
+
+			if ( val == null ) {
+				return null;
+			}
+
+			if ( Array.isArray( val ) ) {
+				return jQuery.map( val, function( val ) {
+					return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) };
+				} );
+			}
+
+			return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) };
+		} ).get();
+	}
+} );
+
+
+var
+	r20 = /%20/g,
+	rhash = /#.*$/,
+	rantiCache = /([?&])_=[^&]*/,
+	rheaders = /^(.*?):[ \t]*([^\r\n]*)$/mg,
+
+	// #7653, #8125, #8152: local protocol detection
+	rlocalProtocol = /^(?:about|app|app-storage|.+-extension|file|res|widget):$/,
+	rnoContent = /^(?:GET|HEAD)$/,
+	rprotocol = /^\/\//,
+
+	/* Prefilters
+	 * 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example)
+	 * 2) These are called:
+	 *    - BEFORE asking for a transport
+	 *    - AFTER param serialization (s.data is a string if s.processData is true)
+	 * 3) key is the dataType
+	 * 4) the catchall symbol "*" can be used
+	 * 5) execution will start with transport dataType and THEN continue down to "*" if needed
+	 */
+	prefilters = {},
+
+	/* Transports bindings
+	 * 1) key is the dataType
+	 * 2) the catchall symbol "*" can be used
+	 * 3) selection will start with transport dataType and THEN go to "*" if needed
+	 */
+	transports = {},
+
+	// Avoid comment-prolog char sequence (#10098); must appease lint and evade compression
+	allTypes = "*/".concat( "*" ),
+
+	// Anchor tag for parsing the document origin
+	originAnchor = document.createElement( "a" );
+	originAnchor.href = location.href;
+
+// Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport
+function addToPrefiltersOrTransports( structure ) {
+
+	// dataTypeExpression is optional and defaults to "*"
+	return function( dataTypeExpression, func ) {
+
+		if ( typeof dataTypeExpression !== "string" ) {
+			func = dataTypeExpression;
+			dataTypeExpression = "*";
+		}
+
+		var dataType,
+			i = 0,
+			dataTypes = dataTypeExpression.toLowerCase().match( rnothtmlwhite ) || [];
+
+		if ( isFunction( func ) ) {
+
+			// For each dataType in the dataTypeExpression
+			while ( ( dataType = dataTypes[ i++ ] ) ) {
+
+				// Prepend if requested
+				if ( dataType[ 0 ] === "+" ) {
+					dataType = dataType.slice( 1 ) || "*";
+					( structure[ dataType ] = structure[ dataType ] || [] ).unshift( func );
+
+				// Otherwise append
+				} else {
+					( structure[ dataType ] = structure[ dataType ] || [] ).push( func );
+				}
+			}
+		}
+	};
+}
+
+// Base inspection function for prefilters and transports
+function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR ) {
+
+	var inspected = {},
+		seekingTransport = ( structure === transports );
+
+	function inspect( dataType ) {
+		var selected;
+		inspected[ dataType ] = true;
+		jQuery.each( structure[ dataType ] || [], function( _, prefilterOrFactory ) {
+			var dataTypeOrTransport = prefilterOrFactory( options, originalOptions, jqXHR );
+			if ( typeof dataTypeOrTransport === "string" &&
+				!seekingTransport && !inspected[ dataTypeOrTransport ] ) {
+
+				options.dataTypes.unshift( dataTypeOrTransport );
+				inspect( dataTypeOrTransport );
+				return false;
+			} else if ( seekingTransport ) {
+				return !( selected = dataTypeOrTransport );
+			}
+		} );
+		return selected;
+	}
+
+	return inspect( options.dataTypes[ 0 ] ) || !inspected[ "*" ] && inspect( "*" );
+}
+
+// A special extend for ajax options
+// that takes "flat" options (not to be deep extended)
+// Fixes #9887
+function ajaxExtend( target, src ) {
+	var key, deep,
+		flatOptions = jQuery.ajaxSettings.flatOptions || {};
+
+	for ( key in src ) {
+		if ( src[ key ] !== undefined ) {
+			( flatOptions[ key ] ? target : ( deep || ( deep = {} ) ) )[ key ] = src[ key ];
+		}
+	}
+	if ( deep ) {
+		jQuery.extend( true, target, deep );
+	}
+
+	return target;
+}
+
+/* Handles responses to an ajax request:
+ * - finds the right dataType (mediates between content-type and expected dataType)
+ * - returns the corresponding response
+ */
+function ajaxHandleResponses( s, jqXHR, responses ) {
+
+	var ct, type, finalDataType, firstDataType,
+		contents = s.contents,
+		dataTypes = s.dataTypes;
+
+	// Remove auto dataType and get content-type in the process
+	while ( dataTypes[ 0 ] === "*" ) {
+		dataTypes.shift();
+		if ( ct === undefined ) {
+			ct = s.mimeType || jqXHR.getResponseHeader( "Content-Type" );
+		}
+	}
+
+	// Check if we're dealing with a known content-type
+	if ( ct ) {
+		for ( type in contents ) {
+			if ( contents[ type ] && contents[ type ].test( ct ) ) {
+				dataTypes.unshift( type );
+				break;
+			}
+		}
+	}
+
+	// Check to see if we have a response for the expected dataType
+	if ( dataTypes[ 0 ] in responses ) {
+		finalDataType = dataTypes[ 0 ];
+	} else {
+
+		// Try convertible dataTypes
+		for ( type in responses ) {
+			if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[ 0 ] ] ) {
+				finalDataType = type;
+				break;
+			}
+			if ( !firstDataType ) {
+				firstDataType = type;
+			}
+		}
+
+		// Or just use first one
+		finalDataType = finalDataType || firstDataType;
+	}
+
+	// If we found a dataType
+	// We add the dataType to the list if needed
+	// and return the corresponding response
+	if ( finalDataType ) {
+		if ( finalDataType !== dataTypes[ 0 ] ) {
+			dataTypes.unshift( finalDataType );
+		}
+		return responses[ finalDataType ];
+	}
+}
+
+/* Chain conversions given the request and the original response
+ * Also sets the responseXXX fields on the jqXHR instance
+ */
+function ajaxConvert( s, response, jqXHR, isSuccess ) {
+	var conv2, current, conv, tmp, prev,
+		converters = {},
+
+		// Work with a copy of dataTypes in case we need to modify it for conversion
+		dataTypes = s.dataTypes.slice();
+
+	// Create converters map with lowercased keys
+	if ( dataTypes[ 1 ] ) {
+		for ( conv in s.converters ) {
+			converters[ conv.toLowerCase() ] = s.converters[ conv ];
+		}
+	}
+
+	current = dataTypes.shift();
+
+	// Convert to each sequential dataType
+	while ( current ) {
+
+		if ( s.responseFields[ current ] ) {
+			jqXHR[ s.responseFields[ current ] ] = response;
+		}
+
+		// Apply the dataFilter if provided
+		if ( !prev && isSuccess && s.dataFilter ) {
+			response = s.dataFilter( response, s.dataType );
+		}
+
+		prev = current;
+		current = dataTypes.shift();
+
+		if ( current ) {
+
+			// There's only work to do if current dataType is non-auto
+			if ( current === "*" ) {
+
+				current = prev;
+
+			// Convert response if prev dataType is non-auto and differs from current
+			} else if ( prev !== "*" && prev !== current ) {
+
+				// Seek a direct converter
+				conv = converters[ prev + " " + current ] || converters[ "* " + current ];
+
+				// If none found, seek a pair
+				if ( !conv ) {
+					for ( conv2 in converters ) {
+
+						// If conv2 outputs current
+						tmp = conv2.split( " " );
+						if ( tmp[ 1 ] === current ) {
+
+							// If prev can be converted to accepted input
+							conv = converters[ prev + " " + tmp[ 0 ] ] ||
+								converters[ "* " + tmp[ 0 ] ];
+							if ( conv ) {
+
+								// Condense equivalence converters
+								if ( conv === true ) {
+									conv = converters[ conv2 ];
+
+								// Otherwise, insert the intermediate dataType
+								} else if ( converters[ conv2 ] !== true ) {
+									current = tmp[ 0 ];
+									dataTypes.unshift( tmp[ 1 ] );
+								}
+								break;
+							}
+						}
+					}
+				}
+
+				// Apply converter (if not an equivalence)
+				if ( conv !== true ) {
+
+					// Unless errors are allowed to bubble, catch and return them
+					if ( conv && s.throws ) {
+						response = conv( response );
+					} else {
+						try {
+							response = conv( response );
+						} catch ( e ) {
+							return {
+								state: "parsererror",
+								error: conv ? e : "No conversion from " + prev + " to " + current
+							};
+						}
+					}
+				}
+			}
+		}
+	}
+
+	return { state: "success", data: response };
+}
+
+jQuery.extend( {
+
+	// Counter for holding the number of active queries
+	active: 0,
+
+	// Last-Modified header cache for next request
+	lastModified: {},
+	etag: {},
+
+	ajaxSettings: {
+		url: location.href,
+		type: "GET",
+		isLocal: rlocalProtocol.test( location.protocol ),
+		global: true,
+		processData: true,
+		async: true,
+		contentType: "application/x-www-form-urlencoded; charset=UTF-8",
+
+		/*
+		timeout: 0,
+		data: null,
+		dataType: null,
+		username: null,
+		password: null,
+		cache: null,
+		throws: false,
+		traditional: false,
+		headers: {},
+		*/
+
+		accepts: {
+			"*": allTypes,
+			text: "text/plain",
+			html: "text/html",
+			xml: "application/xml, text/xml",
+			json: "application/json, text/javascript"
+		},
+
+		contents: {
+			xml: /\bxml\b/,
+			html: /\bhtml/,
+			json: /\bjson\b/
+		},
+
+		responseFields: {
+			xml: "responseXML",
+			text: "responseText",
+			json: "responseJSON"
+		},
+
+		// Data converters
+		// Keys separate source (or catchall "*") and destination types with a single space
+		converters: {
+
+			// Convert anything to text
+			"* text": String,
+
+			// Text to html (true = no transformation)
+			"text html": true,
+
+			// Evaluate text as a json expression
+			"text json": JSON.parse,
+
+			// Parse text as xml
+			"text xml": jQuery.parseXML
+		},
+
+		// For options that shouldn't be deep extended:
+		// you can add your own custom options here if
+		// and when you create one that shouldn't be
+		// deep extended (see ajaxExtend)
+		flatOptions: {
+			url: true,
+			context: true
+		}
+	},
+
+	// Creates a full fledged settings object into target
+	// with both ajaxSettings and settings fields.
+	// If target is omitted, writes into ajaxSettings.
+	ajaxSetup: function( target, settings ) {
+		return settings ?
+
+			// Building a settings object
+			ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) :
+
+			// Extending ajaxSettings
+			ajaxExtend( jQuery.ajaxSettings, target );
+	},
+
+	ajaxPrefilter: addToPrefiltersOrTransports( prefilters ),
+	ajaxTransport: addToPrefiltersOrTransports( transports ),
+
+	// Main method
+	ajax: function( url, options ) {
+
+		// If url is an object, simulate pre-1.5 signature
+		if ( typeof url === "object" ) {
+			options = url;
+			url = undefined;
+		}
+
+		// Force options to be an object
+		options = options || {};
+
+		var transport,
+
+			// URL without anti-cache param
+			cacheURL,
+
+			// Response headers
+			responseHeadersString,
+			responseHeaders,
+
+			// timeout handle
+			timeoutTimer,
+
+			// Url cleanup var
+			urlAnchor,
+
+			// Request state (becomes false upon send and true upon completion)
+			completed,
+
+			// To know if global events are to be dispatched
+			fireGlobals,
+
+			// Loop variable
+			i,
+
+			// uncached part of the url
+			uncached,
+
+			// Create the final options object
+			s = jQuery.ajaxSetup( {}, options ),
+
+			// Callbacks context
+			callbackContext = s.context || s,
+
+			// Context for global events is callbackContext if it is a DOM node or jQuery collection
+			globalEventContext = s.context &&
+				( callbackContext.nodeType || callbackContext.jquery ) ?
+					jQuery( callbackContext ) :
+					jQuery.event,
+
+			// Deferreds
+			deferred = jQuery.Deferred(),
+			completeDeferred = jQuery.Callbacks( "once memory" ),
+
+			// Status-dependent callbacks
+			statusCode = s.statusCode || {},
+
+			// Headers (they are sent all at once)
+			requestHeaders = {},
+			requestHeadersNames = {},
+
+			// Default abort message
+			strAbort = "canceled",
+
+			// Fake xhr
+			jqXHR = {
+				readyState: 0,
+
+				// Builds headers hashtable if needed
+				getResponseHeader: function( key ) {
+					var match;
+					if ( completed ) {
+						if ( !responseHeaders ) {
+							responseHeaders = {};
+							while ( ( match = rheaders.exec( responseHeadersString ) ) ) {
+								responseHeaders[ match[ 1 ].toLowerCase() ] = match[ 2 ];
+							}
+						}
+						match = responseHeaders[ key.toLowerCase() ];
+					}
+					return match == null ? null : match;
+				},
+
+				// Raw string
+				getAllResponseHeaders: function() {
+					return completed ? responseHeadersString : null;
+				},
+
+				// Caches the header
+				setRequestHeader: function( name, value ) {
+					if ( completed == null ) {
+						name = requestHeadersNames[ name.toLowerCase() ] =
+							requestHeadersNames[ name.toLowerCase() ] || name;
+						requestHeaders[ name ] = value;
+					}
+					return this;
+				},
+
+				// Overrides response content-type header
+				overrideMimeType: function( type ) {
+					if ( completed == null ) {
+						s.mimeType = type;
+					}
+					return this;
+				},
+
+				// Status-dependent callbacks
+				statusCode: function( map ) {
+					var code;
+					if ( map ) {
+						if ( completed ) {
+
+							// Execute the appropriate callbacks
+							jqXHR.always( map[ jqXHR.status ] );
+						} else {
+
+							// Lazy-add the new callbacks in a way that preserves old ones
+							for ( code in map ) {
+								statusCode[ code ] = [ statusCode[ code ], map[ code ] ];
+							}
+						}
+					}
+					return this;
+				},
+
+				// Cancel the request
+				abort: function( statusText ) {
+					var finalText = statusText || strAbort;
+					if ( transport ) {
+						transport.abort( finalText );
+					}
+					done( 0, finalText );
+					return this;
+				}
+			};
+
+		// Attach deferreds
+		deferred.promise( jqXHR );
+
+		// Add protocol if not provided (prefilters might expect it)
+		// Handle falsy url in the settings object (#10093: consistency with old signature)
+		// We also use the url parameter if available
+		s.url = ( ( url || s.url || location.href ) + "" )
+			.replace( rprotocol, location.protocol + "//" );
+
+		// Alias method option to type as per ticket #12004
+		s.type = options.method || options.type || s.method || s.type;
+
+		// Extract dataTypes list
+		s.dataTypes = ( s.dataType || "*" ).toLowerCase().match( rnothtmlwhite ) || [ "" ];
+
+		// A cross-domain request is in order when the origin doesn't match the current origin.
+		if ( s.crossDomain == null ) {
+			urlAnchor = document.createElement( "a" );
+
+			// Support: IE <=8 - 11, Edge 12 - 15
+			// IE throws exception on accessing the href property if url is malformed,
+			// e.g. http://example.com:80x/
+			try {
+				urlAnchor.href = s.url;
+
+				// Support: IE <=8 - 11 only
+				// Anchor's host property isn't correctly set when s.url is relative
+				urlAnchor.href = urlAnchor.href;
+				s.crossDomain = originAnchor.protocol + "//" + originAnchor.host !==
+					urlAnchor.protocol + "//" + urlAnchor.host;
+			} catch ( e ) {
+
+				// If there is an error parsing the URL, assume it is crossDomain,
+				// it can be rejected by the transport if it is invalid
+				s.crossDomain = true;
+			}
+		}
+
+		// Convert data if not already a string
+		if ( s.data && s.processData && typeof s.data !== "string" ) {
+			s.data = jQuery.param( s.data, s.traditional );
+		}
+
+		// Apply prefilters
+		inspectPrefiltersOrTransports( prefilters, s, options, jqXHR );
+
+		// If request was aborted inside a prefilter, stop there
+		if ( completed ) {
+			return jqXHR;
+		}
+
+		// We can fire global events as of now if asked to
+		// Don't fire events if jQuery.event is undefined in an AMD-usage scenario (#15118)
+		fireGlobals = jQuery.event && s.global;
+
+		// Watch for a new set of requests
+		if ( fireGlobals && jQuery.active++ === 0 ) {
+			jQuery.event.trigger( "ajaxStart" );
+		}
+
+		// Uppercase the type
+		s.type = s.type.toUpperCase();
+
+		// Determine if request has content
+		s.hasContent = !rnoContent.test( s.type );
+
+		// Save the URL in case we're toying with the If-Modified-Since
+		// and/or If-None-Match header later on
+		// Remove hash to simplify url manipulation
+		cacheURL = s.url.replace( rhash, "" );
+
+		// More options handling for requests with no content
+		if ( !s.hasContent ) {
+
+			// Remember the hash so we can put it back
+			uncached = s.url.slice( cacheURL.length );
+
+			// If data is available and should be processed, append data to url
+			if ( s.data && ( s.processData || typeof s.data === "string" ) ) {
+				cacheURL += ( rquery.test( cacheURL ) ? "&" : "?" ) + s.data;
+
+				// #9682: remove data so that it's not used in an eventual retry
+				delete s.data;
+			}
+
+			// Add or update anti-cache param if needed
+			if ( s.cache === false ) {
+				cacheURL = cacheURL.replace( rantiCache, "$1" );
+				uncached = ( rquery.test( cacheURL ) ? "&" : "?" ) + "_=" + ( nonce++ ) + uncached;
+			}
+
+			// Put hash and anti-cache on the URL that will be requested (gh-1732)
+			s.url = cacheURL + uncached;
+
+		// Change '%20' to '+' if this is encoded form body content (gh-2658)
+		} else if ( s.data && s.processData &&
+			( s.contentType || "" ).indexOf( "application/x-www-form-urlencoded" ) === 0 ) {
+			s.data = s.data.replace( r20, "+" );
+		}
+
+		// Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode.
+		if ( s.ifModified ) {
+			if ( jQuery.lastModified[ cacheURL ] ) {
+				jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ cacheURL ] );
+			}
+			if ( jQuery.etag[ cacheURL ] ) {
+				jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ cacheURL ] );
+			}
+		}
+
+		// Set the correct header, if data is being sent
+		if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) {
+			jqXHR.setRequestHeader( "Content-Type", s.contentType );
+		}
+
+		// Set the Accepts header for the server, depending on the dataType
+		jqXHR.setRequestHeader(
+			"Accept",
+			s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[ 0 ] ] ?
+				s.accepts[ s.dataTypes[ 0 ] ] +
+					( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) :
+				s.accepts[ "*" ]
+		);
+
+		// Check for headers option
+		for ( i in s.headers ) {
+			jqXHR.setRequestHeader( i, s.headers[ i ] );
+		}
+
+		// Allow custom headers/mimetypes and early abort
+		if ( s.beforeSend &&
+			( s.beforeSend.call( callbackContext, jqXHR, s ) === false || completed ) ) {
+
+			// Abort if not done already and return
+			return jqXHR.abort();
+		}
+
+		// Aborting is no longer a cancellation
+		strAbort = "abort";
+
+		// Install callbacks on deferreds
+		completeDeferred.add( s.complete );
+		jqXHR.done( s.success );
+		jqXHR.fail( s.error );
+
+		// Get transport
+		transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR );
+
+		// If no transport, we auto-abort
+		if ( !transport ) {
+			done( -1, "No Transport" );
+		} else {
+			jqXHR.readyState = 1;
+
+			// Send global event
+			if ( fireGlobals ) {
+				globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] );
+			}
+
+			// If request was aborted inside ajaxSend, stop there
+			if ( completed ) {
+				return jqXHR;
+			}
+
+			// Timeout
+			if ( s.async && s.timeout > 0 ) {
+				timeoutTimer = window.setTimeout( function() {
+					jqXHR.abort( "timeout" );
+				}, s.timeout );
+			}
+
+			try {
+				completed = false;
+				transport.send( requestHeaders, done );
+			} catch ( e ) {
+
+				// Rethrow post-completion exceptions
+				if ( completed ) {
+					throw e;
+				}
+
+				// Propagate others as results
+				done( -1, e );
+			}
+		}
+
+		// Callback for when everything is done
+		function done( status, nativeStatusText, responses, headers ) {
+			var isSuccess, success, error, response, modified,
+				statusText = nativeStatusText;
+
+			// Ignore repeat invocations
+			if ( completed ) {
+				return;
+			}
+
+			completed = true;
+
+			// Clear timeout if it exists
+			if ( timeoutTimer ) {
+				window.clearTimeout( timeoutTimer );
+			}
+
+			// Dereference transport for early garbage collection
+			// (no matter how long the jqXHR object will be used)
+			transport = undefined;
+
+			// Cache response headers
+			responseHeadersString = headers || "";
+
+			// Set readyState
+			jqXHR.readyState = status > 0 ? 4 : 0;
+
+			// Determine if successful
+			isSuccess = status >= 200 && status < 300 || status === 304;
+
+			// Get response data
+			if ( responses ) {
+				response = ajaxHandleResponses( s, jqXHR, responses );
+			}
+
+			// Convert no matter what (that way responseXXX fields are always set)
+			response = ajaxConvert( s, response, jqXHR, isSuccess );
+
+			// If successful, handle type chaining
+			if ( isSuccess ) {
+
+				// Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode.
+				if ( s.ifModified ) {
+					modified = jqXHR.getResponseHeader( "Last-Modified" );
+					if ( modified ) {
+						jQuery.lastModified[ cacheURL ] = modified;
+					}
+					modified = jqXHR.getResponseHeader( "etag" );
+					if ( modified ) {
+						jQuery.etag[ cacheURL ] = modified;
+					}
+				}
+
+				// if no content
+				if ( status === 204 || s.type === "HEAD" ) {
+					statusText = "nocontent";
+
+				// if not modified
+				} else if ( status === 304 ) {
+					statusText = "notmodified";
+
+				// If we have data, let's convert it
+				} else {
+					statusText = response.state;
+					success = response.data;
+					error = response.error;
+					isSuccess = !error;
+				}
+			} else {
+
+				// Extract error from statusText and normalize for non-aborts
+				error = statusText;
+				if ( status || !statusText ) {
+					statusText = "error";
+					if ( status < 0 ) {
+						status = 0;
+					}
+				}
+			}
+
+			// Set data for the fake xhr object
+			jqXHR.status = status;
+			jqXHR.statusText = ( nativeStatusText || statusText ) + "";
+
+			// Success/Error
+			if ( isSuccess ) {
+				deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] );
+			} else {
+				deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] );
+			}
+
+			// Status-dependent callbacks
+			jqXHR.statusCode( statusCode );
+			statusCode = undefined;
+
+			if ( fireGlobals ) {
+				globalEventContext.trigger( isSuccess ? "ajaxSuccess" : "ajaxError",
+					[ jqXHR, s, isSuccess ? success : error ] );
+			}
+
+			// Complete
+			completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] );
+
+			if ( fireGlobals ) {
+				globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] );
+
+				// Handle the global AJAX counter
+				if ( !( --jQuery.active ) ) {
+					jQuery.event.trigger( "ajaxStop" );
+				}
+			}
+		}
+
+		return jqXHR;
+	},
+
+	getJSON: function( url, data, callback ) {
+		return jQuery.get( url, data, callback, "json" );
+	},
+
+	getScript: function( url, callback ) {
+		return jQuery.get( url, undefined, callback, "script" );
+	}
+} );
+
+jQuery.each( [ "get", "post" ], function( i, method ) {
+	jQuery[ method ] = function( url, data, callback, type ) {
+
+		// Shift arguments if data argument was omitted
+		if ( isFunction( data ) ) {
+			type = type || callback;
+			callback = data;
+			data = undefined;
+		}
+
+		// The url can be an options object (which then must have .url)
+		return jQuery.ajax( jQuery.extend( {
+			url: url,
+			type: method,
+			dataType: type,
+			data: data,
+			success: callback
+		}, jQuery.isPlainObject( url ) && url ) );
+	};
+} );
+
+
+jQuery._evalUrl = function( url ) {
+	return jQuery.ajax( {
+		url: url,
+
+		// Make this explicit, since user can override this through ajaxSetup (#11264)
+		type: "GET",
+		dataType: "script",
+		cache: true,
+		async: false,
+		global: false,
+		"throws": true
+	} );
+};
+
+
+jQuery.fn.extend( {
+	wrapAll: function( html ) {
+		var wrap;
+
+		if ( this[ 0 ] ) {
+			if ( isFunction( html ) ) {
+				html = html.call( this[ 0 ] );
+			}
+
+			// The elements to wrap the target around
+			wrap = jQuery( html, this[ 0 ].ownerDocument ).eq( 0 ).clone( true );
+
+			if ( this[ 0 ].parentNode ) {
+				wrap.insertBefore( this[ 0 ] );
+			}
+
+			wrap.map( function() {
+				var elem = this;
+
+				while ( elem.firstElementChild ) {
+					elem = elem.firstElementChild;
+				}
+
+				return elem;
+			} ).append( this );
+		}
+
+		return this;
+	},
+
+	wrapInner: function( html ) {
+		if ( isFunction( html ) ) {
+			return this.each( function( i ) {
+				jQuery( this ).wrapInner( html.call( this, i ) );
+			} );
+		}
+
+		return this.each( function() {
+			var self = jQuery( this ),
+				contents = self.contents();
+
+			if ( contents.length ) {
+				contents.wrapAll( html );
+
+			} else {
+				self.append( html );
+			}
+		} );
+	},
+
+	wrap: function( html ) {
+		var htmlIsFunction = isFunction( html );
+
+		return this.each( function( i ) {
+			jQuery( this ).wrapAll( htmlIsFunction ? html.call( this, i ) : html );
+		} );
+	},
+
+	unwrap: function( selector ) {
+		this.parent( selector ).not( "body" ).each( function() {
+			jQuery( this ).replaceWith( this.childNodes );
+		} );
+		return this;
+	}
+} );
+
+
+jQuery.expr.pseudos.hidden = function( elem ) {
+	return !jQuery.expr.pseudos.visible( elem );
+};
+jQuery.expr.pseudos.visible = function( elem ) {
+	return !!( elem.offsetWidth || elem.offsetHeight || elem.getClientRects().length );
+};
+
+
+
+
+jQuery.ajaxSettings.xhr = function() {
+	try {
+		return new window.XMLHttpRequest();
+	} catch ( e ) {}
+};
+
+var xhrSuccessStatus = {
+
+		// File protocol always yields status code 0, assume 200
+		0: 200,
+
+		// Support: IE <=9 only
+		// #1450: sometimes IE returns 1223 when it should be 204
+		1223: 204
+	},
+	xhrSupported = jQuery.ajaxSettings.xhr();
+
+support.cors = !!xhrSupported && ( "withCredentials" in xhrSupported );
+support.ajax = xhrSupported = !!xhrSupported;
+
+jQuery.ajaxTransport( function( options ) {
+	var callback, errorCallback;
+
+	// Cross domain only allowed if supported through XMLHttpRequest
+	if ( support.cors || xhrSupported && !options.crossDomain ) {
+		return {
+			send: function( headers, complete ) {
+				var i,
+					xhr = options.xhr();
+
+				xhr.open(
+					options.type,
+					options.url,
+					options.async,
+					options.username,
+					options.password
+				);
+
+				// Apply custom fields if provided
+				if ( options.xhrFields ) {
+					for ( i in options.xhrFields ) {
+						xhr[ i ] = options.xhrFields[ i ];
+					}
+				}
+
+				// Override mime type if needed
+				if ( options.mimeType && xhr.overrideMimeType ) {
+					xhr.overrideMimeType( options.mimeType );
+				}
+
+				// X-Requested-With header
+				// For cross-domain requests, seeing as conditions for a preflight are
+				// akin to a jigsaw puzzle, we simply never set it to be sure.
+				// (it can always be set on a per-request basis or even using ajaxSetup)
+				// For same-domain requests, won't change header if already provided.
+				if ( !options.crossDomain && !headers[ "X-Requested-With" ] ) {
+					headers[ "X-Requested-With" ] = "XMLHttpRequest";
+				}
+
+				// Set headers
+				for ( i in headers ) {
+					xhr.setRequestHeader( i, headers[ i ] );
+				}
+
+				// Callback
+				callback = function( type ) {
+					return function() {
+						if ( callback ) {
+							callback = errorCallback = xhr.onload =
+								xhr.onerror = xhr.onabort = xhr.ontimeout =
+									xhr.onreadystatechange = null;
+
+							if ( type === "abort" ) {
+								xhr.abort();
+							} else if ( type === "error" ) {
+
+								// Support: IE <=9 only
+								// On a manual native abort, IE9 throws
+								// errors on any property access that is not readyState
+								if ( typeof xhr.status !== "number" ) {
+									complete( 0, "error" );
+								} else {
+									complete(
+
+										// File: protocol always yields status 0; see #8605, #14207
+										xhr.status,
+										xhr.statusText
+									);
+								}
+							} else {
+								complete(
+									xhrSuccessStatus[ xhr.status ] || xhr.status,
+									xhr.statusText,
+
+									// Support: IE <=9 only
+									// IE9 has no XHR2 but throws on binary (trac-11426)
+									// For XHR2 non-text, let the caller handle it (gh-2498)
+									( xhr.responseType || "text" ) !== "text"  ||
+									typeof xhr.responseText !== "string" ?
+										{ binary: xhr.response } :
+										{ text: xhr.responseText },
+									xhr.getAllResponseHeaders()
+								);
+							}
+						}
+					};
+				};
+
+				// Listen to events
+				xhr.onload = callback();
+				errorCallback = xhr.onerror = xhr.ontimeout = callback( "error" );
+
+				// Support: IE 9 only
+				// Use onreadystatechange to replace onabort
+				// to handle uncaught aborts
+				if ( xhr.onabort !== undefined ) {
+					xhr.onabort = errorCallback;
+				} else {
+					xhr.onreadystatechange = function() {
+
+						// Check readyState before timeout as it changes
+						if ( xhr.readyState === 4 ) {
+
+							// Allow onerror to be called first,
+							// but that will not handle a native abort
+							// Also, save errorCallback to a variable
+							// as xhr.onerror cannot be accessed
+							window.setTimeout( function() {
+								if ( callback ) {
+									errorCallback();
+								}
+							} );
+						}
+					};
+				}
+
+				// Create the abort callback
+				callback = callback( "abort" );
+
+				try {
+
+					// Do send the request (this may raise an exception)
+					xhr.send( options.hasContent && options.data || null );
+				} catch ( e ) {
+
+					// #14683: Only rethrow if this hasn't been notified as an error yet
+					if ( callback ) {
+						throw e;
+					}
+				}
+			},
+
+			abort: function() {
+				if ( callback ) {
+					callback();
+				}
+			}
+		};
+	}
+} );
+
+
+
+
+// Prevent auto-execution of scripts when no explicit dataType was provided (See gh-2432)
+jQuery.ajaxPrefilter( function( s ) {
+	if ( s.crossDomain ) {
+		s.contents.script = false;
+	}
+} );
+
+// Install script dataType
+jQuery.ajaxSetup( {
+	accepts: {
+		script: "text/javascript, application/javascript, " +
+			"application/ecmascript, application/x-ecmascript"
+	},
+	contents: {
+		script: /\b(?:java|ecma)script\b/
+	},
+	converters: {
+		"text script": function( text ) {
+			jQuery.globalEval( text );
+			return text;
+		}
+	}
+} );
+
+// Handle cache's special case and crossDomain
+jQuery.ajaxPrefilter( "script", function( s ) {
+	if ( s.cache === undefined ) {
+		s.cache = false;
+	}
+	if ( s.crossDomain ) {
+		s.type = "GET";
+	}
+} );
+
+// Bind script tag hack transport
+jQuery.ajaxTransport( "script", function( s ) {
+
+	// This transport only deals with cross domain requests
+	if ( s.crossDomain ) {
+		var script, callback;
+		return {
+			send: function( _, complete ) {
+				script = jQuery( "<script>" ).prop( {
+					charset: s.scriptCharset,
+					src: s.url
+				} ).on(
+					"load error",
+					callback = function( evt ) {
+						script.remove();
+						callback = null;
+						if ( evt ) {
+							complete( evt.type === "error" ? 404 : 200, evt.type );
+						}
+					}
+				);
+
+				// Use native DOM manipulation to avoid our domManip AJAX trickery
+				document.head.appendChild( script[ 0 ] );
+			},
+			abort: function() {
+				if ( callback ) {
+					callback();
+				}
+			}
+		};
+	}
+} );
+
+
+
+
+var oldCallbacks = [],
+	rjsonp = /(=)\?(?=&|$)|\?\?/;
+
+// Default jsonp settings
+jQuery.ajaxSetup( {
+	jsonp: "callback",
+	jsonpCallback: function() {
+		var callback = oldCallbacks.pop() || ( jQuery.expando + "_" + ( nonce++ ) );
+		this[ callback ] = true;
+		return callback;
+	}
+} );
+
+// Detect, normalize options and install callbacks for jsonp requests
+jQuery.ajaxPrefilter( "json jsonp", function( s, originalSettings, jqXHR ) {
+
+	var callbackName, overwritten, responseContainer,
+		jsonProp = s.jsonp !== false && ( rjsonp.test( s.url ) ?
+			"url" :
+			typeof s.data === "string" &&
+				( s.contentType || "" )
+					.indexOf( "application/x-www-form-urlencoded" ) === 0 &&
+				rjsonp.test( s.data ) && "data"
+		);
+
+	// Handle iff the expected data type is "jsonp" or we have a parameter to set
+	if ( jsonProp || s.dataTypes[ 0 ] === "jsonp" ) {
+
+		// Get callback name, remembering preexisting value associated with it
+		callbackName = s.jsonpCallback = isFunction( s.jsonpCallback ) ?
+			s.jsonpCallback() :
+			s.jsonpCallback;
+
+		// Insert callback into url or form data
+		if ( jsonProp ) {
+			s[ jsonProp ] = s[ jsonProp ].replace( rjsonp, "$1" + callbackName );
+		} else if ( s.jsonp !== false ) {
+			s.url += ( rquery.test( s.url ) ? "&" : "?" ) + s.jsonp + "=" + callbackName;
+		}
+
+		// Use data converter to retrieve json after script execution
+		s.converters[ "script json" ] = function() {
+			if ( !responseContainer ) {
+				jQuery.error( callbackName + " was not called" );
+			}
+			return responseContainer[ 0 ];
+		};
+
+		// Force json dataType
+		s.dataTypes[ 0 ] = "json";
+
+		// Install callback
+		overwritten = window[ callbackName ];
+		window[ callbackName ] = function() {
+			responseContainer = arguments;
+		};
+
+		// Clean-up function (fires after converters)
+		jqXHR.always( function() {
+
+			// If previous value didn't exist - remove it
+			if ( overwritten === undefined ) {
+				jQuery( window ).removeProp( callbackName );
+
+			// Otherwise restore preexisting value
+			} else {
+				window[ callbackName ] = overwritten;
+			}
+
+			// Save back as free
+			if ( s[ callbackName ] ) {
+
+				// Make sure that re-using the options doesn't screw things around
+				s.jsonpCallback = originalSettings.jsonpCallback;
+
+				// Save the callback name for future use
+				oldCallbacks.push( callbackName );
+			}
+
+			// Call if it was a function and we have a response
+			if ( responseContainer && isFunction( overwritten ) ) {
+				overwritten( responseContainer[ 0 ] );
+			}
+
+			responseContainer = overwritten = undefined;
+		} );
+
+		// Delegate to script
+		return "script";
+	}
+} );
+
+
+
+
+// Support: Safari 8 only
+// In Safari 8 documents created via document.implementation.createHTMLDocument
+// collapse sibling forms: the second one becomes a child of the first one.
+// Because of that, this security measure has to be disabled in Safari 8.
+// https://bugs.webkit.org/show_bug.cgi?id=137337
+support.createHTMLDocument = ( function() {
+	var body = document.implementation.createHTMLDocument( "" ).body;
+	body.innerHTML = "<form></form><form></form>";
+	return body.childNodes.length === 2;
+} )();
+
+
+// Argument "data" should be string of html
+// context (optional): If specified, the fragment will be created in this context,
+// defaults to document
+// keepScripts (optional): If true, will include scripts passed in the html string
+jQuery.parseHTML = function( data, context, keepScripts ) {
+	if ( typeof data !== "string" ) {
+		return [];
+	}
+	if ( typeof context === "boolean" ) {
+		keepScripts = context;
+		context = false;
+	}
+
+	var base, parsed, scripts;
+
+	if ( !context ) {
+
+		// Stop scripts or inline event handlers from being executed immediately
+		// by using document.implementation
+		if ( support.createHTMLDocument ) {
+			context = document.implementation.createHTMLDocument( "" );
+
+			// Set the base href for the created document
+			// so any parsed elements with URLs
+			// are based on the document's URL (gh-2965)
+			base = context.createElement( "base" );
+			base.href = document.location.href;
+			context.head.appendChild( base );
+		} else {
+			context = document;
+		}
+	}
+
+	parsed = rsingleTag.exec( data );
+	scripts = !keepScripts && [];
+
+	// Single tag
+	if ( parsed ) {
+		return [ context.createElement( parsed[ 1 ] ) ];
+	}
+
+	parsed = buildFragment( [ data ], context, scripts );
+
+	if ( scripts && scripts.length ) {
+		jQuery( scripts ).remove();
+	}
+
+	return jQuery.merge( [], parsed.childNodes );
+};
+
+
+/**
+ * Load a url into a page
+ */
+jQuery.fn.load = function( url, params, callback ) {
+	var selector, type, response,
+		self = this,
+		off = url.indexOf( " " );
+
+	if ( off > -1 ) {
+		selector = stripAndCollapse( url.slice( off ) );
+		url = url.slice( 0, off );
+	}
+
+	// If it's a function
+	if ( isFunction( params ) ) {
+
+		// We assume that it's the callback
+		callback = params;
+		params = undefined;
+
+	// Otherwise, build a param string
+	} else if ( params && typeof params === "object" ) {
+		type = "POST";
+	}
+
+	// If we have elements to modify, make the request
+	if ( self.length > 0 ) {
+		jQuery.ajax( {
+			url: url,
+
+			// If "type" variable is undefined, then "GET" method will be used.
+			// Make value of this field explicit since
+			// user can override it through ajaxSetup method
+			type: type || "GET",
+			dataType: "html",
+			data: params
+		} ).done( function( responseText ) {
+
+			// Save response for use in complete callback
+			response = arguments;
+
+			self.html( selector ?
+
+				// If a selector was specified, locate the right elements in a dummy div
+				// Exclude scripts to avoid IE 'Permission Denied' errors
+				jQuery( "<div>" ).append( jQuery.parseHTML( responseText ) ).find( selector ) :
+
+				// Otherwise use the full result
+				responseText );
+
+		// If the request succeeds, this function gets "data", "status", "jqXHR"
+		// but they are ignored because response was set above.
+		// If it fails, this function gets "jqXHR", "status", "error"
+		} ).always( callback && function( jqXHR, status ) {
+			self.each( function() {
+				callback.apply( this, response || [ jqXHR.responseText, status, jqXHR ] );
+			} );
+		} );
+	}
+
+	return this;
+};
+
+
+
+
+// Attach a bunch of functions for handling common AJAX events
+jQuery.each( [
+	"ajaxStart",
+	"ajaxStop",
+	"ajaxComplete",
+	"ajaxError",
+	"ajaxSuccess",
+	"ajaxSend"
+], function( i, type ) {
+	jQuery.fn[ type ] = function( fn ) {
+		return this.on( type, fn );
+	};
+} );
+
+
+
+
+jQuery.expr.pseudos.animated = function( elem ) {
+	return jQuery.grep( jQuery.timers, function( fn ) {
+		return elem === fn.elem;
+	} ).length;
+};
+
+
+
+
+jQuery.offset = {
+	setOffset: function( elem, options, i ) {
+		var curPosition, curLeft, curCSSTop, curTop, curOffset, curCSSLeft, calculatePosition,
+			position = jQuery.css( elem, "position" ),
+			curElem = jQuery( elem ),
+			props = {};
+
+		// Set position first, in-case top/left are set even on static elem
+		if ( position === "static" ) {
+			elem.style.position = "relative";
+		}
+
+		curOffset = curElem.offset();
+		curCSSTop = jQuery.css( elem, "top" );
+		curCSSLeft = jQuery.css( elem, "left" );
+		calculatePosition = ( position === "absolute" || position === "fixed" ) &&
+			( curCSSTop + curCSSLeft ).indexOf( "auto" ) > -1;
+
+		// Need to be able to calculate position if either
+		// top or left is auto and position is either absolute or fixed
+		if ( calculatePosition ) {
+			curPosition = curElem.position();
+			curTop = curPosition.top;
+			curLeft = curPosition.left;
+
+		} else {
+			curTop = parseFloat( curCSSTop ) || 0;
+			curLeft = parseFloat( curCSSLeft ) || 0;
+		}
+
+		if ( isFunction( options ) ) {
+
+			// Use jQuery.extend here to allow modification of coordinates argument (gh-1848)
+			options = options.call( elem, i, jQuery.extend( {}, curOffset ) );
+		}
+
+		if ( options.top != null ) {
+			props.top = ( options.top - curOffset.top ) + curTop;
+		}
+		if ( options.left != null ) {
+			props.left = ( options.left - curOffset.left ) + curLeft;
+		}
+
+		if ( "using" in options ) {
+			options.using.call( elem, props );
+
+		} else {
+			curElem.css( props );
+		}
+	}
+};
+
+jQuery.fn.extend( {
+
+	// offset() relates an element's border box to the document origin
+	offset: function( options ) {
+
+		// Preserve chaining for setter
+		if ( arguments.length ) {
+			return options === undefined ?
+				this :
+				this.each( function( i ) {
+					jQuery.offset.setOffset( this, options, i );
+				} );
+		}
+
+		var rect, win,
+			elem = this[ 0 ];
+
+		if ( !elem ) {
+			return;
+		}
+
+		// Return zeros for disconnected and hidden (display: none) elements (gh-2310)
+		// Support: IE <=11 only
+		// Running getBoundingClientRect on a
+		// disconnected node in IE throws an error
+		if ( !elem.getClientRects().length ) {
+			return { top: 0, left: 0 };
+		}
+
+		// Get document-relative position by adding viewport scroll to viewport-relative gBCR
+		rect = elem.getBoundingClientRect();
+		win = elem.ownerDocument.defaultView;
+		return {
+			top: rect.top + win.pageYOffset,
+			left: rect.left + win.pageXOffset
+		};
+	},
+
+	// position() relates an element's margin box to its offset parent's padding box
+	// This corresponds to the behavior of CSS absolute positioning
+	position: function() {
+		if ( !this[ 0 ] ) {
+			return;
+		}
+
+		var offsetParent, offset, doc,
+			elem = this[ 0 ],
+			parentOffset = { top: 0, left: 0 };
+
+		// position:fixed elements are offset from the viewport, which itself always has zero offset
+		if ( jQuery.css( elem, "position" ) === "fixed" ) {
+
+			// Assume position:fixed implies availability of getBoundingClientRect
+			offset = elem.getBoundingClientRect();
+
+		} else {
+			offset = this.offset();
+
+			// Account for the *real* offset parent, which can be the document or its root element
+			// when a statically positioned element is identified
+			doc = elem.ownerDocument;
+			offsetParent = elem.offsetParent || doc.documentElement;
+			while ( offsetParent &&
+				( offsetParent === doc.body || offsetParent === doc.documentElement ) &&
+				jQuery.css( offsetParent, "position" ) === "static" ) {
+
+				offsetParent = offsetParent.parentNode;
+			}
+			if ( offsetParent && offsetParent !== elem && offsetParent.nodeType === 1 ) {
+
+				// Incorporate borders into its offset, since they are outside its content origin
+				parentOffset = jQuery( offsetParent ).offset();
+				parentOffset.top += jQuery.css( offsetParent, "borderTopWidth", true );
+				parentOffset.left += jQuery.css( offsetParent, "borderLeftWidth", true );
+			}
+		}
+
+		// Subtract parent offsets and element margins
+		return {
+			top: offset.top - parentOffset.top - jQuery.css( elem, "marginTop", true ),
+			left: offset.left - parentOffset.left - jQuery.css( elem, "marginLeft", true )
+		};
+	},
+
+	// This method will return documentElement in the following cases:
+	// 1) For the element inside the iframe without offsetParent, this method will return
+	//    documentElement of the parent window
+	// 2) For the hidden or detached element
+	// 3) For body or html element, i.e. in case of the html node - it will return itself
+	//
+	// but those exceptions were never presented as a real life use-cases
+	// and might be considered as more preferable results.
+	//
+	// This logic, however, is not guaranteed and can change at any point in the future
+	offsetParent: function() {
+		return this.map( function() {
+			var offsetParent = this.offsetParent;
+
+			while ( offsetParent && jQuery.css( offsetParent, "position" ) === "static" ) {
+				offsetParent = offsetParent.offsetParent;
+			}
+
+			return offsetParent || documentElement;
+		} );
+	}
+} );
+
+// Create scrollLeft and scrollTop methods
+jQuery.each( { scrollLeft: "pageXOffset", scrollTop: "pageYOffset" }, function( method, prop ) {
+	var top = "pageYOffset" === prop;
+
+	jQuery.fn[ method ] = function( val ) {
+		return access( this, function( elem, method, val ) {
+
+			// Coalesce documents and windows
+			var win;
+			if ( isWindow( elem ) ) {
+				win = elem;
+			} else if ( elem.nodeType === 9 ) {
+				win = elem.defaultView;
+			}
+
+			if ( val === undefined ) {
+				return win ? win[ prop ] : elem[ method ];
+			}
+
+			if ( win ) {
+				win.scrollTo(
+					!top ? val : win.pageXOffset,
+					top ? val : win.pageYOffset
+				);
+
+			} else {
+				elem[ method ] = val;
+			}
+		}, method, val, arguments.length );
+	};
+} );
+
+// Support: Safari <=7 - 9.1, Chrome <=37 - 49
+// Add the top/left cssHooks using jQuery.fn.position
+// Webkit bug: https://bugs.webkit.org/show_bug.cgi?id=29084
+// Blink bug: https://bugs.chromium.org/p/chromium/issues/detail?id=589347
+// getComputedStyle returns percent when specified for top/left/bottom/right;
+// rather than make the css module depend on the offset module, just check for it here
+jQuery.each( [ "top", "left" ], function( i, prop ) {
+	jQuery.cssHooks[ prop ] = addGetHookIf( support.pixelPosition,
+		function( elem, computed ) {
+			if ( computed ) {
+				computed = curCSS( elem, prop );
+
+				// If curCSS returns percentage, fallback to offset
+				return rnumnonpx.test( computed ) ?
+					jQuery( elem ).position()[ prop ] + "px" :
+					computed;
+			}
+		}
+	);
+} );
+
+
+// Create innerHeight, innerWidth, height, width, outerHeight and outerWidth methods
+jQuery.each( { Height: "height", Width: "width" }, function( name, type ) {
+	jQuery.each( { padding: "inner" + name, content: type, "": "outer" + name },
+		function( defaultExtra, funcName ) {
+
+		// Margin is only for outerHeight, outerWidth
+		jQuery.fn[ funcName ] = function( margin, value ) {
+			var chainable = arguments.length && ( defaultExtra || typeof margin !== "boolean" ),
+				extra = defaultExtra || ( margin === true || value === true ? "margin" : "border" );
+
+			return access( this, function( elem, type, value ) {
+				var doc;
+
+				if ( isWindow( elem ) ) {
+
+					// $( window ).outerWidth/Height return w/h including scrollbars (gh-1729)
+					return funcName.indexOf( "outer" ) === 0 ?
+						elem[ "inner" + name ] :
+						elem.document.documentElement[ "client" + name ];
+				}
+
+				// Get document width or height
+				if ( elem.nodeType === 9 ) {
+					doc = elem.documentElement;
+
+					// Either scroll[Width/Height] or offset[Width/Height] or client[Width/Height],
+					// whichever is greatest
+					return Math.max(
+						elem.body[ "scroll" + name ], doc[ "scroll" + name ],
+						elem.body[ "offset" + name ], doc[ "offset" + name ],
+						doc[ "client" + name ]
+					);
+				}
+
+				return value === undefined ?
+
+					// Get width or height on the element, requesting but not forcing parseFloat
+					jQuery.css( elem, type, extra ) :
+
+					// Set width or height on the element
+					jQuery.style( elem, type, value, extra );
+			}, type, chainable ? margin : undefined, chainable );
+		};
+	} );
+} );
+
+
+jQuery.each( ( "blur focus focusin focusout resize scroll click dblclick " +
+	"mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave " +
+	"change select submit keydown keypress keyup contextmenu" ).split( " " ),
+	function( i, name ) {
+
+	// Handle event binding
+	jQuery.fn[ name ] = function( data, fn ) {
+		return arguments.length > 0 ?
+			this.on( name, null, data, fn ) :
+			this.trigger( name );
+	};
+} );
+
+jQuery.fn.extend( {
+	hover: function( fnOver, fnOut ) {
+		return this.mouseenter( fnOver ).mouseleave( fnOut || fnOver );
+	}
+} );
+
+
+
+
+jQuery.fn.extend( {
+
+	bind: function( types, data, fn ) {
+		return this.on( types, null, data, fn );
+	},
+	unbind: function( types, fn ) {
+		return this.off( types, null, fn );
+	},
+
+	delegate: function( selector, types, data, fn ) {
+		return this.on( types, selector, data, fn );
+	},
+	undelegate: function( selector, types, fn ) {
+
+		// ( namespace ) or ( selector, types [, fn] )
+		return arguments.length === 1 ?
+			this.off( selector, "**" ) :
+			this.off( types, selector || "**", fn );
+	}
+} );
+
+// Bind a function to a context, optionally partially applying any
+// arguments.
+// jQuery.proxy is deprecated to promote standards (specifically Function#bind)
+// However, it is not slated for removal any time soon
+jQuery.proxy = function( fn, context ) {
+	var tmp, args, proxy;
+
+	if ( typeof context === "string" ) {
+		tmp = fn[ context ];
+		context = fn;
+		fn = tmp;
+	}
+
+	// Quick check to determine if target is callable, in the spec
+	// this throws a TypeError, but we will just return undefined.
+	if ( !isFunction( fn ) ) {
+		return undefined;
+	}
+
+	// Simulated bind
+	args = slice.call( arguments, 2 );
+	proxy = function() {
+		return fn.apply( context || this, args.concat( slice.call( arguments ) ) );
+	};
+
+	// Set the guid of unique handler to the same of original handler, so it can be removed
+	proxy.guid = fn.guid = fn.guid || jQuery.guid++;
+
+	return proxy;
+};
+
+jQuery.holdReady = function( hold ) {
+	if ( hold ) {
+		jQuery.readyWait++;
+	} else {
+		jQuery.ready( true );
+	}
+};
+jQuery.isArray = Array.isArray;
+jQuery.parseJSON = JSON.parse;
+jQuery.nodeName = nodeName;
+jQuery.isFunction = isFunction;
+jQuery.isWindow = isWindow;
+jQuery.camelCase = camelCase;
+jQuery.type = toType;
+
+jQuery.now = Date.now;
+
+jQuery.isNumeric = function( obj ) {
+
+	// As of jQuery 3.0, isNumeric is limited to
+	// strings and numbers (primitives or objects)
+	// that can be coerced to finite numbers (gh-2662)
+	var type = jQuery.type( obj );
+	return ( type === "number" || type === "string" ) &&
+
+		// parseFloat NaNs numeric-cast false positives ("")
+		// ...but misinterprets leading-number strings, particularly hex literals ("0x...")
+		// subtraction forces infinities to NaN
+		!isNaN( obj - parseFloat( obj ) );
+};
+
+
+
+
+// Register as a named AMD module, since jQuery can be concatenated with other
+// files that may use define, but not via a proper concatenation script that
+// understands anonymous AMD modules. A named AMD is safest and most robust
+// way to register. Lowercase jquery is used because AMD module names are
+// derived from file names, and jQuery is normally delivered in a lowercase
+// file name. Do this after creating the global so that if an AMD module wants
+// to call noConflict to hide this version of jQuery, it will work.
+
+// Note that for maximum portability, libraries that are not jQuery should
+// declare themselves as anonymous modules, and avoid setting a global if an
+// AMD loader is present. jQuery is a special case. For more information, see
+// https://github.com/jrburke/requirejs/wiki/Updating-existing-libraries#wiki-anon
+
+if ( typeof define === "function" && define.amd ) {
+	define( "jquery", [], function() {
+		return jQuery;
+	} );
+}
+
+
+
+
+var
+
+	// Map over jQuery in case of overwrite
+	_jQuery = window.jQuery,
+
+	// Map over the $ in case of overwrite
+	_$ = window.$;
+
+jQuery.noConflict = function( deep ) {
+	if ( window.$ === jQuery ) {
+		window.$ = _$;
+	}
+
+	if ( deep && window.jQuery === jQuery ) {
+		window.jQuery = _jQuery;
+	}
+
+	return jQuery;
+};
+
+// Expose jQuery and $ identifiers, even in AMD
+// (#7102#comment:10, https://github.com/jquery/jquery/pull/557)
+// and CommonJS for browser emulators (#13566)
+if ( !noGlobal ) {
+	window.jQuery = window.$ = jQuery;
+}
+
+
+
+
+return jQuery;
+} );
diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_flat_0_aaaaaa_40x100.png b/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_flat_0_aaaaaa_40x100.png
new file mode 100644
index 0000000000000000000000000000000000000000..ca17cb753b0a2ddbaacc849d284e0bf7af05428c
GIT binary patch
literal 212
zcmeAS@N?(olHy`uVBq!ia0vp^8bF-F1SA+{?>A)!QcOwS?k)_>#w|r1Kptm-M`SUO
z_5fqIli7AahM1>|V~EA+<Oo)Fp2cSZpJ^0N@zfJ$;PRZI9~D01F;InSiEBhjN@7W>
zRdP`(kYX@0Ff`RQFx53Q4>2&eGB&j`FxECOure@kD_zcvq9HdwB{QuOw+3?!`Tal*
N44$rjF6*2UngCl5GAIB5

literal 0
HcmV?d00001

diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_flat_75_ffffff_40x100.png b/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_flat_75_ffffff_40x100.png
new file mode 100644
index 0000000000000000000000000000000000000000..e6a4176cf0b34674a44540e9ec03e5387ba31308
GIT binary patch
literal 208
zcmeAS@N?(olHy`uVBq!ia0vp^8bF-F2qYNp$opRhQcOwS?k)_Bce{j_0C}7R9+AaB
z+5?Q;PG;Ky8A6^ejv*T7lYj6t@hpC#;TbB#aBAWwna#KLs)4eqC9V-ADTyViR>?)F
zK#IZ0z|d6Jz*N`JJjB4<%GlJ(z*yVBz{<eDt#mmviiX_$l+3hB+#1X^<o5$LFnGH9
KxvX<aXaWGO%QFlB

literal 0
HcmV?d00001

diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_glass_55_fbf9ee_1x400.png b/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_glass_55_fbf9ee_1x400.png
new file mode 100644
index 0000000000000000000000000000000000000000..0a084fd9377e687b7935fafa677439fc550120ea
GIT binary patch
literal 335
zcmeAS@N?(olHy`uVBq!ia0vp^j6gI&fC<Rju*&f~kYY>nc6a#?2AmP!?*K(O3p^r=
zfwTu0yPeFo12TF&T^vI^j=w#x$i?I+((tf;UXnmgbH|3oY>pC!)f}(GR!16S-u+#{
ze6YEqRkW=8vGl=5qArKM<9}TC-}iEvB{zdaTcX5$wyRTK&AL<j?Oogl7O%t;J!=h;
z-jz8yK2Z_Txf?iR!y=`46O)gZPw?Ar2`)?)dsFGUcbn%2mT)d+n{3Ay7yfr=9yaKa
z|HNjKs1n@qrcw{+Fx3**h?11Vl2ohYqEsNoU}Ruus%v1XYiJ%~U~Xk>YGq)oZD3$!
kVBl7|oEb$!ZhlH;S|x4`<{I+*ff^V*UHx3vIVCg!01$+91poj5

literal 0
HcmV?d00001

diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_glass_65_ffffff_1x400.png b/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_glass_65_ffffff_1x400.png
new file mode 100644
index 0000000000000000000000000000000000000000..5b4820997690be6470e5c64b8cbd793431dd4ad3
GIT binary patch
literal 207
zcmeAS@N?(olHy`uVBq!ia0vp^j6gI2NH8$CE1Q=ADW)WEcNYf6yIsOdfIQ9ukH}&m
z?E%JaC$sH<3_(v9#}JM4$r%X}t&0mp9yKsb%{ak$*<@oTP*SzTHKHUXu_V<hxhNG#
zF&G&bn(7*u>KdAd7?@ibn_3wdYa19?85p>gE@wv3kei>9nO2EggSm$MexL>hPgg&e
IbxsLQ0Lv~h$N&HU

literal 0
HcmV?d00001

diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_glass_75_dadada_1x400.png b/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_glass_75_dadada_1x400.png
new file mode 100644
index 0000000000000000000000000000000000000000..820ef7b466d5bff53a862ba6d7de69f5972dbad2
GIT binary patch
literal 262
zcmeAS@N?(olHy`uVBq!ia0vp^j6gI&0LWmFTHNUZq?nSt-Ch3w7g=q17Rci)@Q5r1
z(jH*!b~4)z#PD=+46!(!T=8puqDZgOs>RXUCGx5b?-VBQkUm|IuXOmYJrBRJgj{Vx
zMbNnqUkncy+qa2-mWYc>swkcIuvGK#>(0d)B7)5f`@$Ei28nH~0h*~=;u=wsl30>z
zm0Xkxq!^403{7<nOmz*-Lk!HVj7_Z!jI|96tPBj?N|!UEXvob^$xN%nt-)MFem_tH
NgQu&X%Q~loCIBP9O%DJ7

literal 0
HcmV?d00001

diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_glass_75_e6e6e6_1x400.png b/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_glass_75_e6e6e6_1x400.png
new file mode 100644
index 0000000000000000000000000000000000000000..26770496a2d27e0b8f5d4d4a067f8f3ff20dfc55
GIT binary patch
literal 262
zcmeAS@N?(olHy`uVBq!ia0vp^j6gI&0LWmFTHNUZq?nSt-Ch3w7g=q17Rci)@Q5r1
z(jH*!b~4)z#PD=+46!(!TrvH)L6@80)r*_cdCvDr%)6ghVL16=s@mbz7H!uRdGeDa
z?kzLg)16i!f8fKx84s0>4<FykGyjQ%on+slKo=e+hF*tnDhzt2`9L#OOI#yLQW8s2
zt&)pUffR$0fuX6cfvK*cd5D3zm9eRnfw8uMft7)QTj_FU6b-rgDVb@NxHXt-$nOVg
OVDNPHb6Mw<&;$T)4ow{Z

literal 0
HcmV?d00001

diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_glass_95_fef1ec_1x400.png b/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_glass_95_fef1ec_1x400.png
new file mode 100644
index 0000000000000000000000000000000000000000..671bc6bf9b27f6c645ba8103d0b5b441eb9233c7
GIT binary patch
literal 332
zcmeAS@N?(olHy`uVBq!ia0vp^j6gI&fC<Rju*&f~kYY>nc6a#?2AmP!?*K(O3p^r=
zfwTu0yPeFo12VciT^vI^j=w#>k(V)1qW$CZ|6)SVV-&*#dav<$DMuV&n0Dbpw@a<C
zL<6s0+7G*vvYqejST{BX?76zWVpaQ=iZkzonHi23$~?b)VOyyz)5%$db0%#{6W6}<
z!ED#MUb*PGy)jD<wKpxEbn*J^@Wmk}MQ?XX%rvu-j19ArkbS1Zt0D2{=$6M8=lCm`
z+;uflX3ggWIZw63HKHUXu_V<hxhNG#F&G&bn(7*u>KdAd7?@ibn_3wdYa19?85p>g
gE@wv3kei>9nO2EggSm$MexL>hPgg&ebxsLQ0D!7;1ONa4

literal 0
HcmV?d00001

diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_highlight-soft_75_cccccc_1x100.png b/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-bg_highlight-soft_75_cccccc_1x100.png
new file mode 100644
index 0000000000000000000000000000000000000000..368044d43243216e33bf55bcf195fe271e57a7ef
GIT binary patch
literal 280
zcmeAS@N?(olHy`uVBq!ia0vp^j6j?s03;ZUuHXC*q?nSt-Ch3w7g=q17Rci)@Q5r1
z(jH*!b~4)z$cXZEaSV~ToLo`U+vu0Ue0cG9p8hWqa?gxxGLm=1A1u)Cewe3oSeCaf
zI$k30UHXoTXA5lSJe(zTc<N)G>E%W-S*bfB&J`pw9sa4-R?IGW?p~6`>jMSP&M+u3
zY@9al)zrvpHlQu4C9V-ADTyViR>?)FK#IZ0z|d6Jz*N`JJjB4<%GlJ(z*yVBz{<eD
it#mmviiX_$l+3hB+#1X^<o5$LFnGH9xvX<aXaWHFZdmpJ

literal 0
HcmV?d00001

diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-icons_222222_256x240.png b/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-icons_222222_256x240.png
new file mode 100644
index 0000000000000000000000000000000000000000..e9c8e16ac5e7f61c843fbac290ce30c5de7e40b6
GIT binary patch
literal 6922
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
Q^5g_ikWrPcku(qaFX2Wbe*gdg

literal 0
HcmV?d00001

diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-icons_2e83ff_256x240.png b/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-icons_2e83ff_256x240.png
new file mode 100644
index 0000000000000000000000000000000000000000..f2bf8388370920783b94285cb75827ce4b4cc1c5
GIT binary patch
literal 4549
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
F{sUG;a@YU>

literal 0
HcmV?d00001

diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-icons_454545_256x240.png b/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-icons_454545_256x240.png
new file mode 100644
index 0000000000000000000000000000000000000000..d6169e8bf9389ab9b5b7d2c6f0c5fe3e4d363105
GIT binary patch
literal 6992
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
a6;u;yYT@ZL2o-xY0w~C;LMo(9{QnC_7DmPZ

literal 0
HcmV?d00001

diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-icons_888888_256x240.png b/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-icons_888888_256x240.png
new file mode 100644
index 0000000000000000000000000000000000000000..d3e6e02a03d4cfdc6a2114f736aa57e8a898b98b
GIT binary patch
literal 6999
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

literal 0
HcmV?d00001

diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-icons_cd0a0a_256x240.png b/spring-cloud-contract-maven-plugin/apidocs/jquery/images/ui-icons_cd0a0a_256x240.png
new file mode 100644
index 0000000000000000000000000000000000000000..49370189231d006600b0f0c2967cad1583eba634
GIT binary patch
literal 4549
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
E2b3c!L;wH)

literal 0
HcmV?d00001

diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-3.3.1.js b/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-3.3.1.js
new file mode 100644
index 0000000000..9b5206bcc6
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-3.3.1.js
@@ -0,0 +1,10364 @@
+/*!
+ * jQuery JavaScript Library v3.3.1
+ * https://jquery.com/
+ *
+ * Includes Sizzle.js
+ * https://sizzlejs.com/
+ *
+ * Copyright JS Foundation and other contributors
+ * Released under the MIT license
+ * https://jquery.org/license
+ *
+ * Date: 2018-01-20T17:24Z
+ */
+( function( global, factory ) {
+
+	"use strict";
+
+	if ( typeof module === "object" && typeof module.exports === "object" ) {
+
+		// For CommonJS and CommonJS-like environments where a proper `window`
+		// is present, execute the factory and get jQuery.
+		// For environments that do not have a `window` with a `document`
+		// (such as Node.js), expose a factory as module.exports.
+		// This accentuates the need for the creation of a real `window`.
+		// e.g. var jQuery = require("jquery")(window);
+		// See ticket #14549 for more info.
+		module.exports = global.document ?
+			factory( global, true ) :
+			function( w ) {
+				if ( !w.document ) {
+					throw new Error( "jQuery requires a window with a document" );
+				}
+				return factory( w );
+			};
+	} else {
+		factory( global );
+	}
+
+// Pass this if window is not defined yet
+} )( typeof window !== "undefined" ? window : this, function( window, noGlobal ) {
+
+// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1
+// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode
+// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common
+// enough that all such attempts are guarded in a try block.
+"use strict";
+
+var arr = [];
+
+var document = window.document;
+
+var getProto = Object.getPrototypeOf;
+
+var slice = arr.slice;
+
+var concat = arr.concat;
+
+var push = arr.push;
+
+var indexOf = arr.indexOf;
+
+var class2type = {};
+
+var toString = class2type.toString;
+
+var hasOwn = class2type.hasOwnProperty;
+
+var fnToString = hasOwn.toString;
+
+var ObjectFunctionString = fnToString.call( Object );
+
+var support = {};
+
+var isFunction = function isFunction( obj ) {
+
+      // Support: Chrome <=57, Firefox <=52
+      // In some browsers, typeof returns "function" for HTML <object> elements
+      // (i.e., `typeof document.createElement( "object" ) === "function"`).
+      // We don't want to classify *any* DOM node as a function.
+      return typeof obj === "function" && typeof obj.nodeType !== "number";
+  };
+
+
+var isWindow = function isWindow( obj ) {
+		return obj != null && obj === obj.window;
+	};
+
+
+
+
+	var preservedScriptAttributes = {
+		type: true,
+		src: true,
+		noModule: true
+	};
+
+	function DOMEval( code, doc, node ) {
+		doc = doc || document;
+
+		var i,
+			script = doc.createElement( "script" );
+
+		script.text = code;
+		if ( node ) {
+			for ( i in preservedScriptAttributes ) {
+				if ( node[ i ] ) {
+					script[ i ] = node[ i ];
+				}
+			}
+		}
+		doc.head.appendChild( script ).parentNode.removeChild( script );
+	}
+
+
+function toType( obj ) {
+	if ( obj == null ) {
+		return obj + "";
+	}
+
+	// Support: Android <=2.3 only (functionish RegExp)
+	return typeof obj === "object" || typeof obj === "function" ?
+		class2type[ toString.call( obj ) ] || "object" :
+		typeof obj;
+}
+/* global Symbol */
+// Defining this global in .eslintrc.json would create a danger of using the global
+// unguarded in another place, it seems safer to define global only for this module
+
+
+
+var
+	version = "3.3.1",
+
+	// Define a local copy of jQuery
+	jQuery = function( selector, context ) {
+
+		// The jQuery object is actually just the init constructor 'enhanced'
+		// Need init if jQuery is called (just allow error to be thrown if not included)
+		return new jQuery.fn.init( selector, context );
+	},
+
+	// Support: Android <=4.0 only
+	// Make sure we trim BOM and NBSP
+	rtrim = /^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g;
+
+jQuery.fn = jQuery.prototype = {
+
+	// The current version of jQuery being used
+	jquery: version,
+
+	constructor: jQuery,
+
+	// The default length of a jQuery object is 0
+	length: 0,
+
+	toArray: function() {
+		return slice.call( this );
+	},
+
+	// Get the Nth element in the matched element set OR
+	// Get the whole matched element set as a clean array
+	get: function( num ) {
+
+		// Return all the elements in a clean array
+		if ( num == null ) {
+			return slice.call( this );
+		}
+
+		// Return just the one element from the set
+		return num < 0 ? this[ num + this.length ] : this[ num ];
+	},
+
+	// Take an array of elements and push it onto the stack
+	// (returning the new matched element set)
+	pushStack: function( elems ) {
+
+		// Build a new jQuery matched element set
+		var ret = jQuery.merge( this.constructor(), elems );
+
+		// Add the old object onto the stack (as a reference)
+		ret.prevObject = this;
+
+		// Return the newly-formed element set
+		return ret;
+	},
+
+	// Execute a callback for every element in the matched set.
+	each: function( callback ) {
+		return jQuery.each( this, callback );
+	},
+
+	map: function( callback ) {
+		return this.pushStack( jQuery.map( this, function( elem, i ) {
+			return callback.call( elem, i, elem );
+		} ) );
+	},
+
+	slice: function() {
+		return this.pushStack( slice.apply( this, arguments ) );
+	},
+
+	first: function() {
+		return this.eq( 0 );
+	},
+
+	last: function() {
+		return this.eq( -1 );
+	},
+
+	eq: function( i ) {
+		var len = this.length,
+			j = +i + ( i < 0 ? len : 0 );
+		return this.pushStack( j >= 0 && j < len ? [ this[ j ] ] : [] );
+	},
+
+	end: function() {
+		return this.prevObject || this.constructor();
+	},
+
+	// For internal use only.
+	// Behaves like an Array's method, not like a jQuery method.
+	push: push,
+	sort: arr.sort,
+	splice: arr.splice
+};
+
+jQuery.extend = jQuery.fn.extend = function() {
+	var options, name, src, copy, copyIsArray, clone,
+		target = arguments[ 0 ] || {},
+		i = 1,
+		length = arguments.length,
+		deep = false;
+
+	// Handle a deep copy situation
+	if ( typeof target === "boolean" ) {
+		deep = target;
+
+		// Skip the boolean and the target
+		target = arguments[ i ] || {};
+		i++;
+	}
+
+	// Handle case when target is a string or something (possible in deep copy)
+	if ( typeof target !== "object" && !isFunction( target ) ) {
+		target = {};
+	}
+
+	// Extend jQuery itself if only one argument is passed
+	if ( i === length ) {
+		target = this;
+		i--;
+	}
+
+	for ( ; i < length; i++ ) {
+
+		// Only deal with non-null/undefined values
+		if ( ( options = arguments[ i ] ) != null ) {
+
+			// Extend the base object
+			for ( name in options ) {
+				src = target[ name ];
+				copy = options[ name ];
+
+				// Prevent never-ending loop
+				if ( target === copy ) {
+					continue;
+				}
+
+				// Recurse if we're merging plain objects or arrays
+				if ( deep && copy && ( jQuery.isPlainObject( copy ) ||
+					( copyIsArray = Array.isArray( copy ) ) ) ) {
+
+					if ( copyIsArray ) {
+						copyIsArray = false;
+						clone = src && Array.isArray( src ) ? src : [];
+
+					} else {
+						clone = src && jQuery.isPlainObject( src ) ? src : {};
+					}
+
+					// Never move original objects, clone them
+					target[ name ] = jQuery.extend( deep, clone, copy );
+
+				// Don't bring in undefined values
+				} else if ( copy !== undefined ) {
+					target[ name ] = copy;
+				}
+			}
+		}
+	}
+
+	// Return the modified object
+	return target;
+};
+
+jQuery.extend( {
+
+	// Unique for each copy of jQuery on the page
+	expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ),
+
+	// Assume jQuery is ready without the ready module
+	isReady: true,
+
+	error: function( msg ) {
+		throw new Error( msg );
+	},
+
+	noop: function() {},
+
+	isPlainObject: function( obj ) {
+		var proto, Ctor;
+
+		// Detect obvious negatives
+		// Use toString instead of jQuery.type to catch host objects
+		if ( !obj || toString.call( obj ) !== "[object Object]" ) {
+			return false;
+		}
+
+		proto = getProto( obj );
+
+		// Objects with no prototype (e.g., `Object.create( null )`) are plain
+		if ( !proto ) {
+			return true;
+		}
+
+		// Objects with prototype are plain iff they were constructed by a global Object function
+		Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor;
+		return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString;
+	},
+
+	isEmptyObject: function( obj ) {
+
+		/* eslint-disable no-unused-vars */
+		// See https://github.com/eslint/eslint/issues/6125
+		var name;
+
+		for ( name in obj ) {
+			return false;
+		}
+		return true;
+	},
+
+	// Evaluates a script in a global context
+	globalEval: function( code ) {
+		DOMEval( code );
+	},
+
+	each: function( obj, callback ) {
+		var length, i = 0;
+
+		if ( isArrayLike( obj ) ) {
+			length = obj.length;
+			for ( ; i < length; i++ ) {
+				if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) {
+					break;
+				}
+			}
+		} else {
+			for ( i in obj ) {
+				if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) {
+					break;
+				}
+			}
+		}
+
+		return obj;
+	},
+
+	// Support: Android <=4.0 only
+	trim: function( text ) {
+		return text == null ?
+			"" :
+			( text + "" ).replace( rtrim, "" );
+	},
+
+	// results is for internal usage only
+	makeArray: function( arr, results ) {
+		var ret = results || [];
+
+		if ( arr != null ) {
+			if ( isArrayLike( Object( arr ) ) ) {
+				jQuery.merge( ret,
+					typeof arr === "string" ?
+					[ arr ] : arr
+				);
+			} else {
+				push.call( ret, arr );
+			}
+		}
+
+		return ret;
+	},
+
+	inArray: function( elem, arr, i ) {
+		return arr == null ? -1 : indexOf.call( arr, elem, i );
+	},
+
+	// Support: Android <=4.0 only, PhantomJS 1 only
+	// push.apply(_, arraylike) throws on ancient WebKit
+	merge: function( first, second ) {
+		var len = +second.length,
+			j = 0,
+			i = first.length;
+
+		for ( ; j < len; j++ ) {
+			first[ i++ ] = second[ j ];
+		}
+
+		first.length = i;
+
+		return first;
+	},
+
+	grep: function( elems, callback, invert ) {
+		var callbackInverse,
+			matches = [],
+			i = 0,
+			length = elems.length,
+			callbackExpect = !invert;
+
+		// Go through the array, only saving the items
+		// that pass the validator function
+		for ( ; i < length; i++ ) {
+			callbackInverse = !callback( elems[ i ], i );
+			if ( callbackInverse !== callbackExpect ) {
+				matches.push( elems[ i ] );
+			}
+		}
+
+		return matches;
+	},
+
+	// arg is for internal usage only
+	map: function( elems, callback, arg ) {
+		var length, value,
+			i = 0,
+			ret = [];
+
+		// Go through the array, translating each of the items to their new values
+		if ( isArrayLike( elems ) ) {
+			length = elems.length;
+			for ( ; i < length; i++ ) {
+				value = callback( elems[ i ], i, arg );
+
+				if ( value != null ) {
+					ret.push( value );
+				}
+			}
+
+		// Go through every key on the object,
+		} else {
+			for ( i in elems ) {
+				value = callback( elems[ i ], i, arg );
+
+				if ( value != null ) {
+					ret.push( value );
+				}
+			}
+		}
+
+		// Flatten any nested arrays
+		return concat.apply( [], ret );
+	},
+
+	// A global GUID counter for objects
+	guid: 1,
+
+	// jQuery.support is not used in Core but other projects attach their
+	// properties to it so it needs to exist.
+	support: support
+} );
+
+if ( typeof Symbol === "function" ) {
+	jQuery.fn[ Symbol.iterator ] = arr[ Symbol.iterator ];
+}
+
+// Populate the class2type map
+jQuery.each( "Boolean Number String Function Array Date RegExp Object Error Symbol".split( " " ),
+function( i, name ) {
+	class2type[ "[object " + name + "]" ] = name.toLowerCase();
+} );
+
+function isArrayLike( obj ) {
+
+	// Support: real iOS 8.2 only (not reproducible in simulator)
+	// `in` check used to prevent JIT error (gh-2145)
+	// hasOwn isn't used here due to false negatives
+	// regarding Nodelist length in IE
+	var length = !!obj && "length" in obj && obj.length,
+		type = toType( obj );
+
+	if ( isFunction( obj ) || isWindow( obj ) ) {
+		return false;
+	}
+
+	return type === "array" || length === 0 ||
+		typeof length === "number" && length > 0 && ( length - 1 ) in obj;
+}
+var Sizzle =
+/*!
+ * Sizzle CSS Selector Engine v2.3.3
+ * https://sizzlejs.com/
+ *
+ * Copyright jQuery Foundation and other contributors
+ * Released under the MIT license
+ * http://jquery.org/license
+ *
+ * Date: 2016-08-08
+ */
+(function( window ) {
+
+var i,
+	support,
+	Expr,
+	getText,
+	isXML,
+	tokenize,
+	compile,
+	select,
+	outermostContext,
+	sortInput,
+	hasDuplicate,
+
+	// Local document vars
+	setDocument,
+	document,
+	docElem,
+	documentIsHTML,
+	rbuggyQSA,
+	rbuggyMatches,
+	matches,
+	contains,
+
+	// Instance-specific data
+	expando = "sizzle" + 1 * new Date(),
+	preferredDoc = window.document,
+	dirruns = 0,
+	done = 0,
+	classCache = createCache(),
+	tokenCache = createCache(),
+	compilerCache = createCache(),
+	sortOrder = function( a, b ) {
+		if ( a === b ) {
+			hasDuplicate = true;
+		}
+		return 0;
+	},
+
+	// Instance methods
+	hasOwn = ({}).hasOwnProperty,
+	arr = [],
+	pop = arr.pop,
+	push_native = arr.push,
+	push = arr.push,
+	slice = arr.slice,
+	// Use a stripped-down indexOf as it's faster than native
+	// https://jsperf.com/thor-indexof-vs-for/5
+	indexOf = function( list, elem ) {
+		var i = 0,
+			len = list.length;
+		for ( ; i < len; i++ ) {
+			if ( list[i] === elem ) {
+				return i;
+			}
+		}
+		return -1;
+	},
+
+	booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",
+
+	// Regular expressions
+
+	// http://www.w3.org/TR/css3-selectors/#whitespace
+	whitespace = "[\\x20\\t\\r\\n\\f]",
+
+	// http://www.w3.org/TR/CSS21/syndata.html#value-def-identifier
+	identifier = "(?:\\\\.|[\\w-]|[^\0-\\xa0])+",
+
+	// Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors
+	attributes = "\\[" + whitespace + "*(" + identifier + ")(?:" + whitespace +
+		// Operator (capture 2)
+		"*([*^$|!~]?=)" + whitespace +
+		// "Attribute values must be CSS identifiers [capture 5] or strings [capture 3 or capture 4]"
+		"*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|(" + identifier + "))|)" + whitespace +
+		"*\\]",
+
+	pseudos = ":(" + identifier + ")(?:\\((" +
+		// To reduce the number of selectors needing tokenize in the preFilter, prefer arguments:
+		// 1. quoted (capture 3; capture 4 or capture 5)
+		"('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|" +
+		// 2. simple (capture 6)
+		"((?:\\\\.|[^\\\\()[\\]]|" + attributes + ")*)|" +
+		// 3. anything else (capture 2)
+		".*" +
+		")\\)|)",
+
+	// Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter
+	rwhitespace = new RegExp( whitespace + "+", "g" ),
+	rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + whitespace + "+$", "g" ),
+
+	rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ),
+	rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace + "*" ),
+
+	rattributeQuotes = new RegExp( "=" + whitespace + "*([^\\]'\"]*?)" + whitespace + "*\\]", "g" ),
+
+	rpseudo = new RegExp( pseudos ),
+	ridentifier = new RegExp( "^" + identifier + "$" ),
+
+	matchExpr = {
+		"ID": new RegExp( "^#(" + identifier + ")" ),
+		"CLASS": new RegExp( "^\\.(" + identifier + ")" ),
+		"TAG": new RegExp( "^(" + identifier + "|[*])" ),
+		"ATTR": new RegExp( "^" + attributes ),
+		"PSEUDO": new RegExp( "^" + pseudos ),
+		"CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" + whitespace +
+			"*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + whitespace +
+			"*(\\d+)|))" + whitespace + "*\\)|)", "i" ),
+		"bool": new RegExp( "^(?:" + booleans + ")$", "i" ),
+		// For use in libraries implementing .is()
+		// We use this for POS matching in `select`
+		"needsContext": new RegExp( "^" + whitespace + "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" +
+			whitespace + "*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" )
+	},
+
+	rinputs = /^(?:input|select|textarea|button)$/i,
+	rheader = /^h\d$/i,
+
+	rnative = /^[^{]+\{\s*\[native \w/,
+
+	// Easily-parseable/retrievable ID or TAG or CLASS selectors
+	rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,
+
+	rsibling = /[+~]/,
+
+	// CSS escapes
+	// http://www.w3.org/TR/CSS21/syndata.html#escaped-characters
+	runescape = new RegExp( "\\\\([\\da-f]{1,6}" + whitespace + "?|(" + whitespace + ")|.)", "ig" ),
+	funescape = function( _, escaped, escapedWhitespace ) {
+		var high = "0x" + escaped - 0x10000;
+		// NaN means non-codepoint
+		// Support: Firefox<24
+		// Workaround erroneous numeric interpretation of +"0x"
+		return high !== high || escapedWhitespace ?
+			escaped :
+			high < 0 ?
+				// BMP codepoint
+				String.fromCharCode( high + 0x10000 ) :
+				// Supplemental Plane codepoint (surrogate pair)
+				String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 );
+	},
+
+	// CSS string/identifier serialization
+	// https://drafts.csswg.org/cssom/#common-serializing-idioms
+	rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,
+	fcssescape = function( ch, asCodePoint ) {
+		if ( asCodePoint ) {
+
+			// U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER
+			if ( ch === "\0" ) {
+				return "\uFFFD";
+			}
+
+			// Control characters and (dependent upon position) numbers get escaped as code points
+			return ch.slice( 0, -1 ) + "\\" + ch.charCodeAt( ch.length - 1 ).toString( 16 ) + " ";
+		}
+
+		// Other potentially-special ASCII characters get backslash-escaped
+		return "\\" + ch;
+	},
+
+	// Used for iframes
+	// See setDocument()
+	// Removing the function wrapper causes a "Permission Denied"
+	// error in IE
+	unloadHandler = function() {
+		setDocument();
+	},
+
+	disabledAncestor = addCombinator(
+		function( elem ) {
+			return elem.disabled === true && ("form" in elem || "label" in elem);
+		},
+		{ dir: "parentNode", next: "legend" }
+	);
+
+// Optimize for push.apply( _, NodeList )
+try {
+	push.apply(
+		(arr = slice.call( preferredDoc.childNodes )),
+		preferredDoc.childNodes
+	);
+	// Support: Android<4.0
+	// Detect silently failing push.apply
+	arr[ preferredDoc.childNodes.length ].nodeType;
+} catch ( e ) {
+	push = { apply: arr.length ?
+
+		// Leverage slice if possible
+		function( target, els ) {
+			push_native.apply( target, slice.call(els) );
+		} :
+
+		// Support: IE<9
+		// Otherwise append directly
+		function( target, els ) {
+			var j = target.length,
+				i = 0;
+			// Can't trust NodeList.length
+			while ( (target[j++] = els[i++]) ) {}
+			target.length = j - 1;
+		}
+	};
+}
+
+function Sizzle( selector, context, results, seed ) {
+	var m, i, elem, nid, match, groups, newSelector,
+		newContext = context && context.ownerDocument,
+
+		// nodeType defaults to 9, since context defaults to document
+		nodeType = context ? context.nodeType : 9;
+
+	results = results || [];
+
+	// Return early from calls with invalid selector or context
+	if ( typeof selector !== "string" || !selector ||
+		nodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) {
+
+		return results;
+	}
+
+	// Try to shortcut find operations (as opposed to filters) in HTML documents
+	if ( !seed ) {
+
+		if ( ( context ? context.ownerDocument || context : preferredDoc ) !== document ) {
+			setDocument( context );
+		}
+		context = context || document;
+
+		if ( documentIsHTML ) {
+
+			// If the selector is sufficiently simple, try using a "get*By*" DOM method
+			// (excepting DocumentFragment context, where the methods don't exist)
+			if ( nodeType !== 11 && (match = rquickExpr.exec( selector )) ) {
+
+				// ID selector
+				if ( (m = match[1]) ) {
+
+					// Document context
+					if ( nodeType === 9 ) {
+						if ( (elem = context.getElementById( m )) ) {
+
+							// Support: IE, Opera, Webkit
+							// TODO: identify versions
+							// getElementById can match elements by name instead of ID
+							if ( elem.id === m ) {
+								results.push( elem );
+								return results;
+							}
+						} else {
+							return results;
+						}
+
+					// Element context
+					} else {
+
+						// Support: IE, Opera, Webkit
+						// TODO: identify versions
+						// getElementById can match elements by name instead of ID
+						if ( newContext && (elem = newContext.getElementById( m )) &&
+							contains( context, elem ) &&
+							elem.id === m ) {
+
+							results.push( elem );
+							return results;
+						}
+					}
+
+				// Type selector
+				} else if ( match[2] ) {
+					push.apply( results, context.getElementsByTagName( selector ) );
+					return results;
+
+				// Class selector
+				} else if ( (m = match[3]) && support.getElementsByClassName &&
+					context.getElementsByClassName ) {
+
+					push.apply( results, context.getElementsByClassName( m ) );
+					return results;
+				}
+			}
+
+			// Take advantage of querySelectorAll
+			if ( support.qsa &&
+				!compilerCache[ selector + " " ] &&
+				(!rbuggyQSA || !rbuggyQSA.test( selector )) ) {
+
+				if ( nodeType !== 1 ) {
+					newContext = context;
+					newSelector = selector;
+
+				// qSA looks outside Element context, which is not what we want
+				// Thanks to Andrew Dupont for this workaround technique
+				// Support: IE <=8
+				// Exclude object elements
+				} else if ( context.nodeName.toLowerCase() !== "object" ) {
+
+					// Capture the context ID, setting it first if necessary
+					if ( (nid = context.getAttribute( "id" )) ) {
+						nid = nid.replace( rcssescape, fcssescape );
+					} else {
+						context.setAttribute( "id", (nid = expando) );
+					}
+
+					// Prefix every selector in the list
+					groups = tokenize( selector );
+					i = groups.length;
+					while ( i-- ) {
+						groups[i] = "#" + nid + " " + toSelector( groups[i] );
+					}
+					newSelector = groups.join( "," );
+
+					// Expand context for sibling selectors
+					newContext = rsibling.test( selector ) && testContext( context.parentNode ) ||
+						context;
+				}
+
+				if ( newSelector ) {
+					try {
+						push.apply( results,
+							newContext.querySelectorAll( newSelector )
+						);
+						return results;
+					} catch ( qsaError ) {
+					} finally {
+						if ( nid === expando ) {
+							context.removeAttribute( "id" );
+						}
+					}
+				}
+			}
+		}
+	}
+
+	// All others
+	return select( selector.replace( rtrim, "$1" ), context, results, seed );
+}
+
+/**
+ * Create key-value caches of limited size
+ * @returns {function(string, object)} Returns the Object data after storing it on itself with
+ *	property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength)
+ *	deleting the oldest entry
+ */
+function createCache() {
+	var keys = [];
+
+	function cache( key, value ) {
+		// Use (key + " ") to avoid collision with native prototype properties (see Issue #157)
+		if ( keys.push( key + " " ) > Expr.cacheLength ) {
+			// Only keep the most recent entries
+			delete cache[ keys.shift() ];
+		}
+		return (cache[ key + " " ] = value);
+	}
+	return cache;
+}
+
+/**
+ * Mark a function for special use by Sizzle
+ * @param {Function} fn The function to mark
+ */
+function markFunction( fn ) {
+	fn[ expando ] = true;
+	return fn;
+}
+
+/**
+ * Support testing using an element
+ * @param {Function} fn Passed the created element and returns a boolean result
+ */
+function assert( fn ) {
+	var el = document.createElement("fieldset");
+
+	try {
+		return !!fn( el );
+	} catch (e) {
+		return false;
+	} finally {
+		// Remove from its parent by default
+		if ( el.parentNode ) {
+			el.parentNode.removeChild( el );
+		}
+		// release memory in IE
+		el = null;
+	}
+}
+
+/**
+ * Adds the same handler for all of the specified attrs
+ * @param {String} attrs Pipe-separated list of attributes
+ * @param {Function} handler The method that will be applied
+ */
+function addHandle( attrs, handler ) {
+	var arr = attrs.split("|"),
+		i = arr.length;
+
+	while ( i-- ) {
+		Expr.attrHandle[ arr[i] ] = handler;
+	}
+}
+
+/**
+ * Checks document order of two siblings
+ * @param {Element} a
+ * @param {Element} b
+ * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b
+ */
+function siblingCheck( a, b ) {
+	var cur = b && a,
+		diff = cur && a.nodeType === 1 && b.nodeType === 1 &&
+			a.sourceIndex - b.sourceIndex;
+
+	// Use IE sourceIndex if available on both nodes
+	if ( diff ) {
+		return diff;
+	}
+
+	// Check if b follows a
+	if ( cur ) {
+		while ( (cur = cur.nextSibling) ) {
+			if ( cur === b ) {
+				return -1;
+			}
+		}
+	}
+
+	return a ? 1 : -1;
+}
+
+/**
+ * Returns a function to use in pseudos for input types
+ * @param {String} type
+ */
+function createInputPseudo( type ) {
+	return function( elem ) {
+		var name = elem.nodeName.toLowerCase();
+		return name === "input" && elem.type === type;
+	};
+}
+
+/**
+ * Returns a function to use in pseudos for buttons
+ * @param {String} type
+ */
+function createButtonPseudo( type ) {
+	return function( elem ) {
+		var name = elem.nodeName.toLowerCase();
+		return (name === "input" || name === "button") && elem.type === type;
+	};
+}
+
+/**
+ * Returns a function to use in pseudos for :enabled/:disabled
+ * @param {Boolean} disabled true for :disabled; false for :enabled
+ */
+function createDisabledPseudo( disabled ) {
+
+	// Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable
+	return function( elem ) {
+
+		// Only certain elements can match :enabled or :disabled
+		// https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled
+		// https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled
+		if ( "form" in elem ) {
+
+			// Check for inherited disabledness on relevant non-disabled elements:
+			// * listed form-associated elements in a disabled fieldset
+			//   https://html.spec.whatwg.org/multipage/forms.html#category-listed
+			//   https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled
+			// * option elements in a disabled optgroup
+			//   https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled
+			// All such elements have a "form" property.
+			if ( elem.parentNode && elem.disabled === false ) {
+
+				// Option elements defer to a parent optgroup if present
+				if ( "label" in elem ) {
+					if ( "label" in elem.parentNode ) {
+						return elem.parentNode.disabled === disabled;
+					} else {
+						return elem.disabled === disabled;
+					}
+				}
+
+				// Support: IE 6 - 11
+				// Use the isDisabled shortcut property to check for disabled fieldset ancestors
+				return elem.isDisabled === disabled ||
+
+					// Where there is no isDisabled, check manually
+					/* jshint -W018 */
+					elem.isDisabled !== !disabled &&
+						disabledAncestor( elem ) === disabled;
+			}
+
+			return elem.disabled === disabled;
+
+		// Try to winnow out elements that can't be disabled before trusting the disabled property.
+		// Some victims get caught in our net (label, legend, menu, track), but it shouldn't
+		// even exist on them, let alone have a boolean value.
+		} else if ( "label" in elem ) {
+			return elem.disabled === disabled;
+		}
+
+		// Remaining elements are neither :enabled nor :disabled
+		return false;
+	};
+}
+
+/**
+ * Returns a function to use in pseudos for positionals
+ * @param {Function} fn
+ */
+function createPositionalPseudo( fn ) {
+	return markFunction(function( argument ) {
+		argument = +argument;
+		return markFunction(function( seed, matches ) {
+			var j,
+				matchIndexes = fn( [], seed.length, argument ),
+				i = matchIndexes.length;
+
+			// Match elements found at the specified indexes
+			while ( i-- ) {
+				if ( seed[ (j = matchIndexes[i]) ] ) {
+					seed[j] = !(matches[j] = seed[j]);
+				}
+			}
+		});
+	});
+}
+
+/**
+ * Checks a node for validity as a Sizzle context
+ * @param {Element|Object=} context
+ * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value
+ */
+function testContext( context ) {
+	return context && typeof context.getElementsByTagName !== "undefined" && context;
+}
+
+// Expose support vars for convenience
+support = Sizzle.support = {};
+
+/**
+ * Detects XML nodes
+ * @param {Element|Object} elem An element or a document
+ * @returns {Boolean} True iff elem is a non-HTML XML node
+ */
+isXML = Sizzle.isXML = function( elem ) {
+	// documentElement is verified for cases where it doesn't yet exist
+	// (such as loading iframes in IE - #4833)
+	var documentElement = elem && (elem.ownerDocument || elem).documentElement;
+	return documentElement ? documentElement.nodeName !== "HTML" : false;
+};
+
+/**
+ * Sets document-related variables once based on the current document
+ * @param {Element|Object} [doc] An element or document object to use to set the document
+ * @returns {Object} Returns the current document
+ */
+setDocument = Sizzle.setDocument = function( node ) {
+	var hasCompare, subWindow,
+		doc = node ? node.ownerDocument || node : preferredDoc;
+
+	// Return early if doc is invalid or already selected
+	if ( doc === document || doc.nodeType !== 9 || !doc.documentElement ) {
+		return document;
+	}
+
+	// Update global variables
+	document = doc;
+	docElem = document.documentElement;
+	documentIsHTML = !isXML( document );
+
+	// Support: IE 9-11, Edge
+	// Accessing iframe documents after unload throws "permission denied" errors (jQuery #13936)
+	if ( preferredDoc !== document &&
+		(subWindow = document.defaultView) && subWindow.top !== subWindow ) {
+
+		// Support: IE 11, Edge
+		if ( subWindow.addEventListener ) {
+			subWindow.addEventListener( "unload", unloadHandler, false );
+
+		// Support: IE 9 - 10 only
+		} else if ( subWindow.attachEvent ) {
+			subWindow.attachEvent( "onunload", unloadHandler );
+		}
+	}
+
+	/* Attributes
+	---------------------------------------------------------------------- */
+
+	// Support: IE<8
+	// Verify that getAttribute really returns attributes and not properties
+	// (excepting IE8 booleans)
+	support.attributes = assert(function( el ) {
+		el.className = "i";
+		return !el.getAttribute("className");
+	});
+
+	/* getElement(s)By*
+	---------------------------------------------------------------------- */
+
+	// Check if getElementsByTagName("*") returns only elements
+	support.getElementsByTagName = assert(function( el ) {
+		el.appendChild( document.createComment("") );
+		return !el.getElementsByTagName("*").length;
+	});
+
+	// Support: IE<9
+	support.getElementsByClassName = rnative.test( document.getElementsByClassName );
+
+	// Support: IE<10
+	// Check if getElementById returns elements by name
+	// The broken getElementById methods don't pick up programmatically-set names,
+	// so use a roundabout getElementsByName test
+	support.getById = assert(function( el ) {
+		docElem.appendChild( el ).id = expando;
+		return !document.getElementsByName || !document.getElementsByName( expando ).length;
+	});
+
+	// ID filter and find
+	if ( support.getById ) {
+		Expr.filter["ID"] = function( id ) {
+			var attrId = id.replace( runescape, funescape );
+			return function( elem ) {
+				return elem.getAttribute("id") === attrId;
+			};
+		};
+		Expr.find["ID"] = function( id, context ) {
+			if ( typeof context.getElementById !== "undefined" && documentIsHTML ) {
+				var elem = context.getElementById( id );
+				return elem ? [ elem ] : [];
+			}
+		};
+	} else {
+		Expr.filter["ID"] =  function( id ) {
+			var attrId = id.replace( runescape, funescape );
+			return function( elem ) {
+				var node = typeof elem.getAttributeNode !== "undefined" &&
+					elem.getAttributeNode("id");
+				return node && node.value === attrId;
+			};
+		};
+
+		// Support: IE 6 - 7 only
+		// getElementById is not reliable as a find shortcut
+		Expr.find["ID"] = function( id, context ) {
+			if ( typeof context.getElementById !== "undefined" && documentIsHTML ) {
+				var node, i, elems,
+					elem = context.getElementById( id );
+
+				if ( elem ) {
+
+					// Verify the id attribute
+					node = elem.getAttributeNode("id");
+					if ( node && node.value === id ) {
+						return [ elem ];
+					}
+
+					// Fall back on getElementsByName
+					elems = context.getElementsByName( id );
+					i = 0;
+					while ( (elem = elems[i++]) ) {
+						node = elem.getAttributeNode("id");
+						if ( node && node.value === id ) {
+							return [ elem ];
+						}
+					}
+				}
+
+				return [];
+			}
+		};
+	}
+
+	// Tag
+	Expr.find["TAG"] = support.getElementsByTagName ?
+		function( tag, context ) {
+			if ( typeof context.getElementsByTagName !== "undefined" ) {
+				return context.getElementsByTagName( tag );
+
+			// DocumentFragment nodes don't have gEBTN
+			} else if ( support.qsa ) {
+				return context.querySelectorAll( tag );
+			}
+		} :
+
+		function( tag, context ) {
+			var elem,
+				tmp = [],
+				i = 0,
+				// By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too
+				results = context.getElementsByTagName( tag );
+
+			// Filter out possible comments
+			if ( tag === "*" ) {
+				while ( (elem = results[i++]) ) {
+					if ( elem.nodeType === 1 ) {
+						tmp.push( elem );
+					}
+				}
+
+				return tmp;
+			}
+			return results;
+		};
+
+	// Class
+	Expr.find["CLASS"] = support.getElementsByClassName && function( className, context ) {
+		if ( typeof context.getElementsByClassName !== "undefined" && documentIsHTML ) {
+			return context.getElementsByClassName( className );
+		}
+	};
+
+	/* QSA/matchesSelector
+	---------------------------------------------------------------------- */
+
+	// QSA and matchesSelector support
+
+	// matchesSelector(:active) reports false when true (IE9/Opera 11.5)
+	rbuggyMatches = [];
+
+	// qSa(:focus) reports false when true (Chrome 21)
+	// We allow this because of a bug in IE8/9 that throws an error
+	// whenever `document.activeElement` is accessed on an iframe
+	// So, we allow :focus to pass through QSA all the time to avoid the IE error
+	// See https://bugs.jquery.com/ticket/13378
+	rbuggyQSA = [];
+
+	if ( (support.qsa = rnative.test( document.querySelectorAll )) ) {
+		// Build QSA regex
+		// Regex strategy adopted from Diego Perini
+		assert(function( el ) {
+			// Select is set to empty string on purpose
+			// This is to test IE's treatment of not explicitly
+			// setting a boolean content attribute,
+			// since its presence should be enough
+			// https://bugs.jquery.com/ticket/12359
+			docElem.appendChild( el ).innerHTML = "<a id='" + expando + "'></a>" +
+				"<select id='" + expando + "-\r\\' msallowcapture=''>" +
+				"<option selected=''></option></select>";
+
+			// Support: IE8, Opera 11-12.16
+			// Nothing should be selected when empty strings follow ^= or $= or *=
+			// The test attribute must be unknown in Opera but "safe" for WinRT
+			// https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section
+			if ( el.querySelectorAll("[msallowcapture^='']").length ) {
+				rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" );
+			}
+
+			// Support: IE8
+			// Boolean attributes and "value" are not treated correctly
+			if ( !el.querySelectorAll("[selected]").length ) {
+				rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" );
+			}
+
+			// Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+
+			if ( !el.querySelectorAll( "[id~=" + expando + "-]" ).length ) {
+				rbuggyQSA.push("~=");
+			}
+
+			// Webkit/Opera - :checked should return selected option elements
+			// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked
+			// IE8 throws error here and will not see later tests
+			if ( !el.querySelectorAll(":checked").length ) {
+				rbuggyQSA.push(":checked");
+			}
+
+			// Support: Safari 8+, iOS 8+
+			// https://bugs.webkit.org/show_bug.cgi?id=136851
+			// In-page `selector#id sibling-combinator selector` fails
+			if ( !el.querySelectorAll( "a#" + expando + "+*" ).length ) {
+				rbuggyQSA.push(".#.+[+~]");
+			}
+		});
+
+		assert(function( el ) {
+			el.innerHTML = "<a href='' disabled='disabled'></a>" +
+				"<select disabled='disabled'><option/></select>";
+
+			// Support: Windows 8 Native Apps
+			// The type and name attributes are restricted during .innerHTML assignment
+			var input = document.createElement("input");
+			input.setAttribute( "type", "hidden" );
+			el.appendChild( input ).setAttribute( "name", "D" );
+
+			// Support: IE8
+			// Enforce case-sensitivity of name attribute
+			if ( el.querySelectorAll("[name=d]").length ) {
+				rbuggyQSA.push( "name" + whitespace + "*[*^$|!~]?=" );
+			}
+
+			// FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled)
+			// IE8 throws error here and will not see later tests
+			if ( el.querySelectorAll(":enabled").length !== 2 ) {
+				rbuggyQSA.push( ":enabled", ":disabled" );
+			}
+
+			// Support: IE9-11+
+			// IE's :disabled selector does not pick up the children of disabled fieldsets
+			docElem.appendChild( el ).disabled = true;
+			if ( el.querySelectorAll(":disabled").length !== 2 ) {
+				rbuggyQSA.push( ":enabled", ":disabled" );
+			}
+
+			// Opera 10-11 does not throw on post-comma invalid pseudos
+			el.querySelectorAll("*,:x");
+			rbuggyQSA.push(",.*:");
+		});
+	}
+
+	if ( (support.matchesSelector = rnative.test( (matches = docElem.matches ||
+		docElem.webkitMatchesSelector ||
+		docElem.mozMatchesSelector ||
+		docElem.oMatchesSelector ||
+		docElem.msMatchesSelector) )) ) {
+
+		assert(function( el ) {
+			// Check to see if it's possible to do matchesSelector
+			// on a disconnected node (IE 9)
+			support.disconnectedMatch = matches.call( el, "*" );
+
+			// This should fail with an exception
+			// Gecko does not error, returns false instead
+			matches.call( el, "[s!='']:x" );
+			rbuggyMatches.push( "!=", pseudos );
+		});
+	}
+
+	rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join("|") );
+	rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join("|") );
+
+	/* Contains
+	---------------------------------------------------------------------- */
+	hasCompare = rnative.test( docElem.compareDocumentPosition );
+
+	// Element contains another
+	// Purposefully self-exclusive
+	// As in, an element does not contain itself
+	contains = hasCompare || rnative.test( docElem.contains ) ?
+		function( a, b ) {
+			var adown = a.nodeType === 9 ? a.documentElement : a,
+				bup = b && b.parentNode;
+			return a === bup || !!( bup && bup.nodeType === 1 && (
+				adown.contains ?
+					adown.contains( bup ) :
+					a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16
+			));
+		} :
+		function( a, b ) {
+			if ( b ) {
+				while ( (b = b.parentNode) ) {
+					if ( b === a ) {
+						return true;
+					}
+				}
+			}
+			return false;
+		};
+
+	/* Sorting
+	---------------------------------------------------------------------- */
+
+	// Document order sorting
+	sortOrder = hasCompare ?
+	function( a, b ) {
+
+		// Flag for duplicate removal
+		if ( a === b ) {
+			hasDuplicate = true;
+			return 0;
+		}
+
+		// Sort on method existence if only one input has compareDocumentPosition
+		var compare = !a.compareDocumentPosition - !b.compareDocumentPosition;
+		if ( compare ) {
+			return compare;
+		}
+
+		// Calculate position if both inputs belong to the same document
+		compare = ( a.ownerDocument || a ) === ( b.ownerDocument || b ) ?
+			a.compareDocumentPosition( b ) :
+
+			// Otherwise we know they are disconnected
+			1;
+
+		// Disconnected nodes
+		if ( compare & 1 ||
+			(!support.sortDetached && b.compareDocumentPosition( a ) === compare) ) {
+
+			// Choose the first element that is related to our preferred document
+			if ( a === document || a.ownerDocument === preferredDoc && contains(preferredDoc, a) ) {
+				return -1;
+			}
+			if ( b === document || b.ownerDocument === preferredDoc && contains(preferredDoc, b) ) {
+				return 1;
+			}
+
+			// Maintain original order
+			return sortInput ?
+				( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) :
+				0;
+		}
+
+		return compare & 4 ? -1 : 1;
+	} :
+	function( a, b ) {
+		// Exit early if the nodes are identical
+		if ( a === b ) {
+			hasDuplicate = true;
+			return 0;
+		}
+
+		var cur,
+			i = 0,
+			aup = a.parentNode,
+			bup = b.parentNode,
+			ap = [ a ],
+			bp = [ b ];
+
+		// Parentless nodes are either documents or disconnected
+		if ( !aup || !bup ) {
+			return a === document ? -1 :
+				b === document ? 1 :
+				aup ? -1 :
+				bup ? 1 :
+				sortInput ?
+				( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) :
+				0;
+
+		// If the nodes are siblings, we can do a quick check
+		} else if ( aup === bup ) {
+			return siblingCheck( a, b );
+		}
+
+		// Otherwise we need full lists of their ancestors for comparison
+		cur = a;
+		while ( (cur = cur.parentNode) ) {
+			ap.unshift( cur );
+		}
+		cur = b;
+		while ( (cur = cur.parentNode) ) {
+			bp.unshift( cur );
+		}
+
+		// Walk down the tree looking for a discrepancy
+		while ( ap[i] === bp[i] ) {
+			i++;
+		}
+
+		return i ?
+			// Do a sibling check if the nodes have a common ancestor
+			siblingCheck( ap[i], bp[i] ) :
+
+			// Otherwise nodes in our document sort first
+			ap[i] === preferredDoc ? -1 :
+			bp[i] === preferredDoc ? 1 :
+			0;
+	};
+
+	return document;
+};
+
+Sizzle.matches = function( expr, elements ) {
+	return Sizzle( expr, null, null, elements );
+};
+
+Sizzle.matchesSelector = function( elem, expr ) {
+	// Set document vars if needed
+	if ( ( elem.ownerDocument || elem ) !== document ) {
+		setDocument( elem );
+	}
+
+	// Make sure that attribute selectors are quoted
+	expr = expr.replace( rattributeQuotes, "='$1']" );
+
+	if ( support.matchesSelector && documentIsHTML &&
+		!compilerCache[ expr + " " ] &&
+		( !rbuggyMatches || !rbuggyMatches.test( expr ) ) &&
+		( !rbuggyQSA     || !rbuggyQSA.test( expr ) ) ) {
+
+		try {
+			var ret = matches.call( elem, expr );
+
+			// IE 9's matchesSelector returns false on disconnected nodes
+			if ( ret || support.disconnectedMatch ||
+					// As well, disconnected nodes are said to be in a document
+					// fragment in IE 9
+					elem.document && elem.document.nodeType !== 11 ) {
+				return ret;
+			}
+		} catch (e) {}
+	}
+
+	return Sizzle( expr, document, null, [ elem ] ).length > 0;
+};
+
+Sizzle.contains = function( context, elem ) {
+	// Set document vars if needed
+	if ( ( context.ownerDocument || context ) !== document ) {
+		setDocument( context );
+	}
+	return contains( context, elem );
+};
+
+Sizzle.attr = function( elem, name ) {
+	// Set document vars if needed
+	if ( ( elem.ownerDocument || elem ) !== document ) {
+		setDocument( elem );
+	}
+
+	var fn = Expr.attrHandle[ name.toLowerCase() ],
+		// Don't get fooled by Object.prototype properties (jQuery #13807)
+		val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ?
+			fn( elem, name, !documentIsHTML ) :
+			undefined;
+
+	return val !== undefined ?
+		val :
+		support.attributes || !documentIsHTML ?
+			elem.getAttribute( name ) :
+			(val = elem.getAttributeNode(name)) && val.specified ?
+				val.value :
+				null;
+};
+
+Sizzle.escape = function( sel ) {
+	return (sel + "").replace( rcssescape, fcssescape );
+};
+
+Sizzle.error = function( msg ) {
+	throw new Error( "Syntax error, unrecognized expression: " + msg );
+};
+
+/**
+ * Document sorting and removing duplicates
+ * @param {ArrayLike} results
+ */
+Sizzle.uniqueSort = function( results ) {
+	var elem,
+		duplicates = [],
+		j = 0,
+		i = 0;
+
+	// Unless we *know* we can detect duplicates, assume their presence
+	hasDuplicate = !support.detectDuplicates;
+	sortInput = !support.sortStable && results.slice( 0 );
+	results.sort( sortOrder );
+
+	if ( hasDuplicate ) {
+		while ( (elem = results[i++]) ) {
+			if ( elem === results[ i ] ) {
+				j = duplicates.push( i );
+			}
+		}
+		while ( j-- ) {
+			results.splice( duplicates[ j ], 1 );
+		}
+	}
+
+	// Clear input after sorting to release objects
+	// See https://github.com/jquery/sizzle/pull/225
+	sortInput = null;
+
+	return results;
+};
+
+/**
+ * Utility function for retrieving the text value of an array of DOM nodes
+ * @param {Array|Element} elem
+ */
+getText = Sizzle.getText = function( elem ) {
+	var node,
+		ret = "",
+		i = 0,
+		nodeType = elem.nodeType;
+
+	if ( !nodeType ) {
+		// If no nodeType, this is expected to be an array
+		while ( (node = elem[i++]) ) {
+			// Do not traverse comment nodes
+			ret += getText( node );
+		}
+	} else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) {
+		// Use textContent for elements
+		// innerText usage removed for consistency of new lines (jQuery #11153)
+		if ( typeof elem.textContent === "string" ) {
+			return elem.textContent;
+		} else {
+			// Traverse its children
+			for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) {
+				ret += getText( elem );
+			}
+		}
+	} else if ( nodeType === 3 || nodeType === 4 ) {
+		return elem.nodeValue;
+	}
+	// Do not include comment or processing instruction nodes
+
+	return ret;
+};
+
+Expr = Sizzle.selectors = {
+
+	// Can be adjusted by the user
+	cacheLength: 50,
+
+	createPseudo: markFunction,
+
+	match: matchExpr,
+
+	attrHandle: {},
+
+	find: {},
+
+	relative: {
+		">": { dir: "parentNode", first: true },
+		" ": { dir: "parentNode" },
+		"+": { dir: "previousSibling", first: true },
+		"~": { dir: "previousSibling" }
+	},
+
+	preFilter: {
+		"ATTR": function( match ) {
+			match[1] = match[1].replace( runescape, funescape );
+
+			// Move the given value to match[3] whether quoted or unquoted
+			match[3] = ( match[3] || match[4] || match[5] || "" ).replace( runescape, funescape );
+
+			if ( match[2] === "~=" ) {
+				match[3] = " " + match[3] + " ";
+			}
+
+			return match.slice( 0, 4 );
+		},
+
+		"CHILD": function( match ) {
+			/* matches from matchExpr["CHILD"]
+				1 type (only|nth|...)
+				2 what (child|of-type)
+				3 argument (even|odd|\d*|\d*n([+-]\d+)?|...)
+				4 xn-component of xn+y argument ([+-]?\d*n|)
+				5 sign of xn-component
+				6 x of xn-component
+				7 sign of y-component
+				8 y of y-component
+			*/
+			match[1] = match[1].toLowerCase();
+
+			if ( match[1].slice( 0, 3 ) === "nth" ) {
+				// nth-* requires argument
+				if ( !match[3] ) {
+					Sizzle.error( match[0] );
+				}
+
+				// numeric x and y parameters for Expr.filter.CHILD
+				// remember that false/true cast respectively to 0/1
+				match[4] = +( match[4] ? match[5] + (match[6] || 1) : 2 * ( match[3] === "even" || match[3] === "odd" ) );
+				match[5] = +( ( match[7] + match[8] ) || match[3] === "odd" );
+
+			// other types prohibit arguments
+			} else if ( match[3] ) {
+				Sizzle.error( match[0] );
+			}
+
+			return match;
+		},
+
+		"PSEUDO": function( match ) {
+			var excess,
+				unquoted = !match[6] && match[2];
+
+			if ( matchExpr["CHILD"].test( match[0] ) ) {
+				return null;
+			}
+
+			// Accept quoted arguments as-is
+			if ( match[3] ) {
+				match[2] = match[4] || match[5] || "";
+
+			// Strip excess characters from unquoted arguments
+			} else if ( unquoted && rpseudo.test( unquoted ) &&
+				// Get excess from tokenize (recursively)
+				(excess = tokenize( unquoted, true )) &&
+				// advance to the next closing parenthesis
+				(excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length) ) {
+
+				// excess is a negative index
+				match[0] = match[0].slice( 0, excess );
+				match[2] = unquoted.slice( 0, excess );
+			}
+
+			// Return only captures needed by the pseudo filter method (type and argument)
+			return match.slice( 0, 3 );
+		}
+	},
+
+	filter: {
+
+		"TAG": function( nodeNameSelector ) {
+			var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase();
+			return nodeNameSelector === "*" ?
+				function() { return true; } :
+				function( elem ) {
+					return elem.nodeName && elem.nodeName.toLowerCase() === nodeName;
+				};
+		},
+
+		"CLASS": function( className ) {
+			var pattern = classCache[ className + " " ];
+
+			return pattern ||
+				(pattern = new RegExp( "(^|" + whitespace + ")" + className + "(" + whitespace + "|$)" )) &&
+				classCache( className, function( elem ) {
+					return pattern.test( typeof elem.className === "string" && elem.className || typeof elem.getAttribute !== "undefined" && elem.getAttribute("class") || "" );
+				});
+		},
+
+		"ATTR": function( name, operator, check ) {
+			return function( elem ) {
+				var result = Sizzle.attr( elem, name );
+
+				if ( result == null ) {
+					return operator === "!=";
+				}
+				if ( !operator ) {
+					return true;
+				}
+
+				result += "";
+
+				return operator === "=" ? result === check :
+					operator === "!=" ? result !== check :
+					operator === "^=" ? check && result.indexOf( check ) === 0 :
+					operator === "*=" ? check && result.indexOf( check ) > -1 :
+					operator === "$=" ? check && result.slice( -check.length ) === check :
+					operator === "~=" ? ( " " + result.replace( rwhitespace, " " ) + " " ).indexOf( check ) > -1 :
+					operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" :
+					false;
+			};
+		},
+
+		"CHILD": function( type, what, argument, first, last ) {
+			var simple = type.slice( 0, 3 ) !== "nth",
+				forward = type.slice( -4 ) !== "last",
+				ofType = what === "of-type";
+
+			return first === 1 && last === 0 ?
+
+				// Shortcut for :nth-*(n)
+				function( elem ) {
+					return !!elem.parentNode;
+				} :
+
+				function( elem, context, xml ) {
+					var cache, uniqueCache, outerCache, node, nodeIndex, start,
+						dir = simple !== forward ? "nextSibling" : "previousSibling",
+						parent = elem.parentNode,
+						name = ofType && elem.nodeName.toLowerCase(),
+						useCache = !xml && !ofType,
+						diff = false;
+
+					if ( parent ) {
+
+						// :(first|last|only)-(child|of-type)
+						if ( simple ) {
+							while ( dir ) {
+								node = elem;
+								while ( (node = node[ dir ]) ) {
+									if ( ofType ?
+										node.nodeName.toLowerCase() === name :
+										node.nodeType === 1 ) {
+
+										return false;
+									}
+								}
+								// Reverse direction for :only-* (if we haven't yet done so)
+								start = dir = type === "only" && !start && "nextSibling";
+							}
+							return true;
+						}
+
+						start = [ forward ? parent.firstChild : parent.lastChild ];
+
+						// non-xml :nth-child(...) stores cache data on `parent`
+						if ( forward && useCache ) {
+
+							// Seek `elem` from a previously-cached index
+
+							// ...in a gzip-friendly way
+							node = parent;
+							outerCache = node[ expando ] || (node[ expando ] = {});
+
+							// Support: IE <9 only
+							// Defend against cloned attroperties (jQuery gh-1709)
+							uniqueCache = outerCache[ node.uniqueID ] ||
+								(outerCache[ node.uniqueID ] = {});
+
+							cache = uniqueCache[ type ] || [];
+							nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ];
+							diff = nodeIndex && cache[ 2 ];
+							node = nodeIndex && parent.childNodes[ nodeIndex ];
+
+							while ( (node = ++nodeIndex && node && node[ dir ] ||
+
+								// Fallback to seeking `elem` from the start
+								(diff = nodeIndex = 0) || start.pop()) ) {
+
+								// When found, cache indexes on `parent` and break
+								if ( node.nodeType === 1 && ++diff && node === elem ) {
+									uniqueCache[ type ] = [ dirruns, nodeIndex, diff ];
+									break;
+								}
+							}
+
+						} else {
+							// Use previously-cached element index if available
+							if ( useCache ) {
+								// ...in a gzip-friendly way
+								node = elem;
+								outerCache = node[ expando ] || (node[ expando ] = {});
+
+								// Support: IE <9 only
+								// Defend against cloned attroperties (jQuery gh-1709)
+								uniqueCache = outerCache[ node.uniqueID ] ||
+									(outerCache[ node.uniqueID ] = {});
+
+								cache = uniqueCache[ type ] || [];
+								nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ];
+								diff = nodeIndex;
+							}
+
+							// xml :nth-child(...)
+							// or :nth-last-child(...) or :nth(-last)?-of-type(...)
+							if ( diff === false ) {
+								// Use the same loop as above to seek `elem` from the start
+								while ( (node = ++nodeIndex && node && node[ dir ] ||
+									(diff = nodeIndex = 0) || start.pop()) ) {
+
+									if ( ( ofType ?
+										node.nodeName.toLowerCase() === name :
+										node.nodeType === 1 ) &&
+										++diff ) {
+
+										// Cache the index of each encountered element
+										if ( useCache ) {
+											outerCache = node[ expando ] || (node[ expando ] = {});
+
+											// Support: IE <9 only
+											// Defend against cloned attroperties (jQuery gh-1709)
+											uniqueCache = outerCache[ node.uniqueID ] ||
+												(outerCache[ node.uniqueID ] = {});
+
+											uniqueCache[ type ] = [ dirruns, diff ];
+										}
+
+										if ( node === elem ) {
+											break;
+										}
+									}
+								}
+							}
+						}
+
+						// Incorporate the offset, then check against cycle size
+						diff -= last;
+						return diff === first || ( diff % first === 0 && diff / first >= 0 );
+					}
+				};
+		},
+
+		"PSEUDO": function( pseudo, argument ) {
+			// pseudo-class names are case-insensitive
+			// http://www.w3.org/TR/selectors/#pseudo-classes
+			// Prioritize by case sensitivity in case custom pseudos are added with uppercase letters
+			// Remember that setFilters inherits from pseudos
+			var args,
+				fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] ||
+					Sizzle.error( "unsupported pseudo: " + pseudo );
+
+			// The user may use createPseudo to indicate that
+			// arguments are needed to create the filter function
+			// just as Sizzle does
+			if ( fn[ expando ] ) {
+				return fn( argument );
+			}
+
+			// But maintain support for old signatures
+			if ( fn.length > 1 ) {
+				args = [ pseudo, pseudo, "", argument ];
+				return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ?
+					markFunction(function( seed, matches ) {
+						var idx,
+							matched = fn( seed, argument ),
+							i = matched.length;
+						while ( i-- ) {
+							idx = indexOf( seed, matched[i] );
+							seed[ idx ] = !( matches[ idx ] = matched[i] );
+						}
+					}) :
+					function( elem ) {
+						return fn( elem, 0, args );
+					};
+			}
+
+			return fn;
+		}
+	},
+
+	pseudos: {
+		// Potentially complex pseudos
+		"not": markFunction(function( selector ) {
+			// Trim the selector passed to compile
+			// to avoid treating leading and trailing
+			// spaces as combinators
+			var input = [],
+				results = [],
+				matcher = compile( selector.replace( rtrim, "$1" ) );
+
+			return matcher[ expando ] ?
+				markFunction(function( seed, matches, context, xml ) {
+					var elem,
+						unmatched = matcher( seed, null, xml, [] ),
+						i = seed.length;
+
+					// Match elements unmatched by `matcher`
+					while ( i-- ) {
+						if ( (elem = unmatched[i]) ) {
+							seed[i] = !(matches[i] = elem);
+						}
+					}
+				}) :
+				function( elem, context, xml ) {
+					input[0] = elem;
+					matcher( input, null, xml, results );
+					// Don't keep the element (issue #299)
+					input[0] = null;
+					return !results.pop();
+				};
+		}),
+
+		"has": markFunction(function( selector ) {
+			return function( elem ) {
+				return Sizzle( selector, elem ).length > 0;
+			};
+		}),
+
+		"contains": markFunction(function( text ) {
+			text = text.replace( runescape, funescape );
+			return function( elem ) {
+				return ( elem.textContent || elem.innerText || getText( elem ) ).indexOf( text ) > -1;
+			};
+		}),
+
+		// "Whether an element is represented by a :lang() selector
+		// is based solely on the element's language value
+		// being equal to the identifier C,
+		// or beginning with the identifier C immediately followed by "-".
+		// The matching of C against the element's language value is performed case-insensitively.
+		// The identifier C does not have to be a valid language name."
+		// http://www.w3.org/TR/selectors/#lang-pseudo
+		"lang": markFunction( function( lang ) {
+			// lang value must be a valid identifier
+			if ( !ridentifier.test(lang || "") ) {
+				Sizzle.error( "unsupported lang: " + lang );
+			}
+			lang = lang.replace( runescape, funescape ).toLowerCase();
+			return function( elem ) {
+				var elemLang;
+				do {
+					if ( (elemLang = documentIsHTML ?
+						elem.lang :
+						elem.getAttribute("xml:lang") || elem.getAttribute("lang")) ) {
+
+						elemLang = elemLang.toLowerCase();
+						return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0;
+					}
+				} while ( (elem = elem.parentNode) && elem.nodeType === 1 );
+				return false;
+			};
+		}),
+
+		// Miscellaneous
+		"target": function( elem ) {
+			var hash = window.location && window.location.hash;
+			return hash && hash.slice( 1 ) === elem.id;
+		},
+
+		"root": function( elem ) {
+			return elem === docElem;
+		},
+
+		"focus": function( elem ) {
+			return elem === document.activeElement && (!document.hasFocus || document.hasFocus()) && !!(elem.type || elem.href || ~elem.tabIndex);
+		},
+
+		// Boolean properties
+		"enabled": createDisabledPseudo( false ),
+		"disabled": createDisabledPseudo( true ),
+
+		"checked": function( elem ) {
+			// In CSS3, :checked should return both checked and selected elements
+			// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked
+			var nodeName = elem.nodeName.toLowerCase();
+			return (nodeName === "input" && !!elem.checked) || (nodeName === "option" && !!elem.selected);
+		},
+
+		"selected": function( elem ) {
+			// Accessing this property makes selected-by-default
+			// options in Safari work properly
+			if ( elem.parentNode ) {
+				elem.parentNode.selectedIndex;
+			}
+
+			return elem.selected === true;
+		},
+
+		// Contents
+		"empty": function( elem ) {
+			// http://www.w3.org/TR/selectors/#empty-pseudo
+			// :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5),
+			//   but not by others (comment: 8; processing instruction: 7; etc.)
+			// nodeType < 6 works because attributes (2) do not appear as children
+			for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) {
+				if ( elem.nodeType < 6 ) {
+					return false;
+				}
+			}
+			return true;
+		},
+
+		"parent": function( elem ) {
+			return !Expr.pseudos["empty"]( elem );
+		},
+
+		// Element/input types
+		"header": function( elem ) {
+			return rheader.test( elem.nodeName );
+		},
+
+		"input": function( elem ) {
+			return rinputs.test( elem.nodeName );
+		},
+
+		"button": function( elem ) {
+			var name = elem.nodeName.toLowerCase();
+			return name === "input" && elem.type === "button" || name === "button";
+		},
+
+		"text": function( elem ) {
+			var attr;
+			return elem.nodeName.toLowerCase() === "input" &&
+				elem.type === "text" &&
+
+				// Support: IE<8
+				// New HTML5 attribute values (e.g., "search") appear with elem.type === "text"
+				( (attr = elem.getAttribute("type")) == null || attr.toLowerCase() === "text" );
+		},
+
+		// Position-in-collection
+		"first": createPositionalPseudo(function() {
+			return [ 0 ];
+		}),
+
+		"last": createPositionalPseudo(function( matchIndexes, length ) {
+			return [ length - 1 ];
+		}),
+
+		"eq": createPositionalPseudo(function( matchIndexes, length, argument ) {
+			return [ argument < 0 ? argument + length : argument ];
+		}),
+
+		"even": createPositionalPseudo(function( matchIndexes, length ) {
+			var i = 0;
+			for ( ; i < length; i += 2 ) {
+				matchIndexes.push( i );
+			}
+			return matchIndexes;
+		}),
+
+		"odd": createPositionalPseudo(function( matchIndexes, length ) {
+			var i = 1;
+			for ( ; i < length; i += 2 ) {
+				matchIndexes.push( i );
+			}
+			return matchIndexes;
+		}),
+
+		"lt": createPositionalPseudo(function( matchIndexes, length, argument ) {
+			var i = argument < 0 ? argument + length : argument;
+			for ( ; --i >= 0; ) {
+				matchIndexes.push( i );
+			}
+			return matchIndexes;
+		}),
+
+		"gt": createPositionalPseudo(function( matchIndexes, length, argument ) {
+			var i = argument < 0 ? argument + length : argument;
+			for ( ; ++i < length; ) {
+				matchIndexes.push( i );
+			}
+			return matchIndexes;
+		})
+	}
+};
+
+Expr.pseudos["nth"] = Expr.pseudos["eq"];
+
+// Add button/input type pseudos
+for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) {
+	Expr.pseudos[ i ] = createInputPseudo( i );
+}
+for ( i in { submit: true, reset: true } ) {
+	Expr.pseudos[ i ] = createButtonPseudo( i );
+}
+
+// Easy API for creating new setFilters
+function setFilters() {}
+setFilters.prototype = Expr.filters = Expr.pseudos;
+Expr.setFilters = new setFilters();
+
+tokenize = Sizzle.tokenize = function( selector, parseOnly ) {
+	var matched, match, tokens, type,
+		soFar, groups, preFilters,
+		cached = tokenCache[ selector + " " ];
+
+	if ( cached ) {
+		return parseOnly ? 0 : cached.slice( 0 );
+	}
+
+	soFar = selector;
+	groups = [];
+	preFilters = Expr.preFilter;
+
+	while ( soFar ) {
+
+		// Comma and first run
+		if ( !matched || (match = rcomma.exec( soFar )) ) {
+			if ( match ) {
+				// Don't consume trailing commas as valid
+				soFar = soFar.slice( match[0].length ) || soFar;
+			}
+			groups.push( (tokens = []) );
+		}
+
+		matched = false;
+
+		// Combinators
+		if ( (match = rcombinators.exec( soFar )) ) {
+			matched = match.shift();
+			tokens.push({
+				value: matched,
+				// Cast descendant combinators to space
+				type: match[0].replace( rtrim, " " )
+			});
+			soFar = soFar.slice( matched.length );
+		}
+
+		// Filters
+		for ( type in Expr.filter ) {
+			if ( (match = matchExpr[ type ].exec( soFar )) && (!preFilters[ type ] ||
+				(match = preFilters[ type ]( match ))) ) {
+				matched = match.shift();
+				tokens.push({
+					value: matched,
+					type: type,
+					matches: match
+				});
+				soFar = soFar.slice( matched.length );
+			}
+		}
+
+		if ( !matched ) {
+			break;
+		}
+	}
+
+	// Return the length of the invalid excess
+	// if we're just parsing
+	// Otherwise, throw an error or return tokens
+	return parseOnly ?
+		soFar.length :
+		soFar ?
+			Sizzle.error( selector ) :
+			// Cache the tokens
+			tokenCache( selector, groups ).slice( 0 );
+};
+
+function toSelector( tokens ) {
+	var i = 0,
+		len = tokens.length,
+		selector = "";
+	for ( ; i < len; i++ ) {
+		selector += tokens[i].value;
+	}
+	return selector;
+}
+
+function addCombinator( matcher, combinator, base ) {
+	var dir = combinator.dir,
+		skip = combinator.next,
+		key = skip || dir,
+		checkNonElements = base && key === "parentNode",
+		doneName = done++;
+
+	return combinator.first ?
+		// Check against closest ancestor/preceding element
+		function( elem, context, xml ) {
+			while ( (elem = elem[ dir ]) ) {
+				if ( elem.nodeType === 1 || checkNonElements ) {
+					return matcher( elem, context, xml );
+				}
+			}
+			return false;
+		} :
+
+		// Check against all ancestor/preceding elements
+		function( elem, context, xml ) {
+			var oldCache, uniqueCache, outerCache,
+				newCache = [ dirruns, doneName ];
+
+			// We can't set arbitrary data on XML nodes, so they don't benefit from combinator caching
+			if ( xml ) {
+				while ( (elem = elem[ dir ]) ) {
+					if ( elem.nodeType === 1 || checkNonElements ) {
+						if ( matcher( elem, context, xml ) ) {
+							return true;
+						}
+					}
+				}
+			} else {
+				while ( (elem = elem[ dir ]) ) {
+					if ( elem.nodeType === 1 || checkNonElements ) {
+						outerCache = elem[ expando ] || (elem[ expando ] = {});
+
+						// Support: IE <9 only
+						// Defend against cloned attroperties (jQuery gh-1709)
+						uniqueCache = outerCache[ elem.uniqueID ] || (outerCache[ elem.uniqueID ] = {});
+
+						if ( skip && skip === elem.nodeName.toLowerCase() ) {
+							elem = elem[ dir ] || elem;
+						} else if ( (oldCache = uniqueCache[ key ]) &&
+							oldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) {
+
+							// Assign to newCache so results back-propagate to previous elements
+							return (newCache[ 2 ] = oldCache[ 2 ]);
+						} else {
+							// Reuse newcache so results back-propagate to previous elements
+							uniqueCache[ key ] = newCache;
+
+							// A match means we're done; a fail means we have to keep checking
+							if ( (newCache[ 2 ] = matcher( elem, context, xml )) ) {
+								return true;
+							}
+						}
+					}
+				}
+			}
+			return false;
+		};
+}
+
+function elementMatcher( matchers ) {
+	return matchers.length > 1 ?
+		function( elem, context, xml ) {
+			var i = matchers.length;
+			while ( i-- ) {
+				if ( !matchers[i]( elem, context, xml ) ) {
+					return false;
+				}
+			}
+			return true;
+		} :
+		matchers[0];
+}
+
+function multipleContexts( selector, contexts, results ) {
+	var i = 0,
+		len = contexts.length;
+	for ( ; i < len; i++ ) {
+		Sizzle( selector, contexts[i], results );
+	}
+	return results;
+}
+
+function condense( unmatched, map, filter, context, xml ) {
+	var elem,
+		newUnmatched = [],
+		i = 0,
+		len = unmatched.length,
+		mapped = map != null;
+
+	for ( ; i < len; i++ ) {
+		if ( (elem = unmatched[i]) ) {
+			if ( !filter || filter( elem, context, xml ) ) {
+				newUnmatched.push( elem );
+				if ( mapped ) {
+					map.push( i );
+				}
+			}
+		}
+	}
+
+	return newUnmatched;
+}
+
+function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) {
+	if ( postFilter && !postFilter[ expando ] ) {
+		postFilter = setMatcher( postFilter );
+	}
+	if ( postFinder && !postFinder[ expando ] ) {
+		postFinder = setMatcher( postFinder, postSelector );
+	}
+	return markFunction(function( seed, results, context, xml ) {
+		var temp, i, elem,
+			preMap = [],
+			postMap = [],
+			preexisting = results.length,
+
+			// Get initial elements from seed or context
+			elems = seed || multipleContexts( selector || "*", context.nodeType ? [ context ] : context, [] ),
+
+			// Prefilter to get matcher input, preserving a map for seed-results synchronization
+			matcherIn = preFilter && ( seed || !selector ) ?
+				condense( elems, preMap, preFilter, context, xml ) :
+				elems,
+
+			matcherOut = matcher ?
+				// If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results,
+				postFinder || ( seed ? preFilter : preexisting || postFilter ) ?
+
+					// ...intermediate processing is necessary
+					[] :
+
+					// ...otherwise use results directly
+					results :
+				matcherIn;
+
+		// Find primary matches
+		if ( matcher ) {
+			matcher( matcherIn, matcherOut, context, xml );
+		}
+
+		// Apply postFilter
+		if ( postFilter ) {
+			temp = condense( matcherOut, postMap );
+			postFilter( temp, [], context, xml );
+
+			// Un-match failing elements by moving them back to matcherIn
+			i = temp.length;
+			while ( i-- ) {
+				if ( (elem = temp[i]) ) {
+					matcherOut[ postMap[i] ] = !(matcherIn[ postMap[i] ] = elem);
+				}
+			}
+		}
+
+		if ( seed ) {
+			if ( postFinder || preFilter ) {
+				if ( postFinder ) {
+					// Get the final matcherOut by condensing this intermediate into postFinder contexts
+					temp = [];
+					i = matcherOut.length;
+					while ( i-- ) {
+						if ( (elem = matcherOut[i]) ) {
+							// Restore matcherIn since elem is not yet a final match
+							temp.push( (matcherIn[i] = elem) );
+						}
+					}
+					postFinder( null, (matcherOut = []), temp, xml );
+				}
+
+				// Move matched elements from seed to results to keep them synchronized
+				i = matcherOut.length;
+				while ( i-- ) {
+					if ( (elem = matcherOut[i]) &&
+						(temp = postFinder ? indexOf( seed, elem ) : preMap[i]) > -1 ) {
+
+						seed[temp] = !(results[temp] = elem);
+					}
+				}
+			}
+
+		// Add elements to results, through postFinder if defined
+		} else {
+			matcherOut = condense(
+				matcherOut === results ?
+					matcherOut.splice( preexisting, matcherOut.length ) :
+					matcherOut
+			);
+			if ( postFinder ) {
+				postFinder( null, results, matcherOut, xml );
+			} else {
+				push.apply( results, matcherOut );
+			}
+		}
+	});
+}
+
+function matcherFromTokens( tokens ) {
+	var checkContext, matcher, j,
+		len = tokens.length,
+		leadingRelative = Expr.relative[ tokens[0].type ],
+		implicitRelative = leadingRelative || Expr.relative[" "],
+		i = leadingRelative ? 1 : 0,
+
+		// The foundational matcher ensures that elements are reachable from top-level context(s)
+		matchContext = addCombinator( function( elem ) {
+			return elem === checkContext;
+		}, implicitRelative, true ),
+		matchAnyContext = addCombinator( function( elem ) {
+			return indexOf( checkContext, elem ) > -1;
+		}, implicitRelative, true ),
+		matchers = [ function( elem, context, xml ) {
+			var ret = ( !leadingRelative && ( xml || context !== outermostContext ) ) || (
+				(checkContext = context).nodeType ?
+					matchContext( elem, context, xml ) :
+					matchAnyContext( elem, context, xml ) );
+			// Avoid hanging onto element (issue #299)
+			checkContext = null;
+			return ret;
+		} ];
+
+	for ( ; i < len; i++ ) {
+		if ( (matcher = Expr.relative[ tokens[i].type ]) ) {
+			matchers = [ addCombinator(elementMatcher( matchers ), matcher) ];
+		} else {
+			matcher = Expr.filter[ tokens[i].type ].apply( null, tokens[i].matches );
+
+			// Return special upon seeing a positional matcher
+			if ( matcher[ expando ] ) {
+				// Find the next relative operator (if any) for proper handling
+				j = ++i;
+				for ( ; j < len; j++ ) {
+					if ( Expr.relative[ tokens[j].type ] ) {
+						break;
+					}
+				}
+				return setMatcher(
+					i > 1 && elementMatcher( matchers ),
+					i > 1 && toSelector(
+						// If the preceding token was a descendant combinator, insert an implicit any-element `*`
+						tokens.slice( 0, i - 1 ).concat({ value: tokens[ i - 2 ].type === " " ? "*" : "" })
+					).replace( rtrim, "$1" ),
+					matcher,
+					i < j && matcherFromTokens( tokens.slice( i, j ) ),
+					j < len && matcherFromTokens( (tokens = tokens.slice( j )) ),
+					j < len && toSelector( tokens )
+				);
+			}
+			matchers.push( matcher );
+		}
+	}
+
+	return elementMatcher( matchers );
+}
+
+function matcherFromGroupMatchers( elementMatchers, setMatchers ) {
+	var bySet = setMatchers.length > 0,
+		byElement = elementMatchers.length > 0,
+		superMatcher = function( seed, context, xml, results, outermost ) {
+			var elem, j, matcher,
+				matchedCount = 0,
+				i = "0",
+				unmatched = seed && [],
+				setMatched = [],
+				contextBackup = outermostContext,
+				// We must always have either seed elements or outermost context
+				elems = seed || byElement && Expr.find["TAG"]( "*", outermost ),
+				// Use integer dirruns iff this is the outermost matcher
+				dirrunsUnique = (dirruns += contextBackup == null ? 1 : Math.random() || 0.1),
+				len = elems.length;
+
+			if ( outermost ) {
+				outermostContext = context === document || context || outermost;
+			}
+
+			// Add elements passing elementMatchers directly to results
+			// Support: IE<9, Safari
+			// Tolerate NodeList properties (IE: "length"; Safari: <number>) matching elements by id
+			for ( ; i !== len && (elem = elems[i]) != null; i++ ) {
+				if ( byElement && elem ) {
+					j = 0;
+					if ( !context && elem.ownerDocument !== document ) {
+						setDocument( elem );
+						xml = !documentIsHTML;
+					}
+					while ( (matcher = elementMatchers[j++]) ) {
+						if ( matcher( elem, context || document, xml) ) {
+							results.push( elem );
+							break;
+						}
+					}
+					if ( outermost ) {
+						dirruns = dirrunsUnique;
+					}
+				}
+
+				// Track unmatched elements for set filters
+				if ( bySet ) {
+					// They will have gone through all possible matchers
+					if ( (elem = !matcher && elem) ) {
+						matchedCount--;
+					}
+
+					// Lengthen the array for every element, matched or not
+					if ( seed ) {
+						unmatched.push( elem );
+					}
+				}
+			}
+
+			// `i` is now the count of elements visited above, and adding it to `matchedCount`
+			// makes the latter nonnegative.
+			matchedCount += i;
+
+			// Apply set filters to unmatched elements
+			// NOTE: This can be skipped if there are no unmatched elements (i.e., `matchedCount`
+			// equals `i`), unless we didn't visit _any_ elements in the above loop because we have
+			// no element matchers and no seed.
+			// Incrementing an initially-string "0" `i` allows `i` to remain a string only in that
+			// case, which will result in a "00" `matchedCount` that differs from `i` but is also
+			// numerically zero.
+			if ( bySet && i !== matchedCount ) {
+				j = 0;
+				while ( (matcher = setMatchers[j++]) ) {
+					matcher( unmatched, setMatched, context, xml );
+				}
+
+				if ( seed ) {
+					// Reintegrate element matches to eliminate the need for sorting
+					if ( matchedCount > 0 ) {
+						while ( i-- ) {
+							if ( !(unmatched[i] || setMatched[i]) ) {
+								setMatched[i] = pop.call( results );
+							}
+						}
+					}
+
+					// Discard index placeholder values to get only actual matches
+					setMatched = condense( setMatched );
+				}
+
+				// Add matches to results
+				push.apply( results, setMatched );
+
+				// Seedless set matches succeeding multiple successful matchers stipulate sorting
+				if ( outermost && !seed && setMatched.length > 0 &&
+					( matchedCount + setMatchers.length ) > 1 ) {
+
+					Sizzle.uniqueSort( results );
+				}
+			}
+
+			// Override manipulation of globals by nested matchers
+			if ( outermost ) {
+				dirruns = dirrunsUnique;
+				outermostContext = contextBackup;
+			}
+
+			return unmatched;
+		};
+
+	return bySet ?
+		markFunction( superMatcher ) :
+		superMatcher;
+}
+
+compile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) {
+	var i,
+		setMatchers = [],
+		elementMatchers = [],
+		cached = compilerCache[ selector + " " ];
+
+	if ( !cached ) {
+		// Generate a function of recursive functions that can be used to check each element
+		if ( !match ) {
+			match = tokenize( selector );
+		}
+		i = match.length;
+		while ( i-- ) {
+			cached = matcherFromTokens( match[i] );
+			if ( cached[ expando ] ) {
+				setMatchers.push( cached );
+			} else {
+				elementMatchers.push( cached );
+			}
+		}
+
+		// Cache the compiled function
+		cached = compilerCache( selector, matcherFromGroupMatchers( elementMatchers, setMatchers ) );
+
+		// Save selector and tokenization
+		cached.selector = selector;
+	}
+	return cached;
+};
+
+/**
+ * A low-level selection function that works with Sizzle's compiled
+ *  selector functions
+ * @param {String|Function} selector A selector or a pre-compiled
+ *  selector function built with Sizzle.compile
+ * @param {Element} context
+ * @param {Array} [results]
+ * @param {Array} [seed] A set of elements to match against
+ */
+select = Sizzle.select = function( selector, context, results, seed ) {
+	var i, tokens, token, type, find,
+		compiled = typeof selector === "function" && selector,
+		match = !seed && tokenize( (selector = compiled.selector || selector) );
+
+	results = results || [];
+
+	// Try to minimize operations if there is only one selector in the list and no seed
+	// (the latter of which guarantees us context)
+	if ( match.length === 1 ) {
+
+		// Reduce context if the leading compound selector is an ID
+		tokens = match[0] = match[0].slice( 0 );
+		if ( tokens.length > 2 && (token = tokens[0]).type === "ID" &&
+				context.nodeType === 9 && documentIsHTML && Expr.relative[ tokens[1].type ] ) {
+
+			context = ( Expr.find["ID"]( token.matches[0].replace(runescape, funescape), context ) || [] )[0];
+			if ( !context ) {
+				return results;
+
+			// Precompiled matchers will still verify ancestry, so step up a level
+			} else if ( compiled ) {
+				context = context.parentNode;
+			}
+
+			selector = selector.slice( tokens.shift().value.length );
+		}
+
+		// Fetch a seed set for right-to-left matching
+		i = matchExpr["needsContext"].test( selector ) ? 0 : tokens.length;
+		while ( i-- ) {
+			token = tokens[i];
+
+			// Abort if we hit a combinator
+			if ( Expr.relative[ (type = token.type) ] ) {
+				break;
+			}
+			if ( (find = Expr.find[ type ]) ) {
+				// Search, expanding context for leading sibling combinators
+				if ( (seed = find(
+					token.matches[0].replace( runescape, funescape ),
+					rsibling.test( tokens[0].type ) && testContext( context.parentNode ) || context
+				)) ) {
+
+					// If seed is empty or no tokens remain, we can return early
+					tokens.splice( i, 1 );
+					selector = seed.length && toSelector( tokens );
+					if ( !selector ) {
+						push.apply( results, seed );
+						return results;
+					}
+
+					break;
+				}
+			}
+		}
+	}
+
+	// Compile and execute a filtering function if one is not provided
+	// Provide `match` to avoid retokenization if we modified the selector above
+	( compiled || compile( selector, match ) )(
+		seed,
+		context,
+		!documentIsHTML,
+		results,
+		!context || rsibling.test( selector ) && testContext( context.parentNode ) || context
+	);
+	return results;
+};
+
+// One-time assignments
+
+// Sort stability
+support.sortStable = expando.split("").sort( sortOrder ).join("") === expando;
+
+// Support: Chrome 14-35+
+// Always assume duplicates if they aren't passed to the comparison function
+support.detectDuplicates = !!hasDuplicate;
+
+// Initialize against the default document
+setDocument();
+
+// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27)
+// Detached nodes confoundingly follow *each other*
+support.sortDetached = assert(function( el ) {
+	// Should return 1, but returns 4 (following)
+	return el.compareDocumentPosition( document.createElement("fieldset") ) & 1;
+});
+
+// Support: IE<8
+// Prevent attribute/property "interpolation"
+// https://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx
+if ( !assert(function( el ) {
+	el.innerHTML = "<a href='#'></a>";
+	return el.firstChild.getAttribute("href") === "#" ;
+}) ) {
+	addHandle( "type|href|height|width", function( elem, name, isXML ) {
+		if ( !isXML ) {
+			return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 );
+		}
+	});
+}
+
+// Support: IE<9
+// Use defaultValue in place of getAttribute("value")
+if ( !support.attributes || !assert(function( el ) {
+	el.innerHTML = "<input/>";
+	el.firstChild.setAttribute( "value", "" );
+	return el.firstChild.getAttribute( "value" ) === "";
+}) ) {
+	addHandle( "value", function( elem, name, isXML ) {
+		if ( !isXML && elem.nodeName.toLowerCase() === "input" ) {
+			return elem.defaultValue;
+		}
+	});
+}
+
+// Support: IE<9
+// Use getAttributeNode to fetch booleans when getAttribute lies
+if ( !assert(function( el ) {
+	return el.getAttribute("disabled") == null;
+}) ) {
+	addHandle( booleans, function( elem, name, isXML ) {
+		var val;
+		if ( !isXML ) {
+			return elem[ name ] === true ? name.toLowerCase() :
+					(val = elem.getAttributeNode( name )) && val.specified ?
+					val.value :
+				null;
+		}
+	});
+}
+
+return Sizzle;
+
+})( window );
+
+
+
+jQuery.find = Sizzle;
+jQuery.expr = Sizzle.selectors;
+
+// Deprecated
+jQuery.expr[ ":" ] = jQuery.expr.pseudos;
+jQuery.uniqueSort = jQuery.unique = Sizzle.uniqueSort;
+jQuery.text = Sizzle.getText;
+jQuery.isXMLDoc = Sizzle.isXML;
+jQuery.contains = Sizzle.contains;
+jQuery.escapeSelector = Sizzle.escape;
+
+
+
+
+var dir = function( elem, dir, until ) {
+	var matched = [],
+		truncate = until !== undefined;
+
+	while ( ( elem = elem[ dir ] ) && elem.nodeType !== 9 ) {
+		if ( elem.nodeType === 1 ) {
+			if ( truncate && jQuery( elem ).is( until ) ) {
+				break;
+			}
+			matched.push( elem );
+		}
+	}
+	return matched;
+};
+
+
+var siblings = function( n, elem ) {
+	var matched = [];
+
+	for ( ; n; n = n.nextSibling ) {
+		if ( n.nodeType === 1 && n !== elem ) {
+			matched.push( n );
+		}
+	}
+
+	return matched;
+};
+
+
+var rneedsContext = jQuery.expr.match.needsContext;
+
+
+
+function nodeName( elem, name ) {
+
+  return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase();
+
+};
+var rsingleTag = ( /^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i );
+
+
+
+// Implement the identical functionality for filter and not
+function winnow( elements, qualifier, not ) {
+	if ( isFunction( qualifier ) ) {
+		return jQuery.grep( elements, function( elem, i ) {
+			return !!qualifier.call( elem, i, elem ) !== not;
+		} );
+	}
+
+	// Single element
+	if ( qualifier.nodeType ) {
+		return jQuery.grep( elements, function( elem ) {
+			return ( elem === qualifier ) !== not;
+		} );
+	}
+
+	// Arraylike of elements (jQuery, arguments, Array)
+	if ( typeof qualifier !== "string" ) {
+		return jQuery.grep( elements, function( elem ) {
+			return ( indexOf.call( qualifier, elem ) > -1 ) !== not;
+		} );
+	}
+
+	// Filtered directly for both simple and complex selectors
+	return jQuery.filter( qualifier, elements, not );
+}
+
+jQuery.filter = function( expr, elems, not ) {
+	var elem = elems[ 0 ];
+
+	if ( not ) {
+		expr = ":not(" + expr + ")";
+	}
+
+	if ( elems.length === 1 && elem.nodeType === 1 ) {
+		return jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : [];
+	}
+
+	return jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) {
+		return elem.nodeType === 1;
+	} ) );
+};
+
+jQuery.fn.extend( {
+	find: function( selector ) {
+		var i, ret,
+			len = this.length,
+			self = this;
+
+		if ( typeof selector !== "string" ) {
+			return this.pushStack( jQuery( selector ).filter( function() {
+				for ( i = 0; i < len; i++ ) {
+					if ( jQuery.contains( self[ i ], this ) ) {
+						return true;
+					}
+				}
+			} ) );
+		}
+
+		ret = this.pushStack( [] );
+
+		for ( i = 0; i < len; i++ ) {
+			jQuery.find( selector, self[ i ], ret );
+		}
+
+		return len > 1 ? jQuery.uniqueSort( ret ) : ret;
+	},
+	filter: function( selector ) {
+		return this.pushStack( winnow( this, selector || [], false ) );
+	},
+	not: function( selector ) {
+		return this.pushStack( winnow( this, selector || [], true ) );
+	},
+	is: function( selector ) {
+		return !!winnow(
+			this,
+
+			// If this is a positional/relative selector, check membership in the returned set
+			// so $("p:first").is("p:last") won't return true for a doc with two "p".
+			typeof selector === "string" && rneedsContext.test( selector ) ?
+				jQuery( selector ) :
+				selector || [],
+			false
+		).length;
+	}
+} );
+
+
+// Initialize a jQuery object
+
+
+// A central reference to the root jQuery(document)
+var rootjQuery,
+
+	// A simple way to check for HTML strings
+	// Prioritize #id over <tag> to avoid XSS via location.hash (#9521)
+	// Strict HTML recognition (#11290: must start with <)
+	// Shortcut simple #id case for speed
+	rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/,
+
+	init = jQuery.fn.init = function( selector, context, root ) {
+		var match, elem;
+
+		// HANDLE: $(""), $(null), $(undefined), $(false)
+		if ( !selector ) {
+			return this;
+		}
+
+		// Method init() accepts an alternate rootjQuery
+		// so migrate can support jQuery.sub (gh-2101)
+		root = root || rootjQuery;
+
+		// Handle HTML strings
+		if ( typeof selector === "string" ) {
+			if ( selector[ 0 ] === "<" &&
+				selector[ selector.length - 1 ] === ">" &&
+				selector.length >= 3 ) {
+
+				// Assume that strings that start and end with <> are HTML and skip the regex check
+				match = [ null, selector, null ];
+
+			} else {
+				match = rquickExpr.exec( selector );
+			}
+
+			// Match html or make sure no context is specified for #id
+			if ( match && ( match[ 1 ] || !context ) ) {
+
+				// HANDLE: $(html) -> $(array)
+				if ( match[ 1 ] ) {
+					context = context instanceof jQuery ? context[ 0 ] : context;
+
+					// Option to run scripts is true for back-compat
+					// Intentionally let the error be thrown if parseHTML is not present
+					jQuery.merge( this, jQuery.parseHTML(
+						match[ 1 ],
+						context && context.nodeType ? context.ownerDocument || context : document,
+						true
+					) );
+
+					// HANDLE: $(html, props)
+					if ( rsingleTag.test( match[ 1 ] ) && jQuery.isPlainObject( context ) ) {
+						for ( match in context ) {
+
+							// Properties of context are called as methods if possible
+							if ( isFunction( this[ match ] ) ) {
+								this[ match ]( context[ match ] );
+
+							// ...and otherwise set as attributes
+							} else {
+								this.attr( match, context[ match ] );
+							}
+						}
+					}
+
+					return this;
+
+				// HANDLE: $(#id)
+				} else {
+					elem = document.getElementById( match[ 2 ] );
+
+					if ( elem ) {
+
+						// Inject the element directly into the jQuery object
+						this[ 0 ] = elem;
+						this.length = 1;
+					}
+					return this;
+				}
+
+			// HANDLE: $(expr, $(...))
+			} else if ( !context || context.jquery ) {
+				return ( context || root ).find( selector );
+
+			// HANDLE: $(expr, context)
+			// (which is just equivalent to: $(context).find(expr)
+			} else {
+				return this.constructor( context ).find( selector );
+			}
+
+		// HANDLE: $(DOMElement)
+		} else if ( selector.nodeType ) {
+			this[ 0 ] = selector;
+			this.length = 1;
+			return this;
+
+		// HANDLE: $(function)
+		// Shortcut for document ready
+		} else if ( isFunction( selector ) ) {
+			return root.ready !== undefined ?
+				root.ready( selector ) :
+
+				// Execute immediately if ready is not present
+				selector( jQuery );
+		}
+
+		return jQuery.makeArray( selector, this );
+	};
+
+// Give the init function the jQuery prototype for later instantiation
+init.prototype = jQuery.fn;
+
+// Initialize central reference
+rootjQuery = jQuery( document );
+
+
+var rparentsprev = /^(?:parents|prev(?:Until|All))/,
+
+	// Methods guaranteed to produce a unique set when starting from a unique set
+	guaranteedUnique = {
+		children: true,
+		contents: true,
+		next: true,
+		prev: true
+	};
+
+jQuery.fn.extend( {
+	has: function( target ) {
+		var targets = jQuery( target, this ),
+			l = targets.length;
+
+		return this.filter( function() {
+			var i = 0;
+			for ( ; i < l; i++ ) {
+				if ( jQuery.contains( this, targets[ i ] ) ) {
+					return true;
+				}
+			}
+		} );
+	},
+
+	closest: function( selectors, context ) {
+		var cur,
+			i = 0,
+			l = this.length,
+			matched = [],
+			targets = typeof selectors !== "string" && jQuery( selectors );
+
+		// Positional selectors never match, since there's no _selection_ context
+		if ( !rneedsContext.test( selectors ) ) {
+			for ( ; i < l; i++ ) {
+				for ( cur = this[ i ]; cur && cur !== context; cur = cur.parentNode ) {
+
+					// Always skip document fragments
+					if ( cur.nodeType < 11 && ( targets ?
+						targets.index( cur ) > -1 :
+
+						// Don't pass non-elements to Sizzle
+						cur.nodeType === 1 &&
+							jQuery.find.matchesSelector( cur, selectors ) ) ) {
+
+						matched.push( cur );
+						break;
+					}
+				}
+			}
+		}
+
+		return this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched );
+	},
+
+	// Determine the position of an element within the set
+	index: function( elem ) {
+
+		// No argument, return index in parent
+		if ( !elem ) {
+			return ( this[ 0 ] && this[ 0 ].parentNode ) ? this.first().prevAll().length : -1;
+		}
+
+		// Index in selector
+		if ( typeof elem === "string" ) {
+			return indexOf.call( jQuery( elem ), this[ 0 ] );
+		}
+
+		// Locate the position of the desired element
+		return indexOf.call( this,
+
+			// If it receives a jQuery object, the first element is used
+			elem.jquery ? elem[ 0 ] : elem
+		);
+	},
+
+	add: function( selector, context ) {
+		return this.pushStack(
+			jQuery.uniqueSort(
+				jQuery.merge( this.get(), jQuery( selector, context ) )
+			)
+		);
+	},
+
+	addBack: function( selector ) {
+		return this.add( selector == null ?
+			this.prevObject : this.prevObject.filter( selector )
+		);
+	}
+} );
+
+function sibling( cur, dir ) {
+	while ( ( cur = cur[ dir ] ) && cur.nodeType !== 1 ) {}
+	return cur;
+}
+
+jQuery.each( {
+	parent: function( elem ) {
+		var parent = elem.parentNode;
+		return parent && parent.nodeType !== 11 ? parent : null;
+	},
+	parents: function( elem ) {
+		return dir( elem, "parentNode" );
+	},
+	parentsUntil: function( elem, i, until ) {
+		return dir( elem, "parentNode", until );
+	},
+	next: function( elem ) {
+		return sibling( elem, "nextSibling" );
+	},
+	prev: function( elem ) {
+		return sibling( elem, "previousSibling" );
+	},
+	nextAll: function( elem ) {
+		return dir( elem, "nextSibling" );
+	},
+	prevAll: function( elem ) {
+		return dir( elem, "previousSibling" );
+	},
+	nextUntil: function( elem, i, until ) {
+		return dir( elem, "nextSibling", until );
+	},
+	prevUntil: function( elem, i, until ) {
+		return dir( elem, "previousSibling", until );
+	},
+	siblings: function( elem ) {
+		return siblings( ( elem.parentNode || {} ).firstChild, elem );
+	},
+	children: function( elem ) {
+		return siblings( elem.firstChild );
+	},
+	contents: function( elem ) {
+        if ( nodeName( elem, "iframe" ) ) {
+            return elem.contentDocument;
+        }
+
+        // Support: IE 9 - 11 only, iOS 7 only, Android Browser <=4.3 only
+        // Treat the template element as a regular one in browsers that
+        // don't support it.
+        if ( nodeName( elem, "template" ) ) {
+            elem = elem.content || elem;
+        }
+
+        return jQuery.merge( [], elem.childNodes );
+	}
+}, function( name, fn ) {
+	jQuery.fn[ name ] = function( until, selector ) {
+		var matched = jQuery.map( this, fn, until );
+
+		if ( name.slice( -5 ) !== "Until" ) {
+			selector = until;
+		}
+
+		if ( selector && typeof selector === "string" ) {
+			matched = jQuery.filter( selector, matched );
+		}
+
+		if ( this.length > 1 ) {
+
+			// Remove duplicates
+			if ( !guaranteedUnique[ name ] ) {
+				jQuery.uniqueSort( matched );
+			}
+
+			// Reverse order for parents* and prev-derivatives
+			if ( rparentsprev.test( name ) ) {
+				matched.reverse();
+			}
+		}
+
+		return this.pushStack( matched );
+	};
+} );
+var rnothtmlwhite = ( /[^\x20\t\r\n\f]+/g );
+
+
+
+// Convert String-formatted options into Object-formatted ones
+function createOptions( options ) {
+	var object = {};
+	jQuery.each( options.match( rnothtmlwhite ) || [], function( _, flag ) {
+		object[ flag ] = true;
+	} );
+	return object;
+}
+
+/*
+ * Create a callback list using the following parameters:
+ *
+ *	options: an optional list of space-separated options that will change how
+ *			the callback list behaves or a more traditional option object
+ *
+ * By default a callback list will act like an event callback list and can be
+ * "fired" multiple times.
+ *
+ * Possible options:
+ *
+ *	once:			will ensure the callback list can only be fired once (like a Deferred)
+ *
+ *	memory:			will keep track of previous values and will call any callback added
+ *					after the list has been fired right away with the latest "memorized"
+ *					values (like a Deferred)
+ *
+ *	unique:			will ensure a callback can only be added once (no duplicate in the list)
+ *
+ *	stopOnFalse:	interrupt callings when a callback returns false
+ *
+ */
+jQuery.Callbacks = function( options ) {
+
+	// Convert options from String-formatted to Object-formatted if needed
+	// (we check in cache first)
+	options = typeof options === "string" ?
+		createOptions( options ) :
+		jQuery.extend( {}, options );
+
+	var // Flag to know if list is currently firing
+		firing,
+
+		// Last fire value for non-forgettable lists
+		memory,
+
+		// Flag to know if list was already fired
+		fired,
+
+		// Flag to prevent firing
+		locked,
+
+		// Actual callback list
+		list = [],
+
+		// Queue of execution data for repeatable lists
+		queue = [],
+
+		// Index of currently firing callback (modified by add/remove as needed)
+		firingIndex = -1,
+
+		// Fire callbacks
+		fire = function() {
+
+			// Enforce single-firing
+			locked = locked || options.once;
+
+			// Execute callbacks for all pending executions,
+			// respecting firingIndex overrides and runtime changes
+			fired = firing = true;
+			for ( ; queue.length; firingIndex = -1 ) {
+				memory = queue.shift();
+				while ( ++firingIndex < list.length ) {
+
+					// Run callback and check for early termination
+					if ( list[ firingIndex ].apply( memory[ 0 ], memory[ 1 ] ) === false &&
+						options.stopOnFalse ) {
+
+						// Jump to end and forget the data so .add doesn't re-fire
+						firingIndex = list.length;
+						memory = false;
+					}
+				}
+			}
+
+			// Forget the data if we're done with it
+			if ( !options.memory ) {
+				memory = false;
+			}
+
+			firing = false;
+
+			// Clean up if we're done firing for good
+			if ( locked ) {
+
+				// Keep an empty list if we have data for future add calls
+				if ( memory ) {
+					list = [];
+
+				// Otherwise, this object is spent
+				} else {
+					list = "";
+				}
+			}
+		},
+
+		// Actual Callbacks object
+		self = {
+
+			// Add a callback or a collection of callbacks to the list
+			add: function() {
+				if ( list ) {
+
+					// If we have memory from a past run, we should fire after adding
+					if ( memory && !firing ) {
+						firingIndex = list.length - 1;
+						queue.push( memory );
+					}
+
+					( function add( args ) {
+						jQuery.each( args, function( _, arg ) {
+							if ( isFunction( arg ) ) {
+								if ( !options.unique || !self.has( arg ) ) {
+									list.push( arg );
+								}
+							} else if ( arg && arg.length && toType( arg ) !== "string" ) {
+
+								// Inspect recursively
+								add( arg );
+							}
+						} );
+					} )( arguments );
+
+					if ( memory && !firing ) {
+						fire();
+					}
+				}
+				return this;
+			},
+
+			// Remove a callback from the list
+			remove: function() {
+				jQuery.each( arguments, function( _, arg ) {
+					var index;
+					while ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) {
+						list.splice( index, 1 );
+
+						// Handle firing indexes
+						if ( index <= firingIndex ) {
+							firingIndex--;
+						}
+					}
+				} );
+				return this;
+			},
+
+			// Check if a given callback is in the list.
+			// If no argument is given, return whether or not list has callbacks attached.
+			has: function( fn ) {
+				return fn ?
+					jQuery.inArray( fn, list ) > -1 :
+					list.length > 0;
+			},
+
+			// Remove all callbacks from the list
+			empty: function() {
+				if ( list ) {
+					list = [];
+				}
+				return this;
+			},
+
+			// Disable .fire and .add
+			// Abort any current/pending executions
+			// Clear all callbacks and values
+			disable: function() {
+				locked = queue = [];
+				list = memory = "";
+				return this;
+			},
+			disabled: function() {
+				return !list;
+			},
+
+			// Disable .fire
+			// Also disable .add unless we have memory (since it would have no effect)
+			// Abort any pending executions
+			lock: function() {
+				locked = queue = [];
+				if ( !memory && !firing ) {
+					list = memory = "";
+				}
+				return this;
+			},
+			locked: function() {
+				return !!locked;
+			},
+
+			// Call all callbacks with the given context and arguments
+			fireWith: function( context, args ) {
+				if ( !locked ) {
+					args = args || [];
+					args = [ context, args.slice ? args.slice() : args ];
+					queue.push( args );
+					if ( !firing ) {
+						fire();
+					}
+				}
+				return this;
+			},
+
+			// Call all the callbacks with the given arguments
+			fire: function() {
+				self.fireWith( this, arguments );
+				return this;
+			},
+
+			// To know if the callbacks have already been called at least once
+			fired: function() {
+				return !!fired;
+			}
+		};
+
+	return self;
+};
+
+
+function Identity( v ) {
+	return v;
+}
+function Thrower( ex ) {
+	throw ex;
+}
+
+function adoptValue( value, resolve, reject, noValue ) {
+	var method;
+
+	try {
+
+		// Check for promise aspect first to privilege synchronous behavior
+		if ( value && isFunction( ( method = value.promise ) ) ) {
+			method.call( value ).done( resolve ).fail( reject );
+
+		// Other thenables
+		} else if ( value && isFunction( ( method = value.then ) ) ) {
+			method.call( value, resolve, reject );
+
+		// Other non-thenables
+		} else {
+
+			// Control `resolve` arguments by letting Array#slice cast boolean `noValue` to integer:
+			// * false: [ value ].slice( 0 ) => resolve( value )
+			// * true: [ value ].slice( 1 ) => resolve()
+			resolve.apply( undefined, [ value ].slice( noValue ) );
+		}
+
+	// For Promises/A+, convert exceptions into rejections
+	// Since jQuery.when doesn't unwrap thenables, we can skip the extra checks appearing in
+	// Deferred#then to conditionally suppress rejection.
+	} catch ( value ) {
+
+		// Support: Android 4.0 only
+		// Strict mode functions invoked without .call/.apply get global-object context
+		reject.apply( undefined, [ value ] );
+	}
+}
+
+jQuery.extend( {
+
+	Deferred: function( func ) {
+		var tuples = [
+
+				// action, add listener, callbacks,
+				// ... .then handlers, argument index, [final state]
+				[ "notify", "progress", jQuery.Callbacks( "memory" ),
+					jQuery.Callbacks( "memory" ), 2 ],
+				[ "resolve", "done", jQuery.Callbacks( "once memory" ),
+					jQuery.Callbacks( "once memory" ), 0, "resolved" ],
+				[ "reject", "fail", jQuery.Callbacks( "once memory" ),
+					jQuery.Callbacks( "once memory" ), 1, "rejected" ]
+			],
+			state = "pending",
+			promise = {
+				state: function() {
+					return state;
+				},
+				always: function() {
+					deferred.done( arguments ).fail( arguments );
+					return this;
+				},
+				"catch": function( fn ) {
+					return promise.then( null, fn );
+				},
+
+				// Keep pipe for back-compat
+				pipe: function( /* fnDone, fnFail, fnProgress */ ) {
+					var fns = arguments;
+
+					return jQuery.Deferred( function( newDefer ) {
+						jQuery.each( tuples, function( i, tuple ) {
+
+							// Map tuples (progress, done, fail) to arguments (done, fail, progress)
+							var fn = isFunction( fns[ tuple[ 4 ] ] ) && fns[ tuple[ 4 ] ];
+
+							// deferred.progress(function() { bind to newDefer or newDefer.notify })
+							// deferred.done(function() { bind to newDefer or newDefer.resolve })
+							// deferred.fail(function() { bind to newDefer or newDefer.reject })
+							deferred[ tuple[ 1 ] ]( function() {
+								var returned = fn && fn.apply( this, arguments );
+								if ( returned && isFunction( returned.promise ) ) {
+									returned.promise()
+										.progress( newDefer.notify )
+										.done( newDefer.resolve )
+										.fail( newDefer.reject );
+								} else {
+									newDefer[ tuple[ 0 ] + "With" ](
+										this,
+										fn ? [ returned ] : arguments
+									);
+								}
+							} );
+						} );
+						fns = null;
+					} ).promise();
+				},
+				then: function( onFulfilled, onRejected, onProgress ) {
+					var maxDepth = 0;
+					function resolve( depth, deferred, handler, special ) {
+						return function() {
+							var that = this,
+								args = arguments,
+								mightThrow = function() {
+									var returned, then;
+
+									// Support: Promises/A+ section 2.3.3.3.3
+									// https://promisesaplus.com/#point-59
+									// Ignore double-resolution attempts
+									if ( depth < maxDepth ) {
+										return;
+									}
+
+									returned = handler.apply( that, args );
+
+									// Support: Promises/A+ section 2.3.1
+									// https://promisesaplus.com/#point-48
+									if ( returned === deferred.promise() ) {
+										throw new TypeError( "Thenable self-resolution" );
+									}
+
+									// Support: Promises/A+ sections 2.3.3.1, 3.5
+									// https://promisesaplus.com/#point-54
+									// https://promisesaplus.com/#point-75
+									// Retrieve `then` only once
+									then = returned &&
+
+										// Support: Promises/A+ section 2.3.4
+										// https://promisesaplus.com/#point-64
+										// Only check objects and functions for thenability
+										( typeof returned === "object" ||
+											typeof returned === "function" ) &&
+										returned.then;
+
+									// Handle a returned thenable
+									if ( isFunction( then ) ) {
+
+										// Special processors (notify) just wait for resolution
+										if ( special ) {
+											then.call(
+												returned,
+												resolve( maxDepth, deferred, Identity, special ),
+												resolve( maxDepth, deferred, Thrower, special )
+											);
+
+										// Normal processors (resolve) also hook into progress
+										} else {
+
+											// ...and disregard older resolution values
+											maxDepth++;
+
+											then.call(
+												returned,
+												resolve( maxDepth, deferred, Identity, special ),
+												resolve( maxDepth, deferred, Thrower, special ),
+												resolve( maxDepth, deferred, Identity,
+													deferred.notifyWith )
+											);
+										}
+
+									// Handle all other returned values
+									} else {
+
+										// Only substitute handlers pass on context
+										// and multiple values (non-spec behavior)
+										if ( handler !== Identity ) {
+											that = undefined;
+											args = [ returned ];
+										}
+
+										// Process the value(s)
+										// Default process is resolve
+										( special || deferred.resolveWith )( that, args );
+									}
+								},
+
+								// Only normal processors (resolve) catch and reject exceptions
+								process = special ?
+									mightThrow :
+									function() {
+										try {
+											mightThrow();
+										} catch ( e ) {
+
+											if ( jQuery.Deferred.exceptionHook ) {
+												jQuery.Deferred.exceptionHook( e,
+													process.stackTrace );
+											}
+
+											// Support: Promises/A+ section 2.3.3.3.4.1
+											// https://promisesaplus.com/#point-61
+											// Ignore post-resolution exceptions
+											if ( depth + 1 >= maxDepth ) {
+
+												// Only substitute handlers pass on context
+												// and multiple values (non-spec behavior)
+												if ( handler !== Thrower ) {
+													that = undefined;
+													args = [ e ];
+												}
+
+												deferred.rejectWith( that, args );
+											}
+										}
+									};
+
+							// Support: Promises/A+ section 2.3.3.3.1
+							// https://promisesaplus.com/#point-57
+							// Re-resolve promises immediately to dodge false rejection from
+							// subsequent errors
+							if ( depth ) {
+								process();
+							} else {
+
+								// Call an optional hook to record the stack, in case of exception
+								// since it's otherwise lost when execution goes async
+								if ( jQuery.Deferred.getStackHook ) {
+									process.stackTrace = jQuery.Deferred.getStackHook();
+								}
+								window.setTimeout( process );
+							}
+						};
+					}
+
+					return jQuery.Deferred( function( newDefer ) {
+
+						// progress_handlers.add( ... )
+						tuples[ 0 ][ 3 ].add(
+							resolve(
+								0,
+								newDefer,
+								isFunction( onProgress ) ?
+									onProgress :
+									Identity,
+								newDefer.notifyWith
+							)
+						);
+
+						// fulfilled_handlers.add( ... )
+						tuples[ 1 ][ 3 ].add(
+							resolve(
+								0,
+								newDefer,
+								isFunction( onFulfilled ) ?
+									onFulfilled :
+									Identity
+							)
+						);
+
+						// rejected_handlers.add( ... )
+						tuples[ 2 ][ 3 ].add(
+							resolve(
+								0,
+								newDefer,
+								isFunction( onRejected ) ?
+									onRejected :
+									Thrower
+							)
+						);
+					} ).promise();
+				},
+
+				// Get a promise for this deferred
+				// If obj is provided, the promise aspect is added to the object
+				promise: function( obj ) {
+					return obj != null ? jQuery.extend( obj, promise ) : promise;
+				}
+			},
+			deferred = {};
+
+		// Add list-specific methods
+		jQuery.each( tuples, function( i, tuple ) {
+			var list = tuple[ 2 ],
+				stateString = tuple[ 5 ];
+
+			// promise.progress = list.add
+			// promise.done = list.add
+			// promise.fail = list.add
+			promise[ tuple[ 1 ] ] = list.add;
+
+			// Handle state
+			if ( stateString ) {
+				list.add(
+					function() {
+
+						// state = "resolved" (i.e., fulfilled)
+						// state = "rejected"
+						state = stateString;
+					},
+
+					// rejected_callbacks.disable
+					// fulfilled_callbacks.disable
+					tuples[ 3 - i ][ 2 ].disable,
+
+					// rejected_handlers.disable
+					// fulfilled_handlers.disable
+					tuples[ 3 - i ][ 3 ].disable,
+
+					// progress_callbacks.lock
+					tuples[ 0 ][ 2 ].lock,
+
+					// progress_handlers.lock
+					tuples[ 0 ][ 3 ].lock
+				);
+			}
+
+			// progress_handlers.fire
+			// fulfilled_handlers.fire
+			// rejected_handlers.fire
+			list.add( tuple[ 3 ].fire );
+
+			// deferred.notify = function() { deferred.notifyWith(...) }
+			// deferred.resolve = function() { deferred.resolveWith(...) }
+			// deferred.reject = function() { deferred.rejectWith(...) }
+			deferred[ tuple[ 0 ] ] = function() {
+				deferred[ tuple[ 0 ] + "With" ]( this === deferred ? undefined : this, arguments );
+				return this;
+			};
+
+			// deferred.notifyWith = list.fireWith
+			// deferred.resolveWith = list.fireWith
+			// deferred.rejectWith = list.fireWith
+			deferred[ tuple[ 0 ] + "With" ] = list.fireWith;
+		} );
+
+		// Make the deferred a promise
+		promise.promise( deferred );
+
+		// Call given func if any
+		if ( func ) {
+			func.call( deferred, deferred );
+		}
+
+		// All done!
+		return deferred;
+	},
+
+	// Deferred helper
+	when: function( singleValue ) {
+		var
+
+			// count of uncompleted subordinates
+			remaining = arguments.length,
+
+			// count of unprocessed arguments
+			i = remaining,
+
+			// subordinate fulfillment data
+			resolveContexts = Array( i ),
+			resolveValues = slice.call( arguments ),
+
+			// the master Deferred
+			master = jQuery.Deferred(),
+
+			// subordinate callback factory
+			updateFunc = function( i ) {
+				return function( value ) {
+					resolveContexts[ i ] = this;
+					resolveValues[ i ] = arguments.length > 1 ? slice.call( arguments ) : value;
+					if ( !( --remaining ) ) {
+						master.resolveWith( resolveContexts, resolveValues );
+					}
+				};
+			};
+
+		// Single- and empty arguments are adopted like Promise.resolve
+		if ( remaining <= 1 ) {
+			adoptValue( singleValue, master.done( updateFunc( i ) ).resolve, master.reject,
+				!remaining );
+
+			// Use .then() to unwrap secondary thenables (cf. gh-3000)
+			if ( master.state() === "pending" ||
+				isFunction( resolveValues[ i ] && resolveValues[ i ].then ) ) {
+
+				return master.then();
+			}
+		}
+
+		// Multiple arguments are aggregated like Promise.all array elements
+		while ( i-- ) {
+			adoptValue( resolveValues[ i ], updateFunc( i ), master.reject );
+		}
+
+		return master.promise();
+	}
+} );
+
+
+// These usually indicate a programmer mistake during development,
+// warn about them ASAP rather than swallowing them by default.
+var rerrorNames = /^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;
+
+jQuery.Deferred.exceptionHook = function( error, stack ) {
+
+	// Support: IE 8 - 9 only
+	// Console exists when dev tools are open, which can happen at any time
+	if ( window.console && window.console.warn && error && rerrorNames.test( error.name ) ) {
+		window.console.warn( "jQuery.Deferred exception: " + error.message, error.stack, stack );
+	}
+};
+
+
+
+
+jQuery.readyException = function( error ) {
+	window.setTimeout( function() {
+		throw error;
+	} );
+};
+
+
+
+
+// The deferred used on DOM ready
+var readyList = jQuery.Deferred();
+
+jQuery.fn.ready = function( fn ) {
+
+	readyList
+		.then( fn )
+
+		// Wrap jQuery.readyException in a function so that the lookup
+		// happens at the time of error handling instead of callback
+		// registration.
+		.catch( function( error ) {
+			jQuery.readyException( error );
+		} );
+
+	return this;
+};
+
+jQuery.extend( {
+
+	// Is the DOM ready to be used? Set to true once it occurs.
+	isReady: false,
+
+	// A counter to track how many items to wait for before
+	// the ready event fires. See #6781
+	readyWait: 1,
+
+	// Handle when the DOM is ready
+	ready: function( wait ) {
+
+		// Abort if there are pending holds or we're already ready
+		if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) {
+			return;
+		}
+
+		// Remember that the DOM is ready
+		jQuery.isReady = true;
+
+		// If a normal DOM Ready event fired, decrement, and wait if need be
+		if ( wait !== true && --jQuery.readyWait > 0 ) {
+			return;
+		}
+
+		// If there are functions bound, to execute
+		readyList.resolveWith( document, [ jQuery ] );
+	}
+} );
+
+jQuery.ready.then = readyList.then;
+
+// The ready event handler and self cleanup method
+function completed() {
+	document.removeEventListener( "DOMContentLoaded", completed );
+	window.removeEventListener( "load", completed );
+	jQuery.ready();
+}
+
+// Catch cases where $(document).ready() is called
+// after the browser event has already occurred.
+// Support: IE <=9 - 10 only
+// Older IE sometimes signals "interactive" too soon
+if ( document.readyState === "complete" ||
+	( document.readyState !== "loading" && !document.documentElement.doScroll ) ) {
+
+	// Handle it asynchronously to allow scripts the opportunity to delay ready
+	window.setTimeout( jQuery.ready );
+
+} else {
+
+	// Use the handy event callback
+	document.addEventListener( "DOMContentLoaded", completed );
+
+	// A fallback to window.onload, that will always work
+	window.addEventListener( "load", completed );
+}
+
+
+
+
+// Multifunctional method to get and set values of a collection
+// The value/s can optionally be executed if it's a function
+var access = function( elems, fn, key, value, chainable, emptyGet, raw ) {
+	var i = 0,
+		len = elems.length,
+		bulk = key == null;
+
+	// Sets many values
+	if ( toType( key ) === "object" ) {
+		chainable = true;
+		for ( i in key ) {
+			access( elems, fn, i, key[ i ], true, emptyGet, raw );
+		}
+
+	// Sets one value
+	} else if ( value !== undefined ) {
+		chainable = true;
+
+		if ( !isFunction( value ) ) {
+			raw = true;
+		}
+
+		if ( bulk ) {
+
+			// Bulk operations run against the entire set
+			if ( raw ) {
+				fn.call( elems, value );
+				fn = null;
+
+			// ...except when executing function values
+			} else {
+				bulk = fn;
+				fn = function( elem, key, value ) {
+					return bulk.call( jQuery( elem ), value );
+				};
+			}
+		}
+
+		if ( fn ) {
+			for ( ; i < len; i++ ) {
+				fn(
+					elems[ i ], key, raw ?
+					value :
+					value.call( elems[ i ], i, fn( elems[ i ], key ) )
+				);
+			}
+		}
+	}
+
+	if ( chainable ) {
+		return elems;
+	}
+
+	// Gets
+	if ( bulk ) {
+		return fn.call( elems );
+	}
+
+	return len ? fn( elems[ 0 ], key ) : emptyGet;
+};
+
+
+// Matches dashed string for camelizing
+var rmsPrefix = /^-ms-/,
+	rdashAlpha = /-([a-z])/g;
+
+// Used by camelCase as callback to replace()
+function fcamelCase( all, letter ) {
+	return letter.toUpperCase();
+}
+
+// Convert dashed to camelCase; used by the css and data modules
+// Support: IE <=9 - 11, Edge 12 - 15
+// Microsoft forgot to hump their vendor prefix (#9572)
+function camelCase( string ) {
+	return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase );
+}
+var acceptData = function( owner ) {
+
+	// Accepts only:
+	//  - Node
+	//    - Node.ELEMENT_NODE
+	//    - Node.DOCUMENT_NODE
+	//  - Object
+	//    - Any
+	return owner.nodeType === 1 || owner.nodeType === 9 || !( +owner.nodeType );
+};
+
+
+
+
+function Data() {
+	this.expando = jQuery.expando + Data.uid++;
+}
+
+Data.uid = 1;
+
+Data.prototype = {
+
+	cache: function( owner ) {
+
+		// Check if the owner object already has a cache
+		var value = owner[ this.expando ];
+
+		// If not, create one
+		if ( !value ) {
+			value = {};
+
+			// We can accept data for non-element nodes in modern browsers,
+			// but we should not, see #8335.
+			// Always return an empty object.
+			if ( acceptData( owner ) ) {
+
+				// If it is a node unlikely to be stringify-ed or looped over
+				// use plain assignment
+				if ( owner.nodeType ) {
+					owner[ this.expando ] = value;
+
+				// Otherwise secure it in a non-enumerable property
+				// configurable must be true to allow the property to be
+				// deleted when data is removed
+				} else {
+					Object.defineProperty( owner, this.expando, {
+						value: value,
+						configurable: true
+					} );
+				}
+			}
+		}
+
+		return value;
+	},
+	set: function( owner, data, value ) {
+		var prop,
+			cache = this.cache( owner );
+
+		// Handle: [ owner, key, value ] args
+		// Always use camelCase key (gh-2257)
+		if ( typeof data === "string" ) {
+			cache[ camelCase( data ) ] = value;
+
+		// Handle: [ owner, { properties } ] args
+		} else {
+
+			// Copy the properties one-by-one to the cache object
+			for ( prop in data ) {
+				cache[ camelCase( prop ) ] = data[ prop ];
+			}
+		}
+		return cache;
+	},
+	get: function( owner, key ) {
+		return key === undefined ?
+			this.cache( owner ) :
+
+			// Always use camelCase key (gh-2257)
+			owner[ this.expando ] && owner[ this.expando ][ camelCase( key ) ];
+	},
+	access: function( owner, key, value ) {
+
+		// In cases where either:
+		//
+		//   1. No key was specified
+		//   2. A string key was specified, but no value provided
+		//
+		// Take the "read" path and allow the get method to determine
+		// which value to return, respectively either:
+		//
+		//   1. The entire cache object
+		//   2. The data stored at the key
+		//
+		if ( key === undefined ||
+				( ( key && typeof key === "string" ) && value === undefined ) ) {
+
+			return this.get( owner, key );
+		}
+
+		// When the key is not a string, or both a key and value
+		// are specified, set or extend (existing objects) with either:
+		//
+		//   1. An object of properties
+		//   2. A key and value
+		//
+		this.set( owner, key, value );
+
+		// Since the "set" path can have two possible entry points
+		// return the expected data based on which path was taken[*]
+		return value !== undefined ? value : key;
+	},
+	remove: function( owner, key ) {
+		var i,
+			cache = owner[ this.expando ];
+
+		if ( cache === undefined ) {
+			return;
+		}
+
+		if ( key !== undefined ) {
+
+			// Support array or space separated string of keys
+			if ( Array.isArray( key ) ) {
+
+				// If key is an array of keys...
+				// We always set camelCase keys, so remove that.
+				key = key.map( camelCase );
+			} else {
+				key = camelCase( key );
+
+				// If a key with the spaces exists, use it.
+				// Otherwise, create an array by matching non-whitespace
+				key = key in cache ?
+					[ key ] :
+					( key.match( rnothtmlwhite ) || [] );
+			}
+
+			i = key.length;
+
+			while ( i-- ) {
+				delete cache[ key[ i ] ];
+			}
+		}
+
+		// Remove the expando if there's no more data
+		if ( key === undefined || jQuery.isEmptyObject( cache ) ) {
+
+			// Support: Chrome <=35 - 45
+			// Webkit & Blink performance suffers when deleting properties
+			// from DOM nodes, so set to undefined instead
+			// https://bugs.chromium.org/p/chromium/issues/detail?id=378607 (bug restricted)
+			if ( owner.nodeType ) {
+				owner[ this.expando ] = undefined;
+			} else {
+				delete owner[ this.expando ];
+			}
+		}
+	},
+	hasData: function( owner ) {
+		var cache = owner[ this.expando ];
+		return cache !== undefined && !jQuery.isEmptyObject( cache );
+	}
+};
+var dataPriv = new Data();
+
+var dataUser = new Data();
+
+
+
+//	Implementation Summary
+//
+//	1. Enforce API surface and semantic compatibility with 1.9.x branch
+//	2. Improve the module's maintainability by reducing the storage
+//		paths to a single mechanism.
+//	3. Use the same single mechanism to support "private" and "user" data.
+//	4. _Never_ expose "private" data to user code (TODO: Drop _data, _removeData)
+//	5. Avoid exposing implementation details on user objects (eg. expando properties)
+//	6. Provide a clear path for implementation upgrade to WeakMap in 2014
+
+var rbrace = /^(?:\{[\w\W]*\}|\[[\w\W]*\])$/,
+	rmultiDash = /[A-Z]/g;
+
+function getData( data ) {
+	if ( data === "true" ) {
+		return true;
+	}
+
+	if ( data === "false" ) {
+		return false;
+	}
+
+	if ( data === "null" ) {
+		return null;
+	}
+
+	// Only convert to a number if it doesn't change the string
+	if ( data === +data + "" ) {
+		return +data;
+	}
+
+	if ( rbrace.test( data ) ) {
+		return JSON.parse( data );
+	}
+
+	return data;
+}
+
+function dataAttr( elem, key, data ) {
+	var name;
+
+	// If nothing was found internally, try to fetch any
+	// data from the HTML5 data-* attribute
+	if ( data === undefined && elem.nodeType === 1 ) {
+		name = "data-" + key.replace( rmultiDash, "-$&" ).toLowerCase();
+		data = elem.getAttribute( name );
+
+		if ( typeof data === "string" ) {
+			try {
+				data = getData( data );
+			} catch ( e ) {}
+
+			// Make sure we set the data so it isn't changed later
+			dataUser.set( elem, key, data );
+		} else {
+			data = undefined;
+		}
+	}
+	return data;
+}
+
+jQuery.extend( {
+	hasData: function( elem ) {
+		return dataUser.hasData( elem ) || dataPriv.hasData( elem );
+	},
+
+	data: function( elem, name, data ) {
+		return dataUser.access( elem, name, data );
+	},
+
+	removeData: function( elem, name ) {
+		dataUser.remove( elem, name );
+	},
+
+	// TODO: Now that all calls to _data and _removeData have been replaced
+	// with direct calls to dataPriv methods, these can be deprecated.
+	_data: function( elem, name, data ) {
+		return dataPriv.access( elem, name, data );
+	},
+
+	_removeData: function( elem, name ) {
+		dataPriv.remove( elem, name );
+	}
+} );
+
+jQuery.fn.extend( {
+	data: function( key, value ) {
+		var i, name, data,
+			elem = this[ 0 ],
+			attrs = elem && elem.attributes;
+
+		// Gets all values
+		if ( key === undefined ) {
+			if ( this.length ) {
+				data = dataUser.get( elem );
+
+				if ( elem.nodeType === 1 && !dataPriv.get( elem, "hasDataAttrs" ) ) {
+					i = attrs.length;
+					while ( i-- ) {
+
+						// Support: IE 11 only
+						// The attrs elements can be null (#14894)
+						if ( attrs[ i ] ) {
+							name = attrs[ i ].name;
+							if ( name.indexOf( "data-" ) === 0 ) {
+								name = camelCase( name.slice( 5 ) );
+								dataAttr( elem, name, data[ name ] );
+							}
+						}
+					}
+					dataPriv.set( elem, "hasDataAttrs", true );
+				}
+			}
+
+			return data;
+		}
+
+		// Sets multiple values
+		if ( typeof key === "object" ) {
+			return this.each( function() {
+				dataUser.set( this, key );
+			} );
+		}
+
+		return access( this, function( value ) {
+			var data;
+
+			// The calling jQuery object (element matches) is not empty
+			// (and therefore has an element appears at this[ 0 ]) and the
+			// `value` parameter was not undefined. An empty jQuery object
+			// will result in `undefined` for elem = this[ 0 ] which will
+			// throw an exception if an attempt to read a data cache is made.
+			if ( elem && value === undefined ) {
+
+				// Attempt to get data from the cache
+				// The key will always be camelCased in Data
+				data = dataUser.get( elem, key );
+				if ( data !== undefined ) {
+					return data;
+				}
+
+				// Attempt to "discover" the data in
+				// HTML5 custom data-* attrs
+				data = dataAttr( elem, key );
+				if ( data !== undefined ) {
+					return data;
+				}
+
+				// We tried really hard, but the data doesn't exist.
+				return;
+			}
+
+			// Set the data...
+			this.each( function() {
+
+				// We always store the camelCased key
+				dataUser.set( this, key, value );
+			} );
+		}, null, value, arguments.length > 1, null, true );
+	},
+
+	removeData: function( key ) {
+		return this.each( function() {
+			dataUser.remove( this, key );
+		} );
+	}
+} );
+
+
+jQuery.extend( {
+	queue: function( elem, type, data ) {
+		var queue;
+
+		if ( elem ) {
+			type = ( type || "fx" ) + "queue";
+			queue = dataPriv.get( elem, type );
+
+			// Speed up dequeue by getting out quickly if this is just a lookup
+			if ( data ) {
+				if ( !queue || Array.isArray( data ) ) {
+					queue = dataPriv.access( elem, type, jQuery.makeArray( data ) );
+				} else {
+					queue.push( data );
+				}
+			}
+			return queue || [];
+		}
+	},
+
+	dequeue: function( elem, type ) {
+		type = type || "fx";
+
+		var queue = jQuery.queue( elem, type ),
+			startLength = queue.length,
+			fn = queue.shift(),
+			hooks = jQuery._queueHooks( elem, type ),
+			next = function() {
+				jQuery.dequeue( elem, type );
+			};
+
+		// If the fx queue is dequeued, always remove the progress sentinel
+		if ( fn === "inprogress" ) {
+			fn = queue.shift();
+			startLength--;
+		}
+
+		if ( fn ) {
+
+			// Add a progress sentinel to prevent the fx queue from being
+			// automatically dequeued
+			if ( type === "fx" ) {
+				queue.unshift( "inprogress" );
+			}
+
+			// Clear up the last queue stop function
+			delete hooks.stop;
+			fn.call( elem, next, hooks );
+		}
+
+		if ( !startLength && hooks ) {
+			hooks.empty.fire();
+		}
+	},
+
+	// Not public - generate a queueHooks object, or return the current one
+	_queueHooks: function( elem, type ) {
+		var key = type + "queueHooks";
+		return dataPriv.get( elem, key ) || dataPriv.access( elem, key, {
+			empty: jQuery.Callbacks( "once memory" ).add( function() {
+				dataPriv.remove( elem, [ type + "queue", key ] );
+			} )
+		} );
+	}
+} );
+
+jQuery.fn.extend( {
+	queue: function( type, data ) {
+		var setter = 2;
+
+		if ( typeof type !== "string" ) {
+			data = type;
+			type = "fx";
+			setter--;
+		}
+
+		if ( arguments.length < setter ) {
+			return jQuery.queue( this[ 0 ], type );
+		}
+
+		return data === undefined ?
+			this :
+			this.each( function() {
+				var queue = jQuery.queue( this, type, data );
+
+				// Ensure a hooks for this queue
+				jQuery._queueHooks( this, type );
+
+				if ( type === "fx" && queue[ 0 ] !== "inprogress" ) {
+					jQuery.dequeue( this, type );
+				}
+			} );
+	},
+	dequeue: function( type ) {
+		return this.each( function() {
+			jQuery.dequeue( this, type );
+		} );
+	},
+	clearQueue: function( type ) {
+		return this.queue( type || "fx", [] );
+	},
+
+	// Get a promise resolved when queues of a certain type
+	// are emptied (fx is the type by default)
+	promise: function( type, obj ) {
+		var tmp,
+			count = 1,
+			defer = jQuery.Deferred(),
+			elements = this,
+			i = this.length,
+			resolve = function() {
+				if ( !( --count ) ) {
+					defer.resolveWith( elements, [ elements ] );
+				}
+			};
+
+		if ( typeof type !== "string" ) {
+			obj = type;
+			type = undefined;
+		}
+		type = type || "fx";
+
+		while ( i-- ) {
+			tmp = dataPriv.get( elements[ i ], type + "queueHooks" );
+			if ( tmp && tmp.empty ) {
+				count++;
+				tmp.empty.add( resolve );
+			}
+		}
+		resolve();
+		return defer.promise( obj );
+	}
+} );
+var pnum = ( /[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/ ).source;
+
+var rcssNum = new RegExp( "^(?:([+-])=|)(" + pnum + ")([a-z%]*)$", "i" );
+
+
+var cssExpand = [ "Top", "Right", "Bottom", "Left" ];
+
+var isHiddenWithinTree = function( elem, el ) {
+
+		// isHiddenWithinTree might be called from jQuery#filter function;
+		// in that case, element will be second argument
+		elem = el || elem;
+
+		// Inline style trumps all
+		return elem.style.display === "none" ||
+			elem.style.display === "" &&
+
+			// Otherwise, check computed style
+			// Support: Firefox <=43 - 45
+			// Disconnected elements can have computed display: none, so first confirm that elem is
+			// in the document.
+			jQuery.contains( elem.ownerDocument, elem ) &&
+
+			jQuery.css( elem, "display" ) === "none";
+	};
+
+var swap = function( elem, options, callback, args ) {
+	var ret, name,
+		old = {};
+
+	// Remember the old values, and insert the new ones
+	for ( name in options ) {
+		old[ name ] = elem.style[ name ];
+		elem.style[ name ] = options[ name ];
+	}
+
+	ret = callback.apply( elem, args || [] );
+
+	// Revert the old values
+	for ( name in options ) {
+		elem.style[ name ] = old[ name ];
+	}
+
+	return ret;
+};
+
+
+
+
+function adjustCSS( elem, prop, valueParts, tween ) {
+	var adjusted, scale,
+		maxIterations = 20,
+		currentValue = tween ?
+			function() {
+				return tween.cur();
+			} :
+			function() {
+				return jQuery.css( elem, prop, "" );
+			},
+		initial = currentValue(),
+		unit = valueParts && valueParts[ 3 ] || ( jQuery.cssNumber[ prop ] ? "" : "px" ),
+
+		// Starting value computation is required for potential unit mismatches
+		initialInUnit = ( jQuery.cssNumber[ prop ] || unit !== "px" && +initial ) &&
+			rcssNum.exec( jQuery.css( elem, prop ) );
+
+	if ( initialInUnit && initialInUnit[ 3 ] !== unit ) {
+
+		// Support: Firefox <=54
+		// Halve the iteration target value to prevent interference from CSS upper bounds (gh-2144)
+		initial = initial / 2;
+
+		// Trust units reported by jQuery.css
+		unit = unit || initialInUnit[ 3 ];
+
+		// Iteratively approximate from a nonzero starting point
+		initialInUnit = +initial || 1;
+
+		while ( maxIterations-- ) {
+
+			// Evaluate and update our best guess (doubling guesses that zero out).
+			// Finish if the scale equals or crosses 1 (making the old*new product non-positive).
+			jQuery.style( elem, prop, initialInUnit + unit );
+			if ( ( 1 - scale ) * ( 1 - ( scale = currentValue() / initial || 0.5 ) ) <= 0 ) {
+				maxIterations = 0;
+			}
+			initialInUnit = initialInUnit / scale;
+
+		}
+
+		initialInUnit = initialInUnit * 2;
+		jQuery.style( elem, prop, initialInUnit + unit );
+
+		// Make sure we update the tween properties later on
+		valueParts = valueParts || [];
+	}
+
+	if ( valueParts ) {
+		initialInUnit = +initialInUnit || +initial || 0;
+
+		// Apply relative offset (+=/-=) if specified
+		adjusted = valueParts[ 1 ] ?
+			initialInUnit + ( valueParts[ 1 ] + 1 ) * valueParts[ 2 ] :
+			+valueParts[ 2 ];
+		if ( tween ) {
+			tween.unit = unit;
+			tween.start = initialInUnit;
+			tween.end = adjusted;
+		}
+	}
+	return adjusted;
+}
+
+
+var defaultDisplayMap = {};
+
+function getDefaultDisplay( elem ) {
+	var temp,
+		doc = elem.ownerDocument,
+		nodeName = elem.nodeName,
+		display = defaultDisplayMap[ nodeName ];
+
+	if ( display ) {
+		return display;
+	}
+
+	temp = doc.body.appendChild( doc.createElement( nodeName ) );
+	display = jQuery.css( temp, "display" );
+
+	temp.parentNode.removeChild( temp );
+
+	if ( display === "none" ) {
+		display = "block";
+	}
+	defaultDisplayMap[ nodeName ] = display;
+
+	return display;
+}
+
+function showHide( elements, show ) {
+	var display, elem,
+		values = [],
+		index = 0,
+		length = elements.length;
+
+	// Determine new display value for elements that need to change
+	for ( ; index < length; index++ ) {
+		elem = elements[ index ];
+		if ( !elem.style ) {
+			continue;
+		}
+
+		display = elem.style.display;
+		if ( show ) {
+
+			// Since we force visibility upon cascade-hidden elements, an immediate (and slow)
+			// check is required in this first loop unless we have a nonempty display value (either
+			// inline or about-to-be-restored)
+			if ( display === "none" ) {
+				values[ index ] = dataPriv.get( elem, "display" ) || null;
+				if ( !values[ index ] ) {
+					elem.style.display = "";
+				}
+			}
+			if ( elem.style.display === "" && isHiddenWithinTree( elem ) ) {
+				values[ index ] = getDefaultDisplay( elem );
+			}
+		} else {
+			if ( display !== "none" ) {
+				values[ index ] = "none";
+
+				// Remember what we're overwriting
+				dataPriv.set( elem, "display", display );
+			}
+		}
+	}
+
+	// Set the display of the elements in a second loop to avoid constant reflow
+	for ( index = 0; index < length; index++ ) {
+		if ( values[ index ] != null ) {
+			elements[ index ].style.display = values[ index ];
+		}
+	}
+
+	return elements;
+}
+
+jQuery.fn.extend( {
+	show: function() {
+		return showHide( this, true );
+	},
+	hide: function() {
+		return showHide( this );
+	},
+	toggle: function( state ) {
+		if ( typeof state === "boolean" ) {
+			return state ? this.show() : this.hide();
+		}
+
+		return this.each( function() {
+			if ( isHiddenWithinTree( this ) ) {
+				jQuery( this ).show();
+			} else {
+				jQuery( this ).hide();
+			}
+		} );
+	}
+} );
+var rcheckableType = ( /^(?:checkbox|radio)$/i );
+
+var rtagName = ( /<([a-z][^\/\0>\x20\t\r\n\f]+)/i );
+
+var rscriptType = ( /^$|^module$|\/(?:java|ecma)script/i );
+
+
+
+// We have to close these tags to support XHTML (#13200)
+var wrapMap = {
+
+	// Support: IE <=9 only
+	option: [ 1, "<select multiple='multiple'>", "</select>" ],
+
+	// XHTML parsers do not magically insert elements in the
+	// same way that tag soup parsers do. So we cannot shorten
+	// this by omitting <tbody> or other required elements.
+	thead: [ 1, "<table>", "</table>" ],
+	col: [ 2, "<table><colgroup>", "</colgroup></table>" ],
+	tr: [ 2, "<table><tbody>", "</tbody></table>" ],
+	td: [ 3, "<table><tbody><tr>", "</tr></tbody></table>" ],
+
+	_default: [ 0, "", "" ]
+};
+
+// Support: IE <=9 only
+wrapMap.optgroup = wrapMap.option;
+
+wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead;
+wrapMap.th = wrapMap.td;
+
+
+function getAll( context, tag ) {
+
+	// Support: IE <=9 - 11 only
+	// Use typeof to avoid zero-argument method invocation on host objects (#15151)
+	var ret;
+
+	if ( typeof context.getElementsByTagName !== "undefined" ) {
+		ret = context.getElementsByTagName( tag || "*" );
+
+	} else if ( typeof context.querySelectorAll !== "undefined" ) {
+		ret = context.querySelectorAll( tag || "*" );
+
+	} else {
+		ret = [];
+	}
+
+	if ( tag === undefined || tag && nodeName( context, tag ) ) {
+		return jQuery.merge( [ context ], ret );
+	}
+
+	return ret;
+}
+
+
+// Mark scripts as having already been evaluated
+function setGlobalEval( elems, refElements ) {
+	var i = 0,
+		l = elems.length;
+
+	for ( ; i < l; i++ ) {
+		dataPriv.set(
+			elems[ i ],
+			"globalEval",
+			!refElements || dataPriv.get( refElements[ i ], "globalEval" )
+		);
+	}
+}
+
+
+var rhtml = /<|&#?\w+;/;
+
+function buildFragment( elems, context, scripts, selection, ignored ) {
+	var elem, tmp, tag, wrap, contains, j,
+		fragment = context.createDocumentFragment(),
+		nodes = [],
+		i = 0,
+		l = elems.length;
+
+	for ( ; i < l; i++ ) {
+		elem = elems[ i ];
+
+		if ( elem || elem === 0 ) {
+
+			// Add nodes directly
+			if ( toType( elem ) === "object" ) {
+
+				// Support: Android <=4.0 only, PhantomJS 1 only
+				// push.apply(_, arraylike) throws on ancient WebKit
+				jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem );
+
+			// Convert non-html into a text node
+			} else if ( !rhtml.test( elem ) ) {
+				nodes.push( context.createTextNode( elem ) );
+
+			// Convert html into DOM nodes
+			} else {
+				tmp = tmp || fragment.appendChild( context.createElement( "div" ) );
+
+				// Deserialize a standard representation
+				tag = ( rtagName.exec( elem ) || [ "", "" ] )[ 1 ].toLowerCase();
+				wrap = wrapMap[ tag ] || wrapMap._default;
+				tmp.innerHTML = wrap[ 1 ] + jQuery.htmlPrefilter( elem ) + wrap[ 2 ];
+
+				// Descend through wrappers to the right content
+				j = wrap[ 0 ];
+				while ( j-- ) {
+					tmp = tmp.lastChild;
+				}
+
+				// Support: Android <=4.0 only, PhantomJS 1 only
+				// push.apply(_, arraylike) throws on ancient WebKit
+				jQuery.merge( nodes, tmp.childNodes );
+
+				// Remember the top-level container
+				tmp = fragment.firstChild;
+
+				// Ensure the created nodes are orphaned (#12392)
+				tmp.textContent = "";
+			}
+		}
+	}
+
+	// Remove wrapper from fragment
+	fragment.textContent = "";
+
+	i = 0;
+	while ( ( elem = nodes[ i++ ] ) ) {
+
+		// Skip elements already in the context collection (trac-4087)
+		if ( selection && jQuery.inArray( elem, selection ) > -1 ) {
+			if ( ignored ) {
+				ignored.push( elem );
+			}
+			continue;
+		}
+
+		contains = jQuery.contains( elem.ownerDocument, elem );
+
+		// Append to fragment
+		tmp = getAll( fragment.appendChild( elem ), "script" );
+
+		// Preserve script evaluation history
+		if ( contains ) {
+			setGlobalEval( tmp );
+		}
+
+		// Capture executables
+		if ( scripts ) {
+			j = 0;
+			while ( ( elem = tmp[ j++ ] ) ) {
+				if ( rscriptType.test( elem.type || "" ) ) {
+					scripts.push( elem );
+				}
+			}
+		}
+	}
+
+	return fragment;
+}
+
+
+( function() {
+	var fragment = document.createDocumentFragment(),
+		div = fragment.appendChild( document.createElement( "div" ) ),
+		input = document.createElement( "input" );
+
+	// Support: Android 4.0 - 4.3 only
+	// Check state lost if the name is set (#11217)
+	// Support: Windows Web Apps (WWA)
+	// `name` and `type` must use .setAttribute for WWA (#14901)
+	input.setAttribute( "type", "radio" );
+	input.setAttribute( "checked", "checked" );
+	input.setAttribute( "name", "t" );
+
+	div.appendChild( input );
+
+	// Support: Android <=4.1 only
+	// Older WebKit doesn't clone checked state correctly in fragments
+	support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked;
+
+	// Support: IE <=11 only
+	// Make sure textarea (and checkbox) defaultValue is properly cloned
+	div.innerHTML = "<textarea>x</textarea>";
+	support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue;
+} )();
+var documentElement = document.documentElement;
+
+
+
+var
+	rkeyEvent = /^key/,
+	rmouseEvent = /^(?:mouse|pointer|contextmenu|drag|drop)|click/,
+	rtypenamespace = /^([^.]*)(?:\.(.+)|)/;
+
+function returnTrue() {
+	return true;
+}
+
+function returnFalse() {
+	return false;
+}
+
+// Support: IE <=9 only
+// See #13393 for more info
+function safeActiveElement() {
+	try {
+		return document.activeElement;
+	} catch ( err ) { }
+}
+
+function on( elem, types, selector, data, fn, one ) {
+	var origFn, type;
+
+	// Types can be a map of types/handlers
+	if ( typeof types === "object" ) {
+
+		// ( types-Object, selector, data )
+		if ( typeof selector !== "string" ) {
+
+			// ( types-Object, data )
+			data = data || selector;
+			selector = undefined;
+		}
+		for ( type in types ) {
+			on( elem, type, selector, data, types[ type ], one );
+		}
+		return elem;
+	}
+
+	if ( data == null && fn == null ) {
+
+		// ( types, fn )
+		fn = selector;
+		data = selector = undefined;
+	} else if ( fn == null ) {
+		if ( typeof selector === "string" ) {
+
+			// ( types, selector, fn )
+			fn = data;
+			data = undefined;
+		} else {
+
+			// ( types, data, fn )
+			fn = data;
+			data = selector;
+			selector = undefined;
+		}
+	}
+	if ( fn === false ) {
+		fn = returnFalse;
+	} else if ( !fn ) {
+		return elem;
+	}
+
+	if ( one === 1 ) {
+		origFn = fn;
+		fn = function( event ) {
+
+			// Can use an empty set, since event contains the info
+			jQuery().off( event );
+			return origFn.apply( this, arguments );
+		};
+
+		// Use same guid so caller can remove using origFn
+		fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ );
+	}
+	return elem.each( function() {
+		jQuery.event.add( this, types, fn, data, selector );
+	} );
+}
+
+/*
+ * Helper functions for managing events -- not part of the public interface.
+ * Props to Dean Edwards' addEvent library for many of the ideas.
+ */
+jQuery.event = {
+
+	global: {},
+
+	add: function( elem, types, handler, data, selector ) {
+
+		var handleObjIn, eventHandle, tmp,
+			events, t, handleObj,
+			special, handlers, type, namespaces, origType,
+			elemData = dataPriv.get( elem );
+
+		// Don't attach events to noData or text/comment nodes (but allow plain objects)
+		if ( !elemData ) {
+			return;
+		}
+
+		// Caller can pass in an object of custom data in lieu of the handler
+		if ( handler.handler ) {
+			handleObjIn = handler;
+			handler = handleObjIn.handler;
+			selector = handleObjIn.selector;
+		}
+
+		// Ensure that invalid selectors throw exceptions at attach time
+		// Evaluate against documentElement in case elem is a non-element node (e.g., document)
+		if ( selector ) {
+			jQuery.find.matchesSelector( documentElement, selector );
+		}
+
+		// Make sure that the handler has a unique ID, used to find/remove it later
+		if ( !handler.guid ) {
+			handler.guid = jQuery.guid++;
+		}
+
+		// Init the element's event structure and main handler, if this is the first
+		if ( !( events = elemData.events ) ) {
+			events = elemData.events = {};
+		}
+		if ( !( eventHandle = elemData.handle ) ) {
+			eventHandle = elemData.handle = function( e ) {
+
+				// Discard the second event of a jQuery.event.trigger() and
+				// when an event is called after a page has unloaded
+				return typeof jQuery !== "undefined" && jQuery.event.triggered !== e.type ?
+					jQuery.event.dispatch.apply( elem, arguments ) : undefined;
+			};
+		}
+
+		// Handle multiple events separated by a space
+		types = ( types || "" ).match( rnothtmlwhite ) || [ "" ];
+		t = types.length;
+		while ( t-- ) {
+			tmp = rtypenamespace.exec( types[ t ] ) || [];
+			type = origType = tmp[ 1 ];
+			namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort();
+
+			// There *must* be a type, no attaching namespace-only handlers
+			if ( !type ) {
+				continue;
+			}
+
+			// If event changes its type, use the special event handlers for the changed type
+			special = jQuery.event.special[ type ] || {};
+
+			// If selector defined, determine special event api type, otherwise given type
+			type = ( selector ? special.delegateType : special.bindType ) || type;
+
+			// Update special based on newly reset type
+			special = jQuery.event.special[ type ] || {};
+
+			// handleObj is passed to all event handlers
+			handleObj = jQuery.extend( {
+				type: type,
+				origType: origType,
+				data: data,
+				handler: handler,
+				guid: handler.guid,
+				selector: selector,
+				needsContext: selector && jQuery.expr.match.needsContext.test( selector ),
+				namespace: namespaces.join( "." )
+			}, handleObjIn );
+
+			// Init the event handler queue if we're the first
+			if ( !( handlers = events[ type ] ) ) {
+				handlers = events[ type ] = [];
+				handlers.delegateCount = 0;
+
+				// Only use addEventListener if the special events handler returns false
+				if ( !special.setup ||
+					special.setup.call( elem, data, namespaces, eventHandle ) === false ) {
+
+					if ( elem.addEventListener ) {
+						elem.addEventListener( type, eventHandle );
+					}
+				}
+			}
+
+			if ( special.add ) {
+				special.add.call( elem, handleObj );
+
+				if ( !handleObj.handler.guid ) {
+					handleObj.handler.guid = handler.guid;
+				}
+			}
+
+			// Add to the element's handler list, delegates in front
+			if ( selector ) {
+				handlers.splice( handlers.delegateCount++, 0, handleObj );
+			} else {
+				handlers.push( handleObj );
+			}
+
+			// Keep track of which events have ever been used, for event optimization
+			jQuery.event.global[ type ] = true;
+		}
+
+	},
+
+	// Detach an event or set of events from an element
+	remove: function( elem, types, handler, selector, mappedTypes ) {
+
+		var j, origCount, tmp,
+			events, t, handleObj,
+			special, handlers, type, namespaces, origType,
+			elemData = dataPriv.hasData( elem ) && dataPriv.get( elem );
+
+		if ( !elemData || !( events = elemData.events ) ) {
+			return;
+		}
+
+		// Once for each type.namespace in types; type may be omitted
+		types = ( types || "" ).match( rnothtmlwhite ) || [ "" ];
+		t = types.length;
+		while ( t-- ) {
+			tmp = rtypenamespace.exec( types[ t ] ) || [];
+			type = origType = tmp[ 1 ];
+			namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort();
+
+			// Unbind all events (on this namespace, if provided) for the element
+			if ( !type ) {
+				for ( type in events ) {
+					jQuery.event.remove( elem, type + types[ t ], handler, selector, true );
+				}
+				continue;
+			}
+
+			special = jQuery.event.special[ type ] || {};
+			type = ( selector ? special.delegateType : special.bindType ) || type;
+			handlers = events[ type ] || [];
+			tmp = tmp[ 2 ] &&
+				new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" );
+
+			// Remove matching events
+			origCount = j = handlers.length;
+			while ( j-- ) {
+				handleObj = handlers[ j ];
+
+				if ( ( mappedTypes || origType === handleObj.origType ) &&
+					( !handler || handler.guid === handleObj.guid ) &&
+					( !tmp || tmp.test( handleObj.namespace ) ) &&
+					( !selector || selector === handleObj.selector ||
+						selector === "**" && handleObj.selector ) ) {
+					handlers.splice( j, 1 );
+
+					if ( handleObj.selector ) {
+						handlers.delegateCount--;
+					}
+					if ( special.remove ) {
+						special.remove.call( elem, handleObj );
+					}
+				}
+			}
+
+			// Remove generic event handler if we removed something and no more handlers exist
+			// (avoids potential for endless recursion during removal of special event handlers)
+			if ( origCount && !handlers.length ) {
+				if ( !special.teardown ||
+					special.teardown.call( elem, namespaces, elemData.handle ) === false ) {
+
+					jQuery.removeEvent( elem, type, elemData.handle );
+				}
+
+				delete events[ type ];
+			}
+		}
+
+		// Remove data and the expando if it's no longer used
+		if ( jQuery.isEmptyObject( events ) ) {
+			dataPriv.remove( elem, "handle events" );
+		}
+	},
+
+	dispatch: function( nativeEvent ) {
+
+		// Make a writable jQuery.Event from the native event object
+		var event = jQuery.event.fix( nativeEvent );
+
+		var i, j, ret, matched, handleObj, handlerQueue,
+			args = new Array( arguments.length ),
+			handlers = ( dataPriv.get( this, "events" ) || {} )[ event.type ] || [],
+			special = jQuery.event.special[ event.type ] || {};
+
+		// Use the fix-ed jQuery.Event rather than the (read-only) native event
+		args[ 0 ] = event;
+
+		for ( i = 1; i < arguments.length; i++ ) {
+			args[ i ] = arguments[ i ];
+		}
+
+		event.delegateTarget = this;
+
+		// Call the preDispatch hook for the mapped type, and let it bail if desired
+		if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) {
+			return;
+		}
+
+		// Determine handlers
+		handlerQueue = jQuery.event.handlers.call( this, event, handlers );
+
+		// Run delegates first; they may want to stop propagation beneath us
+		i = 0;
+		while ( ( matched = handlerQueue[ i++ ] ) && !event.isPropagationStopped() ) {
+			event.currentTarget = matched.elem;
+
+			j = 0;
+			while ( ( handleObj = matched.handlers[ j++ ] ) &&
+				!event.isImmediatePropagationStopped() ) {
+
+				// Triggered event must either 1) have no namespace, or 2) have namespace(s)
+				// a subset or equal to those in the bound event (both can have no namespace).
+				if ( !event.rnamespace || event.rnamespace.test( handleObj.namespace ) ) {
+
+					event.handleObj = handleObj;
+					event.data = handleObj.data;
+
+					ret = ( ( jQuery.event.special[ handleObj.origType ] || {} ).handle ||
+						handleObj.handler ).apply( matched.elem, args );
+
+					if ( ret !== undefined ) {
+						if ( ( event.result = ret ) === false ) {
+							event.preventDefault();
+							event.stopPropagation();
+						}
+					}
+				}
+			}
+		}
+
+		// Call the postDispatch hook for the mapped type
+		if ( special.postDispatch ) {
+			special.postDispatch.call( this, event );
+		}
+
+		return event.result;
+	},
+
+	handlers: function( event, handlers ) {
+		var i, handleObj, sel, matchedHandlers, matchedSelectors,
+			handlerQueue = [],
+			delegateCount = handlers.delegateCount,
+			cur = event.target;
+
+		// Find delegate handlers
+		if ( delegateCount &&
+
+			// Support: IE <=9
+			// Black-hole SVG <use> instance trees (trac-13180)
+			cur.nodeType &&
+
+			// Support: Firefox <=42
+			// Suppress spec-violating clicks indicating a non-primary pointer button (trac-3861)
+			// https://www.w3.org/TR/DOM-Level-3-Events/#event-type-click
+			// Support: IE 11 only
+			// ...but not arrow key "clicks" of radio inputs, which can have `button` -1 (gh-2343)
+			!( event.type === "click" && event.button >= 1 ) ) {
+
+			for ( ; cur !== this; cur = cur.parentNode || this ) {
+
+				// Don't check non-elements (#13208)
+				// Don't process clicks on disabled elements (#6911, #8165, #11382, #11764)
+				if ( cur.nodeType === 1 && !( event.type === "click" && cur.disabled === true ) ) {
+					matchedHandlers = [];
+					matchedSelectors = {};
+					for ( i = 0; i < delegateCount; i++ ) {
+						handleObj = handlers[ i ];
+
+						// Don't conflict with Object.prototype properties (#13203)
+						sel = handleObj.selector + " ";
+
+						if ( matchedSelectors[ sel ] === undefined ) {
+							matchedSelectors[ sel ] = handleObj.needsContext ?
+								jQuery( sel, this ).index( cur ) > -1 :
+								jQuery.find( sel, this, null, [ cur ] ).length;
+						}
+						if ( matchedSelectors[ sel ] ) {
+							matchedHandlers.push( handleObj );
+						}
+					}
+					if ( matchedHandlers.length ) {
+						handlerQueue.push( { elem: cur, handlers: matchedHandlers } );
+					}
+				}
+			}
+		}
+
+		// Add the remaining (directly-bound) handlers
+		cur = this;
+		if ( delegateCount < handlers.length ) {
+			handlerQueue.push( { elem: cur, handlers: handlers.slice( delegateCount ) } );
+		}
+
+		return handlerQueue;
+	},
+
+	addProp: function( name, hook ) {
+		Object.defineProperty( jQuery.Event.prototype, name, {
+			enumerable: true,
+			configurable: true,
+
+			get: isFunction( hook ) ?
+				function() {
+					if ( this.originalEvent ) {
+							return hook( this.originalEvent );
+					}
+				} :
+				function() {
+					if ( this.originalEvent ) {
+							return this.originalEvent[ name ];
+					}
+				},
+
+			set: function( value ) {
+				Object.defineProperty( this, name, {
+					enumerable: true,
+					configurable: true,
+					writable: true,
+					value: value
+				} );
+			}
+		} );
+	},
+
+	fix: function( originalEvent ) {
+		return originalEvent[ jQuery.expando ] ?
+			originalEvent :
+			new jQuery.Event( originalEvent );
+	},
+
+	special: {
+		load: {
+
+			// Prevent triggered image.load events from bubbling to window.load
+			noBubble: true
+		},
+		focus: {
+
+			// Fire native event if possible so blur/focus sequence is correct
+			trigger: function() {
+				if ( this !== safeActiveElement() && this.focus ) {
+					this.focus();
+					return false;
+				}
+			},
+			delegateType: "focusin"
+		},
+		blur: {
+			trigger: function() {
+				if ( this === safeActiveElement() && this.blur ) {
+					this.blur();
+					return false;
+				}
+			},
+			delegateType: "focusout"
+		},
+		click: {
+
+			// For checkbox, fire native event so checked state will be right
+			trigger: function() {
+				if ( this.type === "checkbox" && this.click && nodeName( this, "input" ) ) {
+					this.click();
+					return false;
+				}
+			},
+
+			// For cross-browser consistency, don't fire native .click() on links
+			_default: function( event ) {
+				return nodeName( event.target, "a" );
+			}
+		},
+
+		beforeunload: {
+			postDispatch: function( event ) {
+
+				// Support: Firefox 20+
+				// Firefox doesn't alert if the returnValue field is not set.
+				if ( event.result !== undefined && event.originalEvent ) {
+					event.originalEvent.returnValue = event.result;
+				}
+			}
+		}
+	}
+};
+
+jQuery.removeEvent = function( elem, type, handle ) {
+
+	// This "if" is needed for plain objects
+	if ( elem.removeEventListener ) {
+		elem.removeEventListener( type, handle );
+	}
+};
+
+jQuery.Event = function( src, props ) {
+
+	// Allow instantiation without the 'new' keyword
+	if ( !( this instanceof jQuery.Event ) ) {
+		return new jQuery.Event( src, props );
+	}
+
+	// Event object
+	if ( src && src.type ) {
+		this.originalEvent = src;
+		this.type = src.type;
+
+		// Events bubbling up the document may have been marked as prevented
+		// by a handler lower down the tree; reflect the correct value.
+		this.isDefaultPrevented = src.defaultPrevented ||
+				src.defaultPrevented === undefined &&
+
+				// Support: Android <=2.3 only
+				src.returnValue === false ?
+			returnTrue :
+			returnFalse;
+
+		// Create target properties
+		// Support: Safari <=6 - 7 only
+		// Target should not be a text node (#504, #13143)
+		this.target = ( src.target && src.target.nodeType === 3 ) ?
+			src.target.parentNode :
+			src.target;
+
+		this.currentTarget = src.currentTarget;
+		this.relatedTarget = src.relatedTarget;
+
+	// Event type
+	} else {
+		this.type = src;
+	}
+
+	// Put explicitly provided properties onto the event object
+	if ( props ) {
+		jQuery.extend( this, props );
+	}
+
+	// Create a timestamp if incoming event doesn't have one
+	this.timeStamp = src && src.timeStamp || Date.now();
+
+	// Mark it as fixed
+	this[ jQuery.expando ] = true;
+};
+
+// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding
+// https://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html
+jQuery.Event.prototype = {
+	constructor: jQuery.Event,
+	isDefaultPrevented: returnFalse,
+	isPropagationStopped: returnFalse,
+	isImmediatePropagationStopped: returnFalse,
+	isSimulated: false,
+
+	preventDefault: function() {
+		var e = this.originalEvent;
+
+		this.isDefaultPrevented = returnTrue;
+
+		if ( e && !this.isSimulated ) {
+			e.preventDefault();
+		}
+	},
+	stopPropagation: function() {
+		var e = this.originalEvent;
+
+		this.isPropagationStopped = returnTrue;
+
+		if ( e && !this.isSimulated ) {
+			e.stopPropagation();
+		}
+	},
+	stopImmediatePropagation: function() {
+		var e = this.originalEvent;
+
+		this.isImmediatePropagationStopped = returnTrue;
+
+		if ( e && !this.isSimulated ) {
+			e.stopImmediatePropagation();
+		}
+
+		this.stopPropagation();
+	}
+};
+
+// Includes all common event props including KeyEvent and MouseEvent specific props
+jQuery.each( {
+	altKey: true,
+	bubbles: true,
+	cancelable: true,
+	changedTouches: true,
+	ctrlKey: true,
+	detail: true,
+	eventPhase: true,
+	metaKey: true,
+	pageX: true,
+	pageY: true,
+	shiftKey: true,
+	view: true,
+	"char": true,
+	charCode: true,
+	key: true,
+	keyCode: true,
+	button: true,
+	buttons: true,
+	clientX: true,
+	clientY: true,
+	offsetX: true,
+	offsetY: true,
+	pointerId: true,
+	pointerType: true,
+	screenX: true,
+	screenY: true,
+	targetTouches: true,
+	toElement: true,
+	touches: true,
+
+	which: function( event ) {
+		var button = event.button;
+
+		// Add which for key events
+		if ( event.which == null && rkeyEvent.test( event.type ) ) {
+			return event.charCode != null ? event.charCode : event.keyCode;
+		}
+
+		// Add which for click: 1 === left; 2 === middle; 3 === right
+		if ( !event.which && button !== undefined && rmouseEvent.test( event.type ) ) {
+			if ( button & 1 ) {
+				return 1;
+			}
+
+			if ( button & 2 ) {
+				return 3;
+			}
+
+			if ( button & 4 ) {
+				return 2;
+			}
+
+			return 0;
+		}
+
+		return event.which;
+	}
+}, jQuery.event.addProp );
+
+// Create mouseenter/leave events using mouseover/out and event-time checks
+// so that event delegation works in jQuery.
+// Do the same for pointerenter/pointerleave and pointerover/pointerout
+//
+// Support: Safari 7 only
+// Safari sends mouseenter too often; see:
+// https://bugs.chromium.org/p/chromium/issues/detail?id=470258
+// for the description of the bug (it existed in older Chrome versions as well).
+jQuery.each( {
+	mouseenter: "mouseover",
+	mouseleave: "mouseout",
+	pointerenter: "pointerover",
+	pointerleave: "pointerout"
+}, function( orig, fix ) {
+	jQuery.event.special[ orig ] = {
+		delegateType: fix,
+		bindType: fix,
+
+		handle: function( event ) {
+			var ret,
+				target = this,
+				related = event.relatedTarget,
+				handleObj = event.handleObj;
+
+			// For mouseenter/leave call the handler if related is outside the target.
+			// NB: No relatedTarget if the mouse left/entered the browser window
+			if ( !related || ( related !== target && !jQuery.contains( target, related ) ) ) {
+				event.type = handleObj.origType;
+				ret = handleObj.handler.apply( this, arguments );
+				event.type = fix;
+			}
+			return ret;
+		}
+	};
+} );
+
+jQuery.fn.extend( {
+
+	on: function( types, selector, data, fn ) {
+		return on( this, types, selector, data, fn );
+	},
+	one: function( types, selector, data, fn ) {
+		return on( this, types, selector, data, fn, 1 );
+	},
+	off: function( types, selector, fn ) {
+		var handleObj, type;
+		if ( types && types.preventDefault && types.handleObj ) {
+
+			// ( event )  dispatched jQuery.Event
+			handleObj = types.handleObj;
+			jQuery( types.delegateTarget ).off(
+				handleObj.namespace ?
+					handleObj.origType + "." + handleObj.namespace :
+					handleObj.origType,
+				handleObj.selector,
+				handleObj.handler
+			);
+			return this;
+		}
+		if ( typeof types === "object" ) {
+
+			// ( types-object [, selector] )
+			for ( type in types ) {
+				this.off( type, selector, types[ type ] );
+			}
+			return this;
+		}
+		if ( selector === false || typeof selector === "function" ) {
+
+			// ( types [, fn] )
+			fn = selector;
+			selector = undefined;
+		}
+		if ( fn === false ) {
+			fn = returnFalse;
+		}
+		return this.each( function() {
+			jQuery.event.remove( this, types, fn, selector );
+		} );
+	}
+} );
+
+
+var
+
+	/* eslint-disable max-len */
+
+	// See https://github.com/eslint/eslint/issues/3229
+	rxhtmlTag = /<(?!area|br|col|embed|hr|img|input|link|meta|param)(([a-z][^\/\0>\x20\t\r\n\f]*)[^>]*)\/>/gi,
+
+	/* eslint-enable */
+
+	// Support: IE <=10 - 11, Edge 12 - 13 only
+	// In IE/Edge using regex groups here causes severe slowdowns.
+	// See https://connect.microsoft.com/IE/feedback/details/1736512/
+	rnoInnerhtml = /<script|<style|<link/i,
+
+	// checked="checked" or checked
+	rchecked = /checked\s*(?:[^=]|=\s*.checked.)/i,
+	rcleanScript = /^\s*<!(?:\[CDATA\[|--)|(?:\]\]|--)>\s*$/g;
+
+// Prefer a tbody over its parent table for containing new rows
+function manipulationTarget( elem, content ) {
+	if ( nodeName( elem, "table" ) &&
+		nodeName( content.nodeType !== 11 ? content : content.firstChild, "tr" ) ) {
+
+		return jQuery( elem ).children( "tbody" )[ 0 ] || elem;
+	}
+
+	return elem;
+}
+
+// Replace/restore the type attribute of script elements for safe DOM manipulation
+function disableScript( elem ) {
+	elem.type = ( elem.getAttribute( "type" ) !== null ) + "/" + elem.type;
+	return elem;
+}
+function restoreScript( elem ) {
+	if ( ( elem.type || "" ).slice( 0, 5 ) === "true/" ) {
+		elem.type = elem.type.slice( 5 );
+	} else {
+		elem.removeAttribute( "type" );
+	}
+
+	return elem;
+}
+
+function cloneCopyEvent( src, dest ) {
+	var i, l, type, pdataOld, pdataCur, udataOld, udataCur, events;
+
+	if ( dest.nodeType !== 1 ) {
+		return;
+	}
+
+	// 1. Copy private data: events, handlers, etc.
+	if ( dataPriv.hasData( src ) ) {
+		pdataOld = dataPriv.access( src );
+		pdataCur = dataPriv.set( dest, pdataOld );
+		events = pdataOld.events;
+
+		if ( events ) {
+			delete pdataCur.handle;
+			pdataCur.events = {};
+
+			for ( type in events ) {
+				for ( i = 0, l = events[ type ].length; i < l; i++ ) {
+					jQuery.event.add( dest, type, events[ type ][ i ] );
+				}
+			}
+		}
+	}
+
+	// 2. Copy user data
+	if ( dataUser.hasData( src ) ) {
+		udataOld = dataUser.access( src );
+		udataCur = jQuery.extend( {}, udataOld );
+
+		dataUser.set( dest, udataCur );
+	}
+}
+
+// Fix IE bugs, see support tests
+function fixInput( src, dest ) {
+	var nodeName = dest.nodeName.toLowerCase();
+
+	// Fails to persist the checked state of a cloned checkbox or radio button.
+	if ( nodeName === "input" && rcheckableType.test( src.type ) ) {
+		dest.checked = src.checked;
+
+	// Fails to return the selected option to the default selected state when cloning options
+	} else if ( nodeName === "input" || nodeName === "textarea" ) {
+		dest.defaultValue = src.defaultValue;
+	}
+}
+
+function domManip( collection, args, callback, ignored ) {
+
+	// Flatten any nested arrays
+	args = concat.apply( [], args );
+
+	var fragment, first, scripts, hasScripts, node, doc,
+		i = 0,
+		l = collection.length,
+		iNoClone = l - 1,
+		value = args[ 0 ],
+		valueIsFunction = isFunction( value );
+
+	// We can't cloneNode fragments that contain checked, in WebKit
+	if ( valueIsFunction ||
+			( l > 1 && typeof value === "string" &&
+				!support.checkClone && rchecked.test( value ) ) ) {
+		return collection.each( function( index ) {
+			var self = collection.eq( index );
+			if ( valueIsFunction ) {
+				args[ 0 ] = value.call( this, index, self.html() );
+			}
+			domManip( self, args, callback, ignored );
+		} );
+	}
+
+	if ( l ) {
+		fragment = buildFragment( args, collection[ 0 ].ownerDocument, false, collection, ignored );
+		first = fragment.firstChild;
+
+		if ( fragment.childNodes.length === 1 ) {
+			fragment = first;
+		}
+
+		// Require either new content or an interest in ignored elements to invoke the callback
+		if ( first || ignored ) {
+			scripts = jQuery.map( getAll( fragment, "script" ), disableScript );
+			hasScripts = scripts.length;
+
+			// Use the original fragment for the last item
+			// instead of the first because it can end up
+			// being emptied incorrectly in certain situations (#8070).
+			for ( ; i < l; i++ ) {
+				node = fragment;
+
+				if ( i !== iNoClone ) {
+					node = jQuery.clone( node, true, true );
+
+					// Keep references to cloned scripts for later restoration
+					if ( hasScripts ) {
+
+						// Support: Android <=4.0 only, PhantomJS 1 only
+						// push.apply(_, arraylike) throws on ancient WebKit
+						jQuery.merge( scripts, getAll( node, "script" ) );
+					}
+				}
+
+				callback.call( collection[ i ], node, i );
+			}
+
+			if ( hasScripts ) {
+				doc = scripts[ scripts.length - 1 ].ownerDocument;
+
+				// Reenable scripts
+				jQuery.map( scripts, restoreScript );
+
+				// Evaluate executable scripts on first document insertion
+				for ( i = 0; i < hasScripts; i++ ) {
+					node = scripts[ i ];
+					if ( rscriptType.test( node.type || "" ) &&
+						!dataPriv.access( node, "globalEval" ) &&
+						jQuery.contains( doc, node ) ) {
+
+						if ( node.src && ( node.type || "" ).toLowerCase()  !== "module" ) {
+
+							// Optional AJAX dependency, but won't run scripts if not present
+							if ( jQuery._evalUrl ) {
+								jQuery._evalUrl( node.src );
+							}
+						} else {
+							DOMEval( node.textContent.replace( rcleanScript, "" ), doc, node );
+						}
+					}
+				}
+			}
+		}
+	}
+
+	return collection;
+}
+
+function remove( elem, selector, keepData ) {
+	var node,
+		nodes = selector ? jQuery.filter( selector, elem ) : elem,
+		i = 0;
+
+	for ( ; ( node = nodes[ i ] ) != null; i++ ) {
+		if ( !keepData && node.nodeType === 1 ) {
+			jQuery.cleanData( getAll( node ) );
+		}
+
+		if ( node.parentNode ) {
+			if ( keepData && jQuery.contains( node.ownerDocument, node ) ) {
+				setGlobalEval( getAll( node, "script" ) );
+			}
+			node.parentNode.removeChild( node );
+		}
+	}
+
+	return elem;
+}
+
+jQuery.extend( {
+	htmlPrefilter: function( html ) {
+		return html.replace( rxhtmlTag, "<$1></$2>" );
+	},
+
+	clone: function( elem, dataAndEvents, deepDataAndEvents ) {
+		var i, l, srcElements, destElements,
+			clone = elem.cloneNode( true ),
+			inPage = jQuery.contains( elem.ownerDocument, elem );
+
+		// Fix IE cloning issues
+		if ( !support.noCloneChecked && ( elem.nodeType === 1 || elem.nodeType === 11 ) &&
+				!jQuery.isXMLDoc( elem ) ) {
+
+			// We eschew Sizzle here for performance reasons: https://jsperf.com/getall-vs-sizzle/2
+			destElements = getAll( clone );
+			srcElements = getAll( elem );
+
+			for ( i = 0, l = srcElements.length; i < l; i++ ) {
+				fixInput( srcElements[ i ], destElements[ i ] );
+			}
+		}
+
+		// Copy the events from the original to the clone
+		if ( dataAndEvents ) {
+			if ( deepDataAndEvents ) {
+				srcElements = srcElements || getAll( elem );
+				destElements = destElements || getAll( clone );
+
+				for ( i = 0, l = srcElements.length; i < l; i++ ) {
+					cloneCopyEvent( srcElements[ i ], destElements[ i ] );
+				}
+			} else {
+				cloneCopyEvent( elem, clone );
+			}
+		}
+
+		// Preserve script evaluation history
+		destElements = getAll( clone, "script" );
+		if ( destElements.length > 0 ) {
+			setGlobalEval( destElements, !inPage && getAll( elem, "script" ) );
+		}
+
+		// Return the cloned set
+		return clone;
+	},
+
+	cleanData: function( elems ) {
+		var data, elem, type,
+			special = jQuery.event.special,
+			i = 0;
+
+		for ( ; ( elem = elems[ i ] ) !== undefined; i++ ) {
+			if ( acceptData( elem ) ) {
+				if ( ( data = elem[ dataPriv.expando ] ) ) {
+					if ( data.events ) {
+						for ( type in data.events ) {
+							if ( special[ type ] ) {
+								jQuery.event.remove( elem, type );
+
+							// This is a shortcut to avoid jQuery.event.remove's overhead
+							} else {
+								jQuery.removeEvent( elem, type, data.handle );
+							}
+						}
+					}
+
+					// Support: Chrome <=35 - 45+
+					// Assign undefined instead of using delete, see Data#remove
+					elem[ dataPriv.expando ] = undefined;
+				}
+				if ( elem[ dataUser.expando ] ) {
+
+					// Support: Chrome <=35 - 45+
+					// Assign undefined instead of using delete, see Data#remove
+					elem[ dataUser.expando ] = undefined;
+				}
+			}
+		}
+	}
+} );
+
+jQuery.fn.extend( {
+	detach: function( selector ) {
+		return remove( this, selector, true );
+	},
+
+	remove: function( selector ) {
+		return remove( this, selector );
+	},
+
+	text: function( value ) {
+		return access( this, function( value ) {
+			return value === undefined ?
+				jQuery.text( this ) :
+				this.empty().each( function() {
+					if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {
+						this.textContent = value;
+					}
+				} );
+		}, null, value, arguments.length );
+	},
+
+	append: function() {
+		return domManip( this, arguments, function( elem ) {
+			if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {
+				var target = manipulationTarget( this, elem );
+				target.appendChild( elem );
+			}
+		} );
+	},
+
+	prepend: function() {
+		return domManip( this, arguments, function( elem ) {
+			if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {
+				var target = manipulationTarget( this, elem );
+				target.insertBefore( elem, target.firstChild );
+			}
+		} );
+	},
+
+	before: function() {
+		return domManip( this, arguments, function( elem ) {
+			if ( this.parentNode ) {
+				this.parentNode.insertBefore( elem, this );
+			}
+		} );
+	},
+
+	after: function() {
+		return domManip( this, arguments, function( elem ) {
+			if ( this.parentNode ) {
+				this.parentNode.insertBefore( elem, this.nextSibling );
+			}
+		} );
+	},
+
+	empty: function() {
+		var elem,
+			i = 0;
+
+		for ( ; ( elem = this[ i ] ) != null; i++ ) {
+			if ( elem.nodeType === 1 ) {
+
+				// Prevent memory leaks
+				jQuery.cleanData( getAll( elem, false ) );
+
+				// Remove any remaining nodes
+				elem.textContent = "";
+			}
+		}
+
+		return this;
+	},
+
+	clone: function( dataAndEvents, deepDataAndEvents ) {
+		dataAndEvents = dataAndEvents == null ? false : dataAndEvents;
+		deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents;
+
+		return this.map( function() {
+			return jQuery.clone( this, dataAndEvents, deepDataAndEvents );
+		} );
+	},
+
+	html: function( value ) {
+		return access( this, function( value ) {
+			var elem = this[ 0 ] || {},
+				i = 0,
+				l = this.length;
+
+			if ( value === undefined && elem.nodeType === 1 ) {
+				return elem.innerHTML;
+			}
+
+			// See if we can take a shortcut and just use innerHTML
+			if ( typeof value === "string" && !rnoInnerhtml.test( value ) &&
+				!wrapMap[ ( rtagName.exec( value ) || [ "", "" ] )[ 1 ].toLowerCase() ] ) {
+
+				value = jQuery.htmlPrefilter( value );
+
+				try {
+					for ( ; i < l; i++ ) {
+						elem = this[ i ] || {};
+
+						// Remove element nodes and prevent memory leaks
+						if ( elem.nodeType === 1 ) {
+							jQuery.cleanData( getAll( elem, false ) );
+							elem.innerHTML = value;
+						}
+					}
+
+					elem = 0;
+
+				// If using innerHTML throws an exception, use the fallback method
+				} catch ( e ) {}
+			}
+
+			if ( elem ) {
+				this.empty().append( value );
+			}
+		}, null, value, arguments.length );
+	},
+
+	replaceWith: function() {
+		var ignored = [];
+
+		// Make the changes, replacing each non-ignored context element with the new content
+		return domManip( this, arguments, function( elem ) {
+			var parent = this.parentNode;
+
+			if ( jQuery.inArray( this, ignored ) < 0 ) {
+				jQuery.cleanData( getAll( this ) );
+				if ( parent ) {
+					parent.replaceChild( elem, this );
+				}
+			}
+
+		// Force callback invocation
+		}, ignored );
+	}
+} );
+
+jQuery.each( {
+	appendTo: "append",
+	prependTo: "prepend",
+	insertBefore: "before",
+	insertAfter: "after",
+	replaceAll: "replaceWith"
+}, function( name, original ) {
+	jQuery.fn[ name ] = function( selector ) {
+		var elems,
+			ret = [],
+			insert = jQuery( selector ),
+			last = insert.length - 1,
+			i = 0;
+
+		for ( ; i <= last; i++ ) {
+			elems = i === last ? this : this.clone( true );
+			jQuery( insert[ i ] )[ original ]( elems );
+
+			// Support: Android <=4.0 only, PhantomJS 1 only
+			// .get() because push.apply(_, arraylike) throws on ancient WebKit
+			push.apply( ret, elems.get() );
+		}
+
+		return this.pushStack( ret );
+	};
+} );
+var rnumnonpx = new RegExp( "^(" + pnum + ")(?!px)[a-z%]+$", "i" );
+
+var getStyles = function( elem ) {
+
+		// Support: IE <=11 only, Firefox <=30 (#15098, #14150)
+		// IE throws on elements created in popups
+		// FF meanwhile throws on frame elements through "defaultView.getComputedStyle"
+		var view = elem.ownerDocument.defaultView;
+
+		if ( !view || !view.opener ) {
+			view = window;
+		}
+
+		return view.getComputedStyle( elem );
+	};
+
+var rboxStyle = new RegExp( cssExpand.join( "|" ), "i" );
+
+
+
+( function() {
+
+	// Executing both pixelPosition & boxSizingReliable tests require only one layout
+	// so they're executed at the same time to save the second computation.
+	function computeStyleTests() {
+
+		// This is a singleton, we need to execute it only once
+		if ( !div ) {
+			return;
+		}
+
+		container.style.cssText = "position:absolute;left:-11111px;width:60px;" +
+			"margin-top:1px;padding:0;border:0";
+		div.style.cssText =
+			"position:relative;display:block;box-sizing:border-box;overflow:scroll;" +
+			"margin:auto;border:1px;padding:1px;" +
+			"width:60%;top:1%";
+		documentElement.appendChild( container ).appendChild( div );
+
+		var divStyle = window.getComputedStyle( div );
+		pixelPositionVal = divStyle.top !== "1%";
+
+		// Support: Android 4.0 - 4.3 only, Firefox <=3 - 44
+		reliableMarginLeftVal = roundPixelMeasures( divStyle.marginLeft ) === 12;
+
+		// Support: Android 4.0 - 4.3 only, Safari <=9.1 - 10.1, iOS <=7.0 - 9.3
+		// Some styles come back with percentage values, even though they shouldn't
+		div.style.right = "60%";
+		pixelBoxStylesVal = roundPixelMeasures( divStyle.right ) === 36;
+
+		// Support: IE 9 - 11 only
+		// Detect misreporting of content dimensions for box-sizing:border-box elements
+		boxSizingReliableVal = roundPixelMeasures( divStyle.width ) === 36;
+
+		// Support: IE 9 only
+		// Detect overflow:scroll screwiness (gh-3699)
+		div.style.position = "absolute";
+		scrollboxSizeVal = div.offsetWidth === 36 || "absolute";
+
+		documentElement.removeChild( container );
+
+		// Nullify the div so it wouldn't be stored in the memory and
+		// it will also be a sign that checks already performed
+		div = null;
+	}
+
+	function roundPixelMeasures( measure ) {
+		return Math.round( parseFloat( measure ) );
+	}
+
+	var pixelPositionVal, boxSizingReliableVal, scrollboxSizeVal, pixelBoxStylesVal,
+		reliableMarginLeftVal,
+		container = document.createElement( "div" ),
+		div = document.createElement( "div" );
+
+	// Finish early in limited (non-browser) environments
+	if ( !div.style ) {
+		return;
+	}
+
+	// Support: IE <=9 - 11 only
+	// Style of cloned element affects source element cloned (#8908)
+	div.style.backgroundClip = "content-box";
+	div.cloneNode( true ).style.backgroundClip = "";
+	support.clearCloneStyle = div.style.backgroundClip === "content-box";
+
+	jQuery.extend( support, {
+		boxSizingReliable: function() {
+			computeStyleTests();
+			return boxSizingReliableVal;
+		},
+		pixelBoxStyles: function() {
+			computeStyleTests();
+			return pixelBoxStylesVal;
+		},
+		pixelPosition: function() {
+			computeStyleTests();
+			return pixelPositionVal;
+		},
+		reliableMarginLeft: function() {
+			computeStyleTests();
+			return reliableMarginLeftVal;
+		},
+		scrollboxSize: function() {
+			computeStyleTests();
+			return scrollboxSizeVal;
+		}
+	} );
+} )();
+
+
+function curCSS( elem, name, computed ) {
+	var width, minWidth, maxWidth, ret,
+
+		// Support: Firefox 51+
+		// Retrieving style before computed somehow
+		// fixes an issue with getting wrong values
+		// on detached elements
+		style = elem.style;
+
+	computed = computed || getStyles( elem );
+
+	// getPropertyValue is needed for:
+	//   .css('filter') (IE 9 only, #12537)
+	//   .css('--customProperty) (#3144)
+	if ( computed ) {
+		ret = computed.getPropertyValue( name ) || computed[ name ];
+
+		if ( ret === "" && !jQuery.contains( elem.ownerDocument, elem ) ) {
+			ret = jQuery.style( elem, name );
+		}
+
+		// A tribute to the "awesome hack by Dean Edwards"
+		// Android Browser returns percentage for some values,
+		// but width seems to be reliably pixels.
+		// This is against the CSSOM draft spec:
+		// https://drafts.csswg.org/cssom/#resolved-values
+		if ( !support.pixelBoxStyles() && rnumnonpx.test( ret ) && rboxStyle.test( name ) ) {
+
+			// Remember the original values
+			width = style.width;
+			minWidth = style.minWidth;
+			maxWidth = style.maxWidth;
+
+			// Put in the new values to get a computed value out
+			style.minWidth = style.maxWidth = style.width = ret;
+			ret = computed.width;
+
+			// Revert the changed values
+			style.width = width;
+			style.minWidth = minWidth;
+			style.maxWidth = maxWidth;
+		}
+	}
+
+	return ret !== undefined ?
+
+		// Support: IE <=9 - 11 only
+		// IE returns zIndex value as an integer.
+		ret + "" :
+		ret;
+}
+
+
+function addGetHookIf( conditionFn, hookFn ) {
+
+	// Define the hook, we'll check on the first run if it's really needed.
+	return {
+		get: function() {
+			if ( conditionFn() ) {
+
+				// Hook not needed (or it's not possible to use it due
+				// to missing dependency), remove it.
+				delete this.get;
+				return;
+			}
+
+			// Hook needed; redefine it so that the support test is not executed again.
+			return ( this.get = hookFn ).apply( this, arguments );
+		}
+	};
+}
+
+
+var
+
+	// Swappable if display is none or starts with table
+	// except "table", "table-cell", or "table-caption"
+	// See here for display values: https://developer.mozilla.org/en-US/docs/CSS/display
+	rdisplayswap = /^(none|table(?!-c[ea]).+)/,
+	rcustomProp = /^--/,
+	cssShow = { position: "absolute", visibility: "hidden", display: "block" },
+	cssNormalTransform = {
+		letterSpacing: "0",
+		fontWeight: "400"
+	},
+
+	cssPrefixes = [ "Webkit", "Moz", "ms" ],
+	emptyStyle = document.createElement( "div" ).style;
+
+// Return a css property mapped to a potentially vendor prefixed property
+function vendorPropName( name ) {
+
+	// Shortcut for names that are not vendor prefixed
+	if ( name in emptyStyle ) {
+		return name;
+	}
+
+	// Check for vendor prefixed names
+	var capName = name[ 0 ].toUpperCase() + name.slice( 1 ),
+		i = cssPrefixes.length;
+
+	while ( i-- ) {
+		name = cssPrefixes[ i ] + capName;
+		if ( name in emptyStyle ) {
+			return name;
+		}
+	}
+}
+
+// Return a property mapped along what jQuery.cssProps suggests or to
+// a vendor prefixed property.
+function finalPropName( name ) {
+	var ret = jQuery.cssProps[ name ];
+	if ( !ret ) {
+		ret = jQuery.cssProps[ name ] = vendorPropName( name ) || name;
+	}
+	return ret;
+}
+
+function setPositiveNumber( elem, value, subtract ) {
+
+	// Any relative (+/-) values have already been
+	// normalized at this point
+	var matches = rcssNum.exec( value );
+	return matches ?
+
+		// Guard against undefined "subtract", e.g., when used as in cssHooks
+		Math.max( 0, matches[ 2 ] - ( subtract || 0 ) ) + ( matches[ 3 ] || "px" ) :
+		value;
+}
+
+function boxModelAdjustment( elem, dimension, box, isBorderBox, styles, computedVal ) {
+	var i = dimension === "width" ? 1 : 0,
+		extra = 0,
+		delta = 0;
+
+	// Adjustment may not be necessary
+	if ( box === ( isBorderBox ? "border" : "content" ) ) {
+		return 0;
+	}
+
+	for ( ; i < 4; i += 2 ) {
+
+		// Both box models exclude margin
+		if ( box === "margin" ) {
+			delta += jQuery.css( elem, box + cssExpand[ i ], true, styles );
+		}
+
+		// If we get here with a content-box, we're seeking "padding" or "border" or "margin"
+		if ( !isBorderBox ) {
+
+			// Add padding
+			delta += jQuery.css( elem, "padding" + cssExpand[ i ], true, styles );
+
+			// For "border" or "margin", add border
+			if ( box !== "padding" ) {
+				delta += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles );
+
+			// But still keep track of it otherwise
+			} else {
+				extra += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles );
+			}
+
+		// If we get here with a border-box (content + padding + border), we're seeking "content" or
+		// "padding" or "margin"
+		} else {
+
+			// For "content", subtract padding
+			if ( box === "content" ) {
+				delta -= jQuery.css( elem, "padding" + cssExpand[ i ], true, styles );
+			}
+
+			// For "content" or "padding", subtract border
+			if ( box !== "margin" ) {
+				delta -= jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles );
+			}
+		}
+	}
+
+	// Account for positive content-box scroll gutter when requested by providing computedVal
+	if ( !isBorderBox && computedVal >= 0 ) {
+
+		// offsetWidth/offsetHeight is a rounded sum of content, padding, scroll gutter, and border
+		// Assuming integer scroll gutter, subtract the rest and round down
+		delta += Math.max( 0, Math.ceil(
+			elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] -
+			computedVal -
+			delta -
+			extra -
+			0.5
+		) );
+	}
+
+	return delta;
+}
+
+function getWidthOrHeight( elem, dimension, extra ) {
+
+	// Start with computed style
+	var styles = getStyles( elem ),
+		val = curCSS( elem, dimension, styles ),
+		isBorderBox = jQuery.css( elem, "boxSizing", false, styles ) === "border-box",
+		valueIsBorderBox = isBorderBox;
+
+	// Support: Firefox <=54
+	// Return a confounding non-pixel value or feign ignorance, as appropriate.
+	if ( rnumnonpx.test( val ) ) {
+		if ( !extra ) {
+			return val;
+		}
+		val = "auto";
+	}
+
+	// Check for style in case a browser which returns unreliable values
+	// for getComputedStyle silently falls back to the reliable elem.style
+	valueIsBorderBox = valueIsBorderBox &&
+		( support.boxSizingReliable() || val === elem.style[ dimension ] );
+
+	// Fall back to offsetWidth/offsetHeight when value is "auto"
+	// This happens for inline elements with no explicit setting (gh-3571)
+	// Support: Android <=4.1 - 4.3 only
+	// Also use offsetWidth/offsetHeight for misreported inline dimensions (gh-3602)
+	if ( val === "auto" ||
+		!parseFloat( val ) && jQuery.css( elem, "display", false, styles ) === "inline" ) {
+
+		val = elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ];
+
+		// offsetWidth/offsetHeight provide border-box values
+		valueIsBorderBox = true;
+	}
+
+	// Normalize "" and auto
+	val = parseFloat( val ) || 0;
+
+	// Adjust for the element's box model
+	return ( val +
+		boxModelAdjustment(
+			elem,
+			dimension,
+			extra || ( isBorderBox ? "border" : "content" ),
+			valueIsBorderBox,
+			styles,
+
+			// Provide the current computed size to request scroll gutter calculation (gh-3589)
+			val
+		)
+	) + "px";
+}
+
+jQuery.extend( {
+
+	// Add in style property hooks for overriding the default
+	// behavior of getting and setting a style property
+	cssHooks: {
+		opacity: {
+			get: function( elem, computed ) {
+				if ( computed ) {
+
+					// We should always get a number back from opacity
+					var ret = curCSS( elem, "opacity" );
+					return ret === "" ? "1" : ret;
+				}
+			}
+		}
+	},
+
+	// Don't automatically add "px" to these possibly-unitless properties
+	cssNumber: {
+		"animationIterationCount": true,
+		"columnCount": true,
+		"fillOpacity": true,
+		"flexGrow": true,
+		"flexShrink": true,
+		"fontWeight": true,
+		"lineHeight": true,
+		"opacity": true,
+		"order": true,
+		"orphans": true,
+		"widows": true,
+		"zIndex": true,
+		"zoom": true
+	},
+
+	// Add in properties whose names you wish to fix before
+	// setting or getting the value
+	cssProps: {},
+
+	// Get and set the style property on a DOM Node
+	style: function( elem, name, value, extra ) {
+
+		// Don't set styles on text and comment nodes
+		if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) {
+			return;
+		}
+
+		// Make sure that we're working with the right name
+		var ret, type, hooks,
+			origName = camelCase( name ),
+			isCustomProp = rcustomProp.test( name ),
+			style = elem.style;
+
+		// Make sure that we're working with the right name. We don't
+		// want to query the value if it is a CSS custom property
+		// since they are user-defined.
+		if ( !isCustomProp ) {
+			name = finalPropName( origName );
+		}
+
+		// Gets hook for the prefixed version, then unprefixed version
+		hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ];
+
+		// Check if we're setting a value
+		if ( value !== undefined ) {
+			type = typeof value;
+
+			// Convert "+=" or "-=" to relative numbers (#7345)
+			if ( type === "string" && ( ret = rcssNum.exec( value ) ) && ret[ 1 ] ) {
+				value = adjustCSS( elem, name, ret );
+
+				// Fixes bug #9237
+				type = "number";
+			}
+
+			// Make sure that null and NaN values aren't set (#7116)
+			if ( value == null || value !== value ) {
+				return;
+			}
+
+			// If a number was passed in, add the unit (except for certain CSS properties)
+			if ( type === "number" ) {
+				value += ret && ret[ 3 ] || ( jQuery.cssNumber[ origName ] ? "" : "px" );
+			}
+
+			// background-* props affect original clone's values
+			if ( !support.clearCloneStyle && value === "" && name.indexOf( "background" ) === 0 ) {
+				style[ name ] = "inherit";
+			}
+
+			// If a hook was provided, use that value, otherwise just set the specified value
+			if ( !hooks || !( "set" in hooks ) ||
+				( value = hooks.set( elem, value, extra ) ) !== undefined ) {
+
+				if ( isCustomProp ) {
+					style.setProperty( name, value );
+				} else {
+					style[ name ] = value;
+				}
+			}
+
+		} else {
+
+			// If a hook was provided get the non-computed value from there
+			if ( hooks && "get" in hooks &&
+				( ret = hooks.get( elem, false, extra ) ) !== undefined ) {
+
+				return ret;
+			}
+
+			// Otherwise just get the value from the style object
+			return style[ name ];
+		}
+	},
+
+	css: function( elem, name, extra, styles ) {
+		var val, num, hooks,
+			origName = camelCase( name ),
+			isCustomProp = rcustomProp.test( name );
+
+		// Make sure that we're working with the right name. We don't
+		// want to modify the value if it is a CSS custom property
+		// since they are user-defined.
+		if ( !isCustomProp ) {
+			name = finalPropName( origName );
+		}
+
+		// Try prefixed name followed by the unprefixed name
+		hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ];
+
+		// If a hook was provided get the computed value from there
+		if ( hooks && "get" in hooks ) {
+			val = hooks.get( elem, true, extra );
+		}
+
+		// Otherwise, if a way to get the computed value exists, use that
+		if ( val === undefined ) {
+			val = curCSS( elem, name, styles );
+		}
+
+		// Convert "normal" to computed value
+		if ( val === "normal" && name in cssNormalTransform ) {
+			val = cssNormalTransform[ name ];
+		}
+
+		// Make numeric if forced or a qualifier was provided and val looks numeric
+		if ( extra === "" || extra ) {
+			num = parseFloat( val );
+			return extra === true || isFinite( num ) ? num || 0 : val;
+		}
+
+		return val;
+	}
+} );
+
+jQuery.each( [ "height", "width" ], function( i, dimension ) {
+	jQuery.cssHooks[ dimension ] = {
+		get: function( elem, computed, extra ) {
+			if ( computed ) {
+
+				// Certain elements can have dimension info if we invisibly show them
+				// but it must have a current display style that would benefit
+				return rdisplayswap.test( jQuery.css( elem, "display" ) ) &&
+
+					// Support: Safari 8+
+					// Table columns in Safari have non-zero offsetWidth & zero
+					// getBoundingClientRect().width unless display is changed.
+					// Support: IE <=11 only
+					// Running getBoundingClientRect on a disconnected node
+					// in IE throws an error.
+					( !elem.getClientRects().length || !elem.getBoundingClientRect().width ) ?
+						swap( elem, cssShow, function() {
+							return getWidthOrHeight( elem, dimension, extra );
+						} ) :
+						getWidthOrHeight( elem, dimension, extra );
+			}
+		},
+
+		set: function( elem, value, extra ) {
+			var matches,
+				styles = getStyles( elem ),
+				isBorderBox = jQuery.css( elem, "boxSizing", false, styles ) === "border-box",
+				subtract = extra && boxModelAdjustment(
+					elem,
+					dimension,
+					extra,
+					isBorderBox,
+					styles
+				);
+
+			// Account for unreliable border-box dimensions by comparing offset* to computed and
+			// faking a content-box to get border and padding (gh-3699)
+			if ( isBorderBox && support.scrollboxSize() === styles.position ) {
+				subtract -= Math.ceil(
+					elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] -
+					parseFloat( styles[ dimension ] ) -
+					boxModelAdjustment( elem, dimension, "border", false, styles ) -
+					0.5
+				);
+			}
+
+			// Convert to pixels if value adjustment is needed
+			if ( subtract && ( matches = rcssNum.exec( value ) ) &&
+				( matches[ 3 ] || "px" ) !== "px" ) {
+
+				elem.style[ dimension ] = value;
+				value = jQuery.css( elem, dimension );
+			}
+
+			return setPositiveNumber( elem, value, subtract );
+		}
+	};
+} );
+
+jQuery.cssHooks.marginLeft = addGetHookIf( support.reliableMarginLeft,
+	function( elem, computed ) {
+		if ( computed ) {
+			return ( parseFloat( curCSS( elem, "marginLeft" ) ) ||
+				elem.getBoundingClientRect().left -
+					swap( elem, { marginLeft: 0 }, function() {
+						return elem.getBoundingClientRect().left;
+					} )
+				) + "px";
+		}
+	}
+);
+
+// These hooks are used by animate to expand properties
+jQuery.each( {
+	margin: "",
+	padding: "",
+	border: "Width"
+}, function( prefix, suffix ) {
+	jQuery.cssHooks[ prefix + suffix ] = {
+		expand: function( value ) {
+			var i = 0,
+				expanded = {},
+
+				// Assumes a single number if not a string
+				parts = typeof value === "string" ? value.split( " " ) : [ value ];
+
+			for ( ; i < 4; i++ ) {
+				expanded[ prefix + cssExpand[ i ] + suffix ] =
+					parts[ i ] || parts[ i - 2 ] || parts[ 0 ];
+			}
+
+			return expanded;
+		}
+	};
+
+	if ( prefix !== "margin" ) {
+		jQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber;
+	}
+} );
+
+jQuery.fn.extend( {
+	css: function( name, value ) {
+		return access( this, function( elem, name, value ) {
+			var styles, len,
+				map = {},
+				i = 0;
+
+			if ( Array.isArray( name ) ) {
+				styles = getStyles( elem );
+				len = name.length;
+
+				for ( ; i < len; i++ ) {
+					map[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles );
+				}
+
+				return map;
+			}
+
+			return value !== undefined ?
+				jQuery.style( elem, name, value ) :
+				jQuery.css( elem, name );
+		}, name, value, arguments.length > 1 );
+	}
+} );
+
+
+function Tween( elem, options, prop, end, easing ) {
+	return new Tween.prototype.init( elem, options, prop, end, easing );
+}
+jQuery.Tween = Tween;
+
+Tween.prototype = {
+	constructor: Tween,
+	init: function( elem, options, prop, end, easing, unit ) {
+		this.elem = elem;
+		this.prop = prop;
+		this.easing = easing || jQuery.easing._default;
+		this.options = options;
+		this.start = this.now = this.cur();
+		this.end = end;
+		this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" );
+	},
+	cur: function() {
+		var hooks = Tween.propHooks[ this.prop ];
+
+		return hooks && hooks.get ?
+			hooks.get( this ) :
+			Tween.propHooks._default.get( this );
+	},
+	run: function( percent ) {
+		var eased,
+			hooks = Tween.propHooks[ this.prop ];
+
+		if ( this.options.duration ) {
+			this.pos = eased = jQuery.easing[ this.easing ](
+				percent, this.options.duration * percent, 0, 1, this.options.duration
+			);
+		} else {
+			this.pos = eased = percent;
+		}
+		this.now = ( this.end - this.start ) * eased + this.start;
+
+		if ( this.options.step ) {
+			this.options.step.call( this.elem, this.now, this );
+		}
+
+		if ( hooks && hooks.set ) {
+			hooks.set( this );
+		} else {
+			Tween.propHooks._default.set( this );
+		}
+		return this;
+	}
+};
+
+Tween.prototype.init.prototype = Tween.prototype;
+
+Tween.propHooks = {
+	_default: {
+		get: function( tween ) {
+			var result;
+
+			// Use a property on the element directly when it is not a DOM element,
+			// or when there is no matching style property that exists.
+			if ( tween.elem.nodeType !== 1 ||
+				tween.elem[ tween.prop ] != null && tween.elem.style[ tween.prop ] == null ) {
+				return tween.elem[ tween.prop ];
+			}
+
+			// Passing an empty string as a 3rd parameter to .css will automatically
+			// attempt a parseFloat and fallback to a string if the parse fails.
+			// Simple values such as "10px" are parsed to Float;
+			// complex values such as "rotate(1rad)" are returned as-is.
+			result = jQuery.css( tween.elem, tween.prop, "" );
+
+			// Empty strings, null, undefined and "auto" are converted to 0.
+			return !result || result === "auto" ? 0 : result;
+		},
+		set: function( tween ) {
+
+			// Use step hook for back compat.
+			// Use cssHook if its there.
+			// Use .style if available and use plain properties where available.
+			if ( jQuery.fx.step[ tween.prop ] ) {
+				jQuery.fx.step[ tween.prop ]( tween );
+			} else if ( tween.elem.nodeType === 1 &&
+				( tween.elem.style[ jQuery.cssProps[ tween.prop ] ] != null ||
+					jQuery.cssHooks[ tween.prop ] ) ) {
+				jQuery.style( tween.elem, tween.prop, tween.now + tween.unit );
+			} else {
+				tween.elem[ tween.prop ] = tween.now;
+			}
+		}
+	}
+};
+
+// Support: IE <=9 only
+// Panic based approach to setting things on disconnected nodes
+Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = {
+	set: function( tween ) {
+		if ( tween.elem.nodeType && tween.elem.parentNode ) {
+			tween.elem[ tween.prop ] = tween.now;
+		}
+	}
+};
+
+jQuery.easing = {
+	linear: function( p ) {
+		return p;
+	},
+	swing: function( p ) {
+		return 0.5 - Math.cos( p * Math.PI ) / 2;
+	},
+	_default: "swing"
+};
+
+jQuery.fx = Tween.prototype.init;
+
+// Back compat <1.8 extension point
+jQuery.fx.step = {};
+
+
+
+
+var
+	fxNow, inProgress,
+	rfxtypes = /^(?:toggle|show|hide)$/,
+	rrun = /queueHooks$/;
+
+function schedule() {
+	if ( inProgress ) {
+		if ( document.hidden === false && window.requestAnimationFrame ) {
+			window.requestAnimationFrame( schedule );
+		} else {
+			window.setTimeout( schedule, jQuery.fx.interval );
+		}
+
+		jQuery.fx.tick();
+	}
+}
+
+// Animations created synchronously will run synchronously
+function createFxNow() {
+	window.setTimeout( function() {
+		fxNow = undefined;
+	} );
+	return ( fxNow = Date.now() );
+}
+
+// Generate parameters to create a standard animation
+function genFx( type, includeWidth ) {
+	var which,
+		i = 0,
+		attrs = { height: type };
+
+	// If we include width, step value is 1 to do all cssExpand values,
+	// otherwise step value is 2 to skip over Left and Right
+	includeWidth = includeWidth ? 1 : 0;
+	for ( ; i < 4; i += 2 - includeWidth ) {
+		which = cssExpand[ i ];
+		attrs[ "margin" + which ] = attrs[ "padding" + which ] = type;
+	}
+
+	if ( includeWidth ) {
+		attrs.opacity = attrs.width = type;
+	}
+
+	return attrs;
+}
+
+function createTween( value, prop, animation ) {
+	var tween,
+		collection = ( Animation.tweeners[ prop ] || [] ).concat( Animation.tweeners[ "*" ] ),
+		index = 0,
+		length = collection.length;
+	for ( ; index < length; index++ ) {
+		if ( ( tween = collection[ index ].call( animation, prop, value ) ) ) {
+
+			// We're done with this property
+			return tween;
+		}
+	}
+}
+
+function defaultPrefilter( elem, props, opts ) {
+	var prop, value, toggle, hooks, oldfire, propTween, restoreDisplay, display,
+		isBox = "width" in props || "height" in props,
+		anim = this,
+		orig = {},
+		style = elem.style,
+		hidden = elem.nodeType && isHiddenWithinTree( elem ),
+		dataShow = dataPriv.get( elem, "fxshow" );
+
+	// Queue-skipping animations hijack the fx hooks
+	if ( !opts.queue ) {
+		hooks = jQuery._queueHooks( elem, "fx" );
+		if ( hooks.unqueued == null ) {
+			hooks.unqueued = 0;
+			oldfire = hooks.empty.fire;
+			hooks.empty.fire = function() {
+				if ( !hooks.unqueued ) {
+					oldfire();
+				}
+			};
+		}
+		hooks.unqueued++;
+
+		anim.always( function() {
+
+			// Ensure the complete handler is called before this completes
+			anim.always( function() {
+				hooks.unqueued--;
+				if ( !jQuery.queue( elem, "fx" ).length ) {
+					hooks.empty.fire();
+				}
+			} );
+		} );
+	}
+
+	// Detect show/hide animations
+	for ( prop in props ) {
+		value = props[ prop ];
+		if ( rfxtypes.test( value ) ) {
+			delete props[ prop ];
+			toggle = toggle || value === "toggle";
+			if ( value === ( hidden ? "hide" : "show" ) ) {
+
+				// Pretend to be hidden if this is a "show" and
+				// there is still data from a stopped show/hide
+				if ( value === "show" && dataShow && dataShow[ prop ] !== undefined ) {
+					hidden = true;
+
+				// Ignore all other no-op show/hide data
+				} else {
+					continue;
+				}
+			}
+			orig[ prop ] = dataShow && dataShow[ prop ] || jQuery.style( elem, prop );
+		}
+	}
+
+	// Bail out if this is a no-op like .hide().hide()
+	propTween = !jQuery.isEmptyObject( props );
+	if ( !propTween && jQuery.isEmptyObject( orig ) ) {
+		return;
+	}
+
+	// Restrict "overflow" and "display" styles during box animations
+	if ( isBox && elem.nodeType === 1 ) {
+
+		// Support: IE <=9 - 11, Edge 12 - 15
+		// Record all 3 overflow attributes because IE does not infer the shorthand
+		// from identically-valued overflowX and overflowY and Edge just mirrors
+		// the overflowX value there.
+		opts.overflow = [ style.overflow, style.overflowX, style.overflowY ];
+
+		// Identify a display type, preferring old show/hide data over the CSS cascade
+		restoreDisplay = dataShow && dataShow.display;
+		if ( restoreDisplay == null ) {
+			restoreDisplay = dataPriv.get( elem, "display" );
+		}
+		display = jQuery.css( elem, "display" );
+		if ( display === "none" ) {
+			if ( restoreDisplay ) {
+				display = restoreDisplay;
+			} else {
+
+				// Get nonempty value(s) by temporarily forcing visibility
+				showHide( [ elem ], true );
+				restoreDisplay = elem.style.display || restoreDisplay;
+				display = jQuery.css( elem, "display" );
+				showHide( [ elem ] );
+			}
+		}
+
+		// Animate inline elements as inline-block
+		if ( display === "inline" || display === "inline-block" && restoreDisplay != null ) {
+			if ( jQuery.css( elem, "float" ) === "none" ) {
+
+				// Restore the original display value at the end of pure show/hide animations
+				if ( !propTween ) {
+					anim.done( function() {
+						style.display = restoreDisplay;
+					} );
+					if ( restoreDisplay == null ) {
+						display = style.display;
+						restoreDisplay = display === "none" ? "" : display;
+					}
+				}
+				style.display = "inline-block";
+			}
+		}
+	}
+
+	if ( opts.overflow ) {
+		style.overflow = "hidden";
+		anim.always( function() {
+			style.overflow = opts.overflow[ 0 ];
+			style.overflowX = opts.overflow[ 1 ];
+			style.overflowY = opts.overflow[ 2 ];
+		} );
+	}
+
+	// Implement show/hide animations
+	propTween = false;
+	for ( prop in orig ) {
+
+		// General show/hide setup for this element animation
+		if ( !propTween ) {
+			if ( dataShow ) {
+				if ( "hidden" in dataShow ) {
+					hidden = dataShow.hidden;
+				}
+			} else {
+				dataShow = dataPriv.access( elem, "fxshow", { display: restoreDisplay } );
+			}
+
+			// Store hidden/visible for toggle so `.stop().toggle()` "reverses"
+			if ( toggle ) {
+				dataShow.hidden = !hidden;
+			}
+
+			// Show elements before animating them
+			if ( hidden ) {
+				showHide( [ elem ], true );
+			}
+
+			/* eslint-disable no-loop-func */
+
+			anim.done( function() {
+
+			/* eslint-enable no-loop-func */
+
+				// The final step of a "hide" animation is actually hiding the element
+				if ( !hidden ) {
+					showHide( [ elem ] );
+				}
+				dataPriv.remove( elem, "fxshow" );
+				for ( prop in orig ) {
+					jQuery.style( elem, prop, orig[ prop ] );
+				}
+			} );
+		}
+
+		// Per-property setup
+		propTween = createTween( hidden ? dataShow[ prop ] : 0, prop, anim );
+		if ( !( prop in dataShow ) ) {
+			dataShow[ prop ] = propTween.start;
+			if ( hidden ) {
+				propTween.end = propTween.start;
+				propTween.start = 0;
+			}
+		}
+	}
+}
+
+function propFilter( props, specialEasing ) {
+	var index, name, easing, value, hooks;
+
+	// camelCase, specialEasing and expand cssHook pass
+	for ( index in props ) {
+		name = camelCase( index );
+		easing = specialEasing[ name ];
+		value = props[ index ];
+		if ( Array.isArray( value ) ) {
+			easing = value[ 1 ];
+			value = props[ index ] = value[ 0 ];
+		}
+
+		if ( index !== name ) {
+			props[ name ] = value;
+			delete props[ index ];
+		}
+
+		hooks = jQuery.cssHooks[ name ];
+		if ( hooks && "expand" in hooks ) {
+			value = hooks.expand( value );
+			delete props[ name ];
+
+			// Not quite $.extend, this won't overwrite existing keys.
+			// Reusing 'index' because we have the correct "name"
+			for ( index in value ) {
+				if ( !( index in props ) ) {
+					props[ index ] = value[ index ];
+					specialEasing[ index ] = easing;
+				}
+			}
+		} else {
+			specialEasing[ name ] = easing;
+		}
+	}
+}
+
+function Animation( elem, properties, options ) {
+	var result,
+		stopped,
+		index = 0,
+		length = Animation.prefilters.length,
+		deferred = jQuery.Deferred().always( function() {
+
+			// Don't match elem in the :animated selector
+			delete tick.elem;
+		} ),
+		tick = function() {
+			if ( stopped ) {
+				return false;
+			}
+			var currentTime = fxNow || createFxNow(),
+				remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ),
+
+				// Support: Android 2.3 only
+				// Archaic crash bug won't allow us to use `1 - ( 0.5 || 0 )` (#12497)
+				temp = remaining / animation.duration || 0,
+				percent = 1 - temp,
+				index = 0,
+				length = animation.tweens.length;
+
+			for ( ; index < length; index++ ) {
+				animation.tweens[ index ].run( percent );
+			}
+
+			deferred.notifyWith( elem, [ animation, percent, remaining ] );
+
+			// If there's more to do, yield
+			if ( percent < 1 && length ) {
+				return remaining;
+			}
+
+			// If this was an empty animation, synthesize a final progress notification
+			if ( !length ) {
+				deferred.notifyWith( elem, [ animation, 1, 0 ] );
+			}
+
+			// Resolve the animation and report its conclusion
+			deferred.resolveWith( elem, [ animation ] );
+			return false;
+		},
+		animation = deferred.promise( {
+			elem: elem,
+			props: jQuery.extend( {}, properties ),
+			opts: jQuery.extend( true, {
+				specialEasing: {},
+				easing: jQuery.easing._default
+			}, options ),
+			originalProperties: properties,
+			originalOptions: options,
+			startTime: fxNow || createFxNow(),
+			duration: options.duration,
+			tweens: [],
+			createTween: function( prop, end ) {
+				var tween = jQuery.Tween( elem, animation.opts, prop, end,
+						animation.opts.specialEasing[ prop ] || animation.opts.easing );
+				animation.tweens.push( tween );
+				return tween;
+			},
+			stop: function( gotoEnd ) {
+				var index = 0,
+
+					// If we are going to the end, we want to run all the tweens
+					// otherwise we skip this part
+					length = gotoEnd ? animation.tweens.length : 0;
+				if ( stopped ) {
+					return this;
+				}
+				stopped = true;
+				for ( ; index < length; index++ ) {
+					animation.tweens[ index ].run( 1 );
+				}
+
+				// Resolve when we played the last frame; otherwise, reject
+				if ( gotoEnd ) {
+					deferred.notifyWith( elem, [ animation, 1, 0 ] );
+					deferred.resolveWith( elem, [ animation, gotoEnd ] );
+				} else {
+					deferred.rejectWith( elem, [ animation, gotoEnd ] );
+				}
+				return this;
+			}
+		} ),
+		props = animation.props;
+
+	propFilter( props, animation.opts.specialEasing );
+
+	for ( ; index < length; index++ ) {
+		result = Animation.prefilters[ index ].call( animation, elem, props, animation.opts );
+		if ( result ) {
+			if ( isFunction( result.stop ) ) {
+				jQuery._queueHooks( animation.elem, animation.opts.queue ).stop =
+					result.stop.bind( result );
+			}
+			return result;
+		}
+	}
+
+	jQuery.map( props, createTween, animation );
+
+	if ( isFunction( animation.opts.start ) ) {
+		animation.opts.start.call( elem, animation );
+	}
+
+	// Attach callbacks from options
+	animation
+		.progress( animation.opts.progress )
+		.done( animation.opts.done, animation.opts.complete )
+		.fail( animation.opts.fail )
+		.always( animation.opts.always );
+
+	jQuery.fx.timer(
+		jQuery.extend( tick, {
+			elem: elem,
+			anim: animation,
+			queue: animation.opts.queue
+		} )
+	);
+
+	return animation;
+}
+
+jQuery.Animation = jQuery.extend( Animation, {
+
+	tweeners: {
+		"*": [ function( prop, value ) {
+			var tween = this.createTween( prop, value );
+			adjustCSS( tween.elem, prop, rcssNum.exec( value ), tween );
+			return tween;
+		} ]
+	},
+
+	tweener: function( props, callback ) {
+		if ( isFunction( props ) ) {
+			callback = props;
+			props = [ "*" ];
+		} else {
+			props = props.match( rnothtmlwhite );
+		}
+
+		var prop,
+			index = 0,
+			length = props.length;
+
+		for ( ; index < length; index++ ) {
+			prop = props[ index ];
+			Animation.tweeners[ prop ] = Animation.tweeners[ prop ] || [];
+			Animation.tweeners[ prop ].unshift( callback );
+		}
+	},
+
+	prefilters: [ defaultPrefilter ],
+
+	prefilter: function( callback, prepend ) {
+		if ( prepend ) {
+			Animation.prefilters.unshift( callback );
+		} else {
+			Animation.prefilters.push( callback );
+		}
+	}
+} );
+
+jQuery.speed = function( speed, easing, fn ) {
+	var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : {
+		complete: fn || !fn && easing ||
+			isFunction( speed ) && speed,
+		duration: speed,
+		easing: fn && easing || easing && !isFunction( easing ) && easing
+	};
+
+	// Go to the end state if fx are off
+	if ( jQuery.fx.off ) {
+		opt.duration = 0;
+
+	} else {
+		if ( typeof opt.duration !== "number" ) {
+			if ( opt.duration in jQuery.fx.speeds ) {
+				opt.duration = jQuery.fx.speeds[ opt.duration ];
+
+			} else {
+				opt.duration = jQuery.fx.speeds._default;
+			}
+		}
+	}
+
+	// Normalize opt.queue - true/undefined/null -> "fx"
+	if ( opt.queue == null || opt.queue === true ) {
+		opt.queue = "fx";
+	}
+
+	// Queueing
+	opt.old = opt.complete;
+
+	opt.complete = function() {
+		if ( isFunction( opt.old ) ) {
+			opt.old.call( this );
+		}
+
+		if ( opt.queue ) {
+			jQuery.dequeue( this, opt.queue );
+		}
+	};
+
+	return opt;
+};
+
+jQuery.fn.extend( {
+	fadeTo: function( speed, to, easing, callback ) {
+
+		// Show any hidden elements after setting opacity to 0
+		return this.filter( isHiddenWithinTree ).css( "opacity", 0 ).show()
+
+			// Animate to the value specified
+			.end().animate( { opacity: to }, speed, easing, callback );
+	},
+	animate: function( prop, speed, easing, callback ) {
+		var empty = jQuery.isEmptyObject( prop ),
+			optall = jQuery.speed( speed, easing, callback ),
+			doAnimation = function() {
+
+				// Operate on a copy of prop so per-property easing won't be lost
+				var anim = Animation( this, jQuery.extend( {}, prop ), optall );
+
+				// Empty animations, or finishing resolves immediately
+				if ( empty || dataPriv.get( this, "finish" ) ) {
+					anim.stop( true );
+				}
+			};
+			doAnimation.finish = doAnimation;
+
+		return empty || optall.queue === false ?
+			this.each( doAnimation ) :
+			this.queue( optall.queue, doAnimation );
+	},
+	stop: function( type, clearQueue, gotoEnd ) {
+		var stopQueue = function( hooks ) {
+			var stop = hooks.stop;
+			delete hooks.stop;
+			stop( gotoEnd );
+		};
+
+		if ( typeof type !== "string" ) {
+			gotoEnd = clearQueue;
+			clearQueue = type;
+			type = undefined;
+		}
+		if ( clearQueue && type !== false ) {
+			this.queue( type || "fx", [] );
+		}
+
+		return this.each( function() {
+			var dequeue = true,
+				index = type != null && type + "queueHooks",
+				timers = jQuery.timers,
+				data = dataPriv.get( this );
+
+			if ( index ) {
+				if ( data[ index ] && data[ index ].stop ) {
+					stopQueue( data[ index ] );
+				}
+			} else {
+				for ( index in data ) {
+					if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) {
+						stopQueue( data[ index ] );
+					}
+				}
+			}
+
+			for ( index = timers.length; index--; ) {
+				if ( timers[ index ].elem === this &&
+					( type == null || timers[ index ].queue === type ) ) {
+
+					timers[ index ].anim.stop( gotoEnd );
+					dequeue = false;
+					timers.splice( index, 1 );
+				}
+			}
+
+			// Start the next in the queue if the last step wasn't forced.
+			// Timers currently will call their complete callbacks, which
+			// will dequeue but only if they were gotoEnd.
+			if ( dequeue || !gotoEnd ) {
+				jQuery.dequeue( this, type );
+			}
+		} );
+	},
+	finish: function( type ) {
+		if ( type !== false ) {
+			type = type || "fx";
+		}
+		return this.each( function() {
+			var index,
+				data = dataPriv.get( this ),
+				queue = data[ type + "queue" ],
+				hooks = data[ type + "queueHooks" ],
+				timers = jQuery.timers,
+				length = queue ? queue.length : 0;
+
+			// Enable finishing flag on private data
+			data.finish = true;
+
+			// Empty the queue first
+			jQuery.queue( this, type, [] );
+
+			if ( hooks && hooks.stop ) {
+				hooks.stop.call( this, true );
+			}
+
+			// Look for any active animations, and finish them
+			for ( index = timers.length; index--; ) {
+				if ( timers[ index ].elem === this && timers[ index ].queue === type ) {
+					timers[ index ].anim.stop( true );
+					timers.splice( index, 1 );
+				}
+			}
+
+			// Look for any animations in the old queue and finish them
+			for ( index = 0; index < length; index++ ) {
+				if ( queue[ index ] && queue[ index ].finish ) {
+					queue[ index ].finish.call( this );
+				}
+			}
+
+			// Turn off finishing flag
+			delete data.finish;
+		} );
+	}
+} );
+
+jQuery.each( [ "toggle", "show", "hide" ], function( i, name ) {
+	var cssFn = jQuery.fn[ name ];
+	jQuery.fn[ name ] = function( speed, easing, callback ) {
+		return speed == null || typeof speed === "boolean" ?
+			cssFn.apply( this, arguments ) :
+			this.animate( genFx( name, true ), speed, easing, callback );
+	};
+} );
+
+// Generate shortcuts for custom animations
+jQuery.each( {
+	slideDown: genFx( "show" ),
+	slideUp: genFx( "hide" ),
+	slideToggle: genFx( "toggle" ),
+	fadeIn: { opacity: "show" },
+	fadeOut: { opacity: "hide" },
+	fadeToggle: { opacity: "toggle" }
+}, function( name, props ) {
+	jQuery.fn[ name ] = function( speed, easing, callback ) {
+		return this.animate( props, speed, easing, callback );
+	};
+} );
+
+jQuery.timers = [];
+jQuery.fx.tick = function() {
+	var timer,
+		i = 0,
+		timers = jQuery.timers;
+
+	fxNow = Date.now();
+
+	for ( ; i < timers.length; i++ ) {
+		timer = timers[ i ];
+
+		// Run the timer and safely remove it when done (allowing for external removal)
+		if ( !timer() && timers[ i ] === timer ) {
+			timers.splice( i--, 1 );
+		}
+	}
+
+	if ( !timers.length ) {
+		jQuery.fx.stop();
+	}
+	fxNow = undefined;
+};
+
+jQuery.fx.timer = function( timer ) {
+	jQuery.timers.push( timer );
+	jQuery.fx.start();
+};
+
+jQuery.fx.interval = 13;
+jQuery.fx.start = function() {
+	if ( inProgress ) {
+		return;
+	}
+
+	inProgress = true;
+	schedule();
+};
+
+jQuery.fx.stop = function() {
+	inProgress = null;
+};
+
+jQuery.fx.speeds = {
+	slow: 600,
+	fast: 200,
+
+	// Default speed
+	_default: 400
+};
+
+
+// Based off of the plugin by Clint Helfers, with permission.
+// https://web.archive.org/web/20100324014747/http://blindsignals.com/index.php/2009/07/jquery-delay/
+jQuery.fn.delay = function( time, type ) {
+	time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time;
+	type = type || "fx";
+
+	return this.queue( type, function( next, hooks ) {
+		var timeout = window.setTimeout( next, time );
+		hooks.stop = function() {
+			window.clearTimeout( timeout );
+		};
+	} );
+};
+
+
+( function() {
+	var input = document.createElement( "input" ),
+		select = document.createElement( "select" ),
+		opt = select.appendChild( document.createElement( "option" ) );
+
+	input.type = "checkbox";
+
+	// Support: Android <=4.3 only
+	// Default value for a checkbox should be "on"
+	support.checkOn = input.value !== "";
+
+	// Support: IE <=11 only
+	// Must access selectedIndex to make default options select
+	support.optSelected = opt.selected;
+
+	// Support: IE <=11 only
+	// An input loses its value after becoming a radio
+	input = document.createElement( "input" );
+	input.value = "t";
+	input.type = "radio";
+	support.radioValue = input.value === "t";
+} )();
+
+
+var boolHook,
+	attrHandle = jQuery.expr.attrHandle;
+
+jQuery.fn.extend( {
+	attr: function( name, value ) {
+		return access( this, jQuery.attr, name, value, arguments.length > 1 );
+	},
+
+	removeAttr: function( name ) {
+		return this.each( function() {
+			jQuery.removeAttr( this, name );
+		} );
+	}
+} );
+
+jQuery.extend( {
+	attr: function( elem, name, value ) {
+		var ret, hooks,
+			nType = elem.nodeType;
+
+		// Don't get/set attributes on text, comment and attribute nodes
+		if ( nType === 3 || nType === 8 || nType === 2 ) {
+			return;
+		}
+
+		// Fallback to prop when attributes are not supported
+		if ( typeof elem.getAttribute === "undefined" ) {
+			return jQuery.prop( elem, name, value );
+		}
+
+		// Attribute hooks are determined by the lowercase version
+		// Grab necessary hook if one is defined
+		if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) {
+			hooks = jQuery.attrHooks[ name.toLowerCase() ] ||
+				( jQuery.expr.match.bool.test( name ) ? boolHook : undefined );
+		}
+
+		if ( value !== undefined ) {
+			if ( value === null ) {
+				jQuery.removeAttr( elem, name );
+				return;
+			}
+
+			if ( hooks && "set" in hooks &&
+				( ret = hooks.set( elem, value, name ) ) !== undefined ) {
+				return ret;
+			}
+
+			elem.setAttribute( name, value + "" );
+			return value;
+		}
+
+		if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) {
+			return ret;
+		}
+
+		ret = jQuery.find.attr( elem, name );
+
+		// Non-existent attributes return null, we normalize to undefined
+		return ret == null ? undefined : ret;
+	},
+
+	attrHooks: {
+		type: {
+			set: function( elem, value ) {
+				if ( !support.radioValue && value === "radio" &&
+					nodeName( elem, "input" ) ) {
+					var val = elem.value;
+					elem.setAttribute( "type", value );
+					if ( val ) {
+						elem.value = val;
+					}
+					return value;
+				}
+			}
+		}
+	},
+
+	removeAttr: function( elem, value ) {
+		var name,
+			i = 0,
+
+			// Attribute names can contain non-HTML whitespace characters
+			// https://html.spec.whatwg.org/multipage/syntax.html#attributes-2
+			attrNames = value && value.match( rnothtmlwhite );
+
+		if ( attrNames && elem.nodeType === 1 ) {
+			while ( ( name = attrNames[ i++ ] ) ) {
+				elem.removeAttribute( name );
+			}
+		}
+	}
+} );
+
+// Hooks for boolean attributes
+boolHook = {
+	set: function( elem, value, name ) {
+		if ( value === false ) {
+
+			// Remove boolean attributes when set to false
+			jQuery.removeAttr( elem, name );
+		} else {
+			elem.setAttribute( name, name );
+		}
+		return name;
+	}
+};
+
+jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( i, name ) {
+	var getter = attrHandle[ name ] || jQuery.find.attr;
+
+	attrHandle[ name ] = function( elem, name, isXML ) {
+		var ret, handle,
+			lowercaseName = name.toLowerCase();
+
+		if ( !isXML ) {
+
+			// Avoid an infinite loop by temporarily removing this function from the getter
+			handle = attrHandle[ lowercaseName ];
+			attrHandle[ lowercaseName ] = ret;
+			ret = getter( elem, name, isXML ) != null ?
+				lowercaseName :
+				null;
+			attrHandle[ lowercaseName ] = handle;
+		}
+		return ret;
+	};
+} );
+
+
+
+
+var rfocusable = /^(?:input|select|textarea|button)$/i,
+	rclickable = /^(?:a|area)$/i;
+
+jQuery.fn.extend( {
+	prop: function( name, value ) {
+		return access( this, jQuery.prop, name, value, arguments.length > 1 );
+	},
+
+	removeProp: function( name ) {
+		return this.each( function() {
+			delete this[ jQuery.propFix[ name ] || name ];
+		} );
+	}
+} );
+
+jQuery.extend( {
+	prop: function( elem, name, value ) {
+		var ret, hooks,
+			nType = elem.nodeType;
+
+		// Don't get/set properties on text, comment and attribute nodes
+		if ( nType === 3 || nType === 8 || nType === 2 ) {
+			return;
+		}
+
+		if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) {
+
+			// Fix name and attach hooks
+			name = jQuery.propFix[ name ] || name;
+			hooks = jQuery.propHooks[ name ];
+		}
+
+		if ( value !== undefined ) {
+			if ( hooks && "set" in hooks &&
+				( ret = hooks.set( elem, value, name ) ) !== undefined ) {
+				return ret;
+			}
+
+			return ( elem[ name ] = value );
+		}
+
+		if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) {
+			return ret;
+		}
+
+		return elem[ name ];
+	},
+
+	propHooks: {
+		tabIndex: {
+			get: function( elem ) {
+
+				// Support: IE <=9 - 11 only
+				// elem.tabIndex doesn't always return the
+				// correct value when it hasn't been explicitly set
+				// https://web.archive.org/web/20141116233347/http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/
+				// Use proper attribute retrieval(#12072)
+				var tabindex = jQuery.find.attr( elem, "tabindex" );
+
+				if ( tabindex ) {
+					return parseInt( tabindex, 10 );
+				}
+
+				if (
+					rfocusable.test( elem.nodeName ) ||
+					rclickable.test( elem.nodeName ) &&
+					elem.href
+				) {
+					return 0;
+				}
+
+				return -1;
+			}
+		}
+	},
+
+	propFix: {
+		"for": "htmlFor",
+		"class": "className"
+	}
+} );
+
+// Support: IE <=11 only
+// Accessing the selectedIndex property
+// forces the browser to respect setting selected
+// on the option
+// The getter ensures a default option is selected
+// when in an optgroup
+// eslint rule "no-unused-expressions" is disabled for this code
+// since it considers such accessions noop
+if ( !support.optSelected ) {
+	jQuery.propHooks.selected = {
+		get: function( elem ) {
+
+			/* eslint no-unused-expressions: "off" */
+
+			var parent = elem.parentNode;
+			if ( parent && parent.parentNode ) {
+				parent.parentNode.selectedIndex;
+			}
+			return null;
+		},
+		set: function( elem ) {
+
+			/* eslint no-unused-expressions: "off" */
+
+			var parent = elem.parentNode;
+			if ( parent ) {
+				parent.selectedIndex;
+
+				if ( parent.parentNode ) {
+					parent.parentNode.selectedIndex;
+				}
+			}
+		}
+	};
+}
+
+jQuery.each( [
+	"tabIndex",
+	"readOnly",
+	"maxLength",
+	"cellSpacing",
+	"cellPadding",
+	"rowSpan",
+	"colSpan",
+	"useMap",
+	"frameBorder",
+	"contentEditable"
+], function() {
+	jQuery.propFix[ this.toLowerCase() ] = this;
+} );
+
+
+
+
+	// Strip and collapse whitespace according to HTML spec
+	// https://infra.spec.whatwg.org/#strip-and-collapse-ascii-whitespace
+	function stripAndCollapse( value ) {
+		var tokens = value.match( rnothtmlwhite ) || [];
+		return tokens.join( " " );
+	}
+
+
+function getClass( elem ) {
+	return elem.getAttribute && elem.getAttribute( "class" ) || "";
+}
+
+function classesToArray( value ) {
+	if ( Array.isArray( value ) ) {
+		return value;
+	}
+	if ( typeof value === "string" ) {
+		return value.match( rnothtmlwhite ) || [];
+	}
+	return [];
+}
+
+jQuery.fn.extend( {
+	addClass: function( value ) {
+		var classes, elem, cur, curValue, clazz, j, finalValue,
+			i = 0;
+
+		if ( isFunction( value ) ) {
+			return this.each( function( j ) {
+				jQuery( this ).addClass( value.call( this, j, getClass( this ) ) );
+			} );
+		}
+
+		classes = classesToArray( value );
+
+		if ( classes.length ) {
+			while ( ( elem = this[ i++ ] ) ) {
+				curValue = getClass( elem );
+				cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " );
+
+				if ( cur ) {
+					j = 0;
+					while ( ( clazz = classes[ j++ ] ) ) {
+						if ( cur.indexOf( " " + clazz + " " ) < 0 ) {
+							cur += clazz + " ";
+						}
+					}
+
+					// Only assign if different to avoid unneeded rendering.
+					finalValue = stripAndCollapse( cur );
+					if ( curValue !== finalValue ) {
+						elem.setAttribute( "class", finalValue );
+					}
+				}
+			}
+		}
+
+		return this;
+	},
+
+	removeClass: function( value ) {
+		var classes, elem, cur, curValue, clazz, j, finalValue,
+			i = 0;
+
+		if ( isFunction( value ) ) {
+			return this.each( function( j ) {
+				jQuery( this ).removeClass( value.call( this, j, getClass( this ) ) );
+			} );
+		}
+
+		if ( !arguments.length ) {
+			return this.attr( "class", "" );
+		}
+
+		classes = classesToArray( value );
+
+		if ( classes.length ) {
+			while ( ( elem = this[ i++ ] ) ) {
+				curValue = getClass( elem );
+
+				// This expression is here for better compressibility (see addClass)
+				cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " );
+
+				if ( cur ) {
+					j = 0;
+					while ( ( clazz = classes[ j++ ] ) ) {
+
+						// Remove *all* instances
+						while ( cur.indexOf( " " + clazz + " " ) > -1 ) {
+							cur = cur.replace( " " + clazz + " ", " " );
+						}
+					}
+
+					// Only assign if different to avoid unneeded rendering.
+					finalValue = stripAndCollapse( cur );
+					if ( curValue !== finalValue ) {
+						elem.setAttribute( "class", finalValue );
+					}
+				}
+			}
+		}
+
+		return this;
+	},
+
+	toggleClass: function( value, stateVal ) {
+		var type = typeof value,
+			isValidValue = type === "string" || Array.isArray( value );
+
+		if ( typeof stateVal === "boolean" && isValidValue ) {
+			return stateVal ? this.addClass( value ) : this.removeClass( value );
+		}
+
+		if ( isFunction( value ) ) {
+			return this.each( function( i ) {
+				jQuery( this ).toggleClass(
+					value.call( this, i, getClass( this ), stateVal ),
+					stateVal
+				);
+			} );
+		}
+
+		return this.each( function() {
+			var className, i, self, classNames;
+
+			if ( isValidValue ) {
+
+				// Toggle individual class names
+				i = 0;
+				self = jQuery( this );
+				classNames = classesToArray( value );
+
+				while ( ( className = classNames[ i++ ] ) ) {
+
+					// Check each className given, space separated list
+					if ( self.hasClass( className ) ) {
+						self.removeClass( className );
+					} else {
+						self.addClass( className );
+					}
+				}
+
+			// Toggle whole class name
+			} else if ( value === undefined || type === "boolean" ) {
+				className = getClass( this );
+				if ( className ) {
+
+					// Store className if set
+					dataPriv.set( this, "__className__", className );
+				}
+
+				// If the element has a class name or if we're passed `false`,
+				// then remove the whole classname (if there was one, the above saved it).
+				// Otherwise bring back whatever was previously saved (if anything),
+				// falling back to the empty string if nothing was stored.
+				if ( this.setAttribute ) {
+					this.setAttribute( "class",
+						className || value === false ?
+						"" :
+						dataPriv.get( this, "__className__" ) || ""
+					);
+				}
+			}
+		} );
+	},
+
+	hasClass: function( selector ) {
+		var className, elem,
+			i = 0;
+
+		className = " " + selector + " ";
+		while ( ( elem = this[ i++ ] ) ) {
+			if ( elem.nodeType === 1 &&
+				( " " + stripAndCollapse( getClass( elem ) ) + " " ).indexOf( className ) > -1 ) {
+					return true;
+			}
+		}
+
+		return false;
+	}
+} );
+
+
+
+
+var rreturn = /\r/g;
+
+jQuery.fn.extend( {
+	val: function( value ) {
+		var hooks, ret, valueIsFunction,
+			elem = this[ 0 ];
+
+		if ( !arguments.length ) {
+			if ( elem ) {
+				hooks = jQuery.valHooks[ elem.type ] ||
+					jQuery.valHooks[ elem.nodeName.toLowerCase() ];
+
+				if ( hooks &&
+					"get" in hooks &&
+					( ret = hooks.get( elem, "value" ) ) !== undefined
+				) {
+					return ret;
+				}
+
+				ret = elem.value;
+
+				// Handle most common string cases
+				if ( typeof ret === "string" ) {
+					return ret.replace( rreturn, "" );
+				}
+
+				// Handle cases where value is null/undef or number
+				return ret == null ? "" : ret;
+			}
+
+			return;
+		}
+
+		valueIsFunction = isFunction( value );
+
+		return this.each( function( i ) {
+			var val;
+
+			if ( this.nodeType !== 1 ) {
+				return;
+			}
+
+			if ( valueIsFunction ) {
+				val = value.call( this, i, jQuery( this ).val() );
+			} else {
+				val = value;
+			}
+
+			// Treat null/undefined as ""; convert numbers to string
+			if ( val == null ) {
+				val = "";
+
+			} else if ( typeof val === "number" ) {
+				val += "";
+
+			} else if ( Array.isArray( val ) ) {
+				val = jQuery.map( val, function( value ) {
+					return value == null ? "" : value + "";
+				} );
+			}
+
+			hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ];
+
+			// If set returns undefined, fall back to normal setting
+			if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) {
+				this.value = val;
+			}
+		} );
+	}
+} );
+
+jQuery.extend( {
+	valHooks: {
+		option: {
+			get: function( elem ) {
+
+				var val = jQuery.find.attr( elem, "value" );
+				return val != null ?
+					val :
+
+					// Support: IE <=10 - 11 only
+					// option.text throws exceptions (#14686, #14858)
+					// Strip and collapse whitespace
+					// https://html.spec.whatwg.org/#strip-and-collapse-whitespace
+					stripAndCollapse( jQuery.text( elem ) );
+			}
+		},
+		select: {
+			get: function( elem ) {
+				var value, option, i,
+					options = elem.options,
+					index = elem.selectedIndex,
+					one = elem.type === "select-one",
+					values = one ? null : [],
+					max = one ? index + 1 : options.length;
+
+				if ( index < 0 ) {
+					i = max;
+
+				} else {
+					i = one ? index : 0;
+				}
+
+				// Loop through all the selected options
+				for ( ; i < max; i++ ) {
+					option = options[ i ];
+
+					// Support: IE <=9 only
+					// IE8-9 doesn't update selected after form reset (#2551)
+					if ( ( option.selected || i === index ) &&
+
+							// Don't return options that are disabled or in a disabled optgroup
+							!option.disabled &&
+							( !option.parentNode.disabled ||
+								!nodeName( option.parentNode, "optgroup" ) ) ) {
+
+						// Get the specific value for the option
+						value = jQuery( option ).val();
+
+						// We don't need an array for one selects
+						if ( one ) {
+							return value;
+						}
+
+						// Multi-Selects return an array
+						values.push( value );
+					}
+				}
+
+				return values;
+			},
+
+			set: function( elem, value ) {
+				var optionSet, option,
+					options = elem.options,
+					values = jQuery.makeArray( value ),
+					i = options.length;
+
+				while ( i-- ) {
+					option = options[ i ];
+
+					/* eslint-disable no-cond-assign */
+
+					if ( option.selected =
+						jQuery.inArray( jQuery.valHooks.option.get( option ), values ) > -1
+					) {
+						optionSet = true;
+					}
+
+					/* eslint-enable no-cond-assign */
+				}
+
+				// Force browsers to behave consistently when non-matching value is set
+				if ( !optionSet ) {
+					elem.selectedIndex = -1;
+				}
+				return values;
+			}
+		}
+	}
+} );
+
+// Radios and checkboxes getter/setter
+jQuery.each( [ "radio", "checkbox" ], function() {
+	jQuery.valHooks[ this ] = {
+		set: function( elem, value ) {
+			if ( Array.isArray( value ) ) {
+				return ( elem.checked = jQuery.inArray( jQuery( elem ).val(), value ) > -1 );
+			}
+		}
+	};
+	if ( !support.checkOn ) {
+		jQuery.valHooks[ this ].get = function( elem ) {
+			return elem.getAttribute( "value" ) === null ? "on" : elem.value;
+		};
+	}
+} );
+
+
+
+
+// Return jQuery for attributes-only inclusion
+
+
+support.focusin = "onfocusin" in window;
+
+
+var rfocusMorph = /^(?:focusinfocus|focusoutblur)$/,
+	stopPropagationCallback = function( e ) {
+		e.stopPropagation();
+	};
+
+jQuery.extend( jQuery.event, {
+
+	trigger: function( event, data, elem, onlyHandlers ) {
+
+		var i, cur, tmp, bubbleType, ontype, handle, special, lastElement,
+			eventPath = [ elem || document ],
+			type = hasOwn.call( event, "type" ) ? event.type : event,
+			namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split( "." ) : [];
+
+		cur = lastElement = tmp = elem = elem || document;
+
+		// Don't do events on text and comment nodes
+		if ( elem.nodeType === 3 || elem.nodeType === 8 ) {
+			return;
+		}
+
+		// focus/blur morphs to focusin/out; ensure we're not firing them right now
+		if ( rfocusMorph.test( type + jQuery.event.triggered ) ) {
+			return;
+		}
+
+		if ( type.indexOf( "." ) > -1 ) {
+
+			// Namespaced trigger; create a regexp to match event type in handle()
+			namespaces = type.split( "." );
+			type = namespaces.shift();
+			namespaces.sort();
+		}
+		ontype = type.indexOf( ":" ) < 0 && "on" + type;
+
+		// Caller can pass in a jQuery.Event object, Object, or just an event type string
+		event = event[ jQuery.expando ] ?
+			event :
+			new jQuery.Event( type, typeof event === "object" && event );
+
+		// Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true)
+		event.isTrigger = onlyHandlers ? 2 : 3;
+		event.namespace = namespaces.join( "." );
+		event.rnamespace = event.namespace ?
+			new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ) :
+			null;
+
+		// Clean up the event in case it is being reused
+		event.result = undefined;
+		if ( !event.target ) {
+			event.target = elem;
+		}
+
+		// Clone any incoming data and prepend the event, creating the handler arg list
+		data = data == null ?
+			[ event ] :
+			jQuery.makeArray( data, [ event ] );
+
+		// Allow special events to draw outside the lines
+		special = jQuery.event.special[ type ] || {};
+		if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) {
+			return;
+		}
+
+		// Determine event propagation path in advance, per W3C events spec (#9951)
+		// Bubble up to document, then to window; watch for a global ownerDocument var (#9724)
+		if ( !onlyHandlers && !special.noBubble && !isWindow( elem ) ) {
+
+			bubbleType = special.delegateType || type;
+			if ( !rfocusMorph.test( bubbleType + type ) ) {
+				cur = cur.parentNode;
+			}
+			for ( ; cur; cur = cur.parentNode ) {
+				eventPath.push( cur );
+				tmp = cur;
+			}
+
+			// Only add window if we got to document (e.g., not plain obj or detached DOM)
+			if ( tmp === ( elem.ownerDocument || document ) ) {
+				eventPath.push( tmp.defaultView || tmp.parentWindow || window );
+			}
+		}
+
+		// Fire handlers on the event path
+		i = 0;
+		while ( ( cur = eventPath[ i++ ] ) && !event.isPropagationStopped() ) {
+			lastElement = cur;
+			event.type = i > 1 ?
+				bubbleType :
+				special.bindType || type;
+
+			// jQuery handler
+			handle = ( dataPriv.get( cur, "events" ) || {} )[ event.type ] &&
+				dataPriv.get( cur, "handle" );
+			if ( handle ) {
+				handle.apply( cur, data );
+			}
+
+			// Native handler
+			handle = ontype && cur[ ontype ];
+			if ( handle && handle.apply && acceptData( cur ) ) {
+				event.result = handle.apply( cur, data );
+				if ( event.result === false ) {
+					event.preventDefault();
+				}
+			}
+		}
+		event.type = type;
+
+		// If nobody prevented the default action, do it now
+		if ( !onlyHandlers && !event.isDefaultPrevented() ) {
+
+			if ( ( !special._default ||
+				special._default.apply( eventPath.pop(), data ) === false ) &&
+				acceptData( elem ) ) {
+
+				// Call a native DOM method on the target with the same name as the event.
+				// Don't do default actions on window, that's where global variables be (#6170)
+				if ( ontype && isFunction( elem[ type ] ) && !isWindow( elem ) ) {
+
+					// Don't re-trigger an onFOO event when we call its FOO() method
+					tmp = elem[ ontype ];
+
+					if ( tmp ) {
+						elem[ ontype ] = null;
+					}
+
+					// Prevent re-triggering of the same event, since we already bubbled it above
+					jQuery.event.triggered = type;
+
+					if ( event.isPropagationStopped() ) {
+						lastElement.addEventListener( type, stopPropagationCallback );
+					}
+
+					elem[ type ]();
+
+					if ( event.isPropagationStopped() ) {
+						lastElement.removeEventListener( type, stopPropagationCallback );
+					}
+
+					jQuery.event.triggered = undefined;
+
+					if ( tmp ) {
+						elem[ ontype ] = tmp;
+					}
+				}
+			}
+		}
+
+		return event.result;
+	},
+
+	// Piggyback on a donor event to simulate a different one
+	// Used only for `focus(in | out)` events
+	simulate: function( type, elem, event ) {
+		var e = jQuery.extend(
+			new jQuery.Event(),
+			event,
+			{
+				type: type,
+				isSimulated: true
+			}
+		);
+
+		jQuery.event.trigger( e, null, elem );
+	}
+
+} );
+
+jQuery.fn.extend( {
+
+	trigger: function( type, data ) {
+		return this.each( function() {
+			jQuery.event.trigger( type, data, this );
+		} );
+	},
+	triggerHandler: function( type, data ) {
+		var elem = this[ 0 ];
+		if ( elem ) {
+			return jQuery.event.trigger( type, data, elem, true );
+		}
+	}
+} );
+
+
+// Support: Firefox <=44
+// Firefox doesn't have focus(in | out) events
+// Related ticket - https://bugzilla.mozilla.org/show_bug.cgi?id=687787
+//
+// Support: Chrome <=48 - 49, Safari <=9.0 - 9.1
+// focus(in | out) events fire after focus & blur events,
+// which is spec violation - http://www.w3.org/TR/DOM-Level-3-Events/#events-focusevent-event-order
+// Related ticket - https://bugs.chromium.org/p/chromium/issues/detail?id=449857
+if ( !support.focusin ) {
+	jQuery.each( { focus: "focusin", blur: "focusout" }, function( orig, fix ) {
+
+		// Attach a single capturing handler on the document while someone wants focusin/focusout
+		var handler = function( event ) {
+			jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ) );
+		};
+
+		jQuery.event.special[ fix ] = {
+			setup: function() {
+				var doc = this.ownerDocument || this,
+					attaches = dataPriv.access( doc, fix );
+
+				if ( !attaches ) {
+					doc.addEventListener( orig, handler, true );
+				}
+				dataPriv.access( doc, fix, ( attaches || 0 ) + 1 );
+			},
+			teardown: function() {
+				var doc = this.ownerDocument || this,
+					attaches = dataPriv.access( doc, fix ) - 1;
+
+				if ( !attaches ) {
+					doc.removeEventListener( orig, handler, true );
+					dataPriv.remove( doc, fix );
+
+				} else {
+					dataPriv.access( doc, fix, attaches );
+				}
+			}
+		};
+	} );
+}
+var location = window.location;
+
+var nonce = Date.now();
+
+var rquery = ( /\?/ );
+
+
+
+// Cross-browser xml parsing
+jQuery.parseXML = function( data ) {
+	var xml;
+	if ( !data || typeof data !== "string" ) {
+		return null;
+	}
+
+	// Support: IE 9 - 11 only
+	// IE throws on parseFromString with invalid input.
+	try {
+		xml = ( new window.DOMParser() ).parseFromString( data, "text/xml" );
+	} catch ( e ) {
+		xml = undefined;
+	}
+
+	if ( !xml || xml.getElementsByTagName( "parsererror" ).length ) {
+		jQuery.error( "Invalid XML: " + data );
+	}
+	return xml;
+};
+
+
+var
+	rbracket = /\[\]$/,
+	rCRLF = /\r?\n/g,
+	rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i,
+	rsubmittable = /^(?:input|select|textarea|keygen)/i;
+
+function buildParams( prefix, obj, traditional, add ) {
+	var name;
+
+	if ( Array.isArray( obj ) ) {
+
+		// Serialize array item.
+		jQuery.each( obj, function( i, v ) {
+			if ( traditional || rbracket.test( prefix ) ) {
+
+				// Treat each array item as a scalar.
+				add( prefix, v );
+
+			} else {
+
+				// Item is non-scalar (array or object), encode its numeric index.
+				buildParams(
+					prefix + "[" + ( typeof v === "object" && v != null ? i : "" ) + "]",
+					v,
+					traditional,
+					add
+				);
+			}
+		} );
+
+	} else if ( !traditional && toType( obj ) === "object" ) {
+
+		// Serialize object item.
+		for ( name in obj ) {
+			buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add );
+		}
+
+	} else {
+
+		// Serialize scalar item.
+		add( prefix, obj );
+	}
+}
+
+// Serialize an array of form elements or a set of
+// key/values into a query string
+jQuery.param = function( a, traditional ) {
+	var prefix,
+		s = [],
+		add = function( key, valueOrFunction ) {
+
+			// If value is a function, invoke it and use its return value
+			var value = isFunction( valueOrFunction ) ?
+				valueOrFunction() :
+				valueOrFunction;
+
+			s[ s.length ] = encodeURIComponent( key ) + "=" +
+				encodeURIComponent( value == null ? "" : value );
+		};
+
+	// If an array was passed in, assume that it is an array of form elements.
+	if ( Array.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) {
+
+		// Serialize the form elements
+		jQuery.each( a, function() {
+			add( this.name, this.value );
+		} );
+
+	} else {
+
+		// If traditional, encode the "old" way (the way 1.3.2 or older
+		// did it), otherwise encode params recursively.
+		for ( prefix in a ) {
+			buildParams( prefix, a[ prefix ], traditional, add );
+		}
+	}
+
+	// Return the resulting serialization
+	return s.join( "&" );
+};
+
+jQuery.fn.extend( {
+	serialize: function() {
+		return jQuery.param( this.serializeArray() );
+	},
+	serializeArray: function() {
+		return this.map( function() {
+
+			// Can add propHook for "elements" to filter or add form elements
+			var elements = jQuery.prop( this, "elements" );
+			return elements ? jQuery.makeArray( elements ) : this;
+		} )
+		.filter( function() {
+			var type = this.type;
+
+			// Use .is( ":disabled" ) so that fieldset[disabled] works
+			return this.name && !jQuery( this ).is( ":disabled" ) &&
+				rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) &&
+				( this.checked || !rcheckableType.test( type ) );
+		} )
+		.map( function( i, elem ) {
+			var val = jQuery( this ).val();
+
+			if ( val == null ) {
+				return null;
+			}
+
+			if ( Array.isArray( val ) ) {
+				return jQuery.map( val, function( val ) {
+					return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) };
+				} );
+			}
+
+			return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) };
+		} ).get();
+	}
+} );
+
+
+var
+	r20 = /%20/g,
+	rhash = /#.*$/,
+	rantiCache = /([?&])_=[^&]*/,
+	rheaders = /^(.*?):[ \t]*([^\r\n]*)$/mg,
+
+	// #7653, #8125, #8152: local protocol detection
+	rlocalProtocol = /^(?:about|app|app-storage|.+-extension|file|res|widget):$/,
+	rnoContent = /^(?:GET|HEAD)$/,
+	rprotocol = /^\/\//,
+
+	/* Prefilters
+	 * 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example)
+	 * 2) These are called:
+	 *    - BEFORE asking for a transport
+	 *    - AFTER param serialization (s.data is a string if s.processData is true)
+	 * 3) key is the dataType
+	 * 4) the catchall symbol "*" can be used
+	 * 5) execution will start with transport dataType and THEN continue down to "*" if needed
+	 */
+	prefilters = {},
+
+	/* Transports bindings
+	 * 1) key is the dataType
+	 * 2) the catchall symbol "*" can be used
+	 * 3) selection will start with transport dataType and THEN go to "*" if needed
+	 */
+	transports = {},
+
+	// Avoid comment-prolog char sequence (#10098); must appease lint and evade compression
+	allTypes = "*/".concat( "*" ),
+
+	// Anchor tag for parsing the document origin
+	originAnchor = document.createElement( "a" );
+	originAnchor.href = location.href;
+
+// Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport
+function addToPrefiltersOrTransports( structure ) {
+
+	// dataTypeExpression is optional and defaults to "*"
+	return function( dataTypeExpression, func ) {
+
+		if ( typeof dataTypeExpression !== "string" ) {
+			func = dataTypeExpression;
+			dataTypeExpression = "*";
+		}
+
+		var dataType,
+			i = 0,
+			dataTypes = dataTypeExpression.toLowerCase().match( rnothtmlwhite ) || [];
+
+		if ( isFunction( func ) ) {
+
+			// For each dataType in the dataTypeExpression
+			while ( ( dataType = dataTypes[ i++ ] ) ) {
+
+				// Prepend if requested
+				if ( dataType[ 0 ] === "+" ) {
+					dataType = dataType.slice( 1 ) || "*";
+					( structure[ dataType ] = structure[ dataType ] || [] ).unshift( func );
+
+				// Otherwise append
+				} else {
+					( structure[ dataType ] = structure[ dataType ] || [] ).push( func );
+				}
+			}
+		}
+	};
+}
+
+// Base inspection function for prefilters and transports
+function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR ) {
+
+	var inspected = {},
+		seekingTransport = ( structure === transports );
+
+	function inspect( dataType ) {
+		var selected;
+		inspected[ dataType ] = true;
+		jQuery.each( structure[ dataType ] || [], function( _, prefilterOrFactory ) {
+			var dataTypeOrTransport = prefilterOrFactory( options, originalOptions, jqXHR );
+			if ( typeof dataTypeOrTransport === "string" &&
+				!seekingTransport && !inspected[ dataTypeOrTransport ] ) {
+
+				options.dataTypes.unshift( dataTypeOrTransport );
+				inspect( dataTypeOrTransport );
+				return false;
+			} else if ( seekingTransport ) {
+				return !( selected = dataTypeOrTransport );
+			}
+		} );
+		return selected;
+	}
+
+	return inspect( options.dataTypes[ 0 ] ) || !inspected[ "*" ] && inspect( "*" );
+}
+
+// A special extend for ajax options
+// that takes "flat" options (not to be deep extended)
+// Fixes #9887
+function ajaxExtend( target, src ) {
+	var key, deep,
+		flatOptions = jQuery.ajaxSettings.flatOptions || {};
+
+	for ( key in src ) {
+		if ( src[ key ] !== undefined ) {
+			( flatOptions[ key ] ? target : ( deep || ( deep = {} ) ) )[ key ] = src[ key ];
+		}
+	}
+	if ( deep ) {
+		jQuery.extend( true, target, deep );
+	}
+
+	return target;
+}
+
+/* Handles responses to an ajax request:
+ * - finds the right dataType (mediates between content-type and expected dataType)
+ * - returns the corresponding response
+ */
+function ajaxHandleResponses( s, jqXHR, responses ) {
+
+	var ct, type, finalDataType, firstDataType,
+		contents = s.contents,
+		dataTypes = s.dataTypes;
+
+	// Remove auto dataType and get content-type in the process
+	while ( dataTypes[ 0 ] === "*" ) {
+		dataTypes.shift();
+		if ( ct === undefined ) {
+			ct = s.mimeType || jqXHR.getResponseHeader( "Content-Type" );
+		}
+	}
+
+	// Check if we're dealing with a known content-type
+	if ( ct ) {
+		for ( type in contents ) {
+			if ( contents[ type ] && contents[ type ].test( ct ) ) {
+				dataTypes.unshift( type );
+				break;
+			}
+		}
+	}
+
+	// Check to see if we have a response for the expected dataType
+	if ( dataTypes[ 0 ] in responses ) {
+		finalDataType = dataTypes[ 0 ];
+	} else {
+
+		// Try convertible dataTypes
+		for ( type in responses ) {
+			if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[ 0 ] ] ) {
+				finalDataType = type;
+				break;
+			}
+			if ( !firstDataType ) {
+				firstDataType = type;
+			}
+		}
+
+		// Or just use first one
+		finalDataType = finalDataType || firstDataType;
+	}
+
+	// If we found a dataType
+	// We add the dataType to the list if needed
+	// and return the corresponding response
+	if ( finalDataType ) {
+		if ( finalDataType !== dataTypes[ 0 ] ) {
+			dataTypes.unshift( finalDataType );
+		}
+		return responses[ finalDataType ];
+	}
+}
+
+/* Chain conversions given the request and the original response
+ * Also sets the responseXXX fields on the jqXHR instance
+ */
+function ajaxConvert( s, response, jqXHR, isSuccess ) {
+	var conv2, current, conv, tmp, prev,
+		converters = {},
+
+		// Work with a copy of dataTypes in case we need to modify it for conversion
+		dataTypes = s.dataTypes.slice();
+
+	// Create converters map with lowercased keys
+	if ( dataTypes[ 1 ] ) {
+		for ( conv in s.converters ) {
+			converters[ conv.toLowerCase() ] = s.converters[ conv ];
+		}
+	}
+
+	current = dataTypes.shift();
+
+	// Convert to each sequential dataType
+	while ( current ) {
+
+		if ( s.responseFields[ current ] ) {
+			jqXHR[ s.responseFields[ current ] ] = response;
+		}
+
+		// Apply the dataFilter if provided
+		if ( !prev && isSuccess && s.dataFilter ) {
+			response = s.dataFilter( response, s.dataType );
+		}
+
+		prev = current;
+		current = dataTypes.shift();
+
+		if ( current ) {
+
+			// There's only work to do if current dataType is non-auto
+			if ( current === "*" ) {
+
+				current = prev;
+
+			// Convert response if prev dataType is non-auto and differs from current
+			} else if ( prev !== "*" && prev !== current ) {
+
+				// Seek a direct converter
+				conv = converters[ prev + " " + current ] || converters[ "* " + current ];
+
+				// If none found, seek a pair
+				if ( !conv ) {
+					for ( conv2 in converters ) {
+
+						// If conv2 outputs current
+						tmp = conv2.split( " " );
+						if ( tmp[ 1 ] === current ) {
+
+							// If prev can be converted to accepted input
+							conv = converters[ prev + " " + tmp[ 0 ] ] ||
+								converters[ "* " + tmp[ 0 ] ];
+							if ( conv ) {
+
+								// Condense equivalence converters
+								if ( conv === true ) {
+									conv = converters[ conv2 ];
+
+								// Otherwise, insert the intermediate dataType
+								} else if ( converters[ conv2 ] !== true ) {
+									current = tmp[ 0 ];
+									dataTypes.unshift( tmp[ 1 ] );
+								}
+								break;
+							}
+						}
+					}
+				}
+
+				// Apply converter (if not an equivalence)
+				if ( conv !== true ) {
+
+					// Unless errors are allowed to bubble, catch and return them
+					if ( conv && s.throws ) {
+						response = conv( response );
+					} else {
+						try {
+							response = conv( response );
+						} catch ( e ) {
+							return {
+								state: "parsererror",
+								error: conv ? e : "No conversion from " + prev + " to " + current
+							};
+						}
+					}
+				}
+			}
+		}
+	}
+
+	return { state: "success", data: response };
+}
+
+jQuery.extend( {
+
+	// Counter for holding the number of active queries
+	active: 0,
+
+	// Last-Modified header cache for next request
+	lastModified: {},
+	etag: {},
+
+	ajaxSettings: {
+		url: location.href,
+		type: "GET",
+		isLocal: rlocalProtocol.test( location.protocol ),
+		global: true,
+		processData: true,
+		async: true,
+		contentType: "application/x-www-form-urlencoded; charset=UTF-8",
+
+		/*
+		timeout: 0,
+		data: null,
+		dataType: null,
+		username: null,
+		password: null,
+		cache: null,
+		throws: false,
+		traditional: false,
+		headers: {},
+		*/
+
+		accepts: {
+			"*": allTypes,
+			text: "text/plain",
+			html: "text/html",
+			xml: "application/xml, text/xml",
+			json: "application/json, text/javascript"
+		},
+
+		contents: {
+			xml: /\bxml\b/,
+			html: /\bhtml/,
+			json: /\bjson\b/
+		},
+
+		responseFields: {
+			xml: "responseXML",
+			text: "responseText",
+			json: "responseJSON"
+		},
+
+		// Data converters
+		// Keys separate source (or catchall "*") and destination types with a single space
+		converters: {
+
+			// Convert anything to text
+			"* text": String,
+
+			// Text to html (true = no transformation)
+			"text html": true,
+
+			// Evaluate text as a json expression
+			"text json": JSON.parse,
+
+			// Parse text as xml
+			"text xml": jQuery.parseXML
+		},
+
+		// For options that shouldn't be deep extended:
+		// you can add your own custom options here if
+		// and when you create one that shouldn't be
+		// deep extended (see ajaxExtend)
+		flatOptions: {
+			url: true,
+			context: true
+		}
+	},
+
+	// Creates a full fledged settings object into target
+	// with both ajaxSettings and settings fields.
+	// If target is omitted, writes into ajaxSettings.
+	ajaxSetup: function( target, settings ) {
+		return settings ?
+
+			// Building a settings object
+			ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) :
+
+			// Extending ajaxSettings
+			ajaxExtend( jQuery.ajaxSettings, target );
+	},
+
+	ajaxPrefilter: addToPrefiltersOrTransports( prefilters ),
+	ajaxTransport: addToPrefiltersOrTransports( transports ),
+
+	// Main method
+	ajax: function( url, options ) {
+
+		// If url is an object, simulate pre-1.5 signature
+		if ( typeof url === "object" ) {
+			options = url;
+			url = undefined;
+		}
+
+		// Force options to be an object
+		options = options || {};
+
+		var transport,
+
+			// URL without anti-cache param
+			cacheURL,
+
+			// Response headers
+			responseHeadersString,
+			responseHeaders,
+
+			// timeout handle
+			timeoutTimer,
+
+			// Url cleanup var
+			urlAnchor,
+
+			// Request state (becomes false upon send and true upon completion)
+			completed,
+
+			// To know if global events are to be dispatched
+			fireGlobals,
+
+			// Loop variable
+			i,
+
+			// uncached part of the url
+			uncached,
+
+			// Create the final options object
+			s = jQuery.ajaxSetup( {}, options ),
+
+			// Callbacks context
+			callbackContext = s.context || s,
+
+			// Context for global events is callbackContext if it is a DOM node or jQuery collection
+			globalEventContext = s.context &&
+				( callbackContext.nodeType || callbackContext.jquery ) ?
+					jQuery( callbackContext ) :
+					jQuery.event,
+
+			// Deferreds
+			deferred = jQuery.Deferred(),
+			completeDeferred = jQuery.Callbacks( "once memory" ),
+
+			// Status-dependent callbacks
+			statusCode = s.statusCode || {},
+
+			// Headers (they are sent all at once)
+			requestHeaders = {},
+			requestHeadersNames = {},
+
+			// Default abort message
+			strAbort = "canceled",
+
+			// Fake xhr
+			jqXHR = {
+				readyState: 0,
+
+				// Builds headers hashtable if needed
+				getResponseHeader: function( key ) {
+					var match;
+					if ( completed ) {
+						if ( !responseHeaders ) {
+							responseHeaders = {};
+							while ( ( match = rheaders.exec( responseHeadersString ) ) ) {
+								responseHeaders[ match[ 1 ].toLowerCase() ] = match[ 2 ];
+							}
+						}
+						match = responseHeaders[ key.toLowerCase() ];
+					}
+					return match == null ? null : match;
+				},
+
+				// Raw string
+				getAllResponseHeaders: function() {
+					return completed ? responseHeadersString : null;
+				},
+
+				// Caches the header
+				setRequestHeader: function( name, value ) {
+					if ( completed == null ) {
+						name = requestHeadersNames[ name.toLowerCase() ] =
+							requestHeadersNames[ name.toLowerCase() ] || name;
+						requestHeaders[ name ] = value;
+					}
+					return this;
+				},
+
+				// Overrides response content-type header
+				overrideMimeType: function( type ) {
+					if ( completed == null ) {
+						s.mimeType = type;
+					}
+					return this;
+				},
+
+				// Status-dependent callbacks
+				statusCode: function( map ) {
+					var code;
+					if ( map ) {
+						if ( completed ) {
+
+							// Execute the appropriate callbacks
+							jqXHR.always( map[ jqXHR.status ] );
+						} else {
+
+							// Lazy-add the new callbacks in a way that preserves old ones
+							for ( code in map ) {
+								statusCode[ code ] = [ statusCode[ code ], map[ code ] ];
+							}
+						}
+					}
+					return this;
+				},
+
+				// Cancel the request
+				abort: function( statusText ) {
+					var finalText = statusText || strAbort;
+					if ( transport ) {
+						transport.abort( finalText );
+					}
+					done( 0, finalText );
+					return this;
+				}
+			};
+
+		// Attach deferreds
+		deferred.promise( jqXHR );
+
+		// Add protocol if not provided (prefilters might expect it)
+		// Handle falsy url in the settings object (#10093: consistency with old signature)
+		// We also use the url parameter if available
+		s.url = ( ( url || s.url || location.href ) + "" )
+			.replace( rprotocol, location.protocol + "//" );
+
+		// Alias method option to type as per ticket #12004
+		s.type = options.method || options.type || s.method || s.type;
+
+		// Extract dataTypes list
+		s.dataTypes = ( s.dataType || "*" ).toLowerCase().match( rnothtmlwhite ) || [ "" ];
+
+		// A cross-domain request is in order when the origin doesn't match the current origin.
+		if ( s.crossDomain == null ) {
+			urlAnchor = document.createElement( "a" );
+
+			// Support: IE <=8 - 11, Edge 12 - 15
+			// IE throws exception on accessing the href property if url is malformed,
+			// e.g. http://example.com:80x/
+			try {
+				urlAnchor.href = s.url;
+
+				// Support: IE <=8 - 11 only
+				// Anchor's host property isn't correctly set when s.url is relative
+				urlAnchor.href = urlAnchor.href;
+				s.crossDomain = originAnchor.protocol + "//" + originAnchor.host !==
+					urlAnchor.protocol + "//" + urlAnchor.host;
+			} catch ( e ) {
+
+				// If there is an error parsing the URL, assume it is crossDomain,
+				// it can be rejected by the transport if it is invalid
+				s.crossDomain = true;
+			}
+		}
+
+		// Convert data if not already a string
+		if ( s.data && s.processData && typeof s.data !== "string" ) {
+			s.data = jQuery.param( s.data, s.traditional );
+		}
+
+		// Apply prefilters
+		inspectPrefiltersOrTransports( prefilters, s, options, jqXHR );
+
+		// If request was aborted inside a prefilter, stop there
+		if ( completed ) {
+			return jqXHR;
+		}
+
+		// We can fire global events as of now if asked to
+		// Don't fire events if jQuery.event is undefined in an AMD-usage scenario (#15118)
+		fireGlobals = jQuery.event && s.global;
+
+		// Watch for a new set of requests
+		if ( fireGlobals && jQuery.active++ === 0 ) {
+			jQuery.event.trigger( "ajaxStart" );
+		}
+
+		// Uppercase the type
+		s.type = s.type.toUpperCase();
+
+		// Determine if request has content
+		s.hasContent = !rnoContent.test( s.type );
+
+		// Save the URL in case we're toying with the If-Modified-Since
+		// and/or If-None-Match header later on
+		// Remove hash to simplify url manipulation
+		cacheURL = s.url.replace( rhash, "" );
+
+		// More options handling for requests with no content
+		if ( !s.hasContent ) {
+
+			// Remember the hash so we can put it back
+			uncached = s.url.slice( cacheURL.length );
+
+			// If data is available and should be processed, append data to url
+			if ( s.data && ( s.processData || typeof s.data === "string" ) ) {
+				cacheURL += ( rquery.test( cacheURL ) ? "&" : "?" ) + s.data;
+
+				// #9682: remove data so that it's not used in an eventual retry
+				delete s.data;
+			}
+
+			// Add or update anti-cache param if needed
+			if ( s.cache === false ) {
+				cacheURL = cacheURL.replace( rantiCache, "$1" );
+				uncached = ( rquery.test( cacheURL ) ? "&" : "?" ) + "_=" + ( nonce++ ) + uncached;
+			}
+
+			// Put hash and anti-cache on the URL that will be requested (gh-1732)
+			s.url = cacheURL + uncached;
+
+		// Change '%20' to '+' if this is encoded form body content (gh-2658)
+		} else if ( s.data && s.processData &&
+			( s.contentType || "" ).indexOf( "application/x-www-form-urlencoded" ) === 0 ) {
+			s.data = s.data.replace( r20, "+" );
+		}
+
+		// Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode.
+		if ( s.ifModified ) {
+			if ( jQuery.lastModified[ cacheURL ] ) {
+				jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ cacheURL ] );
+			}
+			if ( jQuery.etag[ cacheURL ] ) {
+				jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ cacheURL ] );
+			}
+		}
+
+		// Set the correct header, if data is being sent
+		if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) {
+			jqXHR.setRequestHeader( "Content-Type", s.contentType );
+		}
+
+		// Set the Accepts header for the server, depending on the dataType
+		jqXHR.setRequestHeader(
+			"Accept",
+			s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[ 0 ] ] ?
+				s.accepts[ s.dataTypes[ 0 ] ] +
+					( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) :
+				s.accepts[ "*" ]
+		);
+
+		// Check for headers option
+		for ( i in s.headers ) {
+			jqXHR.setRequestHeader( i, s.headers[ i ] );
+		}
+
+		// Allow custom headers/mimetypes and early abort
+		if ( s.beforeSend &&
+			( s.beforeSend.call( callbackContext, jqXHR, s ) === false || completed ) ) {
+
+			// Abort if not done already and return
+			return jqXHR.abort();
+		}
+
+		// Aborting is no longer a cancellation
+		strAbort = "abort";
+
+		// Install callbacks on deferreds
+		completeDeferred.add( s.complete );
+		jqXHR.done( s.success );
+		jqXHR.fail( s.error );
+
+		// Get transport
+		transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR );
+
+		// If no transport, we auto-abort
+		if ( !transport ) {
+			done( -1, "No Transport" );
+		} else {
+			jqXHR.readyState = 1;
+
+			// Send global event
+			if ( fireGlobals ) {
+				globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] );
+			}
+
+			// If request was aborted inside ajaxSend, stop there
+			if ( completed ) {
+				return jqXHR;
+			}
+
+			// Timeout
+			if ( s.async && s.timeout > 0 ) {
+				timeoutTimer = window.setTimeout( function() {
+					jqXHR.abort( "timeout" );
+				}, s.timeout );
+			}
+
+			try {
+				completed = false;
+				transport.send( requestHeaders, done );
+			} catch ( e ) {
+
+				// Rethrow post-completion exceptions
+				if ( completed ) {
+					throw e;
+				}
+
+				// Propagate others as results
+				done( -1, e );
+			}
+		}
+
+		// Callback for when everything is done
+		function done( status, nativeStatusText, responses, headers ) {
+			var isSuccess, success, error, response, modified,
+				statusText = nativeStatusText;
+
+			// Ignore repeat invocations
+			if ( completed ) {
+				return;
+			}
+
+			completed = true;
+
+			// Clear timeout if it exists
+			if ( timeoutTimer ) {
+				window.clearTimeout( timeoutTimer );
+			}
+
+			// Dereference transport for early garbage collection
+			// (no matter how long the jqXHR object will be used)
+			transport = undefined;
+
+			// Cache response headers
+			responseHeadersString = headers || "";
+
+			// Set readyState
+			jqXHR.readyState = status > 0 ? 4 : 0;
+
+			// Determine if successful
+			isSuccess = status >= 200 && status < 300 || status === 304;
+
+			// Get response data
+			if ( responses ) {
+				response = ajaxHandleResponses( s, jqXHR, responses );
+			}
+
+			// Convert no matter what (that way responseXXX fields are always set)
+			response = ajaxConvert( s, response, jqXHR, isSuccess );
+
+			// If successful, handle type chaining
+			if ( isSuccess ) {
+
+				// Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode.
+				if ( s.ifModified ) {
+					modified = jqXHR.getResponseHeader( "Last-Modified" );
+					if ( modified ) {
+						jQuery.lastModified[ cacheURL ] = modified;
+					}
+					modified = jqXHR.getResponseHeader( "etag" );
+					if ( modified ) {
+						jQuery.etag[ cacheURL ] = modified;
+					}
+				}
+
+				// if no content
+				if ( status === 204 || s.type === "HEAD" ) {
+					statusText = "nocontent";
+
+				// if not modified
+				} else if ( status === 304 ) {
+					statusText = "notmodified";
+
+				// If we have data, let's convert it
+				} else {
+					statusText = response.state;
+					success = response.data;
+					error = response.error;
+					isSuccess = !error;
+				}
+			} else {
+
+				// Extract error from statusText and normalize for non-aborts
+				error = statusText;
+				if ( status || !statusText ) {
+					statusText = "error";
+					if ( status < 0 ) {
+						status = 0;
+					}
+				}
+			}
+
+			// Set data for the fake xhr object
+			jqXHR.status = status;
+			jqXHR.statusText = ( nativeStatusText || statusText ) + "";
+
+			// Success/Error
+			if ( isSuccess ) {
+				deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] );
+			} else {
+				deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] );
+			}
+
+			// Status-dependent callbacks
+			jqXHR.statusCode( statusCode );
+			statusCode = undefined;
+
+			if ( fireGlobals ) {
+				globalEventContext.trigger( isSuccess ? "ajaxSuccess" : "ajaxError",
+					[ jqXHR, s, isSuccess ? success : error ] );
+			}
+
+			// Complete
+			completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] );
+
+			if ( fireGlobals ) {
+				globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] );
+
+				// Handle the global AJAX counter
+				if ( !( --jQuery.active ) ) {
+					jQuery.event.trigger( "ajaxStop" );
+				}
+			}
+		}
+
+		return jqXHR;
+	},
+
+	getJSON: function( url, data, callback ) {
+		return jQuery.get( url, data, callback, "json" );
+	},
+
+	getScript: function( url, callback ) {
+		return jQuery.get( url, undefined, callback, "script" );
+	}
+} );
+
+jQuery.each( [ "get", "post" ], function( i, method ) {
+	jQuery[ method ] = function( url, data, callback, type ) {
+
+		// Shift arguments if data argument was omitted
+		if ( isFunction( data ) ) {
+			type = type || callback;
+			callback = data;
+			data = undefined;
+		}
+
+		// The url can be an options object (which then must have .url)
+		return jQuery.ajax( jQuery.extend( {
+			url: url,
+			type: method,
+			dataType: type,
+			data: data,
+			success: callback
+		}, jQuery.isPlainObject( url ) && url ) );
+	};
+} );
+
+
+jQuery._evalUrl = function( url ) {
+	return jQuery.ajax( {
+		url: url,
+
+		// Make this explicit, since user can override this through ajaxSetup (#11264)
+		type: "GET",
+		dataType: "script",
+		cache: true,
+		async: false,
+		global: false,
+		"throws": true
+	} );
+};
+
+
+jQuery.fn.extend( {
+	wrapAll: function( html ) {
+		var wrap;
+
+		if ( this[ 0 ] ) {
+			if ( isFunction( html ) ) {
+				html = html.call( this[ 0 ] );
+			}
+
+			// The elements to wrap the target around
+			wrap = jQuery( html, this[ 0 ].ownerDocument ).eq( 0 ).clone( true );
+
+			if ( this[ 0 ].parentNode ) {
+				wrap.insertBefore( this[ 0 ] );
+			}
+
+			wrap.map( function() {
+				var elem = this;
+
+				while ( elem.firstElementChild ) {
+					elem = elem.firstElementChild;
+				}
+
+				return elem;
+			} ).append( this );
+		}
+
+		return this;
+	},
+
+	wrapInner: function( html ) {
+		if ( isFunction( html ) ) {
+			return this.each( function( i ) {
+				jQuery( this ).wrapInner( html.call( this, i ) );
+			} );
+		}
+
+		return this.each( function() {
+			var self = jQuery( this ),
+				contents = self.contents();
+
+			if ( contents.length ) {
+				contents.wrapAll( html );
+
+			} else {
+				self.append( html );
+			}
+		} );
+	},
+
+	wrap: function( html ) {
+		var htmlIsFunction = isFunction( html );
+
+		return this.each( function( i ) {
+			jQuery( this ).wrapAll( htmlIsFunction ? html.call( this, i ) : html );
+		} );
+	},
+
+	unwrap: function( selector ) {
+		this.parent( selector ).not( "body" ).each( function() {
+			jQuery( this ).replaceWith( this.childNodes );
+		} );
+		return this;
+	}
+} );
+
+
+jQuery.expr.pseudos.hidden = function( elem ) {
+	return !jQuery.expr.pseudos.visible( elem );
+};
+jQuery.expr.pseudos.visible = function( elem ) {
+	return !!( elem.offsetWidth || elem.offsetHeight || elem.getClientRects().length );
+};
+
+
+
+
+jQuery.ajaxSettings.xhr = function() {
+	try {
+		return new window.XMLHttpRequest();
+	} catch ( e ) {}
+};
+
+var xhrSuccessStatus = {
+
+		// File protocol always yields status code 0, assume 200
+		0: 200,
+
+		// Support: IE <=9 only
+		// #1450: sometimes IE returns 1223 when it should be 204
+		1223: 204
+	},
+	xhrSupported = jQuery.ajaxSettings.xhr();
+
+support.cors = !!xhrSupported && ( "withCredentials" in xhrSupported );
+support.ajax = xhrSupported = !!xhrSupported;
+
+jQuery.ajaxTransport( function( options ) {
+	var callback, errorCallback;
+
+	// Cross domain only allowed if supported through XMLHttpRequest
+	if ( support.cors || xhrSupported && !options.crossDomain ) {
+		return {
+			send: function( headers, complete ) {
+				var i,
+					xhr = options.xhr();
+
+				xhr.open(
+					options.type,
+					options.url,
+					options.async,
+					options.username,
+					options.password
+				);
+
+				// Apply custom fields if provided
+				if ( options.xhrFields ) {
+					for ( i in options.xhrFields ) {
+						xhr[ i ] = options.xhrFields[ i ];
+					}
+				}
+
+				// Override mime type if needed
+				if ( options.mimeType && xhr.overrideMimeType ) {
+					xhr.overrideMimeType( options.mimeType );
+				}
+
+				// X-Requested-With header
+				// For cross-domain requests, seeing as conditions for a preflight are
+				// akin to a jigsaw puzzle, we simply never set it to be sure.
+				// (it can always be set on a per-request basis or even using ajaxSetup)
+				// For same-domain requests, won't change header if already provided.
+				if ( !options.crossDomain && !headers[ "X-Requested-With" ] ) {
+					headers[ "X-Requested-With" ] = "XMLHttpRequest";
+				}
+
+				// Set headers
+				for ( i in headers ) {
+					xhr.setRequestHeader( i, headers[ i ] );
+				}
+
+				// Callback
+				callback = function( type ) {
+					return function() {
+						if ( callback ) {
+							callback = errorCallback = xhr.onload =
+								xhr.onerror = xhr.onabort = xhr.ontimeout =
+									xhr.onreadystatechange = null;
+
+							if ( type === "abort" ) {
+								xhr.abort();
+							} else if ( type === "error" ) {
+
+								// Support: IE <=9 only
+								// On a manual native abort, IE9 throws
+								// errors on any property access that is not readyState
+								if ( typeof xhr.status !== "number" ) {
+									complete( 0, "error" );
+								} else {
+									complete(
+
+										// File: protocol always yields status 0; see #8605, #14207
+										xhr.status,
+										xhr.statusText
+									);
+								}
+							} else {
+								complete(
+									xhrSuccessStatus[ xhr.status ] || xhr.status,
+									xhr.statusText,
+
+									// Support: IE <=9 only
+									// IE9 has no XHR2 but throws on binary (trac-11426)
+									// For XHR2 non-text, let the caller handle it (gh-2498)
+									( xhr.responseType || "text" ) !== "text"  ||
+									typeof xhr.responseText !== "string" ?
+										{ binary: xhr.response } :
+										{ text: xhr.responseText },
+									xhr.getAllResponseHeaders()
+								);
+							}
+						}
+					};
+				};
+
+				// Listen to events
+				xhr.onload = callback();
+				errorCallback = xhr.onerror = xhr.ontimeout = callback( "error" );
+
+				// Support: IE 9 only
+				// Use onreadystatechange to replace onabort
+				// to handle uncaught aborts
+				if ( xhr.onabort !== undefined ) {
+					xhr.onabort = errorCallback;
+				} else {
+					xhr.onreadystatechange = function() {
+
+						// Check readyState before timeout as it changes
+						if ( xhr.readyState === 4 ) {
+
+							// Allow onerror to be called first,
+							// but that will not handle a native abort
+							// Also, save errorCallback to a variable
+							// as xhr.onerror cannot be accessed
+							window.setTimeout( function() {
+								if ( callback ) {
+									errorCallback();
+								}
+							} );
+						}
+					};
+				}
+
+				// Create the abort callback
+				callback = callback( "abort" );
+
+				try {
+
+					// Do send the request (this may raise an exception)
+					xhr.send( options.hasContent && options.data || null );
+				} catch ( e ) {
+
+					// #14683: Only rethrow if this hasn't been notified as an error yet
+					if ( callback ) {
+						throw e;
+					}
+				}
+			},
+
+			abort: function() {
+				if ( callback ) {
+					callback();
+				}
+			}
+		};
+	}
+} );
+
+
+
+
+// Prevent auto-execution of scripts when no explicit dataType was provided (See gh-2432)
+jQuery.ajaxPrefilter( function( s ) {
+	if ( s.crossDomain ) {
+		s.contents.script = false;
+	}
+} );
+
+// Install script dataType
+jQuery.ajaxSetup( {
+	accepts: {
+		script: "text/javascript, application/javascript, " +
+			"application/ecmascript, application/x-ecmascript"
+	},
+	contents: {
+		script: /\b(?:java|ecma)script\b/
+	},
+	converters: {
+		"text script": function( text ) {
+			jQuery.globalEval( text );
+			return text;
+		}
+	}
+} );
+
+// Handle cache's special case and crossDomain
+jQuery.ajaxPrefilter( "script", function( s ) {
+	if ( s.cache === undefined ) {
+		s.cache = false;
+	}
+	if ( s.crossDomain ) {
+		s.type = "GET";
+	}
+} );
+
+// Bind script tag hack transport
+jQuery.ajaxTransport( "script", function( s ) {
+
+	// This transport only deals with cross domain requests
+	if ( s.crossDomain ) {
+		var script, callback;
+		return {
+			send: function( _, complete ) {
+				script = jQuery( "<script>" ).prop( {
+					charset: s.scriptCharset,
+					src: s.url
+				} ).on(
+					"load error",
+					callback = function( evt ) {
+						script.remove();
+						callback = null;
+						if ( evt ) {
+							complete( evt.type === "error" ? 404 : 200, evt.type );
+						}
+					}
+				);
+
+				// Use native DOM manipulation to avoid our domManip AJAX trickery
+				document.head.appendChild( script[ 0 ] );
+			},
+			abort: function() {
+				if ( callback ) {
+					callback();
+				}
+			}
+		};
+	}
+} );
+
+
+
+
+var oldCallbacks = [],
+	rjsonp = /(=)\?(?=&|$)|\?\?/;
+
+// Default jsonp settings
+jQuery.ajaxSetup( {
+	jsonp: "callback",
+	jsonpCallback: function() {
+		var callback = oldCallbacks.pop() || ( jQuery.expando + "_" + ( nonce++ ) );
+		this[ callback ] = true;
+		return callback;
+	}
+} );
+
+// Detect, normalize options and install callbacks for jsonp requests
+jQuery.ajaxPrefilter( "json jsonp", function( s, originalSettings, jqXHR ) {
+
+	var callbackName, overwritten, responseContainer,
+		jsonProp = s.jsonp !== false && ( rjsonp.test( s.url ) ?
+			"url" :
+			typeof s.data === "string" &&
+				( s.contentType || "" )
+					.indexOf( "application/x-www-form-urlencoded" ) === 0 &&
+				rjsonp.test( s.data ) && "data"
+		);
+
+	// Handle iff the expected data type is "jsonp" or we have a parameter to set
+	if ( jsonProp || s.dataTypes[ 0 ] === "jsonp" ) {
+
+		// Get callback name, remembering preexisting value associated with it
+		callbackName = s.jsonpCallback = isFunction( s.jsonpCallback ) ?
+			s.jsonpCallback() :
+			s.jsonpCallback;
+
+		// Insert callback into url or form data
+		if ( jsonProp ) {
+			s[ jsonProp ] = s[ jsonProp ].replace( rjsonp, "$1" + callbackName );
+		} else if ( s.jsonp !== false ) {
+			s.url += ( rquery.test( s.url ) ? "&" : "?" ) + s.jsonp + "=" + callbackName;
+		}
+
+		// Use data converter to retrieve json after script execution
+		s.converters[ "script json" ] = function() {
+			if ( !responseContainer ) {
+				jQuery.error( callbackName + " was not called" );
+			}
+			return responseContainer[ 0 ];
+		};
+
+		// Force json dataType
+		s.dataTypes[ 0 ] = "json";
+
+		// Install callback
+		overwritten = window[ callbackName ];
+		window[ callbackName ] = function() {
+			responseContainer = arguments;
+		};
+
+		// Clean-up function (fires after converters)
+		jqXHR.always( function() {
+
+			// If previous value didn't exist - remove it
+			if ( overwritten === undefined ) {
+				jQuery( window ).removeProp( callbackName );
+
+			// Otherwise restore preexisting value
+			} else {
+				window[ callbackName ] = overwritten;
+			}
+
+			// Save back as free
+			if ( s[ callbackName ] ) {
+
+				// Make sure that re-using the options doesn't screw things around
+				s.jsonpCallback = originalSettings.jsonpCallback;
+
+				// Save the callback name for future use
+				oldCallbacks.push( callbackName );
+			}
+
+			// Call if it was a function and we have a response
+			if ( responseContainer && isFunction( overwritten ) ) {
+				overwritten( responseContainer[ 0 ] );
+			}
+
+			responseContainer = overwritten = undefined;
+		} );
+
+		// Delegate to script
+		return "script";
+	}
+} );
+
+
+
+
+// Support: Safari 8 only
+// In Safari 8 documents created via document.implementation.createHTMLDocument
+// collapse sibling forms: the second one becomes a child of the first one.
+// Because of that, this security measure has to be disabled in Safari 8.
+// https://bugs.webkit.org/show_bug.cgi?id=137337
+support.createHTMLDocument = ( function() {
+	var body = document.implementation.createHTMLDocument( "" ).body;
+	body.innerHTML = "<form></form><form></form>";
+	return body.childNodes.length === 2;
+} )();
+
+
+// Argument "data" should be string of html
+// context (optional): If specified, the fragment will be created in this context,
+// defaults to document
+// keepScripts (optional): If true, will include scripts passed in the html string
+jQuery.parseHTML = function( data, context, keepScripts ) {
+	if ( typeof data !== "string" ) {
+		return [];
+	}
+	if ( typeof context === "boolean" ) {
+		keepScripts = context;
+		context = false;
+	}
+
+	var base, parsed, scripts;
+
+	if ( !context ) {
+
+		// Stop scripts or inline event handlers from being executed immediately
+		// by using document.implementation
+		if ( support.createHTMLDocument ) {
+			context = document.implementation.createHTMLDocument( "" );
+
+			// Set the base href for the created document
+			// so any parsed elements with URLs
+			// are based on the document's URL (gh-2965)
+			base = context.createElement( "base" );
+			base.href = document.location.href;
+			context.head.appendChild( base );
+		} else {
+			context = document;
+		}
+	}
+
+	parsed = rsingleTag.exec( data );
+	scripts = !keepScripts && [];
+
+	// Single tag
+	if ( parsed ) {
+		return [ context.createElement( parsed[ 1 ] ) ];
+	}
+
+	parsed = buildFragment( [ data ], context, scripts );
+
+	if ( scripts && scripts.length ) {
+		jQuery( scripts ).remove();
+	}
+
+	return jQuery.merge( [], parsed.childNodes );
+};
+
+
+/**
+ * Load a url into a page
+ */
+jQuery.fn.load = function( url, params, callback ) {
+	var selector, type, response,
+		self = this,
+		off = url.indexOf( " " );
+
+	if ( off > -1 ) {
+		selector = stripAndCollapse( url.slice( off ) );
+		url = url.slice( 0, off );
+	}
+
+	// If it's a function
+	if ( isFunction( params ) ) {
+
+		// We assume that it's the callback
+		callback = params;
+		params = undefined;
+
+	// Otherwise, build a param string
+	} else if ( params && typeof params === "object" ) {
+		type = "POST";
+	}
+
+	// If we have elements to modify, make the request
+	if ( self.length > 0 ) {
+		jQuery.ajax( {
+			url: url,
+
+			// If "type" variable is undefined, then "GET" method will be used.
+			// Make value of this field explicit since
+			// user can override it through ajaxSetup method
+			type: type || "GET",
+			dataType: "html",
+			data: params
+		} ).done( function( responseText ) {
+
+			// Save response for use in complete callback
+			response = arguments;
+
+			self.html( selector ?
+
+				// If a selector was specified, locate the right elements in a dummy div
+				// Exclude scripts to avoid IE 'Permission Denied' errors
+				jQuery( "<div>" ).append( jQuery.parseHTML( responseText ) ).find( selector ) :
+
+				// Otherwise use the full result
+				responseText );
+
+		// If the request succeeds, this function gets "data", "status", "jqXHR"
+		// but they are ignored because response was set above.
+		// If it fails, this function gets "jqXHR", "status", "error"
+		} ).always( callback && function( jqXHR, status ) {
+			self.each( function() {
+				callback.apply( this, response || [ jqXHR.responseText, status, jqXHR ] );
+			} );
+		} );
+	}
+
+	return this;
+};
+
+
+
+
+// Attach a bunch of functions for handling common AJAX events
+jQuery.each( [
+	"ajaxStart",
+	"ajaxStop",
+	"ajaxComplete",
+	"ajaxError",
+	"ajaxSuccess",
+	"ajaxSend"
+], function( i, type ) {
+	jQuery.fn[ type ] = function( fn ) {
+		return this.on( type, fn );
+	};
+} );
+
+
+
+
+jQuery.expr.pseudos.animated = function( elem ) {
+	return jQuery.grep( jQuery.timers, function( fn ) {
+		return elem === fn.elem;
+	} ).length;
+};
+
+
+
+
+jQuery.offset = {
+	setOffset: function( elem, options, i ) {
+		var curPosition, curLeft, curCSSTop, curTop, curOffset, curCSSLeft, calculatePosition,
+			position = jQuery.css( elem, "position" ),
+			curElem = jQuery( elem ),
+			props = {};
+
+		// Set position first, in-case top/left are set even on static elem
+		if ( position === "static" ) {
+			elem.style.position = "relative";
+		}
+
+		curOffset = curElem.offset();
+		curCSSTop = jQuery.css( elem, "top" );
+		curCSSLeft = jQuery.css( elem, "left" );
+		calculatePosition = ( position === "absolute" || position === "fixed" ) &&
+			( curCSSTop + curCSSLeft ).indexOf( "auto" ) > -1;
+
+		// Need to be able to calculate position if either
+		// top or left is auto and position is either absolute or fixed
+		if ( calculatePosition ) {
+			curPosition = curElem.position();
+			curTop = curPosition.top;
+			curLeft = curPosition.left;
+
+		} else {
+			curTop = parseFloat( curCSSTop ) || 0;
+			curLeft = parseFloat( curCSSLeft ) || 0;
+		}
+
+		if ( isFunction( options ) ) {
+
+			// Use jQuery.extend here to allow modification of coordinates argument (gh-1848)
+			options = options.call( elem, i, jQuery.extend( {}, curOffset ) );
+		}
+
+		if ( options.top != null ) {
+			props.top = ( options.top - curOffset.top ) + curTop;
+		}
+		if ( options.left != null ) {
+			props.left = ( options.left - curOffset.left ) + curLeft;
+		}
+
+		if ( "using" in options ) {
+			options.using.call( elem, props );
+
+		} else {
+			curElem.css( props );
+		}
+	}
+};
+
+jQuery.fn.extend( {
+
+	// offset() relates an element's border box to the document origin
+	offset: function( options ) {
+
+		// Preserve chaining for setter
+		if ( arguments.length ) {
+			return options === undefined ?
+				this :
+				this.each( function( i ) {
+					jQuery.offset.setOffset( this, options, i );
+				} );
+		}
+
+		var rect, win,
+			elem = this[ 0 ];
+
+		if ( !elem ) {
+			return;
+		}
+
+		// Return zeros for disconnected and hidden (display: none) elements (gh-2310)
+		// Support: IE <=11 only
+		// Running getBoundingClientRect on a
+		// disconnected node in IE throws an error
+		if ( !elem.getClientRects().length ) {
+			return { top: 0, left: 0 };
+		}
+
+		// Get document-relative position by adding viewport scroll to viewport-relative gBCR
+		rect = elem.getBoundingClientRect();
+		win = elem.ownerDocument.defaultView;
+		return {
+			top: rect.top + win.pageYOffset,
+			left: rect.left + win.pageXOffset
+		};
+	},
+
+	// position() relates an element's margin box to its offset parent's padding box
+	// This corresponds to the behavior of CSS absolute positioning
+	position: function() {
+		if ( !this[ 0 ] ) {
+			return;
+		}
+
+		var offsetParent, offset, doc,
+			elem = this[ 0 ],
+			parentOffset = { top: 0, left: 0 };
+
+		// position:fixed elements are offset from the viewport, which itself always has zero offset
+		if ( jQuery.css( elem, "position" ) === "fixed" ) {
+
+			// Assume position:fixed implies availability of getBoundingClientRect
+			offset = elem.getBoundingClientRect();
+
+		} else {
+			offset = this.offset();
+
+			// Account for the *real* offset parent, which can be the document or its root element
+			// when a statically positioned element is identified
+			doc = elem.ownerDocument;
+			offsetParent = elem.offsetParent || doc.documentElement;
+			while ( offsetParent &&
+				( offsetParent === doc.body || offsetParent === doc.documentElement ) &&
+				jQuery.css( offsetParent, "position" ) === "static" ) {
+
+				offsetParent = offsetParent.parentNode;
+			}
+			if ( offsetParent && offsetParent !== elem && offsetParent.nodeType === 1 ) {
+
+				// Incorporate borders into its offset, since they are outside its content origin
+				parentOffset = jQuery( offsetParent ).offset();
+				parentOffset.top += jQuery.css( offsetParent, "borderTopWidth", true );
+				parentOffset.left += jQuery.css( offsetParent, "borderLeftWidth", true );
+			}
+		}
+
+		// Subtract parent offsets and element margins
+		return {
+			top: offset.top - parentOffset.top - jQuery.css( elem, "marginTop", true ),
+			left: offset.left - parentOffset.left - jQuery.css( elem, "marginLeft", true )
+		};
+	},
+
+	// This method will return documentElement in the following cases:
+	// 1) For the element inside the iframe without offsetParent, this method will return
+	//    documentElement of the parent window
+	// 2) For the hidden or detached element
+	// 3) For body or html element, i.e. in case of the html node - it will return itself
+	//
+	// but those exceptions were never presented as a real life use-cases
+	// and might be considered as more preferable results.
+	//
+	// This logic, however, is not guaranteed and can change at any point in the future
+	offsetParent: function() {
+		return this.map( function() {
+			var offsetParent = this.offsetParent;
+
+			while ( offsetParent && jQuery.css( offsetParent, "position" ) === "static" ) {
+				offsetParent = offsetParent.offsetParent;
+			}
+
+			return offsetParent || documentElement;
+		} );
+	}
+} );
+
+// Create scrollLeft and scrollTop methods
+jQuery.each( { scrollLeft: "pageXOffset", scrollTop: "pageYOffset" }, function( method, prop ) {
+	var top = "pageYOffset" === prop;
+
+	jQuery.fn[ method ] = function( val ) {
+		return access( this, function( elem, method, val ) {
+
+			// Coalesce documents and windows
+			var win;
+			if ( isWindow( elem ) ) {
+				win = elem;
+			} else if ( elem.nodeType === 9 ) {
+				win = elem.defaultView;
+			}
+
+			if ( val === undefined ) {
+				return win ? win[ prop ] : elem[ method ];
+			}
+
+			if ( win ) {
+				win.scrollTo(
+					!top ? val : win.pageXOffset,
+					top ? val : win.pageYOffset
+				);
+
+			} else {
+				elem[ method ] = val;
+			}
+		}, method, val, arguments.length );
+	};
+} );
+
+// Support: Safari <=7 - 9.1, Chrome <=37 - 49
+// Add the top/left cssHooks using jQuery.fn.position
+// Webkit bug: https://bugs.webkit.org/show_bug.cgi?id=29084
+// Blink bug: https://bugs.chromium.org/p/chromium/issues/detail?id=589347
+// getComputedStyle returns percent when specified for top/left/bottom/right;
+// rather than make the css module depend on the offset module, just check for it here
+jQuery.each( [ "top", "left" ], function( i, prop ) {
+	jQuery.cssHooks[ prop ] = addGetHookIf( support.pixelPosition,
+		function( elem, computed ) {
+			if ( computed ) {
+				computed = curCSS( elem, prop );
+
+				// If curCSS returns percentage, fallback to offset
+				return rnumnonpx.test( computed ) ?
+					jQuery( elem ).position()[ prop ] + "px" :
+					computed;
+			}
+		}
+	);
+} );
+
+
+// Create innerHeight, innerWidth, height, width, outerHeight and outerWidth methods
+jQuery.each( { Height: "height", Width: "width" }, function( name, type ) {
+	jQuery.each( { padding: "inner" + name, content: type, "": "outer" + name },
+		function( defaultExtra, funcName ) {
+
+		// Margin is only for outerHeight, outerWidth
+		jQuery.fn[ funcName ] = function( margin, value ) {
+			var chainable = arguments.length && ( defaultExtra || typeof margin !== "boolean" ),
+				extra = defaultExtra || ( margin === true || value === true ? "margin" : "border" );
+
+			return access( this, function( elem, type, value ) {
+				var doc;
+
+				if ( isWindow( elem ) ) {
+
+					// $( window ).outerWidth/Height return w/h including scrollbars (gh-1729)
+					return funcName.indexOf( "outer" ) === 0 ?
+						elem[ "inner" + name ] :
+						elem.document.documentElement[ "client" + name ];
+				}
+
+				// Get document width or height
+				if ( elem.nodeType === 9 ) {
+					doc = elem.documentElement;
+
+					// Either scroll[Width/Height] or offset[Width/Height] or client[Width/Height],
+					// whichever is greatest
+					return Math.max(
+						elem.body[ "scroll" + name ], doc[ "scroll" + name ],
+						elem.body[ "offset" + name ], doc[ "offset" + name ],
+						doc[ "client" + name ]
+					);
+				}
+
+				return value === undefined ?
+
+					// Get width or height on the element, requesting but not forcing parseFloat
+					jQuery.css( elem, type, extra ) :
+
+					// Set width or height on the element
+					jQuery.style( elem, type, value, extra );
+			}, type, chainable ? margin : undefined, chainable );
+		};
+	} );
+} );
+
+
+jQuery.each( ( "blur focus focusin focusout resize scroll click dblclick " +
+	"mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave " +
+	"change select submit keydown keypress keyup contextmenu" ).split( " " ),
+	function( i, name ) {
+
+	// Handle event binding
+	jQuery.fn[ name ] = function( data, fn ) {
+		return arguments.length > 0 ?
+			this.on( name, null, data, fn ) :
+			this.trigger( name );
+	};
+} );
+
+jQuery.fn.extend( {
+	hover: function( fnOver, fnOut ) {
+		return this.mouseenter( fnOver ).mouseleave( fnOut || fnOver );
+	}
+} );
+
+
+
+
+jQuery.fn.extend( {
+
+	bind: function( types, data, fn ) {
+		return this.on( types, null, data, fn );
+	},
+	unbind: function( types, fn ) {
+		return this.off( types, null, fn );
+	},
+
+	delegate: function( selector, types, data, fn ) {
+		return this.on( types, selector, data, fn );
+	},
+	undelegate: function( selector, types, fn ) {
+
+		// ( namespace ) or ( selector, types [, fn] )
+		return arguments.length === 1 ?
+			this.off( selector, "**" ) :
+			this.off( types, selector || "**", fn );
+	}
+} );
+
+// Bind a function to a context, optionally partially applying any
+// arguments.
+// jQuery.proxy is deprecated to promote standards (specifically Function#bind)
+// However, it is not slated for removal any time soon
+jQuery.proxy = function( fn, context ) {
+	var tmp, args, proxy;
+
+	if ( typeof context === "string" ) {
+		tmp = fn[ context ];
+		context = fn;
+		fn = tmp;
+	}
+
+	// Quick check to determine if target is callable, in the spec
+	// this throws a TypeError, but we will just return undefined.
+	if ( !isFunction( fn ) ) {
+		return undefined;
+	}
+
+	// Simulated bind
+	args = slice.call( arguments, 2 );
+	proxy = function() {
+		return fn.apply( context || this, args.concat( slice.call( arguments ) ) );
+	};
+
+	// Set the guid of unique handler to the same of original handler, so it can be removed
+	proxy.guid = fn.guid = fn.guid || jQuery.guid++;
+
+	return proxy;
+};
+
+jQuery.holdReady = function( hold ) {
+	if ( hold ) {
+		jQuery.readyWait++;
+	} else {
+		jQuery.ready( true );
+	}
+};
+jQuery.isArray = Array.isArray;
+jQuery.parseJSON = JSON.parse;
+jQuery.nodeName = nodeName;
+jQuery.isFunction = isFunction;
+jQuery.isWindow = isWindow;
+jQuery.camelCase = camelCase;
+jQuery.type = toType;
+
+jQuery.now = Date.now;
+
+jQuery.isNumeric = function( obj ) {
+
+	// As of jQuery 3.0, isNumeric is limited to
+	// strings and numbers (primitives or objects)
+	// that can be coerced to finite numbers (gh-2662)
+	var type = jQuery.type( obj );
+	return ( type === "number" || type === "string" ) &&
+
+		// parseFloat NaNs numeric-cast false positives ("")
+		// ...but misinterprets leading-number strings, particularly hex literals ("0x...")
+		// subtraction forces infinities to NaN
+		!isNaN( obj - parseFloat( obj ) );
+};
+
+
+
+
+// Register as a named AMD module, since jQuery can be concatenated with other
+// files that may use define, but not via a proper concatenation script that
+// understands anonymous AMD modules. A named AMD is safest and most robust
+// way to register. Lowercase jquery is used because AMD module names are
+// derived from file names, and jQuery is normally delivered in a lowercase
+// file name. Do this after creating the global so that if an AMD module wants
+// to call noConflict to hide this version of jQuery, it will work.
+
+// Note that for maximum portability, libraries that are not jQuery should
+// declare themselves as anonymous modules, and avoid setting a global if an
+// AMD loader is present. jQuery is a special case. For more information, see
+// https://github.com/jrburke/requirejs/wiki/Updating-existing-libraries#wiki-anon
+
+if ( typeof define === "function" && define.amd ) {
+	define( "jquery", [], function() {
+		return jQuery;
+	} );
+}
+
+
+
+
+var
+
+	// Map over jQuery in case of overwrite
+	_jQuery = window.jQuery,
+
+	// Map over the $ in case of overwrite
+	_$ = window.$;
+
+jQuery.noConflict = function( deep ) {
+	if ( window.$ === jQuery ) {
+		window.$ = _$;
+	}
+
+	if ( deep && window.jQuery === jQuery ) {
+		window.jQuery = _jQuery;
+	}
+
+	return jQuery;
+};
+
+// Expose jQuery and $ identifiers, even in AMD
+// (#7102#comment:10, https://github.com/jquery/jquery/pull/557)
+// and CommonJS for browser emulators (#13566)
+if ( !noGlobal ) {
+	window.jQuery = window.$ = jQuery;
+}
+
+
+
+
+return jQuery;
+} );
diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-migrate-3.0.1.js b/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-migrate-3.0.1.js
new file mode 100644
index 0000000000..6c1d4ff282
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-migrate-3.0.1.js
@@ -0,0 +1,628 @@
+/*!
+ * jQuery Migrate - v3.0.1 - 2017-09-26
+ * Copyright jQuery Foundation and other contributors
+ */
+;( function( factory ) {
+	if ( typeof define === "function" && define.amd ) {
+
+		// AMD. Register as an anonymous module.
+		define( [ "jquery" ], window, factory );
+	} else if ( typeof module === "object" && module.exports ) {
+
+		// Node/CommonJS
+		// eslint-disable-next-line no-undef
+		module.exports = factory( require( "jquery" ), window );
+	} else {
+
+		// Browser globals
+		factory( jQuery, window );
+	}
+} )( function( jQuery, window ) {
+"use strict";
+
+
+jQuery.migrateVersion = "3.0.1";
+
+jQuery.migrateMute = true;
+
+/* exported migrateWarn, migrateWarnFunc, migrateWarnProp */
+
+( function() {
+
+	var rbadVersions = /^[12]\./;
+
+	// Support: IE9 only
+	// IE9 only creates console object when dev tools are first opened
+	// IE9 console is a host object, callable but doesn't have .apply()
+	if ( !window.console || !window.console.log ) {
+		return;
+	}
+
+	// Need jQuery 3.0.0+ and no older Migrate loaded
+	if ( !jQuery || rbadVersions.test( jQuery.fn.jquery ) ) {
+		window.console.log( "JQMIGRATE: jQuery 3.0.0+ REQUIRED" );
+	}
+	if ( jQuery.migrateWarnings ) {
+		window.console.log( "JQMIGRATE: Migrate plugin loaded multiple times" );
+	}
+
+	// Show a message on the console so devs know we're active
+	window.console.log( "JQMIGRATE: Migrate is installed" +
+		( jQuery.migrateMute ? "" : " with logging active" ) +
+		", version " + jQuery.migrateVersion );
+
+} )();
+
+var warnedAbout = {};
+
+// List of warnings already given; public read only
+jQuery.migrateWarnings = [];
+
+// Set to false to disable traces that appear with warnings
+if ( jQuery.migrateTrace === undefined ) {
+	jQuery.migrateTrace = true;
+}
+
+// Forget any warnings we've already given; public
+jQuery.migrateReset = function() {
+	warnedAbout = {};
+	jQuery.migrateWarnings.length = 0;
+};
+
+function migrateWarn( msg ) {
+	var console = window.console;
+	if ( !warnedAbout[ msg ] ) {
+		warnedAbout[ msg ] = true;
+		jQuery.migrateWarnings.push( msg );
+		if ( console && console.warn && !jQuery.migrateMute ) {
+			console.warn( "JQMIGRATE: " + msg );
+			if ( jQuery.migrateTrace && console.trace ) {
+				console.trace();
+			}
+		}
+	}
+}
+
+function migrateWarnProp( obj, prop, value, msg ) {
+	Object.defineProperty( obj, prop, {
+		configurable: true,
+		enumerable: true,
+		get: function() {
+			migrateWarn( msg );
+			return value;
+		},
+		set: function( newValue ) {
+			migrateWarn( msg );
+			value = newValue;
+		}
+	} );
+}
+
+function migrateWarnFunc( obj, prop, newFunc, msg ) {
+	obj[ prop ] = function() {
+		migrateWarn( msg );
+		return newFunc.apply( this, arguments );
+	};
+}
+
+if ( window.document.compatMode === "BackCompat" ) {
+
+	// JQuery has never supported or tested Quirks Mode
+	migrateWarn( "jQuery is not compatible with Quirks Mode" );
+}
+
+
+var oldInit = jQuery.fn.init,
+	oldIsNumeric = jQuery.isNumeric,
+	oldFind = jQuery.find,
+	rattrHashTest = /\[(\s*[-\w]+\s*)([~|^$*]?=)\s*([-\w#]*?#[-\w#]*)\s*\]/,
+	rattrHashGlob = /\[(\s*[-\w]+\s*)([~|^$*]?=)\s*([-\w#]*?#[-\w#]*)\s*\]/g;
+
+jQuery.fn.init = function( arg1 ) {
+	var args = Array.prototype.slice.call( arguments );
+
+	if ( typeof arg1 === "string" && arg1 === "#" ) {
+
+		// JQuery( "#" ) is a bogus ID selector, but it returned an empty set before jQuery 3.0
+		migrateWarn( "jQuery( '#' ) is not a valid selector" );
+		args[ 0 ] = [];
+	}
+
+	return oldInit.apply( this, args );
+};
+jQuery.fn.init.prototype = jQuery.fn;
+
+jQuery.find = function( selector ) {
+	var args = Array.prototype.slice.call( arguments );
+
+	// Support: PhantomJS 1.x
+	// String#match fails to match when used with a //g RegExp, only on some strings
+	if ( typeof selector === "string" && rattrHashTest.test( selector ) ) {
+
+		// The nonstandard and undocumented unquoted-hash was removed in jQuery 1.12.0
+		// First see if qS thinks it's a valid selector, if so avoid a false positive
+		try {
+			window.document.querySelector( selector );
+		} catch ( err1 ) {
+
+			// Didn't *look* valid to qSA, warn and try quoting what we think is the value
+			selector = selector.replace( rattrHashGlob, function( _, attr, op, value ) {
+				return "[" + attr + op + "\"" + value + "\"]";
+			} );
+
+			// If the regexp *may* have created an invalid selector, don't update it
+			// Note that there may be false alarms if selector uses jQuery extensions
+			try {
+				window.document.querySelector( selector );
+				migrateWarn( "Attribute selector with '#' must be quoted: " + args[ 0 ] );
+				args[ 0 ] = selector;
+			} catch ( err2 ) {
+				migrateWarn( "Attribute selector with '#' was not fixed: " + args[ 0 ] );
+			}
+		}
+	}
+
+	return oldFind.apply( this, args );
+};
+
+// Copy properties attached to original jQuery.find method (e.g. .attr, .isXML)
+var findProp;
+for ( findProp in oldFind ) {
+	if ( Object.prototype.hasOwnProperty.call( oldFind, findProp ) ) {
+		jQuery.find[ findProp ] = oldFind[ findProp ];
+	}
+}
+
+// The number of elements contained in the matched element set
+jQuery.fn.size = function() {
+	migrateWarn( "jQuery.fn.size() is deprecated and removed; use the .length property" );
+	return this.length;
+};
+
+jQuery.parseJSON = function() {
+	migrateWarn( "jQuery.parseJSON is deprecated; use JSON.parse" );
+	return JSON.parse.apply( null, arguments );
+};
+
+jQuery.isNumeric = function( val ) {
+
+	// The jQuery 2.2.3 implementation of isNumeric
+	function isNumeric2( obj ) {
+		var realStringObj = obj && obj.toString();
+		return !jQuery.isArray( obj ) && ( realStringObj - parseFloat( realStringObj ) + 1 ) >= 0;
+	}
+
+	var newValue = oldIsNumeric( val ),
+		oldValue = isNumeric2( val );
+
+	if ( newValue !== oldValue ) {
+		migrateWarn( "jQuery.isNumeric() should not be called on constructed objects" );
+	}
+
+	return oldValue;
+};
+
+migrateWarnFunc( jQuery, "holdReady", jQuery.holdReady,
+	"jQuery.holdReady is deprecated" );
+
+migrateWarnFunc( jQuery, "unique", jQuery.uniqueSort,
+	"jQuery.unique is deprecated; use jQuery.uniqueSort" );
+
+// Now jQuery.expr.pseudos is the standard incantation
+migrateWarnProp( jQuery.expr, "filters", jQuery.expr.pseudos,
+	"jQuery.expr.filters is deprecated; use jQuery.expr.pseudos" );
+migrateWarnProp( jQuery.expr, ":", jQuery.expr.pseudos,
+	"jQuery.expr[':'] is deprecated; use jQuery.expr.pseudos" );
+
+
+var oldAjax = jQuery.ajax;
+
+jQuery.ajax = function( ) {
+	var jQXHR = oldAjax.apply( this, arguments );
+
+	// Be sure we got a jQXHR (e.g., not sync)
+	if ( jQXHR.promise ) {
+		migrateWarnFunc( jQXHR, "success", jQXHR.done,
+			"jQXHR.success is deprecated and removed" );
+		migrateWarnFunc( jQXHR, "error", jQXHR.fail,
+			"jQXHR.error is deprecated and removed" );
+		migrateWarnFunc( jQXHR, "complete", jQXHR.always,
+			"jQXHR.complete is deprecated and removed" );
+	}
+
+	return jQXHR;
+};
+
+
+var oldRemoveAttr = jQuery.fn.removeAttr,
+	oldToggleClass = jQuery.fn.toggleClass,
+	rmatchNonSpace = /\S+/g;
+
+jQuery.fn.removeAttr = function( name ) {
+	var self = this;
+
+	jQuery.each( name.match( rmatchNonSpace ), function( i, attr ) {
+		if ( jQuery.expr.match.bool.test( attr ) ) {
+			migrateWarn( "jQuery.fn.removeAttr no longer sets boolean properties: " + attr );
+			self.prop( attr, false );
+		}
+	} );
+
+	return oldRemoveAttr.apply( this, arguments );
+};
+
+jQuery.fn.toggleClass = function( state ) {
+
+	// Only deprecating no-args or single boolean arg
+	if ( state !== undefined && typeof state !== "boolean" ) {
+		return oldToggleClass.apply( this, arguments );
+	}
+
+	migrateWarn( "jQuery.fn.toggleClass( boolean ) is deprecated" );
+
+	// Toggle entire class name of each element
+	return this.each( function() {
+		var className = this.getAttribute && this.getAttribute( "class" ) || "";
+
+		if ( className ) {
+			jQuery.data( this, "__className__", className );
+		}
+
+		// If the element has a class name or if we're passed `false`,
+		// then remove the whole classname (if there was one, the above saved it).
+		// Otherwise bring back whatever was previously saved (if anything),
+		// falling back to the empty string if nothing was stored.
+		if ( this.setAttribute ) {
+			this.setAttribute( "class",
+				className || state === false ?
+				"" :
+				jQuery.data( this, "__className__" ) || ""
+			);
+		}
+	} );
+};
+
+
+var internalSwapCall = false;
+
+// If this version of jQuery has .swap(), don't false-alarm on internal uses
+if ( jQuery.swap ) {
+	jQuery.each( [ "height", "width", "reliableMarginRight" ], function( _, name ) {
+		var oldHook = jQuery.cssHooks[ name ] && jQuery.cssHooks[ name ].get;
+
+		if ( oldHook ) {
+			jQuery.cssHooks[ name ].get = function() {
+				var ret;
+
+				internalSwapCall = true;
+				ret = oldHook.apply( this, arguments );
+				internalSwapCall = false;
+				return ret;
+			};
+		}
+	} );
+}
+
+jQuery.swap = function( elem, options, callback, args ) {
+	var ret, name,
+		old = {};
+
+	if ( !internalSwapCall ) {
+		migrateWarn( "jQuery.swap() is undocumented and deprecated" );
+	}
+
+	// Remember the old values, and insert the new ones
+	for ( name in options ) {
+		old[ name ] = elem.style[ name ];
+		elem.style[ name ] = options[ name ];
+	}
+
+	ret = callback.apply( elem, args || [] );
+
+	// Revert the old values
+	for ( name in options ) {
+		elem.style[ name ] = old[ name ];
+	}
+
+	return ret;
+};
+
+var oldData = jQuery.data;
+
+jQuery.data = function( elem, name, value ) {
+	var curData;
+
+	// Name can be an object, and each entry in the object is meant to be set as data
+	if ( name && typeof name === "object" && arguments.length === 2 ) {
+		curData = jQuery.hasData( elem ) && oldData.call( this, elem );
+		var sameKeys = {};
+		for ( var key in name ) {
+			if ( key !== jQuery.camelCase( key ) ) {
+				migrateWarn( "jQuery.data() always sets/gets camelCased names: " + key );
+				curData[ key ] = name[ key ];
+			} else {
+				sameKeys[ key ] = name[ key ];
+			}
+		}
+
+		oldData.call( this, elem, sameKeys );
+
+		return name;
+	}
+
+	// If the name is transformed, look for the un-transformed name in the data object
+	if ( name && typeof name === "string" && name !== jQuery.camelCase( name ) ) {
+		curData = jQuery.hasData( elem ) && oldData.call( this, elem );
+		if ( curData && name in curData ) {
+			migrateWarn( "jQuery.data() always sets/gets camelCased names: " + name );
+			if ( arguments.length > 2 ) {
+				curData[ name ] = value;
+			}
+			return curData[ name ];
+		}
+	}
+
+	return oldData.apply( this, arguments );
+};
+
+var oldTweenRun = jQuery.Tween.prototype.run;
+var linearEasing = function( pct ) {
+		return pct;
+	};
+
+jQuery.Tween.prototype.run = function( ) {
+	if ( jQuery.easing[ this.easing ].length > 1 ) {
+		migrateWarn(
+			"'jQuery.easing." + this.easing.toString() + "' should use only one argument"
+		);
+
+		jQuery.easing[ this.easing ] = linearEasing;
+	}
+
+	oldTweenRun.apply( this, arguments );
+};
+
+jQuery.fx.interval = jQuery.fx.interval || 13;
+
+// Support: IE9, Android <=4.4
+// Avoid false positives on browsers that lack rAF
+if ( window.requestAnimationFrame ) {
+	migrateWarnProp( jQuery.fx, "interval", jQuery.fx.interval,
+		"jQuery.fx.interval is deprecated" );
+}
+
+var oldLoad = jQuery.fn.load,
+	oldEventAdd = jQuery.event.add,
+	originalFix = jQuery.event.fix;
+
+jQuery.event.props = [];
+jQuery.event.fixHooks = {};
+
+migrateWarnProp( jQuery.event.props, "concat", jQuery.event.props.concat,
+	"jQuery.event.props.concat() is deprecated and removed" );
+
+jQuery.event.fix = function( originalEvent ) {
+	var event,
+		type = originalEvent.type,
+		fixHook = this.fixHooks[ type ],
+		props = jQuery.event.props;
+
+	if ( props.length ) {
+		migrateWarn( "jQuery.event.props are deprecated and removed: " + props.join() );
+		while ( props.length ) {
+			jQuery.event.addProp( props.pop() );
+		}
+	}
+
+	if ( fixHook && !fixHook._migrated_ ) {
+		fixHook._migrated_ = true;
+		migrateWarn( "jQuery.event.fixHooks are deprecated and removed: " + type );
+		if ( ( props = fixHook.props ) && props.length ) {
+			while ( props.length ) {
+				jQuery.event.addProp( props.pop() );
+			}
+		}
+	}
+
+	event = originalFix.call( this, originalEvent );
+
+	return fixHook && fixHook.filter ? fixHook.filter( event, originalEvent ) : event;
+};
+
+jQuery.event.add = function( elem, types ) {
+
+	// This misses the multiple-types case but that seems awfully rare
+	if ( elem === window && types === "load" && window.document.readyState === "complete" ) {
+		migrateWarn( "jQuery(window).on('load'...) called after load event occurred" );
+	}
+	return oldEventAdd.apply( this, arguments );
+};
+
+jQuery.each( [ "load", "unload", "error" ], function( _, name ) {
+
+	jQuery.fn[ name ] = function() {
+		var args = Array.prototype.slice.call( arguments, 0 );
+
+		// If this is an ajax load() the first arg should be the string URL;
+		// technically this could also be the "Anything" arg of the event .load()
+		// which just goes to show why this dumb signature has been deprecated!
+		// jQuery custom builds that exclude the Ajax module justifiably die here.
+		if ( name === "load" && typeof args[ 0 ] === "string" ) {
+			return oldLoad.apply( this, args );
+		}
+
+		migrateWarn( "jQuery.fn." + name + "() is deprecated" );
+
+		args.splice( 0, 0, name );
+		if ( arguments.length ) {
+			return this.on.apply( this, args );
+		}
+
+		// Use .triggerHandler here because:
+		// - load and unload events don't need to bubble, only applied to window or image
+		// - error event should not bubble to window, although it does pre-1.7
+		// See http://bugs.jquery.com/ticket/11820
+		this.triggerHandler.apply( this, args );
+		return this;
+	};
+
+} );
+
+jQuery.each( ( "blur focus focusin focusout resize scroll click dblclick " +
+	"mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave " +
+	"change select submit keydown keypress keyup contextmenu" ).split( " " ),
+	function( i, name ) {
+
+	// Handle event binding
+	jQuery.fn[ name ] = function( data, fn ) {
+		migrateWarn( "jQuery.fn." + name + "() event shorthand is deprecated" );
+		return arguments.length > 0 ?
+			this.on( name, null, data, fn ) :
+			this.trigger( name );
+	};
+} );
+
+// Trigger "ready" event only once, on document ready
+jQuery( function() {
+	jQuery( window.document ).triggerHandler( "ready" );
+} );
+
+jQuery.event.special.ready = {
+	setup: function() {
+		if ( this === window.document ) {
+			migrateWarn( "'ready' event is deprecated" );
+		}
+	}
+};
+
+jQuery.fn.extend( {
+
+	bind: function( types, data, fn ) {
+		migrateWarn( "jQuery.fn.bind() is deprecated" );
+		return this.on( types, null, data, fn );
+	},
+	unbind: function( types, fn ) {
+		migrateWarn( "jQuery.fn.unbind() is deprecated" );
+		return this.off( types, null, fn );
+	},
+	delegate: function( selector, types, data, fn ) {
+		migrateWarn( "jQuery.fn.delegate() is deprecated" );
+		return this.on( types, selector, data, fn );
+	},
+	undelegate: function( selector, types, fn ) {
+		migrateWarn( "jQuery.fn.undelegate() is deprecated" );
+		return arguments.length === 1 ?
+			this.off( selector, "**" ) :
+			this.off( types, selector || "**", fn );
+	},
+	hover: function( fnOver, fnOut ) {
+		migrateWarn( "jQuery.fn.hover() is deprecated" );
+		return this.on( "mouseenter", fnOver ).on( "mouseleave", fnOut || fnOver );
+	}
+} );
+
+
+var oldOffset = jQuery.fn.offset;
+
+jQuery.fn.offset = function() {
+	var docElem,
+		elem = this[ 0 ],
+		origin = { top: 0, left: 0 };
+
+	if ( !elem || !elem.nodeType ) {
+		migrateWarn( "jQuery.fn.offset() requires a valid DOM element" );
+		return origin;
+	}
+
+	docElem = ( elem.ownerDocument || window.document ).documentElement;
+	if ( !jQuery.contains( docElem, elem ) ) {
+		migrateWarn( "jQuery.fn.offset() requires an element connected to a document" );
+		return origin;
+	}
+
+	return oldOffset.apply( this, arguments );
+};
+
+
+var oldParam = jQuery.param;
+
+jQuery.param = function( data, traditional ) {
+	var ajaxTraditional = jQuery.ajaxSettings && jQuery.ajaxSettings.traditional;
+
+	if ( traditional === undefined && ajaxTraditional ) {
+
+		migrateWarn( "jQuery.param() no longer uses jQuery.ajaxSettings.traditional" );
+		traditional = ajaxTraditional;
+	}
+
+	return oldParam.call( this, data, traditional );
+};
+
+var oldSelf = jQuery.fn.andSelf || jQuery.fn.addBack;
+
+jQuery.fn.andSelf = function() {
+	migrateWarn( "jQuery.fn.andSelf() is deprecated and removed, use jQuery.fn.addBack()" );
+	return oldSelf.apply( this, arguments );
+};
+
+
+var oldDeferred = jQuery.Deferred,
+	tuples = [
+
+		// Action, add listener, callbacks, .then handlers, final state
+		[ "resolve", "done", jQuery.Callbacks( "once memory" ),
+			jQuery.Callbacks( "once memory" ), "resolved" ],
+		[ "reject", "fail", jQuery.Callbacks( "once memory" ),
+			jQuery.Callbacks( "once memory" ), "rejected" ],
+		[ "notify", "progress", jQuery.Callbacks( "memory" ),
+			jQuery.Callbacks( "memory" ) ]
+	];
+
+jQuery.Deferred = function( func ) {
+	var deferred = oldDeferred(),
+		promise = deferred.promise();
+
+	deferred.pipe = promise.pipe = function( /* fnDone, fnFail, fnProgress */ ) {
+		var fns = arguments;
+
+		migrateWarn( "deferred.pipe() is deprecated" );
+
+		return jQuery.Deferred( function( newDefer ) {
+			jQuery.each( tuples, function( i, tuple ) {
+				var fn = jQuery.isFunction( fns[ i ] ) && fns[ i ];
+
+				// Deferred.done(function() { bind to newDefer or newDefer.resolve })
+				// deferred.fail(function() { bind to newDefer or newDefer.reject })
+				// deferred.progress(function() { bind to newDefer or newDefer.notify })
+				deferred[ tuple[ 1 ] ]( function() {
+					var returned = fn && fn.apply( this, arguments );
+					if ( returned && jQuery.isFunction( returned.promise ) ) {
+						returned.promise()
+							.done( newDefer.resolve )
+							.fail( newDefer.reject )
+							.progress( newDefer.notify );
+					} else {
+						newDefer[ tuple[ 0 ] + "With" ](
+							this === promise ? newDefer.promise() : this,
+							fn ? [ returned ] : arguments
+						);
+					}
+				} );
+			} );
+			fns = null;
+		} ).promise();
+
+	};
+
+	if ( func ) {
+		func.call( deferred, deferred );
+	}
+
+	return deferred;
+};
+
+// Preserve handler of uncaught exceptions in promise chains
+jQuery.Deferred.exceptionHook = oldDeferred.exceptionHook;
+
+return jQuery;
+} );
diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.css b/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.css
new file mode 100644
index 0000000000..4f2fc19f06
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.css
@@ -0,0 +1,544 @@
+/*! jQuery UI - v1.11.4 - 2015-05-20
+* http://jqueryui.com
+* Includes: core.css, autocomplete.css, menu.css, theme.css
+* To view and modify this theme, visit http://jqueryui.com/themeroller/?ffDefault=Verdana%2CArial%2Csans-serif&fwDefault=normal&fsDefault=1.1em&cornerRadius=4px&bgColorHeader=cccccc&bgTextureHeader=highlight_soft&bgImgOpacityHeader=75&borderColorHeader=aaaaaa&fcHeader=222222&iconColorHeader=222222&bgColorContent=ffffff&bgTextureContent=flat&bgImgOpacityContent=75&borderColorContent=aaaaaa&fcContent=222222&iconColorContent=222222&bgColorDefault=e6e6e6&bgTextureDefault=glass&bgImgOpacityDefault=75&borderColorDefault=d3d3d3&fcDefault=555555&iconColorDefault=888888&bgColorHover=dadada&bgTextureHover=glass&bgImgOpacityHover=75&borderColorHover=999999&fcHover=212121&iconColorHover=454545&bgColorActive=ffffff&bgTextureActive=glass&bgImgOpacityActive=65&borderColorActive=aaaaaa&fcActive=212121&iconColorActive=454545&bgColorHighlight=fbf9ee&bgTextureHighlight=glass&bgImgOpacityHighlight=55&borderColorHighlight=fcefa1&fcHighlight=363636&iconColorHighlight=2e83ff&bgColorError=fef1ec&bgTextureError=glass&bgImgOpacityError=95&borderColorError=cd0a0a&fcError=cd0a0a&iconColorError=cd0a0a&bgColorOverlay=aaaaaa&bgTextureOverlay=flat&bgImgOpacityOverlay=0&opacityOverlay=30&bgColorShadow=aaaaaa&bgTextureShadow=flat&bgImgOpacityShadow=0&opacityShadow=30&thicknessShadow=8px&offsetTopShadow=-8px&offsetLeftShadow=-8px&cornerRadiusShadow=8px
+* Copyright 2015 jQuery Foundation and other contributors; Licensed MIT */
+
+/* Layout helpers
+----------------------------------*/
+.ui-helper-hidden {
+	display: none;
+}
+.ui-helper-hidden-accessible {
+	border: 0;
+	clip: rect(0 0 0 0);
+	height: 1px;
+	margin: -1px;
+	overflow: hidden;
+	padding: 0;
+	position: absolute;
+	width: 1px;
+}
+.ui-helper-reset {
+	margin: 0;
+	padding: 0;
+	border: 0;
+	outline: 0;
+	line-height: 1.3;
+	text-decoration: none;
+	font-size: 100%;
+	list-style: none;
+}
+.ui-helper-clearfix:before,
+.ui-helper-clearfix:after {
+	content: "";
+	display: table;
+	border-collapse: collapse;
+}
+.ui-helper-clearfix:after {
+	clear: both;
+}
+.ui-helper-clearfix {
+	min-height: 0; /* support: IE7 */
+}
+.ui-helper-zfix {
+	width: 100%;
+	height: 100%;
+	top: 0;
+	left: 0;
+	position: absolute;
+	opacity: 0;
+	filter:Alpha(Opacity=0); /* support: IE8 */
+}
+
+.ui-front {
+	z-index: 100;
+}
+
+
+/* Interaction Cues
+----------------------------------*/
+.ui-state-disabled {
+	cursor: default !important;
+}
+
+
+/* Icons
+----------------------------------*/
+
+/* states and images */
+.ui-icon {
+	display: block;
+	text-indent: -99999px;
+	overflow: hidden;
+	background-repeat: no-repeat;
+}
+
+
+/* Misc visuals
+----------------------------------*/
+
+/* Overlays */
+.ui-widget-overlay {
+	position: fixed;
+	top: 0;
+	left: 0;
+	width: 100%;
+	height: 100%;
+}
+.ui-autocomplete {
+	position: absolute;
+	top: 0;
+	left: 0;
+	cursor: default;
+}
+.ui-menu {
+	list-style: none;
+	padding: 0;
+	margin: 0;
+	display: block;
+	outline: none;
+}
+.ui-menu .ui-menu {
+	position: absolute;
+}
+.ui-menu .ui-menu-item {
+	position: relative;
+	margin: 0;
+	padding: 3px 1em 3px .4em;
+	cursor: pointer;
+	min-height: 0; /* support: IE7 */
+	/* support: IE10, see #8844 */
+	list-style-image: url("data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7");
+}
+.ui-menu .ui-menu-divider {
+	margin: 5px 0;
+	height: 0;
+	font-size: 0;
+	line-height: 0;
+	border-width: 1px 0 0 0;
+}
+.ui-menu .ui-state-focus,
+.ui-menu .ui-state-active {
+	margin: -1px;
+}
+
+/* icon support */
+.ui-menu-icons {
+	position: relative;
+}
+.ui-menu-icons .ui-menu-item {
+	padding-left: 2em;
+}
+
+/* left-aligned */
+.ui-menu .ui-icon {
+	position: absolute;
+	top: 0;
+	bottom: 0;
+	left: .2em;
+	margin: auto 0;
+}
+
+/* right-aligned */
+.ui-menu .ui-menu-icon {
+	left: auto;
+	right: 0;
+}
+
+/* Component containers
+----------------------------------*/
+.ui-widget {
+	font-family: Verdana,Arial,sans-serif;
+	font-size: 1.1em;
+}
+.ui-widget .ui-widget {
+	font-size: 1em;
+}
+.ui-widget input,
+.ui-widget select,
+.ui-widget textarea,
+.ui-widget button {
+	font-family: Verdana,Arial,sans-serif;
+	font-size: 1em;
+}
+.ui-widget-content {
+	border: 1px solid #aaaaaa;
+	background: #ffffff url("images/ui-bg_flat_75_ffffff_40x100.png") 50% 50% repeat-x;
+	color: #222222;
+}
+.ui-widget-content a {
+	color: #222222;
+}
+.ui-widget-header {
+	border: 1px solid #aaaaaa;
+	background: #cccccc url("images/ui-bg_highlight-soft_75_cccccc_1x100.png") 50% 50% repeat-x;
+	color: #222222;
+	font-weight: bold;
+}
+.ui-widget-header a {
+	color: #222222;
+}
+
+/* Interaction states
+----------------------------------*/
+.ui-state-default,
+.ui-widget-content .ui-state-default,
+.ui-widget-header .ui-state-default {
+	border: 1px solid #d3d3d3;
+	background: #e6e6e6 url("images/ui-bg_glass_75_e6e6e6_1x400.png") 50% 50% repeat-x;
+	font-weight: normal;
+	color: #555555;
+}
+.ui-state-default a,
+.ui-state-default a:link,
+.ui-state-default a:visited {
+	color: #555555;
+	text-decoration: none;
+}
+.ui-state-hover,
+.ui-widget-content .ui-state-hover,
+.ui-widget-header .ui-state-hover,
+.ui-state-focus,
+.ui-widget-content .ui-state-focus,
+.ui-widget-header .ui-state-focus {
+	border: 1px solid #999999;
+	background: #dadada url("images/ui-bg_glass_75_dadada_1x400.png") 50% 50% repeat-x;
+	font-weight: normal;
+	color: #212121;
+}
+.ui-state-hover a,
+.ui-state-hover a:hover,
+.ui-state-hover a:link,
+.ui-state-hover a:visited,
+.ui-state-focus a,
+.ui-state-focus a:hover,
+.ui-state-focus a:link,
+.ui-state-focus a:visited {
+	color: #212121;
+	text-decoration: none;
+}
+.ui-state-active,
+.ui-widget-content .ui-state-active,
+.ui-widget-header .ui-state-active {
+	border: 1px solid #aaaaaa;
+	background: #ffffff url("images/ui-bg_glass_65_ffffff_1x400.png") 50% 50% repeat-x;
+	font-weight: normal;
+	color: #212121;
+}
+.ui-state-active a,
+.ui-state-active a:link,
+.ui-state-active a:visited {
+	color: #212121;
+	text-decoration: none;
+}
+
+/* Interaction Cues
+----------------------------------*/
+.ui-state-highlight,
+.ui-widget-content .ui-state-highlight,
+.ui-widget-header .ui-state-highlight {
+	border: 1px solid #fcefa1;
+	background: #fbf9ee url("images/ui-bg_glass_55_fbf9ee_1x400.png") 50% 50% repeat-x;
+	color: #363636;
+}
+.ui-state-highlight a,
+.ui-widget-content .ui-state-highlight a,
+.ui-widget-header .ui-state-highlight a {
+	color: #363636;
+}
+.ui-state-error,
+.ui-widget-content .ui-state-error,
+.ui-widget-header .ui-state-error {
+	border: 1px solid #cd0a0a;
+	background: #fef1ec url("images/ui-bg_glass_95_fef1ec_1x400.png") 50% 50% repeat-x;
+	color: #cd0a0a;
+}
+.ui-state-error a,
+.ui-widget-content .ui-state-error a,
+.ui-widget-header .ui-state-error a {
+	color: #cd0a0a;
+}
+.ui-state-error-text,
+.ui-widget-content .ui-state-error-text,
+.ui-widget-header .ui-state-error-text {
+	color: #cd0a0a;
+}
+.ui-priority-primary,
+.ui-widget-content .ui-priority-primary,
+.ui-widget-header .ui-priority-primary {
+	font-weight: bold;
+}
+.ui-priority-secondary,
+.ui-widget-content .ui-priority-secondary,
+.ui-widget-header .ui-priority-secondary {
+	opacity: .7;
+	filter:Alpha(Opacity=70); /* support: IE8 */
+	font-weight: normal;
+}
+.ui-state-disabled,
+.ui-widget-content .ui-state-disabled,
+.ui-widget-header .ui-state-disabled {
+	opacity: .35;
+	filter:Alpha(Opacity=35); /* support: IE8 */
+	background-image: none;
+}
+.ui-state-disabled .ui-icon {
+	filter:Alpha(Opacity=35); /* support: IE8 - See #6059 */
+}
+
+/* Icons
+----------------------------------*/
+
+/* states and images */
+.ui-icon {
+	width: 16px;
+	height: 16px;
+}
+.ui-icon,
+.ui-widget-content .ui-icon {
+	background-image: url("images/ui-icons_222222_256x240.png");
+}
+.ui-widget-header .ui-icon {
+	background-image: url("images/ui-icons_222222_256x240.png");
+}
+.ui-state-default .ui-icon {
+	background-image: url("images/ui-icons_888888_256x240.png");
+}
+.ui-state-hover .ui-icon,
+.ui-state-focus .ui-icon {
+	background-image: url("images/ui-icons_454545_256x240.png");
+}
+.ui-state-active .ui-icon {
+	background-image: url("images/ui-icons_454545_256x240.png");
+}
+.ui-state-highlight .ui-icon {
+	background-image: url("images/ui-icons_2e83ff_256x240.png");
+}
+.ui-state-error .ui-icon,
+.ui-state-error-text .ui-icon {
+	background-image: url("images/ui-icons_cd0a0a_256x240.png");
+}
+
+/* positioning */
+.ui-icon-blank { background-position: 16px 16px; }
+.ui-icon-carat-1-n { background-position: 0 0; }
+.ui-icon-carat-1-ne { background-position: -16px 0; }
+.ui-icon-carat-1-e { background-position: -32px 0; }
+.ui-icon-carat-1-se { background-position: -48px 0; }
+.ui-icon-carat-1-s { background-position: -64px 0; }
+.ui-icon-carat-1-sw { background-position: -80px 0; }
+.ui-icon-carat-1-w { background-position: -96px 0; }
+.ui-icon-carat-1-nw { background-position: -112px 0; }
+.ui-icon-carat-2-n-s { background-position: -128px 0; }
+.ui-icon-carat-2-e-w { background-position: -144px 0; }
+.ui-icon-triangle-1-n { background-position: 0 -16px; }
+.ui-icon-triangle-1-ne { background-position: -16px -16px; }
+.ui-icon-triangle-1-e { background-position: -32px -16px; }
+.ui-icon-triangle-1-se { background-position: -48px -16px; }
+.ui-icon-triangle-1-s { background-position: -64px -16px; }
+.ui-icon-triangle-1-sw { background-position: -80px -16px; }
+.ui-icon-triangle-1-w { background-position: -96px -16px; }
+.ui-icon-triangle-1-nw { background-position: -112px -16px; }
+.ui-icon-triangle-2-n-s { background-position: -128px -16px; }
+.ui-icon-triangle-2-e-w { background-position: -144px -16px; }
+.ui-icon-arrow-1-n { background-position: 0 -32px; }
+.ui-icon-arrow-1-ne { background-position: -16px -32px; }
+.ui-icon-arrow-1-e { background-position: -32px -32px; }
+.ui-icon-arrow-1-se { background-position: -48px -32px; }
+.ui-icon-arrow-1-s { background-position: -64px -32px; }
+.ui-icon-arrow-1-sw { background-position: -80px -32px; }
+.ui-icon-arrow-1-w { background-position: -96px -32px; }
+.ui-icon-arrow-1-nw { background-position: -112px -32px; }
+.ui-icon-arrow-2-n-s { background-position: -128px -32px; }
+.ui-icon-arrow-2-ne-sw { background-position: -144px -32px; }
+.ui-icon-arrow-2-e-w { background-position: -160px -32px; }
+.ui-icon-arrow-2-se-nw { background-position: -176px -32px; }
+.ui-icon-arrowstop-1-n { background-position: -192px -32px; }
+.ui-icon-arrowstop-1-e { background-position: -208px -32px; }
+.ui-icon-arrowstop-1-s { background-position: -224px -32px; }
+.ui-icon-arrowstop-1-w { background-position: -240px -32px; }
+.ui-icon-arrowthick-1-n { background-position: 0 -48px; }
+.ui-icon-arrowthick-1-ne { background-position: -16px -48px; }
+.ui-icon-arrowthick-1-e { background-position: -32px -48px; }
+.ui-icon-arrowthick-1-se { background-position: -48px -48px; }
+.ui-icon-arrowthick-1-s { background-position: -64px -48px; }
+.ui-icon-arrowthick-1-sw { background-position: -80px -48px; }
+.ui-icon-arrowthick-1-w { background-position: -96px -48px; }
+.ui-icon-arrowthick-1-nw { background-position: -112px -48px; }
+.ui-icon-arrowthick-2-n-s { background-position: -128px -48px; }
+.ui-icon-arrowthick-2-ne-sw { background-position: -144px -48px; }
+.ui-icon-arrowthick-2-e-w { background-position: -160px -48px; }
+.ui-icon-arrowthick-2-se-nw { background-position: -176px -48px; }
+.ui-icon-arrowthickstop-1-n { background-position: -192px -48px; }
+.ui-icon-arrowthickstop-1-e { background-position: -208px -48px; }
+.ui-icon-arrowthickstop-1-s { background-position: -224px -48px; }
+.ui-icon-arrowthickstop-1-w { background-position: -240px -48px; }
+.ui-icon-arrowreturnthick-1-w { background-position: 0 -64px; }
+.ui-icon-arrowreturnthick-1-n { background-position: -16px -64px; }
+.ui-icon-arrowreturnthick-1-e { background-position: -32px -64px; }
+.ui-icon-arrowreturnthick-1-s { background-position: -48px -64px; }
+.ui-icon-arrowreturn-1-w { background-position: -64px -64px; }
+.ui-icon-arrowreturn-1-n { background-position: -80px -64px; }
+.ui-icon-arrowreturn-1-e { background-position: -96px -64px; }
+.ui-icon-arrowreturn-1-s { background-position: -112px -64px; }
+.ui-icon-arrowrefresh-1-w { background-position: -128px -64px; }
+.ui-icon-arrowrefresh-1-n { background-position: -144px -64px; }
+.ui-icon-arrowrefresh-1-e { background-position: -160px -64px; }
+.ui-icon-arrowrefresh-1-s { background-position: -176px -64px; }
+.ui-icon-arrow-4 { background-position: 0 -80px; }
+.ui-icon-arrow-4-diag { background-position: -16px -80px; }
+.ui-icon-extlink { background-position: -32px -80px; }
+.ui-icon-newwin { background-position: -48px -80px; }
+.ui-icon-refresh { background-position: -64px -80px; }
+.ui-icon-shuffle { background-position: -80px -80px; }
+.ui-icon-transfer-e-w { background-position: -96px -80px; }
+.ui-icon-transferthick-e-w { background-position: -112px -80px; }
+.ui-icon-folder-collapsed { background-position: 0 -96px; }
+.ui-icon-folder-open { background-position: -16px -96px; }
+.ui-icon-document { background-position: -32px -96px; }
+.ui-icon-document-b { background-position: -48px -96px; }
+.ui-icon-note { background-position: -64px -96px; }
+.ui-icon-mail-closed { background-position: -80px -96px; }
+.ui-icon-mail-open { background-position: -96px -96px; }
+.ui-icon-suitcase { background-position: -112px -96px; }
+.ui-icon-comment { background-position: -128px -96px; }
+.ui-icon-person { background-position: -144px -96px; }
+.ui-icon-print { background-position: -160px -96px; }
+.ui-icon-trash { background-position: -176px -96px; }
+.ui-icon-locked { background-position: -192px -96px; }
+.ui-icon-unlocked { background-position: -208px -96px; }
+.ui-icon-bookmark { background-position: -224px -96px; }
+.ui-icon-tag { background-position: -240px -96px; }
+.ui-icon-home { background-position: 0 -112px; }
+.ui-icon-flag { background-position: -16px -112px; }
+.ui-icon-calendar { background-position: -32px -112px; }
+.ui-icon-cart { background-position: -48px -112px; }
+.ui-icon-pencil { background-position: -64px -112px; }
+.ui-icon-clock { background-position: -80px -112px; }
+.ui-icon-disk { background-position: -96px -112px; }
+.ui-icon-calculator { background-position: -112px -112px; }
+.ui-icon-zoomin { background-position: -128px -112px; }
+.ui-icon-zoomout { background-position: -144px -112px; }
+.ui-icon-search { background-position: -160px -112px; }
+.ui-icon-wrench { background-position: -176px -112px; }
+.ui-icon-gear { background-position: -192px -112px; }
+.ui-icon-heart { background-position: -208px -112px; }
+.ui-icon-star { background-position: -224px -112px; }
+.ui-icon-link { background-position: -240px -112px; }
+.ui-icon-cancel { background-position: 0 -128px; }
+.ui-icon-plus { background-position: -16px -128px; }
+.ui-icon-plusthick { background-position: -32px -128px; }
+.ui-icon-minus { background-position: -48px -128px; }
+.ui-icon-minusthick { background-position: -64px -128px; }
+.ui-icon-close { background-position: -80px -128px; }
+.ui-icon-closethick { background-position: -96px -128px; }
+.ui-icon-key { background-position: -112px -128px; }
+.ui-icon-lightbulb { background-position: -128px -128px; }
+.ui-icon-scissors { background-position: -144px -128px; }
+.ui-icon-clipboard { background-position: -160px -128px; }
+.ui-icon-copy { background-position: -176px -128px; }
+.ui-icon-contact { background-position: -192px -128px; }
+.ui-icon-image { background-position: -208px -128px; }
+.ui-icon-video { background-position: -224px -128px; }
+.ui-icon-script { background-position: -240px -128px; }
+.ui-icon-alert { background-position: 0 -144px; }
+.ui-icon-info { background-position: -16px -144px; }
+.ui-icon-notice { background-position: -32px -144px; }
+.ui-icon-help { background-position: -48px -144px; }
+.ui-icon-check { background-position: -64px -144px; }
+.ui-icon-bullet { background-position: -80px -144px; }
+.ui-icon-radio-on { background-position: -96px -144px; }
+.ui-icon-radio-off { background-position: -112px -144px; }
+.ui-icon-pin-w { background-position: -128px -144px; }
+.ui-icon-pin-s { background-position: -144px -144px; }
+.ui-icon-play { background-position: 0 -160px; }
+.ui-icon-pause { background-position: -16px -160px; }
+.ui-icon-seek-next { background-position: -32px -160px; }
+.ui-icon-seek-prev { background-position: -48px -160px; }
+.ui-icon-seek-end { background-position: -64px -160px; }
+.ui-icon-seek-start { background-position: -80px -160px; }
+/* ui-icon-seek-first is deprecated, use ui-icon-seek-start instead */
+.ui-icon-seek-first { background-position: -80px -160px; }
+.ui-icon-stop { background-position: -96px -160px; }
+.ui-icon-eject { background-position: -112px -160px; }
+.ui-icon-volume-off { background-position: -128px -160px; }
+.ui-icon-volume-on { background-position: -144px -160px; }
+.ui-icon-power { background-position: 0 -176px; }
+.ui-icon-signal-diag { background-position: -16px -176px; }
+.ui-icon-signal { background-position: -32px -176px; }
+.ui-icon-battery-0 { background-position: -48px -176px; }
+.ui-icon-battery-1 { background-position: -64px -176px; }
+.ui-icon-battery-2 { background-position: -80px -176px; }
+.ui-icon-battery-3 { background-position: -96px -176px; }
+.ui-icon-circle-plus { background-position: 0 -192px; }
+.ui-icon-circle-minus { background-position: -16px -192px; }
+.ui-icon-circle-close { background-position: -32px -192px; }
+.ui-icon-circle-triangle-e { background-position: -48px -192px; }
+.ui-icon-circle-triangle-s { background-position: -64px -192px; }
+.ui-icon-circle-triangle-w { background-position: -80px -192px; }
+.ui-icon-circle-triangle-n { background-position: -96px -192px; }
+.ui-icon-circle-arrow-e { background-position: -112px -192px; }
+.ui-icon-circle-arrow-s { background-position: -128px -192px; }
+.ui-icon-circle-arrow-w { background-position: -144px -192px; }
+.ui-icon-circle-arrow-n { background-position: -160px -192px; }
+.ui-icon-circle-zoomin { background-position: -176px -192px; }
+.ui-icon-circle-zoomout { background-position: -192px -192px; }
+.ui-icon-circle-check { background-position: -208px -192px; }
+.ui-icon-circlesmall-plus { background-position: 0 -208px; }
+.ui-icon-circlesmall-minus { background-position: -16px -208px; }
+.ui-icon-circlesmall-close { background-position: -32px -208px; }
+.ui-icon-squaresmall-plus { background-position: -48px -208px; }
+.ui-icon-squaresmall-minus { background-position: -64px -208px; }
+.ui-icon-squaresmall-close { background-position: -80px -208px; }
+.ui-icon-grip-dotted-vertical { background-position: 0 -224px; }
+.ui-icon-grip-dotted-horizontal { background-position: -16px -224px; }
+.ui-icon-grip-solid-vertical { background-position: -32px -224px; }
+.ui-icon-grip-solid-horizontal { background-position: -48px -224px; }
+.ui-icon-gripsmall-diagonal-se { background-position: -64px -224px; }
+.ui-icon-grip-diagonal-se { background-position: -80px -224px; }
+
+
+/* Misc visuals
+----------------------------------*/
+
+/* Corner radius */
+.ui-corner-all,
+.ui-corner-top,
+.ui-corner-left,
+.ui-corner-tl {
+	border-top-left-radius: 4px;
+}
+.ui-corner-all,
+.ui-corner-top,
+.ui-corner-right,
+.ui-corner-tr {
+	border-top-right-radius: 4px;
+}
+.ui-corner-all,
+.ui-corner-bottom,
+.ui-corner-left,
+.ui-corner-bl {
+	border-bottom-left-radius: 4px;
+}
+.ui-corner-all,
+.ui-corner-bottom,
+.ui-corner-right,
+.ui-corner-br {
+	border-bottom-right-radius: 4px;
+}
+
+/* Overlays */
+.ui-widget-overlay {
+	background: #aaaaaa url("images/ui-bg_flat_0_aaaaaa_40x100.png") 50% 50% repeat-x;
+	opacity: .3;
+	filter: Alpha(Opacity=30); /* support: IE8 */
+}
+.ui-widget-shadow {
+	margin: -8px 0 0 -8px;
+	padding: 8px;
+	background: #aaaaaa url("images/ui-bg_flat_0_aaaaaa_40x100.png") 50% 50% repeat-x;
+	opacity: .3;
+	filter: Alpha(Opacity=30); /* support: IE8 */
+	border-radius: 8px;
+}
diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.js b/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.js
new file mode 100644
index 0000000000..e1a68a15bf
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.js
@@ -0,0 +1,2610 @@
+/*! jQuery UI - v1.11.4 - 2015-05-20
+* http://jqueryui.com
+* Includes: core.js, widget.js, position.js, autocomplete.js, menu.js
+* Copyright 2015 jQuery Foundation and other contributors; Licensed MIT */
+
+(function( factory ) {
+	if ( typeof define === "function" && define.amd ) {
+
+		// AMD. Register as an anonymous module.
+		define([ "jquery" ], factory );
+	} else {
+
+		// Browser globals
+		factory( jQuery );
+	}
+}(function( $ ) {
+/*!
+ * jQuery UI Core 1.11.4
+ * http://jqueryui.com
+ *
+ * Copyright jQuery Foundation and other contributors
+ * Released under the MIT license.
+ * http://jquery.org/license
+ *
+ * http://api.jqueryui.com/category/ui-core/
+ */
+
+
+// $.ui might exist from components with no dependencies, e.g., $.ui.position
+$.ui = $.ui || {};
+
+$.extend( $.ui, {
+	version: "1.11.4",
+
+	keyCode: {
+		BACKSPACE: 8,
+		COMMA: 188,
+		DELETE: 46,
+		DOWN: 40,
+		END: 35,
+		ENTER: 13,
+		ESCAPE: 27,
+		HOME: 36,
+		LEFT: 37,
+		PAGE_DOWN: 34,
+		PAGE_UP: 33,
+		PERIOD: 190,
+		RIGHT: 39,
+		SPACE: 32,
+		TAB: 9,
+		UP: 38
+	}
+});
+
+// plugins
+$.fn.extend({
+	scrollParent: function( includeHidden ) {
+		var position = this.css( "position" ),
+			excludeStaticParent = position === "absolute",
+			overflowRegex = includeHidden ? /(auto|scroll|hidden)/ : /(auto|scroll)/,
+			scrollParent = this.parents().filter( function() {
+				var parent = $( this );
+				if ( excludeStaticParent && parent.css( "position" ) === "static" ) {
+					return false;
+				}
+				return overflowRegex.test( parent.css( "overflow" ) + parent.css( "overflow-y" ) + parent.css( "overflow-x" ) );
+			}).eq( 0 );
+
+		return position === "fixed" || !scrollParent.length ? $( this[ 0 ].ownerDocument || document ) : scrollParent;
+	},
+
+	uniqueId: (function() {
+		var uuid = 0;
+
+		return function() {
+			return this.each(function() {
+				if ( !this.id ) {
+					this.id = "ui-id-" + ( ++uuid );
+				}
+			});
+		};
+	})(),
+
+	removeUniqueId: function() {
+		return this.each(function() {
+			if ( /^ui-id-\d+$/.test( this.id ) ) {
+				$( this ).removeAttr( "id" );
+			}
+		});
+	}
+});
+
+// selectors
+function focusable( element, isTabIndexNotNaN ) {
+	var map, mapName, img,
+		nodeName = element.nodeName.toLowerCase();
+	if ( "area" === nodeName ) {
+		map = element.parentNode;
+		mapName = map.name;
+		if ( !element.href || !mapName || map.nodeName.toLowerCase() !== "map" ) {
+			return false;
+		}
+		img = $( "img[usemap='#" + mapName + "']" )[ 0 ];
+		return !!img && visible( img );
+	}
+	return ( /^(input|select|textarea|button|object)$/.test( nodeName ) ?
+		!element.disabled :
+		"a" === nodeName ?
+			element.href || isTabIndexNotNaN :
+			isTabIndexNotNaN) &&
+		// the element and all of its ancestors must be visible
+		visible( element );
+}
+
+function visible( element ) {
+	return $.expr.filters.visible( element ) &&
+		!$( element ).parents().addBack().filter(function() {
+			return $.css( this, "visibility" ) === "hidden";
+		}).length;
+}
+
+$.extend( $.expr[ ":" ], {
+	data: $.expr.createPseudo ?
+		$.expr.createPseudo(function( dataName ) {
+			return function( elem ) {
+				return !!$.data( elem, dataName );
+			};
+		}) :
+		// support: jQuery <1.8
+		function( elem, i, match ) {
+			return !!$.data( elem, match[ 3 ] );
+		},
+
+	focusable: function( element ) {
+		return focusable( element, !isNaN( $.attr( element, "tabindex" ) ) );
+	},
+
+	tabbable: function( element ) {
+		var tabIndex = $.attr( element, "tabindex" ),
+			isTabIndexNaN = isNaN( tabIndex );
+		return ( isTabIndexNaN || tabIndex >= 0 ) && focusable( element, !isTabIndexNaN );
+	}
+});
+
+// support: jQuery <1.8
+if ( !$( "<a>" ).outerWidth( 1 ).jquery ) {
+	$.each( [ "Width", "Height" ], function( i, name ) {
+		var side = name === "Width" ? [ "Left", "Right" ] : [ "Top", "Bottom" ],
+			type = name.toLowerCase(),
+			orig = {
+				innerWidth: $.fn.innerWidth,
+				innerHeight: $.fn.innerHeight,
+				outerWidth: $.fn.outerWidth,
+				outerHeight: $.fn.outerHeight
+			};
+
+		function reduce( elem, size, border, margin ) {
+			$.each( side, function() {
+				size -= parseFloat( $.css( elem, "padding" + this ) ) || 0;
+				if ( border ) {
+					size -= parseFloat( $.css( elem, "border" + this + "Width" ) ) || 0;
+				}
+				if ( margin ) {
+					size -= parseFloat( $.css( elem, "margin" + this ) ) || 0;
+				}
+			});
+			return size;
+		}
+
+		$.fn[ "inner" + name ] = function( size ) {
+			if ( size === undefined ) {
+				return orig[ "inner" + name ].call( this );
+			}
+
+			return this.each(function() {
+				$( this ).css( type, reduce( this, size ) + "px" );
+			});
+		};
+
+		$.fn[ "outer" + name] = function( size, margin ) {
+			if ( typeof size !== "number" ) {
+				return orig[ "outer" + name ].call( this, size );
+			}
+
+			return this.each(function() {
+				$( this).css( type, reduce( this, size, true, margin ) + "px" );
+			});
+		};
+	});
+}
+
+// support: jQuery <1.8
+if ( !$.fn.addBack ) {
+	$.fn.addBack = function( selector ) {
+		return this.add( selector == null ?
+			this.prevObject : this.prevObject.filter( selector )
+		);
+	};
+}
+
+// support: jQuery 1.6.1, 1.6.2 (http://bugs.jquery.com/ticket/9413)
+if ( $( "<a>" ).data( "a-b", "a" ).removeData( "a-b" ).data( "a-b" ) ) {
+	$.fn.removeData = (function( removeData ) {
+		return function( key ) {
+			if ( arguments.length ) {
+				return removeData.call( this, $.camelCase( key ) );
+			} else {
+				return removeData.call( this );
+			}
+		};
+	})( $.fn.removeData );
+}
+
+// deprecated
+$.ui.ie = !!/msie [\w.]+/.exec( navigator.userAgent.toLowerCase() );
+
+$.fn.extend({
+	focus: (function( orig ) {
+		return function( delay, fn ) {
+			return typeof delay === "number" ?
+				this.each(function() {
+					var elem = this;
+					setTimeout(function() {
+						$( elem ).focus();
+						if ( fn ) {
+							fn.call( elem );
+						}
+					}, delay );
+				}) :
+				orig.apply( this, arguments );
+		};
+	})( $.fn.focus ),
+
+	disableSelection: (function() {
+		var eventType = "onselectstart" in document.createElement( "div" ) ?
+			"selectstart" :
+			"mousedown";
+
+		return function() {
+			return this.bind( eventType + ".ui-disableSelection", function( event ) {
+				event.preventDefault();
+			});
+		};
+	})(),
+
+	enableSelection: function() {
+		return this.unbind( ".ui-disableSelection" );
+	},
+
+	zIndex: function( zIndex ) {
+		if ( zIndex !== undefined ) {
+			return this.css( "zIndex", zIndex );
+		}
+
+		if ( this.length ) {
+			var elem = $( this[ 0 ] ), position, value;
+			while ( elem.length && elem[ 0 ] !== document ) {
+				// Ignore z-index if position is set to a value where z-index is ignored by the browser
+				// This makes behavior of this function consistent across browsers
+				// WebKit always returns auto if the element is positioned
+				position = elem.css( "position" );
+				if ( position === "absolute" || position === "relative" || position === "fixed" ) {
+					// IE returns 0 when zIndex is not specified
+					// other browsers return a string
+					// we ignore the case of nested elements with an explicit value of 0
+					// <div style="z-index: -10;"><div style="z-index: 0;"></div></div>
+					value = parseInt( elem.css( "zIndex" ), 10 );
+					if ( !isNaN( value ) && value !== 0 ) {
+						return value;
+					}
+				}
+				elem = elem.parent();
+			}
+		}
+
+		return 0;
+	}
+});
+
+// $.ui.plugin is deprecated. Use $.widget() extensions instead.
+$.ui.plugin = {
+	add: function( module, option, set ) {
+		var i,
+			proto = $.ui[ module ].prototype;
+		for ( i in set ) {
+			proto.plugins[ i ] = proto.plugins[ i ] || [];
+			proto.plugins[ i ].push( [ option, set[ i ] ] );
+		}
+	},
+	call: function( instance, name, args, allowDisconnected ) {
+		var i,
+			set = instance.plugins[ name ];
+
+		if ( !set ) {
+			return;
+		}
+
+		if ( !allowDisconnected && ( !instance.element[ 0 ].parentNode || instance.element[ 0 ].parentNode.nodeType === 11 ) ) {
+			return;
+		}
+
+		for ( i = 0; i < set.length; i++ ) {
+			if ( instance.options[ set[ i ][ 0 ] ] ) {
+				set[ i ][ 1 ].apply( instance.element, args );
+			}
+		}
+	}
+};
+
+
+/*!
+ * jQuery UI Widget 1.11.4
+ * http://jqueryui.com
+ *
+ * Copyright jQuery Foundation and other contributors
+ * Released under the MIT license.
+ * http://jquery.org/license
+ *
+ * http://api.jqueryui.com/jQuery.widget/
+ */
+
+
+var widget_uuid = 0,
+	widget_slice = Array.prototype.slice;
+
+$.cleanData = (function( orig ) {
+	return function( elems ) {
+		var events, elem, i;
+		for ( i = 0; (elem = elems[i]) != null; i++ ) {
+			try {
+
+				// Only trigger remove when necessary to save time
+				events = $._data( elem, "events" );
+				if ( events && events.remove ) {
+					$( elem ).triggerHandler( "remove" );
+				}
+
+			// http://bugs.jquery.com/ticket/8235
+			} catch ( e ) {}
+		}
+		orig( elems );
+	};
+})( $.cleanData );
+
+$.widget = function( name, base, prototype ) {
+	var fullName, existingConstructor, constructor, basePrototype,
+		// proxiedPrototype allows the provided prototype to remain unmodified
+		// so that it can be used as a mixin for multiple widgets (#8876)
+		proxiedPrototype = {},
+		namespace = name.split( "." )[ 0 ];
+
+	name = name.split( "." )[ 1 ];
+	fullName = namespace + "-" + name;
+
+	if ( !prototype ) {
+		prototype = base;
+		base = $.Widget;
+	}
+
+	// create selector for plugin
+	$.expr[ ":" ][ fullName.toLowerCase() ] = function( elem ) {
+		return !!$.data( elem, fullName );
+	};
+
+	$[ namespace ] = $[ namespace ] || {};
+	existingConstructor = $[ namespace ][ name ];
+	constructor = $[ namespace ][ name ] = function( options, element ) {
+		// allow instantiation without "new" keyword
+		if ( !this._createWidget ) {
+			return new constructor( options, element );
+		}
+
+		// allow instantiation without initializing for simple inheritance
+		// must use "new" keyword (the code above always passes args)
+		if ( arguments.length ) {
+			this._createWidget( options, element );
+		}
+	};
+	// extend with the existing constructor to carry over any static properties
+	$.extend( constructor, existingConstructor, {
+		version: prototype.version,
+		// copy the object used to create the prototype in case we need to
+		// redefine the widget later
+		_proto: $.extend( {}, prototype ),
+		// track widgets that inherit from this widget in case this widget is
+		// redefined after a widget inherits from it
+		_childConstructors: []
+	});
+
+	basePrototype = new base();
+	// we need to make the options hash a property directly on the new instance
+	// otherwise we'll modify the options hash on the prototype that we're
+	// inheriting from
+	basePrototype.options = $.widget.extend( {}, basePrototype.options );
+	$.each( prototype, function( prop, value ) {
+		if ( !$.isFunction( value ) ) {
+			proxiedPrototype[ prop ] = value;
+			return;
+		}
+		proxiedPrototype[ prop ] = (function() {
+			var _super = function() {
+					return base.prototype[ prop ].apply( this, arguments );
+				},
+				_superApply = function( args ) {
+					return base.prototype[ prop ].apply( this, args );
+				};
+			return function() {
+				var __super = this._super,
+					__superApply = this._superApply,
+					returnValue;
+
+				this._super = _super;
+				this._superApply = _superApply;
+
+				returnValue = value.apply( this, arguments );
+
+				this._super = __super;
+				this._superApply = __superApply;
+
+				return returnValue;
+			};
+		})();
+	});
+	constructor.prototype = $.widget.extend( basePrototype, {
+		// TODO: remove support for widgetEventPrefix
+		// always use the name + a colon as the prefix, e.g., draggable:start
+		// don't prefix for widgets that aren't DOM-based
+		widgetEventPrefix: existingConstructor ? (basePrototype.widgetEventPrefix || name) : name
+	}, proxiedPrototype, {
+		constructor: constructor,
+		namespace: namespace,
+		widgetName: name,
+		widgetFullName: fullName
+	});
+
+	// If this widget is being redefined then we need to find all widgets that
+	// are inheriting from it and redefine all of them so that they inherit from
+	// the new version of this widget. We're essentially trying to replace one
+	// level in the prototype chain.
+	if ( existingConstructor ) {
+		$.each( existingConstructor._childConstructors, function( i, child ) {
+			var childPrototype = child.prototype;
+
+			// redefine the child widget using the same prototype that was
+			// originally used, but inherit from the new version of the base
+			$.widget( childPrototype.namespace + "." + childPrototype.widgetName, constructor, child._proto );
+		});
+		// remove the list of existing child constructors from the old constructor
+		// so the old child constructors can be garbage collected
+		delete existingConstructor._childConstructors;
+	} else {
+		base._childConstructors.push( constructor );
+	}
+
+	$.widget.bridge( name, constructor );
+
+	return constructor;
+};
+
+$.widget.extend = function( target ) {
+	var input = widget_slice.call( arguments, 1 ),
+		inputIndex = 0,
+		inputLength = input.length,
+		key,
+		value;
+	for ( ; inputIndex < inputLength; inputIndex++ ) {
+		for ( key in input[ inputIndex ] ) {
+			value = input[ inputIndex ][ key ];
+			if ( input[ inputIndex ].hasOwnProperty( key ) && value !== undefined ) {
+				// Clone objects
+				if ( $.isPlainObject( value ) ) {
+					target[ key ] = $.isPlainObject( target[ key ] ) ?
+						$.widget.extend( {}, target[ key ], value ) :
+						// Don't extend strings, arrays, etc. with objects
+						$.widget.extend( {}, value );
+				// Copy everything else by reference
+				} else {
+					target[ key ] = value;
+				}
+			}
+		}
+	}
+	return target;
+};
+
+$.widget.bridge = function( name, object ) {
+	var fullName = object.prototype.widgetFullName || name;
+	$.fn[ name ] = function( options ) {
+		var isMethodCall = typeof options === "string",
+			args = widget_slice.call( arguments, 1 ),
+			returnValue = this;
+
+		if ( isMethodCall ) {
+			this.each(function() {
+				var methodValue,
+					instance = $.data( this, fullName );
+				if ( options === "instance" ) {
+					returnValue = instance;
+					return false;
+				}
+				if ( !instance ) {
+					return $.error( "cannot call methods on " + name + " prior to initialization; " +
+						"attempted to call method '" + options + "'" );
+				}
+				if ( !$.isFunction( instance[options] ) || options.charAt( 0 ) === "_" ) {
+					return $.error( "no such method '" + options + "' for " + name + " widget instance" );
+				}
+				methodValue = instance[ options ].apply( instance, args );
+				if ( methodValue !== instance && methodValue !== undefined ) {
+					returnValue = methodValue && methodValue.jquery ?
+						returnValue.pushStack( methodValue.get() ) :
+						methodValue;
+					return false;
+				}
+			});
+		} else {
+
+			// Allow multiple hashes to be passed on init
+			if ( args.length ) {
+				options = $.widget.extend.apply( null, [ options ].concat(args) );
+			}
+
+			this.each(function() {
+				var instance = $.data( this, fullName );
+				if ( instance ) {
+					instance.option( options || {} );
+					if ( instance._init ) {
+						instance._init();
+					}
+				} else {
+					$.data( this, fullName, new object( options, this ) );
+				}
+			});
+		}
+
+		return returnValue;
+	};
+};
+
+$.Widget = function( /* options, element */ ) {};
+$.Widget._childConstructors = [];
+
+$.Widget.prototype = {
+	widgetName: "widget",
+	widgetEventPrefix: "",
+	defaultElement: "<div>",
+	options: {
+		disabled: false,
+
+		// callbacks
+		create: null
+	},
+	_createWidget: function( options, element ) {
+		element = $( element || this.defaultElement || this )[ 0 ];
+		this.element = $( element );
+		this.uuid = widget_uuid++;
+		this.eventNamespace = "." + this.widgetName + this.uuid;
+
+		this.bindings = $();
+		this.hoverable = $();
+		this.focusable = $();
+
+		if ( element !== this ) {
+			$.data( element, this.widgetFullName, this );
+			this._on( true, this.element, {
+				remove: function( event ) {
+					if ( event.target === element ) {
+						this.destroy();
+					}
+				}
+			});
+			this.document = $( element.style ?
+				// element within the document
+				element.ownerDocument :
+				// element is window or document
+				element.document || element );
+			this.window = $( this.document[0].defaultView || this.document[0].parentWindow );
+		}
+
+		this.options = $.widget.extend( {},
+			this.options,
+			this._getCreateOptions(),
+			options );
+
+		this._create();
+		this._trigger( "create", null, this._getCreateEventData() );
+		this._init();
+	},
+	_getCreateOptions: $.noop,
+	_getCreateEventData: $.noop,
+	_create: $.noop,
+	_init: $.noop,
+
+	destroy: function() {
+		this._destroy();
+		// we can probably remove the unbind calls in 2.0
+		// all event bindings should go through this._on()
+		this.element
+			.unbind( this.eventNamespace )
+			.removeData( this.widgetFullName )
+			// support: jquery <1.6.3
+			// http://bugs.jquery.com/ticket/9413
+			.removeData( $.camelCase( this.widgetFullName ) );
+		this.widget()
+			.unbind( this.eventNamespace )
+			.removeAttr( "aria-disabled" )
+			.removeClass(
+				this.widgetFullName + "-disabled " +
+				"ui-state-disabled" );
+
+		// clean up events and states
+		this.bindings.unbind( this.eventNamespace );
+		this.hoverable.removeClass( "ui-state-hover" );
+		this.focusable.removeClass( "ui-state-focus" );
+	},
+	_destroy: $.noop,
+
+	widget: function() {
+		return this.element;
+	},
+
+	option: function( key, value ) {
+		var options = key,
+			parts,
+			curOption,
+			i;
+
+		if ( arguments.length === 0 ) {
+			// don't return a reference to the internal hash
+			return $.widget.extend( {}, this.options );
+		}
+
+		if ( typeof key === "string" ) {
+			// handle nested keys, e.g., "foo.bar" => { foo: { bar: ___ } }
+			options = {};
+			parts = key.split( "." );
+			key = parts.shift();
+			if ( parts.length ) {
+				curOption = options[ key ] = $.widget.extend( {}, this.options[ key ] );
+				for ( i = 0; i < parts.length - 1; i++ ) {
+					curOption[ parts[ i ] ] = curOption[ parts[ i ] ] || {};
+					curOption = curOption[ parts[ i ] ];
+				}
+				key = parts.pop();
+				if ( arguments.length === 1 ) {
+					return curOption[ key ] === undefined ? null : curOption[ key ];
+				}
+				curOption[ key ] = value;
+			} else {
+				if ( arguments.length === 1 ) {
+					return this.options[ key ] === undefined ? null : this.options[ key ];
+				}
+				options[ key ] = value;
+			}
+		}
+
+		this._setOptions( options );
+
+		return this;
+	},
+	_setOptions: function( options ) {
+		var key;
+
+		for ( key in options ) {
+			this._setOption( key, options[ key ] );
+		}
+
+		return this;
+	},
+	_setOption: function( key, value ) {
+		this.options[ key ] = value;
+
+		if ( key === "disabled" ) {
+			this.widget()
+				.toggleClass( this.widgetFullName + "-disabled", !!value );
+
+			// If the widget is becoming disabled, then nothing is interactive
+			if ( value ) {
+				this.hoverable.removeClass( "ui-state-hover" );
+				this.focusable.removeClass( "ui-state-focus" );
+			}
+		}
+
+		return this;
+	},
+
+	enable: function() {
+		return this._setOptions({ disabled: false });
+	},
+	disable: function() {
+		return this._setOptions({ disabled: true });
+	},
+
+	_on: function( suppressDisabledCheck, element, handlers ) {
+		var delegateElement,
+			instance = this;
+
+		// no suppressDisabledCheck flag, shuffle arguments
+		if ( typeof suppressDisabledCheck !== "boolean" ) {
+			handlers = element;
+			element = suppressDisabledCheck;
+			suppressDisabledCheck = false;
+		}
+
+		// no element argument, shuffle and use this.element
+		if ( !handlers ) {
+			handlers = element;
+			element = this.element;
+			delegateElement = this.widget();
+		} else {
+			element = delegateElement = $( element );
+			this.bindings = this.bindings.add( element );
+		}
+
+		$.each( handlers, function( event, handler ) {
+			function handlerProxy() {
+				// allow widgets to customize the disabled handling
+				// - disabled as an array instead of boolean
+				// - disabled class as method for disabling individual parts
+				if ( !suppressDisabledCheck &&
+						( instance.options.disabled === true ||
+							$( this ).hasClass( "ui-state-disabled" ) ) ) {
+					return;
+				}
+				return ( typeof handler === "string" ? instance[ handler ] : handler )
+					.apply( instance, arguments );
+			}
+
+			// copy the guid so direct unbinding works
+			if ( typeof handler !== "string" ) {
+				handlerProxy.guid = handler.guid =
+					handler.guid || handlerProxy.guid || $.guid++;
+			}
+
+			var match = event.match( /^([\w:-]*)\s*(.*)$/ ),
+				eventName = match[1] + instance.eventNamespace,
+				selector = match[2];
+			if ( selector ) {
+				delegateElement.delegate( selector, eventName, handlerProxy );
+			} else {
+				element.bind( eventName, handlerProxy );
+			}
+		});
+	},
+
+	_off: function( element, eventName ) {
+		eventName = (eventName || "").split( " " ).join( this.eventNamespace + " " ) +
+			this.eventNamespace;
+		element.unbind( eventName ).undelegate( eventName );
+
+		// Clear the stack to avoid memory leaks (#10056)
+		this.bindings = $( this.bindings.not( element ).get() );
+		this.focusable = $( this.focusable.not( element ).get() );
+		this.hoverable = $( this.hoverable.not( element ).get() );
+	},
+
+	_delay: function( handler, delay ) {
+		function handlerProxy() {
+			return ( typeof handler === "string" ? instance[ handler ] : handler )
+				.apply( instance, arguments );
+		}
+		var instance = this;
+		return setTimeout( handlerProxy, delay || 0 );
+	},
+
+	_hoverable: function( element ) {
+		this.hoverable = this.hoverable.add( element );
+		this._on( element, {
+			mouseenter: function( event ) {
+				$( event.currentTarget ).addClass( "ui-state-hover" );
+			},
+			mouseleave: function( event ) {
+				$( event.currentTarget ).removeClass( "ui-state-hover" );
+			}
+		});
+	},
+
+	_focusable: function( element ) {
+		this.focusable = this.focusable.add( element );
+		this._on( element, {
+			focusin: function( event ) {
+				$( event.currentTarget ).addClass( "ui-state-focus" );
+			},
+			focusout: function( event ) {
+				$( event.currentTarget ).removeClass( "ui-state-focus" );
+			}
+		});
+	},
+
+	_trigger: function( type, event, data ) {
+		var prop, orig,
+			callback = this.options[ type ];
+
+		data = data || {};
+		event = $.Event( event );
+		event.type = ( type === this.widgetEventPrefix ?
+			type :
+			this.widgetEventPrefix + type ).toLowerCase();
+		// the original event may come from any element
+		// so we need to reset the target on the new event
+		event.target = this.element[ 0 ];
+
+		// copy original event properties over to the new event
+		orig = event.originalEvent;
+		if ( orig ) {
+			for ( prop in orig ) {
+				if ( !( prop in event ) ) {
+					event[ prop ] = orig[ prop ];
+				}
+			}
+		}
+
+		this.element.trigger( event, data );
+		return !( $.isFunction( callback ) &&
+			callback.apply( this.element[0], [ event ].concat( data ) ) === false ||
+			event.isDefaultPrevented() );
+	}
+};
+
+$.each( { show: "fadeIn", hide: "fadeOut" }, function( method, defaultEffect ) {
+	$.Widget.prototype[ "_" + method ] = function( element, options, callback ) {
+		if ( typeof options === "string" ) {
+			options = { effect: options };
+		}
+		var hasOptions,
+			effectName = !options ?
+				method :
+				options === true || typeof options === "number" ?
+					defaultEffect :
+					options.effect || defaultEffect;
+		options = options || {};
+		if ( typeof options === "number" ) {
+			options = { duration: options };
+		}
+		hasOptions = !$.isEmptyObject( options );
+		options.complete = callback;
+		if ( options.delay ) {
+			element.delay( options.delay );
+		}
+		if ( hasOptions && $.effects && $.effects.effect[ effectName ] ) {
+			element[ method ]( options );
+		} else if ( effectName !== method && element[ effectName ] ) {
+			element[ effectName ]( options.duration, options.easing, callback );
+		} else {
+			element.queue(function( next ) {
+				$( this )[ method ]();
+				if ( callback ) {
+					callback.call( element[ 0 ] );
+				}
+				next();
+			});
+		}
+	};
+});
+
+var widget = $.widget;
+
+
+/*!
+ * jQuery UI Position 1.11.4
+ * http://jqueryui.com
+ *
+ * Copyright jQuery Foundation and other contributors
+ * Released under the MIT license.
+ * http://jquery.org/license
+ *
+ * http://api.jqueryui.com/position/
+ */
+
+(function() {
+
+$.ui = $.ui || {};
+
+var cachedScrollbarWidth, supportsOffsetFractions,
+	max = Math.max,
+	abs = Math.abs,
+	round = Math.round,
+	rhorizontal = /left|center|right/,
+	rvertical = /top|center|bottom/,
+	roffset = /[\+\-]\d+(\.[\d]+)?%?/,
+	rposition = /^\w+/,
+	rpercent = /%$/,
+	_position = $.fn.position;
+
+function getOffsets( offsets, width, height ) {
+	return [
+		parseFloat( offsets[ 0 ] ) * ( rpercent.test( offsets[ 0 ] ) ? width / 100 : 1 ),
+		parseFloat( offsets[ 1 ] ) * ( rpercent.test( offsets[ 1 ] ) ? height / 100 : 1 )
+	];
+}
+
+function parseCss( element, property ) {
+	return parseInt( $.css( element, property ), 10 ) || 0;
+}
+
+function getDimensions( elem ) {
+	var raw = elem[0];
+	if ( raw.nodeType === 9 ) {
+		return {
+			width: elem.width(),
+			height: elem.height(),
+			offset: { top: 0, left: 0 }
+		};
+	}
+	if ( $.isWindow( raw ) ) {
+		return {
+			width: elem.width(),
+			height: elem.height(),
+			offset: { top: elem.scrollTop(), left: elem.scrollLeft() }
+		};
+	}
+	if ( raw.preventDefault ) {
+		return {
+			width: 0,
+			height: 0,
+			offset: { top: raw.pageY, left: raw.pageX }
+		};
+	}
+	return {
+		width: elem.outerWidth(),
+		height: elem.outerHeight(),
+		offset: elem.offset()
+	};
+}
+
+$.position = {
+	scrollbarWidth: function() {
+		if ( cachedScrollbarWidth !== undefined ) {
+			return cachedScrollbarWidth;
+		}
+		var w1, w2,
+			div = $( "<div style='display:block;position:absolute;width:50px;height:50px;overflow:hidden;'><div style='height:100px;width:auto;'></div></div>" ),
+			innerDiv = div.children()[0];
+
+		$( "body" ).append( div );
+		w1 = innerDiv.offsetWidth;
+		div.css( "overflow", "scroll" );
+
+		w2 = innerDiv.offsetWidth;
+
+		if ( w1 === w2 ) {
+			w2 = div[0].clientWidth;
+		}
+
+		div.remove();
+
+		return (cachedScrollbarWidth = w1 - w2);
+	},
+	getScrollInfo: function( within ) {
+		var overflowX = within.isWindow || within.isDocument ? "" :
+				within.element.css( "overflow-x" ),
+			overflowY = within.isWindow || within.isDocument ? "" :
+				within.element.css( "overflow-y" ),
+			hasOverflowX = overflowX === "scroll" ||
+				( overflowX === "auto" && within.width < within.element[0].scrollWidth ),
+			hasOverflowY = overflowY === "scroll" ||
+				( overflowY === "auto" && within.height < within.element[0].scrollHeight );
+		return {
+			width: hasOverflowY ? $.position.scrollbarWidth() : 0,
+			height: hasOverflowX ? $.position.scrollbarWidth() : 0
+		};
+	},
+	getWithinInfo: function( element ) {
+		var withinElement = $( element || window ),
+			isWindow = $.isWindow( withinElement[0] ),
+			isDocument = !!withinElement[ 0 ] && withinElement[ 0 ].nodeType === 9;
+		return {
+			element: withinElement,
+			isWindow: isWindow,
+			isDocument: isDocument,
+			offset: withinElement.offset() || { left: 0, top: 0 },
+			scrollLeft: withinElement.scrollLeft(),
+			scrollTop: withinElement.scrollTop(),
+
+			// support: jQuery 1.6.x
+			// jQuery 1.6 doesn't support .outerWidth/Height() on documents or windows
+			width: isWindow || isDocument ? withinElement.width() : withinElement.outerWidth(),
+			height: isWindow || isDocument ? withinElement.height() : withinElement.outerHeight()
+		};
+	}
+};
+
+$.fn.position = function( options ) {
+	if ( !options || !options.of ) {
+		return _position.apply( this, arguments );
+	}
+
+	// make a copy, we don't want to modify arguments
+	options = $.extend( {}, options );
+
+	var atOffset, targetWidth, targetHeight, targetOffset, basePosition, dimensions,
+		target = $( options.of ),
+		within = $.position.getWithinInfo( options.within ),
+		scrollInfo = $.position.getScrollInfo( within ),
+		collision = ( options.collision || "flip" ).split( " " ),
+		offsets = {};
+
+	dimensions = getDimensions( target );
+	if ( target[0].preventDefault ) {
+		// force left top to allow flipping
+		options.at = "left top";
+	}
+	targetWidth = dimensions.width;
+	targetHeight = dimensions.height;
+	targetOffset = dimensions.offset;
+	// clone to reuse original targetOffset later
+	basePosition = $.extend( {}, targetOffset );
+
+	// force my and at to have valid horizontal and vertical positions
+	// if a value is missing or invalid, it will be converted to center
+	$.each( [ "my", "at" ], function() {
+		var pos = ( options[ this ] || "" ).split( " " ),
+			horizontalOffset,
+			verticalOffset;
+
+		if ( pos.length === 1) {
+			pos = rhorizontal.test( pos[ 0 ] ) ?
+				pos.concat( [ "center" ] ) :
+				rvertical.test( pos[ 0 ] ) ?
+					[ "center" ].concat( pos ) :
+					[ "center", "center" ];
+		}
+		pos[ 0 ] = rhorizontal.test( pos[ 0 ] ) ? pos[ 0 ] : "center";
+		pos[ 1 ] = rvertical.test( pos[ 1 ] ) ? pos[ 1 ] : "center";
+
+		// calculate offsets
+		horizontalOffset = roffset.exec( pos[ 0 ] );
+		verticalOffset = roffset.exec( pos[ 1 ] );
+		offsets[ this ] = [
+			horizontalOffset ? horizontalOffset[ 0 ] : 0,
+			verticalOffset ? verticalOffset[ 0 ] : 0
+		];
+
+		// reduce to just the positions without the offsets
+		options[ this ] = [
+			rposition.exec( pos[ 0 ] )[ 0 ],
+			rposition.exec( pos[ 1 ] )[ 0 ]
+		];
+	});
+
+	// normalize collision option
+	if ( collision.length === 1 ) {
+		collision[ 1 ] = collision[ 0 ];
+	}
+
+	if ( options.at[ 0 ] === "right" ) {
+		basePosition.left += targetWidth;
+	} else if ( options.at[ 0 ] === "center" ) {
+		basePosition.left += targetWidth / 2;
+	}
+
+	if ( options.at[ 1 ] === "bottom" ) {
+		basePosition.top += targetHeight;
+	} else if ( options.at[ 1 ] === "center" ) {
+		basePosition.top += targetHeight / 2;
+	}
+
+	atOffset = getOffsets( offsets.at, targetWidth, targetHeight );
+	basePosition.left += atOffset[ 0 ];
+	basePosition.top += atOffset[ 1 ];
+
+	return this.each(function() {
+		var collisionPosition, using,
+			elem = $( this ),
+			elemWidth = elem.outerWidth(),
+			elemHeight = elem.outerHeight(),
+			marginLeft = parseCss( this, "marginLeft" ),
+			marginTop = parseCss( this, "marginTop" ),
+			collisionWidth = elemWidth + marginLeft + parseCss( this, "marginRight" ) + scrollInfo.width,
+			collisionHeight = elemHeight + marginTop + parseCss( this, "marginBottom" ) + scrollInfo.height,
+			position = $.extend( {}, basePosition ),
+			myOffset = getOffsets( offsets.my, elem.outerWidth(), elem.outerHeight() );
+
+		if ( options.my[ 0 ] === "right" ) {
+			position.left -= elemWidth;
+		} else if ( options.my[ 0 ] === "center" ) {
+			position.left -= elemWidth / 2;
+		}
+
+		if ( options.my[ 1 ] === "bottom" ) {
+			position.top -= elemHeight;
+		} else if ( options.my[ 1 ] === "center" ) {
+			position.top -= elemHeight / 2;
+		}
+
+		position.left += myOffset[ 0 ];
+		position.top += myOffset[ 1 ];
+
+		// if the browser doesn't support fractions, then round for consistent results
+		if ( !supportsOffsetFractions ) {
+			position.left = round( position.left );
+			position.top = round( position.top );
+		}
+
+		collisionPosition = {
+			marginLeft: marginLeft,
+			marginTop: marginTop
+		};
+
+		$.each( [ "left", "top" ], function( i, dir ) {
+			if ( $.ui.position[ collision[ i ] ] ) {
+				$.ui.position[ collision[ i ] ][ dir ]( position, {
+					targetWidth: targetWidth,
+					targetHeight: targetHeight,
+					elemWidth: elemWidth,
+					elemHeight: elemHeight,
+					collisionPosition: collisionPosition,
+					collisionWidth: collisionWidth,
+					collisionHeight: collisionHeight,
+					offset: [ atOffset[ 0 ] + myOffset[ 0 ], atOffset [ 1 ] + myOffset[ 1 ] ],
+					my: options.my,
+					at: options.at,
+					within: within,
+					elem: elem
+				});
+			}
+		});
+
+		if ( options.using ) {
+			// adds feedback as second argument to using callback, if present
+			using = function( props ) {
+				var left = targetOffset.left - position.left,
+					right = left + targetWidth - elemWidth,
+					top = targetOffset.top - position.top,
+					bottom = top + targetHeight - elemHeight,
+					feedback = {
+						target: {
+							element: target,
+							left: targetOffset.left,
+							top: targetOffset.top,
+							width: targetWidth,
+							height: targetHeight
+						},
+						element: {
+							element: elem,
+							left: position.left,
+							top: position.top,
+							width: elemWidth,
+							height: elemHeight
+						},
+						horizontal: right < 0 ? "left" : left > 0 ? "right" : "center",
+						vertical: bottom < 0 ? "top" : top > 0 ? "bottom" : "middle"
+					};
+				if ( targetWidth < elemWidth && abs( left + right ) < targetWidth ) {
+					feedback.horizontal = "center";
+				}
+				if ( targetHeight < elemHeight && abs( top + bottom ) < targetHeight ) {
+					feedback.vertical = "middle";
+				}
+				if ( max( abs( left ), abs( right ) ) > max( abs( top ), abs( bottom ) ) ) {
+					feedback.important = "horizontal";
+				} else {
+					feedback.important = "vertical";
+				}
+				options.using.call( this, props, feedback );
+			};
+		}
+
+		elem.offset( $.extend( position, { using: using } ) );
+	});
+};
+
+$.ui.position = {
+	fit: {
+		left: function( position, data ) {
+			var within = data.within,
+				withinOffset = within.isWindow ? within.scrollLeft : within.offset.left,
+				outerWidth = within.width,
+				collisionPosLeft = position.left - data.collisionPosition.marginLeft,
+				overLeft = withinOffset - collisionPosLeft,
+				overRight = collisionPosLeft + data.collisionWidth - outerWidth - withinOffset,
+				newOverRight;
+
+			// element is wider than within
+			if ( data.collisionWidth > outerWidth ) {
+				// element is initially over the left side of within
+				if ( overLeft > 0 && overRight <= 0 ) {
+					newOverRight = position.left + overLeft + data.collisionWidth - outerWidth - withinOffset;
+					position.left += overLeft - newOverRight;
+				// element is initially over right side of within
+				} else if ( overRight > 0 && overLeft <= 0 ) {
+					position.left = withinOffset;
+				// element is initially over both left and right sides of within
+				} else {
+					if ( overLeft > overRight ) {
+						position.left = withinOffset + outerWidth - data.collisionWidth;
+					} else {
+						position.left = withinOffset;
+					}
+				}
+			// too far left -> align with left edge
+			} else if ( overLeft > 0 ) {
+				position.left += overLeft;
+			// too far right -> align with right edge
+			} else if ( overRight > 0 ) {
+				position.left -= overRight;
+			// adjust based on position and margin
+			} else {
+				position.left = max( position.left - collisionPosLeft, position.left );
+			}
+		},
+		top: function( position, data ) {
+			var within = data.within,
+				withinOffset = within.isWindow ? within.scrollTop : within.offset.top,
+				outerHeight = data.within.height,
+				collisionPosTop = position.top - data.collisionPosition.marginTop,
+				overTop = withinOffset - collisionPosTop,
+				overBottom = collisionPosTop + data.collisionHeight - outerHeight - withinOffset,
+				newOverBottom;
+
+			// element is taller than within
+			if ( data.collisionHeight > outerHeight ) {
+				// element is initially over the top of within
+				if ( overTop > 0 && overBottom <= 0 ) {
+					newOverBottom = position.top + overTop + data.collisionHeight - outerHeight - withinOffset;
+					position.top += overTop - newOverBottom;
+				// element is initially over bottom of within
+				} else if ( overBottom > 0 && overTop <= 0 ) {
+					position.top = withinOffset;
+				// element is initially over both top and bottom of within
+				} else {
+					if ( overTop > overBottom ) {
+						position.top = withinOffset + outerHeight - data.collisionHeight;
+					} else {
+						position.top = withinOffset;
+					}
+				}
+			// too far up -> align with top
+			} else if ( overTop > 0 ) {
+				position.top += overTop;
+			// too far down -> align with bottom edge
+			} else if ( overBottom > 0 ) {
+				position.top -= overBottom;
+			// adjust based on position and margin
+			} else {
+				position.top = max( position.top - collisionPosTop, position.top );
+			}
+		}
+	},
+	flip: {
+		left: function( position, data ) {
+			var within = data.within,
+				withinOffset = within.offset.left + within.scrollLeft,
+				outerWidth = within.width,
+				offsetLeft = within.isWindow ? within.scrollLeft : within.offset.left,
+				collisionPosLeft = position.left - data.collisionPosition.marginLeft,
+				overLeft = collisionPosLeft - offsetLeft,
+				overRight = collisionPosLeft + data.collisionWidth - outerWidth - offsetLeft,
+				myOffset = data.my[ 0 ] === "left" ?
+					-data.elemWidth :
+					data.my[ 0 ] === "right" ?
+						data.elemWidth :
+						0,
+				atOffset = data.at[ 0 ] === "left" ?
+					data.targetWidth :
+					data.at[ 0 ] === "right" ?
+						-data.targetWidth :
+						0,
+				offset = -2 * data.offset[ 0 ],
+				newOverRight,
+				newOverLeft;
+
+			if ( overLeft < 0 ) {
+				newOverRight = position.left + myOffset + atOffset + offset + data.collisionWidth - outerWidth - withinOffset;
+				if ( newOverRight < 0 || newOverRight < abs( overLeft ) ) {
+					position.left += myOffset + atOffset + offset;
+				}
+			} else if ( overRight > 0 ) {
+				newOverLeft = position.left - data.collisionPosition.marginLeft + myOffset + atOffset + offset - offsetLeft;
+				if ( newOverLeft > 0 || abs( newOverLeft ) < overRight ) {
+					position.left += myOffset + atOffset + offset;
+				}
+			}
+		},
+		top: function( position, data ) {
+			var within = data.within,
+				withinOffset = within.offset.top + within.scrollTop,
+				outerHeight = within.height,
+				offsetTop = within.isWindow ? within.scrollTop : within.offset.top,
+				collisionPosTop = position.top - data.collisionPosition.marginTop,
+				overTop = collisionPosTop - offsetTop,
+				overBottom = collisionPosTop + data.collisionHeight - outerHeight - offsetTop,
+				top = data.my[ 1 ] === "top",
+				myOffset = top ?
+					-data.elemHeight :
+					data.my[ 1 ] === "bottom" ?
+						data.elemHeight :
+						0,
+				atOffset = data.at[ 1 ] === "top" ?
+					data.targetHeight :
+					data.at[ 1 ] === "bottom" ?
+						-data.targetHeight :
+						0,
+				offset = -2 * data.offset[ 1 ],
+				newOverTop,
+				newOverBottom;
+			if ( overTop < 0 ) {
+				newOverBottom = position.top + myOffset + atOffset + offset + data.collisionHeight - outerHeight - withinOffset;
+				if ( newOverBottom < 0 || newOverBottom < abs( overTop ) ) {
+					position.top += myOffset + atOffset + offset;
+				}
+			} else if ( overBottom > 0 ) {
+				newOverTop = position.top - data.collisionPosition.marginTop + myOffset + atOffset + offset - offsetTop;
+				if ( newOverTop > 0 || abs( newOverTop ) < overBottom ) {
+					position.top += myOffset + atOffset + offset;
+				}
+			}
+		}
+	},
+	flipfit: {
+		left: function() {
+			$.ui.position.flip.left.apply( this, arguments );
+			$.ui.position.fit.left.apply( this, arguments );
+		},
+		top: function() {
+			$.ui.position.flip.top.apply( this, arguments );
+			$.ui.position.fit.top.apply( this, arguments );
+		}
+	}
+};
+
+// fraction support test
+(function() {
+	var testElement, testElementParent, testElementStyle, offsetLeft, i,
+		body = document.getElementsByTagName( "body" )[ 0 ],
+		div = document.createElement( "div" );
+
+	//Create a "fake body" for testing based on method used in jQuery.support
+	testElement = document.createElement( body ? "div" : "body" );
+	testElementStyle = {
+		visibility: "hidden",
+		width: 0,
+		height: 0,
+		border: 0,
+		margin: 0,
+		background: "none"
+	};
+	if ( body ) {
+		$.extend( testElementStyle, {
+			position: "absolute",
+			left: "-1000px",
+			top: "-1000px"
+		});
+	}
+	for ( i in testElementStyle ) {
+		testElement.style[ i ] = testElementStyle[ i ];
+	}
+	testElement.appendChild( div );
+	testElementParent = body || document.documentElement;
+	testElementParent.insertBefore( testElement, testElementParent.firstChild );
+
+	div.style.cssText = "position: absolute; left: 10.7432222px;";
+
+	offsetLeft = $( div ).offset().left;
+	supportsOffsetFractions = offsetLeft > 10 && offsetLeft < 11;
+
+	testElement.innerHTML = "";
+	testElementParent.removeChild( testElement );
+})();
+
+})();
+
+var position = $.ui.position;
+
+
+/*!
+ * jQuery UI Menu 1.11.4
+ * http://jqueryui.com
+ *
+ * Copyright jQuery Foundation and other contributors
+ * Released under the MIT license.
+ * http://jquery.org/license
+ *
+ * http://api.jqueryui.com/menu/
+ */
+
+
+var menu = $.widget( "ui.menu", {
+	version: "1.11.4",
+	defaultElement: "<ul>",
+	delay: 300,
+	options: {
+		icons: {
+			submenu: "ui-icon-carat-1-e"
+		},
+		items: "> *",
+		menus: "ul",
+		position: {
+			my: "left-1 top",
+			at: "right top"
+		},
+		role: "menu",
+
+		// callbacks
+		blur: null,
+		focus: null,
+		select: null
+	},
+
+	_create: function() {
+		this.activeMenu = this.element;
+
+		// Flag used to prevent firing of the click handler
+		// as the event bubbles up through nested menus
+		this.mouseHandled = false;
+		this.element
+			.uniqueId()
+			.addClass( "ui-menu ui-widget ui-widget-content" )
+			.toggleClass( "ui-menu-icons", !!this.element.find( ".ui-icon" ).length )
+			.attr({
+				role: this.options.role,
+				tabIndex: 0
+			});
+
+		if ( this.options.disabled ) {
+			this.element
+				.addClass( "ui-state-disabled" )
+				.attr( "aria-disabled", "true" );
+		}
+
+		this._on({
+			// Prevent focus from sticking to links inside menu after clicking
+			// them (focus should always stay on UL during navigation).
+			"mousedown .ui-menu-item": function( event ) {
+				event.preventDefault();
+			},
+			"click .ui-menu-item": function( event ) {
+				var target = $( event.target );
+				if ( !this.mouseHandled && target.not( ".ui-state-disabled" ).length ) {
+					this.select( event );
+
+					// Only set the mouseHandled flag if the event will bubble, see #9469.
+					if ( !event.isPropagationStopped() ) {
+						this.mouseHandled = true;
+					}
+
+					// Open submenu on click
+					if ( target.has( ".ui-menu" ).length ) {
+						this.expand( event );
+					} else if ( !this.element.is( ":focus" ) && $( this.document[ 0 ].activeElement ).closest( ".ui-menu" ).length ) {
+
+						// Redirect focus to the menu
+						this.element.trigger( "focus", [ true ] );
+
+						// If the active item is on the top level, let it stay active.
+						// Otherwise, blur the active item since it is no longer visible.
+						if ( this.active && this.active.parents( ".ui-menu" ).length === 1 ) {
+							clearTimeout( this.timer );
+						}
+					}
+				}
+			},
+			"mouseenter .ui-menu-item": function( event ) {
+				// Ignore mouse events while typeahead is active, see #10458.
+				// Prevents focusing the wrong item when typeahead causes a scroll while the mouse
+				// is over an item in the menu
+				if ( this.previousFilter ) {
+					return;
+				}
+				var target = $( event.currentTarget );
+				// Remove ui-state-active class from siblings of the newly focused menu item
+				// to avoid a jump caused by adjacent elements both having a class with a border
+				target.siblings( ".ui-state-active" ).removeClass( "ui-state-active" );
+				this.focus( event, target );
+			},
+			mouseleave: "collapseAll",
+			"mouseleave .ui-menu": "collapseAll",
+			focus: function( event, keepActiveItem ) {
+				// If there's already an active item, keep it active
+				// If not, activate the first item
+				var item = this.active || this.element.find( this.options.items ).eq( 0 );
+
+				if ( !keepActiveItem ) {
+					this.focus( event, item );
+				}
+			},
+			blur: function( event ) {
+				this._delay(function() {
+					if ( !$.contains( this.element[0], this.document[0].activeElement ) ) {
+						this.collapseAll( event );
+					}
+				});
+			},
+			keydown: "_keydown"
+		});
+
+		this.refresh();
+
+		// Clicks outside of a menu collapse any open menus
+		this._on( this.document, {
+			click: function( event ) {
+				if ( this._closeOnDocumentClick( event ) ) {
+					this.collapseAll( event );
+				}
+
+				// Reset the mouseHandled flag
+				this.mouseHandled = false;
+			}
+		});
+	},
+
+	_destroy: function() {
+		// Destroy (sub)menus
+		this.element
+			.removeAttr( "aria-activedescendant" )
+			.find( ".ui-menu" ).addBack()
+				.removeClass( "ui-menu ui-widget ui-widget-content ui-menu-icons ui-front" )
+				.removeAttr( "role" )
+				.removeAttr( "tabIndex" )
+				.removeAttr( "aria-labelledby" )
+				.removeAttr( "aria-expanded" )
+				.removeAttr( "aria-hidden" )
+				.removeAttr( "aria-disabled" )
+				.removeUniqueId()
+				.show();
+
+		// Destroy menu items
+		this.element.find( ".ui-menu-item" )
+			.removeClass( "ui-menu-item" )
+			.removeAttr( "role" )
+			.removeAttr( "aria-disabled" )
+			.removeUniqueId()
+			.removeClass( "ui-state-hover" )
+			.removeAttr( "tabIndex" )
+			.removeAttr( "role" )
+			.removeAttr( "aria-haspopup" )
+			.children().each( function() {
+				var elem = $( this );
+				if ( elem.data( "ui-menu-submenu-carat" ) ) {
+					elem.remove();
+				}
+			});
+
+		// Destroy menu dividers
+		this.element.find( ".ui-menu-divider" ).removeClass( "ui-menu-divider ui-widget-content" );
+	},
+
+	_keydown: function( event ) {
+		var match, prev, character, skip,
+			preventDefault = true;
+
+		switch ( event.keyCode ) {
+		case $.ui.keyCode.PAGE_UP:
+			this.previousPage( event );
+			break;
+		case $.ui.keyCode.PAGE_DOWN:
+			this.nextPage( event );
+			break;
+		case $.ui.keyCode.HOME:
+			this._move( "first", "first", event );
+			break;
+		case $.ui.keyCode.END:
+			this._move( "last", "last", event );
+			break;
+		case $.ui.keyCode.UP:
+			this.previous( event );
+			break;
+		case $.ui.keyCode.DOWN:
+			this.next( event );
+			break;
+		case $.ui.keyCode.LEFT:
+			this.collapse( event );
+			break;
+		case $.ui.keyCode.RIGHT:
+			if ( this.active && !this.active.is( ".ui-state-disabled" ) ) {
+				this.expand( event );
+			}
+			break;
+		case $.ui.keyCode.ENTER:
+		case $.ui.keyCode.SPACE:
+			this._activate( event );
+			break;
+		case $.ui.keyCode.ESCAPE:
+			this.collapse( event );
+			break;
+		default:
+			preventDefault = false;
+			prev = this.previousFilter || "";
+			character = String.fromCharCode( event.keyCode );
+			skip = false;
+
+			clearTimeout( this.filterTimer );
+
+			if ( character === prev ) {
+				skip = true;
+			} else {
+				character = prev + character;
+			}
+
+			match = this._filterMenuItems( character );
+			match = skip && match.index( this.active.next() ) !== -1 ?
+				this.active.nextAll( ".ui-menu-item" ) :
+				match;
+
+			// If no matches on the current filter, reset to the last character pressed
+			// to move down the menu to the first item that starts with that character
+			if ( !match.length ) {
+				character = String.fromCharCode( event.keyCode );
+				match = this._filterMenuItems( character );
+			}
+
+			if ( match.length ) {
+				this.focus( event, match );
+				this.previousFilter = character;
+				this.filterTimer = this._delay(function() {
+					delete this.previousFilter;
+				}, 1000 );
+			} else {
+				delete this.previousFilter;
+			}
+		}
+
+		if ( preventDefault ) {
+			event.preventDefault();
+		}
+	},
+
+	_activate: function( event ) {
+		if ( !this.active.is( ".ui-state-disabled" ) ) {
+			if ( this.active.is( "[aria-haspopup='true']" ) ) {
+				this.expand( event );
+			} else {
+				this.select( event );
+			}
+		}
+	},
+
+	refresh: function() {
+		var menus, items,
+			that = this,
+			icon = this.options.icons.submenu,
+			submenus = this.element.find( this.options.menus );
+
+		this.element.toggleClass( "ui-menu-icons", !!this.element.find( ".ui-icon" ).length );
+
+		// Initialize nested menus
+		submenus.filter( ":not(.ui-menu)" )
+			.addClass( "ui-menu ui-widget ui-widget-content ui-front" )
+			.hide()
+			.attr({
+				role: this.options.role,
+				"aria-hidden": "true",
+				"aria-expanded": "false"
+			})
+			.each(function() {
+				var menu = $( this ),
+					item = menu.parent(),
+					submenuCarat = $( "<span>" )
+						.addClass( "ui-menu-icon ui-icon " + icon )
+						.data( "ui-menu-submenu-carat", true );
+
+				item
+					.attr( "aria-haspopup", "true" )
+					.prepend( submenuCarat );
+				menu.attr( "aria-labelledby", item.attr( "id" ) );
+			});
+
+		menus = submenus.add( this.element );
+		items = menus.find( this.options.items );
+
+		// Initialize menu-items containing spaces and/or dashes only as dividers
+		items.not( ".ui-menu-item" ).each(function() {
+			var item = $( this );
+			if ( that._isDivider( item ) ) {
+				item.addClass( "ui-widget-content ui-menu-divider" );
+			}
+		});
+
+		// Don't refresh list items that are already adapted
+		items.not( ".ui-menu-item, .ui-menu-divider" )
+			.addClass( "ui-menu-item" )
+			.uniqueId()
+			.attr({
+				tabIndex: -1,
+				role: this._itemRole()
+			});
+
+		// Add aria-disabled attribute to any disabled menu item
+		items.filter( ".ui-state-disabled" ).attr( "aria-disabled", "true" );
+
+		// If the active item has been removed, blur the menu
+		if ( this.active && !$.contains( this.element[ 0 ], this.active[ 0 ] ) ) {
+			this.blur();
+		}
+	},
+
+	_itemRole: function() {
+		return {
+			menu: "menuitem",
+			listbox: "option"
+		}[ this.options.role ];
+	},
+
+	_setOption: function( key, value ) {
+		if ( key === "icons" ) {
+			this.element.find( ".ui-menu-icon" )
+				.removeClass( this.options.icons.submenu )
+				.addClass( value.submenu );
+		}
+		if ( key === "disabled" ) {
+			this.element
+				.toggleClass( "ui-state-disabled", !!value )
+				.attr( "aria-disabled", value );
+		}
+		this._super( key, value );
+	},
+
+	focus: function( event, item ) {
+		var nested, focused;
+		this.blur( event, event && event.type === "focus" );
+
+		this._scrollIntoView( item );
+
+		this.active = item.first();
+		focused = this.active.addClass( "ui-state-focus" ).removeClass( "ui-state-active" );
+		// Only update aria-activedescendant if there's a role
+		// otherwise we assume focus is managed elsewhere
+		if ( this.options.role ) {
+			this.element.attr( "aria-activedescendant", focused.attr( "id" ) );
+		}
+
+		// Highlight active parent menu item, if any
+		this.active
+			.parent()
+			.closest( ".ui-menu-item" )
+			.addClass( "ui-state-active" );
+
+		if ( event && event.type === "keydown" ) {
+			this._close();
+		} else {
+			this.timer = this._delay(function() {
+				this._close();
+			}, this.delay );
+		}
+
+		nested = item.children( ".ui-menu" );
+		if ( nested.length && event && ( /^mouse/.test( event.type ) ) ) {
+			this._startOpening(nested);
+		}
+		this.activeMenu = item.parent();
+
+		this._trigger( "focus", event, { item: item } );
+	},
+
+	_scrollIntoView: function( item ) {
+		var borderTop, paddingTop, offset, scroll, elementHeight, itemHeight;
+		if ( this._hasScroll() ) {
+			borderTop = parseFloat( $.css( this.activeMenu[0], "borderTopWidth" ) ) || 0;
+			paddingTop = parseFloat( $.css( this.activeMenu[0], "paddingTop" ) ) || 0;
+			offset = item.offset().top - this.activeMenu.offset().top - borderTop - paddingTop;
+			scroll = this.activeMenu.scrollTop();
+			elementHeight = this.activeMenu.height();
+			itemHeight = item.outerHeight();
+
+			if ( offset < 0 ) {
+				this.activeMenu.scrollTop( scroll + offset );
+			} else if ( offset + itemHeight > elementHeight ) {
+				this.activeMenu.scrollTop( scroll + offset - elementHeight + itemHeight );
+			}
+		}
+	},
+
+	blur: function( event, fromFocus ) {
+		if ( !fromFocus ) {
+			clearTimeout( this.timer );
+		}
+
+		if ( !this.active ) {
+			return;
+		}
+
+		this.active.removeClass( "ui-state-focus" );
+		this.active = null;
+
+		this._trigger( "blur", event, { item: this.active } );
+	},
+
+	_startOpening: function( submenu ) {
+		clearTimeout( this.timer );
+
+		// Don't open if already open fixes a Firefox bug that caused a .5 pixel
+		// shift in the submenu position when mousing over the carat icon
+		if ( submenu.attr( "aria-hidden" ) !== "true" ) {
+			return;
+		}
+
+		this.timer = this._delay(function() {
+			this._close();
+			this._open( submenu );
+		}, this.delay );
+	},
+
+	_open: function( submenu ) {
+		var position = $.extend({
+			of: this.active
+		}, this.options.position );
+
+		clearTimeout( this.timer );
+		this.element.find( ".ui-menu" ).not( submenu.parents( ".ui-menu" ) )
+			.hide()
+			.attr( "aria-hidden", "true" );
+
+		submenu
+			.show()
+			.removeAttr( "aria-hidden" )
+			.attr( "aria-expanded", "true" )
+			.position( position );
+	},
+
+	collapseAll: function( event, all ) {
+		clearTimeout( this.timer );
+		this.timer = this._delay(function() {
+			// If we were passed an event, look for the submenu that contains the event
+			var currentMenu = all ? this.element :
+				$( event && event.target ).closest( this.element.find( ".ui-menu" ) );
+
+			// If we found no valid submenu ancestor, use the main menu to close all sub menus anyway
+			if ( !currentMenu.length ) {
+				currentMenu = this.element;
+			}
+
+			this._close( currentMenu );
+
+			this.blur( event );
+			this.activeMenu = currentMenu;
+		}, this.delay );
+	},
+
+	// With no arguments, closes the currently active menu - if nothing is active
+	// it closes all menus.  If passed an argument, it will search for menus BELOW
+	_close: function( startMenu ) {
+		if ( !startMenu ) {
+			startMenu = this.active ? this.active.parent() : this.element;
+		}
+
+		startMenu
+			.find( ".ui-menu" )
+				.hide()
+				.attr( "aria-hidden", "true" )
+				.attr( "aria-expanded", "false" )
+			.end()
+			.find( ".ui-state-active" ).not( ".ui-state-focus" )
+				.removeClass( "ui-state-active" );
+	},
+
+	_closeOnDocumentClick: function( event ) {
+		return !$( event.target ).closest( ".ui-menu" ).length;
+	},
+
+	_isDivider: function( item ) {
+
+		// Match hyphen, em dash, en dash
+		return !/[^\-\u2014\u2013\s]/.test( item.text() );
+	},
+
+	collapse: function( event ) {
+		var newItem = this.active &&
+			this.active.parent().closest( ".ui-menu-item", this.element );
+		if ( newItem && newItem.length ) {
+			this._close();
+			this.focus( event, newItem );
+		}
+	},
+
+	expand: function( event ) {
+		var newItem = this.active &&
+			this.active
+				.children( ".ui-menu " )
+				.find( this.options.items )
+				.first();
+
+		if ( newItem && newItem.length ) {
+			this._open( newItem.parent() );
+
+			// Delay so Firefox will not hide activedescendant change in expanding submenu from AT
+			this._delay(function() {
+				this.focus( event, newItem );
+			});
+		}
+	},
+
+	next: function( event ) {
+		this._move( "next", "first", event );
+	},
+
+	previous: function( event ) {
+		this._move( "prev", "last", event );
+	},
+
+	isFirstItem: function() {
+		return this.active && !this.active.prevAll( ".ui-menu-item" ).length;
+	},
+
+	isLastItem: function() {
+		return this.active && !this.active.nextAll( ".ui-menu-item" ).length;
+	},
+
+	_move: function( direction, filter, event ) {
+		var next;
+		if ( this.active ) {
+			if ( direction === "first" || direction === "last" ) {
+				next = this.active
+					[ direction === "first" ? "prevAll" : "nextAll" ]( ".ui-menu-item" )
+					.eq( -1 );
+			} else {
+				next = this.active
+					[ direction + "All" ]( ".ui-menu-item" )
+					.eq( 0 );
+			}
+		}
+		if ( !next || !next.length || !this.active ) {
+			next = this.activeMenu.find( this.options.items )[ filter ]();
+		}
+
+		this.focus( event, next );
+	},
+
+	nextPage: function( event ) {
+		var item, base, height;
+
+		if ( !this.active ) {
+			this.next( event );
+			return;
+		}
+		if ( this.isLastItem() ) {
+			return;
+		}
+		if ( this._hasScroll() ) {
+			base = this.active.offset().top;
+			height = this.element.height();
+			this.active.nextAll( ".ui-menu-item" ).each(function() {
+				item = $( this );
+				return item.offset().top - base - height < 0;
+			});
+
+			this.focus( event, item );
+		} else {
+			this.focus( event, this.activeMenu.find( this.options.items )
+				[ !this.active ? "first" : "last" ]() );
+		}
+	},
+
+	previousPage: function( event ) {
+		var item, base, height;
+		if ( !this.active ) {
+			this.next( event );
+			return;
+		}
+		if ( this.isFirstItem() ) {
+			return;
+		}
+		if ( this._hasScroll() ) {
+			base = this.active.offset().top;
+			height = this.element.height();
+			this.active.prevAll( ".ui-menu-item" ).each(function() {
+				item = $( this );
+				return item.offset().top - base + height > 0;
+			});
+
+			this.focus( event, item );
+		} else {
+			this.focus( event, this.activeMenu.find( this.options.items ).first() );
+		}
+	},
+
+	_hasScroll: function() {
+		return this.element.outerHeight() < this.element.prop( "scrollHeight" );
+	},
+
+	select: function( event ) {
+		// TODO: It should never be possible to not have an active item at this
+		// point, but the tests don't trigger mouseenter before click.
+		this.active = this.active || $( event.target ).closest( ".ui-menu-item" );
+		var ui = { item: this.active };
+		if ( !this.active.has( ".ui-menu" ).length ) {
+			this.collapseAll( event, true );
+		}
+		this._trigger( "select", event, ui );
+	},
+
+	_filterMenuItems: function(character) {
+		var escapedCharacter = character.replace( /[\-\[\]{}()*+?.,\\\^$|#\s]/g, "\\$&" ),
+			regex = new RegExp( "^" + escapedCharacter, "i" );
+
+		return this.activeMenu
+			.find( this.options.items )
+
+			// Only match on items, not dividers or other content (#10571)
+			.filter( ".ui-menu-item" )
+			.filter(function() {
+				return regex.test( $.trim( $( this ).text() ) );
+			});
+	}
+});
+
+
+/*!
+ * jQuery UI Autocomplete 1.11.4
+ * http://jqueryui.com
+ *
+ * Copyright jQuery Foundation and other contributors
+ * Released under the MIT license.
+ * http://jquery.org/license
+ *
+ * http://api.jqueryui.com/autocomplete/
+ */
+
+
+$.widget( "ui.autocomplete", {
+	version: "1.11.4",
+	defaultElement: "<input>",
+	options: {
+		appendTo: null,
+		autoFocus: false,
+		delay: 300,
+		minLength: 1,
+		position: {
+			my: "left top",
+			at: "left bottom",
+			collision: "none"
+		},
+		source: null,
+
+		// callbacks
+		change: null,
+		close: null,
+		focus: null,
+		open: null,
+		response: null,
+		search: null,
+		select: null
+	},
+
+	requestIndex: 0,
+	pending: 0,
+
+	_create: function() {
+		// Some browsers only repeat keydown events, not keypress events,
+		// so we use the suppressKeyPress flag to determine if we've already
+		// handled the keydown event. #7269
+		// Unfortunately the code for & in keypress is the same as the up arrow,
+		// so we use the suppressKeyPressRepeat flag to avoid handling keypress
+		// events when we know the keydown event was used to modify the
+		// search term. #7799
+		var suppressKeyPress, suppressKeyPressRepeat, suppressInput,
+			nodeName = this.element[ 0 ].nodeName.toLowerCase(),
+			isTextarea = nodeName === "textarea",
+			isInput = nodeName === "input";
+
+		this.isMultiLine =
+			// Textareas are always multi-line
+			isTextarea ? true :
+			// Inputs are always single-line, even if inside a contentEditable element
+			// IE also treats inputs as contentEditable
+			isInput ? false :
+			// All other element types are determined by whether or not they're contentEditable
+			this.element.prop( "isContentEditable" );
+
+		this.valueMethod = this.element[ isTextarea || isInput ? "val" : "text" ];
+		this.isNewMenu = true;
+
+		this.element
+			.addClass( "ui-autocomplete-input" )
+			.attr( "autocomplete", "off" );
+
+		this._on( this.element, {
+			keydown: function( event ) {
+				if ( this.element.prop( "readOnly" ) ) {
+					suppressKeyPress = true;
+					suppressInput = true;
+					suppressKeyPressRepeat = true;
+					return;
+				}
+
+				suppressKeyPress = false;
+				suppressInput = false;
+				suppressKeyPressRepeat = false;
+				var keyCode = $.ui.keyCode;
+				switch ( event.keyCode ) {
+				case keyCode.PAGE_UP:
+					suppressKeyPress = true;
+					this._move( "previousPage", event );
+					break;
+				case keyCode.PAGE_DOWN:
+					suppressKeyPress = true;
+					this._move( "nextPage", event );
+					break;
+				case keyCode.UP:
+					suppressKeyPress = true;
+					this._keyEvent( "previous", event );
+					break;
+				case keyCode.DOWN:
+					suppressKeyPress = true;
+					this._keyEvent( "next", event );
+					break;
+				case keyCode.ENTER:
+					// when menu is open and has focus
+					if ( this.menu.active ) {
+						// #6055 - Opera still allows the keypress to occur
+						// which causes forms to submit
+						suppressKeyPress = true;
+						event.preventDefault();
+						this.menu.select( event );
+					}
+					break;
+				case keyCode.TAB:
+					if ( this.menu.active ) {
+						this.menu.select( event );
+					}
+					break;
+				case keyCode.ESCAPE:
+					if ( this.menu.element.is( ":visible" ) ) {
+						if ( !this.isMultiLine ) {
+							this._value( this.term );
+						}
+						this.close( event );
+						// Different browsers have different default behavior for escape
+						// Single press can mean undo or clear
+						// Double press in IE means clear the whole form
+						event.preventDefault();
+					}
+					break;
+				default:
+					suppressKeyPressRepeat = true;
+					// search timeout should be triggered before the input value is changed
+					this._searchTimeout( event );
+					break;
+				}
+			},
+			keypress: function( event ) {
+				if ( suppressKeyPress ) {
+					suppressKeyPress = false;
+					if ( !this.isMultiLine || this.menu.element.is( ":visible" ) ) {
+						event.preventDefault();
+					}
+					return;
+				}
+				if ( suppressKeyPressRepeat ) {
+					return;
+				}
+
+				// replicate some key handlers to allow them to repeat in Firefox and Opera
+				var keyCode = $.ui.keyCode;
+				switch ( event.keyCode ) {
+				case keyCode.PAGE_UP:
+					this._move( "previousPage", event );
+					break;
+				case keyCode.PAGE_DOWN:
+					this._move( "nextPage", event );
+					break;
+				case keyCode.UP:
+					this._keyEvent( "previous", event );
+					break;
+				case keyCode.DOWN:
+					this._keyEvent( "next", event );
+					break;
+				}
+			},
+			input: function( event ) {
+				if ( suppressInput ) {
+					suppressInput = false;
+					event.preventDefault();
+					return;
+				}
+				this._searchTimeout( event );
+			},
+			focus: function() {
+				this.selectedItem = null;
+				this.previous = this._value();
+			},
+			blur: function( event ) {
+				if ( this.cancelBlur ) {
+					delete this.cancelBlur;
+					return;
+				}
+
+				clearTimeout( this.searching );
+				this.close( event );
+				this._change( event );
+			}
+		});
+
+		this._initSource();
+		this.menu = $( "<ul>" )
+			.addClass( "ui-autocomplete ui-front" )
+			.appendTo( this._appendTo() )
+			.menu({
+				// disable ARIA support, the live region takes care of that
+				role: null
+			})
+			.hide()
+			.menu( "instance" );
+
+		this._on( this.menu.element, {
+			mousedown: function( event ) {
+				// prevent moving focus out of the text field
+				event.preventDefault();
+
+				// IE doesn't prevent moving focus even with event.preventDefault()
+				// so we set a flag to know when we should ignore the blur event
+				this.cancelBlur = true;
+				this._delay(function() {
+					delete this.cancelBlur;
+				});
+
+				// clicking on the scrollbar causes focus to shift to the body
+				// but we can't detect a mouseup or a click immediately afterward
+				// so we have to track the next mousedown and close the menu if
+				// the user clicks somewhere outside of the autocomplete
+				var menuElement = this.menu.element[ 0 ];
+				if ( !$( event.target ).closest( ".ui-menu-item" ).length ) {
+					this._delay(function() {
+						var that = this;
+						this.document.one( "mousedown", function( event ) {
+							if ( event.target !== that.element[ 0 ] &&
+									event.target !== menuElement &&
+									!$.contains( menuElement, event.target ) ) {
+								that.close();
+							}
+						});
+					});
+				}
+			},
+			menufocus: function( event, ui ) {
+				var label, item;
+				// support: Firefox
+				// Prevent accidental activation of menu items in Firefox (#7024 #9118)
+				if ( this.isNewMenu ) {
+					this.isNewMenu = false;
+					if ( event.originalEvent && /^mouse/.test( event.originalEvent.type ) ) {
+						this.menu.blur();
+
+						this.document.one( "mousemove", function() {
+							$( event.target ).trigger( event.originalEvent );
+						});
+
+						return;
+					}
+				}
+
+				item = ui.item.data( "ui-autocomplete-item" );
+				if ( false !== this._trigger( "focus", event, { item: item } ) ) {
+					// use value to match what will end up in the input, if it was a key event
+					if ( event.originalEvent && /^key/.test( event.originalEvent.type ) ) {
+						this._value( item.value );
+					}
+				}
+
+				// Announce the value in the liveRegion
+				label = ui.item.attr( "aria-label" ) || item.value;
+				if ( label && $.trim( label ).length ) {
+					this.liveRegion.children().hide();
+					$( "<div>" ).text( label ).appendTo( this.liveRegion );
+				}
+			},
+			menuselect: function( event, ui ) {
+				var item = ui.item.data( "ui-autocomplete-item" ),
+					previous = this.previous;
+
+				// only trigger when focus was lost (click on menu)
+				if ( this.element[ 0 ] !== this.document[ 0 ].activeElement ) {
+					this.element.focus();
+					this.previous = previous;
+					// #6109 - IE triggers two focus events and the second
+					// is asynchronous, so we need to reset the previous
+					// term synchronously and asynchronously :-(
+					this._delay(function() {
+						this.previous = previous;
+						this.selectedItem = item;
+					});
+				}
+
+				if ( false !== this._trigger( "select", event, { item: item } ) ) {
+					this._value( item.value );
+				}
+				// reset the term after the select event
+				// this allows custom select handling to work properly
+				this.term = this._value();
+
+				this.close( event );
+				this.selectedItem = item;
+			}
+		});
+
+		this.liveRegion = $( "<span>", {
+				role: "status",
+				"aria-live": "assertive",
+				"aria-relevant": "additions"
+			})
+			.addClass( "ui-helper-hidden-accessible" )
+			.appendTo( this.document[ 0 ].body );
+
+		// turning off autocomplete prevents the browser from remembering the
+		// value when navigating through history, so we re-enable autocomplete
+		// if the page is unloaded before the widget is destroyed. #7790
+		this._on( this.window, {
+			beforeunload: function() {
+				this.element.removeAttr( "autocomplete" );
+			}
+		});
+	},
+
+	_destroy: function() {
+		clearTimeout( this.searching );
+		this.element
+			.removeClass( "ui-autocomplete-input" )
+			.removeAttr( "autocomplete" );
+		this.menu.element.remove();
+		this.liveRegion.remove();
+	},
+
+	_setOption: function( key, value ) {
+		this._super( key, value );
+		if ( key === "source" ) {
+			this._initSource();
+		}
+		if ( key === "appendTo" ) {
+			this.menu.element.appendTo( this._appendTo() );
+		}
+		if ( key === "disabled" && value && this.xhr ) {
+			this.xhr.abort();
+		}
+	},
+
+	_appendTo: function() {
+		var element = this.options.appendTo;
+
+		if ( element ) {
+			element = element.jquery || element.nodeType ?
+				$( element ) :
+				this.document.find( element ).eq( 0 );
+		}
+
+		if ( !element || !element[ 0 ] ) {
+			element = this.element.closest( ".ui-front" );
+		}
+
+		if ( !element.length ) {
+			element = this.document[ 0 ].body;
+		}
+
+		return element;
+	},
+
+	_initSource: function() {
+		var array, url,
+			that = this;
+		if ( $.isArray( this.options.source ) ) {
+			array = this.options.source;
+			this.source = function( request, response ) {
+				response( $.ui.autocomplete.filter( array, request.term ) );
+			};
+		} else if ( typeof this.options.source === "string" ) {
+			url = this.options.source;
+			this.source = function( request, response ) {
+				if ( that.xhr ) {
+					that.xhr.abort();
+				}
+				that.xhr = $.ajax({
+					url: url,
+					data: request,
+					dataType: "json",
+					success: function( data ) {
+						response( data );
+					},
+					error: function() {
+						response([]);
+					}
+				});
+			};
+		} else {
+			this.source = this.options.source;
+		}
+	},
+
+	_searchTimeout: function( event ) {
+		clearTimeout( this.searching );
+		this.searching = this._delay(function() {
+
+			// Search if the value has changed, or if the user retypes the same value (see #7434)
+			var equalValues = this.term === this._value(),
+				menuVisible = this.menu.element.is( ":visible" ),
+				modifierKey = event.altKey || event.ctrlKey || event.metaKey || event.shiftKey;
+
+			if ( !equalValues || ( equalValues && !menuVisible && !modifierKey ) ) {
+				this.selectedItem = null;
+				this.search( null, event );
+			}
+		}, this.options.delay );
+	},
+
+	search: function( value, event ) {
+		value = value != null ? value : this._value();
+
+		// always save the actual value, not the one passed as an argument
+		this.term = this._value();
+
+		if ( value.length < this.options.minLength ) {
+			return this.close( event );
+		}
+
+		if ( this._trigger( "search", event ) === false ) {
+			return;
+		}
+
+		return this._search( value );
+	},
+
+	_search: function( value ) {
+		this.pending++;
+		this.element.addClass( "ui-autocomplete-loading" );
+		this.cancelSearch = false;
+
+		this.source( { term: value }, this._response() );
+	},
+
+	_response: function() {
+		var index = ++this.requestIndex;
+
+		return $.proxy(function( content ) {
+			if ( index === this.requestIndex ) {
+				this.__response( content );
+			}
+
+			this.pending--;
+			if ( !this.pending ) {
+				this.element.removeClass( "ui-autocomplete-loading" );
+			}
+		}, this );
+	},
+
+	__response: function( content ) {
+		if ( content ) {
+			content = this._normalize( content );
+		}
+		this._trigger( "response", null, { content: content } );
+		if ( !this.options.disabled && content && content.length && !this.cancelSearch ) {
+			this._suggest( content );
+			this._trigger( "open" );
+		} else {
+			// use ._close() instead of .close() so we don't cancel future searches
+			this._close();
+		}
+	},
+
+	close: function( event ) {
+		this.cancelSearch = true;
+		this._close( event );
+	},
+
+	_close: function( event ) {
+		if ( this.menu.element.is( ":visible" ) ) {
+			this.menu.element.hide();
+			this.menu.blur();
+			this.isNewMenu = true;
+			this._trigger( "close", event );
+		}
+	},
+
+	_change: function( event ) {
+		if ( this.previous !== this._value() ) {
+			this._trigger( "change", event, { item: this.selectedItem } );
+		}
+	},
+
+	_normalize: function( items ) {
+		// assume all items have the right format when the first item is complete
+		if ( items.length && items[ 0 ].label && items[ 0 ].value ) {
+			return items;
+		}
+		return $.map( items, function( item ) {
+			if ( typeof item === "string" ) {
+				return {
+					label: item,
+					value: item
+				};
+			}
+			return $.extend( {}, item, {
+				label: item.label || item.value,
+				value: item.value || item.label
+			});
+		});
+	},
+
+	_suggest: function( items ) {
+		var ul = this.menu.element.empty();
+		this._renderMenu( ul, items );
+		this.isNewMenu = true;
+		this.menu.refresh();
+
+		// size and position menu
+		ul.show();
+		this._resizeMenu();
+		ul.position( $.extend({
+			of: this.element
+		}, this.options.position ) );
+
+		if ( this.options.autoFocus ) {
+			this.menu.next();
+		}
+	},
+
+	_resizeMenu: function() {
+		var ul = this.menu.element;
+		ul.outerWidth( Math.max(
+			// Firefox wraps long text (possibly a rounding bug)
+			// so we add 1px to avoid the wrapping (#7513)
+			ul.width( "" ).outerWidth() + 1,
+			this.element.outerWidth()
+		) );
+	},
+
+	_renderMenu: function( ul, items ) {
+		var that = this;
+		$.each( items, function( index, item ) {
+			that._renderItemData( ul, item );
+		});
+	},
+
+	_renderItemData: function( ul, item ) {
+		return this._renderItem( ul, item ).data( "ui-autocomplete-item", item );
+	},
+
+	_renderItem: function( ul, item ) {
+		return $( "<li>" ).text( item.label ).appendTo( ul );
+	},
+
+	_move: function( direction, event ) {
+		if ( !this.menu.element.is( ":visible" ) ) {
+			this.search( null, event );
+			return;
+		}
+		if ( this.menu.isFirstItem() && /^previous/.test( direction ) ||
+				this.menu.isLastItem() && /^next/.test( direction ) ) {
+
+			if ( !this.isMultiLine ) {
+				this._value( this.term );
+			}
+
+			this.menu.blur();
+			return;
+		}
+		this.menu[ direction ]( event );
+	},
+
+	widget: function() {
+		return this.menu.element;
+	},
+
+	_value: function() {
+		return this.valueMethod.apply( this.element, arguments );
+	},
+
+	_keyEvent: function( keyEvent, event ) {
+		if ( !this.isMultiLine || this.menu.element.is( ":visible" ) ) {
+			this._move( keyEvent, event );
+
+			// prevents moving cursor to beginning/end of the text field in some browsers
+			event.preventDefault();
+		}
+	}
+});
+
+$.extend( $.ui.autocomplete, {
+	escapeRegex: function( value ) {
+		return value.replace( /[\-\[\]{}()*+?.,\\\^$|#\s]/g, "\\$&" );
+	},
+	filter: function( array, term ) {
+		var matcher = new RegExp( $.ui.autocomplete.escapeRegex( term ), "i" );
+		return $.grep( array, function( value ) {
+			return matcher.test( value.label || value.value || value );
+		});
+	}
+});
+
+// live region extension, adding a `messages` option
+// NOTE: This is an experimental API. We are still investigating
+// a full solution for string manipulation and internationalization.
+$.widget( "ui.autocomplete", $.ui.autocomplete, {
+	options: {
+		messages: {
+			noResults: "No search results.",
+			results: function( amount ) {
+				return amount + ( amount > 1 ? " results are" : " result is" ) +
+					" available, use up and down arrow keys to navigate.";
+			}
+		}
+	},
+
+	__response: function( content ) {
+		var message;
+		this._superApply( arguments );
+		if ( this.options.disabled || this.cancelSearch ) {
+			return;
+		}
+		if ( content && content.length ) {
+			message = this.options.messages.results( content.length );
+		} else {
+			message = this.options.messages.noResults;
+		}
+		this.liveRegion.children().hide();
+		$( "<div>" ).text( message ).appendTo( this.liveRegion );
+	}
+});
+
+var autocomplete = $.ui.autocomplete;
+
+
+
+}));
diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.min.css b/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.min.css
new file mode 100644
index 0000000000..94816ca005
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.min.css
@@ -0,0 +1,7 @@
+/*! jQuery UI - v1.11.4 - 2015-05-20
+* http://jqueryui.com
+* Includes: core.css, autocomplete.css, menu.css, theme.css
+* To view and modify this theme, visit http://jqueryui.com/themeroller/?ffDefault=Verdana%2CArial%2Csans-serif&fwDefault=normal&fsDefault=1.1em&cornerRadius=4px&bgColorHeader=cccccc&bgTextureHeader=highlight_soft&bgImgOpacityHeader=75&borderColorHeader=aaaaaa&fcHeader=222222&iconColorHeader=222222&bgColorContent=ffffff&bgTextureContent=flat&bgImgOpacityContent=75&borderColorContent=aaaaaa&fcContent=222222&iconColorContent=222222&bgColorDefault=e6e6e6&bgTextureDefault=glass&bgImgOpacityDefault=75&borderColorDefault=d3d3d3&fcDefault=555555&iconColorDefault=888888&bgColorHover=dadada&bgTextureHover=glass&bgImgOpacityHover=75&borderColorHover=999999&fcHover=212121&iconColorHover=454545&bgColorActive=ffffff&bgTextureActive=glass&bgImgOpacityActive=65&borderColorActive=aaaaaa&fcActive=212121&iconColorActive=454545&bgColorHighlight=fbf9ee&bgTextureHighlight=glass&bgImgOpacityHighlight=55&borderColorHighlight=fcefa1&fcHighlight=363636&iconColorHighlight=2e83ff&bgColorError=fef1ec&bgTextureError=glass&bgImgOpacityError=95&borderColorError=cd0a0a&fcError=cd0a0a&iconColorError=cd0a0a&bgColorOverlay=aaaaaa&bgTextureOverlay=flat&bgImgOpacityOverlay=0&opacityOverlay=30&bgColorShadow=aaaaaa&bgTextureShadow=flat&bgImgOpacityShadow=0&opacityShadow=30&thicknessShadow=8px&offsetTopShadow=-8px&offsetLeftShadow=-8px&cornerRadiusShadow=8px
+* Copyright 2015 jQuery Foundation and other contributors; Licensed MIT */
+
+.ui-helper-hidden{display:none}.ui-helper-hidden-accessible{border:0;clip:rect(0 0 0 0);height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;width:1px}.ui-helper-reset{margin:0;padding:0;border:0;outline:0;line-height:1.3;text-decoration:none;font-size:100%;list-style:none}.ui-helper-clearfix:before,.ui-helper-clearfix:after{content:"";display:table;border-collapse:collapse}.ui-helper-clearfix:after{clear:both}.ui-helper-clearfix{min-height:0}.ui-helper-zfix{width:100%;height:100%;top:0;left:0;position:absolute;opacity:0;filter:Alpha(Opacity=0)}.ui-front{z-index:100}.ui-state-disabled{cursor:default!important}.ui-icon{display:block;text-indent:-99999px;overflow:hidden;background-repeat:no-repeat}.ui-widget-overlay{position:fixed;top:0;left:0;width:100%;height:100%}.ui-autocomplete{position:absolute;top:0;left:0;cursor:default}.ui-menu{list-style:none;padding:0;margin:0;display:block;outline:none}.ui-menu .ui-menu{position:absolute}.ui-menu .ui-menu-item{position:relative;margin:0;padding:3px 1em 3px .4em;cursor:pointer;min-height:0;list-style-image:url("data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7")}.ui-menu .ui-menu-divider{margin:5px 0;height:0;font-size:0;line-height:0;border-width:1px 0 0 0}.ui-menu .ui-state-focus,.ui-menu .ui-state-active{margin:-1px}.ui-menu-icons{position:relative}.ui-menu-icons .ui-menu-item{padding-left:2em}.ui-menu .ui-icon{position:absolute;top:0;bottom:0;left:.2em;margin:auto 0}.ui-menu .ui-menu-icon{left:auto;right:0}.ui-widget{font-family:Verdana,Arial,sans-serif;font-size:1.1em}.ui-widget .ui-widget{font-size:1em}.ui-widget input,.ui-widget select,.ui-widget textarea,.ui-widget button{font-family:Verdana,Arial,sans-serif;font-size:1em}.ui-widget-content{border:1px solid #aaa;background:#fff url("images/ui-bg_flat_75_ffffff_40x100.png") 50% 50% repeat-x;color:#222}.ui-widget-content a{color:#222}.ui-widget-header{border:1px solid #aaa;background:#ccc url("images/ui-bg_highlight-soft_75_cccccc_1x100.png") 50% 50% repeat-x;color:#222;font-weight:bold}.ui-widget-header a{color:#222}.ui-state-default,.ui-widget-content .ui-state-default,.ui-widget-header .ui-state-default{border:1px solid #d3d3d3;background:#e6e6e6 url("images/ui-bg_glass_75_e6e6e6_1x400.png") 50% 50% repeat-x;font-weight:normal;color:#555}.ui-state-default a,.ui-state-default a:link,.ui-state-default a:visited{color:#555;text-decoration:none}.ui-state-hover,.ui-widget-content .ui-state-hover,.ui-widget-header .ui-state-hover,.ui-state-focus,.ui-widget-content .ui-state-focus,.ui-widget-header .ui-state-focus{border:1px solid #999;background:#dadada url("images/ui-bg_glass_75_dadada_1x400.png") 50% 50% repeat-x;font-weight:normal;color:#212121}.ui-state-hover a,.ui-state-hover a:hover,.ui-state-hover a:link,.ui-state-hover a:visited,.ui-state-focus a,.ui-state-focus a:hover,.ui-state-focus a:link,.ui-state-focus a:visited{color:#212121;text-decoration:none}.ui-state-active,.ui-widget-content .ui-state-active,.ui-widget-header .ui-state-active{border:1px solid #aaa;background:#fff url("images/ui-bg_glass_65_ffffff_1x400.png") 50% 50% repeat-x;font-weight:normal;color:#212121}.ui-state-active a,.ui-state-active a:link,.ui-state-active a:visited{color:#212121;text-decoration:none}.ui-state-highlight,.ui-widget-content .ui-state-highlight,.ui-widget-header .ui-state-highlight{border:1px solid #fcefa1;background:#fbf9ee url("images/ui-bg_glass_55_fbf9ee_1x400.png") 50% 50% repeat-x;color:#363636}.ui-state-highlight a,.ui-widget-content .ui-state-highlight a,.ui-widget-header .ui-state-highlight a{color:#363636}.ui-state-error,.ui-widget-content .ui-state-error,.ui-widget-header .ui-state-error{border:1px solid #cd0a0a;background:#fef1ec url("images/ui-bg_glass_95_fef1ec_1x400.png") 50% 50% repeat-x;color:#cd0a0a}.ui-state-error a,.ui-widget-content .ui-state-error a,.ui-widget-header .ui-state-error a{color:#cd0a0a}.ui-state-error-text,.ui-widget-content .ui-state-error-text,.ui-widget-header .ui-state-error-text{color:#cd0a0a}.ui-priority-primary,.ui-widget-content .ui-priority-primary,.ui-widget-header .ui-priority-primary{font-weight:bold}.ui-priority-secondary,.ui-widget-content .ui-priority-secondary,.ui-widget-header .ui-priority-secondary{opacity:.7;filter:Alpha(Opacity=70);font-weight:normal}.ui-state-disabled,.ui-widget-content .ui-state-disabled,.ui-widget-header .ui-state-disabled{opacity:.35;filter:Alpha(Opacity=35);background-image:none}.ui-state-disabled .ui-icon{filter:Alpha(Opacity=35)}.ui-icon{width:16px;height:16px}.ui-icon,.ui-widget-content .ui-icon{background-image:url("images/ui-icons_222222_256x240.png")}.ui-widget-header .ui-icon{background-image:url("images/ui-icons_222222_256x240.png")}.ui-state-default .ui-icon{background-image:url("images/ui-icons_888888_256x240.png")}.ui-state-hover .ui-icon,.ui-state-focus .ui-icon{background-image:url("images/ui-icons_454545_256x240.png")}.ui-state-active .ui-icon{background-image:url("images/ui-icons_454545_256x240.png")}.ui-state-highlight .ui-icon{background-image:url("images/ui-icons_2e83ff_256x240.png")}.ui-state-error .ui-icon,.ui-state-error-text .ui-icon{background-image:url("images/ui-icons_cd0a0a_256x240.png")}.ui-icon-blank{background-position:16px 16px}.ui-icon-carat-1-n{background-position:0 0}.ui-icon-carat-1-ne{background-position:-16px 0}.ui-icon-carat-1-e{background-position:-32px 0}.ui-icon-carat-1-se{background-position:-48px 0}.ui-icon-carat-1-s{background-position:-64px 0}.ui-icon-carat-1-sw{background-position:-80px 0}.ui-icon-carat-1-w{background-position:-96px 0}.ui-icon-carat-1-nw{background-position:-112px 0}.ui-icon-carat-2-n-s{background-position:-128px 0}.ui-icon-carat-2-e-w{background-position:-144px 0}.ui-icon-triangle-1-n{background-position:0 -16px}.ui-icon-triangle-1-ne{background-position:-16px -16px}.ui-icon-triangle-1-e{background-position:-32px -16px}.ui-icon-triangle-1-se{background-position:-48px -16px}.ui-icon-triangle-1-s{background-position:-64px -16px}.ui-icon-triangle-1-sw{background-position:-80px -16px}.ui-icon-triangle-1-w{background-position:-96px -16px}.ui-icon-triangle-1-nw{background-position:-112px -16px}.ui-icon-triangle-2-n-s{background-position:-128px -16px}.ui-icon-triangle-2-e-w{background-position:-144px -16px}.ui-icon-arrow-1-n{background-position:0 -32px}.ui-icon-arrow-1-ne{background-position:-16px -32px}.ui-icon-arrow-1-e{background-position:-32px -32px}.ui-icon-arrow-1-se{background-position:-48px -32px}.ui-icon-arrow-1-s{background-position:-64px -32px}.ui-icon-arrow-1-sw{background-position:-80px -32px}.ui-icon-arrow-1-w{background-position:-96px -32px}.ui-icon-arrow-1-nw{background-position:-112px -32px}.ui-icon-arrow-2-n-s{background-position:-128px -32px}.ui-icon-arrow-2-ne-sw{background-position:-144px -32px}.ui-icon-arrow-2-e-w{background-position:-160px -32px}.ui-icon-arrow-2-se-nw{background-position:-176px -32px}.ui-icon-arrowstop-1-n{background-position:-192px -32px}.ui-icon-arrowstop-1-e{background-position:-208px -32px}.ui-icon-arrowstop-1-s{background-position:-224px -32px}.ui-icon-arrowstop-1-w{background-position:-240px -32px}.ui-icon-arrowthick-1-n{background-position:0 -48px}.ui-icon-arrowthick-1-ne{background-position:-16px -48px}.ui-icon-arrowthick-1-e{background-position:-32px -48px}.ui-icon-arrowthick-1-se{background-position:-48px -48px}.ui-icon-arrowthick-1-s{background-position:-64px -48px}.ui-icon-arrowthick-1-sw{background-position:-80px -48px}.ui-icon-arrowthick-1-w{background-position:-96px -48px}.ui-icon-arrowthick-1-nw{background-position:-112px -48px}.ui-icon-arrowthick-2-n-s{background-position:-128px -48px}.ui-icon-arrowthick-2-ne-sw{background-position:-144px -48px}.ui-icon-arrowthick-2-e-w{background-position:-160px -48px}.ui-icon-arrowthick-2-se-nw{background-position:-176px -48px}.ui-icon-arrowthickstop-1-n{background-position:-192px -48px}.ui-icon-arrowthickstop-1-e{background-position:-208px -48px}.ui-icon-arrowthickstop-1-s{background-position:-224px -48px}.ui-icon-arrowthickstop-1-w{background-position:-240px -48px}.ui-icon-arrowreturnthick-1-w{background-position:0 -64px}.ui-icon-arrowreturnthick-1-n{background-position:-16px -64px}.ui-icon-arrowreturnthick-1-e{background-position:-32px -64px}.ui-icon-arrowreturnthick-1-s{background-position:-48px -64px}.ui-icon-arrowreturn-1-w{background-position:-64px -64px}.ui-icon-arrowreturn-1-n{background-position:-80px -64px}.ui-icon-arrowreturn-1-e{background-position:-96px -64px}.ui-icon-arrowreturn-1-s{background-position:-112px -64px}.ui-icon-arrowrefresh-1-w{background-position:-128px -64px}.ui-icon-arrowrefresh-1-n{background-position:-144px -64px}.ui-icon-arrowrefresh-1-e{background-position:-160px -64px}.ui-icon-arrowrefresh-1-s{background-position:-176px -64px}.ui-icon-arrow-4{background-position:0 -80px}.ui-icon-arrow-4-diag{background-position:-16px -80px}.ui-icon-extlink{background-position:-32px -80px}.ui-icon-newwin{background-position:-48px -80px}.ui-icon-refresh{background-position:-64px -80px}.ui-icon-shuffle{background-position:-80px -80px}.ui-icon-transfer-e-w{background-position:-96px -80px}.ui-icon-transferthick-e-w{background-position:-112px -80px}.ui-icon-folder-collapsed{background-position:0 -96px}.ui-icon-folder-open{background-position:-16px -96px}.ui-icon-document{background-position:-32px -96px}.ui-icon-document-b{background-position:-48px -96px}.ui-icon-note{background-position:-64px -96px}.ui-icon-mail-closed{background-position:-80px -96px}.ui-icon-mail-open{background-position:-96px -96px}.ui-icon-suitcase{background-position:-112px -96px}.ui-icon-comment{background-position:-128px -96px}.ui-icon-person{background-position:-144px -96px}.ui-icon-print{background-position:-160px -96px}.ui-icon-trash{background-position:-176px -96px}.ui-icon-locked{background-position:-192px -96px}.ui-icon-unlocked{background-position:-208px -96px}.ui-icon-bookmark{background-position:-224px -96px}.ui-icon-tag{background-position:-240px -96px}.ui-icon-home{background-position:0 -112px}.ui-icon-flag{background-position:-16px -112px}.ui-icon-calendar{background-position:-32px -112px}.ui-icon-cart{background-position:-48px -112px}.ui-icon-pencil{background-position:-64px -112px}.ui-icon-clock{background-position:-80px -112px}.ui-icon-disk{background-position:-96px -112px}.ui-icon-calculator{background-position:-112px -112px}.ui-icon-zoomin{background-position:-128px -112px}.ui-icon-zoomout{background-position:-144px -112px}.ui-icon-search{background-position:-160px -112px}.ui-icon-wrench{background-position:-176px -112px}.ui-icon-gear{background-position:-192px -112px}.ui-icon-heart{background-position:-208px -112px}.ui-icon-star{background-position:-224px -112px}.ui-icon-link{background-position:-240px -112px}.ui-icon-cancel{background-position:0 -128px}.ui-icon-plus{background-position:-16px -128px}.ui-icon-plusthick{background-position:-32px -128px}.ui-icon-minus{background-position:-48px -128px}.ui-icon-minusthick{background-position:-64px -128px}.ui-icon-close{background-position:-80px -128px}.ui-icon-closethick{background-position:-96px -128px}.ui-icon-key{background-position:-112px -128px}.ui-icon-lightbulb{background-position:-128px -128px}.ui-icon-scissors{background-position:-144px -128px}.ui-icon-clipboard{background-position:-160px -128px}.ui-icon-copy{background-position:-176px -128px}.ui-icon-contact{background-position:-192px -128px}.ui-icon-image{background-position:-208px -128px}.ui-icon-video{background-position:-224px -128px}.ui-icon-script{background-position:-240px -128px}.ui-icon-alert{background-position:0 -144px}.ui-icon-info{background-position:-16px -144px}.ui-icon-notice{background-position:-32px -144px}.ui-icon-help{background-position:-48px -144px}.ui-icon-check{background-position:-64px -144px}.ui-icon-bullet{background-position:-80px -144px}.ui-icon-radio-on{background-position:-96px -144px}.ui-icon-radio-off{background-position:-112px -144px}.ui-icon-pin-w{background-position:-128px -144px}.ui-icon-pin-s{background-position:-144px -144px}.ui-icon-play{background-position:0 -160px}.ui-icon-pause{background-position:-16px -160px}.ui-icon-seek-next{background-position:-32px -160px}.ui-icon-seek-prev{background-position:-48px -160px}.ui-icon-seek-end{background-position:-64px -160px}.ui-icon-seek-start{background-position:-80px -160px}.ui-icon-seek-first{background-position:-80px -160px}.ui-icon-stop{background-position:-96px -160px}.ui-icon-eject{background-position:-112px -160px}.ui-icon-volume-off{background-position:-128px -160px}.ui-icon-volume-on{background-position:-144px -160px}.ui-icon-power{background-position:0 -176px}.ui-icon-signal-diag{background-position:-16px -176px}.ui-icon-signal{background-position:-32px -176px}.ui-icon-battery-0{background-position:-48px -176px}.ui-icon-battery-1{background-position:-64px -176px}.ui-icon-battery-2{background-position:-80px -176px}.ui-icon-battery-3{background-position:-96px -176px}.ui-icon-circle-plus{background-position:0 -192px}.ui-icon-circle-minus{background-position:-16px -192px}.ui-icon-circle-close{background-position:-32px -192px}.ui-icon-circle-triangle-e{background-position:-48px -192px}.ui-icon-circle-triangle-s{background-position:-64px -192px}.ui-icon-circle-triangle-w{background-position:-80px -192px}.ui-icon-circle-triangle-n{background-position:-96px -192px}.ui-icon-circle-arrow-e{background-position:-112px -192px}.ui-icon-circle-arrow-s{background-position:-128px -192px}.ui-icon-circle-arrow-w{background-position:-144px -192px}.ui-icon-circle-arrow-n{background-position:-160px -192px}.ui-icon-circle-zoomin{background-position:-176px -192px}.ui-icon-circle-zoomout{background-position:-192px -192px}.ui-icon-circle-check{background-position:-208px -192px}.ui-icon-circlesmall-plus{background-position:0 -208px}.ui-icon-circlesmall-minus{background-position:-16px -208px}.ui-icon-circlesmall-close{background-position:-32px -208px}.ui-icon-squaresmall-plus{background-position:-48px -208px}.ui-icon-squaresmall-minus{background-position:-64px -208px}.ui-icon-squaresmall-close{background-position:-80px -208px}.ui-icon-grip-dotted-vertical{background-position:0 -224px}.ui-icon-grip-dotted-horizontal{background-position:-16px -224px}.ui-icon-grip-solid-vertical{background-position:-32px -224px}.ui-icon-grip-solid-horizontal{background-position:-48px -224px}.ui-icon-gripsmall-diagonal-se{background-position:-64px -224px}.ui-icon-grip-diagonal-se{background-position:-80px -224px}.ui-corner-all,.ui-corner-top,.ui-corner-left,.ui-corner-tl{border-top-left-radius:4px}.ui-corner-all,.ui-corner-top,.ui-corner-right,.ui-corner-tr{border-top-right-radius:4px}.ui-corner-all,.ui-corner-bottom,.ui-corner-left,.ui-corner-bl{border-bottom-left-radius:4px}.ui-corner-all,.ui-corner-bottom,.ui-corner-right,.ui-corner-br{border-bottom-right-radius:4px}.ui-widget-overlay{background:#aaa url("images/ui-bg_flat_0_aaaaaa_40x100.png") 50% 50% repeat-x;opacity:.3;filter:Alpha(Opacity=30)}.ui-widget-shadow{margin:-8px 0 0 -8px;padding:8px;background:#aaa url("images/ui-bg_flat_0_aaaaaa_40x100.png") 50% 50% repeat-x;opacity:.3;filter:Alpha(Opacity=30);border-radius:8px}
diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.min.js b/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.min.js
new file mode 100644
index 0000000000..e1ae5f606b
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.min.js
@@ -0,0 +1,7 @@
+/*! jQuery UI - v1.11.4 - 2015-05-20
+* http://jqueryui.com
+* Includes: core.js, widget.js, position.js, autocomplete.js, menu.js
+* Copyright 2015 jQuery Foundation and other contributors; Licensed MIT */
+
+(function(e){"function"==typeof define&&define.amd?define(["jquery"],e):e(jQuery)})(function(e){function t(t,s){var n,a,o,r=t.nodeName.toLowerCase();return"area"===r?(n=t.parentNode,a=n.name,t.href&&a&&"map"===n.nodeName.toLowerCase()?(o=e("img[usemap='#"+a+"']")[0],!!o&&i(o)):!1):(/^(input|select|textarea|button|object)$/.test(r)?!t.disabled:"a"===r?t.href||s:s)&&i(t)}function i(t){return e.expr.filters.visible(t)&&!e(t).parents().addBack().filter(function(){return"hidden"===e.css(this,"visibility")}).length}e.ui=e.ui||{},e.extend(e.ui,{version:"1.11.4",keyCode:{BACKSPACE:8,COMMA:188,DELETE:46,DOWN:40,END:35,ENTER:13,ESCAPE:27,HOME:36,LEFT:37,PAGE_DOWN:34,PAGE_UP:33,PERIOD:190,RIGHT:39,SPACE:32,TAB:9,UP:38}}),e.fn.extend({scrollParent:function(t){var i=this.css("position"),s="absolute"===i,n=t?/(auto|scroll|hidden)/:/(auto|scroll)/,a=this.parents().filter(function(){var t=e(this);return s&&"static"===t.css("position")?!1:n.test(t.css("overflow")+t.css("overflow-y")+t.css("overflow-x"))}).eq(0);return"fixed"!==i&&a.length?a:e(this[0].ownerDocument||document)},uniqueId:function(){var e=0;return function(){return this.each(function(){this.id||(this.id="ui-id-"+ ++e)})}}(),removeUniqueId:function(){return this.each(function(){/^ui-id-\d+$/.test(this.id)&&e(this).removeAttr("id")})}}),e.extend(e.expr[":"],{data:e.expr.createPseudo?e.expr.createPseudo(function(t){return function(i){return!!e.data(i,t)}}):function(t,i,s){return!!e.data(t,s[3])},focusable:function(i){return t(i,!isNaN(e.attr(i,"tabindex")))},tabbable:function(i){var s=e.attr(i,"tabindex"),n=isNaN(s);return(n||s>=0)&&t(i,!n)}}),e("<a>").outerWidth(1).jquery||e.each(["Width","Height"],function(t,i){function s(t,i,s,a){return e.each(n,function(){i-=parseFloat(e.css(t,"padding"+this))||0,s&&(i-=parseFloat(e.css(t,"border"+this+"Width"))||0),a&&(i-=parseFloat(e.css(t,"margin"+this))||0)}),i}var n="Width"===i?["Left","Right"]:["Top","Bottom"],a=i.toLowerCase(),o={innerWidth:e.fn.innerWidth,innerHeight:e.fn.innerHeight,outerWidth:e.fn.outerWidth,outerHeight:e.fn.outerHeight};e.fn["inner"+i]=function(t){return void 0===t?o["inner"+i].call(this):this.each(function(){e(this).css(a,s(this,t)+"px")})},e.fn["outer"+i]=function(t,n){return"number"!=typeof t?o["outer"+i].call(this,t):this.each(function(){e(this).css(a,s(this,t,!0,n)+"px")})}}),e.fn.addBack||(e.fn.addBack=function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}),e("<a>").data("a-b","a").removeData("a-b").data("a-b")&&(e.fn.removeData=function(t){return function(i){return arguments.length?t.call(this,e.camelCase(i)):t.call(this)}}(e.fn.removeData)),e.ui.ie=!!/msie [\w.]+/.exec(navigator.userAgent.toLowerCase()),e.fn.extend({focus:function(t){return function(i,s){return"number"==typeof i?this.each(function(){var t=this;setTimeout(function(){e(t).focus(),s&&s.call(t)},i)}):t.apply(this,arguments)}}(e.fn.focus),disableSelection:function(){var e="onselectstart"in document.createElement("div")?"selectstart":"mousedown";return function(){return this.bind(e+".ui-disableSelection",function(e){e.preventDefault()})}}(),enableSelection:function(){return this.unbind(".ui-disableSelection")},zIndex:function(t){if(void 0!==t)return this.css("zIndex",t);if(this.length)for(var i,s,n=e(this[0]);n.length&&n[0]!==document;){if(i=n.css("position"),("absolute"===i||"relative"===i||"fixed"===i)&&(s=parseInt(n.css("zIndex"),10),!isNaN(s)&&0!==s))return s;n=n.parent()}return 0}}),e.ui.plugin={add:function(t,i,s){var n,a=e.ui[t].prototype;for(n in s)a.plugins[n]=a.plugins[n]||[],a.plugins[n].push([i,s[n]])},call:function(e,t,i,s){var n,a=e.plugins[t];if(a&&(s||e.element[0].parentNode&&11!==e.element[0].parentNode.nodeType))for(n=0;a.length>n;n++)e.options[a[n][0]]&&a[n][1].apply(e.element,i)}};var s=0,n=Array.prototype.slice;e.cleanData=function(t){return function(i){var s,n,a;for(a=0;null!=(n=i[a]);a++)try{s=e._data(n,"events"),s&&s.remove&&e(n).triggerHandler("remove")}catch(o){}t(i)}}(e.cleanData),e.widget=function(t,i,s){var n,a,o,r,h={},l=t.split(".")[0];return t=t.split(".")[1],n=l+"-"+t,s||(s=i,i=e.Widget),e.expr[":"][n.toLowerCase()]=function(t){return!!e.data(t,n)},e[l]=e[l]||{},a=e[l][t],o=e[l][t]=function(e,t){return this._createWidget?(arguments.length&&this._createWidget(e,t),void 0):new o(e,t)},e.extend(o,a,{version:s.version,_proto:e.extend({},s),_childConstructors:[]}),r=new i,r.options=e.widget.extend({},r.options),e.each(s,function(t,s){return e.isFunction(s)?(h[t]=function(){var e=function(){return i.prototype[t].apply(this,arguments)},n=function(e){return i.prototype[t].apply(this,e)};return function(){var t,i=this._super,a=this._superApply;return this._super=e,this._superApply=n,t=s.apply(this,arguments),this._super=i,this._superApply=a,t}}(),void 0):(h[t]=s,void 0)}),o.prototype=e.widget.extend(r,{widgetEventPrefix:a?r.widgetEventPrefix||t:t},h,{constructor:o,namespace:l,widgetName:t,widgetFullName:n}),a?(e.each(a._childConstructors,function(t,i){var s=i.prototype;e.widget(s.namespace+"."+s.widgetName,o,i._proto)}),delete a._childConstructors):i._childConstructors.push(o),e.widget.bridge(t,o),o},e.widget.extend=function(t){for(var i,s,a=n.call(arguments,1),o=0,r=a.length;r>o;o++)for(i in a[o])s=a[o][i],a[o].hasOwnProperty(i)&&void 0!==s&&(t[i]=e.isPlainObject(s)?e.isPlainObject(t[i])?e.widget.extend({},t[i],s):e.widget.extend({},s):s);return t},e.widget.bridge=function(t,i){var s=i.prototype.widgetFullName||t;e.fn[t]=function(a){var o="string"==typeof a,r=n.call(arguments,1),h=this;return o?this.each(function(){var i,n=e.data(this,s);return"instance"===a?(h=n,!1):n?e.isFunction(n[a])&&"_"!==a.charAt(0)?(i=n[a].apply(n,r),i!==n&&void 0!==i?(h=i&&i.jquery?h.pushStack(i.get()):i,!1):void 0):e.error("no such method '"+a+"' for "+t+" widget instance"):e.error("cannot call methods on "+t+" prior to initialization; "+"attempted to call method '"+a+"'")}):(r.length&&(a=e.widget.extend.apply(null,[a].concat(r))),this.each(function(){var t=e.data(this,s);t?(t.option(a||{}),t._init&&t._init()):e.data(this,s,new i(a,this))})),h}},e.Widget=function(){},e.Widget._childConstructors=[],e.Widget.prototype={widgetName:"widget",widgetEventPrefix:"",defaultElement:"<div>",options:{disabled:!1,create:null},_createWidget:function(t,i){i=e(i||this.defaultElement||this)[0],this.element=e(i),this.uuid=s++,this.eventNamespace="."+this.widgetName+this.uuid,this.bindings=e(),this.hoverable=e(),this.focusable=e(),i!==this&&(e.data(i,this.widgetFullName,this),this._on(!0,this.element,{remove:function(e){e.target===i&&this.destroy()}}),this.document=e(i.style?i.ownerDocument:i.document||i),this.window=e(this.document[0].defaultView||this.document[0].parentWindow)),this.options=e.widget.extend({},this.options,this._getCreateOptions(),t),this._create(),this._trigger("create",null,this._getCreateEventData()),this._init()},_getCreateOptions:e.noop,_getCreateEventData:e.noop,_create:e.noop,_init:e.noop,destroy:function(){this._destroy(),this.element.unbind(this.eventNamespace).removeData(this.widgetFullName).removeData(e.camelCase(this.widgetFullName)),this.widget().unbind(this.eventNamespace).removeAttr("aria-disabled").removeClass(this.widgetFullName+"-disabled "+"ui-state-disabled"),this.bindings.unbind(this.eventNamespace),this.hoverable.removeClass("ui-state-hover"),this.focusable.removeClass("ui-state-focus")},_destroy:e.noop,widget:function(){return this.element},option:function(t,i){var s,n,a,o=t;if(0===arguments.length)return e.widget.extend({},this.options);if("string"==typeof t)if(o={},s=t.split("."),t=s.shift(),s.length){for(n=o[t]=e.widget.extend({},this.options[t]),a=0;s.length-1>a;a++)n[s[a]]=n[s[a]]||{},n=n[s[a]];if(t=s.pop(),1===arguments.length)return void 0===n[t]?null:n[t];n[t]=i}else{if(1===arguments.length)return void 0===this.options[t]?null:this.options[t];o[t]=i}return this._setOptions(o),this},_setOptions:function(e){var t;for(t in e)this._setOption(t,e[t]);return this},_setOption:function(e,t){return this.options[e]=t,"disabled"===e&&(this.widget().toggleClass(this.widgetFullName+"-disabled",!!t),t&&(this.hoverable.removeClass("ui-state-hover"),this.focusable.removeClass("ui-state-focus"))),this},enable:function(){return this._setOptions({disabled:!1})},disable:function(){return this._setOptions({disabled:!0})},_on:function(t,i,s){var n,a=this;"boolean"!=typeof t&&(s=i,i=t,t=!1),s?(i=n=e(i),this.bindings=this.bindings.add(i)):(s=i,i=this.element,n=this.widget()),e.each(s,function(s,o){function r(){return t||a.options.disabled!==!0&&!e(this).hasClass("ui-state-disabled")?("string"==typeof o?a[o]:o).apply(a,arguments):void 0}"string"!=typeof o&&(r.guid=o.guid=o.guid||r.guid||e.guid++);var h=s.match(/^([\w:-]*)\s*(.*)$/),l=h[1]+a.eventNamespace,u=h[2];u?n.delegate(u,l,r):i.bind(l,r)})},_off:function(t,i){i=(i||"").split(" ").join(this.eventNamespace+" ")+this.eventNamespace,t.unbind(i).undelegate(i),this.bindings=e(this.bindings.not(t).get()),this.focusable=e(this.focusable.not(t).get()),this.hoverable=e(this.hoverable.not(t).get())},_delay:function(e,t){function i(){return("string"==typeof e?s[e]:e).apply(s,arguments)}var s=this;return setTimeout(i,t||0)},_hoverable:function(t){this.hoverable=this.hoverable.add(t),this._on(t,{mouseenter:function(t){e(t.currentTarget).addClass("ui-state-hover")},mouseleave:function(t){e(t.currentTarget).removeClass("ui-state-hover")}})},_focusable:function(t){this.focusable=this.focusable.add(t),this._on(t,{focusin:function(t){e(t.currentTarget).addClass("ui-state-focus")},focusout:function(t){e(t.currentTarget).removeClass("ui-state-focus")}})},_trigger:function(t,i,s){var n,a,o=this.options[t];if(s=s||{},i=e.Event(i),i.type=(t===this.widgetEventPrefix?t:this.widgetEventPrefix+t).toLowerCase(),i.target=this.element[0],a=i.originalEvent)for(n in a)n in i||(i[n]=a[n]);return this.element.trigger(i,s),!(e.isFunction(o)&&o.apply(this.element[0],[i].concat(s))===!1||i.isDefaultPrevented())}},e.each({show:"fadeIn",hide:"fadeOut"},function(t,i){e.Widget.prototype["_"+t]=function(s,n,a){"string"==typeof n&&(n={effect:n});var o,r=n?n===!0||"number"==typeof n?i:n.effect||i:t;n=n||{},"number"==typeof n&&(n={duration:n}),o=!e.isEmptyObject(n),n.complete=a,n.delay&&s.delay(n.delay),o&&e.effects&&e.effects.effect[r]?s[t](n):r!==t&&s[r]?s[r](n.duration,n.easing,a):s.queue(function(i){e(this)[t](),a&&a.call(s[0]),i()})}}),e.widget,function(){function t(e,t,i){return[parseFloat(e[0])*(p.test(e[0])?t/100:1),parseFloat(e[1])*(p.test(e[1])?i/100:1)]}function i(t,i){return parseInt(e.css(t,i),10)||0}function s(t){var i=t[0];return 9===i.nodeType?{width:t.width(),height:t.height(),offset:{top:0,left:0}}:e.isWindow(i)?{width:t.width(),height:t.height(),offset:{top:t.scrollTop(),left:t.scrollLeft()}}:i.preventDefault?{width:0,height:0,offset:{top:i.pageY,left:i.pageX}}:{width:t.outerWidth(),height:t.outerHeight(),offset:t.offset()}}e.ui=e.ui||{};var n,a,o=Math.max,r=Math.abs,h=Math.round,l=/left|center|right/,u=/top|center|bottom/,d=/[\+\-]\d+(\.[\d]+)?%?/,c=/^\w+/,p=/%$/,f=e.fn.position;e.position={scrollbarWidth:function(){if(void 0!==n)return n;var t,i,s=e("<div style='display:block;position:absolute;width:50px;height:50px;overflow:hidden;'><div style='height:100px;width:auto;'></div></div>"),a=s.children()[0];return e("body").append(s),t=a.offsetWidth,s.css("overflow","scroll"),i=a.offsetWidth,t===i&&(i=s[0].clientWidth),s.remove(),n=t-i},getScrollInfo:function(t){var i=t.isWindow||t.isDocument?"":t.element.css("overflow-x"),s=t.isWindow||t.isDocument?"":t.element.css("overflow-y"),n="scroll"===i||"auto"===i&&t.width<t.element[0].scrollWidth,a="scroll"===s||"auto"===s&&t.height<t.element[0].scrollHeight;return{width:a?e.position.scrollbarWidth():0,height:n?e.position.scrollbarWidth():0}},getWithinInfo:function(t){var i=e(t||window),s=e.isWindow(i[0]),n=!!i[0]&&9===i[0].nodeType;return{element:i,isWindow:s,isDocument:n,offset:i.offset()||{left:0,top:0},scrollLeft:i.scrollLeft(),scrollTop:i.scrollTop(),width:s||n?i.width():i.outerWidth(),height:s||n?i.height():i.outerHeight()}}},e.fn.position=function(n){if(!n||!n.of)return f.apply(this,arguments);n=e.extend({},n);var p,m,g,v,y,b,_=e(n.of),x=e.position.getWithinInfo(n.within),w=e.position.getScrollInfo(x),k=(n.collision||"flip").split(" "),T={};return b=s(_),_[0].preventDefault&&(n.at="left top"),m=b.width,g=b.height,v=b.offset,y=e.extend({},v),e.each(["my","at"],function(){var e,t,i=(n[this]||"").split(" ");1===i.length&&(i=l.test(i[0])?i.concat(["center"]):u.test(i[0])?["center"].concat(i):["center","center"]),i[0]=l.test(i[0])?i[0]:"center",i[1]=u.test(i[1])?i[1]:"center",e=d.exec(i[0]),t=d.exec(i[1]),T[this]=[e?e[0]:0,t?t[0]:0],n[this]=[c.exec(i[0])[0],c.exec(i[1])[0]]}),1===k.length&&(k[1]=k[0]),"right"===n.at[0]?y.left+=m:"center"===n.at[0]&&(y.left+=m/2),"bottom"===n.at[1]?y.top+=g:"center"===n.at[1]&&(y.top+=g/2),p=t(T.at,m,g),y.left+=p[0],y.top+=p[1],this.each(function(){var s,l,u=e(this),d=u.outerWidth(),c=u.outerHeight(),f=i(this,"marginLeft"),b=i(this,"marginTop"),D=d+f+i(this,"marginRight")+w.width,S=c+b+i(this,"marginBottom")+w.height,N=e.extend({},y),M=t(T.my,u.outerWidth(),u.outerHeight());"right"===n.my[0]?N.left-=d:"center"===n.my[0]&&(N.left-=d/2),"bottom"===n.my[1]?N.top-=c:"center"===n.my[1]&&(N.top-=c/2),N.left+=M[0],N.top+=M[1],a||(N.left=h(N.left),N.top=h(N.top)),s={marginLeft:f,marginTop:b},e.each(["left","top"],function(t,i){e.ui.position[k[t]]&&e.ui.position[k[t]][i](N,{targetWidth:m,targetHeight:g,elemWidth:d,elemHeight:c,collisionPosition:s,collisionWidth:D,collisionHeight:S,offset:[p[0]+M[0],p[1]+M[1]],my:n.my,at:n.at,within:x,elem:u})}),n.using&&(l=function(e){var t=v.left-N.left,i=t+m-d,s=v.top-N.top,a=s+g-c,h={target:{element:_,left:v.left,top:v.top,width:m,height:g},element:{element:u,left:N.left,top:N.top,width:d,height:c},horizontal:0>i?"left":t>0?"right":"center",vertical:0>a?"top":s>0?"bottom":"middle"};d>m&&m>r(t+i)&&(h.horizontal="center"),c>g&&g>r(s+a)&&(h.vertical="middle"),h.important=o(r(t),r(i))>o(r(s),r(a))?"horizontal":"vertical",n.using.call(this,e,h)}),u.offset(e.extend(N,{using:l}))})},e.ui.position={fit:{left:function(e,t){var i,s=t.within,n=s.isWindow?s.scrollLeft:s.offset.left,a=s.width,r=e.left-t.collisionPosition.marginLeft,h=n-r,l=r+t.collisionWidth-a-n;t.collisionWidth>a?h>0&&0>=l?(i=e.left+h+t.collisionWidth-a-n,e.left+=h-i):e.left=l>0&&0>=h?n:h>l?n+a-t.collisionWidth:n:h>0?e.left+=h:l>0?e.left-=l:e.left=o(e.left-r,e.left)},top:function(e,t){var i,s=t.within,n=s.isWindow?s.scrollTop:s.offset.top,a=t.within.height,r=e.top-t.collisionPosition.marginTop,h=n-r,l=r+t.collisionHeight-a-n;t.collisionHeight>a?h>0&&0>=l?(i=e.top+h+t.collisionHeight-a-n,e.top+=h-i):e.top=l>0&&0>=h?n:h>l?n+a-t.collisionHeight:n:h>0?e.top+=h:l>0?e.top-=l:e.top=o(e.top-r,e.top)}},flip:{left:function(e,t){var i,s,n=t.within,a=n.offset.left+n.scrollLeft,o=n.width,h=n.isWindow?n.scrollLeft:n.offset.left,l=e.left-t.collisionPosition.marginLeft,u=l-h,d=l+t.collisionWidth-o-h,c="left"===t.my[0]?-t.elemWidth:"right"===t.my[0]?t.elemWidth:0,p="left"===t.at[0]?t.targetWidth:"right"===t.at[0]?-t.targetWidth:0,f=-2*t.offset[0];0>u?(i=e.left+c+p+f+t.collisionWidth-o-a,(0>i||r(u)>i)&&(e.left+=c+p+f)):d>0&&(s=e.left-t.collisionPosition.marginLeft+c+p+f-h,(s>0||d>r(s))&&(e.left+=c+p+f))},top:function(e,t){var i,s,n=t.within,a=n.offset.top+n.scrollTop,o=n.height,h=n.isWindow?n.scrollTop:n.offset.top,l=e.top-t.collisionPosition.marginTop,u=l-h,d=l+t.collisionHeight-o-h,c="top"===t.my[1],p=c?-t.elemHeight:"bottom"===t.my[1]?t.elemHeight:0,f="top"===t.at[1]?t.targetHeight:"bottom"===t.at[1]?-t.targetHeight:0,m=-2*t.offset[1];0>u?(s=e.top+p+f+m+t.collisionHeight-o-a,(0>s||r(u)>s)&&(e.top+=p+f+m)):d>0&&(i=e.top-t.collisionPosition.marginTop+p+f+m-h,(i>0||d>r(i))&&(e.top+=p+f+m))}},flipfit:{left:function(){e.ui.position.flip.left.apply(this,arguments),e.ui.position.fit.left.apply(this,arguments)},top:function(){e.ui.position.flip.top.apply(this,arguments),e.ui.position.fit.top.apply(this,arguments)}}},function(){var t,i,s,n,o,r=document.getElementsByTagName("body")[0],h=document.createElement("div");t=document.createElement(r?"div":"body"),s={visibility:"hidden",width:0,height:0,border:0,margin:0,background:"none"},r&&e.extend(s,{position:"absolute",left:"-1000px",top:"-1000px"});for(o in s)t.style[o]=s[o];t.appendChild(h),i=r||document.documentElement,i.insertBefore(t,i.firstChild),h.style.cssText="position: absolute; left: 10.7432222px;",n=e(h).offset().left,a=n>10&&11>n,t.innerHTML="",i.removeChild(t)}()}(),e.ui.position,e.widget("ui.menu",{version:"1.11.4",defaultElement:"<ul>",delay:300,options:{icons:{submenu:"ui-icon-carat-1-e"},items:"> *",menus:"ul",position:{my:"left-1 top",at:"right top"},role:"menu",blur:null,focus:null,select:null},_create:function(){this.activeMenu=this.element,this.mouseHandled=!1,this.element.uniqueId().addClass("ui-menu ui-widget ui-widget-content").toggleClass("ui-menu-icons",!!this.element.find(".ui-icon").length).attr({role:this.options.role,tabIndex:0}),this.options.disabled&&this.element.addClass("ui-state-disabled").attr("aria-disabled","true"),this._on({"mousedown .ui-menu-item":function(e){e.preventDefault()},"click .ui-menu-item":function(t){var i=e(t.target);!this.mouseHandled&&i.not(".ui-state-disabled").length&&(this.select(t),t.isPropagationStopped()||(this.mouseHandled=!0),i.has(".ui-menu").length?this.expand(t):!this.element.is(":focus")&&e(this.document[0].activeElement).closest(".ui-menu").length&&(this.element.trigger("focus",[!0]),this.active&&1===this.active.parents(".ui-menu").length&&clearTimeout(this.timer)))},"mouseenter .ui-menu-item":function(t){if(!this.previousFilter){var i=e(t.currentTarget);i.siblings(".ui-state-active").removeClass("ui-state-active"),this.focus(t,i)}},mouseleave:"collapseAll","mouseleave .ui-menu":"collapseAll",focus:function(e,t){var i=this.active||this.element.find(this.options.items).eq(0);t||this.focus(e,i)},blur:function(t){this._delay(function(){e.contains(this.element[0],this.document[0].activeElement)||this.collapseAll(t)})},keydown:"_keydown"}),this.refresh(),this._on(this.document,{click:function(e){this._closeOnDocumentClick(e)&&this.collapseAll(e),this.mouseHandled=!1}})},_destroy:function(){this.element.removeAttr("aria-activedescendant").find(".ui-menu").addBack().removeClass("ui-menu ui-widget ui-widget-content ui-menu-icons ui-front").removeAttr("role").removeAttr("tabIndex").removeAttr("aria-labelledby").removeAttr("aria-expanded").removeAttr("aria-hidden").removeAttr("aria-disabled").removeUniqueId().show(),this.element.find(".ui-menu-item").removeClass("ui-menu-item").removeAttr("role").removeAttr("aria-disabled").removeUniqueId().removeClass("ui-state-hover").removeAttr("tabIndex").removeAttr("role").removeAttr("aria-haspopup").children().each(function(){var t=e(this);t.data("ui-menu-submenu-carat")&&t.remove()}),this.element.find(".ui-menu-divider").removeClass("ui-menu-divider ui-widget-content")},_keydown:function(t){var i,s,n,a,o=!0;switch(t.keyCode){case e.ui.keyCode.PAGE_UP:this.previousPage(t);break;case e.ui.keyCode.PAGE_DOWN:this.nextPage(t);break;case e.ui.keyCode.HOME:this._move("first","first",t);break;case e.ui.keyCode.END:this._move("last","last",t);break;case e.ui.keyCode.UP:this.previous(t);break;case e.ui.keyCode.DOWN:this.next(t);break;case e.ui.keyCode.LEFT:this.collapse(t);break;case e.ui.keyCode.RIGHT:this.active&&!this.active.is(".ui-state-disabled")&&this.expand(t);break;case e.ui.keyCode.ENTER:case e.ui.keyCode.SPACE:this._activate(t);break;case e.ui.keyCode.ESCAPE:this.collapse(t);break;default:o=!1,s=this.previousFilter||"",n=String.fromCharCode(t.keyCode),a=!1,clearTimeout(this.filterTimer),n===s?a=!0:n=s+n,i=this._filterMenuItems(n),i=a&&-1!==i.index(this.active.next())?this.active.nextAll(".ui-menu-item"):i,i.length||(n=String.fromCharCode(t.keyCode),i=this._filterMenuItems(n)),i.length?(this.focus(t,i),this.previousFilter=n,this.filterTimer=this._delay(function(){delete this.previousFilter},1e3)):delete this.previousFilter}o&&t.preventDefault()},_activate:function(e){this.active.is(".ui-state-disabled")||(this.active.is("[aria-haspopup='true']")?this.expand(e):this.select(e))},refresh:function(){var t,i,s=this,n=this.options.icons.submenu,a=this.element.find(this.options.menus);this.element.toggleClass("ui-menu-icons",!!this.element.find(".ui-icon").length),a.filter(":not(.ui-menu)").addClass("ui-menu ui-widget ui-widget-content ui-front").hide().attr({role:this.options.role,"aria-hidden":"true","aria-expanded":"false"}).each(function(){var t=e(this),i=t.parent(),s=e("<span>").addClass("ui-menu-icon ui-icon "+n).data("ui-menu-submenu-carat",!0);i.attr("aria-haspopup","true").prepend(s),t.attr("aria-labelledby",i.attr("id"))}),t=a.add(this.element),i=t.find(this.options.items),i.not(".ui-menu-item").each(function(){var t=e(this);s._isDivider(t)&&t.addClass("ui-widget-content ui-menu-divider")}),i.not(".ui-menu-item, .ui-menu-divider").addClass("ui-menu-item").uniqueId().attr({tabIndex:-1,role:this._itemRole()}),i.filter(".ui-state-disabled").attr("aria-disabled","true"),this.active&&!e.contains(this.element[0],this.active[0])&&this.blur()},_itemRole:function(){return{menu:"menuitem",listbox:"option"}[this.options.role]},_setOption:function(e,t){"icons"===e&&this.element.find(".ui-menu-icon").removeClass(this.options.icons.submenu).addClass(t.submenu),"disabled"===e&&this.element.toggleClass("ui-state-disabled",!!t).attr("aria-disabled",t),this._super(e,t)},focus:function(e,t){var i,s;this.blur(e,e&&"focus"===e.type),this._scrollIntoView(t),this.active=t.first(),s=this.active.addClass("ui-state-focus").removeClass("ui-state-active"),this.options.role&&this.element.attr("aria-activedescendant",s.attr("id")),this.active.parent().closest(".ui-menu-item").addClass("ui-state-active"),e&&"keydown"===e.type?this._close():this.timer=this._delay(function(){this._close()},this.delay),i=t.children(".ui-menu"),i.length&&e&&/^mouse/.test(e.type)&&this._startOpening(i),this.activeMenu=t.parent(),this._trigger("focus",e,{item:t})},_scrollIntoView:function(t){var i,s,n,a,o,r;this._hasScroll()&&(i=parseFloat(e.css(this.activeMenu[0],"borderTopWidth"))||0,s=parseFloat(e.css(this.activeMenu[0],"paddingTop"))||0,n=t.offset().top-this.activeMenu.offset().top-i-s,a=this.activeMenu.scrollTop(),o=this.activeMenu.height(),r=t.outerHeight(),0>n?this.activeMenu.scrollTop(a+n):n+r>o&&this.activeMenu.scrollTop(a+n-o+r))},blur:function(e,t){t||clearTimeout(this.timer),this.active&&(this.active.removeClass("ui-state-focus"),this.active=null,this._trigger("blur",e,{item:this.active}))},_startOpening:function(e){clearTimeout(this.timer),"true"===e.attr("aria-hidden")&&(this.timer=this._delay(function(){this._close(),this._open(e)},this.delay))},_open:function(t){var i=e.extend({of:this.active},this.options.position);clearTimeout(this.timer),this.element.find(".ui-menu").not(t.parents(".ui-menu")).hide().attr("aria-hidden","true"),t.show().removeAttr("aria-hidden").attr("aria-expanded","true").position(i)},collapseAll:function(t,i){clearTimeout(this.timer),this.timer=this._delay(function(){var s=i?this.element:e(t&&t.target).closest(this.element.find(".ui-menu"));s.length||(s=this.element),this._close(s),this.blur(t),this.activeMenu=s},this.delay)},_close:function(e){e||(e=this.active?this.active.parent():this.element),e.find(".ui-menu").hide().attr("aria-hidden","true").attr("aria-expanded","false").end().find(".ui-state-active").not(".ui-state-focus").removeClass("ui-state-active")},_closeOnDocumentClick:function(t){return!e(t.target).closest(".ui-menu").length},_isDivider:function(e){return!/[^\-\u2014\u2013\s]/.test(e.text())},collapse:function(e){var t=this.active&&this.active.parent().closest(".ui-menu-item",this.element);t&&t.length&&(this._close(),this.focus(e,t))},expand:function(e){var t=this.active&&this.active.children(".ui-menu ").find(this.options.items).first();t&&t.length&&(this._open(t.parent()),this._delay(function(){this.focus(e,t)}))},next:function(e){this._move("next","first",e)},previous:function(e){this._move("prev","last",e)},isFirstItem:function(){return this.active&&!this.active.prevAll(".ui-menu-item").length},isLastItem:function(){return this.active&&!this.active.nextAll(".ui-menu-item").length},_move:function(e,t,i){var s;this.active&&(s="first"===e||"last"===e?this.active["first"===e?"prevAll":"nextAll"](".ui-menu-item").eq(-1):this.active[e+"All"](".ui-menu-item").eq(0)),s&&s.length&&this.active||(s=this.activeMenu.find(this.options.items)[t]()),this.focus(i,s)},nextPage:function(t){var i,s,n;return this.active?(this.isLastItem()||(this._hasScroll()?(s=this.active.offset().top,n=this.element.height(),this.active.nextAll(".ui-menu-item").each(function(){return i=e(this),0>i.offset().top-s-n}),this.focus(t,i)):this.focus(t,this.activeMenu.find(this.options.items)[this.active?"last":"first"]())),void 0):(this.next(t),void 0)},previousPage:function(t){var i,s,n;return this.active?(this.isFirstItem()||(this._hasScroll()?(s=this.active.offset().top,n=this.element.height(),this.active.prevAll(".ui-menu-item").each(function(){return i=e(this),i.offset().top-s+n>0}),this.focus(t,i)):this.focus(t,this.activeMenu.find(this.options.items).first())),void 0):(this.next(t),void 0)},_hasScroll:function(){return this.element.outerHeight()<this.element.prop("scrollHeight")},select:function(t){this.active=this.active||e(t.target).closest(".ui-menu-item");var i={item:this.active};this.active.has(".ui-menu").length||this.collapseAll(t,!0),this._trigger("select",t,i)},_filterMenuItems:function(t){var i=t.replace(/[\-\[\]{}()*+?.,\\\^$|#\s]/g,"\\$&"),s=RegExp("^"+i,"i");return this.activeMenu.find(this.options.items).filter(".ui-menu-item").filter(function(){return s.test(e.trim(e(this).text()))})}}),e.widget("ui.autocomplete",{version:"1.11.4",defaultElement:"<input>",options:{appendTo:null,autoFocus:!1,delay:300,minLength:1,position:{my:"left top",at:"left bottom",collision:"none"},source:null,change:null,close:null,focus:null,open:null,response:null,search:null,select:null},requestIndex:0,pending:0,_create:function(){var t,i,s,n=this.element[0].nodeName.toLowerCase(),a="textarea"===n,o="input"===n;this.isMultiLine=a?!0:o?!1:this.element.prop("isContentEditable"),this.valueMethod=this.element[a||o?"val":"text"],this.isNewMenu=!0,this.element.addClass("ui-autocomplete-input").attr("autocomplete","off"),this._on(this.element,{keydown:function(n){if(this.element.prop("readOnly"))return t=!0,s=!0,i=!0,void 0;t=!1,s=!1,i=!1;var a=e.ui.keyCode;switch(n.keyCode){case a.PAGE_UP:t=!0,this._move("previousPage",n);break;case a.PAGE_DOWN:t=!0,this._move("nextPage",n);break;case a.UP:t=!0,this._keyEvent("previous",n);break;case a.DOWN:t=!0,this._keyEvent("next",n);break;case a.ENTER:this.menu.active&&(t=!0,n.preventDefault(),this.menu.select(n));break;case a.TAB:this.menu.active&&this.menu.select(n);break;case a.ESCAPE:this.menu.element.is(":visible")&&(this.isMultiLine||this._value(this.term),this.close(n),n.preventDefault());break;default:i=!0,this._searchTimeout(n)}},keypress:function(s){if(t)return t=!1,(!this.isMultiLine||this.menu.element.is(":visible"))&&s.preventDefault(),void 0;if(!i){var n=e.ui.keyCode;switch(s.keyCode){case n.PAGE_UP:this._move("previousPage",s);break;case n.PAGE_DOWN:this._move("nextPage",s);break;case n.UP:this._keyEvent("previous",s);break;case n.DOWN:this._keyEvent("next",s)}}},input:function(e){return s?(s=!1,e.preventDefault(),void 0):(this._searchTimeout(e),void 0)},focus:function(){this.selectedItem=null,this.previous=this._value()},blur:function(e){return this.cancelBlur?(delete this.cancelBlur,void 0):(clearTimeout(this.searching),this.close(e),this._change(e),void 0)}}),this._initSource(),this.menu=e("<ul>").addClass("ui-autocomplete ui-front").appendTo(this._appendTo()).menu({role:null}).hide().menu("instance"),this._on(this.menu.element,{mousedown:function(t){t.preventDefault(),this.cancelBlur=!0,this._delay(function(){delete this.cancelBlur});var i=this.menu.element[0];e(t.target).closest(".ui-menu-item").length||this._delay(function(){var t=this;this.document.one("mousedown",function(s){s.target===t.element[0]||s.target===i||e.contains(i,s.target)||t.close()})})},menufocus:function(t,i){var s,n;return this.isNewMenu&&(this.isNewMenu=!1,t.originalEvent&&/^mouse/.test(t.originalEvent.type))?(this.menu.blur(),this.document.one("mousemove",function(){e(t.target).trigger(t.originalEvent)}),void 0):(n=i.item.data("ui-autocomplete-item"),!1!==this._trigger("focus",t,{item:n})&&t.originalEvent&&/^key/.test(t.originalEvent.type)&&this._value(n.value),s=i.item.attr("aria-label")||n.value,s&&e.trim(s).length&&(this.liveRegion.children().hide(),e("<div>").text(s).appendTo(this.liveRegion)),void 0)},menuselect:function(e,t){var i=t.item.data("ui-autocomplete-item"),s=this.previous;this.element[0]!==this.document[0].activeElement&&(this.element.focus(),this.previous=s,this._delay(function(){this.previous=s,this.selectedItem=i})),!1!==this._trigger("select",e,{item:i})&&this._value(i.value),this.term=this._value(),this.close(e),this.selectedItem=i}}),this.liveRegion=e("<span>",{role:"status","aria-live":"assertive","aria-relevant":"additions"}).addClass("ui-helper-hidden-accessible").appendTo(this.document[0].body),this._on(this.window,{beforeunload:function(){this.element.removeAttr("autocomplete")}})},_destroy:function(){clearTimeout(this.searching),this.element.removeClass("ui-autocomplete-input").removeAttr("autocomplete"),this.menu.element.remove(),this.liveRegion.remove()},_setOption:function(e,t){this._super(e,t),"source"===e&&this._initSource(),"appendTo"===e&&this.menu.element.appendTo(this._appendTo()),"disabled"===e&&t&&this.xhr&&this.xhr.abort()},_appendTo:function(){var t=this.options.appendTo;return t&&(t=t.jquery||t.nodeType?e(t):this.document.find(t).eq(0)),t&&t[0]||(t=this.element.closest(".ui-front")),t.length||(t=this.document[0].body),t},_initSource:function(){var t,i,s=this;e.isArray(this.options.source)?(t=this.options.source,this.source=function(i,s){s(e.ui.autocomplete.filter(t,i.term))}):"string"==typeof this.options.source?(i=this.options.source,this.source=function(t,n){s.xhr&&s.xhr.abort(),s.xhr=e.ajax({url:i,data:t,dataType:"json",success:function(e){n(e)},error:function(){n([])}})}):this.source=this.options.source},_searchTimeout:function(e){clearTimeout(this.searching),this.searching=this._delay(function(){var t=this.term===this._value(),i=this.menu.element.is(":visible"),s=e.altKey||e.ctrlKey||e.metaKey||e.shiftKey;(!t||t&&!i&&!s)&&(this.selectedItem=null,this.search(null,e))},this.options.delay)},search:function(e,t){return e=null!=e?e:this._value(),this.term=this._value(),e.length<this.options.minLength?this.close(t):this._trigger("search",t)!==!1?this._search(e):void 0},_search:function(e){this.pending++,this.element.addClass("ui-autocomplete-loading"),this.cancelSearch=!1,this.source({term:e},this._response())},_response:function(){var t=++this.requestIndex;return e.proxy(function(e){t===this.requestIndex&&this.__response(e),this.pending--,this.pending||this.element.removeClass("ui-autocomplete-loading")},this)},__response:function(e){e&&(e=this._normalize(e)),this._trigger("response",null,{content:e}),!this.options.disabled&&e&&e.length&&!this.cancelSearch?(this._suggest(e),this._trigger("open")):this._close()},close:function(e){this.cancelSearch=!0,this._close(e)},_close:function(e){this.menu.element.is(":visible")&&(this.menu.element.hide(),this.menu.blur(),this.isNewMenu=!0,this._trigger("close",e))},_change:function(e){this.previous!==this._value()&&this._trigger("change",e,{item:this.selectedItem})},_normalize:function(t){return t.length&&t[0].label&&t[0].value?t:e.map(t,function(t){return"string"==typeof t?{label:t,value:t}:e.extend({},t,{label:t.label||t.value,value:t.value||t.label})})},_suggest:function(t){var i=this.menu.element.empty();this._renderMenu(i,t),this.isNewMenu=!0,this.menu.refresh(),i.show(),this._resizeMenu(),i.position(e.extend({of:this.element},this.options.position)),this.options.autoFocus&&this.menu.next()
+},_resizeMenu:function(){var e=this.menu.element;e.outerWidth(Math.max(e.width("").outerWidth()+1,this.element.outerWidth()))},_renderMenu:function(t,i){var s=this;e.each(i,function(e,i){s._renderItemData(t,i)})},_renderItemData:function(e,t){return this._renderItem(e,t).data("ui-autocomplete-item",t)},_renderItem:function(t,i){return e("<li>").text(i.label).appendTo(t)},_move:function(e,t){return this.menu.element.is(":visible")?this.menu.isFirstItem()&&/^previous/.test(e)||this.menu.isLastItem()&&/^next/.test(e)?(this.isMultiLine||this._value(this.term),this.menu.blur(),void 0):(this.menu[e](t),void 0):(this.search(null,t),void 0)},widget:function(){return this.menu.element},_value:function(){return this.valueMethod.apply(this.element,arguments)},_keyEvent:function(e,t){(!this.isMultiLine||this.menu.element.is(":visible"))&&(this._move(e,t),t.preventDefault())}}),e.extend(e.ui.autocomplete,{escapeRegex:function(e){return e.replace(/[\-\[\]{}()*+?.,\\\^$|#\s]/g,"\\$&")},filter:function(t,i){var s=RegExp(e.ui.autocomplete.escapeRegex(i),"i");return e.grep(t,function(e){return s.test(e.label||e.value||e)})}}),e.widget("ui.autocomplete",e.ui.autocomplete,{options:{messages:{noResults:"No search results.",results:function(e){return e+(e>1?" results are":" result is")+" available, use up and down arrow keys to navigate."}}},__response:function(t){var i;this._superApply(arguments),this.options.disabled||this.cancelSearch||(i=t&&t.length?this.options.messages.results(t.length):this.options.messages.noResults,this.liveRegion.children().hide(),e("<div>").text(i).appendTo(this.liveRegion))}}),e.ui.autocomplete});
diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.structure.css b/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.structure.css
new file mode 100644
index 0000000000..1a53ab4a15
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.structure.css
@@ -0,0 +1,152 @@
+/*!
+ * jQuery UI CSS Framework 1.11.4
+ * http://jqueryui.com
+ *
+ * Copyright jQuery Foundation and other contributors
+ * Released under the MIT license.
+ * http://jquery.org/license
+ *
+ * http://api.jqueryui.com/category/theming/
+ */
+
+/* Layout helpers
+----------------------------------*/
+.ui-helper-hidden {
+	display: none;
+}
+.ui-helper-hidden-accessible {
+	border: 0;
+	clip: rect(0 0 0 0);
+	height: 1px;
+	margin: -1px;
+	overflow: hidden;
+	padding: 0;
+	position: absolute;
+	width: 1px;
+}
+.ui-helper-reset {
+	margin: 0;
+	padding: 0;
+	border: 0;
+	outline: 0;
+	line-height: 1.3;
+	text-decoration: none;
+	font-size: 100%;
+	list-style: none;
+}
+.ui-helper-clearfix:before,
+.ui-helper-clearfix:after {
+	content: "";
+	display: table;
+	border-collapse: collapse;
+}
+.ui-helper-clearfix:after {
+	clear: both;
+}
+.ui-helper-clearfix {
+	min-height: 0; /* support: IE7 */
+}
+.ui-helper-zfix {
+	width: 100%;
+	height: 100%;
+	top: 0;
+	left: 0;
+	position: absolute;
+	opacity: 0;
+	filter:Alpha(Opacity=0); /* support: IE8 */
+}
+
+.ui-front {
+	z-index: 100;
+}
+
+
+/* Interaction Cues
+----------------------------------*/
+.ui-state-disabled {
+	cursor: default !important;
+}
+
+
+/* Icons
+----------------------------------*/
+
+/* states and images */
+.ui-icon {
+	display: block;
+	text-indent: -99999px;
+	overflow: hidden;
+	background-repeat: no-repeat;
+}
+
+
+/* Misc visuals
+----------------------------------*/
+
+/* Overlays */
+.ui-widget-overlay {
+	position: fixed;
+	top: 0;
+	left: 0;
+	width: 100%;
+	height: 100%;
+}
+.ui-autocomplete {
+	position: absolute;
+	top: 0;
+	left: 0;
+	cursor: default;
+}
+.ui-menu {
+	list-style: none;
+	padding: 0;
+	margin: 0;
+	display: block;
+	outline: none;
+}
+.ui-menu .ui-menu {
+	position: absolute;
+}
+.ui-menu .ui-menu-item {
+	position: relative;
+	margin: 0;
+	padding: 3px 1em 3px .4em;
+	cursor: pointer;
+	min-height: 0; /* support: IE7 */
+	/* support: IE10, see #8844 */
+	list-style-image: url("data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7");
+}
+.ui-menu .ui-menu-divider {
+	margin: 5px 0;
+	height: 0;
+	font-size: 0;
+	line-height: 0;
+	border-width: 1px 0 0 0;
+}
+.ui-menu .ui-state-focus,
+.ui-menu .ui-state-active {
+	margin: -1px;
+}
+
+/* icon support */
+.ui-menu-icons {
+	position: relative;
+}
+.ui-menu-icons .ui-menu-item {
+	padding-left: 2em;
+}
+
+/* left-aligned */
+.ui-menu .ui-icon {
+	position: absolute;
+	top: 0;
+	bottom: 0;
+	left: .2em;
+	margin: auto 0;
+}
+
+/* right-aligned */
+.ui-menu .ui-menu-icon {
+	left: auto;
+	right: 0;
+}
diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.structure.min.css b/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.structure.min.css
new file mode 100644
index 0000000000..7f29f9a076
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/jquery/jquery-ui.structure.min.css
@@ -0,0 +1,5 @@
+/*! jQuery UI - v1.11.4 - 2015-05-20
+* http://jqueryui.com
+* Copyright 2015 jQuery Foundation and other contributors; Licensed MIT */
+
+.ui-helper-hidden{display:none}.ui-helper-hidden-accessible{border:0;clip:rect(0 0 0 0);height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;width:1px}.ui-helper-reset{margin:0;padding:0;border:0;outline:0;line-height:1.3;text-decoration:none;font-size:100%;list-style:none}.ui-helper-clearfix:before,.ui-helper-clearfix:after{content:"";display:table;border-collapse:collapse}.ui-helper-clearfix:after{clear:both}.ui-helper-clearfix{min-height:0}.ui-helper-zfix{width:100%;height:100%;top:0;left:0;position:absolute;opacity:0;filter:Alpha(Opacity=0)}.ui-front{z-index:100}.ui-state-disabled{cursor:default!important}.ui-icon{display:block;text-indent:-99999px;overflow:hidden;background-repeat:no-repeat}.ui-widget-overlay{position:fixed;top:0;left:0;width:100%;height:100%}.ui-autocomplete{position:absolute;top:0;left:0;cursor:default}.ui-menu{list-style:none;padding:0;margin:0;display:block;outline:none}.ui-menu .ui-menu{position:absolute}.ui-menu .ui-menu-item{position:relative;margin:0;padding:3px 1em 3px .4em;cursor:pointer;min-height:0;list-style-image:url("data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7")}.ui-menu .ui-menu-divider{margin:5px 0;height:0;font-size:0;line-height:0;border-width:1px 0 0 0}.ui-menu .ui-state-focus,.ui-menu .ui-state-active{margin:-1px}.ui-menu-icons{position:relative}.ui-menu-icons .ui-menu-item{padding-left:2em}.ui-menu .ui-icon{position:absolute;top:0;bottom:0;left:.2em;margin:auto 0}.ui-menu .ui-menu-icon{left:auto;right:0}
diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/jszip-utils/dist/jszip-utils-ie.js b/spring-cloud-contract-maven-plugin/apidocs/jquery/jszip-utils/dist/jszip-utils-ie.js
new file mode 100644
index 0000000000..a74cc709f6
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/jquery/jszip-utils/dist/jszip-utils-ie.js
@@ -0,0 +1,56 @@
+/*!
+
+JSZipUtils - A collection of cross-browser utilities to go along with JSZip.
+<http://stuk.github.io/jszip-utils>
+
+(c) 2014 Stuart Knightley, David Duponchel
+Dual licenced under the MIT license or GPLv3. See https://raw.github.com/Stuk/jszip-utils/master/LICENSE.markdown.
+
+*/
+;(function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require=="function"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);throw new Error("Cannot find module '"+o+"'")}var f=n[o]={exports:{}};t[o][0].call(f.exports,function(e){var n=t[o][1][e];return s(n?n:e)},f,f.exports,e,t,n,r)}return n[o].exports}var i=typeof require=="function"&&require;for(var o=0;o<r.length;o++)s(r[o]);return s})({1:[function(require,module,exports){
+var global=typeof self !== "undefined" ? self : typeof window !== "undefined" ? window : {};/* jshint evil: true, newcap: false */
+/* global IEBinaryToArray_ByteStr, IEBinaryToArray_ByteStr_Last */
+"use strict";
+
+// Adapted from http://stackoverflow.com/questions/1095102/how-do-i-load-binary-image-data-using-javascript-and-xmlhttprequest
+var IEBinaryToArray_ByteStr_Script =
+    "<!-- IEBinaryToArray_ByteStr -->\r\n"+
+    "<script type='text/vbscript'>\r\n"+
+    "Function IEBinaryToArray_ByteStr(Binary)\r\n"+
+    "   IEBinaryToArray_ByteStr = CStr(Binary)\r\n"+
+    "End Function\r\n"+
+    "Function IEBinaryToArray_ByteStr_Last(Binary)\r\n"+
+    "   Dim lastIndex\r\n"+
+    "   lastIndex = LenB(Binary)\r\n"+
+    "   if lastIndex mod 2 Then\r\n"+
+    "       IEBinaryToArray_ByteStr_Last = Chr( AscB( MidB( Binary, lastIndex, 1 ) ) )\r\n"+
+    "   Else\r\n"+
+    "       IEBinaryToArray_ByteStr_Last = "+'""'+"\r\n"+
+    "   End If\r\n"+
+    "End Function\r\n"+
+    "</script>\r\n";
+
+// inject VBScript
+document.write(IEBinaryToArray_ByteStr_Script);
+
+global.JSZipUtils._getBinaryFromXHR = function (xhr) {
+    var binary = xhr.responseBody;
+    var byteMapping = {};
+    for ( var i = 0; i < 256; i++ ) {
+        for ( var j = 0; j < 256; j++ ) {
+            byteMapping[ String.fromCharCode( i + (j << 8) ) ] =
+                String.fromCharCode(i) + String.fromCharCode(j);
+        }
+    }
+    var rawBytes = IEBinaryToArray_ByteStr(binary);
+    var lastChr = IEBinaryToArray_ByteStr_Last(binary);
+    return rawBytes.replace(/[\s\S]/g, function( match ) {
+        return byteMapping[match];
+    }) + lastChr;
+};
+
+// enforcing Stuk's coding style
+// vim: set shiftwidth=4 softtabstop=4:
+
+},{}]},{},[1])
+;
diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/jszip-utils/dist/jszip-utils-ie.min.js b/spring-cloud-contract-maven-plugin/apidocs/jquery/jszip-utils/dist/jszip-utils-ie.min.js
new file mode 100644
index 0000000000..93d8bc8ef2
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/jquery/jszip-utils/dist/jszip-utils-ie.min.js
@@ -0,0 +1,10 @@
+/*!
+
+JSZipUtils - A collection of cross-browser utilities to go along with JSZip.
+<http://stuk.github.io/jszip-utils>
+
+(c) 2014 Stuart Knightley, David Duponchel
+Dual licenced under the MIT license or GPLv3. See https://raw.github.com/Stuk/jszip-utils/master/LICENSE.markdown.
+
+*/
+!function a(b,c,d){function e(g,h){if(!c[g]){if(!b[g]){var i="function"==typeof require&&require;if(!h&&i)return i(g,!0);if(f)return f(g,!0);throw new Error("Cannot find module '"+g+"'")}var j=c[g]={exports:{}};b[g][0].call(j.exports,function(a){var c=b[g][1][a];return e(c?c:a)},j,j.exports,a,b,c,d)}return c[g].exports}for(var f="function"==typeof require&&require,g=0;g<d.length;g++)e(d[g]);return e}({1:[function(){var a="undefined"!=typeof self?self:"undefined"!=typeof window?window:{},b="<!-- IEBinaryToArray_ByteStr -->\r\n<script type='text/vbscript'>\r\nFunction IEBinaryToArray_ByteStr(Binary)\r\n   IEBinaryToArray_ByteStr = CStr(Binary)\r\nEnd Function\r\nFunction IEBinaryToArray_ByteStr_Last(Binary)\r\n   Dim lastIndex\r\n   lastIndex = LenB(Binary)\r\n   if lastIndex mod 2 Then\r\n       IEBinaryToArray_ByteStr_Last = Chr( AscB( MidB( Binary, lastIndex, 1 ) ) )\r\n   Else\r\n       IEBinaryToArray_ByteStr_Last = \"\"\r\n   End If\r\nEnd Function\r\n</script>\r\n";document.write(b),a.JSZipUtils._getBinaryFromXHR=function(a){for(var b=a.responseBody,c={},d=0;256>d;d++)for(var e=0;256>e;e++)c[String.fromCharCode(d+(e<<8))]=String.fromCharCode(d)+String.fromCharCode(e);var f=IEBinaryToArray_ByteStr(b),g=IEBinaryToArray_ByteStr_Last(b);return f.replace(/[\s\S]/g,function(a){return c[a]})+g}},{}]},{},[1]);
diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/jszip-utils/dist/jszip-utils.js b/spring-cloud-contract-maven-plugin/apidocs/jquery/jszip-utils/dist/jszip-utils.js
new file mode 100644
index 0000000000..775895ec92
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/jquery/jszip-utils/dist/jszip-utils.js
@@ -0,0 +1,118 @@
+/*!
+
+JSZipUtils - A collection of cross-browser utilities to go along with JSZip.
+<http://stuk.github.io/jszip-utils>
+
+(c) 2014 Stuart Knightley, David Duponchel
+Dual licenced under the MIT license or GPLv3. See https://raw.github.com/Stuk/jszip-utils/master/LICENSE.markdown.
+
+*/
+!function(e){"object"==typeof exports?module.exports=e():"function"==typeof define&&define.amd?define(e):"undefined"!=typeof window?window.JSZipUtils=e():"undefined"!=typeof global?global.JSZipUtils=e():"undefined"!=typeof self&&(self.JSZipUtils=e())}(function(){var define,module,exports;return (function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require=="function"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);throw new Error("Cannot find module '"+o+"'")}var f=n[o]={exports:{}};t[o][0].call(f.exports,function(e){var n=t[o][1][e];return s(n?n:e)},f,f.exports,e,t,n,r)}return n[o].exports}var i=typeof require=="function"&&require;for(var o=0;o<r.length;o++)s(r[o]);return s})({1:[function(require,module,exports){
+'use strict';
+
+var JSZipUtils = {};
+// just use the responseText with xhr1, response with xhr2.
+// The transformation doesn't throw away high-order byte (with responseText)
+// because JSZip handles that case. If not used with JSZip, you may need to
+// do it, see https://developer.mozilla.org/En/Using_XMLHttpRequest#Handling_binary_data
+JSZipUtils._getBinaryFromXHR = function (xhr) {
+    // for xhr.responseText, the 0xFF mask is applied by JSZip
+    return xhr.response || xhr.responseText;
+};
+
+// taken from jQuery
+function createStandardXHR() {
+    try {
+        return new window.XMLHttpRequest();
+    } catch( e ) {}
+}
+
+function createActiveXHR() {
+    try {
+        return new window.ActiveXObject("Microsoft.XMLHTTP");
+    } catch( e ) {}
+}
+
+// Create the request object
+var createXHR = window.ActiveXObject ?
+    /* Microsoft failed to properly
+     * implement the XMLHttpRequest in IE7 (can't request local files),
+     * so we use the ActiveXObject when it is available
+     * Additionally XMLHttpRequest can be disabled in IE7/IE8 so
+     * we need a fallback.
+     */
+    function() {
+    return createStandardXHR() || createActiveXHR();
+} :
+    // For all other browsers, use the standard XMLHttpRequest object
+    createStandardXHR;
+
+
+
+JSZipUtils.getBinaryContent = function(path, callback) {
+    /*
+     * Here is the tricky part : getting the data.
+     * In firefox/chrome/opera/... setting the mimeType to 'text/plain; charset=x-user-defined'
+     * is enough, the result is in the standard xhr.responseText.
+     * cf https://developer.mozilla.org/En/XMLHttpRequest/Using_XMLHttpRequest#Receiving_binary_data_in_older_browsers
+     * In IE <= 9, we must use (the IE only) attribute responseBody
+     * (for binary data, its content is different from responseText).
+     * In IE 10, the 'charset=x-user-defined' trick doesn't work, only the
+     * responseType will work :
+     * http://msdn.microsoft.com/en-us/library/ie/hh673569%28v=vs.85%29.aspx#Binary_Object_upload_and_download
+     *
+     * I'd like to use jQuery to avoid this XHR madness, but it doesn't support
+     * the responseType attribute : http://bugs.jquery.com/ticket/11461
+     */
+    try {
+
+        var xhr = createXHR();
+
+        xhr.open('GET', path, true);
+
+        // recent browsers
+        if ("responseType" in xhr) {
+            xhr.responseType = "arraybuffer";
+        }
+
+        // older browser
+        if(xhr.overrideMimeType) {
+            xhr.overrideMimeType("text/plain; charset=x-user-defined");
+        }
+
+        xhr.onreadystatechange = function(evt) {
+            var file, err;
+            // use `xhr` and not `this`... thanks IE
+            if (xhr.readyState === 4) {
+                if (xhr.status === 200 || xhr.status === 0) {
+                    file = null;
+                    err = null;
+                    try {
+                        file = JSZipUtils._getBinaryFromXHR(xhr);
+                    } catch(e) {
+                        err = new Error(e);
+                    }
+                    callback(err, file);
+                } else {
+                    callback(new Error("Ajax error for " + path + " : " + this.status + " " + this.statusText), null);
+                }
+            }
+        };
+
+        xhr.send();
+
+    } catch (e) {
+        callback(new Error(e), null);
+    }
+};
+
+// export
+module.exports = JSZipUtils;
+
+// enforcing Stuk's coding style
+// vim: set shiftwidth=4 softtabstop=4:
+
+},{}]},{},[1])
+(1)
+});
+;
diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/jszip-utils/dist/jszip-utils.min.js b/spring-cloud-contract-maven-plugin/apidocs/jquery/jszip-utils/dist/jszip-utils.min.js
new file mode 100644
index 0000000000..78c7f5e5aa
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/jquery/jszip-utils/dist/jszip-utils.min.js
@@ -0,0 +1,10 @@
+/*!
+
+JSZipUtils - A collection of cross-browser utilities to go along with JSZip.
+<http://stuk.github.io/jszip-utils>
+
+(c) 2014 Stuart Knightley, David Duponchel
+Dual licenced under the MIT license or GPLv3. See https://raw.github.com/Stuk/jszip-utils/master/LICENSE.markdown.
+
+*/
+!function(a){"object"==typeof exports?module.exports=a():"function"==typeof define&&define.amd?define(a):"undefined"!=typeof window?window.JSZipUtils=a():"undefined"!=typeof global?global.JSZipUtils=a():"undefined"!=typeof self&&(self.JSZipUtils=a())}(function(){return function a(b,c,d){function e(g,h){if(!c[g]){if(!b[g]){var i="function"==typeof require&&require;if(!h&&i)return i(g,!0);if(f)return f(g,!0);throw new Error("Cannot find module '"+g+"'")}var j=c[g]={exports:{}};b[g][0].call(j.exports,function(a){var c=b[g][1][a];return e(c?c:a)},j,j.exports,a,b,c,d)}return c[g].exports}for(var f="function"==typeof require&&require,g=0;g<d.length;g++)e(d[g]);return e}({1:[function(a,b){"use strict";function c(){try{return new window.XMLHttpRequest}catch(a){}}function d(){try{return new window.ActiveXObject("Microsoft.XMLHTTP")}catch(a){}}var e={};e._getBinaryFromXHR=function(a){return a.response||a.responseText};var f=window.ActiveXObject?function(){return c()||d()}:c;e.getBinaryContent=function(a,b){try{var c=f();c.open("GET",a,!0),"responseType"in c&&(c.responseType="arraybuffer"),c.overrideMimeType&&c.overrideMimeType("text/plain; charset=x-user-defined"),c.onreadystatechange=function(){var d,f;if(4===c.readyState)if(200===c.status||0===c.status){d=null,f=null;try{d=e._getBinaryFromXHR(c)}catch(g){f=new Error(g)}b(f,d)}else b(new Error("Ajax error for "+a+" : "+this.status+" "+this.statusText),null)},c.send()}catch(d){b(new Error(d),null)}},b.exports=e},{}]},{},[1])(1)});
diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/jszip/dist/jszip.js b/spring-cloud-contract-maven-plugin/apidocs/jquery/jszip/dist/jszip.js
new file mode 100644
index 0000000000..f44b7054ef
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/jquery/jszip/dist/jszip.js
@@ -0,0 +1,11623 @@
+/*!
+
+JSZip v3.1.5 - A JavaScript class for generating and reading zip files
+<http://stuartk.com/jszip>
+
+(c) 2009-2016 Stuart Knightley <stuart [at] stuartk.com>
+Dual licenced under the MIT license or GPLv3. See https://raw.github.com/Stuk/jszip/master/LICENSE.markdown.
+
+JSZip uses the library pako released under the MIT license :
+https://github.com/nodeca/pako/blob/master/LICENSE
+*/
+
+(function(f){if(typeof exports==="object"&&typeof module!=="undefined"){module.exports=f()}else if(typeof define==="function"&&define.amd){define([],f)}else{var g;if(typeof window!=="undefined"){g=window}else if(typeof global!=="undefined"){g=global}else if(typeof self!=="undefined"){g=self}else{g=this}g.JSZip = f()}})(function(){var define,module,exports;return (function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require=="function"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);var f=new Error("Cannot find module '"+o+"'");throw f.code="MODULE_NOT_FOUND",f}var l=n[o]={exports:{}};t[o][0].call(l.exports,function(e){var n=t[o][1][e];return s(n?n:e)},l,l.exports,e,t,n,r)}return n[o].exports}var i=typeof require=="function"&&require;for(var o=0;o<r.length;o++)s(r[o]);return s})({1:[function(require,module,exports){
+'use strict';
+var utils = require('./utils');
+var support = require('./support');
+// private property
+var _keyStr = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=";
+
+
+// public method for encoding
+exports.encode = function(input) {
+    var output = [];
+    var chr1, chr2, chr3, enc1, enc2, enc3, enc4;
+    var i = 0, len = input.length, remainingBytes = len;
+
+    var isArray = utils.getTypeOf(input) !== "string";
+    while (i < input.length) {
+        remainingBytes = len - i;
+
+        if (!isArray) {
+            chr1 = input.charCodeAt(i++);
+            chr2 = i < len ? input.charCodeAt(i++) : 0;
+            chr3 = i < len ? input.charCodeAt(i++) : 0;
+        } else {
+            chr1 = input[i++];
+            chr2 = i < len ? input[i++] : 0;
+            chr3 = i < len ? input[i++] : 0;
+        }
+
+        enc1 = chr1 >> 2;
+        enc2 = ((chr1 & 3) << 4) | (chr2 >> 4);
+        enc3 = remainingBytes > 1 ? (((chr2 & 15) << 2) | (chr3 >> 6)) : 64;
+        enc4 = remainingBytes > 2 ? (chr3 & 63) : 64;
+
+        output.push(_keyStr.charAt(enc1) + _keyStr.charAt(enc2) + _keyStr.charAt(enc3) + _keyStr.charAt(enc4));
+
+    }
+
+    return output.join("");
+};
+
+// public method for decoding
+exports.decode = function(input) {
+    var chr1, chr2, chr3;
+    var enc1, enc2, enc3, enc4;
+    var i = 0, resultIndex = 0;
+
+    var dataUrlPrefix = "data:";
+
+    if (input.substr(0, dataUrlPrefix.length) === dataUrlPrefix) {
+        // This is a common error: people give a data url
+        // (data:image/png;base64,iVBOR...) with a {base64: true} and
+        // wonders why things don't work.
+        // We can detect that the string input looks like a data url but we
+        // *can't* be sure it is one: removing everything up to the comma would
+        // be too dangerous.
+        throw new Error("Invalid base64 input, it looks like a data url.");
+    }
+
+    input = input.replace(/[^A-Za-z0-9\+\/\=]/g, "");
+
+    var totalLength = input.length * 3 / 4;
+    if(input.charAt(input.length - 1) === _keyStr.charAt(64)) {
+        totalLength--;
+    }
+    if(input.charAt(input.length - 2) === _keyStr.charAt(64)) {
+        totalLength--;
+    }
+    if (totalLength % 1 !== 0) {
+        // totalLength is not an integer, the length does not match a valid
+        // base64 content. That can happen if:
+        // - the input is not a base64 content
+        // - the input is *almost* a base64 content, with a extra chars at the
+        //   beginning or at the end
+        // - the input uses a base64 variant (base64url for example)
+        throw new Error("Invalid base64 input, bad content length.");
+    }
+    var output;
+    if (support.uint8array) {
+        output = new Uint8Array(totalLength|0);
+    } else {
+        output = new Array(totalLength|0);
+    }
+
+    while (i < input.length) {
+
+        enc1 = _keyStr.indexOf(input.charAt(i++));
+        enc2 = _keyStr.indexOf(input.charAt(i++));
+        enc3 = _keyStr.indexOf(input.charAt(i++));
+        enc4 = _keyStr.indexOf(input.charAt(i++));
+
+        chr1 = (enc1 << 2) | (enc2 >> 4);
+        chr2 = ((enc2 & 15) << 4) | (enc3 >> 2);
+        chr3 = ((enc3 & 3) << 6) | enc4;
+
+        output[resultIndex++] = chr1;
+
+        if (enc3 !== 64) {
+            output[resultIndex++] = chr2;
+        }
+        if (enc4 !== 64) {
+            output[resultIndex++] = chr3;
+        }
+
+    }
+
+    return output;
+};
+
+},{"./support":30,"./utils":32}],2:[function(require,module,exports){
+'use strict';
+
+var external = require("./external");
+var DataWorker = require('./stream/DataWorker');
+var DataLengthProbe = require('./stream/DataLengthProbe');
+var Crc32Probe = require('./stream/Crc32Probe');
+var DataLengthProbe = require('./stream/DataLengthProbe');
+
+/**
+ * Represent a compressed object, with everything needed to decompress it.
+ * @constructor
+ * @param {number} compressedSize the size of the data compressed.
+ * @param {number} uncompressedSize the size of the data after decompression.
+ * @param {number} crc32 the crc32 of the decompressed file.
+ * @param {object} compression the type of compression, see lib/compressions.js.
+ * @param {String|ArrayBuffer|Uint8Array|Buffer} data the compressed data.
+ */
+function CompressedObject(compressedSize, uncompressedSize, crc32, compression, data) {
+    this.compressedSize = compressedSize;
+    this.uncompressedSize = uncompressedSize;
+    this.crc32 = crc32;
+    this.compression = compression;
+    this.compressedContent = data;
+}
+
+CompressedObject.prototype = {
+    /**
+     * Create a worker to get the uncompressed content.
+     * @return {GenericWorker} the worker.
+     */
+    getContentWorker : function () {
+        var worker = new DataWorker(external.Promise.resolve(this.compressedContent))
+        .pipe(this.compression.uncompressWorker())
+        .pipe(new DataLengthProbe("data_length"));
+
+        var that = this;
+        worker.on("end", function () {
+            if(this.streamInfo['data_length'] !== that.uncompressedSize) {
+                throw new Error("Bug : uncompressed data size mismatch");
+            }
+        });
+        return worker;
+    },
+    /**
+     * Create a worker to get the compressed content.
+     * @return {GenericWorker} the worker.
+     */
+    getCompressedWorker : function () {
+        return new DataWorker(external.Promise.resolve(this.compressedContent))
+        .withStreamInfo("compressedSize", this.compressedSize)
+        .withStreamInfo("uncompressedSize", this.uncompressedSize)
+        .withStreamInfo("crc32", this.crc32)
+        .withStreamInfo("compression", this.compression)
+        ;
+    }
+};
+
+/**
+ * Chain the given worker with other workers to compress the content with the
+ * given compresion.
+ * @param {GenericWorker} uncompressedWorker the worker to pipe.
+ * @param {Object} compression the compression object.
+ * @param {Object} compressionOptions the options to use when compressing.
+ * @return {GenericWorker} the new worker compressing the content.
+ */
+CompressedObject.createWorkerFrom = function (uncompressedWorker, compression, compressionOptions) {
+    return uncompressedWorker
+    .pipe(new Crc32Probe())
+    .pipe(new DataLengthProbe("uncompressedSize"))
+    .pipe(compression.compressWorker(compressionOptions))
+    .pipe(new DataLengthProbe("compressedSize"))
+    .withStreamInfo("compression", compression);
+};
+
+module.exports = CompressedObject;
+
+},{"./external":6,"./stream/Crc32Probe":25,"./stream/DataLengthProbe":26,"./stream/DataWorker":27}],3:[function(require,module,exports){
+'use strict';
+
+var GenericWorker = require("./stream/GenericWorker");
+
+exports.STORE = {
+    magic: "\x00\x00",
+    compressWorker : function (compressionOptions) {
+        return new GenericWorker("STORE compression");
+    },
+    uncompressWorker : function () {
+        return new GenericWorker("STORE decompression");
+    }
+};
+exports.DEFLATE = require('./flate');
+
+},{"./flate":7,"./stream/GenericWorker":28}],4:[function(require,module,exports){
+'use strict';
+
+var utils = require('./utils');
+
+/**
+ * The following functions come from pako, from pako/lib/zlib/crc32.js
+ * released under the MIT license, see pako https://github.com/nodeca/pako/
+ */
+
+// Use ordinary array, since untyped makes no boost here
+function makeTable() {
+    var c, table = [];
+
+    for(var n =0; n < 256; n++){
+        c = n;
+        for(var k =0; k < 8; k++){
+            c = ((c&1) ? (0xEDB88320 ^ (c >>> 1)) : (c >>> 1));
+        }
+        table[n] = c;
+    }
+
+    return table;
+}
+
+// Create table on load. Just 255 signed longs. Not a problem.
+var crcTable = makeTable();
+
+
+function crc32(crc, buf, len, pos) {
+    var t = crcTable, end = pos + len;
+
+    crc = crc ^ (-1);
+
+    for (var i = pos; i < end; i++ ) {
+        crc = (crc >>> 8) ^ t[(crc ^ buf[i]) & 0xFF];
+    }
+
+    return (crc ^ (-1)); // >>> 0;
+}
+
+// That's all for the pako functions.
+
+/**
+ * Compute the crc32 of a string.
+ * This is almost the same as the function crc32, but for strings. Using the
+ * same function for the two use cases leads to horrible performances.
+ * @param {Number} crc the starting value of the crc.
+ * @param {String} str the string to use.
+ * @param {Number} len the length of the string.
+ * @param {Number} pos the starting position for the crc32 computation.
+ * @return {Number} the computed crc32.
+ */
+function crc32str(crc, str, len, pos) {
+    var t = crcTable, end = pos + len;
+
+    crc = crc ^ (-1);
+
+    for (var i = pos; i < end; i++ ) {
+        crc = (crc >>> 8) ^ t[(crc ^ str.charCodeAt(i)) & 0xFF];
+    }
+
+    return (crc ^ (-1)); // >>> 0;
+}
+
+module.exports = function crc32wrapper(input, crc) {
+    if (typeof input === "undefined" || !input.length) {
+        return 0;
+    }
+
+    var isArray = utils.getTypeOf(input) !== "string";
+
+    if(isArray) {
+        return crc32(crc|0, input, input.length, 0);
+    } else {
+        return crc32str(crc|0, input, input.length, 0);
+    }
+};
+
+},{"./utils":32}],5:[function(require,module,exports){
+'use strict';
+exports.base64 = false;
+exports.binary = false;
+exports.dir = false;
+exports.createFolders = true;
+exports.date = null;
+exports.compression = null;
+exports.compressionOptions = null;
+exports.comment = null;
+exports.unixPermissions = null;
+exports.dosPermissions = null;
+
+},{}],6:[function(require,module,exports){
+/* global Promise */
+'use strict';
+
+// load the global object first:
+// - it should be better integrated in the system (unhandledRejection in node)
+// - the environment may have a custom Promise implementation (see zone.js)
+var ES6Promise = null;
+if (typeof Promise !== "undefined") {
+    ES6Promise = Promise;
+} else {
+    ES6Promise = require("lie");
+}
+
+/**
+ * Let the user use/change some implementations.
+ */
+module.exports = {
+    Promise: ES6Promise
+};
+
+},{"lie":58}],7:[function(require,module,exports){
+'use strict';
+var USE_TYPEDARRAY = (typeof Uint8Array !== 'undefined') && (typeof Uint16Array !== 'undefined') && (typeof Uint32Array !== 'undefined');
+
+var pako = require("pako");
+var utils = require("./utils");
+var GenericWorker = require("./stream/GenericWorker");
+
+var ARRAY_TYPE = USE_TYPEDARRAY ? "uint8array" : "array";
+
+exports.magic = "\x08\x00";
+
+/**
+ * Create a worker that uses pako to inflate/deflate.
+ * @constructor
+ * @param {String} action the name of the pako function to call : either "Deflate" or "Inflate".
+ * @param {Object} options the options to use when (de)compressing.
+ */
+function FlateWorker(action, options) {
+    GenericWorker.call(this, "FlateWorker/" + action);
+
+    this._pako = null;
+    this._pakoAction = action;
+    this._pakoOptions = options;
+    // the `meta` object from the last chunk received
+    // this allow this worker to pass around metadata
+    this.meta = {};
+}
+
+utils.inherits(FlateWorker, GenericWorker);
+
+/**
+ * @see GenericWorker.processChunk
+ */
+FlateWorker.prototype.processChunk = function (chunk) {
+    this.meta = chunk.meta;
+    if (this._pako === null) {
+        this._createPako();
+    }
+    this._pako.push(utils.transformTo(ARRAY_TYPE, chunk.data), false);
+};
+
+/**
+ * @see GenericWorker.flush
+ */
+FlateWorker.prototype.flush = function () {
+    GenericWorker.prototype.flush.call(this);
+    if (this._pako === null) {
+        this._createPako();
+    }
+    this._pako.push([], true);
+};
+/**
+ * @see GenericWorker.cleanUp
+ */
+FlateWorker.prototype.cleanUp = function () {
+    GenericWorker.prototype.cleanUp.call(this);
+    this._pako = null;
+};
+
+/**
+ * Create the _pako object.
+ * TODO: lazy-loading this object isn't the best solution but it's the
+ * quickest. The best solution is to lazy-load the worker list. See also the
+ * issue #446.
+ */
+FlateWorker.prototype._createPako = function () {
+    this._pako = new pako[this._pakoAction]({
+        raw: true,
+        level: this._pakoOptions.level || -1 // default compression
+    });
+    var self = this;
+    this._pako.onData = function(data) {
+        self.push({
+            data : data,
+            meta : self.meta
+        });
+    };
+};
+
+exports.compressWorker = function (compressionOptions) {
+    return new FlateWorker("Deflate", compressionOptions);
+};
+exports.uncompressWorker = function () {
+    return new FlateWorker("Inflate", {});
+};
+
+},{"./stream/GenericWorker":28,"./utils":32,"pako":59}],8:[function(require,module,exports){
+'use strict';
+
+var utils = require('../utils');
+var GenericWorker = require('../stream/GenericWorker');
+var utf8 = require('../utf8');
+var crc32 = require('../crc32');
+var signature = require('../signature');
+
+/**
+ * Transform an integer into a string in hexadecimal.
+ * @private
+ * @param {number} dec the number to convert.
+ * @param {number} bytes the number of bytes to generate.
+ * @returns {string} the result.
+ */
+var decToHex = function(dec, bytes) {
+    var hex = "", i;
+    for (i = 0; i < bytes; i++) {
+        hex += String.fromCharCode(dec & 0xff);
+        dec = dec >>> 8;
+    }
+    return hex;
+};
+
+/**
+ * Generate the UNIX part of the external file attributes.
+ * @param {Object} unixPermissions the unix permissions or null.
+ * @param {Boolean} isDir true if the entry is a directory, false otherwise.
+ * @return {Number} a 32 bit integer.
+ *
+ * adapted from http://unix.stackexchange.com/questions/14705/the-zip-formats-external-file-attribute :
+ *
+ * TTTTsstrwxrwxrwx0000000000ADVSHR
+ * ^^^^____________________________ file type, see zipinfo.c (UNX_*)
+ *     ^^^_________________________ setuid, setgid, sticky
+ *        ^^^^^^^^^________________ permissions
+ *                 ^^^^^^^^^^______ not used ?
+ *                           ^^^^^^ DOS attribute bits : Archive, Directory, Volume label, System file, Hidden, Read only
+ */
+var generateUnixExternalFileAttr = function (unixPermissions, isDir) {
+
+    var result = unixPermissions;
+    if (!unixPermissions) {
+        // I can't use octal values in strict mode, hence the hexa.
+        //  040775 => 0x41fd
+        // 0100664 => 0x81b4
+        result = isDir ? 0x41fd : 0x81b4;
+    }
+    return (result & 0xFFFF) << 16;
+};
+
+/**
+ * Generate the DOS part of the external file attributes.
+ * @param {Object} dosPermissions the dos permissions or null.
+ * @param {Boolean} isDir true if the entry is a directory, false otherwise.
+ * @return {Number} a 32 bit integer.
+ *
+ * Bit 0     Read-Only
+ * Bit 1     Hidden
+ * Bit 2     System
+ * Bit 3     Volume Label
+ * Bit 4     Directory
+ * Bit 5     Archive
+ */
+var generateDosExternalFileAttr = function (dosPermissions, isDir) {
+
+    // the dir flag is already set for compatibility
+    return (dosPermissions || 0)  & 0x3F;
+};
+
+/**
+ * Generate the various parts used in the construction of the final zip file.
+ * @param {Object} streamInfo the hash with informations about the compressed file.
+ * @param {Boolean} streamedContent is the content streamed ?
+ * @param {Boolean} streamingEnded is the stream finished ?
+ * @param {number} offset the current offset from the start of the zip file.
+ * @param {String} platform let's pretend we are this platform (change platform dependents fields)
+ * @param {Function} encodeFileName the function to encode the file name / comment.
+ * @return {Object} the zip parts.
+ */
+var generateZipParts = function(streamInfo, streamedContent, streamingEnded, offset, platform, encodeFileName) {
+    var file = streamInfo['file'],
+    compression = streamInfo['compression'],
+    useCustomEncoding = encodeFileName !== utf8.utf8encode,
+    encodedFileName = utils.transformTo("string", encodeFileName(file.name)),
+    utfEncodedFileName = utils.transformTo("string", utf8.utf8encode(file.name)),
+    comment = file.comment,
+    encodedComment = utils.transformTo("string", encodeFileName(comment)),
+    utfEncodedComment = utils.transformTo("string", utf8.utf8encode(comment)),
+    useUTF8ForFileName = utfEncodedFileName.length !== file.name.length,
+    useUTF8ForComment = utfEncodedComment.length !== comment.length,
+    dosTime,
+    dosDate,
+    extraFields = "",
+    unicodePathExtraField = "",
+    unicodeCommentExtraField = "",
+    dir = file.dir,
+    date = file.date;
+
+
+    var dataInfo = {
+        crc32 : 0,
+        compressedSize : 0,
+        uncompressedSize : 0
+    };
+
+    // if the content is streamed, the sizes/crc32 are only available AFTER
+    // the end of the stream.
+    if (!streamedContent || streamingEnded) {
+        dataInfo.crc32 = streamInfo['crc32'];
+        dataInfo.compressedSize = streamInfo['compressedSize'];
+        dataInfo.uncompressedSize = streamInfo['uncompressedSize'];
+    }
+
+    var bitflag = 0;
+    if (streamedContent) {
+        // Bit 3: the sizes/crc32 are set to zero in the local header.
+        // The correct values are put in the data descriptor immediately
+        // following the compressed data.
+        bitflag |= 0x0008;
+    }
+    if (!useCustomEncoding && (useUTF8ForFileName || useUTF8ForComment)) {
+        // Bit 11: Language encoding flag (EFS).
+        bitflag |= 0x0800;
+    }
+
+
+    var extFileAttr = 0;
+    var versionMadeBy = 0;
+    if (dir) {
+        // dos or unix, we set the dos dir flag
+        extFileAttr |= 0x00010;
+    }
+    if(platform === "UNIX") {
+        versionMadeBy = 0x031E; // UNIX, version 3.0
+        extFileAttr |= generateUnixExternalFileAttr(file.unixPermissions, dir);
+    } else { // DOS or other, fallback to DOS
+        versionMadeBy = 0x0014; // DOS, version 2.0
+        extFileAttr |= generateDosExternalFileAttr(file.dosPermissions, dir);
+    }
+
+    // date
+    // @see http://www.delorie.com/djgpp/doc/rbinter/it/52/13.html
+    // @see http://www.delorie.com/djgpp/doc/rbinter/it/65/16.html
+    // @see http://www.delorie.com/djgpp/doc/rbinter/it/66/16.html
+
+    dosTime = date.getUTCHours();
+    dosTime = dosTime << 6;
+    dosTime = dosTime | date.getUTCMinutes();
+    dosTime = dosTime << 5;
+    dosTime = dosTime | date.getUTCSeconds() / 2;
+
+    dosDate = date.getUTCFullYear() - 1980;
+    dosDate = dosDate << 4;
+    dosDate = dosDate | (date.getUTCMonth() + 1);
+    dosDate = dosDate << 5;
+    dosDate = dosDate | date.getUTCDate();
+
+    if (useUTF8ForFileName) {
+        // set the unicode path extra field. unzip needs at least one extra
+        // field to correctly handle unicode path, so using the path is as good
+        // as any other information. This could improve the situation with
+        // other archive managers too.
+        // This field is usually used without the utf8 flag, with a non
+        // unicode path in the header (winrar, winzip). This helps (a bit)
+        // with the messy Windows' default compressed folders feature but
+        // breaks on p7zip which doesn't seek the unicode path extra field.
+        // So for now, UTF-8 everywhere !
+        unicodePathExtraField =
+            // Version
+            decToHex(1, 1) +
+            // NameCRC32
+            decToHex(crc32(encodedFileName), 4) +
+            // UnicodeName
+            utfEncodedFileName;
+
+        extraFields +=
+            // Info-ZIP Unicode Path Extra Field
+            "\x75\x70" +
+            // size
+            decToHex(unicodePathExtraField.length, 2) +
+            // content
+            unicodePathExtraField;
+    }
+
+    if(useUTF8ForComment) {
+
+        unicodeCommentExtraField =
+            // Version
+            decToHex(1, 1) +
+            // CommentCRC32
+            decToHex(crc32(encodedComment), 4) +
+            // UnicodeName
+            utfEncodedComment;
+
+        extraFields +=
+            // Info-ZIP Unicode Path Extra Field
+            "\x75\x63" +
+            // size
+            decToHex(unicodeCommentExtraField.length, 2) +
+            // content
+            unicodeCommentExtraField;
+    }
+
+    var header = "";
+
+    // version needed to extract
+    header += "\x0A\x00";
+    // general purpose bit flag
+    header += decToHex(bitflag, 2);
+    // compression method
+    header += compression.magic;
+    // last mod file time
+    header += decToHex(dosTime, 2);
+    // last mod file date
+    header += decToHex(dosDate, 2);
+    // crc-32
+    header += decToHex(dataInfo.crc32, 4);
+    // compressed size
+    header += decToHex(dataInfo.compressedSize, 4);
+    // uncompressed size
+    header += decToHex(dataInfo.uncompressedSize, 4);
+    // file name length
+    header += decToHex(encodedFileName.length, 2);
+    // extra field length
+    header += decToHex(extraFields.length, 2);
+
+
+    var fileRecord = signature.LOCAL_FILE_HEADER + header + encodedFileName + extraFields;
+
+    var dirRecord = signature.CENTRAL_FILE_HEADER +
+        // version made by (00: DOS)
+        decToHex(versionMadeBy, 2) +
+        // file header (common to file and central directory)
+        header +
+        // file comment length
+        decToHex(encodedComment.length, 2) +
+        // disk number start
+        "\x00\x00" +
+        // internal file attributes TODO
+        "\x00\x00" +
+        // external file attributes
+        decToHex(extFileAttr, 4) +
+        // relative offset of local header
+        decToHex(offset, 4) +
+        // file name
+        encodedFileName +
+        // extra field
+        extraFields +
+        // file comment
+        encodedComment;
+
+    return {
+        fileRecord: fileRecord,
+        dirRecord: dirRecord
+    };
+};
+
+/**
+ * Generate the EOCD record.
+ * @param {Number} entriesCount the number of entries in the zip file.
+ * @param {Number} centralDirLength the length (in bytes) of the central dir.
+ * @param {Number} localDirLength the length (in bytes) of the local dir.
+ * @param {String} comment the zip file comment as a binary string.
+ * @param {Function} encodeFileName the function to encode the comment.
+ * @return {String} the EOCD record.
+ */
+var generateCentralDirectoryEnd = function (entriesCount, centralDirLength, localDirLength, comment, encodeFileName) {
+    var dirEnd = "";
+    var encodedComment = utils.transformTo("string", encodeFileName(comment));
+
+    // end of central dir signature
+    dirEnd = signature.CENTRAL_DIRECTORY_END +
+        // number of this disk
+        "\x00\x00" +
+        // number of the disk with the start of the central directory
+        "\x00\x00" +
+        // total number of entries in the central directory on this disk
+        decToHex(entriesCount, 2) +
+        // total number of entries in the central directory
+        decToHex(entriesCount, 2) +
+        // size of the central directory   4 bytes
+        decToHex(centralDirLength, 4) +
+        // offset of start of central directory with respect to the starting disk number
+        decToHex(localDirLength, 4) +
+        // .ZIP file comment length
+        decToHex(encodedComment.length, 2) +
+        // .ZIP file comment
+        encodedComment;
+
+    return dirEnd;
+};
+
+/**
+ * Generate data descriptors for a file entry.
+ * @param {Object} streamInfo the hash generated by a worker, containing informations
+ * on the file entry.
+ * @return {String} the data descriptors.
+ */
+var generateDataDescriptors = function (streamInfo) {
+    var descriptor = "";
+    descriptor = signature.DATA_DESCRIPTOR +
+        // crc-32                          4 bytes
+        decToHex(streamInfo['crc32'], 4) +
+        // compressed size                 4 bytes
+        decToHex(streamInfo['compressedSize'], 4) +
+        // uncompressed size               4 bytes
+        decToHex(streamInfo['uncompressedSize'], 4);
+
+    return descriptor;
+};
+
+
+/**
+ * A worker to concatenate other workers to create a zip file.
+ * @param {Boolean} streamFiles `true` to stream the content of the files,
+ * `false` to accumulate it.
+ * @param {String} comment the comment to use.
+ * @param {String} platform the platform to use, "UNIX" or "DOS".
+ * @param {Function} encodeFileName the function to encode file names and comments.
+ */
+function ZipFileWorker(streamFiles, comment, platform, encodeFileName) {
+    GenericWorker.call(this, "ZipFileWorker");
+    // The number of bytes written so far. This doesn't count accumulated chunks.
+    this.bytesWritten = 0;
+    // The comment of the zip file
+    this.zipComment = comment;
+    // The platform "generating" the zip file.
+    this.zipPlatform = platform;
+    // the function to encode file names and comments.
+    this.encodeFileName = encodeFileName;
+    // Should we stream the content of the files ?
+    this.streamFiles = streamFiles;
+    // If `streamFiles` is false, we will need to accumulate the content of the
+    // files to calculate sizes / crc32 (and write them *before* the content).
+    // This boolean indicates if we are accumulating chunks (it will change a lot
+    // during the lifetime of this worker).
+    this.accumulate = false;
+    // The buffer receiving chunks when accumulating content.
+    this.contentBuffer = [];
+    // The list of generated directory records.
+    this.dirRecords = [];
+    // The offset (in bytes) from the beginning of the zip file for the current source.
+    this.currentSourceOffset = 0;
+    // The total number of entries in this zip file.
+    this.entriesCount = 0;
+    // the name of the file currently being added, null when handling the end of the zip file.
+    // Used for the emited metadata.
+    this.currentFile = null;
+
+
+
+    this._sources = [];
+}
+utils.inherits(ZipFileWorker, GenericWorker);
+
+/**
+ * @see GenericWorker.push
+ */
+ZipFileWorker.prototype.push = function (chunk) {
+
+    var currentFilePercent = chunk.meta.percent || 0;
+    var entriesCount = this.entriesCount;
+    var remainingFiles = this._sources.length;
+
+    if(this.accumulate) {
+        this.contentBuffer.push(chunk);
+    } else {
+        this.bytesWritten += chunk.data.length;
+
+        GenericWorker.prototype.push.call(this, {
+            data : chunk.data,
+            meta : {
+                currentFile : this.currentFile,
+                percent : entriesCount ? (currentFilePercent + 100 * (entriesCount - remainingFiles - 1)) / entriesCount : 100
+            }
+        });
+    }
+};
+
+/**
+ * The worker started a new source (an other worker).
+ * @param {Object} streamInfo the streamInfo object from the new source.
+ */
+ZipFileWorker.prototype.openedSource = function (streamInfo) {
+    this.currentSourceOffset = this.bytesWritten;
+    this.currentFile = streamInfo['file'].name;
+
+    var streamedContent = this.streamFiles && !streamInfo['file'].dir;
+
+    // don't stream folders (because they don't have any content)
+    if(streamedContent) {
+        var record = generateZipParts(streamInfo, streamedContent, false, this.currentSourceOffset, this.zipPlatform, this.encodeFileName);
+        this.push({
+            data : record.fileRecord,
+            meta : {percent:0}
+        });
+    } else {
+        // we need to wait for the whole file before pushing anything
+        this.accumulate = true;
+    }
+};
+
+/**
+ * The worker finished a source (an other worker).
+ * @param {Object} streamInfo the streamInfo object from the finished source.
+ */
+ZipFileWorker.prototype.closedSource = function (streamInfo) {
+    this.accumulate = false;
+    var streamedContent = this.streamFiles && !streamInfo['file'].dir;
+    var record = generateZipParts(streamInfo, streamedContent, true, this.currentSourceOffset, this.zipPlatform, this.encodeFileName);
+
+    this.dirRecords.push(record.dirRecord);
+    if(streamedContent) {
+        // after the streamed file, we put data descriptors
+        this.push({
+            data : generateDataDescriptors(streamInfo),
+            meta : {percent:100}
+        });
+    } else {
+        // the content wasn't streamed, we need to push everything now
+        // first the file record, then the content
+        this.push({
+            data : record.fileRecord,
+            meta : {percent:0}
+        });
+        while(this.contentBuffer.length) {
+            this.push(this.contentBuffer.shift());
+        }
+    }
+    this.currentFile = null;
+};
+
+/**
+ * @see GenericWorker.flush
+ */
+ZipFileWorker.prototype.flush = function () {
+
+    var localDirLength = this.bytesWritten;
+    for(var i = 0; i < this.dirRecords.length; i++) {
+        this.push({
+            data : this.dirRecords[i],
+            meta : {percent:100}
+        });
+    }
+    var centralDirLength = this.bytesWritten - localDirLength;
+
+    var dirEnd = generateCentralDirectoryEnd(this.dirRecords.length, centralDirLength, localDirLength, this.zipComment, this.encodeFileName);
+
+    this.push({
+        data : dirEnd,
+        meta : {percent:100}
+    });
+};
+
+/**
+ * Prepare the next source to be read.
+ */
+ZipFileWorker.prototype.prepareNextSource = function () {
+    this.previous = this._sources.shift();
+    this.openedSource(this.previous.streamInfo);
+    if (this.isPaused) {
+        this.previous.pause();
+    } else {
+        this.previous.resume();
+    }
+};
+
+/**
+ * @see GenericWorker.registerPrevious
+ */
+ZipFileWorker.prototype.registerPrevious = function (previous) {
+    this._sources.push(previous);
+    var self = this;
+
+    previous.on('data', function (chunk) {
+        self.processChunk(chunk);
+    });
+    previous.on('end', function () {
+        self.closedSource(self.previous.streamInfo);
+        if(self._sources.length) {
+            self.prepareNextSource();
+        } else {
+            self.end();
+        }
+    });
+    previous.on('error', function (e) {
+        self.error(e);
+    });
+    return this;
+};
+
+/**
+ * @see GenericWorker.resume
+ */
+ZipFileWorker.prototype.resume = function () {
+    if(!GenericWorker.prototype.resume.call(this)) {
+        return false;
+    }
+
+    if (!this.previous && this._sources.length) {
+        this.prepareNextSource();
+        return true;
+    }
+    if (!this.previous && !this._sources.length && !this.generatedError) {
+        this.end();
+        return true;
+    }
+};
+
+/**
+ * @see GenericWorker.error
+ */
+ZipFileWorker.prototype.error = function (e) {
+    var sources = this._sources;
+    if(!GenericWorker.prototype.error.call(this, e)) {
+        return false;
+    }
+    for(var i = 0; i < sources.length; i++) {
+        try {
+            sources[i].error(e);
+        } catch(e) {
+            // the `error` exploded, nothing to do
+        }
+    }
+    return true;
+};
+
+/**
+ * @see GenericWorker.lock
+ */
+ZipFileWorker.prototype.lock = function () {
+    GenericWorker.prototype.lock.call(this);
+    var sources = this._sources;
+    for(var i = 0; i < sources.length; i++) {
+        sources[i].lock();
+    }
+};
+
+module.exports = ZipFileWorker;
+
+},{"../crc32":4,"../signature":23,"../stream/GenericWorker":28,"../utf8":31,"../utils":32}],9:[function(require,module,exports){
+'use strict';
+
+var compressions = require('../compressions');
+var ZipFileWorker = require('./ZipFileWorker');
+
+/**
+ * Find the compression to use.
+ * @param {String} fileCompression the compression defined at the file level, if any.
+ * @param {String} zipCompression the compression defined at the load() level.
+ * @return {Object} the compression object to use.
+ */
+var getCompression = function (fileCompression, zipCompression) {
+
+    var compressionName = fileCompression || zipCompression;
+    var compression = compressions[compressionName];
+    if (!compression) {
+        throw new Error(compressionName + " is not a valid compression method !");
+    }
+    return compression;
+};
+
+/**
+ * Create a worker to generate a zip file.
+ * @param {JSZip} zip the JSZip instance at the right root level.
+ * @param {Object} options to generate the zip file.
+ * @param {String} comment the comment to use.
+ */
+exports.generateWorker = function (zip, options, comment) {
+
+    var zipFileWorker = new ZipFileWorker(options.streamFiles, comment, options.platform, options.encodeFileName);
+    var entriesCount = 0;
+    try {
+
+        zip.forEach(function (relativePath, file) {
+            entriesCount++;
+            var compression = getCompression(file.options.compression, options.compression);
+            var compressionOptions = file.options.compressionOptions || options.compressionOptions || {};
+            var dir = file.dir, date = file.date;
+
+            file._compressWorker(compression, compressionOptions)
+            .withStreamInfo("file", {
+                name : relativePath,
+                dir : dir,
+                date : date,
+                comment : file.comment || "",
+                unixPermissions : file.unixPermissions,
+                dosPermissions : file.dosPermissions
+            })
+            .pipe(zipFileWorker);
+        });
+        zipFileWorker.entriesCount = entriesCount;
+    } catch (e) {
+        zipFileWorker.error(e);
+    }
+
+    return zipFileWorker;
+};
+
+},{"../compressions":3,"./ZipFileWorker":8}],10:[function(require,module,exports){
+'use strict';
+
+/**
+ * Representation a of zip file in js
+ * @constructor
+ */
+function JSZip() {
+    // if this constructor is used without `new`, it adds `new` before itself:
+    if(!(this instanceof JSZip)) {
+        return new JSZip();
+    }
+
+    if(arguments.length) {
+        throw new Error("The constructor with parameters has been removed in JSZip 3.0, please check the upgrade guide.");
+    }
+
+    // object containing the files :
+    // {
+    //   "folder/" : {...},
+    //   "folder/data.txt" : {...}
+    // }
+    this.files = {};
+
+    this.comment = null;
+
+    // Where we are in the hierarchy
+    this.root = "";
+    this.clone = function() {
+        var newObj = new JSZip();
+        for (var i in this) {
+            if (typeof this[i] !== "function") {
+                newObj[i] = this[i];
+            }
+        }
+        return newObj;
+    };
+}
+JSZip.prototype = require('./object');
+JSZip.prototype.loadAsync = require('./load');
+JSZip.support = require('./support');
+JSZip.defaults = require('./defaults');
+
+// TODO find a better way to handle this version,
+// a require('package.json').version doesn't work with webpack, see #327
+JSZip.version = "3.1.5";
+
+JSZip.loadAsync = function (content, options) {
+    return new JSZip().loadAsync(content, options);
+};
+
+JSZip.external = require("./external");
+module.exports = JSZip;
+
+},{"./defaults":5,"./external":6,"./load":11,"./object":15,"./support":30}],11:[function(require,module,exports){
+'use strict';
+var utils = require('./utils');
+var external = require("./external");
+var utf8 = require('./utf8');
+var utils = require('./utils');
+var ZipEntries = require('./zipEntries');
+var Crc32Probe = require('./stream/Crc32Probe');
+var nodejsUtils = require("./nodejsUtils");
+
+/**
+ * Check the CRC32 of an entry.
+ * @param {ZipEntry} zipEntry the zip entry to check.
+ * @return {Promise} the result.
+ */
+function checkEntryCRC32(zipEntry) {
+    return new external.Promise(function (resolve, reject) {
+        var worker = zipEntry.decompressed.getContentWorker().pipe(new Crc32Probe());
+        worker.on("error", function (e) {
+            reject(e);
+        })
+        .on("end", function () {
+            if (worker.streamInfo.crc32 !== zipEntry.decompressed.crc32) {
+                reject(new Error("Corrupted zip : CRC32 mismatch"));
+            } else {
+                resolve();
+            }
+        })
+        .resume();
+    });
+}
+
+module.exports = function(data, options) {
+    var zip = this;
+    options = utils.extend(options || {}, {
+        base64: false,
+        checkCRC32: false,
+        optimizedBinaryString: false,
+        createFolders: false,
+        decodeFileName: utf8.utf8decode
+    });
+
+    if (nodejsUtils.isNode && nodejsUtils.isStream(data)) {
+        return external.Promise.reject(new Error("JSZip can't accept a stream when loading a zip file."));
+    }
+
+    return utils.prepareContent("the loaded zip file", data, true, options.optimizedBinaryString, options.base64)
+    .then(function(data) {
+        var zipEntries = new ZipEntries(options);
+        zipEntries.load(data);
+        return zipEntries;
+    }).then(function checkCRC32(zipEntries) {
+        var promises = [external.Promise.resolve(zipEntries)];
+        var files = zipEntries.files;
+        if (options.checkCRC32) {
+            for (var i = 0; i < files.length; i++) {
+                promises.push(checkEntryCRC32(files[i]));
+            }
+        }
+        return external.Promise.all(promises);
+    }).then(function addFiles(results) {
+        var zipEntries = results.shift();
+        var files = zipEntries.files;
+        for (var i = 0; i < files.length; i++) {
+            var input = files[i];
+            zip.file(input.fileNameStr, input.decompressed, {
+                binary: true,
+                optimizedBinaryString: true,
+                date: input.date,
+                dir: input.dir,
+                comment : input.fileCommentStr.length ? input.fileCommentStr : null,
+                unixPermissions : input.unixPermissions,
+                dosPermissions : input.dosPermissions,
+                createFolders: options.createFolders
+            });
+        }
+        if (zipEntries.zipComment.length) {
+            zip.comment = zipEntries.zipComment;
+        }
+
+        return zip;
+    });
+};
+
+},{"./external":6,"./nodejsUtils":14,"./stream/Crc32Probe":25,"./utf8":31,"./utils":32,"./zipEntries":33}],12:[function(require,module,exports){
+"use strict";
+
+var utils = require('../utils');
+var GenericWorker = require('../stream/GenericWorker');
+
+/**
+ * A worker that use a nodejs stream as source.
+ * @constructor
+ * @param {String} filename the name of the file entry for this stream.
+ * @param {Readable} stream the nodejs stream.
+ */
+function NodejsStreamInputAdapter(filename, stream) {
+    GenericWorker.call(this, "Nodejs stream input adapter for " + filename);
+    this._upstreamEnded = false;
+    this._bindStream(stream);
+}
+
+utils.inherits(NodejsStreamInputAdapter, GenericWorker);
+
+/**
+ * Prepare the stream and bind the callbacks on it.
+ * Do this ASAP on node 0.10 ! A lazy binding doesn't always work.
+ * @param {Stream} stream the nodejs stream to use.
+ */
+NodejsStreamInputAdapter.prototype._bindStream = function (stream) {
+    var self = this;
+    this._stream = stream;
+    stream.pause();
+    stream
+    .on("data", function (chunk) {
+        self.push({
+            data: chunk,
+            meta : {
+                percent : 0
+            }
+        });
+    })
+    .on("error", function (e) {
+        if(self.isPaused) {
+            this.generatedError = e;
+        } else {
+            self.error(e);
+        }
+    })
+    .on("end", function () {
+        if(self.isPaused) {
+            self._upstreamEnded = true;
+        } else {
+            self.end();
+        }
+    });
+};
+NodejsStreamInputAdapter.prototype.pause = function () {
+    if(!GenericWorker.prototype.pause.call(this)) {
+        return false;
+    }
+    this._stream.pause();
+    return true;
+};
+NodejsStreamInputAdapter.prototype.resume = function () {
+    if(!GenericWorker.prototype.resume.call(this)) {
+        return false;
+    }
+
+    if(this._upstreamEnded) {
+        this.end();
+    } else {
+        this._stream.resume();
+    }
+
+    return true;
+};
+
+module.exports = NodejsStreamInputAdapter;
+
+},{"../stream/GenericWorker":28,"../utils":32}],13:[function(require,module,exports){
+'use strict';
+
+var Readable = require('readable-stream').Readable;
+
+var utils = require('../utils');
+utils.inherits(NodejsStreamOutputAdapter, Readable);
+
+/**
+* A nodejs stream using a worker as source.
+* @see the SourceWrapper in http://nodejs.org/api/stream.html
+* @constructor
+* @param {StreamHelper} helper the helper wrapping the worker
+* @param {Object} options the nodejs stream options
+* @param {Function} updateCb the update callback.
+*/
+function NodejsStreamOutputAdapter(helper, options, updateCb) {
+    Readable.call(this, options);
+    this._helper = helper;
+
+    var self = this;
+    helper.on("data", function (data, meta) {
+        if (!self.push(data)) {
+            self._helper.pause();
+        }
+        if(updateCb) {
+            updateCb(meta);
+        }
+    })
+    .on("error", function(e) {
+        self.emit('error', e);
+    })
+    .on("end", function () {
+        self.push(null);
+    });
+}
+
+
+NodejsStreamOutputAdapter.prototype._read = function() {
+    this._helper.resume();
+};
+
+module.exports = NodejsStreamOutputAdapter;
+
+},{"../utils":32,"readable-stream":16}],14:[function(require,module,exports){
+'use strict';
+
+module.exports = {
+    /**
+     * True if this is running in Nodejs, will be undefined in a browser.
+     * In a browser, browserify won't include this file and the whole module
+     * will be resolved an empty object.
+     */
+    isNode : typeof Buffer !== "undefined",
+    /**
+     * Create a new nodejs Buffer from an existing content.
+     * @param {Object} data the data to pass to the constructor.
+     * @param {String} encoding the encoding to use.
+     * @return {Buffer} a new Buffer.
+     */
+    newBufferFrom: function(data, encoding) {
+        // XXX We can't use `Buffer.from` which comes from `Uint8Array.from`
+        // in nodejs v4 (< v.4.5). It's not the expected implementation (and
+        // has a different signature).
+        // see https://github.com/nodejs/node/issues/8053
+        // A condition on nodejs' version won't solve the issue as we don't
+        // control the Buffer polyfills that may or may not be used.
+        return new Buffer(data, encoding);
+    },
+    /**
+     * Create a new nodejs Buffer with the specified size.
+     * @param {Integer} size the size of the buffer.
+     * @return {Buffer} a new Buffer.
+     */
+    allocBuffer: function (size) {
+        if (Buffer.alloc) {
+            return Buffer.alloc(size);
+        } else {
+            return new Buffer(size);
+        }
+    },
+    /**
+     * Find out if an object is a Buffer.
+     * @param {Object} b the object to test.
+     * @return {Boolean} true if the object is a Buffer, false otherwise.
+     */
+    isBuffer : function(b){
+        return Buffer.isBuffer(b);
+    },
+
+    isStream : function (obj) {
+        return obj &&
+            typeof obj.on === "function" &&
+            typeof obj.pause === "function" &&
+            typeof obj.resume === "function";
+    }
+};
+
+},{}],15:[function(require,module,exports){
+'use strict';
+var utf8 = require('./utf8');
+var utils = require('./utils');
+var GenericWorker = require('./stream/GenericWorker');
+var StreamHelper = require('./stream/StreamHelper');
+var defaults = require('./defaults');
+var CompressedObject = require('./compressedObject');
+var ZipObject = require('./zipObject');
+var generate = require("./generate");
+var nodejsUtils = require("./nodejsUtils");
+var NodejsStreamInputAdapter = require("./nodejs/NodejsStreamInputAdapter");
+
+
+/**
+ * Add a file in the current folder.
+ * @private
+ * @param {string} name the name of the file
+ * @param {String|ArrayBuffer|Uint8Array|Buffer} data the data of the file
+ * @param {Object} originalOptions the options of the file
+ * @return {Object} the new file.
+ */
+var fileAdd = function(name, data, originalOptions) {
+    // be sure sub folders exist
+    var dataType = utils.getTypeOf(data),
+        parent;
+
+
+    /*
+     * Correct options.
+     */
+
+    var o = utils.extend(originalOptions || {}, defaults);
+    o.date = o.date || new Date();
+    if (o.compression !== null) {
+        o.compression = o.compression.toUpperCase();
+    }
+
+    if (typeof o.unixPermissions === "string") {
+        o.unixPermissions = parseInt(o.unixPermissions, 8);
+    }
+
+    // UNX_IFDIR  0040000 see zipinfo.c
+    if (o.unixPermissions && (o.unixPermissions & 0x4000)) {
+        o.dir = true;
+    }
+    // Bit 4    Directory
+    if (o.dosPermissions && (o.dosPermissions & 0x0010)) {
+        o.dir = true;
+    }
+
+    if (o.dir) {
+        name = forceTrailingSlash(name);
+    }
+    if (o.createFolders && (parent = parentFolder(name))) {
+        folderAdd.call(this, parent, true);
+    }
+
+    var isUnicodeString = dataType === "string" && o.binary === false && o.base64 === false;
+    if (!originalOptions || typeof originalOptions.binary === "undefined") {
+        o.binary = !isUnicodeString;
+    }
+
+
+    var isCompressedEmpty = (data instanceof CompressedObject) && data.uncompressedSize === 0;
+
+    if (isCompressedEmpty || o.dir || !data || data.length === 0) {
+        o.base64 = false;
+        o.binary = true;
+        data = "";
+        o.compression = "STORE";
+        dataType = "string";
+    }
+
+    /*
+     * Convert content to fit.
+     */
+
+    var zipObjectContent = null;
+    if (data instanceof CompressedObject || data instanceof GenericWorker) {
+        zipObjectContent = data;
+    } else if (nodejsUtils.isNode && nodejsUtils.isStream(data)) {
+        zipObjectContent = new NodejsStreamInputAdapter(name, data);
+    } else {
+        zipObjectContent = utils.prepareContent(name, data, o.binary, o.optimizedBinaryString, o.base64);
+    }
+
+    var object = new ZipObject(name, zipObjectContent, o);
+    this.files[name] = object;
+    /*
+    TODO: we can't throw an exception because we have async promises
+    (we can have a promise of a Date() for example) but returning a
+    promise is useless because file(name, data) returns the JSZip
+    object for chaining. Should we break that to allow the user
+    to catch the error ?
+
+    return external.Promise.resolve(zipObjectContent)
+    .then(function () {
+        return object;
+    });
+    */
+};
+
+/**
+ * Find the parent folder of the path.
+ * @private
+ * @param {string} path the path to use
+ * @return {string} the parent folder, or ""
+ */
+var parentFolder = function (path) {
+    if (path.slice(-1) === '/') {
+        path = path.substring(0, path.length - 1);
+    }
+    var lastSlash = path.lastIndexOf('/');
+    return (lastSlash > 0) ? path.substring(0, lastSlash) : "";
+};
+
+/**
+ * Returns the path with a slash at the end.
+ * @private
+ * @param {String} path the path to check.
+ * @return {String} the path with a trailing slash.
+ */
+var forceTrailingSlash = function(path) {
+    // Check the name ends with a /
+    if (path.slice(-1) !== "/") {
+        path += "/"; // IE doesn't like substr(-1)
+    }
+    return path;
+};
+
+/**
+ * Add a (sub) folder in the current folder.
+ * @private
+ * @param {string} name the folder's name
+ * @param {boolean=} [createFolders] If true, automatically create sub
+ *  folders. Defaults to false.
+ * @return {Object} the new folder.
+ */
+var folderAdd = function(name, createFolders) {
+    createFolders = (typeof createFolders !== 'undefined') ? createFolders : defaults.createFolders;
+
+    name = forceTrailingSlash(name);
+
+    // Does this folder already exist?
+    if (!this.files[name]) {
+        fileAdd.call(this, name, null, {
+            dir: true,
+            createFolders: createFolders
+        });
+    }
+    return this.files[name];
+};
+
+/**
+* Cross-window, cross-Node-context regular expression detection
+* @param  {Object}  object Anything
+* @return {Boolean}        true if the object is a regular expression,
+* false otherwise
+*/
+function isRegExp(object) {
+    return Object.prototype.toString.call(object) === "[object RegExp]";
+}
+
+// return the actual prototype of JSZip
+var out = {
+    /**
+     * @see loadAsync
+     */
+    load: function() {
+        throw new Error("This method has been removed in JSZip 3.0, please check the upgrade guide.");
+    },
+
+
+    /**
+     * Call a callback function for each entry at this folder level.
+     * @param {Function} cb the callback function:
+     * function (relativePath, file) {...}
+     * It takes 2 arguments : the relative path and the file.
+     */
+    forEach: function(cb) {
+        var filename, relativePath, file;
+        for (filename in this.files) {
+            if (!this.files.hasOwnProperty(filename)) {
+                continue;
+            }
+            file = this.files[filename];
+            relativePath = filename.slice(this.root.length, filename.length);
+            if (relativePath && filename.slice(0, this.root.length) === this.root) { // the file is in the current root
+                cb(relativePath, file); // TODO reverse the parameters ? need to be clean AND consistent with the filter search fn...
+            }
+        }
+    },
+
+    /**
+     * Filter nested files/folders with the specified function.
+     * @param {Function} search the predicate to use :
+     * function (relativePath, file) {...}
+     * It takes 2 arguments : the relative path and the file.
+     * @return {Array} An array of matching elements.
+     */
+    filter: function(search) {
+        var result = [];
+        this.forEach(function (relativePath, entry) {
+            if (search(relativePath, entry)) { // the file matches the function
+                result.push(entry);
+            }
+
+        });
+        return result;
+    },
+
+    /**
+     * Add a file to the zip file, or search a file.
+     * @param   {string|RegExp} name The name of the file to add (if data is defined),
+     * the name of the file to find (if no data) or a regex to match files.
+     * @param   {String|ArrayBuffer|Uint8Array|Buffer} data  The file data, either raw or base64 encoded
+     * @param   {Object} o     File options
+     * @return  {JSZip|Object|Array} this JSZip object (when adding a file),
+     * a file (when searching by string) or an array of files (when searching by regex).
+     */
+    file: function(name, data, o) {
+        if (arguments.length === 1) {
+            if (isRegExp(name)) {
+                var regexp = name;
+                return this.filter(function(relativePath, file) {
+                    return !file.dir && regexp.test(relativePath);
+                });
+            }
+            else { // text
+                var obj = this.files[this.root + name];
+                if (obj && !obj.dir) {
+                    return obj;
+                } else {
+                    return null;
+                }
+            }
+        }
+        else { // more than one argument : we have data !
+            name = this.root + name;
+            fileAdd.call(this, name, data, o);
+        }
+        return this;
+    },
+
+    /**
+     * Add a directory to the zip file, or search.
+     * @param   {String|RegExp} arg The name of the directory to add, or a regex to search folders.
+     * @return  {JSZip} an object with the new directory as the root, or an array containing matching folders.
+     */
+    folder: function(arg) {
+        if (!arg) {
+            return this;
+        }
+
+        if (isRegExp(arg)) {
+            return this.filter(function(relativePath, file) {
+                return file.dir && arg.test(relativePath);
+            });
+        }
+
+        // else, name is a new folder
+        var name = this.root + arg;
+        var newFolder = folderAdd.call(this, name);
+
+        // Allow chaining by returning a new object with this folder as the root
+        var ret = this.clone();
+        ret.root = newFolder.name;
+        return ret;
+    },
+
+    /**
+     * Delete a file, or a directory and all sub-files, from the zip
+     * @param {string} name the name of the file to delete
+     * @return {JSZip} this JSZip object
+     */
+    remove: function(name) {
+        name = this.root + name;
+        var file = this.files[name];
+        if (!file) {
+            // Look for any folders
+            if (name.slice(-1) !== "/") {
+                name += "/";
+            }
+            file = this.files[name];
+        }
+
+        if (file && !file.dir) {
+            // file
+            delete this.files[name];
+        } else {
+            // maybe a folder, delete recursively
+            var kids = this.filter(function(relativePath, file) {
+                return file.name.slice(0, name.length) === name;
+            });
+            for (var i = 0; i < kids.length; i++) {
+                delete this.files[kids[i].name];
+            }
+        }
+
+        return this;
+    },
+
+    /**
+     * Generate the complete zip file
+     * @param {Object} options the options to generate the zip file :
+     * - compression, "STORE" by default.
+     * - type, "base64" by default. Values are : string, base64, uint8array, arraybuffer, blob.
+     * @return {String|Uint8Array|ArrayBuffer|Buffer|Blob} the zip file
+     */
+    generate: function(options) {
+        throw new Error("This method has been removed in JSZip 3.0, please check the upgrade guide.");
+    },
+
+    /**
+     * Generate the complete zip file as an internal stream.
+     * @param {Object} options the options to generate the zip file :
+     * - compression, "STORE" by default.
+     * - type, "base64" by default. Values are : string, base64, uint8array, arraybuffer, blob.
+     * @return {StreamHelper} the streamed zip file.
+     */
+    generateInternalStream: function(options) {
+      var worker, opts = {};
+      try {
+          opts = utils.extend(options || {}, {
+              streamFiles: false,
+              compression: "STORE",
+              compressionOptions : null,
+              type: "",
+              platform: "DOS",
+              comment: null,
+              mimeType: 'application/zip',
+              encodeFileName: utf8.utf8encode
+          });
+
+          opts.type = opts.type.toLowerCase();
+          opts.compression = opts.compression.toUpperCase();
+
+          // "binarystring" is prefered but the internals use "string".
+          if(opts.type === "binarystring") {
+            opts.type = "string";
+          }
+
+          if (!opts.type) {
+            throw new Error("No output type specified.");
+          }
+
+          utils.checkSupport(opts.type);
+
+          // accept nodejs `process.platform`
+          if(
+              opts.platform === 'darwin' ||
+              opts.platform === 'freebsd' ||
+              opts.platform === 'linux' ||
+              opts.platform === 'sunos'
+          ) {
+              opts.platform = "UNIX";
+          }
+          if (opts.platform === 'win32') {
+              opts.platform = "DOS";
+          }
+
+          var comment = opts.comment || this.comment || "";
+          worker = generate.generateWorker(this, opts, comment);
+      } catch (e) {
+        worker = new GenericWorker("error");
+        worker.error(e);
+      }
+      return new StreamHelper(worker, opts.type || "string", opts.mimeType);
+    },
+    /**
+     * Generate the complete zip file asynchronously.
+     * @see generateInternalStream
+     */
+    generateAsync: function(options, onUpdate) {
+        return this.generateInternalStream(options).accumulate(onUpdate);
+    },
+    /**
+     * Generate the complete zip file asynchronously.
+     * @see generateInternalStream
+     */
+    generateNodeStream: function(options, onUpdate) {
+        options = options || {};
+        if (!options.type) {
+            options.type = "nodebuffer";
+        }
+        return this.generateInternalStream(options).toNodejsStream(onUpdate);
+    }
+};
+module.exports = out;
+
+},{"./compressedObject":2,"./defaults":5,"./generate":9,"./nodejs/NodejsStreamInputAdapter":12,"./nodejsUtils":14,"./stream/GenericWorker":28,"./stream/StreamHelper":29,"./utf8":31,"./utils":32,"./zipObject":35}],16:[function(require,module,exports){
+/*
+ * This file is used by module bundlers (browserify/webpack/etc) when
+ * including a stream implementation. We use "readable-stream" to get a
+ * consistent behavior between nodejs versions but bundlers often have a shim
+ * for "stream". Using this shim greatly improve the compatibility and greatly
+ * reduce the final size of the bundle (only one stream implementation, not
+ * two).
+ */
+module.exports = require("stream");
+
+},{"stream":undefined}],17:[function(require,module,exports){
+'use strict';
+var DataReader = require('./DataReader');
+var utils = require('../utils');
+
+function ArrayReader(data) {
+    DataReader.call(this, data);
+	for(var i = 0; i < this.data.length; i++) {
+		data[i] = data[i] & 0xFF;
+	}
+}
+utils.inherits(ArrayReader, DataReader);
+/**
+ * @see DataReader.byteAt
+ */
+ArrayReader.prototype.byteAt = function(i) {
+    return this.data[this.zero + i];
+};
+/**
+ * @see DataReader.lastIndexOfSignature
+ */
+ArrayReader.prototype.lastIndexOfSignature = function(sig) {
+    var sig0 = sig.charCodeAt(0),
+        sig1 = sig.charCodeAt(1),
+        sig2 = sig.charCodeAt(2),
+        sig3 = sig.charCodeAt(3);
+    for (var i = this.length - 4; i >= 0; --i) {
+        if (this.data[i] === sig0 && this.data[i + 1] === sig1 && this.data[i + 2] === sig2 && this.data[i + 3] === sig3) {
+            return i - this.zero;
+        }
+    }
+
+    return -1;
+};
+/**
+ * @see DataReader.readAndCheckSignature
+ */
+ArrayReader.prototype.readAndCheckSignature = function (sig) {
+    var sig0 = sig.charCodeAt(0),
+        sig1 = sig.charCodeAt(1),
+        sig2 = sig.charCodeAt(2),
+        sig3 = sig.charCodeAt(3),
+        data = this.readData(4);
+    return sig0 === data[0] && sig1 === data[1] && sig2 === data[2] && sig3 === data[3];
+};
+/**
+ * @see DataReader.readData
+ */
+ArrayReader.prototype.readData = function(size) {
+    this.checkOffset(size);
+    if(size === 0) {
+        return [];
+    }
+    var result = this.data.slice(this.zero + this.index, this.zero + this.index + size);
+    this.index += size;
+    return result;
+};
+module.exports = ArrayReader;
+
+},{"../utils":32,"./DataReader":18}],18:[function(require,module,exports){
+'use strict';
+var utils = require('../utils');
+
+function DataReader(data) {
+    this.data = data; // type : see implementation
+    this.length = data.length;
+    this.index = 0;
+    this.zero = 0;
+}
+DataReader.prototype = {
+    /**
+     * Check that the offset will not go too far.
+     * @param {string} offset the additional offset to check.
+     * @throws {Error} an Error if the offset is out of bounds.
+     */
+    checkOffset: function(offset) {
+        this.checkIndex(this.index + offset);
+    },
+    /**
+     * Check that the specified index will not be too far.
+     * @param {string} newIndex the index to check.
+     * @throws {Error} an Error if the index is out of bounds.
+     */
+    checkIndex: function(newIndex) {
+        if (this.length < this.zero + newIndex || newIndex < 0) {
+            throw new Error("End of data reached (data length = " + this.length + ", asked index = " + (newIndex) + "). Corrupted zip ?");
+        }
+    },
+    /**
+     * Change the index.
+     * @param {number} newIndex The new index.
+     * @throws {Error} if the new index is out of the data.
+     */
+    setIndex: function(newIndex) {
+        this.checkIndex(newIndex);
+        this.index = newIndex;
+    },
+    /**
+     * Skip the next n bytes.
+     * @param {number} n the number of bytes to skip.
+     * @throws {Error} if the new index is out of the data.
+     */
+    skip: function(n) {
+        this.setIndex(this.index + n);
+    },
+    /**
+     * Get the byte at the specified index.
+     * @param {number} i the index to use.
+     * @return {number} a byte.
+     */
+    byteAt: function(i) {
+        // see implementations
+    },
+    /**
+     * Get the next number with a given byte size.
+     * @param {number} size the number of bytes to read.
+     * @return {number} the corresponding number.
+     */
+    readInt: function(size) {
+        var result = 0,
+            i;
+        this.checkOffset(size);
+        for (i = this.index + size - 1; i >= this.index; i--) {
+            result = (result << 8) + this.byteAt(i);
+        }
+        this.index += size;
+        return result;
+    },
+    /**
+     * Get the next string with a given byte size.
+     * @param {number} size the number of bytes to read.
+     * @return {string} the corresponding string.
+     */
+    readString: function(size) {
+        return utils.transformTo("string", this.readData(size));
+    },
+    /**
+     * Get raw data without conversion, <size> bytes.
+     * @param {number} size the number of bytes to read.
+     * @return {Object} the raw data, implementation specific.
+     */
+    readData: function(size) {
+        // see implementations
+    },
+    /**
+     * Find the last occurence of a zip signature (4 bytes).
+     * @param {string} sig the signature to find.
+     * @return {number} the index of the last occurence, -1 if not found.
+     */
+    lastIndexOfSignature: function(sig) {
+        // see implementations
+    },
+    /**
+     * Read the signature (4 bytes) at the current position and compare it with sig.
+     * @param {string} sig the expected signature
+     * @return {boolean} true if the signature matches, false otherwise.
+     */
+    readAndCheckSignature: function(sig) {
+        // see implementations
+    },
+    /**
+     * Get the next date.
+     * @return {Date} the date.
+     */
+    readDate: function() {
+        var dostime = this.readInt(4);
+        return new Date(Date.UTC(
+        ((dostime >> 25) & 0x7f) + 1980, // year
+        ((dostime >> 21) & 0x0f) - 1, // month
+        (dostime >> 16) & 0x1f, // day
+        (dostime >> 11) & 0x1f, // hour
+        (dostime >> 5) & 0x3f, // minute
+        (dostime & 0x1f) << 1)); // second
+    }
+};
+module.exports = DataReader;
+
+},{"../utils":32}],19:[function(require,module,exports){
+'use strict';
+var Uint8ArrayReader = require('./Uint8ArrayReader');
+var utils = require('../utils');
+
+function NodeBufferReader(data) {
+    Uint8ArrayReader.call(this, data);
+}
+utils.inherits(NodeBufferReader, Uint8ArrayReader);
+
+/**
+ * @see DataReader.readData
+ */
+NodeBufferReader.prototype.readData = function(size) {
+    this.checkOffset(size);
+    var result = this.data.slice(this.zero + this.index, this.zero + this.index + size);
+    this.index += size;
+    return result;
+};
+module.exports = NodeBufferReader;
+
+},{"../utils":32,"./Uint8ArrayReader":21}],20:[function(require,module,exports){
+'use strict';
+var DataReader = require('./DataReader');
+var utils = require('../utils');
+
+function StringReader(data) {
+    DataReader.call(this, data);
+}
+utils.inherits(StringReader, DataReader);
+/**
+ * @see DataReader.byteAt
+ */
+StringReader.prototype.byteAt = function(i) {
+    return this.data.charCodeAt(this.zero + i);
+};
+/**
+ * @see DataReader.lastIndexOfSignature
+ */
+StringReader.prototype.lastIndexOfSignature = function(sig) {
+    return this.data.lastIndexOf(sig) - this.zero;
+};
+/**
+ * @see DataReader.readAndCheckSignature
+ */
+StringReader.prototype.readAndCheckSignature = function (sig) {
+    var data = this.readData(4);
+    return sig === data;
+};
+/**
+ * @see DataReader.readData
+ */
+StringReader.prototype.readData = function(size) {
+    this.checkOffset(size);
+    // this will work because the constructor applied the "& 0xff" mask.
+    var result = this.data.slice(this.zero + this.index, this.zero + this.index + size);
+    this.index += size;
+    return result;
+};
+module.exports = StringReader;
+
+},{"../utils":32,"./DataReader":18}],21:[function(require,module,exports){
+'use strict';
+var ArrayReader = require('./ArrayReader');
+var utils = require('../utils');
+
+function Uint8ArrayReader(data) {
+    ArrayReader.call(this, data);
+}
+utils.inherits(Uint8ArrayReader, ArrayReader);
+/**
+ * @see DataReader.readData
+ */
+Uint8ArrayReader.prototype.readData = function(size) {
+    this.checkOffset(size);
+    if(size === 0) {
+        // in IE10, when using subarray(idx, idx), we get the array [0x00] instead of [].
+        return new Uint8Array(0);
+    }
+    var result = this.data.subarray(this.zero + this.index, this.zero + this.index + size);
+    this.index += size;
+    return result;
+};
+module.exports = Uint8ArrayReader;
+
+},{"../utils":32,"./ArrayReader":17}],22:[function(require,module,exports){
+'use strict';
+
+var utils = require('../utils');
+var support = require('../support');
+var ArrayReader = require('./ArrayReader');
+var StringReader = require('./StringReader');
+var NodeBufferReader = require('./NodeBufferReader');
+var Uint8ArrayReader = require('./Uint8ArrayReader');
+
+/**
+ * Create a reader adapted to the data.
+ * @param {String|ArrayBuffer|Uint8Array|Buffer} data the data to read.
+ * @return {DataReader} the data reader.
+ */
+module.exports = function (data) {
+    var type = utils.getTypeOf(data);
+    utils.checkSupport(type);
+    if (type === "string" && !support.uint8array) {
+        return new StringReader(data);
+    }
+    if (type === "nodebuffer") {
+        return new NodeBufferReader(data);
+    }
+    if (support.uint8array) {
+        return new Uint8ArrayReader(utils.transformTo("uint8array", data));
+    }
+    return new ArrayReader(utils.transformTo("array", data));
+};
+
+},{"../support":30,"../utils":32,"./ArrayReader":17,"./NodeBufferReader":19,"./StringReader":20,"./Uint8ArrayReader":21}],23:[function(require,module,exports){
+'use strict';
+exports.LOCAL_FILE_HEADER = "PK\x03\x04";
+exports.CENTRAL_FILE_HEADER = "PK\x01\x02";
+exports.CENTRAL_DIRECTORY_END = "PK\x05\x06";
+exports.ZIP64_CENTRAL_DIRECTORY_LOCATOR = "PK\x06\x07";
+exports.ZIP64_CENTRAL_DIRECTORY_END = "PK\x06\x06";
+exports.DATA_DESCRIPTOR = "PK\x07\x08";
+
+},{}],24:[function(require,module,exports){
+'use strict';
+
+var GenericWorker = require('./GenericWorker');
+var utils = require('../utils');
+
+/**
+ * A worker which convert chunks to a specified type.
+ * @constructor
+ * @param {String} destType the destination type.
+ */
+function ConvertWorker(destType) {
+    GenericWorker.call(this, "ConvertWorker to " + destType);
+    this.destType = destType;
+}
+utils.inherits(ConvertWorker, GenericWorker);
+
+/**
+ * @see GenericWorker.processChunk
+ */
+ConvertWorker.prototype.processChunk = function (chunk) {
+    this.push({
+        data : utils.transformTo(this.destType, chunk.data),
+        meta : chunk.meta
+    });
+};
+module.exports = ConvertWorker;
+
+},{"../utils":32,"./GenericWorker":28}],25:[function(require,module,exports){
+'use strict';
+
+var GenericWorker = require('./GenericWorker');
+var crc32 = require('../crc32');
+var utils = require('../utils');
+
+/**
+ * A worker which calculate the crc32 of the data flowing through.
+ * @constructor
+ */
+function Crc32Probe() {
+    GenericWorker.call(this, "Crc32Probe");
+    this.withStreamInfo("crc32", 0);
+}
+utils.inherits(Crc32Probe, GenericWorker);
+
+/**
+ * @see GenericWorker.processChunk
+ */
+Crc32Probe.prototype.processChunk = function (chunk) {
+    this.streamInfo.crc32 = crc32(chunk.data, this.streamInfo.crc32 || 0);
+    this.push(chunk);
+};
+module.exports = Crc32Probe;
+
+},{"../crc32":4,"../utils":32,"./GenericWorker":28}],26:[function(require,module,exports){
+'use strict';
+
+var utils = require('../utils');
+var GenericWorker = require('./GenericWorker');
+
+/**
+ * A worker which calculate the total length of the data flowing through.
+ * @constructor
+ * @param {String} propName the name used to expose the length
+ */
+function DataLengthProbe(propName) {
+    GenericWorker.call(this, "DataLengthProbe for " + propName);
+    this.propName = propName;
+    this.withStreamInfo(propName, 0);
+}
+utils.inherits(DataLengthProbe, GenericWorker);
+
+/**
+ * @see GenericWorker.processChunk
+ */
+DataLengthProbe.prototype.processChunk = function (chunk) {
+    if(chunk) {
+        var length = this.streamInfo[this.propName] || 0;
+        this.streamInfo[this.propName] = length + chunk.data.length;
+    }
+    GenericWorker.prototype.processChunk.call(this, chunk);
+};
+module.exports = DataLengthProbe;
+
+
+},{"../utils":32,"./GenericWorker":28}],27:[function(require,module,exports){
+'use strict';
+
+var utils = require('../utils');
+var GenericWorker = require('./GenericWorker');
+
+// the size of the generated chunks
+// TODO expose this as a public variable
+var DEFAULT_BLOCK_SIZE = 16 * 1024;
+
+/**
+ * A worker that reads a content and emits chunks.
+ * @constructor
+ * @param {Promise} dataP the promise of the data to split
+ */
+function DataWorker(dataP) {
+    GenericWorker.call(this, "DataWorker");
+    var self = this;
+    this.dataIsReady = false;
+    this.index = 0;
+    this.max = 0;
+    this.data = null;
+    this.type = "";
+
+    this._tickScheduled = false;
+
+    dataP.then(function (data) {
+        self.dataIsReady = true;
+        self.data = data;
+        self.max = data && data.length || 0;
+        self.type = utils.getTypeOf(data);
+        if(!self.isPaused) {
+            self._tickAndRepeat();
+        }
+    }, function (e) {
+        self.error(e);
+    });
+}
+
+utils.inherits(DataWorker, GenericWorker);
+
+/**
+ * @see GenericWorker.cleanUp
+ */
+DataWorker.prototype.cleanUp = function () {
+    GenericWorker.prototype.cleanUp.call(this);
+    this.data = null;
+};
+
+/**
+ * @see GenericWorker.resume
+ */
+DataWorker.prototype.resume = function () {
+    if(!GenericWorker.prototype.resume.call(this)) {
+        return false;
+    }
+
+    if (!this._tickScheduled && this.dataIsReady) {
+        this._tickScheduled = true;
+        utils.delay(this._tickAndRepeat, [], this);
+    }
+    return true;
+};
+
+/**
+ * Trigger a tick a schedule an other call to this function.
+ */
+DataWorker.prototype._tickAndRepeat = function() {
+    this._tickScheduled = false;
+    if(this.isPaused || this.isFinished) {
+        return;
+    }
+    this._tick();
+    if(!this.isFinished) {
+        utils.delay(this._tickAndRepeat, [], this);
+        this._tickScheduled = true;
+    }
+};
+
+/**
+ * Read and push a chunk.
+ */
+DataWorker.prototype._tick = function() {
+
+    if(this.isPaused || this.isFinished) {
+        return false;
+    }
+
+    var size = DEFAULT_BLOCK_SIZE;
+    var data = null, nextIndex = Math.min(this.max, this.index + size);
+    if (this.index >= this.max) {
+        // EOF
+        return this.end();
+    } else {
+        switch(this.type) {
+            case "string":
+                data = this.data.substring(this.index, nextIndex);
+            break;
+            case "uint8array":
+                data = this.data.subarray(this.index, nextIndex);
+            break;
+            case "array":
+            case "nodebuffer":
+                data = this.data.slice(this.index, nextIndex);
+            break;
+        }
+        this.index = nextIndex;
+        return this.push({
+            data : data,
+            meta : {
+                percent : this.max ? this.index / this.max * 100 : 0
+            }
+        });
+    }
+};
+
+module.exports = DataWorker;
+
+},{"../utils":32,"./GenericWorker":28}],28:[function(require,module,exports){
+'use strict';
+
+/**
+ * A worker that does nothing but passing chunks to the next one. This is like
+ * a nodejs stream but with some differences. On the good side :
+ * - it works on IE 6-9 without any issue / polyfill
+ * - it weights less than the full dependencies bundled with browserify
+ * - it forwards errors (no need to declare an error handler EVERYWHERE)
+ *
+ * A chunk is an object with 2 attributes : `meta` and `data`. The former is an
+ * object containing anything (`percent` for example), see each worker for more
+ * details. The latter is the real data (String, Uint8Array, etc).
+ *
+ * @constructor
+ * @param {String} name the name of the stream (mainly used for debugging purposes)
+ */
+function GenericWorker(name) {
+    // the name of the worker
+    this.name = name || "default";
+    // an object containing metadata about the workers chain
+    this.streamInfo = {};
+    // an error which happened when the worker was paused
+    this.generatedError = null;
+    // an object containing metadata to be merged by this worker into the general metadata
+    this.extraStreamInfo = {};
+    // true if the stream is paused (and should not do anything), false otherwise
+    this.isPaused = true;
+    // true if the stream is finished (and should not do anything), false otherwise
+    this.isFinished = false;
+    // true if the stream is locked to prevent further structure updates (pipe), false otherwise
+    this.isLocked = false;
+    // the event listeners
+    this._listeners = {
+        'data':[],
+        'end':[],
+        'error':[]
+    };
+    // the previous worker, if any
+    this.previous = null;
+}
+
+GenericWorker.prototype = {
+    /**
+     * Push a chunk to the next workers.
+     * @param {Object} chunk the chunk to push
+     */
+    push : function (chunk) {
+        this.emit("data", chunk);
+    },
+    /**
+     * End the stream.
+     * @return {Boolean} true if this call ended the worker, false otherwise.
+     */
+    end : function () {
+        if (this.isFinished) {
+            return false;
+        }
+
+        this.flush();
+        try {
+            this.emit("end");
+            this.cleanUp();
+            this.isFinished = true;
+        } catch (e) {
+            this.emit("error", e);
+        }
+        return true;
+    },
+    /**
+     * End the stream with an error.
+     * @param {Error} e the error which caused the premature end.
+     * @return {Boolean} true if this call ended the worker with an error, false otherwise.
+     */
+    error : function (e) {
+        if (this.isFinished) {
+            return false;
+        }
+
+        if(this.isPaused) {
+            this.generatedError = e;
+        } else {
+            this.isFinished = true;
+
+            this.emit("error", e);
+
+            // in the workers chain exploded in the middle of the chain,
+            // the error event will go downward but we also need to notify
+            // workers upward that there has been an error.
+            if(this.previous) {
+                this.previous.error(e);
+            }
+
+            this.cleanUp();
+        }
+        return true;
+    },
+    /**
+     * Add a callback on an event.
+     * @param {String} name the name of the event (data, end, error)
+     * @param {Function} listener the function to call when the event is triggered
+     * @return {GenericWorker} the current object for chainability
+     */
+    on : function (name, listener) {
+        this._listeners[name].push(listener);
+        return this;
+    },
+    /**
+     * Clean any references when a worker is ending.
+     */
+    cleanUp : function () {
+        this.streamInfo = this.generatedError = this.extraStreamInfo = null;
+        this._listeners = [];
+    },
+    /**
+     * Trigger an event. This will call registered callback with the provided arg.
+     * @param {String} name the name of the event (data, end, error)
+     * @param {Object} arg the argument to call the callback with.
+     */
+    emit : function (name, arg) {
+        if (this._listeners[name]) {
+            for(var i = 0; i < this._listeners[name].length; i++) {
+                this._listeners[name][i].call(this, arg);
+            }
+        }
+    },
+    /**
+     * Chain a worker with an other.
+     * @param {Worker} next the worker receiving events from the current one.
+     * @return {worker} the next worker for chainability
+     */
+    pipe : function (next) {
+        return next.registerPrevious(this);
+    },
+    /**
+     * Same as `pipe` in the other direction.
+     * Using an API with `pipe(next)` is very easy.
+     * Implementing the API with the point of view of the next one registering
+     * a source is easier, see the ZipFileWorker.
+     * @param {Worker} previous the previous worker, sending events to this one
+     * @return {Worker} the current worker for chainability
+     */
+    registerPrevious : function (previous) {
+        if (this.isLocked) {
+            throw new Error("The stream '" + this + "' has already been used.");
+        }
+
+        // sharing the streamInfo...
+        this.streamInfo = previous.streamInfo;
+        // ... and adding our own bits
+        this.mergeStreamInfo();
+        this.previous =  previous;
+        var self = this;
+        previous.on('data', function (chunk) {
+            self.processChunk(chunk);
+        });
+        previous.on('end', function () {
+            self.end();
+        });
+        previous.on('error', function (e) {
+            self.error(e);
+        });
+        return this;
+    },
+    /**
+     * Pause the stream so it doesn't send events anymore.
+     * @return {Boolean} true if this call paused the worker, false otherwise.
+     */
+    pause : function () {
+        if(this.isPaused || this.isFinished) {
+            return false;
+        }
+        this.isPaused = true;
+
+        if(this.previous) {
+            this.previous.pause();
+        }
+        return true;
+    },
+    /**
+     * Resume a paused stream.
+     * @return {Boolean} true if this call resumed the worker, false otherwise.
+     */
+    resume : function () {
+        if(!this.isPaused || this.isFinished) {
+            return false;
+        }
+        this.isPaused = false;
+
+        // if true, the worker tried to resume but failed
+        var withError = false;
+        if(this.generatedError) {
+            this.error(this.generatedError);
+            withError = true;
+        }
+        if(this.previous) {
+            this.previous.resume();
+        }
+
+        return !withError;
+    },
+    /**
+     * Flush any remaining bytes as the stream is ending.
+     */
+    flush : function () {},
+    /**
+     * Process a chunk. This is usually the method overridden.
+     * @param {Object} chunk the chunk to process.
+     */
+    processChunk : function(chunk) {
+        this.push(chunk);
+    },
+    /**
+     * Add a key/value to be added in the workers chain streamInfo once activated.
+     * @param {String} key the key to use
+     * @param {Object} value the associated value
+     * @return {Worker} the current worker for chainability
+     */
+    withStreamInfo : function (key, value) {
+        this.extraStreamInfo[key] = value;
+        this.mergeStreamInfo();
+        return this;
+    },
+    /**
+     * Merge this worker's streamInfo into the chain's streamInfo.
+     */
+    mergeStreamInfo : function () {
+        for(var key in this.extraStreamInfo) {
+            if (!this.extraStreamInfo.hasOwnProperty(key)) {
+                continue;
+            }
+            this.streamInfo[key] = this.extraStreamInfo[key];
+        }
+    },
+
+    /**
+     * Lock the stream to prevent further updates on the workers chain.
+     * After calling this method, all calls to pipe will fail.
+     */
+    lock: function () {
+        if (this.isLocked) {
+            throw new Error("The stream '" + this + "' has already been used.");
+        }
+        this.isLocked = true;
+        if (this.previous) {
+            this.previous.lock();
+        }
+    },
+
+    /**
+     *
+     * Pretty print the workers chain.
+     */
+    toString : function () {
+        var me = "Worker " + this.name;
+        if (this.previous) {
+            return this.previous + " -> " + me;
+        } else {
+            return me;
+        }
+    }
+};
+
+module.exports = GenericWorker;
+
+},{}],29:[function(require,module,exports){
+'use strict';
+
+var utils = require('../utils');
+var ConvertWorker = require('./ConvertWorker');
+var GenericWorker = require('./GenericWorker');
+var base64 = require('../base64');
+var support = require("../support");
+var external = require("../external");
+
+var NodejsStreamOutputAdapter = null;
+if (support.nodestream) {
+    try {
+        NodejsStreamOutputAdapter = require('../nodejs/NodejsStreamOutputAdapter');
+    } catch(e) {}
+}
+
+/**
+ * Apply the final transformation of the data. If the user wants a Blob for
+ * example, it's easier to work with an U8intArray and finally do the
+ * ArrayBuffer/Blob conversion.
+ * @param {String} type the name of the final type
+ * @param {String|Uint8Array|Buffer} content the content to transform
+ * @param {String} mimeType the mime type of the content, if applicable.
+ * @return {String|Uint8Array|ArrayBuffer|Buffer|Blob} the content in the right format.
+ */
+function transformZipOutput(type, content, mimeType) {
+    switch(type) {
+        case "blob" :
+            return utils.newBlob(utils.transformTo("arraybuffer", content), mimeType);
+        case "base64" :
+            return base64.encode(content);
+        default :
+            return utils.transformTo(type, content);
+    }
+}
+
+/**
+ * Concatenate an array of data of the given type.
+ * @param {String} type the type of the data in the given array.
+ * @param {Array} dataArray the array containing the data chunks to concatenate
+ * @return {String|Uint8Array|Buffer} the concatenated data
+ * @throws Error if the asked type is unsupported
+ */
+function concat (type, dataArray) {
+    var i, index = 0, res = null, totalLength = 0;
+    for(i = 0; i < dataArray.length; i++) {
+        totalLength += dataArray[i].length;
+    }
+    switch(type) {
+        case "string":
+            return dataArray.join("");
+          case "array":
+            return Array.prototype.concat.apply([], dataArray);
+        case "uint8array":
+            res = new Uint8Array(totalLength);
+            for(i = 0; i < dataArray.length; i++) {
+                res.set(dataArray[i], index);
+                index += dataArray[i].length;
+            }
+            return res;
+        case "nodebuffer":
+            return Buffer.concat(dataArray);
+        default:
+            throw new Error("concat : unsupported type '"  + type + "'");
+    }
+}
+
+/**
+ * Listen a StreamHelper, accumulate its content and concatenate it into a
+ * complete block.
+ * @param {StreamHelper} helper the helper to use.
+ * @param {Function} updateCallback a callback called on each update. Called
+ * with one arg :
+ * - the metadata linked to the update received.
+ * @return Promise the promise for the accumulation.
+ */
+function accumulate(helper, updateCallback) {
+    return new external.Promise(function (resolve, reject){
+        var dataArray = [];
+        var chunkType = helper._internalType,
+            resultType = helper._outputType,
+            mimeType = helper._mimeType;
+        helper
+        .on('data', function (data, meta) {
+            dataArray.push(data);
+            if(updateCallback) {
+                updateCallback(meta);
+            }
+        })
+        .on('error', function(err) {
+            dataArray = [];
+            reject(err);
+        })
+        .on('end', function (){
+            try {
+                var result = transformZipOutput(resultType, concat(chunkType, dataArray), mimeType);
+                resolve(result);
+            } catch (e) {
+                reject(e);
+            }
+            dataArray = [];
+        })
+        .resume();
+    });
+}
+
+/**
+ * An helper to easily use workers outside of JSZip.
+ * @constructor
+ * @param {Worker} worker the worker to wrap
+ * @param {String} outputType the type of data expected by the use
+ * @param {String} mimeType the mime type of the content, if applicable.
+ */
+function StreamHelper(worker, outputType, mimeType) {
+    var internalType = outputType;
+    switch(outputType) {
+        case "blob":
+        case "arraybuffer":
+            internalType = "uint8array";
+        break;
+        case "base64":
+            internalType = "string";
+        break;
+    }
+
+    try {
+        // the type used internally
+        this._internalType = internalType;
+        // the type used to output results
+        this._outputType = outputType;
+        // the mime type
+        this._mimeType = mimeType;
+        utils.checkSupport(internalType);
+        this._worker = worker.pipe(new ConvertWorker(internalType));
+        // the last workers can be rewired without issues but we need to
+        // prevent any updates on previous workers.
+        worker.lock();
+    } catch(e) {
+        this._worker = new GenericWorker("error");
+        this._worker.error(e);
+    }
+}
+
+StreamHelper.prototype = {
+    /**
+     * Listen a StreamHelper, accumulate its content and concatenate it into a
+     * complete block.
+     * @param {Function} updateCb the update callback.
+     * @return Promise the promise for the accumulation.
+     */
+    accumulate : function (updateCb) {
+        return accumulate(this, updateCb);
+    },
+    /**
+     * Add a listener on an event triggered on a stream.
+     * @param {String} evt the name of the event
+     * @param {Function} fn the listener
+     * @return {StreamHelper} the current helper.
+     */
+    on : function (evt, fn) {
+        var self = this;
+
+        if(evt === "data") {
+            this._worker.on(evt, function (chunk) {
+                fn.call(self, chunk.data, chunk.meta);
+            });
+        } else {
+            this._worker.on(evt, function () {
+                utils.delay(fn, arguments, self);
+            });
+        }
+        return this;
+    },
+    /**
+     * Resume the flow of chunks.
+     * @return {StreamHelper} the current helper.
+     */
+    resume : function () {
+        utils.delay(this._worker.resume, [], this._worker);
+        return this;
+    },
+    /**
+     * Pause the flow of chunks.
+     * @return {StreamHelper} the current helper.
+     */
+    pause : function () {
+        this._worker.pause();
+        return this;
+    },
+    /**
+     * Return a nodejs stream for this helper.
+     * @param {Function} updateCb the update callback.
+     * @return {NodejsStreamOutputAdapter} the nodejs stream.
+     */
+    toNodejsStream : function (updateCb) {
+        utils.checkSupport("nodestream");
+        if (this._outputType !== "nodebuffer") {
+            // an object stream containing blob/arraybuffer/uint8array/string
+            // is strange and I don't know if it would be useful.
+            // I you find this comment and have a good usecase, please open a
+            // bug report !
+            throw new Error(this._outputType + " is not supported by this method");
+        }
+
+        return new NodejsStreamOutputAdapter(this, {
+            objectMode : this._outputType !== "nodebuffer"
+        }, updateCb);
+    }
+};
+
+
+module.exports = StreamHelper;
+
+},{"../base64":1,"../external":6,"../nodejs/NodejsStreamOutputAdapter":13,"../support":30,"../utils":32,"./ConvertWorker":24,"./GenericWorker":28}],30:[function(require,module,exports){
+'use strict';
+
+exports.base64 = true;
+exports.array = true;
+exports.string = true;
+exports.arraybuffer = typeof ArrayBuffer !== "undefined" && typeof Uint8Array !== "undefined";
+exports.nodebuffer = typeof Buffer !== "undefined";
+// contains true if JSZip can read/generate Uint8Array, false otherwise.
+exports.uint8array = typeof Uint8Array !== "undefined";
+
+if (typeof ArrayBuffer === "undefined") {
+    exports.blob = false;
+}
+else {
+    var buffer = new ArrayBuffer(0);
+    try {
+        exports.blob = new Blob([buffer], {
+            type: "application/zip"
+        }).size === 0;
+    }
+    catch (e) {
+        try {
+            var Builder = self.BlobBuilder || self.WebKitBlobBuilder || self.MozBlobBuilder || self.MSBlobBuilder;
+            var builder = new Builder();
+            builder.append(buffer);
+            exports.blob = builder.getBlob('application/zip').size === 0;
+        }
+        catch (e) {
+            exports.blob = false;
+        }
+    }
+}
+
+try {
+    exports.nodestream = !!require('readable-stream').Readable;
+} catch(e) {
+    exports.nodestream = false;
+}
+
+},{"readable-stream":16}],31:[function(require,module,exports){
+'use strict';
+
+var utils = require('./utils');
+var support = require('./support');
+var nodejsUtils = require('./nodejsUtils');
+var GenericWorker = require('./stream/GenericWorker');
+
+/**
+ * The following functions come from pako, from pako/lib/utils/strings
+ * released under the MIT license, see pako https://github.com/nodeca/pako/
+ */
+
+// Table with utf8 lengths (calculated by first byte of sequence)
+// Note, that 5 & 6-byte values and some 4-byte values can not be represented in JS,
+// because max possible codepoint is 0x10ffff
+var _utf8len = new Array(256);
+for (var i=0; i<256; i++) {
+  _utf8len[i] = (i >= 252 ? 6 : i >= 248 ? 5 : i >= 240 ? 4 : i >= 224 ? 3 : i >= 192 ? 2 : 1);
+}
+_utf8len[254]=_utf8len[254]=1; // Invalid sequence start
+
+// convert string to array (typed, when possible)
+var string2buf = function (str) {
+    var buf, c, c2, m_pos, i, str_len = str.length, buf_len = 0;
+
+    // count binary size
+    for (m_pos = 0; m_pos < str_len; m_pos++) {
+        c = str.charCodeAt(m_pos);
+        if ((c & 0xfc00) === 0xd800 && (m_pos+1 < str_len)) {
+            c2 = str.charCodeAt(m_pos+1);
+            if ((c2 & 0xfc00) === 0xdc00) {
+                c = 0x10000 + ((c - 0xd800) << 10) + (c2 - 0xdc00);
+                m_pos++;
+            }
+        }
+        buf_len += c < 0x80 ? 1 : c < 0x800 ? 2 : c < 0x10000 ? 3 : 4;
+    }
+
+    // allocate buffer
+    if (support.uint8array) {
+        buf = new Uint8Array(buf_len);
+    } else {
+        buf = new Array(buf_len);
+    }
+
+    // convert
+    for (i=0, m_pos = 0; i < buf_len; m_pos++) {
+        c = str.charCodeAt(m_pos);
+        if ((c & 0xfc00) === 0xd800 && (m_pos+1 < str_len)) {
+            c2 = str.charCodeAt(m_pos+1);
+            if ((c2 & 0xfc00) === 0xdc00) {
+                c = 0x10000 + ((c - 0xd800) << 10) + (c2 - 0xdc00);
+                m_pos++;
+            }
+        }
+        if (c < 0x80) {
+            /* one byte */
+            buf[i++] = c;
+        } else if (c < 0x800) {
+            /* two bytes */
+            buf[i++] = 0xC0 | (c >>> 6);
+            buf[i++] = 0x80 | (c & 0x3f);
+        } else if (c < 0x10000) {
+            /* three bytes */
+            buf[i++] = 0xE0 | (c >>> 12);
+            buf[i++] = 0x80 | (c >>> 6 & 0x3f);
+            buf[i++] = 0x80 | (c & 0x3f);
+        } else {
+            /* four bytes */
+            buf[i++] = 0xf0 | (c >>> 18);
+            buf[i++] = 0x80 | (c >>> 12 & 0x3f);
+            buf[i++] = 0x80 | (c >>> 6 & 0x3f);
+            buf[i++] = 0x80 | (c & 0x3f);
+        }
+    }
+
+    return buf;
+};
+
+// Calculate max possible position in utf8 buffer,
+// that will not break sequence. If that's not possible
+// - (very small limits) return max size as is.
+//
+// buf[] - utf8 bytes array
+// max   - length limit (mandatory);
+var utf8border = function(buf, max) {
+    var pos;
+
+    max = max || buf.length;
+    if (max > buf.length) { max = buf.length; }
+
+    // go back from last position, until start of sequence found
+    pos = max-1;
+    while (pos >= 0 && (buf[pos] & 0xC0) === 0x80) { pos--; }
+
+    // Fuckup - very small and broken sequence,
+    // return max, because we should return something anyway.
+    if (pos < 0) { return max; }
+
+    // If we came to start of buffer - that means vuffer is too small,
+    // return max too.
+    if (pos === 0) { return max; }
+
+    return (pos + _utf8len[buf[pos]] > max) ? pos : max;
+};
+
+// convert array to string
+var buf2string = function (buf) {
+    var str, i, out, c, c_len;
+    var len = buf.length;
+
+    // Reserve max possible length (2 words per char)
+    // NB: by unknown reasons, Array is significantly faster for
+    //     String.fromCharCode.apply than Uint16Array.
+    var utf16buf = new Array(len*2);
+
+    for (out=0, i=0; i<len;) {
+        c = buf[i++];
+        // quick process ascii
+        if (c < 0x80) { utf16buf[out++] = c; continue; }
+
+        c_len = _utf8len[c];
+        // skip 5 & 6 byte codes
+        if (c_len > 4) { utf16buf[out++] = 0xfffd; i += c_len-1; continue; }
+
+        // apply mask on first byte
+        c &= c_len === 2 ? 0x1f : c_len === 3 ? 0x0f : 0x07;
+        // join the rest
+        while (c_len > 1 && i < len) {
+            c = (c << 6) | (buf[i++] & 0x3f);
+            c_len--;
+        }
+
+        // terminated by end of string?
+        if (c_len > 1) { utf16buf[out++] = 0xfffd; continue; }
+
+        if (c < 0x10000) {
+            utf16buf[out++] = c;
+        } else {
+            c -= 0x10000;
+            utf16buf[out++] = 0xd800 | ((c >> 10) & 0x3ff);
+            utf16buf[out++] = 0xdc00 | (c & 0x3ff);
+        }
+    }
+
+    // shrinkBuf(utf16buf, out)
+    if (utf16buf.length !== out) {
+        if(utf16buf.subarray) {
+            utf16buf = utf16buf.subarray(0, out);
+        } else {
+            utf16buf.length = out;
+        }
+    }
+
+    // return String.fromCharCode.apply(null, utf16buf);
+    return utils.applyFromCharCode(utf16buf);
+};
+
+
+// That's all for the pako functions.
+
+
+/**
+ * Transform a javascript string into an array (typed if possible) of bytes,
+ * UTF-8 encoded.
+ * @param {String} str the string to encode
+ * @return {Array|Uint8Array|Buffer} the UTF-8 encoded string.
+ */
+exports.utf8encode = function utf8encode(str) {
+    if (support.nodebuffer) {
+        return nodejsUtils.newBufferFrom(str, "utf-8");
+    }
+
+    return string2buf(str);
+};
+
+
+/**
+ * Transform a bytes array (or a representation) representing an UTF-8 encoded
+ * string into a javascript string.
+ * @param {Array|Uint8Array|Buffer} buf the data de decode
+ * @return {String} the decoded string.
+ */
+exports.utf8decode = function utf8decode(buf) {
+    if (support.nodebuffer) {
+        return utils.transformTo("nodebuffer", buf).toString("utf-8");
+    }
+
+    buf = utils.transformTo(support.uint8array ? "uint8array" : "array", buf);
+
+    return buf2string(buf);
+};
+
+/**
+ * A worker to decode utf8 encoded binary chunks into string chunks.
+ * @constructor
+ */
+function Utf8DecodeWorker() {
+    GenericWorker.call(this, "utf-8 decode");
+    // the last bytes if a chunk didn't end with a complete codepoint.
+    this.leftOver = null;
+}
+utils.inherits(Utf8DecodeWorker, GenericWorker);
+
+/**
+ * @see GenericWorker.processChunk
+ */
+Utf8DecodeWorker.prototype.processChunk = function (chunk) {
+
+    var data = utils.transformTo(support.uint8array ? "uint8array" : "array", chunk.data);
+
+    // 1st step, re-use what's left of the previous chunk
+    if (this.leftOver && this.leftOver.length) {
+        if(support.uint8array) {
+            var previousData = data;
+            data = new Uint8Array(previousData.length + this.leftOver.length);
+            data.set(this.leftOver, 0);
+            data.set(previousData, this.leftOver.length);
+        } else {
+            data = this.leftOver.concat(data);
+        }
+        this.leftOver = null;
+    }
+
+    var nextBoundary = utf8border(data);
+    var usableData = data;
+    if (nextBoundary !== data.length) {
+        if (support.uint8array) {
+            usableData = data.subarray(0, nextBoundary);
+            this.leftOver = data.subarray(nextBoundary, data.length);
+        } else {
+            usableData = data.slice(0, nextBoundary);
+            this.leftOver = data.slice(nextBoundary, data.length);
+        }
+    }
+
+    this.push({
+        data : exports.utf8decode(usableData),
+        meta : chunk.meta
+    });
+};
+
+/**
+ * @see GenericWorker.flush
+ */
+Utf8DecodeWorker.prototype.flush = function () {
+    if(this.leftOver && this.leftOver.length) {
+        this.push({
+            data : exports.utf8decode(this.leftOver),
+            meta : {}
+        });
+        this.leftOver = null;
+    }
+};
+exports.Utf8DecodeWorker = Utf8DecodeWorker;
+
+/**
+ * A worker to endcode string chunks into utf8 encoded binary chunks.
+ * @constructor
+ */
+function Utf8EncodeWorker() {
+    GenericWorker.call(this, "utf-8 encode");
+}
+utils.inherits(Utf8EncodeWorker, GenericWorker);
+
+/**
+ * @see GenericWorker.processChunk
+ */
+Utf8EncodeWorker.prototype.processChunk = function (chunk) {
+    this.push({
+        data : exports.utf8encode(chunk.data),
+        meta : chunk.meta
+    });
+};
+exports.Utf8EncodeWorker = Utf8EncodeWorker;
+
+},{"./nodejsUtils":14,"./stream/GenericWorker":28,"./support":30,"./utils":32}],32:[function(require,module,exports){
+'use strict';
+
+var support = require('./support');
+var base64 = require('./base64');
+var nodejsUtils = require('./nodejsUtils');
+var setImmediate = require('core-js/library/fn/set-immediate');
+var external = require("./external");
+
+
+/**
+ * Convert a string that pass as a "binary string": it should represent a byte
+ * array but may have > 255 char codes. Be sure to take only the first byte
+ * and returns the byte array.
+ * @param {String} str the string to transform.
+ * @return {Array|Uint8Array} the string in a binary format.
+ */
+function string2binary(str) {
+    var result = null;
+    if (support.uint8array) {
+      result = new Uint8Array(str.length);
+    } else {
+      result = new Array(str.length);
+    }
+    return stringToArrayLike(str, result);
+}
+
+/**
+ * Create a new blob with the given content and the given type.
+ * @param {String|ArrayBuffer} part the content to put in the blob. DO NOT use
+ * an Uint8Array because the stock browser of android 4 won't accept it (it
+ * will be silently converted to a string, "[object Uint8Array]").
+ *
+ * Use only ONE part to build the blob to avoid a memory leak in IE11 / Edge:
+ * when a large amount of Array is used to create the Blob, the amount of
+ * memory consumed is nearly 100 times the original data amount.
+ *
+ * @param {String} type the mime type of the blob.
+ * @return {Blob} the created blob.
+ */
+exports.newBlob = function(part, type) {
+    exports.checkSupport("blob");
+
+    try {
+        // Blob constructor
+        return new Blob([part], {
+            type: type
+        });
+    }
+    catch (e) {
+
+        try {
+            // deprecated, browser only, old way
+            var Builder = self.BlobBuilder || self.WebKitBlobBuilder || self.MozBlobBuilder || self.MSBlobBuilder;
+            var builder = new Builder();
+            builder.append(part);
+            return builder.getBlob(type);
+        }
+        catch (e) {
+
+            // well, fuck ?!
+            throw new Error("Bug : can't construct the Blob.");
+        }
+    }
+
+
+};
+/**
+ * The identity function.
+ * @param {Object} input the input.
+ * @return {Object} the same input.
+ */
+function identity(input) {
+    return input;
+}
+
+/**
+ * Fill in an array with a string.
+ * @param {String} str the string to use.
+ * @param {Array|ArrayBuffer|Uint8Array|Buffer} array the array to fill in (will be mutated).
+ * @return {Array|ArrayBuffer|Uint8Array|Buffer} the updated array.
+ */
+function stringToArrayLike(str, array) {
+    for (var i = 0; i < str.length; ++i) {
+        array[i] = str.charCodeAt(i) & 0xFF;
+    }
+    return array;
+}
+
+/**
+ * An helper for the function arrayLikeToString.
+ * This contains static informations and functions that
+ * can be optimized by the browser JIT compiler.
+ */
+var arrayToStringHelper = {
+    /**
+     * Transform an array of int into a string, chunk by chunk.
+     * See the performances notes on arrayLikeToString.
+     * @param {Array|ArrayBuffer|Uint8Array|Buffer} array the array to transform.
+     * @param {String} type the type of the array.
+     * @param {Integer} chunk the chunk size.
+     * @return {String} the resulting string.
+     * @throws Error if the chunk is too big for the stack.
+     */
+    stringifyByChunk: function(array, type, chunk) {
+        var result = [], k = 0, len = array.length;
+        // shortcut
+        if (len <= chunk) {
+            return String.fromCharCode.apply(null, array);
+        }
+        while (k < len) {
+            if (type === "array" || type === "nodebuffer") {
+                result.push(String.fromCharCode.apply(null, array.slice(k, Math.min(k + chunk, len))));
+            }
+            else {
+                result.push(String.fromCharCode.apply(null, array.subarray(k, Math.min(k + chunk, len))));
+            }
+            k += chunk;
+        }
+        return result.join("");
+    },
+    /**
+     * Call String.fromCharCode on every item in the array.
+     * This is the naive implementation, which generate A LOT of intermediate string.
+     * This should be used when everything else fail.
+     * @param {Array|ArrayBuffer|Uint8Array|Buffer} array the array to transform.
+     * @return {String} the result.
+     */
+    stringifyByChar: function(array){
+        var resultStr = "";
+        for(var i = 0; i < array.length; i++) {
+            resultStr += String.fromCharCode(array[i]);
+        }
+        return resultStr;
+    },
+    applyCanBeUsed : {
+        /**
+         * true if the browser accepts to use String.fromCharCode on Uint8Array
+         */
+        uint8array : (function () {
+            try {
+                return support.uint8array && String.fromCharCode.apply(null, new Uint8Array(1)).length === 1;
+            } catch (e) {
+                return false;
+            }
+        })(),
+        /**
+         * true if the browser accepts to use String.fromCharCode on nodejs Buffer.
+         */
+        nodebuffer : (function () {
+            try {
+                return support.nodebuffer && String.fromCharCode.apply(null, nodejsUtils.allocBuffer(1)).length === 1;
+            } catch (e) {
+                return false;
+            }
+        })()
+    }
+};
+
+/**
+ * Transform an array-like object to a string.
+ * @param {Array|ArrayBuffer|Uint8Array|Buffer} array the array to transform.
+ * @return {String} the result.
+ */
+function arrayLikeToString(array) {
+    // Performances notes :
+    // --------------------
+    // String.fromCharCode.apply(null, array) is the fastest, see
+    // see http://jsperf.com/converting-a-uint8array-to-a-string/2
+    // but the stack is limited (and we can get huge arrays !).
+    //
+    // result += String.fromCharCode(array[i]); generate too many strings !
+    //
+    // This code is inspired by http://jsperf.com/arraybuffer-to-string-apply-performance/2
+    // TODO : we now have workers that split the work. Do we still need that ?
+    var chunk = 65536,
+        type = exports.getTypeOf(array),
+        canUseApply = true;
+    if (type === "uint8array") {
+        canUseApply = arrayToStringHelper.applyCanBeUsed.uint8array;
+    } else if (type === "nodebuffer") {
+        canUseApply = arrayToStringHelper.applyCanBeUsed.nodebuffer;
+    }
+
+    if (canUseApply) {
+        while (chunk > 1) {
+            try {
+                return arrayToStringHelper.stringifyByChunk(array, type, chunk);
+            } catch (e) {
+                chunk = Math.floor(chunk / 2);
+            }
+        }
+    }
+
+    // no apply or chunk error : slow and painful algorithm
+    // default browser on android 4.*
+    return arrayToStringHelper.stringifyByChar(array);
+}
+
+exports.applyFromCharCode = arrayLikeToString;
+
+
+/**
+ * Copy the data from an array-like to an other array-like.
+ * @param {Array|ArrayBuffer|Uint8Array|Buffer} arrayFrom the origin array.
+ * @param {Array|ArrayBuffer|Uint8Array|Buffer} arrayTo the destination array which will be mutated.
+ * @return {Array|ArrayBuffer|Uint8Array|Buffer} the updated destination array.
+ */
+function arrayLikeToArrayLike(arrayFrom, arrayTo) {
+    for (var i = 0; i < arrayFrom.length; i++) {
+        arrayTo[i] = arrayFrom[i];
+    }
+    return arrayTo;
+}
+
+// a matrix containing functions to transform everything into everything.
+var transform = {};
+
+// string to ?
+transform["string"] = {
+    "string": identity,
+    "array": function(input) {
+        return stringToArrayLike(input, new Array(input.length));
+    },
+    "arraybuffer": function(input) {
+        return transform["string"]["uint8array"](input).buffer;
+    },
+    "uint8array": function(input) {
+        return stringToArrayLike(input, new Uint8Array(input.length));
+    },
+    "nodebuffer": function(input) {
+        return stringToArrayLike(input, nodejsUtils.allocBuffer(input.length));
+    }
+};
+
+// array to ?
+transform["array"] = {
+    "string": arrayLikeToString,
+    "array": identity,
+    "arraybuffer": function(input) {
+        return (new Uint8Array(input)).buffer;
+    },
+    "uint8array": function(input) {
+        return new Uint8Array(input);
+    },
+    "nodebuffer": function(input) {
+        return nodejsUtils.newBufferFrom(input);
+    }
+};
+
+// arraybuffer to ?
+transform["arraybuffer"] = {
+    "string": function(input) {
+        return arrayLikeToString(new Uint8Array(input));
+    },
+    "array": function(input) {
+        return arrayLikeToArrayLike(new Uint8Array(input), new Array(input.byteLength));
+    },
+    "arraybuffer": identity,
+    "uint8array": function(input) {
+        return new Uint8Array(input);
+    },
+    "nodebuffer": function(input) {
+        return nodejsUtils.newBufferFrom(new Uint8Array(input));
+    }
+};
+
+// uint8array to ?
+transform["uint8array"] = {
+    "string": arrayLikeToString,
+    "array": function(input) {
+        return arrayLikeToArrayLike(input, new Array(input.length));
+    },
+    "arraybuffer": function(input) {
+        return input.buffer;
+    },
+    "uint8array": identity,
+    "nodebuffer": function(input) {
+        return nodejsUtils.newBufferFrom(input);
+    }
+};
+
+// nodebuffer to ?
+transform["nodebuffer"] = {
+    "string": arrayLikeToString,
+    "array": function(input) {
+        return arrayLikeToArrayLike(input, new Array(input.length));
+    },
+    "arraybuffer": function(input) {
+        return transform["nodebuffer"]["uint8array"](input).buffer;
+    },
+    "uint8array": function(input) {
+        return arrayLikeToArrayLike(input, new Uint8Array(input.length));
+    },
+    "nodebuffer": identity
+};
+
+/**
+ * Transform an input into any type.
+ * The supported output type are : string, array, uint8array, arraybuffer, nodebuffer.
+ * If no output type is specified, the unmodified input will be returned.
+ * @param {String} outputType the output type.
+ * @param {String|Array|ArrayBuffer|Uint8Array|Buffer} input the input to convert.
+ * @throws {Error} an Error if the browser doesn't support the requested output type.
+ */
+exports.transformTo = function(outputType, input) {
+    if (!input) {
+        // undefined, null, etc
+        // an empty string won't harm.
+        input = "";
+    }
+    if (!outputType) {
+        return input;
+    }
+    exports.checkSupport(outputType);
+    var inputType = exports.getTypeOf(input);
+    var result = transform[inputType][outputType](input);
+    return result;
+};
+
+/**
+ * Return the type of the input.
+ * The type will be in a format valid for JSZip.utils.transformTo : string, array, uint8array, arraybuffer.
+ * @param {Object} input the input to identify.
+ * @return {String} the (lowercase) type of the input.
+ */
+exports.getTypeOf = function(input) {
+    if (typeof input === "string") {
+        return "string";
+    }
+    if (Object.prototype.toString.call(input) === "[object Array]") {
+        return "array";
+    }
+    if (support.nodebuffer && nodejsUtils.isBuffer(input)) {
+        return "nodebuffer";
+    }
+    if (support.uint8array && input instanceof Uint8Array) {
+        return "uint8array";
+    }
+    if (support.arraybuffer && input instanceof ArrayBuffer) {
+        return "arraybuffer";
+    }
+};
+
+/**
+ * Throw an exception if the type is not supported.
+ * @param {String} type the type to check.
+ * @throws {Error} an Error if the browser doesn't support the requested type.
+ */
+exports.checkSupport = function(type) {
+    var supported = support[type.toLowerCase()];
+    if (!supported) {
+        throw new Error(type + " is not supported by this platform");
+    }
+};
+
+exports.MAX_VALUE_16BITS = 65535;
+exports.MAX_VALUE_32BITS = -1; // well, "\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF" is parsed as -1
+
+/**
+ * Prettify a string read as binary.
+ * @param {string} str the string to prettify.
+ * @return {string} a pretty string.
+ */
+exports.pretty = function(str) {
+    var res = '',
+        code, i;
+    for (i = 0; i < (str || "").length; i++) {
+        code = str.charCodeAt(i);
+        res += '\\x' + (code < 16 ? "0" : "") + code.toString(16).toUpperCase();
+    }
+    return res;
+};
+
+/**
+ * Defer the call of a function.
+ * @param {Function} callback the function to call asynchronously.
+ * @param {Array} args the arguments to give to the callback.
+ */
+exports.delay = function(callback, args, self) {
+    setImmediate(function () {
+        callback.apply(self || null, args || []);
+    });
+};
+
+/**
+ * Extends a prototype with an other, without calling a constructor with
+ * side effects. Inspired by nodejs' `utils.inherits`
+ * @param {Function} ctor the constructor to augment
+ * @param {Function} superCtor the parent constructor to use
+ */
+exports.inherits = function (ctor, superCtor) {
+    var Obj = function() {};
+    Obj.prototype = superCtor.prototype;
+    ctor.prototype = new Obj();
+};
+
+/**
+ * Merge the objects passed as parameters into a new one.
+ * @private
+ * @param {...Object} var_args All objects to merge.
+ * @return {Object} a new object with the data of the others.
+ */
+exports.extend = function() {
+    var result = {}, i, attr;
+    for (i = 0; i < arguments.length; i++) { // arguments is not enumerable in some browsers
+        for (attr in arguments[i]) {
+            if (arguments[i].hasOwnProperty(attr) && typeof result[attr] === "undefined") {
+                result[attr] = arguments[i][attr];
+            }
+        }
+    }
+    return result;
+};
+
+/**
+ * Transform arbitrary content into a Promise.
+ * @param {String} name a name for the content being processed.
+ * @param {Object} inputData the content to process.
+ * @param {Boolean} isBinary true if the content is not an unicode string
+ * @param {Boolean} isOptimizedBinaryString true if the string content only has one byte per character.
+ * @param {Boolean} isBase64 true if the string content is encoded with base64.
+ * @return {Promise} a promise in a format usable by JSZip.
+ */
+exports.prepareContent = function(name, inputData, isBinary, isOptimizedBinaryString, isBase64) {
+
+    // if inputData is already a promise, this flatten it.
+    var promise = external.Promise.resolve(inputData).then(function(data) {
+        
+        
+        var isBlob = support.blob && (data instanceof Blob || ['[object File]', '[object Blob]'].indexOf(Object.prototype.toString.call(data)) !== -1);
+
+        if (isBlob && typeof FileReader !== "undefined") {
+            return new external.Promise(function (resolve, reject) {
+                var reader = new FileReader();
+
+                reader.onload = function(e) {
+                    resolve(e.target.result);
+                };
+                reader.onerror = function(e) {
+                    reject(e.target.error);
+                };
+                reader.readAsArrayBuffer(data);
+            });
+        } else {
+            return data;
+        }
+    });
+
+    return promise.then(function(data) {
+        var dataType = exports.getTypeOf(data);
+
+        if (!dataType) {
+            return external.Promise.reject(
+                new Error("Can't read the data of '" + name + "'. Is it " +
+                          "in a supported JavaScript type (String, Blob, ArrayBuffer, etc) ?")
+            );
+        }
+        // special case : it's way easier to work with Uint8Array than with ArrayBuffer
+        if (dataType === "arraybuffer") {
+            data = exports.transformTo("uint8array", data);
+        } else if (dataType === "string") {
+            if (isBase64) {
+                data = base64.decode(data);
+            }
+            else if (isBinary) {
+                // optimizedBinaryString === true means that the file has already been filtered with a 0xFF mask
+                if (isOptimizedBinaryString !== true) {
+                    // this is a string, not in a base64 format.
+                    // Be sure that this is a correct "binary string"
+                    data = string2binary(data);
+                }
+            }
+        }
+        return data;
+    });
+};
+
+},{"./base64":1,"./external":6,"./nodejsUtils":14,"./support":30,"core-js/library/fn/set-immediate":36}],33:[function(require,module,exports){
+'use strict';
+var readerFor = require('./reader/readerFor');
+var utils = require('./utils');
+var sig = require('./signature');
+var ZipEntry = require('./zipEntry');
+var utf8 = require('./utf8');
+var support = require('./support');
+//  class ZipEntries {{{
+/**
+ * All the entries in the zip file.
+ * @constructor
+ * @param {Object} loadOptions Options for loading the stream.
+ */
+function ZipEntries(loadOptions) {
+    this.files = [];
+    this.loadOptions = loadOptions;
+}
+ZipEntries.prototype = {
+    /**
+     * Check that the reader is on the specified signature.
+     * @param {string} expectedSignature the expected signature.
+     * @throws {Error} if it is an other signature.
+     */
+    checkSignature: function(expectedSignature) {
+        if (!this.reader.readAndCheckSignature(expectedSignature)) {
+            this.reader.index -= 4;
+            var signature = this.reader.readString(4);
+            throw new Error("Corrupted zip or bug: unexpected signature " + "(" + utils.pretty(signature) + ", expected " + utils.pretty(expectedSignature) + ")");
+        }
+    },
+    /**
+     * Check if the given signature is at the given index.
+     * @param {number} askedIndex the index to check.
+     * @param {string} expectedSignature the signature to expect.
+     * @return {boolean} true if the signature is here, false otherwise.
+     */
+    isSignature: function(askedIndex, expectedSignature) {
+        var currentIndex = this.reader.index;
+        this.reader.setIndex(askedIndex);
+        var signature = this.reader.readString(4);
+        var result = signature === expectedSignature;
+        this.reader.setIndex(currentIndex);
+        return result;
+    },
+    /**
+     * Read the end of the central directory.
+     */
+    readBlockEndOfCentral: function() {
+        this.diskNumber = this.reader.readInt(2);
+        this.diskWithCentralDirStart = this.reader.readInt(2);
+        this.centralDirRecordsOnThisDisk = this.reader.readInt(2);
+        this.centralDirRecords = this.reader.readInt(2);
+        this.centralDirSize = this.reader.readInt(4);
+        this.centralDirOffset = this.reader.readInt(4);
+
+        this.zipCommentLength = this.reader.readInt(2);
+        // warning : the encoding depends of the system locale
+        // On a linux machine with LANG=en_US.utf8, this field is utf8 encoded.
+        // On a windows machine, this field is encoded with the localized windows code page.
+        var zipComment = this.reader.readData(this.zipCommentLength);
+        var decodeParamType = support.uint8array ? "uint8array" : "array";
+        // To get consistent behavior with the generation part, we will assume that
+        // this is utf8 encoded unless specified otherwise.
+        var decodeContent = utils.transformTo(decodeParamType, zipComment);
+        this.zipComment = this.loadOptions.decodeFileName(decodeContent);
+    },
+    /**
+     * Read the end of the Zip 64 central directory.
+     * Not merged with the method readEndOfCentral :
+     * The end of central can coexist with its Zip64 brother,
+     * I don't want to read the wrong number of bytes !
+     */
+    readBlockZip64EndOfCentral: function() {
+        this.zip64EndOfCentralSize = this.reader.readInt(8);
+        this.reader.skip(4);
+        // this.versionMadeBy = this.reader.readString(2);
+        // this.versionNeeded = this.reader.readInt(2);
+        this.diskNumber = this.reader.readInt(4);
+        this.diskWithCentralDirStart = this.reader.readInt(4);
+        this.centralDirRecordsOnThisDisk = this.reader.readInt(8);
+        this.centralDirRecords = this.reader.readInt(8);
+        this.centralDirSize = this.reader.readInt(8);
+        this.centralDirOffset = this.reader.readInt(8);
+
+        this.zip64ExtensibleData = {};
+        var extraDataSize = this.zip64EndOfCentralSize - 44,
+            index = 0,
+            extraFieldId,
+            extraFieldLength,
+            extraFieldValue;
+        while (index < extraDataSize) {
+            extraFieldId = this.reader.readInt(2);
+            extraFieldLength = this.reader.readInt(4);
+            extraFieldValue = this.reader.readData(extraFieldLength);
+            this.zip64ExtensibleData[extraFieldId] = {
+                id: extraFieldId,
+                length: extraFieldLength,
+                value: extraFieldValue
+            };
+        }
+    },
+    /**
+     * Read the end of the Zip 64 central directory locator.
+     */
+    readBlockZip64EndOfCentralLocator: function() {
+        this.diskWithZip64CentralDirStart = this.reader.readInt(4);
+        this.relativeOffsetEndOfZip64CentralDir = this.reader.readInt(8);
+        this.disksCount = this.reader.readInt(4);
+        if (this.disksCount > 1) {
+            throw new Error("Multi-volumes zip are not supported");
+        }
+    },
+    /**
+     * Read the local files, based on the offset read in the central part.
+     */
+    readLocalFiles: function() {
+        var i, file;
+        for (i = 0; i < this.files.length; i++) {
+            file = this.files[i];
+            this.reader.setIndex(file.localHeaderOffset);
+            this.checkSignature(sig.LOCAL_FILE_HEADER);
+            file.readLocalPart(this.reader);
+            file.handleUTF8();
+            file.processAttributes();
+        }
+    },
+    /**
+     * Read the central directory.
+     */
+    readCentralDir: function() {
+        var file;
+
+        this.reader.setIndex(this.centralDirOffset);
+        while (this.reader.readAndCheckSignature(sig.CENTRAL_FILE_HEADER)) {
+            file = new ZipEntry({
+                zip64: this.zip64
+            }, this.loadOptions);
+            file.readCentralPart(this.reader);
+            this.files.push(file);
+        }
+
+        if (this.centralDirRecords !== this.files.length) {
+            if (this.centralDirRecords !== 0 && this.files.length === 0) {
+                // We expected some records but couldn't find ANY.
+                // This is really suspicious, as if something went wrong.
+                throw new Error("Corrupted zip or bug: expected " + this.centralDirRecords + " records in central dir, got " + this.files.length);
+            } else {
+                // We found some records but not all.
+                // Something is wrong but we got something for the user: no error here.
+                // console.warn("expected", this.centralDirRecords, "records in central dir, got", this.files.length);
+            }
+        }
+    },
+    /**
+     * Read the end of central directory.
+     */
+    readEndOfCentral: function() {
+        var offset = this.reader.lastIndexOfSignature(sig.CENTRAL_DIRECTORY_END);
+        if (offset < 0) {
+            // Check if the content is a truncated zip or complete garbage.
+            // A "LOCAL_FILE_HEADER" is not required at the beginning (auto
+            // extractible zip for example) but it can give a good hint.
+            // If an ajax request was used without responseType, we will also
+            // get unreadable data.
+            var isGarbage = !this.isSignature(0, sig.LOCAL_FILE_HEADER);
+
+            if (isGarbage) {
+                throw new Error("Can't find end of central directory : is this a zip file ? " +
+                                "If it is, see https://stuk.github.io/jszip/documentation/howto/read_zip.html");
+            } else {
+                throw new Error("Corrupted zip: can't find end of central directory");
+            }
+
+        }
+        this.reader.setIndex(offset);
+        var endOfCentralDirOffset = offset;
+        this.checkSignature(sig.CENTRAL_DIRECTORY_END);
+        this.readBlockEndOfCentral();
+
+
+        /* extract from the zip spec :
+            4)  If one of the fields in the end of central directory
+                record is too small to hold required data, the field
+                should be set to -1 (0xFFFF or 0xFFFFFFFF) and the
+                ZIP64 format record should be created.
+            5)  The end of central directory record and the
+                Zip64 end of central directory locator record must
+                reside on the same disk when splitting or spanning
+                an archive.
+         */
+        if (this.diskNumber === utils.MAX_VALUE_16BITS || this.diskWithCentralDirStart === utils.MAX_VALUE_16BITS || this.centralDirRecordsOnThisDisk === utils.MAX_VALUE_16BITS || this.centralDirRecords === utils.MAX_VALUE_16BITS || this.centralDirSize === utils.MAX_VALUE_32BITS || this.centralDirOffset === utils.MAX_VALUE_32BITS) {
+            this.zip64 = true;
+
+            /*
+            Warning : the zip64 extension is supported, but ONLY if the 64bits integer read from
+            the zip file can fit into a 32bits integer. This cannot be solved : JavaScript represents
+            all numbers as 64-bit double precision IEEE 754 floating point numbers.
+            So, we have 53bits for integers and bitwise operations treat everything as 32bits.
+            see https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Operators/Bitwise_Operators
+            and http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-262.pdf section 8.5
+            */
+
+            // should look for a zip64 EOCD locator
+            offset = this.reader.lastIndexOfSignature(sig.ZIP64_CENTRAL_DIRECTORY_LOCATOR);
+            if (offset < 0) {
+                throw new Error("Corrupted zip: can't find the ZIP64 end of central directory locator");
+            }
+            this.reader.setIndex(offset);
+            this.checkSignature(sig.ZIP64_CENTRAL_DIRECTORY_LOCATOR);
+            this.readBlockZip64EndOfCentralLocator();
+
+            // now the zip64 EOCD record
+            if (!this.isSignature(this.relativeOffsetEndOfZip64CentralDir, sig.ZIP64_CENTRAL_DIRECTORY_END)) {
+                // console.warn("ZIP64 end of central directory not where expected.");
+                this.relativeOffsetEndOfZip64CentralDir = this.reader.lastIndexOfSignature(sig.ZIP64_CENTRAL_DIRECTORY_END);
+                if (this.relativeOffsetEndOfZip64CentralDir < 0) {
+                    throw new Error("Corrupted zip: can't find the ZIP64 end of central directory");
+                }
+            }
+            this.reader.setIndex(this.relativeOffsetEndOfZip64CentralDir);
+            this.checkSignature(sig.ZIP64_CENTRAL_DIRECTORY_END);
+            this.readBlockZip64EndOfCentral();
+        }
+
+        var expectedEndOfCentralDirOffset = this.centralDirOffset + this.centralDirSize;
+        if (this.zip64) {
+            expectedEndOfCentralDirOffset += 20; // end of central dir 64 locator
+            expectedEndOfCentralDirOffset += 12 /* should not include the leading 12 bytes */ + this.zip64EndOfCentralSize;
+        }
+
+        var extraBytes = endOfCentralDirOffset - expectedEndOfCentralDirOffset;
+
+        if (extraBytes > 0) {
+            // console.warn(extraBytes, "extra bytes at beginning or within zipfile");
+            if (this.isSignature(endOfCentralDirOffset, sig.CENTRAL_FILE_HEADER)) {
+                // The offsets seem wrong, but we have something at the specified offset.
+                // So… we keep it.
+            } else {
+                // the offset is wrong, update the "zero" of the reader
+                // this happens if data has been prepended (crx files for example)
+                this.reader.zero = extraBytes;
+            }
+        } else if (extraBytes < 0) {
+            throw new Error("Corrupted zip: missing " + Math.abs(extraBytes) + " bytes.");
+        }
+    },
+    prepareReader: function(data) {
+        this.reader = readerFor(data);
+    },
+    /**
+     * Read a zip file and create ZipEntries.
+     * @param {String|ArrayBuffer|Uint8Array|Buffer} data the binary string representing a zip file.
+     */
+    load: function(data) {
+        this.prepareReader(data);
+        this.readEndOfCentral();
+        this.readCentralDir();
+        this.readLocalFiles();
+    }
+};
+// }}} end of ZipEntries
+module.exports = ZipEntries;
+
+},{"./reader/readerFor":22,"./signature":23,"./support":30,"./utf8":31,"./utils":32,"./zipEntry":34}],34:[function(require,module,exports){
+'use strict';
+var readerFor = require('./reader/readerFor');
+var utils = require('./utils');
+var CompressedObject = require('./compressedObject');
+var crc32fn = require('./crc32');
+var utf8 = require('./utf8');
+var compressions = require('./compressions');
+var support = require('./support');
+
+var MADE_BY_DOS = 0x00;
+var MADE_BY_UNIX = 0x03;
+
+/**
+ * Find a compression registered in JSZip.
+ * @param {string} compressionMethod the method magic to find.
+ * @return {Object|null} the JSZip compression object, null if none found.
+ */
+var findCompression = function(compressionMethod) {
+    for (var method in compressions) {
+        if (!compressions.hasOwnProperty(method)) {
+            continue;
+        }
+        if (compressions[method].magic === compressionMethod) {
+            return compressions[method];
+        }
+    }
+    return null;
+};
+
+// class ZipEntry {{{
+/**
+ * An entry in the zip file.
+ * @constructor
+ * @param {Object} options Options of the current file.
+ * @param {Object} loadOptions Options for loading the stream.
+ */
+function ZipEntry(options, loadOptions) {
+    this.options = options;
+    this.loadOptions = loadOptions;
+}
+ZipEntry.prototype = {
+    /**
+     * say if the file is encrypted.
+     * @return {boolean} true if the file is encrypted, false otherwise.
+     */
+    isEncrypted: function() {
+        // bit 1 is set
+        return (this.bitFlag & 0x0001) === 0x0001;
+    },
+    /**
+     * say if the file has utf-8 filename/comment.
+     * @return {boolean} true if the filename/comment is in utf-8, false otherwise.
+     */
+    useUTF8: function() {
+        // bit 11 is set
+        return (this.bitFlag & 0x0800) === 0x0800;
+    },
+    /**
+     * Read the local part of a zip file and add the info in this object.
+     * @param {DataReader} reader the reader to use.
+     */
+    readLocalPart: function(reader) {
+        var compression, localExtraFieldsLength;
+
+        // we already know everything from the central dir !
+        // If the central dir data are false, we are doomed.
+        // On the bright side, the local part is scary  : zip64, data descriptors, both, etc.
+        // The less data we get here, the more reliable this should be.
+        // Let's skip the whole header and dash to the data !
+        reader.skip(22);
+        // in some zip created on windows, the filename stored in the central dir contains \ instead of /.
+        // Strangely, the filename here is OK.
+        // I would love to treat these zip files as corrupted (see http://www.info-zip.org/FAQ.html#backslashes
+        // or APPNOTE#4.4.17.1, "All slashes MUST be forward slashes '/'") but there are a lot of bad zip generators...
+        // Search "unzip mismatching "local" filename continuing with "central" filename version" on
+        // the internet.
+        //
+        // I think I see the logic here : the central directory is used to display
+        // content and the local directory is used to extract the files. Mixing / and \
+        // may be used to display \ to windows users and use / when extracting the files.
+        // Unfortunately, this lead also to some issues : http://seclists.org/fulldisclosure/2009/Sep/394
+        this.fileNameLength = reader.readInt(2);
+        localExtraFieldsLength = reader.readInt(2); // can't be sure this will be the same as the central dir
+        // the fileName is stored as binary data, the handleUTF8 method will take care of the encoding.
+        this.fileName = reader.readData(this.fileNameLength);
+        reader.skip(localExtraFieldsLength);
+
+        if (this.compressedSize === -1 || this.uncompressedSize === -1) {
+            throw new Error("Bug or corrupted zip : didn't get enough informations from the central directory " + "(compressedSize === -1 || uncompressedSize === -1)");
+        }
+
+        compression = findCompression(this.compressionMethod);
+        if (compression === null) { // no compression found
+            throw new Error("Corrupted zip : compression " + utils.pretty(this.compressionMethod) + " unknown (inner file : " + utils.transformTo("string", this.fileName) + ")");
+        }
+        this.decompressed = new CompressedObject(this.compressedSize, this.uncompressedSize, this.crc32, compression, reader.readData(this.compressedSize));
+    },
+
+    /**
+     * Read the central part of a zip file and add the info in this object.
+     * @param {DataReader} reader the reader to use.
+     */
+    readCentralPart: function(reader) {
+        this.versionMadeBy = reader.readInt(2);
+        reader.skip(2);
+        // this.versionNeeded = reader.readInt(2);
+        this.bitFlag = reader.readInt(2);
+        this.compressionMethod = reader.readString(2);
+        this.date = reader.readDate();
+        this.crc32 = reader.readInt(4);
+        this.compressedSize = reader.readInt(4);
+        this.uncompressedSize = reader.readInt(4);
+        var fileNameLength = reader.readInt(2);
+        this.extraFieldsLength = reader.readInt(2);
+        this.fileCommentLength = reader.readInt(2);
+        this.diskNumberStart = reader.readInt(2);
+        this.internalFileAttributes = reader.readInt(2);
+        this.externalFileAttributes = reader.readInt(4);
+        this.localHeaderOffset = reader.readInt(4);
+
+        if (this.isEncrypted()) {
+            throw new Error("Encrypted zip are not supported");
+        }
+
+        // will be read in the local part, see the comments there
+        reader.skip(fileNameLength);
+        this.readExtraFields(reader);
+        this.parseZIP64ExtraField(reader);
+        this.fileComment = reader.readData(this.fileCommentLength);
+    },
+
+    /**
+     * Parse the external file attributes and get the unix/dos permissions.
+     */
+    processAttributes: function () {
+        this.unixPermissions = null;
+        this.dosPermissions = null;
+        var madeBy = this.versionMadeBy >> 8;
+
+        // Check if we have the DOS directory flag set.
+        // We look for it in the DOS and UNIX permissions
+        // but some unknown platform could set it as a compatibility flag.
+        this.dir = this.externalFileAttributes & 0x0010 ? true : false;
+
+        if(madeBy === MADE_BY_DOS) {
+            // first 6 bits (0 to 5)
+            this.dosPermissions = this.externalFileAttributes & 0x3F;
+        }
+
+        if(madeBy === MADE_BY_UNIX) {
+            this.unixPermissions = (this.externalFileAttributes >> 16) & 0xFFFF;
+            // the octal permissions are in (this.unixPermissions & 0x01FF).toString(8);
+        }
+
+        // fail safe : if the name ends with a / it probably means a folder
+        if (!this.dir && this.fileNameStr.slice(-1) === '/') {
+            this.dir = true;
+        }
+    },
+
+    /**
+     * Parse the ZIP64 extra field and merge the info in the current ZipEntry.
+     * @param {DataReader} reader the reader to use.
+     */
+    parseZIP64ExtraField: function(reader) {
+
+        if (!this.extraFields[0x0001]) {
+            return;
+        }
+
+        // should be something, preparing the extra reader
+        var extraReader = readerFor(this.extraFields[0x0001].value);
+
+        // I really hope that these 64bits integer can fit in 32 bits integer, because js
+        // won't let us have more.
+        if (this.uncompressedSize === utils.MAX_VALUE_32BITS) {
+            this.uncompressedSize = extraReader.readInt(8);
+        }
+        if (this.compressedSize === utils.MAX_VALUE_32BITS) {
+            this.compressedSize = extraReader.readInt(8);
+        }
+        if (this.localHeaderOffset === utils.MAX_VALUE_32BITS) {
+            this.localHeaderOffset = extraReader.readInt(8);
+        }
+        if (this.diskNumberStart === utils.MAX_VALUE_32BITS) {
+            this.diskNumberStart = extraReader.readInt(4);
+        }
+    },
+    /**
+     * Read the central part of a zip file and add the info in this object.
+     * @param {DataReader} reader the reader to use.
+     */
+    readExtraFields: function(reader) {
+        var end = reader.index + this.extraFieldsLength,
+            extraFieldId,
+            extraFieldLength,
+            extraFieldValue;
+
+        if (!this.extraFields) {
+            this.extraFields = {};
+        }
+
+        while (reader.index < end) {
+            extraFieldId = reader.readInt(2);
+            extraFieldLength = reader.readInt(2);
+            extraFieldValue = reader.readData(extraFieldLength);
+
+            this.extraFields[extraFieldId] = {
+                id: extraFieldId,
+                length: extraFieldLength,
+                value: extraFieldValue
+            };
+        }
+    },
+    /**
+     * Apply an UTF8 transformation if needed.
+     */
+    handleUTF8: function() {
+        var decodeParamType = support.uint8array ? "uint8array" : "array";
+        if (this.useUTF8()) {
+            this.fileNameStr = utf8.utf8decode(this.fileName);
+            this.fileCommentStr = utf8.utf8decode(this.fileComment);
+        } else {
+            var upath = this.findExtraFieldUnicodePath();
+            if (upath !== null) {
+                this.fileNameStr = upath;
+            } else {
+                // ASCII text or unsupported code page
+                var fileNameByteArray =  utils.transformTo(decodeParamType, this.fileName);
+                this.fileNameStr = this.loadOptions.decodeFileName(fileNameByteArray);
+            }
+
+            var ucomment = this.findExtraFieldUnicodeComment();
+            if (ucomment !== null) {
+                this.fileCommentStr = ucomment;
+            } else {
+                // ASCII text or unsupported code page
+                var commentByteArray =  utils.transformTo(decodeParamType, this.fileComment);
+                this.fileCommentStr = this.loadOptions.decodeFileName(commentByteArray);
+            }
+        }
+    },
+
+    /**
+     * Find the unicode path declared in the extra field, if any.
+     * @return {String} the unicode path, null otherwise.
+     */
+    findExtraFieldUnicodePath: function() {
+        var upathField = this.extraFields[0x7075];
+        if (upathField) {
+            var extraReader = readerFor(upathField.value);
+
+            // wrong version
+            if (extraReader.readInt(1) !== 1) {
+                return null;
+            }
+
+            // the crc of the filename changed, this field is out of date.
+            if (crc32fn(this.fileName) !== extraReader.readInt(4)) {
+                return null;
+            }
+
+            return utf8.utf8decode(extraReader.readData(upathField.length - 5));
+        }
+        return null;
+    },
+
+    /**
+     * Find the unicode comment declared in the extra field, if any.
+     * @return {String} the unicode comment, null otherwise.
+     */
+    findExtraFieldUnicodeComment: function() {
+        var ucommentField = this.extraFields[0x6375];
+        if (ucommentField) {
+            var extraReader = readerFor(ucommentField.value);
+
+            // wrong version
+            if (extraReader.readInt(1) !== 1) {
+                return null;
+            }
+
+            // the crc of the comment changed, this field is out of date.
+            if (crc32fn(this.fileComment) !== extraReader.readInt(4)) {
+                return null;
+            }
+
+            return utf8.utf8decode(extraReader.readData(ucommentField.length - 5));
+        }
+        return null;
+    }
+};
+module.exports = ZipEntry;
+
+},{"./compressedObject":2,"./compressions":3,"./crc32":4,"./reader/readerFor":22,"./support":30,"./utf8":31,"./utils":32}],35:[function(require,module,exports){
+'use strict';
+
+var StreamHelper = require('./stream/StreamHelper');
+var DataWorker = require('./stream/DataWorker');
+var utf8 = require('./utf8');
+var CompressedObject = require('./compressedObject');
+var GenericWorker = require('./stream/GenericWorker');
+
+/**
+ * A simple object representing a file in the zip file.
+ * @constructor
+ * @param {string} name the name of the file
+ * @param {String|ArrayBuffer|Uint8Array|Buffer} data the data
+ * @param {Object} options the options of the file
+ */
+var ZipObject = function(name, data, options) {
+    this.name = name;
+    this.dir = options.dir;
+    this.date = options.date;
+    this.comment = options.comment;
+    this.unixPermissions = options.unixPermissions;
+    this.dosPermissions = options.dosPermissions;
+
+    this._data = data;
+    this._dataBinary = options.binary;
+    // keep only the compression
+    this.options = {
+        compression : options.compression,
+        compressionOptions : options.compressionOptions
+    };
+};
+
+ZipObject.prototype = {
+    /**
+     * Create an internal stream for the content of this object.
+     * @param {String} type the type of each chunk.
+     * @return StreamHelper the stream.
+     */
+    internalStream: function (type) {
+        var result = null, outputType = "string";
+        try {
+            if (!type) {
+                throw new Error("No output type specified.");
+            }
+            outputType = type.toLowerCase();
+            var askUnicodeString = outputType === "string" || outputType === "text";
+            if (outputType === "binarystring" || outputType === "text") {
+                outputType = "string";
+            }
+            result = this._decompressWorker();
+
+            var isUnicodeString = !this._dataBinary;
+
+            if (isUnicodeString && !askUnicodeString) {
+                result = result.pipe(new utf8.Utf8EncodeWorker());
+            }
+            if (!isUnicodeString && askUnicodeString) {
+                result = result.pipe(new utf8.Utf8DecodeWorker());
+            }
+        } catch (e) {
+            result = new GenericWorker("error");
+            result.error(e);
+        }
+
+        return new StreamHelper(result, outputType, "");
+    },
+
+    /**
+     * Prepare the content in the asked type.
+     * @param {String} type the type of the result.
+     * @param {Function} onUpdate a function to call on each internal update.
+     * @return Promise the promise of the result.
+     */
+    async: function (type, onUpdate) {
+        return this.internalStream(type).accumulate(onUpdate);
+    },
+
+    /**
+     * Prepare the content as a nodejs stream.
+     * @param {String} type the type of each chunk.
+     * @param {Function} onUpdate a function to call on each internal update.
+     * @return Stream the stream.
+     */
+    nodeStream: function (type, onUpdate) {
+        return this.internalStream(type || "nodebuffer").toNodejsStream(onUpdate);
+    },
+
+    /**
+     * Return a worker for the compressed content.
+     * @private
+     * @param {Object} compression the compression object to use.
+     * @param {Object} compressionOptions the options to use when compressing.
+     * @return Worker the worker.
+     */
+    _compressWorker: function (compression, compressionOptions) {
+        if (
+            this._data instanceof CompressedObject &&
+            this._data.compression.magic === compression.magic
+        ) {
+            return this._data.getCompressedWorker();
+        } else {
+            var result = this._decompressWorker();
+            if(!this._dataBinary) {
+                result = result.pipe(new utf8.Utf8EncodeWorker());
+            }
+            return CompressedObject.createWorkerFrom(result, compression, compressionOptions);
+        }
+    },
+    /**
+     * Return a worker for the decompressed content.
+     * @private
+     * @return Worker the worker.
+     */
+    _decompressWorker : function () {
+        if (this._data instanceof CompressedObject) {
+            return this._data.getContentWorker();
+        } else if (this._data instanceof GenericWorker) {
+            return this._data;
+        } else {
+            return new DataWorker(this._data);
+        }
+    }
+};
+
+var removedMethods = ["asText", "asBinary", "asNodeBuffer", "asUint8Array", "asArrayBuffer"];
+var removedFn = function () {
+    throw new Error("This method has been removed in JSZip 3.0, please check the upgrade guide.");
+};
+
+for(var i = 0; i < removedMethods.length; i++) {
+    ZipObject.prototype[removedMethods[i]] = removedFn;
+}
+module.exports = ZipObject;
+
+},{"./compressedObject":2,"./stream/DataWorker":27,"./stream/GenericWorker":28,"./stream/StreamHelper":29,"./utf8":31}],36:[function(require,module,exports){
+require('../modules/web.immediate');
+module.exports = require('../modules/_core').setImmediate;
+},{"../modules/_core":40,"../modules/web.immediate":56}],37:[function(require,module,exports){
+module.exports = function(it){
+  if(typeof it != 'function')throw TypeError(it + ' is not a function!');
+  return it;
+};
+},{}],38:[function(require,module,exports){
+var isObject = require('./_is-object');
+module.exports = function(it){
+  if(!isObject(it))throw TypeError(it + ' is not an object!');
+  return it;
+};
+},{"./_is-object":51}],39:[function(require,module,exports){
+var toString = {}.toString;
+
+module.exports = function(it){
+  return toString.call(it).slice(8, -1);
+};
+},{}],40:[function(require,module,exports){
+var core = module.exports = {version: '2.3.0'};
+if(typeof __e == 'number')__e = core; // eslint-disable-line no-undef
+},{}],41:[function(require,module,exports){
+// optional / simple context binding
+var aFunction = require('./_a-function');
+module.exports = function(fn, that, length){
+  aFunction(fn);
+  if(that === undefined)return fn;
+  switch(length){
+    case 1: return function(a){
+      return fn.call(that, a);
+    };
+    case 2: return function(a, b){
+      return fn.call(that, a, b);
+    };
+    case 3: return function(a, b, c){
+      return fn.call(that, a, b, c);
+    };
+  }
+  return function(/* ...args */){
+    return fn.apply(that, arguments);
+  };
+};
+},{"./_a-function":37}],42:[function(require,module,exports){
+// Thank's IE8 for his funny defineProperty
+module.exports = !require('./_fails')(function(){
+  return Object.defineProperty({}, 'a', {get: function(){ return 7; }}).a != 7;
+});
+},{"./_fails":45}],43:[function(require,module,exports){
+var isObject = require('./_is-object')
+  , document = require('./_global').document
+  // in old IE typeof document.createElement is 'object'
+  , is = isObject(document) && isObject(document.createElement);
+module.exports = function(it){
+  return is ? document.createElement(it) : {};
+};
+},{"./_global":46,"./_is-object":51}],44:[function(require,module,exports){
+var global    = require('./_global')
+  , core      = require('./_core')
+  , ctx       = require('./_ctx')
+  , hide      = require('./_hide')
+  , PROTOTYPE = 'prototype';
+
+var $export = function(type, name, source){
+  var IS_FORCED = type & $export.F
+    , IS_GLOBAL = type & $export.G
+    , IS_STATIC = type & $export.S
+    , IS_PROTO  = type & $export.P
+    , IS_BIND   = type & $export.B
+    , IS_WRAP   = type & $export.W
+    , exports   = IS_GLOBAL ? core : core[name] || (core[name] = {})
+    , expProto  = exports[PROTOTYPE]
+    , target    = IS_GLOBAL ? global : IS_STATIC ? global[name] : (global[name] || {})[PROTOTYPE]
+    , key, own, out;
+  if(IS_GLOBAL)source = name;
+  for(key in source){
+    // contains in native
+    own = !IS_FORCED && target && target[key] !== undefined;
+    if(own && key in exports)continue;
+    // export native or passed
+    out = own ? target[key] : source[key];
+    // prevent global pollution for namespaces
+    exports[key] = IS_GLOBAL && typeof target[key] != 'function' ? source[key]
+    // bind timers to global for call from export context
+    : IS_BIND && own ? ctx(out, global)
+    // wrap global constructors for prevent change them in library
+    : IS_WRAP && target[key] == out ? (function(C){
+      var F = function(a, b, c){
+        if(this instanceof C){
+          switch(arguments.length){
+            case 0: return new C;
+            case 1: return new C(a);
+            case 2: return new C(a, b);
+          } return new C(a, b, c);
+        } return C.apply(this, arguments);
+      };
+      F[PROTOTYPE] = C[PROTOTYPE];
+      return F;
+    // make static versions for prototype methods
+    })(out) : IS_PROTO && typeof out == 'function' ? ctx(Function.call, out) : out;
+    // export proto methods to core.%CONSTRUCTOR%.methods.%NAME%
+    if(IS_PROTO){
+      (exports.virtual || (exports.virtual = {}))[key] = out;
+      // export proto methods to core.%CONSTRUCTOR%.prototype.%NAME%
+      if(type & $export.R && expProto && !expProto[key])hide(expProto, key, out);
+    }
+  }
+};
+// type bitmap
+$export.F = 1;   // forced
+$export.G = 2;   // global
+$export.S = 4;   // static
+$export.P = 8;   // proto
+$export.B = 16;  // bind
+$export.W = 32;  // wrap
+$export.U = 64;  // safe
+$export.R = 128; // real proto method for `library` 
+module.exports = $export;
+},{"./_core":40,"./_ctx":41,"./_global":46,"./_hide":47}],45:[function(require,module,exports){
+module.exports = function(exec){
+  try {
+    return !!exec();
+  } catch(e){
+    return true;
+  }
+};
+},{}],46:[function(require,module,exports){
+// https://github.com/zloirock/core-js/issues/86#issuecomment-115759028
+var global = module.exports = typeof window != 'undefined' && window.Math == Math
+  ? window : typeof self != 'undefined' && self.Math == Math ? self : Function('return this')();
+if(typeof __g == 'number')__g = global; // eslint-disable-line no-undef
+},{}],47:[function(require,module,exports){
+var dP         = require('./_object-dp')
+  , createDesc = require('./_property-desc');
+module.exports = require('./_descriptors') ? function(object, key, value){
+  return dP.f(object, key, createDesc(1, value));
+} : function(object, key, value){
+  object[key] = value;
+  return object;
+};
+},{"./_descriptors":42,"./_object-dp":52,"./_property-desc":53}],48:[function(require,module,exports){
+module.exports = require('./_global').document && document.documentElement;
+},{"./_global":46}],49:[function(require,module,exports){
+module.exports = !require('./_descriptors') && !require('./_fails')(function(){
+  return Object.defineProperty(require('./_dom-create')('div'), 'a', {get: function(){ return 7; }}).a != 7;
+});
+},{"./_descriptors":42,"./_dom-create":43,"./_fails":45}],50:[function(require,module,exports){
+// fast apply, http://jsperf.lnkit.com/fast-apply/5
+module.exports = function(fn, args, that){
+  var un = that === undefined;
+  switch(args.length){
+    case 0: return un ? fn()
+                      : fn.call(that);
+    case 1: return un ? fn(args[0])
+                      : fn.call(that, args[0]);
+    case 2: return un ? fn(args[0], args[1])
+                      : fn.call(that, args[0], args[1]);
+    case 3: return un ? fn(args[0], args[1], args[2])
+                      : fn.call(that, args[0], args[1], args[2]);
+    case 4: return un ? fn(args[0], args[1], args[2], args[3])
+                      : fn.call(that, args[0], args[1], args[2], args[3]);
+  } return              fn.apply(that, args);
+};
+},{}],51:[function(require,module,exports){
+module.exports = function(it){
+  return typeof it === 'object' ? it !== null : typeof it === 'function';
+};
+},{}],52:[function(require,module,exports){
+var anObject       = require('./_an-object')
+  , IE8_DOM_DEFINE = require('./_ie8-dom-define')
+  , toPrimitive    = require('./_to-primitive')
+  , dP             = Object.defineProperty;
+
+exports.f = require('./_descriptors') ? Object.defineProperty : function defineProperty(O, P, Attributes){
+  anObject(O);
+  P = toPrimitive(P, true);
+  anObject(Attributes);
+  if(IE8_DOM_DEFINE)try {
+    return dP(O, P, Attributes);
+  } catch(e){ /* empty */ }
+  if('get' in Attributes || 'set' in Attributes)throw TypeError('Accessors not supported!');
+  if('value' in Attributes)O[P] = Attributes.value;
+  return O;
+};
+},{"./_an-object":38,"./_descriptors":42,"./_ie8-dom-define":49,"./_to-primitive":55}],53:[function(require,module,exports){
+module.exports = function(bitmap, value){
+  return {
+    enumerable  : !(bitmap & 1),
+    configurable: !(bitmap & 2),
+    writable    : !(bitmap & 4),
+    value       : value
+  };
+};
+},{}],54:[function(require,module,exports){
+var ctx                = require('./_ctx')
+  , invoke             = require('./_invoke')
+  , html               = require('./_html')
+  , cel                = require('./_dom-create')
+  , global             = require('./_global')
+  , process            = global.process
+  , setTask            = global.setImmediate
+  , clearTask          = global.clearImmediate
+  , MessageChannel     = global.MessageChannel
+  , counter            = 0
+  , queue              = {}
+  , ONREADYSTATECHANGE = 'onreadystatechange'
+  , defer, channel, port;
+var run = function(){
+  var id = +this;
+  if(queue.hasOwnProperty(id)){
+    var fn = queue[id];
+    delete queue[id];
+    fn();
+  }
+};
+var listener = function(event){
+  run.call(event.data);
+};
+// Node.js 0.9+ & IE10+ has setImmediate, otherwise:
+if(!setTask || !clearTask){
+  setTask = function setImmediate(fn){
+    var args = [], i = 1;
+    while(arguments.length > i)args.push(arguments[i++]);
+    queue[++counter] = function(){
+      invoke(typeof fn == 'function' ? fn : Function(fn), args);
+    };
+    defer(counter);
+    return counter;
+  };
+  clearTask = function clearImmediate(id){
+    delete queue[id];
+  };
+  // Node.js 0.8-
+  if(require('./_cof')(process) == 'process'){
+    defer = function(id){
+      process.nextTick(ctx(run, id, 1));
+    };
+  // Browsers with MessageChannel, includes WebWorkers
+  } else if(MessageChannel){
+    channel = new MessageChannel;
+    port    = channel.port2;
+    channel.port1.onmessage = listener;
+    defer = ctx(port.postMessage, port, 1);
+  // Browsers with postMessage, skip WebWorkers
+  // IE8 has postMessage, but it's sync & typeof its postMessage is 'object'
+  } else if(global.addEventListener && typeof postMessage == 'function' && !global.importScripts){
+    defer = function(id){
+      global.postMessage(id + '', '*');
+    };
+    global.addEventListener('message', listener, false);
+  // IE8-
+  } else if(ONREADYSTATECHANGE in cel('script')){
+    defer = function(id){
+      html.appendChild(cel('script'))[ONREADYSTATECHANGE] = function(){
+        html.removeChild(this);
+        run.call(id);
+      };
+    };
+  // Rest old browsers
+  } else {
+    defer = function(id){
+      setTimeout(ctx(run, id, 1), 0);
+    };
+  }
+}
+module.exports = {
+  set:   setTask,
+  clear: clearTask
+};
+},{"./_cof":39,"./_ctx":41,"./_dom-create":43,"./_global":46,"./_html":48,"./_invoke":50}],55:[function(require,module,exports){
+// 7.1.1 ToPrimitive(input [, PreferredType])
+var isObject = require('./_is-object');
+// instead of the ES6 spec version, we didn't implement @@toPrimitive case
+// and the second argument - flag - preferred type is a string
+module.exports = function(it, S){
+  if(!isObject(it))return it;
+  var fn, val;
+  if(S && typeof (fn = it.toString) == 'function' && !isObject(val = fn.call(it)))return val;
+  if(typeof (fn = it.valueOf) == 'function' && !isObject(val = fn.call(it)))return val;
+  if(!S && typeof (fn = it.toString) == 'function' && !isObject(val = fn.call(it)))return val;
+  throw TypeError("Can't convert object to primitive value");
+};
+},{"./_is-object":51}],56:[function(require,module,exports){
+var $export = require('./_export')
+  , $task   = require('./_task');
+$export($export.G + $export.B, {
+  setImmediate:   $task.set,
+  clearImmediate: $task.clear
+});
+},{"./_export":44,"./_task":54}],57:[function(require,module,exports){
+(function (global){
+'use strict';
+var Mutation = global.MutationObserver || global.WebKitMutationObserver;
+
+var scheduleDrain;
+
+{
+  if (Mutation) {
+    var called = 0;
+    var observer = new Mutation(nextTick);
+    var element = global.document.createTextNode('');
+    observer.observe(element, {
+      characterData: true
+    });
+    scheduleDrain = function () {
+      element.data = (called = ++called % 2);
+    };
+  } else if (!global.setImmediate && typeof global.MessageChannel !== 'undefined') {
+    var channel = new global.MessageChannel();
+    channel.port1.onmessage = nextTick;
+    scheduleDrain = function () {
+      channel.port2.postMessage(0);
+    };
+  } else if ('document' in global && 'onreadystatechange' in global.document.createElement('script')) {
+    scheduleDrain = function () {
+
+      // Create a <script> element; its readystatechange event will be fired asynchronously once it is inserted
+      // into the document. Do so, thus queuing up the task. Remember to clean up once it's been called.
+      var scriptEl = global.document.createElement('script');
+      scriptEl.onreadystatechange = function () {
+        nextTick();
+
+        scriptEl.onreadystatechange = null;
+        scriptEl.parentNode.removeChild(scriptEl);
+        scriptEl = null;
+      };
+      global.document.documentElement.appendChild(scriptEl);
+    };
+  } else {
+    scheduleDrain = function () {
+      setTimeout(nextTick, 0);
+    };
+  }
+}
+
+var draining;
+var queue = [];
+//named nextTick for less confusing stack traces
+function nextTick() {
+  draining = true;
+  var i, oldQueue;
+  var len = queue.length;
+  while (len) {
+    oldQueue = queue;
+    queue = [];
+    i = -1;
+    while (++i < len) {
+      oldQueue[i]();
+    }
+    len = queue.length;
+  }
+  draining = false;
+}
+
+module.exports = immediate;
+function immediate(task) {
+  if (queue.push(task) === 1 && !draining) {
+    scheduleDrain();
+  }
+}
+
+}).call(this,typeof global !== "undefined" ? global : typeof self !== "undefined" ? self : typeof window !== "undefined" ? window : {})
+},{}],58:[function(require,module,exports){
+'use strict';
+var immediate = require('immediate');
+
+/* istanbul ignore next */
+function INTERNAL() {}
+
+var handlers = {};
+
+var REJECTED = ['REJECTED'];
+var FULFILLED = ['FULFILLED'];
+var PENDING = ['PENDING'];
+
+module.exports = Promise;
+
+function Promise(resolver) {
+  if (typeof resolver !== 'function') {
+    throw new TypeError('resolver must be a function');
+  }
+  this.state = PENDING;
+  this.queue = [];
+  this.outcome = void 0;
+  if (resolver !== INTERNAL) {
+    safelyResolveThenable(this, resolver);
+  }
+}
+
+Promise.prototype["catch"] = function (onRejected) {
+  return this.then(null, onRejected);
+};
+Promise.prototype.then = function (onFulfilled, onRejected) {
+  if (typeof onFulfilled !== 'function' && this.state === FULFILLED ||
+    typeof onRejected !== 'function' && this.state === REJECTED) {
+    return this;
+  }
+  var promise = new this.constructor(INTERNAL);
+  if (this.state !== PENDING) {
+    var resolver = this.state === FULFILLED ? onFulfilled : onRejected;
+    unwrap(promise, resolver, this.outcome);
+  } else {
+    this.queue.push(new QueueItem(promise, onFulfilled, onRejected));
+  }
+
+  return promise;
+};
+function QueueItem(promise, onFulfilled, onRejected) {
+  this.promise = promise;
+  if (typeof onFulfilled === 'function') {
+    this.onFulfilled = onFulfilled;
+    this.callFulfilled = this.otherCallFulfilled;
+  }
+  if (typeof onRejected === 'function') {
+    this.onRejected = onRejected;
+    this.callRejected = this.otherCallRejected;
+  }
+}
+QueueItem.prototype.callFulfilled = function (value) {
+  handlers.resolve(this.promise, value);
+};
+QueueItem.prototype.otherCallFulfilled = function (value) {
+  unwrap(this.promise, this.onFulfilled, value);
+};
+QueueItem.prototype.callRejected = function (value) {
+  handlers.reject(this.promise, value);
+};
+QueueItem.prototype.otherCallRejected = function (value) {
+  unwrap(this.promise, this.onRejected, value);
+};
+
+function unwrap(promise, func, value) {
+  immediate(function () {
+    var returnValue;
+    try {
+      returnValue = func(value);
+    } catch (e) {
+      return handlers.reject(promise, e);
+    }
+    if (returnValue === promise) {
+      handlers.reject(promise, new TypeError('Cannot resolve promise with itself'));
+    } else {
+      handlers.resolve(promise, returnValue);
+    }
+  });
+}
+
+handlers.resolve = function (self, value) {
+  var result = tryCatch(getThen, value);
+  if (result.status === 'error') {
+    return handlers.reject(self, result.value);
+  }
+  var thenable = result.value;
+
+  if (thenable) {
+    safelyResolveThenable(self, thenable);
+  } else {
+    self.state = FULFILLED;
+    self.outcome = value;
+    var i = -1;
+    var len = self.queue.length;
+    while (++i < len) {
+      self.queue[i].callFulfilled(value);
+    }
+  }
+  return self;
+};
+handlers.reject = function (self, error) {
+  self.state = REJECTED;
+  self.outcome = error;
+  var i = -1;
+  var len = self.queue.length;
+  while (++i < len) {
+    self.queue[i].callRejected(error);
+  }
+  return self;
+};
+
+function getThen(obj) {
+  // Make sure we only access the accessor once as required by the spec
+  var then = obj && obj.then;
+  if (obj && (typeof obj === 'object' || typeof obj === 'function') && typeof then === 'function') {
+    return function appyThen() {
+      then.apply(obj, arguments);
+    };
+  }
+}
+
+function safelyResolveThenable(self, thenable) {
+  // Either fulfill, reject or reject with error
+  var called = false;
+  function onError(value) {
+    if (called) {
+      return;
+    }
+    called = true;
+    handlers.reject(self, value);
+  }
+
+  function onSuccess(value) {
+    if (called) {
+      return;
+    }
+    called = true;
+    handlers.resolve(self, value);
+  }
+
+  function tryToUnwrap() {
+    thenable(onSuccess, onError);
+  }
+
+  var result = tryCatch(tryToUnwrap);
+  if (result.status === 'error') {
+    onError(result.value);
+  }
+}
+
+function tryCatch(func, value) {
+  var out = {};
+  try {
+    out.value = func(value);
+    out.status = 'success';
+  } catch (e) {
+    out.status = 'error';
+    out.value = e;
+  }
+  return out;
+}
+
+Promise.resolve = resolve;
+function resolve(value) {
+  if (value instanceof this) {
+    return value;
+  }
+  return handlers.resolve(new this(INTERNAL), value);
+}
+
+Promise.reject = reject;
+function reject(reason) {
+  var promise = new this(INTERNAL);
+  return handlers.reject(promise, reason);
+}
+
+Promise.all = all;
+function all(iterable) {
+  var self = this;
+  if (Object.prototype.toString.call(iterable) !== '[object Array]') {
+    return this.reject(new TypeError('must be an array'));
+  }
+
+  var len = iterable.length;
+  var called = false;
+  if (!len) {
+    return this.resolve([]);
+  }
+
+  var values = new Array(len);
+  var resolved = 0;
+  var i = -1;
+  var promise = new this(INTERNAL);
+
+  while (++i < len) {
+    allResolver(iterable[i], i);
+  }
+  return promise;
+  function allResolver(value, i) {
+    self.resolve(value).then(resolveFromAll, function (error) {
+      if (!called) {
+        called = true;
+        handlers.reject(promise, error);
+      }
+    });
+    function resolveFromAll(outValue) {
+      values[i] = outValue;
+      if (++resolved === len && !called) {
+        called = true;
+        handlers.resolve(promise, values);
+      }
+    }
+  }
+}
+
+Promise.race = race;
+function race(iterable) {
+  var self = this;
+  if (Object.prototype.toString.call(iterable) !== '[object Array]') {
+    return this.reject(new TypeError('must be an array'));
+  }
+
+  var len = iterable.length;
+  var called = false;
+  if (!len) {
+    return this.resolve([]);
+  }
+
+  var i = -1;
+  var promise = new this(INTERNAL);
+
+  while (++i < len) {
+    resolver(iterable[i]);
+  }
+  return promise;
+  function resolver(value) {
+    self.resolve(value).then(function (response) {
+      if (!called) {
+        called = true;
+        handlers.resolve(promise, response);
+      }
+    }, function (error) {
+      if (!called) {
+        called = true;
+        handlers.reject(promise, error);
+      }
+    });
+  }
+}
+
+},{"immediate":57}],59:[function(require,module,exports){
+// Top level file is just a mixin of submodules & constants
+'use strict';
+
+var assign    = require('./lib/utils/common').assign;
+
+var deflate   = require('./lib/deflate');
+var inflate   = require('./lib/inflate');
+var constants = require('./lib/zlib/constants');
+
+var pako = {};
+
+assign(pako, deflate, inflate, constants);
+
+module.exports = pako;
+
+},{"./lib/deflate":60,"./lib/inflate":61,"./lib/utils/common":62,"./lib/zlib/constants":65}],60:[function(require,module,exports){
+'use strict';
+
+
+var zlib_deflate = require('./zlib/deflate');
+var utils        = require('./utils/common');
+var strings      = require('./utils/strings');
+var msg          = require('./zlib/messages');
+var ZStream      = require('./zlib/zstream');
+
+var toString = Object.prototype.toString;
+
+/* Public constants ==========================================================*/
+/* ===========================================================================*/
+
+var Z_NO_FLUSH      = 0;
+var Z_FINISH        = 4;
+
+var Z_OK            = 0;
+var Z_STREAM_END    = 1;
+var Z_SYNC_FLUSH    = 2;
+
+var Z_DEFAULT_COMPRESSION = -1;
+
+var Z_DEFAULT_STRATEGY    = 0;
+
+var Z_DEFLATED  = 8;
+
+/* ===========================================================================*/
+
+
+/**
+ * class Deflate
+ *
+ * Generic JS-style wrapper for zlib calls. If you don't need
+ * streaming behaviour - use more simple functions: [[deflate]],
+ * [[deflateRaw]] and [[gzip]].
+ **/
+
+/* internal
+ * Deflate.chunks -> Array
+ *
+ * Chunks of output data, if [[Deflate#onData]] not overriden.
+ **/
+
+/**
+ * Deflate.result -> Uint8Array|Array
+ *
+ * Compressed result, generated by default [[Deflate#onData]]
+ * and [[Deflate#onEnd]] handlers. Filled after you push last chunk
+ * (call [[Deflate#push]] with `Z_FINISH` / `true` param)  or if you
+ * push a chunk with explicit flush (call [[Deflate#push]] with
+ * `Z_SYNC_FLUSH` param).
+ **/
+
+/**
+ * Deflate.err -> Number
+ *
+ * Error code after deflate finished. 0 (Z_OK) on success.
+ * You will not need it in real life, because deflate errors
+ * are possible only on wrong options or bad `onData` / `onEnd`
+ * custom handlers.
+ **/
+
+/**
+ * Deflate.msg -> String
+ *
+ * Error message, if [[Deflate.err]] != 0
+ **/
+
+
+/**
+ * new Deflate(options)
+ * - options (Object): zlib deflate options.
+ *
+ * Creates new deflator instance with specified params. Throws exception
+ * on bad params. Supported options:
+ *
+ * - `level`
+ * - `windowBits`
+ * - `memLevel`
+ * - `strategy`
+ * - `dictionary`
+ *
+ * [http://zlib.net/manual.html#Advanced](http://zlib.net/manual.html#Advanced)
+ * for more information on these.
+ *
+ * Additional options, for internal needs:
+ *
+ * - `chunkSize` - size of generated data chunks (16K by default)
+ * - `raw` (Boolean) - do raw deflate
+ * - `gzip` (Boolean) - create gzip wrapper
+ * - `to` (String) - if equal to 'string', then result will be "binary string"
+ *    (each char code [0..255])
+ * - `header` (Object) - custom header for gzip
+ *   - `text` (Boolean) - true if compressed data believed to be text
+ *   - `time` (Number) - modification time, unix timestamp
+ *   - `os` (Number) - operation system code
+ *   - `extra` (Array) - array of bytes with extra data (max 65536)
+ *   - `name` (String) - file name (binary string)
+ *   - `comment` (String) - comment (binary string)
+ *   - `hcrc` (Boolean) - true if header crc should be added
+ *
+ * ##### Example:
+ *
+ * ```javascript
+ * var pako = require('pako')
+ *   , chunk1 = Uint8Array([1,2,3,4,5,6,7,8,9])
+ *   , chunk2 = Uint8Array([10,11,12,13,14,15,16,17,18,19]);
+ *
+ * var deflate = new pako.Deflate({ level: 3});
+ *
+ * deflate.push(chunk1, false);
+ * deflate.push(chunk2, true);  // true -> last chunk
+ *
+ * if (deflate.err) { throw new Error(deflate.err); }
+ *
+ * console.log(deflate.result);
+ * ```
+ **/
+function Deflate(options) {
+  if (!(this instanceof Deflate)) return new Deflate(options);
+
+  this.options = utils.assign({
+    level: Z_DEFAULT_COMPRESSION,
+    method: Z_DEFLATED,
+    chunkSize: 16384,
+    windowBits: 15,
+    memLevel: 8,
+    strategy: Z_DEFAULT_STRATEGY,
+    to: ''
+  }, options || {});
+
+  var opt = this.options;
+
+  if (opt.raw && (opt.windowBits > 0)) {
+    opt.windowBits = -opt.windowBits;
+  }
+
+  else if (opt.gzip && (opt.windowBits > 0) && (opt.windowBits < 16)) {
+    opt.windowBits += 16;
+  }
+
+  this.err    = 0;      // error code, if happens (0 = Z_OK)
+  this.msg    = '';     // error message
+  this.ended  = false;  // used to avoid multiple onEnd() calls
+  this.chunks = [];     // chunks of compressed data
+
+  this.strm = new ZStream();
+  this.strm.avail_out = 0;
+
+  var status = zlib_deflate.deflateInit2(
+    this.strm,
+    opt.level,
+    opt.method,
+    opt.windowBits,
+    opt.memLevel,
+    opt.strategy
+  );
+
+  if (status !== Z_OK) {
+    throw new Error(msg[status]);
+  }
+
+  if (opt.header) {
+    zlib_deflate.deflateSetHeader(this.strm, opt.header);
+  }
+
+  if (opt.dictionary) {
+    var dict;
+    // Convert data if needed
+    if (typeof opt.dictionary === 'string') {
+      // If we need to compress text, change encoding to utf8.
+      dict = strings.string2buf(opt.dictionary);
+    } else if (toString.call(opt.dictionary) === '[object ArrayBuffer]') {
+      dict = new Uint8Array(opt.dictionary);
+    } else {
+      dict = opt.dictionary;
+    }
+
+    status = zlib_deflate.deflateSetDictionary(this.strm, dict);
+
+    if (status !== Z_OK) {
+      throw new Error(msg[status]);
+    }
+
+    this._dict_set = true;
+  }
+}
+
+/**
+ * Deflate#push(data[, mode]) -> Boolean
+ * - data (Uint8Array|Array|ArrayBuffer|String): input data. Strings will be
+ *   converted to utf8 byte sequence.
+ * - mode (Number|Boolean): 0..6 for corresponding Z_NO_FLUSH..Z_TREE modes.
+ *   See constants. Skipped or `false` means Z_NO_FLUSH, `true` meansh Z_FINISH.
+ *
+ * Sends input data to deflate pipe, generating [[Deflate#onData]] calls with
+ * new compressed chunks. Returns `true` on success. The last data block must have
+ * mode Z_FINISH (or `true`). That will flush internal pending buffers and call
+ * [[Deflate#onEnd]]. For interim explicit flushes (without ending the stream) you
+ * can use mode Z_SYNC_FLUSH, keeping the compression context.
+ *
+ * On fail call [[Deflate#onEnd]] with error code and return false.
+ *
+ * We strongly recommend to use `Uint8Array` on input for best speed (output
+ * array format is detected automatically). Also, don't skip last param and always
+ * use the same type in your code (boolean or number). That will improve JS speed.
+ *
+ * For regular `Array`-s make sure all elements are [0..255].
+ *
+ * ##### Example
+ *
+ * ```javascript
+ * push(chunk, false); // push one of data chunks
+ * ...
+ * push(chunk, true);  // push last chunk
+ * ```
+ **/
+Deflate.prototype.push = function (data, mode) {
+  var strm = this.strm;
+  var chunkSize = this.options.chunkSize;
+  var status, _mode;
+
+  if (this.ended) { return false; }
+
+  _mode = (mode === ~~mode) ? mode : ((mode === true) ? Z_FINISH : Z_NO_FLUSH);
+
+  // Convert data if needed
+  if (typeof data === 'string') {
+    // If we need to compress text, change encoding to utf8.
+    strm.input = strings.string2buf(data);
+  } else if (toString.call(data) === '[object ArrayBuffer]') {
+    strm.input = new Uint8Array(data);
+  } else {
+    strm.input = data;
+  }
+
+  strm.next_in = 0;
+  strm.avail_in = strm.input.length;
+
+  do {
+    if (strm.avail_out === 0) {
+      strm.output = new utils.Buf8(chunkSize);
+      strm.next_out = 0;
+      strm.avail_out = chunkSize;
+    }
+    status = zlib_deflate.deflate(strm, _mode);    /* no bad return value */
+
+    if (status !== Z_STREAM_END && status !== Z_OK) {
+      this.onEnd(status);
+      this.ended = true;
+      return false;
+    }
+    if (strm.avail_out === 0 || (strm.avail_in === 0 && (_mode === Z_FINISH || _mode === Z_SYNC_FLUSH))) {
+      if (this.options.to === 'string') {
+        this.onData(strings.buf2binstring(utils.shrinkBuf(strm.output, strm.next_out)));
+      } else {
+        this.onData(utils.shrinkBuf(strm.output, strm.next_out));
+      }
+    }
+  } while ((strm.avail_in > 0 || strm.avail_out === 0) && status !== Z_STREAM_END);
+
+  // Finalize on the last chunk.
+  if (_mode === Z_FINISH) {
+    status = zlib_deflate.deflateEnd(this.strm);
+    this.onEnd(status);
+    this.ended = true;
+    return status === Z_OK;
+  }
+
+  // callback interim results if Z_SYNC_FLUSH.
+  if (_mode === Z_SYNC_FLUSH) {
+    this.onEnd(Z_OK);
+    strm.avail_out = 0;
+    return true;
+  }
+
+  return true;
+};
+
+
+/**
+ * Deflate#onData(chunk) -> Void
+ * - chunk (Uint8Array|Array|String): ouput data. Type of array depends
+ *   on js engine support. When string output requested, each chunk
+ *   will be string.
+ *
+ * By default, stores data blocks in `chunks[]` property and glue
+ * those in `onEnd`. Override this handler, if you need another behaviour.
+ **/
+Deflate.prototype.onData = function (chunk) {
+  this.chunks.push(chunk);
+};
+
+
+/**
+ * Deflate#onEnd(status) -> Void
+ * - status (Number): deflate status. 0 (Z_OK) on success,
+ *   other if not.
+ *
+ * Called once after you tell deflate that the input stream is
+ * complete (Z_FINISH) or should be flushed (Z_SYNC_FLUSH)
+ * or if an error happened. By default - join collected chunks,
+ * free memory and fill `results` / `err` properties.
+ **/
+Deflate.prototype.onEnd = function (status) {
+  // On success - join
+  if (status === Z_OK) {
+    if (this.options.to === 'string') {
+      this.result = this.chunks.join('');
+    } else {
+      this.result = utils.flattenChunks(this.chunks);
+    }
+  }
+  this.chunks = [];
+  this.err = status;
+  this.msg = this.strm.msg;
+};
+
+
+/**
+ * deflate(data[, options]) -> Uint8Array|Array|String
+ * - data (Uint8Array|Array|String): input data to compress.
+ * - options (Object): zlib deflate options.
+ *
+ * Compress `data` with deflate algorithm and `options`.
+ *
+ * Supported options are:
+ *
+ * - level
+ * - windowBits
+ * - memLevel
+ * - strategy
+ * - dictionary
+ *
+ * [http://zlib.net/manual.html#Advanced](http://zlib.net/manual.html#Advanced)
+ * for more information on these.
+ *
+ * Sugar (options):
+ *
+ * - `raw` (Boolean) - say that we work with raw stream, if you don't wish to specify
+ *   negative windowBits implicitly.
+ * - `to` (String) - if equal to 'string', then result will be "binary string"
+ *    (each char code [0..255])
+ *
+ * ##### Example:
+ *
+ * ```javascript
+ * var pako = require('pako')
+ *   , data = Uint8Array([1,2,3,4,5,6,7,8,9]);
+ *
+ * console.log(pako.deflate(data));
+ * ```
+ **/
+function deflate(input, options) {
+  var deflator = new Deflate(options);
+
+  deflator.push(input, true);
+
+  // That will never happens, if you don't cheat with options :)
+  if (deflator.err) { throw deflator.msg || msg[deflator.err]; }
+
+  return deflator.result;
+}
+
+
+/**
+ * deflateRaw(data[, options]) -> Uint8Array|Array|String
+ * - data (Uint8Array|Array|String): input data to compress.
+ * - options (Object): zlib deflate options.
+ *
+ * The same as [[deflate]], but creates raw data, without wrapper
+ * (header and adler32 crc).
+ **/
+function deflateRaw(input, options) {
+  options = options || {};
+  options.raw = true;
+  return deflate(input, options);
+}
+
+
+/**
+ * gzip(data[, options]) -> Uint8Array|Array|String
+ * - data (Uint8Array|Array|String): input data to compress.
+ * - options (Object): zlib deflate options.
+ *
+ * The same as [[deflate]], but create gzip wrapper instead of
+ * deflate one.
+ **/
+function gzip(input, options) {
+  options = options || {};
+  options.gzip = true;
+  return deflate(input, options);
+}
+
+
+exports.Deflate = Deflate;
+exports.deflate = deflate;
+exports.deflateRaw = deflateRaw;
+exports.gzip = gzip;
+
+},{"./utils/common":62,"./utils/strings":63,"./zlib/deflate":67,"./zlib/messages":72,"./zlib/zstream":74}],61:[function(require,module,exports){
+'use strict';
+
+
+var zlib_inflate = require('./zlib/inflate');
+var utils        = require('./utils/common');
+var strings      = require('./utils/strings');
+var c            = require('./zlib/constants');
+var msg          = require('./zlib/messages');
+var ZStream      = require('./zlib/zstream');
+var GZheader     = require('./zlib/gzheader');
+
+var toString = Object.prototype.toString;
+
+/**
+ * class Inflate
+ *
+ * Generic JS-style wrapper for zlib calls. If you don't need
+ * streaming behaviour - use more simple functions: [[inflate]]
+ * and [[inflateRaw]].
+ **/
+
+/* internal
+ * inflate.chunks -> Array
+ *
+ * Chunks of output data, if [[Inflate#onData]] not overriden.
+ **/
+
+/**
+ * Inflate.result -> Uint8Array|Array|String
+ *
+ * Uncompressed result, generated by default [[Inflate#onData]]
+ * and [[Inflate#onEnd]] handlers. Filled after you push last chunk
+ * (call [[Inflate#push]] with `Z_FINISH` / `true` param) or if you
+ * push a chunk with explicit flush (call [[Inflate#push]] with
+ * `Z_SYNC_FLUSH` param).
+ **/
+
+/**
+ * Inflate.err -> Number
+ *
+ * Error code after inflate finished. 0 (Z_OK) on success.
+ * Should be checked if broken data possible.
+ **/
+
+/**
+ * Inflate.msg -> String
+ *
+ * Error message, if [[Inflate.err]] != 0
+ **/
+
+
+/**
+ * new Inflate(options)
+ * - options (Object): zlib inflate options.
+ *
+ * Creates new inflator instance with specified params. Throws exception
+ * on bad params. Supported options:
+ *
+ * - `windowBits`
+ * - `dictionary`
+ *
+ * [http://zlib.net/manual.html#Advanced](http://zlib.net/manual.html#Advanced)
+ * for more information on these.
+ *
+ * Additional options, for internal needs:
+ *
+ * - `chunkSize` - size of generated data chunks (16K by default)
+ * - `raw` (Boolean) - do raw inflate
+ * - `to` (String) - if equal to 'string', then result will be converted
+ *   from utf8 to utf16 (javascript) string. When string output requested,
+ *   chunk length can differ from `chunkSize`, depending on content.
+ *
+ * By default, when no options set, autodetect deflate/gzip data format via
+ * wrapper header.
+ *
+ * ##### Example:
+ *
+ * ```javascript
+ * var pako = require('pako')
+ *   , chunk1 = Uint8Array([1,2,3,4,5,6,7,8,9])
+ *   , chunk2 = Uint8Array([10,11,12,13,14,15,16,17,18,19]);
+ *
+ * var inflate = new pako.Inflate({ level: 3});
+ *
+ * inflate.push(chunk1, false);
+ * inflate.push(chunk2, true);  // true -> last chunk
+ *
+ * if (inflate.err) { throw new Error(inflate.err); }
+ *
+ * console.log(inflate.result);
+ * ```
+ **/
+function Inflate(options) {
+  if (!(this instanceof Inflate)) return new Inflate(options);
+
+  this.options = utils.assign({
+    chunkSize: 16384,
+    windowBits: 0,
+    to: ''
+  }, options || {});
+
+  var opt = this.options;
+
+  // Force window size for `raw` data, if not set directly,
+  // because we have no header for autodetect.
+  if (opt.raw && (opt.windowBits >= 0) && (opt.windowBits < 16)) {
+    opt.windowBits = -opt.windowBits;
+    if (opt.windowBits === 0) { opt.windowBits = -15; }
+  }
+
+  // If `windowBits` not defined (and mode not raw) - set autodetect flag for gzip/deflate
+  if ((opt.windowBits >= 0) && (opt.windowBits < 16) &&
+      !(options && options.windowBits)) {
+    opt.windowBits += 32;
+  }
+
+  // Gzip header has no info about windows size, we can do autodetect only
+  // for deflate. So, if window size not set, force it to max when gzip possible
+  if ((opt.windowBits > 15) && (opt.windowBits < 48)) {
+    // bit 3 (16) -> gzipped data
+    // bit 4 (32) -> autodetect gzip/deflate
+    if ((opt.windowBits & 15) === 0) {
+      opt.windowBits |= 15;
+    }
+  }
+
+  this.err    = 0;      // error code, if happens (0 = Z_OK)
+  this.msg    = '';     // error message
+  this.ended  = false;  // used to avoid multiple onEnd() calls
+  this.chunks = [];     // chunks of compressed data
+
+  this.strm   = new ZStream();
+  this.strm.avail_out = 0;
+
+  var status  = zlib_inflate.inflateInit2(
+    this.strm,
+    opt.windowBits
+  );
+
+  if (status !== c.Z_OK) {
+    throw new Error(msg[status]);
+  }
+
+  this.header = new GZheader();
+
+  zlib_inflate.inflateGetHeader(this.strm, this.header);
+}
+
+/**
+ * Inflate#push(data[, mode]) -> Boolean
+ * - data (Uint8Array|Array|ArrayBuffer|String): input data
+ * - mode (Number|Boolean): 0..6 for corresponding Z_NO_FLUSH..Z_TREE modes.
+ *   See constants. Skipped or `false` means Z_NO_FLUSH, `true` meansh Z_FINISH.
+ *
+ * Sends input data to inflate pipe, generating [[Inflate#onData]] calls with
+ * new output chunks. Returns `true` on success. The last data block must have
+ * mode Z_FINISH (or `true`). That will flush internal pending buffers and call
+ * [[Inflate#onEnd]]. For interim explicit flushes (without ending the stream) you
+ * can use mode Z_SYNC_FLUSH, keeping the decompression context.
+ *
+ * On fail call [[Inflate#onEnd]] with error code and return false.
+ *
+ * We strongly recommend to use `Uint8Array` on input for best speed (output
+ * format is detected automatically). Also, don't skip last param and always
+ * use the same type in your code (boolean or number). That will improve JS speed.
+ *
+ * For regular `Array`-s make sure all elements are [0..255].
+ *
+ * ##### Example
+ *
+ * ```javascript
+ * push(chunk, false); // push one of data chunks
+ * ...
+ * push(chunk, true);  // push last chunk
+ * ```
+ **/
+Inflate.prototype.push = function (data, mode) {
+  var strm = this.strm;
+  var chunkSize = this.options.chunkSize;
+  var dictionary = this.options.dictionary;
+  var status, _mode;
+  var next_out_utf8, tail, utf8str;
+  var dict;
+
+  // Flag to properly process Z_BUF_ERROR on testing inflate call
+  // when we check that all output data was flushed.
+  var allowBufError = false;
+
+  if (this.ended) { return false; }
+  _mode = (mode === ~~mode) ? mode : ((mode === true) ? c.Z_FINISH : c.Z_NO_FLUSH);
+
+  // Convert data if needed
+  if (typeof data === 'string') {
+    // Only binary strings can be decompressed on practice
+    strm.input = strings.binstring2buf(data);
+  } else if (toString.call(data) === '[object ArrayBuffer]') {
+    strm.input = new Uint8Array(data);
+  } else {
+    strm.input = data;
+  }
+
+  strm.next_in = 0;
+  strm.avail_in = strm.input.length;
+
+  do {
+    if (strm.avail_out === 0) {
+      strm.output = new utils.Buf8(chunkSize);
+      strm.next_out = 0;
+      strm.avail_out = chunkSize;
+    }
+
+    status = zlib_inflate.inflate(strm, c.Z_NO_FLUSH);    /* no bad return value */
+
+    if (status === c.Z_NEED_DICT && dictionary) {
+      // Convert data if needed
+      if (typeof dictionary === 'string') {
+        dict = strings.string2buf(dictionary);
+      } else if (toString.call(dictionary) === '[object ArrayBuffer]') {
+        dict = new Uint8Array(dictionary);
+      } else {
+        dict = dictionary;
+      }
+
+      status = zlib_inflate.inflateSetDictionary(this.strm, dict);
+
+    }
+
+    if (status === c.Z_BUF_ERROR && allowBufError === true) {
+      status = c.Z_OK;
+      allowBufError = false;
+    }
+
+    if (status !== c.Z_STREAM_END && status !== c.Z_OK) {
+      this.onEnd(status);
+      this.ended = true;
+      return false;
+    }
+
+    if (strm.next_out) {
+      if (strm.avail_out === 0 || status === c.Z_STREAM_END || (strm.avail_in === 0 && (_mode === c.Z_FINISH || _mode === c.Z_SYNC_FLUSH))) {
+
+        if (this.options.to === 'string') {
+
+          next_out_utf8 = strings.utf8border(strm.output, strm.next_out);
+
+          tail = strm.next_out - next_out_utf8;
+          utf8str = strings.buf2string(strm.output, next_out_utf8);
+
+          // move tail
+          strm.next_out = tail;
+          strm.avail_out = chunkSize - tail;
+          if (tail) { utils.arraySet(strm.output, strm.output, next_out_utf8, tail, 0); }
+
+          this.onData(utf8str);
+
+        } else {
+          this.onData(utils.shrinkBuf(strm.output, strm.next_out));
+        }
+      }
+    }
+
+    // When no more input data, we should check that internal inflate buffers
+    // are flushed. The only way to do it when avail_out = 0 - run one more
+    // inflate pass. But if output data not exists, inflate return Z_BUF_ERROR.
+    // Here we set flag to process this error properly.
+    //
+    // NOTE. Deflate does not return error in this case and does not needs such
+    // logic.
+    if (strm.avail_in === 0 && strm.avail_out === 0) {
+      allowBufError = true;
+    }
+
+  } while ((strm.avail_in > 0 || strm.avail_out === 0) && status !== c.Z_STREAM_END);
+
+  if (status === c.Z_STREAM_END) {
+    _mode = c.Z_FINISH;
+  }
+
+  // Finalize on the last chunk.
+  if (_mode === c.Z_FINISH) {
+    status = zlib_inflate.inflateEnd(this.strm);
+    this.onEnd(status);
+    this.ended = true;
+    return status === c.Z_OK;
+  }
+
+  // callback interim results if Z_SYNC_FLUSH.
+  if (_mode === c.Z_SYNC_FLUSH) {
+    this.onEnd(c.Z_OK);
+    strm.avail_out = 0;
+    return true;
+  }
+
+  return true;
+};
+
+
+/**
+ * Inflate#onData(chunk) -> Void
+ * - chunk (Uint8Array|Array|String): ouput data. Type of array depends
+ *   on js engine support. When string output requested, each chunk
+ *   will be string.
+ *
+ * By default, stores data blocks in `chunks[]` property and glue
+ * those in `onEnd`. Override this handler, if you need another behaviour.
+ **/
+Inflate.prototype.onData = function (chunk) {
+  this.chunks.push(chunk);
+};
+
+
+/**
+ * Inflate#onEnd(status) -> Void
+ * - status (Number): inflate status. 0 (Z_OK) on success,
+ *   other if not.
+ *
+ * Called either after you tell inflate that the input stream is
+ * complete (Z_FINISH) or should be flushed (Z_SYNC_FLUSH)
+ * or if an error happened. By default - join collected chunks,
+ * free memory and fill `results` / `err` properties.
+ **/
+Inflate.prototype.onEnd = function (status) {
+  // On success - join
+  if (status === c.Z_OK) {
+    if (this.options.to === 'string') {
+      // Glue & convert here, until we teach pako to send
+      // utf8 alligned strings to onData
+      this.result = this.chunks.join('');
+    } else {
+      this.result = utils.flattenChunks(this.chunks);
+    }
+  }
+  this.chunks = [];
+  this.err = status;
+  this.msg = this.strm.msg;
+};
+
+
+/**
+ * inflate(data[, options]) -> Uint8Array|Array|String
+ * - data (Uint8Array|Array|String): input data to decompress.
+ * - options (Object): zlib inflate options.
+ *
+ * Decompress `data` with inflate/ungzip and `options`. Autodetect
+ * format via wrapper header by default. That's why we don't provide
+ * separate `ungzip` method.
+ *
+ * Supported options are:
+ *
+ * - windowBits
+ *
+ * [http://zlib.net/manual.html#Advanced](http://zlib.net/manual.html#Advanced)
+ * for more information.
+ *
+ * Sugar (options):
+ *
+ * - `raw` (Boolean) - say that we work with raw stream, if you don't wish to specify
+ *   negative windowBits implicitly.
+ * - `to` (String) - if equal to 'string', then result will be converted
+ *   from utf8 to utf16 (javascript) string. When string output requested,
+ *   chunk length can differ from `chunkSize`, depending on content.
+ *
+ *
+ * ##### Example:
+ *
+ * ```javascript
+ * var pako = require('pako')
+ *   , input = pako.deflate([1,2,3,4,5,6,7,8,9])
+ *   , output;
+ *
+ * try {
+ *   output = pako.inflate(input);
+ * } catch (err)
+ *   console.log(err);
+ * }
+ * ```
+ **/
+function inflate(input, options) {
+  var inflator = new Inflate(options);
+
+  inflator.push(input, true);
+
+  // That will never happens, if you don't cheat with options :)
+  if (inflator.err) { throw inflator.msg || msg[inflator.err]; }
+
+  return inflator.result;
+}
+
+
+/**
+ * inflateRaw(data[, options]) -> Uint8Array|Array|String
+ * - data (Uint8Array|Array|String): input data to decompress.
+ * - options (Object): zlib inflate options.
+ *
+ * The same as [[inflate]], but creates raw data, without wrapper
+ * (header and adler32 crc).
+ **/
+function inflateRaw(input, options) {
+  options = options || {};
+  options.raw = true;
+  return inflate(input, options);
+}
+
+
+/**
+ * ungzip(data[, options]) -> Uint8Array|Array|String
+ * - data (Uint8Array|Array|String): input data to decompress.
+ * - options (Object): zlib inflate options.
+ *
+ * Just shortcut to [[inflate]], because it autodetects format
+ * by header.content. Done for convenience.
+ **/
+
+
+exports.Inflate = Inflate;
+exports.inflate = inflate;
+exports.inflateRaw = inflateRaw;
+exports.ungzip  = inflate;
+
+},{"./utils/common":62,"./utils/strings":63,"./zlib/constants":65,"./zlib/gzheader":68,"./zlib/inflate":70,"./zlib/messages":72,"./zlib/zstream":74}],62:[function(require,module,exports){
+'use strict';
+
+
+var TYPED_OK =  (typeof Uint8Array !== 'undefined') &&
+                (typeof Uint16Array !== 'undefined') &&
+                (typeof Int32Array !== 'undefined');
+
+
+exports.assign = function (obj /*from1, from2, from3, ...*/) {
+  var sources = Array.prototype.slice.call(arguments, 1);
+  while (sources.length) {
+    var source = sources.shift();
+    if (!source) { continue; }
+
+    if (typeof source !== 'object') {
+      throw new TypeError(source + 'must be non-object');
+    }
+
+    for (var p in source) {
+      if (source.hasOwnProperty(p)) {
+        obj[p] = source[p];
+      }
+    }
+  }
+
+  return obj;
+};
+
+
+// reduce buffer size, avoiding mem copy
+exports.shrinkBuf = function (buf, size) {
+  if (buf.length === size) { return buf; }
+  if (buf.subarray) { return buf.subarray(0, size); }
+  buf.length = size;
+  return buf;
+};
+
+
+var fnTyped = {
+  arraySet: function (dest, src, src_offs, len, dest_offs) {
+    if (src.subarray && dest.subarray) {
+      dest.set(src.subarray(src_offs, src_offs + len), dest_offs);
+      return;
+    }
+    // Fallback to ordinary array
+    for (var i = 0; i < len; i++) {
+      dest[dest_offs + i] = src[src_offs + i];
+    }
+  },
+  // Join array of chunks to single array.
+  flattenChunks: function (chunks) {
+    var i, l, len, pos, chunk, result;
+
+    // calculate data length
+    len = 0;
+    for (i = 0, l = chunks.length; i < l; i++) {
+      len += chunks[i].length;
+    }
+
+    // join chunks
+    result = new Uint8Array(len);
+    pos = 0;
+    for (i = 0, l = chunks.length; i < l; i++) {
+      chunk = chunks[i];
+      result.set(chunk, pos);
+      pos += chunk.length;
+    }
+
+    return result;
+  }
+};
+
+var fnUntyped = {
+  arraySet: function (dest, src, src_offs, len, dest_offs) {
+    for (var i = 0; i < len; i++) {
+      dest[dest_offs + i] = src[src_offs + i];
+    }
+  },
+  // Join array of chunks to single array.
+  flattenChunks: function (chunks) {
+    return [].concat.apply([], chunks);
+  }
+};
+
+
+// Enable/Disable typed arrays use, for testing
+//
+exports.setTyped = function (on) {
+  if (on) {
+    exports.Buf8  = Uint8Array;
+    exports.Buf16 = Uint16Array;
+    exports.Buf32 = Int32Array;
+    exports.assign(exports, fnTyped);
+  } else {
+    exports.Buf8  = Array;
+    exports.Buf16 = Array;
+    exports.Buf32 = Array;
+    exports.assign(exports, fnUntyped);
+  }
+};
+
+exports.setTyped(TYPED_OK);
+
+},{}],63:[function(require,module,exports){
+// String encode/decode helpers
+'use strict';
+
+
+var utils = require('./common');
+
+
+// Quick check if we can use fast array to bin string conversion
+//
+// - apply(Array) can fail on Android 2.2
+// - apply(Uint8Array) can fail on iOS 5.1 Safary
+//
+var STR_APPLY_OK = true;
+var STR_APPLY_UIA_OK = true;
+
+try { String.fromCharCode.apply(null, [ 0 ]); } catch (__) { STR_APPLY_OK = false; }
+try { String.fromCharCode.apply(null, new Uint8Array(1)); } catch (__) { STR_APPLY_UIA_OK = false; }
+
+
+// Table with utf8 lengths (calculated by first byte of sequence)
+// Note, that 5 & 6-byte values and some 4-byte values can not be represented in JS,
+// because max possible codepoint is 0x10ffff
+var _utf8len = new utils.Buf8(256);
+for (var q = 0; q < 256; q++) {
+  _utf8len[q] = (q >= 252 ? 6 : q >= 248 ? 5 : q >= 240 ? 4 : q >= 224 ? 3 : q >= 192 ? 2 : 1);
+}
+_utf8len[254] = _utf8len[254] = 1; // Invalid sequence start
+
+
+// convert string to array (typed, when possible)
+exports.string2buf = function (str) {
+  var buf, c, c2, m_pos, i, str_len = str.length, buf_len = 0;
+
+  // count binary size
+  for (m_pos = 0; m_pos < str_len; m_pos++) {
+    c = str.charCodeAt(m_pos);
+    if ((c & 0xfc00) === 0xd800 && (m_pos + 1 < str_len)) {
+      c2 = str.charCodeAt(m_pos + 1);
+      if ((c2 & 0xfc00) === 0xdc00) {
+        c = 0x10000 + ((c - 0xd800) << 10) + (c2 - 0xdc00);
+        m_pos++;
+      }
+    }
+    buf_len += c < 0x80 ? 1 : c < 0x800 ? 2 : c < 0x10000 ? 3 : 4;
+  }
+
+  // allocate buffer
+  buf = new utils.Buf8(buf_len);
+
+  // convert
+  for (i = 0, m_pos = 0; i < buf_len; m_pos++) {
+    c = str.charCodeAt(m_pos);
+    if ((c & 0xfc00) === 0xd800 && (m_pos + 1 < str_len)) {
+      c2 = str.charCodeAt(m_pos + 1);
+      if ((c2 & 0xfc00) === 0xdc00) {
+        c = 0x10000 + ((c - 0xd800) << 10) + (c2 - 0xdc00);
+        m_pos++;
+      }
+    }
+    if (c < 0x80) {
+      /* one byte */
+      buf[i++] = c;
+    } else if (c < 0x800) {
+      /* two bytes */
+      buf[i++] = 0xC0 | (c >>> 6);
+      buf[i++] = 0x80 | (c & 0x3f);
+    } else if (c < 0x10000) {
+      /* three bytes */
+      buf[i++] = 0xE0 | (c >>> 12);
+      buf[i++] = 0x80 | (c >>> 6 & 0x3f);
+      buf[i++] = 0x80 | (c & 0x3f);
+    } else {
+      /* four bytes */
+      buf[i++] = 0xf0 | (c >>> 18);
+      buf[i++] = 0x80 | (c >>> 12 & 0x3f);
+      buf[i++] = 0x80 | (c >>> 6 & 0x3f);
+      buf[i++] = 0x80 | (c & 0x3f);
+    }
+  }
+
+  return buf;
+};
+
+// Helper (used in 2 places)
+function buf2binstring(buf, len) {
+  // use fallback for big arrays to avoid stack overflow
+  if (len < 65537) {
+    if ((buf.subarray && STR_APPLY_UIA_OK) || (!buf.subarray && STR_APPLY_OK)) {
+      return String.fromCharCode.apply(null, utils.shrinkBuf(buf, len));
+    }
+  }
+
+  var result = '';
+  for (var i = 0; i < len; i++) {
+    result += String.fromCharCode(buf[i]);
+  }
+  return result;
+}
+
+
+// Convert byte array to binary string
+exports.buf2binstring = function (buf) {
+  return buf2binstring(buf, buf.length);
+};
+
+
+// Convert binary string (typed, when possible)
+exports.binstring2buf = function (str) {
+  var buf = new utils.Buf8(str.length);
+  for (var i = 0, len = buf.length; i < len; i++) {
+    buf[i] = str.charCodeAt(i);
+  }
+  return buf;
+};
+
+
+// convert array to string
+exports.buf2string = function (buf, max) {
+  var i, out, c, c_len;
+  var len = max || buf.length;
+
+  // Reserve max possible length (2 words per char)
+  // NB: by unknown reasons, Array is significantly faster for
+  //     String.fromCharCode.apply than Uint16Array.
+  var utf16buf = new Array(len * 2);
+
+  for (out = 0, i = 0; i < len;) {
+    c = buf[i++];
+    // quick process ascii
+    if (c < 0x80) { utf16buf[out++] = c; continue; }
+
+    c_len = _utf8len[c];
+    // skip 5 & 6 byte codes
+    if (c_len > 4) { utf16buf[out++] = 0xfffd; i += c_len - 1; continue; }
+
+    // apply mask on first byte
+    c &= c_len === 2 ? 0x1f : c_len === 3 ? 0x0f : 0x07;
+    // join the rest
+    while (c_len > 1 && i < len) {
+      c = (c << 6) | (buf[i++] & 0x3f);
+      c_len--;
+    }
+
+    // terminated by end of string?
+    if (c_len > 1) { utf16buf[out++] = 0xfffd; continue; }
+
+    if (c < 0x10000) {
+      utf16buf[out++] = c;
+    } else {
+      c -= 0x10000;
+      utf16buf[out++] = 0xd800 | ((c >> 10) & 0x3ff);
+      utf16buf[out++] = 0xdc00 | (c & 0x3ff);
+    }
+  }
+
+  return buf2binstring(utf16buf, out);
+};
+
+
+// Calculate max possible position in utf8 buffer,
+// that will not break sequence. If that's not possible
+// - (very small limits) return max size as is.
+//
+// buf[] - utf8 bytes array
+// max   - length limit (mandatory);
+exports.utf8border = function (buf, max) {
+  var pos;
+
+  max = max || buf.length;
+  if (max > buf.length) { max = buf.length; }
+
+  // go back from last position, until start of sequence found
+  pos = max - 1;
+  while (pos >= 0 && (buf[pos] & 0xC0) === 0x80) { pos--; }
+
+  // Fuckup - very small and broken sequence,
+  // return max, because we should return something anyway.
+  if (pos < 0) { return max; }
+
+  // If we came to start of buffer - that means vuffer is too small,
+  // return max too.
+  if (pos === 0) { return max; }
+
+  return (pos + _utf8len[buf[pos]] > max) ? pos : max;
+};
+
+},{"./common":62}],64:[function(require,module,exports){
+'use strict';
+
+// Note: adler32 takes 12% for level 0 and 2% for level 6.
+// It doesn't worth to make additional optimizationa as in original.
+// Small size is preferable.
+
+// (C) 1995-2013 Jean-loup Gailly and Mark Adler
+// (C) 2014-2017 Vitaly Puzrin and Andrey Tupitsin
+//
+// This software is provided 'as-is', without any express or implied
+// warranty. In no event will the authors be held liable for any damages
+// arising from the use of this software.
+//
+// Permission is granted to anyone to use this software for any purpose,
+// including commercial applications, and to alter it and redistribute it
+// freely, subject to the following restrictions:
+//
+// 1. The origin of this software must not be misrepresented; you must not
+//   claim that you wrote the original software. If you use this software
+//   in a product, an acknowledgment in the product documentation would be
+//   appreciated but is not required.
+// 2. Altered source versions must be plainly marked as such, and must not be
+//   misrepresented as being the original software.
+// 3. This notice may not be removed or altered from any source distribution.
+
+function adler32(adler, buf, len, pos) {
+  var s1 = (adler & 0xffff) |0,
+      s2 = ((adler >>> 16) & 0xffff) |0,
+      n = 0;
+
+  while (len !== 0) {
+    // Set limit ~ twice less than 5552, to keep
+    // s2 in 31-bits, because we force signed ints.
+    // in other case %= will fail.
+    n = len > 2000 ? 2000 : len;
+    len -= n;
+
+    do {
+      s1 = (s1 + buf[pos++]) |0;
+      s2 = (s2 + s1) |0;
+    } while (--n);
+
+    s1 %= 65521;
+    s2 %= 65521;
+  }
+
+  return (s1 | (s2 << 16)) |0;
+}
+
+
+module.exports = adler32;
+
+},{}],65:[function(require,module,exports){
+'use strict';
+
+// (C) 1995-2013 Jean-loup Gailly and Mark Adler
+// (C) 2014-2017 Vitaly Puzrin and Andrey Tupitsin
+//
+// This software is provided 'as-is', without any express or implied
+// warranty. In no event will the authors be held liable for any damages
+// arising from the use of this software.
+//
+// Permission is granted to anyone to use this software for any purpose,
+// including commercial applications, and to alter it and redistribute it
+// freely, subject to the following restrictions:
+//
+// 1. The origin of this software must not be misrepresented; you must not
+//   claim that you wrote the original software. If you use this software
+//   in a product, an acknowledgment in the product documentation would be
+//   appreciated but is not required.
+// 2. Altered source versions must be plainly marked as such, and must not be
+//   misrepresented as being the original software.
+// 3. This notice may not be removed or altered from any source distribution.
+
+module.exports = {
+
+  /* Allowed flush values; see deflate() and inflate() below for details */
+  Z_NO_FLUSH:         0,
+  Z_PARTIAL_FLUSH:    1,
+  Z_SYNC_FLUSH:       2,
+  Z_FULL_FLUSH:       3,
+  Z_FINISH:           4,
+  Z_BLOCK:            5,
+  Z_TREES:            6,
+
+  /* Return codes for the compression/decompression functions. Negative values
+  * are errors, positive values are used for special but normal events.
+  */
+  Z_OK:               0,
+  Z_STREAM_END:       1,
+  Z_NEED_DICT:        2,
+  Z_ERRNO:           -1,
+  Z_STREAM_ERROR:    -2,
+  Z_DATA_ERROR:      -3,
+  //Z_MEM_ERROR:     -4,
+  Z_BUF_ERROR:       -5,
+  //Z_VERSION_ERROR: -6,
+
+  /* compression levels */
+  Z_NO_COMPRESSION:         0,
+  Z_BEST_SPEED:             1,
+  Z_BEST_COMPRESSION:       9,
+  Z_DEFAULT_COMPRESSION:   -1,
+
+
+  Z_FILTERED:               1,
+  Z_HUFFMAN_ONLY:           2,
+  Z_RLE:                    3,
+  Z_FIXED:                  4,
+  Z_DEFAULT_STRATEGY:       0,
+
+  /* Possible values of the data_type field (though see inflate()) */
+  Z_BINARY:                 0,
+  Z_TEXT:                   1,
+  //Z_ASCII:                1, // = Z_TEXT (deprecated)
+  Z_UNKNOWN:                2,
+
+  /* The deflate compression method */
+  Z_DEFLATED:               8
+  //Z_NULL:                 null // Use -1 or null inline, depending on var type
+};
+
+},{}],66:[function(require,module,exports){
+'use strict';
+
+// Note: we can't get significant speed boost here.
+// So write code to minimize size - no pregenerated tables
+// and array tools dependencies.
+
+// (C) 1995-2013 Jean-loup Gailly and Mark Adler
+// (C) 2014-2017 Vitaly Puzrin and Andrey Tupitsin
+//
+// This software is provided 'as-is', without any express or implied
+// warranty. In no event will the authors be held liable for any damages
+// arising from the use of this software.
+//
+// Permission is granted to anyone to use this software for any purpose,
+// including commercial applications, and to alter it and redistribute it
+// freely, subject to the following restrictions:
+//
+// 1. The origin of this software must not be misrepresented; you must not
+//   claim that you wrote the original software. If you use this software
+//   in a product, an acknowledgment in the product documentation would be
+//   appreciated but is not required.
+// 2. Altered source versions must be plainly marked as such, and must not be
+//   misrepresented as being the original software.
+// 3. This notice may not be removed or altered from any source distribution.
+
+// Use ordinary array, since untyped makes no boost here
+function makeTable() {
+  var c, table = [];
+
+  for (var n = 0; n < 256; n++) {
+    c = n;
+    for (var k = 0; k < 8; k++) {
+      c = ((c & 1) ? (0xEDB88320 ^ (c >>> 1)) : (c >>> 1));
+    }
+    table[n] = c;
+  }
+
+  return table;
+}
+
+// Create table on load. Just 255 signed longs. Not a problem.
+var crcTable = makeTable();
+
+
+function crc32(crc, buf, len, pos) {
+  var t = crcTable,
+      end = pos + len;
+
+  crc ^= -1;
+
+  for (var i = pos; i < end; i++) {
+    crc = (crc >>> 8) ^ t[(crc ^ buf[i]) & 0xFF];
+  }
+
+  return (crc ^ (-1)); // >>> 0;
+}
+
+
+module.exports = crc32;
+
+},{}],67:[function(require,module,exports){
+'use strict';
+
+// (C) 1995-2013 Jean-loup Gailly and Mark Adler
+// (C) 2014-2017 Vitaly Puzrin and Andrey Tupitsin
+//
+// This software is provided 'as-is', without any express or implied
+// warranty. In no event will the authors be held liable for any damages
+// arising from the use of this software.
+//
+// Permission is granted to anyone to use this software for any purpose,
+// including commercial applications, and to alter it and redistribute it
+// freely, subject to the following restrictions:
+//
+// 1. The origin of this software must not be misrepresented; you must not
+//   claim that you wrote the original software. If you use this software
+//   in a product, an acknowledgment in the product documentation would be
+//   appreciated but is not required.
+// 2. Altered source versions must be plainly marked as such, and must not be
+//   misrepresented as being the original software.
+// 3. This notice may not be removed or altered from any source distribution.
+
+var utils   = require('../utils/common');
+var trees   = require('./trees');
+var adler32 = require('./adler32');
+var crc32   = require('./crc32');
+var msg     = require('./messages');
+
+/* Public constants ==========================================================*/
+/* ===========================================================================*/
+
+
+/* Allowed flush values; see deflate() and inflate() below for details */
+var Z_NO_FLUSH      = 0;
+var Z_PARTIAL_FLUSH = 1;
+//var Z_SYNC_FLUSH    = 2;
+var Z_FULL_FLUSH    = 3;
+var Z_FINISH        = 4;
+var Z_BLOCK         = 5;
+//var Z_TREES         = 6;
+
+
+/* Return codes for the compression/decompression functions. Negative values
+ * are errors, positive values are used for special but normal events.
+ */
+var Z_OK            = 0;
+var Z_STREAM_END    = 1;
+//var Z_NEED_DICT     = 2;
+//var Z_ERRNO         = -1;
+var Z_STREAM_ERROR  = -2;
+var Z_DATA_ERROR    = -3;
+//var Z_MEM_ERROR     = -4;
+var Z_BUF_ERROR     = -5;
+//var Z_VERSION_ERROR = -6;
+
+
+/* compression levels */
+//var Z_NO_COMPRESSION      = 0;
+//var Z_BEST_SPEED          = 1;
+//var Z_BEST_COMPRESSION    = 9;
+var Z_DEFAULT_COMPRESSION = -1;
+
+
+var Z_FILTERED            = 1;
+var Z_HUFFMAN_ONLY        = 2;
+var Z_RLE                 = 3;
+var Z_FIXED               = 4;
+var Z_DEFAULT_STRATEGY    = 0;
+
+/* Possible values of the data_type field (though see inflate()) */
+//var Z_BINARY              = 0;
+//var Z_TEXT                = 1;
+//var Z_ASCII               = 1; // = Z_TEXT
+var Z_UNKNOWN             = 2;
+
+
+/* The deflate compression method */
+var Z_DEFLATED  = 8;
+
+/*============================================================================*/
+
+
+var MAX_MEM_LEVEL = 9;
+/* Maximum value for memLevel in deflateInit2 */
+var MAX_WBITS = 15;
+/* 32K LZ77 window */
+var DEF_MEM_LEVEL = 8;
+
+
+var LENGTH_CODES  = 29;
+/* number of length codes, not counting the special END_BLOCK code */
+var LITERALS      = 256;
+/* number of literal bytes 0..255 */
+var L_CODES       = LITERALS + 1 + LENGTH_CODES;
+/* number of Literal or Length codes, including the END_BLOCK code */
+var D_CODES       = 30;
+/* number of distance codes */
+var BL_CODES      = 19;
+/* number of codes used to transfer the bit lengths */
+var HEAP_SIZE     = 2 * L_CODES + 1;
+/* maximum heap size */
+var MAX_BITS  = 15;
+/* All codes must not exceed MAX_BITS bits */
+
+var MIN_MATCH = 3;
+var MAX_MATCH = 258;
+var MIN_LOOKAHEAD = (MAX_MATCH + MIN_MATCH + 1);
+
+var PRESET_DICT = 0x20;
+
+var INIT_STATE = 42;
+var EXTRA_STATE = 69;
+var NAME_STATE = 73;
+var COMMENT_STATE = 91;
+var HCRC_STATE = 103;
+var BUSY_STATE = 113;
+var FINISH_STATE = 666;
+
+var BS_NEED_MORE      = 1; /* block not completed, need more input or more output */
+var BS_BLOCK_DONE     = 2; /* block flush performed */
+var BS_FINISH_STARTED = 3; /* finish started, need only more output at next deflate */
+var BS_FINISH_DONE    = 4; /* finish done, accept no more input or output */
+
+var OS_CODE = 0x03; // Unix :) . Don't detect, use this default.
+
+function err(strm, errorCode) {
+  strm.msg = msg[errorCode];
+  return errorCode;
+}
+
+function rank(f) {
+  return ((f) << 1) - ((f) > 4 ? 9 : 0);
+}
+
+function zero(buf) { var len = buf.length; while (--len >= 0) { buf[len] = 0; } }
+
+
+/* =========================================================================
+ * Flush as much pending output as possible. All deflate() output goes
+ * through this function so some applications may wish to modify it
+ * to avoid allocating a large strm->output buffer and copying into it.
+ * (See also read_buf()).
+ */
+function flush_pending(strm) {
+  var s = strm.state;
+
+  //_tr_flush_bits(s);
+  var len = s.pending;
+  if (len > strm.avail_out) {
+    len = strm.avail_out;
+  }
+  if (len === 0) { return; }
+
+  utils.arraySet(strm.output, s.pending_buf, s.pending_out, len, strm.next_out);
+  strm.next_out += len;
+  s.pending_out += len;
+  strm.total_out += len;
+  strm.avail_out -= len;
+  s.pending -= len;
+  if (s.pending === 0) {
+    s.pending_out = 0;
+  }
+}
+
+
+function flush_block_only(s, last) {
+  trees._tr_flush_block(s, (s.block_start >= 0 ? s.block_start : -1), s.strstart - s.block_start, last);
+  s.block_start = s.strstart;
+  flush_pending(s.strm);
+}
+
+
+function put_byte(s, b) {
+  s.pending_buf[s.pending++] = b;
+}
+
+
+/* =========================================================================
+ * Put a short in the pending buffer. The 16-bit value is put in MSB order.
+ * IN assertion: the stream state is correct and there is enough room in
+ * pending_buf.
+ */
+function putShortMSB(s, b) {
+//  put_byte(s, (Byte)(b >> 8));
+//  put_byte(s, (Byte)(b & 0xff));
+  s.pending_buf[s.pending++] = (b >>> 8) & 0xff;
+  s.pending_buf[s.pending++] = b & 0xff;
+}
+
+
+/* ===========================================================================
+ * Read a new buffer from the current input stream, update the adler32
+ * and total number of bytes read.  All deflate() input goes through
+ * this function so some applications may wish to modify it to avoid
+ * allocating a large strm->input buffer and copying from it.
+ * (See also flush_pending()).
+ */
+function read_buf(strm, buf, start, size) {
+  var len = strm.avail_in;
+
+  if (len > size) { len = size; }
+  if (len === 0) { return 0; }
+
+  strm.avail_in -= len;
+
+  // zmemcpy(buf, strm->next_in, len);
+  utils.arraySet(buf, strm.input, strm.next_in, len, start);
+  if (strm.state.wrap === 1) {
+    strm.adler = adler32(strm.adler, buf, len, start);
+  }
+
+  else if (strm.state.wrap === 2) {
+    strm.adler = crc32(strm.adler, buf, len, start);
+  }
+
+  strm.next_in += len;
+  strm.total_in += len;
+
+  return len;
+}
+
+
+/* ===========================================================================
+ * Set match_start to the longest match starting at the given string and
+ * return its length. Matches shorter or equal to prev_length are discarded,
+ * in which case the result is equal to prev_length and match_start is
+ * garbage.
+ * IN assertions: cur_match is the head of the hash chain for the current
+ *   string (strstart) and its distance is <= MAX_DIST, and prev_length >= 1
+ * OUT assertion: the match length is not greater than s->lookahead.
+ */
+function longest_match(s, cur_match) {
+  var chain_length = s.max_chain_length;      /* max hash chain length */
+  var scan = s.strstart; /* current string */
+  var match;                       /* matched string */
+  var len;                           /* length of current match */
+  var best_len = s.prev_length;              /* best match length so far */
+  var nice_match = s.nice_match;             /* stop if match long enough */
+  var limit = (s.strstart > (s.w_size - MIN_LOOKAHEAD)) ?
+      s.strstart - (s.w_size - MIN_LOOKAHEAD) : 0/*NIL*/;
+
+  var _win = s.window; // shortcut
+
+  var wmask = s.w_mask;
+  var prev  = s.prev;
+
+  /* Stop when cur_match becomes <= limit. To simplify the code,
+   * we prevent matches with the string of window index 0.
+   */
+
+  var strend = s.strstart + MAX_MATCH;
+  var scan_end1  = _win[scan + best_len - 1];
+  var scan_end   = _win[scan + best_len];
+
+  /* The code is optimized for HASH_BITS >= 8 and MAX_MATCH-2 multiple of 16.
+   * It is easy to get rid of this optimization if necessary.
+   */
+  // Assert(s->hash_bits >= 8 && MAX_MATCH == 258, "Code too clever");
+
+  /* Do not waste too much time if we already have a good match: */
+  if (s.prev_length >= s.good_match) {
+    chain_length >>= 2;
+  }
+  /* Do not look for matches beyond the end of the input. This is necessary
+   * to make deflate deterministic.
+   */
+  if (nice_match > s.lookahead) { nice_match = s.lookahead; }
+
+  // Assert((ulg)s->strstart <= s->window_size-MIN_LOOKAHEAD, "need lookahead");
+
+  do {
+    // Assert(cur_match < s->strstart, "no future");
+    match = cur_match;
+
+    /* Skip to next match if the match length cannot increase
+     * or if the match length is less than 2.  Note that the checks below
+     * for insufficient lookahead only occur occasionally for performance
+     * reasons.  Therefore uninitialized memory will be accessed, and
+     * conditional jumps will be made that depend on those values.
+     * However the length of the match is limited to the lookahead, so
+     * the output of deflate is not affected by the uninitialized values.
+     */
+
+    if (_win[match + best_len]     !== scan_end  ||
+        _win[match + best_len - 1] !== scan_end1 ||
+        _win[match]                !== _win[scan] ||
+        _win[++match]              !== _win[scan + 1]) {
+      continue;
+    }
+
+    /* The check at best_len-1 can be removed because it will be made
+     * again later. (This heuristic is not always a win.)
+     * It is not necessary to compare scan[2] and match[2] since they
+     * are always equal when the other bytes match, given that
+     * the hash keys are equal and that HASH_BITS >= 8.
+     */
+    scan += 2;
+    match++;
+    // Assert(*scan == *match, "match[2]?");
+
+    /* We check for insufficient lookahead only every 8th comparison;
+     * the 256th check will be made at strstart+258.
+     */
+    do {
+      /*jshint noempty:false*/
+    } while (_win[++scan] === _win[++match] && _win[++scan] === _win[++match] &&
+             _win[++scan] === _win[++match] && _win[++scan] === _win[++match] &&
+             _win[++scan] === _win[++match] && _win[++scan] === _win[++match] &&
+             _win[++scan] === _win[++match] && _win[++scan] === _win[++match] &&
+             scan < strend);
+
+    // Assert(scan <= s->window+(unsigned)(s->window_size-1), "wild scan");
+
+    len = MAX_MATCH - (strend - scan);
+    scan = strend - MAX_MATCH;
+
+    if (len > best_len) {
+      s.match_start = cur_match;
+      best_len = len;
+      if (len >= nice_match) {
+        break;
+      }
+      scan_end1  = _win[scan + best_len - 1];
+      scan_end   = _win[scan + best_len];
+    }
+  } while ((cur_match = prev[cur_match & wmask]) > limit && --chain_length !== 0);
+
+  if (best_len <= s.lookahead) {
+    return best_len;
+  }
+  return s.lookahead;
+}
+
+
+/* ===========================================================================
+ * Fill the window when the lookahead becomes insufficient.
+ * Updates strstart and lookahead.
+ *
+ * IN assertion: lookahead < MIN_LOOKAHEAD
+ * OUT assertions: strstart <= window_size-MIN_LOOKAHEAD
+ *    At least one byte has been read, or avail_in == 0; reads are
+ *    performed for at least two bytes (required for the zip translate_eol
+ *    option -- not supported here).
+ */
+function fill_window(s) {
+  var _w_size = s.w_size;
+  var p, n, m, more, str;
+
+  //Assert(s->lookahead < MIN_LOOKAHEAD, "already enough lookahead");
+
+  do {
+    more = s.window_size - s.lookahead - s.strstart;
+
+    // JS ints have 32 bit, block below not needed
+    /* Deal with !@#$% 64K limit: */
+    //if (sizeof(int) <= 2) {
+    //    if (more == 0 && s->strstart == 0 && s->lookahead == 0) {
+    //        more = wsize;
+    //
+    //  } else if (more == (unsigned)(-1)) {
+    //        /* Very unlikely, but possible on 16 bit machine if
+    //         * strstart == 0 && lookahead == 1 (input done a byte at time)
+    //         */
+    //        more--;
+    //    }
+    //}
+
+
+    /* If the window is almost full and there is insufficient lookahead,
+     * move the upper half to the lower one to make room in the upper half.
+     */
+    if (s.strstart >= _w_size + (_w_size - MIN_LOOKAHEAD)) {
+
+      utils.arraySet(s.window, s.window, _w_size, _w_size, 0);
+      s.match_start -= _w_size;
+      s.strstart -= _w_size;
+      /* we now have strstart >= MAX_DIST */
+      s.block_start -= _w_size;
+
+      /* Slide the hash table (could be avoided with 32 bit values
+       at the expense of memory usage). We slide even when level == 0
+       to keep the hash table consistent if we switch back to level > 0
+       later. (Using level 0 permanently is not an optimal usage of
+       zlib, so we don't care about this pathological case.)
+       */
+
+      n = s.hash_size;
+      p = n;
+      do {
+        m = s.head[--p];
+        s.head[p] = (m >= _w_size ? m - _w_size : 0);
+      } while (--n);
+
+      n = _w_size;
+      p = n;
+      do {
+        m = s.prev[--p];
+        s.prev[p] = (m >= _w_size ? m - _w_size : 0);
+        /* If n is not on any hash chain, prev[n] is garbage but
+         * its value will never be used.
+         */
+      } while (--n);
+
+      more += _w_size;
+    }
+    if (s.strm.avail_in === 0) {
+      break;
+    }
+
+    /* If there was no sliding:
+     *    strstart <= WSIZE+MAX_DIST-1 && lookahead <= MIN_LOOKAHEAD - 1 &&
+     *    more == window_size - lookahead - strstart
+     * => more >= window_size - (MIN_LOOKAHEAD-1 + WSIZE + MAX_DIST-1)
+     * => more >= window_size - 2*WSIZE + 2
+     * In the BIG_MEM or MMAP case (not yet supported),
+     *   window_size == input_size + MIN_LOOKAHEAD  &&
+     *   strstart + s->lookahead <= input_size => more >= MIN_LOOKAHEAD.
+     * Otherwise, window_size == 2*WSIZE so more >= 2.
+     * If there was sliding, more >= WSIZE. So in all cases, more >= 2.
+     */
+    //Assert(more >= 2, "more < 2");
+    n = read_buf(s.strm, s.window, s.strstart + s.lookahead, more);
+    s.lookahead += n;
+
+    /* Initialize the hash value now that we have some input: */
+    if (s.lookahead + s.insert >= MIN_MATCH) {
+      str = s.strstart - s.insert;
+      s.ins_h = s.window[str];
+
+      /* UPDATE_HASH(s, s->ins_h, s->window[str + 1]); */
+      s.ins_h = ((s.ins_h << s.hash_shift) ^ s.window[str + 1]) & s.hash_mask;
+//#if MIN_MATCH != 3
+//        Call update_hash() MIN_MATCH-3 more times
+//#endif
+      while (s.insert) {
+        /* UPDATE_HASH(s, s->ins_h, s->window[str + MIN_MATCH-1]); */
+        s.ins_h = ((s.ins_h << s.hash_shift) ^ s.window[str + MIN_MATCH - 1]) & s.hash_mask;
+
+        s.prev[str & s.w_mask] = s.head[s.ins_h];
+        s.head[s.ins_h] = str;
+        str++;
+        s.insert--;
+        if (s.lookahead + s.insert < MIN_MATCH) {
+          break;
+        }
+      }
+    }
+    /* If the whole input has less than MIN_MATCH bytes, ins_h is garbage,
+     * but this is not important since only literal bytes will be emitted.
+     */
+
+  } while (s.lookahead < MIN_LOOKAHEAD && s.strm.avail_in !== 0);
+
+  /* If the WIN_INIT bytes after the end of the current data have never been
+   * written, then zero those bytes in order to avoid memory check reports of
+   * the use of uninitialized (or uninitialised as Julian writes) bytes by
+   * the longest match routines.  Update the high water mark for the next
+   * time through here.  WIN_INIT is set to MAX_MATCH since the longest match
+   * routines allow scanning to strstart + MAX_MATCH, ignoring lookahead.
+   */
+//  if (s.high_water < s.window_size) {
+//    var curr = s.strstart + s.lookahead;
+//    var init = 0;
+//
+//    if (s.high_water < curr) {
+//      /* Previous high water mark below current data -- zero WIN_INIT
+//       * bytes or up to end of window, whichever is less.
+//       */
+//      init = s.window_size - curr;
+//      if (init > WIN_INIT)
+//        init = WIN_INIT;
+//      zmemzero(s->window + curr, (unsigned)init);
+//      s->high_water = curr + init;
+//    }
+//    else if (s->high_water < (ulg)curr + WIN_INIT) {
+//      /* High water mark at or above current data, but below current data
+//       * plus WIN_INIT -- zero out to current data plus WIN_INIT, or up
+//       * to end of window, whichever is less.
+//       */
+//      init = (ulg)curr + WIN_INIT - s->high_water;
+//      if (init > s->window_size - s->high_water)
+//        init = s->window_size - s->high_water;
+//      zmemzero(s->window + s->high_water, (unsigned)init);
+//      s->high_water += init;
+//    }
+//  }
+//
+//  Assert((ulg)s->strstart <= s->window_size - MIN_LOOKAHEAD,
+//    "not enough room for search");
+}
+
+/* ===========================================================================
+ * Copy without compression as much as possible from the input stream, return
+ * the current block state.
+ * This function does not insert new strings in the dictionary since
+ * uncompressible data is probably not useful. This function is used
+ * only for the level=0 compression option.
+ * NOTE: this function should be optimized to avoid extra copying from
+ * window to pending_buf.
+ */
+function deflate_stored(s, flush) {
+  /* Stored blocks are limited to 0xffff bytes, pending_buf is limited
+   * to pending_buf_size, and each stored block has a 5 byte header:
+   */
+  var max_block_size = 0xffff;
+
+  if (max_block_size > s.pending_buf_size - 5) {
+    max_block_size = s.pending_buf_size - 5;
+  }
+
+  /* Copy as much as possible from input to output: */
+  for (;;) {
+    /* Fill the window as much as possible: */
+    if (s.lookahead <= 1) {
+
+      //Assert(s->strstart < s->w_size+MAX_DIST(s) ||
+      //  s->block_start >= (long)s->w_size, "slide too late");
+//      if (!(s.strstart < s.w_size + (s.w_size - MIN_LOOKAHEAD) ||
+//        s.block_start >= s.w_size)) {
+//        throw  new Error("slide too late");
+//      }
+
+      fill_window(s);
+      if (s.lookahead === 0 && flush === Z_NO_FLUSH) {
+        return BS_NEED_MORE;
+      }
+
+      if (s.lookahead === 0) {
+        break;
+      }
+      /* flush the current block */
+    }
+    //Assert(s->block_start >= 0L, "block gone");
+//    if (s.block_start < 0) throw new Error("block gone");
+
+    s.strstart += s.lookahead;
+    s.lookahead = 0;
+
+    /* Emit a stored block if pending_buf will be full: */
+    var max_start = s.block_start + max_block_size;
+
+    if (s.strstart === 0 || s.strstart >= max_start) {
+      /* strstart == 0 is possible when wraparound on 16-bit machine */
+      s.lookahead = s.strstart - max_start;
+      s.strstart = max_start;
+      /*** FLUSH_BLOCK(s, 0); ***/
+      flush_block_only(s, false);
+      if (s.strm.avail_out === 0) {
+        return BS_NEED_MORE;
+      }
+      /***/
+
+
+    }
+    /* Flush if we may have to slide, otherwise block_start may become
+     * negative and the data will be gone:
+     */
+    if (s.strstart - s.block_start >= (s.w_size - MIN_LOOKAHEAD)) {
+      /*** FLUSH_BLOCK(s, 0); ***/
+      flush_block_only(s, false);
+      if (s.strm.avail_out === 0) {
+        return BS_NEED_MORE;
+      }
+      /***/
+    }
+  }
+
+  s.insert = 0;
+
+  if (flush === Z_FINISH) {
+    /*** FLUSH_BLOCK(s, 1); ***/
+    flush_block_only(s, true);
+    if (s.strm.avail_out === 0) {
+      return BS_FINISH_STARTED;
+    }
+    /***/
+    return BS_FINISH_DONE;
+  }
+
+  if (s.strstart > s.block_start) {
+    /*** FLUSH_BLOCK(s, 0); ***/
+    flush_block_only(s, false);
+    if (s.strm.avail_out === 0) {
+      return BS_NEED_MORE;
+    }
+    /***/
+  }
+
+  return BS_NEED_MORE;
+}
+
+/* ===========================================================================
+ * Compress as much as possible from the input stream, return the current
+ * block state.
+ * This function does not perform lazy evaluation of matches and inserts
+ * new strings in the dictionary only for unmatched strings or for short
+ * matches. It is used only for the fast compression options.
+ */
+function deflate_fast(s, flush) {
+  var hash_head;        /* head of the hash chain */
+  var bflush;           /* set if current block must be flushed */
+
+  for (;;) {
+    /* Make sure that we always have enough lookahead, except
+     * at the end of the input file. We need MAX_MATCH bytes
+     * for the next match, plus MIN_MATCH bytes to insert the
+     * string following the next match.
+     */
+    if (s.lookahead < MIN_LOOKAHEAD) {
+      fill_window(s);
+      if (s.lookahead < MIN_LOOKAHEAD && flush === Z_NO_FLUSH) {
+        return BS_NEED_MORE;
+      }
+      if (s.lookahead === 0) {
+        break; /* flush the current block */
+      }
+    }
+
+    /* Insert the string window[strstart .. strstart+2] in the
+     * dictionary, and set hash_head to the head of the hash chain:
+     */
+    hash_head = 0/*NIL*/;
+    if (s.lookahead >= MIN_MATCH) {
+      /*** INSERT_STRING(s, s.strstart, hash_head); ***/
+      s.ins_h = ((s.ins_h << s.hash_shift) ^ s.window[s.strstart + MIN_MATCH - 1]) & s.hash_mask;
+      hash_head = s.prev[s.strstart & s.w_mask] = s.head[s.ins_h];
+      s.head[s.ins_h] = s.strstart;
+      /***/
+    }
+
+    /* Find the longest match, discarding those <= prev_length.
+     * At this point we have always match_length < MIN_MATCH
+     */
+    if (hash_head !== 0/*NIL*/ && ((s.strstart - hash_head) <= (s.w_size - MIN_LOOKAHEAD))) {
+      /* To simplify the code, we prevent matches with the string
+       * of window index 0 (in particular we have to avoid a match
+       * of the string with itself at the start of the input file).
+       */
+      s.match_length = longest_match(s, hash_head);
+      /* longest_match() sets match_start */
+    }
+    if (s.match_length >= MIN_MATCH) {
+      // check_match(s, s.strstart, s.match_start, s.match_length); // for debug only
+
+      /*** _tr_tally_dist(s, s.strstart - s.match_start,
+                     s.match_length - MIN_MATCH, bflush); ***/
+      bflush = trees._tr_tally(s, s.strstart - s.match_start, s.match_length - MIN_MATCH);
+
+      s.lookahead -= s.match_length;
+
+      /* Insert new strings in the hash table only if the match length
+       * is not too large. This saves time but degrades compression.
+       */
+      if (s.match_length <= s.max_lazy_match/*max_insert_length*/ && s.lookahead >= MIN_MATCH) {
+        s.match_length--; /* string at strstart already in table */
+        do {
+          s.strstart++;
+          /*** INSERT_STRING(s, s.strstart, hash_head); ***/
+          s.ins_h = ((s.ins_h << s.hash_shift) ^ s.window[s.strstart + MIN_MATCH - 1]) & s.hash_mask;
+          hash_head = s.prev[s.strstart & s.w_mask] = s.head[s.ins_h];
+          s.head[s.ins_h] = s.strstart;
+          /***/
+          /* strstart never exceeds WSIZE-MAX_MATCH, so there are
+           * always MIN_MATCH bytes ahead.
+           */
+        } while (--s.match_length !== 0);
+        s.strstart++;
+      } else
+      {
+        s.strstart += s.match_length;
+        s.match_length = 0;
+        s.ins_h = s.window[s.strstart];
+        /* UPDATE_HASH(s, s.ins_h, s.window[s.strstart+1]); */
+        s.ins_h = ((s.ins_h << s.hash_shift) ^ s.window[s.strstart + 1]) & s.hash_mask;
+
+//#if MIN_MATCH != 3
+//                Call UPDATE_HASH() MIN_MATCH-3 more times
+//#endif
+        /* If lookahead < MIN_MATCH, ins_h is garbage, but it does not
+         * matter since it will be recomputed at next deflate call.
+         */
+      }
+    } else {
+      /* No match, output a literal byte */
+      //Tracevv((stderr,"%c", s.window[s.strstart]));
+      /*** _tr_tally_lit(s, s.window[s.strstart], bflush); ***/
+      bflush = trees._tr_tally(s, 0, s.window[s.strstart]);
+
+      s.lookahead--;
+      s.strstart++;
+    }
+    if (bflush) {
+      /*** FLUSH_BLOCK(s, 0); ***/
+      flush_block_only(s, false);
+      if (s.strm.avail_out === 0) {
+        return BS_NEED_MORE;
+      }
+      /***/
+    }
+  }
+  s.insert = ((s.strstart < (MIN_MATCH - 1)) ? s.strstart : MIN_MATCH - 1);
+  if (flush === Z_FINISH) {
+    /*** FLUSH_BLOCK(s, 1); ***/
+    flush_block_only(s, true);
+    if (s.strm.avail_out === 0) {
+      return BS_FINISH_STARTED;
+    }
+    /***/
+    return BS_FINISH_DONE;
+  }
+  if (s.last_lit) {
+    /*** FLUSH_BLOCK(s, 0); ***/
+    flush_block_only(s, false);
+    if (s.strm.avail_out === 0) {
+      return BS_NEED_MORE;
+    }
+    /***/
+  }
+  return BS_BLOCK_DONE;
+}
+
+/* ===========================================================================
+ * Same as above, but achieves better compression. We use a lazy
+ * evaluation for matches: a match is finally adopted only if there is
+ * no better match at the next window position.
+ */
+function deflate_slow(s, flush) {
+  var hash_head;          /* head of hash chain */
+  var bflush;              /* set if current block must be flushed */
+
+  var max_insert;
+
+  /* Process the input block. */
+  for (;;) {
+    /* Make sure that we always have enough lookahead, except
+     * at the end of the input file. We need MAX_MATCH bytes
+     * for the next match, plus MIN_MATCH bytes to insert the
+     * string following the next match.
+     */
+    if (s.lookahead < MIN_LOOKAHEAD) {
+      fill_window(s);
+      if (s.lookahead < MIN_LOOKAHEAD && flush === Z_NO_FLUSH) {
+        return BS_NEED_MORE;
+      }
+      if (s.lookahead === 0) { break; } /* flush the current block */
+    }
+
+    /* Insert the string window[strstart .. strstart+2] in the
+     * dictionary, and set hash_head to the head of the hash chain:
+     */
+    hash_head = 0/*NIL*/;
+    if (s.lookahead >= MIN_MATCH) {
+      /*** INSERT_STRING(s, s.strstart, hash_head); ***/
+      s.ins_h = ((s.ins_h << s.hash_shift) ^ s.window[s.strstart + MIN_MATCH - 1]) & s.hash_mask;
+      hash_head = s.prev[s.strstart & s.w_mask] = s.head[s.ins_h];
+      s.head[s.ins_h] = s.strstart;
+      /***/
+    }
+
+    /* Find the longest match, discarding those <= prev_length.
+     */
+    s.prev_length = s.match_length;
+    s.prev_match = s.match_start;
+    s.match_length = MIN_MATCH - 1;
+
+    if (hash_head !== 0/*NIL*/ && s.prev_length < s.max_lazy_match &&
+        s.strstart - hash_head <= (s.w_size - MIN_LOOKAHEAD)/*MAX_DIST(s)*/) {
+      /* To simplify the code, we prevent matches with the string
+       * of window index 0 (in particular we have to avoid a match
+       * of the string with itself at the start of the input file).
+       */
+      s.match_length = longest_match(s, hash_head);
+      /* longest_match() sets match_start */
+
+      if (s.match_length <= 5 &&
+         (s.strategy === Z_FILTERED || (s.match_length === MIN_MATCH && s.strstart - s.match_start > 4096/*TOO_FAR*/))) {
+
+        /* If prev_match is also MIN_MATCH, match_start is garbage
+         * but we will ignore the current match anyway.
+         */
+        s.match_length = MIN_MATCH - 1;
+      }
+    }
+    /* If there was a match at the previous step and the current
+     * match is not better, output the previous match:
+     */
+    if (s.prev_length >= MIN_MATCH && s.match_length <= s.prev_length) {
+      max_insert = s.strstart + s.lookahead - MIN_MATCH;
+      /* Do not insert strings in hash table beyond this. */
+
+      //check_match(s, s.strstart-1, s.prev_match, s.prev_length);
+
+      /***_tr_tally_dist(s, s.strstart - 1 - s.prev_match,
+                     s.prev_length - MIN_MATCH, bflush);***/
+      bflush = trees._tr_tally(s, s.strstart - 1 - s.prev_match, s.prev_length - MIN_MATCH);
+      /* Insert in hash table all strings up to the end of the match.
+       * strstart-1 and strstart are already inserted. If there is not
+       * enough lookahead, the last two strings are not inserted in
+       * the hash table.
+       */
+      s.lookahead -= s.prev_length - 1;
+      s.prev_length -= 2;
+      do {
+        if (++s.strstart <= max_insert) {
+          /*** INSERT_STRING(s, s.strstart, hash_head); ***/
+          s.ins_h = ((s.ins_h << s.hash_shift) ^ s.window[s.strstart + MIN_MATCH - 1]) & s.hash_mask;
+          hash_head = s.prev[s.strstart & s.w_mask] = s.head[s.ins_h];
+          s.head[s.ins_h] = s.strstart;
+          /***/
+        }
+      } while (--s.prev_length !== 0);
+      s.match_available = 0;
+      s.match_length = MIN_MATCH - 1;
+      s.strstart++;
+
+      if (bflush) {
+        /*** FLUSH_BLOCK(s, 0); ***/
+        flush_block_only(s, false);
+        if (s.strm.avail_out === 0) {
+          return BS_NEED_MORE;
+        }
+        /***/
+      }
+
+    } else if (s.match_available) {
+      /* If there was no match at the previous position, output a
+       * single literal. If there was a match but the current match
+       * is longer, truncate the previous match to a single literal.
+       */
+      //Tracevv((stderr,"%c", s->window[s->strstart-1]));
+      /*** _tr_tally_lit(s, s.window[s.strstart-1], bflush); ***/
+      bflush = trees._tr_tally(s, 0, s.window[s.strstart - 1]);
+
+      if (bflush) {
+        /*** FLUSH_BLOCK_ONLY(s, 0) ***/
+        flush_block_only(s, false);
+        /***/
+      }
+      s.strstart++;
+      s.lookahead--;
+      if (s.strm.avail_out === 0) {
+        return BS_NEED_MORE;
+      }
+    } else {
+      /* There is no previous match to compare with, wait for
+       * the next step to decide.
+       */
+      s.match_available = 1;
+      s.strstart++;
+      s.lookahead--;
+    }
+  }
+  //Assert (flush != Z_NO_FLUSH, "no flush?");
+  if (s.match_available) {
+    //Tracevv((stderr,"%c", s->window[s->strstart-1]));
+    /*** _tr_tally_lit(s, s.window[s.strstart-1], bflush); ***/
+    bflush = trees._tr_tally(s, 0, s.window[s.strstart - 1]);
+
+    s.match_available = 0;
+  }
+  s.insert = s.strstart < MIN_MATCH - 1 ? s.strstart : MIN_MATCH - 1;
+  if (flush === Z_FINISH) {
+    /*** FLUSH_BLOCK(s, 1); ***/
+    flush_block_only(s, true);
+    if (s.strm.avail_out === 0) {
+      return BS_FINISH_STARTED;
+    }
+    /***/
+    return BS_FINISH_DONE;
+  }
+  if (s.last_lit) {
+    /*** FLUSH_BLOCK(s, 0); ***/
+    flush_block_only(s, false);
+    if (s.strm.avail_out === 0) {
+      return BS_NEED_MORE;
+    }
+    /***/
+  }
+
+  return BS_BLOCK_DONE;
+}
+
+
+/* ===========================================================================
+ * For Z_RLE, simply look for runs of bytes, generate matches only of distance
+ * one.  Do not maintain a hash table.  (It will be regenerated if this run of
+ * deflate switches away from Z_RLE.)
+ */
+function deflate_rle(s, flush) {
+  var bflush;            /* set if current block must be flushed */
+  var prev;              /* byte at distance one to match */
+  var scan, strend;      /* scan goes up to strend for length of run */
+
+  var _win = s.window;
+
+  for (;;) {
+    /* Make sure that we always have enough lookahead, except
+     * at the end of the input file. We need MAX_MATCH bytes
+     * for the longest run, plus one for the unrolled loop.
+     */
+    if (s.lookahead <= MAX_MATCH) {
+      fill_window(s);
+      if (s.lookahead <= MAX_MATCH && flush === Z_NO_FLUSH) {
+        return BS_NEED_MORE;
+      }
+      if (s.lookahead === 0) { break; } /* flush the current block */
+    }
+
+    /* See how many times the previous byte repeats */
+    s.match_length = 0;
+    if (s.lookahead >= MIN_MATCH && s.strstart > 0) {
+      scan = s.strstart - 1;
+      prev = _win[scan];
+      if (prev === _win[++scan] && prev === _win[++scan] && prev === _win[++scan]) {
+        strend = s.strstart + MAX_MATCH;
+        do {
+          /*jshint noempty:false*/
+        } while (prev === _win[++scan] && prev === _win[++scan] &&
+                 prev === _win[++scan] && prev === _win[++scan] &&
+                 prev === _win[++scan] && prev === _win[++scan] &&
+                 prev === _win[++scan] && prev === _win[++scan] &&
+                 scan < strend);
+        s.match_length = MAX_MATCH - (strend - scan);
+        if (s.match_length > s.lookahead) {
+          s.match_length = s.lookahead;
+        }
+      }
+      //Assert(scan <= s->window+(uInt)(s->window_size-1), "wild scan");
+    }
+
+    /* Emit match if have run of MIN_MATCH or longer, else emit literal */
+    if (s.match_length >= MIN_MATCH) {
+      //check_match(s, s.strstart, s.strstart - 1, s.match_length);
+
+      /*** _tr_tally_dist(s, 1, s.match_length - MIN_MATCH, bflush); ***/
+      bflush = trees._tr_tally(s, 1, s.match_length - MIN_MATCH);
+
+      s.lookahead -= s.match_length;
+      s.strstart += s.match_length;
+      s.match_length = 0;
+    } else {
+      /* No match, output a literal byte */
+      //Tracevv((stderr,"%c", s->window[s->strstart]));
+      /*** _tr_tally_lit(s, s.window[s.strstart], bflush); ***/
+      bflush = trees._tr_tally(s, 0, s.window[s.strstart]);
+
+      s.lookahead--;
+      s.strstart++;
+    }
+    if (bflush) {
+      /*** FLUSH_BLOCK(s, 0); ***/
+      flush_block_only(s, false);
+      if (s.strm.avail_out === 0) {
+        return BS_NEED_MORE;
+      }
+      /***/
+    }
+  }
+  s.insert = 0;
+  if (flush === Z_FINISH) {
+    /*** FLUSH_BLOCK(s, 1); ***/
+    flush_block_only(s, true);
+    if (s.strm.avail_out === 0) {
+      return BS_FINISH_STARTED;
+    }
+    /***/
+    return BS_FINISH_DONE;
+  }
+  if (s.last_lit) {
+    /*** FLUSH_BLOCK(s, 0); ***/
+    flush_block_only(s, false);
+    if (s.strm.avail_out === 0) {
+      return BS_NEED_MORE;
+    }
+    /***/
+  }
+  return BS_BLOCK_DONE;
+}
+
+/* ===========================================================================
+ * For Z_HUFFMAN_ONLY, do not look for matches.  Do not maintain a hash table.
+ * (It will be regenerated if this run of deflate switches away from Huffman.)
+ */
+function deflate_huff(s, flush) {
+  var bflush;             /* set if current block must be flushed */
+
+  for (;;) {
+    /* Make sure that we have a literal to write. */
+    if (s.lookahead === 0) {
+      fill_window(s);
+      if (s.lookahead === 0) {
+        if (flush === Z_NO_FLUSH) {
+          return BS_NEED_MORE;
+        }
+        break;      /* flush the current block */
+      }
+    }
+
+    /* Output a literal byte */
+    s.match_length = 0;
+    //Tracevv((stderr,"%c", s->window[s->strstart]));
+    /*** _tr_tally_lit(s, s.window[s.strstart], bflush); ***/
+    bflush = trees._tr_tally(s, 0, s.window[s.strstart]);
+    s.lookahead--;
+    s.strstart++;
+    if (bflush) {
+      /*** FLUSH_BLOCK(s, 0); ***/
+      flush_block_only(s, false);
+      if (s.strm.avail_out === 0) {
+        return BS_NEED_MORE;
+      }
+      /***/
+    }
+  }
+  s.insert = 0;
+  if (flush === Z_FINISH) {
+    /*** FLUSH_BLOCK(s, 1); ***/
+    flush_block_only(s, true);
+    if (s.strm.avail_out === 0) {
+      return BS_FINISH_STARTED;
+    }
+    /***/
+    return BS_FINISH_DONE;
+  }
+  if (s.last_lit) {
+    /*** FLUSH_BLOCK(s, 0); ***/
+    flush_block_only(s, false);
+    if (s.strm.avail_out === 0) {
+      return BS_NEED_MORE;
+    }
+    /***/
+  }
+  return BS_BLOCK_DONE;
+}
+
+/* Values for max_lazy_match, good_match and max_chain_length, depending on
+ * the desired pack level (0..9). The values given below have been tuned to
+ * exclude worst case performance for pathological files. Better values may be
+ * found for specific files.
+ */
+function Config(good_length, max_lazy, nice_length, max_chain, func) {
+  this.good_length = good_length;
+  this.max_lazy = max_lazy;
+  this.nice_length = nice_length;
+  this.max_chain = max_chain;
+  this.func = func;
+}
+
+var configuration_table;
+
+configuration_table = [
+  /*      good lazy nice chain */
+  new Config(0, 0, 0, 0, deflate_stored),          /* 0 store only */
+  new Config(4, 4, 8, 4, deflate_fast),            /* 1 max speed, no lazy matches */
+  new Config(4, 5, 16, 8, deflate_fast),           /* 2 */
+  new Config(4, 6, 32, 32, deflate_fast),          /* 3 */
+
+  new Config(4, 4, 16, 16, deflate_slow),          /* 4 lazy matches */
+  new Config(8, 16, 32, 32, deflate_slow),         /* 5 */
+  new Config(8, 16, 128, 128, deflate_slow),       /* 6 */
+  new Config(8, 32, 128, 256, deflate_slow),       /* 7 */
+  new Config(32, 128, 258, 1024, deflate_slow),    /* 8 */
+  new Config(32, 258, 258, 4096, deflate_slow)     /* 9 max compression */
+];
+
+
+/* ===========================================================================
+ * Initialize the "longest match" routines for a new zlib stream
+ */
+function lm_init(s) {
+  s.window_size = 2 * s.w_size;
+
+  /*** CLEAR_HASH(s); ***/
+  zero(s.head); // Fill with NIL (= 0);
+
+  /* Set the default configuration parameters:
+   */
+  s.max_lazy_match = configuration_table[s.level].max_lazy;
+  s.good_match = configuration_table[s.level].good_length;
+  s.nice_match = configuration_table[s.level].nice_length;
+  s.max_chain_length = configuration_table[s.level].max_chain;
+
+  s.strstart = 0;
+  s.block_start = 0;
+  s.lookahead = 0;
+  s.insert = 0;
+  s.match_length = s.prev_length = MIN_MATCH - 1;
+  s.match_available = 0;
+  s.ins_h = 0;
+}
+
+
+function DeflateState() {
+  this.strm = null;            /* pointer back to this zlib stream */
+  this.status = 0;            /* as the name implies */
+  this.pending_buf = null;      /* output still pending */
+  this.pending_buf_size = 0;  /* size of pending_buf */
+  this.pending_out = 0;       /* next pending byte to output to the stream */
+  this.pending = 0;           /* nb of bytes in the pending buffer */
+  this.wrap = 0;              /* bit 0 true for zlib, bit 1 true for gzip */
+  this.gzhead = null;         /* gzip header information to write */
+  this.gzindex = 0;           /* where in extra, name, or comment */
+  this.method = Z_DEFLATED; /* can only be DEFLATED */
+  this.last_flush = -1;   /* value of flush param for previous deflate call */
+
+  this.w_size = 0;  /* LZ77 window size (32K by default) */
+  this.w_bits = 0;  /* log2(w_size)  (8..16) */
+  this.w_mask = 0;  /* w_size - 1 */
+
+  this.window = null;
+  /* Sliding window. Input bytes are read into the second half of the window,
+   * and move to the first half later to keep a dictionary of at least wSize
+   * bytes. With this organization, matches are limited to a distance of
+   * wSize-MAX_MATCH bytes, but this ensures that IO is always
+   * performed with a length multiple of the block size.
+   */
+
+  this.window_size = 0;
+  /* Actual size of window: 2*wSize, except when the user input buffer
+   * is directly used as sliding window.
+   */
+
+  this.prev = null;
+  /* Link to older string with same hash index. To limit the size of this
+   * array to 64K, this link is maintained only for the last 32K strings.
+   * An index in this array is thus a window index modulo 32K.
+   */
+
+  this.head = null;   /* Heads of the hash chains or NIL. */
+
+  this.ins_h = 0;       /* hash index of string to be inserted */
+  this.hash_size = 0;   /* number of elements in hash table */
+  this.hash_bits = 0;   /* log2(hash_size) */
+  this.hash_mask = 0;   /* hash_size-1 */
+
+  this.hash_shift = 0;
+  /* Number of bits by which ins_h must be shifted at each input
+   * step. It must be such that after MIN_MATCH steps, the oldest
+   * byte no longer takes part in the hash key, that is:
+   *   hash_shift * MIN_MATCH >= hash_bits
+   */
+
+  this.block_start = 0;
+  /* Window position at the beginning of the current output block. Gets
+   * negative when the window is moved backwards.
+   */
+
+  this.match_length = 0;      /* length of best match */
+  this.prev_match = 0;        /* previous match */
+  this.match_available = 0;   /* set if previous match exists */
+  this.strstart = 0;          /* start of string to insert */
+  this.match_start = 0;       /* start of matching string */
+  this.lookahead = 0;         /* number of valid bytes ahead in window */
+
+  this.prev_length = 0;
+  /* Length of the best match at previous step. Matches not greater than this
+   * are discarded. This is used in the lazy match evaluation.
+   */
+
+  this.max_chain_length = 0;
+  /* To speed up deflation, hash chains are never searched beyond this
+   * length.  A higher limit improves compression ratio but degrades the
+   * speed.
+   */
+
+  this.max_lazy_match = 0;
+  /* Attempt to find a better match only when the current match is strictly
+   * smaller than this value. This mechanism is used only for compression
+   * levels >= 4.
+   */
+  // That's alias to max_lazy_match, don't use directly
+  //this.max_insert_length = 0;
+  /* Insert new strings in the hash table only if the match length is not
+   * greater than this length. This saves time but degrades compression.
+   * max_insert_length is used only for compression levels <= 3.
+   */
+
+  this.level = 0;     /* compression level (1..9) */
+  this.strategy = 0;  /* favor or force Huffman coding*/
+
+  this.good_match = 0;
+  /* Use a faster search when the previous match is longer than this */
+
+  this.nice_match = 0; /* Stop searching when current match exceeds this */
+
+              /* used by trees.c: */
+
+  /* Didn't use ct_data typedef below to suppress compiler warning */
+
+  // struct ct_data_s dyn_ltree[HEAP_SIZE];   /* literal and length tree */
+  // struct ct_data_s dyn_dtree[2*D_CODES+1]; /* distance tree */
+  // struct ct_data_s bl_tree[2*BL_CODES+1];  /* Huffman tree for bit lengths */
+
+  // Use flat array of DOUBLE size, with interleaved fata,
+  // because JS does not support effective
+  this.dyn_ltree  = new utils.Buf16(HEAP_SIZE * 2);
+  this.dyn_dtree  = new utils.Buf16((2 * D_CODES + 1) * 2);
+  this.bl_tree    = new utils.Buf16((2 * BL_CODES + 1) * 2);
+  zero(this.dyn_ltree);
+  zero(this.dyn_dtree);
+  zero(this.bl_tree);
+
+  this.l_desc   = null;         /* desc. for literal tree */
+  this.d_desc   = null;         /* desc. for distance tree */
+  this.bl_desc  = null;         /* desc. for bit length tree */
+
+  //ush bl_count[MAX_BITS+1];
+  this.bl_count = new utils.Buf16(MAX_BITS + 1);
+  /* number of codes at each bit length for an optimal tree */
+
+  //int heap[2*L_CODES+1];      /* heap used to build the Huffman trees */
+  this.heap = new utils.Buf16(2 * L_CODES + 1);  /* heap used to build the Huffman trees */
+  zero(this.heap);
+
+  this.heap_len = 0;               /* number of elements in the heap */
+  this.heap_max = 0;               /* element of largest frequency */
+  /* The sons of heap[n] are heap[2*n] and heap[2*n+1]. heap[0] is not used.
+   * The same heap array is used to build all trees.
+   */
+
+  this.depth = new utils.Buf16(2 * L_CODES + 1); //uch depth[2*L_CODES+1];
+  zero(this.depth);
+  /* Depth of each subtree used as tie breaker for trees of equal frequency
+   */
+
+  this.l_buf = 0;          /* buffer index for literals or lengths */
+
+  this.lit_bufsize = 0;
+  /* Size of match buffer for literals/lengths.  There are 4 reasons for
+   * limiting lit_bufsize to 64K:
+   *   - frequencies can be kept in 16 bit counters
+   *   - if compression is not successful for the first block, all input
+   *     data is still in the window so we can still emit a stored block even
+   *     when input comes from standard input.  (This can also be done for
+   *     all blocks if lit_bufsize is not greater than 32K.)
+   *   - if compression is not successful for a file smaller than 64K, we can
+   *     even emit a stored file instead of a stored block (saving 5 bytes).
+   *     This is applicable only for zip (not gzip or zlib).
+   *   - creating new Huffman trees less frequently may not provide fast
+   *     adaptation to changes in the input data statistics. (Take for
+   *     example a binary file with poorly compressible code followed by
+   *     a highly compressible string table.) Smaller buffer sizes give
+   *     fast adaptation but have of course the overhead of transmitting
+   *     trees more frequently.
+   *   - I can't count above 4
+   */
+
+  this.last_lit = 0;      /* running index in l_buf */
+
+  this.d_buf = 0;
+  /* Buffer index for distances. To simplify the code, d_buf and l_buf have
+   * the same number of elements. To use different lengths, an extra flag
+   * array would be necessary.
+   */
+
+  this.opt_len = 0;       /* bit length of current block with optimal trees */
+  this.static_len = 0;    /* bit length of current block with static trees */
+  this.matches = 0;       /* number of string matches in current block */
+  this.insert = 0;        /* bytes at end of window left to insert */
+
+
+  this.bi_buf = 0;
+  /* Output buffer. bits are inserted starting at the bottom (least
+   * significant bits).
+   */
+  this.bi_valid = 0;
+  /* Number of valid bits in bi_buf.  All bits above the last valid bit
+   * are always zero.
+   */
+
+  // Used for window memory init. We safely ignore it for JS. That makes
+  // sense only for pointers and memory check tools.
+  //this.high_water = 0;
+  /* High water mark offset in window for initialized bytes -- bytes above
+   * this are set to zero in order to avoid memory check warnings when
+   * longest match routines access bytes past the input.  This is then
+   * updated to the new high water mark.
+   */
+}
+
+
+function deflateResetKeep(strm) {
+  var s;
+
+  if (!strm || !strm.state) {
+    return err(strm, Z_STREAM_ERROR);
+  }
+
+  strm.total_in = strm.total_out = 0;
+  strm.data_type = Z_UNKNOWN;
+
+  s = strm.state;
+  s.pending = 0;
+  s.pending_out = 0;
+
+  if (s.wrap < 0) {
+    s.wrap = -s.wrap;
+    /* was made negative by deflate(..., Z_FINISH); */
+  }
+  s.status = (s.wrap ? INIT_STATE : BUSY_STATE);
+  strm.adler = (s.wrap === 2) ?
+    0  // crc32(0, Z_NULL, 0)
+  :
+    1; // adler32(0, Z_NULL, 0)
+  s.last_flush = Z_NO_FLUSH;
+  trees._tr_init(s);
+  return Z_OK;
+}
+
+
+function deflateReset(strm) {
+  var ret = deflateResetKeep(strm);
+  if (ret === Z_OK) {
+    lm_init(strm.state);
+  }
+  return ret;
+}
+
+
+function deflateSetHeader(strm, head) {
+  if (!strm || !strm.state) { return Z_STREAM_ERROR; }
+  if (strm.state.wrap !== 2) { return Z_STREAM_ERROR; }
+  strm.state.gzhead = head;
+  return Z_OK;
+}
+
+
+function deflateInit2(strm, level, method, windowBits, memLevel, strategy) {
+  if (!strm) { // === Z_NULL
+    return Z_STREAM_ERROR;
+  }
+  var wrap = 1;
+
+  if (level === Z_DEFAULT_COMPRESSION) {
+    level = 6;
+  }
+
+  if (windowBits < 0) { /* suppress zlib wrapper */
+    wrap = 0;
+    windowBits = -windowBits;
+  }
+
+  else if (windowBits > 15) {
+    wrap = 2;           /* write gzip wrapper instead */
+    windowBits -= 16;
+  }
+
+
+  if (memLevel < 1 || memLevel > MAX_MEM_LEVEL || method !== Z_DEFLATED ||
+    windowBits < 8 || windowBits > 15 || level < 0 || level > 9 ||
+    strategy < 0 || strategy > Z_FIXED) {
+    return err(strm, Z_STREAM_ERROR);
+  }
+
+
+  if (windowBits === 8) {
+    windowBits = 9;
+  }
+  /* until 256-byte window bug fixed */
+
+  var s = new DeflateState();
+
+  strm.state = s;
+  s.strm = strm;
+
+  s.wrap = wrap;
+  s.gzhead = null;
+  s.w_bits = windowBits;
+  s.w_size = 1 << s.w_bits;
+  s.w_mask = s.w_size - 1;
+
+  s.hash_bits = memLevel + 7;
+  s.hash_size = 1 << s.hash_bits;
+  s.hash_mask = s.hash_size - 1;
+  s.hash_shift = ~~((s.hash_bits + MIN_MATCH - 1) / MIN_MATCH);
+
+  s.window = new utils.Buf8(s.w_size * 2);
+  s.head = new utils.Buf16(s.hash_size);
+  s.prev = new utils.Buf16(s.w_size);
+
+  // Don't need mem init magic for JS.
+  //s.high_water = 0;  /* nothing written to s->window yet */
+
+  s.lit_bufsize = 1 << (memLevel + 6); /* 16K elements by default */
+
+  s.pending_buf_size = s.lit_bufsize * 4;
+
+  //overlay = (ushf *) ZALLOC(strm, s->lit_bufsize, sizeof(ush)+2);
+  //s->pending_buf = (uchf *) overlay;
+  s.pending_buf = new utils.Buf8(s.pending_buf_size);
+
+  // It is offset from `s.pending_buf` (size is `s.lit_bufsize * 2`)
+  //s->d_buf = overlay + s->lit_bufsize/sizeof(ush);
+  s.d_buf = 1 * s.lit_bufsize;
+
+  //s->l_buf = s->pending_buf + (1+sizeof(ush))*s->lit_bufsize;
+  s.l_buf = (1 + 2) * s.lit_bufsize;
+
+  s.level = level;
+  s.strategy = strategy;
+  s.method = method;
+
+  return deflateReset(strm);
+}
+
+function deflateInit(strm, level) {
+  return deflateInit2(strm, level, Z_DEFLATED, MAX_WBITS, DEF_MEM_LEVEL, Z_DEFAULT_STRATEGY);
+}
+
+
+function deflate(strm, flush) {
+  var old_flush, s;
+  var beg, val; // for gzip header write only
+
+  if (!strm || !strm.state ||
+    flush > Z_BLOCK || flush < 0) {
+    return strm ? err(strm, Z_STREAM_ERROR) : Z_STREAM_ERROR;
+  }
+
+  s = strm.state;
+
+  if (!strm.output ||
+      (!strm.input && strm.avail_in !== 0) ||
+      (s.status === FINISH_STATE && flush !== Z_FINISH)) {
+    return err(strm, (strm.avail_out === 0) ? Z_BUF_ERROR : Z_STREAM_ERROR);
+  }
+
+  s.strm = strm; /* just in case */
+  old_flush = s.last_flush;
+  s.last_flush = flush;
+
+  /* Write the header */
+  if (s.status === INIT_STATE) {
+
+    if (s.wrap === 2) { // GZIP header
+      strm.adler = 0;  //crc32(0L, Z_NULL, 0);
+      put_byte(s, 31);
+      put_byte(s, 139);
+      put_byte(s, 8);
+      if (!s.gzhead) { // s->gzhead == Z_NULL
+        put_byte(s, 0);
+        put_byte(s, 0);
+        put_byte(s, 0);
+        put_byte(s, 0);
+        put_byte(s, 0);
+        put_byte(s, s.level === 9 ? 2 :
+                    (s.strategy >= Z_HUFFMAN_ONLY || s.level < 2 ?
+                     4 : 0));
+        put_byte(s, OS_CODE);
+        s.status = BUSY_STATE;
+      }
+      else {
+        put_byte(s, (s.gzhead.text ? 1 : 0) +
+                    (s.gzhead.hcrc ? 2 : 0) +
+                    (!s.gzhead.extra ? 0 : 4) +
+                    (!s.gzhead.name ? 0 : 8) +
+                    (!s.gzhead.comment ? 0 : 16)
+                );
+        put_byte(s, s.gzhead.time & 0xff);
+        put_byte(s, (s.gzhead.time >> 8) & 0xff);
+        put_byte(s, (s.gzhead.time >> 16) & 0xff);
+        put_byte(s, (s.gzhead.time >> 24) & 0xff);
+        put_byte(s, s.level === 9 ? 2 :
+                    (s.strategy >= Z_HUFFMAN_ONLY || s.level < 2 ?
+                     4 : 0));
+        put_byte(s, s.gzhead.os & 0xff);
+        if (s.gzhead.extra && s.gzhead.extra.length) {
+          put_byte(s, s.gzhead.extra.length & 0xff);
+          put_byte(s, (s.gzhead.extra.length >> 8) & 0xff);
+        }
+        if (s.gzhead.hcrc) {
+          strm.adler = crc32(strm.adler, s.pending_buf, s.pending, 0);
+        }
+        s.gzindex = 0;
+        s.status = EXTRA_STATE;
+      }
+    }
+    else // DEFLATE header
+    {
+      var header = (Z_DEFLATED + ((s.w_bits - 8) << 4)) << 8;
+      var level_flags = -1;
+
+      if (s.strategy >= Z_HUFFMAN_ONLY || s.level < 2) {
+        level_flags = 0;
+      } else if (s.level < 6) {
+        level_flags = 1;
+      } else if (s.level === 6) {
+        level_flags = 2;
+      } else {
+        level_flags = 3;
+      }
+      header |= (level_flags << 6);
+      if (s.strstart !== 0) { header |= PRESET_DICT; }
+      header += 31 - (header % 31);
+
+      s.status = BUSY_STATE;
+      putShortMSB(s, header);
+
+      /* Save the adler32 of the preset dictionary: */
+      if (s.strstart !== 0) {
+        putShortMSB(s, strm.adler >>> 16);
+        putShortMSB(s, strm.adler & 0xffff);
+      }
+      strm.adler = 1; // adler32(0L, Z_NULL, 0);
+    }
+  }
+
+//#ifdef GZIP
+  if (s.status === EXTRA_STATE) {
+    if (s.gzhead.extra/* != Z_NULL*/) {
+      beg = s.pending;  /* start of bytes to update crc */
+
+      while (s.gzindex < (s.gzhead.extra.length & 0xffff)) {
+        if (s.pending === s.pending_buf_size) {
+          if (s.gzhead.hcrc && s.pending > beg) {
+            strm.adler = crc32(strm.adler, s.pending_buf, s.pending - beg, beg);
+          }
+          flush_pending(strm);
+          beg = s.pending;
+          if (s.pending === s.pending_buf_size) {
+            break;
+          }
+        }
+        put_byte(s, s.gzhead.extra[s.gzindex] & 0xff);
+        s.gzindex++;
+      }
+      if (s.gzhead.hcrc && s.pending > beg) {
+        strm.adler = crc32(strm.adler, s.pending_buf, s.pending - beg, beg);
+      }
+      if (s.gzindex === s.gzhead.extra.length) {
+        s.gzindex = 0;
+        s.status = NAME_STATE;
+      }
+    }
+    else {
+      s.status = NAME_STATE;
+    }
+  }
+  if (s.status === NAME_STATE) {
+    if (s.gzhead.name/* != Z_NULL*/) {
+      beg = s.pending;  /* start of bytes to update crc */
+      //int val;
+
+      do {
+        if (s.pending === s.pending_buf_size) {
+          if (s.gzhead.hcrc && s.pending > beg) {
+            strm.adler = crc32(strm.adler, s.pending_buf, s.pending - beg, beg);
+          }
+          flush_pending(strm);
+          beg = s.pending;
+          if (s.pending === s.pending_buf_size) {
+            val = 1;
+            break;
+          }
+        }
+        // JS specific: little magic to add zero terminator to end of string
+        if (s.gzindex < s.gzhead.name.length) {
+          val = s.gzhead.name.charCodeAt(s.gzindex++) & 0xff;
+        } else {
+          val = 0;
+        }
+        put_byte(s, val);
+      } while (val !== 0);
+
+      if (s.gzhead.hcrc && s.pending > beg) {
+        strm.adler = crc32(strm.adler, s.pending_buf, s.pending - beg, beg);
+      }
+      if (val === 0) {
+        s.gzindex = 0;
+        s.status = COMMENT_STATE;
+      }
+    }
+    else {
+      s.status = COMMENT_STATE;
+    }
+  }
+  if (s.status === COMMENT_STATE) {
+    if (s.gzhead.comment/* != Z_NULL*/) {
+      beg = s.pending;  /* start of bytes to update crc */
+      //int val;
+
+      do {
+        if (s.pending === s.pending_buf_size) {
+          if (s.gzhead.hcrc && s.pending > beg) {
+            strm.adler = crc32(strm.adler, s.pending_buf, s.pending - beg, beg);
+          }
+          flush_pending(strm);
+          beg = s.pending;
+          if (s.pending === s.pending_buf_size) {
+            val = 1;
+            break;
+          }
+        }
+        // JS specific: little magic to add zero terminator to end of string
+        if (s.gzindex < s.gzhead.comment.length) {
+          val = s.gzhead.comment.charCodeAt(s.gzindex++) & 0xff;
+        } else {
+          val = 0;
+        }
+        put_byte(s, val);
+      } while (val !== 0);
+
+      if (s.gzhead.hcrc && s.pending > beg) {
+        strm.adler = crc32(strm.adler, s.pending_buf, s.pending - beg, beg);
+      }
+      if (val === 0) {
+        s.status = HCRC_STATE;
+      }
+    }
+    else {
+      s.status = HCRC_STATE;
+    }
+  }
+  if (s.status === HCRC_STATE) {
+    if (s.gzhead.hcrc) {
+      if (s.pending + 2 > s.pending_buf_size) {
+        flush_pending(strm);
+      }
+      if (s.pending + 2 <= s.pending_buf_size) {
+        put_byte(s, strm.adler & 0xff);
+        put_byte(s, (strm.adler >> 8) & 0xff);
+        strm.adler = 0; //crc32(0L, Z_NULL, 0);
+        s.status = BUSY_STATE;
+      }
+    }
+    else {
+      s.status = BUSY_STATE;
+    }
+  }
+//#endif
+
+  /* Flush as much pending output as possible */
+  if (s.pending !== 0) {
+    flush_pending(strm);
+    if (strm.avail_out === 0) {
+      /* Since avail_out is 0, deflate will be called again with
+       * more output space, but possibly with both pending and
+       * avail_in equal to zero. There won't be anything to do,
+       * but this is not an error situation so make sure we
+       * return OK instead of BUF_ERROR at next call of deflate:
+       */
+      s.last_flush = -1;
+      return Z_OK;
+    }
+
+    /* Make sure there is something to do and avoid duplicate consecutive
+     * flushes. For repeated and useless calls with Z_FINISH, we keep
+     * returning Z_STREAM_END instead of Z_BUF_ERROR.
+     */
+  } else if (strm.avail_in === 0 && rank(flush) <= rank(old_flush) &&
+    flush !== Z_FINISH) {
+    return err(strm, Z_BUF_ERROR);
+  }
+
+  /* User must not provide more input after the first FINISH: */
+  if (s.status === FINISH_STATE && strm.avail_in !== 0) {
+    return err(strm, Z_BUF_ERROR);
+  }
+
+  /* Start a new block or continue the current one.
+   */
+  if (strm.avail_in !== 0 || s.lookahead !== 0 ||
+    (flush !== Z_NO_FLUSH && s.status !== FINISH_STATE)) {
+    var bstate = (s.strategy === Z_HUFFMAN_ONLY) ? deflate_huff(s, flush) :
+      (s.strategy === Z_RLE ? deflate_rle(s, flush) :
+        configuration_table[s.level].func(s, flush));
+
+    if (bstate === BS_FINISH_STARTED || bstate === BS_FINISH_DONE) {
+      s.status = FINISH_STATE;
+    }
+    if (bstate === BS_NEED_MORE || bstate === BS_FINISH_STARTED) {
+      if (strm.avail_out === 0) {
+        s.last_flush = -1;
+        /* avoid BUF_ERROR next call, see above */
+      }
+      return Z_OK;
+      /* If flush != Z_NO_FLUSH && avail_out == 0, the next call
+       * of deflate should use the same flush parameter to make sure
+       * that the flush is complete. So we don't have to output an
+       * empty block here, this will be done at next call. This also
+       * ensures that for a very small output buffer, we emit at most
+       * one empty block.
+       */
+    }
+    if (bstate === BS_BLOCK_DONE) {
+      if (flush === Z_PARTIAL_FLUSH) {
+        trees._tr_align(s);
+      }
+      else if (flush !== Z_BLOCK) { /* FULL_FLUSH or SYNC_FLUSH */
+
+        trees._tr_stored_block(s, 0, 0, false);
+        /* For a full flush, this empty block will be recognized
+         * as a special marker by inflate_sync().
+         */
+        if (flush === Z_FULL_FLUSH) {
+          /*** CLEAR_HASH(s); ***/             /* forget history */
+          zero(s.head); // Fill with NIL (= 0);
+
+          if (s.lookahead === 0) {
+            s.strstart = 0;
+            s.block_start = 0;
+            s.insert = 0;
+          }
+        }
+      }
+      flush_pending(strm);
+      if (strm.avail_out === 0) {
+        s.last_flush = -1; /* avoid BUF_ERROR at next call, see above */
+        return Z_OK;
+      }
+    }
+  }
+  //Assert(strm->avail_out > 0, "bug2");
+  //if (strm.avail_out <= 0) { throw new Error("bug2");}
+
+  if (flush !== Z_FINISH) { return Z_OK; }
+  if (s.wrap <= 0) { return Z_STREAM_END; }
+
+  /* Write the trailer */
+  if (s.wrap === 2) {
+    put_byte(s, strm.adler & 0xff);
+    put_byte(s, (strm.adler >> 8) & 0xff);
+    put_byte(s, (strm.adler >> 16) & 0xff);
+    put_byte(s, (strm.adler >> 24) & 0xff);
+    put_byte(s, strm.total_in & 0xff);
+    put_byte(s, (strm.total_in >> 8) & 0xff);
+    put_byte(s, (strm.total_in >> 16) & 0xff);
+    put_byte(s, (strm.total_in >> 24) & 0xff);
+  }
+  else
+  {
+    putShortMSB(s, strm.adler >>> 16);
+    putShortMSB(s, strm.adler & 0xffff);
+  }
+
+  flush_pending(strm);
+  /* If avail_out is zero, the application will call deflate again
+   * to flush the rest.
+   */
+  if (s.wrap > 0) { s.wrap = -s.wrap; }
+  /* write the trailer only once! */
+  return s.pending !== 0 ? Z_OK : Z_STREAM_END;
+}
+
+function deflateEnd(strm) {
+  var status;
+
+  if (!strm/*== Z_NULL*/ || !strm.state/*== Z_NULL*/) {
+    return Z_STREAM_ERROR;
+  }
+
+  status = strm.state.status;
+  if (status !== INIT_STATE &&
+    status !== EXTRA_STATE &&
+    status !== NAME_STATE &&
+    status !== COMMENT_STATE &&
+    status !== HCRC_STATE &&
+    status !== BUSY_STATE &&
+    status !== FINISH_STATE
+  ) {
+    return err(strm, Z_STREAM_ERROR);
+  }
+
+  strm.state = null;
+
+  return status === BUSY_STATE ? err(strm, Z_DATA_ERROR) : Z_OK;
+}
+
+
+/* =========================================================================
+ * Initializes the compression dictionary from the given byte
+ * sequence without producing any compressed output.
+ */
+function deflateSetDictionary(strm, dictionary) {
+  var dictLength = dictionary.length;
+
+  var s;
+  var str, n;
+  var wrap;
+  var avail;
+  var next;
+  var input;
+  var tmpDict;
+
+  if (!strm/*== Z_NULL*/ || !strm.state/*== Z_NULL*/) {
+    return Z_STREAM_ERROR;
+  }
+
+  s = strm.state;
+  wrap = s.wrap;
+
+  if (wrap === 2 || (wrap === 1 && s.status !== INIT_STATE) || s.lookahead) {
+    return Z_STREAM_ERROR;
+  }
+
+  /* when using zlib wrappers, compute Adler-32 for provided dictionary */
+  if (wrap === 1) {
+    /* adler32(strm->adler, dictionary, dictLength); */
+    strm.adler = adler32(strm.adler, dictionary, dictLength, 0);
+  }
+
+  s.wrap = 0;   /* avoid computing Adler-32 in read_buf */
+
+  /* if dictionary would fill window, just replace the history */
+  if (dictLength >= s.w_size) {
+    if (wrap === 0) {            /* already empty otherwise */
+      /*** CLEAR_HASH(s); ***/
+      zero(s.head); // Fill with NIL (= 0);
+      s.strstart = 0;
+      s.block_start = 0;
+      s.insert = 0;
+    }
+    /* use the tail */
+    // dictionary = dictionary.slice(dictLength - s.w_size);
+    tmpDict = new utils.Buf8(s.w_size);
+    utils.arraySet(tmpDict, dictionary, dictLength - s.w_size, s.w_size, 0);
+    dictionary = tmpDict;
+    dictLength = s.w_size;
+  }
+  /* insert dictionary into window and hash */
+  avail = strm.avail_in;
+  next = strm.next_in;
+  input = strm.input;
+  strm.avail_in = dictLength;
+  strm.next_in = 0;
+  strm.input = dictionary;
+  fill_window(s);
+  while (s.lookahead >= MIN_MATCH) {
+    str = s.strstart;
+    n = s.lookahead - (MIN_MATCH - 1);
+    do {
+      /* UPDATE_HASH(s, s->ins_h, s->window[str + MIN_MATCH-1]); */
+      s.ins_h = ((s.ins_h << s.hash_shift) ^ s.window[str + MIN_MATCH - 1]) & s.hash_mask;
+
+      s.prev[str & s.w_mask] = s.head[s.ins_h];
+
+      s.head[s.ins_h] = str;
+      str++;
+    } while (--n);
+    s.strstart = str;
+    s.lookahead = MIN_MATCH - 1;
+    fill_window(s);
+  }
+  s.strstart += s.lookahead;
+  s.block_start = s.strstart;
+  s.insert = s.lookahead;
+  s.lookahead = 0;
+  s.match_length = s.prev_length = MIN_MATCH - 1;
+  s.match_available = 0;
+  strm.next_in = next;
+  strm.input = input;
+  strm.avail_in = avail;
+  s.wrap = wrap;
+  return Z_OK;
+}
+
+
+exports.deflateInit = deflateInit;
+exports.deflateInit2 = deflateInit2;
+exports.deflateReset = deflateReset;
+exports.deflateResetKeep = deflateResetKeep;
+exports.deflateSetHeader = deflateSetHeader;
+exports.deflate = deflate;
+exports.deflateEnd = deflateEnd;
+exports.deflateSetDictionary = deflateSetDictionary;
+exports.deflateInfo = 'pako deflate (from Nodeca project)';
+
+/* Not implemented
+exports.deflateBound = deflateBound;
+exports.deflateCopy = deflateCopy;
+exports.deflateParams = deflateParams;
+exports.deflatePending = deflatePending;
+exports.deflatePrime = deflatePrime;
+exports.deflateTune = deflateTune;
+*/
+
+},{"../utils/common":62,"./adler32":64,"./crc32":66,"./messages":72,"./trees":73}],68:[function(require,module,exports){
+'use strict';
+
+// (C) 1995-2013 Jean-loup Gailly and Mark Adler
+// (C) 2014-2017 Vitaly Puzrin and Andrey Tupitsin
+//
+// This software is provided 'as-is', without any express or implied
+// warranty. In no event will the authors be held liable for any damages
+// arising from the use of this software.
+//
+// Permission is granted to anyone to use this software for any purpose,
+// including commercial applications, and to alter it and redistribute it
+// freely, subject to the following restrictions:
+//
+// 1. The origin of this software must not be misrepresented; you must not
+//   claim that you wrote the original software. If you use this software
+//   in a product, an acknowledgment in the product documentation would be
+//   appreciated but is not required.
+// 2. Altered source versions must be plainly marked as such, and must not be
+//   misrepresented as being the original software.
+// 3. This notice may not be removed or altered from any source distribution.
+
+function GZheader() {
+  /* true if compressed data believed to be text */
+  this.text       = 0;
+  /* modification time */
+  this.time       = 0;
+  /* extra flags (not used when writing a gzip file) */
+  this.xflags     = 0;
+  /* operating system */
+  this.os         = 0;
+  /* pointer to extra field or Z_NULL if none */
+  this.extra      = null;
+  /* extra field length (valid if extra != Z_NULL) */
+  this.extra_len  = 0; // Actually, we don't need it in JS,
+                       // but leave for few code modifications
+
+  //
+  // Setup limits is not necessary because in js we should not preallocate memory
+  // for inflate use constant limit in 65536 bytes
+  //
+
+  /* space at extra (only when reading header) */
+  // this.extra_max  = 0;
+  /* pointer to zero-terminated file name or Z_NULL */
+  this.name       = '';
+  /* space at name (only when reading header) */
+  // this.name_max   = 0;
+  /* pointer to zero-terminated comment or Z_NULL */
+  this.comment    = '';
+  /* space at comment (only when reading header) */
+  // this.comm_max   = 0;
+  /* true if there was or will be a header crc */
+  this.hcrc       = 0;
+  /* true when done reading gzip header (not used when writing a gzip file) */
+  this.done       = false;
+}
+
+module.exports = GZheader;
+
+},{}],69:[function(require,module,exports){
+'use strict';
+
+// (C) 1995-2013 Jean-loup Gailly and Mark Adler
+// (C) 2014-2017 Vitaly Puzrin and Andrey Tupitsin
+//
+// This software is provided 'as-is', without any express or implied
+// warranty. In no event will the authors be held liable for any damages
+// arising from the use of this software.
+//
+// Permission is granted to anyone to use this software for any purpose,
+// including commercial applications, and to alter it and redistribute it
+// freely, subject to the following restrictions:
+//
+// 1. The origin of this software must not be misrepresented; you must not
+//   claim that you wrote the original software. If you use this software
+//   in a product, an acknowledgment in the product documentation would be
+//   appreciated but is not required.
+// 2. Altered source versions must be plainly marked as such, and must not be
+//   misrepresented as being the original software.
+// 3. This notice may not be removed or altered from any source distribution.
+
+// See state defs from inflate.js
+var BAD = 30;       /* got a data error -- remain here until reset */
+var TYPE = 12;      /* i: waiting for type bits, including last-flag bit */
+
+/*
+   Decode literal, length, and distance codes and write out the resulting
+   literal and match bytes until either not enough input or output is
+   available, an end-of-block is encountered, or a data error is encountered.
+   When large enough input and output buffers are supplied to inflate(), for
+   example, a 16K input buffer and a 64K output buffer, more than 95% of the
+   inflate execution time is spent in this routine.
+
+   Entry assumptions:
+
+        state.mode === LEN
+        strm.avail_in >= 6
+        strm.avail_out >= 258
+        start >= strm.avail_out
+        state.bits < 8
+
+   On return, state.mode is one of:
+
+        LEN -- ran out of enough output space or enough available input
+        TYPE -- reached end of block code, inflate() to interpret next block
+        BAD -- error in block data
+
+   Notes:
+
+    - The maximum input bits used by a length/distance pair is 15 bits for the
+      length code, 5 bits for the length extra, 15 bits for the distance code,
+      and 13 bits for the distance extra.  This totals 48 bits, or six bytes.
+      Therefore if strm.avail_in >= 6, then there is enough input to avoid
+      checking for available input while decoding.
+
+    - The maximum bytes that a single length/distance pair can output is 258
+      bytes, which is the maximum length that can be coded.  inflate_fast()
+      requires strm.avail_out >= 258 for each loop to avoid checking for
+      output space.
+ */
+module.exports = function inflate_fast(strm, start) {
+  var state;
+  var _in;                    /* local strm.input */
+  var last;                   /* have enough input while in < last */
+  var _out;                   /* local strm.output */
+  var beg;                    /* inflate()'s initial strm.output */
+  var end;                    /* while out < end, enough space available */
+//#ifdef INFLATE_STRICT
+  var dmax;                   /* maximum distance from zlib header */
+//#endif
+  var wsize;                  /* window size or zero if not using window */
+  var whave;                  /* valid bytes in the window */
+  var wnext;                  /* window write index */
+  // Use `s_window` instead `window`, avoid conflict with instrumentation tools
+  var s_window;               /* allocated sliding window, if wsize != 0 */
+  var hold;                   /* local strm.hold */
+  var bits;                   /* local strm.bits */
+  var lcode;                  /* local strm.lencode */
+  var dcode;                  /* local strm.distcode */
+  var lmask;                  /* mask for first level of length codes */
+  var dmask;                  /* mask for first level of distance codes */
+  var here;                   /* retrieved table entry */
+  var op;                     /* code bits, operation, extra bits, or */
+                              /*  window position, window bytes to copy */
+  var len;                    /* match length, unused bytes */
+  var dist;                   /* match distance */
+  var from;                   /* where to copy match from */
+  var from_source;
+
+
+  var input, output; // JS specific, because we have no pointers
+
+  /* copy state to local variables */
+  state = strm.state;
+  //here = state.here;
+  _in = strm.next_in;
+  input = strm.input;
+  last = _in + (strm.avail_in - 5);
+  _out = strm.next_out;
+  output = strm.output;
+  beg = _out - (start - strm.avail_out);
+  end = _out + (strm.avail_out - 257);
+//#ifdef INFLATE_STRICT
+  dmax = state.dmax;
+//#endif
+  wsize = state.wsize;
+  whave = state.whave;
+  wnext = state.wnext;
+  s_window = state.window;
+  hold = state.hold;
+  bits = state.bits;
+  lcode = state.lencode;
+  dcode = state.distcode;
+  lmask = (1 << state.lenbits) - 1;
+  dmask = (1 << state.distbits) - 1;
+
+
+  /* decode literals and length/distances until end-of-block or not enough
+     input data or output space */
+
+  top:
+  do {
+    if (bits < 15) {
+      hold += input[_in++] << bits;
+      bits += 8;
+      hold += input[_in++] << bits;
+      bits += 8;
+    }
+
+    here = lcode[hold & lmask];
+
+    dolen:
+    for (;;) { // Goto emulation
+      op = here >>> 24/*here.bits*/;
+      hold >>>= op;
+      bits -= op;
+      op = (here >>> 16) & 0xff/*here.op*/;
+      if (op === 0) {                          /* literal */
+        //Tracevv((stderr, here.val >= 0x20 && here.val < 0x7f ?
+        //        "inflate:         literal '%c'\n" :
+        //        "inflate:         literal 0x%02x\n", here.val));
+        output[_out++] = here & 0xffff/*here.val*/;
+      }
+      else if (op & 16) {                     /* length base */
+        len = here & 0xffff/*here.val*/;
+        op &= 15;                           /* number of extra bits */
+        if (op) {
+          if (bits < op) {
+            hold += input[_in++] << bits;
+            bits += 8;
+          }
+          len += hold & ((1 << op) - 1);
+          hold >>>= op;
+          bits -= op;
+        }
+        //Tracevv((stderr, "inflate:         length %u\n", len));
+        if (bits < 15) {
+          hold += input[_in++] << bits;
+          bits += 8;
+          hold += input[_in++] << bits;
+          bits += 8;
+        }
+        here = dcode[hold & dmask];
+
+        dodist:
+        for (;;) { // goto emulation
+          op = here >>> 24/*here.bits*/;
+          hold >>>= op;
+          bits -= op;
+          op = (here >>> 16) & 0xff/*here.op*/;
+
+          if (op & 16) {                      /* distance base */
+            dist = here & 0xffff/*here.val*/;
+            op &= 15;                       /* number of extra bits */
+            if (bits < op) {
+              hold += input[_in++] << bits;
+              bits += 8;
+              if (bits < op) {
+                hold += input[_in++] << bits;
+                bits += 8;
+              }
+            }
+            dist += hold & ((1 << op) - 1);
+//#ifdef INFLATE_STRICT
+            if (dist > dmax) {
+              strm.msg = 'invalid distance too far back';
+              state.mode = BAD;
+              break top;
+            }
+//#endif
+            hold >>>= op;
+            bits -= op;
+            //Tracevv((stderr, "inflate:         distance %u\n", dist));
+            op = _out - beg;                /* max distance in output */
+            if (dist > op) {                /* see if copy from window */
+              op = dist - op;               /* distance back in window */
+              if (op > whave) {
+                if (state.sane) {
+                  strm.msg = 'invalid distance too far back';
+                  state.mode = BAD;
+                  break top;
+                }
+
+// (!) This block is disabled in zlib defailts,
+// don't enable it for binary compatibility
+//#ifdef INFLATE_ALLOW_INVALID_DISTANCE_TOOFAR_ARRR
+//                if (len <= op - whave) {
+//                  do {
+//                    output[_out++] = 0;
+//                  } while (--len);
+//                  continue top;
+//                }
+//                len -= op - whave;
+//                do {
+//                  output[_out++] = 0;
+//                } while (--op > whave);
+//                if (op === 0) {
+//                  from = _out - dist;
+//                  do {
+//                    output[_out++] = output[from++];
+//                  } while (--len);
+//                  continue top;
+//                }
+//#endif
+              }
+              from = 0; // window index
+              from_source = s_window;
+              if (wnext === 0) {           /* very common case */
+                from += wsize - op;
+                if (op < len) {         /* some from window */
+                  len -= op;
+                  do {
+                    output[_out++] = s_window[from++];
+                  } while (--op);
+                  from = _out - dist;  /* rest from output */
+                  from_source = output;
+                }
+              }
+              else if (wnext < op) {      /* wrap around window */
+                from += wsize + wnext - op;
+                op -= wnext;
+                if (op < len) {         /* some from end of window */
+                  len -= op;
+                  do {
+                    output[_out++] = s_window[from++];
+                  } while (--op);
+                  from = 0;
+                  if (wnext < len) {  /* some from start of window */
+                    op = wnext;
+                    len -= op;
+                    do {
+                      output[_out++] = s_window[from++];
+                    } while (--op);
+                    from = _out - dist;      /* rest from output */
+                    from_source = output;
+                  }
+                }
+              }
+              else {                      /* contiguous in window */
+                from += wnext - op;
+                if (op < len) {         /* some from window */
+                  len -= op;
+                  do {
+                    output[_out++] = s_window[from++];
+                  } while (--op);
+                  from = _out - dist;  /* rest from output */
+                  from_source = output;
+                }
+              }
+              while (len > 2) {
+                output[_out++] = from_source[from++];
+                output[_out++] = from_source[from++];
+                output[_out++] = from_source[from++];
+                len -= 3;
+              }
+              if (len) {
+                output[_out++] = from_source[from++];
+                if (len > 1) {
+                  output[_out++] = from_source[from++];
+                }
+              }
+            }
+            else {
+              from = _out - dist;          /* copy direct from output */
+              do {                        /* minimum length is three */
+                output[_out++] = output[from++];
+                output[_out++] = output[from++];
+                output[_out++] = output[from++];
+                len -= 3;
+              } while (len > 2);
+              if (len) {
+                output[_out++] = output[from++];
+                if (len > 1) {
+                  output[_out++] = output[from++];
+                }
+              }
+            }
+          }
+          else if ((op & 64) === 0) {          /* 2nd level distance code */
+            here = dcode[(here & 0xffff)/*here.val*/ + (hold & ((1 << op) - 1))];
+            continue dodist;
+          }
+          else {
+            strm.msg = 'invalid distance code';
+            state.mode = BAD;
+            break top;
+          }
+
+          break; // need to emulate goto via "continue"
+        }
+      }
+      else if ((op & 64) === 0) {              /* 2nd level length code */
+        here = lcode[(here & 0xffff)/*here.val*/ + (hold & ((1 << op) - 1))];
+        continue dolen;
+      }
+      else if (op & 32) {                     /* end-of-block */
+        //Tracevv((stderr, "inflate:         end of block\n"));
+        state.mode = TYPE;
+        break top;
+      }
+      else {
+        strm.msg = 'invalid literal/length code';
+        state.mode = BAD;
+        break top;
+      }
+
+      break; // need to emulate goto via "continue"
+    }
+  } while (_in < last && _out < end);
+
+  /* return unused bytes (on entry, bits < 8, so in won't go too far back) */
+  len = bits >> 3;
+  _in -= len;
+  bits -= len << 3;
+  hold &= (1 << bits) - 1;
+
+  /* update state and return */
+  strm.next_in = _in;
+  strm.next_out = _out;
+  strm.avail_in = (_in < last ? 5 + (last - _in) : 5 - (_in - last));
+  strm.avail_out = (_out < end ? 257 + (end - _out) : 257 - (_out - end));
+  state.hold = hold;
+  state.bits = bits;
+  return;
+};
+
+},{}],70:[function(require,module,exports){
+'use strict';
+
+// (C) 1995-2013 Jean-loup Gailly and Mark Adler
+// (C) 2014-2017 Vitaly Puzrin and Andrey Tupitsin
+//
+// This software is provided 'as-is', without any express or implied
+// warranty. In no event will the authors be held liable for any damages
+// arising from the use of this software.
+//
+// Permission is granted to anyone to use this software for any purpose,
+// including commercial applications, and to alter it and redistribute it
+// freely, subject to the following restrictions:
+//
+// 1. The origin of this software must not be misrepresented; you must not
+//   claim that you wrote the original software. If you use this software
+//   in a product, an acknowledgment in the product documentation would be
+//   appreciated but is not required.
+// 2. Altered source versions must be plainly marked as such, and must not be
+//   misrepresented as being the original software.
+// 3. This notice may not be removed or altered from any source distribution.
+
+var utils         = require('../utils/common');
+var adler32       = require('./adler32');
+var crc32         = require('./crc32');
+var inflate_fast  = require('./inffast');
+var inflate_table = require('./inftrees');
+
+var CODES = 0;
+var LENS = 1;
+var DISTS = 2;
+
+/* Public constants ==========================================================*/
+/* ===========================================================================*/
+
+
+/* Allowed flush values; see deflate() and inflate() below for details */
+//var Z_NO_FLUSH      = 0;
+//var Z_PARTIAL_FLUSH = 1;
+//var Z_SYNC_FLUSH    = 2;
+//var Z_FULL_FLUSH    = 3;
+var Z_FINISH        = 4;
+var Z_BLOCK         = 5;
+var Z_TREES         = 6;
+
+
+/* Return codes for the compression/decompression functions. Negative values
+ * are errors, positive values are used for special but normal events.
+ */
+var Z_OK            = 0;
+var Z_STREAM_END    = 1;
+var Z_NEED_DICT     = 2;
+//var Z_ERRNO         = -1;
+var Z_STREAM_ERROR  = -2;
+var Z_DATA_ERROR    = -3;
+var Z_MEM_ERROR     = -4;
+var Z_BUF_ERROR     = -5;
+//var Z_VERSION_ERROR = -6;
+
+/* The deflate compression method */
+var Z_DEFLATED  = 8;
+
+
+/* STATES ====================================================================*/
+/* ===========================================================================*/
+
+
+var    HEAD = 1;       /* i: waiting for magic header */
+var    FLAGS = 2;      /* i: waiting for method and flags (gzip) */
+var    TIME = 3;       /* i: waiting for modification time (gzip) */
+var    OS = 4;         /* i: waiting for extra flags and operating system (gzip) */
+var    EXLEN = 5;      /* i: waiting for extra length (gzip) */
+var    EXTRA = 6;      /* i: waiting for extra bytes (gzip) */
+var    NAME = 7;       /* i: waiting for end of file name (gzip) */
+var    COMMENT = 8;    /* i: waiting for end of comment (gzip) */
+var    HCRC = 9;       /* i: waiting for header crc (gzip) */
+var    DICTID = 10;    /* i: waiting for dictionary check value */
+var    DICT = 11;      /* waiting for inflateSetDictionary() call */
+var        TYPE = 12;      /* i: waiting for type bits, including last-flag bit */
+var        TYPEDO = 13;    /* i: same, but skip check to exit inflate on new block */
+var        STORED = 14;    /* i: waiting for stored size (length and complement) */
+var        COPY_ = 15;     /* i/o: same as COPY below, but only first time in */
+var        COPY = 16;      /* i/o: waiting for input or output to copy stored block */
+var        TABLE = 17;     /* i: waiting for dynamic block table lengths */
+var        LENLENS = 18;   /* i: waiting for code length code lengths */
+var        CODELENS = 19;  /* i: waiting for length/lit and distance code lengths */
+var            LEN_ = 20;      /* i: same as LEN below, but only first time in */
+var            LEN = 21;       /* i: waiting for length/lit/eob code */
+var            LENEXT = 22;    /* i: waiting for length extra bits */
+var            DIST = 23;      /* i: waiting for distance code */
+var            DISTEXT = 24;   /* i: waiting for distance extra bits */
+var            MATCH = 25;     /* o: waiting for output space to copy string */
+var            LIT = 26;       /* o: waiting for output space to write literal */
+var    CHECK = 27;     /* i: waiting for 32-bit check value */
+var    LENGTH = 28;    /* i: waiting for 32-bit length (gzip) */
+var    DONE = 29;      /* finished check, done -- remain here until reset */
+var    BAD = 30;       /* got a data error -- remain here until reset */
+var    MEM = 31;       /* got an inflate() memory error -- remain here until reset */
+var    SYNC = 32;      /* looking for synchronization bytes to restart inflate() */
+
+/* ===========================================================================*/
+
+
+
+var ENOUGH_LENS = 852;
+var ENOUGH_DISTS = 592;
+//var ENOUGH =  (ENOUGH_LENS+ENOUGH_DISTS);
+
+var MAX_WBITS = 15;
+/* 32K LZ77 window */
+var DEF_WBITS = MAX_WBITS;
+
+
+function zswap32(q) {
+  return  (((q >>> 24) & 0xff) +
+          ((q >>> 8) & 0xff00) +
+          ((q & 0xff00) << 8) +
+          ((q & 0xff) << 24));
+}
+
+
+function InflateState() {
+  this.mode = 0;             /* current inflate mode */
+  this.last = false;          /* true if processing last block */
+  this.wrap = 0;              /* bit 0 true for zlib, bit 1 true for gzip */
+  this.havedict = false;      /* true if dictionary provided */
+  this.flags = 0;             /* gzip header method and flags (0 if zlib) */
+  this.dmax = 0;              /* zlib header max distance (INFLATE_STRICT) */
+  this.check = 0;             /* protected copy of check value */
+  this.total = 0;             /* protected copy of output count */
+  // TODO: may be {}
+  this.head = null;           /* where to save gzip header information */
+
+  /* sliding window */
+  this.wbits = 0;             /* log base 2 of requested window size */
+  this.wsize = 0;             /* window size or zero if not using window */
+  this.whave = 0;             /* valid bytes in the window */
+  this.wnext = 0;             /* window write index */
+  this.window = null;         /* allocated sliding window, if needed */
+
+  /* bit accumulator */
+  this.hold = 0;              /* input bit accumulator */
+  this.bits = 0;              /* number of bits in "in" */
+
+  /* for string and stored block copying */
+  this.length = 0;            /* literal or length of data to copy */
+  this.offset = 0;            /* distance back to copy string from */
+
+  /* for table and code decoding */
+  this.extra = 0;             /* extra bits needed */
+
+  /* fixed and dynamic code tables */
+  this.lencode = null;          /* starting table for length/literal codes */
+  this.distcode = null;         /* starting table for distance codes */
+  this.lenbits = 0;           /* index bits for lencode */
+  this.distbits = 0;          /* index bits for distcode */
+
+  /* dynamic table building */
+  this.ncode = 0;             /* number of code length code lengths */
+  this.nlen = 0;              /* number of length code lengths */
+  this.ndist = 0;             /* number of distance code lengths */
+  this.have = 0;              /* number of code lengths in lens[] */
+  this.next = null;              /* next available space in codes[] */
+
+  this.lens = new utils.Buf16(320); /* temporary storage for code lengths */
+  this.work = new utils.Buf16(288); /* work area for code table building */
+
+  /*
+   because we don't have pointers in js, we use lencode and distcode directly
+   as buffers so we don't need codes
+  */
+  //this.codes = new utils.Buf32(ENOUGH);       /* space for code tables */
+  this.lendyn = null;              /* dynamic table for length/literal codes (JS specific) */
+  this.distdyn = null;             /* dynamic table for distance codes (JS specific) */
+  this.sane = 0;                   /* if false, allow invalid distance too far */
+  this.back = 0;                   /* bits back of last unprocessed length/lit */
+  this.was = 0;                    /* initial length of match */
+}
+
+function inflateResetKeep(strm) {
+  var state;
+
+  if (!strm || !strm.state) { return Z_STREAM_ERROR; }
+  state = strm.state;
+  strm.total_in = strm.total_out = state.total = 0;
+  strm.msg = ''; /*Z_NULL*/
+  if (state.wrap) {       /* to support ill-conceived Java test suite */
+    strm.adler = state.wrap & 1;
+  }
+  state.mode = HEAD;
+  state.last = 0;
+  state.havedict = 0;
+  state.dmax = 32768;
+  state.head = null/*Z_NULL*/;
+  state.hold = 0;
+  state.bits = 0;
+  //state.lencode = state.distcode = state.next = state.codes;
+  state.lencode = state.lendyn = new utils.Buf32(ENOUGH_LENS);
+  state.distcode = state.distdyn = new utils.Buf32(ENOUGH_DISTS);
+
+  state.sane = 1;
+  state.back = -1;
+  //Tracev((stderr, "inflate: reset\n"));
+  return Z_OK;
+}
+
+function inflateReset(strm) {
+  var state;
+
+  if (!strm || !strm.state) { return Z_STREAM_ERROR; }
+  state = strm.state;
+  state.wsize = 0;
+  state.whave = 0;
+  state.wnext = 0;
+  return inflateResetKeep(strm);
+
+}
+
+function inflateReset2(strm, windowBits) {
+  var wrap;
+  var state;
+
+  /* get the state */
+  if (!strm || !strm.state) { return Z_STREAM_ERROR; }
+  state = strm.state;
+
+  /* extract wrap request from windowBits parameter */
+  if (windowBits < 0) {
+    wrap = 0;
+    windowBits = -windowBits;
+  }
+  else {
+    wrap = (windowBits >> 4) + 1;
+    if (windowBits < 48) {
+      windowBits &= 15;
+    }
+  }
+
+  /* set number of window bits, free window if different */
+  if (windowBits && (windowBits < 8 || windowBits > 15)) {
+    return Z_STREAM_ERROR;
+  }
+  if (state.window !== null && state.wbits !== windowBits) {
+    state.window = null;
+  }
+
+  /* update state and reset the rest of it */
+  state.wrap = wrap;
+  state.wbits = windowBits;
+  return inflateReset(strm);
+}
+
+function inflateInit2(strm, windowBits) {
+  var ret;
+  var state;
+
+  if (!strm) { return Z_STREAM_ERROR; }
+  //strm.msg = Z_NULL;                 /* in case we return an error */
+
+  state = new InflateState();
+
+  //if (state === Z_NULL) return Z_MEM_ERROR;
+  //Tracev((stderr, "inflate: allocated\n"));
+  strm.state = state;
+  state.window = null/*Z_NULL*/;
+  ret = inflateReset2(strm, windowBits);
+  if (ret !== Z_OK) {
+    strm.state = null/*Z_NULL*/;
+  }
+  return ret;
+}
+
+function inflateInit(strm) {
+  return inflateInit2(strm, DEF_WBITS);
+}
+
+
+/*
+ Return state with length and distance decoding tables and index sizes set to
+ fixed code decoding.  Normally this returns fixed tables from inffixed.h.
+ If BUILDFIXED is defined, then instead this routine builds the tables the
+ first time it's called, and returns those tables the first time and
+ thereafter.  This reduces the size of the code by about 2K bytes, in
+ exchange for a little execution time.  However, BUILDFIXED should not be
+ used for threaded applications, since the rewriting of the tables and virgin
+ may not be thread-safe.
+ */
+var virgin = true;
+
+var lenfix, distfix; // We have no pointers in JS, so keep tables separate
+
+function fixedtables(state) {
+  /* build fixed huffman tables if first call (may not be thread safe) */
+  if (virgin) {
+    var sym;
+
+    lenfix = new utils.Buf32(512);
+    distfix = new utils.Buf32(32);
+
+    /* literal/length table */
+    sym = 0;
+    while (sym < 144) { state.lens[sym++] = 8; }
+    while (sym < 256) { state.lens[sym++] = 9; }
+    while (sym < 280) { state.lens[sym++] = 7; }
+    while (sym < 288) { state.lens[sym++] = 8; }
+
+    inflate_table(LENS,  state.lens, 0, 288, lenfix,   0, state.work, { bits: 9 });
+
+    /* distance table */
+    sym = 0;
+    while (sym < 32) { state.lens[sym++] = 5; }
+
+    inflate_table(DISTS, state.lens, 0, 32,   distfix, 0, state.work, { bits: 5 });
+
+    /* do this just once */
+    virgin = false;
+  }
+
+  state.lencode = lenfix;
+  state.lenbits = 9;
+  state.distcode = distfix;
+  state.distbits = 5;
+}
+
+
+/*
+ Update the window with the last wsize (normally 32K) bytes written before
+ returning.  If window does not exist yet, create it.  This is only called
+ when a window is already in use, or when output has been written during this
+ inflate call, but the end of the deflate stream has not been reached yet.
+ It is also called to create a window for dictionary data when a dictionary
+ is loaded.
+
+ Providing output buffers larger than 32K to inflate() should provide a speed
+ advantage, since only the last 32K of output is copied to the sliding window
+ upon return from inflate(), and since all distances after the first 32K of
+ output will fall in the output data, making match copies simpler and faster.
+ The advantage may be dependent on the size of the processor's data caches.
+ */
+function updatewindow(strm, src, end, copy) {
+  var dist;
+  var state = strm.state;
+
+  /* if it hasn't been done already, allocate space for the window */
+  if (state.window === null) {
+    state.wsize = 1 << state.wbits;
+    state.wnext = 0;
+    state.whave = 0;
+
+    state.window = new utils.Buf8(state.wsize);
+  }
+
+  /* copy state->wsize or less output bytes into the circular window */
+  if (copy >= state.wsize) {
+    utils.arraySet(state.window, src, end - state.wsize, state.wsize, 0);
+    state.wnext = 0;
+    state.whave = state.wsize;
+  }
+  else {
+    dist = state.wsize - state.wnext;
+    if (dist > copy) {
+      dist = copy;
+    }
+    //zmemcpy(state->window + state->wnext, end - copy, dist);
+    utils.arraySet(state.window, src, end - copy, dist, state.wnext);
+    copy -= dist;
+    if (copy) {
+      //zmemcpy(state->window, end - copy, copy);
+      utils.arraySet(state.window, src, end - copy, copy, 0);
+      state.wnext = copy;
+      state.whave = state.wsize;
+    }
+    else {
+      state.wnext += dist;
+      if (state.wnext === state.wsize) { state.wnext = 0; }
+      if (state.whave < state.wsize) { state.whave += dist; }
+    }
+  }
+  return 0;
+}
+
+function inflate(strm, flush) {
+  var state;
+  var input, output;          // input/output buffers
+  var next;                   /* next input INDEX */
+  var put;                    /* next output INDEX */
+  var have, left;             /* available input and output */
+  var hold;                   /* bit buffer */
+  var bits;                   /* bits in bit buffer */
+  var _in, _out;              /* save starting available input and output */
+  var copy;                   /* number of stored or match bytes to copy */
+  var from;                   /* where to copy match bytes from */
+  var from_source;
+  var here = 0;               /* current decoding table entry */
+  var here_bits, here_op, here_val; // paked "here" denormalized (JS specific)
+  //var last;                   /* parent table entry */
+  var last_bits, last_op, last_val; // paked "last" denormalized (JS specific)
+  var len;                    /* length to copy for repeats, bits to drop */
+  var ret;                    /* return code */
+  var hbuf = new utils.Buf8(4);    /* buffer for gzip header crc calculation */
+  var opts;
+
+  var n; // temporary var for NEED_BITS
+
+  var order = /* permutation of code lengths */
+    [ 16, 17, 18, 0, 8, 7, 9, 6, 10, 5, 11, 4, 12, 3, 13, 2, 14, 1, 15 ];
+
+
+  if (!strm || !strm.state || !strm.output ||
+      (!strm.input && strm.avail_in !== 0)) {
+    return Z_STREAM_ERROR;
+  }
+
+  state = strm.state;
+  if (state.mode === TYPE) { state.mode = TYPEDO; }    /* skip check */
+
+
+  //--- LOAD() ---
+  put = strm.next_out;
+  output = strm.output;
+  left = strm.avail_out;
+  next = strm.next_in;
+  input = strm.input;
+  have = strm.avail_in;
+  hold = state.hold;
+  bits = state.bits;
+  //---
+
+  _in = have;
+  _out = left;
+  ret = Z_OK;
+
+  inf_leave: // goto emulation
+  for (;;) {
+    switch (state.mode) {
+    case HEAD:
+      if (state.wrap === 0) {
+        state.mode = TYPEDO;
+        break;
+      }
+      //=== NEEDBITS(16);
+      while (bits < 16) {
+        if (have === 0) { break inf_leave; }
+        have--;
+        hold += input[next++] << bits;
+        bits += 8;
+      }
+      //===//
+      if ((state.wrap & 2) && hold === 0x8b1f) {  /* gzip header */
+        state.check = 0/*crc32(0L, Z_NULL, 0)*/;
+        //=== CRC2(state.check, hold);
+        hbuf[0] = hold & 0xff;
+        hbuf[1] = (hold >>> 8) & 0xff;
+        state.check = crc32(state.check, hbuf, 2, 0);
+        //===//
+
+        //=== INITBITS();
+        hold = 0;
+        bits = 0;
+        //===//
+        state.mode = FLAGS;
+        break;
+      }
+      state.flags = 0;           /* expect zlib header */
+      if (state.head) {
+        state.head.done = false;
+      }
+      if (!(state.wrap & 1) ||   /* check if zlib header allowed */
+        (((hold & 0xff)/*BITS(8)*/ << 8) + (hold >> 8)) % 31) {
+        strm.msg = 'incorrect header check';
+        state.mode = BAD;
+        break;
+      }
+      if ((hold & 0x0f)/*BITS(4)*/ !== Z_DEFLATED) {
+        strm.msg = 'unknown compression method';
+        state.mode = BAD;
+        break;
+      }
+      //--- DROPBITS(4) ---//
+      hold >>>= 4;
+      bits -= 4;
+      //---//
+      len = (hold & 0x0f)/*BITS(4)*/ + 8;
+      if (state.wbits === 0) {
+        state.wbits = len;
+      }
+      else if (len > state.wbits) {
+        strm.msg = 'invalid window size';
+        state.mode = BAD;
+        break;
+      }
+      state.dmax = 1 << len;
+      //Tracev((stderr, "inflate:   zlib header ok\n"));
+      strm.adler = state.check = 1/*adler32(0L, Z_NULL, 0)*/;
+      state.mode = hold & 0x200 ? DICTID : TYPE;
+      //=== INITBITS();
+      hold = 0;
+      bits = 0;
+      //===//
+      break;
+    case FLAGS:
+      //=== NEEDBITS(16); */
+      while (bits < 16) {
+        if (have === 0) { break inf_leave; }
+        have--;
+        hold += input[next++] << bits;
+        bits += 8;
+      }
+      //===//
+      state.flags = hold;
+      if ((state.flags & 0xff) !== Z_DEFLATED) {
+        strm.msg = 'unknown compression method';
+        state.mode = BAD;
+        break;
+      }
+      if (state.flags & 0xe000) {
+        strm.msg = 'unknown header flags set';
+        state.mode = BAD;
+        break;
+      }
+      if (state.head) {
+        state.head.text = ((hold >> 8) & 1);
+      }
+      if (state.flags & 0x0200) {
+        //=== CRC2(state.check, hold);
+        hbuf[0] = hold & 0xff;
+        hbuf[1] = (hold >>> 8) & 0xff;
+        state.check = crc32(state.check, hbuf, 2, 0);
+        //===//
+      }
+      //=== INITBITS();
+      hold = 0;
+      bits = 0;
+      //===//
+      state.mode = TIME;
+      /* falls through */
+    case TIME:
+      //=== NEEDBITS(32); */
+      while (bits < 32) {
+        if (have === 0) { break inf_leave; }
+        have--;
+        hold += input[next++] << bits;
+        bits += 8;
+      }
+      //===//
+      if (state.head) {
+        state.head.time = hold;
+      }
+      if (state.flags & 0x0200) {
+        //=== CRC4(state.check, hold)
+        hbuf[0] = hold & 0xff;
+        hbuf[1] = (hold >>> 8) & 0xff;
+        hbuf[2] = (hold >>> 16) & 0xff;
+        hbuf[3] = (hold >>> 24) & 0xff;
+        state.check = crc32(state.check, hbuf, 4, 0);
+        //===
+      }
+      //=== INITBITS();
+      hold = 0;
+      bits = 0;
+      //===//
+      state.mode = OS;
+      /* falls through */
+    case OS:
+      //=== NEEDBITS(16); */
+      while (bits < 16) {
+        if (have === 0) { break inf_leave; }
+        have--;
+        hold += input[next++] << bits;
+        bits += 8;
+      }
+      //===//
+      if (state.head) {
+        state.head.xflags = (hold & 0xff);
+        state.head.os = (hold >> 8);
+      }
+      if (state.flags & 0x0200) {
+        //=== CRC2(state.check, hold);
+        hbuf[0] = hold & 0xff;
+        hbuf[1] = (hold >>> 8) & 0xff;
+        state.check = crc32(state.check, hbuf, 2, 0);
+        //===//
+      }
+      //=== INITBITS();
+      hold = 0;
+      bits = 0;
+      //===//
+      state.mode = EXLEN;
+      /* falls through */
+    case EXLEN:
+      if (state.flags & 0x0400) {
+        //=== NEEDBITS(16); */
+        while (bits < 16) {
+          if (have === 0) { break inf_leave; }
+          have--;
+          hold += input[next++] << bits;
+          bits += 8;
+        }
+        //===//
+        state.length = hold;
+        if (state.head) {
+          state.head.extra_len = hold;
+        }
+        if (state.flags & 0x0200) {
+          //=== CRC2(state.check, hold);
+          hbuf[0] = hold & 0xff;
+          hbuf[1] = (hold >>> 8) & 0xff;
+          state.check = crc32(state.check, hbuf, 2, 0);
+          //===//
+        }
+        //=== INITBITS();
+        hold = 0;
+        bits = 0;
+        //===//
+      }
+      else if (state.head) {
+        state.head.extra = null/*Z_NULL*/;
+      }
+      state.mode = EXTRA;
+      /* falls through */
+    case EXTRA:
+      if (state.flags & 0x0400) {
+        copy = state.length;
+        if (copy > have) { copy = have; }
+        if (copy) {
+          if (state.head) {
+            len = state.head.extra_len - state.length;
+            if (!state.head.extra) {
+              // Use untyped array for more conveniend processing later
+              state.head.extra = new Array(state.head.extra_len);
+            }
+            utils.arraySet(
+              state.head.extra,
+              input,
+              next,
+              // extra field is limited to 65536 bytes
+              // - no need for additional size check
+              copy,
+              /*len + copy > state.head.extra_max - len ? state.head.extra_max : copy,*/
+              len
+            );
+            //zmemcpy(state.head.extra + len, next,
+            //        len + copy > state.head.extra_max ?
+            //        state.head.extra_max - len : copy);
+          }
+          if (state.flags & 0x0200) {
+            state.check = crc32(state.check, input, copy, next);
+          }
+          have -= copy;
+          next += copy;
+          state.length -= copy;
+        }
+        if (state.length) { break inf_leave; }
+      }
+      state.length = 0;
+      state.mode = NAME;
+      /* falls through */
+    case NAME:
+      if (state.flags & 0x0800) {
+        if (have === 0) { break inf_leave; }
+        copy = 0;
+        do {
+          // TODO: 2 or 1 bytes?
+          len = input[next + copy++];
+          /* use constant limit because in js we should not preallocate memory */
+          if (state.head && len &&
+              (state.length < 65536 /*state.head.name_max*/)) {
+            state.head.name += String.fromCharCode(len);
+          }
+        } while (len && copy < have);
+
+        if (state.flags & 0x0200) {
+          state.check = crc32(state.check, input, copy, next);
+        }
+        have -= copy;
+        next += copy;
+        if (len) { break inf_leave; }
+      }
+      else if (state.head) {
+        state.head.name = null;
+      }
+      state.length = 0;
+      state.mode = COMMENT;
+      /* falls through */
+    case COMMENT:
+      if (state.flags & 0x1000) {
+        if (have === 0) { break inf_leave; }
+        copy = 0;
+        do {
+          len = input[next + copy++];
+          /* use constant limit because in js we should not preallocate memory */
+          if (state.head && len &&
+              (state.length < 65536 /*state.head.comm_max*/)) {
+            state.head.comment += String.fromCharCode(len);
+          }
+        } while (len && copy < have);
+        if (state.flags & 0x0200) {
+          state.check = crc32(state.check, input, copy, next);
+        }
+        have -= copy;
+        next += copy;
+        if (len) { break inf_leave; }
+      }
+      else if (state.head) {
+        state.head.comment = null;
+      }
+      state.mode = HCRC;
+      /* falls through */
+    case HCRC:
+      if (state.flags & 0x0200) {
+        //=== NEEDBITS(16); */
+        while (bits < 16) {
+          if (have === 0) { break inf_leave; }
+          have--;
+          hold += input[next++] << bits;
+          bits += 8;
+        }
+        //===//
+        if (hold !== (state.check & 0xffff)) {
+          strm.msg = 'header crc mismatch';
+          state.mode = BAD;
+          break;
+        }
+        //=== INITBITS();
+        hold = 0;
+        bits = 0;
+        //===//
+      }
+      if (state.head) {
+        state.head.hcrc = ((state.flags >> 9) & 1);
+        state.head.done = true;
+      }
+      strm.adler = state.check = 0;
+      state.mode = TYPE;
+      break;
+    case DICTID:
+      //=== NEEDBITS(32); */
+      while (bits < 32) {
+        if (have === 0) { break inf_leave; }
+        have--;
+        hold += input[next++] << bits;
+        bits += 8;
+      }
+      //===//
+      strm.adler = state.check = zswap32(hold);
+      //=== INITBITS();
+      hold = 0;
+      bits = 0;
+      //===//
+      state.mode = DICT;
+      /* falls through */
+    case DICT:
+      if (state.havedict === 0) {
+        //--- RESTORE() ---
+        strm.next_out = put;
+        strm.avail_out = left;
+        strm.next_in = next;
+        strm.avail_in = have;
+        state.hold = hold;
+        state.bits = bits;
+        //---
+        return Z_NEED_DICT;
+      }
+      strm.adler = state.check = 1/*adler32(0L, Z_NULL, 0)*/;
+      state.mode = TYPE;
+      /* falls through */
+    case TYPE:
+      if (flush === Z_BLOCK || flush === Z_TREES) { break inf_leave; }
+      /* falls through */
+    case TYPEDO:
+      if (state.last) {
+        //--- BYTEBITS() ---//
+        hold >>>= bits & 7;
+        bits -= bits & 7;
+        //---//
+        state.mode = CHECK;
+        break;
+      }
+      //=== NEEDBITS(3); */
+      while (bits < 3) {
+        if (have === 0) { break inf_leave; }
+        have--;
+        hold += input[next++] << bits;
+        bits += 8;
+      }
+      //===//
+      state.last = (hold & 0x01)/*BITS(1)*/;
+      //--- DROPBITS(1) ---//
+      hold >>>= 1;
+      bits -= 1;
+      //---//
+
+      switch ((hold & 0x03)/*BITS(2)*/) {
+      case 0:                             /* stored block */
+        //Tracev((stderr, "inflate:     stored block%s\n",
+        //        state.last ? " (last)" : ""));
+        state.mode = STORED;
+        break;
+      case 1:                             /* fixed block */
+        fixedtables(state);
+        //Tracev((stderr, "inflate:     fixed codes block%s\n",
+        //        state.last ? " (last)" : ""));
+        state.mode = LEN_;             /* decode codes */
+        if (flush === Z_TREES) {
+          //--- DROPBITS(2) ---//
+          hold >>>= 2;
+          bits -= 2;
+          //---//
+          break inf_leave;
+        }
+        break;
+      case 2:                             /* dynamic block */
+        //Tracev((stderr, "inflate:     dynamic codes block%s\n",
+        //        state.last ? " (last)" : ""));
+        state.mode = TABLE;
+        break;
+      case 3:
+        strm.msg = 'invalid block type';
+        state.mode = BAD;
+      }
+      //--- DROPBITS(2) ---//
+      hold >>>= 2;
+      bits -= 2;
+      //---//
+      break;
+    case STORED:
+      //--- BYTEBITS() ---// /* go to byte boundary */
+      hold >>>= bits & 7;
+      bits -= bits & 7;
+      //---//
+      //=== NEEDBITS(32); */
+      while (bits < 32) {
+        if (have === 0) { break inf_leave; }
+        have--;
+        hold += input[next++] << bits;
+        bits += 8;
+      }
+      //===//
+      if ((hold & 0xffff) !== ((hold >>> 16) ^ 0xffff)) {
+        strm.msg = 'invalid stored block lengths';
+        state.mode = BAD;
+        break;
+      }
+      state.length = hold & 0xffff;
+      //Tracev((stderr, "inflate:       stored length %u\n",
+      //        state.length));
+      //=== INITBITS();
+      hold = 0;
+      bits = 0;
+      //===//
+      state.mode = COPY_;
+      if (flush === Z_TREES) { break inf_leave; }
+      /* falls through */
+    case COPY_:
+      state.mode = COPY;
+      /* falls through */
+    case COPY:
+      copy = state.length;
+      if (copy) {
+        if (copy > have) { copy = have; }
+        if (copy > left) { copy = left; }
+        if (copy === 0) { break inf_leave; }
+        //--- zmemcpy(put, next, copy); ---
+        utils.arraySet(output, input, next, copy, put);
+        //---//
+        have -= copy;
+        next += copy;
+        left -= copy;
+        put += copy;
+        state.length -= copy;
+        break;
+      }
+      //Tracev((stderr, "inflate:       stored end\n"));
+      state.mode = TYPE;
+      break;
+    case TABLE:
+      //=== NEEDBITS(14); */
+      while (bits < 14) {
+        if (have === 0) { break inf_leave; }
+        have--;
+        hold += input[next++] << bits;
+        bits += 8;
+      }
+      //===//
+      state.nlen = (hold & 0x1f)/*BITS(5)*/ + 257;
+      //--- DROPBITS(5) ---//
+      hold >>>= 5;
+      bits -= 5;
+      //---//
+      state.ndist = (hold & 0x1f)/*BITS(5)*/ + 1;
+      //--- DROPBITS(5) ---//
+      hold >>>= 5;
+      bits -= 5;
+      //---//
+      state.ncode = (hold & 0x0f)/*BITS(4)*/ + 4;
+      //--- DROPBITS(4) ---//
+      hold >>>= 4;
+      bits -= 4;
+      //---//
+//#ifndef PKZIP_BUG_WORKAROUND
+      if (state.nlen > 286 || state.ndist > 30) {
+        strm.msg = 'too many length or distance symbols';
+        state.mode = BAD;
+        break;
+      }
+//#endif
+      //Tracev((stderr, "inflate:       table sizes ok\n"));
+      state.have = 0;
+      state.mode = LENLENS;
+      /* falls through */
+    case LENLENS:
+      while (state.have < state.ncode) {
+        //=== NEEDBITS(3);
+        while (bits < 3) {
+          if (have === 0) { break inf_leave; }
+          have--;
+          hold += input[next++] << bits;
+          bits += 8;
+        }
+        //===//
+        state.lens[order[state.have++]] = (hold & 0x07);//BITS(3);
+        //--- DROPBITS(3) ---//
+        hold >>>= 3;
+        bits -= 3;
+        //---//
+      }
+      while (state.have < 19) {
+        state.lens[order[state.have++]] = 0;
+      }
+      // We have separate tables & no pointers. 2 commented lines below not needed.
+      //state.next = state.codes;
+      //state.lencode = state.next;
+      // Switch to use dynamic table
+      state.lencode = state.lendyn;
+      state.lenbits = 7;
+
+      opts = { bits: state.lenbits };
+      ret = inflate_table(CODES, state.lens, 0, 19, state.lencode, 0, state.work, opts);
+      state.lenbits = opts.bits;
+
+      if (ret) {
+        strm.msg = 'invalid code lengths set';
+        state.mode = BAD;
+        break;
+      }
+      //Tracev((stderr, "inflate:       code lengths ok\n"));
+      state.have = 0;
+      state.mode = CODELENS;
+      /* falls through */
+    case CODELENS:
+      while (state.have < state.nlen + state.ndist) {
+        for (;;) {
+          here = state.lencode[hold & ((1 << state.lenbits) - 1)];/*BITS(state.lenbits)*/
+          here_bits = here >>> 24;
+          here_op = (here >>> 16) & 0xff;
+          here_val = here & 0xffff;
+
+          if ((here_bits) <= bits) { break; }
+          //--- PULLBYTE() ---//
+          if (have === 0) { break inf_leave; }
+          have--;
+          hold += input[next++] << bits;
+          bits += 8;
+          //---//
+        }
+        if (here_val < 16) {
+          //--- DROPBITS(here.bits) ---//
+          hold >>>= here_bits;
+          bits -= here_bits;
+          //---//
+          state.lens[state.have++] = here_val;
+        }
+        else {
+          if (here_val === 16) {
+            //=== NEEDBITS(here.bits + 2);
+            n = here_bits + 2;
+            while (bits < n) {
+              if (have === 0) { break inf_leave; }
+              have--;
+              hold += input[next++] << bits;
+              bits += 8;
+            }
+            //===//
+            //--- DROPBITS(here.bits) ---//
+            hold >>>= here_bits;
+            bits -= here_bits;
+            //---//
+            if (state.have === 0) {
+              strm.msg = 'invalid bit length repeat';
+              state.mode = BAD;
+              break;
+            }
+            len = state.lens[state.have - 1];
+            copy = 3 + (hold & 0x03);//BITS(2);
+            //--- DROPBITS(2) ---//
+            hold >>>= 2;
+            bits -= 2;
+            //---//
+          }
+          else if (here_val === 17) {
+            //=== NEEDBITS(here.bits + 3);
+            n = here_bits + 3;
+            while (bits < n) {
+              if (have === 0) { break inf_leave; }
+              have--;
+              hold += input[next++] << bits;
+              bits += 8;
+            }
+            //===//
+            //--- DROPBITS(here.bits) ---//
+            hold >>>= here_bits;
+            bits -= here_bits;
+            //---//
+            len = 0;
+            copy = 3 + (hold & 0x07);//BITS(3);
+            //--- DROPBITS(3) ---//
+            hold >>>= 3;
+            bits -= 3;
+            //---//
+          }
+          else {
+            //=== NEEDBITS(here.bits + 7);
+            n = here_bits + 7;
+            while (bits < n) {
+              if (have === 0) { break inf_leave; }
+              have--;
+              hold += input[next++] << bits;
+              bits += 8;
+            }
+            //===//
+            //--- DROPBITS(here.bits) ---//
+            hold >>>= here_bits;
+            bits -= here_bits;
+            //---//
+            len = 0;
+            copy = 11 + (hold & 0x7f);//BITS(7);
+            //--- DROPBITS(7) ---//
+            hold >>>= 7;
+            bits -= 7;
+            //---//
+          }
+          if (state.have + copy > state.nlen + state.ndist) {
+            strm.msg = 'invalid bit length repeat';
+            state.mode = BAD;
+            break;
+          }
+          while (copy--) {
+            state.lens[state.have++] = len;
+          }
+        }
+      }
+
+      /* handle error breaks in while */
+      if (state.mode === BAD) { break; }
+
+      /* check for end-of-block code (better have one) */
+      if (state.lens[256] === 0) {
+        strm.msg = 'invalid code -- missing end-of-block';
+        state.mode = BAD;
+        break;
+      }
+
+      /* build code tables -- note: do not change the lenbits or distbits
+         values here (9 and 6) without reading the comments in inftrees.h
+         concerning the ENOUGH constants, which depend on those values */
+      state.lenbits = 9;
+
+      opts = { bits: state.lenbits };
+      ret = inflate_table(LENS, state.lens, 0, state.nlen, state.lencode, 0, state.work, opts);
+      // We have separate tables & no pointers. 2 commented lines below not needed.
+      // state.next_index = opts.table_index;
+      state.lenbits = opts.bits;
+      // state.lencode = state.next;
+
+      if (ret) {
+        strm.msg = 'invalid literal/lengths set';
+        state.mode = BAD;
+        break;
+      }
+
+      state.distbits = 6;
+      //state.distcode.copy(state.codes);
+      // Switch to use dynamic table
+      state.distcode = state.distdyn;
+      opts = { bits: state.distbits };
+      ret = inflate_table(DISTS, state.lens, state.nlen, state.ndist, state.distcode, 0, state.work, opts);
+      // We have separate tables & no pointers. 2 commented lines below not needed.
+      // state.next_index = opts.table_index;
+      state.distbits = opts.bits;
+      // state.distcode = state.next;
+
+      if (ret) {
+        strm.msg = 'invalid distances set';
+        state.mode = BAD;
+        break;
+      }
+      //Tracev((stderr, 'inflate:       codes ok\n'));
+      state.mode = LEN_;
+      if (flush === Z_TREES) { break inf_leave; }
+      /* falls through */
+    case LEN_:
+      state.mode = LEN;
+      /* falls through */
+    case LEN:
+      if (have >= 6 && left >= 258) {
+        //--- RESTORE() ---
+        strm.next_out = put;
+        strm.avail_out = left;
+        strm.next_in = next;
+        strm.avail_in = have;
+        state.hold = hold;
+        state.bits = bits;
+        //---
+        inflate_fast(strm, _out);
+        //--- LOAD() ---
+        put = strm.next_out;
+        output = strm.output;
+        left = strm.avail_out;
+        next = strm.next_in;
+        input = strm.input;
+        have = strm.avail_in;
+        hold = state.hold;
+        bits = state.bits;
+        //---
+
+        if (state.mode === TYPE) {
+          state.back = -1;
+        }
+        break;
+      }
+      state.back = 0;
+      for (;;) {
+        here = state.lencode[hold & ((1 << state.lenbits) - 1)];  /*BITS(state.lenbits)*/
+        here_bits = here >>> 24;
+        here_op = (here >>> 16) & 0xff;
+        here_val = here & 0xffff;
+
+        if (here_bits <= bits) { break; }
+        //--- PULLBYTE() ---//
+        if (have === 0) { break inf_leave; }
+        have--;
+        hold += input[next++] << bits;
+        bits += 8;
+        //---//
+      }
+      if (here_op && (here_op & 0xf0) === 0) {
+        last_bits = here_bits;
+        last_op = here_op;
+        last_val = here_val;
+        for (;;) {
+          here = state.lencode[last_val +
+                  ((hold & ((1 << (last_bits + last_op)) - 1))/*BITS(last.bits + last.op)*/ >> last_bits)];
+          here_bits = here >>> 24;
+          here_op = (here >>> 16) & 0xff;
+          here_val = here & 0xffff;
+
+          if ((last_bits + here_bits) <= bits) { break; }
+          //--- PULLBYTE() ---//
+          if (have === 0) { break inf_leave; }
+          have--;
+          hold += input[next++] << bits;
+          bits += 8;
+          //---//
+        }
+        //--- DROPBITS(last.bits) ---//
+        hold >>>= last_bits;
+        bits -= last_bits;
+        //---//
+        state.back += last_bits;
+      }
+      //--- DROPBITS(here.bits) ---//
+      hold >>>= here_bits;
+      bits -= here_bits;
+      //---//
+      state.back += here_bits;
+      state.length = here_val;
+      if (here_op === 0) {
+        //Tracevv((stderr, here.val >= 0x20 && here.val < 0x7f ?
+        //        "inflate:         literal '%c'\n" :
+        //        "inflate:         literal 0x%02x\n", here.val));
+        state.mode = LIT;
+        break;
+      }
+      if (here_op & 32) {
+        //Tracevv((stderr, "inflate:         end of block\n"));
+        state.back = -1;
+        state.mode = TYPE;
+        break;
+      }
+      if (here_op & 64) {
+        strm.msg = 'invalid literal/length code';
+        state.mode = BAD;
+        break;
+      }
+      state.extra = here_op & 15;
+      state.mode = LENEXT;
+      /* falls through */
+    case LENEXT:
+      if (state.extra) {
+        //=== NEEDBITS(state.extra);
+        n = state.extra;
+        while (bits < n) {
+          if (have === 0) { break inf_leave; }
+          have--;
+          hold += input[next++] << bits;
+          bits += 8;
+        }
+        //===//
+        state.length += hold & ((1 << state.extra) - 1)/*BITS(state.extra)*/;
+        //--- DROPBITS(state.extra) ---//
+        hold >>>= state.extra;
+        bits -= state.extra;
+        //---//
+        state.back += state.extra;
+      }
+      //Tracevv((stderr, "inflate:         length %u\n", state.length));
+      state.was = state.length;
+      state.mode = DIST;
+      /* falls through */
+    case DIST:
+      for (;;) {
+        here = state.distcode[hold & ((1 << state.distbits) - 1)];/*BITS(state.distbits)*/
+        here_bits = here >>> 24;
+        here_op = (here >>> 16) & 0xff;
+        here_val = here & 0xffff;
+
+        if ((here_bits) <= bits) { break; }
+        //--- PULLBYTE() ---//
+        if (have === 0) { break inf_leave; }
+        have--;
+        hold += input[next++] << bits;
+        bits += 8;
+        //---//
+      }
+      if ((here_op & 0xf0) === 0) {
+        last_bits = here_bits;
+        last_op = here_op;
+        last_val = here_val;
+        for (;;) {
+          here = state.distcode[last_val +
+                  ((hold & ((1 << (last_bits + last_op)) - 1))/*BITS(last.bits + last.op)*/ >> last_bits)];
+          here_bits = here >>> 24;
+          here_op = (here >>> 16) & 0xff;
+          here_val = here & 0xffff;
+
+          if ((last_bits + here_bits) <= bits) { break; }
+          //--- PULLBYTE() ---//
+          if (have === 0) { break inf_leave; }
+          have--;
+          hold += input[next++] << bits;
+          bits += 8;
+          //---//
+        }
+        //--- DROPBITS(last.bits) ---//
+        hold >>>= last_bits;
+        bits -= last_bits;
+        //---//
+        state.back += last_bits;
+      }
+      //--- DROPBITS(here.bits) ---//
+      hold >>>= here_bits;
+      bits -= here_bits;
+      //---//
+      state.back += here_bits;
+      if (here_op & 64) {
+        strm.msg = 'invalid distance code';
+        state.mode = BAD;
+        break;
+      }
+      state.offset = here_val;
+      state.extra = (here_op) & 15;
+      state.mode = DISTEXT;
+      /* falls through */
+    case DISTEXT:
+      if (state.extra) {
+        //=== NEEDBITS(state.extra);
+        n = state.extra;
+        while (bits < n) {
+          if (have === 0) { break inf_leave; }
+          have--;
+          hold += input[next++] << bits;
+          bits += 8;
+        }
+        //===//
+        state.offset += hold & ((1 << state.extra) - 1)/*BITS(state.extra)*/;
+        //--- DROPBITS(state.extra) ---//
+        hold >>>= state.extra;
+        bits -= state.extra;
+        //---//
+        state.back += state.extra;
+      }
+//#ifdef INFLATE_STRICT
+      if (state.offset > state.dmax) {
+        strm.msg = 'invalid distance too far back';
+        state.mode = BAD;
+        break;
+      }
+//#endif
+      //Tracevv((stderr, "inflate:         distance %u\n", state.offset));
+      state.mode = MATCH;
+      /* falls through */
+    case MATCH:
+      if (left === 0) { break inf_leave; }
+      copy = _out - left;
+      if (state.offset > copy) {         /* copy from window */
+        copy = state.offset - copy;
+        if (copy > state.whave) {
+          if (state.sane) {
+            strm.msg = 'invalid distance too far back';
+            state.mode = BAD;
+            break;
+          }
+// (!) This block is disabled in zlib defailts,
+// don't enable it for binary compatibility
+//#ifdef INFLATE_ALLOW_INVALID_DISTANCE_TOOFAR_ARRR
+//          Trace((stderr, "inflate.c too far\n"));
+//          copy -= state.whave;
+//          if (copy > state.length) { copy = state.length; }
+//          if (copy > left) { copy = left; }
+//          left -= copy;
+//          state.length -= copy;
+//          do {
+//            output[put++] = 0;
+//          } while (--copy);
+//          if (state.length === 0) { state.mode = LEN; }
+//          break;
+//#endif
+        }
+        if (copy > state.wnext) {
+          copy -= state.wnext;
+          from = state.wsize - copy;
+        }
+        else {
+          from = state.wnext - copy;
+        }
+        if (copy > state.length) { copy = state.length; }
+        from_source = state.window;
+      }
+      else {                              /* copy from output */
+        from_source = output;
+        from = put - state.offset;
+        copy = state.length;
+      }
+      if (copy > left) { copy = left; }
+      left -= copy;
+      state.length -= copy;
+      do {
+        output[put++] = from_source[from++];
+      } while (--copy);
+      if (state.length === 0) { state.mode = LEN; }
+      break;
+    case LIT:
+      if (left === 0) { break inf_leave; }
+      output[put++] = state.length;
+      left--;
+      state.mode = LEN;
+      break;
+    case CHECK:
+      if (state.wrap) {
+        //=== NEEDBITS(32);
+        while (bits < 32) {
+          if (have === 0) { break inf_leave; }
+          have--;
+          // Use '|' insdead of '+' to make sure that result is signed
+          hold |= input[next++] << bits;
+          bits += 8;
+        }
+        //===//
+        _out -= left;
+        strm.total_out += _out;
+        state.total += _out;
+        if (_out) {
+          strm.adler = state.check =
+              /*UPDATE(state.check, put - _out, _out);*/
+              (state.flags ? crc32(state.check, output, _out, put - _out) : adler32(state.check, output, _out, put - _out));
+
+        }
+        _out = left;
+        // NB: crc32 stored as signed 32-bit int, zswap32 returns signed too
+        if ((state.flags ? hold : zswap32(hold)) !== state.check) {
+          strm.msg = 'incorrect data check';
+          state.mode = BAD;
+          break;
+        }
+        //=== INITBITS();
+        hold = 0;
+        bits = 0;
+        //===//
+        //Tracev((stderr, "inflate:   check matches trailer\n"));
+      }
+      state.mode = LENGTH;
+      /* falls through */
+    case LENGTH:
+      if (state.wrap && state.flags) {
+        //=== NEEDBITS(32);
+        while (bits < 32) {
+          if (have === 0) { break inf_leave; }
+          have--;
+          hold += input[next++] << bits;
+          bits += 8;
+        }
+        //===//
+        if (hold !== (state.total & 0xffffffff)) {
+          strm.msg = 'incorrect length check';
+          state.mode = BAD;
+          break;
+        }
+        //=== INITBITS();
+        hold = 0;
+        bits = 0;
+        //===//
+        //Tracev((stderr, "inflate:   length matches trailer\n"));
+      }
+      state.mode = DONE;
+      /* falls through */
+    case DONE:
+      ret = Z_STREAM_END;
+      break inf_leave;
+    case BAD:
+      ret = Z_DATA_ERROR;
+      break inf_leave;
+    case MEM:
+      return Z_MEM_ERROR;
+    case SYNC:
+      /* falls through */
+    default:
+      return Z_STREAM_ERROR;
+    }
+  }
+
+  // inf_leave <- here is real place for "goto inf_leave", emulated via "break inf_leave"
+
+  /*
+     Return from inflate(), updating the total counts and the check value.
+     If there was no progress during the inflate() call, return a buffer
+     error.  Call updatewindow() to create and/or update the window state.
+     Note: a memory error from inflate() is non-recoverable.
+   */
+
+  //--- RESTORE() ---
+  strm.next_out = put;
+  strm.avail_out = left;
+  strm.next_in = next;
+  strm.avail_in = have;
+  state.hold = hold;
+  state.bits = bits;
+  //---
+
+  if (state.wsize || (_out !== strm.avail_out && state.mode < BAD &&
+                      (state.mode < CHECK || flush !== Z_FINISH))) {
+    if (updatewindow(strm, strm.output, strm.next_out, _out - strm.avail_out)) {
+      state.mode = MEM;
+      return Z_MEM_ERROR;
+    }
+  }
+  _in -= strm.avail_in;
+  _out -= strm.avail_out;
+  strm.total_in += _in;
+  strm.total_out += _out;
+  state.total += _out;
+  if (state.wrap && _out) {
+    strm.adler = state.check = /*UPDATE(state.check, strm.next_out - _out, _out);*/
+      (state.flags ? crc32(state.check, output, _out, strm.next_out - _out) : adler32(state.check, output, _out, strm.next_out - _out));
+  }
+  strm.data_type = state.bits + (state.last ? 64 : 0) +
+                    (state.mode === TYPE ? 128 : 0) +
+                    (state.mode === LEN_ || state.mode === COPY_ ? 256 : 0);
+  if (((_in === 0 && _out === 0) || flush === Z_FINISH) && ret === Z_OK) {
+    ret = Z_BUF_ERROR;
+  }
+  return ret;
+}
+
+function inflateEnd(strm) {
+
+  if (!strm || !strm.state /*|| strm->zfree == (free_func)0*/) {
+    return Z_STREAM_ERROR;
+  }
+
+  var state = strm.state;
+  if (state.window) {
+    state.window = null;
+  }
+  strm.state = null;
+  return Z_OK;
+}
+
+function inflateGetHeader(strm, head) {
+  var state;
+
+  /* check state */
+  if (!strm || !strm.state) { return Z_STREAM_ERROR; }
+  state = strm.state;
+  if ((state.wrap & 2) === 0) { return Z_STREAM_ERROR; }
+
+  /* save header structure */
+  state.head = head;
+  head.done = false;
+  return Z_OK;
+}
+
+function inflateSetDictionary(strm, dictionary) {
+  var dictLength = dictionary.length;
+
+  var state;
+  var dictid;
+  var ret;
+
+  /* check state */
+  if (!strm /* == Z_NULL */ || !strm.state /* == Z_NULL */) { return Z_STREAM_ERROR; }
+  state = strm.state;
+
+  if (state.wrap !== 0 && state.mode !== DICT) {
+    return Z_STREAM_ERROR;
+  }
+
+  /* check for correct dictionary identifier */
+  if (state.mode === DICT) {
+    dictid = 1; /* adler32(0, null, 0)*/
+    /* dictid = adler32(dictid, dictionary, dictLength); */
+    dictid = adler32(dictid, dictionary, dictLength, 0);
+    if (dictid !== state.check) {
+      return Z_DATA_ERROR;
+    }
+  }
+  /* copy dictionary to window using updatewindow(), which will amend the
+   existing dictionary if appropriate */
+  ret = updatewindow(strm, dictionary, dictLength, dictLength);
+  if (ret) {
+    state.mode = MEM;
+    return Z_MEM_ERROR;
+  }
+  state.havedict = 1;
+  // Tracev((stderr, "inflate:   dictionary set\n"));
+  return Z_OK;
+}
+
+exports.inflateReset = inflateReset;
+exports.inflateReset2 = inflateReset2;
+exports.inflateResetKeep = inflateResetKeep;
+exports.inflateInit = inflateInit;
+exports.inflateInit2 = inflateInit2;
+exports.inflate = inflate;
+exports.inflateEnd = inflateEnd;
+exports.inflateGetHeader = inflateGetHeader;
+exports.inflateSetDictionary = inflateSetDictionary;
+exports.inflateInfo = 'pako inflate (from Nodeca project)';
+
+/* Not implemented
+exports.inflateCopy = inflateCopy;
+exports.inflateGetDictionary = inflateGetDictionary;
+exports.inflateMark = inflateMark;
+exports.inflatePrime = inflatePrime;
+exports.inflateSync = inflateSync;
+exports.inflateSyncPoint = inflateSyncPoint;
+exports.inflateUndermine = inflateUndermine;
+*/
+
+},{"../utils/common":62,"./adler32":64,"./crc32":66,"./inffast":69,"./inftrees":71}],71:[function(require,module,exports){
+'use strict';
+
+// (C) 1995-2013 Jean-loup Gailly and Mark Adler
+// (C) 2014-2017 Vitaly Puzrin and Andrey Tupitsin
+//
+// This software is provided 'as-is', without any express or implied
+// warranty. In no event will the authors be held liable for any damages
+// arising from the use of this software.
+//
+// Permission is granted to anyone to use this software for any purpose,
+// including commercial applications, and to alter it and redistribute it
+// freely, subject to the following restrictions:
+//
+// 1. The origin of this software must not be misrepresented; you must not
+//   claim that you wrote the original software. If you use this software
+//   in a product, an acknowledgment in the product documentation would be
+//   appreciated but is not required.
+// 2. Altered source versions must be plainly marked as such, and must not be
+//   misrepresented as being the original software.
+// 3. This notice may not be removed or altered from any source distribution.
+
+var utils = require('../utils/common');
+
+var MAXBITS = 15;
+var ENOUGH_LENS = 852;
+var ENOUGH_DISTS = 592;
+//var ENOUGH = (ENOUGH_LENS+ENOUGH_DISTS);
+
+var CODES = 0;
+var LENS = 1;
+var DISTS = 2;
+
+var lbase = [ /* Length codes 257..285 base */
+  3, 4, 5, 6, 7, 8, 9, 10, 11, 13, 15, 17, 19, 23, 27, 31,
+  35, 43, 51, 59, 67, 83, 99, 115, 131, 163, 195, 227, 258, 0, 0
+];
+
+var lext = [ /* Length codes 257..285 extra */
+  16, 16, 16, 16, 16, 16, 16, 16, 17, 17, 17, 17, 18, 18, 18, 18,
+  19, 19, 19, 19, 20, 20, 20, 20, 21, 21, 21, 21, 16, 72, 78
+];
+
+var dbase = [ /* Distance codes 0..29 base */
+  1, 2, 3, 4, 5, 7, 9, 13, 17, 25, 33, 49, 65, 97, 129, 193,
+  257, 385, 513, 769, 1025, 1537, 2049, 3073, 4097, 6145,
+  8193, 12289, 16385, 24577, 0, 0
+];
+
+var dext = [ /* Distance codes 0..29 extra */
+  16, 16, 16, 16, 17, 17, 18, 18, 19, 19, 20, 20, 21, 21, 22, 22,
+  23, 23, 24, 24, 25, 25, 26, 26, 27, 27,
+  28, 28, 29, 29, 64, 64
+];
+
+module.exports = function inflate_table(type, lens, lens_index, codes, table, table_index, work, opts)
+{
+  var bits = opts.bits;
+      //here = opts.here; /* table entry for duplication */
+
+  var len = 0;               /* a code's length in bits */
+  var sym = 0;               /* index of code symbols */
+  var min = 0, max = 0;          /* minimum and maximum code lengths */
+  var root = 0;              /* number of index bits for root table */
+  var curr = 0;              /* number of index bits for current table */
+  var drop = 0;              /* code bits to drop for sub-table */
+  var left = 0;                   /* number of prefix codes available */
+  var used = 0;              /* code entries in table used */
+  var huff = 0;              /* Huffman code */
+  var incr;              /* for incrementing code, index */
+  var fill;              /* index for replicating entries */
+  var low;               /* low bits for current root entry */
+  var mask;              /* mask for low root bits */
+  var next;             /* next available space in table */
+  var base = null;     /* base value table to use */
+  var base_index = 0;
+//  var shoextra;    /* extra bits table to use */
+  var end;                    /* use base and extra for symbol > end */
+  var count = new utils.Buf16(MAXBITS + 1); //[MAXBITS+1];    /* number of codes of each length */
+  var offs = new utils.Buf16(MAXBITS + 1); //[MAXBITS+1];     /* offsets in table for each length */
+  var extra = null;
+  var extra_index = 0;
+
+  var here_bits, here_op, here_val;
+
+  /*
+   Process a set of code lengths to create a canonical Huffman code.  The
+   code lengths are lens[0..codes-1].  Each length corresponds to the
+   symbols 0..codes-1.  The Huffman code is generated by first sorting the
+   symbols by length from short to long, and retaining the symbol order
+   for codes with equal lengths.  Then the code starts with all zero bits
+   for the first code of the shortest length, and the codes are integer
+   increments for the same length, and zeros are appended as the length
+   increases.  For the deflate format, these bits are stored backwards
+   from their more natural integer increment ordering, and so when the
+   decoding tables are built in the large loop below, the integer codes
+   are incremented backwards.
+
+   This routine assumes, but does not check, that all of the entries in
+   lens[] are in the range 0..MAXBITS.  The caller must assure this.
+   1..MAXBITS is interpreted as that code length.  zero means that that
+   symbol does not occur in this code.
+
+   The codes are sorted by computing a count of codes for each length,
+   creating from that a table of starting indices for each length in the
+   sorted table, and then entering the symbols in order in the sorted
+   table.  The sorted table is work[], with that space being provided by
+   the caller.
+
+   The length counts are used for other purposes as well, i.e. finding
+   the minimum and maximum length codes, determining if there are any
+   codes at all, checking for a valid set of lengths, and looking ahead
+   at length counts to determine sub-table sizes when building the
+   decoding tables.
+   */
+
+  /* accumulate lengths for codes (assumes lens[] all in 0..MAXBITS) */
+  for (len = 0; len <= MAXBITS; len++) {
+    count[len] = 0;
+  }
+  for (sym = 0; sym < codes; sym++) {
+    count[lens[lens_index + sym]]++;
+  }
+
+  /* bound code lengths, force root to be within code lengths */
+  root = bits;
+  for (max = MAXBITS; max >= 1; max--) {
+    if (count[max] !== 0) { break; }
+  }
+  if (root > max) {
+    root = max;
+  }
+  if (max === 0) {                     /* no symbols to code at all */
+    //table.op[opts.table_index] = 64;  //here.op = (var char)64;    /* invalid code marker */
+    //table.bits[opts.table_index] = 1;   //here.bits = (var char)1;
+    //table.val[opts.table_index++] = 0;   //here.val = (var short)0;
+    table[table_index++] = (1 << 24) | (64 << 16) | 0;
+
+
+    //table.op[opts.table_index] = 64;
+    //table.bits[opts.table_index] = 1;
+    //table.val[opts.table_index++] = 0;
+    table[table_index++] = (1 << 24) | (64 << 16) | 0;
+
+    opts.bits = 1;
+    return 0;     /* no symbols, but wait for decoding to report error */
+  }
+  for (min = 1; min < max; min++) {
+    if (count[min] !== 0) { break; }
+  }
+  if (root < min) {
+    root = min;
+  }
+
+  /* check for an over-subscribed or incomplete set of lengths */
+  left = 1;
+  for (len = 1; len <= MAXBITS; len++) {
+    left <<= 1;
+    left -= count[len];
+    if (left < 0) {
+      return -1;
+    }        /* over-subscribed */
+  }
+  if (left > 0 && (type === CODES || max !== 1)) {
+    return -1;                      /* incomplete set */
+  }
+
+  /* generate offsets into symbol table for each length for sorting */
+  offs[1] = 0;
+  for (len = 1; len < MAXBITS; len++) {
+    offs[len + 1] = offs[len] + count[len];
+  }
+
+  /* sort symbols by length, by symbol order within each length */
+  for (sym = 0; sym < codes; sym++) {
+    if (lens[lens_index + sym] !== 0) {
+      work[offs[lens[lens_index + sym]]++] = sym;
+    }
+  }
+
+  /*
+   Create and fill in decoding tables.  In this loop, the table being
+   filled is at next and has curr index bits.  The code being used is huff
+   with length len.  That code is converted to an index by dropping drop
+   bits off of the bottom.  For codes where len is less than drop + curr,
+   those top drop + curr - len bits are incremented through all values to
+   fill the table with replicated entries.
+
+   root is the number of index bits for the root table.  When len exceeds
+   root, sub-tables are created pointed to by the root entry with an index
+   of the low root bits of huff.  This is saved in low to check for when a
+   new sub-table should be started.  drop is zero when the root table is
+   being filled, and drop is root when sub-tables are being filled.
+
+   When a new sub-table is needed, it is necessary to look ahead in the
+   code lengths to determine what size sub-table is needed.  The length
+   counts are used for this, and so count[] is decremented as codes are
+   entered in the tables.
+
+   used keeps track of how many table entries have been allocated from the
+   provided *table space.  It is checked for LENS and DIST tables against
+   the constants ENOUGH_LENS and ENOUGH_DISTS to guard against changes in
+   the initial root table size constants.  See the comments in inftrees.h
+   for more information.
+
+   sym increments through all symbols, and the loop terminates when
+   all codes of length max, i.e. all codes, have been processed.  This
+   routine permits incomplete codes, so another loop after this one fills
+   in the rest of the decoding tables with invalid code markers.
+   */
+
+  /* set up for code type */
+  // poor man optimization - use if-else instead of switch,
+  // to avoid deopts in old v8
+  if (type === CODES) {
+    base = extra = work;    /* dummy value--not used */
+    end = 19;
+
+  } else if (type === LENS) {
+    base = lbase;
+    base_index -= 257;
+    extra = lext;
+    extra_index -= 257;
+    end = 256;
+
+  } else {                    /* DISTS */
+    base = dbase;
+    extra = dext;
+    end = -1;
+  }
+
+  /* initialize opts for loop */
+  huff = 0;                   /* starting code */
+  sym = 0;                    /* starting code symbol */
+  len = min;                  /* starting code length */
+  next = table_index;              /* current table to fill in */
+  curr = root;                /* current table index bits */
+  drop = 0;                   /* current bits to drop from code for index */
+  low = -1;                   /* trigger new sub-table when len > root */
+  used = 1 << root;          /* use root table entries */
+  mask = used - 1;            /* mask for comparing low */
+
+  /* check available table space */
+  if ((type === LENS && used > ENOUGH_LENS) ||
+    (type === DISTS && used > ENOUGH_DISTS)) {
+    return 1;
+  }
+
+  /* process all codes and make table entries */
+  for (;;) {
+    /* create table entry */
+    here_bits = len - drop;
+    if (work[sym] < end) {
+      here_op = 0;
+      here_val = work[sym];
+    }
+    else if (work[sym] > end) {
+      here_op = extra[extra_index + work[sym]];
+      here_val = base[base_index + work[sym]];
+    }
+    else {
+      here_op = 32 + 64;         /* end of block */
+      here_val = 0;
+    }
+
+    /* replicate for those indices with low len bits equal to huff */
+    incr = 1 << (len - drop);
+    fill = 1 << curr;
+    min = fill;                 /* save offset to next table */
+    do {
+      fill -= incr;
+      table[next + (huff >> drop) + fill] = (here_bits << 24) | (here_op << 16) | here_val |0;
+    } while (fill !== 0);
+
+    /* backwards increment the len-bit code huff */
+    incr = 1 << (len - 1);
+    while (huff & incr) {
+      incr >>= 1;
+    }
+    if (incr !== 0) {
+      huff &= incr - 1;
+      huff += incr;
+    } else {
+      huff = 0;
+    }
+
+    /* go to next symbol, update count, len */
+    sym++;
+    if (--count[len] === 0) {
+      if (len === max) { break; }
+      len = lens[lens_index + work[sym]];
+    }
+
+    /* create new sub-table if needed */
+    if (len > root && (huff & mask) !== low) {
+      /* if first time, transition to sub-tables */
+      if (drop === 0) {
+        drop = root;
+      }
+
+      /* increment past last table */
+      next += min;            /* here min is 1 << curr */
+
+      /* determine length of next table */
+      curr = len - drop;
+      left = 1 << curr;
+      while (curr + drop < max) {
+        left -= count[curr + drop];
+        if (left <= 0) { break; }
+        curr++;
+        left <<= 1;
+      }
+
+      /* check for enough space */
+      used += 1 << curr;
+      if ((type === LENS && used > ENOUGH_LENS) ||
+        (type === DISTS && used > ENOUGH_DISTS)) {
+        return 1;
+      }
+
+      /* point entry in root table to sub-table */
+      low = huff & mask;
+      /*table.op[low] = curr;
+      table.bits[low] = root;
+      table.val[low] = next - opts.table_index;*/
+      table[low] = (root << 24) | (curr << 16) | (next - table_index) |0;
+    }
+  }
+
+  /* fill in remaining table entry if code is incomplete (guaranteed to have
+   at most one remaining entry, since if the code is incomplete, the
+   maximum code length that was allowed to get this far is one bit) */
+  if (huff !== 0) {
+    //table.op[next + huff] = 64;            /* invalid code marker */
+    //table.bits[next + huff] = len - drop;
+    //table.val[next + huff] = 0;
+    table[next + huff] = ((len - drop) << 24) | (64 << 16) |0;
+  }
+
+  /* set return parameters */
+  //opts.table_index += used;
+  opts.bits = root;
+  return 0;
+};
+
+},{"../utils/common":62}],72:[function(require,module,exports){
+'use strict';
+
+// (C) 1995-2013 Jean-loup Gailly and Mark Adler
+// (C) 2014-2017 Vitaly Puzrin and Andrey Tupitsin
+//
+// This software is provided 'as-is', without any express or implied
+// warranty. In no event will the authors be held liable for any damages
+// arising from the use of this software.
+//
+// Permission is granted to anyone to use this software for any purpose,
+// including commercial applications, and to alter it and redistribute it
+// freely, subject to the following restrictions:
+//
+// 1. The origin of this software must not be misrepresented; you must not
+//   claim that you wrote the original software. If you use this software
+//   in a product, an acknowledgment in the product documentation would be
+//   appreciated but is not required.
+// 2. Altered source versions must be plainly marked as such, and must not be
+//   misrepresented as being the original software.
+// 3. This notice may not be removed or altered from any source distribution.
+
+module.exports = {
+  2:      'need dictionary',     /* Z_NEED_DICT       2  */
+  1:      'stream end',          /* Z_STREAM_END      1  */
+  0:      '',                    /* Z_OK              0  */
+  '-1':   'file error',          /* Z_ERRNO         (-1) */
+  '-2':   'stream error',        /* Z_STREAM_ERROR  (-2) */
+  '-3':   'data error',          /* Z_DATA_ERROR    (-3) */
+  '-4':   'insufficient memory', /* Z_MEM_ERROR     (-4) */
+  '-5':   'buffer error',        /* Z_BUF_ERROR     (-5) */
+  '-6':   'incompatible version' /* Z_VERSION_ERROR (-6) */
+};
+
+},{}],73:[function(require,module,exports){
+'use strict';
+
+// (C) 1995-2013 Jean-loup Gailly and Mark Adler
+// (C) 2014-2017 Vitaly Puzrin and Andrey Tupitsin
+//
+// This software is provided 'as-is', without any express or implied
+// warranty. In no event will the authors be held liable for any damages
+// arising from the use of this software.
+//
+// Permission is granted to anyone to use this software for any purpose,
+// including commercial applications, and to alter it and redistribute it
+// freely, subject to the following restrictions:
+//
+// 1. The origin of this software must not be misrepresented; you must not
+//   claim that you wrote the original software. If you use this software
+//   in a product, an acknowledgment in the product documentation would be
+//   appreciated but is not required.
+// 2. Altered source versions must be plainly marked as such, and must not be
+//   misrepresented as being the original software.
+// 3. This notice may not be removed or altered from any source distribution.
+
+var utils = require('../utils/common');
+
+/* Public constants ==========================================================*/
+/* ===========================================================================*/
+
+
+//var Z_FILTERED          = 1;
+//var Z_HUFFMAN_ONLY      = 2;
+//var Z_RLE               = 3;
+var Z_FIXED               = 4;
+//var Z_DEFAULT_STRATEGY  = 0;
+
+/* Possible values of the data_type field (though see inflate()) */
+var Z_BINARY              = 0;
+var Z_TEXT                = 1;
+//var Z_ASCII             = 1; // = Z_TEXT
+var Z_UNKNOWN             = 2;
+
+/*============================================================================*/
+
+
+function zero(buf) { var len = buf.length; while (--len >= 0) { buf[len] = 0; } }
+
+// From zutil.h
+
+var STORED_BLOCK = 0;
+var STATIC_TREES = 1;
+var DYN_TREES    = 2;
+/* The three kinds of block type */
+
+var MIN_MATCH    = 3;
+var MAX_MATCH    = 258;
+/* The minimum and maximum match lengths */
+
+// From deflate.h
+/* ===========================================================================
+ * Internal compression state.
+ */
+
+var LENGTH_CODES  = 29;
+/* number of length codes, not counting the special END_BLOCK code */
+
+var LITERALS      = 256;
+/* number of literal bytes 0..255 */
+
+var L_CODES       = LITERALS + 1 + LENGTH_CODES;
+/* number of Literal or Length codes, including the END_BLOCK code */
+
+var D_CODES       = 30;
+/* number of distance codes */
+
+var BL_CODES      = 19;
+/* number of codes used to transfer the bit lengths */
+
+var HEAP_SIZE     = 2 * L_CODES + 1;
+/* maximum heap size */
+
+var MAX_BITS      = 15;
+/* All codes must not exceed MAX_BITS bits */
+
+var Buf_size      = 16;
+/* size of bit buffer in bi_buf */
+
+
+/* ===========================================================================
+ * Constants
+ */
+
+var MAX_BL_BITS = 7;
+/* Bit length codes must not exceed MAX_BL_BITS bits */
+
+var END_BLOCK   = 256;
+/* end of block literal code */
+
+var REP_3_6     = 16;
+/* repeat previous bit length 3-6 times (2 bits of repeat count) */
+
+var REPZ_3_10   = 17;
+/* repeat a zero length 3-10 times  (3 bits of repeat count) */
+
+var REPZ_11_138 = 18;
+/* repeat a zero length 11-138 times  (7 bits of repeat count) */
+
+/* eslint-disable comma-spacing,array-bracket-spacing */
+var extra_lbits =   /* extra bits for each length code */
+  [0,0,0,0,0,0,0,0,1,1,1,1,2,2,2,2,3,3,3,3,4,4,4,4,5,5,5,5,0];
+
+var extra_dbits =   /* extra bits for each distance code */
+  [0,0,0,0,1,1,2,2,3,3,4,4,5,5,6,6,7,7,8,8,9,9,10,10,11,11,12,12,13,13];
+
+var extra_blbits =  /* extra bits for each bit length code */
+  [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,3,7];
+
+var bl_order =
+  [16,17,18,0,8,7,9,6,10,5,11,4,12,3,13,2,14,1,15];
+/* eslint-enable comma-spacing,array-bracket-spacing */
+
+/* The lengths of the bit length codes are sent in order of decreasing
+ * probability, to avoid transmitting the lengths for unused bit length codes.
+ */
+
+/* ===========================================================================
+ * Local data. These are initialized only once.
+ */
+
+// We pre-fill arrays with 0 to avoid uninitialized gaps
+
+var DIST_CODE_LEN = 512; /* see definition of array dist_code below */
+
+// !!!! Use flat array insdead of structure, Freq = i*2, Len = i*2+1
+var static_ltree  = new Array((L_CODES + 2) * 2);
+zero(static_ltree);
+/* The static literal tree. Since the bit lengths are imposed, there is no
+ * need for the L_CODES extra codes used during heap construction. However
+ * The codes 286 and 287 are needed to build a canonical tree (see _tr_init
+ * below).
+ */
+
+var static_dtree  = new Array(D_CODES * 2);
+zero(static_dtree);
+/* The static distance tree. (Actually a trivial tree since all codes use
+ * 5 bits.)
+ */
+
+var _dist_code    = new Array(DIST_CODE_LEN);
+zero(_dist_code);
+/* Distance codes. The first 256 values correspond to the distances
+ * 3 .. 258, the last 256 values correspond to the top 8 bits of
+ * the 15 bit distances.
+ */
+
+var _length_code  = new Array(MAX_MATCH - MIN_MATCH + 1);
+zero(_length_code);
+/* length code for each normalized match length (0 == MIN_MATCH) */
+
+var base_length   = new Array(LENGTH_CODES);
+zero(base_length);
+/* First normalized length for each code (0 = MIN_MATCH) */
+
+var base_dist     = new Array(D_CODES);
+zero(base_dist);
+/* First normalized distance for each code (0 = distance of 1) */
+
+
+function StaticTreeDesc(static_tree, extra_bits, extra_base, elems, max_length) {
+
+  this.static_tree  = static_tree;  /* static tree or NULL */
+  this.extra_bits   = extra_bits;   /* extra bits for each code or NULL */
+  this.extra_base   = extra_base;   /* base index for extra_bits */
+  this.elems        = elems;        /* max number of elements in the tree */
+  this.max_length   = max_length;   /* max bit length for the codes */
+
+  // show if `static_tree` has data or dummy - needed for monomorphic objects
+  this.has_stree    = static_tree && static_tree.length;
+}
+
+
+var static_l_desc;
+var static_d_desc;
+var static_bl_desc;
+
+
+function TreeDesc(dyn_tree, stat_desc) {
+  this.dyn_tree = dyn_tree;     /* the dynamic tree */
+  this.max_code = 0;            /* largest code with non zero frequency */
+  this.stat_desc = stat_desc;   /* the corresponding static tree */
+}
+
+
+
+function d_code(dist) {
+  return dist < 256 ? _dist_code[dist] : _dist_code[256 + (dist >>> 7)];
+}
+
+
+/* ===========================================================================
+ * Output a short LSB first on the stream.
+ * IN assertion: there is enough room in pendingBuf.
+ */
+function put_short(s, w) {
+//    put_byte(s, (uch)((w) & 0xff));
+//    put_byte(s, (uch)((ush)(w) >> 8));
+  s.pending_buf[s.pending++] = (w) & 0xff;
+  s.pending_buf[s.pending++] = (w >>> 8) & 0xff;
+}
+
+
+/* ===========================================================================
+ * Send a value on a given number of bits.
+ * IN assertion: length <= 16 and value fits in length bits.
+ */
+function send_bits(s, value, length) {
+  if (s.bi_valid > (Buf_size - length)) {
+    s.bi_buf |= (value << s.bi_valid) & 0xffff;
+    put_short(s, s.bi_buf);
+    s.bi_buf = value >> (Buf_size - s.bi_valid);
+    s.bi_valid += length - Buf_size;
+  } else {
+    s.bi_buf |= (value << s.bi_valid) & 0xffff;
+    s.bi_valid += length;
+  }
+}
+
+
+function send_code(s, c, tree) {
+  send_bits(s, tree[c * 2]/*.Code*/, tree[c * 2 + 1]/*.Len*/);
+}
+
+
+/* ===========================================================================
+ * Reverse the first len bits of a code, using straightforward code (a faster
+ * method would use a table)
+ * IN assertion: 1 <= len <= 15
+ */
+function bi_reverse(code, len) {
+  var res = 0;
+  do {
+    res |= code & 1;
+    code >>>= 1;
+    res <<= 1;
+  } while (--len > 0);
+  return res >>> 1;
+}
+
+
+/* ===========================================================================
+ * Flush the bit buffer, keeping at most 7 bits in it.
+ */
+function bi_flush(s) {
+  if (s.bi_valid === 16) {
+    put_short(s, s.bi_buf);
+    s.bi_buf = 0;
+    s.bi_valid = 0;
+
+  } else if (s.bi_valid >= 8) {
+    s.pending_buf[s.pending++] = s.bi_buf & 0xff;
+    s.bi_buf >>= 8;
+    s.bi_valid -= 8;
+  }
+}
+
+
+/* ===========================================================================
+ * Compute the optimal bit lengths for a tree and update the total bit length
+ * for the current block.
+ * IN assertion: the fields freq and dad are set, heap[heap_max] and
+ *    above are the tree nodes sorted by increasing frequency.
+ * OUT assertions: the field len is set to the optimal bit length, the
+ *     array bl_count contains the frequencies for each bit length.
+ *     The length opt_len is updated; static_len is also updated if stree is
+ *     not null.
+ */
+function gen_bitlen(s, desc)
+//    deflate_state *s;
+//    tree_desc *desc;    /* the tree descriptor */
+{
+  var tree            = desc.dyn_tree;
+  var max_code        = desc.max_code;
+  var stree           = desc.stat_desc.static_tree;
+  var has_stree       = desc.stat_desc.has_stree;
+  var extra           = desc.stat_desc.extra_bits;
+  var base            = desc.stat_desc.extra_base;
+  var max_length      = desc.stat_desc.max_length;
+  var h;              /* heap index */
+  var n, m;           /* iterate over the tree elements */
+  var bits;           /* bit length */
+  var xbits;          /* extra bits */
+  var f;              /* frequency */
+  var overflow = 0;   /* number of elements with bit length too large */
+
+  for (bits = 0; bits <= MAX_BITS; bits++) {
+    s.bl_count[bits] = 0;
+  }
+
+  /* In a first pass, compute the optimal bit lengths (which may
+   * overflow in the case of the bit length tree).
+   */
+  tree[s.heap[s.heap_max] * 2 + 1]/*.Len*/ = 0; /* root of the heap */
+
+  for (h = s.heap_max + 1; h < HEAP_SIZE; h++) {
+    n = s.heap[h];
+    bits = tree[tree[n * 2 + 1]/*.Dad*/ * 2 + 1]/*.Len*/ + 1;
+    if (bits > max_length) {
+      bits = max_length;
+      overflow++;
+    }
+    tree[n * 2 + 1]/*.Len*/ = bits;
+    /* We overwrite tree[n].Dad which is no longer needed */
+
+    if (n > max_code) { continue; } /* not a leaf node */
+
+    s.bl_count[bits]++;
+    xbits = 0;
+    if (n >= base) {
+      xbits = extra[n - base];
+    }
+    f = tree[n * 2]/*.Freq*/;
+    s.opt_len += f * (bits + xbits);
+    if (has_stree) {
+      s.static_len += f * (stree[n * 2 + 1]/*.Len*/ + xbits);
+    }
+  }
+  if (overflow === 0) { return; }
+
+  // Trace((stderr,"\nbit length overflow\n"));
+  /* This happens for example on obj2 and pic of the Calgary corpus */
+
+  /* Find the first bit length which could increase: */
+  do {
+    bits = max_length - 1;
+    while (s.bl_count[bits] === 0) { bits--; }
+    s.bl_count[bits]--;      /* move one leaf down the tree */
+    s.bl_count[bits + 1] += 2; /* move one overflow item as its brother */
+    s.bl_count[max_length]--;
+    /* The brother of the overflow item also moves one step up,
+     * but this does not affect bl_count[max_length]
+     */
+    overflow -= 2;
+  } while (overflow > 0);
+
+  /* Now recompute all bit lengths, scanning in increasing frequency.
+   * h is still equal to HEAP_SIZE. (It is simpler to reconstruct all
+   * lengths instead of fixing only the wrong ones. This idea is taken
+   * from 'ar' written by Haruhiko Okumura.)
+   */
+  for (bits = max_length; bits !== 0; bits--) {
+    n = s.bl_count[bits];
+    while (n !== 0) {
+      m = s.heap[--h];
+      if (m > max_code) { continue; }
+      if (tree[m * 2 + 1]/*.Len*/ !== bits) {
+        // Trace((stderr,"code %d bits %d->%d\n", m, tree[m].Len, bits));
+        s.opt_len += (bits - tree[m * 2 + 1]/*.Len*/) * tree[m * 2]/*.Freq*/;
+        tree[m * 2 + 1]/*.Len*/ = bits;
+      }
+      n--;
+    }
+  }
+}
+
+
+/* ===========================================================================
+ * Generate the codes for a given tree and bit counts (which need not be
+ * optimal).
+ * IN assertion: the array bl_count contains the bit length statistics for
+ * the given tree and the field len is set for all tree elements.
+ * OUT assertion: the field code is set for all tree elements of non
+ *     zero code length.
+ */
+function gen_codes(tree, max_code, bl_count)
+//    ct_data *tree;             /* the tree to decorate */
+//    int max_code;              /* largest code with non zero frequency */
+//    ushf *bl_count;            /* number of codes at each bit length */
+{
+  var next_code = new Array(MAX_BITS + 1); /* next code value for each bit length */
+  var code = 0;              /* running code value */
+  var bits;                  /* bit index */
+  var n;                     /* code index */
+
+  /* The distribution counts are first used to generate the code values
+   * without bit reversal.
+   */
+  for (bits = 1; bits <= MAX_BITS; bits++) {
+    next_code[bits] = code = (code + bl_count[bits - 1]) << 1;
+  }
+  /* Check that the bit counts in bl_count are consistent. The last code
+   * must be all ones.
+   */
+  //Assert (code + bl_count[MAX_BITS]-1 == (1<<MAX_BITS)-1,
+  //        "inconsistent bit counts");
+  //Tracev((stderr,"\ngen_codes: max_code %d ", max_code));
+
+  for (n = 0;  n <= max_code; n++) {
+    var len = tree[n * 2 + 1]/*.Len*/;
+    if (len === 0) { continue; }
+    /* Now reverse the bits */
+    tree[n * 2]/*.Code*/ = bi_reverse(next_code[len]++, len);
+
+    //Tracecv(tree != static_ltree, (stderr,"\nn %3d %c l %2d c %4x (%x) ",
+    //     n, (isgraph(n) ? n : ' '), len, tree[n].Code, next_code[len]-1));
+  }
+}
+
+
+/* ===========================================================================
+ * Initialize the various 'constant' tables.
+ */
+function tr_static_init() {
+  var n;        /* iterates over tree elements */
+  var bits;     /* bit counter */
+  var length;   /* length value */
+  var code;     /* code value */
+  var dist;     /* distance index */
+  var bl_count = new Array(MAX_BITS + 1);
+  /* number of codes at each bit length for an optimal tree */
+
+  // do check in _tr_init()
+  //if (static_init_done) return;
+
+  /* For some embedded targets, global variables are not initialized: */
+/*#ifdef NO_INIT_GLOBAL_POINTERS
+  static_l_desc.static_tree = static_ltree;
+  static_l_desc.extra_bits = extra_lbits;
+  static_d_desc.static_tree = static_dtree;
+  static_d_desc.extra_bits = extra_dbits;
+  static_bl_desc.extra_bits = extra_blbits;
+#endif*/
+
+  /* Initialize the mapping length (0..255) -> length code (0..28) */
+  length = 0;
+  for (code = 0; code < LENGTH_CODES - 1; code++) {
+    base_length[code] = length;
+    for (n = 0; n < (1 << extra_lbits[code]); n++) {
+      _length_code[length++] = code;
+    }
+  }
+  //Assert (length == 256, "tr_static_init: length != 256");
+  /* Note that the length 255 (match length 258) can be represented
+   * in two different ways: code 284 + 5 bits or code 285, so we
+   * overwrite length_code[255] to use the best encoding:
+   */
+  _length_code[length - 1] = code;
+
+  /* Initialize the mapping dist (0..32K) -> dist code (0..29) */
+  dist = 0;
+  for (code = 0; code < 16; code++) {
+    base_dist[code] = dist;
+    for (n = 0; n < (1 << extra_dbits[code]); n++) {
+      _dist_code[dist++] = code;
+    }
+  }
+  //Assert (dist == 256, "tr_static_init: dist != 256");
+  dist >>= 7; /* from now on, all distances are divided by 128 */
+  for (; code < D_CODES; code++) {
+    base_dist[code] = dist << 7;
+    for (n = 0; n < (1 << (extra_dbits[code] - 7)); n++) {
+      _dist_code[256 + dist++] = code;
+    }
+  }
+  //Assert (dist == 256, "tr_static_init: 256+dist != 512");
+
+  /* Construct the codes of the static literal tree */
+  for (bits = 0; bits <= MAX_BITS; bits++) {
+    bl_count[bits] = 0;
+  }
+
+  n = 0;
+  while (n <= 143) {
+    static_ltree[n * 2 + 1]/*.Len*/ = 8;
+    n++;
+    bl_count[8]++;
+  }
+  while (n <= 255) {
+    static_ltree[n * 2 + 1]/*.Len*/ = 9;
+    n++;
+    bl_count[9]++;
+  }
+  while (n <= 279) {
+    static_ltree[n * 2 + 1]/*.Len*/ = 7;
+    n++;
+    bl_count[7]++;
+  }
+  while (n <= 287) {
+    static_ltree[n * 2 + 1]/*.Len*/ = 8;
+    n++;
+    bl_count[8]++;
+  }
+  /* Codes 286 and 287 do not exist, but we must include them in the
+   * tree construction to get a canonical Huffman tree (longest code
+   * all ones)
+   */
+  gen_codes(static_ltree, L_CODES + 1, bl_count);
+
+  /* The static distance tree is trivial: */
+  for (n = 0; n < D_CODES; n++) {
+    static_dtree[n * 2 + 1]/*.Len*/ = 5;
+    static_dtree[n * 2]/*.Code*/ = bi_reverse(n, 5);
+  }
+
+  // Now data ready and we can init static trees
+  static_l_desc = new StaticTreeDesc(static_ltree, extra_lbits, LITERALS + 1, L_CODES, MAX_BITS);
+  static_d_desc = new StaticTreeDesc(static_dtree, extra_dbits, 0,          D_CODES, MAX_BITS);
+  static_bl_desc = new StaticTreeDesc(new Array(0), extra_blbits, 0,         BL_CODES, MAX_BL_BITS);
+
+  //static_init_done = true;
+}
+
+
+/* ===========================================================================
+ * Initialize a new block.
+ */
+function init_block(s) {
+  var n; /* iterates over tree elements */
+
+  /* Initialize the trees. */
+  for (n = 0; n < L_CODES;  n++) { s.dyn_ltree[n * 2]/*.Freq*/ = 0; }
+  for (n = 0; n < D_CODES;  n++) { s.dyn_dtree[n * 2]/*.Freq*/ = 0; }
+  for (n = 0; n < BL_CODES; n++) { s.bl_tree[n * 2]/*.Freq*/ = 0; }
+
+  s.dyn_ltree[END_BLOCK * 2]/*.Freq*/ = 1;
+  s.opt_len = s.static_len = 0;
+  s.last_lit = s.matches = 0;
+}
+
+
+/* ===========================================================================
+ * Flush the bit buffer and align the output on a byte boundary
+ */
+function bi_windup(s)
+{
+  if (s.bi_valid > 8) {
+    put_short(s, s.bi_buf);
+  } else if (s.bi_valid > 0) {
+    //put_byte(s, (Byte)s->bi_buf);
+    s.pending_buf[s.pending++] = s.bi_buf;
+  }
+  s.bi_buf = 0;
+  s.bi_valid = 0;
+}
+
+/* ===========================================================================
+ * Copy a stored block, storing first the length and its
+ * one's complement if requested.
+ */
+function copy_block(s, buf, len, header)
+//DeflateState *s;
+//charf    *buf;    /* the input data */
+//unsigned len;     /* its length */
+//int      header;  /* true if block header must be written */
+{
+  bi_windup(s);        /* align on byte boundary */
+
+  if (header) {
+    put_short(s, len);
+    put_short(s, ~len);
+  }
+//  while (len--) {
+//    put_byte(s, *buf++);
+//  }
+  utils.arraySet(s.pending_buf, s.window, buf, len, s.pending);
+  s.pending += len;
+}
+
+/* ===========================================================================
+ * Compares to subtrees, using the tree depth as tie breaker when
+ * the subtrees have equal frequency. This minimizes the worst case length.
+ */
+function smaller(tree, n, m, depth) {
+  var _n2 = n * 2;
+  var _m2 = m * 2;
+  return (tree[_n2]/*.Freq*/ < tree[_m2]/*.Freq*/ ||
+         (tree[_n2]/*.Freq*/ === tree[_m2]/*.Freq*/ && depth[n] <= depth[m]));
+}
+
+/* ===========================================================================
+ * Restore the heap property by moving down the tree starting at node k,
+ * exchanging a node with the smallest of its two sons if necessary, stopping
+ * when the heap property is re-established (each father smaller than its
+ * two sons).
+ */
+function pqdownheap(s, tree, k)
+//    deflate_state *s;
+//    ct_data *tree;  /* the tree to restore */
+//    int k;               /* node to move down */
+{
+  var v = s.heap[k];
+  var j = k << 1;  /* left son of k */
+  while (j <= s.heap_len) {
+    /* Set j to the smallest of the two sons: */
+    if (j < s.heap_len &&
+      smaller(tree, s.heap[j + 1], s.heap[j], s.depth)) {
+      j++;
+    }
+    /* Exit if v is smaller than both sons */
+    if (smaller(tree, v, s.heap[j], s.depth)) { break; }
+
+    /* Exchange v with the smallest son */
+    s.heap[k] = s.heap[j];
+    k = j;
+
+    /* And continue down the tree, setting j to the left son of k */
+    j <<= 1;
+  }
+  s.heap[k] = v;
+}
+
+
+// inlined manually
+// var SMALLEST = 1;
+
+/* ===========================================================================
+ * Send the block data compressed using the given Huffman trees
+ */
+function compress_block(s, ltree, dtree)
+//    deflate_state *s;
+//    const ct_data *ltree; /* literal tree */
+//    const ct_data *dtree; /* distance tree */
+{
+  var dist;           /* distance of matched string */
+  var lc;             /* match length or unmatched char (if dist == 0) */
+  var lx = 0;         /* running index in l_buf */
+  var code;           /* the code to send */
+  var extra;          /* number of extra bits to send */
+
+  if (s.last_lit !== 0) {
+    do {
+      dist = (s.pending_buf[s.d_buf + lx * 2] << 8) | (s.pending_buf[s.d_buf + lx * 2 + 1]);
+      lc = s.pending_buf[s.l_buf + lx];
+      lx++;
+
+      if (dist === 0) {
+        send_code(s, lc, ltree); /* send a literal byte */
+        //Tracecv(isgraph(lc), (stderr," '%c' ", lc));
+      } else {
+        /* Here, lc is the match length - MIN_MATCH */
+        code = _length_code[lc];
+        send_code(s, code + LITERALS + 1, ltree); /* send the length code */
+        extra = extra_lbits[code];
+        if (extra !== 0) {
+          lc -= base_length[code];
+          send_bits(s, lc, extra);       /* send the extra length bits */
+        }
+        dist--; /* dist is now the match distance - 1 */
+        code = d_code(dist);
+        //Assert (code < D_CODES, "bad d_code");
+
+        send_code(s, code, dtree);       /* send the distance code */
+        extra = extra_dbits[code];
+        if (extra !== 0) {
+          dist -= base_dist[code];
+          send_bits(s, dist, extra);   /* send the extra distance bits */
+        }
+      } /* literal or match pair ? */
+
+      /* Check that the overlay between pending_buf and d_buf+l_buf is ok: */
+      //Assert((uInt)(s->pending) < s->lit_bufsize + 2*lx,
+      //       "pendingBuf overflow");
+
+    } while (lx < s.last_lit);
+  }
+
+  send_code(s, END_BLOCK, ltree);
+}
+
+
+/* ===========================================================================
+ * Construct one Huffman tree and assigns the code bit strings and lengths.
+ * Update the total bit length for the current block.
+ * IN assertion: the field freq is set for all tree elements.
+ * OUT assertions: the fields len and code are set to the optimal bit length
+ *     and corresponding code. The length opt_len is updated; static_len is
+ *     also updated if stree is not null. The field max_code is set.
+ */
+function build_tree(s, desc)
+//    deflate_state *s;
+//    tree_desc *desc; /* the tree descriptor */
+{
+  var tree     = desc.dyn_tree;
+  var stree    = desc.stat_desc.static_tree;
+  var has_stree = desc.stat_desc.has_stree;
+  var elems    = desc.stat_desc.elems;
+  var n, m;          /* iterate over heap elements */
+  var max_code = -1; /* largest code with non zero frequency */
+  var node;          /* new node being created */
+
+  /* Construct the initial heap, with least frequent element in
+   * heap[SMALLEST]. The sons of heap[n] are heap[2*n] and heap[2*n+1].
+   * heap[0] is not used.
+   */
+  s.heap_len = 0;
+  s.heap_max = HEAP_SIZE;
+
+  for (n = 0; n < elems; n++) {
+    if (tree[n * 2]/*.Freq*/ !== 0) {
+      s.heap[++s.heap_len] = max_code = n;
+      s.depth[n] = 0;
+
+    } else {
+      tree[n * 2 + 1]/*.Len*/ = 0;
+    }
+  }
+
+  /* The pkzip format requires that at least one distance code exists,
+   * and that at least one bit should be sent even if there is only one
+   * possible code. So to avoid special checks later on we force at least
+   * two codes of non zero frequency.
+   */
+  while (s.heap_len < 2) {
+    node = s.heap[++s.heap_len] = (max_code < 2 ? ++max_code : 0);
+    tree[node * 2]/*.Freq*/ = 1;
+    s.depth[node] = 0;
+    s.opt_len--;
+
+    if (has_stree) {
+      s.static_len -= stree[node * 2 + 1]/*.Len*/;
+    }
+    /* node is 0 or 1 so it does not have extra bits */
+  }
+  desc.max_code = max_code;
+
+  /* The elements heap[heap_len/2+1 .. heap_len] are leaves of the tree,
+   * establish sub-heaps of increasing lengths:
+   */
+  for (n = (s.heap_len >> 1/*int /2*/); n >= 1; n--) { pqdownheap(s, tree, n); }
+
+  /* Construct the Huffman tree by repeatedly combining the least two
+   * frequent nodes.
+   */
+  node = elems;              /* next internal node of the tree */
+  do {
+    //pqremove(s, tree, n);  /* n = node of least frequency */
+    /*** pqremove ***/
+    n = s.heap[1/*SMALLEST*/];
+    s.heap[1/*SMALLEST*/] = s.heap[s.heap_len--];
+    pqdownheap(s, tree, 1/*SMALLEST*/);
+    /***/
+
+    m = s.heap[1/*SMALLEST*/]; /* m = node of next least frequency */
+
+    s.heap[--s.heap_max] = n; /* keep the nodes sorted by frequency */
+    s.heap[--s.heap_max] = m;
+
+    /* Create a new node father of n and m */
+    tree[node * 2]/*.Freq*/ = tree[n * 2]/*.Freq*/ + tree[m * 2]/*.Freq*/;
+    s.depth[node] = (s.depth[n] >= s.depth[m] ? s.depth[n] : s.depth[m]) + 1;
+    tree[n * 2 + 1]/*.Dad*/ = tree[m * 2 + 1]/*.Dad*/ = node;
+
+    /* and insert the new node in the heap */
+    s.heap[1/*SMALLEST*/] = node++;
+    pqdownheap(s, tree, 1/*SMALLEST*/);
+
+  } while (s.heap_len >= 2);
+
+  s.heap[--s.heap_max] = s.heap[1/*SMALLEST*/];
+
+  /* At this point, the fields freq and dad are set. We can now
+   * generate the bit lengths.
+   */
+  gen_bitlen(s, desc);
+
+  /* The field len is now set, we can generate the bit codes */
+  gen_codes(tree, max_code, s.bl_count);
+}
+
+
+/* ===========================================================================
+ * Scan a literal or distance tree to determine the frequencies of the codes
+ * in the bit length tree.
+ */
+function scan_tree(s, tree, max_code)
+//    deflate_state *s;
+//    ct_data *tree;   /* the tree to be scanned */
+//    int max_code;    /* and its largest code of non zero frequency */
+{
+  var n;                     /* iterates over all tree elements */
+  var prevlen = -1;          /* last emitted length */
+  var curlen;                /* length of current code */
+
+  var nextlen = tree[0 * 2 + 1]/*.Len*/; /* length of next code */
+
+  var count = 0;             /* repeat count of the current code */
+  var max_count = 7;         /* max repeat count */
+  var min_count = 4;         /* min repeat count */
+
+  if (nextlen === 0) {
+    max_count = 138;
+    min_count = 3;
+  }
+  tree[(max_code + 1) * 2 + 1]/*.Len*/ = 0xffff; /* guard */
+
+  for (n = 0; n <= max_code; n++) {
+    curlen = nextlen;
+    nextlen = tree[(n + 1) * 2 + 1]/*.Len*/;
+
+    if (++count < max_count && curlen === nextlen) {
+      continue;
+
+    } else if (count < min_count) {
+      s.bl_tree[curlen * 2]/*.Freq*/ += count;
+
+    } else if (curlen !== 0) {
+
+      if (curlen !== prevlen) { s.bl_tree[curlen * 2]/*.Freq*/++; }
+      s.bl_tree[REP_3_6 * 2]/*.Freq*/++;
+
+    } else if (count <= 10) {
+      s.bl_tree[REPZ_3_10 * 2]/*.Freq*/++;
+
+    } else {
+      s.bl_tree[REPZ_11_138 * 2]/*.Freq*/++;
+    }
+
+    count = 0;
+    prevlen = curlen;
+
+    if (nextlen === 0) {
+      max_count = 138;
+      min_count = 3;
+
+    } else if (curlen === nextlen) {
+      max_count = 6;
+      min_count = 3;
+
+    } else {
+      max_count = 7;
+      min_count = 4;
+    }
+  }
+}
+
+
+/* ===========================================================================
+ * Send a literal or distance tree in compressed form, using the codes in
+ * bl_tree.
+ */
+function send_tree(s, tree, max_code)
+//    deflate_state *s;
+//    ct_data *tree; /* the tree to be scanned */
+//    int max_code;       /* and its largest code of non zero frequency */
+{
+  var n;                     /* iterates over all tree elements */
+  var prevlen = -1;          /* last emitted length */
+  var curlen;                /* length of current code */
+
+  var nextlen = tree[0 * 2 + 1]/*.Len*/; /* length of next code */
+
+  var count = 0;             /* repeat count of the current code */
+  var max_count = 7;         /* max repeat count */
+  var min_count = 4;         /* min repeat count */
+
+  /* tree[max_code+1].Len = -1; */  /* guard already set */
+  if (nextlen === 0) {
+    max_count = 138;
+    min_count = 3;
+  }
+
+  for (n = 0; n <= max_code; n++) {
+    curlen = nextlen;
+    nextlen = tree[(n + 1) * 2 + 1]/*.Len*/;
+
+    if (++count < max_count && curlen === nextlen) {
+      continue;
+
+    } else if (count < min_count) {
+      do { send_code(s, curlen, s.bl_tree); } while (--count !== 0);
+
+    } else if (curlen !== 0) {
+      if (curlen !== prevlen) {
+        send_code(s, curlen, s.bl_tree);
+        count--;
+      }
+      //Assert(count >= 3 && count <= 6, " 3_6?");
+      send_code(s, REP_3_6, s.bl_tree);
+      send_bits(s, count - 3, 2);
+
+    } else if (count <= 10) {
+      send_code(s, REPZ_3_10, s.bl_tree);
+      send_bits(s, count - 3, 3);
+
+    } else {
+      send_code(s, REPZ_11_138, s.bl_tree);
+      send_bits(s, count - 11, 7);
+    }
+
+    count = 0;
+    prevlen = curlen;
+    if (nextlen === 0) {
+      max_count = 138;
+      min_count = 3;
+
+    } else if (curlen === nextlen) {
+      max_count = 6;
+      min_count = 3;
+
+    } else {
+      max_count = 7;
+      min_count = 4;
+    }
+  }
+}
+
+
+/* ===========================================================================
+ * Construct the Huffman tree for the bit lengths and return the index in
+ * bl_order of the last bit length code to send.
+ */
+function build_bl_tree(s) {
+  var max_blindex;  /* index of last bit length code of non zero freq */
+
+  /* Determine the bit length frequencies for literal and distance trees */
+  scan_tree(s, s.dyn_ltree, s.l_desc.max_code);
+  scan_tree(s, s.dyn_dtree, s.d_desc.max_code);
+
+  /* Build the bit length tree: */
+  build_tree(s, s.bl_desc);
+  /* opt_len now includes the length of the tree representations, except
+   * the lengths of the bit lengths codes and the 5+5+4 bits for the counts.
+   */
+
+  /* Determine the number of bit length codes to send. The pkzip format
+   * requires that at least 4 bit length codes be sent. (appnote.txt says
+   * 3 but the actual value used is 4.)
+   */
+  for (max_blindex = BL_CODES - 1; max_blindex >= 3; max_blindex--) {
+    if (s.bl_tree[bl_order[max_blindex] * 2 + 1]/*.Len*/ !== 0) {
+      break;
+    }
+  }
+  /* Update opt_len to include the bit length tree and counts */
+  s.opt_len += 3 * (max_blindex + 1) + 5 + 5 + 4;
+  //Tracev((stderr, "\ndyn trees: dyn %ld, stat %ld",
+  //        s->opt_len, s->static_len));
+
+  return max_blindex;
+}
+
+
+/* ===========================================================================
+ * Send the header for a block using dynamic Huffman trees: the counts, the
+ * lengths of the bit length codes, the literal tree and the distance tree.
+ * IN assertion: lcodes >= 257, dcodes >= 1, blcodes >= 4.
+ */
+function send_all_trees(s, lcodes, dcodes, blcodes)
+//    deflate_state *s;
+//    int lcodes, dcodes, blcodes; /* number of codes for each tree */
+{
+  var rank;                    /* index in bl_order */
+
+  //Assert (lcodes >= 257 && dcodes >= 1 && blcodes >= 4, "not enough codes");
+  //Assert (lcodes <= L_CODES && dcodes <= D_CODES && blcodes <= BL_CODES,
+  //        "too many codes");
+  //Tracev((stderr, "\nbl counts: "));
+  send_bits(s, lcodes - 257, 5); /* not +255 as stated in appnote.txt */
+  send_bits(s, dcodes - 1,   5);
+  send_bits(s, blcodes - 4,  4); /* not -3 as stated in appnote.txt */
+  for (rank = 0; rank < blcodes; rank++) {
+    //Tracev((stderr, "\nbl code %2d ", bl_order[rank]));
+    send_bits(s, s.bl_tree[bl_order[rank] * 2 + 1]/*.Len*/, 3);
+  }
+  //Tracev((stderr, "\nbl tree: sent %ld", s->bits_sent));
+
+  send_tree(s, s.dyn_ltree, lcodes - 1); /* literal tree */
+  //Tracev((stderr, "\nlit tree: sent %ld", s->bits_sent));
+
+  send_tree(s, s.dyn_dtree, dcodes - 1); /* distance tree */
+  //Tracev((stderr, "\ndist tree: sent %ld", s->bits_sent));
+}
+
+
+/* ===========================================================================
+ * Check if the data type is TEXT or BINARY, using the following algorithm:
+ * - TEXT if the two conditions below are satisfied:
+ *    a) There are no non-portable control characters belonging to the
+ *       "black list" (0..6, 14..25, 28..31).
+ *    b) There is at least one printable character belonging to the
+ *       "white list" (9 {TAB}, 10 {LF}, 13 {CR}, 32..255).
+ * - BINARY otherwise.
+ * - The following partially-portable control characters form a
+ *   "gray list" that is ignored in this detection algorithm:
+ *   (7 {BEL}, 8 {BS}, 11 {VT}, 12 {FF}, 26 {SUB}, 27 {ESC}).
+ * IN assertion: the fields Freq of dyn_ltree are set.
+ */
+function detect_data_type(s) {
+  /* black_mask is the bit mask of black-listed bytes
+   * set bits 0..6, 14..25, and 28..31
+   * 0xf3ffc07f = binary 11110011111111111100000001111111
+   */
+  var black_mask = 0xf3ffc07f;
+  var n;
+
+  /* Check for non-textual ("black-listed") bytes. */
+  for (n = 0; n <= 31; n++, black_mask >>>= 1) {
+    if ((black_mask & 1) && (s.dyn_ltree[n * 2]/*.Freq*/ !== 0)) {
+      return Z_BINARY;
+    }
+  }
+
+  /* Check for textual ("white-listed") bytes. */
+  if (s.dyn_ltree[9 * 2]/*.Freq*/ !== 0 || s.dyn_ltree[10 * 2]/*.Freq*/ !== 0 ||
+      s.dyn_ltree[13 * 2]/*.Freq*/ !== 0) {
+    return Z_TEXT;
+  }
+  for (n = 32; n < LITERALS; n++) {
+    if (s.dyn_ltree[n * 2]/*.Freq*/ !== 0) {
+      return Z_TEXT;
+    }
+  }
+
+  /* There are no "black-listed" or "white-listed" bytes:
+   * this stream either is empty or has tolerated ("gray-listed") bytes only.
+   */
+  return Z_BINARY;
+}
+
+
+var static_init_done = false;
+
+/* ===========================================================================
+ * Initialize the tree data structures for a new zlib stream.
+ */
+function _tr_init(s)
+{
+
+  if (!static_init_done) {
+    tr_static_init();
+    static_init_done = true;
+  }
+
+  s.l_desc  = new TreeDesc(s.dyn_ltree, static_l_desc);
+  s.d_desc  = new TreeDesc(s.dyn_dtree, static_d_desc);
+  s.bl_desc = new TreeDesc(s.bl_tree, static_bl_desc);
+
+  s.bi_buf = 0;
+  s.bi_valid = 0;
+
+  /* Initialize the first block of the first file: */
+  init_block(s);
+}
+
+
+/* ===========================================================================
+ * Send a stored block
+ */
+function _tr_stored_block(s, buf, stored_len, last)
+//DeflateState *s;
+//charf *buf;       /* input block */
+//ulg stored_len;   /* length of input block */
+//int last;         /* one if this is the last block for a file */
+{
+  send_bits(s, (STORED_BLOCK << 1) + (last ? 1 : 0), 3);    /* send block type */
+  copy_block(s, buf, stored_len, true); /* with header */
+}
+
+
+/* ===========================================================================
+ * Send one empty static block to give enough lookahead for inflate.
+ * This takes 10 bits, of which 7 may remain in the bit buffer.
+ */
+function _tr_align(s) {
+  send_bits(s, STATIC_TREES << 1, 3);
+  send_code(s, END_BLOCK, static_ltree);
+  bi_flush(s);
+}
+
+
+/* ===========================================================================
+ * Determine the best encoding for the current block: dynamic trees, static
+ * trees or store, and output the encoded block to the zip file.
+ */
+function _tr_flush_block(s, buf, stored_len, last)
+//DeflateState *s;
+//charf *buf;       /* input block, or NULL if too old */
+//ulg stored_len;   /* length of input block */
+//int last;         /* one if this is the last block for a file */
+{
+  var opt_lenb, static_lenb;  /* opt_len and static_len in bytes */
+  var max_blindex = 0;        /* index of last bit length code of non zero freq */
+
+  /* Build the Huffman trees unless a stored block is forced */
+  if (s.level > 0) {
+
+    /* Check if the file is binary or text */
+    if (s.strm.data_type === Z_UNKNOWN) {
+      s.strm.data_type = detect_data_type(s);
+    }
+
+    /* Construct the literal and distance trees */
+    build_tree(s, s.l_desc);
+    // Tracev((stderr, "\nlit data: dyn %ld, stat %ld", s->opt_len,
+    //        s->static_len));
+
+    build_tree(s, s.d_desc);
+    // Tracev((stderr, "\ndist data: dyn %ld, stat %ld", s->opt_len,
+    //        s->static_len));
+    /* At this point, opt_len and static_len are the total bit lengths of
+     * the compressed block data, excluding the tree representations.
+     */
+
+    /* Build the bit length tree for the above two trees, and get the index
+     * in bl_order of the last bit length code to send.
+     */
+    max_blindex = build_bl_tree(s);
+
+    /* Determine the best encoding. Compute the block lengths in bytes. */
+    opt_lenb = (s.opt_len + 3 + 7) >>> 3;
+    static_lenb = (s.static_len + 3 + 7) >>> 3;
+
+    // Tracev((stderr, "\nopt %lu(%lu) stat %lu(%lu) stored %lu lit %u ",
+    //        opt_lenb, s->opt_len, static_lenb, s->static_len, stored_len,
+    //        s->last_lit));
+
+    if (static_lenb <= opt_lenb) { opt_lenb = static_lenb; }
+
+  } else {
+    // Assert(buf != (char*)0, "lost buf");
+    opt_lenb = static_lenb = stored_len + 5; /* force a stored block */
+  }
+
+  if ((stored_len + 4 <= opt_lenb) && (buf !== -1)) {
+    /* 4: two words for the lengths */
+
+    /* The test buf != NULL is only necessary if LIT_BUFSIZE > WSIZE.
+     * Otherwise we can't have processed more than WSIZE input bytes since
+     * the last block flush, because compression would have been
+     * successful. If LIT_BUFSIZE <= WSIZE, it is never too late to
+     * transform a block into a stored block.
+     */
+    _tr_stored_block(s, buf, stored_len, last);
+
+  } else if (s.strategy === Z_FIXED || static_lenb === opt_lenb) {
+
+    send_bits(s, (STATIC_TREES << 1) + (last ? 1 : 0), 3);
+    compress_block(s, static_ltree, static_dtree);
+
+  } else {
+    send_bits(s, (DYN_TREES << 1) + (last ? 1 : 0), 3);
+    send_all_trees(s, s.l_desc.max_code + 1, s.d_desc.max_code + 1, max_blindex + 1);
+    compress_block(s, s.dyn_ltree, s.dyn_dtree);
+  }
+  // Assert (s->compressed_len == s->bits_sent, "bad compressed size");
+  /* The above check is made mod 2^32, for files larger than 512 MB
+   * and uLong implemented on 32 bits.
+   */
+  init_block(s);
+
+  if (last) {
+    bi_windup(s);
+  }
+  // Tracev((stderr,"\ncomprlen %lu(%lu) ", s->compressed_len>>3,
+  //       s->compressed_len-7*last));
+}
+
+/* ===========================================================================
+ * Save the match info and tally the frequency counts. Return true if
+ * the current block must be flushed.
+ */
+function _tr_tally(s, dist, lc)
+//    deflate_state *s;
+//    unsigned dist;  /* distance of matched string */
+//    unsigned lc;    /* match length-MIN_MATCH or unmatched char (if dist==0) */
+{
+  //var out_length, in_length, dcode;
+
+  s.pending_buf[s.d_buf + s.last_lit * 2]     = (dist >>> 8) & 0xff;
+  s.pending_buf[s.d_buf + s.last_lit * 2 + 1] = dist & 0xff;
+
+  s.pending_buf[s.l_buf + s.last_lit] = lc & 0xff;
+  s.last_lit++;
+
+  if (dist === 0) {
+    /* lc is the unmatched char */
+    s.dyn_ltree[lc * 2]/*.Freq*/++;
+  } else {
+    s.matches++;
+    /* Here, lc is the match length - MIN_MATCH */
+    dist--;             /* dist = match distance - 1 */
+    //Assert((ush)dist < (ush)MAX_DIST(s) &&
+    //       (ush)lc <= (ush)(MAX_MATCH-MIN_MATCH) &&
+    //       (ush)d_code(dist) < (ush)D_CODES,  "_tr_tally: bad match");
+
+    s.dyn_ltree[(_length_code[lc] + LITERALS + 1) * 2]/*.Freq*/++;
+    s.dyn_dtree[d_code(dist) * 2]/*.Freq*/++;
+  }
+
+// (!) This block is disabled in zlib defailts,
+// don't enable it for binary compatibility
+
+//#ifdef TRUNCATE_BLOCK
+//  /* Try to guess if it is profitable to stop the current block here */
+//  if ((s.last_lit & 0x1fff) === 0 && s.level > 2) {
+//    /* Compute an upper bound for the compressed length */
+//    out_length = s.last_lit*8;
+//    in_length = s.strstart - s.block_start;
+//
+//    for (dcode = 0; dcode < D_CODES; dcode++) {
+//      out_length += s.dyn_dtree[dcode*2]/*.Freq*/ * (5 + extra_dbits[dcode]);
+//    }
+//    out_length >>>= 3;
+//    //Tracev((stderr,"\nlast_lit %u, in %ld, out ~%ld(%ld%%) ",
+//    //       s->last_lit, in_length, out_length,
+//    //       100L - out_length*100L/in_length));
+//    if (s.matches < (s.last_lit>>1)/*int /2*/ && out_length < (in_length>>1)/*int /2*/) {
+//      return true;
+//    }
+//  }
+//#endif
+
+  return (s.last_lit === s.lit_bufsize - 1);
+  /* We avoid equality with lit_bufsize because of wraparound at 64K
+   * on 16 bit machines and because stored blocks are restricted to
+   * 64K-1 bytes.
+   */
+}
+
+exports._tr_init  = _tr_init;
+exports._tr_stored_block = _tr_stored_block;
+exports._tr_flush_block  = _tr_flush_block;
+exports._tr_tally = _tr_tally;
+exports._tr_align = _tr_align;
+
+},{"../utils/common":62}],74:[function(require,module,exports){
+'use strict';
+
+// (C) 1995-2013 Jean-loup Gailly and Mark Adler
+// (C) 2014-2017 Vitaly Puzrin and Andrey Tupitsin
+//
+// This software is provided 'as-is', without any express or implied
+// warranty. In no event will the authors be held liable for any damages
+// arising from the use of this software.
+//
+// Permission is granted to anyone to use this software for any purpose,
+// including commercial applications, and to alter it and redistribute it
+// freely, subject to the following restrictions:
+//
+// 1. The origin of this software must not be misrepresented; you must not
+//   claim that you wrote the original software. If you use this software
+//   in a product, an acknowledgment in the product documentation would be
+//   appreciated but is not required.
+// 2. Altered source versions must be plainly marked as such, and must not be
+//   misrepresented as being the original software.
+// 3. This notice may not be removed or altered from any source distribution.
+
+function ZStream() {
+  /* next input byte */
+  this.input = null; // JS specific, because we have no pointers
+  this.next_in = 0;
+  /* number of bytes available at input */
+  this.avail_in = 0;
+  /* total number of input bytes read so far */
+  this.total_in = 0;
+  /* next output byte should be put there */
+  this.output = null; // JS specific, because we have no pointers
+  this.next_out = 0;
+  /* remaining free space at output */
+  this.avail_out = 0;
+  /* total number of bytes output so far */
+  this.total_out = 0;
+  /* last error message, NULL if no error */
+  this.msg = ''/*Z_NULL*/;
+  /* not visible by applications */
+  this.state = null;
+  /* best guess about the data type: binary or text */
+  this.data_type = 2/*Z_UNKNOWN*/;
+  /* adler32 value of the uncompressed data */
+  this.adler = 0;
+}
+
+module.exports = ZStream;
+
+},{}]},{},[10])(10)
+});
\ No newline at end of file
diff --git a/spring-cloud-contract-maven-plugin/apidocs/jquery/jszip/dist/jszip.min.js b/spring-cloud-contract-maven-plugin/apidocs/jquery/jszip/dist/jszip.min.js
new file mode 100644
index 0000000000..b9188736b7
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/jquery/jszip/dist/jszip.min.js
@@ -0,0 +1,15 @@
+/*!
+
+JSZip v3.1.5 - A JavaScript class for generating and reading zip files
+<http://stuartk.com/jszip>
+
+(c) 2009-2016 Stuart Knightley <stuart [at] stuartk.com>
+Dual licenced under the MIT license or GPLv3. See https://raw.github.com/Stuk/jszip/master/LICENSE.markdown.
+
+JSZip uses the library pako released under the MIT license :
+https://github.com/nodeca/pako/blob/master/LICENSE
+*/
+!function(a){if("object"==typeof exports&&"undefined"!=typeof module)module.exports=a();else if("function"==typeof define&&define.amd)define([],a);else{var b;b="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof self?self:this,b.JSZip=a()}}(function(){return function a(b,c,d){function e(g,h){if(!c[g]){if(!b[g]){var i="function"==typeof require&&require;if(!h&&i)return i(g,!0);if(f)return f(g,!0);var j=new Error("Cannot find module '"+g+"'");throw j.code="MODULE_NOT_FOUND",j}var k=c[g]={exports:{}};b[g][0].call(k.exports,function(a){var c=b[g][1][a];return e(c?c:a)},k,k.exports,a,b,c,d)}return c[g].exports}for(var f="function"==typeof require&&require,g=0;g<d.length;g++)e(d[g]);return e}({1:[function(a,b,c){"use strict";var d=a("./utils"),e=a("./support"),f="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=";c.encode=function(a){for(var b,c,e,g,h,i,j,k=[],l=0,m=a.length,n=m,o="string"!==d.getTypeOf(a);l<a.length;)n=m-l,o?(b=a[l++],c=l<m?a[l++]:0,e=l<m?a[l++]:0):(b=a.charCodeAt(l++),c=l<m?a.charCodeAt(l++):0,e=l<m?a.charCodeAt(l++):0),g=b>>2,h=(3&b)<<4|c>>4,i=n>1?(15&c)<<2|e>>6:64,j=n>2?63&e:64,k.push(f.charAt(g)+f.charAt(h)+f.charAt(i)+f.charAt(j));return k.join("")},c.decode=function(a){var b,c,d,g,h,i,j,k=0,l=0,m="data:";if(a.substr(0,m.length)===m)throw new Error("Invalid base64 input, it looks like a data url.");a=a.replace(/[^A-Za-z0-9\+\/\=]/g,"");var n=3*a.length/4;if(a.charAt(a.length-1)===f.charAt(64)&&n--,a.charAt(a.length-2)===f.charAt(64)&&n--,n%1!==0)throw new Error("Invalid base64 input, bad content length.");var o;for(o=e.uint8array?new Uint8Array(0|n):new Array(0|n);k<a.length;)g=f.indexOf(a.charAt(k++)),h=f.indexOf(a.charAt(k++)),i=f.indexOf(a.charAt(k++)),j=f.indexOf(a.charAt(k++)),b=g<<2|h>>4,c=(15&h)<<4|i>>2,d=(3&i)<<6|j,o[l++]=b,64!==i&&(o[l++]=c),64!==j&&(o[l++]=d);return o}},{"./support":30,"./utils":32}],2:[function(a,b,c){"use strict";function d(a,b,c,d,e){this.compressedSize=a,this.uncompressedSize=b,this.crc32=c,this.compression=d,this.compressedContent=e}var e=a("./external"),f=a("./stream/DataWorker"),g=a("./stream/DataLengthProbe"),h=a("./stream/Crc32Probe"),g=a("./stream/DataLengthProbe");d.prototype={getContentWorker:function(){var a=new f(e.Promise.resolve(this.compressedContent)).pipe(this.compression.uncompressWorker()).pipe(new g("data_length")),b=this;return a.on("end",function(){if(this.streamInfo.data_length!==b.uncompressedSize)throw new Error("Bug : uncompressed data size mismatch")}),a},getCompressedWorker:function(){return new f(e.Promise.resolve(this.compressedContent)).withStreamInfo("compressedSize",this.compressedSize).withStreamInfo("uncompressedSize",this.uncompressedSize).withStreamInfo("crc32",this.crc32).withStreamInfo("compression",this.compression)}},d.createWorkerFrom=function(a,b,c){return a.pipe(new h).pipe(new g("uncompressedSize")).pipe(b.compressWorker(c)).pipe(new g("compressedSize")).withStreamInfo("compression",b)},b.exports=d},{"./external":6,"./stream/Crc32Probe":25,"./stream/DataLengthProbe":26,"./stream/DataWorker":27}],3:[function(a,b,c){"use strict";var d=a("./stream/GenericWorker");c.STORE={magic:"\0\0",compressWorker:function(a){return new d("STORE compression")},uncompressWorker:function(){return new d("STORE decompression")}},c.DEFLATE=a("./flate")},{"./flate":7,"./stream/GenericWorker":28}],4:[function(a,b,c){"use strict";function d(){for(var a,b=[],c=0;c<256;c++){a=c;for(var d=0;d<8;d++)a=1&a?3988292384^a>>>1:a>>>1;b[c]=a}return b}function e(a,b,c,d){var e=h,f=d+c;a^=-1;for(var g=d;g<f;g++)a=a>>>8^e[255&(a^b[g])];return a^-1}function f(a,b,c,d){var e=h,f=d+c;a^=-1;for(var g=d;g<f;g++)a=a>>>8^e[255&(a^b.charCodeAt(g))];return a^-1}var g=a("./utils"),h=d();b.exports=function(a,b){if("undefined"==typeof a||!a.length)return 0;var c="string"!==g.getTypeOf(a);return c?e(0|b,a,a.length,0):f(0|b,a,a.length,0)}},{"./utils":32}],5:[function(a,b,c){"use strict";c.base64=!1,c.binary=!1,c.dir=!1,c.createFolders=!0,c.date=null,c.compression=null,c.compressionOptions=null,c.comment=null,c.unixPermissions=null,c.dosPermissions=null},{}],6:[function(a,b,c){"use strict";var d=null;d="undefined"!=typeof Promise?Promise:a("lie"),b.exports={Promise:d}},{lie:58}],7:[function(a,b,c){"use strict";function d(a,b){h.call(this,"FlateWorker/"+a),this._pako=null,this._pakoAction=a,this._pakoOptions=b,this.meta={}}var e="undefined"!=typeof Uint8Array&&"undefined"!=typeof Uint16Array&&"undefined"!=typeof Uint32Array,f=a("pako"),g=a("./utils"),h=a("./stream/GenericWorker"),i=e?"uint8array":"array";c.magic="\b\0",g.inherits(d,h),d.prototype.processChunk=function(a){this.meta=a.meta,null===this._pako&&this._createPako(),this._pako.push(g.transformTo(i,a.data),!1)},d.prototype.flush=function(){h.prototype.flush.call(this),null===this._pako&&this._createPako(),this._pako.push([],!0)},d.prototype.cleanUp=function(){h.prototype.cleanUp.call(this),this._pako=null},d.prototype._createPako=function(){this._pako=new f[this._pakoAction]({raw:!0,level:this._pakoOptions.level||-1});var a=this;this._pako.onData=function(b){a.push({data:b,meta:a.meta})}},c.compressWorker=function(a){return new d("Deflate",a)},c.uncompressWorker=function(){return new d("Inflate",{})}},{"./stream/GenericWorker":28,"./utils":32,pako:59}],8:[function(a,b,c){"use strict";function d(a,b,c,d){f.call(this,"ZipFileWorker"),this.bytesWritten=0,this.zipComment=b,this.zipPlatform=c,this.encodeFileName=d,this.streamFiles=a,this.accumulate=!1,this.contentBuffer=[],this.dirRecords=[],this.currentSourceOffset=0,this.entriesCount=0,this.currentFile=null,this._sources=[]}var e=a("../utils"),f=a("../stream/GenericWorker"),g=a("../utf8"),h=a("../crc32"),i=a("../signature"),j=function(a,b){var c,d="";for(c=0;c<b;c++)d+=String.fromCharCode(255&a),a>>>=8;return d},k=function(a,b){var c=a;return a||(c=b?16893:33204),(65535&c)<<16},l=function(a,b){return 63&(a||0)},m=function(a,b,c,d,f,m){var n,o,p=a.file,q=a.compression,r=m!==g.utf8encode,s=e.transformTo("string",m(p.name)),t=e.transformTo("string",g.utf8encode(p.name)),u=p.comment,v=e.transformTo("string",m(u)),w=e.transformTo("string",g.utf8encode(u)),x=t.length!==p.name.length,y=w.length!==u.length,z="",A="",B="",C=p.dir,D=p.date,E={crc32:0,compressedSize:0,uncompressedSize:0};b&&!c||(E.crc32=a.crc32,E.compressedSize=a.compressedSize,E.uncompressedSize=a.uncompressedSize);var F=0;b&&(F|=8),r||!x&&!y||(F|=2048);var G=0,H=0;C&&(G|=16),"UNIX"===f?(H=798,G|=k(p.unixPermissions,C)):(H=20,G|=l(p.dosPermissions,C)),n=D.getUTCHours(),n<<=6,n|=D.getUTCMinutes(),n<<=5,n|=D.getUTCSeconds()/2,o=D.getUTCFullYear()-1980,o<<=4,o|=D.getUTCMonth()+1,o<<=5,o|=D.getUTCDate(),x&&(A=j(1,1)+j(h(s),4)+t,z+="up"+j(A.length,2)+A),y&&(B=j(1,1)+j(h(v),4)+w,z+="uc"+j(B.length,2)+B);var I="";I+="\n\0",I+=j(F,2),I+=q.magic,I+=j(n,2),I+=j(o,2),I+=j(E.crc32,4),I+=j(E.compressedSize,4),I+=j(E.uncompressedSize,4),I+=j(s.length,2),I+=j(z.length,2);var J=i.LOCAL_FILE_HEADER+I+s+z,K=i.CENTRAL_FILE_HEADER+j(H,2)+I+j(v.length,2)+"\0\0\0\0"+j(G,4)+j(d,4)+s+z+v;return{fileRecord:J,dirRecord:K}},n=function(a,b,c,d,f){var g="",h=e.transformTo("string",f(d));return g=i.CENTRAL_DIRECTORY_END+"\0\0\0\0"+j(a,2)+j(a,2)+j(b,4)+j(c,4)+j(h.length,2)+h},o=function(a){var b="";return b=i.DATA_DESCRIPTOR+j(a.crc32,4)+j(a.compressedSize,4)+j(a.uncompressedSize,4)};e.inherits(d,f),d.prototype.push=function(a){var b=a.meta.percent||0,c=this.entriesCount,d=this._sources.length;this.accumulate?this.contentBuffer.push(a):(this.bytesWritten+=a.data.length,f.prototype.push.call(this,{data:a.data,meta:{currentFile:this.currentFile,percent:c?(b+100*(c-d-1))/c:100}}))},d.prototype.openedSource=function(a){this.currentSourceOffset=this.bytesWritten,this.currentFile=a.file.name;var b=this.streamFiles&&!a.file.dir;if(b){var c=m(a,b,!1,this.currentSourceOffset,this.zipPlatform,this.encodeFileName);this.push({data:c.fileRecord,meta:{percent:0}})}else this.accumulate=!0},d.prototype.closedSource=function(a){this.accumulate=!1;var b=this.streamFiles&&!a.file.dir,c=m(a,b,!0,this.currentSourceOffset,this.zipPlatform,this.encodeFileName);if(this.dirRecords.push(c.dirRecord),b)this.push({data:o(a),meta:{percent:100}});else for(this.push({data:c.fileRecord,meta:{percent:0}});this.contentBuffer.length;)this.push(this.contentBuffer.shift());this.currentFile=null},d.prototype.flush=function(){for(var a=this.bytesWritten,b=0;b<this.dirRecords.length;b++)this.push({data:this.dirRecords[b],meta:{percent:100}});var c=this.bytesWritten-a,d=n(this.dirRecords.length,c,a,this.zipComment,this.encodeFileName);this.push({data:d,meta:{percent:100}})},d.prototype.prepareNextSource=function(){this.previous=this._sources.shift(),this.openedSource(this.previous.streamInfo),this.isPaused?this.previous.pause():this.previous.resume()},d.prototype.registerPrevious=function(a){this._sources.push(a);var b=this;return a.on("data",function(a){b.processChunk(a)}),a.on("end",function(){b.closedSource(b.previous.streamInfo),b._sources.length?b.prepareNextSource():b.end()}),a.on("error",function(a){b.error(a)}),this},d.prototype.resume=function(){return!!f.prototype.resume.call(this)&&(!this.previous&&this._sources.length?(this.prepareNextSource(),!0):this.previous||this._sources.length||this.generatedError?void 0:(this.end(),!0))},d.prototype.error=function(a){var b=this._sources;if(!f.prototype.error.call(this,a))return!1;for(var c=0;c<b.length;c++)try{b[c].error(a)}catch(a){}return!0},d.prototype.lock=function(){f.prototype.lock.call(this);for(var a=this._sources,b=0;b<a.length;b++)a[b].lock()},b.exports=d},{"../crc32":4,"../signature":23,"../stream/GenericWorker":28,"../utf8":31,"../utils":32}],9:[function(a,b,c){"use strict";var d=a("../compressions"),e=a("./ZipFileWorker"),f=function(a,b){var c=a||b,e=d[c];if(!e)throw new Error(c+" is not a valid compression method !");return e};c.generateWorker=function(a,b,c){var d=new e(b.streamFiles,c,b.platform,b.encodeFileName),g=0;try{a.forEach(function(a,c){g++;var e=f(c.options.compression,b.compression),h=c.options.compressionOptions||b.compressionOptions||{},i=c.dir,j=c.date;c._compressWorker(e,h).withStreamInfo("file",{name:a,dir:i,date:j,comment:c.comment||"",unixPermissions:c.unixPermissions,dosPermissions:c.dosPermissions}).pipe(d)}),d.entriesCount=g}catch(h){d.error(h)}return d}},{"../compressions":3,"./ZipFileWorker":8}],10:[function(a,b,c){"use strict";function d(){if(!(this instanceof d))return new d;if(arguments.length)throw new Error("The constructor with parameters has been removed in JSZip 3.0, please check the upgrade guide.");this.files={},this.comment=null,this.root="",this.clone=function(){var a=new d;for(var b in this)"function"!=typeof this[b]&&(a[b]=this[b]);return a}}d.prototype=a("./object"),d.prototype.loadAsync=a("./load"),d.support=a("./support"),d.defaults=a("./defaults"),d.version="3.1.5",d.loadAsync=function(a,b){return(new d).loadAsync(a,b)},d.external=a("./external"),b.exports=d},{"./defaults":5,"./external":6,"./load":11,"./object":15,"./support":30}],11:[function(a,b,c){"use strict";function d(a){return new f.Promise(function(b,c){var d=a.decompressed.getContentWorker().pipe(new i);d.on("error",function(a){c(a)}).on("end",function(){d.streamInfo.crc32!==a.decompressed.crc32?c(new Error("Corrupted zip : CRC32 mismatch")):b()}).resume()})}var e=a("./utils"),f=a("./external"),g=a("./utf8"),e=a("./utils"),h=a("./zipEntries"),i=a("./stream/Crc32Probe"),j=a("./nodejsUtils");b.exports=function(a,b){var c=this;return b=e.extend(b||{},{base64:!1,checkCRC32:!1,optimizedBinaryString:!1,createFolders:!1,decodeFileName:g.utf8decode}),j.isNode&&j.isStream(a)?f.Promise.reject(new Error("JSZip can't accept a stream when loading a zip file.")):e.prepareContent("the loaded zip file",a,!0,b.optimizedBinaryString,b.base64).then(function(a){var c=new h(b);return c.load(a),c}).then(function(a){var c=[f.Promise.resolve(a)],e=a.files;if(b.checkCRC32)for(var g=0;g<e.length;g++)c.push(d(e[g]));return f.Promise.all(c)}).then(function(a){for(var d=a.shift(),e=d.files,f=0;f<e.length;f++){var g=e[f];c.file(g.fileNameStr,g.decompressed,{binary:!0,optimizedBinaryString:!0,date:g.date,dir:g.dir,comment:g.fileCommentStr.length?g.fileCommentStr:null,unixPermissions:g.unixPermissions,dosPermissions:g.dosPermissions,createFolders:b.createFolders})}return d.zipComment.length&&(c.comment=d.zipComment),c})}},{"./external":6,"./nodejsUtils":14,"./stream/Crc32Probe":25,"./utf8":31,"./utils":32,"./zipEntries":33}],12:[function(a,b,c){"use strict";function d(a,b){f.call(this,"Nodejs stream input adapter for "+a),this._upstreamEnded=!1,this._bindStream(b)}var e=a("../utils"),f=a("../stream/GenericWorker");e.inherits(d,f),d.prototype._bindStream=function(a){var b=this;this._stream=a,a.pause(),a.on("data",function(a){b.push({data:a,meta:{percent:0}})}).on("error",function(a){b.isPaused?this.generatedError=a:b.error(a)}).on("end",function(){b.isPaused?b._upstreamEnded=!0:b.end()})},d.prototype.pause=function(){return!!f.prototype.pause.call(this)&&(this._stream.pause(),!0)},d.prototype.resume=function(){return!!f.prototype.resume.call(this)&&(this._upstreamEnded?this.end():this._stream.resume(),!0)},b.exports=d},{"../stream/GenericWorker":28,"../utils":32}],13:[function(a,b,c){"use strict";function d(a,b,c){e.call(this,b),this._helper=a;var d=this;a.on("data",function(a,b){d.push(a)||d._helper.pause(),c&&c(b)}).on("error",function(a){d.emit("error",a)}).on("end",function(){d.push(null)})}var e=a("readable-stream").Readable,f=a("../utils");f.inherits(d,e),d.prototype._read=function(){this._helper.resume()},b.exports=d},{"../utils":32,"readable-stream":16}],14:[function(a,b,c){"use strict";b.exports={isNode:"undefined"!=typeof Buffer,newBufferFrom:function(a,b){return new Buffer(a,b)},allocBuffer:function(a){return Buffer.alloc?Buffer.alloc(a):new Buffer(a)},isBuffer:function(a){return Buffer.isBuffer(a)},isStream:function(a){return a&&"function"==typeof a.on&&"function"==typeof a.pause&&"function"==typeof a.resume}}},{}],15:[function(a,b,c){"use strict";function d(a){return"[object RegExp]"===Object.prototype.toString.call(a)}var e=a("./utf8"),f=a("./utils"),g=a("./stream/GenericWorker"),h=a("./stream/StreamHelper"),i=a("./defaults"),j=a("./compressedObject"),k=a("./zipObject"),l=a("./generate"),m=a("./nodejsUtils"),n=a("./nodejs/NodejsStreamInputAdapter"),o=function(a,b,c){var d,e=f.getTypeOf(b),h=f.extend(c||{},i);h.date=h.date||new Date,null!==h.compression&&(h.compression=h.compression.toUpperCase()),"string"==typeof h.unixPermissions&&(h.unixPermissions=parseInt(h.unixPermissions,8)),h.unixPermissions&&16384&h.unixPermissions&&(h.dir=!0),h.dosPermissions&&16&h.dosPermissions&&(h.dir=!0),h.dir&&(a=q(a)),h.createFolders&&(d=p(a))&&r.call(this,d,!0);var l="string"===e&&h.binary===!1&&h.base64===!1;c&&"undefined"!=typeof c.binary||(h.binary=!l);var o=b instanceof j&&0===b.uncompressedSize;(o||h.dir||!b||0===b.length)&&(h.base64=!1,h.binary=!0,b="",h.compression="STORE",e="string");var s=null;s=b instanceof j||b instanceof g?b:m.isNode&&m.isStream(b)?new n(a,b):f.prepareContent(a,b,h.binary,h.optimizedBinaryString,h.base64);var t=new k(a,s,h);this.files[a]=t},p=function(a){"/"===a.slice(-1)&&(a=a.substring(0,a.length-1));var b=a.lastIndexOf("/");return b>0?a.substring(0,b):""},q=function(a){return"/"!==a.slice(-1)&&(a+="/"),a},r=function(a,b){return b="undefined"!=typeof b?b:i.createFolders,a=q(a),this.files[a]||o.call(this,a,null,{dir:!0,createFolders:b}),this.files[a]},s={load:function(){throw new Error("This method has been removed in JSZip 3.0, please check the upgrade guide.")},forEach:function(a){var b,c,d;for(b in this.files)this.files.hasOwnProperty(b)&&(d=this.files[b],c=b.slice(this.root.length,b.length),c&&b.slice(0,this.root.length)===this.root&&a(c,d))},filter:function(a){var b=[];return this.forEach(function(c,d){a(c,d)&&b.push(d)}),b},file:function(a,b,c){if(1===arguments.length){if(d(a)){var e=a;return this.filter(function(a,b){return!b.dir&&e.test(a)})}var f=this.files[this.root+a];return f&&!f.dir?f:null}return a=this.root+a,o.call(this,a,b,c),this},folder:function(a){if(!a)return this;if(d(a))return this.filter(function(b,c){return c.dir&&a.test(b)});var b=this.root+a,c=r.call(this,b),e=this.clone();return e.root=c.name,e},remove:function(a){a=this.root+a;var b=this.files[a];if(b||("/"!==a.slice(-1)&&(a+="/"),b=this.files[a]),b&&!b.dir)delete this.files[a];else for(var c=this.filter(function(b,c){return c.name.slice(0,a.length)===a}),d=0;d<c.length;d++)delete this.files[c[d].name];return this},generate:function(a){throw new Error("This method has been removed in JSZip 3.0, please check the upgrade guide.")},generateInternalStream:function(a){var b,c={};try{if(c=f.extend(a||{},{streamFiles:!1,compression:"STORE",compressionOptions:null,type:"",platform:"DOS",comment:null,mimeType:"application/zip",encodeFileName:e.utf8encode}),c.type=c.type.toLowerCase(),c.compression=c.compression.toUpperCase(),"binarystring"===c.type&&(c.type="string"),!c.type)throw new Error("No output type specified.");f.checkSupport(c.type),"darwin"!==c.platform&&"freebsd"!==c.platform&&"linux"!==c.platform&&"sunos"!==c.platform||(c.platform="UNIX"),"win32"===c.platform&&(c.platform="DOS");var d=c.comment||this.comment||"";b=l.generateWorker(this,c,d)}catch(i){b=new g("error"),b.error(i)}return new h(b,c.type||"string",c.mimeType)},generateAsync:function(a,b){return this.generateInternalStream(a).accumulate(b)},generateNodeStream:function(a,b){return a=a||{},a.type||(a.type="nodebuffer"),this.generateInternalStream(a).toNodejsStream(b)}};b.exports=s},{"./compressedObject":2,"./defaults":5,"./generate":9,"./nodejs/NodejsStreamInputAdapter":12,"./nodejsUtils":14,"./stream/GenericWorker":28,"./stream/StreamHelper":29,"./utf8":31,"./utils":32,"./zipObject":35}],16:[function(a,b,c){b.exports=a("stream")},{stream:void 0}],17:[function(a,b,c){"use strict";function d(a){e.call(this,a);for(var b=0;b<this.data.length;b++)a[b]=255&a[b]}var e=a("./DataReader"),f=a("../utils");f.inherits(d,e),d.prototype.byteAt=function(a){return this.data[this.zero+a]},d.prototype.lastIndexOfSignature=function(a){for(var b=a.charCodeAt(0),c=a.charCodeAt(1),d=a.charCodeAt(2),e=a.charCodeAt(3),f=this.length-4;f>=0;--f)if(this.data[f]===b&&this.data[f+1]===c&&this.data[f+2]===d&&this.data[f+3]===e)return f-this.zero;return-1},d.prototype.readAndCheckSignature=function(a){var b=a.charCodeAt(0),c=a.charCodeAt(1),d=a.charCodeAt(2),e=a.charCodeAt(3),f=this.readData(4);return b===f[0]&&c===f[1]&&d===f[2]&&e===f[3]},d.prototype.readData=function(a){if(this.checkOffset(a),0===a)return[];var b=this.data.slice(this.zero+this.index,this.zero+this.index+a);return this.index+=a,b},b.exports=d},{"../utils":32,"./DataReader":18}],18:[function(a,b,c){"use strict";function d(a){this.data=a,this.length=a.length,this.index=0,this.zero=0}var e=a("../utils");d.prototype={checkOffset:function(a){this.checkIndex(this.index+a)},checkIndex:function(a){if(this.length<this.zero+a||a<0)throw new Error("End of data reached (data length = "+this.length+", asked index = "+a+"). Corrupted zip ?")},setIndex:function(a){this.checkIndex(a),this.index=a},skip:function(a){this.setIndex(this.index+a)},byteAt:function(a){},readInt:function(a){var b,c=0;for(this.checkOffset(a),b=this.index+a-1;b>=this.index;b--)c=(c<<8)+this.byteAt(b);return this.index+=a,c},readString:function(a){return e.transformTo("string",this.readData(a))},readData:function(a){},lastIndexOfSignature:function(a){},readAndCheckSignature:function(a){},readDate:function(){var a=this.readInt(4);return new Date(Date.UTC((a>>25&127)+1980,(a>>21&15)-1,a>>16&31,a>>11&31,a>>5&63,(31&a)<<1))}},b.exports=d},{"../utils":32}],19:[function(a,b,c){"use strict";function d(a){e.call(this,a)}var e=a("./Uint8ArrayReader"),f=a("../utils");f.inherits(d,e),d.prototype.readData=function(a){this.checkOffset(a);var b=this.data.slice(this.zero+this.index,this.zero+this.index+a);return this.index+=a,b},b.exports=d},{"../utils":32,"./Uint8ArrayReader":21}],20:[function(a,b,c){"use strict";function d(a){e.call(this,a)}var e=a("./DataReader"),f=a("../utils");f.inherits(d,e),d.prototype.byteAt=function(a){return this.data.charCodeAt(this.zero+a)},d.prototype.lastIndexOfSignature=function(a){return this.data.lastIndexOf(a)-this.zero},d.prototype.readAndCheckSignature=function(a){var b=this.readData(4);return a===b},d.prototype.readData=function(a){this.checkOffset(a);var b=this.data.slice(this.zero+this.index,this.zero+this.index+a);return this.index+=a,b},b.exports=d},{"../utils":32,"./DataReader":18}],21:[function(a,b,c){"use strict";function d(a){e.call(this,a)}var e=a("./ArrayReader"),f=a("../utils");f.inherits(d,e),d.prototype.readData=function(a){if(this.checkOffset(a),0===a)return new Uint8Array(0);var b=this.data.subarray(this.zero+this.index,this.zero+this.index+a);return this.index+=a,b},b.exports=d},{"../utils":32,"./ArrayReader":17}],22:[function(a,b,c){"use strict";var d=a("../utils"),e=a("../support"),f=a("./ArrayReader"),g=a("./StringReader"),h=a("./NodeBufferReader"),i=a("./Uint8ArrayReader");b.exports=function(a){var b=d.getTypeOf(a);return d.checkSupport(b),"string"!==b||e.uint8array?"nodebuffer"===b?new h(a):e.uint8array?new i(d.transformTo("uint8array",a)):new f(d.transformTo("array",a)):new g(a)}},{"../support":30,"../utils":32,"./ArrayReader":17,"./NodeBufferReader":19,"./StringReader":20,"./Uint8ArrayReader":21}],23:[function(a,b,c){"use strict";c.LOCAL_FILE_HEADER="PK",c.CENTRAL_FILE_HEADER="PK
",c.CENTRAL_DIRECTORY_END="PK",c.ZIP64_CENTRAL_DIRECTORY_LOCATOR="PK",c.ZIP64_CENTRAL_DIRECTORY_END="PK",c.DATA_DESCRIPTOR="PK\b"},{}],24:[function(a,b,c){"use strict";function d(a){e.call(this,"ConvertWorker to "+a),this.destType=a}var e=a("./GenericWorker"),f=a("../utils");f.inherits(d,e),d.prototype.processChunk=function(a){this.push({data:f.transformTo(this.destType,a.data),meta:a.meta})},b.exports=d},{"../utils":32,"./GenericWorker":28}],25:[function(a,b,c){"use strict";function d(){e.call(this,"Crc32Probe"),this.withStreamInfo("crc32",0)}var e=a("./GenericWorker"),f=a("../crc32"),g=a("../utils");g.inherits(d,e),d.prototype.processChunk=function(a){this.streamInfo.crc32=f(a.data,this.streamInfo.crc32||0),this.push(a)},b.exports=d},{"../crc32":4,"../utils":32,"./GenericWorker":28}],26:[function(a,b,c){"use strict";function d(a){f.call(this,"DataLengthProbe for "+a),this.propName=a,this.withStreamInfo(a,0)}var e=a("../utils"),f=a("./GenericWorker");e.inherits(d,f),d.prototype.processChunk=function(a){if(a){var b=this.streamInfo[this.propName]||0;this.streamInfo[this.propName]=b+a.data.length}f.prototype.processChunk.call(this,a)},b.exports=d},{"../utils":32,"./GenericWorker":28}],27:[function(a,b,c){"use strict";function d(a){f.call(this,"DataWorker");var b=this;this.dataIsReady=!1,this.index=0,this.max=0,this.data=null,this.type="",this._tickScheduled=!1,a.then(function(a){b.dataIsReady=!0,b.data=a,b.max=a&&a.length||0,b.type=e.getTypeOf(a),b.isPaused||b._tickAndRepeat()},function(a){b.error(a)})}var e=a("../utils"),f=a("./GenericWorker"),g=16384;e.inherits(d,f),d.prototype.cleanUp=function(){f.prototype.cleanUp.call(this),this.data=null},d.prototype.resume=function(){return!!f.prototype.resume.call(this)&&(!this._tickScheduled&&this.dataIsReady&&(this._tickScheduled=!0,e.delay(this._tickAndRepeat,[],this)),!0)},d.prototype._tickAndRepeat=function(){this._tickScheduled=!1,this.isPaused||this.isFinished||(this._tick(),this.isFinished||(e.delay(this._tickAndRepeat,[],this),this._tickScheduled=!0))},d.prototype._tick=function(){if(this.isPaused||this.isFinished)return!1;var a=g,b=null,c=Math.min(this.max,this.index+a);if(this.index>=this.max)return this.end();switch(this.type){case"string":b=this.data.substring(this.index,c);break;case"uint8array":b=this.data.subarray(this.index,c);break;case"array":case"nodebuffer":b=this.data.slice(this.index,c)}return this.index=c,this.push({data:b,meta:{percent:this.max?this.index/this.max*100:0}})},b.exports=d},{"../utils":32,"./GenericWorker":28}],28:[function(a,b,c){"use strict";function d(a){this.name=a||"default",this.streamInfo={},this.generatedError=null,this.extraStreamInfo={},this.isPaused=!0,this.isFinished=!1,this.isLocked=!1,this._listeners={data:[],end:[],error:[]},this.previous=null}d.prototype={push:function(a){this.emit("data",a)},end:function(){if(this.isFinished)return!1;this.flush();try{this.emit("end"),this.cleanUp(),this.isFinished=!0}catch(a){this.emit("error",a)}return!0},error:function(a){return!this.isFinished&&(this.isPaused?this.generatedError=a:(this.isFinished=!0,this.emit("error",a),this.previous&&this.previous.error(a),this.cleanUp()),!0)},on:function(a,b){return this._listeners[a].push(b),this},cleanUp:function(){this.streamInfo=this.generatedError=this.extraStreamInfo=null,this._listeners=[]},emit:function(a,b){if(this._listeners[a])for(var c=0;c<this._listeners[a].length;c++)this._listeners[a][c].call(this,b)},pipe:function(a){return a.registerPrevious(this)},registerPrevious:function(a){if(this.isLocked)throw new Error("The stream '"+this+"' has already been used.");this.streamInfo=a.streamInfo,this.mergeStreamInfo(),this.previous=a;var b=this;return a.on("data",function(a){b.processChunk(a)}),a.on("end",function(){b.end()}),a.on("error",function(a){b.error(a)}),this},pause:function(){return!this.isPaused&&!this.isFinished&&(this.isPaused=!0,this.previous&&this.previous.pause(),!0)},resume:function(){if(!this.isPaused||this.isFinished)return!1;this.isPaused=!1;var a=!1;return this.generatedError&&(this.error(this.generatedError),a=!0),this.previous&&this.previous.resume(),!a},flush:function(){},processChunk:function(a){this.push(a)},withStreamInfo:function(a,b){return this.extraStreamInfo[a]=b,this.mergeStreamInfo(),this},mergeStreamInfo:function(){for(var a in this.extraStreamInfo)this.extraStreamInfo.hasOwnProperty(a)&&(this.streamInfo[a]=this.extraStreamInfo[a])},lock:function(){if(this.isLocked)throw new Error("The stream '"+this+"' has already been used.");this.isLocked=!0,this.previous&&this.previous.lock()},toString:function(){var a="Worker "+this.name;return this.previous?this.previous+" -> "+a:a}},b.exports=d},{}],29:[function(a,b,c){"use strict";function d(a,b,c){switch(a){case"blob":return h.newBlob(h.transformTo("arraybuffer",b),c);case"base64":return k.encode(b);default:return h.transformTo(a,b)}}function e(a,b){var c,d=0,e=null,f=0;for(c=0;c<b.length;c++)f+=b[c].length;switch(a){case"string":return b.join("");case"array":return Array.prototype.concat.apply([],b);case"uint8array":for(e=new Uint8Array(f),c=0;c<b.length;c++)e.set(b[c],d),d+=b[c].length;return e;case"nodebuffer":return Buffer.concat(b);default:throw new Error("concat : unsupported type '"+a+"'")}}function f(a,b){return new m.Promise(function(c,f){var g=[],h=a._internalType,i=a._outputType,j=a._mimeType;a.on("data",function(a,c){g.push(a),b&&b(c)}).on("error",function(a){g=[],f(a)}).on("end",function(){try{var a=d(i,e(h,g),j);c(a)}catch(b){f(b)}g=[]}).resume()})}function g(a,b,c){var d=b;switch(b){case"blob":case"arraybuffer":d="uint8array";break;case"base64":d="string"}try{this._internalType=d,this._outputType=b,this._mimeType=c,h.checkSupport(d),this._worker=a.pipe(new i(d)),a.lock()}catch(e){this._worker=new j("error"),this._worker.error(e)}}var h=a("../utils"),i=a("./ConvertWorker"),j=a("./GenericWorker"),k=a("../base64"),l=a("../support"),m=a("../external"),n=null;if(l.nodestream)try{n=a("../nodejs/NodejsStreamOutputAdapter")}catch(o){}g.prototype={accumulate:function(a){return f(this,a)},on:function(a,b){var c=this;return"data"===a?this._worker.on(a,function(a){b.call(c,a.data,a.meta)}):this._worker.on(a,function(){h.delay(b,arguments,c)}),this},resume:function(){return h.delay(this._worker.resume,[],this._worker),this},pause:function(){return this._worker.pause(),this},toNodejsStream:function(a){if(h.checkSupport("nodestream"),"nodebuffer"!==this._outputType)throw new Error(this._outputType+" is not supported by this method");return new n(this,{objectMode:"nodebuffer"!==this._outputType},a)}},b.exports=g},{"../base64":1,"../external":6,"../nodejs/NodejsStreamOutputAdapter":13,"../support":30,"../utils":32,"./ConvertWorker":24,"./GenericWorker":28}],30:[function(a,b,c){"use strict";if(c.base64=!0,c.array=!0,c.string=!0,c.arraybuffer="undefined"!=typeof ArrayBuffer&&"undefined"!=typeof Uint8Array,c.nodebuffer="undefined"!=typeof Buffer,c.uint8array="undefined"!=typeof Uint8Array,"undefined"==typeof ArrayBuffer)c.blob=!1;else{var d=new ArrayBuffer(0);try{c.blob=0===new Blob([d],{type:"application/zip"}).size}catch(e){try{var f=self.BlobBuilder||self.WebKitBlobBuilder||self.MozBlobBuilder||self.MSBlobBuilder,g=new f;g.append(d),c.blob=0===g.getBlob("application/zip").size}catch(e){c.blob=!1}}}try{c.nodestream=!!a("readable-stream").Readable}catch(e){c.nodestream=!1}},{"readable-stream":16}],31:[function(a,b,c){"use strict";function d(){i.call(this,"utf-8 decode"),this.leftOver=null}function e(){i.call(this,"utf-8 encode")}for(var f=a("./utils"),g=a("./support"),h=a("./nodejsUtils"),i=a("./stream/GenericWorker"),j=new Array(256),k=0;k<256;k++)j[k]=k>=252?6:k>=248?5:k>=240?4:k>=224?3:k>=192?2:1;j[254]=j[254]=1;var l=function(a){var b,c,d,e,f,h=a.length,i=0;for(e=0;e<h;e++)c=a.charCodeAt(e),55296===(64512&c)&&e+1<h&&(d=a.charCodeAt(e+1),56320===(64512&d)&&(c=65536+(c-55296<<10)+(d-56320),e++)),i+=c<128?1:c<2048?2:c<65536?3:4;for(b=g.uint8array?new Uint8Array(i):new Array(i),f=0,e=0;f<i;e++)c=a.charCodeAt(e),55296===(64512&c)&&e+1<h&&(d=a.charCodeAt(e+1),56320===(64512&d)&&(c=65536+(c-55296<<10)+(d-56320),e++)),c<128?b[f++]=c:c<2048?(b[f++]=192|c>>>6,b[f++]=128|63&c):c<65536?(b[f++]=224|c>>>12,b[f++]=128|c>>>6&63,b[f++]=128|63&c):(b[f++]=240|c>>>18,b[f++]=128|c>>>12&63,b[f++]=128|c>>>6&63,b[f++]=128|63&c);return b},m=function(a,b){var c;for(b=b||a.length,b>a.length&&(b=a.length),c=b-1;c>=0&&128===(192&a[c]);)c--;return c<0?b:0===c?b:c+j[a[c]]>b?c:b},n=function(a){var b,c,d,e,g=a.length,h=new Array(2*g);for(c=0,b=0;b<g;)if(d=a[b++],d<128)h[c++]=d;else if(e=j[d],e>4)h[c++]=65533,b+=e-1;else{for(d&=2===e?31:3===e?15:7;e>1&&b<g;)d=d<<6|63&a[b++],e--;e>1?h[c++]=65533:d<65536?h[c++]=d:(d-=65536,h[c++]=55296|d>>10&1023,h[c++]=56320|1023&d)}return h.length!==c&&(h.subarray?h=h.subarray(0,c):h.length=c),f.applyFromCharCode(h)};c.utf8encode=function(a){return g.nodebuffer?h.newBufferFrom(a,"utf-8"):l(a)},c.utf8decode=function(a){return g.nodebuffer?f.transformTo("nodebuffer",a).toString("utf-8"):(a=f.transformTo(g.uint8array?"uint8array":"array",a),n(a))},f.inherits(d,i),d.prototype.processChunk=function(a){var b=f.transformTo(g.uint8array?"uint8array":"array",a.data);if(this.leftOver&&this.leftOver.length){if(g.uint8array){var d=b;b=new Uint8Array(d.length+this.leftOver.length),b.set(this.leftOver,0),b.set(d,this.leftOver.length)}else b=this.leftOver.concat(b);this.leftOver=null}var e=m(b),h=b;e!==b.length&&(g.uint8array?(h=b.subarray(0,e),this.leftOver=b.subarray(e,b.length)):(h=b.slice(0,e),this.leftOver=b.slice(e,b.length))),this.push({data:c.utf8decode(h),meta:a.meta})},d.prototype.flush=function(){this.leftOver&&this.leftOver.length&&(this.push({data:c.utf8decode(this.leftOver),meta:{}}),this.leftOver=null)},c.Utf8DecodeWorker=d,f.inherits(e,i),e.prototype.processChunk=function(a){this.push({data:c.utf8encode(a.data),meta:a.meta})},c.Utf8EncodeWorker=e},{"./nodejsUtils":14,"./stream/GenericWorker":28,"./support":30,"./utils":32}],32:[function(a,b,c){"use strict";function d(a){var b=null;return b=i.uint8array?new Uint8Array(a.length):new Array(a.length),f(a,b)}function e(a){return a}function f(a,b){for(var c=0;c<a.length;++c)b[c]=255&a.charCodeAt(c);return b}function g(a){var b=65536,d=c.getTypeOf(a),e=!0;if("uint8array"===d?e=n.applyCanBeUsed.uint8array:"nodebuffer"===d&&(e=n.applyCanBeUsed.nodebuffer),e)for(;b>1;)try{return n.stringifyByChunk(a,d,b)}catch(f){b=Math.floor(b/2)}return n.stringifyByChar(a)}function h(a,b){for(var c=0;c<a.length;c++)b[c]=a[c];
+return b}var i=a("./support"),j=a("./base64"),k=a("./nodejsUtils"),l=a("core-js/library/fn/set-immediate"),m=a("./external");c.newBlob=function(a,b){c.checkSupport("blob");try{return new Blob([a],{type:b})}catch(d){try{var e=self.BlobBuilder||self.WebKitBlobBuilder||self.MozBlobBuilder||self.MSBlobBuilder,f=new e;return f.append(a),f.getBlob(b)}catch(d){throw new Error("Bug : can't construct the Blob.")}}};var n={stringifyByChunk:function(a,b,c){var d=[],e=0,f=a.length;if(f<=c)return String.fromCharCode.apply(null,a);for(;e<f;)"array"===b||"nodebuffer"===b?d.push(String.fromCharCode.apply(null,a.slice(e,Math.min(e+c,f)))):d.push(String.fromCharCode.apply(null,a.subarray(e,Math.min(e+c,f)))),e+=c;return d.join("")},stringifyByChar:function(a){for(var b="",c=0;c<a.length;c++)b+=String.fromCharCode(a[c]);return b},applyCanBeUsed:{uint8array:function(){try{return i.uint8array&&1===String.fromCharCode.apply(null,new Uint8Array(1)).length}catch(a){return!1}}(),nodebuffer:function(){try{return i.nodebuffer&&1===String.fromCharCode.apply(null,k.allocBuffer(1)).length}catch(a){return!1}}()}};c.applyFromCharCode=g;var o={};o.string={string:e,array:function(a){return f(a,new Array(a.length))},arraybuffer:function(a){return o.string.uint8array(a).buffer},uint8array:function(a){return f(a,new Uint8Array(a.length))},nodebuffer:function(a){return f(a,k.allocBuffer(a.length))}},o.array={string:g,array:e,arraybuffer:function(a){return new Uint8Array(a).buffer},uint8array:function(a){return new Uint8Array(a)},nodebuffer:function(a){return k.newBufferFrom(a)}},o.arraybuffer={string:function(a){return g(new Uint8Array(a))},array:function(a){return h(new Uint8Array(a),new Array(a.byteLength))},arraybuffer:e,uint8array:function(a){return new Uint8Array(a)},nodebuffer:function(a){return k.newBufferFrom(new Uint8Array(a))}},o.uint8array={string:g,array:function(a){return h(a,new Array(a.length))},arraybuffer:function(a){return a.buffer},uint8array:e,nodebuffer:function(a){return k.newBufferFrom(a)}},o.nodebuffer={string:g,array:function(a){return h(a,new Array(a.length))},arraybuffer:function(a){return o.nodebuffer.uint8array(a).buffer},uint8array:function(a){return h(a,new Uint8Array(a.length))},nodebuffer:e},c.transformTo=function(a,b){if(b||(b=""),!a)return b;c.checkSupport(a);var d=c.getTypeOf(b),e=o[d][a](b);return e},c.getTypeOf=function(a){return"string"==typeof a?"string":"[object Array]"===Object.prototype.toString.call(a)?"array":i.nodebuffer&&k.isBuffer(a)?"nodebuffer":i.uint8array&&a instanceof Uint8Array?"uint8array":i.arraybuffer&&a instanceof ArrayBuffer?"arraybuffer":void 0},c.checkSupport=function(a){var b=i[a.toLowerCase()];if(!b)throw new Error(a+" is not supported by this platform")},c.MAX_VALUE_16BITS=65535,c.MAX_VALUE_32BITS=-1,c.pretty=function(a){var b,c,d="";for(c=0;c<(a||"").length;c++)b=a.charCodeAt(c),d+="\\x"+(b<16?"0":"")+b.toString(16).toUpperCase();return d},c.delay=function(a,b,c){l(function(){a.apply(c||null,b||[])})},c.inherits=function(a,b){var c=function(){};c.prototype=b.prototype,a.prototype=new c},c.extend=function(){var a,b,c={};for(a=0;a<arguments.length;a++)for(b in arguments[a])arguments[a].hasOwnProperty(b)&&"undefined"==typeof c[b]&&(c[b]=arguments[a][b]);return c},c.prepareContent=function(a,b,e,f,g){var h=m.Promise.resolve(b).then(function(a){var b=i.blob&&(a instanceof Blob||["[object File]","[object Blob]"].indexOf(Object.prototype.toString.call(a))!==-1);return b&&"undefined"!=typeof FileReader?new m.Promise(function(b,c){var d=new FileReader;d.onload=function(a){b(a.target.result)},d.onerror=function(a){c(a.target.error)},d.readAsArrayBuffer(a)}):a});return h.then(function(b){var h=c.getTypeOf(b);return h?("arraybuffer"===h?b=c.transformTo("uint8array",b):"string"===h&&(g?b=j.decode(b):e&&f!==!0&&(b=d(b))),b):m.Promise.reject(new Error("Can't read the data of '"+a+"'. Is it in a supported JavaScript type (String, Blob, ArrayBuffer, etc) ?"))})}},{"./base64":1,"./external":6,"./nodejsUtils":14,"./support":30,"core-js/library/fn/set-immediate":36}],33:[function(a,b,c){"use strict";function d(a){this.files=[],this.loadOptions=a}var e=a("./reader/readerFor"),f=a("./utils"),g=a("./signature"),h=a("./zipEntry"),i=(a("./utf8"),a("./support"));d.prototype={checkSignature:function(a){if(!this.reader.readAndCheckSignature(a)){this.reader.index-=4;var b=this.reader.readString(4);throw new Error("Corrupted zip or bug: unexpected signature ("+f.pretty(b)+", expected "+f.pretty(a)+")")}},isSignature:function(a,b){var c=this.reader.index;this.reader.setIndex(a);var d=this.reader.readString(4),e=d===b;return this.reader.setIndex(c),e},readBlockEndOfCentral:function(){this.diskNumber=this.reader.readInt(2),this.diskWithCentralDirStart=this.reader.readInt(2),this.centralDirRecordsOnThisDisk=this.reader.readInt(2),this.centralDirRecords=this.reader.readInt(2),this.centralDirSize=this.reader.readInt(4),this.centralDirOffset=this.reader.readInt(4),this.zipCommentLength=this.reader.readInt(2);var a=this.reader.readData(this.zipCommentLength),b=i.uint8array?"uint8array":"array",c=f.transformTo(b,a);this.zipComment=this.loadOptions.decodeFileName(c)},readBlockZip64EndOfCentral:function(){this.zip64EndOfCentralSize=this.reader.readInt(8),this.reader.skip(4),this.diskNumber=this.reader.readInt(4),this.diskWithCentralDirStart=this.reader.readInt(4),this.centralDirRecordsOnThisDisk=this.reader.readInt(8),this.centralDirRecords=this.reader.readInt(8),this.centralDirSize=this.reader.readInt(8),this.centralDirOffset=this.reader.readInt(8),this.zip64ExtensibleData={};for(var a,b,c,d=this.zip64EndOfCentralSize-44,e=0;e<d;)a=this.reader.readInt(2),b=this.reader.readInt(4),c=this.reader.readData(b),this.zip64ExtensibleData[a]={id:a,length:b,value:c}},readBlockZip64EndOfCentralLocator:function(){if(this.diskWithZip64CentralDirStart=this.reader.readInt(4),this.relativeOffsetEndOfZip64CentralDir=this.reader.readInt(8),this.disksCount=this.reader.readInt(4),this.disksCount>1)throw new Error("Multi-volumes zip are not supported")},readLocalFiles:function(){var a,b;for(a=0;a<this.files.length;a++)b=this.files[a],this.reader.setIndex(b.localHeaderOffset),this.checkSignature(g.LOCAL_FILE_HEADER),b.readLocalPart(this.reader),b.handleUTF8(),b.processAttributes()},readCentralDir:function(){var a;for(this.reader.setIndex(this.centralDirOffset);this.reader.readAndCheckSignature(g.CENTRAL_FILE_HEADER);)a=new h({zip64:this.zip64},this.loadOptions),a.readCentralPart(this.reader),this.files.push(a);if(this.centralDirRecords!==this.files.length&&0!==this.centralDirRecords&&0===this.files.length)throw new Error("Corrupted zip or bug: expected "+this.centralDirRecords+" records in central dir, got "+this.files.length)},readEndOfCentral:function(){var a=this.reader.lastIndexOfSignature(g.CENTRAL_DIRECTORY_END);if(a<0){var b=!this.isSignature(0,g.LOCAL_FILE_HEADER);throw b?new Error("Can't find end of central directory : is this a zip file ? If it is, see https://stuk.github.io/jszip/documentation/howto/read_zip.html"):new Error("Corrupted zip: can't find end of central directory")}this.reader.setIndex(a);var c=a;if(this.checkSignature(g.CENTRAL_DIRECTORY_END),this.readBlockEndOfCentral(),this.diskNumber===f.MAX_VALUE_16BITS||this.diskWithCentralDirStart===f.MAX_VALUE_16BITS||this.centralDirRecordsOnThisDisk===f.MAX_VALUE_16BITS||this.centralDirRecords===f.MAX_VALUE_16BITS||this.centralDirSize===f.MAX_VALUE_32BITS||this.centralDirOffset===f.MAX_VALUE_32BITS){if(this.zip64=!0,a=this.reader.lastIndexOfSignature(g.ZIP64_CENTRAL_DIRECTORY_LOCATOR),a<0)throw new Error("Corrupted zip: can't find the ZIP64 end of central directory locator");if(this.reader.setIndex(a),this.checkSignature(g.ZIP64_CENTRAL_DIRECTORY_LOCATOR),this.readBlockZip64EndOfCentralLocator(),!this.isSignature(this.relativeOffsetEndOfZip64CentralDir,g.ZIP64_CENTRAL_DIRECTORY_END)&&(this.relativeOffsetEndOfZip64CentralDir=this.reader.lastIndexOfSignature(g.ZIP64_CENTRAL_DIRECTORY_END),this.relativeOffsetEndOfZip64CentralDir<0))throw new Error("Corrupted zip: can't find the ZIP64 end of central directory");this.reader.setIndex(this.relativeOffsetEndOfZip64CentralDir),this.checkSignature(g.ZIP64_CENTRAL_DIRECTORY_END),this.readBlockZip64EndOfCentral()}var d=this.centralDirOffset+this.centralDirSize;this.zip64&&(d+=20,d+=12+this.zip64EndOfCentralSize);var e=c-d;if(e>0)this.isSignature(c,g.CENTRAL_FILE_HEADER)||(this.reader.zero=e);else if(e<0)throw new Error("Corrupted zip: missing "+Math.abs(e)+" bytes.")},prepareReader:function(a){this.reader=e(a)},load:function(a){this.prepareReader(a),this.readEndOfCentral(),this.readCentralDir(),this.readLocalFiles()}},b.exports=d},{"./reader/readerFor":22,"./signature":23,"./support":30,"./utf8":31,"./utils":32,"./zipEntry":34}],34:[function(a,b,c){"use strict";function d(a,b){this.options=a,this.loadOptions=b}var e=a("./reader/readerFor"),f=a("./utils"),g=a("./compressedObject"),h=a("./crc32"),i=a("./utf8"),j=a("./compressions"),k=a("./support"),l=0,m=3,n=function(a){for(var b in j)if(j.hasOwnProperty(b)&&j[b].magic===a)return j[b];return null};d.prototype={isEncrypted:function(){return 1===(1&this.bitFlag)},useUTF8:function(){return 2048===(2048&this.bitFlag)},readLocalPart:function(a){var b,c;if(a.skip(22),this.fileNameLength=a.readInt(2),c=a.readInt(2),this.fileName=a.readData(this.fileNameLength),a.skip(c),this.compressedSize===-1||this.uncompressedSize===-1)throw new Error("Bug or corrupted zip : didn't get enough informations from the central directory (compressedSize === -1 || uncompressedSize === -1)");if(b=n(this.compressionMethod),null===b)throw new Error("Corrupted zip : compression "+f.pretty(this.compressionMethod)+" unknown (inner file : "+f.transformTo("string",this.fileName)+")");this.decompressed=new g(this.compressedSize,this.uncompressedSize,this.crc32,b,a.readData(this.compressedSize))},readCentralPart:function(a){this.versionMadeBy=a.readInt(2),a.skip(2),this.bitFlag=a.readInt(2),this.compressionMethod=a.readString(2),this.date=a.readDate(),this.crc32=a.readInt(4),this.compressedSize=a.readInt(4),this.uncompressedSize=a.readInt(4);var b=a.readInt(2);if(this.extraFieldsLength=a.readInt(2),this.fileCommentLength=a.readInt(2),this.diskNumberStart=a.readInt(2),this.internalFileAttributes=a.readInt(2),this.externalFileAttributes=a.readInt(4),this.localHeaderOffset=a.readInt(4),this.isEncrypted())throw new Error("Encrypted zip are not supported");a.skip(b),this.readExtraFields(a),this.parseZIP64ExtraField(a),this.fileComment=a.readData(this.fileCommentLength)},processAttributes:function(){this.unixPermissions=null,this.dosPermissions=null;var a=this.versionMadeBy>>8;this.dir=!!(16&this.externalFileAttributes),a===l&&(this.dosPermissions=63&this.externalFileAttributes),a===m&&(this.unixPermissions=this.externalFileAttributes>>16&65535),this.dir||"/"!==this.fileNameStr.slice(-1)||(this.dir=!0)},parseZIP64ExtraField:function(a){if(this.extraFields[1]){var b=e(this.extraFields[1].value);this.uncompressedSize===f.MAX_VALUE_32BITS&&(this.uncompressedSize=b.readInt(8)),this.compressedSize===f.MAX_VALUE_32BITS&&(this.compressedSize=b.readInt(8)),this.localHeaderOffset===f.MAX_VALUE_32BITS&&(this.localHeaderOffset=b.readInt(8)),this.diskNumberStart===f.MAX_VALUE_32BITS&&(this.diskNumberStart=b.readInt(4))}},readExtraFields:function(a){var b,c,d,e=a.index+this.extraFieldsLength;for(this.extraFields||(this.extraFields={});a.index<e;)b=a.readInt(2),c=a.readInt(2),d=a.readData(c),this.extraFields[b]={id:b,length:c,value:d}},handleUTF8:function(){var a=k.uint8array?"uint8array":"array";if(this.useUTF8())this.fileNameStr=i.utf8decode(this.fileName),this.fileCommentStr=i.utf8decode(this.fileComment);else{var b=this.findExtraFieldUnicodePath();if(null!==b)this.fileNameStr=b;else{var c=f.transformTo(a,this.fileName);this.fileNameStr=this.loadOptions.decodeFileName(c)}var d=this.findExtraFieldUnicodeComment();if(null!==d)this.fileCommentStr=d;else{var e=f.transformTo(a,this.fileComment);this.fileCommentStr=this.loadOptions.decodeFileName(e)}}},findExtraFieldUnicodePath:function(){var a=this.extraFields[28789];if(a){var b=e(a.value);return 1!==b.readInt(1)?null:h(this.fileName)!==b.readInt(4)?null:i.utf8decode(b.readData(a.length-5))}return null},findExtraFieldUnicodeComment:function(){var a=this.extraFields[25461];if(a){var b=e(a.value);return 1!==b.readInt(1)?null:h(this.fileComment)!==b.readInt(4)?null:i.utf8decode(b.readData(a.length-5))}return null}},b.exports=d},{"./compressedObject":2,"./compressions":3,"./crc32":4,"./reader/readerFor":22,"./support":30,"./utf8":31,"./utils":32}],35:[function(a,b,c){"use strict";var d=a("./stream/StreamHelper"),e=a("./stream/DataWorker"),f=a("./utf8"),g=a("./compressedObject"),h=a("./stream/GenericWorker"),i=function(a,b,c){this.name=a,this.dir=c.dir,this.date=c.date,this.comment=c.comment,this.unixPermissions=c.unixPermissions,this.dosPermissions=c.dosPermissions,this._data=b,this._dataBinary=c.binary,this.options={compression:c.compression,compressionOptions:c.compressionOptions}};i.prototype={internalStream:function(a){var b=null,c="string";try{if(!a)throw new Error("No output type specified.");c=a.toLowerCase();var e="string"===c||"text"===c;"binarystring"!==c&&"text"!==c||(c="string"),b=this._decompressWorker();var g=!this._dataBinary;g&&!e&&(b=b.pipe(new f.Utf8EncodeWorker)),!g&&e&&(b=b.pipe(new f.Utf8DecodeWorker))}catch(i){b=new h("error"),b.error(i)}return new d(b,c,"")},async:function(a,b){return this.internalStream(a).accumulate(b)},nodeStream:function(a,b){return this.internalStream(a||"nodebuffer").toNodejsStream(b)},_compressWorker:function(a,b){if(this._data instanceof g&&this._data.compression.magic===a.magic)return this._data.getCompressedWorker();var c=this._decompressWorker();return this._dataBinary||(c=c.pipe(new f.Utf8EncodeWorker)),g.createWorkerFrom(c,a,b)},_decompressWorker:function(){return this._data instanceof g?this._data.getContentWorker():this._data instanceof h?this._data:new e(this._data)}};for(var j=["asText","asBinary","asNodeBuffer","asUint8Array","asArrayBuffer"],k=function(){throw new Error("This method has been removed in JSZip 3.0, please check the upgrade guide.")},l=0;l<j.length;l++)i.prototype[j[l]]=k;b.exports=i},{"./compressedObject":2,"./stream/DataWorker":27,"./stream/GenericWorker":28,"./stream/StreamHelper":29,"./utf8":31}],36:[function(a,b,c){a("../modules/web.immediate"),b.exports=a("../modules/_core").setImmediate},{"../modules/_core":40,"../modules/web.immediate":56}],37:[function(a,b,c){b.exports=function(a){if("function"!=typeof a)throw TypeError(a+" is not a function!");return a}},{}],38:[function(a,b,c){var d=a("./_is-object");b.exports=function(a){if(!d(a))throw TypeError(a+" is not an object!");return a}},{"./_is-object":51}],39:[function(a,b,c){var d={}.toString;b.exports=function(a){return d.call(a).slice(8,-1)}},{}],40:[function(a,b,c){var d=b.exports={version:"2.3.0"};"number"==typeof __e&&(__e=d)},{}],41:[function(a,b,c){var d=a("./_a-function");b.exports=function(a,b,c){if(d(a),void 0===b)return a;switch(c){case 1:return function(c){return a.call(b,c)};case 2:return function(c,d){return a.call(b,c,d)};case 3:return function(c,d,e){return a.call(b,c,d,e)}}return function(){return a.apply(b,arguments)}}},{"./_a-function":37}],42:[function(a,b,c){b.exports=!a("./_fails")(function(){return 7!=Object.defineProperty({},"a",{get:function(){return 7}}).a})},{"./_fails":45}],43:[function(a,b,c){var d=a("./_is-object"),e=a("./_global").document,f=d(e)&&d(e.createElement);b.exports=function(a){return f?e.createElement(a):{}}},{"./_global":46,"./_is-object":51}],44:[function(a,b,c){var d=a("./_global"),e=a("./_core"),f=a("./_ctx"),g=a("./_hide"),h="prototype",i=function(a,b,c){var j,k,l,m=a&i.F,n=a&i.G,o=a&i.S,p=a&i.P,q=a&i.B,r=a&i.W,s=n?e:e[b]||(e[b]={}),t=s[h],u=n?d:o?d[b]:(d[b]||{})[h];n&&(c=b);for(j in c)k=!m&&u&&void 0!==u[j],k&&j in s||(l=k?u[j]:c[j],s[j]=n&&"function"!=typeof u[j]?c[j]:q&&k?f(l,d):r&&u[j]==l?function(a){var b=function(b,c,d){if(this instanceof a){switch(arguments.length){case 0:return new a;case 1:return new a(b);case 2:return new a(b,c)}return new a(b,c,d)}return a.apply(this,arguments)};return b[h]=a[h],b}(l):p&&"function"==typeof l?f(Function.call,l):l,p&&((s.virtual||(s.virtual={}))[j]=l,a&i.R&&t&&!t[j]&&g(t,j,l)))};i.F=1,i.G=2,i.S=4,i.P=8,i.B=16,i.W=32,i.U=64,i.R=128,b.exports=i},{"./_core":40,"./_ctx":41,"./_global":46,"./_hide":47}],45:[function(a,b,c){b.exports=function(a){try{return!!a()}catch(b){return!0}}},{}],46:[function(a,b,c){var d=b.exports="undefined"!=typeof window&&window.Math==Math?window:"undefined"!=typeof self&&self.Math==Math?self:Function("return this")();"number"==typeof __g&&(__g=d)},{}],47:[function(a,b,c){var d=a("./_object-dp"),e=a("./_property-desc");b.exports=a("./_descriptors")?function(a,b,c){return d.f(a,b,e(1,c))}:function(a,b,c){return a[b]=c,a}},{"./_descriptors":42,"./_object-dp":52,"./_property-desc":53}],48:[function(a,b,c){b.exports=a("./_global").document&&document.documentElement},{"./_global":46}],49:[function(a,b,c){b.exports=!a("./_descriptors")&&!a("./_fails")(function(){return 7!=Object.defineProperty(a("./_dom-create")("div"),"a",{get:function(){return 7}}).a})},{"./_descriptors":42,"./_dom-create":43,"./_fails":45}],50:[function(a,b,c){b.exports=function(a,b,c){var d=void 0===c;switch(b.length){case 0:return d?a():a.call(c);case 1:return d?a(b[0]):a.call(c,b[0]);case 2:return d?a(b[0],b[1]):a.call(c,b[0],b[1]);case 3:return d?a(b[0],b[1],b[2]):a.call(c,b[0],b[1],b[2]);case 4:return d?a(b[0],b[1],b[2],b[3]):a.call(c,b[0],b[1],b[2],b[3])}return a.apply(c,b)}},{}],51:[function(a,b,c){b.exports=function(a){return"object"==typeof a?null!==a:"function"==typeof a}},{}],52:[function(a,b,c){var d=a("./_an-object"),e=a("./_ie8-dom-define"),f=a("./_to-primitive"),g=Object.defineProperty;c.f=a("./_descriptors")?Object.defineProperty:function(a,b,c){if(d(a),b=f(b,!0),d(c),e)try{return g(a,b,c)}catch(h){}if("get"in c||"set"in c)throw TypeError("Accessors not supported!");return"value"in c&&(a[b]=c.value),a}},{"./_an-object":38,"./_descriptors":42,"./_ie8-dom-define":49,"./_to-primitive":55}],53:[function(a,b,c){b.exports=function(a,b){return{enumerable:!(1&a),configurable:!(2&a),writable:!(4&a),value:b}}},{}],54:[function(a,b,c){var d,e,f,g=a("./_ctx"),h=a("./_invoke"),i=a("./_html"),j=a("./_dom-create"),k=a("./_global"),l=k.process,m=k.setImmediate,n=k.clearImmediate,o=k.MessageChannel,p=0,q={},r="onreadystatechange",s=function(){var a=+this;if(q.hasOwnProperty(a)){var b=q[a];delete q[a],b()}},t=function(a){s.call(a.data)};m&&n||(m=function(a){for(var b=[],c=1;arguments.length>c;)b.push(arguments[c++]);return q[++p]=function(){h("function"==typeof a?a:Function(a),b)},d(p),p},n=function(a){delete q[a]},"process"==a("./_cof")(l)?d=function(a){l.nextTick(g(s,a,1))}:o?(e=new o,f=e.port2,e.port1.onmessage=t,d=g(f.postMessage,f,1)):k.addEventListener&&"function"==typeof postMessage&&!k.importScripts?(d=function(a){k.postMessage(a+"","*")},k.addEventListener("message",t,!1)):d=r in j("script")?function(a){i.appendChild(j("script"))[r]=function(){i.removeChild(this),s.call(a)}}:function(a){setTimeout(g(s,a,1),0)}),b.exports={set:m,clear:n}},{"./_cof":39,"./_ctx":41,"./_dom-create":43,"./_global":46,"./_html":48,"./_invoke":50}],55:[function(a,b,c){var d=a("./_is-object");b.exports=function(a,b){if(!d(a))return a;var c,e;if(b&&"function"==typeof(c=a.toString)&&!d(e=c.call(a)))return e;if("function"==typeof(c=a.valueOf)&&!d(e=c.call(a)))return e;if(!b&&"function"==typeof(c=a.toString)&&!d(e=c.call(a)))return e;throw TypeError("Can't convert object to primitive value")}},{"./_is-object":51}],56:[function(a,b,c){var d=a("./_export"),e=a("./_task");d(d.G+d.B,{setImmediate:e.set,clearImmediate:e.clear})},{"./_export":44,"./_task":54}],57:[function(a,b,c){(function(a){"use strict";function c(){k=!0;for(var a,b,c=l.length;c;){for(b=l,l=[],a=-1;++a<c;)b[a]();c=l.length}k=!1}function d(a){1!==l.push(a)||k||e()}var e,f=a.MutationObserver||a.WebKitMutationObserver;if(f){var g=0,h=new f(c),i=a.document.createTextNode("");h.observe(i,{characterData:!0}),e=function(){i.data=g=++g%2}}else if(a.setImmediate||"undefined"==typeof a.MessageChannel)e="document"in a&&"onreadystatechange"in a.document.createElement("script")?function(){var b=a.document.createElement("script");b.onreadystatechange=function(){c(),b.onreadystatechange=null,b.parentNode.removeChild(b),b=null},a.document.documentElement.appendChild(b)}:function(){setTimeout(c,0)};else{var j=new a.MessageChannel;j.port1.onmessage=c,e=function(){j.port2.postMessage(0)}}var k,l=[];b.exports=d}).call(this,"undefined"!=typeof global?global:"undefined"!=typeof self?self:"undefined"!=typeof window?window:{})},{}],58:[function(a,b,c){"use strict";function d(){}function e(a){if("function"!=typeof a)throw new TypeError("resolver must be a function");this.state=s,this.queue=[],this.outcome=void 0,a!==d&&i(this,a)}function f(a,b,c){this.promise=a,"function"==typeof b&&(this.onFulfilled=b,this.callFulfilled=this.otherCallFulfilled),"function"==typeof c&&(this.onRejected=c,this.callRejected=this.otherCallRejected)}function g(a,b,c){o(function(){var d;try{d=b(c)}catch(e){return p.reject(a,e)}d===a?p.reject(a,new TypeError("Cannot resolve promise with itself")):p.resolve(a,d)})}function h(a){var b=a&&a.then;if(a&&("object"==typeof a||"function"==typeof a)&&"function"==typeof b)return function(){b.apply(a,arguments)}}function i(a,b){function c(b){f||(f=!0,p.reject(a,b))}function d(b){f||(f=!0,p.resolve(a,b))}function e(){b(d,c)}var f=!1,g=j(e);"error"===g.status&&c(g.value)}function j(a,b){var c={};try{c.value=a(b),c.status="success"}catch(d){c.status="error",c.value=d}return c}function k(a){return a instanceof this?a:p.resolve(new this(d),a)}function l(a){var b=new this(d);return p.reject(b,a)}function m(a){function b(a,b){function d(a){g[b]=a,++h!==e||f||(f=!0,p.resolve(j,g))}c.resolve(a).then(d,function(a){f||(f=!0,p.reject(j,a))})}var c=this;if("[object Array]"!==Object.prototype.toString.call(a))return this.reject(new TypeError("must be an array"));var e=a.length,f=!1;if(!e)return this.resolve([]);for(var g=new Array(e),h=0,i=-1,j=new this(d);++i<e;)b(a[i],i);return j}function n(a){function b(a){c.resolve(a).then(function(a){f||(f=!0,p.resolve(h,a))},function(a){f||(f=!0,p.reject(h,a))})}var c=this;if("[object Array]"!==Object.prototype.toString.call(a))return this.reject(new TypeError("must be an array"));var e=a.length,f=!1;if(!e)return this.resolve([]);for(var g=-1,h=new this(d);++g<e;)b(a[g]);return h}var o=a("immediate"),p={},q=["REJECTED"],r=["FULFILLED"],s=["PENDING"];b.exports=e,e.prototype["catch"]=function(a){return this.then(null,a)},e.prototype.then=function(a,b){if("function"!=typeof a&&this.state===r||"function"!=typeof b&&this.state===q)return this;var c=new this.constructor(d);if(this.state!==s){var e=this.state===r?a:b;g(c,e,this.outcome)}else this.queue.push(new f(c,a,b));return c},f.prototype.callFulfilled=function(a){p.resolve(this.promise,a)},f.prototype.otherCallFulfilled=function(a){g(this.promise,this.onFulfilled,a)},f.prototype.callRejected=function(a){p.reject(this.promise,a)},f.prototype.otherCallRejected=function(a){g(this.promise,this.onRejected,a)},p.resolve=function(a,b){var c=j(h,b);if("error"===c.status)return p.reject(a,c.value);var d=c.value;if(d)i(a,d);else{a.state=r,a.outcome=b;for(var e=-1,f=a.queue.length;++e<f;)a.queue[e].callFulfilled(b)}return a},p.reject=function(a,b){a.state=q,a.outcome=b;for(var c=-1,d=a.queue.length;++c<d;)a.queue[c].callRejected(b);return a},e.resolve=k,e.reject=l,e.all=m,e.race=n},{immediate:57}],59:[function(a,b,c){"use strict";var d=a("./lib/utils/common").assign,e=a("./lib/deflate"),f=a("./lib/inflate"),g=a("./lib/zlib/constants"),h={};d(h,e,f,g),b.exports=h},{"./lib/deflate":60,"./lib/inflate":61,"./lib/utils/common":62,"./lib/zlib/constants":65}],60:[function(a,b,c){"use strict";function d(a){if(!(this instanceof d))return new d(a);this.options=i.assign({level:s,method:u,chunkSize:16384,windowBits:15,memLevel:8,strategy:t,to:""},a||{});var b=this.options;b.raw&&b.windowBits>0?b.windowBits=-b.windowBits:b.gzip&&b.windowBits>0&&b.windowBits<16&&(b.windowBits+=16),this.err=0,this.msg="",this.ended=!1,this.chunks=[],this.strm=new l,this.strm.avail_out=0;var c=h.deflateInit2(this.strm,b.level,b.method,b.windowBits,b.memLevel,b.strategy);if(c!==p)throw new Error(k[c]);if(b.header&&h.deflateSetHeader(this.strm,b.header),b.dictionary){var e;if(e="string"==typeof b.dictionary?j.string2buf(b.dictionary):"[object ArrayBuffer]"===m.call(b.dictionary)?new Uint8Array(b.dictionary):b.dictionary,c=h.deflateSetDictionary(this.strm,e),c!==p)throw new Error(k[c]);this._dict_set=!0}}function e(a,b){var c=new d(b);if(c.push(a,!0),c.err)throw c.msg||k[c.err];return c.result}function f(a,b){return b=b||{},b.raw=!0,e(a,b)}function g(a,b){return b=b||{},b.gzip=!0,e(a,b)}var h=a("./zlib/deflate"),i=a("./utils/common"),j=a("./utils/strings"),k=a("./zlib/messages"),l=a("./zlib/zstream"),m=Object.prototype.toString,n=0,o=4,p=0,q=1,r=2,s=-1,t=0,u=8;d.prototype.push=function(a,b){var c,d,e=this.strm,f=this.options.chunkSize;if(this.ended)return!1;d=b===~~b?b:b===!0?o:n,"string"==typeof a?e.input=j.string2buf(a):"[object ArrayBuffer]"===m.call(a)?e.input=new Uint8Array(a):e.input=a,e.next_in=0,e.avail_in=e.input.length;do{if(0===e.avail_out&&(e.output=new i.Buf8(f),e.next_out=0,e.avail_out=f),c=h.deflate(e,d),c!==q&&c!==p)return this.onEnd(c),this.ended=!0,!1;0!==e.avail_out&&(0!==e.avail_in||d!==o&&d!==r)||("string"===this.options.to?this.onData(j.buf2binstring(i.shrinkBuf(e.output,e.next_out))):this.onData(i.shrinkBuf(e.output,e.next_out)))}while((e.avail_in>0||0===e.avail_out)&&c!==q);return d===o?(c=h.deflateEnd(this.strm),this.onEnd(c),this.ended=!0,c===p):d!==r||(this.onEnd(p),e.avail_out=0,!0)},d.prototype.onData=function(a){this.chunks.push(a)},d.prototype.onEnd=function(a){a===p&&("string"===this.options.to?this.result=this.chunks.join(""):this.result=i.flattenChunks(this.chunks)),this.chunks=[],this.err=a,this.msg=this.strm.msg},c.Deflate=d,c.deflate=e,c.deflateRaw=f,c.gzip=g},{"./utils/common":62,"./utils/strings":63,"./zlib/deflate":67,"./zlib/messages":72,"./zlib/zstream":74}],61:[function(a,b,c){"use strict";function d(a){if(!(this instanceof d))return new d(a);this.options=h.assign({chunkSize:16384,windowBits:0,to:""},a||{});var b=this.options;b.raw&&b.windowBits>=0&&b.windowBits<16&&(b.windowBits=-b.windowBits,0===b.windowBits&&(b.windowBits=-15)),!(b.windowBits>=0&&b.windowBits<16)||a&&a.windowBits||(b.windowBits+=32),b.windowBits>15&&b.windowBits<48&&0===(15&b.windowBits)&&(b.windowBits|=15),this.err=0,this.msg="",this.ended=!1,this.chunks=[],this.strm=new l,this.strm.avail_out=0;var c=g.inflateInit2(this.strm,b.windowBits);if(c!==j.Z_OK)throw new Error(k[c]);this.header=new m,g.inflateGetHeader(this.strm,this.header)}function e(a,b){var c=new d(b);if(c.push(a,!0),c.err)throw c.msg||k[c.err];return c.result}function f(a,b){return b=b||{},b.raw=!0,e(a,b)}var g=a("./zlib/inflate"),h=a("./utils/common"),i=a("./utils/strings"),j=a("./zlib/constants"),k=a("./zlib/messages"),l=a("./zlib/zstream"),m=a("./zlib/gzheader"),n=Object.prototype.toString;d.prototype.push=function(a,b){var c,d,e,f,k,l,m=this.strm,o=this.options.chunkSize,p=this.options.dictionary,q=!1;if(this.ended)return!1;d=b===~~b?b:b===!0?j.Z_FINISH:j.Z_NO_FLUSH,"string"==typeof a?m.input=i.binstring2buf(a):"[object ArrayBuffer]"===n.call(a)?m.input=new Uint8Array(a):m.input=a,m.next_in=0,m.avail_in=m.input.length;do{if(0===m.avail_out&&(m.output=new h.Buf8(o),m.next_out=0,m.avail_out=o),c=g.inflate(m,j.Z_NO_FLUSH),c===j.Z_NEED_DICT&&p&&(l="string"==typeof p?i.string2buf(p):"[object ArrayBuffer]"===n.call(p)?new Uint8Array(p):p,c=g.inflateSetDictionary(this.strm,l)),c===j.Z_BUF_ERROR&&q===!0&&(c=j.Z_OK,q=!1),c!==j.Z_STREAM_END&&c!==j.Z_OK)return this.onEnd(c),this.ended=!0,!1;m.next_out&&(0!==m.avail_out&&c!==j.Z_STREAM_END&&(0!==m.avail_in||d!==j.Z_FINISH&&d!==j.Z_SYNC_FLUSH)||("string"===this.options.to?(e=i.utf8border(m.output,m.next_out),f=m.next_out-e,k=i.buf2string(m.output,e),m.next_out=f,m.avail_out=o-f,f&&h.arraySet(m.output,m.output,e,f,0),this.onData(k)):this.onData(h.shrinkBuf(m.output,m.next_out)))),0===m.avail_in&&0===m.avail_out&&(q=!0)}while((m.avail_in>0||0===m.avail_out)&&c!==j.Z_STREAM_END);return c===j.Z_STREAM_END&&(d=j.Z_FINISH),d===j.Z_FINISH?(c=g.inflateEnd(this.strm),this.onEnd(c),this.ended=!0,c===j.Z_OK):d!==j.Z_SYNC_FLUSH||(this.onEnd(j.Z_OK),m.avail_out=0,!0)},d.prototype.onData=function(a){this.chunks.push(a)},d.prototype.onEnd=function(a){a===j.Z_OK&&("string"===this.options.to?this.result=this.chunks.join(""):this.result=h.flattenChunks(this.chunks)),this.chunks=[],this.err=a,this.msg=this.strm.msg},c.Inflate=d,c.inflate=e,c.inflateRaw=f,c.ungzip=e},{"./utils/common":62,"./utils/strings":63,"./zlib/constants":65,"./zlib/gzheader":68,"./zlib/inflate":70,"./zlib/messages":72,"./zlib/zstream":74}],62:[function(a,b,c){"use strict";var d="undefined"!=typeof Uint8Array&&"undefined"!=typeof Uint16Array&&"undefined"!=typeof Int32Array;c.assign=function(a){for(var b=Array.prototype.slice.call(arguments,1);b.length;){var c=b.shift();if(c){if("object"!=typeof c)throw new TypeError(c+"must be non-object");for(var d in c)c.hasOwnProperty(d)&&(a[d]=c[d])}}return a},c.shrinkBuf=function(a,b){return a.length===b?a:a.subarray?a.subarray(0,b):(a.length=b,a)};var e={arraySet:function(a,b,c,d,e){if(b.subarray&&a.subarray)return void a.set(b.subarray(c,c+d),e);for(var f=0;f<d;f++)a[e+f]=b[c+f]},flattenChunks:function(a){var b,c,d,e,f,g;for(d=0,b=0,c=a.length;b<c;b++)d+=a[b].length;for(g=new Uint8Array(d),e=0,b=0,c=a.length;b<c;b++)f=a[b],g.set(f,e),e+=f.length;return g}},f={arraySet:function(a,b,c,d,e){for(var f=0;f<d;f++)a[e+f]=b[c+f]},flattenChunks:function(a){return[].concat.apply([],a)}};c.setTyped=function(a){a?(c.Buf8=Uint8Array,c.Buf16=Uint16Array,c.Buf32=Int32Array,c.assign(c,e)):(c.Buf8=Array,c.Buf16=Array,c.Buf32=Array,c.assign(c,f))},c.setTyped(d)},{}],63:[function(a,b,c){"use strict";function d(a,b){if(b<65537&&(a.subarray&&g||!a.subarray&&f))return String.fromCharCode.apply(null,e.shrinkBuf(a,b));for(var c="",d=0;d<b;d++)c+=String.fromCharCode(a[d]);return c}var e=a("./common"),f=!0,g=!0;try{String.fromCharCode.apply(null,[0])}catch(h){f=!1}try{String.fromCharCode.apply(null,new Uint8Array(1))}catch(h){g=!1}for(var i=new e.Buf8(256),j=0;j<256;j++)i[j]=j>=252?6:j>=248?5:j>=240?4:j>=224?3:j>=192?2:1;i[254]=i[254]=1,c.string2buf=function(a){var b,c,d,f,g,h=a.length,i=0;for(f=0;f<h;f++)c=a.charCodeAt(f),55296===(64512&c)&&f+1<h&&(d=a.charCodeAt(f+1),56320===(64512&d)&&(c=65536+(c-55296<<10)+(d-56320),f++)),i+=c<128?1:c<2048?2:c<65536?3:4;for(b=new e.Buf8(i),g=0,f=0;g<i;f++)c=a.charCodeAt(f),55296===(64512&c)&&f+1<h&&(d=a.charCodeAt(f+1),56320===(64512&d)&&(c=65536+(c-55296<<10)+(d-56320),f++)),c<128?b[g++]=c:c<2048?(b[g++]=192|c>>>6,b[g++]=128|63&c):c<65536?(b[g++]=224|c>>>12,b[g++]=128|c>>>6&63,b[g++]=128|63&c):(b[g++]=240|c>>>18,b[g++]=128|c>>>12&63,b[g++]=128|c>>>6&63,b[g++]=128|63&c);return b},c.buf2binstring=function(a){return d(a,a.length)},c.binstring2buf=function(a){for(var b=new e.Buf8(a.length),c=0,d=b.length;c<d;c++)b[c]=a.charCodeAt(c);return b},c.buf2string=function(a,b){var c,e,f,g,h=b||a.length,j=new Array(2*h);for(e=0,c=0;c<h;)if(f=a[c++],f<128)j[e++]=f;else if(g=i[f],g>4)j[e++]=65533,c+=g-1;else{for(f&=2===g?31:3===g?15:7;g>1&&c<h;)f=f<<6|63&a[c++],g--;g>1?j[e++]=65533:f<65536?j[e++]=f:(f-=65536,j[e++]=55296|f>>10&1023,j[e++]=56320|1023&f)}return d(j,e)},c.utf8border=function(a,b){var c;for(b=b||a.length,b>a.length&&(b=a.length),c=b-1;c>=0&&128===(192&a[c]);)c--;return c<0?b:0===c?b:c+i[a[c]]>b?c:b}},{"./common":62}],64:[function(a,b,c){"use strict";function d(a,b,c,d){for(var e=65535&a|0,f=a>>>16&65535|0,g=0;0!==c;){g=c>2e3?2e3:c,c-=g;do e=e+b[d++]|0,f=f+e|0;while(--g);e%=65521,f%=65521}return e|f<<16|0;
+}b.exports=d},{}],65:[function(a,b,c){"use strict";b.exports={Z_NO_FLUSH:0,Z_PARTIAL_FLUSH:1,Z_SYNC_FLUSH:2,Z_FULL_FLUSH:3,Z_FINISH:4,Z_BLOCK:5,Z_TREES:6,Z_OK:0,Z_STREAM_END:1,Z_NEED_DICT:2,Z_ERRNO:-1,Z_STREAM_ERROR:-2,Z_DATA_ERROR:-3,Z_BUF_ERROR:-5,Z_NO_COMPRESSION:0,Z_BEST_SPEED:1,Z_BEST_COMPRESSION:9,Z_DEFAULT_COMPRESSION:-1,Z_FILTERED:1,Z_HUFFMAN_ONLY:2,Z_RLE:3,Z_FIXED:4,Z_DEFAULT_STRATEGY:0,Z_BINARY:0,Z_TEXT:1,Z_UNKNOWN:2,Z_DEFLATED:8}},{}],66:[function(a,b,c){"use strict";function d(){for(var a,b=[],c=0;c<256;c++){a=c;for(var d=0;d<8;d++)a=1&a?3988292384^a>>>1:a>>>1;b[c]=a}return b}function e(a,b,c,d){var e=f,g=d+c;a^=-1;for(var h=d;h<g;h++)a=a>>>8^e[255&(a^b[h])];return a^-1}var f=d();b.exports=e},{}],67:[function(a,b,c){"use strict";function d(a,b){return a.msg=I[b],b}function e(a){return(a<<1)-(a>4?9:0)}function f(a){for(var b=a.length;--b>=0;)a[b]=0}function g(a){var b=a.state,c=b.pending;c>a.avail_out&&(c=a.avail_out),0!==c&&(E.arraySet(a.output,b.pending_buf,b.pending_out,c,a.next_out),a.next_out+=c,b.pending_out+=c,a.total_out+=c,a.avail_out-=c,b.pending-=c,0===b.pending&&(b.pending_out=0))}function h(a,b){F._tr_flush_block(a,a.block_start>=0?a.block_start:-1,a.strstart-a.block_start,b),a.block_start=a.strstart,g(a.strm)}function i(a,b){a.pending_buf[a.pending++]=b}function j(a,b){a.pending_buf[a.pending++]=b>>>8&255,a.pending_buf[a.pending++]=255&b}function k(a,b,c,d){var e=a.avail_in;return e>d&&(e=d),0===e?0:(a.avail_in-=e,E.arraySet(b,a.input,a.next_in,e,c),1===a.state.wrap?a.adler=G(a.adler,b,e,c):2===a.state.wrap&&(a.adler=H(a.adler,b,e,c)),a.next_in+=e,a.total_in+=e,e)}function l(a,b){var c,d,e=a.max_chain_length,f=a.strstart,g=a.prev_length,h=a.nice_match,i=a.strstart>a.w_size-la?a.strstart-(a.w_size-la):0,j=a.window,k=a.w_mask,l=a.prev,m=a.strstart+ka,n=j[f+g-1],o=j[f+g];a.prev_length>=a.good_match&&(e>>=2),h>a.lookahead&&(h=a.lookahead);do if(c=b,j[c+g]===o&&j[c+g-1]===n&&j[c]===j[f]&&j[++c]===j[f+1]){f+=2,c++;do;while(j[++f]===j[++c]&&j[++f]===j[++c]&&j[++f]===j[++c]&&j[++f]===j[++c]&&j[++f]===j[++c]&&j[++f]===j[++c]&&j[++f]===j[++c]&&j[++f]===j[++c]&&f<m);if(d=ka-(m-f),f=m-ka,d>g){if(a.match_start=b,g=d,d>=h)break;n=j[f+g-1],o=j[f+g]}}while((b=l[b&k])>i&&0!==--e);return g<=a.lookahead?g:a.lookahead}function m(a){var b,c,d,e,f,g=a.w_size;do{if(e=a.window_size-a.lookahead-a.strstart,a.strstart>=g+(g-la)){E.arraySet(a.window,a.window,g,g,0),a.match_start-=g,a.strstart-=g,a.block_start-=g,c=a.hash_size,b=c;do d=a.head[--b],a.head[b]=d>=g?d-g:0;while(--c);c=g,b=c;do d=a.prev[--b],a.prev[b]=d>=g?d-g:0;while(--c);e+=g}if(0===a.strm.avail_in)break;if(c=k(a.strm,a.window,a.strstart+a.lookahead,e),a.lookahead+=c,a.lookahead+a.insert>=ja)for(f=a.strstart-a.insert,a.ins_h=a.window[f],a.ins_h=(a.ins_h<<a.hash_shift^a.window[f+1])&a.hash_mask;a.insert&&(a.ins_h=(a.ins_h<<a.hash_shift^a.window[f+ja-1])&a.hash_mask,a.prev[f&a.w_mask]=a.head[a.ins_h],a.head[a.ins_h]=f,f++,a.insert--,!(a.lookahead+a.insert<ja)););}while(a.lookahead<la&&0!==a.strm.avail_in)}function n(a,b){var c=65535;for(c>a.pending_buf_size-5&&(c=a.pending_buf_size-5);;){if(a.lookahead<=1){if(m(a),0===a.lookahead&&b===J)return ua;if(0===a.lookahead)break}a.strstart+=a.lookahead,a.lookahead=0;var d=a.block_start+c;if((0===a.strstart||a.strstart>=d)&&(a.lookahead=a.strstart-d,a.strstart=d,h(a,!1),0===a.strm.avail_out))return ua;if(a.strstart-a.block_start>=a.w_size-la&&(h(a,!1),0===a.strm.avail_out))return ua}return a.insert=0,b===M?(h(a,!0),0===a.strm.avail_out?wa:xa):a.strstart>a.block_start&&(h(a,!1),0===a.strm.avail_out)?ua:ua}function o(a,b){for(var c,d;;){if(a.lookahead<la){if(m(a),a.lookahead<la&&b===J)return ua;if(0===a.lookahead)break}if(c=0,a.lookahead>=ja&&(a.ins_h=(a.ins_h<<a.hash_shift^a.window[a.strstart+ja-1])&a.hash_mask,c=a.prev[a.strstart&a.w_mask]=a.head[a.ins_h],a.head[a.ins_h]=a.strstart),0!==c&&a.strstart-c<=a.w_size-la&&(a.match_length=l(a,c)),a.match_length>=ja)if(d=F._tr_tally(a,a.strstart-a.match_start,a.match_length-ja),a.lookahead-=a.match_length,a.match_length<=a.max_lazy_match&&a.lookahead>=ja){a.match_length--;do a.strstart++,a.ins_h=(a.ins_h<<a.hash_shift^a.window[a.strstart+ja-1])&a.hash_mask,c=a.prev[a.strstart&a.w_mask]=a.head[a.ins_h],a.head[a.ins_h]=a.strstart;while(0!==--a.match_length);a.strstart++}else a.strstart+=a.match_length,a.match_length=0,a.ins_h=a.window[a.strstart],a.ins_h=(a.ins_h<<a.hash_shift^a.window[a.strstart+1])&a.hash_mask;else d=F._tr_tally(a,0,a.window[a.strstart]),a.lookahead--,a.strstart++;if(d&&(h(a,!1),0===a.strm.avail_out))return ua}return a.insert=a.strstart<ja-1?a.strstart:ja-1,b===M?(h(a,!0),0===a.strm.avail_out?wa:xa):a.last_lit&&(h(a,!1),0===a.strm.avail_out)?ua:va}function p(a,b){for(var c,d,e;;){if(a.lookahead<la){if(m(a),a.lookahead<la&&b===J)return ua;if(0===a.lookahead)break}if(c=0,a.lookahead>=ja&&(a.ins_h=(a.ins_h<<a.hash_shift^a.window[a.strstart+ja-1])&a.hash_mask,c=a.prev[a.strstart&a.w_mask]=a.head[a.ins_h],a.head[a.ins_h]=a.strstart),a.prev_length=a.match_length,a.prev_match=a.match_start,a.match_length=ja-1,0!==c&&a.prev_length<a.max_lazy_match&&a.strstart-c<=a.w_size-la&&(a.match_length=l(a,c),a.match_length<=5&&(a.strategy===U||a.match_length===ja&&a.strstart-a.match_start>4096)&&(a.match_length=ja-1)),a.prev_length>=ja&&a.match_length<=a.prev_length){e=a.strstart+a.lookahead-ja,d=F._tr_tally(a,a.strstart-1-a.prev_match,a.prev_length-ja),a.lookahead-=a.prev_length-1,a.prev_length-=2;do++a.strstart<=e&&(a.ins_h=(a.ins_h<<a.hash_shift^a.window[a.strstart+ja-1])&a.hash_mask,c=a.prev[a.strstart&a.w_mask]=a.head[a.ins_h],a.head[a.ins_h]=a.strstart);while(0!==--a.prev_length);if(a.match_available=0,a.match_length=ja-1,a.strstart++,d&&(h(a,!1),0===a.strm.avail_out))return ua}else if(a.match_available){if(d=F._tr_tally(a,0,a.window[a.strstart-1]),d&&h(a,!1),a.strstart++,a.lookahead--,0===a.strm.avail_out)return ua}else a.match_available=1,a.strstart++,a.lookahead--}return a.match_available&&(d=F._tr_tally(a,0,a.window[a.strstart-1]),a.match_available=0),a.insert=a.strstart<ja-1?a.strstart:ja-1,b===M?(h(a,!0),0===a.strm.avail_out?wa:xa):a.last_lit&&(h(a,!1),0===a.strm.avail_out)?ua:va}function q(a,b){for(var c,d,e,f,g=a.window;;){if(a.lookahead<=ka){if(m(a),a.lookahead<=ka&&b===J)return ua;if(0===a.lookahead)break}if(a.match_length=0,a.lookahead>=ja&&a.strstart>0&&(e=a.strstart-1,d=g[e],d===g[++e]&&d===g[++e]&&d===g[++e])){f=a.strstart+ka;do;while(d===g[++e]&&d===g[++e]&&d===g[++e]&&d===g[++e]&&d===g[++e]&&d===g[++e]&&d===g[++e]&&d===g[++e]&&e<f);a.match_length=ka-(f-e),a.match_length>a.lookahead&&(a.match_length=a.lookahead)}if(a.match_length>=ja?(c=F._tr_tally(a,1,a.match_length-ja),a.lookahead-=a.match_length,a.strstart+=a.match_length,a.match_length=0):(c=F._tr_tally(a,0,a.window[a.strstart]),a.lookahead--,a.strstart++),c&&(h(a,!1),0===a.strm.avail_out))return ua}return a.insert=0,b===M?(h(a,!0),0===a.strm.avail_out?wa:xa):a.last_lit&&(h(a,!1),0===a.strm.avail_out)?ua:va}function r(a,b){for(var c;;){if(0===a.lookahead&&(m(a),0===a.lookahead)){if(b===J)return ua;break}if(a.match_length=0,c=F._tr_tally(a,0,a.window[a.strstart]),a.lookahead--,a.strstart++,c&&(h(a,!1),0===a.strm.avail_out))return ua}return a.insert=0,b===M?(h(a,!0),0===a.strm.avail_out?wa:xa):a.last_lit&&(h(a,!1),0===a.strm.avail_out)?ua:va}function s(a,b,c,d,e){this.good_length=a,this.max_lazy=b,this.nice_length=c,this.max_chain=d,this.func=e}function t(a){a.window_size=2*a.w_size,f(a.head),a.max_lazy_match=D[a.level].max_lazy,a.good_match=D[a.level].good_length,a.nice_match=D[a.level].nice_length,a.max_chain_length=D[a.level].max_chain,a.strstart=0,a.block_start=0,a.lookahead=0,a.insert=0,a.match_length=a.prev_length=ja-1,a.match_available=0,a.ins_h=0}function u(){this.strm=null,this.status=0,this.pending_buf=null,this.pending_buf_size=0,this.pending_out=0,this.pending=0,this.wrap=0,this.gzhead=null,this.gzindex=0,this.method=$,this.last_flush=-1,this.w_size=0,this.w_bits=0,this.w_mask=0,this.window=null,this.window_size=0,this.prev=null,this.head=null,this.ins_h=0,this.hash_size=0,this.hash_bits=0,this.hash_mask=0,this.hash_shift=0,this.block_start=0,this.match_length=0,this.prev_match=0,this.match_available=0,this.strstart=0,this.match_start=0,this.lookahead=0,this.prev_length=0,this.max_chain_length=0,this.max_lazy_match=0,this.level=0,this.strategy=0,this.good_match=0,this.nice_match=0,this.dyn_ltree=new E.Buf16(2*ha),this.dyn_dtree=new E.Buf16(2*(2*fa+1)),this.bl_tree=new E.Buf16(2*(2*ga+1)),f(this.dyn_ltree),f(this.dyn_dtree),f(this.bl_tree),this.l_desc=null,this.d_desc=null,this.bl_desc=null,this.bl_count=new E.Buf16(ia+1),this.heap=new E.Buf16(2*ea+1),f(this.heap),this.heap_len=0,this.heap_max=0,this.depth=new E.Buf16(2*ea+1),f(this.depth),this.l_buf=0,this.lit_bufsize=0,this.last_lit=0,this.d_buf=0,this.opt_len=0,this.static_len=0,this.matches=0,this.insert=0,this.bi_buf=0,this.bi_valid=0}function v(a){var b;return a&&a.state?(a.total_in=a.total_out=0,a.data_type=Z,b=a.state,b.pending=0,b.pending_out=0,b.wrap<0&&(b.wrap=-b.wrap),b.status=b.wrap?na:sa,a.adler=2===b.wrap?0:1,b.last_flush=J,F._tr_init(b),O):d(a,Q)}function w(a){var b=v(a);return b===O&&t(a.state),b}function x(a,b){return a&&a.state?2!==a.state.wrap?Q:(a.state.gzhead=b,O):Q}function y(a,b,c,e,f,g){if(!a)return Q;var h=1;if(b===T&&(b=6),e<0?(h=0,e=-e):e>15&&(h=2,e-=16),f<1||f>_||c!==$||e<8||e>15||b<0||b>9||g<0||g>X)return d(a,Q);8===e&&(e=9);var i=new u;return a.state=i,i.strm=a,i.wrap=h,i.gzhead=null,i.w_bits=e,i.w_size=1<<i.w_bits,i.w_mask=i.w_size-1,i.hash_bits=f+7,i.hash_size=1<<i.hash_bits,i.hash_mask=i.hash_size-1,i.hash_shift=~~((i.hash_bits+ja-1)/ja),i.window=new E.Buf8(2*i.w_size),i.head=new E.Buf16(i.hash_size),i.prev=new E.Buf16(i.w_size),i.lit_bufsize=1<<f+6,i.pending_buf_size=4*i.lit_bufsize,i.pending_buf=new E.Buf8(i.pending_buf_size),i.d_buf=1*i.lit_bufsize,i.l_buf=3*i.lit_bufsize,i.level=b,i.strategy=g,i.method=c,w(a)}function z(a,b){return y(a,b,$,aa,ba,Y)}function A(a,b){var c,h,k,l;if(!a||!a.state||b>N||b<0)return a?d(a,Q):Q;if(h=a.state,!a.output||!a.input&&0!==a.avail_in||h.status===ta&&b!==M)return d(a,0===a.avail_out?S:Q);if(h.strm=a,c=h.last_flush,h.last_flush=b,h.status===na)if(2===h.wrap)a.adler=0,i(h,31),i(h,139),i(h,8),h.gzhead?(i(h,(h.gzhead.text?1:0)+(h.gzhead.hcrc?2:0)+(h.gzhead.extra?4:0)+(h.gzhead.name?8:0)+(h.gzhead.comment?16:0)),i(h,255&h.gzhead.time),i(h,h.gzhead.time>>8&255),i(h,h.gzhead.time>>16&255),i(h,h.gzhead.time>>24&255),i(h,9===h.level?2:h.strategy>=V||h.level<2?4:0),i(h,255&h.gzhead.os),h.gzhead.extra&&h.gzhead.extra.length&&(i(h,255&h.gzhead.extra.length),i(h,h.gzhead.extra.length>>8&255)),h.gzhead.hcrc&&(a.adler=H(a.adler,h.pending_buf,h.pending,0)),h.gzindex=0,h.status=oa):(i(h,0),i(h,0),i(h,0),i(h,0),i(h,0),i(h,9===h.level?2:h.strategy>=V||h.level<2?4:0),i(h,ya),h.status=sa);else{var m=$+(h.w_bits-8<<4)<<8,n=-1;n=h.strategy>=V||h.level<2?0:h.level<6?1:6===h.level?2:3,m|=n<<6,0!==h.strstart&&(m|=ma),m+=31-m%31,h.status=sa,j(h,m),0!==h.strstart&&(j(h,a.adler>>>16),j(h,65535&a.adler)),a.adler=1}if(h.status===oa)if(h.gzhead.extra){for(k=h.pending;h.gzindex<(65535&h.gzhead.extra.length)&&(h.pending!==h.pending_buf_size||(h.gzhead.hcrc&&h.pending>k&&(a.adler=H(a.adler,h.pending_buf,h.pending-k,k)),g(a),k=h.pending,h.pending!==h.pending_buf_size));)i(h,255&h.gzhead.extra[h.gzindex]),h.gzindex++;h.gzhead.hcrc&&h.pending>k&&(a.adler=H(a.adler,h.pending_buf,h.pending-k,k)),h.gzindex===h.gzhead.extra.length&&(h.gzindex=0,h.status=pa)}else h.status=pa;if(h.status===pa)if(h.gzhead.name){k=h.pending;do{if(h.pending===h.pending_buf_size&&(h.gzhead.hcrc&&h.pending>k&&(a.adler=H(a.adler,h.pending_buf,h.pending-k,k)),g(a),k=h.pending,h.pending===h.pending_buf_size)){l=1;break}l=h.gzindex<h.gzhead.name.length?255&h.gzhead.name.charCodeAt(h.gzindex++):0,i(h,l)}while(0!==l);h.gzhead.hcrc&&h.pending>k&&(a.adler=H(a.adler,h.pending_buf,h.pending-k,k)),0===l&&(h.gzindex=0,h.status=qa)}else h.status=qa;if(h.status===qa)if(h.gzhead.comment){k=h.pending;do{if(h.pending===h.pending_buf_size&&(h.gzhead.hcrc&&h.pending>k&&(a.adler=H(a.adler,h.pending_buf,h.pending-k,k)),g(a),k=h.pending,h.pending===h.pending_buf_size)){l=1;break}l=h.gzindex<h.gzhead.comment.length?255&h.gzhead.comment.charCodeAt(h.gzindex++):0,i(h,l)}while(0!==l);h.gzhead.hcrc&&h.pending>k&&(a.adler=H(a.adler,h.pending_buf,h.pending-k,k)),0===l&&(h.status=ra)}else h.status=ra;if(h.status===ra&&(h.gzhead.hcrc?(h.pending+2>h.pending_buf_size&&g(a),h.pending+2<=h.pending_buf_size&&(i(h,255&a.adler),i(h,a.adler>>8&255),a.adler=0,h.status=sa)):h.status=sa),0!==h.pending){if(g(a),0===a.avail_out)return h.last_flush=-1,O}else if(0===a.avail_in&&e(b)<=e(c)&&b!==M)return d(a,S);if(h.status===ta&&0!==a.avail_in)return d(a,S);if(0!==a.avail_in||0!==h.lookahead||b!==J&&h.status!==ta){var o=h.strategy===V?r(h,b):h.strategy===W?q(h,b):D[h.level].func(h,b);if(o!==wa&&o!==xa||(h.status=ta),o===ua||o===wa)return 0===a.avail_out&&(h.last_flush=-1),O;if(o===va&&(b===K?F._tr_align(h):b!==N&&(F._tr_stored_block(h,0,0,!1),b===L&&(f(h.head),0===h.lookahead&&(h.strstart=0,h.block_start=0,h.insert=0))),g(a),0===a.avail_out))return h.last_flush=-1,O}return b!==M?O:h.wrap<=0?P:(2===h.wrap?(i(h,255&a.adler),i(h,a.adler>>8&255),i(h,a.adler>>16&255),i(h,a.adler>>24&255),i(h,255&a.total_in),i(h,a.total_in>>8&255),i(h,a.total_in>>16&255),i(h,a.total_in>>24&255)):(j(h,a.adler>>>16),j(h,65535&a.adler)),g(a),h.wrap>0&&(h.wrap=-h.wrap),0!==h.pending?O:P)}function B(a){var b;return a&&a.state?(b=a.state.status,b!==na&&b!==oa&&b!==pa&&b!==qa&&b!==ra&&b!==sa&&b!==ta?d(a,Q):(a.state=null,b===sa?d(a,R):O)):Q}function C(a,b){var c,d,e,g,h,i,j,k,l=b.length;if(!a||!a.state)return Q;if(c=a.state,g=c.wrap,2===g||1===g&&c.status!==na||c.lookahead)return Q;for(1===g&&(a.adler=G(a.adler,b,l,0)),c.wrap=0,l>=c.w_size&&(0===g&&(f(c.head),c.strstart=0,c.block_start=0,c.insert=0),k=new E.Buf8(c.w_size),E.arraySet(k,b,l-c.w_size,c.w_size,0),b=k,l=c.w_size),h=a.avail_in,i=a.next_in,j=a.input,a.avail_in=l,a.next_in=0,a.input=b,m(c);c.lookahead>=ja;){d=c.strstart,e=c.lookahead-(ja-1);do c.ins_h=(c.ins_h<<c.hash_shift^c.window[d+ja-1])&c.hash_mask,c.prev[d&c.w_mask]=c.head[c.ins_h],c.head[c.ins_h]=d,d++;while(--e);c.strstart=d,c.lookahead=ja-1,m(c)}return c.strstart+=c.lookahead,c.block_start=c.strstart,c.insert=c.lookahead,c.lookahead=0,c.match_length=c.prev_length=ja-1,c.match_available=0,a.next_in=i,a.input=j,a.avail_in=h,c.wrap=g,O}var D,E=a("../utils/common"),F=a("./trees"),G=a("./adler32"),H=a("./crc32"),I=a("./messages"),J=0,K=1,L=3,M=4,N=5,O=0,P=1,Q=-2,R=-3,S=-5,T=-1,U=1,V=2,W=3,X=4,Y=0,Z=2,$=8,_=9,aa=15,ba=8,ca=29,da=256,ea=da+1+ca,fa=30,ga=19,ha=2*ea+1,ia=15,ja=3,ka=258,la=ka+ja+1,ma=32,na=42,oa=69,pa=73,qa=91,ra=103,sa=113,ta=666,ua=1,va=2,wa=3,xa=4,ya=3;D=[new s(0,0,0,0,n),new s(4,4,8,4,o),new s(4,5,16,8,o),new s(4,6,32,32,o),new s(4,4,16,16,p),new s(8,16,32,32,p),new s(8,16,128,128,p),new s(8,32,128,256,p),new s(32,128,258,1024,p),new s(32,258,258,4096,p)],c.deflateInit=z,c.deflateInit2=y,c.deflateReset=w,c.deflateResetKeep=v,c.deflateSetHeader=x,c.deflate=A,c.deflateEnd=B,c.deflateSetDictionary=C,c.deflateInfo="pako deflate (from Nodeca project)"},{"../utils/common":62,"./adler32":64,"./crc32":66,"./messages":72,"./trees":73}],68:[function(a,b,c){"use strict";function d(){this.text=0,this.time=0,this.xflags=0,this.os=0,this.extra=null,this.extra_len=0,this.name="",this.comment="",this.hcrc=0,this.done=!1}b.exports=d},{}],69:[function(a,b,c){"use strict";var d=30,e=12;b.exports=function(a,b){var c,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y,z,A,B,C;c=a.state,f=a.next_in,B=a.input,g=f+(a.avail_in-5),h=a.next_out,C=a.output,i=h-(b-a.avail_out),j=h+(a.avail_out-257),k=c.dmax,l=c.wsize,m=c.whave,n=c.wnext,o=c.window,p=c.hold,q=c.bits,r=c.lencode,s=c.distcode,t=(1<<c.lenbits)-1,u=(1<<c.distbits)-1;a:do{q<15&&(p+=B[f++]<<q,q+=8,p+=B[f++]<<q,q+=8),v=r[p&t];b:for(;;){if(w=v>>>24,p>>>=w,q-=w,w=v>>>16&255,0===w)C[h++]=65535&v;else{if(!(16&w)){if(0===(64&w)){v=r[(65535&v)+(p&(1<<w)-1)];continue b}if(32&w){c.mode=e;break a}a.msg="invalid literal/length code",c.mode=d;break a}x=65535&v,w&=15,w&&(q<w&&(p+=B[f++]<<q,q+=8),x+=p&(1<<w)-1,p>>>=w,q-=w),q<15&&(p+=B[f++]<<q,q+=8,p+=B[f++]<<q,q+=8),v=s[p&u];c:for(;;){if(w=v>>>24,p>>>=w,q-=w,w=v>>>16&255,!(16&w)){if(0===(64&w)){v=s[(65535&v)+(p&(1<<w)-1)];continue c}a.msg="invalid distance code",c.mode=d;break a}if(y=65535&v,w&=15,q<w&&(p+=B[f++]<<q,q+=8,q<w&&(p+=B[f++]<<q,q+=8)),y+=p&(1<<w)-1,y>k){a.msg="invalid distance too far back",c.mode=d;break a}if(p>>>=w,q-=w,w=h-i,y>w){if(w=y-w,w>m&&c.sane){a.msg="invalid distance too far back",c.mode=d;break a}if(z=0,A=o,0===n){if(z+=l-w,w<x){x-=w;do C[h++]=o[z++];while(--w);z=h-y,A=C}}else if(n<w){if(z+=l+n-w,w-=n,w<x){x-=w;do C[h++]=o[z++];while(--w);if(z=0,n<x){w=n,x-=w;do C[h++]=o[z++];while(--w);z=h-y,A=C}}}else if(z+=n-w,w<x){x-=w;do C[h++]=o[z++];while(--w);z=h-y,A=C}for(;x>2;)C[h++]=A[z++],C[h++]=A[z++],C[h++]=A[z++],x-=3;x&&(C[h++]=A[z++],x>1&&(C[h++]=A[z++]))}else{z=h-y;do C[h++]=C[z++],C[h++]=C[z++],C[h++]=C[z++],x-=3;while(x>2);x&&(C[h++]=C[z++],x>1&&(C[h++]=C[z++]))}break}}break}}while(f<g&&h<j);x=q>>3,f-=x,q-=x<<3,p&=(1<<q)-1,a.next_in=f,a.next_out=h,a.avail_in=f<g?5+(g-f):5-(f-g),a.avail_out=h<j?257+(j-h):257-(h-j),c.hold=p,c.bits=q}},{}],70:[function(a,b,c){"use strict";function d(a){return(a>>>24&255)+(a>>>8&65280)+((65280&a)<<8)+((255&a)<<24)}function e(){this.mode=0,this.last=!1,this.wrap=0,this.havedict=!1,this.flags=0,this.dmax=0,this.check=0,this.total=0,this.head=null,this.wbits=0,this.wsize=0,this.whave=0,this.wnext=0,this.window=null,this.hold=0,this.bits=0,this.length=0,this.offset=0,this.extra=0,this.lencode=null,this.distcode=null,this.lenbits=0,this.distbits=0,this.ncode=0,this.nlen=0,this.ndist=0,this.have=0,this.next=null,this.lens=new s.Buf16(320),this.work=new s.Buf16(288),this.lendyn=null,this.distdyn=null,this.sane=0,this.back=0,this.was=0}function f(a){var b;return a&&a.state?(b=a.state,a.total_in=a.total_out=b.total=0,a.msg="",b.wrap&&(a.adler=1&b.wrap),b.mode=L,b.last=0,b.havedict=0,b.dmax=32768,b.head=null,b.hold=0,b.bits=0,b.lencode=b.lendyn=new s.Buf32(pa),b.distcode=b.distdyn=new s.Buf32(qa),b.sane=1,b.back=-1,D):G}function g(a){var b;return a&&a.state?(b=a.state,b.wsize=0,b.whave=0,b.wnext=0,f(a)):G}function h(a,b){var c,d;return a&&a.state?(d=a.state,b<0?(c=0,b=-b):(c=(b>>4)+1,b<48&&(b&=15)),b&&(b<8||b>15)?G:(null!==d.window&&d.wbits!==b&&(d.window=null),d.wrap=c,d.wbits=b,g(a))):G}function i(a,b){var c,d;return a?(d=new e,a.state=d,d.window=null,c=h(a,b),c!==D&&(a.state=null),c):G}function j(a){return i(a,sa)}function k(a){if(ta){var b;for(q=new s.Buf32(512),r=new s.Buf32(32),b=0;b<144;)a.lens[b++]=8;for(;b<256;)a.lens[b++]=9;for(;b<280;)a.lens[b++]=7;for(;b<288;)a.lens[b++]=8;for(w(y,a.lens,0,288,q,0,a.work,{bits:9}),b=0;b<32;)a.lens[b++]=5;w(z,a.lens,0,32,r,0,a.work,{bits:5}),ta=!1}a.lencode=q,a.lenbits=9,a.distcode=r,a.distbits=5}function l(a,b,c,d){var e,f=a.state;return null===f.window&&(f.wsize=1<<f.wbits,f.wnext=0,f.whave=0,f.window=new s.Buf8(f.wsize)),d>=f.wsize?(s.arraySet(f.window,b,c-f.wsize,f.wsize,0),f.wnext=0,f.whave=f.wsize):(e=f.wsize-f.wnext,e>d&&(e=d),s.arraySet(f.window,b,c-d,e,f.wnext),d-=e,d?(s.arraySet(f.window,b,c-d,d,0),f.wnext=d,f.whave=f.wsize):(f.wnext+=e,f.wnext===f.wsize&&(f.wnext=0),f.whave<f.wsize&&(f.whave+=e))),0}function m(a,b){var c,e,f,g,h,i,j,m,n,o,p,q,r,pa,qa,ra,sa,ta,ua,va,wa,xa,ya,za,Aa=0,Ba=new s.Buf8(4),Ca=[16,17,18,0,8,7,9,6,10,5,11,4,12,3,13,2,14,1,15];if(!a||!a.state||!a.output||!a.input&&0!==a.avail_in)return G;c=a.state,c.mode===W&&(c.mode=X),h=a.next_out,f=a.output,j=a.avail_out,g=a.next_in,e=a.input,i=a.avail_in,m=c.hold,n=c.bits,o=i,p=j,xa=D;a:for(;;)switch(c.mode){case L:if(0===c.wrap){c.mode=X;break}for(;n<16;){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}if(2&c.wrap&&35615===m){c.check=0,Ba[0]=255&m,Ba[1]=m>>>8&255,c.check=u(c.check,Ba,2,0),m=0,n=0,c.mode=M;break}if(c.flags=0,c.head&&(c.head.done=!1),!(1&c.wrap)||(((255&m)<<8)+(m>>8))%31){a.msg="incorrect header check",c.mode=ma;break}if((15&m)!==K){a.msg="unknown compression method",c.mode=ma;break}if(m>>>=4,n-=4,wa=(15&m)+8,0===c.wbits)c.wbits=wa;else if(wa>c.wbits){a.msg="invalid window size",c.mode=ma;break}c.dmax=1<<wa,a.adler=c.check=1,c.mode=512&m?U:W,m=0,n=0;break;case M:for(;n<16;){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}if(c.flags=m,(255&c.flags)!==K){a.msg="unknown compression method",c.mode=ma;break}if(57344&c.flags){a.msg="unknown header flags set",c.mode=ma;break}c.head&&(c.head.text=m>>8&1),512&c.flags&&(Ba[0]=255&m,Ba[1]=m>>>8&255,c.check=u(c.check,Ba,2,0)),m=0,n=0,c.mode=N;case N:for(;n<32;){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}c.head&&(c.head.time=m),512&c.flags&&(Ba[0]=255&m,Ba[1]=m>>>8&255,Ba[2]=m>>>16&255,Ba[3]=m>>>24&255,c.check=u(c.check,Ba,4,0)),m=0,n=0,c.mode=O;case O:for(;n<16;){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}c.head&&(c.head.xflags=255&m,c.head.os=m>>8),512&c.flags&&(Ba[0]=255&m,Ba[1]=m>>>8&255,c.check=u(c.check,Ba,2,0)),m=0,n=0,c.mode=P;case P:if(1024&c.flags){for(;n<16;){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}c.length=m,c.head&&(c.head.extra_len=m),512&c.flags&&(Ba[0]=255&m,Ba[1]=m>>>8&255,c.check=u(c.check,Ba,2,0)),m=0,n=0}else c.head&&(c.head.extra=null);c.mode=Q;case Q:if(1024&c.flags&&(q=c.length,q>i&&(q=i),q&&(c.head&&(wa=c.head.extra_len-c.length,c.head.extra||(c.head.extra=new Array(c.head.extra_len)),s.arraySet(c.head.extra,e,g,q,wa)),512&c.flags&&(c.check=u(c.check,e,q,g)),i-=q,g+=q,c.length-=q),c.length))break a;c.length=0,c.mode=R;case R:if(2048&c.flags){if(0===i)break a;q=0;do wa=e[g+q++],c.head&&wa&&c.length<65536&&(c.head.name+=String.fromCharCode(wa));while(wa&&q<i);if(512&c.flags&&(c.check=u(c.check,e,q,g)),i-=q,g+=q,wa)break a}else c.head&&(c.head.name=null);c.length=0,c.mode=S;case S:if(4096&c.flags){if(0===i)break a;q=0;do wa=e[g+q++],c.head&&wa&&c.length<65536&&(c.head.comment+=String.fromCharCode(wa));while(wa&&q<i);if(512&c.flags&&(c.check=u(c.check,e,q,g)),i-=q,g+=q,wa)break a}else c.head&&(c.head.comment=null);c.mode=T;case T:if(512&c.flags){for(;n<16;){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}if(m!==(65535&c.check)){a.msg="header crc mismatch",c.mode=ma;break}m=0,n=0}c.head&&(c.head.hcrc=c.flags>>9&1,c.head.done=!0),a.adler=c.check=0,c.mode=W;break;case U:for(;n<32;){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}a.adler=c.check=d(m),m=0,n=0,c.mode=V;case V:if(0===c.havedict)return a.next_out=h,a.avail_out=j,a.next_in=g,a.avail_in=i,c.hold=m,c.bits=n,F;a.adler=c.check=1,c.mode=W;case W:if(b===B||b===C)break a;case X:if(c.last){m>>>=7&n,n-=7&n,c.mode=ja;break}for(;n<3;){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}switch(c.last=1&m,m>>>=1,n-=1,3&m){case 0:c.mode=Y;break;case 1:if(k(c),c.mode=ca,b===C){m>>>=2,n-=2;break a}break;case 2:c.mode=_;break;case 3:a.msg="invalid block type",c.mode=ma}m>>>=2,n-=2;break;case Y:for(m>>>=7&n,n-=7&n;n<32;){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}if((65535&m)!==(m>>>16^65535)){a.msg="invalid stored block lengths",c.mode=ma;break}if(c.length=65535&m,m=0,n=0,c.mode=Z,b===C)break a;case Z:c.mode=$;case $:if(q=c.length){if(q>i&&(q=i),q>j&&(q=j),0===q)break a;s.arraySet(f,e,g,q,h),i-=q,g+=q,j-=q,h+=q,c.length-=q;break}c.mode=W;break;case _:for(;n<14;){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}if(c.nlen=(31&m)+257,m>>>=5,n-=5,c.ndist=(31&m)+1,m>>>=5,n-=5,c.ncode=(15&m)+4,m>>>=4,n-=4,c.nlen>286||c.ndist>30){a.msg="too many length or distance symbols",c.mode=ma;break}c.have=0,c.mode=aa;case aa:for(;c.have<c.ncode;){for(;n<3;){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}c.lens[Ca[c.have++]]=7&m,m>>>=3,n-=3}for(;c.have<19;)c.lens[Ca[c.have++]]=0;if(c.lencode=c.lendyn,c.lenbits=7,ya={bits:c.lenbits},xa=w(x,c.lens,0,19,c.lencode,0,c.work,ya),c.lenbits=ya.bits,xa){a.msg="invalid code lengths set",c.mode=ma;break}c.have=0,c.mode=ba;case ba:for(;c.have<c.nlen+c.ndist;){for(;Aa=c.lencode[m&(1<<c.lenbits)-1],qa=Aa>>>24,ra=Aa>>>16&255,sa=65535&Aa,!(qa<=n);){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}if(sa<16)m>>>=qa,n-=qa,c.lens[c.have++]=sa;else{if(16===sa){for(za=qa+2;n<za;){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}if(m>>>=qa,n-=qa,0===c.have){a.msg="invalid bit length repeat",c.mode=ma;break}wa=c.lens[c.have-1],q=3+(3&m),m>>>=2,n-=2}else if(17===sa){for(za=qa+3;n<za;){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}m>>>=qa,n-=qa,wa=0,q=3+(7&m),m>>>=3,n-=3}else{for(za=qa+7;n<za;){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}m>>>=qa,n-=qa,wa=0,q=11+(127&m),m>>>=7,n-=7}if(c.have+q>c.nlen+c.ndist){a.msg="invalid bit length repeat",c.mode=ma;break}for(;q--;)c.lens[c.have++]=wa}}if(c.mode===ma)break;if(0===c.lens[256]){a.msg="invalid code -- missing end-of-block",c.mode=ma;break}if(c.lenbits=9,ya={bits:c.lenbits},xa=w(y,c.lens,0,c.nlen,c.lencode,0,c.work,ya),c.lenbits=ya.bits,xa){a.msg="invalid literal/lengths set",c.mode=ma;break}if(c.distbits=6,c.distcode=c.distdyn,ya={bits:c.distbits},xa=w(z,c.lens,c.nlen,c.ndist,c.distcode,0,c.work,ya),c.distbits=ya.bits,xa){a.msg="invalid distances set",c.mode=ma;break}if(c.mode=ca,b===C)break a;case ca:c.mode=da;case da:if(i>=6&&j>=258){a.next_out=h,a.avail_out=j,a.next_in=g,a.avail_in=i,c.hold=m,c.bits=n,v(a,p),h=a.next_out,f=a.output,j=a.avail_out,g=a.next_in,e=a.input,i=a.avail_in,m=c.hold,n=c.bits,c.mode===W&&(c.back=-1);break}for(c.back=0;Aa=c.lencode[m&(1<<c.lenbits)-1],qa=Aa>>>24,ra=Aa>>>16&255,sa=65535&Aa,!(qa<=n);){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}if(ra&&0===(240&ra)){for(ta=qa,ua=ra,va=sa;Aa=c.lencode[va+((m&(1<<ta+ua)-1)>>ta)],qa=Aa>>>24,ra=Aa>>>16&255,sa=65535&Aa,!(ta+qa<=n);){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}m>>>=ta,n-=ta,c.back+=ta}if(m>>>=qa,n-=qa,c.back+=qa,c.length=sa,0===ra){c.mode=ia;break}if(32&ra){c.back=-1,c.mode=W;break}if(64&ra){a.msg="invalid literal/length code",c.mode=ma;break}c.extra=15&ra,c.mode=ea;case ea:if(c.extra){for(za=c.extra;n<za;){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}c.length+=m&(1<<c.extra)-1,m>>>=c.extra,n-=c.extra,c.back+=c.extra}c.was=c.length,c.mode=fa;case fa:for(;Aa=c.distcode[m&(1<<c.distbits)-1],qa=Aa>>>24,ra=Aa>>>16&255,sa=65535&Aa,!(qa<=n);){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}if(0===(240&ra)){for(ta=qa,ua=ra,va=sa;Aa=c.distcode[va+((m&(1<<ta+ua)-1)>>ta)],qa=Aa>>>24,ra=Aa>>>16&255,sa=65535&Aa,!(ta+qa<=n);){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}m>>>=ta,n-=ta,c.back+=ta}if(m>>>=qa,n-=qa,c.back+=qa,64&ra){a.msg="invalid distance code",c.mode=ma;break}c.offset=sa,c.extra=15&ra,c.mode=ga;case ga:if(c.extra){for(za=c.extra;n<za;){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}c.offset+=m&(1<<c.extra)-1,m>>>=c.extra,n-=c.extra,c.back+=c.extra}if(c.offset>c.dmax){a.msg="invalid distance too far back",c.mode=ma;break}c.mode=ha;case ha:if(0===j)break a;if(q=p-j,c.offset>q){if(q=c.offset-q,q>c.whave&&c.sane){a.msg="invalid distance too far back",c.mode=ma;break}q>c.wnext?(q-=c.wnext,r=c.wsize-q):r=c.wnext-q,q>c.length&&(q=c.length),pa=c.window}else pa=f,r=h-c.offset,q=c.length;q>j&&(q=j),j-=q,c.length-=q;do f[h++]=pa[r++];while(--q);0===c.length&&(c.mode=da);break;case ia:if(0===j)break a;f[h++]=c.length,j--,c.mode=da;break;case ja:if(c.wrap){for(;n<32;){if(0===i)break a;i--,m|=e[g++]<<n,n+=8}if(p-=j,a.total_out+=p,c.total+=p,p&&(a.adler=c.check=c.flags?u(c.check,f,p,h-p):t(c.check,f,p,h-p)),p=j,(c.flags?m:d(m))!==c.check){a.msg="incorrect data check",c.mode=ma;break}m=0,n=0}c.mode=ka;case ka:if(c.wrap&&c.flags){for(;n<32;){if(0===i)break a;i--,m+=e[g++]<<n,n+=8}if(m!==(4294967295&c.total)){a.msg="incorrect length check",c.mode=ma;break}m=0,n=0}c.mode=la;case la:xa=E;break a;case ma:xa=H;break a;case na:return I;case oa:default:return G}return a.next_out=h,a.avail_out=j,a.next_in=g,a.avail_in=i,c.hold=m,c.bits=n,(c.wsize||p!==a.avail_out&&c.mode<ma&&(c.mode<ja||b!==A))&&l(a,a.output,a.next_out,p-a.avail_out)?(c.mode=na,I):(o-=a.avail_in,p-=a.avail_out,a.total_in+=o,a.total_out+=p,c.total+=p,c.wrap&&p&&(a.adler=c.check=c.flags?u(c.check,f,p,a.next_out-p):t(c.check,f,p,a.next_out-p)),a.data_type=c.bits+(c.last?64:0)+(c.mode===W?128:0)+(c.mode===ca||c.mode===Z?256:0),(0===o&&0===p||b===A)&&xa===D&&(xa=J),xa)}function n(a){if(!a||!a.state)return G;var b=a.state;return b.window&&(b.window=null),a.state=null,D}function o(a,b){var c;return a&&a.state?(c=a.state,0===(2&c.wrap)?G:(c.head=b,b.done=!1,D)):G}function p(a,b){var c,d,e,f=b.length;return a&&a.state?(c=a.state,0!==c.wrap&&c.mode!==V?G:c.mode===V&&(d=1,d=t(d,b,f,0),d!==c.check)?H:(e=l(a,b,f,f))?(c.mode=na,I):(c.havedict=1,D)):G}var q,r,s=a("../utils/common"),t=a("./adler32"),u=a("./crc32"),v=a("./inffast"),w=a("./inftrees"),x=0,y=1,z=2,A=4,B=5,C=6,D=0,E=1,F=2,G=-2,H=-3,I=-4,J=-5,K=8,L=1,M=2,N=3,O=4,P=5,Q=6,R=7,S=8,T=9,U=10,V=11,W=12,X=13,Y=14,Z=15,$=16,_=17,aa=18,ba=19,ca=20,da=21,ea=22,fa=23,ga=24,ha=25,ia=26,ja=27,ka=28,la=29,ma=30,na=31,oa=32,pa=852,qa=592,ra=15,sa=ra,ta=!0;c.inflateReset=g,c.inflateReset2=h,c.inflateResetKeep=f,c.inflateInit=j,c.inflateInit2=i,c.inflate=m,c.inflateEnd=n,c.inflateGetHeader=o,c.inflateSetDictionary=p,c.inflateInfo="pako inflate (from Nodeca project)"},{"../utils/common":62,"./adler32":64,"./crc32":66,"./inffast":69,"./inftrees":71}],71:[function(a,b,c){"use strict";var d=a("../utils/common"),e=15,f=852,g=592,h=0,i=1,j=2,k=[3,4,5,6,7,8,9,10,11,13,15,17,19,23,27,31,35,43,51,59,67,83,99,115,131,163,195,227,258,0,0],l=[16,16,16,16,16,16,16,16,17,17,17,17,18,18,18,18,19,19,19,19,20,20,20,20,21,21,21,21,16,72,78],m=[1,2,3,4,5,7,9,13,17,25,33,49,65,97,129,193,257,385,513,769,1025,1537,2049,3073,4097,6145,8193,12289,16385,24577,0,0],n=[16,16,16,16,17,17,18,18,19,19,20,20,21,21,22,22,23,23,24,24,25,25,26,26,27,27,28,28,29,29,64,64];b.exports=function(a,b,c,o,p,q,r,s){var t,u,v,w,x,y,z,A,B,C=s.bits,D=0,E=0,F=0,G=0,H=0,I=0,J=0,K=0,L=0,M=0,N=null,O=0,P=new d.Buf16(e+1),Q=new d.Buf16(e+1),R=null,S=0;for(D=0;D<=e;D++)P[D]=0;for(E=0;E<o;E++)P[b[c+E]]++;for(H=C,G=e;G>=1&&0===P[G];G--);if(H>G&&(H=G),0===G)return p[q++]=20971520,p[q++]=20971520,s.bits=1,0;for(F=1;F<G&&0===P[F];F++);for(H<F&&(H=F),K=1,D=1;D<=e;D++)if(K<<=1,K-=P[D],K<0)return-1;if(K>0&&(a===h||1!==G))return-1;for(Q[1]=0,D=1;D<e;D++)Q[D+1]=Q[D]+P[D];for(E=0;E<o;E++)0!==b[c+E]&&(r[Q[b[c+E]]++]=E);if(a===h?(N=R=r,y=19):a===i?(N=k,O-=257,R=l,S-=257,y=256):(N=m,R=n,y=-1),M=0,E=0,D=F,x=q,I=H,J=0,v=-1,L=1<<H,w=L-1,a===i&&L>f||a===j&&L>g)return 1;for(;;){z=D-J,r[E]<y?(A=0,B=r[E]):r[E]>y?(A=R[S+r[E]],B=N[O+r[E]]):(A=96,B=0),t=1<<D-J,u=1<<I,F=u;do u-=t,p[x+(M>>J)+u]=z<<24|A<<16|B|0;while(0!==u);for(t=1<<D-1;M&t;)t>>=1;if(0!==t?(M&=t-1,M+=t):M=0,E++,0===--P[D]){if(D===G)break;D=b[c+r[E]]}if(D>H&&(M&w)!==v){for(0===J&&(J=H),x+=F,I=D-J,K=1<<I;I+J<G&&(K-=P[I+J],!(K<=0));)I++,K<<=1;if(L+=1<<I,a===i&&L>f||a===j&&L>g)return 1;v=M&w,p[v]=H<<24|I<<16|x-q|0}}return 0!==M&&(p[x+M]=D-J<<24|64<<16|0),s.bits=H,0}},{"../utils/common":62}],72:[function(a,b,c){"use strict";b.exports={2:"need dictionary",1:"stream end",0:"","-1":"file error","-2":"stream error","-3":"data error","-4":"insufficient memory","-5":"buffer error","-6":"incompatible version"}},{}],73:[function(a,b,c){"use strict";function d(a){for(var b=a.length;--b>=0;)a[b]=0}function e(a,b,c,d,e){this.static_tree=a,this.extra_bits=b,this.extra_base=c,this.elems=d,this.max_length=e,this.has_stree=a&&a.length}function f(a,b){this.dyn_tree=a,this.max_code=0,this.stat_desc=b}function g(a){return a<256?ia[a]:ia[256+(a>>>7)]}function h(a,b){a.pending_buf[a.pending++]=255&b,a.pending_buf[a.pending++]=b>>>8&255}function i(a,b,c){a.bi_valid>X-c?(a.bi_buf|=b<<a.bi_valid&65535,h(a,a.bi_buf),a.bi_buf=b>>X-a.bi_valid,a.bi_valid+=c-X):(a.bi_buf|=b<<a.bi_valid&65535,a.bi_valid+=c)}function j(a,b,c){i(a,c[2*b],c[2*b+1])}function k(a,b){var c=0;do c|=1&a,a>>>=1,c<<=1;while(--b>0);return c>>>1}function l(a){16===a.bi_valid?(h(a,a.bi_buf),a.bi_buf=0,a.bi_valid=0):a.bi_valid>=8&&(a.pending_buf[a.pending++]=255&a.bi_buf,a.bi_buf>>=8,a.bi_valid-=8)}function m(a,b){var c,d,e,f,g,h,i=b.dyn_tree,j=b.max_code,k=b.stat_desc.static_tree,l=b.stat_desc.has_stree,m=b.stat_desc.extra_bits,n=b.stat_desc.extra_base,o=b.stat_desc.max_length,p=0;for(f=0;f<=W;f++)a.bl_count[f]=0;for(i[2*a.heap[a.heap_max]+1]=0,
+c=a.heap_max+1;c<V;c++)d=a.heap[c],f=i[2*i[2*d+1]+1]+1,f>o&&(f=o,p++),i[2*d+1]=f,d>j||(a.bl_count[f]++,g=0,d>=n&&(g=m[d-n]),h=i[2*d],a.opt_len+=h*(f+g),l&&(a.static_len+=h*(k[2*d+1]+g)));if(0!==p){do{for(f=o-1;0===a.bl_count[f];)f--;a.bl_count[f]--,a.bl_count[f+1]+=2,a.bl_count[o]--,p-=2}while(p>0);for(f=o;0!==f;f--)for(d=a.bl_count[f];0!==d;)e=a.heap[--c],e>j||(i[2*e+1]!==f&&(a.opt_len+=(f-i[2*e+1])*i[2*e],i[2*e+1]=f),d--)}}function n(a,b,c){var d,e,f=new Array(W+1),g=0;for(d=1;d<=W;d++)f[d]=g=g+c[d-1]<<1;for(e=0;e<=b;e++){var h=a[2*e+1];0!==h&&(a[2*e]=k(f[h]++,h))}}function o(){var a,b,c,d,f,g=new Array(W+1);for(c=0,d=0;d<Q-1;d++)for(ka[d]=c,a=0;a<1<<ba[d];a++)ja[c++]=d;for(ja[c-1]=d,f=0,d=0;d<16;d++)for(la[d]=f,a=0;a<1<<ca[d];a++)ia[f++]=d;for(f>>=7;d<T;d++)for(la[d]=f<<7,a=0;a<1<<ca[d]-7;a++)ia[256+f++]=d;for(b=0;b<=W;b++)g[b]=0;for(a=0;a<=143;)ga[2*a+1]=8,a++,g[8]++;for(;a<=255;)ga[2*a+1]=9,a++,g[9]++;for(;a<=279;)ga[2*a+1]=7,a++,g[7]++;for(;a<=287;)ga[2*a+1]=8,a++,g[8]++;for(n(ga,S+1,g),a=0;a<T;a++)ha[2*a+1]=5,ha[2*a]=k(a,5);ma=new e(ga,ba,R+1,S,W),na=new e(ha,ca,0,T,W),oa=new e(new Array(0),da,0,U,Y)}function p(a){var b;for(b=0;b<S;b++)a.dyn_ltree[2*b]=0;for(b=0;b<T;b++)a.dyn_dtree[2*b]=0;for(b=0;b<U;b++)a.bl_tree[2*b]=0;a.dyn_ltree[2*Z]=1,a.opt_len=a.static_len=0,a.last_lit=a.matches=0}function q(a){a.bi_valid>8?h(a,a.bi_buf):a.bi_valid>0&&(a.pending_buf[a.pending++]=a.bi_buf),a.bi_buf=0,a.bi_valid=0}function r(a,b,c,d){q(a),d&&(h(a,c),h(a,~c)),G.arraySet(a.pending_buf,a.window,b,c,a.pending),a.pending+=c}function s(a,b,c,d){var e=2*b,f=2*c;return a[e]<a[f]||a[e]===a[f]&&d[b]<=d[c]}function t(a,b,c){for(var d=a.heap[c],e=c<<1;e<=a.heap_len&&(e<a.heap_len&&s(b,a.heap[e+1],a.heap[e],a.depth)&&e++,!s(b,d,a.heap[e],a.depth));)a.heap[c]=a.heap[e],c=e,e<<=1;a.heap[c]=d}function u(a,b,c){var d,e,f,h,k=0;if(0!==a.last_lit)do d=a.pending_buf[a.d_buf+2*k]<<8|a.pending_buf[a.d_buf+2*k+1],e=a.pending_buf[a.l_buf+k],k++,0===d?j(a,e,b):(f=ja[e],j(a,f+R+1,b),h=ba[f],0!==h&&(e-=ka[f],i(a,e,h)),d--,f=g(d),j(a,f,c),h=ca[f],0!==h&&(d-=la[f],i(a,d,h)));while(k<a.last_lit);j(a,Z,b)}function v(a,b){var c,d,e,f=b.dyn_tree,g=b.stat_desc.static_tree,h=b.stat_desc.has_stree,i=b.stat_desc.elems,j=-1;for(a.heap_len=0,a.heap_max=V,c=0;c<i;c++)0!==f[2*c]?(a.heap[++a.heap_len]=j=c,a.depth[c]=0):f[2*c+1]=0;for(;a.heap_len<2;)e=a.heap[++a.heap_len]=j<2?++j:0,f[2*e]=1,a.depth[e]=0,a.opt_len--,h&&(a.static_len-=g[2*e+1]);for(b.max_code=j,c=a.heap_len>>1;c>=1;c--)t(a,f,c);e=i;do c=a.heap[1],a.heap[1]=a.heap[a.heap_len--],t(a,f,1),d=a.heap[1],a.heap[--a.heap_max]=c,a.heap[--a.heap_max]=d,f[2*e]=f[2*c]+f[2*d],a.depth[e]=(a.depth[c]>=a.depth[d]?a.depth[c]:a.depth[d])+1,f[2*c+1]=f[2*d+1]=e,a.heap[1]=e++,t(a,f,1);while(a.heap_len>=2);a.heap[--a.heap_max]=a.heap[1],m(a,b),n(f,j,a.bl_count)}function w(a,b,c){var d,e,f=-1,g=b[1],h=0,i=7,j=4;for(0===g&&(i=138,j=3),b[2*(c+1)+1]=65535,d=0;d<=c;d++)e=g,g=b[2*(d+1)+1],++h<i&&e===g||(h<j?a.bl_tree[2*e]+=h:0!==e?(e!==f&&a.bl_tree[2*e]++,a.bl_tree[2*$]++):h<=10?a.bl_tree[2*_]++:a.bl_tree[2*aa]++,h=0,f=e,0===g?(i=138,j=3):e===g?(i=6,j=3):(i=7,j=4))}function x(a,b,c){var d,e,f=-1,g=b[1],h=0,k=7,l=4;for(0===g&&(k=138,l=3),d=0;d<=c;d++)if(e=g,g=b[2*(d+1)+1],!(++h<k&&e===g)){if(h<l){do j(a,e,a.bl_tree);while(0!==--h)}else 0!==e?(e!==f&&(j(a,e,a.bl_tree),h--),j(a,$,a.bl_tree),i(a,h-3,2)):h<=10?(j(a,_,a.bl_tree),i(a,h-3,3)):(j(a,aa,a.bl_tree),i(a,h-11,7));h=0,f=e,0===g?(k=138,l=3):e===g?(k=6,l=3):(k=7,l=4)}}function y(a){var b;for(w(a,a.dyn_ltree,a.l_desc.max_code),w(a,a.dyn_dtree,a.d_desc.max_code),v(a,a.bl_desc),b=U-1;b>=3&&0===a.bl_tree[2*ea[b]+1];b--);return a.opt_len+=3*(b+1)+5+5+4,b}function z(a,b,c,d){var e;for(i(a,b-257,5),i(a,c-1,5),i(a,d-4,4),e=0;e<d;e++)i(a,a.bl_tree[2*ea[e]+1],3);x(a,a.dyn_ltree,b-1),x(a,a.dyn_dtree,c-1)}function A(a){var b,c=4093624447;for(b=0;b<=31;b++,c>>>=1)if(1&c&&0!==a.dyn_ltree[2*b])return I;if(0!==a.dyn_ltree[18]||0!==a.dyn_ltree[20]||0!==a.dyn_ltree[26])return J;for(b=32;b<R;b++)if(0!==a.dyn_ltree[2*b])return J;return I}function B(a){pa||(o(),pa=!0),a.l_desc=new f(a.dyn_ltree,ma),a.d_desc=new f(a.dyn_dtree,na),a.bl_desc=new f(a.bl_tree,oa),a.bi_buf=0,a.bi_valid=0,p(a)}function C(a,b,c,d){i(a,(L<<1)+(d?1:0),3),r(a,b,c,!0)}function D(a){i(a,M<<1,3),j(a,Z,ga),l(a)}function E(a,b,c,d){var e,f,g=0;a.level>0?(a.strm.data_type===K&&(a.strm.data_type=A(a)),v(a,a.l_desc),v(a,a.d_desc),g=y(a),e=a.opt_len+3+7>>>3,f=a.static_len+3+7>>>3,f<=e&&(e=f)):e=f=c+5,c+4<=e&&b!==-1?C(a,b,c,d):a.strategy===H||f===e?(i(a,(M<<1)+(d?1:0),3),u(a,ga,ha)):(i(a,(N<<1)+(d?1:0),3),z(a,a.l_desc.max_code+1,a.d_desc.max_code+1,g+1),u(a,a.dyn_ltree,a.dyn_dtree)),p(a),d&&q(a)}function F(a,b,c){return a.pending_buf[a.d_buf+2*a.last_lit]=b>>>8&255,a.pending_buf[a.d_buf+2*a.last_lit+1]=255&b,a.pending_buf[a.l_buf+a.last_lit]=255&c,a.last_lit++,0===b?a.dyn_ltree[2*c]++:(a.matches++,b--,a.dyn_ltree[2*(ja[c]+R+1)]++,a.dyn_dtree[2*g(b)]++),a.last_lit===a.lit_bufsize-1}var G=a("../utils/common"),H=4,I=0,J=1,K=2,L=0,M=1,N=2,O=3,P=258,Q=29,R=256,S=R+1+Q,T=30,U=19,V=2*S+1,W=15,X=16,Y=7,Z=256,$=16,_=17,aa=18,ba=[0,0,0,0,0,0,0,0,1,1,1,1,2,2,2,2,3,3,3,3,4,4,4,4,5,5,5,5,0],ca=[0,0,0,0,1,1,2,2,3,3,4,4,5,5,6,6,7,7,8,8,9,9,10,10,11,11,12,12,13,13],da=[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,3,7],ea=[16,17,18,0,8,7,9,6,10,5,11,4,12,3,13,2,14,1,15],fa=512,ga=new Array(2*(S+2));d(ga);var ha=new Array(2*T);d(ha);var ia=new Array(fa);d(ia);var ja=new Array(P-O+1);d(ja);var ka=new Array(Q);d(ka);var la=new Array(T);d(la);var ma,na,oa,pa=!1;c._tr_init=B,c._tr_stored_block=C,c._tr_flush_block=E,c._tr_tally=F,c._tr_align=D},{"../utils/common":62}],74:[function(a,b,c){"use strict";function d(){this.input=null,this.next_in=0,this.avail_in=0,this.total_in=0,this.output=null,this.next_out=0,this.avail_out=0,this.total_out=0,this.msg="",this.state=null,this.data_type=2,this.adler=0}b.exports=d},{}]},{},[10])(10)});
\ No newline at end of file
diff --git a/spring-cloud-contract-maven-plugin/apidocs/member-search-index.js b/spring-cloud-contract-maven-plugin/apidocs/member-search-index.js
new file mode 100644
index 0000000000..0148f319e9
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/member-search-index.js
@@ -0,0 +1 @@
+memberSearchIndex = [{"p":"org.springframework.cloud.contract.maven.verifier.stubrunner","c":"AetherStubDownloaderFactory","l":"AetherStubDownloaderFactory(RepositorySystem, MavenProject)","url":"%3Cinit%3E(org.eclipse.aether.RepositorySystem,org.apache.maven.project.MavenProject)"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"BaseClassMapping","l":"BaseClassMapping()","url":"%3Cinit%3E()"},{"p":"org.springframework.cloud.contract.maven.verifier.stubrunner","c":"AetherStubDownloaderFactory","l":"build(RepositorySystemSession)","url":"build(org.eclipse.aether.RepositorySystemSession)"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"ConvertMojo","l":"ConvertMojo()","url":"%3Cinit%3E()"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"BaseClassMapping","l":"equals(Object)","url":"equals(java.lang.Object)"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"ConvertMojo","l":"execute()"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"GenerateStubsMojo","l":"execute()"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"GenerateTestsMojo","l":"execute()"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"HelpMojo","l":"execute()"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"PushStubsToScmMojo","l":"execute()"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"RunMojo","l":"execute()"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"GenerateStubsMojo","l":"GenerateStubsMojo()","url":"%3Cinit%3E()"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"GenerateTestsMojo","l":"GenerateTestsMojo()","url":"%3Cinit%3E()"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"BaseClassMapping","l":"getBaseClassFQN()"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"BaseClassMapping","l":"getContractPackageRegex()"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"GenerateTestsMojo","l":"getExcludedFiles()"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"GenerateTestsMojo","l":"getIgnoredFiles()"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"BaseClassMapping","l":"hashCode()"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"HelpMojo","l":"HelpMojo()","url":"%3Cinit%3E()"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"GenerateTestsMojo","l":"isAssertJsonSize()"},{"p":"org.springframework.cloud.contract.maven.verifier.stubrunner","c":"LocalStubRunner","l":"LocalStubRunner()","url":"%3Cinit%3E()"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"GenerateTestsMojo","l":"mappingsToMap()"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"PushStubsToScmMojo","l":"PushStubsToScmMojo()","url":"%3Cinit%3E()"},{"p":"org.springframework.cloud.contract.maven.verifier.stubrunner","c":"RemoteStubRunner","l":"RemoteStubRunner(AetherStubDownloaderFactory)","url":"%3Cinit%3E(org.springframework.cloud.contract.maven.verifier.stubrunner.AetherStubDownloaderFactory)"},{"p":"org.springframework.cloud.contract.maven.verifier.stubrunner","c":"LocalStubRunner","l":"run(String, StubRunnerOptions)","url":"run(java.lang.String,org.springframework.cloud.contract.stubrunner.StubRunnerOptions)"},{"p":"org.springframework.cloud.contract.maven.verifier.stubrunner","c":"RemoteStubRunner","l":"run(StubRunnerOptions, RepositorySystemSession)","url":"run(org.springframework.cloud.contract.stubrunner.StubRunnerOptions,org.eclipse.aether.RepositorySystemSession)"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"RunMojo","l":"RunMojo(LocalStubRunner, RemoteStubRunner)","url":"%3Cinit%3E(org.springframework.cloud.contract.maven.verifier.stubrunner.LocalStubRunner,org.springframework.cloud.contract.maven.verifier.stubrunner.RemoteStubRunner)"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"GenerateTestsMojo","l":"setAssertJsonSize(boolean)"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"BaseClassMapping","l":"setBaseClassFQN(String)","url":"setBaseClassFQN(java.lang.String)"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"BaseClassMapping","l":"setContractPackageRegex(String)","url":"setContractPackageRegex(java.lang.String)"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"GenerateTestsMojo","l":"setExcludedFiles(List<String>)","url":"setExcludedFiles(java.util.List)"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"GenerateTestsMojo","l":"setIgnoredFiles(List<String>)","url":"setIgnoredFiles(java.util.List)"},{"p":"org.springframework.cloud.contract.maven.verifier","c":"BaseClassMapping","l":"toString()"}]
\ No newline at end of file
diff --git a/spring-cloud-contract-maven-plugin/apidocs/member-search-index.zip b/spring-cloud-contract-maven-plugin/apidocs/member-search-index.zip
new file mode 100644
index 0000000000000000000000000000000000000000..5e31576e7de684bc1cabe986c31fc26e5b75a035
GIT binary patch
literal 773
zcmWIWW@Zs#;Nak3sMyKw&wvCZfb87V+@#bZ-Qv{5qT~$S%)FG;3cal2{Jgzk-ubr;
zc>ZZSHZaL0yto8pzu1(<Z;~zc-R#YR6KfWSOtT5}yUhFh{p6(OE8`<4M(n#Oa`L^h
zX3(FH>2rGT_f7TVNSk%~N!(=-xv6yuJ}Ye0d^{Ix8mlaoo{+*k>wfVC7T<kWc1~Gv
z{Nap9@$iJO1<Kn0R>&<4Fk!RZ+U8{+$y*qs9O1BR!tV1gIC+;m%y{<US=8FbndaA=
z*UjzkKFvA(PE1T3d!MnvL1PxD@^zkvyDu-4Ox4!-ncnIg^!1;)jUjL98+naGE&)d*
z&l+XNvc-tAuPvOzSnnk|%~HHj`M#h+kt#n6_tx+yKW=`yqvAJZi;!_}c4$zo;!E4o
z<J#=|i?j@O#D?X^YsOvXRc$)e@<#MmzwEXHMa;G>KRDlfUBGr{sl$4X@`hvlhtdUR
ziXZ<h6TbV%os}I+;}pbp%4}K3yL0`$ms-`%b_Ji+66X0YyT8AZb=H)!;!|=NOxzv`
zuMM|~eXKg|BIj)Ll<9*0mFX^8cjbfJ#ll6xg+;3+gn!>(DBbW_bdl`y_`s7L|LwFl
zJrk~9EFrpXr+D?s46k-ROI@$5<12L6o!@!KMj~N#l*6j7#;B8(u`)6@_gRJC2wpjH
zal*a#vqL$R9?P^ZKKw8@?TubXd&1mXiLqL|agMKC=jh)1JAE6+dN!H9f4j}BcN-t(
zZjafu`n2ay@he{M9<57T`TurIyUppy$?MkdY){DAT(@!x!!74bt9jmQa?M@+Wx0av
z*O$-tPg;9Bfcs$B-hZ8Pno*_QyB=oT6J7CM+hui@b=%H|O%}}S|7fiaSKr$ecK?ml
zshp65NA_;8|IZlU&Ca25&@dpGiGjghh=C!%n~_O`0g+UZ<v>Xl72ry^0p6@^AeD?j
N=mw-$0!?RN004YGJOKaz

literal 0
HcmV?d00001

diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/BaseClassMapping.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/BaseClassMapping.html
index 32c151d5bf..d12d6c724f 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/BaseClassMapping.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/BaseClassMapping.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>BaseClassMapping (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/ConvertMojo.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/ConvertMojo.html
index 80975558c7..7e019bbaba 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/ConvertMojo.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/ConvertMojo.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>ConvertMojo (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/GenerateStubsMojo.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/GenerateStubsMojo.html
index bb31ce092d..e829b9acae 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/GenerateStubsMojo.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/GenerateStubsMojo.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>GenerateStubsMojo (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/GenerateTestsMojo.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/GenerateTestsMojo.html
index 6db9bb63b8..2aa5299db5 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/GenerateTestsMojo.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/GenerateTestsMojo.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>GenerateTestsMojo (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/HelpMojo.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/HelpMojo.html
index 6008889383..6ef37c5126 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/HelpMojo.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/HelpMojo.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>HelpMojo (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/PushStubsToScmMojo.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/PushStubsToScmMojo.html
index a0e3378bc3..2a5fc24418 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/PushStubsToScmMojo.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/PushStubsToScmMojo.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>PushStubsToScmMojo (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/RunMojo.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/RunMojo.html
index 2cdf9cb52f..50c1dee42c 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/RunMojo.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/RunMojo.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>RunMojo (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/BaseClassMapping.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/BaseClassMapping.html
index 21fa8583f4..73d489e209 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/BaseClassMapping.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/BaseClassMapping.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Uses of Class org.springframework.cloud.contract.maven.verifier.BaseClassMapping (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/ConvertMojo.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/ConvertMojo.html
index 1a7013d288..1d92d0ed36 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/ConvertMojo.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/ConvertMojo.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Uses of Class org.springframework.cloud.contract.maven.verifier.ConvertMojo (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/GenerateStubsMojo.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/GenerateStubsMojo.html
index 34d06b9a28..bed7af63a7 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/GenerateStubsMojo.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/GenerateStubsMojo.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Uses of Class org.springframework.cloud.contract.maven.verifier.GenerateStubsMojo (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/GenerateTestsMojo.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/GenerateTestsMojo.html
index 2f87e1474a..fce7bee996 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/GenerateTestsMojo.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/GenerateTestsMojo.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Uses of Class org.springframework.cloud.contract.maven.verifier.GenerateTestsMojo (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/HelpMojo.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/HelpMojo.html
index 412c9fc78f..c3936007c3 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/HelpMojo.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/HelpMojo.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Uses of Class org.springframework.cloud.contract.maven.verifier.HelpMojo (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/PushStubsToScmMojo.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/PushStubsToScmMojo.html
index bbc56a6561..e1ea5a49e9 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/PushStubsToScmMojo.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/PushStubsToScmMojo.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Uses of Class org.springframework.cloud.contract.maven.verifier.PushStubsToScmMojo (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/RunMojo.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/RunMojo.html
index 01e913bfa3..f1660cd8ca 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/RunMojo.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/class-use/RunMojo.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Uses of Class org.springframework.cloud.contract.maven.verifier.RunMojo (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-frame.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-frame.html
index 7e9800e05b..d69d112508 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-frame.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-frame.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>org.springframework.cloud.contract.maven.verifier (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-summary.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-summary.html
index 9716ccbbbc..848f723acf 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-summary.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-summary.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>org.springframework.cloud.contract.maven.verifier (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-tree.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-tree.html
index 565210177c..167344cdf9 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-tree.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-tree.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>org.springframework.cloud.contract.maven.verifier Class Hierarchy (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-use.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-use.html
index 88052c3a58..aa6dd1ab67 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-use.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/package-use.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Uses of Package org.springframework.cloud.contract.maven.verifier (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/AetherStubDownloaderFactory.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/AetherStubDownloaderFactory.html
index 6404af8334..3a65601144 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/AetherStubDownloaderFactory.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/AetherStubDownloaderFactory.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>AetherStubDownloaderFactory (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/LocalStubRunner.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/LocalStubRunner.html
index 174dac322f..8544299bbe 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/LocalStubRunner.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/LocalStubRunner.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>LocalStubRunner (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/RemoteStubRunner.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/RemoteStubRunner.html
index cf7ae0aad7..dc1862793e 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/RemoteStubRunner.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/RemoteStubRunner.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>RemoteStubRunner (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/class-use/AetherStubDownloaderFactory.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/class-use/AetherStubDownloaderFactory.html
index 424302d38b..042cf7c422 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/class-use/AetherStubDownloaderFactory.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/class-use/AetherStubDownloaderFactory.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Uses of Class org.springframework.cloud.contract.maven.verifier.stubrunner.AetherStubDownloaderFactory (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/class-use/LocalStubRunner.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/class-use/LocalStubRunner.html
index 5b061798fe..a7aace4205 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/class-use/LocalStubRunner.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/class-use/LocalStubRunner.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Uses of Class org.springframework.cloud.contract.maven.verifier.stubrunner.LocalStubRunner (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/class-use/RemoteStubRunner.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/class-use/RemoteStubRunner.html
index 0b06345942..7c87090d7c 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/class-use/RemoteStubRunner.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/class-use/RemoteStubRunner.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Uses of Class org.springframework.cloud.contract.maven.verifier.stubrunner.RemoteStubRunner (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-frame.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-frame.html
index e88664b970..a12834a307 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-frame.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-frame.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>org.springframework.cloud.contract.maven.verifier.stubrunner (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-summary.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-summary.html
index 798d2b620d..e1de15ac10 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-summary.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-summary.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>org.springframework.cloud.contract.maven.verifier.stubrunner (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-tree.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-tree.html
index aa66f0e3b2..a0d8b52439 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-tree.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-tree.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>org.springframework.cloud.contract.maven.verifier.stubrunner Class Hierarchy (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-use.html b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-use.html
index 9d6e256b7d..0dd94ecbcc 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-use.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/org/springframework/cloud/contract/maven/verifier/stubrunner/package-use.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Uses of Package org.springframework.cloud.contract.maven.verifier.stubrunner (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/overview-frame.html b/spring-cloud-contract-maven-plugin/apidocs/overview-frame.html
index 2d720a899d..797d3dec43 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/overview-frame.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/overview-frame.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Overview List (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/overview-summary.html b/spring-cloud-contract-maven-plugin/apidocs/overview-summary.html
index c33e3194fb..ad515dca36 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/overview-summary.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/overview-summary.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Overview (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/overview-tree.html b/spring-cloud-contract-maven-plugin/apidocs/overview-tree.html
index 4e084422db..2b1a910433 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/overview-tree.html
+++ b/spring-cloud-contract-maven-plugin/apidocs/overview-tree.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_201) on Wed Aug 07 09:56:21 UTC 2019 -->
+<!-- Generated by javadoc (1.8.0_192) on Wed Aug 07 23:13:24 CEST 2019 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Class Hierarchy (Spring Cloud Contract Maven Plugin 2.2.0.BUILD-SNAPSHOT API)</title>
 <meta name="date" content="2019-08-07">
diff --git a/spring-cloud-contract-maven-plugin/apidocs/package-search-index.js b/spring-cloud-contract-maven-plugin/apidocs/package-search-index.js
new file mode 100644
index 0000000000..daf7d407c5
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/package-search-index.js
@@ -0,0 +1 @@
+packageSearchIndex = [{"l":"All Packages","url":"allpackages-index.html"},{"l":"org.springframework.cloud.contract.maven.verifier"},{"l":"org.springframework.cloud.contract.maven.verifier.stubrunner"}]
\ No newline at end of file
diff --git a/spring-cloud-contract-maven-plugin/apidocs/package-search-index.zip b/spring-cloud-contract-maven-plugin/apidocs/package-search-index.zip
new file mode 100644
index 0000000000000000000000000000000000000000..3bd8f39da994bf7629d9ddf6f64bb8f646bf1232
GIT binary patch
literal 273
zcmWIWW@Zs#;Nak3sMyKw&wvCZf$W0B<m|-sRNdm##G>R3-ORj{)C#?<;{3e1XAJoc
z8SuD0T&-~aD0{+Vwl^IIm*jQ4vbZ{bNr=-O+0X)}YwES{e<>{%o_m&0oO83wT9bg|
zaz}H1ZcY9aXkND^=ZoCFWeP>H6Kwn@tU2E_vw5mrk;XlRg@w~X=Z3q^n)Imt<kqj&
zyMEj4tYrxBX6LBU=3bWzbkP<d4)A7V5@A5N8d(nHYE*#J4*}k+Y#^nKK<EynK}It$
F008MXRki>C

literal 0
HcmV?d00001

diff --git a/spring-cloud-contract-maven-plugin/apidocs/resources/glass.png b/spring-cloud-contract-maven-plugin/apidocs/resources/glass.png
new file mode 100644
index 0000000000000000000000000000000000000000..a7f591f467a1c0c949bbc510156a0c1afb860a6e
GIT binary patch
literal 499
zcmV<P0Sx|$P)<h;3K|Lk000e1NJLTq000mG000mO1^@s6AM^iV0000PbVXQnQ*UN;
zcVTj606}DLVr3vnZDD6+Qe|Oed2z{QJOBUzl}SWFRCwBA{Qv(y0|-RU-){({%7EAb
zhy{T7ArP+x;@;(nj_(+707j4jK+Q=&_Dmpt1jH+W_!SWAfXoHr*Ffw7G~^Ce10v?_
zGXv7cfOshorvVlIgh>JoRsvExf%rEN>jUL}qZ_~k#FbE+Q;{`;0FZwVNX2n-^JoI;
zP;4#$8DIy*Yk-P>VN(DUKmPse7mx+ExD4O|;?E5D0Z5($mjO3`*anwQU^s{ZDK#Lz
zj>~{qyaIx5K!t%=G&2IJNzg!ChRpyLkO7}Ry!QaotAHAMpbB3AF(}|_f!G-oI|uK6
z`id_dumai5K%C3Y$;tKS_iqMPHg<*|-@e`liWLAggVM!zAP#@l;=c>S03;{#04Z~5
zN_+ss=Yg6*hTr59mzMwZ@+l~q!+?ft!fF66AXT#wWavHt30bZWFCK%!BNk}LN?0Hg
z1VF_nfs`Lm^DjYZ1(1uD0u4<h+6721i2zbdgk+VN-#xwu(wIh)0Z>CSIr)XAaq<Z=
pynB52BgqCp4Jm;}@p6Cw0|4^LpB(^sAf*5R002ovPDHLkV1hXO#b5vc

literal 0
HcmV?d00001

diff --git a/spring-cloud-contract-maven-plugin/apidocs/resources/x.png b/spring-cloud-contract-maven-plugin/apidocs/resources/x.png
new file mode 100644
index 0000000000000000000000000000000000000000..30548a756e151be4e927e8d28c508cc5b3514bf3
GIT binary patch
literal 394
zcmV;50d@X~P)<h;3K|Lk000e1NJLTq000mG000mO1^@s6AM^iV0000PbVXQnQ*UN;
zcVTj606}DLVr3vnZDD6+Qe|Oed2z{QJOBUzEJ;K`RCwBAZ10)C00gB#Tm-~f6~+1M
z8SsFP-icvAY7!8)0M$-mc5(A40dl&5m<Nahj~qXF-Nwq|Iu6a@Kx!Ef^8&FKQ0;pr
zAfpyZ4I2<I2PzD~p?N6~Gb0ICfegq6;=f3OtmuZ|&<xU(#{wi40r7tzo{yw}1!@Q*
zkY>W6IT{!St5~1{i=i}zAy76p%_|w8rh@@c0Axr!ns=D-X+|*sY6!@wacG9%)Qn*O
zl0sa739kT-&_?#oVxXF6tOnqTD)cZ}2vi$`ZU8RLAlo8=_z#*P3xI~i!lEh+Pdu-L
zx{d*wgjtXbnGX_Yf@Tc7Q3YhLhPvc8noGJs2DA~1DySiA&<p{k-g=k|K>6V{5JzFt
ojAY1KXm~va;tU{v7C?Xj0BHw!K;2aXV*mgE07*qoM6N<$f;4TDA^-pY

literal 0
HcmV?d00001

diff --git a/spring-cloud-contract-maven-plugin/apidocs/search.js b/spring-cloud-contract-maven-plugin/apidocs/search.js
new file mode 100644
index 0000000000..9d3fb81226
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/search.js
@@ -0,0 +1,329 @@
+/*
+ * Copyright (c) 2015, 2018, Oracle and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.  Oracle designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+ * or visit www.oracle.com if you need additional information or have any
+ * questions.
+ */
+
+var noResult = {l: "No results found"};
+var catModules = "Modules";
+var catPackages = "Packages";
+var catTypes = "Types";
+var catMembers = "Members";
+var catSearchTags = "SearchTags";
+var highlight = "<span class=\"resultHighlight\">$&</span>";
+var camelCaseRegexp = "";
+var secondaryMatcher = "";
+function getHighlightedText(item) {
+    var ccMatcher = new RegExp(camelCaseRegexp);
+    var label = item.replace(ccMatcher, highlight);
+    if (label === item) {
+        label = item.replace(secondaryMatcher, highlight);
+    }
+    return label;
+}
+function getURLPrefix(ui) {
+    var urlPrefix="";
+    if (useModuleDirectories) {
+        var slash = "/";
+        if (ui.item.category === catModules) {
+            return ui.item.l + slash;
+        } else if (ui.item.category === catPackages && ui.item.m) {
+            return ui.item.m + slash;
+        } else if ((ui.item.category === catTypes && ui.item.p) || ui.item.category === catMembers) {
+            $.each(packageSearchIndex, function(index, item) {
+                if (ui.item.p == item.l) {
+                    urlPrefix = item.m + slash;
+                }
+            });
+            return urlPrefix;
+        } else {
+            return urlPrefix;
+        }
+    }
+    return urlPrefix;
+}
+var watermark = 'Search';
+$(function() {
+    $("#search").val('');
+    $("#search").prop("disabled", false);
+    $("#reset").prop("disabled", false);
+    $("#search").val(watermark).addClass('watermark');
+    $("#search").blur(function() {
+        if ($(this).val().length == 0) {
+            $(this).val(watermark).addClass('watermark');
+        }
+    });
+    $("#search").on('click keydown', function() {
+        if ($(this).val() == watermark) {
+            $(this).val('').removeClass('watermark');
+        }
+    });
+    $("#reset").click(function() {
+        $("#search").val('');
+        $("#search").focus();
+    });
+    $("#search").focus();
+    $("#search")[0].setSelectionRange(0, 0);
+});
+$.widget("custom.catcomplete", $.ui.autocomplete, {
+    _create: function() {
+        this._super();
+        this.widget().menu("option", "items", "> :not(.ui-autocomplete-category)");
+    },
+    _renderMenu: function(ul, items) {
+        var rMenu = this,
+                currentCategory = "";
+        $.each(items, function(index, item) {
+            var li;
+            if (item.l !== noResult.l && item.category !== currentCategory) {
+                ul.append("<li class=\"ui-autocomplete-category\">" + item.category + "</li>");
+                currentCategory = item.category;
+            }
+            li = rMenu._renderItemData(ul, item);
+            if (item.category) {
+                li.attr("aria-label", item.category + " : " + item.l);
+                li.attr("class", "resultItem");
+            } else {
+                li.attr("aria-label", item.l);
+                li.attr("class", "resultItem");
+            }
+        });
+    },
+    _renderItem: function(ul, item) {
+        var label = "";
+        if (item.category === catModules) {
+            label = getHighlightedText(item.l);
+        } else if (item.category === catPackages) {
+            label = (item.m)
+                    ? getHighlightedText(item.m + "/" + item.l)
+                    : getHighlightedText(item.l);
+        } else if (item.category === catTypes) {
+            label = (item.p)
+                    ? getHighlightedText(item.p + "." + item.l)
+                    : getHighlightedText(item.l);
+        } else if (item.category === catMembers) {
+            label = getHighlightedText(item.p + "." + (item.c + "." + item.l));
+        } else if (item.category === catSearchTags) {
+            label = getHighlightedText(item.l);
+        } else {
+            label = item.l;
+        }
+        $li = $("<li/>").appendTo(ul);
+        if (item.category === catSearchTags) {
+            if (item.d) {
+                $("<a/>").attr("href", "#")
+                        .html(label + "<span class=\"searchTagHolderResult\"> (" + item.h + ")</span><br><span class=\"searchTagDescResult\">"
+                                + item.d + "</span><br>")
+                        .appendTo($li);
+            } else {
+                $("<a/>").attr("href", "#")
+                        .html(label + "<span class=\"searchTagHolderResult\"> (" + item.h + ")</span>")
+                        .appendTo($li);
+            }
+        } else {
+            $("<a/>").attr("href", "#")
+                    .html(label)
+                    .appendTo($li);
+        }
+        return $li;
+    }
+});
+$(function() {
+    $("#search").catcomplete({
+        minLength: 1,
+        delay: 100,
+        source: function(request, response) {
+            var result = new Array();
+            var presult = new Array();
+            var tresult = new Array();
+            var mresult = new Array();
+            var tgresult = new Array();
+            var secondaryresult = new Array();
+            var displayCount = 0;
+            var exactMatcher = new RegExp("^" + $.ui.autocomplete.escapeRegex(request.term) + "$", "i");
+            camelCaseRegexp = ($.ui.autocomplete.escapeRegex(request.term)).split(/(?=[A-Z])/).join("([a-z0-9_$]*?)");
+            var camelCaseMatcher = new RegExp("^" + camelCaseRegexp);
+            secondaryMatcher = new RegExp($.ui.autocomplete.escapeRegex(request.term), "i");
+
+            // Return the nested innermost name from the specified object
+            function nestedName(e) {
+                return e.l.substring(e.l.lastIndexOf(".") + 1);
+            }
+
+            function concatResults(a1, a2) {
+                a1 = a1.concat(a2);
+                a2.length = 0;
+                return a1;
+            }
+
+            if (moduleSearchIndex) {
+                var mdleCount = 0;
+                $.each(moduleSearchIndex, function(index, item) {
+                    item.category = catModules;
+                    if (exactMatcher.test(item.l)) {
+                        result.push(item);
+                        mdleCount++;
+                    } else if (camelCaseMatcher.test(item.l)) {
+                        result.push(item);
+                    } else if (secondaryMatcher.test(item.l)) {
+                        secondaryresult.push(item);
+                    }
+                });
+                displayCount = mdleCount;
+                result = concatResults(result, secondaryresult);
+            }
+            if (packageSearchIndex) {
+                var pCount = 0;
+                var pkg = "";
+                $.each(packageSearchIndex, function(index, item) {
+                    item.category = catPackages;
+                    pkg = (item.m)
+                            ? (item.m + "/" + item.l)
+                            : item.l;
+                    if (exactMatcher.test(item.l)) {
+                        presult.push(item);
+                        pCount++;
+                    } else if (camelCaseMatcher.test(pkg)) {
+                        presult.push(item);
+                    } else if (secondaryMatcher.test(pkg)) {
+                        secondaryresult.push(item);
+                    }
+                });
+                result = result.concat(concatResults(presult, secondaryresult));
+                displayCount = (pCount > displayCount) ? pCount : displayCount;
+            }
+            if (typeSearchIndex) {
+                var tCount = 0;
+                $.each(typeSearchIndex, function(index, item) {
+                    item.category = catTypes;
+                    var s = nestedName(item);
+                    if (exactMatcher.test(s)) {
+                        tresult.push(item);
+                        tCount++;
+                    } else if (camelCaseMatcher.test(s)) {
+                        tresult.push(item);
+                    } else if (secondaryMatcher.test(item.p + "." + item.l)) {
+                        secondaryresult.push(item);
+                    }
+                });
+                result = result.concat(concatResults(tresult, secondaryresult));
+                displayCount = (tCount > displayCount) ? tCount : displayCount;
+            }
+            if (memberSearchIndex) {
+                var mCount = 0;
+                $.each(memberSearchIndex, function(index, item) {
+                    item.category = catMembers;
+                    var s = nestedName(item);
+                    if (exactMatcher.test(s)) {
+                        mresult.push(item);
+                        mCount++;
+                    } else if (camelCaseMatcher.test(s)) {
+                        mresult.push(item);
+                    } else if (secondaryMatcher.test(item.c + "." + item.l)) {
+                        secondaryresult.push(item);
+                    }
+                });
+                result = result.concat(concatResults(mresult, secondaryresult));
+                displayCount = (mCount > displayCount) ? mCount : displayCount;
+            }
+            if (tagSearchIndex) {
+                var tgCount = 0;
+                $.each(tagSearchIndex, function(index, item) {
+                    item.category = catSearchTags;
+                    if (exactMatcher.test(item.l)) {
+                        tgresult.push(item);
+                        tgCount++;
+                    } else if (secondaryMatcher.test(item.l)) {
+                        secondaryresult.push(item);
+                    }
+                });
+                result = result.concat(concatResults(tgresult, secondaryresult));
+                displayCount = (tgCount > displayCount) ? tgCount : displayCount;
+            }
+            displayCount = (displayCount > 500) ? displayCount : 500;
+            var counter = function() {
+                var count = {Modules: 0, Packages: 0, Types: 0, Members: 0, SearchTags: 0};
+                var f = function(item) {
+                    count[item.category] += 1;
+                    return (count[item.category] <= displayCount);
+                };
+                return f;
+            }();
+            response(result.filter(counter));
+        },
+        response: function(event, ui) {
+            if (!ui.content.length) {
+                ui.content.push(noResult);
+            } else {
+                $("#search").empty();
+            }
+        },
+        autoFocus: true,
+        position: {
+            collision: "flip"
+        },
+        select: function(event, ui) {
+            if (ui.item.l !== noResult.l) {
+                var url = getURLPrefix(ui);
+                if (ui.item.category === catModules) {
+                    if (useModuleDirectories) {
+                        url += "module-summary.html";
+                    } else {
+                        url = ui.item.l + "-summary.html";
+                    }
+                } else if (ui.item.category === catPackages) {
+                    if (ui.item.url) {
+                        url = ui.item.url;
+                    } else {
+                    url += ui.item.l.replace(/\./g, '/') + "/package-summary.html";
+                    }
+                } else if (ui.item.category === catTypes) {
+                    if (ui.item.url) {
+                        url = ui.item.url;
+                    } else if (ui.item.p === "<Unnamed>") {
+                        url += ui.item.l + ".html";
+                    } else {
+                        url += ui.item.p.replace(/\./g, '/') + "/" + ui.item.l + ".html";
+                    }
+                } else if (ui.item.category === catMembers) {
+                    if (ui.item.p === "<Unnamed>") {
+                        url += ui.item.c + ".html" + "#";
+                    } else {
+                        url += ui.item.p.replace(/\./g, '/') + "/" + ui.item.c + ".html" + "#";
+                    }
+                    if (ui.item.url) {
+                        url += ui.item.url;
+                    } else {
+                        url += ui.item.l;
+                    }
+                } else if (ui.item.category === catSearchTags) {
+                    url += ui.item.u;
+                }
+                if (top !== window) {
+                    parent.classFrame.location = pathtoroot + url;
+                } else {
+                    window.location.href = pathtoroot + url;
+                }
+            }
+        }
+    });
+});
diff --git a/spring-cloud-contract-maven-plugin/apidocs/stylesheet.css b/spring-cloud-contract-maven-plugin/apidocs/stylesheet.css
index 98055b22d6..fa246765cf 100644
--- a/spring-cloud-contract-maven-plugin/apidocs/stylesheet.css
+++ b/spring-cloud-contract-maven-plugin/apidocs/stylesheet.css
@@ -1,35 +1,51 @@
-/* Javadoc style sheet */
-/*
-Overall document style
-*/
+/* 
+ * Javadoc style sheet
+ */
 
 @import url('resources/fonts/dejavu.css');
 
+/*
+ * Styles for individual HTML elements.
+ *
+ * These are styles that are specific to individual HTML elements. Changing them affects the style of a particular
+ * HTML element throughout the page.
+ */
+
 body {
     background-color:#ffffff;
     color:#353833;
     font-family:'DejaVu Sans', Arial, Helvetica, sans-serif;
     font-size:14px;
     margin:0;
+    padding:0;
+    height:100%;
+    width:100%;
+}
+iframe {
+    margin:0;
+    padding:0;
+    height:100%;
+    width:100%;
+    overflow-y:scroll;
+    border:none;
 }
 a:link, a:visited {
     text-decoration:none;
     color:#4A6782;
 }
-a:hover, a:focus {
+a[href]:hover, a[href]:focus {
     text-decoration:none;
     color:#bb7a2a;
 }
-a:active {
-    text-decoration:none;
-    color:#4A6782;
-}
 a[name] {
     color:#353833;
 }
-a[name]:hover {
-    text-decoration:none;
-    color:#353833;
+a[name]:before, a[name]:target, a[id]:before, a[id]:target {
+    content:"";
+    display:inline-block;
+    position:relative;
+    padding-top:129px;
+    margin-top:-129px;
 }
 pre {
     font-family:'DejaVu Sans Mono', monospace;
@@ -78,9 +94,16 @@ table tr td dt code {
 sup {
     font-size:8px;
 }
+
 /*
-Document title and Copyright styles
-*/
+ * Styles for HTML generated by javadoc.
+ *
+ * These are style classes that are used by the standard doclet to generate HTML documentation.
+ */
+
+/*
+ * Styles for document title and copyright.
+ */
 .clear {
     clear:both;
     height:0px;
@@ -111,8 +134,8 @@ Document title and Copyright styles
     font-weight:bold;
 }
 /*
-Navigation bar styles
-*/
+ * Styles for navigation bar.
+ */
 .bar {
     background-color:#4D7A97;
     color:#FFFFFF;
@@ -121,6 +144,15 @@ Navigation bar styles
     font-size:11px;
     margin:0;
 }
+.navPadding {
+    padding-top: 107px;
+}
+.fixedNav {
+    position:fixed;
+    width:100%;
+    z-index:999;
+    background-color:#ffffff;
+}
 .topNav {
     background-color:#4D7A97;
     color:#FFFFFF;
@@ -170,7 +202,22 @@ ul.navList li{
     padding: 5px 6px;
     text-transform:uppercase;
 }
-ul.subNavList li{
+ul.navListSearch {
+    float:right;
+    margin:0 0 0 0;
+    padding:0;
+}
+ul.navListSearch li {
+    list-style:none;
+    float:right;
+    padding: 5px 6px;
+    text-transform:uppercase;
+}
+ul.navListSearch li label {
+    position:relative;
+    right:-16px;
+}
+ul.subNavList li {
     list-style:none;
     float:left;
 }
@@ -196,21 +243,29 @@ ul.subNavList li{
     overflow:hidden;
 }
 /*
-Page header and footer styles
-*/
+ * Styles for page header and footer.
+ */
 .header, .footer {
     clear:both;
     margin:0 20px;
     padding:5px 0 0 0;
 }
-.indexHeader {
-    margin:10px;
+.indexNav {
     position:relative;
+    font-size:12px;
+    background-color:#dee3e9;
 }
-.indexHeader span{
-    margin-right:15px;
+.indexNav ul {
+    margin-top:0;
+    padding:5px;
 }
-.indexHeader h1 {
+.indexNav ul li {
+    display:inline;
+    list-style-type:none;
+    padding-right:10px;
+    text-transform:uppercase;
+}
+.indexNav h1 {
     font-size:13px;
 }
 .title {
@@ -232,8 +287,8 @@ Page header and footer styles
     font-size:13px;
 }
 /*
-Heading styles
-*/
+ * Styles for headings.
+ */
 div.details ul.blockList ul.blockList ul.blockList li.blockList h4, div.details ul.blockList ul.blockList ul.blockListLast li.blockList h4 {
     background-color:#dee3e9;
     border:1px solid #d0d9e0;
@@ -254,9 +309,10 @@ ul.blockList li.blockList h2 {
     padding:0px 0 20px 0;
 }
 /*
-Page layout container styles
-*/
-.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer {
+ * Styles for page layout containers.
+ */
+.contentContainer, .sourceContainer, .classUseContainer, .serializedFormContainer, .constantValuesContainer,
+.allClassesContainer, .allPackagesContainer {
     clear:both;
     padding:10px 20px;
     position:relative;
@@ -287,7 +343,7 @@ Page layout container styles
 .contentContainer .description dl dd, .contentContainer .details dl dd, .serializedFormContainer dl dd {
     margin:5px 0 10px 0px;
     font-size:14px;
-    font-family:'DejaVu Sans Mono',monospace;
+    font-family:'DejaVu Serif', Georgia, "Times New Roman", Times, serif;
 }
 .serializedFormContainer dl.nameValue dt {
     margin-left:1px;
@@ -301,8 +357,11 @@ Page layout container styles
     display:inline;
 }
 /*
-List styles
-*/
+ * Styles for lists.
+ */
+li.circle {
+    list-style:circle;
+}
 ul.horizontal li {
     display:inline;
     font-size:0.9em;
@@ -355,19 +414,22 @@ table tr td dl, table tr td dl dt, table tr td dl dd {
     margin-bottom:1px;
 }
 /*
-Table styles
-*/
-.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary {
+ * Styles for tables.
+ */
+.overviewSummary, .memberSummary, .typeSummary, .useSummary, .constantsSummary, .deprecatedSummary,
+.requiresSummary, .packagesSummary, .providesSummary, .usesSummary {
     width:100%;
+    border-spacing:0;
     border-left:1px solid #EEE; 
     border-right:1px solid #EEE; 
     border-bottom:1px solid #EEE; 
 }
-.overviewSummary, .memberSummary  {
+.overviewSummary, .memberSummary, .requiresSummary, .packagesSummary, .providesSummary, .usesSummary  {
     padding:0px;
 }
 .overviewSummary caption, .memberSummary caption, .typeSummary caption,
-.useSummary caption, .constantsSummary caption, .deprecatedSummary caption {
+.useSummary caption, .constantsSummary caption, .deprecatedSummary caption,
+.requiresSummary caption, .packagesSummary caption, .providesSummary caption, .usesSummary caption {
     position:relative;
     text-align:left;
     background-repeat:no-repeat;
@@ -382,17 +444,31 @@ Table styles
     white-space:pre;
 }
 .overviewSummary caption a:link, .memberSummary caption a:link, .typeSummary caption a:link,
-.useSummary caption a:link, .constantsSummary caption a:link, .deprecatedSummary caption a:link,
+.constantsSummary caption a:link, .deprecatedSummary caption a:link,
+.requiresSummary caption a:link, .packagesSummary caption a:link, .providesSummary caption a:link,
+.usesSummary caption a:link,
 .overviewSummary caption a:hover, .memberSummary caption a:hover, .typeSummary caption a:hover,
-.useSummary caption a:hover, .constantsSummary caption a:hover, .deprecatedSummary caption a:hover,
+.constantsSummary caption a:hover, .deprecatedSummary caption a:hover,
+.requiresSummary caption a:hover, .packagesSummary caption a:hover, .providesSummary caption a:hover,
+.usesSummary caption a:hover,
 .overviewSummary caption a:active, .memberSummary caption a:active, .typeSummary caption a:active,
-.useSummary caption a:active, .constantsSummary caption a:active, .deprecatedSummary caption a:active,
+.constantsSummary caption a:active, .deprecatedSummary caption a:active,
+.requiresSummary caption a:active, .packagesSummary caption a:active, .providesSummary caption a:active,
+.usesSummary caption a:active,
 .overviewSummary caption a:visited, .memberSummary caption a:visited, .typeSummary caption a:visited,
-.useSummary caption a:visited, .constantsSummary caption a:visited, .deprecatedSummary caption a:visited {
+.constantsSummary caption a:visited, .deprecatedSummary caption a:visited,
+.requiresSummary caption a:visited, .packagesSummary caption a:visited, .providesSummary caption a:visited,
+.usesSummary caption a:visited {
     color:#FFFFFF;
 }
+.useSummary caption a:link, .useSummary caption a:hover, .useSummary caption a:active,
+.useSummary caption a:visited {
+    color:#1f389c;
+}
 .overviewSummary caption span, .memberSummary caption span, .typeSummary caption span,
-.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span {
+.useSummary caption span, .constantsSummary caption span, .deprecatedSummary caption span,
+.requiresSummary caption span, .packagesSummary caption span, .providesSummary caption span,
+.usesSummary caption span {
     white-space:nowrap;
     padding-top:5px;
     padding-left:12px;
@@ -404,7 +480,8 @@ Table styles
     border: none;
     height:16px;
 }
-.memberSummary caption span.activeTableTab span {
+.memberSummary caption span.activeTableTab span, .packagesSummary caption span.activeTableTab span,
+.overviewSummary caption span.activeTableTab span, .typeSummary caption span.activeTableTab span {
     white-space:nowrap;
     padding-top:5px;
     padding-left:12px;
@@ -415,7 +492,8 @@ Table styles
     background-color:#F8981D;
     height:16px;
 }
-.memberSummary caption span.tableTab span {
+.memberSummary caption span.tableTab span, .packagesSummary caption span.tableTab span,
+.overviewSummary caption span.tableTab span, .typeSummary caption span.tableTab span {
     white-space:nowrap;
     padding-top:5px;
     padding-left:12px;
@@ -426,7 +504,10 @@ Table styles
     background-color:#4D7A97;
     height:16px;
 }
-.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab {
+.memberSummary caption span.tableTab, .memberSummary caption span.activeTableTab,
+.packagesSummary caption span.tableTab, .packagesSummary caption span.activeTableTab,
+.overviewSummary caption span.tableTab, .overviewSummary caption span.activeTableTab,
+.typeSummary caption span.tableTab, .typeSummary caption span.activeTableTab {
     padding-top:0px;
     padding-left:0px;
     padding-right:0px;
@@ -435,14 +516,16 @@ Table styles
     display:inline;
 }
 .overviewSummary .tabEnd, .memberSummary .tabEnd, .typeSummary .tabEnd,
-.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd {
+.useSummary .tabEnd, .constantsSummary .tabEnd, .deprecatedSummary .tabEnd,
+.requiresSummary .tabEnd, .packagesSummary .tabEnd, .providesSummary .tabEnd, .usesSummary .tabEnd {
     display:none;
     width:5px;
     position:relative;
     float:left;
     background-color:#F8981D;
 }
-.memberSummary .activeTableTab .tabEnd {
+.memberSummary .activeTableTab .tabEnd, .packagesSummary .activeTableTab .tabEnd,
+.overviewSummary .activeTableTab .tabEnd, .typeSummary .activeTableTab .tabEnd {
     display:none;
     width:5px;
     margin-right:3px;
@@ -450,66 +533,88 @@ Table styles
     float:left;
     background-color:#F8981D;
 }
-.memberSummary .tableTab .tabEnd {
+.memberSummary .tableTab .tabEnd, .packagesSummary .tableTab .tabEnd,
+.overviewSummary .tableTab .tabEnd, .typeSummary .tableTab .tabEnd {
     display:none;
     width:5px;
     margin-right:3px;
     position:relative;
     background-color:#4D7A97;
     float:left;
-
+}
+.rowColor th, .altColor th {
+    font-weight:normal;
 }
 .overviewSummary td, .memberSummary td, .typeSummary td,
-.useSummary td, .constantsSummary td, .deprecatedSummary td {
+.useSummary td, .constantsSummary td, .deprecatedSummary td,
+.requiresSummary td, .packagesSummary td, .providesSummary td, .usesSummary td {
     text-align:left;
     padding:0px 0px 12px 10px;
 }
-th.colOne, th.colFirst, th.colLast, .useSummary th, .constantsSummary th,
-td.colOne, td.colFirst, td.colLast, .useSummary td, .constantsSummary td{
+th.colFirst, th.colSecond, th.colLast, th.colConstructorName, th.colDeprecatedItemName, .useSummary th,
+.constantsSummary th, .packagesSummary th, td.colFirst, td.colSecond, td.colLast, .useSummary td,
+.constantsSummary td {
     vertical-align:top;
     padding-right:0px;
     padding-top:8px;
     padding-bottom:3px;
 }
-th.colFirst, th.colLast, th.colOne, .constantsSummary th {
+th.colFirst, th.colSecond, th.colLast, th.colConstructorName, th.colDeprecatedItemName, .constantsSummary th,
+.packagesSummary th {
     background:#dee3e9;
     text-align:left;
     padding:8px 3px 3px 7px;
 }
 td.colFirst, th.colFirst {
-    white-space:nowrap;
     font-size:13px;
 }
-td.colLast, th.colLast {
+td.colSecond, th.colSecond, td.colLast, th.colConstructorName, th.colDeprecatedItemName, th.colLast {
     font-size:13px;
 }
-td.colOne, th.colOne {
+.constantsSummary th, .packagesSummary th {
+    font-size:13px;
+}
+.providesSummary th.colFirst, .providesSummary th.colLast, .providesSummary td.colFirst,
+.providesSummary td.colLast {
+    white-space:normal;
     font-size:13px;
 }
 .overviewSummary td.colFirst, .overviewSummary th.colFirst,
-.useSummary td.colFirst, .useSummary th.colFirst,
-.overviewSummary td.colOne, .overviewSummary th.colOne,
+.requiresSummary td.colFirst, .requiresSummary th.colFirst,
+.packagesSummary td.colFirst, .packagesSummary td.colSecond, .packagesSummary th.colFirst, .packagesSummary th,
+.usesSummary td.colFirst, .usesSummary th.colFirst,
+.providesSummary td.colFirst, .providesSummary th.colFirst,
 .memberSummary td.colFirst, .memberSummary th.colFirst,
-.memberSummary td.colOne, .memberSummary th.colOne,
-.typeSummary td.colFirst{
-    width:25%;
+.memberSummary td.colSecond, .memberSummary th.colSecond, .memberSummary th.colConstructorName,
+.typeSummary td.colFirst, .typeSummary th.colFirst {
     vertical-align:top;
 }
-td.colOne a:link, td.colOne a:active, td.colOne a:visited, td.colOne a:hover, td.colFirst a:link, td.colFirst a:active, td.colFirst a:visited, td.colFirst a:hover, td.colLast a:link, td.colLast a:active, td.colLast a:visited, td.colLast a:hover, .constantValuesContainer td a:link, .constantValuesContainer td a:active, .constantValuesContainer td a:visited, .constantValuesContainer td a:hover {
+.packagesSummary th.colLast, .packagesSummary td.colLast {
+    white-space:normal;
+}
+td.colFirst a:link, td.colFirst a:visited,
+td.colSecond a:link, td.colSecond a:visited,
+th.colFirst a:link, th.colFirst a:visited,
+th.colSecond a:link, th.colSecond a:visited,
+th.colConstructorName a:link, th.colConstructorName a:visited,
+th.colDeprecatedItemName a:link, th.colDeprecatedItemName a:visited, 
+.constantValuesContainer td a:link, .constantValuesContainer td a:visited, 
+.allClassesContainer td a:link, .allClassesContainer td a:visited, 
+.allPackagesContainer td a:link, .allPackagesContainer td a:visited {
     font-weight:bold;
 }
 .tableSubHeadingColor {
     background-color:#EEEEFF;
 }
-.altColor {
+.altColor, .altColor th {
     background-color:#FFFFFF;
 }
-.rowColor {
+.rowColor, .rowColor th {
     background-color:#EEEEEF;
 }
 /*
-Content styles
-*/
+ * Styles for contents.
+ */
 .description pre {
     margin-top:0;
 }
@@ -520,27 +625,22 @@ Content styles
 .docSummary {
     padding:0;
 }
-
 ul.blockList ul.blockList ul.blockList li.blockList h3 {
     font-style:normal;
 }
-
 div.block {
     font-size:14px;
     font-family:'DejaVu Serif', Georgia, "Times New Roman", Times, serif;
 }
-
 td.colLast div {
     padding-top:0px;
 }
-
-
 td.colLast a {
     padding-bottom:3px;
 }
 /*
-Formatting effect styles
-*/
+ * Styles for formatting effect.
+ */
 .sourceLineNo {
     color:green;
     padding:0 30px 0 0;
@@ -555,20 +655,252 @@ h1.hidden {
     margin:3px 10px 2px 0px;
     color:#474747;
 }
-.deprecatedLabel, .descfrmTypeLabel, .memberNameLabel, .memberNameLink,
-.overrideSpecifyLabel, .packageHierarchyLabel, .paramLabel, .returnLabel,
-.seeLabel, .simpleTagLabel, .throwsLabel, .typeNameLabel, .typeNameLink {
+.deprecatedLabel, .descfrmTypeLabel, .implementationLabel, .memberNameLabel, .memberNameLink,
+.moduleLabelInPackage, .moduleLabelInType, .overrideSpecifyLabel, .packageLabelInType,
+.packageHierarchyLabel, .paramLabel, .returnLabel, .seeLabel, .simpleTagLabel,
+.throwsLabel, .typeNameLabel, .typeNameLink, .searchTagLink {
     font-weight:bold;
 }
 .deprecationComment, .emphasizedPhrase, .interfaceName {
     font-style:italic;
 }
-
-div.block div.block span.deprecationComment, div.block div.block span.emphasizedPhrase,
+.deprecationBlock {
+    font-size:14px;
+    font-family:'DejaVu Serif', Georgia, "Times New Roman", Times, serif;
+    border-style:solid;
+    border-width:thin;
+    border-radius:10px;
+    padding:10px;
+    margin-bottom:10px;
+    margin-right:10px;
+    display:inline-block;
+}
+div.block div.deprecationComment, div.block div.block span.emphasizedPhrase,
 div.block div.block span.interfaceName {
     font-style:normal;
 }
-
-div.contentContainer ul.blockList li.blockList h2{
+div.contentContainer ul.blockList li.blockList h2 {
     padding-bottom:0px;
 }
+/*
+ * Styles for IFRAME.
+ */
+.mainContainer {
+    margin:0 auto; 
+    padding:0; 
+    height:100%; 
+    width:100%; 
+    position:fixed; 
+    top:0; 
+    left:0;
+}
+.leftContainer {
+    height:100%;
+    position:fixed;
+    width:320px;
+}
+.leftTop {
+    position:relative;
+    float:left;
+    width:315px;
+    top:0;
+    left:0;
+    height:30%;
+    border-right:6px solid #ccc;
+    border-bottom:6px solid #ccc;
+}
+.leftBottom {
+    position:relative;
+    float:left;
+    width:315px;
+    bottom:0;
+    left:0;
+    height:70%;
+    border-right:6px solid #ccc;
+    border-top:1px solid #000;
+}
+.rightContainer {
+    position:absolute;
+    left:320px;
+    top:0;
+    bottom:0;
+    height:100%;
+    right:0;
+    border-left:1px solid #000;
+}
+.rightIframe {
+    margin:0;
+    padding:0;
+    height:100%;
+    right:30px;
+    width:100%;
+    overflow:visible;
+    margin-bottom:30px;
+}
+/*
+ * Styles specific to HTML5 elements.
+ */
+main, nav, header, footer, section {
+    display:block;
+}
+/*
+ * Styles for javadoc search.
+ */
+.ui-autocomplete-category {
+    font-weight:bold;
+    font-size:15px;
+    padding:7px 0 7px 3px;
+    background-color:#4D7A97;
+    color:#FFFFFF;
+}
+.resultItem {
+    font-size:13px;
+}
+.ui-autocomplete {
+    max-height:85%;
+    max-width:65%;
+    overflow-y:scroll;
+    overflow-x:scroll;
+    white-space:nowrap;
+    box-shadow: 0 3px 6px rgba(0,0,0,0.16), 0 3px 6px rgba(0,0,0,0.23);
+}
+ul.ui-autocomplete {
+    position:fixed;
+    z-index:999999;
+}
+ul.ui-autocomplete  li {
+    float:left;
+    clear:both;
+    width:100%;
+}
+.resultHighlight {
+    font-weight:bold;
+}
+#search {
+    background-image:url('resources/glass.png');
+    background-size:13px;
+    background-repeat:no-repeat;
+    background-position:2px 3px;
+    padding-left:20px;
+    position:relative;
+    right:-18px;
+}
+#reset {
+    background-color: rgb(255,255,255);
+    background-image:url('resources/x.png');
+    background-position:center;
+    background-repeat:no-repeat;
+    background-size:12px;
+    border:0 none;
+    width:16px;
+    height:17px;
+    position:relative;
+    left:-4px;
+    top:-4px;
+    font-size:0px;
+}
+.watermark {
+    color:#545454;
+}
+.searchTagDescResult {
+    font-style:italic;
+    font-size:11px;
+}
+.searchTagHolderResult {
+    font-style:italic;
+    font-size:12px;
+}
+.searchTagResult:before, .searchTagResult:target {
+    color:red;
+}
+.moduleGraph span {
+    display:none;
+    position:absolute;
+}
+.moduleGraph:hover span {
+    display:block;
+    margin: -100px 0 0 100px;
+    z-index: 1;
+}
+.methodSignature {
+    white-space:normal;
+}
+
+/*
+ * Styles for user-provided tables.
+ *
+ * borderless:
+ *      No borders, vertical margins, styled caption.
+ *      This style is provided for use with existing doc comments.
+ *      In general, borderless tables should not be used for layout purposes.
+ *
+ * plain:
+ *      Plain borders around table and cells, vertical margins, styled caption.
+ *      Best for small tables or for complex tables for tables with cells that span
+ *      rows and columns, when the "striped" style does not work well.
+ *
+ * striped:
+ *      Borders around the table and vertical borders between cells, striped rows,
+ *      vertical margins, styled caption.
+ *      Best for tables that have a header row, and a body containing a series of simple rows.
+ */
+
+table.borderless,
+table.plain,
+table.striped {
+    margin-top: 10px;
+    margin-bottom: 10px;
+}
+table.borderless > caption,
+table.plain > caption,
+table.striped > caption {
+    font-weight: bold;
+    font-size: smaller;
+}
+table.borderless th, table.borderless td,
+table.plain th, table.plain td,
+table.striped th, table.striped td {
+    padding: 2px 5px;
+}
+table.borderless,
+table.borderless > thead > tr > th, table.borderless > tbody > tr > th, table.borderless > tr > th,
+table.borderless > thead > tr > td, table.borderless > tbody > tr > td, table.borderless > tr > td {
+    border: none;
+}
+table.borderless > thead > tr, table.borderless > tbody > tr, table.borderless > tr {
+    background-color: transparent;
+}
+table.plain {
+    border-collapse: collapse;
+    border: 1px solid black;
+}
+table.plain > thead > tr, table.plain > tbody tr, table.plain > tr {
+    background-color: transparent;
+}
+table.plain > thead > tr > th, table.plain > tbody > tr > th, table.plain > tr > th,
+table.plain > thead > tr > td, table.plain > tbody > tr > td, table.plain > tr > td {
+    border: 1px solid black;
+}
+table.striped {
+    border-collapse: collapse;
+    border: 1px solid black;
+}
+table.striped > thead {
+    background-color: #E3E3E3;
+}
+table.striped > thead > tr > th, table.striped > thead > tr > td {
+    border: 1px solid black;
+}
+table.striped > tbody > tr:nth-child(even) {
+    background-color: #EEE
+}
+table.striped > tbody > tr:nth-child(odd) {
+    background-color: #FFF
+}
+table.striped > tbody > tr > th, table.striped > tbody > tr > td {
+    border-left: 1px solid black;
+    border-right: 1px solid black;
+}
+table.striped > tbody > tr > th {
+    font-weight: normal;
+}
diff --git a/spring-cloud-contract-maven-plugin/apidocs/type-search-index.js b/spring-cloud-contract-maven-plugin/apidocs/type-search-index.js
new file mode 100644
index 0000000000..f7dd2c75cb
--- /dev/null
+++ b/spring-cloud-contract-maven-plugin/apidocs/type-search-index.js
@@ -0,0 +1 @@
+typeSearchIndex = [{"p":"org.springframework.cloud.contract.maven.verifier.stubrunner","l":"AetherStubDownloaderFactory"},{"l":"All Classes","url":"allclasses-index.html"},{"p":"org.springframework.cloud.contract.maven.verifier","l":"BaseClassMapping"},{"p":"org.springframework.cloud.contract.maven.verifier","l":"ConvertMojo"},{"p":"org.springframework.cloud.contract.maven.verifier","l":"GenerateStubsMojo"},{"p":"org.springframework.cloud.contract.maven.verifier","l":"GenerateTestsMojo"},{"p":"org.springframework.cloud.contract.maven.verifier","l":"HelpMojo"},{"p":"org.springframework.cloud.contract.maven.verifier.stubrunner","l":"LocalStubRunner"},{"p":"org.springframework.cloud.contract.maven.verifier","l":"PushStubsToScmMojo"},{"p":"org.springframework.cloud.contract.maven.verifier.stubrunner","l":"RemoteStubRunner"},{"p":"org.springframework.cloud.contract.maven.verifier","l":"RunMojo"}]
\ No newline at end of file
diff --git a/spring-cloud-contract-maven-plugin/apidocs/type-search-index.zip b/spring-cloud-contract-maven-plugin/apidocs/type-search-index.zip
new file mode 100644
index 0000000000000000000000000000000000000000..ae72b3cc50f49fec5afe5c40a8da11adfe89054c
GIT binary patch
literal 375
zcmWIWW@Zs#;Nak3sMyKw&wvEPfb5dWf>hn&)Wo9X4BgDUl++5ntm6E<wUajHF&Xl-
z#V<YO^O@l;*NV3RDl9po%_k+_bqTwdF|8GNfA7xH=<WB`?*CN(GwJ!`v_+LhI_j$f
zcNJK1RqWX`XRY$N-cp%K4c^xdvo`NtP;#8_Xx1tAlZp#w%v{)1aqP;X9Pd3(vK89c
zo-P%M+;_INY;}5voEXch6-%csJ>PKR>WhusymdFtDy5|U3;o_Yv-wfMWv(Qhw-*nv
zwoh6jTK_5In)bAfj)&?ZtTYSTXDw6Qr+Bn*!T$Isb7cemzwq@vZnbXnw!=K-drIrF
zZu3^Hv!3O#Jz>@3f9wI?>>N)@Vp(qjy<W!5z!2cg$Rxsm2p(iPQ1GAv?12^F&B_K+
O#|VTjKw6d&!~+03Q;dB8

literal 0
HcmV?d00001

diff --git a/spring-cloud-contract-maven-plugin/checkstyle.html b/spring-cloud-contract-maven-plugin/checkstyle.html
index 6373c6c369..1babe5ab05 100644
--- a/spring-cloud-contract-maven-plugin/checkstyle.html
+++ b/spring-cloud-contract-maven-plugin/checkstyle.html
@@ -294,7 +294,7 @@
 <td>12</td>
 <td>0</td>
 <td>0</td>
-<td>521</td></tr></table></div>
+<td>530</td></tr></table></div>
 <div class="section">
 <h2><a name="Files"></a>Files</h2>
 <table border="0" class="table table-striped">
@@ -312,7 +312,7 @@
 <td><a href="#org.springframework.cloud.contract.maven.verifier.ConvertMojo.java">org/springframework/cloud/contract/maven/verifier/ConvertMojo.java</a></td>
 <td>0</td>
 <td>0</td>
-<td>98</td></tr>
+<td>99</td></tr>
 <tr class="b">
 <td><a href="#org.springframework.cloud.contract.maven.verifier.CopyContracts.java">org/springframework/cloud/contract/maven/verifier/CopyContracts.java</a></td>
 <td>0</td>
@@ -322,7 +322,7 @@
 <td><a href="#org.springframework.cloud.contract.maven.verifier.GenerateStubsMojo.java">org/springframework/cloud/contract/maven/verifier/GenerateStubsMojo.java</a></td>
 <td>0</td>
 <td>0</td>
-<td>33</td></tr>
+<td>42</td></tr>
 <tr class="b">
 <td><a href="#org.springframework.cloud.contract.maven.verifier.GenerateTestsMojo.java">org/springframework/cloud/contract/maven/verifier/GenerateTestsMojo.java</a></td>
 <td>0</td>
@@ -337,7 +337,7 @@
 <td><a href="#org.springframework.cloud.contract.maven.verifier.MavenContractsDownloader.java">org/springframework/cloud/contract/maven/verifier/MavenContractsDownloader.java</a></td>
 <td>0</td>
 <td>0</td>
-<td>86</td></tr>
+<td>85</td></tr>
 <tr class="a">
 <td><a href="#org.springframework.cloud.contract.maven.verifier.PushStubsToScmMojo.java">org/springframework/cloud/contract/maven/verifier/PushStubsToScmMojo.java</a></td>
 <td>0</td>
@@ -357,12 +357,12 @@
 <td><a href="#org.springframework.cloud.contract.maven.verifier.stubrunner.LocalStubRunner.java">org/springframework/cloud/contract/maven/verifier/stubrunner/LocalStubRunner.java</a></td>
 <td>0</td>
 <td>0</td>
-<td>8</td></tr>
+<td>9</td></tr>
 <tr class="a">
 <td><a href="#org.springframework.cloud.contract.maven.verifier.stubrunner.RemoteStubRunner.java">org/springframework/cloud/contract/maven/verifier/stubrunner/RemoteStubRunner.java</a></td>
 <td>0</td>
 <td>0</td>
-<td>19</td></tr></table></div>
+<td>18</td></tr></table></div>
 <div class="section">
 <h2><a name="Rules"></a>Rules</h2>
 <table border="0" class="table table-striped">
@@ -374,7 +374,7 @@
 <tr class="a">
 <td>blocks</td>
 <td><a class="externalLink" href="http://checkstyle.sourceforge.net/config_blocks.html#RightCurly">RightCurly</a></td>
-<td>11</td>
+<td>13</td>
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td></tr>
 <tr class="b">
 <td>coding</td>
@@ -384,7 +384,7 @@
 <tr class="a">
 <td></td>
 <td><a class="externalLink" href="http://checkstyle.sourceforge.net/config_coding.html#HiddenField">HiddenField</a></td>
-<td>35</td>
+<td>34</td>
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td></tr>
 <tr class="b">
 <td></td>
@@ -399,7 +399,7 @@
 <tr class="b">
 <td>javadoc</td>
 <td><a class="externalLink" href="http://checkstyle.sourceforge.net/config_javadoc.html#JavadocMethod">JavadocMethod</a></td>
-<td>52</td>
+<td>53</td>
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td></tr>
 <tr class="a">
 <td></td>
@@ -419,7 +419,7 @@
 <tr class="b">
 <td>misc</td>
 <td><a class="externalLink" href="http://checkstyle.sourceforge.net/config_misc.html#FinalParameters">FinalParameters</a></td>
-<td>62</td>
+<td>63</td>
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td></tr>
 <tr class="a">
 <td>naming</td>
@@ -429,7 +429,7 @@
 <tr class="b">
 <td>sizes</td>
 <td><a class="externalLink" href="http://checkstyle.sourceforge.net/config_sizes.html#LineLength">LineLength</a></td>
-<td>235</td>
+<td>241</td>
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td></tr>
 <tr class="a">
 <td></td>
@@ -1172,63 +1172,69 @@
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
+<td>Line is longer than 80 characters (found 81).</td>
+<td>281</td></tr>
+<tr class="b">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>sizes</td>
+<td>LineLength</td>
 <td>Line is longer than 80 characters (found 93).</td>
 <td>282</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 89).</td>
 <td>283</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>286</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter rootPath should be final.</td>
 <td>286</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 98).</td>
 <td>287</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>coding</td>
 <td>AvoidInlineConditionals</td>
 <td>Avoid inline conditionals.</td>
 <td>287</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>291</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter contractsDirectory should be final.</td>
 <td>291</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>coding</td>
 <td>HiddenField</td>
 <td>'contractsDirectory' hides a field.</td>
 <td>291</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>coding</td>
 <td>AvoidInlineConditionals</td>
 <td>Avoid inline conditionals.</td>
 <td>292</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
@@ -1237,271 +1243,271 @@
 <div class="section">
 <h3 id="org.springframework.cloud.contract.maven.verifier.CopyContracts.java">org/springframework/cloud/contract/maven/verifier/CopyContracts.java</h3>
 <table border="0" class="table table-striped">
-<tr class="b">
+<tr class="a">
 <th>Severity</th>
 <th>Category</th>
 <th>Rule</th>
 <th>Message</th>
 <th>Line</th></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocType</td>
 <td>Missing a Javadoc comment.</td>
 <td>34</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>whitespace</td>
 <td>FileTabCharacter</td>
 <td>File contains tab characters (this is the first instance).</td>
 <td>36</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>36</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>naming</td>
 <td>ConstantName</td>
 <td>Name 'log' must match pattern '^[A-Z][A-Z0-9]*(_[A-Z0-9]+)*$'.</td>
 <td>36</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>38</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>40</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>42</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>44</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>46</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter project should be final.</td>
 <td>46</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>coding</td>
 <td>HiddenField</td>
 <td>'project' hides a field.</td>
 <td>46</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter mavenSession should be final.</td>
 <td>46</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>coding</td>
 <td>HiddenField</td>
 <td>'mavenSession' hides a field.</td>
 <td>46</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter mavenResourcesFiltering should be final.</td>
 <td>47</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>coding</td>
 <td>HiddenField</td>
 <td>'mavenResourcesFiltering' hides a field.</td>
 <td>47</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter config should be final.</td>
 <td>48</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>coding</td>
 <td>HiddenField</td>
 <td>'config' hides a field.</td>
 <td>48</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>55</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter contractsDirectory should be final.</td>
 <td>55</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter outputDirectory should be final.</td>
 <td>55</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 98).</td>
 <td>57</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 102).</td>
 <td>58</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 93).</td>
 <td>59</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 89).</td>
 <td>63</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 85).</td>
 <td>65</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 93).</td>
 <td>69</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 82).</td>
 <td>80</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>blocks</td>
 <td>RightCurly</td>
 <td>'}' at column 3 should be on the same line as the next part of a multi-block statement (one that directly contains multiple blocks: if/else-if/else, do/while or try/catch/finally).</td>
 <td>92</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 93).</td>
 <td>98</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>98</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter includedRootFolderAntPattern should be final.</td>
 <td>98</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 85).</td>
 <td>99</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>blocks</td>
 <td>RightCurly</td>
 <td>'}' at column 3 should be on the same line as the next part of a multi-block statement (one that directly contains multiple blocks: if/else-if/else, do/while or try/catch/finally).</td>
 <td>101</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 88).</td>
 <td>102</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 90).</td>
 <td>103</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 91).</td>
 <td>109</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>109</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter includedRootFolderAntPattern should be final.</td>
 <td>109</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 83).</td>
 <td>110</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>blocks</td>
 <td>RightCurly</td>
 <td>'}' at column 3 should be on the same line as the next part of a multi-block statement (one that directly contains multiple blocks: if/else-if/else, do/while or try/catch/finally).</td>
 <td>112</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 90).</td>
 <td>113</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 92).</td>
 <td>114</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>120</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
@@ -1510,210 +1516,264 @@
 <div class="section">
 <h3 id="org.springframework.cloud.contract.maven.verifier.GenerateStubsMojo.java">org/springframework/cloud/contract/maven/verifier/GenerateStubsMojo.java</h3>
 <table border="0" class="table table-striped">
-<tr class="a">
+<tr class="b">
 <th>Severity</th>
 <th>Category</th>
 <th>Rule</th>
 <th>Message</th>
 <th>Line</th></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 85).</td>
 <td>37</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>whitespace</td>
 <td>FileTabCharacter</td>
 <td>File contains tab characters (this is the first instance).</td>
 <td>43</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>46</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>50</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 92).</td>
 <td>57</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>67</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>76</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>79</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>82</td></tr>
+<tr class="b">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>sizes</td>
+<td>LineLength</td>
+<td>Line is longer than 80 characters (found 94).</td>
+<td>86</td></tr>
 <tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 83).</td>
-<td>85</td></tr>
+<td>92</td></tr>
 <tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>design</td>
 <td>DesignForExtension</td>
 <td>Class 'GenerateStubsMojo' looks like designed for extension (can be subclassed), but the method 'execute' does not have javadoc that explains how to do that safely. If class is not designed for extension consider making the class 'GenerateStubsMojo' final or making the method 'execute' static/final/abstract/empty, or adding allowed annotation for the method.</td>
-<td>85</td></tr>
+<td>92</td></tr>
 <tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
-<td>85</td></tr>
+<td>92</td></tr>
 <tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 129).</td>
-<td>88</td></tr>
+<td>95</td></tr>
 <tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 114).</td>
-<td>89</td></tr>
-<tr class="b">
-<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
-<td>sizes</td>
-<td>LineLength</td>
-<td>Line is longer than 80 characters (found 87).</td>
-<td>94</td></tr>
-<tr class="a">
-<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
-<td>javadoc</td>
-<td>JavadocMethod</td>
-<td>Missing a Javadoc comment.</td>
-<td>98</td></tr>
-<tr class="b">
-<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
-<td>misc</td>
-<td>FinalParameters</td>
-<td>Parameter stubsOutputDir should be final.</td>
-<td>98</td></tr>
-<tr class="a">
-<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
-<td>sizes</td>
-<td>LineLength</td>
-<td>Line is longer than 80 characters (found 86).</td>
-<td>101</td></tr>
-<tr class="b">
-<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
-<td>sizes</td>
-<td>LineLength</td>
-<td>Line is longer than 80 characters (found 114).</td>
-<td>103</td></tr>
-<tr class="a">
-<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
-<td>sizes</td>
-<td>LineLength</td>
-<td>Line is longer than 80 characters (found 85).</td>
-<td>105</td></tr>
-<tr class="b">
-<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
-<td>sizes</td>
-<td>LineLength</td>
-<td>Line is longer than 80 characters (found 90).</td>
-<td>107</td></tr>
-<tr class="a">
-<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
-<td>sizes</td>
-<td>LineLength</td>
-<td>Line is longer than 80 characters (found 82).</td>
-<td>109</td></tr>
-<tr class="b">
-<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
-<td>sizes</td>
-<td>LineLength</td>
-<td>Line is longer than 80 characters (found 83).</td>
-<td>110</td></tr>
-<tr class="a">
-<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
-<td>sizes</td>
-<td>LineLength</td>
-<td>Line is longer than 80 characters (found 93).</td>
-<td>112</td></tr>
-<tr class="b">
-<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
-<td>whitespace</td>
-<td>NoWhitespaceAfter</td>
-<td>'{' is followed by whitespace.</td>
-<td>112</td></tr>
-<tr class="a">
-<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
-<td>sizes</td>
-<td>LineLength</td>
-<td>Line is longer than 80 characters (found 99).</td>
-<td>113</td></tr>
-<tr class="b">
-<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
-<td>coding</td>
-<td>AvoidInlineConditionals</td>
-<td>Avoid inline conditionals.</td>
-<td>113</td></tr>
-<tr class="a">
-<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
-<td>sizes</td>
-<td>LineLength</td>
-<td>Line is longer than 80 characters (found 109).</td>
-<td>117</td></tr>
+<td>96</td></tr>
 <tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>blocks</td>
 <td>RightCurly</td>
 <td>'}' at column 3 should be on the same line as the next part of a multi-block statement (one that directly contains multiple blocks: if/else-if/else, do/while or try/catch/finally).</td>
-<td>119</td></tr>
+<td>99</td></tr>
+<tr class="a">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>sizes</td>
+<td>LineLength</td>
+<td>Line is longer than 80 characters (found 95).</td>
+<td>100</td></tr>
+<tr class="b">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>sizes</td>
+<td>LineLength</td>
+<td>Line is longer than 80 characters (found 164).</td>
+<td>102</td></tr>
+<tr class="a">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>blocks</td>
+<td>RightCurly</td>
+<td>'}' at column 3 should be on the same line as the next part of a multi-block statement (one that directly contains multiple blocks: if/else-if/else, do/while or try/catch/finally).</td>
+<td>104</td></tr>
+<tr class="b">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>sizes</td>
+<td>LineLength</td>
+<td>Line is longer than 80 characters (found 94).</td>
+<td>105</td></tr>
+<tr class="a">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>sizes</td>
+<td>LineLength</td>
+<td>Line is longer than 80 characters (found 86).</td>
+<td>106</td></tr>
+<tr class="b">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>sizes</td>
+<td>LineLength</td>
+<td>Line is longer than 80 characters (found 114).</td>
+<td>108</td></tr>
+<tr class="a">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>sizes</td>
+<td>LineLength</td>
+<td>Line is longer than 80 characters (found 87).</td>
+<td>111</td></tr>
+<tr class="b">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>sizes</td>
+<td>LineLength</td>
+<td>Line is longer than 80 characters (found 85).</td>
+<td>115</td></tr>
+<tr class="a">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>javadoc</td>
+<td>JavadocMethod</td>
+<td>Missing a Javadoc comment.</td>
+<td>115</td></tr>
+<tr class="b">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>misc</td>
+<td>FinalParameters</td>
+<td>Parameter stubsOutputDir should be final.</td>
+<td>115</td></tr>
+<tr class="a">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>sizes</td>
+<td>LineLength</td>
+<td>Line is longer than 80 characters (found 85).</td>
+<td>116</td></tr>
+<tr class="b">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>sizes</td>
+<td>LineLength</td>
+<td>Line is longer than 80 characters (found 90).</td>
+<td>118</td></tr>
+<tr class="a">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>sizes</td>
+<td>LineLength</td>
+<td>Line is longer than 80 characters (found 82).</td>
+<td>120</td></tr>
+<tr class="b">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>sizes</td>
+<td>LineLength</td>
+<td>Line is longer than 80 characters (found 83).</td>
+<td>121</td></tr>
+<tr class="a">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>sizes</td>
+<td>LineLength</td>
+<td>Line is longer than 80 characters (found 93).</td>
+<td>123</td></tr>
+<tr class="b">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>whitespace</td>
+<td>NoWhitespaceAfter</td>
+<td>'{' is followed by whitespace.</td>
+<td>123</td></tr>
+<tr class="a">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>sizes</td>
+<td>LineLength</td>
+<td>Line is longer than 80 characters (found 99).</td>
+<td>124</td></tr>
+<tr class="b">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>coding</td>
+<td>AvoidInlineConditionals</td>
+<td>Avoid inline conditionals.</td>
+<td>124</td></tr>
+<tr class="a">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>sizes</td>
+<td>LineLength</td>
+<td>Line is longer than 80 characters (found 109).</td>
+<td>128</td></tr>
+<tr class="b">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>blocks</td>
+<td>RightCurly</td>
+<td>'}' at column 3 should be on the same line as the next part of a multi-block statement (one that directly contains multiple blocks: if/else-if/else, do/while or try/catch/finally).</td>
+<td>130</td></tr>
 <tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 101).</td>
-<td>122</td></tr>
+<td>133</td></tr>
 <tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
-<td>127</td></tr>
+<td>138</td></tr>
+<tr class="a">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>misc</td>
+<td>FinalParameters</td>
+<td>Parameter stubsOutputDir should be final.</td>
+<td>138</td></tr>
+<tr class="b">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>javadoc</td>
+<td>JavadocMethod</td>
+<td>Missing a Javadoc comment.</td>
+<td>142</td></tr>
 <tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
-<td>137</td></tr>
+<td>152</td></tr>
 <tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 84).</td>
-<td>138</td></tr></table></div>
+<td>153</td></tr></table></div>
 <div class="section">
 <h3 id="org.springframework.cloud.contract.maven.verifier.GenerateTestsMojo.java">org/springframework/cloud/contract/maven/verifier/GenerateTestsMojo.java</h3>
 <table border="0" class="table table-striped">
@@ -2735,7 +2795,7 @@
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
-<td>Line is longer than 80 characters (found 89).</td>
+<td>Line is longer than 80 characters (found 93).</td>
 <td>81</td></tr>
 <tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
@@ -2753,219 +2813,213 @@
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
-<td>Parameter failOnNoStubs should be final.</td>
+<td>Parameter failOnNoContracts should be final.</td>
 <td>81</td></tr>
 <tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
-<td>coding</td>
-<td>HiddenField</td>
-<td>'failOnNoStubs' hides a field.</td>
-<td>81</td></tr>
-<tr class="b">
-<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 89).</td>
 <td>92</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 90).</td>
 <td>98</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>98</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter config should be final.</td>
 <td>98</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter defaultContractsDir should be final.</td>
 <td>99</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 87).</td>
 <td>102</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>coding</td>
 <td>AvoidInlineConditionals</td>
 <td>Avoid inline conditionals.</td>
 <td>103</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 88).</td>
 <td>105</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 108).</td>
 <td>107</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 88).</td>
 <td>108</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 98).</td>
 <td>109</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>blocks</td>
 <td>RightCurly</td>
 <td>'}' at column 3 should be on the same line as the next part of a multi-block statement (one that directly contains multiple blocks: if/else-if/else, do/while or try/catch/finally).</td>
 <td>112</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 124).</td>
 <td>115</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 90).</td>
 <td>118</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 97).</td>
 <td>122</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>127</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 95).</td>
 <td>129</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 84).</td>
 <td>130</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>133</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 84).</td>
 <td>134</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 89).</td>
 <td>136</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>139</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 81).</td>
 <td>141</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>144</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 81).</td>
 <td>145</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 81).</td>
 <td>146</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 100).</td>
 <td>147</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 84).</td>
 <td>149</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 84).</td>
 <td>153</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 94).</td>
 <td>156</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>161</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 90).</td>
 <td>164</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 88).</td>
 <td>165</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>coding</td>
 <td>AvoidInlineConditionals</td>
 <td>Avoid inline conditionals.</td>
 <td>165</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
@@ -2974,163 +3028,163 @@
 <div class="section">
 <h3 id="org.springframework.cloud.contract.maven.verifier.PushStubsToScmMojo.java">org/springframework/cloud/contract/maven/verifier/PushStubsToScmMojo.java</h3>
 <table border="0" class="table table-striped">
-<tr class="a">
+<tr class="b">
 <th>Severity</th>
 <th>Category</th>
 <th>Rule</th>
 <th>Message</th>
 <th>Line</th></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>whitespace</td>
 <td>FileTabCharacter</td>
 <td>File contains tab characters (this is the first instance).</td>
 <td>43</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>43</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>47</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 92).</td>
 <td>54</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 89).</td>
 <td>60</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>64</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 84).</td>
 <td>80</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 88).</td>
 <td>81</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 94).</td>
 <td>94</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 87).</td>
 <td>102</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>design</td>
 <td>DesignForExtension</td>
 <td>Class 'PushStubsToScmMojo' looks like designed for extension (can be subclassed), but the method 'execute' does not have javadoc that explains how to do that safely. If class is not designed for extension consider making the class 'PushStubsToScmMojo' final or making the method 'execute' static/final/abstract/empty, or adding allowed annotation for the method.</td>
 <td>107</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 129).</td>
 <td>111</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 119).</td>
 <td>113</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 97).</td>
 <td>117</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 83).</td>
 <td>118</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 81).</td>
 <td>119</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 123).</td>
 <td>120</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 97).</td>
 <td>124</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 88).</td>
 <td>125</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 93).</td>
 <td>126</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>design</td>
 <td>DesignForExtension</td>
 <td>Class 'PushStubsToScmMojo' looks like designed for extension (can be subclassed), but the method 'buildOptions' does not have javadoc that explains how to do that safely. If class is not designed for extension consider making the class 'PushStubsToScmMojo' final or making the method 'buildOptions' static/final/abstract/empty, or adding allowed annotation for the method.</td>
 <td>130</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>130</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 81).</td>
 <td>131</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 81).</td>
 <td>132</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 84).</td>
 <td>133</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
@@ -3139,217 +3193,217 @@
 <div class="section">
 <h3 id="org.springframework.cloud.contract.maven.verifier.RunMojo.java">org/springframework/cloud/contract/maven/verifier/RunMojo.java</h3>
 <table border="0" class="table table-striped">
-<tr class="b">
+<tr class="a">
 <th>Severity</th>
 <th>Category</th>
 <th>Rule</th>
 <th>Message</th>
 <th>Line</th></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>whitespace</td>
 <td>FileTabCharacter</td>
 <td>File contains tab characters (this is the first instance).</td>
 <td>48</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>51</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>53</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>55</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>58</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>61</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 92).</td>
 <td>74</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 84).</td>
 <td>85</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 89).</td>
 <td>105</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 84).</td>
 <td>107</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>117</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>120</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 92).</td>
 <td>121</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter localStubRunner should be final.</td>
 <td>121</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>coding</td>
 <td>HiddenField</td>
 <td>'localStubRunner' hides a field.</td>
 <td>121</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter remoteStubRunner should be final.</td>
 <td>121</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>coding</td>
 <td>HiddenField</td>
 <td>'remoteStubRunner' hides a field.</td>
 <td>121</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>design</td>
 <td>DesignForExtension</td>
 <td>Class 'RunMojo' looks like designed for extension (can be subclassed), but the method 'execute' does not have javadoc that explains how to do that safely. If class is not designed for extension consider making the class 'RunMojo' final or making the method 'execute' static/final/abstract/empty, or adding allowed annotation for the method.</td>
 <td>126</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 83).</td>
 <td>127</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 107).</td>
 <td>130</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 88).</td>
 <td>135</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 94).</td>
 <td>139</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 97).</td>
 <td>141</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 97).</td>
 <td>142</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>blocks</td>
 <td>RightCurly</td>
 <td>'}' at column 3 should be on the same line as the next part of a multi-block statement (one that directly contains multiple blocks: if/else-if/else, do/while or try/catch/finally).</td>
 <td>143</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 88).</td>
 <td>145</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 92).</td>
 <td>146</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 95).</td>
 <td>147</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>blocks</td>
 <td>RightCurly</td>
 <td>'}' at column 4 should be on the same line as the next part of a multi-block statement (one that directly contains multiple blocks: if/else-if/else, do/while or try/catch/finally).</td>
 <td>153</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 103).</td>
 <td>155</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>160</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>blocks</td>
 <td>RightCurly</td>
 <td>'}' at column 3 should be on the same line as the next part of a multi-block statement (one that directly contains multiple blocks: if/else-if/else, do/while or try/catch/finally).</td>
 <td>163</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>169</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>blocks</td>
 <td>RightCurly</td>
 <td>'}' at column 3 should be on the same line as the next part of a multi-block statement (one that directly contains multiple blocks: if/else-if/else, do/while or try/catch/finally).</td>
 <td>176</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
@@ -3358,145 +3412,145 @@
 <div class="section">
 <h3 id="org.springframework.cloud.contract.maven.verifier.stubrunner.AetherStubDownloaderFactory.java">org/springframework/cloud/contract/maven/verifier/stubrunner/AetherStubDownloaderFactory.java</h3>
 <table border="0" class="table table-striped">
-<tr class="b">
+<tr class="a">
 <th>Severity</th>
 <th>Category</th>
 <th>Rule</th>
 <th>Message</th>
 <th>Line</th></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 92).</td>
 <td>45</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>whitespace</td>
 <td>FileTabCharacter</td>
 <td>File contains tab characters (this is the first instance).</td>
 <td>45</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>45</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>naming</td>
 <td>ConstantName</td>
 <td>Name 'log' must match pattern '^[A-Z][A-Z0-9]*(_[A-Z0-9]+)*$'.</td>
 <td>45</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>47</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>49</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>51</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter repoSystem should be final.</td>
 <td>52</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>coding</td>
 <td>HiddenField</td>
 <td>'repoSystem' hides a field.</td>
 <td>52</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter project should be final.</td>
 <td>53</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>coding</td>
 <td>HiddenField</td>
 <td>'project' hides a field.</td>
 <td>53</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 87).</td>
 <td>58</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>design</td>
 <td>DesignForExtension</td>
 <td>Class 'AetherStubDownloaderFactory' looks like designed for extension (can be subclassed), but the method 'build' does not have javadoc that explains how to do that safely. If class is not designed for extension consider making the class 'AetherStubDownloaderFactory' final or making the method 'build' static/final/abstract/empty, or adding allowed annotation for the method.</td>
 <td>58</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>58</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 90).</td>
 <td>61</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter stubRunnerOptions should be final.</td>
 <td>61</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 120).</td>
 <td>63</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 92).</td>
 <td>65</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 88).</td>
 <td>66</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 96).</td>
 <td>67</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 97).</td>
 <td>72</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter location should be final.</td>
 <td>72</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
@@ -3505,12 +3559,18 @@
 <div class="section">
 <h3 id="org.springframework.cloud.contract.maven.verifier.stubrunner.LocalStubRunner.java">org/springframework/cloud/contract/maven/verifier/stubrunner/LocalStubRunner.java</h3>
 <table border="0" class="table table-striped">
-<tr class="b">
+<tr class="a">
 <th>Severity</th>
 <th>Category</th>
 <th>Rule</th>
 <th>Message</th>
 <th>Line</th></tr>
+<tr class="b">
+<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
+<td>javadoc</td>
+<td>JavadocPackage</td>
+<td>Missing package-info.java file.</td>
+<td>1</td></tr>
 <tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>whitespace</td>
@@ -3570,113 +3630,107 @@
 <th>Line</th></tr>
 <tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
-<td>javadoc</td>
-<td>JavadocPackage</td>
-<td>Missing package-info.java file.</td>
-<td>1</td></tr>
-<tr class="a">
-<td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 81).</td>
 <td>40</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>whitespace</td>
 <td>FileTabCharacter</td>
 <td>File contains tab characters (this is the first instance).</td>
 <td>40</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>40</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>naming</td>
 <td>ConstantName</td>
 <td>Name 'log' must match pattern '^[A-Z][A-Z0-9]*(_[A-Z0-9]+)*$'.</td>
 <td>40</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocVariable</td>
 <td>Missing a Javadoc comment.</td>
 <td>42</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>44</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 90).</td>
 <td>45</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter aetherStubDownloaderFactory should be final.</td>
 <td>45</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>coding</td>
 <td>HiddenField</td>
 <td>'aetherStubDownloaderFactory' hides a field.</td>
 <td>45</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>design</td>
 <td>DesignForExtension</td>
 <td>Class 'RemoteStubRunner' looks like designed for extension (can be subclassed), but the method 'run' does not have javadoc that explains how to do that safely. If class is not designed for extension consider making the class 'RemoteStubRunner' final or making the method 'run' static/final/abstract/empty, or adding allowed annotation for the method.</td>
 <td>49</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>javadoc</td>
 <td>JavadocMethod</td>
 <td>Missing a Javadoc comment.</td>
 <td>49</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter options should be final.</td>
 <td>49</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>misc</td>
 <td>FinalParameters</td>
 <td>Parameter repositorySystemSession should be final.</td>
 <td>50</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 88).</td>
 <td>55</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 88).</td>
 <td>57</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
 <td>Line is longer than 80 characters (found 82).</td>
 <td>59</td></tr>
-<tr class="a">
+<tr class="b">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>blocks</td>
 <td>RightCurly</td>
 <td>'}' at column 3 should be on the same line as the next part of a multi-block statement (one that directly contains multiple blocks: if/else-if/else, do/while or try/catch/finally).</td>
 <td>62</td></tr>
-<tr class="b">
+<tr class="a">
 <td><img src="images/icon_error_sml.gif" alt="" />&#160;Error</td>
 <td>sizes</td>
 <td>LineLength</td>
diff --git a/spring-cloud-contract-maven-plugin/checkstyle.rss b/spring-cloud-contract-maven-plugin/checkstyle.rss
index a605288337..26cf0d7b93 100644
--- a/spring-cloud-contract-maven-plugin/checkstyle.rss
+++ b/spring-cloud-contract-maven-plugin/checkstyle.rss
@@ -26,7 +26,7 @@ under the License.
     <copyright>&#169;2016 - 2019 Spring</copyright>
     <item>
       <title>File: 12,
-             Errors: 521,
+             Errors: 530,
              Warnings: 0,
              Infos: 0
       </title>
@@ -69,7 +69,7 @@ under the License.
                   0
                 </td>
                 <td>
-                  86
+                  85
                 </td>
               </tr>
                           <tr>
@@ -83,7 +83,7 @@ under the License.
                   0
                 </td>
                 <td>
-                  33
+                  42
                 </td>
               </tr>
                           <tr>
@@ -139,7 +139,7 @@ under the License.
                   0
                 </td>
                 <td>
-                  19
+                  18
                 </td>
               </tr>
                           <tr>
@@ -181,7 +181,7 @@ under the License.
                   0
                 </td>
                 <td>
-                  8
+                  9
                 </td>
               </tr>
                           <tr>
@@ -209,7 +209,7 @@ under the License.
                   0
                 </td>
                 <td>
-                  98
+                  99
                 </td>
               </tr>
                       </tbody>
diff --git a/spring-cloud-contract-maven-plugin/convert-mojo.html b/spring-cloud-contract-maven-plugin/convert-mojo.html
index 32a4078240..7e22192b89 100644
--- a/spring-cloud-contract-maven-plugin/convert-mojo.html
+++ b/spring-cloud-contract-maven-plugin/convert-mojo.html
@@ -479,14 +479,14 @@ further processing.<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User p
           
 <tr class="a">
             
-<td><b><a href="#failOnNoStubs">failOnNoStubs</a></b></td>
+<td><b><a href="#failOnNoContracts">failOnNoContracts</a></b></td>
             
 <td><tt>boolean</tt></td>
             
 <td><tt>-</tt></td>
             
 <td>When enabled, this flag will tell stub runner to throw an exception
-when no stubs / contracts were found.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>failOnNoStubs</tt>.<br /></td>
+when no stubs / contracts were found.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>failOnNoContracts</tt>.<br /></td>
           </tr>
           
 <tr class="b">
@@ -743,7 +743,7 @@ further processing.</div>
           
 <li><b>Default</b>: <tt>false</tt></li>
         </ul><hr />
-<p><b><a name="failOnNoStubs">failOnNoStubs</a>:</b></p>
+<p><b><a name="failOnNoContracts">failOnNoContracts</a>:</b></p>
         
 <div>When enabled, this flag will tell stub runner to throw an exception
 when no stubs / contracts were found.</div>
@@ -754,7 +754,7 @@ when no stubs / contracts were found.</div>
           
 <li><b>Required</b>: <tt>No</tt></li>
           
-<li><b>User Property</b>: <tt>failOnNoStubs</tt></li>
+<li><b>User Property</b>: <tt>failOnNoContracts</tt></li>
           
 <li><b>Default</b>: <tt>true</tt></li>
         </ul><hr />
diff --git a/spring-cloud-contract-maven-plugin/generateStubs-mojo.html b/spring-cloud-contract-maven-plugin/generateStubs-mojo.html
index 92d1daa260..18e26dc6fe 100644
--- a/spring-cloud-contract-maven-plugin/generateStubs-mojo.html
+++ b/spring-cloud-contract-maven-plugin/generateStubs-mojo.html
@@ -321,6 +321,18 @@ to be executed first.</div>
           
 <tr class="b">
             
+<td><b><a href="#failOnNoContracts">failOnNoContracts</a></b></td>
+            
+<td><tt>boolean</tt></td>
+            
+<td><tt>-</tt></td>
+            
+<td>When enabled, this flag will tell stub runner to throw an exception
+when no stubs / contracts were found.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>failOnNoContracts</tt>.<br /></td>
+          </tr>
+          
+<tr class="a">
+            
 <td><b><a href="#jarSkip">jarSkip</a></b></td>
             
 <td><tt>boolean</tt></td>
@@ -330,7 +342,7 @@ to be executed first.</div>
 <td>Set this to &quot;true&quot; to bypass only JAR creation.<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>spring.cloud.contract.verifier.jar.skip</tt>.<br /></td>
           </tr>
           
-<tr class="a">
+<tr class="b">
             
 <td><b><a href="#outputDirectory">outputDirectory</a></b></td>
             
@@ -341,7 +353,7 @@ to be executed first.</div>
 <td>(no description)<br /><b>Default value is</b>: <tt>${project.build.directory}/stubs</tt>.<br /><b>User property is</b>: <tt>stubsDirectory</tt>.<br /></td>
           </tr>
           
-<tr class="b">
+<tr class="a">
             
 <td><b><a href="#skip">skip</a></b></td>
             
@@ -379,6 +391,21 @@ to be executed first.</div>
           
 <li><b>Required</b>: <tt>No</tt></li>
         </ul><hr />
+<p><b><a name="failOnNoContracts">failOnNoContracts</a>:</b></p>
+        
+<div>When enabled, this flag will tell stub runner to throw an exception
+when no stubs / contracts were found.</div>
+        
+<ul>
+          
+<li><b>Type</b>: <tt>boolean</tt></li>
+          
+<li><b>Required</b>: <tt>No</tt></li>
+          
+<li><b>User Property</b>: <tt>failOnNoContracts</tt></li>
+          
+<li><b>Default</b>: <tt>true</tt></li>
+        </ul><hr />
 <p><b><a name="jarSkip">jarSkip</a>:</b></p>
         
 <div>Set this to &quot;true&quot; to bypass only JAR creation.</div>