nexuscalc 1.1.0

🔢 A chill CLI calculator that just works

🔢 NexusCalc

A powerful interactive CLI calculator that just works.

NexusCalc - because sometimes you need to calculate things and your brain said "no."

✨ Features

• ➕ Addition - Add two numbers
• ➖ Subtraction - Subtract second from first
• ✖️ Multiplication - Multiply two numbers
• ➗ Division - Divide first by second (with zero division error handling)
• 🏠 Floor - Floor division (integer result)
• 🔢 Floating-point precision - 0.1 + 0.2 = 0.3 (we fixed it!)
• 🛡️ Error handling - Division by zero? We got you
• ⌨️ Regex quit patterns - q, Q, quit, QUIT, 6
• 📊 Calculation counter - Track your math history
• 🎨 Beautiful formatting - Clean, color-coded output
• 💡 Built-in help - Type h or help for documentation
• 🧠 Keyboard interrupts - Ctrl+C gracefully handled

📦 Installation

python -m pip install nexuscalc

🚀 Usage

Interactive Mode (Recommended)

from nexuscalc import start_calc
start_calc()

Or using the wrapper:

from nexuscalc import nexuscalc
nexuscalc.start_calc()

Or after installation, just run:

nexuscalc

⚠️ Deprecated (will be removed in 2.0.0)

from nexuscalc import calculate
calculate()  # Deprecated - use start_calc() instead

Quick Start

# Method 1: Recommended - Direct function
from nexuscalc import start_calc
start_calc()

# Method 2: Recommended - Using wrapper
from nexuscalc import nexuscalc
nexuscalc.start_calc()

# Method 3: Deprecated (will be removed in 2.0.0)
from nexuscalc import calculate
calculate()  # ⚠️ Deprecated

# Method 4: Deprecated (will be removed in 2.0.0)
from nexuscalc import nexuscalc
nexuscalc.calculate()  # ⚠️ Deprecated

# Method 5: Using the class (advanced)
from nexuscalc import NexusCalc
calc = NexusCalc()
calc.run()

# Method 6: Show help
from nexuscalc import nexuscalc
nexuscalc.help()

Programmatic Usage

from nexuscalc.core.operations import Operations

ops = Operations()
result = ops.add(5, 3)  # Returns 8
result = ops.divide(10, 2)  # Returns 5.0
result = ops.floor_divide(10, 3)  # Returns 3

🎮 Interactive Commands

While using the calculator, you can type:

Command	Action
1-5	Select operation
h, help, ?	Show help
q, Q, quit, QUIT, 6	Exit calculator
Ctrl+C	Cancel current operation
Ctrl+D	Exit calculator

📝 Examples

from nexuscalc import start_calc

# Start the calculator
start_calc()

# Example session:
# ==================================================
# 🔢 NEXUSCALC - Powerful Calculator
# ==================================================
# 
# 1. Add ➕
# 2. Subtract ➖
# 3. Multiply ✖️
# 4. Divide ➗
# 5. Floor 🏠
# 6. Quit 🚪
# 
# Use 1-5
# NEXUSCALC > 1
# Enter first number
# NEXUSCALC > 0.1
# Enter second number
# NEXUSCALC > 0.2
# 
# ✅ Result: 0.3

🛡️ Error Handling

NexusCalc handles errors gracefully:

# Division by zero
NEXUSCALC > 4
Enter first number
NEXUSCALC > 10
Enter second number
NEXUSCALC > 0

❌ Division Error: Cannot divide by zero!
💡 Hint: You cannot divide by zero. Please try a different number.

# Invalid input
NEXUSCALC > 1
Enter first number
NEXUSCALC > hello

❌ Error: 'hello' is not a valid number
💡 Please try again with a valid number.

📊 Why NexusCalc?

Feature	NexusCalc	Other Calculators
CLI Interface	✅	❌
Error Handling	✅	⚠️
Regex Quit Patterns	✅	❌
Floating Point Precision	✅	⚠️
Built-in Help	✅	❌
Calculation Counter	✅	❌
Keyboard Interrupts	✅	❌
Beautiful Output	✅	❌
Deprecation Warnings	✅	❌

📋 Version History

Version	Changes
1.1.0	Added start_calc(), deprecated calculate()
1.0.0	Initial stable release

🧪 Development

Run tests:

python -m pytest tests/ -v

Run tests with coverage:

python -m pytest tests/ --cov=src/nexuscalc

📁 Project Structure

nexuscalc/
├── src/nexuscalc/
│   ├── core/          # Core calculator logic
│   ├── parsers/       # Expression parsing
│   ├── evaluator/     # Expression evaluation
│   ├── utils/         # Utilities and helpers
│   └── exceptions/    # Custom exceptions
├── tests/             # Unit tests
├── examples/          # Usage examples
└── setup.py          # Package setup

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

MIT License - see the LICENSE file for details.

👤 Author

Light Bulb Experiments © 2026

🙏 Acknowledgments

• Built with ☕ and ❤️
• Inspired by the need for a simple, powerful CLI calculator
• Thanks to all users who made this better

⭐ Show Your Support

If you find NexusCalc useful, please consider:

• ⭐ Starring the repository on GitHub
• 🐛 Reporting issues
• 💡 Suggesting features
• 🔧 Contributing code

---

Made with ❤️ by Light Bulb Experiments