julia-set 0.1.0

Julia set computation and rendering
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162

name: Rust

on:
  push:
    branches: [ master ]
  pull_request:
    branches: [ master ]

env:
  # Minimum supported Rust version.
  msrv: 1.44.0
  # Nightly Rust toolchain for building docs.
  nightly: nightly-2020-10-24

jobs:
  # Checks minimum supported Rust version.
  build-msrv:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v2

      - name: Cache cargo build
        uses: actions/cache@v1
        with:
          path: target
          key: ${{ runner.os }}-msrv-cargo-build-target

      - name: Install Rust
        uses: actions-rs/toolchain@v1
        with:
          toolchain: ${{ env.msrv }}
          override: true

      - name: Run tests
        uses: actions-rs/cargo@v1
        with:
          command: test
          args: --features dyn_cpu_backend

  build:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v2

      - name: Install packages for Vulkan
        run: |
          sudo apt-get update
          sudo apt-get install -y --no-install-suggests --no-install-recommends \
            cmake libvulkan-dev vulkan-utils

      - name: Install packages for POCL
        run: |
          wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key | sudo apt-key add -
          sudo add-apt-repository 'deb [arch=amd64] http://apt.llvm.org/bionic/ llvm-toolchain-bionic-9 main'
          sudo apt-get update
          sudo apt-get install -y --no-install-suggests --no-install-recommends \
            build-essential cmake pkg-config libhwloc-dev zlib1g-dev \
            ocl-icd-libopencl1 ocl-icd-dev ocl-icd-opencl-dev clinfo \
            clang-9 libclang-9-dev llvm-9 llvm-9-dev

      - name: Cache POCL binaries
        uses: actions/cache@v1
        with:
          path: ~/.local
          key: ${{ runner.os }}-pocl1.5

      - name: Install POCL
        env:
          POCL_VER: 1.5
        run: |
          if [[ ! -x ~/.local/pocl-$POCL_VER/build/bin/poclcc ]]; then
            mkdir -p ~/.local && cd ~/.local
            curl -sSL "https://github.com/pocl/pocl/archive/v$POCL_VER.tar.gz" > pocl-$POCL_VER.tar.gz
            tar xf "pocl-$POCL_VER.tar.gz"
            cd pocl-$POCL_VER
            mkdir -p build && cd build
            cmake -DWITH_LLVM_CONFIG=/usr/bin/llvm-config-9 \
              -DCMAKE_INSTALL_PREFIX=/usr \
              -DLLC_HOST_CPU=x86-64 ..
            make
          fi
          cd ~/.local/pocl-$POCL_VER/build && sudo make install
          clinfo

      - name: Cache cargo build
        uses: actions/cache@v1
        with:
          path: target
          key: ${{ runner.os }}-cargo-build-target

      - name: Install Rust
        uses: actions-rs/toolchain@v1
        with:
          toolchain: stable
          override: true
          components: rustfmt,clippy

      - name: Format
        uses: actions-rs/cargo@v1
        with:
          command: fmt
          args: --all -- --check
      - name: Clippy
        uses: actions-rs/clippy-check@v1
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          args: --all-targets --all-features -- -D warnings

      - name: Run tests
        uses: actions-rs/cargo@v1
        with:
          command: test
          args: --features dyn_cpu_backend,opencl_backend --all-targets
          # FIXME: Is it possible to get Vulkan working in CI?
      - name: Run doc tests
        uses: actions-rs/cargo@v1
        with:
          command: test
          args: --all-features --doc

  # Building docs does not require an OpenCL libraries or implementation.
  document:
    needs:
      - build
      - build-msrv
    if: github.event_name == 'push'
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v2
        with:
          persist-credentials: false

      - name: Cache cargo build
        uses: actions/cache@v1
        with:
          path: target
          key: ${{ runner.os }}-docs-cargo-build-target

      - name: Install Rust
        uses: actions-rs/toolchain@v1
        with:
          toolchain: ${{ env.nightly }}
          profile: minimal
          override: true

      - name: Build docs
        run: |
          cargo clean --doc && \
          cargo rustdoc --all-features -- \
            --cfg docsrs -Z unstable-options \
            --extern-html-root-url ocl=https://docs.rs/ocl/~0.19

      - name: Deploy
        uses: JamesIves/github-pages-deploy-action@releases/v3
        with:
          ACCESS_TOKEN: ${{ secrets.ACCESS_TOKEN }}
          BRANCH: gh-pages
          FOLDER: target/doc
          SINGLE_COMMIT: true