From b125bec9914bd211d77719bd60bc5a23bd9db579 Mon Sep 17 00:00:00 2001
From: Martin Fischer <martin@push-f.com>
Date: Sat, 19 Aug 2023 13:17:30 +0200
Subject: break!: remove DefaultEmitter from public API

---
 src/emitter.rs | 10 +++++-----
 src/lib.rs     |  5 ++++-
 2 files changed, 9 insertions(+), 6 deletions(-)

(limited to 'src')

diff --git a/src/emitter.rs b/src/emitter.rs
index 30e1d17..0985403 100644
--- a/src/emitter.rs
+++ b/src/emitter.rs
@@ -165,14 +165,13 @@ pub trait Emitter<O> {
     fn adjusted_current_node_present_and_not_in_html_namespace(&mut self) -> bool;
 }
 
-/// The default implementation of [`Emitter`], used to produce tokens.
-///
-/// # Warning
+/// The DefaultEmitter is not exposed in the public API because:
 ///
 /// * Using the DefaultEmitter without calling [`Tokenizer::set_state`]
 ///   results in wrong state transitions:
 ///
-///   ```
+#[cfg_attr(not(feature = "integration-tests"), doc = "```ignore")]
+#[cfg_attr(feature = "integration-tests", doc = "```")]
 ///   # use html5tokenizer::{DefaultEmitter, Tokenizer, Token};
 ///   let emitter = DefaultEmitter::default();
 ///   let html = "<script><b>";
@@ -184,7 +183,8 @@ pub trait Emitter<O> {
 /// * The DefaultEmitter implements [`Emitter::adjusted_current_node_present_and_not_in_html_namespace`]
 ///   by returning false, which results in all CDATA sections being tokenized as bogus comments.
 ///
-///   ```
+#[cfg_attr(not(feature = "integration-tests"), doc = "```ignore")]
+#[cfg_attr(feature = "integration-tests", doc = "```")]
 ///   # use html5tokenizer::{DefaultEmitter, Tokenizer, Token};
 ///   let emitter = DefaultEmitter::default();
 ///   let html = "<svg><![CDATA[I love SVG]]>";
diff --git a/src/lib.rs b/src/lib.rs
index dc012cd..c14613b 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -14,13 +14,16 @@ pub mod reader;
 mod tokenizer;
 mod utils;
 
-pub use emitter::{Comment, DefaultEmitter, Doctype, Emitter, EndTag, StartTag, Token};
+pub use emitter::{Comment, Doctype, Emitter, EndTag, StartTag, Token};
 pub use error::Error;
 pub use tokenizer::{State, Tokenizer};
 
 #[cfg(feature = "integration-tests")]
 pub use utils::State as InternalState;
 
+#[cfg(feature = "integration-tests")]
+pub use emitter::DefaultEmitter;
+
 /// Relative links in the README.md don't work in rustdoc, so we have to override them.
 macro_rules! file_url {
     ($path:literal) => {
-- 
cgit v1.2.3