PyMaemo/Scratchboxless packaging guide - Revision history

189.2.128.130: Fix some typos

2011-03-02T13:46:23Z

Fix some typos

← Older revision		Revision as of 13:46, 2 March 2011
Line 71:		Line 71:
	== Building a basic debian directory ==		== 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].		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 stdeb website].

	Note: sdist_dsc and bdist_deb do '''not''' use this directory, generating a new one in the source dir under deb_dist/.		Note: sdist_dsc and bdist_deb do '''not''' use this directory, generating a new one in the source dir under deb_dist/.
Line 90:		Line 90:
	\| type = notice		\| type = notice
	\| image=		\| 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. }}		\| 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 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).		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).

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

2010-07-09T15:30:10Z

Support for non-Debian systems

← Older revision		Revision as of 15:30, 9 July 2010
Line 90:		Line 90:
	\| type = notice		\| type = notice
	\| image=		\| 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		\| 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. }}
	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).		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).

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

2010-07-09T15:28:20Z

Support for non-Debian systems

← Older revision		Revision as of 15:28, 9 July 2010
Line 86:		Line 86:

	== Support for non-Debian systems ==		== Support for non-Debian systems ==

	~~'''DRAFT DRAFT DRAFT DRAFT DRAFT'''~~

	{{ambox		{{ambox
Line 97:		Line 95:
	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).		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.		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		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
Line 104:		Line 102:
	depends=python-twitter		depends=python-twitter

	If you don't want to add any dependency, just leave the field empty ('depends=').		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:		Now, run the sdist_deb command:

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

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

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

2010-07-08T22:28:47Z

Support for non-Debian systems

← Older revision		Revision as of 22:28, 8 July 2010
Line 94:		Line 94:
	\| 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		\| 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. }}		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).		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 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.

	~~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}~~		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

	or		[control]
			depends=python-twitter

	~~cmdclass={~~'~~command1': command1~~,		If you don't want to add any dependency, just leave the field empty ('depends=').
	'~~command2~~'~~: command1,~~
	~~(..~~.)
	~~'sdist_deb': sdist_deb}~~

	Now ~~just use~~ the ~~new~~ command ~~to build the sources~~:		Now, run the sdist_deb command:

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

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

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

2010-07-08T19:40:40Z

Support for non-Debian systems

← Older revision		Revision as of 19:40, 8 July 2010
Line 104:		Line 104:

	try:		try:
	from sdist_deb import sdist_deb		from sdist_deb import sdist_deb
	except ImportError:		except ImportError:
	from distutils.core import Command		from distutils.core import Command

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

2010-07-08T19:24:54Z

Support for non-Debian systems

← Older revision		Revision as of 19:24, 8 July 2010
Line 88:		Line 88:

	'''DRAFT DRAFT DRAFT DRAFT DRAFT'''		'''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).		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).
Line 97:		Line 105:
	try:		try:
	from sdist_deb import sdist_deb		from sdist_deb import sdist_deb
	except ~~ValueError~~:		except ImportError:
	from distutils.core import Command		from distutils.core import Command
	class sdist_deb(Command):		class sdist_deb(Command):
Line 120:		Line 128:

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


	== References ==		== References ==

189.115.161.248 at 20:45, 7 July 2010

2010-07-07T20:45:41Z

← Older revision		Revision as of 20:45, 7 July 2010
Line 7:		Line 7:
	== Prerequisites ==		== Prerequisites ==

	This tutorial is aimed at Debian-based systems, as some stdeb commands requires the dpkg tools installed.		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:		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:
Line 13:		Line 13:
	# Clone the git repository		# Clone the git repository
	git clone http://github.com/astraw/stdeb.git		git clone http://github.com/astraw/stdeb.git

	# Enter source package		# Enter source package
	cd stdeb		cd stdeb

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

	# Install it		# Install it
	sudo dpkg -i deb_dist/python-stdeb_0.5.1+git-1_all.deb		sudo dpkg -i deb_dist/python-stdeb_0.5.1+git-1_all.deb
Line 83:		Line 83:
	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]].		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]].

	~~== Future work ==~~

	Support for non-Debian systems.
			== 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 ==

imported_>lizardo: /* Introduction */

2010-06-17T19:38:15Z

Introduction

← Older revision		Revision as of 19:38, 17 June 2010
Line 1:		Line 1:
	== Introduction ==		== 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 [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.		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, ~~building~~ the packages and ~~uploading it~~ to extras-devel.		This tutorial will show how to integrate it into your project, build the packages and upload them to extras-devel.

	== Prerequisites ==		== Prerequisites ==

imported_>willer at 14:15, 17 June 2010

2010-06-17T14:15:58Z

← Older revision		Revision as of 14:15, 17 June 2010
Line 45:		Line 45:
	[DEFAULT]		[DEFAULT]
	XS-Python-Version: 2.5 # Only version currently supported by PyMaemo.		XS-Python-Version: 2.5 # Only version currently supported by PyMaemo.
	Package:~~myscript~~ # Binary package name. stdeb adds the prefix "python-" by default		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.		Section: user/development # Section should start with user/ to appear in the menu.
	Depends: python-gtk2 # extra dependencies go here		Depends: python-gtk2 # extra dependencies go here

201.75.7.138: /* Uploading to extras */

2010-06-16T23:15:22Z

Uploading to extras

← Older revision		Revision as of 23:15, 16 June 2010
Line 81:		Line 81:
	$ dpkg-buildpackage -rfakeroot -uc -us -S		$ 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]]		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]].

	== Future work ==		== Future work ==