declareQuant

declareQuant is a Python library designed to simplify the process of declaring and managing quantity-based variables within a program. It aims to reduce errors related to unit conversions and ensure that calculations are performed with consistent units. The library allows developers to define variables that not only hold a numerical value but also an associated unit of measurement.

The core functionality of declareQuant revolves around its `Quantity` object. When creating a `Quantity`, a user specifies a numerical value and a unit. For example, one could declare a distance as `Quantity(10, 'meters')`. The library supports a wide range of common units and provides mechanisms for defining custom units if needed.

A key feature of declareQuant is its automatic unit handling. When performing arithmetic operations between `Quantity` objects, the library attempts to perform unit conversions to ensure compatibility. For instance, adding `Quantity(5, 'meters')` and `Quantity(2, 'kilometers')` would automatically convert kilometers to meters before summation, resulting in a `Quantity` object representing the total distance in meters. This significantly reduces the likelihood of mistakes that can arise from manual unit conversion.

Furthermore, declareQuant enforces type checking to prevent operations between incompatible units, such as adding meters to seconds, unless explicitly allowed through defined conversion pathways. This strictness helps catch potential errors early in the development cycle. The library is intended for use in scientific computing, engineering, and any domain where accurate and robust handling of physical quantities is essential.