pyre 0.2.0 → 0.3.0

data/History.txt

@@ -1,3 +1,12 @@
+== 0.3.0 / 2008-02-20
+
+* Huge enhancement!
+  * contrib/ directory with Subversion post-commit hook ready to be tried out!
+* New methods
+  * Room#upload('path/to/file') - UPLOAD!
+* Improved methods
+  * A bunch of them now raise errors on failure
+
 == 0.2.0 / 2008-02-17
 
 * New methods

data/Manifest.txt

@@ -17,3 +17,4 @@ tasks/setup.rb
 tasks/spec.rake
 tasks/svn.rake
 tasks/test.rake
+contrib/svn/post-commit

data/README.txt

@@ -44,6 +44,11 @@ Patches awfully welcome.
 
 You can also grab the current trunk from http://pyre.rubyforge.org/svn/pyre/trunk
 
+== MORE:
+
+Check out the contrib directory for example scripts you can use, like a stylish
+Subversion post-commit hook that shoots a nice-looking message to a Campfire room.
+
 == LICENSE:
 
 (The MIT License)

data/contrib/svn/post-commit

@@ -0,0 +1,76 @@
+#!/usr/bin/ruby
+
+# Subversion Post-Commit Hook using Pyre
+#
+# Throw this in your subversion repositories hooks/ directory
+# (after making the appropriate changes) and it will paste
+# nice commit messages for you in a Campfire chat room.
+#
+# The messages look like this:
+
+# cms commited revision 104
+# *************************
+# Fixed all spelling mistaeks in the README
+# *************************
+# U   pyre/trunk/README
+
+# Get creative.  For Rails projects, you might want to add
+# a warning if a revision added or changed a mirgration.
+# You could try adding something like this near the beginning
+# of the messsage-building section:
+#
+# message << "MIGRATION!!!\n" if files.include?('db/migrate')
+
+# CHANGE THESE VALUES!
+# AND make sure the path in the first line is correct!
+# AND make sure this file is executable!
+
+SVNLOOK            = '/path/to/svnlook' # svn hooks need full paths!
+CAMPFIRE_SUBDOMAIN = 'your_subdomain'
+CAMPFIRE_USERNAME  = 'svn_bot_username'
+CAMPFIRE_PASSWORD  = 'svn_bot_password'
+CAMPFIRE_ROOM      = 'campfire_room'
+CAMPFIRE_SSL       = false              # set to true if needed
+
+# Okay, you're done changing values.
+
+require 'rubygems'
+require 'pyre'
+
+# Subversion passes along the path of the repo and the revision number
+# to the post-commit hook (and in that order).
+path     = ARGV[0]
+revision = ARGV[1]
+
+# See `svnlook help` for more.
+author = `#{SVNLOOK} author -r #{revision} #{path}`.strip
+files  = `#{SVNLOOK} changed -r #{revision} #{path}`
+log    = `#{SVNLOOK} log -r #{revision} #{path}`.strip
+
+# Here's where the message that gets pasted to the room gets built.
+# Change this as you see fit.
+message   = "#{author} commited revision #{revision}\n"
+separator = '*' * (message.length - 1) << "\n"
+message  << separator
+message  << log << "\n"
+message  << separator
+message  << files
+
+# And here's where Pyre kicks in and pastes it.
+Pyre::Campfire.new(CAMPFIRE_SUBDOMAIN, :ssl => CAMPFIRE_SSL) do |campfire|
+  campfire.login(CAMPFIRE_USERNAME, CAMPFIRE_PASSWORD)
+  campfire.room(CAMPFIRE_ROOM) do |room|
+    room.paste(message)
+  end
+end
+
+# For more information on Subversion repository hooks, see:
+# http://svnbook.red-bean.com/en/1.4/svn.reposadmin.create.html#svn.reposadmin.create.hooks
+
+# THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/pyre.rb

@@ -1,7 +1,7 @@
 # Pyre: Because there isn't a real API for Campfire.
 module Pyre
   # :stopdoc:
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
   LIBPATH = ::File.expand_path(::File.dirname(__FILE__)) + ::File::SEPARATOR
   PATH = ::File.dirname(LIBPATH) + ::File::SEPARATOR
   # :startdoc:
@@ -11,6 +11,13 @@ module Pyre
   def self.version
     VERSION
   end
+  
+  # :stopdoc:
+  class LoginError < StandardError; end
+  class CommunicationError < StandardError; end
+  class UploadError < StandardError; end
+  class NavigationError < StandardError; end
+  # :startdoc:
 end
 
 require 'uri'

data/lib/pyre/campfire.rb

@@ -31,7 +31,7 @@ module Pyre
       login_form.fields.name('email_address').value = email
       login_form.fields.name('password').value      = password
       @agent.submit(login_form)
-      logged_in?
+      logged_in? or begin raise LoginError end
     end
     
     # Log out. Returns true on success.

data/lib/pyre/room.rb

@@ -13,7 +13,7 @@ module Pyre
     # Enter the room. Returns true on success.
     def join
       @campfire.agent.get(@url)
-      joined?
+      joined? or begin raise NavigationError end
     end
     
     # Leave the room. Returns true on success.
@@ -21,7 +21,7 @@ module Pyre
       if joined?
         leave = @campfire.agent.current_page.links.detect {|link| link.text == 'Leave'}
         @campfire.agent.post(leave.uri)
-        not joined?
+        not joined? or begin raise NavigationError end
       end
     end
     
@@ -30,20 +30,31 @@ module Pyre
       @campfire.agent.current_page.at('h1[@id="room_name"]').inner_text == @name rescue false
     end
     
-    # Send +message+ to the room. Joins the room if necessary. 
+    # Send +message+ to the room. Joins the room if necessary. Returns true on success.
     def speak(message)
       result = submit_chat_form(message)
       success = (result.uri.to_s == "#{@url}/speak")
       join
-      success
+      success or begin raise CommunicationError end
     end
     
-    # Paste +message+ to the room. Joins the room if necessary.
+    # Paste +message+ to the room. Joins the room if necessary. Returns true on success.
     def paste(message)
       result = submit_chat_form(message, 'paste' => 'true')
       success = (result.links.detect {|link| link.text == 'View paste'} and result.uri.to_s == "#{@url}/speak")
       join
-      success
+      success or begin raise CommunicationError end
+    end
+    
+    # Upload a file (named +filename+) to the room. Joins the room if necessary. Returns true on success.
+    def upload(filename)
+      join unless joined?
+      upload_form = @campfire.agent.current_page.forms.detect {|form| form.form_node[:id] == 'upload_form_tag'}
+      upload_form.file_uploads.first.file_name = filename
+      result = @campfire.agent.submit(upload_form)
+      join
+      success = @campfire.agent.current_page.search(%Q{ul[@id="file_list"]//a[@href$="/#{File.basename(filename)}"]}).size > 0
+      success or begin raise UploadError end
     end
     
     def inspect #:nodoc:

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: pyre
 version: !ruby/object:Gem::Version 
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors: 
 - Christopher Shea
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-02-17 00:00:00 -07:00
+date: 2008-02-20 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -50,6 +50,7 @@ files:
 - tasks/spec.rake
 - tasks/svn.rake
 - tasks/test.rake
+- contrib/svn/post-commit
 has_rdoc: true
 homepage: http://pyre.rubyforge.org
 post_install_message: