Turpial is a collaborative project that grows with the effort of developers in Venezuela and all around the world. To be developer or collaborator of Turpial you just need to follow the instructions given below.

1.- Installing the source code

  • First thing you need as a Turpial developer is Git, in order to clone, fetch and push all changes in the code that you and all the rest of the developers do. You can learn all about git in the official git webpage

1.1.- libturpial

Libturpial is the library that handles all the core functions of Turpial and lets you develop any kind of creative things on top of it (Like Turpial ;))

1.1.1.- Installing libturpial

To get a copy of the Turpial repository execute this command in a shell:

$ git clone git://github.com/satanas/libturpial.git libturpial

This will create the <em>libturpial</em> folder with all the application source code. Next, enter the folder with:

$ cd libturpial

And verify that you are in the master branch with:

$ git checkout master

Finally, install libturpial in development mode (as root/superuser) with this sentence:

# python setup.py develop

1.1.2.-.Updating libturpial

When there are changes availables, just execute this sentence to update:

$ git pull origin master

And then reinstall module:

# python setup.py develop

1.2.- Turpial

Once you have installed libturpial you can now install Turpial.

1.2.1.- Installing Turpial

To get a copy of the Turpial repository execute this command in a shell:

$ git clone git://github.com/satanas/Turpial.git turpial

This will create the <em>libturpial</em> folder with all the application source code. Next, enter the folder with:

$ cd turpial

And change to the development branch with:

$ git branch --track development origin/development
$ git checkout development

Finally, install Turpial in development mode (as root/superuser) with this sentence:

# python setup.py develop

1.2.2.- Updating Turpial

When there are changes availables, just execute this sentence to update:

$ git pull origin master

And then reinstall module:

# python setup.py develop

2.- Ok, I installed Turpial. Now what?

To execute Turpial, type in a shell:

turpial

3.- Debug mode, what are you talking about?

Debug mode is the way we say to Turpial that prints a lot of information in the shell. You can activate it just adding the -d parameter:

turpial -d

This information is really useful for developers at the moment of identify fix issues, so keep it in mind