Puritan: Difference between revisions

From OLPC
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 7: Line 7:




===== On Fedora =====
===== Fedora Instructions =====


The Puritan UI is invoked by installing a [http://dev.laptop.org/~mstone/releases/RPMS/ puritan rpm] (built from the [http://dev.laptop.org/git?p=users/mstone/puritan;a=shortlog;h=ui ui branch])
The Puritan UI is invoked by installing a [http://dev.laptop.org/~mstone/releases/RPMS/ puritan rpm] (built from the [http://dev.laptop.org/git?p=users/mstone/puritan;a=shortlog;h=ui ui branch])
Line 27: Line 27:




===== On Debian =====
===== Debian Instructions =====


''Note: yum seems to be broken on Debian at the moment, which is preventing this recipe from working. :('' --[[User:Mstone|Michael Stone]] 03:02, 7 March 2008 (EST)
''Note: yum seems to be broken on Debian at the moment, which is preventing this recipe from working. :('' --[[User:Mstone|Michael Stone]] 03:02, 7 March 2008 (EST)

Revision as of 19:38, 26 May 2008

Puritan

Source code. README. Latest version: 0.4.

Puritan is a disk-image compiler which converts source material including packages, activities, and hacks into installable disk images. It consists of two pieces: a UI and a family of compilations (example). The compilations are simple Python programs which populate a filesystem with the materials you supply, then wrap it up with a bow-tie. The UI runs the compilations in a controlled environment created by Mock and configured according to the compilation's bootstrap and dependencies files.


Fedora Instructions

The Puritan UI is invoked by installing a puritan rpm (built from the ui branch)

 wget -O puritan.rpm http://dev.laptop.org/~mstone/releases/RPMS/puritan-0.4-1.olpc2.noarch.rpm
 sudo rpm -Uvh puritan.rpm

then by checking out a 'puritan compilation' to be run by /usr/bin/puritan

 $(git clone git://dev.laptop.org/users/mstone/puritan compilation; cd compilation; git checkout origin/devel_jffs2)
 puritan -v ./compilation HEAD ./results build

If you want to download a set of RPMs for post-processing (for example, because you want to layer a risky feature on top of them), you can also run

 puritan -v ./compilation HEAD ./results download

Your results should appear in ./results.


Debian Instructions

Note: yum seems to be broken on Debian at the moment, which is preventing this recipe from working. :( --Michael Stone 03:02, 7 March 2008 (EST)

 sudo apt-get install mock git-core
 sudo usermod -a -G mock $USERNAME
 git clone git://dev.laptop.org/users/mstone/puritan ui
 $(git clone git://dev.laptop.org/users/mstone/puritan compilation; cd compilation; git checkout origin/devel_jffs2)
 /usr/bin/python2.5 ui/puritan/main.py ./compilation HEAD ./results


Help Out

Finally, please help improve puritan by

  • making puritan work on your platform - it's only dependencies are python2.5, git-core, and mock!
  • maintaining the devel_ext3 compilation
  • adding some reasonable package or buildroot caching system so that it runs faster without impairing build repeatability
  • improving the UI with commands for manipulating compilations, or for diffing builds, or for profiling compilations, or ...