Deployed bf85c94 with MkDocs version: 1.6.1

guide/cli-reference/index.html

@@ -2923,7 +2923,7 @@
 </tr>
 <tr>
 <td><code>--no-proxy-download</code></td>
-<td>Bypass the proxy for <strong>segment downloads only</strong> (manifest, licence, and auth stay proxied).</td>
+<td>Bypass the proxy for <strong>all downloads</strong> (manifest, licence, and auth stay proxied).</td>
 </tr>
 <tr>
 <td><code>--remote</code></td>

guide/downloading/index.html

@@ -3117,7 +3117,7 @@ configured proxy providers), or a <code>provider:region</code> form.</p>
 <p>Two related flags:</p>
 <ul>
 <li><code>--no-proxy</code>: force-disable all proxy use for this run.</li>
-<li><code>--no-proxy-download</code>: bypass the proxy for <strong>segment downloads only</strong>. The manifest,
+<li><code>--no-proxy-download</code>: bypass the proxy for <strong>all downloads</strong>. The manifest,
   license, and authentication requests still go through the proxy. This is useful when the
   proxy is only needed to satisfy geo-checks, not to move the bulk of the data.</li>
 </ul>

guide/proxies-and-vpn/index.html

@@ -2185,7 +2185,7 @@ file lives and how it is loaded.</p>
 </tr>
 <tr>
 <td><code>--no-proxy-download</code></td>
-<td>Use the proxy for the manifest, licence, and authentication, but bypass it for the <strong>segment downloads</strong> themselves.</td>
+<td>Use the proxy for the manifest, licence, and authentication, but bypass it for the <strong>downloads</strong> themselves.</td>
 </tr>
 </tbody>
 </table>
@@ -2205,7 +2205,7 @@ do not have to pass it on every command. See
 <p>Segment downloads are usually the largest share of traffic, and a residential-grade VPN
 proxy is often the slowest link in the chain. <code>--no-proxy-download</code> lets you keep the
 proxy where it matters (passing the geo-check for the manifest and the licence) while
-pulling the actual audio and video segments over your normal connection for full speed.</p>
+pulling the files themselves over your normal connection at full speed.</p>
 <div class="language-shell highlight"><span class="filename">Proxy the manifest and licence, download segments direct</span><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>unshackle<span class="w"> </span>dl<span class="w"> </span>--proxy<span class="w"> </span>gb<span class="w"> </span>--no-proxy-download<span class="w"> </span>EXAMPLE<span class="w"> </span>10a1234
 </span></code></pre></div>
 <div class="admonition warning">

reference/api/tracks/index.html

@@ -1583,6 +1583,17 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#unshackle.core.tracks.Attachment.download" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <code class="doc-symbol doc-symbol-toc doc-symbol-method"></code>&nbsp;download
+      
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -2605,6 +2616,17 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#unshackle.core.tracks.Attachment.download" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <code class="doc-symbol doc-symbol-toc doc-symbol-method"></code>&nbsp;download
+      
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -3574,7 +3596,7 @@
 
         <p>Create a new Attachment.</p>
 <p>If providing a path, the file must already exist.
-If providing a URL, the file will be downloaded to the temp directory.
+If providing a URL, download() fetches the file during the download phase.
 Either path or url must be provided.</p>
 <p>If name is not provided it will use the file name (without extension).
 If mime_type is not provided, it will try to guess it.</p>
@@ -3676,7 +3698,7 @@ If mime_type is not provided, it will try to guess it.</p>
                 <code>session</code>
             </td>
             <td>
-                  <code><span title="typing.Optional">Optional</span>[<span title="requests.Session">Session</span>]</code>
+                  <code><span title="typing.Optional">Optional</span>[<span title="unshackle.core.tracks.attachment.AnySession">AnySession</span>]</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -3735,6 +3757,26 @@ If mime_type is not provided, it will try to guess it.</p>
 
 
 
+<div class="doc doc-object doc-function">
+
+
+<h3 id="unshackle.core.tracks.Attachment.download" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">download</span>
+
+
+<a href="#unshackle.core.tracks.Attachment.download" class="headerlink" title="Permanent link">&para;</a></h3>
+<div class="language-python doc-signature highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nf">download</span><span class="p">(</span><span class="n">session</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">no_proxy_download</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+</span></code></pre></div>
+
+    <div class="doc doc-contents ">
+
+        <p>Download a URL-backed attachment to the temp directory.</p>
+
+
+    </div>
+
+</div>
+
 <div class="doc doc-object doc-function">
 
 
@@ -3861,7 +3903,7 @@ If mime_type is not provided, it will try to guess it.</p>
                 <code>session</code>
             </td>
             <td>
-                  <code><span title="typing.Optional">Optional</span>[<span title="requests.Session">Session</span>]</code>
+                  <code><span title="typing.Optional">Optional</span>[<span title="unshackle.core.tracks.attachment.AnySession">AnySession</span>]</code>
             </td>
             <td>
               <div class="doc-md-description">