silvermoon 0.1

data/.gitignore

@@ -0,0 +1,8 @@
+.bundle/
+log/*.log
+pkg/
+spec/dummy/db/*.sqlite3
+spec/dummy/log/*.log
+spec/dummy/tmp/
+*.swp
+*.swo

data/.rvmrc

@@ -0,0 +1 @@
+rvm 1.8.7@silvermoon --create

data/Gemfile

@@ -0,0 +1,14 @@
+source "http://rubygems.org"
+
+gemspec
+
+gem "rails", "3.0.10"
+gem "capybara", ">= 0.4.0"
+gem "sqlite3"
+
+gem "rspec-rails", ">= 2.0.0.beta"
+gem 'guard-rails'
+gem 'ruby-debug'
+
+gem 'twitter'
+gem 'koala'

data/Gemfile.lock

@@ -0,0 +1,159 @@
+PATH
+  remote: .
+  specs:
+    silvermoon (0.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    abstract (1.0.0)
+    actionmailer (3.0.10)
+      actionpack (= 3.0.10)
+      mail (~> 2.2.19)
+    actionpack (3.0.10)
+      activemodel (= 3.0.10)
+      activesupport (= 3.0.10)
+      builder (~> 2.1.2)
+      erubis (~> 2.6.6)
+      i18n (~> 0.5.0)
+      rack (~> 1.2.1)
+      rack-mount (~> 0.6.14)
+      rack-test (~> 0.5.7)
+      tzinfo (~> 0.3.23)
+    activemodel (3.0.10)
+      activesupport (= 3.0.10)
+      builder (~> 2.1.2)
+      i18n (~> 0.5.0)
+    activerecord (3.0.10)
+      activemodel (= 3.0.10)
+      activesupport (= 3.0.10)
+      arel (~> 2.0.10)
+      tzinfo (~> 0.3.23)
+    activeresource (3.0.10)
+      activemodel (= 3.0.10)
+      activesupport (= 3.0.10)
+    activesupport (3.0.10)
+    addressable (2.2.6)
+    arel (2.0.10)
+    builder (2.1.2)
+    capybara (1.0.1)
+      mime-types (>= 1.16)
+      nokogiri (>= 1.3.3)
+      rack (>= 1.0.0)
+      rack-test (>= 0.5.4)
+      selenium-webdriver (~> 2.0)
+      xpath (~> 0.1.4)
+    childprocess (0.2.2)
+      ffi (~> 1.0.6)
+    columnize (0.3.4)
+    diff-lcs (1.1.3)
+    erubis (2.6.6)
+      abstract (>= 1.0.0)
+    faraday (0.7.4)
+      addressable (~> 2.2.6)
+      multipart-post (~> 1.1.0)
+      rack (>= 1.1.0, < 2)
+    faraday_middleware (0.7.0)
+      faraday (~> 0.7.3)
+    ffi (1.0.9)
+    guard (0.6.2)
+      thor (~> 0.14.6)
+    guard-rails (0.0.3)
+      guard (>= 0.2.2)
+    hashie (1.1.0)
+    i18n (0.5.0)
+    json_pure (1.5.4)
+      spruz (~> 0.2.8)
+    koala (1.1.0)
+      multi_json (~> 1.0)
+      multipart-post (~> 1.0)
+    linecache (0.46)
+      rbx-require-relative (> 0.0.4)
+    mail (2.2.19)
+      activesupport (>= 2.3.6)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.16)
+    multi_json (1.0.3)
+    multi_xml (0.2.2)
+    multipart-post (1.1.3)
+    nokogiri (1.5.0)
+    polyglot (0.3.2)
+    rack (1.2.3)
+    rack-mount (0.6.14)
+      rack (>= 1.0.0)
+    rack-test (0.5.7)
+      rack (>= 1.0)
+    rails (3.0.10)
+      actionmailer (= 3.0.10)
+      actionpack (= 3.0.10)
+      activerecord (= 3.0.10)
+      activeresource (= 3.0.10)
+      activesupport (= 3.0.10)
+      bundler (~> 1.0)
+      railties (= 3.0.10)
+    railties (3.0.10)
+      actionpack (= 3.0.10)
+      activesupport (= 3.0.10)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (~> 0.14.4)
+    rake (0.9.2)
+    rbx-require-relative (0.0.5)
+    rdoc (3.9.4)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.4)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+    rspec-rails (2.6.1)
+      actionpack (~> 3.0)
+      activesupport (~> 3.0)
+      railties (~> 3.0)
+      rspec (~> 2.6.0)
+    ruby-debug (0.10.4)
+      columnize (>= 0.1)
+      ruby-debug-base (~> 0.10.4.0)
+    ruby-debug-base (0.10.4)
+      linecache (>= 0.3)
+    rubyzip (0.9.4)
+    selenium-webdriver (2.5.0)
+      childprocess (>= 0.2.1)
+      ffi (>= 1.0.7)
+      json_pure
+      rubyzip
+    simple_oauth (0.1.5)
+    spruz (0.2.13)
+    sqlite3 (1.3.4)
+    thor (0.14.6)
+    treetop (1.4.10)
+      polyglot
+      polyglot (>= 0.3.1)
+    twitter (1.6.2)
+      faraday (~> 0.7.4)
+      faraday_middleware (~> 0.7.0)
+      hashie (~> 1.1.0)
+      multi_json (~> 1.0.0)
+      multi_xml (~> 0.2.0)
+      simple_oauth (~> 0.1.5)
+    tzinfo (0.3.29)
+    xpath (0.1.4)
+      nokogiri (~> 1.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  capybara (>= 0.4.0)
+  guard-rails
+  koala
+  rails (= 3.0.10)
+  rspec-rails (>= 2.0.0.beta)
+  ruby-debug
+  silvermoon!
+  sqlite3
+  twitter

data/Guardfile

@@ -0,0 +1,21 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard 'rspec', :version => 2 do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec/" }
+
+  # Rails example
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^app/(.+)\.rb$})                           { |m| "spec/#{m[1]}_spec.rb" }
+  watch(%r{^lib/(.+)\.rb$})                           { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch(%r{^app/controllers/(.+)_(controller)\.rb$})  { |m| ["spec/routing/#{m[1]}_routing_spec.rb", "spec/#{m[2]}s/#{m[1]}_#{m[2]}_spec.rb", "spec/acceptance/#{m[1]}_spec.rb"] }
+  watch(%r{^spec/support/(.+)\.rb$})                  { "spec/" }
+  watch('spec/spec_helper.rb')                        { "spec/" }
+  watch('config/routes.rb')                           { "spec/routing" }
+  watch('app/controllers/application_controller.rb')  { "spec/controllers" }
+  # Capybara request specs
+  watch(%r{^app/views/(.+)/.*\.(erb|haml)$})          { |m| "spec/requests/#{m[1]}_spec.rb" }
+end
+

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2011 YOURNAME
+
+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.

data/README.md

@@ -0,0 +1,83 @@
+= Silvermoon
+
+A simple notifier wrapper for rails.
+
+== Usage
+
+On the Gemfile:
+
+    gem 'silvermoon'
+Then:
+
+    bundle install
+
+After you have the gem installed, run the installer
+
+    rails g silvermoon:install
+
+This will generate one file: 
+
+    config/silvermoon.yml
+
+And add two gems to your gemfile:
+
+    koala
+    twitter
+
+The file will configure how *Silvermoon* will work on your system and
+the two gems are a dependency for the default notifiers, if you create your
+own implementations you can just remove them.
+
+=== silvermoon.yml
+
+Here you will add specifics for each notifier that you use, and any extra
+information necessary so that they notify their respective services.
+
+It uses dependency injection so you can specificy what class will be
+instantiated to receive the notify method.
+
+It comes with two defaults, the Facebook and the Twitter notifiers and they
+use respectively Koala and Twitter gems to communicate with the services.
+
+If you don't like them, you can simply remove them and make your own class to
+receive the notification.
+
+Check out `Silvermoon::Notifier::Base` to know how to implement your own
+notifier.
+
+=== Notifying
+
+Now that your environment is ready, you have to specify what and who to notify.
+This is done in two ways at your controllers.
+
+To say *who* will be notified, you simply add in the top of your controller:
+
+    notifies :twitter, :facebook
+
+By default it will use all the notifiers declared on the `silvermoon.rb` but you can
+specify different notifications for different controllers.
+
+This sets up a controller scope notification setting, but you can still override it at the notification time.
+
+Finally, to say *what* will be notified by the services you've enabled, you add this line:
+
+    notify('This is my title', 'This is my content', 'http://myurl.com')
+
+==== Important note
+
+This is an interface for notifications, the notify method also accepts an additional hash of parameters
+and every notifier reads this data and uses it in different ways.
+For instance, the twitter notifier does not use the content, it uses just the title and the url. On the other hand
+the facebook notifier can take an `:image` parameter and will render that image url together with the wall post.
+
+This is the complete method signature for `notify`:
+
+    notify(title, content, url, extra = {}, notifiers = controller_notifiers)
+
+As you can see, you can specify exclusive notifiers for different actions in your controllers, just pass them to the
+`notifiers` parameter.
+
+== Contribution
+
+Every contribution is welcome !
+I am eager to receive constructive criticism, feature requests, bug reports, pull requests, anything!

data/Rakefile

@@ -0,0 +1,27 @@
+# encoding: UTF-8
+require 'rubygems'
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rake'
+require 'rake/rdoctask'
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+require 'bundler/gem_tasks'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Silvermoon'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/lib/generators/silvermoon/install/install_generator.rb

@@ -0,0 +1,16 @@
+module Silvermoon
+  module Generators
+    class InstallGenerator < ::Rails::Generators::Base
+      source_root File.expand_path('../templates', __FILE__)
+
+      def create_silvermoon_yaml
+        copy_file 'silvermoon.yml', 'config/silvermoon.yml'
+      end
+
+      def add_default_dependent_gems
+        gem 'koala'
+        gem 'twitter'
+      end
+    end
+  end
+end

data/lib/generators/silvermoon/install/templates/silvermoon.yml

@@ -0,0 +1,17 @@
+
+development: &development
+  facebook:
+    klass: 'Silvermoon::Notifier::Facebook'
+    app_id: 'MY_APP_ID'
+    app_secret: 'MY_APP_SECRET'
+  twitter:
+    klass: 'Silvermoon::Notifier::Twitter'
+    consumer_key: 'MY_APP_CONSUMER_KEY'
+    consumer_secret: 'MY_APP_CONSUMER_SECRET'
+    oauth_token: 'MY_APP_OAUTH_TOKEN'
+    oauth_token_secret: 'MY_APP_OAUTH_TOKEN_SECRET'
+    
+production: 
+  <<: *development
+test:
+  <<: *development

data/lib/silvermoon.rb

@@ -0,0 +1,54 @@
+module Silvermoon
+
+  autoload :Notifier, 'silvermoon/notifier'
+
+  autoload :ActionControllerExtension, 'silvermoon/action_controller_extension'
+
+  module Notifier
+    autoload :Base, 'silvermoon/notifier/base'
+    autoload :Facebook, 'silvermoon/notifier/facebook'
+    autoload :Twitter, 'silvermoon/notifier/twitter'
+  end
+
+  require 'silvermoon/railtie'
+
+  mattr_accessor :loaded_notifiers
+  @@loaded_notifiers = Hash.new
+
+  def self.notify(title, content, url, extras = {}, notifiers = [])
+    returns = {} 
+    notifiers = Notifier.config.keys if notifiers.empty?
+    notifiers.each do |notifier|
+      loaded_notifier = loaded_notifiers[notifier] || load_notifier(notifier)
+      begin
+        returns[notifier] = loaded_notifier.notify(title, content, url, extras)
+      rescue ::Exception => e
+        returns[notifier] = e
+      end
+    end
+    returns
+  end
+
+  def self.add_notifier(notifier)
+    load_notifier(notifier)
+  end
+
+  def self.clear_notifiers!
+    @@loaded_notifiers = Hash.new
+  end
+
+#  def self.setup(&block)
+#    self.instance_exec(&block)
+#  end
+
+  private
+
+  def self.load_notifier(notifier)
+    return loaded_notifiers[notifier] if loaded_notifiers.has_key?(notifier)
+    loaded_notifier = Silvermoon::Notifier.config[notifier]['klass'].constantize.new
+    loaded_notifier.identifier = notifier
+    loaded_notifiers[notifier] = loaded_notifier
+    loaded_notifier
+  end
+
+end

data/lib/silvermoon/action_controller_extension.rb

@@ -0,0 +1,22 @@
+module Silvermoon
+  module ActionControllerExtension
+    extend ActiveSupport::Concern   
+
+    included do
+      cattr_accessor :controller_notifiers
+    end
+
+    module ClassMethods
+      def notifies(*what)
+        self.controller_notifiers = what.to_a.compact
+      end
+    end
+
+    module InstanceMethods
+      def notify(title, content, url, extras = {}, notifiers = nil)
+        Silvermoon.notify(title, content, url, extras, (notifiers || self.controller_notifiers) )
+      end
+    end
+
+  end
+end