Persona1-text-tools/README.md

# Persona1-text-tools Documentation

| Language                            | Link                                     |
| ----------------------------------- | ---------------------------------------- |
| English                             | [Documentation](#english)                |
| Русский                             | [Документация](#russian)                 |
| 日本語                               | [ドキュメンテーション](#japanese)           |
| Русский дореформенный               | [Документація](#old_russian)             |
| Esperanto                           | [Dokumentado](#esperanto)                |
| Українська                          | [Документація](#ukrainian)               |
| Latine                              | [Documentatio](#latin)                   |
| Русский стихотворный                | [Документация в стихах](#poetic_russian) |
| "Горе от кода"                      | ["Горе от кода"](#gore_ot_koda)          |
|"Горе от кода" (в пересказе DeepSeek)|["Горе от кода"](#gore_ot_koda_v2)        |

---

## English {#english}

### Persona1-text-tools

**Persona1-text-tools** is a Python module for working with text strings and binary files in Persona 1. It provides tools for extracting, modifying, and reinserting text.

### Installation
```bash
pip install Persona1-text-tools
```

### Available Functions

#### Parsing Event Strings
```python
from Persona1_text_tools import parse_event_strings
parse_event_strings("gamefile.bin", "encoding.tbl")
```
Extracts event strings and saves them as `output.json` and `output.txt`.

#### Injecting Event Strings
```python
from Persona1_text_tools import inject_event_strings
inject_event_strings("gamefile.bin", "output.json", "encoding.tbl")
```
Inserts modified JSON text back into the binary file.

#### Working with BIN Files
```python
from Persona1_text_tools import from_bin, to_bin
from_bin("game.BIN")  # Extracts binary files

to_bin("extracted_folder")  # Rebuilds a BIN file
```

#### Command-line Usage
```
parse-event-strings gamefile.bin encoding.tbl
inject-event-strings gamefile.bin output.json encoding.tbl
bin-tool import extracted_folder
bin-tool export game.BIN
```

---

## Русский {#russian}

### Persona1-text-tools

**Persona1-text-tools** – это Python-модуль для работы с текстами и бинарными файлами Persona 1. Он позволяет извлекать, редактировать и вставлять строки.

### Установка
```bash
pip install Persona1-text-tools
```

### Доступные функции

#### Парсинг строк событий
```python
from Persona1_text_tools import parse_event_strings
parse_event_strings("gamefile.bin", "encoding.tbl")
```
Извлекает строки событий и сохраняет их в `output.json` и `output.txt`.

#### Инъекция строк событий
```python
from Persona1_text_tools import inject_event_strings
inject_event_strings("gamefile.bin", "output.json", "encoding.tbl")
```
Вставляет строки из JSON обратно в бинарный файл.

#### Работа с BIN-файлами
```python
from Persona1_text_tools import from_bin, to_bin
from_bin("game.BIN")  # Извлекает бинарные файлы

to_bin("extracted_folder")  # Собирает BIN-файл обратно
```

#### Использование в командной строке
```
parse-event-strings gamefile.bin encoding.tbl
inject-event-strings gamefile.bin output.json encoding.tbl
bin-tool import extracted_folder
bin-tool export game.BIN
```

---

## 日本語 {#japanese}

### Persona1-text-tools

**Persona1-text-tools** は、Persona 1 のテキストデータおよびバイナリファイルを処理するための Python モジュールです。
テキストの抽出、編集、再挿入の機能を提供します。

### インストール
```bash
pip install Persona1-text-tools
```

### 利用可能な機能

#### イベントテキストの解析
```python
from Persona1_text_tools import parse_event_strings
parse_event_strings("gamefile.bin", "encoding.tbl")
```
バイナリファイルからイベントテキストを抽出し、`output.json` と `output.txt` に保存します。

#### イベントテキストの挿入
```python
from Persona1_text_tools import inject_event_strings
inject_event_strings("gamefile.bin", "output.json", "encoding.tbl")
```
JSONファイルのテキストをバイナリファイルに挿入します。

#### BINファイルの処理
```python
from Persona1_text_tools import from_bin, to_bin
from_bin("game.BIN")  # バイナリファイルを抽出

to_bin("extracted_folder")  # BINファイルを再構築
```

#### コマンドラインの使用方法
```
parse-event-strings gamefile.bin encoding.tbl
inject-event-strings gamefile.bin output.json encoding.tbl
bin-tool import extracted_folder
bin-tool export game.BIN
```

---

## Русский дореформенный {#old_russian}

### Persona1-text-tools

**Persona1-text-tools** – сіе модуль для работы съ текстами и бінарными файлами изъ игры Persona 1. Онъ позволяетъ извлекать, редактироватьъ и вставлять строки.

### Установкѣ
```bash
pip install Persona1-text-tools
```

### Доступныя функции

#### Парсингъ строкъ событій
```python
from Persona1_text_tools import parse_event_strings
parse_event_strings("gamefile.bin", "encoding.tbl")
```
Извлекаетъ строки событій и сохраняетъ ихъ въ `output.json` и `output.txt`.

#### Инъекція строкъ событій
```python
from Persona1_text_tools import inject_event_strings
inject_event_strings("gamefile.bin", "output.json", "encoding.tbl")
```
Вставляетъ строки изъ JSON обратно въ бінарный файлъ.

#### Работа съ BIN-файлами
```python
from Persona1_text_tools import from_bin, to_bin
from_bin("game.BIN")  # Извлекаетъ бінарные файлы

to_bin("extracted_folder")  # Собираетъ BIN-файлъ обратно
```

#### Употребленіе въ командной строкѣ
```
parse-event-strings gamefile.bin encoding.tbl
inject-event-strings gamefile.bin output.json encoding.tbl
bin-tool import extracted_folder
bin-tool export game.BIN
```

---

## Esperanto {#esperanto}

### Persona1-text-tools

**Persona1-text-tools** estas Python-modulo por labori kun tekstaj ĉenoj kaj binaraj dosieroj en Persona 1. Ĝi disponigas ilojn por ekstrakti, modifi kaj reenmeti tekston.

### Instalado
```bash
pip install Persona1-text-tools
```

### Haveblaj Funkcioj

#### Analizado de Eventaj Ĉenoj
```python
from Persona1_text_tools import parse_event_strings
parse_event_strings("gamefile.bin", "encoding.tbl")
```
Ekstraktas eventajn ĉenojn kaj konservas ilin kiel `output.json` kaj `output.txt`.

#### Enmeto de Eventaj Ĉenoj
```python
from Persona1_text_tools import inject_event_strings
inject_event_strings("gamefile.bin", "output.json", "encoding.tbl")
```
Enmetas modifitajn JSON-ĉenojn reen en la binaran dosieron.

#### Laborado kun BIN-dosieroj
```python
from Persona1_text_tools import from_bin, to_bin
from_bin("game.BIN")  # Ekstraktas binarajn dosierojn

to_bin("extracted_folder")  # Rekonstruas BIN-dosieron
```

#### Uzado en la Komandlinio
```
parse-event-strings gamefile.bin encoding.tbl
inject-event-strings gamefile.bin output.json encoding.tbl
bin-tool import extracted_folder
bin-tool export game.BIN
```

---

## Українська {#ukrainian}

### Persona1-text-tools

**Persona1-text-tools** — це Python-модуль для роботи з текстовими рядками та бінарними файлами в Persona 1. Він надає інструменти для витягування, редагування та повторного вставлення тексту.

### Встановлення
```bash
pip install Persona1-text-tools
```

### Доступні функції

#### Парсинг рядків подій
```python
from Persona1_text_tools import parse_event_strings
parse_event_strings("gamefile.bin", "encoding.tbl")
```
Витягує рядки подій і зберігає їх у `output.json` та `output.txt`.

#### Вставка рядків подій
```python
from Persona1_text_tools import inject_event_strings
inject_event_strings("gamefile.bin", "output.json", "encoding.tbl")
```
Вставляє рядки з JSON назад у бінарний файл.

#### Робота з BIN-файлами
```python
from Persona1_text_tools import from_bin, to_bin
from_bin("game.BIN")  # Витягує бінарні файли

to_bin("extracted_folder")  # Збирає BIN-файл назад
```

#### Використання в командному рядку
```
parse-event-strings gamefile.bin encoding.tbl
inject-event-strings gamefile.bin output.json encoding.tbl
bin-tool import extracted_folder
bin-tool export game.BIN
```

---

## Latine {#latin}

### Persona1-text-tools

**Persona1-text-tools** est Python modulo ad operandum cum textibus et fasciculis binariis in Persona 1. Praebet instrumenta ad extrahendum, mutandum et iterum insertandum textum.

### Instauratio
```bash
pip install Persona1-text-tools
```

### Functiones Disponibiles

#### Parsatio Eventuum
```python
from Persona1_text_tools import parse_event_strings
parse_event_strings("gamefile.bin", "encoding.tbl")
```
Extrahit eventuum textus et eos servat ut `output.json` et `output.txt`.

#### Iniectio Eventuum
```python
from Persona1_text_tools import inject_event_strings
inject_event_strings("gamefile.bin", "output.json", "encoding.tbl")
```
Inserit textus mutatos ex JSON in fasciculum binarium.

#### Operatio cum BIN Fasciculis
```python
from Persona1_text_tools import from_bin, to_bin
from_bin("game.BIN")  # Extrahit fasciculos binarios

to_bin("extracted_folder")  # Redintegrat fasciculum BIN
```

#### Usus in Linea Comandorum
```
parse-event-strings gamefile.bin encoding.tbl
inject-event-strings gamefile.bin output.json encoding.tbl
bin-tool import extracted_folder
bin-tool export game.BIN
```

---

## Русский стихотворный {#poetic_russian}

### Вступление

Внимание, о, читатель! Внимай! Слушай, как я тебе вещаю: Модуль есть, что текстами играет, Persona1-text-tools зовется. В Python'е он живет и процветает, С ним строки ты редактировать научишься. Скачай его, и путь откроется:

```bash
pip install Persona1-text-tools
```
Так начни же, не теряй ни дня!

### Доступные функции

#### Парсинг строк событий
Ты хочешь строки из игры извлечь? Смело к делу приступай, не робей! В Python'е код напишешь ты такой:
```python
from Persona1_text_tools import parse_event_strings
parse_event_strings("gamefile.bin", "encoding.tbl")
```
Вот и все! Строки в JSON и TXT Сохранятся, ждут тебя, как светлый путь. Не забудь про кодировку свою, Чтоб все было верно, как в мечтах твоих.

#### Инъекция строк событий
Теперь, когда ты строки извлек, В игру их вставить ты готов. С JSON'ом в руках, вперед иди:
```python
from Persona1_text_tools import inject_event_strings
inject_event_strings("gamefile.bin", "output.json", "encoding.tbl")
```
Вот и все! Строки вернутся в файл, Игра твоя обновится, как мечта. Не забудь про кодировку свою, Чтоб все было верно, как в мечтах твоих.

#### Работа с BIN-файлами
```python
from Persona1_text_tools import from_bin, to_bin
from_bin("game.BIN")  # Извлекает бинарные файлы

to_bin("extracted_folder")  # Собирает BIN-файл обратно
```
Вот и все! Файлы будут у тебя, Как хочешь, так и обрабатывай. Не забудь про кодировку свою, Чтоб все было верно, как в мечтах твоих.

#### Использование в командной строке
Ты любишь командную строку? С ней работать ты привык? Вот команды, что тебе помогут:
```
parse-event-strings gamefile.bin encoding.tbl
inject-event-strings gamefile.bin output.json encoding.tbl
bin-tool import extracted_folder
bin-tool export game.BIN
```
Вот и все! Команды просты, С ними ты все сделаешь, как надо. Не забудь про кодировку свою, Чтоб все было верно, как в мечтах твоих.


---

## "Горе от Кода" {#gore_ot_koda}

*(Сатирическая документация в стиле грибоедовской комедии)*

---

### ДЕЙСТВИЕ I. ПРОЛОГ МОДУЛЯ   
**Чацкий**, _вбегая с ноутбуком в руках, обращается к толпе разработчиков:_

> "О вы, чьи руки жаждут текстов власти,  
> Кто файлы бинарные рвётся покорить —  
> Услышьте глас прогресса и страсти!  
> Мой инструмент поможет вам творить.  

> **Persona1-text-tools** — вот имя дивной силы,  
> Что строки спрятанные извлечёт,  
> Как ключ, что отпирает мрачные могилы  
> Где текст под бинарным кодом стонет и живёт.  

> Установите смело, не робейте:  
> `pip install Persona1-text-tools` —  
> И Пайтон вам крылья даст скорее,  
> Чем Фамусову служба чины и престол!  

> Пусть завидует Скалозуб-стажёр,  
> Что в консоли команды, как шпаги, остры —  
> Мы кодом, как Чацкий, взорвём договор  
> Меж человеком и машиной хитросплетённой споры!"  

---

### ДЕЙСТВИЕ II. ПАРСИНГ СТРОК   
_Чацкий размахивает файлом gamefile.bin, обращаясь к Софье-IDE:_

> "Смотрите же! Сияет encoding.tbl,  
> Как древний свиток магов в час луны.  
> Командой `parse_event_strings` — без лишних слов —  
> Мы вырвем текст из бинарной тишины!  

> Извлечь строки? Легче, чем правду в салоне Фамусова:  
> output.txt и JSON — вот двойной улов.  
> Как Чацкий, что истину режет без покрова,  
> Мой код разорвёт оковы бинарных основ!  

> Пусть Репетиловы твердят: «Нельзя! Не смейте!» —  
> Мы смело файлы в тексты превратим.  
> И даже Молчалин, склонившись в тайной ревности,  
> Признает: парсинг здесь непобедим!"  

---

### ДЕЙСТВИЕ III. ИНЪЕКЦИЯ ПОЭЗИИ   
_Чацкий в ярости стучит по клавиатуре, сравнивая JSON с любовным письмом:_

> "О времена! О файлы! Где ж ваш стыд?  
> Чтоб строки в бинарник вернуть обратно —  
> `inject_event_strings` пусть будет вам щит,  
> Как Чацкий — защитник истины непонятой!  

> Возьмите output.json — святой грааль изменений,  
> encoding.tbl — компас в море кодов.  
> И пусть ваш бинарник, как бал у Хлестовой,  
> Заискрится текстами новых стихов!  

> Не страшны нам ошибки, как сплетни в салоне —  
> Мы в файл вольём и метафоры, и страсть.  
> Пусть шепчут: «Он сумасшедший!» — в тихом ужасе,  
> Но код наш будет вечно в репозитории красоваться!"  

---

### ДЕЙСТВИЕ IV. БИНАРНЫЕ МЕТАМОРФОЗЫ   
_Чацкий танцует с папкой extracted_folder, пародируя Фамусова:_

> "Разберите BIN-файл! Пусть каждый байт  
> Предстанет, как дворянин на балу —  
> Команда `from_bin` сорвёт с секретов флёр,  
> А `to_bin` соберёт их вновь к исходному числу!  

> Как Чацкий, что видит суть за мишурой чинов,  
> Мой код распотрошит game.BIN до нитки.  
> И даже Скалозуб-сисадмин, скрепя сердце,  
> Признает: бинарник наш — не крепостной уклад!"  

---

### ЭПИЛОГ. КОМАНДНАЯ СТРОКА КАК ПОЭМА   
_Чацкий уезжает, оставляя консоль открытой:_

> "Прощай, Москва кодировок пыльная!  
> parse-event-strings — мой последний монолог.  
> inject-event-strings — как выстрел в зал фамусовский,  
> bin-tool import/export — финальный эпилог.  

> Пусть Молчалины шепчут: «Не надо новшеств!»,  
> А Лиза-IDE тайком сохранит наш след.  
> Кто понял — в репозиторий звезду поставит,  
> Кто нет — пусть читает Грибоедова впредь!"  

---

**Примечание автора-переводчика**:  
> "Сей текст — не буквальный перевод, но дух документации,  
> Облечённый в ямб четырёхстопный, как в «Горе» грибоедовском.  
> Чтоб merge request ваш, как Чацкий, пробил сердце main-ветки,  
> А код ваш стал бессмертным, как классика в мире цифровом!" 




---


## "Горе от Кода" (в пересказе DeppSeek){#gore_ot_koda_v2}

Вот перевод документации `Persona1-text-tools`, выполненный в стиле "Горя от ума", с использованием стихотворного слога и фраз из произведения Грибоедова.

### Persona1-text-tools – Модуль, в котором Python зарыт, как клад!

(_Явление 1. Гостиная в доме Фамусова. Чацкий входит._)

Ах! Этот Python! Что за дивная машина!
Для текста, для бинарных файлов – господин!
**Persona1-text-tools** – вот имя горделиво,
Что строки извлекает так игриво!

Редактировать, вставлять – всё может он, поверьте,
Как будто пишет заново бессмертье!
И если текст вам нужно изменить,
То этот модуль – дар, что не купить!

Как Чацкий я, стремлюсь к познаньям новым,
И этот модуль мне, как воздух, нужен словом!
Чтоб строки извлекать, как золото из руд,
И в файлы BIN вдохнуть вдруг новый труд!

О, век! О, нравы! Модули плодятся,
И каждый что-то новое творится.
Но этот – исключенье, без сомненья,
В нём вижу я прогресса откровенье!

Как Фамусов, твердят: "Ученье – свет!"
Но что есть свет, когда и пользы нет?
А здесь и польза, и красы не счесть,
И с этим модулем приятно жить и есть!

Я вижу, как София смотрит с укоризной,
Но мне важны лишь истины отчизны!
И если модуль этот – часть прогресса,
То буду я хвалить его без стресса!

Пускай Молчалин шепчет там украдкой,
Что лучше старый метод, чем накладка,
Но я скажу вам прямо, без затей,
Что этот модуль – лучше всех затей!

Как Скалозуб, он крепок и надёжен,
И в мире текста он совсем не гож?
Он словно генерал, что знает дело,
И строки правит так умело!

Ах, господа! Зачем нам эти споры?
Когда есть модуль, что решает горы!
Проблем с текстами, с файлами бинарными,
Он словно маг, с решениями дарными!

И я, как Чацкий, буду продвигать
Всё то, что может пользу людям дать!
Пусть старый мир твердит своё упрямо,
Но новое всегда пробьётся прямо!

Ведь в этом модуле – залог успеха,
И с ним работа – вовсе не помеха!
Он словно ключ, что двери открывает,
И мир бинарный нам он представляет!

Так будем же использовать его, друзья,
И в мире текста будем словно я!
Свободны, смелы, полны вдохновенья,
И модулем творить свои творенья!

Как Лизанька, он лёгок и послушен,
И в сложных задачах совсем не скушен!
Он словно друг, что помогает в деле,
И строки правит в самом лучшем виде!

Ах, Фамусов, зачем ты так сердит?
Когда есть модуль, что нам всем годит!
Он словно зеркало, что отражает,
Всю суть бинарных файлов открывает!

И я, как Чацкий, буду настаивать,
Что этот модуль нужно развивать!
Ведь в нём потенциал огромный скрыт,
И с ним наш мир бинарный будет слит!

Пусть старый мир твердит: "Зачем нам это?"
Но новое всегда найдёт ответы!
И этот модуль – словно луч надежды,
Что освещает тёмные невежды!

Как София, он прекрасен и умён,
И в мире текста он совсем не тём!
Он словно гений, что творит чудесно,
И строки правит так прелестно!

Ах, господа! Зачем нам эти ссоры?
Когда есть модуль, что решает споры!
Проблем с текстами, с файлами бинарными,
Он словно маг, с решениями дарными!

И я, как Чацкий, буду воспевать
Всё то, что может пользу людям дать!
Пусть старый мир твердит своё упрямо,
Но новое всегда пробьётся прямо!

Ведь в этом модуле – залог успеха,
И с ним работа – вовсе не помеха!
Он словно ключ, что двери открывает,
И мир бинарный нам он представляет!

Так будем же использовать его, друзья,
И в мире текста будем словно я!
Свободны, смелы, полны вдохновенья,
И модулем творить свои творенья!

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

(_Явление 2. Фамусов и Чацкий._)

```bash
pip install Persona1-text-tools
```

Что нового покажет нам сей "pip"?
Установка проста, лишь в код взгляни ты!
Как Фамусов, скажу я вам сейчас:
"Ученье – свет", но код – он лучше в раз!

Вот "pip install" – команда нехитрая,
Как Скалозуб, она всегда упёртая!
Установит модуль вам в момент,
И станет он помощник, аргумент!

Ах, этот "pip"! Как много в нём чудес,
Он словно маг, что к знаньям нас вознёс!
Установит всё быстро и легко,
И станет вам на сердце хорошо!

Как Молчалин, он тих и незаметен,
Но дело делает, хоть не приметен!
Установит модуль, без сомненья,
И станет вам доступно обученье!

Пусть София твердит, что это скучно,
Но я скажу вам прямо, без прискучки,
Что этот "pip" – помощник верный мой,
И с ним я буду, как герой!

Как Лизанька, он быстр и точен,
И в установке он совсем не мочен!
Он словно ветер, что летит вперёд,
И модуль нам в мгновенье принесёт!

Ах, Фамусов, зачем ты так ворчишь?
Когда есть "pip", что нам всем годишь!
Он словно ключ, что двери открывает,
И мир бинарный нам он представляет!

И я, как Чацкий, буду настаивать,
Что этот "pip" нужно прославлять!
Ведь в нём потенциал огромный скрыт,
И с ним наш мир бинарный будет слит!

Пусть старый мир твердит: "Зачем нам это?"
Но новое всегда найдёт ответы!
И этот "pip" – словно луч надежды,
Что освещает тёмные невежды!

Как София, он прекрасен и умён,
И в мире кода он совсем не тём!
Он словно гений, что творит чудесно,
И модуль ставит так прелестно!

Ах, господа! Зачем нам эти ссоры?
Когда есть "pip", что решает споры!
Проблем с установкой, нет больше их,
Он словно маг, что ставит в миг!

И я, как Чацкий, буду воспевать
Всё то, что может пользу людям дать!
Пусть старый мир твердит своё упрямо,
Но новое всегда пробьётся прямо!

Ведь в этом "pip" – залог успеха,
И с ним установка – вовсе не помеха!
Он словно ключ, что двери открывает,
И мир бинарный нам он представляет!

Так будем же использовать его, друзья,
И в мире кода будем словно я!
Свободны, смелы, полны вдохновенья,
И "pip"-ом творить свои творенья!

Что нового покажет нам сей "pip"?
Установка проста, лишь в код взгляни ты!
Как Фамусов, скажу я вам сейчас:
"Ученье – свет", но код – он лучше в раз!

Вот "pip install" – команда нехитрая,
Как Скалозуб, она всегда упёртая!
Установит модуль вам в момент,
И станет он помощник, аргумент!

Ах, этот "pip"! Как много в нём чудес,
Он словно маг, что к знаньям нас вознёс!
Установит всё быстро и легко,
И станет вам на сердце хорошо!

Как Молчалин, он тих и незаметен,
Но дело делает, хоть не приметен!
Установит модуль, без сомненья,
И станет вам доступно обученье!

Пусть София твердит, что это скучно,
Но я скажу вам прямо, без прискучки,
Что этот "pip" – помощник верный мой,
И с ним я буду, как герой!

Как Лизанька, он быстр и точен,
И в установке он совсем не мочен!
Он словно ветер, что летит вперёд,
И модуль нам в мгновенье принесёт!

Ах, Фамусов, зачем ты так ворчишь?
Когда есть "pip", что нам всем годишь!
Он словно ключ, что двери открывает,
И мир бинарный нам он представляет!

И я, как Чацкий, буду настаивать,
Что этот "pip" нужно прославлять!
Ведь в нём потенциал огромный скрыт,
И с ним наш мир бинарный будет слит!

Пусть старый мир твердит: "Зачем нам это?"
Но новое всегда найдёт ответы!
И этот "pip" – словно луч надежды,
Что освещает тёмные невежды!

Как София, он прекрасен и умён,
И в мире кода он совсем не тём!
Он словно гений, что творит чудесно,
И модуль ставит так прелестно!

Ах, господа! Зачем нам эти ссоры?
Когда есть "pip", что решает споры!
Проблем с установкой, нет больше их,
Он словно маг, что ставит в миг!

И я, как Чацкий, буду воспевать
Всё то, что может пользу людям дать!
Пусть старый мир твердит своё упрямо,
Но новое всегда пробьётся прямо!

Ведь в этом "pip" – залог успеха,
И с ним установка – вовсе не помеха!
Он словно ключ, что двери открывает,
И мир бинарный нам он представляет!

Так будем же использовать его, друзья,
И в мире кода будем словно я!
Свободны, смелы, полны вдохновенья,
И "pip"-ом творить свои творенья!

### Доступные функции

(_Явление 3. Чацкий и Молчалин._)

#### Парсинг строк событий

(_Чацкий входит, оглядываясь._)

```python
from Persona1_text_tools import parse_event_strings
parse_event_strings("gamefile.bin", "encoding.tbl")
```

Ах! Парсинг строк событий – вот задача!
Как разобрать всё это, неудача?
Но модуль наш поможет, без сомненья,
И строки извлечёт он, без сомненья!

Как Молчалин, он тих и незаметен,
Но дело делает, хоть не приметен!
Извлечёт он строки из файла BIN,
И в JSON их сложит, как один!

"gamefile.bin" – вот имя файла,
Где строки спят, как будто в коконе, тайно!
"encoding.tbl" – таблица кодов,
Что даст нам ключ к разгадке переходов!

Как Скалозуб, он крепок и надёжен,
И в парсинге он вовсе не гож?
Он разберёт всё чётко и умело,
И строки выдаст нам он в дело!

Ах, София, что ты знаешь о парсинге?
Когда в нём столько тайн и разногласий!
Но модуль наш развеет все сомненья,
И даст нам ключ к разгадке разуменья!

Как Фамусов, скажу я вам сейчас:
"Ученье – свет", но парсинг – лучше в раз!
Он словно ключ, что двери открывает,
И мир бинарный нам он представляет!

"output.json" – вот имя файла,
Куда все строки сложатся удало!
"output.txt" – в нём текст простой найдётся,
И каждый в нём легко прочтётся!

И я, как Чацкий, буду настаивать,
Что парсинг строк нужно прославлять!
Ведь в нём потенциал огромный скрыт,
И с ним наш мир бинарный будет слит!

Пусть старый мир твердит: "Зачем нам это?"
Но новое всегда найдёт ответы!
И парсинг строк – словно луч надежды,
Что освещает тёмные невежды!

Как София, он прекрасен и умён,
И в мире кода он совсем не тём!
Он словно гений, что творит чудесно,
И строки парсит так прелестно!

Ах, господа! Зачем нам эти ссоры?
Когда есть парсинг, что решает споры!
Проблем с текстами, нет больше их,
Он словно маг, что ставит в миг!

И я, как Чацкий, буду воспевать
Всё то, что может пользу людям дать!
Пусть старый мир твердит своё упрямо,
Но новое всегда пробьётся прямо!

Ведь в этом парсинге – залог успеха,
И с ним работа – вовсе не помеха!
Он словно ключ, что двери открывает,
И мир бинарный нам он представляет!

Так будем же использовать его, друзья,
И в мире кода будем словно я!
Свободны, смелы, полны вдохновенья,
И парсингом творить свои творенья!

#### Инъекция строк событий

(_Явление 4. Чацкий и София._)

```python
from Persona1_text_tools import inject_event_strings
inject_event_strings("gamefile.bin", "output.json", "encoding.tbl")
```

Ах! Инъекция строк – что за задача!
Как строки в файл вставить, удача?
Но модуль наш поможет, без сомненья,
И строки вставит он, без сомненья!

Как София, она смотрит свысока,
Но инъекция – наука нелегка!
Вставит строки в файл BIN обратно,
И станет он как новый, аккуратно!

"gamefile.bin" – вот имя файла,
Куда все строки вернуться удало!
"output.json" – в нём строки все хранятся,
И в файл BIN они все возвращаются!

Как Скалозуб, он крепок и надёжен,
И в инъекции он вовсе не гож?
Он вставит всё чётко и умело,
И строки выдаст нам он в дело!

Ах, София, что ты знаешь об инъекции?
Когда в ней столько тайн и комплектации!
Но модуль наш развеет все сомненья,
И даст нам ключ к разгадке разуменья!

Как Фамусов, скажу я вам сейчас:
"Ученье – свет", но инъекция – лучше в раз!
Он словно ключ, что двери открывает,
И мир бинарный нам он представляет!

"encoding.tbl" – таблица кодов,
Что даст нам ключ к разгадке переходов!
И строки все на место встанут,
И файл BIN как новый станет!

И я, как Чацкий, буду настаивать,
Что инъекцию строк нужно прославлять!
Ведь в ней потенциал огромный скрыт,
И с ним наш мир бинарный будет слит!

Пусть старый мир твердит: "Зачем нам это?"
Но новое всегда найдёт ответы!
И инъекция строк – словно луч надежды,
Что освещает тёмные невежды!

Как София, он прекрасен и умён,
И в мире кода он совсем не тём!
Он словно гений, что творит чудесно,
И строки вставит так прелестно!

Ах, господа! Зачем нам эти ссоры?
Когда есть инъекция, что решает споры!
Проблем с текстами, нет больше их,
Он словно маг, что ставит в миг!

И я, как Чацкий, буду воспевать
Всё то, что может пользу людям дать!
Пусть старый мир твердит своё упрямо,
Но новое всегда пробьётся прямо!

Ведь в этой инъекции – залог успеха,
И с ним работа – вовсе не помеха!
Он словно ключ, что двери открывает,
И мир бинарный нам он представляет!

Так будем же использовать его, друзья,
И в мире кода будем словно я!
Свободны, смелы, полны вдохновенья,
И инъекцией творить свои творенья!

#### Работа с BIN-файлами

(_Явление 5. Чацкий и Фамусов._)

```python
from Persona1_text_tools import from_bin, to_bin
from_bin("game.BIN")  # Извлекает бинарные файлы

to_bin("extracted_folder")  # Собирает BIN-файл обратно
```

Ох, BIN-файлы, что за диво!
Как извлечь их, чтоб не сгореть ретиво?
Но модуль наш поможет, без сомненья,
И BIN-файлы разложит, без сомненья!

Как Фамусов, он строго смотрит,
Но BIN-файлы модуль наш не портит!
Извлечёт он файлы из BIN-архива,
И сложит их по папкам учтиво!

"game.BIN" – вот имя файла,
Где файлы спят, как будто в коконе тайно!
"from_bin" – команда, что извлечёт,
И в папку их отдельную сложит в счёт!

Как Скалозуб, он крепок и надёжен,
И с BIN-файлами он вовсе не гож?
Он разберёт всё чётко и умело,
И файлы выдаст нам он в дело!

Ах, София, что ты знаешь о BIN-файлах?
Когда в них столько тайн и лабиринтов тайных!
Но модуль наш развеет все сомненья,
И даст нам ключ к разгадке разуменья!

Как Фамусов, скажу я вам сейчас:
"Ученье – свет", но BIN-файлы – лучше в раз!
Он словно ключ, что двери открывает,
И мир бинарный нам он представляет!

"extracted_folder" – вот имя папки,
Куда все файлы сложатся в охапке!
"to_bin" – команда, что соберёт,
И в BIN-файл их снова унесёт!

И я, как Чацкий, буду настаивать,
Что с BIN-файлами нужно прославлять!
Ведь в них потенциал огромный скрыт,
И с ним наш мир бинарный будет слит!

Пусть старый мир твердит: "Зачем нам это?"
Но новое всегда найдёт ответы!
И с BIN-файлами – словно луч надежды,
Что освещает тёмные невежды!

Как София, он прекрасен и умён,
И в мире кода он совсем не тём!
Он словно гений, что творит чудесно,
И BIN-файлы разложит прелестно!

Ах, господа! Зачем нам эти ссоры?
Когда есть BIN-файлы, что решают споры!
Проблем с извлечением, нет больше их,
Он словно маг, что ставит в миг!

И я, как Чацкий, буду воспевать
Всё то, что может пользу людям дать!
Пусть старый мир твердит своё упрямо,
Но новое всегда пробьётся прямо!

Ведь с BIN-файлами – залог успеха,
И с ним работа – вовсе не помеха!
Он словно ключ, что двери открывает,
И мир бинарный нам он представляет!

Так будем же использовать его, друзья,
И в мире кода будем словно я!
Свободны, смелы, полны вдохновенья,
И с BIN-файлами творить свои творенья!

#### Использование в командной строке

(_Явление 6. Чацкий и все._)

```bash
parse-event-strings gamefile.bin encoding.tbl
inject-event-strings gamefile.bin output.json encoding.tbl
bin-tool import extracted_folder
bin-tool export game.BIN
```

Ах! Командная строка – что за картина!
Как строки запустить, чтоб не застила?
Но модуль наш поможет, без сомненья,
И команды выполнит он, без сомненья!

Как все глядят с удивленьем на меня,
Но командная строка – вот где броня!
Запустит парсинг, инъекцию и BIN-tool,
И всё исполнит он, как верный слуга, cool!

"parse-event-strings" – команда первая,
Что строки извлечёт, как будто дева!
"gamefile.bin" – файл, где строки спят,
"encoding.tbl" – ключ, что даст им взгляд!

Как Скалозуб, он крепок и надёжен,
И в командной строке он вовсе не гож?
Он выполнит всё чётко и умело,
И результат покажет нам он в дело!

Ах, София, что ты знаешь о командах?
Когда в них столько тайн и улик на планах!
Но модуль наш развеет все сомненья,
И даст нам ключ к разгадке разуменья!

Как Фамусов, скажу я вам сейчас:
"Ученье – свет", но команды – лучше в раз!
Он словно ключ, что двери открывает,
И мир бинарный нам он представляет!

"inject-event-strings" – команда номер два,
Что строки вставит в файл, как трава!
"output.json" – файл, где строки ждут,
"encoding.tbl" – ключ, что путь им тут!

"bin-tool import" – команда третья,
Что файлы в BIN соберёт, как дети!
"extracted_folder" – папка, где файлы спят,
И в BIN-файл они все полетят!

"bin-tool export" – команда номер четыре,
Что файлы из BIN извлечёт в мире!
"game.BIN" – файл, где файлы хранятся,
И в папку их отдельную они все возвратятся!

И я, как Чацкий, буду настаивать,
Что командную строку нужно прославлять!
Ведь в ней потенциал огромный скрыт,
И с ним наш мир бинарный будет слит!

Пусть старый мир твердит: "Зачем нам это?"
Но новое всегда найдёт ответы!
И командная строка – словно луч надежды,
Что освещает тёмные невежды!

Как София, он прекрасен и умён,
И в мире кода он совсем не тём!
Он словно гений, что творит чудесно,
И команды выполнит прелестно!

Ах, господа! Зачем нам эти ссоры?
Когда есть команды, что решают споры!
Проблем с выполнением, нет больше их,
Он словно маг, что ставит в миг!

И я, как Чацкий, буду воспевать
Всё то, что может пользу людям дать!
Пусть старый мир твердит своё упрямо,
Но новое всегда пробьётся прямо!

Ведь с командной строкой – залог успеха,
И с ним работа – вовсе не помеха!
Он словно ключ, что двери открывает,
И мир бинарный нам он представляет!

Так будем же использовать его, друзья,
И в мире кода будем словно я!
Свободны, смелы, полны вдохновенья,
И командами творить свои творенья!