rpm-ostree/cbindgen.toml

autogen_warning = "/* Warning, this file is autogenerated by cbindgen. Don't modify this manually. */"
language = "C"
header = "#pragma once\n#include \"rpmostree-rust-prelude.h\"\nG_BEGIN_DECLS\n"
trailer = """
G_DEFINE_AUTOPTR_CLEANUP_FUNC(RORTreefile, ror_treefile_free)
G_END_DECLS
"""

[export]
prefix = "ROR"
# Here we exclude entries belonging to the C side which we use on the Rust side and so
# doesn't make sense to re-export.
exclude = ["RpmOstreeOrigin",
           "rpmostree_get_repodata_chksum_repr",
           "rpmostree_origin_get_live_state" ]

[parse]
# We don't want cbindgen to parse libdnf-sys, since we're clients of the library, not
# providers. This should already be guaranteed by `parse_deps` being `false`, but include
# this here too to be explicit.
exclude = ["libdnf-sys"]
Use cbindgen If we're going to scale out our oxidation, let's follow the path of Firefox (and other projects) further and use cbindgen: https://github.com/eqrion/cbindgen It's actually nice that `cbindgen` is packaged today in Fedora, but I doubt it is elsewhere; we may end up needing to push that forward, or just vendor it via a `build.rs` script and Cargo. I chose to rename things to `ROR`/`ror_` since it's shorter. I am tempted a bit to rename our internal functions to just `ro_` to or so. Closes: #1516 Approved by: jlebon 2018-08-24 17:42:31 +03:00			`autogen_warning = "/* Warning, this file is autogenerated by cbindgen. Don't modify this manually. */"`
			`language = "C"`
Convert some code to compile in C++ mode This is part of investigating using https://cxx.rs/ In order to make this really work, we need to convert some of our C code to C++ so we can include cxx.rs-generated code. This starts by converting just two files as a starting point. I did the minimal porting; I didn't try to actually rewrite them to resemble modern C++, just "C in C++ mode". 2020-11-22 22:55:06 +03:00			`header = "#pragma once\n#include \"rpmostree-rust-prelude.h\"\nG_BEGIN_DECLS\n"`
rust/bindgen: Add an autoptr cleanup for our struct I'm going to add a new user soon. This should probably be a best practice. Ideally...cbindgen would have a way to add some wrapper bits around any types it defines or something? Closes: #1559 Approved by: jlebon 2018-09-13 23:11:48 +03:00			`trailer = """`
			`G_DEFINE_AUTOPTR_CLEANUP_FUNC(RORTreefile, ror_treefile_free)`
Convert some code to compile in C++ mode This is part of investigating using https://cxx.rs/ In order to make this really work, we need to convert some of our C code to C++ so we can include cxx.rs-generated code. This starts by converting just two files as a starting point. I did the minimal porting; I didn't try to actually rewrite them to resemble modern C++, just "C in C++ mode". 2020-11-22 22:55:06 +03:00			`G_END_DECLS`
rust/bindgen: Add an autoptr cleanup for our struct I'm going to add a new user soon. This should probably be a best practice. Ideally...cbindgen would have a way to add some wrapper bits around any types it defines or something? Closes: #1559 Approved by: jlebon 2018-09-13 23:11:48 +03:00			`"""`

Use cbindgen If we're going to scale out our oxidation, let's follow the path of Firefox (and other projects) further and use cbindgen: https://github.com/eqrion/cbindgen It's actually nice that `cbindgen` is packaged today in Fedora, but I doubt it is elsewhere; we may end up needing to push that forward, or just vendor it via a `build.rs` script and Cargo. I chose to rename things to `ROR`/`ror_` since it's shorter. I am tempted a bit to rename our internal functions to just `ro_` to or so. Closes: #1516 Approved by: jlebon 2018-08-24 17:42:31 +03:00			`[export]`
			`prefix = "ROR"`
daemon/syscore: push livefs introspection to Rust This starts bridging parts of the daemon syscore logic to Rust plumbing, moving the livefs detection logic over there as a first consumer. That was the simplest logic available for wiring, and mostly meant as a sanity check. 2020-10-29 13:24:41 +03:00			`# Here we exclude entries belonging to the C side which we use on the Rust side and so`
rust: move libdnf-sys module to its own crate This is just a cleaner arrangement to make the separation more explicit. It also matches what most other wrapper crates do. One advantage of this is that we can tell cbindgen directly that we don't want it to ever export symbols from `libdnf-sys`. Related discussions in: https://github.com/coreos/rpm-ostree/pull/2047 2020-04-07 18:09:17 +03:00			`# doesn't make sense to re-export.`
daemon/syscore: push livefs introspection to Rust This starts bridging parts of the daemon syscore logic to Rust plumbing, moving the livefs detection logic over there as a first consumer. That was the simplest logic available for wiring, and mostly meant as a sanity check. 2020-10-29 13:24:41 +03:00			`exclude = ["RpmOstreeOrigin",`
			`"rpmostree_get_repodata_chksum_repr",`
			`"rpmostree_origin_get_live_state" ]`
rust: move libdnf-sys module to its own crate This is just a cleaner arrangement to make the separation more explicit. It also matches what most other wrapper crates do. One advantage of this is that we can tell cbindgen directly that we don't want it to ever export symbols from `libdnf-sys`. Related discussions in: https://github.com/coreos/rpm-ostree/pull/2047 2020-04-07 18:09:17 +03:00
			`[parse]`
			`# We don't want cbindgen to parse libdnf-sys, since we're clients of the library, not`
			# providers. This should already be guaranteed by `parse_deps` being `false`, but include
			`# this here too to be explicit.`
			`exclude = ["libdnf-sys"]`