collectiveidea / tinder fork watch download tarball
public
Forks16Right
Watchers48Right
Description: Tinder is an Ruby API for interfacing with Campfire, the 37Signals chat application.
Homepage: http://tinder.rubyforge.org/
Clone URL: git://github.com/collectiveidea/tinder.git
Click here to lend your support to: tinder and make a donation at www.pledgie.com !
tinder /
name age
history
message
file .gitignore Thu Mar 06 23:34:14 -0800 2008 added .gitignore [brandon]
file CHANGELOG.txt Thu Jan 29 05:27:28 -0800 2009 Fix attribution in changelog [brandon]
file Manifest.txt Wed Jan 28 18:47:39 -0800 2009 Preparing for release 1.2.0 release and fix ver... [brandon]
file README.txt Sat Sep 06 08:10:03 -0700 2008 Added room access with guest URL [elliterate]
file Rakefile Wed Jan 28 18:16:43 -0800 2009 Cleaned up file upload code and added dep on mi... [brandon]
file init.rb Tue Jan 23 16:20:48 -0800 2007 moved stuff around added contributions from Ter... [brandon]
directory lib/ Wed Jan 28 18:47:39 -0800 2009 Preparing for release 1.2.0 release and fix ver... [brandon]
directory site/ Thu Oct 23 12:08:20 -0700 2008 update rubyforge styles [brandon]
directory spec/ Tue Dec 09 22:24:51 -0800 2008 Finding rooms by name, even when full. With te... [queso]
directory test/ Fri Apr 25 14:32:16 -0700 2008 Added a get request to login method to check if... [jjones] 
= Tinder - get the Campfire started

Tinder is a library for interfacing with Campfire, the chat application from 37Signals. Unlike Marshmallow, it is 
designed to be a full-featured API (since 37Signals doesn't provide a real one), allowing you to programatically manage 
and speak/listen in chat rooms.

== Usage

  campfire = Campfire.new 'mysubdomain'
  campfire.login 'myemail@example.com', 'mypassword'

  room = campfire.create_room 'New Room', 'My new campfire room to test tinder'
  room.rename 'New Room Name'
  room.speak 'Hello world!'
  room.paste "my pasted\ncode"
  room.destroy

  room = campfire.find_room_by_guest_hash 'abc123', 'John Doe'
  room.speak 'Hello world!'
  
  See the RDoc for more details.

== Requirements

* Active Support
  gem install activesupport
* Hpricot
  gem install hpricot
  
== Installation

Tinder can be installed as a gem or a Rails plugin:

  gem install tinder
  
  script/plugin install http://source.collectiveidea.com/public/tinder/trunk
  
== Development

The source for Tinder is available at http://source.collectiveidea.com/public/tinder/trunk. Development can be followed 
at http://opensoul.org/tags/tinder.  Contributions are welcome!

== ToDo

* Tests! (unit and remote)
* Marshmallow-style integration scripts for exception notification and continuous integration