Add files via upload

Author: vasyadiagnost

.gitattributes

@@ -0,0 +1,20 @@
+# Keep scripts safe on Windows while normalizing the rest of the repository.
+*.bat text eol=crlf
+*.cmd text eol=crlf
+*.ps1 text eol=crlf
+*.py text eol=lf
+*.spec text eol=lf
+*.md text eol=lf
+*.txt text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf
+*.toml text eol=lf
+*.json text eol=lf
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.ico binary
+*.pdf binary
+*.doc binary
+*.docx binary
+*.exe binary

.gitignore

@@ -0,0 +1,47 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.pyo
+*.pyd
+*.egg-info/
+.eggs/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# Virtual environments
+.venv/
+.venv_build/
+venv/
+env/
+ENV/
+
+# Build artifacts
+build/
+dist/
+*.log
+*.tmp
+*.bak
+*.zip
+*.7z
+*.rar
+
+# PyInstaller runtime/cache
+*.manifest
+*.toc
+
+# Local app output and test leftovers
+logs/
+output/
+out/
+test_output/
+
+# OS/editor files
+.DS_Store
+Thumbs.db
+desktop.ini
+.vscode/
+.idea/

CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [1.0.0] - 2026-05-28
+
+### Added
+
+- Initial GitHub-ready release package.
+- RU / EN language switcher.
+- English translation for UI labels, tabs, buttons, dialogs, statuses and log messages.
+- Smoke tests for translation coverage, branding removal, PDF/image helpers and batch-file line endings.
+- GitHub-ready documentation, upload guide, build guide, release checklist and CI smoke-test workflow.
+
+### Changed
+
+- Main source file renamed to `office_converter.py` for a cleaner repository layout.
+- PyInstaller spec and build scripts updated to use the new source file name.
+- Windows batch files kept ASCII-only with CRLF line endings.
+
+### Removed
+
+- Old logo image, “Ща все сделаем!” text and Dzen link from the interface.
+- Logo references from the PyInstaller spec.
+
+### Known limitations
+
+- Word/DOC/DOCX operations require Windows with Microsoft Word installed.
+- PDF → DOCX conversion quality depends on source PDF layout complexity.

CONTRIBUTING.md

@@ -0,0 +1,34 @@
+# Contributing
+
+Thanks for helping improve Office Converter All-in-One.
+
+## Development setup
+
+On Windows:
+
+```bat
+py -3 -m venv .venv
+.venv\Scripts\python.exe -m pip install --upgrade pip setuptools wheel
+.venv\Scripts\python.exe -m pip install -r requirements.txt
+```
+
+Run smoke tests:
+
+```bat
+run_smoke_tests.bat
+```
+
+On Linux/macOS, GUI tests may require a virtual display, for example `xvfb-run` on Linux.
+
+## Pull request checklist
+
+- Keep the app usable on Windows.
+- Do not remove the RU / EN language switcher.
+- Add translations for both languages when adding UI text.
+- Keep `build_exe.bat` ASCII-only with CRLF line endings.
+- Run `tests/smoke_tests.py` before submitting.
+- Do not commit generated `build/`, `dist/`, virtual environments or local logs.
+
+## Translation keys
+
+UI strings live in the `TRANSLATIONS` dictionary inside `office_converter.py`. Every key must exist in both `RU` and `EN`; the smoke tests enforce this.

OfficeConvertorPortable.spec

@@ -0,0 +1,57 @@
+# -*- mode: python ; coding: utf-8 -*-
+
+from PyInstaller.utils.hooks import collect_submodules
+
+hiddenimports = [
+    'win32com',
+    'win32com.client',
+    'pythoncom',
+    'fitz',
+    'pypdf',
+    'PIL',
+    'pdf2docx',
+]
+
+for package_name in ('fitz', 'pypdf', 'PIL', 'pdf2docx'):
+    try:
+        hiddenimports += collect_submodules(package_name)
+    except Exception:
+        pass
+
+
+a = Analysis(
+    ['office_converter.py'],
+    pathex=[],
+    binaries=[],
+    datas=[],
+    hiddenimports=hiddenimports,
+    hookspath=[],
+    hooksconfig={},
+    runtime_hooks=[],
+    excludes=[],
+    noarchive=False,
+    optimize=0,
+)
+pyz = PYZ(a.pure)
+
+exe = EXE(
+    pyz,
+    a.scripts,
+    a.binaries,
+    a.datas,
+    [],
+    name='OfficeConvertorPortable',
+    debug=False,
+    bootloader_ignore_signals=False,
+    strip=False,
+    upx=True,
+    upx_exclude=[],
+    runtime_tmpdir=None,
+    console=False,
+    disable_windowed_traceback=False,
+    argv_emulation=False,
+    target_arch=None,
+    codesign_identity=None,
+    entitlements_file=None,
+    icon=None,
+)

README.md

@@ -0,0 +1,86 @@
+# Office Converter All-in-One
+
+Offline Windows desktop utility for common office conversion tasks: Word ↔ PDF, DOC → DOCX, PDF ↔ PNG, PDF → DOCX, plus PDF merge and split.
+
+[Русская версия README](README.ru.md)
+
+## Features
+
+- **Word → PDF** for `.doc` and `.docx` files via Microsoft Word automation.
+- **DOC → DOCX** conversion via Microsoft Word automation.
+- **PDF → DOCX** using `pdf2docx`.
+- **PDF → PNG** page export using PyMuPDF.
+- **PNG/JPG → PDF**, either one PDF per image or one merged PDF.
+- **PDF merge** and **PDF split** by pages or ranges.
+- Recursive folder search, optional overwrite, preserving subfolder structure, progress bar and operation log.
+- Runtime **RU / EN** interface switcher.
+- Offline workflow: no file uploads to online conversion services.
+
+## Requirements
+
+- Windows 10/11.
+- Python 3.10 or newer for building/running from source.
+- Microsoft Word is required only for Word/DOC/DOCX modes.
+- Internet access is needed only during the first dependency installation.
+
+## Build a portable EXE on Windows
+
+1. Download or clone this repository.
+2. Open the project folder in Windows Explorer.
+3. Run `build_exe.bat`.
+4. After a successful build, the executable will be here:
+
+```text
+dist\OfficeConvertorPortable.exe
+```
+
+The EXE name intentionally keeps the historical `OfficeConvertorPortable` spelling for compatibility with earlier local builds.
+
+## Run from source on Windows
+
+```bat
+py -3 -m venv .venv
+.venv\Scripts\python.exe -m pip install --upgrade pip setuptools wheel
+.venv\Scripts\python.exe -m pip install -r requirements.txt
+.venv\Scripts\python.exe office_converter.py
+```
+
+## Smoke tests
+
+On Windows:
+
+```bat
+run_smoke_tests.bat
+```
+
+Cross-platform developer check, for example in CI:
+
+```bash
+python tests/smoke_tests.py
+```
+
+The smoke tests cover the translated UI labels, absence of removed branding, basic path helpers, image/PDF conversion helpers, PDF merge/split and Windows batch-file line endings. Microsoft Word COM automation is not tested outside Windows with Word installed.
+
+## Repository structure
+
+```text
+office_converter.py                 Main Tkinter application
+OfficeConvertorPortable.spec         PyInstaller build spec
+build_exe.bat                        Windows EXE build helper
+run_smoke_tests.bat                  Local smoke-test helper
+requirements.txt                     Runtime/build dependencies
+tests/smoke_tests.py                 Smoke tests
+docs/                                Build, upload, release and license notes
+.github/workflows/smoke-tests.yml    GitHub Actions smoke test
+```
+
+## Notes and limitations
+
+- Word automation requires installed Microsoft Word and runs only on Windows.
+- PDF → DOCX attempts to reconstruct document structure; complex layouts may not convert perfectly.
+- Unsigned PyInstaller binaries can trigger antivirus warnings. Build from source if you need maximum trust.
+- Before publishing binaries or choosing a project license, read [`docs/LICENSE_CHOICE.md`](docs/LICENSE_CHOICE.md) and [`docs/THIRD_PARTY_NOTICES.md`](docs/THIRD_PARTY_NOTICES.md), especially the PyMuPDF licensing note.
+
+## License
+
+A project license has not been selected yet. See [`docs/LICENSE_CHOICE.md`](docs/LICENSE_CHOICE.md) before making the repository public or attaching release binaries.

README.ru.md

@@ -0,0 +1,84 @@
+# Офисный конвертер всего во всё
+
+Офлайн-утилита для Windows с графическим интерфейсом: Word ↔ PDF, DOC → DOCX, PDF ↔ PNG, PDF → DOCX, а также слияние и разбивка PDF.
+
+[English README](README.md)
+
+## Возможности
+
+- **Word → PDF** для `.doc` и `.docx` через автоматизацию Microsoft Word.
+- **DOC → DOCX** через Microsoft Word.
+- **PDF → DOCX** через `pdf2docx`.
+- **PDF → PNG** с экспортом страниц через PyMuPDF.
+- **PNG/JPG → PDF**: отдельный PDF на каждую картинку или один общий PDF.
+- **Слияние PDF** и **разбивка PDF** по страницам или диапазонам.
+- Поиск в подпапках, перезапись существующих файлов, сохранение структуры подпапок, прогресс и журнал операций.
+- Рабочий переключатель интерфейса **RU / EN** без перезапуска.
+- Офлайн-режим: файлы не отправляются в онлайн-конвертеры.
+
+## Требования
+
+- Windows 10/11.
+- Python 3.10 или новее для сборки/запуска из исходников.
+- Microsoft Word нужен только для режимов Word/DOC/DOCX.
+- Интернет нужен только при первой установке зависимостей.
+
+## Сборка portable EXE на Windows
+
+1. Скачай или склонируй репозиторий.
+2. Открой папку проекта в Проводнике Windows.
+3. Запусти `build_exe.bat`.
+4. После успешной сборки файл появится здесь:
+
+```text
+dist\OfficeConvertorPortable.exe
+```
+
+Имя EXE специально оставлено как `OfficeConvertorPortable`, чтобы не ломать совместимость с предыдущими локальными сборками.
+
+## Запуск из исходников на Windows
+
+```bat
+py -3 -m venv .venv
+.venv\Scripts\python.exe -m pip install --upgrade pip setuptools wheel
+.venv\Scripts\python.exe -m pip install -r requirements.txt
+.venv\Scripts\python.exe office_converter.py
+```
+
+## Быстрые проверки
+
+На Windows:
+
+```bat
+run_smoke_tests.bat
+```
+
+Для CI или ручной проверки в другой среде:
+
+```bash
+python tests/smoke_tests.py
+```
+
+Smoke-тесты проверяют перевод интерфейса, отсутствие удалённого брендинга, работу вспомогательных функций путей, базовые операции PNG/PDF, слияние/разбивку PDF и корректные переносы строк в BAT-файлах. Режимы Microsoft Word COM вне Windows с установленным Word не проверяются.
+
+## Структура репозитория
+
+```text
+office_converter.py                 Главное Tkinter-приложение
+OfficeConvertorPortable.spec         Спецификация сборки PyInstaller
+build_exe.bat                        Помощник сборки EXE под Windows
+run_smoke_tests.bat                  Помощник запуска smoke-тестов
+docs/                                Инструкции по сборке, GitHub, релизу и лицензии
+tests/smoke_tests.py                 Smoke-тесты
+```
+
+## Важные ограничения
+
+- Автоматизация Word требует установленный Microsoft Word и работает только на Windows.
+- PDF → DOCX восстанавливает структуру документа приблизительно; сложная вёрстка может съехать.
+- Неподписанные PyInstaller-сборки иногда ругает антивирус. Для максимального доверия собирай EXE из исходников.
+- Перед публикацией бинарников и выбором лицензии прочитай [`docs/LICENSE_CHOICE.md`](docs/LICENSE_CHOICE.md) и [`docs/THIRD_PARTY_NOTICES.md`](docs/THIRD_PARTY_NOTICES.md), особенно пункт про PyMuPDF.
+
+## Лицензия
+
+Лицензия проекта пока не выбрана. Перед публичной публикацией репозитория или EXE смотри [`docs/LICENSE_CHOICE.md`](docs/LICENSE_CHOICE.md).