toss-cli 1.0.0__py3-none-any.whl

toss_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"

toss_cli/__main__.py

@@ -0,0 +1,4 @@
+from toss_cli.cli import main
+
+if __name__ == "__main__":
+    main()

toss_cli/cli.py

@@ -0,0 +1,96 @@
+import argparse
+import sys
+
+from toss_cli.config import init_config, load_config
+from toss_cli.deploy import deploy
+from toss_cli.remote import get_listings, hide_slug, undeploy_slug, unhide_slug
+from toss_cli.ssh import validate_slug
+
+
+def _cmd_list() -> None:
+    config = load_config()
+    entries = get_listings(config)
+    if not entries:
+        print("No deployments found.")
+        return
+    col = max(len(slug) for slug, _, _ in entries)
+    col = max(col, 4)
+    domain = config["domain"]
+    print(f"{'SLUG':<{col}}  {'LINK':<{len(domain) + col + 2}}  SIZE")
+    print("-" * (col + len(domain) + col + 12))
+    for slug, hidden, size in sorted(entries):
+        link = "[hidden]" if hidden else f"{domain}/{slug}/"
+        print(f"{slug:<{col}}  {link:<{len(domain) + col + 2}}  {size}")
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        prog="toss",
+        description="Deploy static sites, HTML, and Markdown to your own server.",
+    )
+    subparsers = parser.add_subparsers(dest="command")
+
+    subparsers.add_parser("init", help="interactive configuration setup")
+
+    p_deploy = subparsers.add_parser("deploy", help="deploy a file or directory")
+    p_deploy.add_argument("path", nargs="?", help="file or directory to deploy")
+    p_deploy.add_argument("--slug", help="custom slug (default: random)")
+    p_deploy.add_argument("--build", metavar="CMD", help="run a build command first")
+    p_deploy.add_argument("--out", metavar="DIR", help="build output directory (with --build)")
+
+    subparsers.add_parser("list", help="list all deployments")
+
+    p_hide = subparsers.add_parser("hide", help="make a deployment inaccessible")
+    p_hide.add_argument("slug")
+
+    p_unhide = subparsers.add_parser("unhide", help="restore a hidden deployment")
+    p_unhide.add_argument("slug")
+
+    p_undeploy = subparsers.add_parser("undeploy", help="permanently delete a deployment")
+    p_undeploy.add_argument("slug")
+
+    args = parser.parse_args()
+
+    if args.command is None:
+        parser.print_help()
+        sys.exit(1)
+
+    try:
+        if args.command == "init":
+            init_config()
+
+        elif args.command == "deploy":
+            if not args.build and not args.path:
+                p_deploy.error("path is required unless --build is specified")
+            url = deploy(path=args.path, slug=args.slug, build_cmd=args.build, out_dir=args.out)
+            print(url)
+
+        elif args.command == "list":
+            _cmd_list()
+
+        elif args.command == "hide":
+            validate_slug(args.slug)
+            hide_slug(load_config(), args.slug)
+            print(f"Hidden: {args.slug}")
+
+        elif args.command == "unhide":
+            validate_slug(args.slug)
+            unhide_slug(load_config(), args.slug)
+            print(f"Restored: {args.slug}")
+
+        elif args.command == "undeploy":
+            validate_slug(args.slug)
+            answer = input(f"Permanently delete '{args.slug}'? [y/N] ").strip().lower()
+            if answer != "y":
+                print("Cancelled.")
+                return
+            undeploy_slug(load_config(), args.slug)
+            print(f"Deleted: {args.slug}")
+
+    except (FileNotFoundError, RuntimeError, ValueError) as e:
+        print(f"error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

toss_cli/config.py

@@ -0,0 +1,101 @@
+import shutil
+import time
+from pathlib import Path
+
+import tomllib
+
+from toss_cli.ssh import run_ssh
+
+CONFIG_PATH = Path.home() / ".config" / "toss" / "config.toml"
+
+DEFAULTS: dict[str, object] = {
+    "remote_path": "/srv/sites",
+    "slug_length": 6,
+}
+
+
+REQUIRED_KEYS = ("host", "domain", "remote_path", "slug_length")
+
+
+def load_config() -> dict[str, object]:
+    if not CONFIG_PATH.exists():
+        raise FileNotFoundError("no config found - run `toss init` to set up")
+    with open(CONFIG_PATH, "rb") as f:
+        config = tomllib.load(f)
+    missing = [k for k in REQUIRED_KEYS if k not in config]
+    if missing:
+        raise ValueError(f"config missing required keys: {', '.join(missing)}\nrun `toss init` to fix your configuration.")
+    return config
+
+
+def _check_tools() -> None:
+    missing = [t for t in ("rsync", "ssh") if shutil.which(t) is None]
+    if missing:
+        raise RuntimeError(
+            f"Missing the following dependencies: {', '.join(missing)}\nPlease them via your system package manager (e.g. apt install rsync openssh-client)."
+        )
+
+
+def _prompt(label: str, default: str | int | None = None) -> str:
+    hint = f" [{default}]" if default is not None else ""
+    while True:
+        value = input(f"{label}{hint}: ").strip()
+        if value:
+            return value
+        if default is not None:
+            return str(default)
+        print(f"  {label} is required")
+
+
+def _validate_ssh(host: str) -> tuple[bool, float, str]:
+    start = time.monotonic()
+    result = run_ssh(host, "exit", opts=["-q", "-o", "ConnectTimeout=5", "-o", "BatchMode=yes"])
+    elapsed = time.monotonic() - start
+    return result.returncode == 0, elapsed, result.stderr.strip()
+
+
+def _toml_str(value: str) -> str:
+    return '"' + value.replace("\\", "\\\\").replace('"', '\\"') + '"'
+
+
+def init_config() -> None:
+    _check_tools()
+
+    print("=== toss init - interactive configuration ===\n")
+
+    existing: dict[str, object] = {}
+    if CONFIG_PATH.exists():
+        with open(CONFIG_PATH, "rb") as f:
+            existing = tomllib.load(f)
+        print(f"A config file was found at {CONFIG_PATH}, spam enter to keep current values\n")
+
+    host = _prompt("SSH host (e.g. user@myserver)", existing.get("host"))
+    domain = _prompt("domain (e.g. share.mydomain.com)", existing.get("domain"))
+    remote_path = _prompt("remote path", existing.get("remote_path", DEFAULTS["remote_path"]))
+    slug_length_raw = _prompt("slug length", existing.get("slug_length", DEFAULTS["slug_length"]))
+
+    try:
+        slug_length = int(slug_length_raw)
+        if slug_length < 2:
+            print("Warning: slug length below 2 risks frequent collisions.")
+    except ValueError:
+        print("Warning: invalid slug length, using default (6).")
+        slug_length = 6
+
+    print(f"\nTesting SSH connection to {host}...")
+    ok, elapsed, err = _validate_ssh(host)
+    if ok:
+        print(f"SSH connection OK! ({elapsed:.2f}s)")
+    else:
+        print(f"Warning: could not connect to {host}. Saving config anyway.")
+        if err:
+            print(f"  {err}")
+
+    CONFIG_PATH.parent.mkdir(parents=True, exist_ok=True)
+    with open(CONFIG_PATH, "w", encoding="utf-8") as f:
+        f.write(f"host = {_toml_str(host)}\n")
+        f.write(f"domain = {_toml_str(domain)}\n")
+        f.write(f"remote_path = {_toml_str(remote_path)}\n")
+        f.write(f"slug_length = {slug_length}\n")
+
+    print(f"\nConfig saved to {CONFIG_PATH}")

toss_cli/deploy.py

@@ -0,0 +1,106 @@
+import random
+import shutil
+import string
+import subprocess
+import tempfile
+from pathlib import Path
+
+from toss_cli import remote, templates
+from toss_cli.ssh import validate_slug
+
+_BUILD_OUT_DIRS = ("dist", "build", "out", "public")
+
+
+def _random_slug(length: int) -> str:
+    chars = string.ascii_lowercase + string.digits
+    return "".join(random.choices(chars, k=length))
+
+
+def _find_free_slug(config: dict) -> str:
+    for _ in range(5):
+        slug = _random_slug(config["slug_length"])
+        if not remote.check_slug_exists(config, slug):
+            return slug
+    raise RuntimeError("Could not find a free slug after 5 attempts, try again")
+
+
+def _detect_input(path: Path) -> str:
+    if path.is_dir():
+        return "directory"
+    if path.suffix == ".md":
+        return "md"
+    if path.suffix in (".html", ".htm"):
+        return "html"
+    raise ValueError(f"Unsupported file type: {path.suffix} (expected .md, .html, or a directory)")
+
+
+def _prepare_build(cmd: str, out_dir: str | None) -> Path:
+    result = subprocess.run(cmd, shell=True)
+    if result.returncode != 0:
+        raise RuntimeError(f"Build command failed with exit code {result.returncode}")
+    if out_dir:
+        p = Path(out_dir)
+        if not p.is_dir():
+            raise RuntimeError(f"--out directory not found: {out_dir}")
+        return p
+    for name in _BUILD_OUT_DIRS:
+        p = Path(name)
+        if p.is_dir():
+            return p
+    raise RuntimeError("Build succeeded but no output directory found, use --out")
+
+
+def deploy(
+    path: str,
+    slug: str | None = None,
+    build_cmd: str | None = None,
+    out_dir: str | None = None,
+) -> str:
+    from toss_cli.config import load_config
+
+    config = load_config()
+
+    # build mode
+    if build_cmd:
+        local_dir = _prepare_build(build_cmd, out_dir)
+        input_type = "directory"
+    else:
+        p = Path(path)
+        if not p.exists():
+            raise FileNotFoundError(f"Path not found: {path}")
+        input_type = _detect_input(p)
+        local_dir = None
+
+    # resolve slug
+    if slug:
+        validate_slug(slug)
+        if remote.check_slug_exists(config, slug):
+            answer = input(f"'{slug}' is already taken, overwrite? [y/N] ").strip().lower()
+            if answer != "y":
+                raise RuntimeError("Deploy cancelled")
+    else:
+        slug = _find_free_slug(config)
+
+    # prepare local staging dir
+    tmp = None
+    try:
+        if input_type == "md":
+            md_text = Path(path).read_text(encoding="utf-8")
+            title = Path(path).stem.replace("-", " ").replace("_", " ").title()
+            html = templates.render_page(title, md_text)
+            tmp = tempfile.mkdtemp()
+            Path(tmp, "index.html").write_text(html, encoding="utf-8")
+            local_dir = tmp
+        elif input_type == "html":
+            tmp = tempfile.mkdtemp()
+            shutil.copy(Path(path), Path(tmp, "index.html"))
+            local_dir = tmp
+        else:
+            local_dir = str(local_dir or path)
+
+        remote.rsync_deploy(config, str(local_dir), slug)
+    finally:
+        if tmp:
+            shutil.rmtree(tmp, ignore_errors=True)
+
+    return f"https://{config['domain']}/{slug}/"

toss_cli/remote.py

@@ -0,0 +1,92 @@
+import shlex
+import subprocess
+from pathlib import PurePosixPath
+
+from toss_cli.ssh import run_ssh
+
+
+def _q(path) -> str:
+    return shlex.quote(str(path))
+
+
+def check_slug_exists(config: dict, slug: str) -> bool:
+    remote = PurePosixPath(config["remote_path"]) / slug
+    result = run_ssh(config["host"], f"test -d {_q(remote)}")
+    return result.returncode == 0
+
+
+def _check_hidden_exists(config: dict, slug: str) -> bool:
+    remote = PurePosixPath(config["remote_path"]) / f".{slug}"
+    result = run_ssh(config["host"], f"test -d {_q(remote)}")
+    return result.returncode == 0
+
+
+def get_listings(config: dict) -> list[tuple[str, bool, str]]:
+    """Return [(slug, is_hidden, size)] for all deployments."""
+    remote = _q(config["remote_path"])
+    cmd = f"find {remote} -mindepth 1 -maxdepth 1 -type d | xargs -I{{}} du -sh {{}} 2>/dev/null"
+    result = run_ssh(config["host"], cmd)
+    if result.returncode != 0 and result.stderr.strip():
+        raise RuntimeError(f"List failed: {result.stderr.strip()}")
+
+    entries = []
+    for line in result.stdout.splitlines():
+        line = line.strip()
+        if not line:
+            continue
+        size, path = line.split("\t", 1)
+        name = PurePosixPath(path).name
+        if name.startswith("."):
+            entries.append((name[1:], True, size))
+        else:
+            entries.append((name, False, size))
+    return entries
+
+
+def hide_slug(config: dict, slug: str) -> None:
+    if _check_hidden_exists(config, slug):
+        raise ValueError(f"'{slug}' is already hidden")
+    if not check_slug_exists(config, slug):
+        raise ValueError(f"'{slug}' not found")
+    base = PurePosixPath(config["remote_path"])
+    result = run_ssh(config["host"], f"mv {_q(base / slug)} {_q(base / ('.' + slug))}")
+    if result.returncode != 0:
+        raise RuntimeError(f"Hide failed: {result.stderr.strip()}")
+
+
+def unhide_slug(config: dict, slug: str) -> None:
+    if check_slug_exists(config, slug):
+        raise ValueError(f"'{slug}' is already visible")
+    if not _check_hidden_exists(config, slug):
+        raise ValueError(f"'{slug}' not found")
+    base = PurePosixPath(config["remote_path"])
+    result = run_ssh(config["host"], f"mv {_q(base / ('.' + slug))} {_q(base / slug)}")
+    if result.returncode != 0:
+        raise RuntimeError(f"Unhide failed: {result.stderr.strip()}")
+
+
+def undeploy_slug(config: dict, slug: str) -> None:
+    if not check_slug_exists(config, slug) and not _check_hidden_exists(config, slug):
+        raise ValueError(f"'{slug}' not found")
+    base = PurePosixPath(config["remote_path"])
+    # remove whichever form exists (visible or hidden)
+    target = base / (f".{slug}" if _check_hidden_exists(config, slug) else slug)
+    result = run_ssh(config["host"], f"rm -rf {_q(target)}")
+    if result.returncode != 0:
+        raise RuntimeError(f"Undeploy failed: {result.stderr.strip()}")
+
+
+def rsync_deploy(config: dict, local_dir: str, slug: str) -> None:
+    remote_dest = f"{config['host']}:{config['remote_path']}/{slug}/"
+    result = subprocess.run(
+        ["rsync", "-az", "--delete", "-e", "ssh", f"{local_dir}/", remote_dest],
+        stderr=subprocess.PIPE,
+        text=True,
+    )
+    if result.returncode != 0:
+        stderr = result.stderr.strip()
+        if "Permission denied" in stderr:
+            raise RuntimeError(f"Deploy failed: permission denied on remote\n  {stderr}")
+        if "Connection refused" in stderr or "No route to host" in stderr:
+            raise RuntimeError(f"Deploy failed: could not reach host\n  {stderr}")
+        raise RuntimeError(f"Deploy failed\n  {stderr}")

toss_cli/ssh.py

@@ -0,0 +1,17 @@
+import re
+import subprocess
+
+_SLUG_RE = re.compile(r"^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$")
+
+
+def validate_slug(slug: str) -> None:
+    if not _SLUG_RE.match(slug):
+        raise ValueError(f"Invalid slug '{slug}': use lowercase letters, digits, and hyphens only")
+
+
+def run_ssh(host: str, cmd: str, opts: list[str] | None = None) -> subprocess.CompletedProcess:
+    return subprocess.run(
+        ["ssh", *(opts or []), host, cmd],
+        capture_output=True,
+        text=True,
+    )

toss_cli/templates/__init__.py

@@ -0,0 +1,8 @@
+import html
+import json
+from importlib.resources import files
+
+
+def render_page(title: str, content: str) -> str:
+    template = files(__name__).joinpath("markdown_page.html").read_text(encoding="utf-8")
+    return template.replace("TOSS_TITLE", html.escape(title)).replace("TOSS_CONTENT", json.dumps(content))

toss_cli/templates/markdown_page.html

@@ -0,0 +1,163 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>TOSS_TITLE</title>
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16/dist/katex.min.css">
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.9.0/build/styles/monokai-sublime.min.css">
+  <style>
+    body {
+      max-width: 740px;
+      margin: 4rem auto;
+      padding: 0 1.5rem;
+      font-family: Georgia, 'Times New Roman', serif;
+      font-size: 1.1rem;
+      line-height: 1.7;
+      color: #f8f8f2;
+      background: #272822;
+    }
+    h1, h2, h3, h4, h5, h6 {
+      font-family: system-ui, sans-serif;
+      line-height: 1.3;
+      margin-top: 2rem;
+      color: #f8f8f2;
+    }
+    a { color: #66d9ef; }
+    a:hover { color: #ae81ff; }
+    code {
+      font-family: 'SF Mono', 'Fira Code', 'JetBrains Mono', monospace;
+      font-size: 0.88em;
+      background: #3e3d32;
+      padding: 0.15em 0.35em;
+      border-radius: 3px;
+      color: #a6e22e;
+    }
+    pre {
+      border-radius: 6px;
+      overflow-x: auto;
+      margin: 1.5rem 0;
+    }
+    pre code {
+      font-family: 'SF Mono', 'Fira Code', 'JetBrains Mono', monospace;
+      font-size: 0.9em;
+      background: none;
+      padding: 0;
+      border-radius: 0;
+      color: inherit;
+    }
+    blockquote {
+      border-left: 3px solid #75715e;
+      margin: 0;
+      padding-left: 1.25rem;
+      color: #75715e;
+    }
+    hr { border-color: #3e3d32; }
+    img { max-width: 100%; }
+    table { border-collapse: collapse; width: 100%; }
+    th, td {
+      border: 1px solid #3e3d32;
+      padding: 0.5rem 0.75rem;
+      text-align: left;
+    }
+    th { background: #3e3d32; color: #a6e22e; }
+    /* footnotes */
+    .footnotes { margin-top: 3rem; border-top: 1px solid #3e3d32; padding-top: 1rem; font-size: 0.9em; color: #75715e; }
+    .footnotes a { color: #75715e; }
+    sup a { color: #ae81ff; text-decoration: none; }
+    /* callout blocks */
+    .markdown-alert {
+      padding: 0.75rem 1rem;
+      border-left: 4px solid;
+      border-radius: 0 6px 6px 0;
+      margin: 1.5rem 0;
+    }
+    .markdown-alert p { margin: 0; }
+    .markdown-alert-title {
+      font-weight: bold;
+      font-family: system-ui, sans-serif;
+      font-size: 0.9em;
+      margin-bottom: 0.4rem;
+      display: flex;
+      align-items: center;
+      gap: 0.4rem;
+    }
+    .markdown-alert-title svg { fill: currentColor; }
+    .markdown-alert-note      { border-color: #66d9ef; background: #1a2a2e; }
+    .markdown-alert-note      .markdown-alert-title { color: #66d9ef; }
+    .markdown-alert-tip       { border-color: #a6e22e; background: #1e2a1a; }
+    .markdown-alert-tip       .markdown-alert-title { color: #a6e22e; }
+    .markdown-alert-important { border-color: #ae81ff; background: #1e1a2e; }
+    .markdown-alert-important .markdown-alert-title { color: #ae81ff; }
+    .markdown-alert-warning   { border-color: #e6db74; background: #2a2a1a; }
+    .markdown-alert-warning   .markdown-alert-title { color: #e6db74; }
+    .markdown-alert-caution   { border-color: #f92672; background: #2a1a1e; }
+    .markdown-alert-caution   .markdown-alert-title { color: #f92672; }
+    /* mermaid diagrams */
+    .mermaid { margin: 1.5rem 0; text-align: center; }
+    @media print {
+      body { max-width: 100%; margin: 0; background: white; color: black; }
+      a { color: inherit; text-decoration: none; }
+    }
+  </style>
+</head>
+<body>
+  <div id="content"></div>
+  <script src="https://cdn.jsdelivr.net/npm/marked@15/marked.min.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/marked-footnote/dist/index.umd.min.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/marked-alert/dist/index.umd.min.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/katex@0.16/dist/katex.min.js"></script>
+  <script src="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.9.0/build/highlight.min.js"></script>
+  <script>
+    function extractMath(md) {
+      const blocks = [];
+      md = md.replace(/\$\$([\s\S]+?)\$\$/g, (_, content) => {
+        return "TOSS_MATH_" + (blocks.push({ content, display: true }) - 1) + "_END";
+      });
+      md = md.replace(/\$([^\n$]+?)\$/g, (_, content) => {
+        return "TOSS_MATH_" + (blocks.push({ content, display: false }) - 1) + "_END";
+      });
+      return { md, blocks };
+    }
+
+    function restoreMath(el, blocks) {
+      const walker = document.createTreeWalker(el, NodeFilter.SHOW_TEXT);
+      const nodes = [];
+      while (walker.nextNode()) nodes.push(walker.currentNode);
+      for (const node of nodes) {
+        if (!node.textContent.includes("TOSS_MATH_")) continue;
+        const span = document.createElement("span");
+        span.innerHTML = node.textContent.replace(/TOSS_MATH_(\d+)_END/g, (_, i) => {
+          const { content, display } = blocks[i];
+          return katex.renderToString(content, { displayMode: display, throwOnError: false });
+        });
+        node.parentNode.replaceChild(span, node);
+      }
+    }
+
+    marked.use(markedFootnote());
+    marked.use(markedAlert());
+    marked.use({
+      renderer: {
+        code(token) {
+          if (token.lang === "mermaid") {
+            return `<pre class="mermaid">${token.text}</pre>`;
+          }
+          return false;
+        }
+      }
+    });
+
+    const MARKDOWN = TOSS_CONTENT;
+    const { md, blocks } = extractMath(MARKDOWN);
+    document.getElementById("content").innerHTML = marked.parse(md);
+    restoreMath(document.getElementById("content"), blocks);
+    document.querySelectorAll("pre code").forEach(block => hljs.highlightElement(block));
+  </script>
+  <script type="module">
+    import mermaid from "https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs";
+    mermaid.initialize({ startOnLoad: false, theme: "dark" });
+    mermaid.run();
+  </script>
+</body>
+</html>

toss_cli-1.0.0.dist-info/METADATA

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: toss-cli
+Version: 1.0.0
+Summary: Minimal CLI to deploy and share static sites, HTML, and Markdown from your own server.
+Project-URL: Homepage, https://github.com/brayevalerien/toss
+Project-URL: Repository, https://github.com/brayevalerien/toss
+Author-email: Valérien <contact@brayevalerien.com>
+License: MIT License
+        
+        Copyright (c) 2026 Valérien
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: caddy,cli,deploy,file-sharing,latex,markdown,rsync,self-hosted,static-site
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+<div align="center">
+  <img src="assets/logo-circle.svg" alt="toss logo" width="96" />
+</div>
+
+# Toss
+Toss is a minimal CLI to deploy and share static sites, HTML, and Markdown from your own server. Fast configuration and easy to setup so you can use it from about everywhere and share your work with private URLs.
+
+## Features
+- Deploy a Markdown file, an HTML file, or a full directory with a single command
+- Markdown pages render in the browser with LaTeX (KaTeX), syntax highlighting, footnotes, callouts, and Mermaid diagrams
+- Random slugs by default, custom slugs with `--slug`
+- Build-and-deploy in one step with `--build`
+- List, hide, unhide, and permanently delete deployments
+- Zero server-side dependencies beyond Caddy and SSH access
+
+## Installation and setup
+> [!NOTE]
+> The following prerequisites are needed before installing toss.
+> - [Python](https://www.python.org/) 3.10+
+> - [uv](https://docs.astral.sh/uv/)
+> - [git](https://git-scm.com/)
+> - `rsync` and `ssh` available in PATH (client-side)
+> - SSH access to a server running [Caddy](https://caddyserver.com/)
+
+### Server-side setup
+You'll first need to configure your server to serve files through SSH and [Caddy](https://caddyserver.com/).
+This section assumes you are running the commands on your server.
+
+Add a DNS A record: `share` (or anything you like) pointing to your server IP.
+
+Create the sites directory and give your SSH user write access:
+```sh
+sudo mkdir -p /srv/sites
+sudo chown youruser:youruser /srv/sites
+```
+
+Add a block to your Caddyfile for the share subdomain:
+```
+share.yourdomain.com {
+    root * /srv/sites
+    file_server
+    header X-Robots-Tag "noindex, nofollow"
+    handle_errors {
+        rewrite * /404.html
+        file_server
+    }
+}
+```
+
+If running Caddy in Docker, also mount `/srv/sites` in your Caddy container's volumes:
+```yaml
+volumes:
+  - /srv/sites:/srv/sites:ro
+```
+
+Copy the 404 page to your server. Feel free to edit `assets/404.html` to add your own contact info, and edit `toss_cli/templates/markdown_page.html` to customize the Markdown rendering theme before installing:
+```sh
+scp assets/404.html user@your-server:/srv/sites/404.html
+```
+
+Then restart Caddy:
+```sh
+# assuming systemd
+sudo systemctl reload caddy
+# or if using Docker
+docker compose up -d caddy
+```
+
+### Local CLI
+Once the server is configured, clone the repo and install toss locally:
+```sh
+git clone https://github.com/brayevalerien/toss
+cd toss
+uv tool install .
+```
+
+Once toss is installed, run the interactive setup wizard once:
+```sh
+toss init
+```
+This will prompt you for your server details, validate SSH connectivity, and save a config file at `~/.config/toss/config.toml`.
+
+> [!NOTE]
+> Re-run `toss init` at any time to update your configuration. If you prefer to edit it manually, it uses the following format:
+> ```toml
+> host = "user@my-server"
+> domain = "share.mydomain.com"
+> remote_path = "/srv/sites"
+> slug_length = 6
+> ```
+
+## Usage
+
+```sh
+# deploy a Markdown file, an HTML file, or a directory
+toss deploy path/to/file.md
+toss deploy path/to/page.html
+toss deploy path/to/site/
+
+# custom slug
+toss deploy report.md --slug my-report
+
+# build then deploy
+toss deploy . --build "npm run build"
+toss deploy . --build "npm run build" --out dist
+
+# list all deployments
+toss list
+
+# hide (makes URL return 404) and unhide
+toss hide <slug>
+toss unhide <slug>
+
+# permanently delete
+toss undeploy <slug>
+```

toss_cli-1.0.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+toss_cli/__init__.py,sha256=J-j-u0itpEFT6irdmWmixQqYMadNl1X91TxUmoiLHMI,22
+toss_cli/__main__.py,sha256=kPJckXHdzH6_ruoA3omAhzNubgq1RD2sETYUCGsaYmw,69
+toss_cli/cli.py,sha256=gaT71KV2J1j4OQuv1XlKkH6lpIp39X5of3_B_doqUb4,3334
+toss_cli/config.py,sha256=fP4IhXFMJsa5X21DrWBZJ-AJzyEfLMMWkBxwfG2RTqE,3457
+toss_cli/deploy.py,sha256=tac8nasLvp-w-RSmCQndyp9wvxX4J61VdILwavQRkxw,3208
+toss_cli/remote.py,sha256=UKg9qfDdq0SrOMM9PL1Bh2RCzvFRPeGaWJK4zJp8Glg,3615
+toss_cli/ssh.py,sha256=7GA1ahUaCN-MFzFI1-0ipSkbzr9bzNSmTUsZUEae3OE,490
+toss_cli/templates/__init__.py,sha256=XSYp7OvLRlK-2nN5RzudBdASiwJlThCWp8cmNT7jNf0,311
+toss_cli/templates/markdown_page.html,sha256=CobFzF78wVdkUQ8UCPFmpiBpEkCpPBcyyV3SW4-G8ZU,5876
+toss_cli-1.0.0.dist-info/METADATA,sha256=iHrCCXb835M36jHNNObjgn-bWUuWX4hT8gYrXQoo2p8,5278
+toss_cli-1.0.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+toss_cli-1.0.0.dist-info/entry_points.txt,sha256=uhwYQXeA8qZ5urUTQWQsfN9YNGruyMz6pNqLvCTKYzs,43
+toss_cli-1.0.0.dist-info/licenses/LICENSE,sha256=GAhgWHA2OR0YL7Q-Ueu1YDiuPC-SRIipdyalTWdX0z8,1066
+toss_cli-1.0.0.dist-info/RECORD,,

toss_cli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

toss_cli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+toss = toss_cli.cli:main

toss_cli-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Valérien
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.