Metadata-Version: 2.4
Name: mts_balance_checker
Version: 0.1.1
Summary: CLI utility for checking MTS balance, traffic, and SMS from the command line.
Home-page: https://github.com/AsmanovLev/MTS-Balance-Checker
Author: AsmanovLev
Author-email: asmanovlev@gmail.com
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Dynamic: license-file

# MTS-Balance-Checker

Утилита командной строки для проверки баланса, остатков трафика и SMS оператора МТС (Россия). Использует API личного кабинета МТС.

## ⚠️ Дисклеймер
Эта утилита явялется следствием [вайбкодинга](https://ru.wikipedia.org/wiki/%D0%92%D0%B0%D0%B9%D0%B1-%D0%BA%D0%BE%D0%B4%D0%B8%D0%BD%D0%B3), создано [Gemini 2.5 Flash](https://gemini.google.com) при 0 внесении правок в код. **Автор не несёт какой-либо отсветсвенности ни за его работоспособность, ни за его безопасность**

>Код был минимально проверен на его корректную работоспособоность, из-за чего было решено его запакетировать и публиковать. Можно только сказать что этот _Readme_ отредактирован вручную. 🐈

## Установка

Вы можете установить пакет с помощью `pip`:
```
https://pypi.org/project/mts-balance-checker/0.1.0/
```

## Использование

Для работы утилите требуются ваш номер телефона и строка аутентификационных cookie из браузера. (Например, это можно сделать [этим](https://chromewebstore.google.com/detail/cclelndahbckbenkjhflpdbgdldlbecc) расширением просто скопировав куки сайта [lk.mts.ru](lk.mts.ru))

**ПРИМЕР 1: Человекочитаемый вывод**

```
mts-check --cookies "JSESSIONID=...; lk_mts_sid=..." --phone 79130598041 --netscape --human --hide-phone
```
```
===============================
 ДАННЫЕ ПО СЧЕТУ МТС (СКРЫТО)
===============================
Баланс (руб.)    : 171.51 руб.
Обновление пакета: 26.10.2025
Интернет         : 26.05 ГБ (из 30.0 ГБ)
Минуты           : 405 мин (из 600 мин)
SMS              : 600 шт (из 600 шт)
===============================
```

**ПРИМЕР 2: Машиночитаемый вывод (JSON)**

```
mts-check --phone 79XXXXXXXXX --cookies-file ~/mts_cookies.txt --output json
```
```
{
  "balance_rub": 171.51,
  "deadline_date": "26.10.2025",
  "remaining_internet_mb": 26674.05,
  "total_internet_gb": 30.0,
  "remaining_minutes_min": 405,
  "total_minutes_min": 600,
  "remaining_sms_count": 600,
  "total_sms_count": 600
}
```

### Основные аргументы

| **Флаг** | **Описание** | 
| :------- | :----------- |
| `--phone` | Ваш номер телефона в формате 79XXXXXXXXX. | 
| `--cookies` | Полная строка cookie (альтернатива: `--cookies-file`). | 
| `--cookies-file` | Путь к файлу с cookie. | 
| `--human` | **Человекочитаемый вывод** (таблица). | 
| `--output parse` | **Машиночитаемый вывод** key=value (по умолчанию). | 
| `--output json` | **Машиночитаемый вывод** в формате JSON. | 
| `--lang {ru, en}` | Язык вывода. | 
| `--verbose` | Вывод логов процесса получения данных в `stderr`. | 
| `--hide-phone` | Спрятать номер телефона в выводе. | 

## Лицензия

Проект распространяется под лицензией **MIT**. Подробнее см. в файле `LICENSE`.
