docs.yml

#===============================================================================
# Copyright 2022 Intel Corporation
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#===============================================================================

trigger:
  branches:
    include:
    - main
    - rls/*
  paths:
    include:
    - requirements-doc.txt
    - doc/
    - .ci/pipeline/docs.yml
    - .github/Pull_Request_template.md
    - .github/workflows/docs-release.yml

pr:
  branches:
    include:
    - main
    - rls/*
  paths:
    include:
    - requirements-doc.txt
    - doc/
    - .ci/pipeline/docs.yml
    - .github/Pull_Request_template.md

variables:
  - name: 'PYTHON'
    value: python

jobs:
- job: Docs
  pool:
    vmImage: 'ubuntu-22.04'
  steps:
  - script: |
      bash .ci/scripts/describe_system.sh
    displayName: 'System info'
  - task: UsePythonVersion@0
    inputs:
      versionSpec: '3.11'
      addToPath: true
  - script: sudo apt-get update && sudo apt-get install -y clang-format pandoc 
    displayName: 'apt-get'
  - script: |
      pip install daal-devel impi-devel
      pip install -r dependencies-dev
      pip install -r requirements-doc.txt
      pip install -r requirements-test.txt
      pip list
    displayName: 'Install requirements'
  - script: |
      export DALROOT=$(dirname $(dirname $(which python)))
      export LD_LIBRARY_PATH=$(dirname $(dirname $(which python)))/lib:$LD_LIBRARY_PATH
      ./conda-recipe/build.sh
    displayName: 'Build daal4py/sklearnex'
  - script: |
      export LD_LIBRARY_PATH=$(dirname $(dirname $(which python)))/lib:$LD_LIBRARY_PATH
      cd doc/daal4py
      make html 2>&1 | tee build.log
      cat build.log
      # check for autodoc warnings
      if grep -i "autodoc" build.log; then
        echo "Autodoc Warnings detected, build failed!"
        exit 1
      fi
    displayName: 'Build daal4py documentation'
  - script: |
      export LD_LIBRARY_PATH=$(dirname $(dirname $(which python)))/lib:$LD_LIBRARY_PATH
      cd doc
      ./build-doc.sh
    displayName: 'Build scikit-learn-intelex documentation'
  - script: |
      mkdir $(Build.ArtifactStagingDirectory)/html/daal4py
      mkdir $(Build.ArtifactStagingDirectory)/html/sklearnex
      cp -R doc/daal4py/_build $(Build.ArtifactStagingDirectory)/html_daal4py
      cp -R doc/_build $(Build.ArtifactStagingDirectory)/html_sklearnex
    displayName: 'Copy build'
  - task: PublishPipelineArtifact@0
    inputs:
      artifactName: 'documentation'
      targetPath: '$(Build.ArtifactStagingDirectory)/'