Internet Things

===

Firefox Internet Things is a [Django][Django]-based web application... [Django]: http://www.djangoproject.com/

You need Python 2.6. Also, you probably want to run this application in a [virtualenv][virtualenv] environment [virtualenv]: http://pypi.python.org/pypi/virtualenv

To install virtualenv (if you don't have it already):

easy_install virtualenv

And pip (package manager):

easy_install pip

You will also need RabbitMQ which is the backend for the message queue system:

sudo [port|apt-get|yum] install rabbitmq-server

As well as Curl which used to POST to Responsys

sudo [port|apt-get|yum] install curl +ssl

Start RabbitMQ:

sudo rabbitmq-server

Set up a user and vhost:

sudo rabbitmqctl add_user [USER] [PASS]
sudo rabbitmqctl add_vhost [VHOST]
sudo rabbitmqctl set_permissions -p [VHOST] [USER] ".*" ".*" ".*"

Start and activate the virtualenv:

virtualenv --distribute --no-site-packages ./ffenv
source ./ffenv/bin/activate

*** Important note to Mac OSX Snow Leopard users: you need to pass the following flag to the compiler

env ARCHFLAGS="-arch x86_64" pip install pycurl

Prepare your development environment:

pip install -r ff4/requirements/compiled.txt
pip install -r ff4/requirements/dev.txt

Get a username and API key from http://bit.ly/ by signing up and and requesting an API key (http://bit.ly/a/your_api_key)

Now add the settings to settings_local.py (BITLY_USERNAME / BITLY_APIKEY)

Create a database and be sure to note the name then make a copy of settings_local.py.default called settings_local.py and update your database settings and your rabbitmq connection settings

Sync your db:

python ff4/manage.py syncdb

Run the migrations

python ff4/manage.py migrate

Then load the fixtures

python ff4/manage.py loaddata ff4/things/fixtures/*.yaml

Fire up a celery worker:

python ff4/manage.py celeryd --verbosity=2 --loglevel=DEBUG

Start your dev server: python ff4/manage.py runserver

[Jim][Jim] is used for managing the JavaScript in Mozilla Mark Up. More information is available [here][Jim]. [Jim]: https://github.com/quirkey/jim

The image sizes are now set correctly in the fixtures, but if you need to reset their sizes for some reason, there's a custom command that will do it for you.

This must be run from the ff4 directory.

 ./manage.py set_image_sizes