Merge pull request #57 from antmicro/add_conda

Enable conda environment support
This commit is contained in:
Tim Ansell 2019-10-16 12:09:09 -07:00 committed by GitHub
commit e85861dca1
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
5 changed files with 70 additions and 2 deletions

View File

@ -13,7 +13,10 @@ PAPEROPT_a4 = -D latex_paper_size=a4
PAPEROPT_letter = -D latex_paper_size=letter
ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp epub latex latexpdf text man changes linkcheck doctest
CONDA_DIR = build/conda
CONDA_ENV_FILE = environment.yml
.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp epub latex latexpdf text man changes linkcheck doctest env
help:
@echo "Please use \`make <target>' where <target> is one of"
@ -31,6 +34,7 @@ help:
@echo " changes to make an overview of all changed/added/deprecated items"
@echo " linkcheck to check all external links for integrity"
@echo " doctest to run all doctests embedded in the documentation (if enabled)"
@echo " env to create a conda environment with the needed packages"
clean:
-rm -rf $(BUILDDIR)/*
@ -111,3 +115,14 @@ doctest:
$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
@echo "Testing of doctests in the sources finished, look at the " \
"results in $(BUILDDIR)/doctest/output.txt."
env:
@rm -rf $(CONDA_DIR)
@mkdir -p $(BUILDDIR) && mkdir -p $(CONDA_DIR)
@wget https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh\
-O $(CONDA_DIR)/miniconda.sh
@bash $(CONDA_DIR)/miniconda.sh -f -b -p $(CONDA_DIR) > /dev/null &&\
echo "Conda environment created successfully..."
@./$(CONDA_DIR)/bin/conda env create -q -f $(CONDA_ENV_FILE) > /dev/null &&\
echo "Conda packages installed successfully..."
@echo "To use conda environment type:\nsource enter-env.sh"

24
enter-env.sh Normal file
View File

@ -0,0 +1,24 @@
#!/bin/bash
if [ ! -n "${BASH_VERSION}" ]; then
echo "This script has to be sourced in bash!"
exit 1
fi
[[ "${BASH_SOURCE[0]}" != "${0}" ]] && SOURCED=1 || SOURCED=0
if [ ${SOURCED} == 0 ]; then
echo "This script has to be sourced!"
exit 1
fi
CONDA_DIR=${PWD}/build/conda
CONDA_DIR_NAME=SymbiFlow-docs
export PATH="${CONDA_DIR}/bin:$PATH"
# Use Conda hook for user shell
SHELL_NAME=`basename $SHELL`
CONDA_HOOK_COMMAND="${CONDA_DIR}/bin/conda shell.${SHELL_NAME} hook"
eval "$(${CONDA_HOOK_COMMAND})"
conda activate ${CONDA_DIR_NAME}

9
environment.yml Normal file
View File

@ -0,0 +1,9 @@
name: SymbiFlow-docs
channels:
- symbiflow
- conda-forge
- defaults
dependencies:
- pip
- pip:
- -r file:requirements.txt

20
readthedocs.yml Normal file
View File

@ -0,0 +1,20 @@
# .readthedocs.yml
# Read the Docs configuration file
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
# Required
version: 2
# Build documentation in the docs/ directory with Sphinx
sphinx:
configuration: source/conf.py
# Optionally build your docs in additional formats such as PDF and ePub
formats: []
# Optionally set the version of Python and requirements required to build your docs
python:
version: 3.7
conda:
environment: environment.yml

View File

@ -1,3 +1,3 @@
Sphinx
Sphinx==2.0.0
git+http://github.com/SymbiFlow/sphinx_materialdesign_theme.git@master#egg=sphinx_symbiflow_theme
sphinx-markdown-tables