Added documentation for the src/ module. Added warning for missing docs, fixed missing docs in src/de/mod.rs

This commit is contained in:
Victor Koenders 2021-10-14 18:04:13 +02:00
parent 7b85fc168e
commit b480d2b3b3
4 changed files with 11 additions and 3 deletions

View File

@ -101,6 +101,9 @@ pub trait Config: InternalConfig {
impl<T: InternalConfig> Config for T {} impl<T: InternalConfig> Config for T {}
/// The default config. By default this will be:
/// - Little endian
/// - Variable int encoding
#[derive(Copy, Clone)] #[derive(Copy, Clone)]
pub struct Default; pub struct Default;

View File

@ -1,3 +1,5 @@
//! Decoder-based structs and traits.
use crate::error::DecodeError; use crate::error::DecodeError;
mod decoder; mod decoder;

View File

@ -40,7 +40,7 @@ pub enum DecodeError {
/// the max index of the enum. /// the max index of the enum.
max: u32, max: u32,
// The index of the enum that the decoder encountered /// The index of the enum that the decoder encountered
found: u32, found: u32,
}, },
@ -48,8 +48,10 @@ pub enum DecodeError {
Utf8(core::str::Utf8Error), Utf8(core::str::Utf8Error),
} }
/// Integer types. Used by [DecodeError]. These types have no purpose other than being shown in errors.
#[non_exhaustive] #[non_exhaustive]
#[derive(Debug)] #[derive(Debug)]
#[allow(missing_docs)]
pub enum IntegerType { pub enum IntegerType {
U16, U16,
U32, U32,

View File

@ -1,4 +1,5 @@
#![no_std] #![no_std]
#![warn(missing_docs)]
//! Bincode is a crate for encoding and decoding using a tiny binary //! Bincode is a crate for encoding and decoding using a tiny binary
//! serialization strategy. Using it, you can easily go from having //! serialization strategy. Using it, you can easily go from having
@ -58,10 +59,10 @@ pub fn encode_into_slice<E: enc::Encodeable>(
pub fn encode_into_slice_with_config<E: enc::Encodeable, C: Config>( pub fn encode_into_slice_with_config<E: enc::Encodeable, C: Config>(
val: E, val: E,
dst: &mut [u8], dst: &mut [u8],
_config: C, config: C,
) -> Result<usize, error::EncodeError> { ) -> Result<usize, error::EncodeError> {
let writer = enc::write::SliceWriter::new(dst); let writer = enc::write::SliceWriter::new(dst);
let mut encoder = enc::Encoder::<_, C>::new(writer); let mut encoder = enc::Encoder::<_, C>::new(writer, config);
val.encode(&mut encoder)?; val.encode(&mut encoder)?;
Ok(encoder.into_writer().bytes_written()) Ok(encoder.into_writer().bytes_written())
} }