🔌 DPDC Prepaid CLI

A Python CLI tool to collect information about Dhaka Power Distribution Company Limited (DPDC) prepaid electricity accounts. Get real-time balance, customer information, and account details directly from your terminal.

✨ Features

• 💰 Balance Check: Get current balance and account information
• 👤 Customer Info: Retrieve detailed customer and meter information
• 🔐 Secure Authentication: Automatic token-based authentication with DPDC API
• 🚀 Fast & Lightweight: Built with Python and designed for speed
• 🔒 GraphQL API: Modern API integration with DPDC's official endpoints

📦 Installation

From PyPI (Recommended)

pip install dpdc

From Source

git clone https://github.com/mdminhazulhaque/python-dpdc.git
cd python-dpdc
pip install -e .

🚀 Quick Start

After installation, use the dpdc-cli command:

# Get help
dpdc-cli --help

# Check balance
dpdc-cli get-balance -c YOUR_CUSTOMER_NUMBER

# Get customer information
dpdc-cli get-customer-info -c YOUR_CUSTOMER_NUMBER

📖 Usage

Usage: dpdc-cli [OPTIONS] COMMAND [ARGS]...

  A CLI tool for DPDC Prepaid electricity account management.

Options:
  --help  Show this message and exit.

Commands:
  get-balance        Get current account balance and customer information
  get-customer-info  Get detailed customer information

💡 Examples

💰 Check Balance

Get your current account balance and information:

$ dpdc-cli get-balance -c 1234567890

Sample Output:

accountId            1234567890
accountType          Pre Paid
balanceRemaining     1250.50
connectionStatus     Active

👤 Get Customer Information

Retrieve comprehensive customer details:

$ dpdc-cli get-customer-info -c 1234567890

Sample Output:

accountId            1234567890
customerName         MD. JOHN DOE
customerClass        Residential
mobileNumber         01234567890

🛠️ Development

Prerequisites

• Python 3.8 or higher
• pip package manager

Setting up for Development

1. Clone the repository:

git clone https://github.com/mdminhazulhaque/python-dpdc.git
cd python-dpdc

2. Create a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install in development mode:

pip install -e .

Dependencies

• requests - HTTP library for API calls
• click - Command line interface framework
• tabulate - Pretty-print tabular data

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

1. Fork the project
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

⚠️ Disclaimer

This is an independent, unofficial tool and is not affiliated with, endorsed by, or connected to the Dhaka Power Distribution Company (DPDC).

Every piece of information this tool retrieves is already publicly available to any consumer through the official customer portal and mobile app. This project does not reverse engineer, bypass, or circumvent anything — it simply accesses the same publicly accessible consumer information programmatically and presents it in a convenient format.

Please only look up accounts you are authorized to access. Use at your own discretion; the authors are not responsible for any issues that may arise from using this tool.