Skip to content

Latest commit

 

History

History
47 lines (30 loc) · 1.96 KB

README.markdown

File metadata and controls

47 lines (30 loc) · 1.96 KB
Raw

Tag Better

Tag Better is an enhancement over Delicious. We're just trying to make it a little more pleasant to use.

Getting started

Install Passenger:

  1. Install the Passenger gem: $ sudo gem install passenger
  2. Build the Apache module: passenger-install-apache2-module
  3. Add the extra bit to your httpd.conf as specified by Passenger
  4. Install the Passenger Preference Pane: http://www.fngtps.com/passenger-preference-pane

Install CouchDBX:

  1. Download from http://janl.github.com/couchdbx/
  2. Drag into your apps folder
  3. Start it up

Install Nokogiri (for parsing XML):

  1. Update libxml and friends: sudo port install libxml2 libxslt
  2. Install nokogiri: sudo gem install nokogiri -- --with-xml2-include=/opt/local/include/libxml2 --with-xml2-lib=/opt/local/lib --with-xslt-dir=/opt/local

Install dependencies:

  1. sudo gem install json rest-client sinatra

Run the application:

  1. Go to the Passenger preference pane in System Preferences
  2. Add the folder you checked Tag Better out to your apps

Hacking

In general:

  • Assets are served out of public. Anything within that directory is served from the root of the web app.
  • If you need to modify the application code, you'll want to touch tmp/always_restart.txt. This tells Passenger to restart the application on every request. You may notice a slight performance hit in doing so.
  • Run a console in the app environment: irb -Ilib -rubygems -rtag_better. You'll need to call TagBetter.init if you want to poke around in the database models.
  • To run tests, create test/config as described in test/test.sh and run ./test/test.sh from the project root.

Testing via Curl:

  • Login: curl -i -c tmp/cookies.txt -d username='USERNAME' -d password='PASSWORD' 'http://tagbetter.local/login'
  • Fetch bundles: curl -b tmp/cookies.txt -H 'Accept: application/json' http://tagbetter.local/USERNAME/bundles
  • Fetch tags: curl -b tmp/cookies.txt -H 'Accept: application/json' http://tagbetter.local/USERNAME/tags