Skip to content

corrosion-rs/corrosion

Folders and files

NameName
Last commit message
Last commit date

Latest commit

f783ee8 · Jan 12, 2025
Dec 4, 2024
Jan 12, 2025
Jan 1, 2025
Jan 12, 2025
Aug 10, 2024
May 11, 2024
Oct 8, 2024
Mar 7, 2018
May 11, 2024
Jan 1, 2025

Repository files navigation

Corrosion

Build Status Documentation License

Corrosion, formerly known as cmake-cargo, is a tool for integrating Rust into an existing CMake project. Corrosion can automatically import executables, static libraries, and dynamic libraries from a workspace or package manifest (Cargo.toml file).

Features

  • Automatic Import of Executable, Static, and Shared Libraries from Rust Crate
  • Easy Installation of Rust Executables
  • Trivially Link Rust Executables to C/C++ Libraries in Tree
  • Multi-Config Generator Support
  • Simple Cross-Compilation

Sample Usage with FetchContent

Using the CMake FetchContent module allows you to easily integrate corrosion into your build. Other methods including installing corrosion or adding it as a subdirectory are covered in the setup chapter of the corrosion documentation.

include(FetchContent)

FetchContent_Declare(
    Corrosion
    GIT_REPOSITORY https://github.com/corrosion-rs/corrosion.git
    GIT_TAG v0.5 # Optionally specify a commit hash, version tag or branch here
)
FetchContent_MakeAvailable(Corrosion)

# Import targets defined in a package or workspace manifest `Cargo.toml` file
corrosion_import_crate(MANIFEST_PATH rust-lib/Cargo.toml)

add_executable(your_cpp_bin main.cpp)
target_link_libraries(your_cpp_bin PUBLIC rust-lib)

Requirements

Stable v0.5 Release

  • CMake 3.15 or newer. Some features may only be available on more recent CMake versions
  • Rust 1.46 or newer. Some platforms / features may require more recent Rust versions

Development (master branch)

  • CMake 3.22 or newer