Maemo Wiki Mirror - User contributions [en]

PyMaemo/Scratchboxless packaging guide

2010-07-09T15:30:10Z

189.115.161.248: /* Support for non-Debian systems */

== Introduction ==

The usual way of developing Maemo applications is using either Scratchbox or [[MADDE]], which are quite heavy for Python development. An alternative is using [http://github.com/astraw/stdeb stdeb], a set of extensions to distutils that allows generating Debian packages, both binary and source, that can be installed on the device or sent to the [[extras-devel]] repository.

This tutorial will show how to integrate it into your project, build the packages and upload them to extras-devel.

== Prerequisites ==

This tutorial is aimed at Debian-based systems, as some stdeb commands requires the dpkg tools installed. If you're using another distro, please refer to the section

Also, you should get the [http://github.com/astraw/stdeb git] version of stdeb to use the debianize command, as it is a new addition and not yet available in the repositories. Run the following commands to install it:

# Clone the git repository
git clone http://github.com/astraw/stdeb.git

# Enter source package
cd stdeb

# Build .deb (making use of stdeb package directory in sys.path).
python setup.py --command-packages=stdeb.command bdist_deb

# Install it
sudo dpkg -i deb_dist/python-stdeb_0.5.1+git-1_all.deb

As only python2.5 is supported in pymaemo, it should be installed if you want to create binary packages. On Ubuntu Lucid (10.04), you can install it from [https://launchpad.net/~fkrull/+archive/deadsnakes this ppa], following the instructions [http://www.codigomanso.com/en/2010/05/google-app-engine-en--10-4-lucid-lynx/ here].

== Preparing the package ==

As stdeb extends distutils, it is necessary that you have a working setup.py script. For our example application, which consists of a [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/myscript single script] named "myscript" and support files like [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/myscript.desktop .desktop]<ref name="desktop">[[Desktop file format]]</ref> and an [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/myscript.png icon]<ref name="icon">[[Packaging#Displaying an icon in the Application Manager next to your package]]</ref>, the [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/setup.py setup.py] will look like this:
<source lang="python">
from distutils.core import setup

setup(
name='myscript',
version='0.1',
author='Lauro Moura',
author_email='lauro.neto@donotspamme.com',
scripts=['myscript'],
data_files=[('share/applications/hildon', ['myscript.desktop']),
('share/pixmaps', ['myscript.png'])],
)
</source>
A file named [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/stdeb.cfg stdeb.cfg] in the same directory as setup.py is required, with stdeb Maemo-specific options. A detailed list of options can be found in the [http://github.com/astraw/stdeb stdeb website].

[DEFAULT]
XS-Python-Version: 2.5 # Only version currently supported by PyMaemo.
Package:my-script # Binary package name. stdeb adds the prefix "python-" by default
Section: user/development # Section should start with user/ to appear in the menu.
Depends: python-gtk2 # extra dependencies go here

Warning 1: Make sure to use [[Maemo_packaging#Sections|an allowed section]].

Warning 2: The <code>Depends</code> field in stdeb.cfg will be used on your debian/control file, so fill it correctly with all the dependencies of your application - otherwise it will break when you try to install it. For instance, [http://gitorious.org/twcano/twcano twcano] depends on the following packages: <code>python-simplejson, pyside-qt4-maemo5, pyside-qt4-webkit and python-twitter</code>, so the <code>Depends</code> field should be filled this way:

Depends: python-simplejson, pyside-qt4-maemo5, pyside-qt4-webkit, python-twitter

== Building the packages ==

The basic command is

python setup.py --command-packages=stdeb.command bdist_deb

It'll create a folder called deb_dist with the source and binary packages. Alternatively, the "sdist_dsc" command will create only the source package.

After generating, you can copy the package to your device and install it (requires an [[SSH]] server):

$ scp myscript_0.1-1_all.deb root@<n900 ip>:/root
$ ssh root@<n900 ip>
# dpkg -i myscript_0.1-1_all.deb

== Building a basic debian directory ==

Another useful command is ''debianize''. It will read the configuration file and write a directory named debian in the same directory. This can be used for manually creating the packages using dpkg tools directly. For a detailed usage example see the [http://github.com/astraw/stdeb#debianize-distutils-command steb website].

Note: sdist_dsc and bdist_deb do '''not''' use this directory, generating a new one in the source dir under deb_dist/.

== Uploading to extras ==

To upload to extras, use the debianize command and then call dpkg-buildpackage:

$ dpkg-buildpackage -rfakeroot -uc -us -S

This command will create the .dsc, .tar.gz and .changes files that can be used to [[uploading to Extras-devel|upload the application to extras-devel]].

== Support for non-Debian systems ==

{{ambox
| type = notice
| image=
| text = Keep in mind that the support for non-Debian systems is '''experimental''': it is not as funcional as the stdeb approach shown above and may not work for your package. Also, these instructions change without notice. }}

If you're using a distro not based on Debian, you can still create source packages for uploading to extras-devel, but won't be able to create binary packages (.deb).

For doing this, you will need the sdist_deb module available [http://gitorious.org/pymaemo/sboxless here]; just clone it in some directory and point the PYTHONPATH environment variable there.

Now create a file called sboxless.cfg, which will contain additional information for generating the package. For now, you can add additional runtime dependencies for your package. If you want to add python-twitter as dependency, just write

[control]
depends=python-twitter

The file is mandatory, so if you don't want to add any dependency, just leave the field empty ('depends=').

Now, run the sdist_deb command:

PYTHONPATH=/path/to/sboxless python setup.py --command-packages=sboxless sdist_deb

The source files will be generated on the ./dist directory.

== References ==

<references />

[[Category:Python]]
[[Category:Packaging]]

PyMaemo/Scratchboxless packaging guide

2010-07-09T15:28:20Z

189.115.161.248: /* Support for non-Debian systems */

== Introduction ==

The usual way of developing Maemo applications is using either Scratchbox or [[MADDE]], which are quite heavy for Python development. An alternative is using [http://github.com/astraw/stdeb stdeb], a set of extensions to distutils that allows generating Debian packages, both binary and source, that can be installed on the device or sent to the [[extras-devel]] repository.

This tutorial will show how to integrate it into your project, build the packages and upload them to extras-devel.

== Prerequisites ==

This tutorial is aimed at Debian-based systems, as some stdeb commands requires the dpkg tools installed. If you're using another distro, please refer to the section

Also, you should get the [http://github.com/astraw/stdeb git] version of stdeb to use the debianize command, as it is a new addition and not yet available in the repositories. Run the following commands to install it:

# Clone the git repository
git clone http://github.com/astraw/stdeb.git

# Enter source package
cd stdeb

# Build .deb (making use of stdeb package directory in sys.path).
python setup.py --command-packages=stdeb.command bdist_deb

# Install it
sudo dpkg -i deb_dist/python-stdeb_0.5.1+git-1_all.deb

As only python2.5 is supported in pymaemo, it should be installed if you want to create binary packages. On Ubuntu Lucid (10.04), you can install it from [https://launchpad.net/~fkrull/+archive/deadsnakes this ppa], following the instructions [http://www.codigomanso.com/en/2010/05/google-app-engine-en--10-4-lucid-lynx/ here].

== Preparing the package ==

As stdeb extends distutils, it is necessary that you have a working setup.py script. For our example application, which consists of a [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/myscript single script] named "myscript" and support files like [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/myscript.desktop .desktop]<ref name="desktop">[[Desktop file format]]</ref> and an [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/myscript.png icon]<ref name="icon">[[Packaging#Displaying an icon in the Application Manager next to your package]]</ref>, the [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/setup.py setup.py] will look like this:
<source lang="python">
from distutils.core import setup

setup(
name='myscript',
version='0.1',
author='Lauro Moura',
author_email='lauro.neto@donotspamme.com',
scripts=['myscript'],
data_files=[('share/applications/hildon', ['myscript.desktop']),
('share/pixmaps', ['myscript.png'])],
)
</source>
A file named [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/stdeb.cfg stdeb.cfg] in the same directory as setup.py is required, with stdeb Maemo-specific options. A detailed list of options can be found in the [http://github.com/astraw/stdeb stdeb website].

[DEFAULT]
XS-Python-Version: 2.5 # Only version currently supported by PyMaemo.
Package:my-script # Binary package name. stdeb adds the prefix "python-" by default
Section: user/development # Section should start with user/ to appear in the menu.
Depends: python-gtk2 # extra dependencies go here

Warning 1: Make sure to use [[Maemo_packaging#Sections|an allowed section]].

Warning 2: The <code>Depends</code> field in stdeb.cfg will be used on your debian/control file, so fill it correctly with all the dependencies of your application - otherwise it will break when you try to install it. For instance, [http://gitorious.org/twcano/twcano twcano] depends on the following packages: <code>python-simplejson, pyside-qt4-maemo5, pyside-qt4-webkit and python-twitter</code>, so the <code>Depends</code> field should be filled this way:

Depends: python-simplejson, pyside-qt4-maemo5, pyside-qt4-webkit, python-twitter

== Building the packages ==

The basic command is

python setup.py --command-packages=stdeb.command bdist_deb

It'll create a folder called deb_dist with the source and binary packages. Alternatively, the "sdist_dsc" command will create only the source package.

After generating, you can copy the package to your device and install it (requires an [[SSH]] server):

$ scp myscript_0.1-1_all.deb root@<n900 ip>:/root
$ ssh root@<n900 ip>
# dpkg -i myscript_0.1-1_all.deb

== Building a basic debian directory ==

Another useful command is ''debianize''. It will read the configuration file and write a directory named debian in the same directory. This can be used for manually creating the packages using dpkg tools directly. For a detailed usage example see the [http://github.com/astraw/stdeb#debianize-distutils-command steb website].

Note: sdist_dsc and bdist_deb do '''not''' use this directory, generating a new one in the source dir under deb_dist/.

== Uploading to extras ==

To upload to extras, use the debianize command and then call dpkg-buildpackage:

$ dpkg-buildpackage -rfakeroot -uc -us -S

This command will create the .dsc, .tar.gz and .changes files that can be used to [[uploading to Extras-devel|upload the application to extras-devel]].

== Support for non-Debian systems ==

{{ambox
| type = notice
| image=
| text = Keep in mind that the support for non-Debian systems is '''experimental''': it is not as funcional as the stdeb approach shown above and
may change without notice. }}

If you're using a distro not based on Debian, you can still create source packages for uploading to extras-devel, but won't be able to create binary packages (.deb).

For doing this, you will need the sdist_deb module available [http://gitorious.org/pymaemo/sboxless here]; just clone it in some directory and point the PYTHONPATH environment variable there.

Now create a file called sboxless.cfg, which will contain additional information for generating the package. For now, you can add additional runtime dependencies for your package. If you want to add python-twitter as dependency, just write

[control]
depends=python-twitter

The file is mandatory, so if you don't want to add any dependency, just leave the field empty ('depends=').

Now, run the sdist_deb command:

PYTHONPATH=/path/to/sboxless python setup.py --command-packages=sboxless sdist_deb

The source files will be generated on the ./dist directory.

== References ==

<references />

[[Category:Python]]
[[Category:Packaging]]

PyMaemo/Scratchboxless packaging guide

2010-07-08T22:28:47Z

189.115.161.248: /* Support for non-Debian systems */

== Introduction ==

The usual way of developing Maemo applications is using either Scratchbox or [[MADDE]], which are quite heavy for Python development. An alternative is using [http://github.com/astraw/stdeb stdeb], a set of extensions to distutils that allows generating Debian packages, both binary and source, that can be installed on the device or sent to the [[extras-devel]] repository.

This tutorial will show how to integrate it into your project, build the packages and upload them to extras-devel.

== Prerequisites ==

This tutorial is aimed at Debian-based systems, as some stdeb commands requires the dpkg tools installed. If you're using another distro, please refer to the section

Also, you should get the [http://github.com/astraw/stdeb git] version of stdeb to use the debianize command, as it is a new addition and not yet available in the repositories. Run the following commands to install it:

# Clone the git repository
git clone http://github.com/astraw/stdeb.git

# Enter source package
cd stdeb

# Build .deb (making use of stdeb package directory in sys.path).
python setup.py --command-packages=stdeb.command bdist_deb

# Install it
sudo dpkg -i deb_dist/python-stdeb_0.5.1+git-1_all.deb

As only python2.5 is supported in pymaemo, it should be installed if you want to create binary packages. On Ubuntu Lucid (10.04), you can install it from [https://launchpad.net/~fkrull/+archive/deadsnakes this ppa], following the instructions [http://www.codigomanso.com/en/2010/05/google-app-engine-en--10-4-lucid-lynx/ here].

== Preparing the package ==

As stdeb extends distutils, it is necessary that you have a working setup.py script. For our example application, which consists of a [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/myscript single script] named "myscript" and support files like [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/myscript.desktop .desktop]<ref name="desktop">[[Desktop file format]]</ref> and an [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/myscript.png icon]<ref name="icon">[[Packaging#Displaying an icon in the Application Manager next to your package]]</ref>, the [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/setup.py setup.py] will look like this:
<source lang="python">
from distutils.core import setup

setup(
name='myscript',
version='0.1',
author='Lauro Moura',
author_email='lauro.neto@donotspamme.com',
scripts=['myscript'],
data_files=[('share/applications/hildon', ['myscript.desktop']),
('share/pixmaps', ['myscript.png'])],
)
</source>
A file named [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/stdeb.cfg stdeb.cfg] in the same directory as setup.py is required, with stdeb Maemo-specific options. A detailed list of options can be found in the [http://github.com/astraw/stdeb stdeb website].

[DEFAULT]
XS-Python-Version: 2.5 # Only version currently supported by PyMaemo.
Package:my-script # Binary package name. stdeb adds the prefix "python-" by default
Section: user/development # Section should start with user/ to appear in the menu.
Depends: python-gtk2 # extra dependencies go here

Warning 1: Make sure to use [[Maemo_packaging#Sections|an allowed section]].

Warning 2: The <code>Depends</code> field in stdeb.cfg will be used on your debian/control file, so fill it correctly with all the dependencies of your application - otherwise it will break when you try to install it. For instance, [http://gitorious.org/twcano/twcano twcano] depends on the following packages: <code>python-simplejson, pyside-qt4-maemo5, pyside-qt4-webkit and python-twitter</code>, so the <code>Depends</code> field should be filled this way:

Depends: python-simplejson, pyside-qt4-maemo5, pyside-qt4-webkit, python-twitter

== Building the packages ==

The basic command is

python setup.py --command-packages=stdeb.command bdist_deb

It'll create a folder called deb_dist with the source and binary packages. Alternatively, the "sdist_dsc" command will create only the source package.

After generating, you can copy the package to your device and install it (requires an [[SSH]] server):

$ scp myscript_0.1-1_all.deb root@<n900 ip>:/root
$ ssh root@<n900 ip>
# dpkg -i myscript_0.1-1_all.deb

== Building a basic debian directory ==

Another useful command is ''debianize''. It will read the configuration file and write a directory named debian in the same directory. This can be used for manually creating the packages using dpkg tools directly. For a detailed usage example see the [http://github.com/astraw/stdeb#debianize-distutils-command steb website].

Note: sdist_dsc and bdist_deb do '''not''' use this directory, generating a new one in the source dir under deb_dist/.

== Uploading to extras ==

To upload to extras, use the debianize command and then call dpkg-buildpackage:

$ dpkg-buildpackage -rfakeroot -uc -us -S

This command will create the .dsc, .tar.gz and .changes files that can be used to [[uploading to Extras-devel|upload the application to extras-devel]].

== Support for non-Debian systems ==

'''DRAFT DRAFT DRAFT DRAFT DRAFT'''

{{ambox
| type = notice
| image=
| text = Keep in mind that the support for non-Debian systems is '''experimental''': it is not as funcional as the stdeb approach shown above and
may change without notice. }}

If you're using a distro not based on Debian, you can still create source packages for uploading to extras-devel, but won't be able to create binary packages (.deb).

For doing this, you will need the sdist_deb module available [http://gitorious.org/pymaemo/sboxless here]; just clone it in some directory, point the PYTHONPATH environment variable there.

Now create a file called sboxless.cfg, which will contain additional information for generating the package. For now, you can add additional runtime dependencies for your package. If you want to add python-twitter as dependency, just write

[control]
depends=python-twitter

If you don't want to add any dependency, just leave the field empty ('depends=').

Now, run the sdist_deb command:

PYTHONPATH=/path/to/sdist_deb python setup.py --command-packages=sboxless sdist_deb

The source files will be generated on the ./dist directory.

== References ==

<references />

[[Category:Python]]
[[Category:Packaging]]

PyMaemo/Scratchboxless packaging guide

2010-07-08T19:40:40Z

189.115.161.248: /* Support for non-Debian systems */

== Introduction ==

The usual way of developing Maemo applications is using either Scratchbox or [[MADDE]], which are quite heavy for Python development. An alternative is using [http://github.com/astraw/stdeb stdeb], a set of extensions to distutils that allows generating Debian packages, both binary and source, that can be installed on the device or sent to the [[extras-devel]] repository.

This tutorial will show how to integrate it into your project, build the packages and upload them to extras-devel.

== Prerequisites ==

This tutorial is aimed at Debian-based systems, as some stdeb commands requires the dpkg tools installed. If you're using another distro, please refer to the section

Also, you should get the [http://github.com/astraw/stdeb git] version of stdeb to use the debianize command, as it is a new addition and not yet available in the repositories. Run the following commands to install it:

# Clone the git repository
git clone http://github.com/astraw/stdeb.git

# Enter source package
cd stdeb

# Build .deb (making use of stdeb package directory in sys.path).
python setup.py --command-packages=stdeb.command bdist_deb

# Install it
sudo dpkg -i deb_dist/python-stdeb_0.5.1+git-1_all.deb

As only python2.5 is supported in pymaemo, it should be installed if you want to create binary packages. On Ubuntu Lucid (10.04), you can install it from [https://launchpad.net/~fkrull/+archive/deadsnakes this ppa], following the instructions [http://www.codigomanso.com/en/2010/05/google-app-engine-en--10-4-lucid-lynx/ here].

== Preparing the package ==

As stdeb extends distutils, it is necessary that you have a working setup.py script. For our example application, which consists of a [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/myscript single script] named "myscript" and support files like [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/myscript.desktop .desktop]<ref name="desktop">[[Desktop file format]]</ref> and an [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/myscript.png icon]<ref name="icon">[[Packaging#Displaying an icon in the Application Manager next to your package]]</ref>, the [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/setup.py setup.py] will look like this:
<source lang="python">
from distutils.core import setup

setup(
name='myscript',
version='0.1',
author='Lauro Moura',
author_email='lauro.neto@donotspamme.com',
scripts=['myscript'],
data_files=[('share/applications/hildon', ['myscript.desktop']),
('share/pixmaps', ['myscript.png'])],
)
</source>
A file named [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/stdeb.cfg stdeb.cfg] in the same directory as setup.py is required, with stdeb Maemo-specific options. A detailed list of options can be found in the [http://github.com/astraw/stdeb stdeb website].

[DEFAULT]
XS-Python-Version: 2.5 # Only version currently supported by PyMaemo.
Package:my-script # Binary package name. stdeb adds the prefix "python-" by default
Section: user/development # Section should start with user/ to appear in the menu.
Depends: python-gtk2 # extra dependencies go here

Warning 1: Make sure to use [[Maemo_packaging#Sections|an allowed section]].

Warning 2: The <code>Depends</code> field in stdeb.cfg will be used on your debian/control file, so fill it correctly with all the dependencies of your application - otherwise it will break when you try to install it. For instance, [http://gitorious.org/twcano/twcano twcano] depends on the following packages: <code>python-simplejson, pyside-qt4-maemo5, pyside-qt4-webkit and python-twitter</code>, so the <code>Depends</code> field should be filled this way:

Depends: python-simplejson, pyside-qt4-maemo5, pyside-qt4-webkit, python-twitter

== Building the packages ==

The basic command is

python setup.py --command-packages=stdeb.command bdist_deb

It'll create a folder called deb_dist with the source and binary packages. Alternatively, the "sdist_dsc" command will create only the source package.

After generating, you can copy the package to your device and install it (requires an [[SSH]] server):

$ scp myscript_0.1-1_all.deb root@<n900 ip>:/root
$ ssh root@<n900 ip>
# dpkg -i myscript_0.1-1_all.deb

== Building a basic debian directory ==

Another useful command is ''debianize''. It will read the configuration file and write a directory named debian in the same directory. This can be used for manually creating the packages using dpkg tools directly. For a detailed usage example see the [http://github.com/astraw/stdeb#debianize-distutils-command steb website].

Note: sdist_dsc and bdist_deb do '''not''' use this directory, generating a new one in the source dir under deb_dist/.

== Uploading to extras ==

To upload to extras, use the debianize command and then call dpkg-buildpackage:

$ dpkg-buildpackage -rfakeroot -uc -us -S

This command will create the .dsc, .tar.gz and .changes files that can be used to [[uploading to Extras-devel|upload the application to extras-devel]].

== Support for non-Debian systems ==

'''DRAFT DRAFT DRAFT DRAFT DRAFT'''

{{ambox
| type = notice
| image=
| text = Keep in mind that the support for non-Debian systems is '''experimental''': it is not as funcional as the stdeb approach shown above and
may change without notice. }}

If you're using a distro not based on Debian, you can still create source packages for uploading to extras-devel, but won't be able to create binary packages (.deb).

For doing this, you will need the sdist_deb module available [http://gitorious.org/pymaemo/sboxless here]; just clone it in some directory and point the PYTHONPATH environment variable there.

For using it, first include the module in your setup.py:

try:
from sdist_deb import sdist_deb
except ImportError:
from distutils.core import Command
class sdist_deb(Command):
pass

The try/except statement and the dummy class are needed so the package won't break when built on the extras-devel autobuilder.

Add a new cmdclass to your setup.py, or update the existing one:

cmdclass={'sdist_deb': sdist_deb}

or

cmdclass={'command1': command1,
'command2': command1,
(...)
'sdist_deb': sdist_deb}

Now just use the new command to build the sources:

PYTHONPATH=/path/to/sdist_deb python setup.py sdist_deb

The source files will be generated on the ./dist directory.

== References ==

<references />

[[Category:Python]]
[[Category:Packaging]]

PyMaemo/Scratchboxless packaging guide

2010-07-08T19:24:54Z

189.115.161.248: /* Support for non-Debian systems */

== Introduction ==

The usual way of developing Maemo applications is using either Scratchbox or [[MADDE]], which are quite heavy for Python development. An alternative is using [http://github.com/astraw/stdeb stdeb], a set of extensions to distutils that allows generating Debian packages, both binary and source, that can be installed on the device or sent to the [[extras-devel]] repository.

This tutorial will show how to integrate it into your project, build the packages and upload them to extras-devel.

== Prerequisites ==

This tutorial is aimed at Debian-based systems, as some stdeb commands requires the dpkg tools installed. If you're using another distro, please refer to the section

Also, you should get the [http://github.com/astraw/stdeb git] version of stdeb to use the debianize command, as it is a new addition and not yet available in the repositories. Run the following commands to install it:

# Clone the git repository
git clone http://github.com/astraw/stdeb.git

# Enter source package
cd stdeb

# Build .deb (making use of stdeb package directory in sys.path).
python setup.py --command-packages=stdeb.command bdist_deb

# Install it
sudo dpkg -i deb_dist/python-stdeb_0.5.1+git-1_all.deb

As only python2.5 is supported in pymaemo, it should be installed if you want to create binary packages. On Ubuntu Lucid (10.04), you can install it from [https://launchpad.net/~fkrull/+archive/deadsnakes this ppa], following the instructions [http://www.codigomanso.com/en/2010/05/google-app-engine-en--10-4-lucid-lynx/ here].

== Preparing the package ==

As stdeb extends distutils, it is necessary that you have a working setup.py script. For our example application, which consists of a [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/myscript single script] named "myscript" and support files like [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/myscript.desktop .desktop]<ref name="desktop">[[Desktop file format]]</ref> and an [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/myscript.png icon]<ref name="icon">[[Packaging#Displaying an icon in the Application Manager next to your package]]</ref>, the [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/setup.py setup.py] will look like this:
<source lang="python">
from distutils.core import setup

setup(
name='myscript',
version='0.1',
author='Lauro Moura',
author_email='lauro.neto@donotspamme.com',
scripts=['myscript'],
data_files=[('share/applications/hildon', ['myscript.desktop']),
('share/pixmaps', ['myscript.png'])],
)
</source>
A file named [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/stdeb.cfg stdeb.cfg] in the same directory as setup.py is required, with stdeb Maemo-specific options. A detailed list of options can be found in the [http://github.com/astraw/stdeb stdeb website].

[DEFAULT]
XS-Python-Version: 2.5 # Only version currently supported by PyMaemo.
Package:my-script # Binary package name. stdeb adds the prefix "python-" by default
Section: user/development # Section should start with user/ to appear in the menu.
Depends: python-gtk2 # extra dependencies go here

Warning 1: Make sure to use [[Maemo_packaging#Sections|an allowed section]].

Warning 2: The <code>Depends</code> field in stdeb.cfg will be used on your debian/control file, so fill it correctly with all the dependencies of your application - otherwise it will break when you try to install it. For instance, [http://gitorious.org/twcano/twcano twcano] depends on the following packages: <code>python-simplejson, pyside-qt4-maemo5, pyside-qt4-webkit and python-twitter</code>, so the <code>Depends</code> field should be filled this way:

Depends: python-simplejson, pyside-qt4-maemo5, pyside-qt4-webkit, python-twitter

== Building the packages ==

The basic command is

python setup.py --command-packages=stdeb.command bdist_deb

It'll create a folder called deb_dist with the source and binary packages. Alternatively, the "sdist_dsc" command will create only the source package.

After generating, you can copy the package to your device and install it (requires an [[SSH]] server):

$ scp myscript_0.1-1_all.deb root@<n900 ip>:/root
$ ssh root@<n900 ip>
# dpkg -i myscript_0.1-1_all.deb

== Building a basic debian directory ==

Another useful command is ''debianize''. It will read the configuration file and write a directory named debian in the same directory. This can be used for manually creating the packages using dpkg tools directly. For a detailed usage example see the [http://github.com/astraw/stdeb#debianize-distutils-command steb website].

Note: sdist_dsc and bdist_deb do '''not''' use this directory, generating a new one in the source dir under deb_dist/.

== Uploading to extras ==

To upload to extras, use the debianize command and then call dpkg-buildpackage:

$ dpkg-buildpackage -rfakeroot -uc -us -S

This command will create the .dsc, .tar.gz and .changes files that can be used to [[uploading to Extras-devel|upload the application to extras-devel]].

== Support for non-Debian systems ==

'''DRAFT DRAFT DRAFT DRAFT DRAFT'''

{{ambox
| type = notice
| image=
| text = Keep in mind that the support for non-Debian systems is '''experimental''': it is not as funcional as the stdeb approach shown above and
may change without notice. }}

If you're using a distro not based on Debian, you can still create source packages for uploading to extras-devel, but won't be able to create binary packages (.deb).

For doing this, you will need the sdist_deb module available [http://gitorious.org/pymaemo/sboxless here]; just clone it in some directory and point the PYTHONPATH environment variable there.

For using it, first include the module in your setup.py:

try:
from sdist_deb import sdist_deb
except ImportError:
from distutils.core import Command
class sdist_deb(Command):
pass

The try/except statement and the dummy class are needed so the package won't break when built on the extras-devel autobuilder.

Add a new cmdclass to your setup.py, or update the existing one:

cmdclass={'sdist_deb': sdist_deb}

or

cmdclass={'command1': command1,
'command2': command1,
(...)
'sdist_deb': sdist_deb}

Now just use the new command to build the sources:

PYTHONPATH=/path/to/sdist_deb python setup.py sdist_deb

The source files will be generated on the ./dist directory.

== References ==

<references />

[[Category:Python]]
[[Category:Packaging]]

PyMaemo/Scratchboxless packaging guide

2010-07-07T20:45:41Z

189.115.161.248:

== Introduction ==

The usual way of developing Maemo applications is using either Scratchbox or [[MADDE]], which are quite heavy for Python development. An alternative is using [http://github.com/astraw/stdeb stdeb], a set of extensions to distutils that allows generating Debian packages, both binary and source, that can be installed on the device or sent to the [[extras-devel]] repository.

This tutorial will show how to integrate it into your project, build the packages and upload them to extras-devel.

== Prerequisites ==

This tutorial is aimed at Debian-based systems, as some stdeb commands requires the dpkg tools installed. If you're using another distro, please refer to the section

Also, you should get the [http://github.com/astraw/stdeb git] version of stdeb to use the debianize command, as it is a new addition and not yet available in the repositories. Run the following commands to install it:

# Clone the git repository
git clone http://github.com/astraw/stdeb.git

# Enter source package
cd stdeb

# Build .deb (making use of stdeb package directory in sys.path).
python setup.py --command-packages=stdeb.command bdist_deb

# Install it
sudo dpkg -i deb_dist/python-stdeb_0.5.1+git-1_all.deb

As only python2.5 is supported in pymaemo, it should be installed if you want to create binary packages. On Ubuntu Lucid (10.04), you can install it from [https://launchpad.net/~fkrull/+archive/deadsnakes this ppa], following the instructions [http://www.codigomanso.com/en/2010/05/google-app-engine-en--10-4-lucid-lynx/ here].

== Preparing the package ==

As stdeb extends distutils, it is necessary that you have a working setup.py script. For our example application, which consists of a [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/myscript single script] named "myscript" and support files like [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/myscript.desktop .desktop]<ref name="desktop">[[Desktop file format]]</ref> and an [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/myscript.png icon]<ref name="icon">[[Packaging#Displaying an icon in the Application Manager next to your package]]</ref>, the [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/setup.py setup.py] will look like this:
<source lang="python">
from distutils.core import setup

setup(
name='myscript',
version='0.1',
author='Lauro Moura',
author_email='lauro.neto@donotspamme.com',
scripts=['myscript'],
data_files=[('share/applications/hildon', ['myscript.desktop']),
('share/pixmaps', ['myscript.png'])],
)
</source>
A file named [http://pymaemo.garage.maemo.org/stdeb_example/myscript-app/stdeb.cfg stdeb.cfg] in the same directory as setup.py is required, with stdeb Maemo-specific options. A detailed list of options can be found in the [http://github.com/astraw/stdeb stdeb website].

[DEFAULT]
XS-Python-Version: 2.5 # Only version currently supported by PyMaemo.
Package:my-script # Binary package name. stdeb adds the prefix "python-" by default
Section: user/development # Section should start with user/ to appear in the menu.
Depends: python-gtk2 # extra dependencies go here

Warning 1: Make sure to use [[Maemo_packaging#Sections|an allowed section]].

Warning 2: The <code>Depends</code> field in stdeb.cfg will be used on your debian/control file, so fill it correctly with all the dependencies of your application - otherwise it will break when you try to install it. For instance, [http://gitorious.org/twcano/twcano twcano] depends on the following packages: <code>python-simplejson, pyside-qt4-maemo5, pyside-qt4-webkit and python-twitter</code>, so the <code>Depends</code> field should be filled this way:

Depends: python-simplejson, pyside-qt4-maemo5, pyside-qt4-webkit, python-twitter

== Building the packages ==

The basic command is

python setup.py --command-packages=stdeb.command bdist_deb

It'll create a folder called deb_dist with the source and binary packages. Alternatively, the "sdist_dsc" command will create only the source package.

After generating, you can copy the package to your device and install it (requires an [[SSH]] server):

$ scp myscript_0.1-1_all.deb root@<n900 ip>:/root
$ ssh root@<n900 ip>
# dpkg -i myscript_0.1-1_all.deb

== Building a basic debian directory ==

Another useful command is ''debianize''. It will read the configuration file and write a directory named debian in the same directory. This can be used for manually creating the packages using dpkg tools directly. For a detailed usage example see the [http://github.com/astraw/stdeb#debianize-distutils-command steb website].

Note: sdist_dsc and bdist_deb do '''not''' use this directory, generating a new one in the source dir under deb_dist/.

== Uploading to extras ==

To upload to extras, use the debianize command and then call dpkg-buildpackage:

$ dpkg-buildpackage -rfakeroot -uc -us -S

This command will create the .dsc, .tar.gz and .changes files that can be used to [[uploading to Extras-devel|upload the application to extras-devel]].

== Support for non-Debian systems ==

'''DRAFT DRAFT DRAFT DRAFT DRAFT'''

If you're using a distro not based on Debian, you can still create source packages for uploading to extras-devel, but won't be able to create binary packages (.deb).

For doing this, you will need the sdist_deb module available [http://gitorious.org/pymaemo/sboxless here]; just clone it in some directory and point the PYTHONPATH environment variable there.

For using it, first include the module in your setup.py:

try:
from sdist_deb import sdist_deb
except ValueError:
from distutils.core import Command
class sdist_deb(Command):
pass

The try/except statement and the dummy class are needed so the package won't break when built on the extras-devel autobuilder.

Add a new cmdclass to your setup.py, or update the existing one:

cmdclass={'sdist_deb': sdist_deb}

or

cmdclass={'command1': command1,
'command2': command1,
(...)
'sdist_deb': sdist_deb}

Now just use the new command to build the sources:

PYTHONPATH=/path/to/sdist_deb python setup.py sdist_deb

The source files will be generated on the ./dist directory.

== References ==

<references />

[[Category:Python]]
[[Category:Packaging]]

PyMaemo/Scratchboxless packaging guide

2010-06-11T15:05:11Z

189.115.161.248: initial page.

= Introduction =

The usual way of developing Maemo applications is using or Scratchbox or MADDE, which are quite heavy for Python development. An alternative is using stdeb, a set of extensions to distutils that allows generating debian packages, both binary and source, that can be installed on the device or sent to the extra-devel repository.

This tutorial will show how to integrate it into your project, building the packages and uploading it to extras-devel.

= Prerequisites =

= Building a binary package =

= Building a souce package =

= Uploading to extras =

= Future work =

Support for non-debian systems.

PyMaemo

2010-06-11T13:41:21Z

189.115.161.248: /* Documentation */ adding link to sboxless packaging.

== What is PyMaemo? ==

The [http://pymaemo.garage.maemo.org/ PyMaemo] (Python for Maemo) project maintains a set of packages necessary to run and develop Python applications on the Maemo platform.

== Supported Software ==

We currently maintain support for the python interpreter, bindings and a few applications in the Maemo platform. A detailed list can be found in [[PyMaemo/Components]].

== Screenshots ==

[[PyMaemo/Screenshots]]

== Software written using PyMaemo ==

See [[PyMaemo/Statistics]] for a list and some related graphs.

== Documentation ==

* [[/Quick start guide | Quick Start Guide for N900]]
* [[/GUI toolkit selection guide|GUI Toolkit Selection Guide]]
* [[/Components|List of PyMaemo components]]
* [[/How to build|How to build PyMaemo packages]]

=== Tutorials ===

* [[/Scratchboxless packaging guide | Scratchboxless packaging guide]]
* [[/UI tutorial | python-hildon Tutorial]]
* [[/Using Location API | Using Location API]]
* [[/Accessing APIs without Python bindings | Accessing APIs without Python bindings]]
* Easy packaging with [[py2deb]] or [[PyPackager]]
* [http://www.themaemo.com/python-for-newbies/ Python Tutorial for Newbies] with a special emphasis on Maemo
* [[/Portrait mode|Python auto-rotation (Portrait mode) on Maemo 5]]
* [[/Performance|Python and Performance]]

==== mikec's "30 minutes" series ====
* [http://talk.maemo.org/showthread.php?t=39879 Qt4 Designer and Python in 30Min]
* [http://talk.maemo.org/showthread.php?t=43663 Qt Designer/Python for Windows XP in 30 Mins]
* [[Customising Qt look and feel and Python in 30 Mins]]

=== Examples ===

* [http://pymaemo.garage.maemo.org/conic.html python-conic examples]
* [http://git.gnome.org/browse/gnome-python/tree/examples/gconf python-gconf examples]
* [[/Python-osso examples | python-osso examples]]
* [[/Phone call and SMS examples | Phone call and SMS examples]]
* [http://www.paraiso.dk/pymaemosms.txt Sending SMS using python-dbus]
* [http://www.paraiso.dk/incomingsms.txt Listening to incoming SMS]
* [http://talk.maemo.org/showpost.php?p=577316&postcount=9 PyQt Stacked Windows]
* [http://wiki.maemo.org/DbusScripts python Dbus tricks]
example]

=== Manuals and References ===

* [http://pymaemo.garage.maemo.org/python_hildon_manual/ python-hildon manual]
* [http://pymaemo.garage.maemo.org/python_location_manual/ python-location manual]

=== In progress documentation ===

This section contains links to documentation that is still being written.

* [[/Python 2.6 porting guide|Python 2.6 porting guide]]

=== Ye Olde Documentation ===

This section contains documentation that hasn't been updated to Maemo 5 (Fremantle) era.

* [[PyMaemo/Using Python in Maemo|Using Python in Maemo]]
* [http://maemo.org/development/documentation/apis/3-x/python-maemo-3.x/ API Documentation (Maemo 3.x Bora)]
* [http://www.teemuharju.net/2006/01/26/coding-for-nokia-770-using-python-part-1/ Coding for Nokia 770 using Python part 1]
* [http://www.teemuharju.net/2006/02/08/coding-for-nokia-770-using-python-part-2/ Coding for Nokia 770 using Python part 2]
* [http://my.opera.com/monroe/blog/pymaemo-tips Jason's useful tips for PyMaemo development]
* [http://pycage.blogspot.com/2007/12/tablet-python-1-relocatable-software.html Martin's useful tips for PyMaemo development]
* [[PyMaemo/Python-GPSbt|python-gpsbt introduction and example (only applicable to Maemo 4.x)]]
* [http://therning.org/magnus/archives/57 GConf in Python]
* [http://pymaemo.garage.maemo.org/abook.html python-abook examples] (Chinook and earlier)

==== Using it ====

* [[PyMaemo/Installation]]
* [[PyMaemo/Manual installation]]
* [[PyMaemo/SDK installation]]
* [[PyMaemo/FAQ]]

[[Category:Python]]