https://github.com/hasnainhsa/budget-planner-with-python
https://github.com/hasnainhsa/budget-planner-with-python
budget-app expense-tracker if-else loops python
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/hasnainhsa/budget-planner-with-python
- Owner: HasnainHSA
- Created: 2024-11-27T03:41:41.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-27T03:48:32.000Z (about 1 year ago)
- Last Synced: 2025-10-04T09:46:28.402Z (3 months ago)
- Topics: budget-app, expense-tracker, if-else, loops, python
- Language: Python
- Homepage:
- Size: 4.88 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
Awesome Lists containing this project
README
## **Budget Planner and Expense Manager**
A simple, interactive Python program designed to help university students track their expenses, stay within budget, and make smarter financial decisions. With a touch of humor and relatable Roman Urdu-English phrases, this program adds a fun twist to the typical budgeting experience.
---
### **Features**
1. **Set a Budget**: Define your monthly spending limit (in PKR).
2. **Add Expenses**: Categorize and add your expenses (e.g., chai, rent, books, etc.).
3. **View Expense Summary**: Check how much you've spent and how much is left.
4. **Warns About Over-Spending**: Fun alerts when you're close to or over budget.
5. **Edit and Remove Expenses**: Update or delete any added expense.
6. **User-Friendly with Humor**: Engages users with funny Roman Urdu prompts and responses.
---
### **Requirements**
- Python 3.6 or later
- A terminal or IDE (e.g., PyCharm, VS Code, or Jupyter Notebook)
---
### **How to Run the Program**
1. Download or clone the project repository:
```bash
git clone https://github.com/username/budget-planner.git
```
2. Navigate to the project directory:
```bash
cd budget-planner
```
3. Run the program:
```bash
python budget_planner.py
```
---
### **How to Use**
1. **Set Your Budget**: When prompted, enter your monthly budget in PKR.
2. **Add Expenses**: Enter expense details (category and amount). The program automatically deducts it from your budget.
3. **View Summary**: Type `summary` anytime to view your spending.
4. **Stay Alert**: Get warnings if your spending gets out of control with a touch of humor.
5. **Quit**: Exit the program anytime by typing `exit`.
---
### **Example Usage**
#### Setting a Budget:
```
Apna monthly budget batao? (PKR): 20000
```
#### Adding an Expense:
```
Expense ka naam? (e.g., chai, rent, books): chai
Kitna kharcha hua? (PKR): 150
Expense added: chai - PKR 150
```
#### Viewing Summary:
```
Type 'summary' to check your spending so far!
```
#### Exceeding Budget:
```
Warning: Aapka budget khatam hone wala hai! Sambhal jao! 😅
```
---
### **Program Features with Humor**
- **Budget Exhausted Alert**: “Bas karo, paise udana band karo, warna agle mahine bhooke maroge! 😜”
- **Motivational Messages**: “Great job! Budget ke andar rehna mushkil hai, but you're killing it! 💪”
- **Interactive Prompts**: Encourages regular use by making it fun.
---
### **Future Enhancements**
- Add graphical visualization for expenses (e.g., bar graphs or pie charts).
- Implement a database to save data for long-term tracking.
- Introduce a login system for multiple users.
---
### **Contributing**
Contributions are welcome! If you'd like to contribute:
1. Fork the repository.
2. Create a new branch:
```bash
git checkout -b feature-name
```
3. Commit your changes:
```bash
git commit -m "Add your feature"
```
4. Push the branch:
```bash
git push origin feature-name
```
5. Create a pull request.
---
### **Author**
- **Name**: Hasnain Saleem
- **Contact**: hasnainsaleem807@gmail.com
- **GitHub**: https://github.com/HasnainHSA
---
### **License**
This project is licensed under the MIT License. See the LICENSE file for more details.