Qt for Python/Development Getting Started: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
 
No edit summary
Line 1: Line 1:
=Getting Started with PySide Development=
[toc align_right=&quot;yes&amp;quot; depth=&quot;3&amp;quot;]<br />[[Category:LanguageBindings::PySide]]


If you’re new to PySide Development, this page is for you! This page is intended to help you get setup and running as a new developer.
= Getting Started with PySide Development =


==Overview==
If you're new to PySide Development, this page is for you! This page is intended to help you get setup and running as a new developer.


The PySide project is supported by the developers who use PySide. This means that anyone who shares an interest in PySide can join the community, participate in its decision making processes, and contribute to PySide development. This page will summarize the key points around how you contribute to PySide, but since PySide follows the same development process as the Qt project, it’s in your best interest to read the [[Main Page|Qt Project Wiki]] ''[wiki.qt.io]''. For simplicity purposes, much of that wiki page will be summarized here so you can get started faster.
== Overview ==


==Reporting Bugs==
The PySide project is supported by the developers who use PySide. This means that anyone who shares an interest in PySide can join the community, participate in its decision making processes, and contribute to PySide development. This page will summarize the key points around how you contribute to PySide, but since PySide follows the same development process as the Qt project, it's in your best interest to read the &quot;Qt Project Wiki&amp;quot;:http://wiki.qt.io/Main_Page. For simplicity purposes, much of that wiki page will be summarized here so you can get started faster.
 
== Reporting Bugs ==


Bugs should be reported to the Qt bug tracker at https://bugreports.qt.io/browse/PYSIDE Please include details on how to reproduce your problem and consider contributing a fix for it. Since PySide is developer supported, bugs get fixed when developers contribute fixes for them.
Bugs should be reported to the Qt bug tracker at https://bugreports.qt.io/browse/PYSIDE Please include details on how to reproduce your problem and consider contributing a fix for it. Since PySide is developer supported, bugs get fixed when developers contribute fixes for them.


==Getting and Building the Source==
== Getting and Building the Source ==


PySide is split into two packages: Shiboken and PySide. Shiboken is a code generator that is used to generate the C++ code needed by PySide to wrap Qt classes. Shiboken can also be used to wrap other C++ classes. The repositories for both Shiboken and PySide are located on gitorious.org:
PySide is split into two packages: Shiboken and PySide. Shiboken is a code generator that is used to generate the C++ code needed by PySide to wrap Qt classes. Shiboken can also be used to wrap other C++ classes. The repositories for both Shiboken and PySide are located on gitorious.org:
Line 18: Line 20:
* PySide: http://qt.gitorious.org/pyside/pyside
* PySide: http://qt.gitorious.org/pyside/pyside


Instructions on building are available for [[Building PySide on Linux|Linux]], [[Building PySide on Windows|Windows]], and [[Building PySide on Mac OS X|OS X]]. You’ll almost certainly want to use a debug build during development.
Instructions on building are available for [[Building_PySide_on_Linux | Linux]], [[Building_PySide_on_Windows | Windows]], and [[Building_PySide_on_Mac_OS_X | OS X]]. You'll almost certainly want to use a debug build during development.


==Contributing Patches==
== Contributing Patches ==


Because PySide is a Qt project, all patches must be submitted through Qt’s Gerrit code integration system at https://codereview.qt.io All developers need a user account on Gerrit and to agree to the Qt Contributor Agreement. Patches submitted via the bug tracked, mailing list, or pull requests cannot be accepted.
Because PySide is a Qt project, all patches must be submitted through Qt's Gerrit code integration system at https://codereview.qt.io All developers need a user account on Gerrit and to agree to the Qt Contributor Agreement. Patches submitted via the bug tracked, mailing list, or pull requests cannot be accepted.


A bug tracker (<span class="caps">JIRA</span>) account is needed before a Gerrit account can be created:
A bug tracker (JIRA) account is needed before a Gerrit account can be created:


* '''<span class="caps">JIRA</span> account'''
* '''JIRA account'''
*# Go to [https://bugreports.qt.io bugreports.qt.io] ''[bugreports.qt.io]'' and click on '''Sign Up'''
*# Go to &quot;bugreports.qt.io&amp;quot;:https://bugreports.qt.io and click on '''Sign Up'''
*# Fill out the details
*# Fill out the details
* '''Gerrit account'''
* '''Gerrit account'''
*# Go to [https://codereview.qt.io codereview.qt.io] ''[codereview.qt.io]'' and click on '''Sign In'''
*# Go to &quot;codereview.qt.io&amp;quot;:https://codereview.qt.io and click on '''Sign In'''
*# Login with the username/password you created with <span class="caps">JIRA</span>
*# Login with the username/password you created with JIRA
*#* '''<span class="caps">NOTE</span>:''' Gerrit usernames are case-sensitive, but <span class="caps">JIRA</span> usernames are not. If you attempt to log into Gerrit with different capitalizations, you will end up with multiple accounts.
*#* '''NOTE:''' Gerrit usernames are case-sensitive, but JIRA usernames are not. If you attempt to log into Gerrit with different capitalizations, you will end up with multiple accounts.
*# Enter your '''full name''' and click '''Save Changes'''
*# Enter your '''full name''' and click '''Save Changes'''
*# Skip the <span class="caps">SSH</span> part for now and scroll all the way down and click '''“New Contributor Agreement”'''
*# Skip the SSH part for now and scroll all the way down and click '''&quot;New Contributor Agreement&amp;quot;'''
*## Select '''Individual''' or '''Corporate''', then scroll down and type '''I <span class="caps">AGREE</span>''' then '''submit'''
*## Select '''Individual''' or '''Corporate''', then scroll down and type '''I AGREE''' then '''submit'''
*## To check if your agreement was submitted, click on '''Settings''' then '''Agreements'''
*## To check if your agreement was submitted, click on '''Settings''' then '''Agreements'''


===Configuring local directories for Gerrit===
=== Configuring local directories for Gerrit ===


Please follow the [[Setting-up-Gerrit|Qt Setting up Gerrit]] instructions, particularly the Local Setup and Configuring Git sections. Add a gerrit remote to local project directory with:
Please follow the [[Setting-up-Gerrit | Qt Setting up Gerrit]] instructions, particularly the Local Setup and Configuring Git sections. Add a gerrit remote to local project directory with:


where &lt;project&gt; is either pyside or shiboken.
<code><br />$ git remote add gerrit ssh://codereview.qt.io/pyside/&amp;lt;project&amp;gt;<br /></code>


===Pushing changes to Gerrit===
where &lt;project&amp;gt; is either pyside or shiboken.
 
=== Pushing changes to Gerrit ===


After you have committed your changes locally, you can push them to Gerrit like this:
After you have committed your changes locally, you can push them to Gerrit like this:


===Categories:===
<code><br /> $ git push gerrit HEAD:refs/for/master
 
* [[:Category:LanguageBindings|LanguageBindings]]
** [[:Category:LanguageBindings::PySide|PySide]]

Revision as of 09:41, 24 February 2015

[toc align_right="yes&quot; depth="3&quot;]

Getting Started with PySide Development

If you're new to PySide Development, this page is for you! This page is intended to help you get setup and running as a new developer.

Overview

The PySide project is supported by the developers who use PySide. This means that anyone who shares an interest in PySide can join the community, participate in its decision making processes, and contribute to PySide development. This page will summarize the key points around how you contribute to PySide, but since PySide follows the same development process as the Qt project, it's in your best interest to read the "Qt Project Wiki&quot;:http://wiki.qt.io/Main_Page. For simplicity purposes, much of that wiki page will be summarized here so you can get started faster.

Reporting Bugs

Bugs should be reported to the Qt bug tracker at https://bugreports.qt.io/browse/PYSIDE Please include details on how to reproduce your problem and consider contributing a fix for it. Since PySide is developer supported, bugs get fixed when developers contribute fixes for them.

Getting and Building the Source

PySide is split into two packages: Shiboken and PySide. Shiboken is a code generator that is used to generate the C++ code needed by PySide to wrap Qt classes. Shiboken can also be used to wrap other C++ classes. The repositories for both Shiboken and PySide are located on gitorious.org:

Instructions on building are available for Linux, Windows, and OS X. You'll almost certainly want to use a debug build during development.

Contributing Patches

Because PySide is a Qt project, all patches must be submitted through Qt's Gerrit code integration system at https://codereview.qt.io All developers need a user account on Gerrit and to agree to the Qt Contributor Agreement. Patches submitted via the bug tracked, mailing list, or pull requests cannot be accepted.

A bug tracker (JIRA) account is needed before a Gerrit account can be created:

  • JIRA account
    1. Go to "bugreports.qt.io&quot;:https://bugreports.qt.io and click on Sign Up
    2. Fill out the details
  • Gerrit account
    1. Go to "codereview.qt.io&quot;:https://codereview.qt.io and click on Sign In
    2. Login with the username/password you created with JIRA
      • NOTE: Gerrit usernames are case-sensitive, but JIRA usernames are not. If you attempt to log into Gerrit with different capitalizations, you will end up with multiple accounts.
    3. Enter your full name and click Save Changes
    4. Skip the SSH part for now and scroll all the way down and click "New Contributor Agreement&quot;
      1. Select Individual or Corporate, then scroll down and type I AGREE then submit
      2. To check if your agreement was submitted, click on Settings then Agreements

Configuring local directories for Gerrit

Please follow the Qt Setting up Gerrit instructions, particularly the Local Setup and Configuring Git sections. Add a gerrit remote to local project directory with:

<br />$ git remote add gerrit ssh://codereview.qt.io/pyside/&amp;lt;project&amp;gt;<br />

where <project&gt; is either pyside or shiboken.

Pushing changes to Gerrit

After you have committed your changes locally, you can push them to Gerrit like this:


$ git push gerrit HEAD:refs/for/master