Skip to content
dol-sen edited this page Jun 15, 2012 · 2 revisions

Rough install guide for testing/development purposes.

CoreBuilder is a Django based webapp, for several reasons.

  1. Pkgcore is written in python, so needs a python based webapp to properly connect to it's api.
  2. I mostly code in python.
  3. I have not done webapp programming before. Django offers many advantages for a webapp noob like me by having templates and code for performing a lot of what is needed to run the corebuilder app.

To test run. You will need to either edit CoreBuilder/corebuilder/static/main.html and comment out the line to download the jquery.js code from CoreBuilder/corebuilder/static/javascript/jquery.js and uncomment the line to download it from jquery (need internet access). Or download and save it with a (jquery.js) link to the version you downloaded in that directory.

You will also need jpaq-1.0.6.00003-{mini, full}.js. It apparently is not available as a machine download, so needs a manual download. Save it in corebuilder/static/javascript/ and create a link (jpaq.js) to the version downloaded, also in the javascript directory.

For the backend you will need to get a checkout of porthole [1]. Checkout the dev_api branch. Currently you also need portage and it's under development public_api since not all the backend code has been migrated to use pkgcore yet.

You need to emerge app-portage/portage-public-api-9999. The ebuild is in the gentoo-guis overlay, which can be installed via layman (app-portage/layman).

Create a file [2] which includes the location of the checkout so it can see the pmbackends dir. Edit the CoreBuilder/settings.py file to suit your . Then in a terminal cd into the CoreBuilder dir, source that file, start the test server. I will be creating a separate package for it later once it is a little more established. But for now you will need to update the git checkout from time to time. There is still a bunch of work to do on the backend. Most of the data gathering code is set up and working. There are still a few functions that are using the portage backend since they have not been ported to use pkgcore yet.

So far CoreBuilder is not capable of performing any install/un-install operations.

[1] http://sourceforge.net/scm/?type=git&group_id=96324

[2] My testpath file contents.

[code]

export PATH="/home/brian/Dev/git/portage/bin:/home/brian/Dev/git/layman/bin:/home/brian/Dev2/porthole-dev_api/scripts:${PATH}"

export PYTHONPATH="/home/brian/Dev/git/portage/pym:/home/brian/Dev/git/layman/pym:/home/brian/Dev2/porthole-dev_api:${PYTHONPATH}" [/code]

Clone this wiki locally