The derive crate for bincode. Implements bincode::Encode
and bincode::Decode
.
This crate is roughly split into 2 parts:
Most of parsing is done in the src/parse/
folder. This will generate the following types:
Attributes
, not being used currentlyVisibility
, not being used currentlyDataType
eitherStruct
orEnum
, with the name of the data type being parsedGenerics
the generics part of the type, e.g.struct Foo<'a>
GenericConstraints
the "where" part of the type
Generating the code implementation is done in either src/derive_enum.rs
and src/derive_struct.rs
.
This is supported by the structs in src/generate
. The most notable points of this module are:
StreamBuilder
is a thin but friendly wrapper aroundTokenStream
Generator
is the base type of the code generator. This has helper methods to generate implementations:ImplFor
is a helper struct for a singleimpl A for B
construction. In this functions can be defined:GenerateFnBody
is a helper struct for a single function in the aboveimpl
. This is created with a callback toFnBuilder
which helps set some properties.GenerateFnBody
has astream()
function which returnsStreamBuilder
for the function.
For additional derive testing, see the test cases in ../tests
For testing purposes, all generated code is outputted to the current target/generated/bincode
folder, under file name <struct/enum name>_Encode.rs
and <struct/enum name>_Decode.rs
. This can help with debugging.