Bump versions for release with docs pointing to docs.rs

Allows us to delete github pages.
This commit is contained in:
Martin Dahl 2023-01-19 09:32:54 +01:00
parent bfe2329a99
commit 5acdeb3727
6 changed files with 28 additions and 28 deletions

View File

@ -3,25 +3,25 @@ R2R - Easy to use, runtime-agnostic, async rust bindings for ROS2.
Easy to use bindings for ROS2 that do *not* require hooking in to the ROS2 build infrastructure -- `cargo build` is all you need. Convenience Rust types are created by calling into the c introspection libraries. This circumvents the ROS2 .msg/.idl pipeline by relying on already generated C code. By default, the behavior is to build bindings to the RCL and all message types that can be found in the currently sourced ros environment.
When integration with the colcon build system is desired, a CMakeLists.txt file can be used to limit the generation of bindings to only include specific (idl) dependencies. This is done through additional environment variables. A minimal example of the colcon integration is available here: <https://github.com/m-dahl/r2r_minimal_node/>.
When integration with the colcon build system is desired, a CMakeLists.txt file can be used to limit the generation of bindings to only include specific (idl) dependencies. This is done through additional environment variables. A minimal example of the colcon integration is available here: <https://github.com/m-dahl/r2r_minimal_node>.
This library differ a bit in style from rclpy and rclcpp as it eliminates all synchronous callbacks in favor of rust futures and streams. Coupled with the rust await syntax, this makes it very pleasant to work with ROS services and actions, even in a single threaded setup (see service.rs example). The library purposefully does not chose an async runtime -- this means that the user needs to take care of any task spawning. This also limits the API to what futures-rs provides.
Manual is available on github pages <https://sequenceplanner.github.io/r2r/> (documention is lacking though).
Documentation can be found on docs.rs: <https://docs.rs/r2r/latest/r2r>.
These bindings are being written organically when things are needed by me and others so please be aware that the API will change. As of now I have no intention of wrapping all of the RCL just for the sake of completeness. However, if you need some specific functionality, feel free to open an issue or a PR!
How to use
--------------------
1. Make sure you have libclang installed. (e.g. libclang-dev on ubuntu)
2. Depend on this package in Cargo.toml: r2r = "0.6.5"
2. Depend on this package in Cargo.toml: `r2r = "0.6.6"`
3. You need to source your ROS2 installation before building/running.
4. The bindings will rebuild automatically if/when you source your workspace(s).
5. If you make changes to existing message types, run cargo clean -p msg_gen to force recompilation of the rust message types on the next build.
5. If you make changes to existing message types, run `cargo clean -p r2r_msg_gen` to force recompilation of the rust message types on the next build.
Examples of how to use the crate are included in examples/
```
. /opt/ros/foxy/setup.sh
. /opt/ros/humble/setup.sh
cargo build
cargo run --example subscriber
# In other shell

View File

@ -8,7 +8,7 @@ edition = "2021"
readme = "README.md"
homepage = "https://github.com/sequenceplanner/r2r"
repository = "https://github.com/sequenceplanner/r2r"
documentation = "https://sequenceplanner.github.io/r2r/"
documentation = "https://docs.rs/r2r/latest/r2r"
[lib]
doctest = false
@ -18,10 +18,10 @@ serde = { version = "1.0.147", features = ["derive"] }
serde_json = "1.0.89"
thiserror = "1.0.37"
lazy_static = "1.4.0"
r2r_common = { path = "../r2r_common", version = "0.3.3" }
r2r_rcl = { path = "../r2r_rcl", version = "0.3.3" }
r2r_msg_gen = { path = "../r2r_msg_gen", version = "0.3.5" }
r2r_actions = { path = "../r2r_actions", version = "0.3.4" }
r2r_common = { path = "../r2r_common", version = "0.3.4" }
r2r_rcl = { path = "../r2r_rcl", version = "0.3.4" }
r2r_msg_gen = { path = "../r2r_msg_gen", version = "0.3.6" }
r2r_actions = { path = "../r2r_actions", version = "0.3.5" }
uuid = { version = "1.2.2", features = ["serde", "v4"] }
futures = "0.3.25"
@ -32,8 +32,8 @@ tokio = { version = "1.22.0", features = ["rt-multi-thread", "macros"] }
rand = "0.8.5"
[build-dependencies]
r2r_common = { path = "../r2r_common", version = "0.3.3" }
r2r_msg_gen = { path = "../r2r_msg_gen", version = "0.3.5" }
r2r_common = { path = "../r2r_common", version = "0.3.4" }
r2r_msg_gen = { path = "../r2r_msg_gen", version = "0.3.6" }
[features]
save-bindgen = ["r2r_rcl/save-bindgen", "r2r_msg_gen/save-bindgen", "r2r_actions/save-bindgen"]

View File

@ -1,6 +1,6 @@
[package]
name = "r2r_actions"
version = "0.3.4"
version = "0.3.5"
authors = ["Martin Dahl <martin.dahl@gmail.com>"]
description = "Internal dependency to the r2r crate."
license = "MIT"
@ -8,15 +8,15 @@ edition = "2021"
readme = "README.md"
homepage = "https://github.com/sequenceplanner/r2r"
repository = "https://github.com/sequenceplanner/r2r"
documentation = "https://sequenceplanner.github.io/r2r/"
documentation = "https://docs.rs/r2r/latest/r2r"
[dependencies]
r2r_rcl = { path = "../r2r_rcl", version = "0.3.3" }
r2r_msg_gen = { path = "../r2r_msg_gen", version = "0.3.5" }
r2r_rcl = { path = "../r2r_rcl", version = "0.3.4" }
r2r_msg_gen = { path = "../r2r_msg_gen", version = "0.3.6" }
[build-dependencies]
bindgen = "0.63.0"
r2r_common = { path = "../r2r_common", version = "0.3.3" }
r2r_common = { path = "../r2r_common", version = "0.3.4" }
[features]
save-bindgen = ["r2r_rcl/save-bindgen", "r2r_msg_gen/save-bindgen"]

View File

@ -1,6 +1,6 @@
[package]
name = "r2r_common"
version = "0.3.3"
version = "0.3.4"
authors = ["Martin Dahl <martin.dahl@gmail.com>"]
description = "Minimal ros2 bindings."
license = "MIT"
@ -8,7 +8,7 @@ edition = "2021"
readme = "README.md"
homepage = "https://github.com/sequenceplanner/r2r"
repository = "https://github.com/sequenceplanner/r2r"
documentation = "https://sequenceplanner.github.io/r2r/"
documentation = "https://docs.rs/r2r/latest/r2r"
[dependencies]
bindgen = "0.63.0"

View File

@ -1,6 +1,6 @@
[package]
name = "r2r_msg_gen"
version = "0.3.5"
version = "0.3.6"
authors = ["Martin Dahl <martin.dahl@gmail.com>"]
description = "Internal dependency to the r2r crate."
license = "MIT"
@ -8,17 +8,17 @@ edition = "2021"
readme = "README.md"
homepage = "https://github.com/sequenceplanner/r2r"
repository = "https://github.com/sequenceplanner/r2r"
documentation = "https://sequenceplanner.github.io/r2r/"
documentation = "https://docs.rs/r2r/latest/r2r"
[dependencies]
lazy_static = "1.4.0"
r2r_rcl = { path = "../r2r_rcl", version = "0.3.3" }
r2r_common = { path = "../r2r_common", version = "0.3.3" }
r2r_rcl = { path = "../r2r_rcl", version = "0.3.4" }
r2r_common = { path = "../r2r_common", version = "0.3.4" }
[build-dependencies]
bindgen = "0.63.0"
r2r_rcl = { path = "../r2r_rcl", version = "0.3.3" }
r2r_common = { path = "../r2r_common", version = "0.3.3" }
r2r_rcl = { path = "../r2r_rcl", version = "0.3.4" }
r2r_common = { path = "../r2r_common", version = "0.3.4" }
heck = "0.4.0"
[features]

View File

@ -1,6 +1,6 @@
[package]
name = "r2r_rcl"
version = "0.3.3"
version = "0.3.4"
authors = ["Martin Dahl <martin.dahl@gmail.com>"]
description = "Internal dependency to the r2r crate."
license = "MIT"
@ -8,7 +8,7 @@ edition = "2021"
readme = "README.md"
homepage = "https://github.com/sequenceplanner/r2r"
repository = "https://github.com/sequenceplanner/r2r"
documentation = "https://sequenceplanner.github.io/r2r/"
documentation = "https://docs.rs/r2r/latest/r2r"
[dependencies]
paste = "1.0.9"
@ -16,7 +16,7 @@ widestring = "1.0.2"
[build-dependencies]
bindgen = "0.63.0"
r2r_common = { path = "../r2r_common", version = "0.3.3" }
r2r_common = { path = "../r2r_common", version = "0.3.4" }
[features]
save-bindgen = []