Description

PluThon is an Eclipse Plug-in that provides support for developing Python applications for Maemo Platform. PluThon does NOT require Scratchbox. Developers run and debug applications directly on a Maemo device, speeding up the development time.

 

Current Features

  • Add PluThon nature to existing PyDev projects.
  • Create new PluThon projects.
  • Run PlutThon applications directly on Maemo devices, through SSH and Rsync, transparently.
  • Create SSH sessions in order to connect to different Maemo devices.
  • Set the remote path in which the application will run on the Maemo device.
  • View the output of the application on the Console View.
  • Run PluThon applications as desktop applications (run-standalone.sh) or console applications (python). [Since PluThon 0.1.3]
  • Create new PluThon projects based on templates. [Since PluThon 0.1.4]

 

Planned Features

The list of planned features is detailed at Garage.

 

Next Release

  • Authentication always fails when changing the ssh connection [#1503]

 

Changes

PluThon 0.1.4 - (2007-10-31)

Changes in this version:

  • Compatibility with Eclipse 3.3 [#1178]
  • Desktop application fails if module does not have #!/usr/bin/env python2.5 [#1556]
  • Hyperlinks at the error lines [#935]
  • Create new PluThon projects based on templates. [#841]

PluThon 0.1.3 - (2007-10-14)

  • Missing pictures in the Basic tutorial [#1498]
  • Remove the Remote Location field [#930]
  • Change the defulat value of the field "Private Key File" [#1502]
  • Restore Defaults button doesn't work [#1504]
  • GLIB WARNING ** libebook - Cannot activate book: Unable to determine the address of the message bus [#1473]
  • Run PluThon applications as desktop applications (run-standalone.sh) or console applications (python).
  • Topics related to the running of PluThon applications have been added to the PluThon User Guide (See the topic Tasks >> Running).

PluThon 0.1.2 - (2007-10-07)

  • Detailed Instalation Guide [#1180]
  • M#03 - PluThon User Guide [#843]
  • org.eclipse.core.internal.resources.ResourceException: Resource XXXX is not open. [#1196]

PluThon 0.1.1 - (2007-08-31)

  • Windows support has been added (only with cwRsync 2.0.10).
  • Stopping applications [#941]
  • Error messages have been improved; Rsync error streams are displayed to the developer. In this way, developers know when Rsync are not installed at the Maemo Device, SSH connection are not OK, remote path is set incorrectly, etc.
  • Tracking of tasks related to running of PluThon applications have been improved.
  • Error stream should be colored. [#936]
  • Add SSH Sessions view to the PyDev perspective [#932]
  • Fix warnings [#931]
  • java.net.URISyntaxException: Illegal character in path at index [#934]
  • Project files are not being synchronized [#937]
  • java.io.IOException: CreateProcess: "rsync -Cavz -e...error=2 [#956]
  • Known issue: the Strings PLUTHON_CREATED= and PLUTHON_COMPLETED are displayed at the Console View, before and after the execution of a PluThon application.

 

Bugs

The list of bugs is detailed at Garage.

 

Requirements

Development Environment - (Since version 0.1.1, PluThon works on Linux and Windows)

  • Eclipse SDK 3.3.x - Download
  • PyDev >= 1.3.7
    • Follow this instructions in order to install PyDev.
    • Remember you must choose a PyDev version which is compliant with Eclipse 3.3.x.
  • Python interpreter configured
    • Follow this instructions in order to configure the PyDev interpreter.
  • Rsync
    • On Linux, follow this instructions in order to install rsync.
    • On Windows, PluThon has been tested only with cwRsync 2.0.10. In this way, follow this installation instructions in order to install it.
  • SSH Client with private key (protocol version 2)
    • On Linux, you should use the default SSH client provided with your distribution.
    • On Windows, PluThon has been tested only with the SSH provided by cwRsync 2.0.10. In this way, follow this installation instructions in order to install cwRsync. You must add cwRsync\bin to the path.
    • Follow this instructions in order to generate a private key. See Section 4.3, 4.4 and 4.5. This documentation is valid both on Linux and Windows.

Target Environment (Maemo)

  • Wi-Fi connection
  • osso-xterm
    • Open the Application manager (in Tools menu).
    • Click Browse installable applications and choose the category Applications.
    • Select osso-xterm, click Install and OK.
    • After the installation process, osso-xterm will be available through Extras >> XTerminal (in Tools menu).
    • For more information about install applications, see this post.
  • becomeroot
    • Open the Application manager (in Tools menu).
    • Open its Application catalogue (inside Tools, on the application's menu).
    • Create this new repository:
      Catalogye name: Polish Eko1
      Web address: http://eko.one.pl/maemo/
      Distribution: bora
      Components: user
    • Refresh package list.
    • Click Browse installable applications and choose the category Support.
    • Select becomeroot, click Install and OK.
    • For more information about install applications, see this post.
  • Python for Maemo
    • Follow all this manual installation instructions in order to install Python for Maemo and Development Packages.
  • OpenSSH Server with public key (protocol version 2)
    • In order to install OpenSSH Server, open this page in Maemo and click on the green icon Click to install!.
    • Open Xterminal and switch to root: sudo gainroot
    • For security reasons, lock root account (passwd -l root) and set password (passwd user).
    • Follow this instructions in order to generate a public key. See Section 4.3, 4.4 and 4.5.
  • Rsync
    • Download the most recent vesion of rsync to the Maemo device. Such a package is available at Garage (download the package rsync).
    • Open the File manager (in Tools menu).
    • Select the previously downloaded rsync package and click on it in order to install.

 

Installation

PLEASE, READ THE REQUIREMENTS SECTION CAREFULLY BEFORE FOLLOW THE INSTALLATION INSTRUCTIONS.

Method 1: Remote Update Site

  • 1 - Select Help > Software Updates > Find and Install from the main menu bar.

    pluthon1

  • 2 - Select the Search for new features to install and click Next.

    pluthon2

  • 3 - Click New Remote Site.

    pluthon3

  • 4 - Fill the form with the following values, click OK (Figure 4) and click Finish (Figure 3).

    • Name : PluThon
    • URL : http://pluthon.garage.maemo.org/update
    pluthon4

  • 5 - Select Pluthon and click Next.

    pluthon5

  • 6 - Select I accept the terms in the license agreements and click Next.

    pluthon6

  • 7 - Click Finish and the installation will be performed.

Method 2: ZIP files

After downloading the ZIP file, extract it on top of Eclipse. Make sure the folder plugins is extracted on top of the Eclipse plugins folder and the folder features is extracted on top of the Eclipse features folder. After that, restart Eclipse with the '-clean' flag, to make sure Eclipse finds out about it.