semvec/pypi-packages huggingface dataset:
nalogovich 1.0.7
Wrapper for integration with the 'Мой налог' API service
Requires Python: >=3.8

<p align="left">
  <img src="https://raw.githubusercontent.com/Ramedon1/nalogovich/main/docs/assets/icon.svg" alt="Nalogovich Logo" width="150">
</p>

# Nalogovich
### Асинхронная Python библиотека (SDK) для API "Мой Налог" (ЛК НПД)

[![PyPI version](https://img.shields.io/pypi/v/nalogovich.svg)](https://pypi.org/project/nalogovich/)
[![Python versions](https://img.shields.io/pypi/pyversions/nalogovich.svg)](https://pypi.org/project/nalogovich/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![CodeFactor](https://www.codefactor.io/repository/github/ramedon1/nalogovich/badge)](https://www.codefactor.io/repository/github/ramedon1/nalogovich)
[![Documentation](https://img.shields.io/badge/GitBook-Docu-lightblue)](https://nalogovich.readthedocs.io/ru/latest/)

**Nalogovich** - библиотека для интеграции с сервисом "Мой Налог". Идеально подходит для автоматизации отчетности самозанятых, создания платежных ботов в Telegram или CRM-систем.

[Документация](https://nalogovich.readthedocs.io/ru/latest/) | [Сообщить об ошибке](https://github.com/Ramedon1/nalogovich/issues)

---
## Установка

```bash
pip install nalogovich
```
Или через менеджер пакетов [uv](https://github.com/astral-sh/uv):
```bash
uv add nalogovich
```

## Быстрый старт

Создание чека:

```python
import asyncio
from nalogovich.lknpd import NpdClient

async def main():
    async with NpdClient(inn="123456789012", password="your_password") as client:
        await client.auth()
        
        # Создаем новый чек
        receipt = await client.create_check(
            name="Консультационные услуги",
            amount=1500,
        )
        
        checks = await client.get_checks(limit=5)
        print(f"Последние операции: {len(checks.content)}")

if __name__ == "__main__":
    asyncio.run(main())
```

### С остальными примерами и методами можно ознакомиться в [документации](https://nalogovich.readthedocs.io/ru/latest/)

## Как получить пароль для использования Nalogovich

Если вы не знаете свой пароль или он у вас не установлен, то его можно установить вручную (даже не зная его):

1.  Перейдите в [Личный кабинет налогоплательщика ФЛ](https://lkfl2.nalog.ru/).
2.  Авторизуйтесь через **Госуслуги (ЕСИА)** или любым удобным способом, который вам подходит.
3.  Зайдите в **Настройки профиля** → **Безопасность** → **Изменить пароль**.
4.  Установите новый пароль.

> Установленный пароль станет единым для входа в кабинет Физлица и в сервис «Мой налог». Используйте его вместе с вашим ИНН для авторизации в библиотеке.
multimodal-communication 0.5.7
Add your description here
Requires Python: >=3.10

# Multimodal Communication

`multimodal_communication` provides utilities for sending text messages through email-to-SMS gateways and managing files in Google Cloud Storage. This package is designed to simplify communication and data management across different platforms.

## Features

- **SMS Messaging**: Send text messages via email-to-SMS gateways (supports multiple carriers)
- **Asynchronous Support**: Utilizes `asyncio` for non-blocking message sending
- **Batch Messaging**: Send messages to multiple recipients simultaneously
- **Google Cloud Storage**: Easy file upload, download, and deletion operations
- **Multiple Data Format Support**: Work with CSV, JSON, and pickled objects

## Components

### SMS Messaging Module

This module allows you to send text messages through email-to-SMS gateways, supporting various carriers including Verizon, T-Mobile, Sprint, AT&T, and more.

```python
from multimodal_communication.python_texting import send_text_message

# Send a simple text message
send_text_message(
    message="Hello from Python!",
    subject="Notification",
    phone_number="1234567890",
    carrier="tmobile",
    email="your-email@gmail.com",
    email_password="your-app-password"
)
```

### CloudHelper

The `CloudHelper` class provides an interface for interacting with Google Cloud Storage:

```python
from multimodal_communication.cloud_functions import CloudHelper

# Upload a local file to Google Cloud Storage
cloud = CloudHelper(path="path/to/local/file.csv")
cloud.upload_to_cloud(bucket_name="my-bucket", file_name="cloud-file.csv")

# Upload an object from memory
import pandas as pd
df = pd.DataFrame({"col1": [1, 2], "col2": [3, 4]})
cloud = CloudHelper(obj=df)
cloud.upload_to_cloud(bucket_name="my-bucket", file_name="dataframe.csv")

# Download a file from Google Cloud Storage
cloud = CloudHelper()
df = cloud.download_from_cloud("my-bucket/path/to/file.csv")

# Delete a file from Google Cloud Storage
cloud = CloudHelper()
cloud.delete_from_cloud(bucket_name="my-bucket", file_name="file-to-delete.csv")
```

## Installation (with local project download)

```bash
pip install . -e
```

## Requirements

- Python 3.6+
- pandas
- google-cloud-storage
- aiosmtplib

## Setup

### Google Cloud Authentication

To use the `CloudHelper` class:

1. Set up Application Default Credentials (ADC) as described in the [Google Cloud documentation](https://cloud.google.com/docs/authentication/external/set-up-adc)
2. Ensure your user account or service account has the required permissions (e.g., "storage.buckets.list")

### Gmail Authentication for SMS

To use the SMS messaging functionality with Gmail:

1. Create an App Password for your Google account (if you have 2FA enabled)
2. Or enable "Less secure app access" (not recommended for production)

## License

MIT License

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.