====== Встановлення Python та розпакування Playwright bundle ======

Ця інструкція описує встановлення Python з exe-файлу та розпакування архіву з Playwright для роботи без інтернету.

===== 1. Встановлення Python =====

  - Завантажте файл {{ :python-3.13.15-amd64.rar | python-3.13.15-amd64.rar}} (розархівуйте).
  - Запустіть файл подвійним кліком.
  - **Важливо:** на першому екрані інсталятора обов'язково поставте галочку внизу вікна:
    * **"Add python.exe to PATH"**
  - Натисніть **"Install Now"**.
  - Дочекайтесь завершення встановлення та закрийте вікно інсталятора.

==== Перевірка встановлення ====

Відкрийте командний рядок (cmd) і виконайте:

<code>
python --version
</code>

Має вивести версію, наприклад: ''Python 3.13.15''

===== 2. Розпакування архіву playwright_bundle.rar =====

  - Скопіюйте файл playwright_bundle.rar** на комп'ютер (флешка, локальна мережа тощо).
  - Розпакуйте архів у корінь диска **C:**, щоб отримати шлях:
<code>
C:\playwright_bundle\
</code>
  - Переконайтесь, що всередині є така структура:

<code>
C:\playwright_bundle\
├── wheels\
│   ├── playwright-1.62.0-py3-none-win_amd64.whl
│   ├── greenlet-3.5.5-cp313-cp313-win_amd64.whl
│   ├── pyee-13.0.1-py3-none-any.whl
│   └── typing_extensions-4.16.0-py3-none-any.whl
└── ms-playwright\
    ├── .links
    ├── chromium-1234
    ├── chromium_headless_shell-1234
    ├── ffmpeg-1011
    └── winldd-1007
</code>

**Примітка:** якщо розпакувати архів в інше місце (не в корінь диска), потрібно буде відповідно змінити шлях у наступних кроках встановлення Playwright.

===== 3. Встановлення Playwright на ПК без інтернету =====


Інструкція описує встановлення пакета {{ :playwright_bundle.rar | playwright}} та налаштування браузера Chromium з локально підготовленої папки **playwright_bundle**, без доступу до інтернету.

===== Передумови =====

  * Python вже встановлено (див. інструкцію "Встановлення Python та розпакування Playwright bundle").
  * Архів розпаковано за шляхом:
<code>
C:\playwright_bundle\
</code>

===== 4. Встановлення пакета playwright з локальної папки =====

Відкрийте командний рядок (cmd) і виконайте:

<code>
pip install --no-index --find-links=C:\playwright_bundle\wheels playwright
</code>

Якщо команда ''pip'' не розпізнається, використайте:

<code>
python -m pip install --no-index --find-links=C:\playwright_bundle\wheels playwright
</code>

Після успішного виконання у консолі має з'явитись повідомлення:
<code>
Successfully installed greenlet-3.5.5 playwright-1.62.0 pyee-13.0.1 typing-extensions-4.16.0
</code>

===== 5. Налаштування шляху до браузера =====

Playwright має "знати", де шукати вже завантажений браузер Chromium, замість того щоб качати його з інтернету.

==== Варіант А — постійно для користувача (рекомендовано) ====

<code>
setx PLAYWRIGHT_BROWSERS_PATH "C:\playwright_bundle\ms-playwright"
</code>

**Важливо:** після цієї команди потрібно **перезапустити консоль** (закрити й відкрити наново), щоб змінна середовища підхопилась.

==== Варіант Б — тимчасово, лише для поточного вікна консолі ====

<code>
set PLAYWRIGHT_BROWSERS_PATH=C:\playwright_bundle\ms-playwright
</code>

Діє, поки не закрите це вікно консолі.

==== Варіант В — прописати прямо у Python-коді ====

Додайте на самому початку скрипта, до імпорту playwright:

<code>
import os
os.environ["PLAYWRIGHT_BROWSERS_PATH"] = r"C:\playwright_bundle\ms-playwright"
</code>

===== 6. Перевірка роботи =====

Створіть тестовий файл ''test.py'' з таким вмістом:

<code>
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch()
    page = browser.new_page()
    page.goto("https://example.com")
    print(page.title())
    browser.close()
</code>

Запустіть:

<code>
python test.py
</code>

Якщо все налаштовано правильно, скрипт відкриє сторінку без помилок і виведе її заголовок у консоль.

===== 7. Усунення проблем =====

==== Помилка: Executable doesn't exist ====

Означає, що змінна **PLAYWRIGHT_BROWSERS_PATH** не встановлена або вказує на неправильний шлях.

Перевірте поточне значення змінної:

<code>
echo %PLAYWRIGHT_BROWSERS_PATH%
</code>

Результат має відповідати шляху:
<code>
C:\playwright_bundle\ms-playwright
</code>

Якщо рядок порожній — виконайте команду **setx** з кроку 2 ще раз та перезапустіть консоль.

==== Помилка: pip не знайдено ====

Це означає, що Python не додано до PATH під час встановлення. Перевстановіть Python, обов'язково поставивши галочку **"Add python.exe to PATH"**, або використовуйте повний шлях до ''python.exe'' та ''pip.exe'' напряму.