📦 Stock Manager

A terminal‑based inventory management system built with Python.
It allows you to track stock levels, set low‑stock thresholds, edit items, and save/load data persistently.

✨ Features

• Add, remove, and edit items – manage quantity, price, threshold, and category.
• Low‑stock alerts – view items that need restocking.
• Search by name – quickly find any item.
• Total inventory value – see the sum of quantity × price.
• Persistent storage – data is saved to inventory.json and loaded automatically on startup.
• User‑friendly menu with emojis and clear prompts.
• Loop for multiple operations – add or edit several items without returning to the main menu.

🚀 How to Run

1. Make sure you have Python 3.7+ installed.
2. Download all three files (file.py, inputs.py, main.py) to the same folder.
3. Open a terminal in that folder and run:

   python main.py

4. Follow the on‑screen menu.

📁 File Structure

stock-manager/
├── file.py          # Item & Inventory classes
├── inputs.py        # User input functions
├── main.py          # Main menu and program flow
├── inventory.json   # Auto‑generated data file (after first save)
└── README.md        # This file

🧠 Class Overview

Item

• Attributes: name, quantity, price, threshold, category
• Methods: __repr__ (friendly display)

Inventory

• Attributes: items (dictionary mapping name → Item)
• Methods: add_item, remove_item, edit_item, find_item, low_stock, total_value, save_to_file, load_from_file

💾 Data Persistence

The inventory is saved to inventory.json when you choose the Save option (or automatically on exit). When the program starts, it loads from this file if it exists.

🛠️ Technologies

• Python 3
• JSON for data storage
• Standard library only (no external dependencies)

🔮 Future Improvements

• Export inventory to CSV
• Add graphical interface (optional)
• Track sales history

📧 Contact

For questions or suggestions:
dev.tharana@gmail.com

🙏 Acknowledgements

Built as a portfolio project to demonstrate object‑oriented programming, file I/O, and user interface design in Python.