"""Generates a Dockerfile based on an input matrix for Julia""" import os import toml from ..python import PythonBuildPack from .julia_semver import find_semver_match class JuliaProjectTomlBuildPack(PythonBuildPack): """ Julia build pack which uses conda. """ # ALL EXISTING JULIA VERSIONS # Note that these must remain ordered, in order for the find_semver_match() # function to behave correctly. all_julias = [ "0.7.0", "1.0.0", "1.0.1", "1.0.2", "1.0.3", "1.1.0", ] @property def julia_version(self): default_julia_version = self.all_julias[-1] if os.path.exists(self.binder_path('JuliaProject.toml')): project_toml = toml.load(self.binder_path('JuliaProject.toml')) else: project_toml = toml.load(self.binder_path('Project.toml')) if 'compat' in project_toml: if 'julia' in project_toml['compat']: julia_version_str = project_toml['compat']['julia'] # For Project.toml files, install the latest julia version that # satisfies the given semver. _julia_version = find_semver_match(julia_version_str, self.all_julias) if _julia_version is not None: return _julia_version return default_julia_version def get_build_env(self): """Get additional environment settings for Julia and Jupyter Returns: an ordered list of environment setting tuples The tuples contain a string of the environment variable name and a string of the environment setting: - `JULIA_PATH`: base path where all Julia Binaries and libraries will be installed - `JULIA_BINDIR`: path where all Julia Binaries will be installed - `JULIA_DEPOT_PATH`: path where Julia libraries are installed. - `JULIA_VERSION`: default version of julia to be installed - `JUPYTER`: environment variable required by IJulia to point to the `jupyter` executable For example, a tuple may be `('JULIA_VERSION', '0.6.0')`. """ return super().get_build_env() + [ ('JULIA_PATH', '${APP_BASE}/julia'), ('JULIA_BINDIR', '${JULIA_PATH}/bin'), ('JULIA_DEPOT_PATH', '${JULIA_PATH}/pkg'), ('JULIA_VERSION', self.julia_version), ('JUPYTER', '${NB_PYTHON_PREFIX}/bin/jupyter') ] def get_path(self): """Adds path to Julia binaries to user's PATH. Returns: an ordered list of path strings. The path to the Julia executable is added to the list. """ return super().get_path() + ['${JULIA_BINDIR}'] def get_build_scripts(self): """ Return series of build-steps common to "ALL" Julia repositories All scripts found here should be independent of contents of a particular repository. This creates a directory with permissions for installing julia packages (from get_assemble_scripts). """ return super().get_build_scripts() + [ ( "root", r""" mkdir -p ${JULIA_PATH} && \ curl -sSL "https://julialang-s3.julialang.org/bin/linux/x64/${JULIA_VERSION%[.-]*}/julia-${JULIA_VERSION}-linux-x86_64.tar.gz" | tar -xz -C ${JULIA_PATH} --strip-components 1 """ ), ( "root", r""" mkdir -p ${JULIA_DEPOT_PATH} && \ chown ${NB_USER}:${NB_USER} ${JULIA_DEPOT_PATH} """ ), ] def get_assemble_scripts(self): """ Return series of build-steps specific to "this" Julia repository Instantiate and then precompile all packages in the repos julia environment. The parent, CondaBuildPack, will add the build steps for any needed Python packages found in environment.yml. """ return super().get_assemble_scripts() + [ ( "${NB_USER}", r""" julia -e "using Pkg; Pkg.add(\"IJulia\"); using IJulia; installkernel(\"Julia\", \"--project=${REPO_DIR}\", env=Dict(\"JUPYTER_DATA_DIR\"=>\"${NB_PYTHON_PREFIX}/share/jupyter\"));" && \ julia --project=${REPO_DIR} -e 'using Pkg; Pkg.instantiate(); pkg"precompile"' """ ) ] def detect(self): """ Check if current repo should be built with the Julia Build pack super().detect() is not called in this function - it would return false unless an `environment.yml` is present and we do not want to require the presence of a `environment.yml` to use Julia. Instead we just check if the path to `Project.toml` or `JuliaProject.toml` exists. """ return os.path.exists(self.binder_path('Project.toml')) or os.path.exists(self.binder_path('JuliaProject.toml'))