1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70
// Copyright 2018 OysterPack Inc. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //! `oysterpack_built` is used as a build-time dependency to gather information about the cargo build //! environment. It serializes the build-time information into Rust-code, which can then be compiled //! into the final crate. //! //! ## What is the Motivation? //! From a DevOps perspective, it is critical to know exactly what is deployed. //! //! `oysterpack_built` provides the same functionality as [built](https://crates.io/crates/built). //! Its main purpose is to standardize the integration for OysterPack apps. //! //! ## How to integrate within your project //! //! 1. Add the following to **Cargo.toml**: //! ```toml //! [package] //! build = "build.rs" //! //! [build-dependencies] //! oysterpack_built = "0.2" //! ``` //! - `oysterpack_built` is added as a build dependency //! - `build.rs` is the name of the cargo build script to use //! - NOTE: By default Cargo looks up for "build.rs" file in a package root (even if you do //! not specify a value for build - see [Cargo build scripts](https://doc.rust-lang.org/cargo/reference/build-scripts.html)). //! 2. Include the following in **build.rs**: //! //! ```no_run //! extern crate oysterpack_built; //! //! fn main() { //! oysterpack_built::write_built_file(); //! } //! ``` //! 3. The build script will by default write a file named **built.rs** into Cargo's output directory. //! It can be picked up and compiled via the `op_build_mod!()` macro provided by [oysterpack_built_mod](https://crates.io/crates/oysterpack_built_mod). //! The `op_build_mod!()` will create a public module named *build*, which will contain the build-time //! information. See [oysterpack_built_mod](https://crates.io/crates/oysterpack_built_mod) for details. //! #![deny(missing_docs, missing_debug_implementations)] #![doc(html_root_url = "https://docs.rs/oysterpack_built/0.2.3")] extern crate built; use std::{env, io, path}; /// Gathers build information and generates code to make it available at runtime. /// /// # Panics /// If build-time information failed to be gathered. pub fn write_built_file() { built::write_built_file().expect("Failed to acquire build-time information"); } #[cfg(test)] mod tests;