Metadata-Version: 2.4
Name: nesco
Version: 1.5.0
Summary: A Python module for Northern Electric Supply Company Limited (NESCO) Smart Meters
Author-email: Md Minhazul Haque <mdminhazulhaque@gmail.com>
Maintainer-email: Md Minhazul Haque <mdminhazulhaque@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/mdminhazulhaque/python-nesco
Project-URL: Repository, https://github.com/mdminhazulhaque/python-nesco
Project-URL: Bug Reports, https://github.com/mdminhazulhaque/python-nesco/issues
Project-URL: Source Code, https://github.com/mdminhazulhaque/python-nesco
Keywords: nesco,smart-meter,electricity,prepaid,bangladesh,utility,cli
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Utilities
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Typing :: Typed
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28.0
Requires-Dist: click>=8.0.0
Requires-Dist: tabulate>=0.9.0
Requires-Dist: beautifulsoup4>=4.9.0

# 🔌 NESCO Prepaid CLI

[![PyPI version](https://badge.fury.io/py/nesco.svg)](https://badge.fury.io/py/nesco)
[![Python Versions](https://img.shields.io/pypi/pyversions/nesco.svg)](https://pypi.org/project/nesco/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Downloads](https://pepy.tech/badge/nesco)](https://pepy.tech/project/nesco)

A command-line interface (CLI) tool to collect information about **Northern Electric Supply Company Limited (NESCO)** prepaid electricity accounts.

## Installation

Install the package using pip:

```bash
pip install nesco
```

## Usage

### Get Balance

Retrieve the current balance for a specific account:

```bash
nesco-cli get-balance -c <customer_number>
```

Example:

```bash
$ nesco-cli get-balance -c 12345678
987.43
```

### Get Recharge History

View the recharge history for a specific account:

```bash
nesco-cli get-recharge-history -c <customer_number>
```

Example:

```bash
$ nesco-cli get-recharge-history -c 12345678
  ID  Token                     Power    Amount    Via     Date                  Status
----  ------------------------  -------  --------  ------  --------------------  --------
   1  0183-4597-1724-6908-6354   957.12   1000     ROCKET  01-JAN-2025 11:00 AM   Success
   2  4815-9365-5179-7943-3266   258.65    400     BKASH   01-FEB-2025 11:00 PM   Success
   3  2265-9417-3127-5691-9994   134.45    400     BKASH   01-MAR-2025 11:00 PM   Success
   ...
```

### Get Monthly Consumption

Retrieve monthly consumption details for a specific account:

```bash
nesco-cli get-monthly-consumption -c <customer_number>
```

Example:

```bash
$ nesco-cli get-monthly-consumption -c 12345678
  Year  Month        Recharge    Discount    Usage
------  ---------  ----------  ----------  -------
  2025  March            2000       -20    1875.22
  2025  February          500        -5     433.15
  2025  January          1000       -10     812.08
  ...
```

Replace `<customer_number>` with your actual account number to use the commands.

### Get Customer Info

```
$ nesco-cli get-customer-info -c 12345678
Name                Address   Electricity Office  Feeder Name      Meter Number    Approved Load (kW)
------------------  --------  ------------------  -------------  --------------  --------------------
MD. MINHAZUL HAQUE  RAJSHAHI  Rajshahi S&D4       GREATER ROAD      12345678901                     2
```
