Morepath Umbrella

This project puts together the Morepath framework with related projects:

• The libraries developed together with Morepath:
  • bowerstatic
  • dectate
  • importscan
  • morepath
  • reg
• The extensions developed and supported within the Morepath organization on GitHub:
  • more.basicauth
  • more.chameleon
  • more.forwarded
  • more.itsdangerous
  • more.jinja2
  • more.jwtauth
  • more.mako
  • more.static
  • more.transaction
  • more.webassets
• The example applications developed and supported within the Morepath organization on GitHub:
  • morepath_batching
  • morepath_cerebral_todomvc
  • morepath_reactredux
  • morepath_rest_dump_load
  • morepath_sqlalchemy
  • morepath_static
  • morepath_wiki

Quickstart

Installation

1. Clone recursively this repository:

   git clone --recursive git@github.com:taschini/morepath-umbrella.git
   cd morepath-umbrella

2. Use Buildout to check out all the project listed above:

   mkdir env
   virtualenv --no-site-packages env/buildout
   ./env/buildout/bin/python bootstrap.py
   ./bin/buildout

3. Create as many virtual environments as the versions of Python you want to use for testing, at least two, one for Python 2.7 and one for Python 3.5:

   virtualenv --no-site-packages -p python2.7 env/py27
   virtualenv --no-site-packages -p python3.5 env/py35

4. Use Pip to install all the dependencies:

   for k in ./env/py*; do $k/bin/pip install -r requirements.txt ; done

Note on the installation on OS X

On some versions of OS X, you might have to ensure that the Cryptography library for Python is linked to a recent version of OpenSSL:

brew install openssl
export CRYPTOGRAPHY_OSX_NO_LINK_FLAGS=1
export LDFLAGS="$(brew --prefix openssl)/lib/libssl.a $(brew --prefix openssl)/lib/libcrypto.a"
export CFLAGS="-I$(brew --prefix openssl)/include"
for k in ./env/py*; do $k/bin/pip install cryptography --no-binary :all:

Common tasks

• Run the tests using one of the virtual environments (say that for Python 3.5):

  ./env/py35/bin/py.test

• Run the tests with coverage statistics:

  ./env/py35/bin/py.test --cov

• Search for text in the projects under the umbrella using Ack:

  ack text `cat ackdirs.txt`

• Check status and branch names of all the projects under the umbrella:

  make status