Puritan/Instructions

From OLPC
< Puritan
Revision as of 22:45, 15 December 2008 by 18.85.47.72 (talk)
Jump to navigation Jump to search

To use Puritan, you need to install dependencies and to check out and run a 'ui' and a 'compilation'.

 # NB: mock >= 0.9.7 is needed.
 # debian:
 sudo apt-get install mock git-core
 # fedora:
 sudo yum install mock git-core
 
 (git clone git://dev.laptop.org/users/mstone/puritan compilation; cd compilation; git checkout -b 767-$USER origin/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:
 # sudo usermod -a -G mock $USER && newgrp mock  # add yourself to the mock group: 
 # 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.