RustText README

README проекта с github.com/Illson/RustText. Одним файлом markdown: README.md.

RustText

Текстовый редактор и просмотрщик больших логов для Windows x64 на Rust и GPUI Kit.

Запуск

Для переносимой сборки распакуйте архив и запустите rusttext.exe. Отладочная и релизная сборки запускаются без отдельного окна консоли. Повторный запуск передаёт файлы открытому RustText. Сборка проверена на Windows 11 x64. Для Windows 10 x64 нужна отдельная проверка.

Сборка из исходников

Нужны Rust с целью x86_64-pc-windows-msvc, инструменты C++ и Windows SDK из Visual Studio, а также CMake в PATH. Локальная сборка проверена с Rust 1.100.0 и CMake 4.5.0. Версия Rust закреплена в rust-toolchain.toml; Cargo по умолчанию собирает не более двух пакетов одновременно.

cargo run --locked
cargo run --locked -- "C:\путь\к\файлу.txt"

Регистрация типов файлов для установки

Распакуйте RustText в постоянную папку и запустите команду из этой папки от имени пользователя, который будет работать с программой.

$registration = Start-Process -FilePath (Resolve-Path '.\rusttext.exe').Path -ArgumentList '--register-file-associations' -Wait -PassThru
if ($registration.ExitCode -ne 0) { throw 'Не удалось зарегистрировать RustText в Windows' }

Команда добавляет RustText в список приложений и пункт «Открыть в RustText» в Проводнике для .txt, .json, .xml и .log. На обычном компьютере назначение подтверждается в «Параметры → Приложения → Приложения по умолчанию». Команда «Файл → Настроить открытие файлов в Windows…» открывает эту страницу.

Для управляемых компьютеров используйте XML в политике ассоциаций Windows. Сначала зарегистрируйте RustText в каждом профиле, к которому применяется политика. В XML укажите следующие типы.

<?xml version="1.0" encoding="UTF-8"?>
<DefaultAssociations>
  <Association Identifier=".txt" ProgId="RustText.Text" ApplicationName="RustText" />
  <Association Identifier=".json" ProgId="RustText.Json" ApplicationName="RustText" />
  <Association Identifier=".xml" ProgId="RustText.Xml" ApplicationName="RustText" />
  <Association Identifier=".log" ProgId="RustText.Log" ApplicationName="RustText" />
</DefaultAssociations>

Сессия, поиск и JSON

Генератор строк

Откройте «Инструменты → Генератор строк…», введите шаблон и количество строк. Небольшой результат откроется в новой вкладке. Если оценка размера превышает 8 МиБ, генератор предложит файл. Кнопка «В файл…» доступна и для небольшого результата.

Например, шаблон strokna {int_from_5} {guid} {rand_string_8} использует три правила в каждой строке. Лимитов в миллион строк и 8 МиБ нет: запись в файл идёт частями, с прогрессом и отменой. Отмена сохраняет прежний файл назначения.

В «Инструменты → Сравнить списки…» вставьте два списка. Результаты показывают общие строки, только слева и только справа. Сравнение учитывает регистр и пробелы, исключает повторы и сохраняет порядок первого появления строк. Результат можно скопировать или открыть в новой вкладке.

«Инструменты → Версии файла…» показывает снимки небольшого текстового файла и их содержимое. По умолчанию снимки ограничены 5 МиБ на файл и 100 МиБ суммарно; лимиты меняются в панели версий. Снимок создаётся после успешного сохранения и перед восстановлением. Восстановление меняет текст в редакторе: Ctrl+Z отменяет замену текста, Ctrl+S сохраняет в файл с обычной проверкой внешних изменений.

«Инструменты → Вывести окно на передний план…» ищет видимые верхнеуровневые окна Windows, включая свёрнутые. Выберите точный PID процесса или поиск по части заголовка без учёта регистра, затем нажмите «Найти» или Enter. У нужного результата нажмите «Вывести». RustText восстановит свёрнутое окно и сообщит, если Windows отклонит переключение.

Большие логи

Обновления

При запуске RustText проверяет новые стабильные выпуски на GitHub в фоне. Если новая версия доступна, приложение скачивает архив и сверяет его с SHA-256.

Когда обновление готово, «Перезапустить» сохраняет сессию, устанавливает обновление и снова открывает окно. «Позже» скрывает уведомление до следующего запуска.

Подготовка архива

Выполните команды из корня репозитория в PowerShell.

$env:CARGO_TARGET_X86_64_PC_WINDOWS_MSVC_RUSTFLAGS = '-C target-feature=+crt-static'
cargo build --release --locked --target x86_64-pc-windows-msvc
.\tools\Package-RustText.ps1 -ExecutablePath 'target\x86_64-pc-windows-msvc\release\rusttext.exe' -OutputDirectory 'target\distribution\v0.1.1'

Для стабильного релиза с тегом вида v0.1.1 прикрепите к выпуску RustText.zip и RustText.zip.sha256. По этим именам RustText находит файлы обновления. Замеры первого выпуска приведены в отчёте.

Проверка

Модульные тесты лежат в tests/unit/. Имя файла соответствует модулю, например session.rs, search.rs или json_format.rs. Для локальных проверок используйте PowerShell 7 и tools/Check.ps1: по умолчанию два логических CPU, два процесса Cargo, два потока тестов и приоритет BelowNormal. Скрипт восстанавливает настройки после завершения, в том числе при ошибке.

.\tools\Check.ps1 -Mode Targeted -TestFilter 'session::'
.\tools\Check.ps1 -Mode Full

Full последовательно запускает проверку форматирования, все тесты с --locked и Clippy для всех целей с -D warnings. Во время правок запускайте целевые тесты; полный прогон выполняйте после законченного изменения. Build собирает Debug, Release собирает Release для Windows x64. Параметры -Jobs и -CpuCount меняют ограничения; сам скрипт кэш не очищает.

Для последовательной работы в нескольких worktree можно передать один абсолютный путь к каталогу сборки через -CacheDirectory. Cargo использует этот каталог вместо локального target и блокирует одновременные записи. Одинаковые toolchain и флаги позволяют повторно использовать зависимости. Настройки Cargo

Разработка

Порядок работы с LLM-агентами, Git worktree и GitHub описан в руководстве по разработке.

RustText (Illson/RustText)

Ищем в базе…

Что это такое?RustText — текстовый редактор и просмотрщик больших лог-файлов для Windows x64, написанный на Rust с использованием UI-библиотеки GPUI Kit. Он открывает файлы любого размера и включает поиск, проверку JSON и инструмент генерации строк.
Это портативное приложение или его нужно устанавливать?Это портативное приложение: распакуйте архив и запустите rusttext.exe. Регистрация ассоциации файлов необязательна и нужна только, если вы хотите открывать файлы .log, .txt, .json и .xml двойным щелчком.
Как его запустить?Скачайте портативный архив, распакуйте его и запустите rusttext.exe. Отладочная и релизная сборки запускаются без окна консоли, а при повторном запуске файлы передаются уже открытому RustText.
Работает ли это и на Windows 10?Проверено только на Windows 11 x64. Windows 10 x64 пока не тестировалась и требует отдельной проверки.
Работает ли это на macOS или Linux?Нет, поддерживается только Windows x64, как указано в названии и цели сборки.
Что помогает работать с большими файлами?Файлы больше 50 МиБ автоматически открываются в просмотрщике логов, который загружает строки по мере необходимости, с индексом, миникартой полосы прокрутки и отображением номеров строк.
Можно ли искать сразу по нескольким вкладкам?Да, поиск может охватывать все текстовые вкладки, а замена применяется к текущей вкладке. Результаты ограничены первыми 100 совпадениями и помечаются как неполные, если некоторые вкладки не удалось загрузить.
Сохраняется ли моя работа после закрытия?Да, открытые вкладки, черновики, выделение, положение прокрутки и размер окна восстанавливаются из сеанса, а закрытые вкладки можно вернуть из последних 100 закрытых.
Для чего нужен генератор строк?Он создаёт много строк по шаблону с заполнителями вроде {intfrom5}, {guid} и {randstring}, записывая большие результаты в файл с индикатором прогресса и возможностью отмены.
Какие есть похожие проекты?lnav, Notepads, edit, neovide, neomacs, ultra-edit, SwitchHosts, ProxyNodeHub
Автор
Illson
Размер
5.2 MB
Звёзды
614
Возраст
2 д
Коммиты · 90 дней