semvec/pypi-packages huggingface dataset:
docx-merge-xml 0.1.1
A fast Python library for merging two Microsoft Word (.docx) documents into one.
License: MIT
Requires Python: >=3.11
Keywords: docx, merge, fast, xml, zip, office

# 📄 docx-merge-xml

A fast Python library for merging two Microsoft Word (`.docx`) documents into one. Easily insert content at specific positions or based on placeholder patterns.

---

## 📦 Installation

Install via pip:

```bash
pip install docx-merge-xml
```

## 📚 Dependencies

Only one dependency:

- `lxml` – for parsing and modifying the DOCX XML content

## 🛠️ API

```py
merge_docx(
	source_path: str,
	content_path: str,
	output_path: str | None = None,
	pattern: str | None = None,
	insert_start: bool = False,
	insert_end: bool = False,
) -> BytesIO
```

Parameters:

- `source_path` (_required_) – Path to the base `.docx` file
- `content_path` (_required_) – Path to the `.docx` file to insert into the base
- `output_path` – Path to save the merged document
- `pattern` – Placeholder string in the source file to be replaced with inserted content
- `insert_start` – Insert the content at the **beginning** of the source file
- `insert_end` – Insert the content at the **end** of the source file

🔔 Note: You can combine `pattern`, `insert_start`, and `insert_end` and at least one is required.

## 💡 Examples

### Replace a placeholder in the source DOCX

```py
from docx_merge import merge_docx

buffer = merge_docx(
	source_path="./source.docx",
	content_path="./table.docx",
	pattern="{{table}}"
)

# Use buffer (e.g., send as a response in a server)
```

### Save the output docx by providing an output_path

```py
from docx_merge import merge_docx

buffer = merge_docx(
	source_path="./source.docx",
	content_path="./table.docx",
	output_path="./output.docx",
	pattern="{{table}}"
)
```

### Insert at the start of the document

```py
from docx_merge import merge_docx

merge_docx(
	source_path="./source.docx",
	content_path="./table.docx",
	output_path="./output.docx",
  insert_start=True
)
```

### Insert at the end of the document

```py
from docx_merge import merge_docx

merge_docx(
	source_path="./source.docx",
	content_path="./table.docx",
	output_path="./output.docx",
  insert_end=True
)
```

## 🧪 Testing

This project uses Pytest for unit testing.

To run tests:

```bash
poetry run pytest
```

## 🔒 License

MIT

## 🤝 Contributing

Contributions, bug reports, and feature requests are welcome! Feel free to open an issue or submit a pull request.
pytelefonipapi 0.0.3
Python services for convenient work with telefon-ip.ru api
License: MIT
Requires Python: >=3.10

# pytelefonipapi - Python services for convenient work with telefon-ip.ru api

![](https://www.python.org/static/img/python-logo.png) 

Установка
============

Пользуем pip:
    
```
pip install pytelefonipapi
```

Зависимости
    
    python>=3.10
    requests
    pydantic>=2.9.2

    
Как использовать
============
Все названия методов соответствуют action в ссылке (смотрите документацию).
**Пример названия метода:** 

- _api/v1/authcalls/\<token\>/**get_code**/\<phone\>/ - `get_code`_

**Варианты импорта**
Вы можете импортировать 
    
    TelefonIpAPI - с всеми доступными методами 
    SettingAPI - только методы для работы с аккаунтом
    FlashCallsAPI - только запросы кода авторизации
    BackCallsAPI - только запрос обратной авторизации
    TGCodeAPI - только запрос кода в Telegram
    SMSCodeAPI - только запрос sms 

Так же прошу вас обратить **внимание** на аннотацию типов аргументов 

Если вам нужно чтобы ответ был в dict - то при инициализации укажите аргумент **return_dict** = True
    
    api = TelefonIpAPI(token, return_dict=True)

    # Либо
    api = TelefonIpAPI(token,)
    api.return_dict = True

Example
============
    import logging
    from datetime import datetime
    from pytelefonipapi import TelefonIpAPI, FlashCallsAPI, SettingAPI
    
    TOKEN = ""
    logger = logging.getLogger(__name__)
    logging.basicConfig(filename='example.log', encoding='utf-8', level=logging.DEBUG)
    
    # Получаем биллинг файлом 
    api = TelefonIpAPI(token=TOKEN, debug=True, logger=logger)
    api.get_billing_csv(datetime.now(), "./files/", "1.csv")
    # #api.get_billing_csv("2025-04-19", "./files/", "1.csv")
    
    api_flash_calls = FlashCallsAPI(token=TOKEN, debug=True, logger=logger)
    # print(api.get_code(phone="+79969307003",))
    
    api_settings = SettingAPI(token=TOKEN, debug=True, logger=logger)
    balance = api_settings.get_balance()
gemini-translator 0.1.0
Python library for translation (Gemini Translator)
License: MIT
Requires Python: >=3.7

# README.md
# ---------
# # Gemini Translator
# A simple Python wrapper for Google Gemini LLM translations.
#
# ## Installation
# ```bash
# pip install gemini-translator
# ```
#
# ## Usage
# ```python
# from gemini_translator.translator import GeminiTranslator
# tr = GeminiTranslator(api_key="YOUR_API_KEY")
# res = tr.translate(["Hello"], "auto", "ru")
# print(res)


# Gemini Translator

Gemini Translator — лёгкая Python-библиотека для пакетных переводов с помощью Google Gemini LLM.

## Установка

```bash
pip install gemini-translator
```

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

```python
from gemini_translator.translator import GeminiTranslator

# Передача ключа напрямую
translator = GeminiTranslator(api_key="YOUR_GEMINI_API_KEY")

# Или через переменную окружения (рекомендуется)
# export GOOGLE_API_KEY="YOUR_GEMINI_API_KEY"
# translator = GeminiTranslator()

# 1) Перевод одного текста
result = translator.translate(
    ["Hello, world!"],
    source_lang="auto",   # автоопределение языка
    target_lang="ru"      # двухбуквенный код языка
)
print(result["Hello, world!"])

# 2) Пакетный перевод списка строк
texts = ["Good morning", "How are you?"]
translations = translator.translate(
    texts,
    source_lang="en",    # явный код исходного языка
    target_lang="fr"     # код целевого языка
)
for original, translated in translations.items():
    print(f"{original} -> {translated}")
```

## Ключ API Gemini

Для работы с Gemini API необходим API-ключ. Его можно получить в Google Cloud Console:

1. Перейдите в раздел **APIs & Services** → **Credentials**.
2. Создайте или выберите существующий API-ключ.
3. Сохраните значение ключа и передайте в библиотеку одним из способов:

   * Через параметр `api_key` при инициализации `GeminiTranslator`.
   * Через переменную окружения `GOOGLE_API_KEY`.

## Параметры

* `api_key: str` — ваш Gemini API-ключ. Если не указан, будет использована переменная окружения `GOOGLE_API_KEY`.
* `model: str` — имя модели Gemini (по умолчанию `gemini-2.0-flash`).
* `timeout: int` — таймаут HTTP-запроса в секундах (по умолчанию 30).

## Примечания

* Коды языков указываются по стандарту ISO 639-1 (двухбуквенные, например, `en`, `ru`, `fr`).
* Если у вас возникает `ValueError: API key must be provided`, проверьте корректность передачи ключа.