71 lines
2.1 KiB
Bash
Executable File
71 lines
2.1 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# Copyright 2020 Google LLC
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
|
|
set -o errexit
|
|
set -o nounset
|
|
set -o xtrace
|
|
set -o pipefail
|
|
|
|
# Update the gh-pages branch. Note that `cargo doc` is **not deterministic** so
|
|
# this should only be done when there is a real change.
|
|
readonly RUST_BRANCH=${1:-main}
|
|
readonly RUST_GH_BRANCH=gh-pages
|
|
|
|
if [ -z "${FORCE+x}" ]; then
|
|
readonly PREV_COMMIT=$(git log --oneline -n 1 ${RUST_GH_BRANCH} | sed 's/.*branch at \([0-9a-f]*\)/\1/')
|
|
readonly CHANGES=$(git diff "${PREV_COMMIT}..${RUST_BRANCH}" | grep -e '[+-]//[/!]')
|
|
|
|
if [ -z "${CHANGES}" ]; then
|
|
echo "No doc comment changes found in ${PREV_COMMIT}..${RUST_BRANCH} subdir rust/"
|
|
exit 0
|
|
fi
|
|
fi
|
|
|
|
git switch "${RUST_BRANCH}"
|
|
readonly RUST_BRANCH_SHA1=$(git rev-parse --short HEAD)
|
|
readonly RUST_BRANCH_SUBJECT=$(git log -n 1 --format=format:%s)
|
|
readonly COMMIT_MESSAGE=$(cat <<-END
|
|
Update Rust docs to ${RUST_BRANCH} branch at ${RUST_BRANCH_SHA1}
|
|
|
|
Auto-generated from commit ${RUST_BRANCH_SHA1} ("${RUST_BRANCH_SUBJECT}").
|
|
END
|
|
)
|
|
|
|
readonly TGZ_FILE="/tmp/coset-doc-${RUST_BRANCH_SHA1}.tgz"
|
|
# Build Cargo docs and save them off outside the repo
|
|
(
|
|
rm -rf target/doc
|
|
cargo doc --no-deps
|
|
cargo deadlinks
|
|
cd target/doc || exit
|
|
tar czf "${TGZ_FILE}" ./*
|
|
)
|
|
|
|
# Shift to ${RUST_GH_BRANCH} branch and replace contents of (just) ./rust/
|
|
git switch ${RUST_GH_BRANCH}
|
|
|
|
readonly DOC_DIR=rust
|
|
rm -rf ${DOC_DIR}
|
|
mkdir ${DOC_DIR}
|
|
(
|
|
cd "${DOC_DIR}" || exit
|
|
tar xzf "${TGZ_FILE}"
|
|
)
|
|
|
|
# Commit any differences
|
|
git add "${DOC_DIR}"
|
|
git commit --message="${COMMIT_MESSAGE}"
|
|
git switch "${RUST_BRANCH}"
|