web-snapshot-cli 0.1.0__tar.gz → 0.2.0__tar.gz

{web_snapshot_cli-0.1.0 → web_snapshot_cli-0.2.0}/.github/workflows/publish.yml

@@ -1,5 +1,4 @@
-# PyPI project: web-snapshot-cli
-# Trusted publisher: owner codingsushi79, repo Snapshot, workflow publish.yml, env pypi
+# PyPI: web-snapshot-cli
 name: Publish to PyPI
 
 on:
@@ -62,3 +61,5 @@ jobs:
           path: dist/
 
       - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true

{web_snapshot_cli-0.1.0 → web_snapshot_cli-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: web-snapshot-cli
-Version: 0.1.0
+Version: 0.2.0
 Summary: Take offline snapshots of any website and restore them locally
 Project-URL: Homepage, https://github.com/codingsushi79/Snapshot
 Project-URL: Repository, https://github.com/codingsushi79/Snapshot
@@ -33,25 +33,7 @@ Take a fast offline copy of any public website, then serve it locally.
 
 ## Install
 
-**One-liner (macOS / Linux / WSL):**
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/codingsushi79/Snapshot/main/install.sh | bash
-```
-
-**One-liner (Windows PowerShell):**
-
-```powershell
-irm https://raw.githubusercontent.com/codingsushi79/Snapshot/main/install.ps1 | iex
-```
-
-**Universal fallback** (requires Python 3.10+):
-
-```bash
-python3 -m pip install --user git+https://github.com/codingsushi79/Snapshot.git
-```
-
-**From PyPI** (once published):
+Requires Python 3.10+.
 
 ```bash
 pip install web-snapshot-cli
@@ -63,23 +45,6 @@ Then run:
 snapshot https://example.com ./mirror
 ```
 
-<details>
-<summary>Other install methods</summary>
-
-```bash
-# With pipx (recommended for CLI tools)
-pipx install web-snapshot-cli
-# or from git:
-pipx install git+https://github.com/codingsushi79/Snapshot.git
-
-# From a local clone
-git clone https://github.com/codingsushi79/Snapshot.git
-cd Snapshot
-pip install -e .
-```
-
-</details>
-
 ## Usage
 
 ### Snapshot a single page

{web_snapshot_cli-0.1.0 → web_snapshot_cli-0.2.0}/README.md

@@ -4,25 +4,7 @@ Take a fast offline copy of any public website, then serve it locally.
 
 ## Install
 
-**One-liner (macOS / Linux / WSL):**
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/codingsushi79/Snapshot/main/install.sh | bash
-```
-
-**One-liner (Windows PowerShell):**
-
-```powershell
-irm https://raw.githubusercontent.com/codingsushi79/Snapshot/main/install.ps1 | iex
-```
-
-**Universal fallback** (requires Python 3.10+):
-
-```bash
-python3 -m pip install --user git+https://github.com/codingsushi79/Snapshot.git
-```
-
-**From PyPI** (once published):
+Requires Python 3.10+.
 
 ```bash
 pip install web-snapshot-cli
@@ -34,23 +16,6 @@ Then run:
 snapshot https://example.com ./mirror
 ```
 
-<details>
-<summary>Other install methods</summary>
-
-```bash
-# With pipx (recommended for CLI tools)
-pipx install web-snapshot-cli
-# or from git:
-pipx install git+https://github.com/codingsushi79/Snapshot.git
-
-# From a local clone
-git clone https://github.com/codingsushi79/Snapshot.git
-cd Snapshot
-pip install -e .
-```
-
-</details>
-
 ## Usage
 
 ### Snapshot a single page

{web_snapshot_cli-0.1.0 → web_snapshot_cli-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "web-snapshot-cli"
-version = "0.1.0"
+version = "0.2.0"
 description = "Take offline snapshots of any website and restore them locally"
 readme = "README.md"
 license = "MIT"

{web_snapshot_cli-0.1.0 → web_snapshot_cli-0.2.0}/src/snapshot/__init__.py

@@ -1,3 +1,3 @@
 """snapshot — offline website snapshots."""
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"

{web_snapshot_cli-0.1.0 → web_snapshot_cli-0.2.0}/src/snapshot/cli.py

@@ -180,6 +180,7 @@ def _build_options(
 )
 @click.option(
     "--sitemap",
+    "use_sitemap",
     is_flag=True,
     help="Seed crawl URLs from sitemap.xml and robots.txt Sitemap directives.",
 )
@@ -198,7 +199,9 @@ def _build_options(
 @click.option("--host", default="127.0.0.1", show_default=True, help="Host for -restore.")
 @click.option("--no-open", is_flag=True, help="Do not open a browser when restoring.")
 @click.version_option(__version__, prog_name="snapshot")
+@click.pass_context
 def main(
+    ctx: click.Context,
     url: str | None,
     output_dir: str | None,
     extra_args: tuple[str, ...],
@@ -245,9 +248,9 @@ def main(
         return
 
     if not url or not output_dir:
-        console.print("[red]Usage:[/red] snapshot [OPTIONS] URL OUTPUT_DIR [extra args]")
-        console.print("       snapshot -restore DIR")
-        raise SystemExit(1)
+        if not url:
+            ctx.fail("Missing argument 'URL'.")
+        ctx.fail("Missing argument 'OUTPUT_DIR'.")
 
     options = _build_options(
         extras,

{web_snapshot_cli-0.1.0 → web_snapshot_cli-0.2.0}/src/snapshot/downloader.py

@@ -39,7 +39,7 @@ class SnapshotOptions:
     timeout: float = 15.0
     concurrency: int = 16
     same_origin_only: bool = True
-    user_agent: str = "web-snapshot-cli/0.1 (+https://github.com/codingsushi79/Snapshot)"
+    user_agent: str = "web-snapshot-cli/0.2 (+https://github.com/codingsushi79/Snapshot)"
     cookies: list[str] = field(default_factory=list)
     headers: list[str] = field(default_factory=list)
     include_patterns: list[str] = field(default_factory=list)

web_snapshot_cli-0.1.0/install.ps1

@@ -1,67 +0,0 @@
-#Requires -Version 5.1
-$ErrorActionPreference = "Stop"
-
-$Repo = if ($env:SNAPSHOT_REPO) { $env:SNAPSHOT_REPO } else { "https://github.com/codingsushi79/Snapshot.git" }
-$Ref = if ($env:SNAPSHOT_REF) { $env:SNAPSHOT_REF } else { "main" }
-$InstallSpec = "git+$Repo@$Ref"
-
-function Write-Info($msg) { Write-Host "→ $msg" -ForegroundColor Cyan }
-function Write-Warn($msg) { Write-Host "! $msg" -ForegroundColor Yellow }
-function Write-Err($msg)  { Write-Host "✗ $msg" -ForegroundColor Red }
-
-function Find-Python {
-    foreach ($cmd in @("python", "python3", "py")) {
-        if (Get-Command $cmd -ErrorAction SilentlyContinue) {
-            $ok = & $cmd -c "import sys; raise SystemExit(0 if sys.version_info >= (3,10) else 1)" 2>$null
-            if ($LASTEXITCODE -eq 0) { return $cmd }
-        }
-    }
-    return $null
-}
-
-function Ensure-Pip($py) {
-    & $py -m pip --version 2>$null | Out-Null
-    if ($LASTEXITCODE -ne 0) {
-        Write-Info "Bootstrapping pip…"
-        & $py -m ensurepip --upgrade 2>$null | Out-Null
-    }
-    & $py -m pip --version 2>$null | Out-Null
-    return ($LASTEXITCODE -eq 0)
-}
-
-Write-Info "Installing snapshot from $InstallSpec"
-
-$py = Find-Python
-if (-not $py) {
-    Write-Err "Python 3.10+ is required."
-    Write-Err "Install from https://www.python.org/downloads/ and re-run this script."
-    exit 1
-}
-
-if (-not (Ensure-Pip $py)) {
-    Write-Err "pip is required but could not be installed."
-    exit 1
-}
-
-if (Get-Command pipx -ErrorAction SilentlyContinue) {
-    Write-Info "Installing snapshot with pipx…"
-    pipx install --force $InstallSpec
-} else {
-    Write-Info "Installing snapshot with pip…"
-    & $py -m pip install --user --upgrade $InstallSpec
-}
-
-$localBin = Join-Path $env:USERPROFILE ".local\\bin"
-$scriptsDir = Join-Path $env:APPDATA "Python\\Python312\\Scripts"
-$paths = @($localBin, $scriptsDir) | Where-Object { Test-Path $_ }
-if ($paths.Count -gt 0) {
-    $env:PATH = ($paths -join ";") + ";" + $env:PATH
-}
-
-if (Get-Command snapshot -ErrorAction SilentlyContinue) {
-    Write-Info "Installed snapshot."
-    Write-Info "Run: snapshot https://example.com ./mirror"
-} else {
-    Write-Warn "snapshot installed, but not on PATH."
-    Write-Warn "Restart your terminal or add Python Scripts to PATH."
-}

web_snapshot_cli-0.1.0/install.sh

@@ -1,109 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-REPO="${SNAPSHOT_REPO:-https://github.com/codingsushi79/Snapshot.git}"
-REF="${SNAPSHOT_REF:-main}"
-INSTALL_SPEC="git+${REPO}@${REF}"
-
-info() { printf '\033[1;34m→\033[0m %s\n' "$*"; }
-warn() { printf '\033[1;33m!\033[0m %s\n' "$*"; }
-err()  { printf '\033[1;31m✗\033[0m %s\n' "$*" >&2; }
-
-need_cmd() {
-  command -v "$1" >/dev/null 2>&1
-}
-
-find_python() {
-  for cmd in python3 python py; do
-    if need_cmd "$cmd"; then
-      if "$cmd" -c 'import sys; raise SystemExit(0 if sys.version_info >= (3, 10) else 1)' 2>/dev/null; then
-        echo "$cmd"
-        return 0
-      fi
-    fi
-  done
-  return 1
-}
-
-ensure_pip() {
-  local py="$1"
-  if "$py" -m pip --version >/dev/null 2>&1; then
-    return 0
-  fi
-  info "Bootstrapping pip…"
-  "$py" -m ensurepip --upgrade >/dev/null 2>&1 || true
-  "$py" -m pip --version >/dev/null 2>&1
-}
-
-pip_user_flag() {
-  if [[ -n "${VIRTUAL_ENV:-}" ]]; then
-    echo ""
-  else
-    echo "--user"
-  fi
-}
-
-install_with_pipx() {
-  local py="$1"
-  info "Installing snapshot with pipx…"
-  if ! need_cmd pipx; then
-    local user_flag
-    user_flag="$(pip_user_flag)"
-    # shellcheck disable=SC2086
-    "$py" -m pip install $user_flag pipx
-    export PATH="${HOME}/.local/bin:${PATH}"
-    if need_cmd pipx; then
-      pipx ensurepath >/dev/null 2>&1 || true
-    fi
-  fi
-  if need_cmd pipx; then
-    pipx install --force "$INSTALL_SPEC"
-    return 0
-  fi
-  return 1
-}
-
-install_with_pip() {
-  local py="$1"
-  local user_flag
-  user_flag="$(pip_user_flag)"
-  info "Installing snapshot with pip…"
-  # shellcheck disable=SC2086
-  "$py" -m pip install $user_flag --upgrade "$INSTALL_SPEC"
-}
-
-verify_install() {
-  export PATH="${HOME}/.local/bin:${HOME}/Library/Python/3.12/bin:${HOME}/Library/Python/3.11/bin:${HOME}/Library/Python/3.10/bin:${PATH}"
-  if command -v snapshot >/dev/null 2>&1; then
-    info "Installed: $(snapshot --version 2>/dev/null || snapshot --help | head -1)"
-    info "Run: snapshot https://example.com ./mirror"
-    return 0
-  fi
-  warn "snapshot installed, but not on PATH."
-  warn "Add this to your shell profile:"
-  echo "  export PATH=\"\${HOME}/.local/bin:\${PATH}\""
-  return 1
-}
-
-main() {
-  info "Installing snapshot from ${INSTALL_SPEC}"
-
-  if ! PY="$(find_python)"; then
-    err "Python 3.10+ is required."
-    err "Install Python from https://www.python.org/downloads/ and re-run this script."
-    exit 1
-  fi
-
-  if ! ensure_pip "$PY"; then
-    err "pip is required but could not be installed."
-    exit 1
-  fi
-
-  if ! install_with_pipx "$PY"; then
-    install_with_pip "$PY"
-  fi
-
-  verify_install || true
-}
-
-main "$@"