banktools 0.1.0__tar.gz

banktools-0.1.0/LICENSE

@@ -0,0 +1 @@
+MIT License

banktools-0.1.0/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: banktools
+Version: 0.1.0
+Summary: A Python library for banking calculations and currency utilities.
+License: MIT License
+Project-URL: Homepage, https://pypi.org/project/banktools/
+Keywords: bank,finance,interest,currency,loan,tax,emi
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# banktools
+
+A Python library for banking calculations and currency utilities.
+
+## Installation
+
+```bash
+pip install banktools
+```
+
+## Modules
+
+### 1. calculator
+Banking and finance calculation functions.
+
+- `simple_interest(principal, rate, time)` — Calculate simple interest
+- `compound_interest(principal, rate, time, n)` — Calculate compound interest
+- `loan_emi(principal, annual_rate, months)` — Calculate monthly loan EMI
+- `tax_calculator(income, tax_rate)` — Calculate tax and net income
+
+### 2. currencytools
+Currency conversion and exchange utilities.
+
+- `convert_currency(amount, exchange_rate)` — Convert amount using exchange rate
+- `format_currency(amount, symbol)` — Format number as currency string
+- `currency_difference(amount1, amount2)` — Find difference between two amounts
+- `is_profitable(bought_at, sold_at)` — Check if currency exchange was profitable
+
+## Usage
+
+```python
+from banktools.calculator import simple_interest, loan_emi
+from banktools.currencytools import convert_currency, format_currency
+
+# Simple interest
+result = simple_interest(1000, 5, 3)
+print(result)  # {'interest': 150.0, 'total_amount': 1150.0}
+
+# Loan EMI
+emi = loan_emi(100000, 8, 24)
+print(emi)  # {'emi': 4523.01, 'total_payment': 108552.24, 'total_interest': 8552.24}
+
+# Currency conversion
+pkr = convert_currency(100, 280)
+print(pkr)  # 28000.0
+
+# Format currency
+print(format_currency(1500.5, '$'))  # $1,500.50
+```
+
+## License
+MIT License

banktools-0.1.0/README.md

@@ -0,0 +1,52 @@
+# banktools
+
+A Python library for banking calculations and currency utilities.
+
+## Installation
+
+```bash
+pip install banktools
+```
+
+## Modules
+
+### 1. calculator
+Banking and finance calculation functions.
+
+- `simple_interest(principal, rate, time)` — Calculate simple interest
+- `compound_interest(principal, rate, time, n)` — Calculate compound interest
+- `loan_emi(principal, annual_rate, months)` — Calculate monthly loan EMI
+- `tax_calculator(income, tax_rate)` — Calculate tax and net income
+
+### 2. currencytools
+Currency conversion and exchange utilities.
+
+- `convert_currency(amount, exchange_rate)` — Convert amount using exchange rate
+- `format_currency(amount, symbol)` — Format number as currency string
+- `currency_difference(amount1, amount2)` — Find difference between two amounts
+- `is_profitable(bought_at, sold_at)` — Check if currency exchange was profitable
+
+## Usage
+
+```python
+from banktools.calculator import simple_interest, loan_emi
+from banktools.currencytools import convert_currency, format_currency
+
+# Simple interest
+result = simple_interest(1000, 5, 3)
+print(result)  # {'interest': 150.0, 'total_amount': 1150.0}
+
+# Loan EMI
+emi = loan_emi(100000, 8, 24)
+print(emi)  # {'emi': 4523.01, 'total_payment': 108552.24, 'total_interest': 8552.24}
+
+# Currency conversion
+pkr = convert_currency(100, 280)
+print(pkr)  # 28000.0
+
+# Format currency
+print(format_currency(1500.5, '$'))  # $1,500.50
+```
+
+## License
+MIT License

banktools-0.1.0/banktools/__init__.py

@@ -0,0 +1,23 @@
+"""
+banktools - A Python library for banking calculations and currency utilities.
+
+Modules:
+    calculator    - Simple interest, compound interest, EMI, tax calculations
+    currencytools - Currency conversion, formatting, comparison, profit check
+"""
+
+from .calculator import simple_interest, compound_interest, loan_emi, tax_calculator
+from .currencytools import convert_currency, format_currency, currency_difference, is_profitable
+
+__version__ = "0.1.0"
+__author__ = "Your Group Name"
+__all__ = [
+    "simple_interest",
+    "compound_interest",
+    "loan_emi",
+    "tax_calculator",
+    "convert_currency",
+    "format_currency",
+    "currency_difference",
+    "is_profitable",
+]

banktools-0.1.0/banktools/calculator.py

@@ -0,0 +1,118 @@
+"""
+calculator.py - Banking calculation utilities for banktools library.
+Provides functions for simple interest, compound interest, loan EMI, and tax.
+"""
+
+
+def simple_interest(principal, rate, time):
+    """
+    Calculate simple interest.
+
+    Args:
+        principal (float): The initial amount of money.
+        rate (float): Annual interest rate in percentage (e.g. 5 for 5%).
+        time (float): Time period in years.
+
+    Returns:
+        dict: Contains 'interest' and 'total_amount'.
+
+    Example:
+        >>> simple_interest(1000, 5, 3)
+        {'interest': 150.0, 'total_amount': 1150.0}
+    """
+    if principal < 0 or rate < 0 or time < 0:
+        raise ValueError("Principal, rate, and time must be non-negative.")
+    interest = (principal * rate * time) / 100
+    total = principal + interest
+    return {
+        "interest": round(interest, 2),
+        "total_amount": round(total, 2)
+    }
+
+
+def compound_interest(principal, rate, time, n=1):
+    """
+    Calculate compound interest.
+
+    Args:
+        principal (float): The initial amount of money.
+        rate (float): Annual interest rate in percentage (e.g. 5 for 5%).
+        time (float): Time period in years.
+        n (int): Number of times interest is compounded per year (default 1).
+
+    Returns:
+        dict: Contains 'interest' and 'total_amount'.
+
+    Example:
+        >>> compound_interest(1000, 5, 3, 12)
+        {'interest': 161.62, 'total_amount': 1161.62}
+    """
+    if principal < 0 or rate < 0 or time < 0 or n <= 0:
+        raise ValueError("All values must be positive.")
+    total = principal * (1 + (rate / 100) / n) ** (n * time)
+    interest = total - principal
+    return {
+        "interest": round(interest, 2),
+        "total_amount": round(total, 2)
+    }
+
+
+def loan_emi(principal, annual_rate, months):
+    """
+    Calculate the monthly EMI (Equated Monthly Installment) for a loan.
+
+    Args:
+        principal (float): Loan amount.
+        annual_rate (float): Annual interest rate in percentage.
+        months (int): Loan tenure in months.
+
+    Returns:
+        dict: Contains 'emi', 'total_payment', and 'total_interest'.
+
+    Example:
+        >>> loan_emi(100000, 8, 24)
+        {'emi': 4523.01, 'total_payment': 108552.24, 'total_interest': 8552.24}
+    """
+    if principal <= 0 or annual_rate < 0 or months <= 0:
+        raise ValueError("Principal and months must be positive; rate must be non-negative.")
+    if annual_rate == 0:
+        emi = principal / months
+        return {
+            "emi": round(emi, 2),
+            "total_payment": round(principal, 2),
+            "total_interest": 0.0
+        }
+    monthly_rate = (annual_rate / 100) / 12
+    emi = principal * monthly_rate * (1 + monthly_rate) ** months / ((1 + monthly_rate) ** months - 1)
+    total_payment = emi * months
+    total_interest = total_payment - principal
+    return {
+        "emi": round(emi, 2),
+        "total_payment": round(total_payment, 2),
+        "total_interest": round(total_interest, 2)
+    }
+
+
+def tax_calculator(income, tax_rate):
+    """
+    Calculate tax and net income after tax.
+
+    Args:
+        income (float): Gross income amount.
+        tax_rate (float): Tax rate in percentage (e.g. 20 for 20%).
+
+    Returns:
+        dict: Contains 'tax_amount' and 'net_income'.
+
+    Example:
+        >>> tax_calculator(50000, 20)
+        {'tax_amount': 10000.0, 'net_income': 40000.0}
+    """
+    if income < 0 or tax_rate < 0 or tax_rate > 100:
+        raise ValueError("Income must be non-negative and tax rate must be between 0 and 100.")
+    tax = (income * tax_rate) / 100
+    net = income - tax
+    return {
+        "tax_amount": round(tax, 2),
+        "net_income": round(net, 2)
+    }

banktools-0.1.0/banktools/currencytools.py

@@ -0,0 +1,105 @@
+"""
+currencytools.py - Currency conversion and exchange utilities for banktools library.
+Provides functions for currency conversion, formatting, comparison, and profit checking.
+"""
+
+
+def convert_currency(amount, exchange_rate):
+    """
+    Convert an amount from one currency to another using an exchange rate.
+
+    Args:
+        amount (float): The amount to convert.
+        exchange_rate (float): The exchange rate to apply (e.g. 1 USD = 280 PKR -> rate=280).
+
+    Returns:
+        float: The converted amount.
+
+    Example:
+        >>> convert_currency(100, 280)
+        28000.0
+    """
+    if amount < 0:
+        raise ValueError("Amount must be non-negative.")
+    if exchange_rate <= 0:
+        raise ValueError("Exchange rate must be greater than zero.")
+    return round(amount * exchange_rate, 2)
+
+
+def format_currency(amount, symbol="$"):
+    """
+    Format a number as a currency string with commas and 2 decimal places.
+
+    Args:
+        amount (float): The monetary amount to format.
+        symbol (str): Currency symbol to prepend (default '$').
+
+    Returns:
+        str: Formatted currency string (e.g. '$1,000.00').
+
+    Example:
+        >>> format_currency(1500.5, '$')
+        '$1,500.50'
+    """
+    if amount < 0:
+        raise ValueError("Amount must be non-negative.")
+    return f"{symbol}{amount:,.2f}"
+
+
+def currency_difference(amount1, amount2):
+    """
+    Calculate the absolute difference between two currency values.
+
+    Args:
+        amount1 (float): First currency amount.
+        amount2 (float): Second currency amount.
+
+    Returns:
+        dict: Contains 'difference' and 'higher_amount'.
+
+    Example:
+        >>> currency_difference(500, 350)
+        {'difference': 150.0, 'higher_amount': 500}
+    """
+    if amount1 < 0 or amount2 < 0:
+        raise ValueError("Amounts must be non-negative.")
+    diff = abs(amount1 - amount2)
+    higher = max(amount1, amount2)
+    return {
+        "difference": round(diff, 2),
+        "higher_amount": higher
+    }
+
+
+def is_profitable(bought_at, sold_at):
+    """
+    Check whether a currency exchange transaction was profitable.
+
+    Args:
+        bought_at (float): Exchange rate when currency was bought.
+        sold_at (float): Exchange rate when currency was sold.
+
+    Returns:
+        dict: Contains 'profitable' (bool), 'profit_or_loss', and 'status' message.
+
+    Example:
+        >>> is_profitable(1.10, 1.25)
+        {'profitable': True, 'profit_or_loss': 0.15, 'status': 'Profit'}
+    """
+    if bought_at <= 0 or sold_at <= 0:
+        raise ValueError("Exchange rates must be greater than zero.")
+    difference = sold_at - bought_at
+    if difference > 0:
+        status = "Profit"
+        profitable = True
+    elif difference < 0:
+        status = "Loss"
+        profitable = False
+    else:
+        status = "Break Even"
+        profitable = False
+    return {
+        "profitable": profitable,
+        "profit_or_loss": round(abs(difference), 4),
+        "status": status
+    }

banktools-0.1.0/banktools.egg-info/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: banktools
+Version: 0.1.0
+Summary: A Python library for banking calculations and currency utilities.
+License: MIT License
+Project-URL: Homepage, https://pypi.org/project/banktools/
+Keywords: bank,finance,interest,currency,loan,tax,emi
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# banktools
+
+A Python library for banking calculations and currency utilities.
+
+## Installation
+
+```bash
+pip install banktools
+```
+
+## Modules
+
+### 1. calculator
+Banking and finance calculation functions.
+
+- `simple_interest(principal, rate, time)` — Calculate simple interest
+- `compound_interest(principal, rate, time, n)` — Calculate compound interest
+- `loan_emi(principal, annual_rate, months)` — Calculate monthly loan EMI
+- `tax_calculator(income, tax_rate)` — Calculate tax and net income
+
+### 2. currencytools
+Currency conversion and exchange utilities.
+
+- `convert_currency(amount, exchange_rate)` — Convert amount using exchange rate
+- `format_currency(amount, symbol)` — Format number as currency string
+- `currency_difference(amount1, amount2)` — Find difference between two amounts
+- `is_profitable(bought_at, sold_at)` — Check if currency exchange was profitable
+
+## Usage
+
+```python
+from banktools.calculator import simple_interest, loan_emi
+from banktools.currencytools import convert_currency, format_currency
+
+# Simple interest
+result = simple_interest(1000, 5, 3)
+print(result)  # {'interest': 150.0, 'total_amount': 1150.0}
+
+# Loan EMI
+emi = loan_emi(100000, 8, 24)
+print(emi)  # {'emi': 4523.01, 'total_payment': 108552.24, 'total_interest': 8552.24}
+
+# Currency conversion
+pkr = convert_currency(100, 280)
+print(pkr)  # 28000.0
+
+# Format currency
+print(format_currency(1500.5, '$'))  # $1,500.50
+```
+
+## License
+MIT License

banktools-0.1.0/banktools.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+banktools/__init__.py
+banktools/calculator.py
+banktools/currencytools.py
+banktools.egg-info/PKG-INFO
+banktools.egg-info/SOURCES.txt
+banktools.egg-info/dependency_links.txt
+banktools.egg-info/top_level.txt

banktools-0.1.0/banktools.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

banktools-0.1.0/banktools.egg-info/top_level.txt

@@ -0,0 +1 @@
+banktools

banktools-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "banktools"
+version = "0.1.0"
+description = "A Python library for banking calculations and currency utilities."
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.7"
+keywords = ["bank", "finance", "interest", "currency", "loan", "tax", "emi"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Office/Business :: Financial",
+]
+
+[project.urls]
+Homepage = "https://pypi.org/project/banktools/"

banktools-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+