[pull] master from rust-random:master

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: dhardy

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,20 @@
+---
+name: Bug report
+about: Something doesn't work as expected
+title: ''
+labels: X-bug
+assignees: ''
+
+---
+
+## Summary
+
+A clear and concise description of what the bug is.
+
+What behaviour is expected, and why?
+
+## Code sample
+
+```rust
+// Code demonstrating the problem
+```

.github/ISSUE_TEMPLATE/suggest-a-change.md

@@ -0,0 +1,28 @@
+---
+name: Suggest a change
+about: Describe this issue template's purpose here.
+title: 'CHANGE: <summary>'
+labels: ''
+assignees: ''
+
+---
+
+A change request is considered a (small) Request-For-Comment, and requires a concrete proposal and motivation.
+
+## Summary
+
+How does this affect the API / end-user? (Include API-breaking changes, value-breaking changes and API additions.)
+
+## Details
+
+What changes does this require internally?
+
+## Motivation
+
+What is the motivation for this change?
+
+Since every change has a cost (even if just API churn or extra code size), every change must have sufficient motivation. This is arguably the most important part of the RFC.
+
+## Alternatives
+
+Which alternatives might be considered, and why or why not?

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,7 @@
+- [ ] Added a `CHANGELOG.md` entry
+
+# Summary
+
+# Motivation
+
+# Details

.github/dependabot.yml

@@ -0,0 +1,11 @@
+version: 2
+updates:
+  - package-ecosystem: "cargo"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+    open-pull-requests-limit: 10
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"

.github/workflows/benches.yml

@@ -0,0 +1,42 @@
+name: Benches
+
+on:
+  push:
+    branches: [ master ]
+    paths-ignore:
+      - "**.md"
+      - "examples/**"
+  pull_request:
+    branches: [ master ]
+    paths-ignore:
+      - "**.md"
+      - "examples/**"
+
+defaults:
+  run:
+    working-directory: ./benches
+
+jobs:
+  clippy-fmt:
+    name: "Benches: Check Clippy and rustfmt"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@master
+        with:
+          toolchain: stable
+          components: clippy, rustfmt
+      - name: Rustfmt
+        run: cargo fmt -- --check
+      - name: Clippy
+        run: cargo clippy --all-targets -- -D warnings
+  benches:
+    name: "Benches: Test"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@master
+        with:
+          toolchain: nightly
+      - name: Test
+        run: RUSTFLAGS=-Dwarnings cargo test --benches

.github/workflows/gh-pages.yml

@@ -0,0 +1,47 @@
+name: gh-pages
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  deploy:
+    name: GH-pages documentation
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: https://rust-random.github.io/rand/
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install toolchain
+        uses: dtolnay/rust-toolchain@nightly
+
+      - name: Build docs
+        env:
+          RUSTDOCFLAGS: --cfg doc_cfg
+        # --all builds all crates, but with default features for other crates (okay in this case)
+        run: |
+          cargo doc --all --all-features --no-deps
+          cp utils/redirect.html target/doc/index.html
+          rm target/doc/.lock
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: './target/doc'
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/test.yml

@@ -0,0 +1,210 @@
+name: Main tests
+
+on:
+  push:
+    branches: [ master, '0.[0-9]+' ]
+    paths-ignore:
+      - "**.md"
+      - "benches/**"
+  pull_request:
+    branches: [ master, '0.[0-9]+' ]
+    paths-ignore:
+      - "**.md"
+      - "benches/**"
+
+permissions:
+  contents: read #  to fetch code (actions/checkout)
+
+jobs:
+  clippy-fmt:
+    name: Check Clippy and rustfmt
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@master
+        with:
+          toolchain: stable
+          components: clippy, rustfmt
+      - name: Check Clippy
+        run: cargo clippy --workspace -- -D warnings
+      - name: Check rustfmt
+        run: cargo fmt --all -- --check
+
+  check-doc:
+    name: Check doc
+    runs-on: ubuntu-latest
+    env:
+      RUSTDOCFLAGS: "-Dwarnings --cfg docsrs -Zunstable-options --generate-link-to-definition"
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install toolchain
+        uses: dtolnay/rust-toolchain@master
+        with:
+          toolchain: nightly
+      - name: rand
+        run: cargo doc --all-features --no-deps
+      - name: rand_core
+        run: cargo doc --all-features --package rand_core --no-deps
+      - name: rand_chacha
+        run: cargo doc --all-features --package rand_chacha --no-deps
+      - name: rand_pcg
+        run: cargo doc --all-features --package rand_pcg --no-deps
+
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+            toolchain: stable
+          - os: macos-latest
+            target: x86_64-apple-darwin
+            toolchain: stable
+            # TODO: also aarch64 / M1
+          - os: windows-latest
+            target: x86_64-pc-windows-gnu
+            toolchain: stable
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
+            toolchain: beta
+            # Test both windows-gnu and windows-msvc; use beta rust on one
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+            variant: MSRV
+            toolchain: 1.63.0
+          - os: ubuntu-latest
+            deps: sudo apt-get update ; sudo apt install gcc-multilib
+            target: i686-unknown-linux-gnu
+            toolchain: nightly
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+            toolchain: nightly
+            variant: minimal_versions
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: MSRV
+        if: ${{ matrix.variant == 'MSRV' }}
+        run: cp Cargo.lock.msrv Cargo.lock
+      - name: Install toolchain
+        uses: dtolnay/rust-toolchain@master
+        with:
+          target: ${{ matrix.target }}
+          toolchain: ${{ matrix.toolchain }}
+      - run: ${{ matrix.deps }}
+      - name: Maybe minimal versions
+        if: ${{ matrix.variant == 'minimal_versions' }}
+        run: |
+          cargo generate-lockfile -Z minimal-versions
+      - name: Maybe nightly
+        if: ${{ matrix.toolchain == 'nightly' }}
+        run: |
+          cargo test --target ${{ matrix.target }} --features=nightly
+          cargo test --target ${{ matrix.target }} --all-features
+          cargo test --target ${{ matrix.target }} --lib --tests --no-default-features
+      - name: Test rand
+        run: |
+          cargo test --target ${{ matrix.target }} --lib --tests --no-default-features
+          cargo build --target ${{ matrix.target }} --no-default-features --features alloc,os_rng,small_rng,unbiased
+          cargo test --target ${{ matrix.target }} --lib --tests --no-default-features --features=alloc,os_rng,small_rng
+          cargo test --target ${{ matrix.target }} --examples
+      - name: Test rand (all stable features)
+        run: |
+          cargo test --target ${{ matrix.target }} --features=serde,log,small_rng
+      - name: Test rand_core
+        run: |
+          cargo test --target ${{ matrix.target }} --manifest-path rand_core/Cargo.toml
+          cargo test --target ${{ matrix.target }} --manifest-path rand_core/Cargo.toml --no-default-features
+          cargo test --target ${{ matrix.target }} --manifest-path rand_core/Cargo.toml --no-default-features --features=os_rng
+      - name: Test rand_pcg
+        run: cargo test --target ${{ matrix.target }} --manifest-path rand_pcg/Cargo.toml --features=serde
+      - name: Test rand_chacha
+        run: cargo test --target ${{ matrix.target }} --manifest-path rand_chacha/Cargo.toml --features=serde
+
+  test-cross:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: powerpc-unknown-linux-gnu
+            toolchain: stable
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install toolchain
+        uses: dtolnay/rust-toolchain@master
+        with:
+          target: ${{ matrix.target }}
+          toolchain: ${{ matrix.toolchain }}
+      - name: Cache cargo plugins
+        uses: actions/cache@v4
+        with:
+          path: ~/.cargo/bin/
+          key: ${{ runner.os }}-cargo-plugins
+      - name: Install cross
+        run: cargo install cross || true
+      - name: Test
+        run: |
+          # all stable features:
+          cross test --no-fail-fast --target ${{ matrix.target }} --features=serde,log,small_rng
+          cross test --no-fail-fast --target ${{ matrix.target }} --examples
+          cross test --no-fail-fast --target ${{ matrix.target }} --manifest-path rand_core/Cargo.toml
+          cross test --no-fail-fast --target ${{ matrix.target }} --manifest-path rand_pcg/Cargo.toml --features=serde
+          cross test --no-fail-fast --target ${{ matrix.target }} --manifest-path rand_chacha/Cargo.toml
+
+  test-miri:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install toolchain
+        run: |
+          rustup toolchain install nightly --component miri
+          rustup override set nightly
+          cargo miri setup
+      - name: Test rand
+        run: |
+          cargo miri test --no-default-features --lib --tests
+          cargo miri test --features=log,small_rng
+          cargo miri test --manifest-path rand_core/Cargo.toml
+          cargo miri test --manifest-path rand_core/Cargo.toml --features=serde
+          cargo miri test --manifest-path rand_core/Cargo.toml --no-default-features
+          cargo miri test --manifest-path rand_pcg/Cargo.toml --features=serde
+          cargo miri test --manifest-path rand_chacha/Cargo.toml --no-default-features
+
+  test-no-std:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install toolchain
+        uses: dtolnay/rust-toolchain@nightly
+        with:
+            target: thumbv6m-none-eabi
+      - name: Build top-level only
+        run: cargo build --target=thumbv6m-none-eabi --no-default-features
+
+  # Disabled due to lack of known working compiler versions (not older than our MSRV)
+  # test-avr:
+  #   runs-on: ubuntu-latest
+  #   steps:
+  #     - uses: actions/checkout@v4
+  #     - name: Install toolchain
+  #       uses: dtolnay/rust-toolchain@nightly
+  #       with:
+  #           components: rust-src
+  #     - name: Build top-level only
+  #       run: cargo build -Z build-std=core --target=avr-unknown-gnu-atmega328 --no-default-features
+
+  test-ios:
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install toolchain
+        uses: dtolnay/rust-toolchain@nightly
+        with:
+            target: aarch64-apple-ios
+      - name: Build top-level only
+        run: cargo build --target=aarch64-apple-ios