Pantomime

Pantomime is a modern, robust, and memory-efficient replacement for the MIME-manipulation features of JavaMail. It provides a cleaner API and better performance for working with email content and MIME structures in Java.

---

✨ Features

• ✅ Pure Java MIME parser
• ✅ Easier-to-use than JavaMail
• ✅ Designed for robustness and low memory usage
• ✅ Actively maintained
• ✅ Licensed under the Mozilla Public License 2.0

---

📦 Installation

You can install Pantomime by cloning this repository and building it yourself:

git clone https://github.com/huxley-barbee/pantomime.git
cd pantomime
./gradlew build

Or download a prebuilt .jar from the Releases page.

Then, include it in your classpath alongside your JavaMail jar (if needed).

---

🚀 Quick Start

MimeMessageParser parser = new MimeMessageParser();
MimeMessage message = parser.parse(new FileInputStream("email.eml"));

System.out.println("Subject: " + message.getSubject());
System.out.println("Body: " + message.getBodyText());

There are many concrete examples of how to use Pantomime in the manual directory.

---

🧪 Platform Support

Pantomime runs on any Java Virtual Machine (JVM). It is tested on Java 8 through 21.

---

📈 Project Status

• 📌 Current Version: 1.0
• 🧪 Seeking testers and contributors

---

🐞 Issues and Feedback

Please report issues via the GitHub Issues page.

---

🤝 Contributing

1. Fork this repo
2. Create a feature branch
3. Submit a pull request
4. Discuss and improve!

We welcome bugfixes, enhancements, documentation help, and test coverage.

---

👤 Author

Developed by Huxley Barbee Developed by Corey Holland

---

📜 License

This project is licensed under the Mozilla Public License 2.0