.github/workflows/CI.yml

@@ -7,6 +7,10 @@ on:
   merge_group:
     branches: [ "master" ]
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 env:
   RUSTFLAGS: "-D warnings"
 
@@ -21,12 +25,13 @@ jobs:
         components: rustfmt
     - run: cargo fmt --all --check
 
-  deny-check:
-    name: cargo-deny check
+  deny:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v4
-    - uses: EmbarkStudios/cargo-deny-action@v2
+    - uses: hecrj/setup-rust-action@v2
+    - uses: taiki-e/install-action@cargo-deny
+    - run: cargo deny check
 
   clippy:
     runs-on: ubuntu-latest
@@ -38,8 +43,6 @@ jobs:
     - uses: taiki-e/install-action@protoc
     - uses: Swatinem/rust-cache@v2
     - run: cargo clippy --workspace --all-features --all-targets
-      env:
-        RUSTFLAGS: "-A warnings"
 
   codegen:
     runs-on: ubuntu-latest
@@ -51,21 +54,23 @@ jobs:
     - run: git diff --exit-code
 
   udeps:
-    name: Check unused dependencies
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v4
     - uses: dtolnay/rust-toolchain@master
       with:
-        toolchain: nightly-2024-08-04
+        toolchain: nightly-2024-12-01
     - uses: taiki-e/install-action@cargo-hack
     - uses: taiki-e/install-action@cargo-udeps
     - uses: taiki-e/install-action@protoc
     - uses: Swatinem/rust-cache@v2
-    - run: cargo hack udeps --workspace --exclude-features tls --each-feature
-    - run: cargo udeps --package tonic --features tls,transport
-    - run: cargo udeps --package tonic --features tls,server
-    - run: cargo udeps --package tonic --features tls,channel
+    - run: cargo hack udeps --workspace --exclude-features=_tls-any,tls,tls-aws-lc,tls-ring --each-feature
+    - run: cargo udeps --package tonic --features tls-ring,transport
+    - run: cargo udeps --package tonic --features tls-ring,server
+    - run: cargo udeps --package tonic --features tls-ring,channel
+    - run: cargo udeps --package tonic --features tls-aws-lc,transport
+    - run: cargo udeps --package tonic --features tls-aws-lc,server
+    - run: cargo udeps --package tonic --features tls-aws-lc,channel
 
   check:
     runs-on: ${{ matrix.os }}
@@ -86,17 +91,24 @@ jobs:
       run: cargo check --workspace --all-targets --all-features
 
   msrv:
-    name: Check MSRV
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v4
+    - uses: hecrj/setup-rust-action@v2
+    - name: Resolve MSRV aware dependencies
+      run: cargo update
+      env:
+        CARGO_RESOLVER_INCOMPATIBLE_RUST_VERSIONS: fallback
+    - name: Get MSRV from manifest file
+      id: msrv
+      run: echo "version=$(yq '.workspace.package.rust-version' Cargo.toml)" >> $GITHUB_OUTPUT
     - uses: hecrj/setup-rust-action@v2
       with:
-        rust-version: "1.71.1"    # msrv
+        rust-version: ${{ steps.msrv.outputs.version }}
     - uses: taiki-e/install-action@cargo-no-dev-deps
     - uses: Swatinem/rust-cache@v2
     - run: cargo no-dev-deps --no-private check --all-features
-    - run: cargo no-dev-deps --no-private doc --no-deps
+    - run: cargo no-dev-deps --no-private doc --no-deps --all-features
       env:
         RUSTDOCFLAGS: "-D warnings"
 
@@ -109,11 +121,22 @@ jobs:
     - uses: actions/checkout@v4
     - uses: hecrj/setup-rust-action@v2
     - uses: taiki-e/install-action@protoc
+    - uses: taiki-e/install-action@cargo-hack
+    - uses: taiki-e/install-action@cargo-nextest
     - uses: Swatinem/rust-cache@v2
-    - run: cargo test --workspace --all-features
+    - run: cargo nextest run --workspace --all-features
       env:
         QUICKCHECK_TESTS: 1000  # run a lot of quickcheck iterations
 
+  doc-test:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - uses: hecrj/setup-rust-action@v2
+    - uses: taiki-e/install-action@cargo-hack
+    - uses: Swatinem/rust-cache@v2
+    - run: cargo hack --no-private test --doc --all-features
+
   interop:
     name: Interop Tests
     runs-on: ${{ matrix.os }}
@@ -140,17 +163,17 @@ jobs:
       with:
         feature-group: all-features
 
-  check-external-types:
+  external-types:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v4
     - uses: dtolnay/rust-toolchain@master
       with:
-        toolchain: nightly-2024-05-01
+        toolchain: nightly-2024-06-30
     - name: Install cargo-check-external-types
       uses: taiki-e/cache-cargo-install-action@v2
       with:
-        tool: cargo-check-external-types@0.1.12
+        tool: cargo-check-external-types@0.1.13
     - uses: taiki-e/install-action@cargo-hack
     - uses: Swatinem/rust-cache@v2
     - run: cargo hack --no-private check-external-types

CHANGELOG.md

@@ -1,3 +1,5 @@
+# NOTE: ths changelog is no longer used and from version `v0.13.0` onward we will be using github releases and the changes can be found [here](https://github.com/hyperium/tonic/releases).
+
 # [0.12.3](https://github.com/hyperium/tonic/compare/v0.12.2...v0.12.3) (2024-08-29)
 
 ### Features

Cargo.toml

@@ -30,3 +30,15 @@ members = [
   "tests/skip_debug",
 ]
 resolver = "2"
+
+[workspace.package]
+rust-version = "1.75"
+
+[workspace.lints.rust]
+missing_debug_implementations = "warn"
+missing_docs = "warn"
+rust_2018_idioms = "warn"
+unreachable_pub = "warn"
+
+[workspace.lints.rustdoc]
+broken_intra_doc_links = "deny"

LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2020 Lucio Franco
+Copyright (c) 2025 Lucio Franco
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -10,7 +10,7 @@ RPC framework that puts mobile and HTTP/2 first.
 [![Crates.io](https://img.shields.io/crates/l/tonic)](LICENSE)
 
 
-[Examples] | [Website] | [Docs] | [Chat]
+[Examples] | [Website] | [Docs] | [Chat][discord]
 
 ## Overview
 
@@ -33,86 +33,42 @@ contains the tools to build clients and servers from [`protobuf`] definitions.
 
 ## Getting Started
 
+- The [`helloworld`][helloworld-tutorial] tutorial provides a basic example of using `tonic`, perfect for first time users!
+- The [`routeguide`][routeguide-tutorial] tutorial provides a complete example of using `tonic` and all its features.
+
 Examples can be found in [`examples`] and for more complex scenarios [`interop`]
 may be a good resource as it shows examples of many of the gRPC features.
 
-If you're using [rust-analyzer] we recommend you set `"rust-analyzer.cargo.buildScripts.enable": true` to correctly load
-the generated code.
-
-For IntelliJ IDEA users, please refer to [this](https://github.com/intellij-rust/intellij-rust/pull/8056) and enable
-`org.rust.cargo.evaluate.build.scripts`
-[experimental feature](https://plugins.jetbrains.com/plugin/8182-rust/docs/rust-faq.html#experimental-features).
-
 ### Rust Version
 
-`tonic`'s MSRV is `1.71.1`.
-
-```bash
-$ rustup update
-$ cargo build
-```
+`tonic`'s MSRV is `1.75`.
 
 ### Dependencies
 
-In order to build `tonic` >= 0.8.0, you need the `protoc` Protocol Buffers compiler, along with Protocol Buffers resource files.
-
-#### Ubuntu
-
-```bash
-sudo apt update && sudo apt upgrade -y
-sudo apt install -y protobuf-compiler libprotobuf-dev
-```
-
-#### Alpine Linux
+[`tonic-build`] uses `protoc` [Protocol Buffers compiler] in some APIs which compile Protocol Buffers resource files such as [`tonic_build::compile_protos()`].
 
-```sh
-sudo apk add protoc protobuf-dev
-```
-
-#### macOS
-
-Assuming [Homebrew](https://brew.sh/) is already installed. (If not, see instructions for installing Homebrew on [the Homebrew website](https://brew.sh/).)
-
-```zsh
-brew install protobuf
-```
-
-#### Windows
-
-- Download the latest version of `protoc-xx.y-win64.zip` from [HERE](https://github.com/protocolbuffers/protobuf/releases/latest)
-- Extract the file `bin\protoc.exe` and put it somewhere in the `PATH`
-- Verify installation by opening a command prompt and enter `protoc --version`
-
-### Tutorials
-
-- The [`helloworld`][helloworld-tutorial] tutorial provides a basic example of using `tonic`, perfect for first time users!
-- The [`routeguide`][routeguide-tutorial] tutorial provides a complete example of using `tonic` and all its
-features.
+[Protocol Buffers compiler]: https://protobuf.dev/downloads/
+[`tonic_build::compile_protos()`]: https://docs.rs/tonic-build/latest/tonic_build/fn.compile_protos.html
 
 ## Getting Help
 
 First, see if the answer to your question can be found in the API documentation.
 If the answer is not there, there is an active community in
-the [Tonic Discord channel][chat]. We would be happy to try to answer your
+the [Tonic Discord channel][discord]. We would be happy to try to answer your
 question. If that doesn't work, try opening an [issue] with the question.
 
-[chat]: https://discord.gg/6yGkFeN
-[issue]: https://github.com/hyperium/tonic/issues/new
+[issue]: https://github.com/hyperium/tonic/issues/new/choose
 
 ## Project Layout
 
-- [`tonic`](https://github.com/hyperium/tonic/tree/master/tonic): Generic gRPC and HTTP/2 client/server
-implementation.
-- [`tonic-build`](https://github.com/hyperium/tonic/tree/master/tonic-build): [`prost`] based service codegen.
-- [`tonic-types`](https://github.com/hyperium/tonic/tree/master/tonic-types): [`prost`] based grpc utility types
-  including support for gRPC Well Known Types.
-- [`tonic-health`](https://github.com/hyperium/tonic/tree/master/tonic-health): Implementation of the standard [gRPC
-health checking service][healthcheck]. Also serves as an example of both unary and response streaming.
-- [`tonic-reflection`](https://github.com/hyperium/tonic/tree/master/tonic-reflection): A tonic based gRPC
-reflection implementation.
-- [`examples`](https://github.com/hyperium/tonic/tree/master/examples): Example gRPC implementations showing off
-tls, load balancing and bi-directional streaming.
-- [`interop`](https://github.com/hyperium/tonic/tree/master/interop): Interop tests implementation.
+- [`tonic`]: Generic gRPC and HTTP/2 client/server implementation.
+- [`tonic-build`]: [`prost`] based service codegen.
+- [`tonic-types`]: [`prost`] based grpc utility types including support for gRPC Well Known Types.
+- [`tonic-health`]: Implementation of the standard [gRPC health checking service][healthcheck].
+  Also serves as an example of both unary and response streaming.
+- [`tonic-reflection`]: A tonic based gRPC reflection implementation.
+- [`examples`]: Example gRPC implementations showing off tls, load balancing and bi-directional streaming.
+- [`interop`]: Interop tests implementation.
 
 ## Contributing
 
@@ -134,19 +90,23 @@ terms or conditions.
 
 
 [gRPC]: https://grpc.io
-[`tonic`]: https://github.com/hyperium/tonic
+[`tonic`]: ./tonic
+[`tonic-build`]: ./tonic-build
+[`tonic-types`]: ./tonic-types
+[`tonic-health`]: ./tonic-health
+[`tonic-reflection`]: ./tonic-reflection
+[`examples`]: ./examples
+[`interop`]: ./interop
 [`tokio`]: https://github.com/tokio-rs/tokio
 [`hyper`]: https://github.com/hyperium/hyper
 [`prost`]: https://github.com/tokio-rs/prost
-[`protobuf`]: https://developers.google.com/protocol-buffers
+[`protobuf`]: https://protobuf.dev/
 [`rustls`]: https://github.com/rustls/rustls
-[`examples`]: https://github.com/hyperium/tonic/tree/master/examples
 [`interop`]: https://github.com/hyperium/tonic/tree/master/interop
 [Examples]: https://github.com/hyperium/tonic/tree/master/examples
 [Website]: https://github.com/hyperium/tonic
 [Docs]: https://docs.rs/tonic
-[Chat]: https://discord.gg/6yGkFeN
+[discord]: https://discord.gg/6yGkFeN
 [routeguide-tutorial]: https://github.com/hyperium/tonic/blob/master/examples/routeguide-tutorial.md
 [helloworld-tutorial]: https://github.com/hyperium/tonic/blob/master/examples/helloworld-tutorial.md
-[healthcheck]: https://github.com/grpc/grpc/blob/master/doc/health-checking.md
-[rust-analyzer]: https://rust-analyzer.github.io
+[healthcheck]: https://grpc.io/docs/guides/health-checking/

codegen/Cargo.toml

@@ -3,10 +3,11 @@ name = "codegen"
 authors = ["Lucio Franco <luciofranco14@gmail.com>"]
 license = "MIT"
 edition = "2021"
-publish = false
-version = "0.1.0"
 
 [dependencies]
-tempfile = "3.8.0"
 protox = "0.7"
+prettyplease = "0.2"
+quote = "1"
+syn = "2"
+tempfile = "3.8.0"
 tonic-build = {path = "../tonic-build", default-features = false, features = ["prost", "cleanup-markdown"]}