nepse-cli 1.0.0__tar.gz

nepse_cli-1.0.0/.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "python-envs.pythonProjects": []
+}

nepse_cli-1.0.0/FAMILY_IPO_README.md

@@ -0,0 +1,160 @@
+# 👨‍👩‍👧‍👦 Family IPO Automation - User Guide
+
+## 🎯 Overview
+This updated system allows you to manage and apply for IPOs for multiple family members from a single interface!
+
+## 📋 Features
+- ✅ **Multi-member support** - Add Dad, Mom, siblings, etc.
+- ✅ **Individual credentials** - Each member has their own login details
+- ✅ **Separate IPO settings** - Different Kitta amounts and CRN per member
+- ✅ **Interactive Selection** - Use arrow keys to choose who to apply for
+- ✅ **Portfolio tracking** - Check holdings for each family member
+- ✅ **Auto-migration** - Old single-member config automatically converts
+
+## 🚀 Quick Start
+
+### 1️⃣ First Time Setup
+Run the program and choose option **2** to add family members:
+```bash
+nepse add-member
+```
+
+### 2️⃣ Add Each Family Member
+For each person (Dad, Mom, Brother, etc.), provide:
+- **Name**: e.g., "Dad", "Mom", "Me", "Brother"
+- **DP Value**: Your DP number (e.g., 139)
+- **Username**: Meroshare username
+- **Password**: Meroshare password
+- **Transaction PIN**: 4-digit PIN for submissions
+- **Applied Kitta**: How many shares to apply for (e.g., 10, 20)
+- **CRN Number**: Customer Reference Number
+
+### 3️⃣ Apply for IPO
+Run the apply command and select which family member to apply for:
+```bash
+nepse apply
+# Use Up/Down arrows to select member and press Enter
+```
+
+## 📁 File Structure
+
+### `family_members.json` (Auto-created)
+Stores all family member credentials:
+```json
+{
+  "members": [
+    {
+      "name": "Dad",
+      "dp_value": "139",
+      "username": "dad_username",
+      "password": "dad_password",
+      "transaction_pin": "1234",
+      "applied_kitta": 10,
+      "crn_number": "DAD_CRN_NUMBER"
+    },
+    ...
+  ]
+}
+```
+
+### `family_members_example.json`
+Template file showing the structure for 4 family members.
+
+## 🎮 Menu Options
+
+### **1. Apply for IPO**
+- Shows interactive list of all family members
+- Select who to apply for using arrow keys
+- Automatically fills their details
+- Complete automation from login to submission
+
+### **2. Add/Update Family Member**
+- Add a new family member
+- Update existing member's details
+- Each member stores their own IPO settings
+
+### **3. List All Family Members**
+- View all configured members
+- See their usernames, DP, Kitta, and CRN
+- Quick overview of who's set up
+
+### **4. Get Portfolio**
+- Select a family member
+- Fetch their current holdings
+- See all shares they own
+
+### **5. Login (Test)**
+- Test login for a specific member
+- Verify credentials are working
+- Useful for debugging
+
+### **6. View DP List**
+- See all available Depository Participants
+- Find your DP value
+
+### **7. Exit**
+- Close the program
+
+## 🔄 Migration from Old Format
+
+If you have an existing `meroshare_config.json`, the system will:
+1. Detect it automatically
+2. Ask for a member name (e.g., "Me")
+3. Convert it to the new multi-member format
+4. Backup the old file as `meroshare_config.json.backup`
+
+## 🔒 Security Notes
+
+- ✅ Keep `family_members.json` secure
+- ✅ Set file permissions (auto-set on Linux/Mac)
+- ✅ Don't share this file or commit it to Git
+- ✅ Each member's password is stored (encrypted storage coming soon)
+
+## 💡 Example Workflow
+
+**Scenario**: Apply for IPO for entire family
+
+```bash
+# Step 1: Add all 4 members (one-time setup)
+nepse add-member
+> Enter details for Dad
+> Run again for Mom, Me, Brother
+
+# Step 2: Apply for Dad
+nepse apply
+> Select: Dad (Use arrow keys)
+> Automation runs for Dad
+
+# Step 3: Apply for Mom
+nepse apply
+> Select: Mom (Use arrow keys)
+> Automation runs for Mom
+
+# OR Apply for everyone at once!
+nepse apply-all
+```
+
+## 🛠️ Troubleshooting
+
+### "No family members found"
+- Run `nepse add-member` to add members first
+
+### "CRN number is required"
+- Make sure you entered CRN during member setup
+- Use `nepse add-member` to update the member
+
+### "Login failed"
+- Verify credentials using `nepse test-login`
+- Check DP value is correct
+- Ensure username/password are valid
+
+## 📞 Support
+
+For issues or questions:
+1. Check this README
+2. Review the example JSON file
+3. Test login for the member having issues
+
+## 🎉 Happy IPO Applying!
+
+Now you can apply for IPOs for your entire family with just a few clicks! 🚀

nepse_cli-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Nadin Tamang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE 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 AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nepse_cli-1.0.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include README.md
+include QUICK_REFERENCE.md
+include FAMILY_IPO_README.md
+include LICENSE
+include nepse-cli-image.png
+recursive-include . *.json
+recursive-include . *.txt

nepse_cli-1.0.0/PKG-INFO

@@ -0,0 +1,224 @@
+Metadata-Version: 2.4
+Name: nepse-cli
+Version: 1.0.0
+Summary: Modern CLI tool for Meroshare IPO automation and NEPSE market data with interactive TUI
+Home-page: https://github.com/menaceXnadin/nepse-cli
+Author: MenaceXnadin
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: playwright>=1.40.0
+Requires-Dist: prompt_toolkit>=3.0.48
+Requires-Dist: rich>=13.0.0
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: requests>=2.25.0
+Requires-Dist: beautifulsoup4>=4.9.0
+Requires-Dist: cloudscraper>=1.2.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Nepse CLI - Meroshare IPO Automation & Market Data
+
+![Nepse CLI](nepse-cli-image.png)
+
+A modern, interactive command-line tool to automate IPO applications on Meroshare for multiple family members and view real-time NEPSE market data.
+
+**✨ Now featuring a beautiful TUI with Rich tables, interactive menus, and fuzzy search!**
+
+```
+[██████████████████░░░░░░░░░░░░] 50% (3/6) Selecting DP (value: 10900)...
+```
+
+## Installation
+
+### 🚀 Easy Start (Windows)
+If you have the source code folder:
+1.  Double-click **`start_nepse.bat`**.
+2.  That's it! It will check for Python, install dependencies, and launch the tool.
+
+### Option 1: Install from Source (Recommended for Development)
+```powershell
+cd "Nepse CLI"
+pip install -e .
+```
+
+### Option 2: Install as Package (Coming Soon)
+Once published to PyPI:
+```bash
+pip install nepse-cli
+```
+
+### Browser Setup
+The CLI will automatically install Playwright browsers on first run if they're not already installed. If you prefer to install manually:
+```powershell
+playwright install chromium
+```
+
+## Usage
+
+### Interactive Shell (Recommended)
+Simply run `nepse` to enter the modern interactive shell:
+```powershell
+nepse
+```
+Once inside the shell, you **do not** need to type `nepse` again. Just type the command directly:
+*   `stonk NABIL`
+*   `ipo`
+*   `apply`
+*   `mktsum`
+
+**Shell Features:**
+*   **Command Palette**: Type `/` to search all available commands.
+*   **Autocompletion**: Type commands and see suggestions.
+*   **History**: Use Up/Down arrows to cycle through command history.
+*   **Help**: Type `help` or `?` to see the command list.
+
+### Direct Commands
+
+#### Meroshare IPO Automation
+```powershell
+# Apply for IPO (headless by default - no browser window)
+nepse apply
+
+# Apply with browser window visible
+nepse apply --gui
+
+# Apply for ALL family members (multi-tab automation)
+nepse apply-all
+
+# Apply for all members with browser visible
+nepse apply-all --gui
+
+# Add or update a family member
+nepse add-member
+
+# List all family members
+nepse list-members
+
+# Get portfolio (headless by default)
+nepse get-portfolio
+
+# Get portfolio with browser window visible
+nepse get-portfolio --gui
+
+# Test login (headless by default)
+nepse test-login
+
+# Test login with browser window visible
+nepse test-login --gui
+
+# View available DP list
+nepse dplist
+```
+
+#### Market Data Commands
+```powershell
+# View all open IPOs/FPOs
+nepse ipo
+
+# View NEPSE indices
+nepse nepse
+
+# View sub-index details (Banking, Hydropower, etc.)
+nepse subidx BANKING
+nepse subidx HYDROPOWER
+
+# View market summary
+nepse mktsum
+
+# View top 10 gainers and losers
+nepse topgl
+
+# View stock details (information only - no charts)
+nepse stonk NABIL
+nepse stonk NICA
+```
+
+## Features
+
+### 🖥️ Modern UI & UX
+- **Rich TUI**: Beautiful tables, panels, and colored output for all commands.
+- **Interactive Menus**: Select family members using arrow keys (no more typing IDs!).
+- **Smart Shell**: Autocompletion, fuzzy search, and command history.
+- **Progress Bars**: Visual feedback for all long-running operations.
+
+### 🤖 Meroshare Automation
+- ✅ **Multi-member Support**: Manage credentials for the whole family.
+- ✅ **One-Command Apply**: `nepse apply-all` applies for everyone in sequence.
+- ✅ **Interactive Selection**: Choose a specific member from a list using arrow keys.
+- ✅ **Headless Mode**: Fast and silent operation by default.
+- ✅ **Secure Storage**: Credentials stored locally in your user directory.
+
+### 📈 Market Data
+- ✅ **Live Indices**: NEPSE, Sensitive, Float, and Sub-indices.
+- ✅ **Market Summary**: Turnover, volume, market cap, and active stocks.
+- ✅ **Top Gainers/Losers**: Real-time lists of best and worst performers.
+- ✅ **Stock Details**: Price, volume, sector, and changes for any listed company.
+- ✅ **IPO Watch**: List of all open and upcoming IPOs/FPOs/Right Shares.
+
+## Configuration
+
+All credential data is stored in a **fixed location** to avoid path issues:
+
+📁 **Data Directory**: `C:\Users\%USERNAME%\Documents\merosharedata\`
+
+Files stored here:
+- `family_members.json` - All family member credentials
+- `ipo_config.json` - IPO application settings (if any)
+- `nepse_cli_history.txt` - Command history for the interactive shell
+
+This means the CLI works from **any directory** - your data is always in the same place!
+
+Family member data structure:
+
+```json
+{
+  "members": [
+    {
+      "name": "Dad",
+      "dp_value": "139",
+      "username": "your_username",
+      "password": "your_password",
+      "transaction_pin": "1234",
+      "applied_kitta": 10,
+      "crn_number": "YOUR_CRN"
+    }
+  ]
+}
+```
+
+## Security
+
+- Passwords are stored locally in JSON format
+- File permissions are set to 600 on Unix systems
+- Never commit `family_members.json` to version control
+
+## Troubleshooting
+
+**Command not found:**
+- Make sure you ran `pip install -e .` in the Nepse CLI directory
+- Restart your terminal after installation
+
+**Browser not installed:**
+- Run: `playwright install chromium`
+
+**Login fails:**
+- Test with: `nepse test-login`
+- Verify credentials with: `nepse list-members`
+- Update credentials with: `nepse add-member`

nepse_cli-1.0.0/QUICK_REFERENCE.md

@@ -0,0 +1,182 @@
+# Nepse CLI - Quick Reference Card
+
+## Interactive Shell (Recommended)
+
+```bash
+nepse
+```
+*   **Search**: Type `/` to search commands.
+*   **Navigate**: Use Up/Down arrows for history.
+*   **Select**: Use arrow keys for menus.
+
+## Market Data Commands
+
+```bash
+# View all open IPOs/FPOs
+nepse ipo
+
+# View NEPSE indices (main, sensitive, float)
+nepse nepse
+
+# View sector sub-indices
+nepse subidx BANKING          # Banking sector
+nepse subidx HYDROPOWER       # Hydropower sector
+nepse subidx FINANCE          # Finance sector
+# ... and more (see full list below)
+
+# View market summary (turnover, volume, market cap)
+nepse mktsum
+
+# View top 10 gainers and losers
+nepse topgl
+
+# View stock details (price, volume, sector, etc.)
+nepse stonk NABIL             # Nabil Bank
+nepse stonk NICA              # NIC Asia Bank
+nepse stonk UPPER             # Upper Tamakoshi
+# ... any valid stock symbol
+```
+
+## Available Sub-Indices
+
+- `BANKING` - Banking SubIndex
+- `DEVBANK` - Development Bank Index
+- `FINANCE` - Finance Index
+- `HOTELS AND TOURISM` - Hotels And Tourism
+- `HYDROPOWER` - HydroPower Index
+- `INVESTMENT` - Investment
+- `LIFE INSURANCE` - Life Insurance
+- `MANUFACTURING AND PROCESSING` - Manufacturing And Processing
+- `MICROFINANCE` - Microfinance Index
+- `MUTUAL FUND` - Mutual Fund
+- `NONLIFE INSURANCE` - Non Life Insurance
+- `OTHERS` - Others Index
+- `TRADING` - Trading Index
+
+## Meroshare IPO Automation
+
+```bash
+# Apply for IPO (single member)
+nepse apply                   # Headless mode (default)
+nepse apply --gui             # Show browser
+
+# Apply for ALL family members
+nepse apply-all               # Headless mode (default)
+nepse apply-all --gui         # Show browser
+
+# Manage family members
+nepse add-member              # Add/update member
+nepse list-members            # List all members
+
+# Portfolio and login
+nepse get-portfolio           # Get portfolio (headless)
+nepse get-portfolio --gui     # Get portfolio (show browser)
+nepse test-login              # Test login (headless)
+nepse test-login --gui        # Test login (show browser)
+
+# Utilities
+nepse dplist                  # View available DPs
+```
+
+## Quick Tips
+
+💡 **Interactive Selection:**
+When running `nepse apply` or `nepse login`, use **Up/Down arrows** to select a family member from the list and press **Enter**.
+
+💡 **Check IPO before applying:**
+```bash
+nepse ipo        # See what's open
+nepse apply      # Apply for selected IPO
+```
+
+💡 **Market snapshot:**
+```bash
+nepse nepse      # Overall indices
+nepse mktsum     # Market statistics
+nepse topgl      # Best performers
+```
+
+💡 **Research a stock:**
+```bash
+nepse stonk NABIL     # Get stock info
+nepse subidx BANKING  # Check sector trend
+```
+
+💡 **Monitor portfolio:**
+```bash
+nepse stonk <SYMBOL>  # Check stock price
+nepse get-portfolio   # View holdings
+```
+
+## Notes
+
+⚠️ **Internet Required:** All market data commands need internet connection
+
+⚠️ **No Charts/Alerts:** Stock command shows info only (no chart generation or price alerts)
+
+⚠️ **Real-time Data:** Data is fetched in real-time from ShareSansar, MeroLagani, and NepseAlpha
+
+✅ **Fast & Lightweight:** Terminal-based, no GUI overhead
+
+✅ **Multi-source:** Uses multiple APIs for reliability
+
+## Data Sources
+
+- 📊 **IPO Data:** ShareHub Nepal API
+- 📈 **Indices:** ShareSansar
+- 💰 **Market Summary:** ShareSansar
+- 🏆 **Top G/L:** MeroLagani
+- 📉 **Stock Prices:** NepseAlpha API (primary), ShareSansar (fallback)
+
+## Installation
+
+```bash
+# Install CLI globally
+cd "Nepse CLI"
+pip install -e .
+
+# Install dependencies
+pip install -r requirements-playwright.txt
+
+# Install browser for automation
+playwright install chromium
+```
+
+## Help
+
+```bash
+# General help
+nepse --help
+
+# Command-specific help
+nepse apply --help
+nepse subidx --help
+nepse stonk --help
+```
+
+## Examples
+
+### Check market before trading:
+```bash
+nepse mktsum     # Market overview
+nepse topgl      # See trends
+nepse stonk UPPER # Check specific stock
+```
+
+### Research IPO:
+```bash
+nepse ipo              # See open IPOs
+nepse subidx BANKING   # Check sector performance
+nepse apply            # Apply if interested
+```
+
+### Monitor portfolio:
+```bash
+nepse portfolio        # View holdings
+nepse stonk NABIL     # Check stock price
+nepse nepse           # Overall market trend
+```
+
+---
+
+**Need more help?** Check `README.md` and `MARKET_DATA_USAGE.md` for detailed documentation.