bbyars/mountebank

<h1>v<%= releaseVersion %></h1>

<p class='info-icon'>Be sure to keep up with the latest releases by subscribing to the
    <a href='http://mbtest.org/feed'>ATOM feed</a>.</p>

<p class='warning-icon'>mountebank v1.7.0 no longer supports node v0.10 or v0.12. This
corresponds to the node community's <a href='https://github.com/nodejs/LTS#lts-schedule'>LTS schedule</a>.</p>

<h2>New Features</h2>
<ul class='bullet-list'>
    <li>Added an <a href='http://<%= host %>/docs/commandLine#save'><code>mb save</code></a>
    command to persist the existing configuration of imposters</li>
    <li>Added the ability to <a href=''>add latency</a> to saved responses from proxies based
    on the actual time it took to call the downstream endpoint</li>
    <li>Added the ability to override the default response for imposters, including overriding
    the default <code>Connection: close</code> <a href='http://<%= host %>/docs/protocols/http'>http header</a></li>
    <li>Added a <a href='http://<%= host %>/docs/commandLine'><code>--noParse</code></a>
    command line option that prevents parsing config files as templates</li>
    <li>Added a <a href='http://<%= host %>/docs/commandLine'><code>--nologfile</code></a>
    command line parameter to prevent logging to the filesystem</li>
    <li>Allow changing the cipher for <a href='http://<%= host %>/docs/api/proxies'>https proxies</a></li>
</ul>

<h2>Bug Fixes</h2>
<ul class='bullet-list'>
    <li>An <code>xpath exists</code> predicate will return true if the XML tag exists, even if
    it does not have any text data.</li>
    <li>Fix Content-Length header if a <code>decorate</code> behavior changes it from the original</li>
    <li>Fix <code>repeat</code> behavior when used with headers</li>
    <li>Fix <code>repeat</code> behavior so that it loops back to the beginning of the <code>responses</code>
    array when it reaches the end, to keep it consistent with the circular buffer behavior</li>
    <li>Fixed missing documentation, including on the <a href='http://<%= host %>/docs/api/contracts'>
    contracts</a> page</li>
    <li>Don't default to chunked encoding on http proxy calls</li>
</ul>

<p>Many thanks to the following kind folk for help with this release:</p>

<ul class='bullet-list'>
    <li><a href='https://github.com/meare'>Andrew</a></li>
</ul>

<h2>Install</h2>

<pre><code>npm install -g mountebank@<%= releaseVersion %></code></pre>

<p>or:</p>

<table>
    <tr>
        <th>Option</th>
        <th>node.js required?</th>
        <th>sudo required?</th>
        <th>links</th>
        <th>Description</th>
    </tr>
    <tr>
        <td>Self-contained archives</td>
        <td>No</td>
        <td>No</td>
        <td style="min-width: 5em;">
            <ul>
                <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-darwin-x64.tar.gz">osx</a></li>
                <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-linux-x86.tar.gz">linux x86</a></li>
                <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-linux-x64.tar.gz">linux x64</a></li>
                <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-win-x86.zip">win x86<sup>*</sup></a></li>
                <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-win-x64.zip">win x64<sup>*</sup></a></li>
            </ul>
        </td>
        <td>Simply unpack and run <code>mb</code> from inside</td>
    </tr>
    <tr>
        <td>OS-specific packages</td>
        <td>No</td>
        <td>Yes</td>
        <td>
            <ul>
                <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>.pkg">pkg</a></li>
                <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-<%= releaseVersion %>-1.x86_64.rpm">rpm</a></li>
                <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank_<%= releaseVersion %>_amd64.deb">deb</a></li>
            </ul>
        </td>
        <td>Puts <code>mb</code> at <code>/usr/local/bin</code>, which is generally in the <code>PATH</code>.</td>
    </tr>
    <tr>
        <td>source tarball</td>
        <td>Yes</td>
        <td>No</td>
        <td>
            <ul>
                <li><a href="https://s3.amazonaws.com/mountebank/v<%= releaseMajorMinor %>/mountebank-v<%= releaseVersion %>-npm.tar.gz">mb</a></li>
            </ul>
        </td>
        <td>source tarball if you roll that way.</td>
    </tr>
</table>

<h2 id='windows-path-limitations'>Windows path limitations</h2>

<p><sup>*</sup>mountebank wishes very much for your Windows experience to be hassle-free, but he is simply not qualified to address
    a particular constraint of Windows Explorer.  For legacy reasons, some Windows applications, including most notably Windows Explorer,
    have a maximum number of characters allowed in a path of 260 characters.  As mountebank writes these words, the longest path he
    includes in the zip files is around 175 characters.  The zip file name, which is likely to represent itself as <i>two</i>
    nested directories if you use the defaults to unzip it, will be around 25 characters.  That gives you very little wiggle room.
    If you unzip the file in your users directory, you may very likely get an error because of this constraint.</p>

<p>The following solutions will all work:</p>

<ul class='bullet-list'>
    <li>Unzip to the root of your C: drive (or a similar small path)</li>
    <li>Use <a href='http://www.7-zip.org/'>7zip</a> to unzip the file instead of Windows Explorer</li>
    <li>Use <code>npm</code> to install mountebank instead of the zip file</li>
</ul>