mirror of
https://github.com/ceph/ceph
synced 2024-12-25 21:03:31 +00:00
70caf0dfe8
pip v20.2 introduced a new option named --use-feature, which is not available with <20.2. so we need to check for it before using it. see also https://pip.pypa.io/en/stable/user_guide/#changes-to-the-pip-dependency-resolver-in-20-2-2020 Fixes: https://tracker.ceph.com/issues/47636 Signed-off-by: Kefu Chai <kchai@redhat.com>
181 lines
5.7 KiB
Bash
Executable File
181 lines
5.7 KiB
Bash
Executable File
#!/bin/sh
|
|
|
|
cd "$(dirname "$0")"
|
|
cd ..
|
|
TOPDIR=`pwd`
|
|
|
|
install -d -m0755 build-doc
|
|
|
|
if command -v dpkg >/dev/null; then
|
|
packages=`cat ${TOPDIR}/doc_deps.deb.txt`
|
|
for package in $packages; do
|
|
if [ "$(dpkg --status -- $package 2>&1 | sed -n 's/^Status: //p')" != "install ok installed" ]; then
|
|
# add a space after old values
|
|
missing="${missing:+$missing }$package"
|
|
fi
|
|
done
|
|
if [ -n "$missing" ]; then
|
|
echo "$0: missing required packages, please install them:" 1>&2
|
|
echo "sudo apt-get install -o APT::Install-Recommends=true $missing" 1>&2
|
|
exit 1
|
|
fi
|
|
elif command -v yum >/dev/null; then
|
|
for package in ant ditaa doxygen libxslt-devel libxml2-devel graphviz python3-devel python3-pip python3-virtualenv python3-Cython; do
|
|
if ! rpm -q --whatprovides $package >/dev/null ; then
|
|
missing="${missing:+$missing }$package"
|
|
fi
|
|
done
|
|
if [ -n "$missing" ]; then
|
|
echo "$0: missing required packages, please install them:" 1>&2
|
|
echo "yum install $missing"
|
|
exit 1
|
|
fi
|
|
else
|
|
for command in dot virtualenv doxygen ant ditaa cython; do
|
|
if ! command -v "$command" > /dev/null; then
|
|
# add a space after old values
|
|
missing="${missing:+$missing }$command"
|
|
fi
|
|
done
|
|
if [ -n "$missing" ]; then
|
|
echo "$0: missing required command, please install them:" 1>&2
|
|
echo "$missing" 1>&2
|
|
exit 1
|
|
fi
|
|
fi
|
|
|
|
# Don't enable -e until after running all the potentially-erroring checks
|
|
# for availability of commands
|
|
set -e
|
|
|
|
cat $TOPDIR/src/osd/PeeringState.h $TOPDIR/src/osd/PeeringState.cc | $TOPDIR/doc/scripts/gen_state_diagram.py > $TOPDIR/doc/dev/peering_graph.generated.dot
|
|
|
|
cd build-doc
|
|
|
|
[ -z "$vdir" ] && vdir="$TOPDIR/build-doc/virtualenv"
|
|
|
|
if [ ! -e $vdir ]; then
|
|
virtualenv --python=python3 $vdir
|
|
fi
|
|
|
|
# be compatible with pip shipped by distro older v20.2
|
|
if $vdir/bin/pip --use-feature=2020-resolver >/dev/null 2>&1 ; then
|
|
PIP_INSTALL="$vdir/bin/pip install --use-feature=2020-resolver"
|
|
else
|
|
PIP_INSTALL="$vdir/bin/pip install"
|
|
fi
|
|
$PIP_INSTALL --quiet -r $TOPDIR/admin/doc-requirements.txt -r $TOPDIR/admin/doc-python-common-requirements.txt
|
|
|
|
install -d -m0755 \
|
|
$TOPDIR/build-doc/output/html \
|
|
$TOPDIR/build-doc/output/man
|
|
|
|
# To avoid having to build librbd to build the Python bindings to build the docs,
|
|
# create a dummy librbd.so that allows the module to be imported by sphinx.
|
|
# the module are imported by the "automodule::" directive.
|
|
mkdir -p $vdir/lib
|
|
export LD_LIBRARY_PATH="$vdir/lib"
|
|
export PYTHONPATH=$TOPDIR/src/pybind
|
|
|
|
|
|
$vdir/bin/python $TOPDIR/doc/scripts/gen_mon_command_api.py > $TOPDIR/doc/api/mon_command_api.rst
|
|
|
|
|
|
# FIXME(sileht): I dunno how to pass the include-dirs correctly with pip
|
|
# for build_ext step, it should be:
|
|
# --global-option=build_ext --global-option="--cython-include-dirs $TOPDIR/src/pybind/rados/"
|
|
# but that doesn't work, so copying the file in the rbd module directly, that's ok for docs
|
|
for bind in rados rbd cephfs rgw; do
|
|
if [ ${bind} != rados ]; then
|
|
cp -f $TOPDIR/src/pybind/rados/rados.pxd $TOPDIR/src/pybind/${bind}/
|
|
fi
|
|
ln -sf lib${bind}.so.1 $vdir/lib/lib${bind}.so
|
|
gcc -shared -o $vdir/lib/lib${bind}.so.1 -xc /dev/null
|
|
ld_flags="-Wl,-rpath,$vdir/lib"
|
|
if [ $(uname) != Darwin ]; then
|
|
ld_flags="${ld_flags},--no-as-needed"
|
|
fi
|
|
BUILD_DOC=1 \
|
|
CFLAGS="-iquote$TOPDIR/src/include" \
|
|
CPPFLAGS="-iquote$TOPDIR/src/include" \
|
|
LDFLAGS="-L$vdir/lib ${ld_flags}" \
|
|
$vdir/bin/pip install --upgrade $TOPDIR/src/pybind/${bind}
|
|
# rgwfile_version(), librgw_create(), rgw_mount()
|
|
# since py3.5, distutils adds postfix in between ${bind} and so
|
|
lib_fn=$vdir/lib/python*/*-packages/${bind}.*.so
|
|
if [ ! -e $lib_fn ]; then
|
|
lib_fn=$vdir/lib/python*/*-packages/${bind}.so
|
|
fi
|
|
if [ ${bind} = "cephfs" ]; then
|
|
func_prefix="ceph"
|
|
else
|
|
func_prefix="(lib)?${bind}"
|
|
fi
|
|
nm $lib_fn | grep -E "U (_)?${func_prefix}" | \
|
|
awk '{ gsub(/^_/,"",$2); print "void "$2"(void) {}" }' | \
|
|
gcc -shared -o $vdir/lib/lib${bind}.so.1 -xc -
|
|
if [ ${bind} != rados ]; then
|
|
rm -f $TOPDIR/src/pybind/${bind}/rados.pxd
|
|
fi
|
|
done
|
|
|
|
if [ -z "$@" ]; then
|
|
sphinx_targets="html man"
|
|
else
|
|
sphinx_targets=$@
|
|
fi
|
|
for target in $sphinx_targets; do
|
|
builder=$target
|
|
case $target in
|
|
html)
|
|
builder=dirhtml
|
|
extra_opt="-D graphviz_output_format=svg"
|
|
;;
|
|
man)
|
|
extra_opt="-t man"
|
|
;;
|
|
esac
|
|
# Build with -W so that warnings are treated as errors and this fails
|
|
$vdir/bin/sphinx-build -W --keep-going -a -b $builder $extra_opt -d doctrees \
|
|
$TOPDIR/doc $TOPDIR/build-doc/output/$target
|
|
|
|
|
|
done
|
|
|
|
# build the releases.json. this reads in the yaml version and dumps
|
|
# out the json representation of the same file. the resulting releases.json
|
|
# should be served from the root of hosted site.
|
|
$vdir/bin/python << EOF > $TOPDIR/build-doc/output/html/releases.json
|
|
from __future__ import print_function
|
|
import datetime
|
|
import json
|
|
import yaml
|
|
|
|
def json_serialize(obj):
|
|
if isinstance(obj, datetime.date):
|
|
return obj.isoformat()
|
|
|
|
with open("$TOPDIR/doc/releases/releases.yml", 'r') as fp:
|
|
releases = yaml.safe_load(fp)
|
|
print(json.dumps(releases, indent=2, default=json_serialize))
|
|
EOF
|
|
|
|
#
|
|
# Build and install JavaDocs
|
|
#
|
|
JAVADIR=$TOPDIR/src/java
|
|
|
|
# Clean and build JavaDocs
|
|
rm -rf $JAVADIR/doc
|
|
ant -buildfile $JAVADIR/build.xml docs
|
|
|
|
# Create clean target directory
|
|
JAVA_OUTDIR=$TOPDIR/build-doc/output/html/cephfs/api/libcephfs-java/javadoc
|
|
rm -rf $JAVA_OUTDIR
|
|
mkdir $JAVA_OUTDIR
|
|
|
|
# Copy JavaDocs to target directory
|
|
cp -a $JAVADIR/doc/* $JAVA_OUTDIR/
|
|
|
|
echo "SUCCESS"
|