PySide Documentation Release 1.2.2 June 23, 2015 Contents 1 Introduction 3 2 Compatibility 5 3 Installation 7 3.1 Installing prerequisities.........................................7 3.2 Installing PySide on a Windows System.................................7 3.3 Installing PySide on a UNIX System..................................7 4 Building PySide on a Windows System9 4.1 Installing prerequisities.........................................9 4.2 Building PySide distribution.......................................9 4.3 Building PySide distribution from git repository............................9 4.4 Installing PySide distribution...................................... 10 4.5 Installing PySide distribution into virtual Python environment................... 10 5 Building PySide on a UNIX System (Ubuntu 12.04 - 14.04) 11 5.1 Installing prerequisities......................................... 11 5.2 Building PySide distribution....................................... 11 5.3 Building PySide distribution from git repository............................ 12 5.4 Installing PySide distribution...................................... 12 5.5 Installing PySide distribution into virtual Python environment................... 12 6 PySide Setup Script command line options 13 6.1 Usage on Windows System....................................... 13 6.2 Usage on UNIX System......................................... 13 6.3 Distribution types............................................ 13 6.4 Options.................................................. 13 7 Feedback and getting involved 15 i ii PySide Documentation, Release 1.2.2 Table of Contents • PySide – Introduction – Compatibility – Installation * Installing prerequisities * Installing PySide on a Windows System * Installing PySide on a UNIX System – Building PySide on a Windows System * Installing prerequisities * Building PySide distribution * Building PySide distribution from git repository * Installing PySide distribution * Installing PySide distribution into virtual Python environment – Building PySide on a UNIX System (Ubuntu 12.04 - 14.04) * Installing prerequisities * Building PySide distribution * Building PySide distribution from git repository * Installing PySide distribution * Installing PySide distribution into virtual Python environment – PySide Setup Script command line options * Usage on Windows System * Usage on UNIX System * Distribution types * Options – Feedback and getting involved Contents 1 PySide Documentation, Release 1.2.2 2 Contents CHAPTER 1 Introduction PySide is the Python Qt bindings project, providing access the complete Qt 4.8 framework as well as to generator tools for rapidly generating bindings for any C++ libraries. The PySide project is developed in the open, with all facilities you’d expect from any modern OSS project such as all code in a git repository, an open Bugzilla for reporting bugs, and an open design process. We welcome any contribution without requiring a transfer of copyright. 3 PySide Documentation, Release 1.2.2 4 Chapter 1. Introduction CHAPTER 2 Compatibility PySide requires Python 2.6 or later and Qt 4.6 or better. Qt 5.x is currently not supported. 5 PySide Documentation, Release 1.2.2 6 Chapter 2. Compatibility CHAPTER 3 Installation 3.1 Installing prerequisities Install latest pip distribution: download get-pip.py and run it using the python interpreter. 3.2 Installing PySide on a Windows System To install PySide on Windows you can choose from the following options: 1. Use pip to install the wheel binary packages: c:\> c:\Python27\Scripts\pip install PySide --use-wheel -f https://download.qt-project.org/official_releases/pyside/ 2. Use setuptools to install the egg binary packages: c:\> c:\Python27\Scripts\easy_install PySide 3. Download and install the packages from the releases page. Note: Provided binaries are without any other external dependencies. All required Qt libraries, development tools and examples are included. 3.3 Installing PySide on a UNIX System We do not provide binaries for UNIX System. Please read the build instructions in section Building PySide on a UNIX System. 7 PySide Documentation, Release 1.2.2 8 Chapter 3. Installation CHAPTER 4 Building PySide on a Windows System 4.1 Installing prerequisities 1. Install Python. 2. Install Qt 4.8 libraries for Windows VS 2008 edition when building against Python 2.6, 2.7 or 3.2. Install Qt 4.8 libraries for Windows VS 2010 edition when building against Python 3.3. 3. Install Cmake. 4. Install Windows SDK v7.0 when building against Python 2.6, 2.7 or 3.2. Install Windows SDK v7.1 when building against Python 3.3. 5. Install Git. 6. (Optional) Install OpenSSL. 7. Install latest pip distribution into the Python you installed in the first step: download get-pip.py and run it using the python interpreter of your Python 2.7 installation using a command prompt: c:\> c:\Python27\python get-pip.py 8. Install latest wheel distribution: c:\> c:\Python27\Scripts\pip install wheel 4.2 Building PySide distribution 1. Download and extract PySide source distribution 2. Switch to the distribution directory: c:\> cd PySide-1.2.2 3. Build the wheel binary distribution: c:\> c:\Python27\python.exe setup.py bdist_wheel --qmake=c:\Qt\4.8.5\bin\qmake.exe --openssl=c:\OpenSSL32bit\bin 4.3 Building PySide distribution from git repository 1. Clone PySide setup scripts from git repository: 9 PySide Documentation, Release 1.2.2 c:\> git clone https://github.com/PySide/pyside-setup.git pyside-setup 2. Switch to the pyside-setup directory: c:\> cd pyside-setup 3. Build the wheel binary distribution: c:\> c:\Python27\python.exe setup.py bdist_wheel --version=1.2.2 --qmake=c:\Qt\4.8.5\bin\qmake.exe --openssl=c:\OpenSSL32bit\bin 4. To build the development version of PySide distribution, ignore the –version parameter: c:\> c:\Python27\python.exe setup.py bdist_wheel --qmake=c:\Qt\4.8.5\bin\qmake.exe --openssl=c:\OpenSSL32bit\bin 4.4 Installing PySide distribution 1. After the successful build, install the distribution with pip: c:\> c:\Python27\Scripts\pip install --use-wheel dist\PySide-1.2.2-cp27-none-win32.whl 4.5 Installing PySide distribution into virtual Python environment 1. Install latest virtualenv distribution: c:\> c:\Python27\Scripts\pip install virtualenv 2. Use virtualenv to make a workspace: c:\> c:\Python27\Scripts\virtualenv --no-site-packages env 3. Switch to the env directory: c:\> cd env 4. Install the distribution with pip: c:\> Scripts\pip install --use-wheel ..\dist\PySide-1.2.2-cp27-none-win32.whl 10 Chapter 4. Building PySide on a Windows System CHAPTER 5 Building PySide on a UNIX System (Ubuntu 12.04 - 14.04) 5.1 Installing prerequisities 1. Install build dependencies: $ sudo apt-get install build-essential git cmake libqt4-dev libphonon-dev python2.7-dev libxml2-dev libxslt1-dev qtmobility-dev 2. Install latest pip distribution into the Python you installed in the first step: download get-pip.py and run it using the python interpreter of your Python 2.7 installation using a command prompt: $ wget https://raw.github.com/pypa/pip/master/contrib/get-pip.py $ sudo python2.7 get-pip.py 3. Install latest wheel distribution: $ sudo pip2.7 install wheel 5.2 Building PySide distribution 1. Download PySide source distribution: $ wget https://pypi.python.org/packages/source/P/PySide/PySide-1.2.2.tar.gz 2. Extract the source distribution: $ tar -xvzf PySide-1.2.2.tar.gz 3. Switch to the distribution directory: $ cd PySide-1.2.2 4. Build the wheel binary distribution: $ python2.7 setup.py bdist_wheel --qmake=/usr/bin/qmake-qt4 5. Optionally you can build standalone version of distribution with embedded Qt libs: $ python2.7 setup.py bdist_wheel --qmake=/usr/bin/qmake-qt4 --standalone 11 PySide Documentation, Release 1.2.2 5.3 Building PySide distribution from git repository 1. Clone PySide setup scripts from git repository: $ git clone https://github.com/PySide/pyside-setup.git pyside-setup 2. Switch to the pyside-setup directory: $ cd pyside-setup 3. Build PySide distribution: $ python2.7 setup.py bdist_wheel --qmake=/usr/bin/qmake-qt4 --version=1.2.2 4. Optionally you can build standalone version of distribution with embedded Qt libs: $ python2.7 setup.py bdist_wheel --qmake=/usr/bin/qmake-qt4 --version=1.2.2 --standalone 5. To build the development version of PySide distribution, ignore the –version parameter: $ python2.7 setup.py bdist_wheel --qmake=/usr/bin/qmake-qt4 5.4 Installing PySide distribution 1. After the successful build, install the distribution with pip: $ sudo pip2.7 install --use-wheel dist/PySide-1.2.2-cp27-none-linux-x86_64.whl 2. Run the post-install script to finish the package configuration: $ sudo python2.7 pyside_postinstall.py -install 5.5 Installing PySide distribution into virtual Python environment 1. Install latest virtualenv distribution: $ sudo pip2.7 virtualenv 2. Use virtualenv to make a workspace: $ virtualenv-2.7 --no-site-packages env 3. Switch to the env directory: $ cd env 4. Install the distribution with pip: $ bin/pip2.7 install --use-wheel ../dist/PySide-1.2.2-cp27-none-linux-x86_64.whl 5. Run the post-install script to finish the package configuration: $ bin/python bin/pyside_postinstall.py -install 12 Chapter 5. Building PySide on a UNIX System (Ubuntu 12.04 - 14.04) CHAPTER 6 PySide Setup Script command line options 6.1 Usage on Windows System c:\> c:\Python27\python.exe setup.py [distribution_type] [options] 6.2 Usage on UNIX System python2.7 setup.py [distribution_type] [options] 6.3 Distribution types bdist_wheel Create wheel binary distribution. This distribution