Ambiente Colaborativo para Comunidades
Python HTML Shell Cucumber CSS JavaScript
Latest commit 2ad0992 Jul 27, 2016 @chaws chaws committed on GitHub Merge pull request #148 from colab/detach_super_archives
Detach super archives
Permalink
Failed to load latest commit information.
.tx
colab
docs Merge pull request #188 from colab/update_docs Jun 10, 2016
features
misc
tests
vagrant
.coveragerc
.gitignore
.travis.yml
LICENSE
MANIFEST.in Include super_archives translations in MANIFEST.in Jul 2, 2015
README.rst Adding the process to run acceptance tests to the README Apr 19, 2016
Vagrantfile
diagrama_classes.asta
setup.cfg
setup.py

README.rst

Colab, a Software for Communities

https://travis-ci.org/colab/colab.svg?branch=master https://coveralls.io/repos/colab/colab/badge.png?branch=master

What is Colab?

Application that integrates existing systems to represent the contributions of the members through:

  • The amendments to the Wiki trac system.
  • Changes to the trac system code.
  • Discussions at the mailman list.
  • And other systems in the community.

Features

Installation

First install the dependencies and than the project it self:

pip install -e .

Development environment

You must install vagrant to set up the development environment. With vagrant available you should run:

vagrant up

During the process you should choose the vagrant box that you want to use. In the end you should have a virtual machine with development environment set up.

Running Colab

To run Colab with development server you will have to:

1- Log in virtual machine:

vagrant ssh

2- Use colab virtualenv:

workon colab

3- Run the development server:

colab-admin runserver 0.0.0.0:8000

Now you can access colab in your browser via http://localhost:8000

NOTE: In case you want to keep the configuration file else where just set the desired location in environment variable COLAB_SETTINGS.

About test

How to write a test

Inside of each folder on /vagrant/colab/<folder> you can create a folder called "tests" and inside of it implements the code for test each file. Remember that you should create __init__.py file.

How to run the tests

Follow the steps below:

1- Log in virtual machine:

vagrant ssh

2- Use colab virtualenv:

workon colab

3- Enter into colab source code directory:

cd /vagrant

4- Run tests with setup.py:

python setup.py test

How to run Acceptance Tests

Follow the steps below to run the acceptance tests.

1- Log in virtual machine:

1.1 - To run without opening a graphic interface

vagrant ssh

1.2 - To run opening a graphic interface

vagrant ssh -- -X

2- Use colab virtualenv:

workon colab

3- Enter into colab source code directory:

cd /vagrant

4- Run all the acceptance tests with:

COLAB_SETTINGS=tests/colab_settings.py colab-admin behave

4.1 To run without opening a browser: .. code-block:

COLAB_SETTINGS=tests/colab_settings.py xvfb-run -a colab-admin behave

4.2 To run a specific feature:

COLAB_SETTINGS=tests/colab_settings.py colab-admin behave /path/to/features/file.feature