Metadata-Version: 2.4
Name: my727finance
Version: 0.1.0
Summary: A numpy-style toolkit for quantitative and business finance: TVM math, technical indicators, risk metrics, financial ratios, statement analysis, costing, variance analysis, and audit analytics.
Author: MY727INFOTECH INDIA PRIVATE LIMITED
License: MY727FINANCE COMMUNITY LICENSE v1.0
        
        Copyright (c) 2026 MY727INFOTECH INDIA PRIVATE LIMITED.
        All Rights Reserved.
        
        ======================================================================
        ORIGINAL SOFTWARE DESIGN & DEVELOPMENT
        ======================================================================
        
        This software was originally designed, architected, developed and
        maintained by:
        
        T.P. Thangaprabhu
        B.Sc., MBA, CIMA Adv Dip MA (UK), FCMA, ACPIFSD (IIT Roorkee)
        
        Cost Accountant | Full Stack Developer | Data Scientist
        
        Founder & Director
        MY727INFOTECH INDIA PRIVATE LIMITED
        
        ======================================================================
        OWNERSHIP
        ======================================================================
        
        The software package "my727finance", including but not limited to its
        source code, algorithms, architecture, documentation, APIs, examples,
        test suites, design, trademarks, and related materials, is the exclusive
        intellectual property of MY727INFOTECH INDIA PRIVATE LIMITED.
        
        All copyright, intellectual property rights, and proprietary rights are
        reserved unless expressly granted under this License.
        
        ======================================================================
        1. LICENSE GRANT
        ======================================================================
        
        Subject to the terms and conditions of this License,
        MY727INFOTECH INDIA PRIVATE LIMITED grants every individual,
        educational institution, business organization, and government entity
        a limited, non-exclusive, non-transferable and revocable license to:
        
        • Install the library.
        • Use the library.
        • Import the library into software applications.
        • Develop software, scripts and services using this library.
        • Use the library for personal, educational, research and commercial
          purposes.
        
        ======================================================================
        2. PERMITTED COMMERCIAL USE
        ======================================================================
        
        Applications developed using my727finance may be:
        
        • Distributed
        • Licensed
        • Sold
        • Commercialized
        
        provided that:
        
        • The application itself is your own work.
        • The my727finance library is not redistributed separately.
        • This License is fully respected.
        
        Nothing in this License transfers ownership of my727finance to any user.
        
        ======================================================================
        3. RESTRICTIONS
        ======================================================================
        
        Without prior written permission from
        MY727INFOTECH INDIA PRIVATE LIMITED, you MAY NOT:
        
        • Republish this library under another name.
        • Rebrand this library.
        • Remove copyright notices.
        • Remove author credits.
        • Claim authorship of the library.
        • Claim ownership of the source code.
        • Sell the library itself.
        • Redistribute the library source code.
        • Redistribute modified versions of the library.
        • Upload this library under another name to
          GitHub, GitLab, Bitbucket, PyPI,
          npm, Maven Central or any other public repository.
        • Bundle this library as a standalone commercial product.
        • Reverse engineer the library for the purpose of creating a competing
          library substantially derived from this work.
        
        ======================================================================
        4. MODIFICATIONS
        ======================================================================
        
        You may modify the source code only for your own internal use.
        
        Modified versions:
        
        • may NOT be redistributed,
        • may NOT be published,
        • may NOT be sold,
        • may NOT be relicensed
        
        without prior written permission from
        MY727INFOTECH INDIA PRIVATE LIMITED.
        
        ======================================================================
        5. ATTRIBUTION
        ======================================================================
        
        The following notices must remain intact in all copies of the software:
        
        Copyright (c) 2026
        MY727INFOTECH INDIA PRIVATE LIMITED
        
        Originally designed and developed by
        T.P. Thangaprabhu.
        
        Applications built using this library are encouraged (but not required)
        to include the acknowledgement:
        
        "Powered by MY727FINANCE"
        
        ======================================================================
        6. TRADEMARKS
        ======================================================================
        
        The names:
        
        • MY727FINANCE
        • MY727INFOTECH
        • MY727
        
        and associated logos are trademarks or proprietary marks of
        MY727INFOTECH INDIA PRIVATE LIMITED.
        
        No permission is granted to use these trademarks in any manner that
        suggests endorsement, ownership or affiliation without prior written
        permission.
        
        ======================================================================
        7. COPYRIGHT
        ======================================================================
        
        Ownership of this software shall always remain with
        
        MY727INFOTECH INDIA PRIVATE LIMITED.
        
        No ownership rights are transferred under this License.
        
        ======================================================================
        8. NO WARRANTY
        ======================================================================
        
        THIS 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,
        NON-INFRINGEMENT, ACCURACY OR RELIABILITY.
        
        THE ENTIRE RISK ARISING OUT OF THE USE OR PERFORMANCE OF THE SOFTWARE
        REMAINS WITH THE USER.
        
        ======================================================================
        9. LIMITATION OF LIABILITY
        ======================================================================
        
        IN NO EVENT SHALL MY727INFOTECH INDIA PRIVATE LIMITED,
        ITS DIRECTORS, EMPLOYEES, DEVELOPERS OR CONTRIBUTORS BE LIABLE FOR
        ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL
        DAMAGES ARISING FROM THE USE OR INABILITY TO USE THIS SOFTWARE,
        EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
        
        ======================================================================
        10. TERMINATION
        ======================================================================
        
        Any violation of this License automatically terminates all rights
        granted under this License.
        
        Upon termination, all copies of the software under the violating
        party's control shall immediately cease to be used or redistributed
        to the extent required by applicable law.
        
        ======================================================================
        11. GOVERNING LAW
        ======================================================================
        
        This License shall be governed by and interpreted in accordance with
        the laws of the Republic of India.
        
        Any dispute arising from this License shall be subject to the exclusive
        jurisdiction of the competent courts located in Chennai, Tamil Nadu,
        India.
        
        ======================================================================
        12. CONTACT
        ======================================================================
        
        MY727INFOTECH INDIA PRIVATE LIMITED
        
        Website:
        https://www.my727infotech.co.in
        
        Email:
        prabhu@my727infotech.co.in
        
        ======================================================================
        
        Copyright (c) 2026
        MY727INFOTECH INDIA PRIVATE LIMITED
        
        Original Software Design & Development
        
        T.P. Thangaprabhu
        B.Sc., MBA, CIMA Adv Dip MA (UK), FCMA, ACPIFSD (IIT Roorkee)
        
        Cost Accountant | Full Stack Developer | Data Scientist
        
        All Rights Reserved.
        
        ======================================================================
        END OF LICENSE
        ======================================================================
Keywords: finance,financial-analysis,ratios,risk,accounting,audit,numpy
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Topic :: Office/Business :: Financial
Classifier: Intended Audience :: Financial and Insurance Industry
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.22
Requires-Dist: pandas>=1.4
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Dynamic: license-file

# MY727FINANCE

A professional Python library for **Quantitative Finance**, **Financial Analysis**, **Corporate Finance**, **Cost & Management Accounting**, **Audit Analytics**, and **Business Intelligence**.

MY727FINANCE provides a NumPy-style API for financial calculations, allowing developers, accountants, auditors, analysts, researchers, students, and businesses to perform financial computations using a single, lightweight library.

---

## Designed & Developed By

**T.P. Thangaprabhu**  
**B.Sc., MBA, CIMA Adv Dip MA (UK), FCMA, ACPIFSD (IIT Roorkee)**

**Cost Accountant | Full Stack Developer | Data Scientist**

Founder & Director  
**MY727INFOTECH INDIA PRIVATE LIMITED**

---

# Installation

## From PyPI

```bash
pip install my727finance
```

## From Wheel

```bash
pip install my727finance-0.1.0-py3-none-any.whl
```

## Development Installation

```bash
pip install -e ".[dev]"
```

---

# Quick Start

```python
import my727finance as mf

ratio = mf.ratios.current_ratio(
    150000,
    75000,
)

print(ratio)
```

Output

```
2.0
```

---

# Example

```python
import my727finance as mf

summary = mf.management_insights.financial_health_summary(
    current_assets=200000,
    current_liabilities=100000,
    total_debt=300000,
    average_shareholders_equity=500000,
    net_income=80000,
    revenue=1000000,
    average_total_assets=900000,
)

print(summary)
```

---

# Features

✔ Financial Mathematics

✔ Financial Ratio Analysis

✔ Financial Statement Analysis

✔ Technical Indicators

✔ Portfolio Risk Analytics

✔ Cash Flow Analysis

✔ Working Capital Analysis

✔ Cost Accounting

✔ Cost Volume Profit Analysis

✔ Standard Costing Variance Analysis

✔ Audit Analytics

✔ Management Insights

✔ NumPy-first API

✔ Pandas-friendly

✔ Extensive Input Validation

✔ Type Hints

✔ Comprehensive Automated Tests

---

# Module Overview

| Module | Description |
|---------|-------------|
| financial_math | Time Value of Money, NPV, IRR, Loan Calculations, Amortization |
| indicators | SMA, EMA, RSI, MACD, Bollinger Bands |
| risk | Returns, Volatility, Sharpe Ratio, Sortino Ratio, VaR, Beta |
| ratios | Liquidity, Profitability, Leverage, Efficiency and Valuation Ratios |
| statement_analysis | Vertical Analysis, Horizontal Analysis and Trend Analysis |
| cash_flow | Free Cash Flow, Cash Conversion Cycle and Cash Flow Ratios |
| working_capital | Working Capital Analysis and Efficiency Metrics |
| costing | Contribution Margin, Break-even Analysis and CVP |
| variance_analysis | Material, Labour, Overhead and Sales Variances |
| audit_analytics | Benford Analysis, Outlier Detection and Duplicate Detection |
| management_insights | DuPont Analysis, Altman Z-Score and Financial Health Summary |

---

# Design Principles

MY727FINANCE has been designed with the following principles:

- Simple API
- High Performance
- NumPy-first
- Pandas-friendly
- Lightweight
- Well Documented
- Highly Tested
- Easy to Extend
- Enterprise Ready

---

# Dependencies

Only two external libraries are required:

- NumPy
- Pandas

This keeps the library lightweight and suitable for offline environments.

---

# Supported Python Versions

- Python 3.9+
- Python 3.10
- Python 3.11
- Python 3.12

---

# Testing

MY727FINANCE includes an extensive automated testing suite.

Current Quality Metrics

- **490 Automated Tests**
- **490 Passed**
- **0 Failed**
- **Approximately 88% Code Coverage**

Run the tests:

```bash
pytest -v
```

Run coverage:

```bash
pytest --cov=my727finance --cov-report=term-missing
```

---

# Build

```bash
python -m build
```

---

# Publish to PyPI

```bash
python -m pip install --upgrade build twine

python -m build

twine upload dist/*
```

---

# Example Usage

```python
import my727finance as mf

prices = [100,102,101,105,107,110]

returns = mf.risk.simple_returns(prices)

print(
    mf.risk.sharpe_ratio(returns)
)

print(
    mf.indicators.rsi(prices)
)

print(
    mf.ratios.current_ratio(
        250000,
        100000
    )
)
```

---

# Disclaimer

MY727FINANCE provides standard financial and accounting calculations for educational, analytical and professional purposes.

The results generated by this library should not be considered financial, investment, legal, accounting, taxation or audit advice.

Users should apply appropriate professional judgment and independently verify all calculations before making financial or business decisions.

---

# License

This software is licensed under the **MY727FINANCE Community License v1.0**.

Please read the **LICENSE** file before using or distributing this software.

---

# Copyright

Copyright © 2026

**MY727INFOTECH INDIA PRIVATE LIMITED**

All Rights Reserved.

Original Software Design & Development

**T.P. Thangaprabhu**

B.Sc., MBA, CIMA Adv Dip MA (UK), FCMA, ACPIFSD (IIT Roorkee)

Cost Accountant | Full Stack Developer | Data Scientist

Founder & Director

MY727INFOTECH INDIA PRIVATE LIMITED

---

# Contact

**MY727INFOTECH INDIA PRIVATE LIMITED**

Email: prabhu@my727infotech.co.in

Website: https://www.my727infotech.co.in
