<commit_before>======================================
Testing PyBossa with a Virtual Machine
======================================

`Vagrant`_ is an open source solution that allows you to create and configure 
lightweight, reproducible, and portable development environments.

Vagrant_ simplifies a lot setting up all the requirements for a web application
like PyBossa, as you will set up a virtual machine that *automagically*
downloads all the required libraries and dependencies for developing and
testing the project.

For these reasons, PyBossa uses Vagrant to allow you to start hacking the
system in a very simple way, and more importantly, without polluting your
system with lots of libraries that you may or may not needed (everything is
configured in the Virtual Machine, which is a very safe sand-box!).

Additionally several cloud companies have integration with Vagrant, so
deploying a PyBossa server is really simple using this method.


.. note::

    The virtual machine and server are configured with a **very basic
    security**
    set of rules (passwords, secrets, firewall, etc.). Therefore, *if you are going to
    use this method to deploy a PyBossa production server* **it is your responsibility
    to secure the system properly**.

Setting up PyBossa with Vagrant
===============================

In order to start using Vagrant and PyBossa all you have to do is installing
the following open source software:

#. VirtualBox_ (min version 4.2.10)
#. Vagrant_ (min version 1.2.1)
#. Vagrant Plugin (vagrant-ansible-local)

.. note::
    Vagrant_ and VirtualBox_ works in Windows, GNU/Linux and Mac OS X, so you can try and run
    PyBossa without problems!

First install a Vagrant plugin which helps installing PyBossa in Vagrant::

    $ vagrant plugin install vagrant-ansible-local

.. note::
    This plugin only needs to be installed once. It will not install Ansible or
    any other software on your host PC. It is only a Vagrant plugin which can talk
    to Ansible inside a Vagrant VM.

Then, you can clone the PyBossa git repository (be sure to install git in your
machine!)::

    $ git clone --recursive git://github.com/PyBossa/pybossa.git<commit_msg>replace git ssh address with https. Better for non auth users<commit_after>======================================
Testing PyBossa with a Virtual Machine
======================================

`Vagrant`_ is an open source solution that allows you to create and configure 
lightweight, reproducible, and portable development environments.

Vagrant_ simplifies a lot setting up all the requirements for a web application
like PyBossa, as you will set up a virtual machine that *automagically*
downloads all the required libraries and dependencies for developing and
testing the project.

For these reasons, PyBossa uses Vagrant to allow you to start hacking the
system in a very simple way, and more importantly, without polluting your
system with lots of libraries that you may or may not needed (everything is
configured in the Virtual Machine, which is a very safe sand-box!).

Additionally several cloud companies have integration with Vagrant, so
deploying a PyBossa server is really simple using this method.


.. note::

    The virtual machine and server are configured with a **very basic
    security**
    set of rules (passwords, secrets, firewall, etc.). Therefore, *if you are going to
    use this method to deploy a PyBossa production server* **it is your responsibility
    to secure the system properly**.

Setting up PyBossa with Vagrant
===============================

In order to start using Vagrant and PyBossa all you have to do is installing
the following open source software:

#. VirtualBox_ (min version 4.2.10)
#. Vagrant_ (min version 1.2.1)
#. Vagrant Plugin (vagrant-ansible-local)

.. note::
    Vagrant_ and VirtualBox_ works in Windows, GNU/Linux and Mac OS X, so you can try and run
    PyBossa without problems!

First install a Vagrant plugin which helps installing PyBossa in Vagrant::

    $ vagrant plugin install vagrant-ansible-local

.. note::
    This plugin only needs to be installed once. It will not install Ansible or
    any other software on your host PC. It is only a Vagrant plugin which can talk
    to Ansible inside a Vagrant VM.

Then, you can clone the PyBossa git repository (be sure to install git in your
machine!)::

    $ git clone --recursive https://github.com/PyBossa/pybossa.git
{'fraction_non_alphanumeric': 0.0939612438035151, 'fraction_numerical': 0.0031545741324921135, 'mean_word_length': 4.247044917257683, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 1, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5594606', 'n_tokens_mistral': 1197, 'n_tokens_neox': 1107, 'n_words': 621}