jaconda 1.0.2 → 2.0.0

data/README.markdown

@@ -1,7 +1,7 @@
 Jaconda API
 --------------
 
-The official ruby wrapper for working with the [Jaconda REST API](http://help.jaconda.im/faqs/api/jaconda-api-documentation)'s XML interface.  
+The official ruby wrapper for working with the [Jaconda REST API](http://help.jaconda.im/kb/api-v2/jaconda-api-documentation)'s XML interface.
 
 ## Installation
 
@@ -13,46 +13,106 @@ ActiveResource
 
 ## Usage
 
-The first thing you need to set the authentication.
+### Sending notifications
 
-    Jaconda::API.authenticate("API_TOKEN")
+    Jaconda::Notification.authenticate(:subdomain => "JACONDA_SUBDOMAIN",
+                                       :room_id => "ROOM_ID",
+                                       :room_token => "ROOM_TOKEN")
 
-### Finding rooms
+    Jaconda::Notification.notify(:text => "146 tests, 1399 assertions, 0 failures, 0 errors",
+                                 :sender_name => "Build Server")
 
-    Jaconda::Room.find(:all) # find all rooms for the current account.
-    Jaconda::Room.find(123)   # find individual room by ID
+### Using API
 
-### Creating a Room
+    Jaconda::API.authenticate(:subdomain => "JACONDA_SUBDOMAIN",
+                              :token => "API_TOKEN")
 
-    room = Jaconda::Room.new(:jid => 'awesome.project')
-    room.title = "Awesome Project Room"
-    room.save
+    Jaconda::API.authenticate(:subdomain => "JACONDA_SUBDOMAIN",
+                              :email => "EMAIL",
+                              :password => "PASSWORD")
+
+#### Finding rooms
+
+    Jaconda::API::Room.find(:all)
+    Jaconda::API::Room.find("support")
+
+#### Finding who's available in the room
+
+    room = Jaconda::API::Room.find("support")
+    room.available_users
+
+#### Finding who has access to the room
 
-### Updating a Room
+    room = Jaconda::API::Room.find("support")
+    room.presences
 
-    room = Jaconda::Room.find(123)
-    room.status_message = "Deadline: 3 apr"
+#### Creating a Room
+
+    Jaconda::API::Room.create(:jid => "awesome.project",
+                              :title => "Awesome Project Room")
+
+#### Updating a Room
+
+    room = Jaconda::API::Room.find("support")
+    room.topic = "Deadline: 3 apr"
     room.save
 
-### Finding messages
+#### Finding messages
 
-    room = Jaconda::Room.find(123)
+    room = Jaconda::API::Room.find("support")
     room.messages
-    
-    Jaconda::Message.find(:all, :params => { :room_id => 123 })
-    Jaconda::Message.find(:all, :params => { :room_id => 123, :per_page => 100, :page => 2 })
+    room.messages(:page => 2)
+
+    Jaconda::API::Message.find(:all, :params => { :room_id => "support",
+                                                  :per_page => 100,
+                                                  :page => 2 })
+
+#### Finding messages on date
+
+    room = Jaconda::API::Room.find("support")
+    room.transcript
+    room.transcript(:date => Date.yesterday)
+
+    Jaconda::API::Message.transcript(:room_id => "support",
+                                     :date => Date.today - 1.month)
+
+#### Searching for messages
+
+    room = Jaconda::API::Room.find("support")
+    room.search(:text => "bug")
+    room.search(:text => "commit", :per_page => 5)
+
+    Jaconda::API::Message.search(:room_id => "support",
+                                 :text => "issue",
+                                 :page => 2)
+
+#### Saying something
+
+    Jaconda::API::Message.create(:room_id => "support",
+                                 :text => "Hello from the API!")
+
+    Jaconda::API::Message.create(:room_id => "support",
+                                 :text => "is loving Jaconda!",
+                                 :kind => "me")
+
+    Jaconda::API::Message.create(:room_id => "support",
+                                 :text => "Hello from the API!",
+                                 :kind => "voice")
+
+#### Finding members
 
-### Creating a Message
+    Jaconda::API::Member.find(:all)
+    Jaconda::API::Member.find(123)
 
-    Jaconda::Message.create(:room_id => 123, :text => "Hello from the API!")
+#### Inviting new member
 
-### Finding users
+    Jaconda::API::Member.create(:name => "Anton",
+                                :email => "developer@gmail.com")
 
-    room = Jaconda::Room.find(123)
-    room.users
-    
-    Jaconda::User.find(:all, :params => { :room_id => 123 })
+#### Finding uploads
 
-### Creating a User
+    room = Jaconda::API::Room.find("support")
+    room.uploads
 
-    Jaconda::User.create(:room_id => 123, :jid => "developer@gmail.com")
+    member = Jaconda::API::Member.find(123)
+    member.uploads

data/Rakefile

@@ -9,7 +9,7 @@ begin
     gem.email = "ant.mironov@gmail.com"
     gem.homepage = "http://github.com/mironov/jaconda-api"
     gem.authors = ["Anton Mironov"]
-    gem.add_dependency "activeresource"
+    gem.add_dependency "activeresource", "~> 2.3.5"
     gem.add_development_dependency "thoughtbot-shoulda", ">= 0"
   end
   Jeweler::GemcutterTasks.new

data/VERSION

@@ -1 +1 @@
-1.0.2
+2.0.0

data/jaconda.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{jaconda}
-  s.version = "1.0.2"
+  s.version = "2.0.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Anton Mironov"]
-  s.date = %q{2010-12-12}
+  s.date = %q{2011-02-27}
   s.email = %q{ant.mironov@gmail.com}
   s.extra_rdoc_files = [
     "LICENSE",
@@ -23,6 +23,13 @@ Gem::Specification.new do |s|
      "VERSION",
      "jaconda.gemspec",
      "lib/jaconda.rb",
+     "lib/jaconda/base.rb",
+     "lib/jaconda/member.rb",
+     "lib/jaconda/message.rb",
+     "lib/jaconda/notification.rb",
+     "lib/jaconda/presence.rb",
+     "lib/jaconda/room.rb",
+     "lib/jaconda/upload.rb",
      "test/helper.rb",
      "test/test_jaconda.rb"
   ]
@@ -41,14 +48,14 @@ Gem::Specification.new do |s|
     s.specification_version = 3
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<activeresource>, [">= 0"])
+      s.add_runtime_dependency(%q<activeresource>, ["~> 2.3.5"])
       s.add_development_dependency(%q<thoughtbot-shoulda>, [">= 0"])
     else
-      s.add_dependency(%q<activeresource>, [">= 0"])
+      s.add_dependency(%q<activeresource>, ["~> 2.3.5"])
       s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
     end
   else
-    s.add_dependency(%q<activeresource>, [">= 0"])
+    s.add_dependency(%q<activeresource>, ["~> 2.3.5"])
     s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
   end
 end

data/lib/jaconda.rb

@@ -1,31 +1,9 @@
-require 'active_resource'
-
-module Jaconda
-  class API < ActiveResource::Base
-    self.site = "https://jaconda.im"
-    self.prefix = "/api/"
-
-    def self.authenticate(api_token)
-      self.password = 'x'
-      self.user = api_token
-    end
-  end
-
-  class Room < API
-    def users(options = {})
-      User.find(:all, :params => options.update(:room_id => id))
-    end
-
-    def messages(options = {})
-      Message.find(:all, :params => options.update(:room_id => id))
-    end
-  end
-
-  class User < API
-    self.prefix = "/api/rooms/:room_id/"
-  end
-
-  class Message < API
-    self.prefix = "/api/rooms/:room_id/"
-  end
-end
+require "active_resource"
+
+require "jaconda/base"
+require "jaconda/notification"
+require "jaconda/room"
+require "jaconda/upload"
+require "jaconda/member"
+require "jaconda/presence"
+require "jaconda/message"

data/lib/jaconda/base.rb

@@ -0,0 +1,16 @@
+module Jaconda
+  class API < ActiveResource::Base
+    self.prefix = "/api/v2/"
+
+    def self.authenticate(options)
+      self.site = "https://#{options[:subdomain]}.jaconda.im"
+      if options[:token]
+        self.user = options[:token]
+        self.password = "x"
+      else
+        self.user = options[:email]
+        self.password = options[:password]
+      end
+    end
+  end
+end

data/lib/jaconda/member.rb

@@ -0,0 +1,19 @@
+module Jaconda
+  class API::Member < API
+    self.element_name = "user"
+
+    def self.collection_name
+      "members"
+    end
+
+    def presences
+      API::Presence.prefix = "/api/v2/members/:user_id/"
+      API::Presence.find(:all, :params => {:user_id => id})
+    end
+
+    def uploads
+      API::Upload.prefix = "/api/v2/members/:user_id/"
+      API::Upload.find(:all, :params => {:user_id => id})
+    end
+  end
+end

data/lib/jaconda/message.rb

@@ -0,0 +1,14 @@
+module Jaconda
+  class API::Message < API
+    self.prefix = "/api/v2/rooms/:room_id/"
+
+    def self.search(options = {})
+      get(:search, options)
+    end
+
+    def self.transcript(options = {})
+      date = options[:date] || Date.today
+      get("#{date.year}/#{date.month}/#{date.day}", options)
+    end
+  end
+end

data/lib/jaconda/notification.rb

@@ -0,0 +1,17 @@
+module Jaconda
+  class Notification < ActiveResource::Base
+    self.prefix = "/api/v2/rooms/:room_id/"
+    self.element_name = ""
+
+    def self.authenticate(options)
+      self.site = "https://#{options[:subdomain]}.jaconda.im"
+      @room_id = options[:room_id]
+      self.user = options[:room_token]
+      self.password = "x"
+    end
+
+    def self.notify(params = {})
+      post(:notify, :message => params, :room_id => @room_id)
+    end
+  end
+end

data/lib/jaconda/presence.rb

@@ -0,0 +1,4 @@
+module Jaconda
+  class API::Presence < API
+  end
+end

data/lib/jaconda/room.rb

@@ -0,0 +1,29 @@
+module Jaconda
+  class API::Room < API
+    def id
+      jid
+    end
+
+    def presences
+      API::Presence.prefix = "/api/v2/rooms/:room_id/"
+      API::Presence.find(:all, :params => {:room_id => id})
+    end
+
+    def uploads
+      API::Upload.prefix = "/api/v2/rooms/:room_id/"
+      API::Upload.find(:all, :params => {:room_id => id})
+    end
+
+    def messages(options = {})
+      API::Message.find(:all, :params => options.update(:room_id => id))
+    end
+
+    def search(options = {})
+      API::Message.search(options.update(:room_id => id))
+    end
+
+    def transcript(options = {})
+      API::Message.transcript(options.update(:room_id => id))
+    end
+  end
+end

data/lib/jaconda/upload.rb

@@ -0,0 +1,5 @@
+module Jaconda
+  class API::Upload < API
+    self.prefix = "/api/v2/rooms/:room_id/"
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: jaconda
 version: !ruby/object:Gem::Version 
-  hash: 19
+  hash: 15
   prerelease: false
   segments: 
-  - 1
-  - 0
   - 2
-  version: 1.0.2
+  - 0
+  - 0
+  version: 2.0.0
 platform: ruby
 authors: 
 - Anton Mironov
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-12-12 00:00:00 +05:00
+date: 2011-02-27 00:00:00 +05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -24,12 +24,14 @@ dependencies:
   requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
-        hash: 3
+        hash: 9
         segments: 
-        - 0
-        version: "0"
+        - 2
+        - 3
+        - 5
+        version: 2.3.5
   type: :runtime
   version_requirements: *id001
 - !ruby/object:Gem::Dependency 
@@ -63,6 +65,13 @@ files:
 - VERSION
 - jaconda.gemspec
 - lib/jaconda.rb
+- lib/jaconda/base.rb
+- lib/jaconda/member.rb
+- lib/jaconda/message.rb
+- lib/jaconda/notification.rb
+- lib/jaconda/presence.rb
+- lib/jaconda/room.rb
+- lib/jaconda/upload.rb
 - test/helper.rb
 - test/test_jaconda.rb
 has_rdoc: true