Awesome
ci_info
Provides current CI environment information.
<a name="overview"></a>
Overview
This library main goal is to provide development/build tools such as cargo-make the needed information on the current CI environment.<br> Inspired by the ci-info npm module.
<a name="usage"></a>
Usage
Simply include the library and invoke the get function to pull all info as follows:
Fetching Info
<!--{ "examples/get.rs" | lines: 3 | code: rust }-->fn main() {
// Just check if a CI environment is detected.
let ci = ci_info::is_ci();
println!("Is CI: {}", ci);
// Get CI environment information
let info = ci_info::get();
println!("Is CI: {}", info.ci);
if let Some(vendor) = info.vendor {
println!("Vendor: {:#?}", vendor);
println!("Name: {:#?}", info.name.unwrap());
}
if let Some(pr) = info.pr {
println!("Is PR: {:#?}", pr);
}
if let Some(branch_name) = info.branch_name {
println!("Branch Name: {:#?}", branch_name);
}
}
<!--{ end }-->
Mocking CI environment
<!--{ "examples/mock.rs" | lines: 2 | code: rust }-->use ci_info::types::{CiInfo, Vendor};
fn main() {
// create the CI info manually
let mut mock_info = CiInfo::new();
mock_info.vendor = Some(Vendor::TravisCI);
mock_info.ci = true;
mock_info.pr = Some(true);
mock_info.branch_name = Some("dev_branch".to_string());
// mock environment
ci_info::mock_ci(&mock_info);
let info = ci_info::get();
assert!(info.ci);
assert!(info.pr.unwrap());
assert_eq!(info.vendor.unwrap(), Vendor::TravisCI);
assert_eq!(info.name.unwrap(), "Travis CI");
assert_eq!(info.branch_name.unwrap(), "dev_branch");
// clear CI environment
mock_info = CiInfo::new();
ci_info::mock_ci(&mock_info);
let info = ci_info::get();
assert!(!info.ci);
}
<!--{ end }-->
<a name="installation"></a>
Installation
In order to use this library, just add it as a dependency:
[dependencies]
ci_info = "^0.14.14"
There is optional serde
support that can be enabled via the serde-1
feature:
[dependencies]
ci_info = { version = "*", features = ["serde-1"] }
API Documentation
See full docs at: API Docs
Contributing
<a name="history"></a>
Release History
See Changelog
<a name="license"></a>
License
Developed by Sagie Gur-Ari and licensed under the Apache 2 open source license.