SeaCMS/pico
3
0
Fork 0
Code Issues Pull Requests Activity

phpDocs auto deployment: Disable cache for releases

Browse Source
This commit is contained in:
Daniel Rudolf 2015-11-30 16:54:45 +01:00
parent c88a26beff
commit 47d2685c6d
3 changed files with 20 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
_build/deploy-phpdoc-branch.sh
View File

@ -17,8 +17,6 @@ fi
PHPDOC_ID="${TRAVIS_BRANCH//\//_}" PHPDOC_ID="${TRAVIS_BRANCH//\//_}"
PHPDOC_GIT_DIR="$TRAVIS_BUILD_DIR/_build/phpdoc-$PHPDOC_ID.git" PHPDOC_GIT_DIR="$TRAVIS_BUILD_DIR/_build/phpdoc-$PHPDOC_ID.git"
PHPDOC_CACHE_DIR="$PHPDOC_GIT_DIR/phpDoc/$PHPDOC_ID.cache"
PHPDOC_TARGET_DIR="$PHPDOC_GIT_DIR/phpDoc/$PHPDOC_ID"
# clone repo # clone repo
echo "Cloning repo..." echo "Cloning repo..."
@ -31,7 +29,7 @@ echo
# generate phpDocs # generate phpDocs
generate-phpdoc.sh \ generate-phpdoc.sh \
"$TRAVIS_BUILD_DIR/.phpdoc.xml" \ "$TRAVIS_BUILD_DIR/.phpdoc.xml" \
"$PHPDOC_CACHE_DIR" "$PHPDOC_TARGET_DIR" \ "$PHPDOC_GIT_DIR/phpDoc/$PHPDOC_ID.cache" "$PHPDOC_GIT_DIR/phpDoc/$PHPDOC_ID" \
"Pico 1.0 API Documentation ($TRAVIS_BRANCH branch)" "Pico 1.0 API Documentation ($TRAVIS_BRANCH branch)"
[ $? -eq 0 ] || exit 1 [ $? -eq 0 ] || exit 1

4
_build/deploy-phpdoc-release.sh
View File

@ -4,8 +4,6 @@
PHPDOC_ID="${TRAVIS_BRANCH//\//_}" PHPDOC_ID="${TRAVIS_BRANCH//\//_}"
PHPDOC_GIT_DIR="$TRAVIS_BUILD_DIR/_build/phpdoc-$PHPDOC_ID.git" PHPDOC_GIT_DIR="$TRAVIS_BUILD_DIR/_build/phpdoc-$PHPDOC_ID.git"
PHPDOC_CACHE_DIR="$TRAVIS_BUILD_DIR/_build/phpdoc-$PHPDOC_ID.cache"
PHPDOC_TARGET_DIR="$PHPDOC_GIT_DIR/phpDoc/$PHPDOC_ID"
# clone repo # clone repo
echo "Cloning repo..." echo "Cloning repo..."
@ -18,7 +16,7 @@ echo
# generate phpDocs # generate phpDocs
generate-phpdoc.sh \ generate-phpdoc.sh \
"$TRAVIS_BUILD_DIR/.phpdoc.xml" \ "$TRAVIS_BUILD_DIR/.phpdoc.xml" \
"$PHPDOC_CACHE_DIR" "$PHPDOC_TARGET_DIR" \ "-" "$PHPDOC_GIT_DIR/phpDoc/$PHPDOC_ID" \
"Pico 1.0 API Documentation ($TRAVIS_TAG)" "Pico 1.0 API Documentation ($TRAVIS_TAG)"
[ $? -eq 0 ] || exit 1 [ $? -eq 0 ] || exit 1

23
_build/generate-phpdoc.sh
View File

@ -15,21 +15,28 @@ printf 'PHPDOC_TARGET_DIR="%s"\n' "$PHPDOC_TARGET_DIR"
printf 'PHPDOC_TITLE="%s"\n' "$PHPDOC_TITLE" printf 'PHPDOC_TITLE="%s"\n' "$PHPDOC_TITLE"
echo echo
# parse phpDoc files (i.e. update cache) # update a separate phpDoc cache
printf "\nUpdate phpDoc cache...\n" if [ "$PHPDOC_CACHE_DIR" != "-" ]; then
phpdoc project:parse --config "$PHPDOC_CONFIG" \ # parse phpDoc files (i.e. update cache)
printf "\nUpdate phpDoc cache...\n"
phpdoc project:parse --config "$PHPDOC_CONFIG" \
--target "$PHPDOC_CACHE_DIR" --target "$PHPDOC_CACHE_DIR"
# check for changes # check for changes
printf '\nCheck for phpDoc cache changes...\n' printf '\nCheck for phpDoc cache changes...\n'
if [ -z "$(git status --porcelain "$PHPDOC_CACHE_DIR")" ]; then if [ -z "$(git status --porcelain "$PHPDOC_CACHE_DIR")" ]; then
printf 'No changes detected; skipping phpDocs renewal...\n\n' printf 'No changes detected; skipping phpDocs renewal...\n\n'
exit 0 exit 0
fi
# NOTE: actually the following command should be `phpdoc project:transform`
# instead of `phpdoc project:run`, but the command seems to be broken...
else
# create temporary cache files in PHPDOC_TARGET_DIR
PHPDOC_CACHE_DIR="$PHPDOC_TARGET_DIR"
fi fi
# transform phpDoc files (i.e. rewrite API docs) # transform phpDoc files (i.e. rewrite API docs)
# NOTE: actually this should be `phpdoc project:transform`,
# but the command seems to be broken...
printf '\nRewrite phpDocs...\n' printf '\nRewrite phpDocs...\n'
rm -rf "$PHPDOC_TARGET_DIR" rm -rf "$PHPDOC_TARGET_DIR"
phpdoc project:run --config "$PHPDOC_CONFIG" \ phpdoc project:run --config "$PHPDOC_CONFIG" \