Puritan/Instructions

From OLPC
< Puritan
Revision as of 01:10, 16 December 2008 by 18.85.47.72 (talk)
Jump to navigation Jump to search

To use Puritan, you need to install dependencies:

 # NB: mock >= 0.9.7 is needed.
 # debian:
 sudo apt-get install mock git-core
 # fedora:
 sudo yum install mock git-core
 # both
 sudo usermod -a -G mock $USER
 newgrp mock

and to check out and run a 'ui' and a 'compilation'.

 (git clone git://dev.laptop.org/users/mstone/puritan compilation; cd compilation; git branch --track 767 origin/767; git checkout 767)
 git clone git://dev.laptop.org/users/mstone/puritan ui
 python2.5 ui/puritan/main.py   # read help
 sudo python2.5 ui/puritan/main.py -v build ./compilation HEAD ./results 
 # Note: if you encounter permission errors when running this command, you may need to:
 # sudo setenforce 0  # disable selinux:
 # Finally, a word of warning: while _my_ uis and compilations will treat your computer nicely, other people's might not. Caveat emptor.

Some puritan compilations now feature a 'download' operation which can be used to download all packages that the compilation will install for later (offline) use:

 sudo python2.5 ui/puritan/main.py -v download ./compilation HEAD ./results 

and 'interactive' error-handling:

 sudo python2.5 ui/puritan/main.py -v build ./compilation HEAD ./results  -- -i
 # when an error occurs:
 # type 'kwargs' to learn what command failed
 # import os; os.system('/bin/bash') to get a bash shell inside the buildroot for further debugging
 # del kwargs['e']   +   Ctrl-D to resume the compilation
 # Ctrl-D to exit the compilation and clean up.