Welcome to Unitility Discussions!

[pjazdzyk]

📣 Welcome to the Unitility Community

Unitility is an open‑source Java library for working with physical quantities and unit conversions, ideal for engineering and scientific applications. It offers intuitive PhysicalQuantity value-object types that bundle value and unit in one immutable, thread‑safe design, along with convenient converter methods.

---

🚀 Why Unitility?

• Simplifies physics unit conversion and operations (addition, multiplication, logarithms, trigonometry, and more)
• Rich support for standard and custom physical quantities (over 45 types across various scientific fields)
• Extensions for Quarkus, Spring Boot, and Jackson for seamless integration in web applications
• Support for Jakarta Validation for input and model checks
• Flexible parsers that recover unit information even from malformed strings
• Lightweight, framework‑agnostic core; Kotlin and Groovy friendly, supports overloaded operators
• Extensively tested and already integrated into production-grade apps and libraries — see: EnergyFlowX or EnergyFlowX API (Demo)
• Artifacts available in Maven Central Repository — see: Maven Central
• Created by a licensed HVAC/MEP engineer and software developer

---

🛠️ How You Can Contribute

This library welcomes contributions! You can:

• Submit Pull Requests with new quantities, bug fixes, or feature enhancements
• Report issues or bugs discovered during usage
• Discuss architectural or design topics: type safety, unit parsing, arithmetic operations, or framework integrations
• Propose custom unit definitions or support for new physics domains

📝 For concrete bug reports or feature requests, please use GitHub Issues.
Discussions are great for general questions, design ideas, and feedback.

---

🗣️ Join the Conversation

Whether you're building with Unitility in Quarkus, Spring, or plain Java:

• 💬 Ask questions about usage or integration
• 🧠 Discuss design ideas, edge cases, or domain modeling
• 🐞 Report bugs or unexpected behavior
• 💡 Suggest enhancements, new units, or new extension modules

📌 Suggested Discussion Categories:

• Q&A – usage, parsing, operations
• Features & Ideas – new quantities or module proposals
• Bug Reports – regressions or incorrect results
• Development Talk – architecture, testing, extensibility

---

By participating, you'll help improve Unitility for everyone. Looking forward to your engagement!