chore!: Stabilize API for 1.0.0 (#20)

* chore!: Remove Encoder trait

BREAKING-CHANGE: Removes the Encoder trait in favor of ByteEncoder and
StrEncoder

* chore!: Remove deprecated `Flags` combinator

* fix: comment references Encoder::error instead of BaseEncoder::Error

Author: Altair-Bueno

examples/bson.rs

@@ -73,7 +73,7 @@ where
     fn encode(&self, encoder: &mut Encoder) -> Result<(), Self::Error> {
         let document = (
             Iter::new(&self.e_list),
-            // u8 uses `Encoder::Error`, so we need to convert it to our BsonError
+            // u8 uses `BaseEncoder::Error`, so we need to convert it to our BsonError
             // for our combinators to work.
             FromError::<_, Self::Error>::new(0u8),
         );

src/combinators/flags.rs

@@ -85,7 +85,6 @@ These types are supported when the `bytes` feature is enabled.
 )]
 mod be;
 mod cond;
-mod flags;
 mod from_error;
 mod iter;
 mod le;
@@ -94,8 +93,6 @@ mod separated;
 
 pub use be::BE;
 pub use cond::Cond;
-#[allow(deprecated)]
-pub use flags::Flags;
 pub use from_error::FromError;
 pub use iter::Iter;
 pub use le::LE;

src/combinators/mod.rs

@@ -184,61 +184,3 @@ where
         Ok(encoder.size())
     }
 }
-
-// TODO: Remove before 1.0.0
-
-/// A type that can handle an [`Encodable`] type
-///
-/// An encoder is responsible for writing bytes into a buffer or other
-/// destination. Encoders are used by encodables to write their data. Thus,
-/// encoders must uphold the same properties as encodables.
-#[deprecated(
-    since = "0.2.2",
-    note = "The `Encoder` trait has been deprecated in favor of multiple encoder traits. Please use `ByteEncoder`, `StrEncoder`, or `BaseEncoder` depending on your needs. The `Encoder` trait will be removed in 1.0.0."
-)]
-pub trait Encoder {
-    /// The error type that can be returned when encoding a value.
-    ///
-    /// For example, some encoders may return an error if the underlying buffer
-    /// is full
-    type Error;
-
-    /// Copies a slice of bytes into the encoder
-    ///
-    /// # Errors
-    ///
-    /// Implementations of this method should return an error if the underlying
-    /// encoder fails to write the slice of bytes.
-    fn put_slice(&mut self, slice: &[u8]) -> Result<(), Self::Error>;
-    /// Appends a single byte into the encoder, if possible.
-    ///
-    /// # Errors
-    ///
-    /// Implementations of this method should return an error if the underlying
-    /// encoder fails to write the byte.
-    fn put_byte(&mut self, byte: u8) -> Result<(), Self::Error>;
-}
-
-#[allow(deprecated)]
-impl<T> BaseEncoder for T
-where
-    T: Encoder,
-{
-    type Error = <T as Encoder>::Error;
-}
-
-#[allow(deprecated)]
-impl<T> ByteEncoder for T
-where
-    T: Encoder,
-{
-    #[inline]
-    fn put_slice(&mut self, slice: &[u8]) -> Result<(), Self::Error> {
-        Encoder::put_slice(self, slice)
-    }
-
-    #[inline]
-    fn put_byte(&mut self, byte: u8) -> Result<(), Self::Error> {
-        Encoder::put_byte(self, byte)
-    }
-}