Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Scaffold buildout for new projects

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 cfgs
Octocat-spinner-32 src
Octocat-spinner-32 templates
Octocat-spinner-32 .gitignore
Octocat-spinner-32 CHANGES.txt
Octocat-spinner-32 README.rst
Octocat-spinner-32 bootstrap.py
Octocat-spinner-32 buildout-utils.py
Octocat-spinner-32 development.cfg
Octocat-spinner-32 production.cfg
README.rst

Documentation

This buildout is meant to be a basis for all future Jarn project buildouts. Anyone, also people not working for Jarn, is free to use this buildout. It is provided as-is without any support or warranty.

Before using this buildout you should read through this document and get to know the practices it encourages.

Ideas

This buildout has a policy distribution by that name included, which in turn contains exactly one Python package by the name policy.

All customer / site specific code, templates, CSS, translations and customizations are done inside that one package.

The buildout and the policy distribution are part of the same Git repository and tagged and deployed together. There's never any releases of the policy distribution.

All reusable functionality is developed in standalone projects, wired in via mr.developer for development. For production these will always get releases to PyPi or dist.jarn.com.

Setup

The production buildout sets up Varnish, haProxy, two Zope instances and ZEO. Varnish is running on 127.0.0.1:8080 and the Plone site id should be Plone.

The development buildout sets up a Zope instance with a direct file storage also running on port 8080.

Bootstrap

To get started do:

python2.6 bootstrap.py -dc development.cfg
bin/buildout -c development.cfg
bin/instance fg

Tests

You can run tests for the policy package using:

bin/test

In order to run coverage tests, use:

bin/coverage
bin/report-html

You can view the coverage results in the htmlcov directory via:

open htmlcov/index.html

I18N

To update the translation files, do:

sh src/policy/policy/rebuild.sh
sh src/policy/policy/sync.sh
Something went wrong with that request. Please try again.