Metadata-Version: 2.1
Name: nexuscalc
Version: 1.0.0
Summary: A powerful calculator application with an interactive CLI
Home-page: https://github.com/yourusername/nexuscalc
Author: NexusCalc Team
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# NexusCalc

A powerful calculator application with an interactive command-line interface.

## Features

- ➕ Addition
- ➖ Subtraction
- ✖️ Multiplication
- ➗ Division with zero division error handling
- 🏠 Floor division
- 🔢 Mathematical constants (pi, e, tau)
- 📐 Advanced mathematical functions (sqrt, sin, cos, tan, log)
- 🛡️ Comprehensive error handling
- 💎 Clean number formatting
- 🎨 Colorful and interactive CLI

## Installation

```bash
python -m pip install nexuscalc
```

## Usage

### Interactive Mode

```python
from nexuscalc import nexuscalc
nexuscalc.calculate()
```

Or:

```python
import nexuscalc
nexuscalc.nexuscalc.calculate()
```

Or after installation:

```bash
nexuscalc
```

### Programmatic Usage

```python
from nexuscalc.core.operations import Operations

ops = Operations()
result = ops.add(5, 3)  # Returns 8
```

### Advanced Expression Evaluation

```python
from nexuscalc.evaluator.evaluator import Evaluator

eval = Evaluator()
result = eval.evaluate_expression("2 + 3 * 4")  # Returns 14
```

## Error Handling

NexusCalc includes comprehensive error handling for:

- Division by zero (with friendly error messages)
- Invalid input formats
- Numeric overflow
- Expression parsing errors
- Function evaluation errors

## Development

Run tests:

```bash
python -m pytest tests/ -v
```

Run tests with coverage:

```bash
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
```

## License

MIT

## Author

Light Bulb Experiments © 2026


