Создаём окружение для PyQt5 в Linux MInt (Ubuntu)
Давно уже до пятой версии обновился Qt и вместе с ним PyQt, но найти информацию по ним в русскоязычном сегменте — задача не из простых. Под катом подробный туториал для тех, кто только начинает знакомиться со связкой Qt + python3.Цель: собрать и настроить окружение, пройти путь от установки PyQt5 и создания формы в Qt Designer до запуска переносимого бинарника.
Пути установкиИсходя из того, что мы — совсем новички, я постараюсь использовать пути в системе, которые используются по-умолчанию, или которые мы создадим исходя из следующей логики размещения: Все необходимые файлы и папки хранятся в директории dev в домашней директории пользователя, т.е. ~/dev/ Мы будем использовать виртуальные окружения для питона, и хранить их будем в директории envs, т.е. ~/dev/envs/ Наши проекты будут храниться в директории src, т.е. ~/dev/src/ Если у вас уже сложилась собственная иерархия размещения файлов, то придётся скорректировать пути в командах, приведённых ниже.Настройка окружения Создаём структуру директорий. Откройте консоль и выполните: cd ~ mkdir -p dev/envs dev/src cd dev/envs Ставим пакет, который потребуется нам для сборки в будущем: sudo apt-get install python3-dev Ставим pip и virtualenv: wget https://bootstrap.pypa.io/get-pip.py sudo python3 get-pip.py rm get-pip.py sudo pip install virtualenv Создаём виртуальное окружение, активируем его и обновляем пакеты: virtualenv --prompt=»[pyqt5] » pyqt5 source pyqt5/bin/activate pip install -U pip setuptools Ставим Qt5. При выборе пути установки я оставил «по-умолчанию» ~/Qt. Если Вы выберите другой, то необходимо менять пути в командах ниже: # Для x64-архитектуры # http://www.qt.io/download-open-source/#section-2 wget http://download.qt-project.org/official_releases/online_installers/qt-opensource-linux-x64-online.run chmod u+x qt-opensource-linux-x64-online.run ./qt-opensource-linux-x64-online.run rm qt-opensource-linux-x64-online.run
# Для x86-архитектуры # http://www.qt.io/download-open-source/#section-2 # wget http://download.qt-project.org/official_releases/online_installers/qt-opensource-linux-x86-online.run # chmod u+x qt-opensource-linux-x86-online.run # ./qt-opensource-linux-x86-online.run # rm qt-opensource-linux-x86-online.run Ставим SIP — модуль, необходимый для работы PyQt: # http://www.riverbankcomputing.com/software/sip/download wget http://sourceforge.net/projects/pyqt/files/sip/sip-4.16.5/sip-4.16.5.tar.gz tar xvzf sip-4.16.5.tar.gz cd sip-4.16.5/ python configure.py -d ~/dev/envs/pyqt5/lib/python3.4/site-packages/ make sudo make install sudo make clean cd … rm -rf sip* Ставим PyQt: wget http://sourceforge.net/projects/pyqt/files/PyQt5/PyQt-5.4/PyQt-gpl-5.4.tar.gz tar xvzf PyQt-gpl-5.4.tar.gz cd PyQt-gpl-5.4/ # У меня под рукой только x64-архитектура, поэтому моя команда выглядит именно так. # Если же у вас x86, то путь ~/Qt/5.4/gcc_64/bin/qmake будет выглядеть иначе. # Буду признателен, если в комментариях подскажут, как именно python configure.py --destdir ~/dev/envs/pyqt5/lib/python3.4/site-packages/ --qmake ~/Qt/5.4/gcc_64/bin/qmake make sudo make install sudo make clean cd … rm -rf PyQt* На этом всё. Окружение установлено и готово к работе. Для проверки выполните команду: python -c «from PyQt5.QtCore import QT_VERSION_STR; from PyQt5.Qt import PYQT_VERSION_STR; from sip import SIP_VERSION_STR; print ('Qt version: ', QT_VERSION_STR); print ('SIP version: ', SIP_VERSION_STR); print ('PyQt version: ', PYQT_VERSION_STR)» Ответ должен выглядеть следующим образом: Qt version: 5.4.0 SIP version: 4.16.5 PyQt version: 5.4 Для проверки, что всё действительно установилось в виртуальное окружение, откройте новое окно терминала и повторите команду проверки: В ответ должна появиться ошибка ImportError. Новое окно терминала после этого можно закрыть.
Создание приложения
Перейдём в директорию с нашими исходниками и создадим директорию проекта:
cd …/src/
mkdir pyqt_test
cd pyqt_test/
Далее нам потребуется Qt Designer. Если Вы не меняли пусть установки Qt, то запустить его можно командой:
# И вновь эта команда будет работать только для x64-архитектуры.
# Для x86 вместо gcc_64 вероятнее всего будет иная директория.
~/Qt/5.4/gcc_64/bin/designer
Вот так выглядит запущенный Qt Designer на моей системе: 
В данном руководстве я не буду подробно останавливаться на описании интерфейса дизайнера, мы пройдём простейший путь до минимальной готовой формы. Если Вам необходима более подробная информация — Google It! В диалоговом окне выбираем «Widget» (последний пункт в списке «templates/forms») и нажимаем кнопку «Создать». Откроется форма редактирования виджета: 
Перетащите на форму кнопку из меню слева и сохраните полученную форму с именем test.ui в директорию ~/dev/src/pyqt_test/: 
Tips&Tricks: Нажав [Crtl + R] Вы можете запустить свою форму и «потрогать» её в режиме реального времени.
Конвертируем файл интерфейса из XML формы в понятную python форму:
pyuic5 test.ui > test_ui.py Я не хочу редактировать что-либо в файле, созданном конвертером PyQt, поэтому наши слоты мы опишем в отдельном файле. Создайте файл test_slots.py и откройте его в любимом Вами редакторе. Наполнение файла должно выглядеть примерно так: »« Пользовательские слоты для виджетов. »« # Импортируем модуль времени from datetime import datetime # Импортируем класс интерфейса из созданного конвертером модуля from test_ui import Ui_Form
# Создаём собственный класс, наследуясь от автоматически сгенерированного class MainWindowSlots (Ui_Form): # Определяем пользовательский слот def set_time (self): # Получаем текущую метку времени в формате 'Ч: М: С' str_time = datetime.now ().strftime ('%H:%M:%S') # Присваиваем надписи на кнопке метку времени self.pushButton.setText (str_time) return None
Затем, создайте ещё один файл с именем main.py, в котором мы опишем основную логику: »« Основной скрипт программы. Запускает конфигуратор окна, подключает слоты и отображает окно. »« # Импортируем системый модуль для корректного закрытия программы import sys # Импортируем минимальный набор виджетов from PyQt5.QtWidgets import QApplication, QWidget # Импортируем созданный нами класс со слотами from test_slots import MainWindowSlots
# Создаём ещё один класс, наследуясь от класса со слотами class MainWindow (MainWindowSlots):
# При инициализации класса нам необходимо выпонить некоторые операции def __init__(self, form): # Сконфигурировать интерфейс методом из базового класса Ui_Form self.setupUi (form) # Подключить созданные нами слоты к виджетам self.connect_slots ()
# Подключаем слоты к виджетам def connect_slots (self): self.pushButton.clicked.connect (self.set_time) return None
if __name__ == '__main__':
# Создаём экземпляр приложения
app = QApplication (sys.argv)
# Создаём базовое окно, в котором будет отображаться наш UI
window = QWidget ()
# Создаём экземпляр нашего UI
ui = MainWindow (window)
# Отображаем окно
window.show ()
# Обрабатываем нажатие на кнопку окна «Закрыть»
sys.exit (app.exec_())
На этом наше приложение завершено. Выполнив из консоли
python main.py
мы должны увидеть форму с кнопкой посередине, нажатие на которую меняет название кнопки на системную дату.
Упаковка в исполняемый файл для Linux
Упаковщик потребует некоторой магии при установке.Скачиваем пакет, не устанавливая его и распаковываем:
cd …/…/envs/pyqt/
pip install -d. cx_freeze
tar xvfz cx_Freeze-4.3.4.tar.gz
Открываем любимым редактором файл cx_Freeze-4.3.4/setup.py. Я использую SublimeText:
subl cx_Freeze-4.3.4/setup.py
Правим строку №84, чтобы она выглядела, как на картинке: 
Tips&Tricks: А вы знали, что если запустить SublimeText из виртуального окружения, то интерпретатором по-умолчанию будет из виртуального окружения? Сохраняем изменения, закрываем редактор, устанавливаем пакет, возвращаемся в папку с исходниками, запускаем упаковку:
cd cx_Freeze-4.3.4 python setup.py install rm …/cx_Freeze-4.3.4.tar.gz cd …/…/…/src/pyqt_test cxfreeze main.py После этого в директории с исходниками появится директория dist, в которой среди множества файлов можно заметить файл без расширения main — это и есть наш бинарник, готовый для запуска и переноски. Откровенно говоря, немного расстраивает размер дистрибьютива: на моей машине это — 70,1 Мб, но не стоит забывать, что туда упакованы: python, PyQt, Qt и некоторые общесистемные библиотеки. Сборочный скрипт cxfreeze достаточно гибко конфигурируется, но подбор оптимальных параметров я оставлю на совести читателя. Скажу только, что счастье кроется в сжатии, оптимизации и ручном ограничении зависимостей.P.S.: Все исходники на GitHub`е
