Розробка на Python із ServBay

Python — це потужна і гнучка мова програмування, широко використовується у веб-розробці, науці про дані, автоматизації та багатьох інших сферах. ServBay — це локальний інструмент для веб-розробки, створений для розробників, який забезпечує підтримку декількох версій Python і зручну інтеграцію з іншими компонентами ServBay (як-от веб-сервери та бази даних) для побудови повноцінного робочого процесу локальної розробки.

Що таке Python?

Python — це високорівнева, інтерпретована мова загального призначення, відома своєю лаконічністю та потужністю. Її філософія акцентує увагу на читабельності та простоті коду, тому Python ідеально підходить для швидкої розробки додатків. Python підтримує різні парадигми програмування: об'єктно-орієнтоване, імперативне, функціональне та процедурне. Основна сила Python — в його багатій стандартній бібліотеці та величезній екосистемі сторонніх пакетів, що дозволяє застосовувати його у веб-розробці (Django, Flask), аналітиці даних, штучному інтелекті, наукових розрахунках тощо.

Підтримка Python у ServBay

Мета ServBay — надати зручний спосіб встановлення й управління різними версіями Python без конфліктів із системним Python чи складних інсталяційних процесів. Ви можете легко перемикатися між кількома версіями Python для роботи над різними проєктами.

ServBay підтримує такі версії Python (актуальний перелік може змінюватися з оновленнями ServBay):

• Python 2.7
• Python 3.5
• Python 3.6
• Python 3.7
• Python 3.8
• Python 3.9
• Python 3.10
• Python 3.11
• Python 3.12
• Python 3.13
• Python 3.14 (та новіші)

Цей перелік охоплює Python 2.7 для спадкових задач, а також сучасні та найновіші гілки Python 3.x, що дозволяє підібрати оптимальну версію під ваш проєкт.

Встановлення Python

Встановлювати Python через графічну панель (GUI) ServBay — просто та інтуїтивно.

1. Відкрийте графічний інтерфейс (GUI) ServBay.
2. Перейдіть до меню Пакети у лівій панелі.
3. Знайдіть розділ Python у списку пакетів.
4. Розгорніть категорію Python, щоб побачити перелік доступних версій.
5. Оберіть потрібну версію Python (наприклад, Python 3.12) і натисніть зелена кнопку Встановити поруч із нею.
6. ServBay автоматично завантажить і встановить вибрану версію Python разом із супутніми компонентами. Дочекайтеся завершення встановлення — кнопка стане зеленою, що означає успішну інсталяцію.

Панель “Пакети” в ServBay GUI з переліком версій Python і кнопками для встановлення

За потреби можна встановлювати кілька версій Python одночасно.

Використання Python у командному рядку

Встановлені через ServBay версії Python автоматично додаються до середовища ServBay і будуть доступні у терміналі. ServBay налаштовує ваш PATH так, щоб ви могли напряму виконувати встановлені версії Python.

Зазвичай доступні такі команди:

• python: вказує на останню встановлену версію Python 3.
• python2: вказує на Python 2.7 (за умови встановлення).
• python3: вказує на останню встановлену версію Python 3.
• pythonX.Y: вказує на конкретну версію Python (наприклад, python3.12, якщо інстальовано).

Щоб перевірити встановлені версії Python, використовуйте термінал ServBay (відкривається з GUI ServBay) або системний термінал:

# Перевірити, яку версію виконує команда python за замовчуванням
python -V
# Приклад виводу: Python 3.12.2

# Перевірити, яку версію використовує команда python3
python3 -V
# Приклад виводу: Python 3.12.2

# Для Python 2.7 (якщо встановлено)
python2 -V
# Приклад виводу: Python 2.7.18

# Для конкретної версії (якщо встановлено)
python3.10 -V
# Приклад виводу: Python 3.10.13

Запустити простий Python-скрипт:

1. Створіть файл (наприклад, hello.py) у кореневій папці вашого сайту (наприклад, /Applications/ServBay/www) або іншому зручному місці.

2. Додайте наступний код:

   # hello.py
   print("Hello from ServBay Python!")

3. Збережіть файл.

4. Відкрийте термінал (з GUI ServBay або системний, переконайтеся, що ServBay запущено і PATH налаштовано).

5. Перейдіть у каталог, де знаходиться hello.py.

6. Запустіть скрипт командою:

   # Наприклад, якщо ви створили hello.py у www
   cd /Applications/ServBay/www
   python hello.py
   # Вивід: Hello from ServBay Python!

   або використовуючи конкретну версію:

   python3.12 hello.py
   # Вивід: Hello from ServBay Python!

Управління Python-пакетами (pip)

Кожна встановлена через ServBay версія Python має pip — менеджер пакетів для встановлення і керування сторонніми бібліотеками.

TIP

У ServBay pip уже попередньо встановлено, окремо інсталювати не потрібно.

Для інсталяції пакетів використовується команда pip install <package-name>. Якщо у вас встановлено кілька версій Python, переконайтеся, що використовуєте pip, пов'язаний із потрібною версією (зазвичай це pipX.Y або через pythonX.Y -m pip).

• Використати pip за замовчуванням (зазвичай для python чи python3):

  pip install requests

• Для конкретної версії:

  pip3.12 install requests

• Через модульний запуск (рекомендовано):

  python3.12 -m pip install requests

Використання віртуальних середовищ Python для ізоляції залежностей

Хоча ServBay дозволяє встановлювати кілька глобальних версій Python, наполегливо рекомендується використовувати віртуальне середовище (Virtual Environment) для кожного проєкту.

Навіщо потрібні віртуальні середовища?

• Ізоляція залежностей: Кожен проєкт може вимагати різні версії одних і тих самих бібліотек (наприклад, у проєкту A потрібен requests==2.25.0, а у B — requests==2.28.1). Віртуальне середовище створює для кожного проєкту окремий Python з власною текою site-packages, що виключає конфлікти залежностей.
• Єдність середовища: Забезпечує збіг залежностей у розробці, тестуванні й (за потреби) продакшені. Для цього використовують файли керування залежностями на кшталт requirements.txt або pyproject.toml.
• Чистота системи: Не варто засмічувати глобальні версії Python, які керуються ServBay, проєктними пакетами. Краще тримати їх відокремлено.

Як створити та використати (наприклад, з venv):

Нехай ви хочете використовувати для проєкту my_flask_app Python 3.12 із ServBay:

1. Оберіть потрібну версію Python (наприклад python3.12).
2. Cтворіть віртуальне середовище:

   # Перейдіть у каталог з проєктом
   cd /Applications/ServBay/www
   # Створіть папку під проєкт
   mkdir my_flask_app
   cd my_flask_app
   
   # Створіть venv через потрібну версію Python ('.venv' — рекомендована назва)
   python3.12 -m venv .venv

   Це створить у папці my_flask_app теку .venv, що містить власний Python, pip і site-packages.
3. Активуйте віртуальне середовище:

   # для macOS
   source .venv/bin/activate

   Після активації у промпті з'явиться (.venv), а команди python та pip вестимуть саме на це середовище.
4. Встановіть залежності:

   # pip install встановлює пакети у .venv
   pip install Flask requests
   
   # Перевірити список встановлених пакетів
   pip list

5. Працюйте над застосунком...
6. Вийдіть із віртуального середовища:

   deactivate

Віртуальні середовища і функціонал .servbay.config працюють разом, забезпечуючи гнучкість та ізоляцію.

Керування версією Python для проєкту через .servbay.config

У ServBay можна створити файл .servbay.config у кореневій папці проєкту, щоб автоматично налаштувати потрібні версії середовища (зокрема, Python) для даного проєкту.

Як це працює:

Коли в інтегрованому терміналі ServBay ви переходите в каталог, що містить .servbay.config, ServBay автоматично зчитує цей файл і налаштовує змінні середовища у поточній сесії терміналу. Це значить, що команди python, php, node тощо виконуватимуться у вказаних у конфігу версіях.

.servbay.config впливає лише на середовище командного рядка й поширюється на каталог розміщення (та всі підкаталоги), але не впливає на веб-сервер.

Приклад формату:

Файл .servbay.config — це звичайний текстовий K/V-файл. Щоб задати потрібну версію Python, додайте рядок із ключем PYTHON_VERSION і вкажіть встановлену через ServBay версію (наприклад, 3.11, 3.12):

# Приклад .servbay.config

# Обрати Python 3.11 для проєкту
PYTHON_VERSION=3.11

# Можна вказати й інші компоненти
PHP_VERSION=8.2
NODE_VERSION=20
# ... додаткові налаштування: реєстри, шляхи кешу тощо ...
# NPM_CONFIG_REGISTRY=https://registry.npmmirror.com/
# GOPROXY=https://goproxy.cn,direct

Переваги:

• Автоматичне перемикання: Не потрібно вручну змінювати глобальну версію Python чи завжди активувати venv (проте рекомендується для залежностей). Достатньо перейти у каталог проєкту — середовище автоматично адаптується.
• Ізоляція проєктів: Кожен проєкт гарантовано запускається у потрібній версії Python.
• Колективна робота: .servbay.config можна зберігати разом із кодом у Git — всі члени команди отримають однакове стартове середовище.

Приклад використання:

Є два проєкти:

• project-a використовує Python 3.11
• project-b — Python 3.14

У відповідних теках створіть файл .servbay.config:

• /Applications/ServBay/www/project-a/.servbay.config:

  PYTHON_VERSION=3.11

• /Applications/ServBay/www/project-b/.servbay.config:

  PYTHON_VERSION=3.14

Тепер, якщо ви у терміналі ServBay перейдете в /Applications/ServBay/www/project-a і наберете python -V, побачите Python 3.11.x. У teці /Applications/ServBay/www/project-b так само працюватиме версія Python 3.14.x.

Зверніть увагу: .servbay.config задає базову версію Python. Для залежностей все одно рекомендується використовувати venv, pipenv чи poetry.

Інтеграція з іншими компонентами ServBay

Одна з головних переваг ServBay — інтегроване локальне середовище. Ви можете поєднувати Python із такими компонентами:

• Веб-розробка: Використовуйте Caddy або Nginx як веб-сервер із ServBay, щоб хостити застосунки на Django, Flask чи інших Python-фреймворках. Для цього налаштуйте проксі з веб-сервера на Python-додаток (Gunicorn, uWSGI).
• Бази даних: Python-додатки часто потребують баз даних. ServBay надає MySQL, PostgreSQL, MongoDB тощо. Для підключення використовуйте бібліотеки (psycopg2 для PostgreSQL, mysql-connector-python для MySQL).
• Кеші: Використовуйте Redis чи Memcached із ServBay для кешування даних у Python-застосунках.

Важливі зауваження

• PATH: ServBay змінює PATH вашого терміналу, щоб першочергово використовувати його версії інструментів. Якщо у вас є інші версії Python поза ServBay, перевіряйте, яку ви використовуєте (which python або which python3).
• Віртуальні середовища: ServBay дає лише базову установку. Для реальних проєктів завжди створюйте ізольоване venv.
• Системні бібліотеки: Для деяких пакетів Python можуть знадобитися додаткові системні бібліотеки чи компілятори. Якщо зіткнетеся з помилкою під час встановлення, дивіться документацію пакета й помилки — можливо, знадобиться доустановити залежності через Homebrew або аналогічне.

Часті питання (FAQ)

Q: Чи можна використовувати Python 2.x і 3.x одночасно у ServBay?

A: Так, ServBay дозволяє встановлювати Python 2.x і 3.x паралельно, запускати їх відповідно командами python2 та python3.

Q: У мене кілька версій Python. Як задати, яку команду python використовувати за замовчуванням?

A: Це налаштовується у розділі "Налаштування" ServBay, де можна вибрати версії Python 2.x та 3.x за замовчуванням. Для проєктів із різними версіями використовуйте .servbay.config: вказавши потрібну версію у цьому файлі, команда python у каталозі проєкту використовуватиме саме її.

Q: Як встановити сторонні бібліотеки у Python із ServBay?

A: Використовуйте pip, що прив’язаний до потрібної версії Python. Наприклад, для Python 3.12 використовуйте python3.12 -m pip install <package-name>. Краще робити це в межах активного віртуального середовища.

Q: Як налаштувати веб-сервер у ServBay для Python-додатків?

A: Зазвичай потрібно налаштувати Caddy чи Nginx — створити сайт-конфіг, прописати зворотний проксі, який перенаправляє HTTP-запити на порт, де працює ваш Python-фреймворк (Django, Flask + Gunicorn або uWSGI). Документація ServBay містить базові приклади налаштування.

Висновок

ServBay забезпечує зручне й інтегроване середовище для розробників Python на macOS. Ви легко можете інсталювати та керувати кількома версіями Python, налаштовувати залежності через pip, інтегруватися з веб-серверами та базами даних ServBay для ефективної локальної розробки й тестування. Використання віртуальних середовищ дає кожному проєкту стабільне й ізольоване середовище, що значно спрощує роботу розробника.