Difference between revisions of "Developing ccPublisher with Eclipse"

From Creative Commons
Jump to: navigation, search
 
(7 intermediate revisions by the same user not shown)
Line 2: Line 2:
 
[[Category:Developer]]
 
[[Category:Developer]]
  
{{stub}}
+
We have found the following tool configuration works well for developing ccPublisher on Windows platforms.  Eclipse is available for Linux and Mac OS X as well, so it should work for all three platforms.  An alternative is to use the cross platform Wing IDE; see [[Developing ccPublisher with Wing]] for details.
 
 
We have found the following tool configuration works well for developing ccPublisher on Windows platforms.  An alternative is to use the cross platform Wing IDE; see [[Developing ccPublisher with Wing]] for details.
 
  
 
== Tools Used ==
 
== Tools Used ==
  
* [http://www.eclipse.org/downloads/ Eclipse]
+
* [http://www.eclipse.org/downloads/ Eclipse 3.1]
 
* [http://pydev.sourceforge.net PyDev]
 
* [http://pydev.sourceforge.net PyDev]
 
* [http://subclipse.tigris.org/ Subclipse]
 
* [http://subclipse.tigris.org/ Subclipse]
 
* [http://eclipsensis.sourceforge.net/ Eclipse NSIS]
 
* [http://eclipsensis.sourceforge.net/ Eclipse NSIS]
 +
 +
=== Using Eclipse 3.2 ===
 +
 +
The instructions and screens on this page were developed using Eclipse 3.1.  Eclipse 3.2 (and the Callisto syncronized release) will be available soon.  There are minor changes to these instructions needed to adapt them to 3.2. 
 +
 +
* In some wizards you click '''Next''' instead of '''Finish'''. 
 +
* When selecting sites to download packages from, also select the ''Calisto Discovery Site'' and ''Eclipse Project Updates'' site.  If dependency errors are displayed, click the '''Select Required''' button to attempt to resolve the dependency issues.
 +
 +
== Prerequisites ==
 +
 +
Before proceeding install the software described in [[CcPublisher Prerequisites]].
  
 
== Installation and Configuration ==
 
== Installation and Configuration ==
Line 49: Line 58:
 
Indicate acceptance of the license agreements and click '''Next'''.
 
Indicate acceptance of the license agreements and click '''Next'''.
  
[[Image]]
+
[[Image:License_agreement.png]]
  
 
Finally, click '''Finish''' to complete installation.
 
Finally, click '''Finish''' to complete installation.
  
[[Image]]
+
[[Image:Update_wiz_final.png]]
 +
 
 +
Eclipse will download each update and install it.  You may be prompted to confirm installation of individual features; simply click '''Install''' or '''Install All'''.  You will be prompted to restart Eclipse after the installation completes.
 +
 
 +
=== Configuring PyDev ===
 +
 
 +
Before you can create a PyDev project you must configure a Python interpreter.  After Eclipse restarts go to the '''Window''' menu and select '''Preferences'''.  Select ''PyDev'' -> '''Interpreter - Python''' from the tree on the left side of the window.
 +
 
 +
[[Image:No_interpreters.png]]
 +
 
 +
Click the '''New...''' button and navigate to your Python interpreter executable (usually <code>c:\python24\python.exe</code>).
  
Eclipse will download each update and install it.  You will be prompted to restart Eclipse after the installation completes.
 
  
 
== Checking out a Sandbox ==
 
== Checking out a Sandbox ==
 +
 +
After Eclipse restarts, click the '''Window''' menu, and then the '''Open Perspective''' sub-menu.  Select '''SVN Repository Exploring'''.  If not listed in the sub-menu, click '''Other...''' for a complete list of available perspectives.
 +
 +
Click the '''Add SVN Repository''' button and enter the repository URL, <code>https://svn.berlios.de/svnroot/repos/cctools/</code>.  Click '''Finish''' and Eclipse will contact the repository.
 +
 +
[[Image:New_svn_repos.png]]
 +
 +
You may be prompted to accept the certificate for the server.  Either click '''Accept temporarily''' or '''Accept permanently'''.
 +
 +
[[Image:Accept_berlios_cert.png]]
 +
 +
If Eclipse validates the repository properly you will now be able to browse the repository tree and select the segment(s) to check out.  For ccPublisher, navigate to the '''publish''' module and select the '''trunk'''.  Right-click the '''trunk''' and select '''Checkout...'''.
 +
 +
[[Image:Repos_trunk_menu.png]]
 +
 +
Select '''Checkout as a project configured using the New Project Wizard''' and click '''Finish'''. 
 +
 +
[[Image:Checkout_as.png]]
 +
 +
Eclipse will retrieve projects information from the Subversion server and start the new project wizard.  Select '''PyDev''' -> '''Pydev Project''' from the wizard and '''Next'''.  Provide a local name for the project and uncheck the '''Create default src directory.'''  Click '''Finish''' to create the project and checkout the source tree.
 +
 +
[[Image:Configure_project.png]]
 +
 +
After the project is checked out, Eclipse will switch into the '''Pydev''' perspective.
 +
 +
== Running within Eclipse ==
 +
 +
To run ccPublisher from within Eclipse, right click on the '''ccp.py''' item in the Navigator and select the '''Run As...''' submenu.  You can create a default run configuration by simply clicking the '''Python Run...''' item.  This will create a run configuration that can later be editted by selecting the '''Run...''' item from the '''Run As...''' submenu.
 +
 +
== Debugging with PyDev ==
 +
 +
PyDev includes an integrated debugger which allows you to set breakpoints, stop execution of the program and inspect the state of the running application.  To perform basic debugging, run the application as described above with a simple change: instead of using the '''Run As...''' right-click sub-menu, use the '''Debug As...''' sub-menu.  You can also set breakpoints in the code by double-clicking in the gray column at the far left side of the editor.  For more details on using PyDev, see the [http://pydev.sourceforge.net/ PyDev home page].
  
 
== Committing Changes ==
 
== Committing Changes ==
 +
 +
To commit local changes to the Subversion server, right-click on the item to commit and select the '''Team''' submenu and click the '''Commit...''' item.  Eclipse will display the commit information dialog which allows you to enter a log message and select which resources you are committing.  This allows you to divide your changes into logical sets.  Simply check (or uncheck) the box next to each item you wish (or do not wish) to commit and provide a log message.  The log message should describe what the change corrects, implements, etc.  If you are committing work for a specific [http://roundup.creativecommons.org/ccpublisher issue] include the issue number in the log message.  After entering your log message, click the '''OK''' button.
 +
 +
[[Image:Commit_message.png]]
 +
 +
== Updating your Checkout ==
 +
 +
To update all or part of your checkout from with Eclipse, right-click on the item to refresh and select the '''Team''' submenu.  Click the '''Update''' menu item to retrieve updates from the server.  By default the update operation will update the selected item and all sub-items; therefore performing an update for the top-level project directory will update the entire project.

Latest revision as of 20:13, 29 June 2006


We have found the following tool configuration works well for developing ccPublisher on Windows platforms. Eclipse is available for Linux and Mac OS X as well, so it should work for all three platforms. An alternative is to use the cross platform Wing IDE; see Developing ccPublisher with Wing for details.

Tools Used

Using Eclipse 3.2

The instructions and screens on this page were developed using Eclipse 3.1. Eclipse 3.2 (and the Callisto syncronized release) will be available soon. There are minor changes to these instructions needed to adapt them to 3.2.

  • In some wizards you click Next instead of Finish.
  • When selecting sites to download packages from, also select the Calisto Discovery Site and Eclipse Project Updates site. If dependency errors are displayed, click the Select Required button to attempt to resolve the dependency issues.

Prerequisites

Before proceeding install the software described in CcPublisher Prerequisites.

Installation and Configuration

Begin by downloading and installing the Eclipse SDK for Windows. The Eclipse SDK contains the basic integrated development environment for Java, and more importantly a framework which may be used by other tools to add support for other languages and technologies. Installing Eclipse for Windows is simply a matter of unzipping the file you downloaded; eclipse.exe is the primary executable.

After installing Eclipse, start the environment. All other installations may be done using Eclipse's integrated update manager. After starting Eclipse and selecting a Workspace location, go to the Help menu and navigate to the Software Updates sub-menu. Select Find and Install....

Eclipse help menu.png

Select Search for New Features to Install and click Next.

Update wiz 1.png

You now need to add the update sites for the new features to install. Click New Remote Site.... Enter PyDev for the name, and the PyDev update URL, http://pydev.sourceforge.net/updates/. Click OK and the site will be added.

New update site.png

Repeat the process for the other two update sites:

All three update sites should be checked; click Finish. Eclipse will visit each update site and download a list of features or updates available from each.

When Eclipse shows the list of updates available, select the following options:

  • PyDev -> Other -> PyDev for Eclipse
  • Subclipse -> Subclipse -> Subclipse 1.0.3
  • EclipseNSIS -> EclipseNSIS
  • EclipseNSIS -> EclipseNSIS Utilities

After the four features are selected, click Next.

Selected updates.png

Indicate acceptance of the license agreements and click Next.

License agreement.png

Finally, click Finish to complete installation.

Update wiz final.png

Eclipse will download each update and install it. You may be prompted to confirm installation of individual features; simply click Install or Install All. You will be prompted to restart Eclipse after the installation completes.

Configuring PyDev

Before you can create a PyDev project you must configure a Python interpreter. After Eclipse restarts go to the Window menu and select Preferences. Select PyDev -> Interpreter - Python from the tree on the left side of the window.

No interpreters.png

Click the New... button and navigate to your Python interpreter executable (usually c:\python24\python.exe).


Checking out a Sandbox

After Eclipse restarts, click the Window menu, and then the Open Perspective sub-menu. Select SVN Repository Exploring. If not listed in the sub-menu, click Other... for a complete list of available perspectives.

Click the Add SVN Repository button and enter the repository URL, https://svn.berlios.de/svnroot/repos/cctools/. Click Finish and Eclipse will contact the repository.

New svn repos.png

You may be prompted to accept the certificate for the server. Either click Accept temporarily or Accept permanently.

Accept berlios cert.png

If Eclipse validates the repository properly you will now be able to browse the repository tree and select the segment(s) to check out. For ccPublisher, navigate to the publish module and select the trunk. Right-click the trunk and select Checkout....

Repos trunk menu.png

Select Checkout as a project configured using the New Project Wizard and click Finish.

Checkout as.png

Eclipse will retrieve projects information from the Subversion server and start the new project wizard. Select PyDev -> Pydev Project from the wizard and Next. Provide a local name for the project and uncheck the Create default src directory. Click Finish to create the project and checkout the source tree.

Configure project.png

After the project is checked out, Eclipse will switch into the Pydev perspective.

Running within Eclipse

To run ccPublisher from within Eclipse, right click on the ccp.py item in the Navigator and select the Run As... submenu. You can create a default run configuration by simply clicking the Python Run... item. This will create a run configuration that can later be editted by selecting the Run... item from the Run As... submenu.

Debugging with PyDev

PyDev includes an integrated debugger which allows you to set breakpoints, stop execution of the program and inspect the state of the running application. To perform basic debugging, run the application as described above with a simple change: instead of using the Run As... right-click sub-menu, use the Debug As... sub-menu. You can also set breakpoints in the code by double-clicking in the gray column at the far left side of the editor. For more details on using PyDev, see the PyDev home page.

Committing Changes

To commit local changes to the Subversion server, right-click on the item to commit and select the Team submenu and click the Commit... item. Eclipse will display the commit information dialog which allows you to enter a log message and select which resources you are committing. This allows you to divide your changes into logical sets. Simply check (or uncheck) the box next to each item you wish (or do not wish) to commit and provide a log message. The log message should describe what the change corrects, implements, etc. If you are committing work for a specific issue include the issue number in the log message. After entering your log message, click the OK button.

Commit message.png

Updating your Checkout

To update all or part of your checkout from with Eclipse, right-click on the item to refresh and select the Team submenu. Click the Update menu item to retrieve updates from the server. By default the update operation will update the selected item and all sub-items; therefore performing an update for the top-level project directory will update the entire project.