Merge pull request #17 from thedtvn/feat/big-update

Feat/big update

Author: thedtvn

.gitignore

@@ -130,6 +130,7 @@ celerybeat.pid
 # Environments
 .env
 .venv
+
 env/
 venv/
 ENV/
@@ -165,10 +166,17 @@ cython_debug/
 #  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
-#.idea/
+.idea/
 
 # Ruff stuff:
 .ruff_cache/
 
 # PyPI configuration file
-.pypirc
+.pypirc
+
+# Documentation
+!docs/templates/
+docs/**/*.html
+docs/**/*.js
+docs/**/*.css
+!docs/templates/**/*

.readthedocs.yaml

@@ -5,7 +5,6 @@
 # Required
 version: 2
 
-
 build:
   os: ubuntu-22.04
   tools:
@@ -17,17 +16,6 @@ build:
     - python3-setuptools
     - gcc
   commands:
-    - pip install pip-tools
-    - pip-compile docs/requirements.in
-    - pip install -r docs/requirements.txt
+    - pip install pdoc
     - pip install .
-    - python docs/gen_doc.py
-    - mkdocs build -d $READTHEDOCS_OUTPUT/html/
-
-mkdocs:
-  configuration: mkdocs.yml
-
-# Optionally declare the Python requirements required to build your docs
-python:
-   install:
-   - requirements: docs/requirements.txt
+    - python docs_gen.py --rtfd

README.MD

@@ -1,39 +1,95 @@
 # MBBank API for Python
-A unofficially lightweight Python Api for the "Military Commercial Joint Stock Bank" personal account
 
-## Why we  have this lib ?
+An unofficial, lightweight Python API for the "Military Commercial Joint Stock Bank" (MBBank) personal accounts.
 
-Because I don't want to lose money on some api services like [casso.vn](https://casso.vn/) or [payos.vn](https://payos.vn/)
-when have freemium tier but with limit :>
+> [!WARNING]
+> This library is unofficial and not endorsed by MBBank. Use it at your own risk.
 
-What you need that it use this lib to make your own code so you can use it free forever
+## Features
 
-[Documentation & FAQ](http://mbbank.rtfd.io/)
+-   **Login**: Authenticate with your MBBank credentials.
+-   **Balance**: Check account balances.
+-   **Transaction History**: Retrieve transaction history for your accounts.
+-   **Transfer**: Perform money transfers to another account*.
+-   **Async Support**: Includes asynchronous capabilities for better performance.
 
-## Requires
-   - [onnx with cuda](https://onnxruntime.ai/getting-started) (optional if you want to use cuda gpu)
+> [!NOTE]
+> Transfer feature requires MBBank APP on your phone to scan OTP code and confirm the transfer.
 
-   - python3
- 
-## Install
-    pip install mbbank-lib
-   or Dev Ver
-   
-    pip install git+https://github.com/thedtvn/MBBank
+## Installation
+
+### From PyPI
+
+```bash
+pip install mbbank-lib
+```
+
+### From Source (Development Version)
+
+```bash
+pip install git+https://github.com/thedtvn/MBBank
+```
+
+## Requirements
+
+-   Python 3.x
+-   [onnxruntime-gpu](https://onnxruntime.ai/getting-started) (Optional, for CUDA GPU support)
+
+## Quick Start
+
+Here is a simple example of how to log in and fetch your account balance:
+
+```python
+import mbbank
+
+def main():
+    username = "YOUR_USERNAME"
+    password = "YOUR_PASSWORD"
+
+    try:
+        mb = mbbank.MBBank(username=username, password=password)
+        
+        # Get balance information
+        balance_info = mb.getBalance()
+        
+        if balance_info.acct_list:
+            print(f"Login successful! Found {len(balance_info.acct_list)} account(s).")
+            for acct in balance_info.acct_list:
+                print(f"Account: {acct.acctNo} - Balance: {acct.currentBalance} {acct.currency}")
+        else:
+            print("Login successful, but no accounts found.")
+
+    except Exception as e:
+        print(f"An error occurred: {e}")
+
+if __name__ == "__main__":
+    main()
+```
+
+For more examples, check the [examples directory](https://github.com/thedtvn/MBBank/tree/main/examples) or [docs](http://mbbank.rtfd.io/)
+
+## Documentation
+
+For detailed documentation and FAQ, visit: [http://mbbank.rtfd.io/](http://mbbank.rtfd.io/)
+
+## Related Projects
+
+-   [Payment QR Code Generator (vietqr.io)](https://vietqr.io/)
+-   [MBBank JS API](https://github.com/CookieGMVN/MBBank)
+-   [MBBank OCR](https://github.com/thedtvn/mbbank-capcha-ocr)
 
 ## Donate
-If you like this project and want to support it, you can do so by donating via the following methods:
-- **Momo**: 0961291206
-- **ZaloPay**: 0961291206
-- **Banking**:
-  - Techcombank - NGUYEN DUONG TUAN
-  - Account Nickname: THEDTVN
-  - Account Nuber: 9612912060
 
-## Extra Info
-- Payment QR Code Generator
-  - [vietqr.io](https://vietqr.io/)
+If you find this project helpful, you can support the developer:
+
+-   **Momo**: 0961291206
+-   **ZaloPay**: 0961291206
+-   **Banking**:
+    -   Bank: Techcombank
+    -   Account Name: NGUYEN DUONG TUAN
+    -   Account Number: 9612912060
+    -   Nickname: THEDTVN
 
-- [MBBank JS API](https://github.com/CookieGMVN/MBBank)
+## License
 
-- [MBBank OCR](https://github.com/thedtvn/mbbank-capcha-ocr)
+This project is licensed under the MIT License. See the [LICENSE](LICENSE.txt) file for details.

docs/gen_doc.py

@@ -0,0 +1,50 @@
+/* index.css — styles for preload/index.html */
+:root{
+  --bg: #0f1724;
+  --card: #0b1220;
+  --text: #e6eef8;
+  --muted: #9fb0c8;
+  --accent: #4fb3ff;
+}
+
+*{box-sizing:border-box}
+html,body{height:100%}
+body{
+  margin:0;
+  font-family: Inter, Segoe UI, Roboto, "Helvetica Neue", Arial, sans-serif;
+  background: linear-gradient(180deg,#071023 0%, #071a2a 100%);
+  color:var(--text);
+  -webkit-font-smoothing:antialiased;
+  -moz-osx-font-smoothing:grayscale;
+}
+
+.container{
+  max-width:900px;
+  margin:48px auto;
+  padding:28px;
+  background:rgba(10,18,28,0.6);
+  border-radius:12px;
+  box-shadow:0 10px 30px rgba(2,6,23,0.6);
+}
+
+.hero h1{margin:0 0 8px;font-size:28px}
+.lead{color:var(--muted);margin:0 0 18px}
+
+h2{color:var(--accent);margin-top:26px}
+section p{line-height:1.6;color:var(--text);margin:8px 0}
+ul{margin:8px 0 16px 20px;color:var(--text)}
+dl{margin:8px 0}
+dt{font-weight:600;margin-top:12px;color:var(--accent)}
+dd{margin:6px 0 12px 0;color:var(--muted)}
+
+a{color:var(--accent);text-decoration:none}
+a:hover{text-decoration:underline}
+
+footer.footnote{margin-top:20px;border-top:1px dashed rgba(255,255,255,0.04);padding-top:12px;color:var(--muted);font-size:13px}
+
+/* small screens */
+@media (max-width:520px){
+  .container{margin:18px;padding:18px}
+  .hero h1{font-size:20px}
+}
+