Document when Camera::viewport_to_world and related methods return No… #203
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: CI | |
| on: | |
| merge_group: | |
| pull_request: | |
| push: | |
| branches: | |
| - main | |
| env: | |
| CARGO_TERM_COLOR: always | |
| NIGHTLY_TOOLCHAIN: nightly | |
| jobs: | |
| build: | |
| strategy: | |
| matrix: | |
| os: [windows-latest, ubuntu-latest, macos-latest] | |
| runs-on: ${{ matrix.os }} | |
| timeout-minutes: 30 | |
| steps: | |
| - uses: actions/checkout@v3 | |
| - uses: actions/cache@v3 | |
| with: | |
| path: | | |
| ~/.cargo/bin/ | |
| ~/.cargo/registry/index/ | |
| ~/.cargo/registry/cache/ | |
| ~/.cargo/git/db/ | |
| target/ | |
| key: ${{ runner.os }}-cargo-build-stable-${{ hashFiles('**/Cargo.toml') }} | |
| - uses: dtolnay/rust-toolchain@stable | |
| - name: Install alsa and udev | |
| run: sudo apt-get update; sudo apt-get install --no-install-recommends libasound2-dev libudev-dev | |
| if: runner.os == 'linux' | |
| - name: Build & run tests | |
| # See tools/ci/src/main.rs for the commands this runs | |
| run: cargo run -p ci -- test | |
| env: | |
| CARGO_INCREMENTAL: 0 | |
| RUSTFLAGS: "-C debuginfo=0 -D warnings" | |
| ci: | |
| runs-on: ubuntu-latest | |
| timeout-minutes: 30 | |
| steps: | |
| - uses: actions/checkout@v3 | |
| - uses: actions/cache@v3 | |
| with: | |
| path: | | |
| ~/.cargo/bin/ | |
| ~/.cargo/registry/index/ | |
| ~/.cargo/registry/cache/ | |
| ~/.cargo/git/db/ | |
| target/ | |
| key: ${{ runner.os }}-cargo-ci-${{ hashFiles('**/Cargo.toml') }} | |
| - uses: dtolnay/rust-toolchain@stable | |
| with: | |
| components: rustfmt, clippy | |
| - name: Install alsa and udev | |
| run: sudo apt-get update; sudo apt-get install --no-install-recommends libasound2-dev libudev-dev libwayland-dev libxkbcommon-dev | |
| - name: CI job | |
| # See tools/ci/src/main.rs for the commands this runs | |
| run: cargo run -p ci -- lints | |
| miri: | |
| runs-on: ubuntu-latest | |
| timeout-minutes: 60 | |
| steps: | |
| - uses: actions/checkout@v3 | |
| - uses: actions/cache@v3 | |
| with: | |
| path: | | |
| ~/.cargo/bin/ | |
| ~/.cargo/registry/index/ | |
| ~/.cargo/registry/cache/ | |
| ~/.cargo/git/db/ | |
| target/ | |
| key: ${{ runner.os }}-cargo-miri-${{ hashFiles('**/Cargo.toml') }} | |
| - uses: dtolnay/rust-toolchain@master | |
| with: | |
| toolchain: ${{ env.NIGHTLY_TOOLCHAIN }} | |
| components: miri | |
| - name: Install alsa and udev | |
| run: sudo apt-get update; sudo apt-get install --no-install-recommends libasound2-dev libudev-dev libwayland-dev libxkbcommon-dev | |
| - name: CI job | |
| # To run the tests one item at a time for troubleshooting, use | |
| # cargo --quiet test --lib -- --list | sed 's/: test$//' | MIRIFLAGS="-Zmiri-disable-isolation -Zmiri-permissive-provenance -Zmiri-disable-weak-memory-emulation" xargs -n1 cargo miri test -p bevy_ecs --lib -- --exact | |
| run: cargo miri test -p bevy_ecs | |
| env: | |
| # -Zrandomize-layout makes sure we dont rely on the layout of anything that might change | |
| RUSTFLAGS: -Zrandomize-layout | |
| # https://github.com/rust-lang/miri#miri--z-flags-and-environment-variables | |
| # -Zmiri-disable-isolation is needed because our executor uses `fastrand` which accesses system time. | |
| # -Zmiri-permissive-provenance disables warnings against int2ptr casts (since those are used by once_cell) | |
| # -Zmiri-ignore-leaks is necessary because a bunch of tests don't join all threads before finishing. | |
| MIRIFLAGS: -Zmiri-ignore-leaks -Zmiri-disable-isolation -Zmiri-permissive-provenance | |
| check-compiles: | |
| runs-on: ubuntu-latest | |
| timeout-minutes: 30 | |
| needs: ci | |
| steps: | |
| - uses: actions/checkout@v3 | |
| - uses: actions/cache@v3 | |
| with: | |
| path: | | |
| ~/.cargo/bin/ | |
| ~/.cargo/registry/index/ | |
| ~/.cargo/registry/cache/ | |
| ~/.cargo/git/db/ | |
| target/ | |
| crates/bevy_ecs_compile_fail_tests/target/ | |
| crates/bevy_reflect_compile_fail_tests/target/ | |
| key: ${{ runner.os }}-cargo-check-compiles-${{ hashFiles('**/Cargo.toml') }} | |
| - uses: dtolnay/rust-toolchain@stable | |
| with: | |
| toolchain: stable | |
| - name: Install alsa and udev | |
| run: sudo apt-get update; sudo apt-get install --no-install-recommends libasound2-dev libudev-dev | |
| - name: Check Compile | |
| # See tools/ci/src/main.rs for the commands this runs | |
| run: cargo run -p ci -- compile | |
| build-wasm: | |
| runs-on: ubuntu-latest | |
| timeout-minutes: 30 | |
| needs: build | |
| steps: | |
| - uses: actions/checkout@v3 | |
| - uses: actions/cache@v3 | |
| with: | |
| path: | | |
| ~/.cargo/bin/ | |
| ~/.cargo/registry/index/ | |
| ~/.cargo/registry/cache/ | |
| ~/.cargo/git/db/ | |
| target/ | |
| key: ubuntu-assets-cargo-build-wasm-stable-${{ hashFiles('**/Cargo.toml') }} | |
| - uses: dtolnay/rust-toolchain@stable | |
| with: | |
| target: wasm32-unknown-unknown | |
| - name: Check wasm | |
| run: cargo check --target wasm32-unknown-unknown | |
| env: | |
| RUSTFLAGS: --cfg=web_sys_unstable_apis | |
| markdownlint: | |
| runs-on: ubuntu-latest | |
| timeout-minutes: 30 | |
| needs: check-missing-features-in-docs | |
| if: always() | |
| steps: | |
| - uses: actions/checkout@v3 | |
| with: | |
| # Full git history is needed to get a proper list of changed files within `super-linter` | |
| fetch-depth: 0 | |
| - name: Run Markdown Lint | |
| uses: docker://ghcr.io/github/super-linter:slim-v4 | |
| env: | |
| MULTI_STATUS: false | |
| VALIDATE_ALL_CODEBASE: false | |
| VALIDATE_MARKDOWN: true | |
| DEFAULT_BRANCH: main | |
| run-examples: | |
| runs-on: ubuntu-latest | |
| timeout-minutes: 30 | |
| steps: | |
| - name: Install Bevy dependencies | |
| run: | | |
| sudo apt-get update; | |
| DEBIAN_FRONTEND=noninteractive sudo apt-get install --no-install-recommends -yq \ | |
| libasound2-dev libudev-dev; | |
| - name: install xvfb, llvmpipe and lavapipe | |
| run: | | |
| sudo apt-get update -y -qq | |
| sudo add-apt-repository ppa:oibaf/graphics-drivers -y | |
| sudo apt-get update | |
| sudo apt install -y xvfb libegl1-mesa libgl1-mesa-dri libxcb-xfixes0-dev mesa-vulkan-drivers | |
| - uses: actions/checkout@v3 | |
| - uses: actions/cache@v3 | |
| with: | |
| path: | | |
| ~/.cargo/bin/ | |
| ~/.cargo/registry/index/ | |
| ~/.cargo/registry/cache/ | |
| ~/.cargo/git/db/ | |
| target/ | |
| key: ${{ runner.os }}-cargo-run-examples-${{ hashFiles('**/Cargo.toml') }} | |
| - uses: dtolnay/rust-toolchain@stable | |
| - name: Build bevy | |
| # this uses the same command as when running the example to ensure build is reused | |
| run: | | |
| TRACE_CHROME=trace-alien_cake_addict.json CI_TESTING_CONFIG=.github/example-run/alien_cake_addict.ron cargo build --example alien_cake_addict --features "bevy_ci_testing,trace,trace_chrome" | |
| - name: Run examples | |
| run: | | |
| for example in .github/example-run/*.ron; do | |
| example_name=`basename $example .ron` | |
| echo -n $example_name > last_example_run | |
| echo "running $example_name - "`date` | |
| time TRACE_CHROME=trace-$example_name.json CI_TESTING_CONFIG=$example xvfb-run cargo run --example $example_name --features "bevy_ci_testing,trace,trace_chrome" | |
| sleep 10 | |
| if [ `find ./ -maxdepth 1 -name 'screenshot-*.png' -print -quit` ]; then | |
| mkdir screenshots-$example_name | |
| mv screenshot-*.png screenshots-$example_name/ | |
| fi | |
| done | |
| zip traces.zip trace*.json | |
| zip -r screenshots.zip screenshots-* | |
| - name: save traces | |
| uses: actions/upload-artifact@v3 | |
| with: | |
| name: example-traces.zip | |
| path: traces.zip | |
| - name: save screenshots | |
| uses: actions/upload-artifact@v3 | |
| with: | |
| name: screenshots.zip | |
| path: screenshots.zip | |
| - name: Save PR number | |
| if: ${{ failure() && github.event_name == 'pull_request' }} | |
| run: | | |
| mkdir -p ./example-run | |
| echo ${{ github.event.number }} > ./example-run/NR | |
| mv last_example_run ./example-run/ | |
| - uses: actions/upload-artifact@v2 | |
| if: ${{ failure() && github.event_name == 'pull_request' }} | |
| with: | |
| name: example-run | |
| path: example-run/ | |
| check-doc: | |
| runs-on: ubuntu-latest | |
| timeout-minutes: 30 | |
| steps: | |
| - uses: actions/checkout@v3 | |
| - uses: actions/cache@v3 | |
| with: | |
| path: | | |
| ~/.cargo/bin/ | |
| ~/.cargo/registry/index/ | |
| ~/.cargo/registry/cache/ | |
| ~/.cargo/git/db/ | |
| target/ | |
| key: ${{ runner.os }}-check-doc-${{ hashFiles('**/Cargo.toml') }} | |
| - uses: dtolnay/rust-toolchain@stable | |
| - name: Install alsa and udev | |
| run: sudo apt-get update; sudo apt-get install --no-install-recommends libasound2-dev libudev-dev libwayland-dev libxkbcommon-dev | |
| if: runner.os == 'linux' | |
| - name: Build and check doc | |
| # See tools/ci/src/main.rs for the commands this runs | |
| run: cargo run -p ci -- doc | |
| env: | |
| CARGO_INCREMENTAL: 0 | |
| RUSTFLAGS: "-C debuginfo=0" | |
| # This currently report a lot of false positives | |
| # Enable it again once it's fixed - https://github.com/bevyengine/bevy/issues/1983 | |
| # - name: Installs cargo-deadlinks | |
| # run: cargo install --force cargo-deadlinks | |
| # - name: Checks dead links | |
| # run: cargo deadlinks --dir target/doc/bevy | |
| # continue-on-error: true | |
| check-missing-examples-in-docs: | |
| runs-on: ubuntu-latest | |
| timeout-minutes: 30 | |
| steps: | |
| - uses: actions/checkout@v3 | |
| - name: check for missing metadata | |
| id: missing-metadata | |
| run: cargo run -p build-templated-pages -- check-missing examples | |
| - name: check for missing update | |
| run: cargo run -p build-templated-pages -- update examples | |
| - name: Check for modified files | |
| id: missing-update | |
| run: | | |
| echo "if this step fails, run the following command and commit the changed file on your PR." | |
| echo " > cargo run -p build-templated-pages -- update examples" | |
| git diff --quiet HEAD -- | |
| - name: Save PR number | |
| if: ${{ failure() && github.event_name == 'pull_request' }} | |
| run: | | |
| mkdir -p ./missing-examples | |
| echo ${{ github.event.number }} > ./missing-examples/NR | |
| - name: log failed task - missing metadata | |
| if: ${{ failure() && github.event_name == 'pull_request' && steps.missing-metadata.conclusion == 'failure' }} | |
| run: touch ./missing-examples/missing-metadata | |
| - name: log failed task - missing update | |
| if: ${{ failure() && github.event_name == 'pull_request' && steps.missing-update.conclusion == 'failure' }} | |
| run: touch ./missing-examples/missing-update | |
| - uses: actions/upload-artifact@v2 | |
| if: ${{ failure() && github.event_name == 'pull_request' }} | |
| with: | |
| name: missing-examples | |
| path: missing-examples/ | |
| check-missing-features-in-docs: | |
| runs-on: ubuntu-latest | |
| timeout-minutes: 30 | |
| needs: check-missing-examples-in-docs | |
| steps: | |
| - uses: actions/checkout@v3 | |
| - name: check for missing features | |
| id: missing-features | |
| run: cargo run -p build-templated-pages -- check-missing features | |
| - name: check for missing update | |
| run: cargo run -p build-templated-pages -- update features | |
| - name: Check for modified files | |
| id: missing-update | |
| run: | | |
| echo "if this step fails, run the following command and commit the changed file on your PR." | |
| echo " > cargo run -p build-templated-pages -- update features" | |
| git diff --quiet HEAD -- | |
| - name: Save PR number | |
| if: ${{ failure() && github.event_name == 'pull_request' }} | |
| run: | | |
| mkdir -p ./missing-features | |
| echo ${{ github.event.number }} > ./missing-features/NR | |
| - name: log failed task - missing features | |
| if: ${{ failure() && github.event_name == 'pull_request' && steps.missing-features.conclusion == 'failure' }} | |
| run: touch ./missing-features/missing-features | |
| - name: log failed task - missing update | |
| if: ${{ failure() && github.event_name == 'pull_request' && steps.missing-update.conclusion == 'failure' }} | |
| run: touch ./missing-features/missing-update | |
| - uses: actions/upload-artifact@v2 | |
| if: ${{ failure() && github.event_name == 'pull_request' }} | |
| with: | |
| name: missing-features | |
| path: missing-features/ | |
| msrv: | |
| runs-on: ubuntu-latest | |
| timeout-minutes: 30 | |
| needs: build | |
| steps: | |
| - uses: actions/checkout@v3 | |
| - uses: actions/cache@v3 | |
| with: | |
| path: | | |
| ~/.cargo/bin/ | |
| ~/.cargo/registry/index/ | |
| ~/.cargo/registry/cache/ | |
| ~/.cargo/git/db/ | |
| target/ | |
| key: ${{ runner.os }}-cargo-msrv-${{ hashFiles('**/Cargo.toml') }} | |
| - name: get MSRV | |
| run: | | |
| msrv=`cargo metadata --no-deps --format-version 1 | jq --raw-output '.packages[] | select(.name=="bevy") | .rust_version'` | |
| echo "MSRV=$msrv" >> $GITHUB_ENV | |
| - uses: dtolnay/rust-toolchain@master | |
| with: | |
| toolchain: ${{ env.MSRV }} | |
| - name: Install alsa and udev | |
| run: sudo apt-get update; sudo apt-get install --no-install-recommends libasound2-dev libudev-dev | |
| - name: Run cargo check | |
| id: check | |
| run: cargo check | |
| - name: Save PR number | |
| if: ${{ failure() && github.event_name == 'pull_request' && steps.check.conclusion == 'failure' }} | |
| run: | | |
| mkdir -p ./msrv | |
| echo ${{ github.event.number }} > ./msrv/NR | |
| - uses: actions/upload-artifact@v2 | |
| if: ${{ failure() && github.event_name == 'pull_request' && steps.check.conclusion == 'failure' }} | |
| with: | |
| name: msrv | |
| path: msrv/ |