{% extends "docs/base.html" %}

{% block docs_content %}
  <div class="d-flex flex-wrap align-items-center justify-content-between gap-2 mb-4">
    <div>
      <h1 class="h3 mb-1">File uploads</h1>
      <p class="text-muted mb-0">CLI commands for repo-scoped file uploads.</p>
    </div>
    <div class="d-flex flex-wrap gap-2">
      <a class="btn btn-sm btn-outline-secondary active" href="/docs/cli/file-uploads">Overview</a>
      <a class="btn btn-sm btn-outline-secondary" href="/docs/cli/list-file-uploads">List</a>
      <a class="btn btn-sm btn-outline-secondary" href="/docs/cli/get-file-upload">Get</a>
      <a class="btn btn-sm btn-outline-secondary" href="/docs/cli/create-file-upload">Create</a>
      <a class="btn btn-sm btn-outline-secondary" href="/docs/cli/update-file-upload">Update</a>
      <a class="btn btn-sm btn-outline-secondary" href="/docs/cli/delete-file-upload">Delete</a>
      <a class="btn btn-sm btn-outline-secondary" href="/docs/cli/download-file-upload-content">Content</a>
    </div>
  </div>

  <div class="card shadow-sm mb-4">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Sections</h2>
      <div class="list-group list-group-flush">
        <a class="list-group-item list-group-item-action" href="/docs/cli/list-file-uploads">List file uploads</a>
        <a class="list-group-item list-group-item-action" href="/docs/cli/get-file-upload">Get file upload</a>
        <a class="list-group-item list-group-item-action" href="/docs/cli/create-file-upload">Create file upload</a>
        <a class="list-group-item list-group-item-action" href="/docs/cli/update-file-upload">Update file upload</a>
        <a class="list-group-item list-group-item-action" href="/docs/cli/delete-file-upload">Delete file upload</a>
        <a class="list-group-item list-group-item-action" href="/docs/cli/download-file-upload-content">Download file upload content</a>
      </div>
    </div>
  </div>

  <div class="card shadow-sm mb-4">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Commands</h2>
      <ul class="mb-0">
        <li><code>list-file-uploads</code></li>
        <li><code>get-file-upload</code></li>
        <li><code>create-file-upload</code></li>
        <li><code>list-file-upload-groups</code>, <code>get-file-upload-group</code>, <code>create-file-upload-group</code>, and <code>update-file-upload-group</code></li>
        <li><code>update-file-upload</code></li>
        <li><code>delete-file-upload</code></li>
        <li><code>download-file-upload-content</code></li>
        <li><a href="/docs/cli/attachments"><code>attach-file</code> and <code>detach-file</code></a></li>
      </ul>
    </div>
  </div>

  <div class="card shadow-sm mb-4">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Examples</h2>
      <div class="bg-light border rounded p-3">
        <pre class="mb-0"><code>pearing-cli list-file-uploads teams/platform/website
pearing-cli create-file-upload website \
  --file ./screenshot.png \
  --description "Build screenshot"
pearing-cli create-file-upload-group website \
  --file ./before.png \
  --file ./after.png \
  --name "Before and after"
pearing-cli download-file-upload-content website a1b2c3d4-... --output ./screenshot.png</code></pre>
      </div>
    </div>
  </div>

  <div class="card shadow-sm mb-4">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Help Output</h2>
      <div class="bg-light border rounded p-3">
        <pre class="mb-0"><code>list-file-uploads &lt;REPO&gt;
get-file-upload &lt;REPO&gt; &lt;UUID&gt;
create-file-upload [OPTIONS] --file &lt;FILE&gt; &lt;REPO&gt;
list-file-upload-groups &lt;REPO&gt;
get-file-upload-group &lt;REPO&gt; &lt;UUID&gt;
create-file-upload-group [OPTIONS] --file &lt;FILE&gt;... &lt;REPO&gt;
update-file-upload-group [OPTIONS] &lt;REPO&gt; &lt;UUID&gt;
update-file-upload [OPTIONS] &lt;REPO&gt; &lt;UUID&gt;
delete-file-upload &lt;REPO&gt; &lt;UUID&gt;
download-file-upload-content [OPTIONS] &lt;REPO&gt; &lt;UUID&gt;</code></pre>
      </div>
    </div>
  </div>

  <div class="card shadow-sm">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Notes</h2>
      <ul class="mb-0">
        <li><code>create-file-upload</code> reads a local file and uploads it as multipart form data.</li>
        <li><code>create-file-upload-group</code> requires at least two repeatable <code>--file</code> values. It preserves their order and fails without creating any members if a configured limit or write fails.</li>
        <li><code>download-file-upload-content</code> writes the stored bytes to stdout unless <code>--output</code> is set.</li>
        <li>Deletes are permanent from the caller's perspective; the underlying soft-delete is an implementation detail.</li>
        <li>Use <a href="/docs/cli/attachments"><code>attach-file</code></a> to associate an upload with content after creating it.</li>
      </ul>
    </div>
  </div>
{% endblock %}