# html_forge
A robust and efficient HTML parsing library for Rust
## 🚀 Features
- `Element Parsing`: Easily parse HTML elements with attributes and nested children.
- `Text Parsing`: Extract and manage text nodes within your documents.
- `Attribute Parsing`: Handle element attributes with both single and double quotes.
- `Comment Parsing`: Parse comments safely, even those with special characters or nested hyphens.
- `Error Handling`: Gracefully manage parsing errors such as mismatched tags and unexpected end-of-file (EOF).
## 📦 Installation
To use `html_forge`, add the following to your Cargo.toml:
```toml
[dependencies]
html_forge = "0.1.0"
```
## Usage
### 1. Basic Parsing Example:
Here’s how you can parse a simple HTML snippet using html_forge:
```rust
use html_forge::parser::Parser;
use html_forge::dom::Node;
fn main() {
let input = "<div class='container'><p>Hello, world!</p></div>".to_string();
let mut parser = Parser::new(input);
match parser.parse() {
Ok(node) => println!("Parsed Node: {:?}", node),
Err(err) => eprintln!("Parsing error: {:?}", err),
}
}
```
### 2. Handling Errors:
html_forge gracefully handles common errors during parsing:
```rust
use html_forge::{parser::Parser, errors::ParseError};
fn main() {
let input = "<div><p>Unclosed div".to_string();
let mut parser = Parser::new(input);
match parser.parse() {
Err(ParseError::UnexpectedEOF) => eprintln!("Error: Unexpected end of file"),
Err(ParseError::MismatchedClosingTag) => eprintln!("Error: Mismatched closing tag"),
Ok(node) => println!("Parsed Node: {:?}", node),
Err(err) => eprintln!("Other parsing error: {:?}", err),
}
}
```
## 🧪 Testing
To run the tests, use:
```bash
cargo test
```
## 👥 Contributing
Contributions are welcome! Feel free to open issues, submit pull requests, or fork the repository to make improvements.
## 📝 License
This library is open-source and available under the [MIT LICENSE](LICENSE).
`Happy forging with html_forge! 🛠️🚀`