Barkeep is a fast, fun way to review code. Engineering organizations can use it to keep the bar high.
More details coming soon!
Setting up Barkeep for development
This is how it works on our Mac OS dev laptops; YMMV:
$ easy_install pip $ pip install pygments $ gem install bundler $ bundle install $ port install nodejs # or brew install node # Note: you may need to "port deactivate c-ares" before installing nodejs $ curl http://npmjs.org/install.sh | sh # install npm $ npm install less $ mysqladmin5 -u root create barkeep # create the 'barkeep' database $ ruby run_migrations.rb # db migrations
If you're running a Mac using Macports with rvm, ensure your ruby is compiled against the macports openssl library. Otherwise you will get segfaults when sending emails over SSL:
$ rvm install 1.9.2 --with-openssl-dir=/opt/local
Running Barkeep Locally
Make sure you're up to date on Ruby gems (
bundle install) and on migrations (
$ bin/rerun.sh # run the server # navigate to localhost:4567
These are somewhat optional services to run while developing. These background jobs periodically fetch new commits, pre-generate commit diffs, and send emails when comments are posted.
$ redis-server # run Redis $ rake clockwork:start # start running periodic cron jobs $ rake resque:start # start processing any jobs which get added to the Resque queue.
You can view the Resque dashboard and inspect failed Resque jobs by navigating to http://localhost:4567/resque.
Once Barkeep is set up for development, look in
config/environment.rb. By default, Barkeep will look in
~/barkeep_repos/, though you can change the
REPOS_ROOT variable to adjust it.
Create the directory and use normal
git clone to add repositories. Now Barkeep can see them!
You probably shouldn't point Barkeep at your own checkouts, because it will take some time to import lots of commits and your dev database will be huge. Additionally, although Barkeep should never make any changes (branch changes or new commits), it will fetch a lot in your repositories which may be confusing (you'll be behind on tracking branches a lot). Instead, clone a few small repositories into the barkeep repos directory.
These packages will need to be installed on a linux server before a deploy will work.
apt-get the following:
mysql-server mysql-client libmysqlclient-dev sqlite3 libsqlite3-dev openssl libopenssl-ruby libssl-dev python-setuptools redis-server
Setting up email
Set the email address and password of the Gmail account you want to use with Barkeep in
Note that emails for new commits are sent from email@example.com and comments are sent from firstname.lastname@example.org. By default, Gmail won't allow your account to send from these addresses without explicitly allowing them. Enabling this is easy -- log in to the Gmail account you're going to use with Barkeep and add these two addresses in Settings > Accounts and Import > Send Mail As.
Barkeep was written by the following Ooyala engineers:
- Bo Chen (bo-chen)
- Phil Crosby (philc)
- Kevin Le (bkad)
- Daniel MacDougall (dmacdougall)
- Caleb Spare (cespare)
and with contributions from:
Barkeep is released under the MIT license.