Metadata-Version: 2.4
Name: calculator-suoxd
Version: 0.1.1
Summary: A simple calculator for elementary school students to practice addition and subtraction.
Author-email: Zacsuo <suoxd123@126.com>
License: MIT License
        
        Copyright (c) 2023 [Your Name]
        
        Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
        
        1. The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
        
        2. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Calculator Project

## Overview
The Calculator Project is a simple yet effective tool designed to help elementary school students practice basic arithmetic operations, specifically addition and subtraction. This project provides a user-friendly interface for generating random math problems and validating user input.

## Features
- **Addition and Subtraction**: The core functionality allows users to perform addition and subtraction operations.
- **Random Problem Generation**: Utility functions generate random math problems to keep practice sessions engaging.
- **Input Validation**: Ensures that user inputs are valid integers, preventing errors during calculations.

## Installation
To install the Calculator Project, you can use pip. Run the following command in your terminal:

```
pip install calculator_project
```

## Usage
After installation, you can use the calculator in your Python scripts as follows:

```python
from calculator import Calculator

calc = Calculator()
result_add = calc.add(5, 3)  # Returns 8
result_subtract = calc.subtract(5, 3)  # Returns 2
```

## Running Tests
To ensure the functionality of the calculator, you can run the unit tests provided in the project. Navigate to the `src/tests` directory and run:

```
python -m unittest test_core.py
```

## Contributing
Contributions to the Calculator Project are welcome! If you have suggestions for improvements or new features, please feel free to submit a pull request.

## License
This project is licensed under the MIT License. See the LICENSE file for more details.
