README.md

Help an institution that helps other people. They got a lot of bills to pay and we got a lot of ideas to share.

Setup local environment

• MongoDB is required.

To run locally for development

• Start mongo server $ path/to/mongo/mongod;

• Run the application using the rake task server:run $ rake server:run; This task sets some variables used by the application to access its google drive account and starts the server using shotgun.

  It tries to find the information on ~/.billbo.yml file, and when not found, asks the user for the information, using that to create the file for further usage.

• Go to localhost:9393;

To seed test data

• Run $ rake db:seed to create one single bill for testing
• Run $ rake db:seed[n] to create n bills
• $ rake -T will list all available tasks

To run the tests

• Run $ rake test:unit to run the unit tests
• Run $ rake test:functional to run the functional tests
• Run $ rake test:all to all tests

If you want to deploy on the cloud

I'd recommend using AppFog

• Create an account on AppFog;
• Install Appfog gem af;
• Using your command line shell, go to directory where your forked billbo repository is;
• Login in your Appfog account running $ af login;
• Run $ af push [appname] --runtime ruby193 and follow the instructions to create the app;
• Once it's created, go to AppFog console and install the MongoLab Add-on;
• In the Services tab add a MongoDB service;
• Then run $ af update [appname] and make sure your app restarted;
• If you're allowed to push to the original repository (thoughtworks/billbo), deployment will be automatic after each push and can be checked on billbo.aws.af.cm;

Do you wanna help?

• Check out our Trello board;