sj-tinder 1.9.3

data/lib/tinder/room.rb

@@ -0,0 +1,307 @@
+# encoding: UTF-8
+require 'time'
+
+module Tinder
+  # A campfire room
+  class Room
+    attr_reader :id, :name
+
+    def initialize(connection, attributes = {})
+      @connection = connection
+      @id = attributes['id']
+      @name = attributes['name']
+      @loaded = false
+    end
+
+    # Join the room
+    # POST /room/#{id}/join.xml
+    # For whatever reason, #join() and #leave() are still xml endpoints
+    # whereas elsewhere in this API we're assuming json :\
+    def join
+      post 'join', 'xml'
+    end
+
+    # Leave a room
+    # POST /room/#{id}/leave.xml
+    def leave
+      post 'leave', 'xml'
+      stop_listening
+    end
+
+    # Get the url for guest access
+    def guest_url
+      "#{@connection.uri}/#{guest_invite_code}" if guest_access_enabled?
+    end
+
+    def guest_access_enabled?
+      load
+      @open_to_guests ? true : false
+    end
+
+    # The invite code use for guest
+    def guest_invite_code
+      load
+      @active_token_value
+    end
+
+    # Change the name of the room
+    def name=(name)
+      update :name => name
+    end
+    alias_method :rename, :name=
+
+    # Change the topic
+    def topic=(topic)
+      update :topic => topic
+    end
+
+    def update(attrs)
+      connection.put("/room/#{@id}.json", {:room => attrs})
+    end
+
+    # Get the current topic
+    def topic
+      reload!
+      @topic
+    end
+
+    # Lock the room to prevent new users from entering and to disable logging
+    def lock
+      post 'lock'
+    end
+
+    # Unlock the room
+    def unlock
+      post 'unlock'
+    end
+
+    # Post a new message to the chat room
+    def speak(message, options = {})
+      send_message(message)
+    end
+
+    def paste(message)
+      send_message(message, 'PasteMessage')
+    end
+
+    def play(sound)
+      send_message(sound, 'SoundMessage')
+    end
+
+    def tweet(url)
+      send_message(url, 'TweetMessage')
+    end
+
+    # Get the list of users currently chatting for this room
+    def users
+      @users ||= current_users
+    end
+
+    def current_users
+      reload!
+      @current_users
+    end
+
+    # return the user with the given id; if it isn't in our room cache,
+    # do a request to get it
+    def user(id)
+      if id
+        cached_user = users.detect {|u| u[:id] == id }
+        user = cached_user || fetch_user(id)
+        self.users << user
+        user
+      end
+    end
+
+    # Perform a request for the user with the given ID
+    def fetch_user(id)
+      user_data = connection.get("/users/#{id}.json")
+      user = user_data && user_data[:user]
+      user[:created_at] = Time.parse(user[:created_at])
+      user
+    end
+
+    # Modifies a hash representation of a Campfire message.  Expands +:user_id+
+    # to a full hash at +:user+, generates Timestamp from +:created_at+.
+    #
+    # Full returned hash:
+    # * +:body+: the body of the message
+    # * +:user+: Campfire user, which is itself a hash, of:
+    #   * +:id+: User id
+    #   * +:name+: User name
+    #   * +:email_address+: Email address
+    #   * +:admin+: Boolean admin flag
+    #   * +:created_at+: User creation timestamp
+    #   * +:type+: User type (e.g. Member)
+    # * +:id+: Campfire message id
+    # * +:type+: Campfire message type
+    # * +:room_id+: Campfire room id
+    # * +:created_at+: Message creation timestamp
+    def parse_message(message)
+      message[:user] = user(message.delete(:user_id))
+      message[:created_at] = Time.parse(message[:created_at])
+      message
+    end
+
+    # Listen for new messages in the room, parsing them with #parse_message
+    # and then yielding them to the provided block as they arrive.
+    #
+    #   room.listen do |m|
+    #     room.speak "Go away!" if m[:body] =~ /Java/i
+    #   end
+    def listen(options = {})
+      raise ArgumentError, "no block provided" unless block_given?
+
+      Tinder.logger.info "Joining #{@name}…"
+      join # you have to be in the room to listen
+
+      require 'json'
+      require 'hashie'
+      require 'multi_json'
+      require 'twitter/json_stream'
+
+      auth = connection.basic_auth_settings
+      options = {
+        :host => "streaming.#{Connection::HOST}",
+        :path => room_url_for('live'),
+        :auth => "#{auth[:username]}:#{auth[:password]}",
+        :timeout => 6,
+        :ssl => connection.options[:ssl]
+      }.merge(options)
+
+      Tinder.logger.info "Starting EventMachine server…"
+      EventMachine::run do
+        @stream = Twitter::JSONStream.connect(options)
+        Tinder.logger.info "Listening to #{@name}…"
+        @stream.each_item do |message|
+          message = Hashie::Mash.new(MultiJson.decode(message))
+          message = parse_message(message)
+          yield(message)
+        end
+
+        @stream.on_error do |message|
+          raise ListenFailed.new("got an error! #{message.inspect}!")
+        end
+
+        @stream.on_max_reconnects do |timeout, retries|
+          raise ListenFailed.new("Tried #{retries} times to connect. Got disconnected from #{@name}!")
+        end
+
+        # if we really get disconnected
+        raise ListenFailed.new("got disconnected from #{@name}!") if !EventMachine.reactor_running?
+      end
+    end
+
+    def listening?
+      @stream != nil
+    end
+
+    def stop_listening
+      return unless listening?
+
+      Tinder.logger.info "Stopped listening to #{@name}…"
+      @stream.stop
+      @stream = nil
+    end
+
+    # Get the transcript for the given date (returns an array of messages parsed
+    # via #parse_message, see #parse_message for format of returned message)
+    #
+    def transcript(transcript_date = Date.today)
+      unless transcript_date.is_a?(Date)
+        transcript_date = transcript_date.to_date
+      end
+      url = "/room/#{@id}/transcript/#{transcript_date.strftime('%Y/%m/%d')}.json"
+      connection.get(url)['messages'].map do |message|
+        parse_message(message)
+      end
+    end
+
+    # Search transcripts for the given term (returns an array of messages parsed
+    # via #parse_message, see #parse_message for format of returned message)
+    #
+    def search(term)
+      encoded_term = URI.encode(term)
+
+      room_messages = connection.get("/search/#{encoded_term}.json")["messages"].select do |message|
+        message[:room_id] == id
+      end
+
+      room_messages.map do |message|
+        parse_message(message)
+      end
+    end
+
+    def upload(file, content_type = nil, filename = nil)
+      require 'mime/types'
+      content_type ||= MIME::Types.type_for(filename || file)
+      raw_post(:uploads, { :upload => Faraday::UploadIO.new(file, content_type, filename) })
+    end
+
+    # Get the list of latest files for this room
+    def files(count = 5)
+      get(:uploads)['uploads'].map { |u| u['full_url'] }
+    end
+
+    # Get a list of recent messages
+    # Accepts a hash for options:
+    # * +:limit+: Restrict the number of messages returned
+    # * +:since_message_id+: Get messages created after the specified message id
+    def recent(options = {})
+      options = { :limit => 10, :since_message_id => nil }.merge(options)
+      # Build url manually, faraday has to be 8.0 to do this
+      url = "#{room_url_for(:recent)}?limit=#{options[:limit]}&since_message_id=#{options[:since_message_id]}"
+
+      connection.get(url)['messages'].map do |msg|
+        parse_message(msg)
+      end
+    end
+
+  protected
+
+    def load
+      reload! unless @loaded
+    end
+
+    def reload!
+      attributes = connection.get("/room/#{@id}.json")['room']
+
+      @id = attributes['id']
+      @name = attributes['name']
+      @topic = attributes['topic']
+      @full = attributes['full']
+      @open_to_guests = attributes['open_to_guests']
+      @active_token_value = attributes['active_token_value']
+      @current_users = attributes['users'].map do |user|
+        user[:created_at] = Time.parse(user[:created_at])
+        user
+      end
+
+      @loaded = true
+    end
+
+    def send_message(message, type = 'TextMessage')
+      post 'speak', {:message => {:body => message, :type => type}}
+    end
+
+    def get(action)
+      connection.get(room_url_for(action))
+    end
+
+    def post(action, body = nil)
+      connection.post(room_url_for(action), body)
+    end
+
+    def raw_post(action, body = nil)
+      connection.raw_post(room_url_for(action), body)
+    end
+
+    def room_url_for(action, format="json")
+      "/room/#{@id}/#{action}.#{format}"
+    end
+
+    def connection
+      @connection
+    end
+  end
+end

data/lib/tinder/version.rb

@@ -0,0 +1,4 @@
+# encoding: UTF-8
+module Tinder
+  VERSION = '1.9.3' unless defined?(::Tinder::VERSION)
+end

data/site/index.html

@@ -0,0 +1,101 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+	<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+	<title>Tinder</title>
+	<link rel="stylesheet" type="text/css" href="http://opensoul.org/stylesheets/code.css" />
+	<link rel="stylesheet" type="text/css" href="stylesheets/style.css" />
+    <link href="http://opensoul.org/stylesheets/ci.css" rel="stylesheet" type="text/css" />
+    <script src="http://opensoul.org/javascripts/code_highlighter.js" type="text/javascript"></script>
+    <script src="http://opensoul.org/javascripts/ruby.js" type="text/javascript"></script>
+</head>
+
+<body>
+<div id="collectiveidea">
+    <a href="http://collectiveidea.com"><img src="http://opensoul.org/images/header_logo.gif" alt="Collective Idea" class="logo" width="17" height="22" /></a>
+    <ul class="links">
+        <li><a href="http://daniel.collectiveidea.com/blog">Daniel</a></li>
+        <li><a href="http://opensoul.org">Brandon</a></li>
+        <li class="name"><a href="http://collectiveidea.com"><img src="http://opensoul.org/images/header_collectiveidea.gif" alt="Collective Idea" width="123" height="21" /></a></li>
+    </ul>
+</div>
+<div id="main">
+    <div id="header">
+        <h1><a href="/">Tinder</a></h1>
+        <p>Getting the campfire started</p>
+        <ul id="nav">
+            <li><a href="tinder">API Docs</a></li>
+            <li><a href="http://rubyforge.org/projects/tinder">RubyForge</a></li>
+            <li><a href="http://opensoul.org/tags/tinder">Blog</a></li>
+        </ul>
+    </div>
+    <div id="content">
+        <p>Tinder is an API for interfacing with <a href="http://campfirenow.com">Campfire</a>, the 37Signals chat application.</p>
+        <h2>Example</h2>
+
+        <pre><code class="ruby">campfire = Tinder::Campfire.new 'mysubdomain'
+campfire.login 'myemail@example.com', 'mypassword'</code></pre>
+
+<h3>Create, find and destroy rooms</h3>
+<pre><code class="ruby">room = campfire.create_room 'New Room', 'My new campfire room to test tinder'
+room = campfire.find_room_by_name 'Other Room'
+room.destroy</code></pre>
+
+<h3>Speak and Paste</h3>
+<pre><code class="ruby">room.speak 'Hello world!'
+room.paste File.read(&quot;path/to/your/file.txt&quot;)</code></pre>
+
+<h3>Listening</h3>
+<pre><code class="ruby">room.listen
+#=&gt; [{:person=&gt;&quot;Brandon&quot;, :message=&gt;&quot;I'm getting very sleepy&quot;, :user_id=&gt;&quot;148583&quot;, :id=&gt;&quot;16434003&quot;}]
+
+# or in block form
+room.listen do |m|
+  room.speak 'Welcome!' if m[:message] == /hello/
+end</code></pre>
+
+<h3>Guest Access</h3>
+<pre><code class="ruby">room.toggle_guest_access
+room.guest_url         #=> http://mysubdomain.campfirenow.com/11111
+room.guest_invite_code #=> 11111</code></pre>
+
+<h3>Change the name and topic</h3>
+<pre><code class="ruby">room.name = 'Tinder Demo'
+room.topic = 'Showing how to change the room name and topic with tinder…'</code></pre>
+
+<h3>Users</h3>
+<pre><code class="ruby">room.users
+campfire.users # users in all rooms</code></pre>
+
+<h3>Transcripts</h3>
+<pre><code class="ruby">transcript = room.transcript(room.available_transcripts.first)
+#=&gt; [{:message=&gt;&quot;foobar!&quot;, :user_id=&gt;&quot;99999&quot;, :person=&gt;&quot;Brandon&quot;, :id=&gt;&quot;18659245&quot;, :timestamp=&gt;Tue May 05 07:15:00 -0700 2009}]
+</code></pre>
+
+        <p>See the <a href="tinder">API documentation</a> for more details.</p>
+
+        <h2>Installation</h2>
+
+        <p>Tinder can be installed as a gem or a Rails plugin. Install the gem by executing:</p>
+
+        <pre>gem install tinder</pre>
+
+        <p>Or, download it from <a href="http://rubyforge.org/frs/?group_id=2922">RubyForge</a>.</p>
+
+        <h2>Source</h2>
+
+        <p>Contributions are welcome and appreciated!  The source is available from:</p>
+
+        <pre>http://github.com/collectiveidea/tinder</pre>
+    </div>
+</div>
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
+</script>
+<script type="text/javascript">
+_uacct = "UA-194397-8";
+urchinTracker();
+</script>
+</body>
+</html>

data/site/stylesheets/style.css

@@ -0,0 +1,77 @@
+body {
+  font-family: "Lucida Grande", Helvetica, Arial, sans-serif;
+  font-size: 76%;
+  background: #2A2A2A;
+  margin: 0;
+  padding: 0;
+}
+
+#collectiveidea {
+  border-bottom: 1px solid #444;
+}
+
+a {
+  color: #2D5385;
+}
+
+#main {
+  background-color: #FFF;
+  width: 700px;
+  margin: 0 auto;
+  border: 5px #CCC;
+  border-left-style: solid;
+  border-right-style: solid;
+  padding: 0 1em;
+}
+
+#header {
+  position: relative;
+  border-bottom: 1px solid #999;
+  padding: 1em;
+}
+
+#header h1 {
+  margin: 0;
+  padding: 0;
+  color: #2D5385;
+}
+
+#header h1 a {
+  text-decoration: none;
+}
+
+#header p {
+  margin: 0;
+  padding: 0;
+  font-size: 0.8em;
+  color: #999;
+}
+
+#nav {
+  list-style: none;
+  position: absolute;
+  right: 0;
+  top: 0.6em;
+}
+#nav li {
+  display: inline;
+  padding: 0 0.5em;
+}
+
+#content {
+  padding: 1em 0;
+}
+
+dl {
+  background-color: #DDD;
+  padding: 1em;
+  border: 1px solid #CCC;
+}
+dl .pronunciation {
+  color: #C00;
+}
+dl .description {
+  text-transform: uppercase;
+  font-size: 0.8em;
+  font-family: fixed;
+}