Apache Beam Docset

Author: Dmytro Sadovnychyi

Generation steps:

Icon

wget https://beam.apache.org/images/logos/full-color/nameless/beam-logo-full-color-nameless-100.png
convert beam-logo-full-color-nameless-100.png -resize 16x16 icon.png
convert beam-logo-full-color-nameless-100.png -resize 32x32 icon@2x.png
rm beam-logo-full-color-nameless-100.png

Docset

git clone git@github.com:apache/beam.git --depth=1
cd beam
python3 -m venv .venv
source .venv/bin/activate
cd sdks/python
pip install -r build-requirements.txt
pip install -e ".[docs,interactive,test,gcp,dataframe]"
pip install doc2dash sphinx_rtd_theme
# Replace sphinx_rtd_theme so we can hide sidebar and footer.
sed -i -e "s/html_theme = 'sphinx_rtd_theme'/html_theme = 'alabaster'; html_theme_options = {'nosidebar': True}; html_show_copyright = False; html_show_sphinx = False/" scripts/generate_pydoc.sh
scripts/generate_pydoc.sh
cd ../../../
doc2dash beam/sdks/python/target/docs/_build --name="Apache Beam Python" --index-page=index.html --force --icon=icon.png
rm -rf beam

Publishing

tar --exclude='.DS_Store' -cvzf Apache_Beam_Python.tgz "Apache Beam Python.docset"
rm -rf Apache\ Beam\ Python.docset/