Expand description
Introduction
kusabira
is the integrated C/C++/assembly source build frontend
for the Cargo
build script.
Features
- Integrated C/C++/assembly building by
cc
and Rust FFI binding generation bybindgen
as the backends. - Multiple source and header files with the glob support by
glob
. - Single-line configuration and build execution.
- Cooperation with
system_deps
to integrate the system libraries. Cargo
metadata output tostd::io::Stdout
.- Highly flexible backend configuration via the hooks.
Terminology
The key words “IETF XXX” in this document set are to be interpreted as the documents published by IETF when, and only when, they appear in all capitals except for the -s suffix denoting plural, as shown here. This key word usage distinguishes the IETF RFCs from the Rust RFCs.
The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL
NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”,
“MAY”, and “OPTIONAL” in this document set are to be interpreted as
described in IETF BCP 14
(IETF RFC2119
,
IETF RFC8174
)
when, and only when, they appear in all capitals, as shown here.
This terminology also applies to the error messages reported by
kusabira
.
License
The terms “Licensor”, “You”, “Your”, “Work”, “Contribution” and “Contributor” in the sections of this document set regarding licenseng are to be interpreted as defined in 1. Definitions of Apache License Version 2.0 when, and only when, they appear capitalized, as shown here, as well as with any inflection.
This software is licensed under either or both of:
at Your option.
Practice of 5. Submission of Contributions, Apache License Version 2.0
Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of Apache License Version 2.0 and MIT License, without any additional terms or conditions.
Informational Definitions
Kusabira (菌), noun, Japanese
-
An anchient word for fungus or its mushroom.
-
A play of Kyogen(狂言) with the following plot:
A garden owner, tired of the fungi growing up after and after in the garden and messing up the scenary, asks a priest for the prayer to drive them away. The priest accepts the request and sets on the work. After a seeming success, the fungi grow up even worse and get the priest into a trouble. Finally, himetake(姫菌), the queen fungi, appears and blows up her big mushroom, driving away the garden owner and priest.
The performance by the Sengoroh Shigeyama family(茂山千五郎家) on Youtube.
Re-exports
pub use error::Error as KusabiraError;
Modules
- The build frontend.
- The error data.
- The ready-to-go hooks.