visionmedia-growl 0.0.4

data/Growl.gemspec

@@ -0,0 +1,31 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{growl}
+  s.version = "0.0.4"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["TJ Holowaychuk"]
+  s.date = %q{2009-04-08}
+  s.description = %q{growlnotify bindings}
+  s.email = %q{tj@vision-media.ca}
+  s.extra_rdoc_files = ["lib/growl/growl.rb", "lib/growl/version.rb", "lib/growl.rb", "README.rdoc", "tasks/docs.rake", "tasks/gemspec.rake", "tasks/spec.rake"]
+  s.files = ["Growl.gemspec", "History.rdoc", "lib/growl/growl.rb", "lib/growl/version.rb", "lib/growl.rb", "Manifest", "Rakefile", "README.rdoc", "spec/fixtures/icon.icns", "spec/fixtures/image.png", "spec/growl_spec.rb", "spec/spec_helper.rb", "tasks/docs.rake", "tasks/gemspec.rake", "tasks/spec.rake", "Todo.rdoc", "growl.gemspec"]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/visionmedia/growl}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Growl", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{growl}
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{growlnotify bindings}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/History.rdoc

@@ -0,0 +1,16 @@
+
+=== 0.0.4 / 2009-04-08
+
+* We dont want visionmedia-Growl, shesh :p, fixed to lowercase
+
+=== 0.0.3 / 2009-04-08
+
+* Added #Growl hash support
+
+=== 0.0.2 / 2009-04-08
+
+* Github build me!!!
+
+=== 0.0.1 / 2009-04-08
+
+* Initial release

data/Manifest

@@ -0,0 +1,16 @@
+Growl.gemspec
+History.rdoc
+lib/growl/growl.rb
+lib/growl/version.rb
+lib/growl.rb
+Manifest
+Rakefile
+README.rdoc
+spec/fixtures/icon.icns
+spec/fixtures/image.png
+spec/growl_spec.rb
+spec/spec_helper.rb
+tasks/docs.rake
+tasks/gemspec.rake
+tasks/spec.rake
+Todo.rdoc

data/README.rdoc

@@ -0,0 +1,66 @@
+
+= Growl
+
+Ruby growlnotify 'bindings'.
+
+== Examples
+
+  notification = Growl.new
+  notification.message = 'Hello World'
+  notification.sticky!
+  notification.icon = :jpeg
+  notification.run
+
+  # OR
+
+  Growl {
+    self.message = 'Hello World'
+    self.icon = :jpeg
+    sticky!
+  }
+
+  # OR
+
+  Growl do |n|
+    n.message = 'Hello World'
+    n.icon = :jpeg
+    n.stick!
+  end
+
+  # OR
+
+  Growl :message => 'Invoked via Growl with hash', :icon => 'jpeg', :title => 'Growl
+
+== Features
+
+* Check availability with Growl#installed?
+* Check dependencies with Growl#version
+* Use images, icon paths, application icons, or file format icons
+* Sticky a notification making it appear until explicitly closed 
+* Set notification priority 
+* Etc (consult growlnotify --help) 
+
+== License:
+
+(The MIT License)
+
+Copyright (c) 2009 TJ Holowaychuk <tj@vision-media.ca>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, an d/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE 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/Rakefile

@@ -0,0 +1,16 @@
+
+$:.unshift 'lib'
+require 'growl'
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new "growl", Growl::VERSION do |p|
+  p.author = "TJ Holowaychuk"
+  p.email = "tj@vision-media.ca"
+  p.summary = "growlnotify bindings"
+  p.url = "http://github.com/visionmedia/growl"
+  p.runtime_dependencies = []
+end
+
+Dir['tasks/**/*.rake'].sort.each { |f| load f }

data/Todo.rdoc

@@ -0,0 +1,14 @@
+
+== Major:
+
+* Switch aliases since appIcon is ... lame
+* Allow the icon switch to be an image, icon, or extension. This would be much more usable than --icon, --image, and --iconpath
+* Docs for installing growlnotify
+
+== Minor:
+
+* Nothing
+
+== Brainstorming:
+
+* Nothing

data/lib/growl/growl.rb

@@ -0,0 +1,142 @@
+
+module Growl
+  
+  BIN = 'growlnotify'
+  
+  #--
+  # Exceptions
+  #++
+  
+  class Error < StandardError; end
+  
+  #--
+  # Singleton methods
+  #++
+  
+  module_function
+  
+  ##
+  # Execute +args+ against the binary.
+  
+  def exec *args
+    Kernel.system BIN, *args
+  end
+  
+  ##
+  # Return the version triple of the binary.
+  
+  def version
+    `#{BIN} --version`.split[1]
+  end
+  
+  ##
+  # Check if the binary is installed and accessable.
+  
+  def installed?
+    !! version
+  end
+  
+  ##
+  # Return an instance of Growl::Base.
+  
+  def new *args, &block
+    Base.new *args, &block
+  end
+  
+  #--
+  # Growl base
+  #++
+  
+  class Base
+    attr_reader :args
+    
+    ##
+    # Initialize with optional +block+, which is then
+    # instance evaled or yielded depending on the blocks arity.
+    
+    def initialize options = {}, &block
+      @args = []
+      if block_given?
+        if block.arity > 0
+          yield self
+        else
+          self.instance_eval &block
+        end
+      else
+        options.each do |key, value|
+          send :"#{key}=", value
+        end
+      end
+    end
+    
+    ##
+    # Run the notification, only --message is required.
+    
+    def run
+      raise Error, 'message required' unless message
+      self.class.switches.each do |switch|
+        if send(:"#{switch}?")
+          args << "--#{switch}"
+          args << send(switch) if send(switch).is_a? String
+        end
+      end
+      Growl.exec *args
+    end
+    
+    ##
+    # Define a switch +name+.
+    #
+    # === examples
+    #
+    #  switch :sticky
+    #
+    #  @growl.sticky!
+    #  @growl.sticky?         # => true
+    #  @growl.sticky = false
+    #  @growl.sticky?         # => false
+    #
+    
+    def self.switch name
+      ivar = :"@#{name}"
+      (@switches ||= []) << name
+      define_method(:"#{name}")  { instance_variable_get(ivar) }
+      define_method(:"#{name}=") { |value| instance_variable_set(ivar, value) }
+      define_method(:"#{name}?") { !! instance_variable_get(ivar) }
+      define_method(:"#{name}!") { instance_variable_set(ivar, true) }
+    end
+    
+    ##
+    # Return array of available switch symbols.
+    
+    def self.switches
+      @switches
+    end
+    
+    #--
+    # Switches
+    #++
+    
+    switch :title
+    switch :message
+    switch :sticky
+    switch :name
+    switch :appIcon
+    switch :icon
+    switch :iconpath
+    switch :image
+    switch :priority
+    switch :identifier
+    switch :host
+    switch :password
+    switch :udp
+    switch :port
+    switch :auth
+    switch :crypt
+
+  end
+
+end
+
+def Growl options = {}, &block
+  Growl.new(options, &block).run
+end

data/lib/growl/version.rb

@@ -0,0 +1,4 @@
+
+module Growl
+  VERSION = '0.0.4'
+end

data/lib/growl.rb

@@ -0,0 +1,25 @@
+#--
+# Copyright (c) 2009 TJ Holowaychuk <tj@vision-media.ca>
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE 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.
+#++
+
+require 'growl/version'
+require 'growl/growl'

data/spec/growl_spec.rb

@@ -0,0 +1,99 @@
+
+describe Growl do
+  
+  describe "#installed?" do
+    it "should check if growlnotify is available" do
+      Growl.should be_installed
+    end
+  end
+  
+  describe "#version" do
+    it "should return only the version triple" do
+      Growl.version.should match(/\d+\.\d+\.\d+/)
+    end
+  end
+  
+  before :each do
+    @growl = Growl.new
+    @growl.message = 'Hello World'
+  end
+  
+  describe "#Growl" do
+    it "should accept a block, running immediately after" do
+      Growl { |n| n.message = 'Invoked via Growl' }
+    end
+    
+    it "should accept a hash" do
+      Growl :message => 'Invoked via Growl with hash', :icon => 'jpeg', :title => 'Growl'
+    end
+  end
+  
+  describe "#run" do
+    it "should fail when no message is present" do
+      lambda { Growl.new.run }.should raise_error(Growl::Error, /message required/)
+    end
+    
+    it "should execute a growl notification" do
+      @growl.run.should be_true
+    end
+  end
+  
+  describe "#sticky!" do
+    it "should make a notification stick until explicitly closed" do
+      @growl.sticky = false
+      @growl.should_not be_sticky
+      @growl.sticky!
+      @growl.should be_sticky
+      @growl.message = 'Im Sticky'
+      @growl.run.should be_true
+    end
+  end
+  
+  describe "#name" do
+    it "should set the application name" do
+      @growl.name = 'Ruby'
+      @growl.run.should be_true
+    end
+  end
+  
+  describe "#title" do
+    it "should add a title" do
+      @growl.title = 'Im a title'
+      @growl.message = 'I am not a title'
+      @growl.run.should be_true
+    end
+  end
+  
+  describe "#appIcon" do
+    it "should use an application for the icon" do
+      @growl.appIcon = 'Safari'
+      @growl.message = 'Safari Icon'
+      @growl.run.should be_true
+    end
+  end
+  
+  describe "#iconpath" do
+    it "should use a path for the icon" do
+      @growl.iconpath = fixture 'icon.icns'
+      @growl.message = 'Custom Icon'
+      @growl.run.should be_true
+    end
+  end
+  
+  describe "#icon" do
+    it "should use an icon based on a file type" do
+      @growl.icon = 'jpeg'
+      @growl.message = 'Jpeg Icon'
+      @growl.run.should be_true
+    end
+  end
+  
+  describe "#image" do
+    it "should use an image path for the 'icon'" do
+      @growl.image = fixture 'image.png'
+      @growl.message = 'Image as icon'
+      @growl.run.should be_true
+    end
+  end
+  
+end

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+
+require 'growl'
+
+def fixture path
+  File.expand_path File.join(File.dirname(__FILE__), 'fixtures', path)
+end

data/tasks/docs.rake

@@ -0,0 +1,13 @@
+
+namespace :docs do
+  
+  desc 'Remove rdoc products'
+  task :remove => [:clobber_docs]
+  
+  desc 'Build docs, and open in browser for viewing (specify BROWSER)'
+  task :open do
+    browser = ENV["BROWSER"] || "safari"
+    sh "open -a #{browser} doc/index.html"
+  end
+  
+end

data/tasks/gemspec.rake

@@ -0,0 +1,3 @@
+
+desc 'Build gemspec file'
+task :gemspec => [:build_gemspec]

data/tasks/spec.rake

@@ -0,0 +1,25 @@
+
+require 'spec/rake/spectask'
+  
+desc "Run all specifications"
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.libs << "lib"
+  t.spec_opts = ["--color", "--require", "spec/spec_helper.rb"]
+end
+  
+namespace :spec do
+
+  desc "Run all specifications verbosely"
+  Spec::Rake::SpecTask.new(:verbose) do |t|
+    t.libs << "lib"
+    t.spec_opts = ["--color", "--format", "specdoc", "--require", "spec/spec_helper.rb"]
+  end
+  
+  desc "Run specific specification verbosely (specify SPEC)"
+  Spec::Rake::SpecTask.new(:select) do |t|
+    t.libs << "lib"
+    t.spec_files = [ENV["SPEC"]]
+    t.spec_opts = ["--color", "--format", "specdoc", "--require", "spec/spec_helper.rb"]
+  end
+  
+end

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification 
+name: visionmedia-growl
+version: !ruby/object:Gem::Version 
+  version: 0.0.4
+platform: ruby
+authors: 
+- TJ Holowaychuk
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-04-08 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: growlnotify bindings
+email: tj@vision-media.ca
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- lib/growl/growl.rb
+- lib/growl/version.rb
+- lib/growl.rb
+- README.rdoc
+- tasks/docs.rake
+- tasks/gemspec.rake
+- tasks/spec.rake
+files: 
+- Growl.gemspec
+- History.rdoc
+- lib/growl/growl.rb
+- lib/growl/version.rb
+- lib/growl.rb
+- Manifest
+- Rakefile
+- README.rdoc
+- spec/fixtures/icon.icns
+- spec/fixtures/image.png
+- spec/growl_spec.rb
+- spec/spec_helper.rb
+- tasks/docs.rake
+- tasks/gemspec.rake
+- tasks/spec.rake
+- Todo.rdoc
+- growl.gemspec
+has_rdoc: true
+homepage: http://github.com/visionmedia/growl
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Growl
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: growl
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: growlnotify bindings
+test_files: []
+