zingolabs-zewif 0.0.2

Fork of Blockhain Commons's zewif crate.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

#!/usr/bin/env bash
set -euo pipefail

# Parse command-line option
MODE="deploy"
if [[ "${1:-}" == "--setup" ]]; then
    MODE="setup"
    shift
elif [[ -n "${1:-}" ]]; then
    echo "❌ Usage: $0 [--setup]"
    exit 1
fi

REPO_URL="$(git remote get-url origin)"
DEPLOY_DIR="/tmp/cargo-doc-setup"
TARGET_DIR=${CARGO_TARGET_DIR:-$(cargo metadata --format-version 1 --no-deps | jq -r '.target_directory')}
CRATE_DIR=${CARGO_MANIFEST_DIR:-$(pwd)}
CRATE_NAME=${CARGO_PKG_NAME:-$(grep -m1 '^name' Cargo.toml | sed -E 's/name *= *"(.*)".*/\1/')}
DOC_DIR="$TARGET_DIR/doc/$CRATE_NAME"

if [[ "$MODE" == "setup" ]]; then
    # ── Sanity checks ──────────────────────────────────────────────────────────────
    if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
        echo '❌ Error: not inside a Git repository.'
        exit 1
    fi

    if git ls-remote --exit-code --heads origin gh-pages >/dev/null; then
        echo '❌ origin/gh-pages already exists. Run the regular deploy script instead.'
        exit 1
    fi

    # ── Build documentation ────────────────────────────────────────────────────────
    echo '📚 Building documentation…'
    RUSTDOCFLAGS="-Z unstable-options --static-root-path=static.files/" \
        cargo +nightly doc --no-deps --all-features

    # ── Prepare temporary gh-pages worktree ────────────────────────────────────────
    rm -rf "$DEPLOY_DIR"
    mkdir -p "$DEPLOY_DIR"
    pushd "$DEPLOY_DIR" >/dev/null

    git init
    git checkout --orphan gh-pages

    # Copy resources in
    cp -R "$TARGET_DIR/doc/static.files/" "$DEPLOY_DIR/static.files/"
    # Copy docs in, preserving subdirs
    cp -R "$TARGET_DIR/doc/$CRATE_NAME/" "$DEPLOY_DIR/"
    touch .nojekyll
    [[ -f "$CRATE_DIR/CNAME" ]] && cp "$CRATE_DIR/CNAME" .

    git add .
    git commit -m "Initial deploy of $CRATE_NAME documentation"
    git remote add origin "$REPO_URL"
    git push -u origin gh-pages

    popd >/dev/null
    rm -rf "$DEPLOY_DIR"

    echo "✅ GitHub Pages branch 'gh-pages' created and published."
    echo "👉 In your repo settings → Pages, set source to the 'gh-pages' branch, root directory."
else
    # ── Incremental deploy ────────────────────────────────────────────────────────
    if ! git ls-remote --exit-code --heads origin gh-pages >/dev/null; then
        echo "❌ origin/gh-pages does not exist. Run with --setup first."
        exit 1
    fi
    echo '📚 Building documentation…'
    RUSTDOCFLAGS="-Z unstable-options --static-root-path=static.files/" \
        cargo +nightly doc --no-deps --all-features

    rm -rf "$DEPLOY_DIR"
    mkdir -p "$DEPLOY_DIR"
    pushd "$DEPLOY_DIR" >/dev/null

    git clone --branch gh-pages "$REPO_URL" .
    # Clean old docs (preserve git metadata)
    find . -maxdepth 1 -mindepth 1 ! -name .git ! -name .gitignore ! -name .nojekyll ! -name CNAME -exec rm -rf {} +

    cp -R "$TARGET_DIR/doc/static.files/" "$DEPLOY_DIR/static.files/"
    cp -R "$TARGET_DIR/doc/$CRATE_NAME/" "$DEPLOY_DIR/"
    touch .nojekyll
    [[ -f "$CRATE_DIR/CNAME" ]] && cp "$CRATE_DIR/CNAME" .

    git add .
    git commit -m "Update docs for $CRATE_NAME"
    git push origin gh-pages

    popd >/dev/null
    rm -rf "$DEPLOY_DIR"

    echo "✅ Documentation updated and published."
fi