Metadata-Version: 2.4
Name: docx_replace_ms
Version: 1.0.1
Summary: Выполняет замену текста в документах `docx` аналогично Microsoft Word
Author-email: Михаил Никифоров <nikiforov1601@yandex.ru>
License-Expression: MIT
Project-URL: Homepage, https://github.com/Misha1601/docx-replace
Project-URL: Issues, https://github.com/Misha1601/docx-replace/issues
Keywords: docx,office,word,microsoft
Classifier: Programming Language :: Python :: 3.7
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: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# docx_replace_ms

`docx_replace_ms` - это простая утилита на Python для замены текста в документах `docx` (Microsoft Word) с сохранением форматирования.
Она аналогична функции "замена" офисного пакета Microsoft Word, работая с `run`'ами параграфов в документе.

Данная библиотека выполняет только 1 единственную функцию - замену текста в docx документе.
Вы даже можене не использовать данную библиотеку, а скопировать код с [GitHub](https://github.com/Misha1601/docx-replace), и вставить его в свой код.

## Отличие от других библиотек

- решение 1 проблемы, замена одного текста на другой.
- не использует сторонние библиотеки
- минимум кода и его простота

## Установка

```bash
pip install python-docx
pip install docx_replace_ms
```

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

Пример использования:

```python
from docx import Document
from docx_replace_ms import docx_replace

# Загружаем документ
doc = Document("my_template.docx")

# Определяем значения для замены
replacements = {
    "текст из 1-го документа 1":"заменяемый текст 1",
    "текст из 1-го документа 2":"заменяемый текст 2"
}

# Выполняем замену
docx_replace(doc, **replacements) # Рекомендуется
# или
docx_replace(doc, word1='new_word1', word2='new_word2')

# Сохраняем измененный документ
doc.save("my_document_final.docx")
```

## Зависимости

- `python-docx`

## Лицензия

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