Lines Matching +full:cargo +full:- +full:deny
8 //! * using `protoc` command line tool and `protoc-gen-rust` plugin
14 //! If you are using non-cargo build system (like Bazel), you might prefer
15 //! using `protoc-gen-rust` plugin for `protoc`.
17 //! If you build with `cargo`, you probably want to use `Codegen` from this crate.
22 //! * `protoc`-based parser (`protoc` is a command like utility from Google protobuf)
23 //! * pure rust parser (`protobuf-parse` crate)
25 //! `protoc`-based parser is expected to parse `.proto` files very correctly:
28 //! While there are no known bugs in `protobuf-parse`, it is not tested very well.
29 //! Also `protobuf-parse` does not implement certain rarely used features of `.proto` parser,
34 //! [`protoc-bin-vendored`](https://docs.rs/protoc-bin-vendored) crate.
40 //! # pub fn protoc_bin_path() -> Result<std::path::PathBuf, std::io::Error> {
48 //! // Use `protoc-bin-vendored` bundled protoc command, optional.
55 //! // Specify output directory relative to Cargo output directory.
60 //! ## How to use `protoc-gen-rust`
65 //! [protoc crate](https://docs.rs/protoc/%3E=3.0.0-alpha))
75 //! On Ubuntu, `protobuf-compiler` package can be installed:
78 //! apt-get install protobuf-compiler
81 //! Protobuf is needed only for code generation, `rust-protobuf` runtime
84 //! 1) Install `protoc-gen-rust` program (which is `protoc` plugin)
86 //! It can be installed either from source or with `cargo install protobuf-codegen` command.
88 //! 2) Add `protoc-gen-rust` to $PATH
90 //! If you installed it with cargo, it should be
93 //! PATH="$HOME/.cargo/bin:$PATH"
99 //! protoc --rust_out . foo.proto
108 //! rust-protobuf provides two options to do that:
111 //! Simple script `sed` one-liners can be used to replace these markers with custom annotations.
117 //! rust-protobuf since version 3 no longer directly supports serde.
119 //! Rust-protobuf 3 fully supports:
122 //! [`protobuf-json-mapping`](https://docs.rs/protobuf-json-mapping)
129 …Example project](https://github.com/stepancheg/rust-protobuf/tree/master/protobuf-examples/customi…
130 //! in the rust-protobuf repository demonstrates how to do it.
132 #![deny(rustdoc::broken_intra_doc_links)]