TolMate 0.5.1004

TolMate ;-P

TolMate

TolMate is a Python utility for checking if a value falls within specified tolerance ranges. It provides feedback via console messages and popup windows to alert users about the status of the value, whether it's within range or outside specifications.

---

Features

• Tolerance Checks: Supports up to three (optional) levels of tolerance ranges:
  • Tol 1: Normal range
  • Tol 2: Soft warning
  • Tol 3: Hard warning
• Configurable Behavior: Choose whether to show console messages, popups, or both.
• Interactive Popups: Allow users to confirm or change the value directly.

• Customizable Look: Highlight alerts with built-in symbols or emojis.
• Reusable and Lightweight: Designed to integrate seamlessly into larger projects.

---

Installation

You can install TolMate using pip.

pip install tolmate

---

Usage

Basic Example

from tolmate import configure_behavior, tolmate

# Set global behavior for popups and messages (by default all True)
configure_behavior(show_popup=True, show_message=False)

# Main program example
def celsius_to_kelvin(celsius):
    """Convert Celsius to Kelvin."""
    return celsius + 273.15

# Main loop for initial value input
try:
    # Configure global behavior (example: enable both message and popup)
    value = float(input("Enter the temperature in degrees Celsius: "))

    if tolmate(value, 20, 40, 10, 50, 0, 60):  # Example ranges
        kelvin = celsius_to_kelvin(value)
        print(f"The temperature in Kelvin is: {kelvin:.2f}")
    else:
        print("The value is outside specifications.")

except ValueError:
    print("Please enter a valid number!")