Merge branch 'docs9' into copyright

.github/workflows/ci.yml

@@ -0,0 +1,144 @@
+on:
+  pull_request:
+  push:
+    branches: main
+
+name: Continuous integration
+env:
+  latest_version: "1.78.0"
+
+jobs:
+  test:
+    name: Test
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os:
+          - windows-latest
+          - ubuntu-latest
+          - macos-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: ${{ env.latest_version }}
+      - uses: Swatinem/rust-cache@v2
+
+      - name: Install NASM for aws-lc-rs on Windows
+        if: runner.os == 'Windows'
+        uses: ilammy/setup-nasm@v1
+
+      - name: Install ninja-build tool for aws-lc-fips-sys on Windows
+        if: runner.os == 'Windows'
+        uses: seanmiddleditch/gha-setup-ninja@v5
+
+      - name: Install golang for aws-lc-fips-sys on macos
+        if: runner.os == 'MacOS'
+        uses: actions/setup-go@v5
+        with:
+          go-version: "1.22.2"
+
+      - run: cargo test --all-features --workspace --lib --tests --profile "ci"
+
+  # Check step to ensure that all targets are valid as the test step doesn't run them.
+  check:
+    name: Check
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os:
+          - windows-latest
+          - ubuntu-latest
+          - macos-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: ${{ env.latest_version }}
+
+      - name: Install NASM for aws-lc-rs on Windows
+        if: runner.os == 'Windows'
+        uses: ilammy/setup-nasm@v1
+
+      - name: Install ninja-build tool for aws-lc-fips-sys on Windows
+        if: runner.os == 'Windows'
+        uses: seanmiddleditch/gha-setup-ninja@v5
+
+      - name: Install golang for aws-lc-fips-sys on macos
+        if: runner.os == 'MacOS'
+        uses: actions/setup-go@v5
+        with:
+          go-version: "1.22.2"
+
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo check --all-features --all-targets --workspace --lib --tests --profile "ci"
+
+  docs:
+    name: Documentation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: ${{ env.latest_version }}
+      - uses: Swatinem/rust-cache@v2
+      - name: Build Documentation
+        run: cargo doc --lib --no-deps --all-features --workspace
+        env:
+          RUSTDOCFLAGS: --cfg docsrs -Dwarnings
+
+  fmt:
+    name: Rustfmt
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: ${{ env.latest_version }}
+          components: rustfmt
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo fmt --all -- --check
+
+  clippy:
+    name: Clippy
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: ${{ env.latest_version }}
+          components: clippy
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo clippy --all-features --all-targets --workspace -- -D warnings
+
+  code_coverage:
+    name: Code Coverage
+    runs-on: ubuntu-latest
+    container:
+      image: xd009642/tarpaulin:develop-nightly
+      options: --security-opt seccomp=unconfined
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+
+      - name: Install Clang
+        # Required for rocksdb
+        run: apt-get update && apt-get install -y llvm llvm-dev clang
+
+      - name: Set libclang path
+        run: echo "LIBCLANG_PATH=$(llvm-config --libdir)" >> $GITHUB_ENV
+
+      - name: Generate code coverage
+        run: |
+          cargo tarpaulin
+
+      - name: Upload to codecov.io
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          fail_ci_if_error: true

.gitignore

@@ -8,4 +8,7 @@
 !/demos/**/Cargo.lock
 
 **/.DS_Store
-*.iml
+*.iml
+
+# Code coverage files
+*.profraw

.tarpaulin.toml

@@ -0,0 +1,46 @@
+[coverage]
+exclude = [
+    "example-util",
+    "console",
+    "console-views",
+    "demand-lane",
+    "demand-map-lane",
+    "value-lane",
+    "map-lane",
+    "command-lane",
+    "value-store",
+    "map-store",
+    "supply-lane",
+    "value-lane-persistence",
+    "map-lane-persistence",
+    "value-store-persistence",
+    "map-store-persistence",
+    "event-downlink",
+    "value-downlink",
+    "map-downlink",
+    "local-downlink",
+    "http-lane",
+    "transit",
+    "transit-model",
+    "tutorial-app",
+    "tutorial-app-model",
+    "tutorial-app-generator",
+    "join_map",
+    "join_value",
+    "aggregations",
+    "time_series",
+    "swimos_form_derive",
+    "swimos_agent_derive",
+    "macro_utilities",
+    "example_client_2_2",
+    "example_server_2_2",
+    "example_client_2_3",
+    "example_server_2_3"
+]
+workspace = true
+avoid-cfg-tarpaulin = true
+profile = "ci"
+ignore-tests = true
+out = ["Xml"]
+timeout = "600s"
+all-features = true

Cargo.toml

@@ -40,6 +40,8 @@ members = [
     "example_apps/join_value",
     "example_apps/aggregations",
     "example_apps/time_series",
+    "example_apps/devguide/2_2/*",
+    "example_apps/devguide/2_3/*",
 ]
 
 exclude = [
@@ -95,11 +97,11 @@ flate2 = "1.0.22"
 bitflags = "2.5"
 rocksdb = "0.22"
 integer-encoding = "4.0.0"
-rustls = "0.20"
+rustls = "0.23.10"
 webpki = "0.22"
-webpki-roots = "0.22"
-tokio-rustls = "0.23"
-rustls-pemfile = "1.0.0"
+webpki-roots = "0.26.3"
+tokio-rustls = "0.26"
+rustls-pemfile = "2.1.2"
 trust-dns-resolver = "0.23.2"
 clap = "4.1"
 crossbeam-queue = { version = "0.3" }
@@ -119,7 +121,7 @@ regex = "1.3.6"
 fnv = "1.0.7"
 cursive = { default-features = false, version = "0.20" }
 duration-str = "0.11.2"
-quick-xml = "0.32.0"
+quick-xml = "0.34.0"
 csv = "1.2"
 serde-xml-rs = "0.6"
 axum = "0.6.20"