october 0.1.1

data/Gemfile

@@ -0,0 +1,35 @@
+source :rubygems
+
+gem 'cinch'
+
+gem 'rake', :require => false
+gem 'activesupport', :require => 'active_support/core_ext'
+gem 'i18n'
+
+# debugging
+group :development do
+  gem 'pry'
+  gem 'pry-nav'
+  gem 'awesome_print'
+end
+
+# Redis stuff
+gem 'redis'
+gem 'hiredis'
+gem 'redis-namespace'
+gem 'redis-objects', :require => 'redis/objects'
+
+# http stuff
+gem 'typhoeus'
+
+# issues stuff - https://github.com/peter-murach/github/
+gem 'github_api'
+
+gem 'json'
+gem 'nokogiri'
+gem 'curb'
+
+group :test do
+  gem 'rspec'
+  gem 'fakefs', :require => 'fakefs/safe'
+end

data/README.md

@@ -0,0 +1,14 @@
+# October
+[![Build Status](https://secure.travis-ci.org/mikz/october.png)](http://travis-ci.org/#!/mikz/october)
+
+IRC bot build on [Cinch framework](https://github.com/cinchrb/cinch) with some additional stuff like persistence layer od configuration in yml.
+
+## Plugins
+
+October provides some sugar for regular Cinch plugins such as redis persistence and help command.
+
+
+## TODO
+
+* Spec
+* Moar features!

data/Rakefile

@@ -0,0 +1,38 @@
+namespace :gem do
+  require "bundler/gem_tasks"
+end
+
+task :integrate do |task|
+  ENV['OCTOBER_ENV'] ||= 'test'
+  exec 'rspec spec'
+end
+
+task :environment, :env do |task, args|
+  ENV['OCTOBER_ENV'] ||= args[:env]
+
+  $:.unshift File.dirname(__FILE__)
+
+  require 'boot'
+  require 'october'
+
+end
+
+task :boot, [:env, :console] => :environment do |task, args|
+  @bot = October::Base.new
+end
+
+desc 'Starts IRC server'
+task :start, [:env, :console] => :boot do |task, args|
+  if args[:console]
+    Cinch::IRC.send :include, October::Debugger
+  end
+
+  @bot.start
+end
+
+desc 'Creates interactive console with Pry'
+task :console, [:env] => :boot do |task, args|
+  @bot.pry
+end
+
+#task :default => :start

data/bin/october

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+root = File.expand_path("..", File.dirname(__FILE__))
+
+# this could be just 'october/daemon' when october will be rubygem
+require File.expand_path(File.join('lib', 'october', 'watchdog'), root)
+
+October::Watchdog.new(root, ARGV.shift).loop!

data/boot.rb

@@ -0,0 +1,5 @@
+require 'bundler/setup'
+Bundler.require *[:default, ENV['RACK_ENV'], ENV['OCTOBER_ENV']].compact
+
+$:.unshift File.expand_path('lib')
+$:.unshift File.expand_path('plugins')

data/config/database.yml.example

@@ -0,0 +1,3 @@
+3scale:
+  adapter: sqlite3
+  database: db/3scale.sqlite3

data/config/irc.yml.example

@@ -0,0 +1,9 @@
+3scale:
+  server: irc.freenet.net
+  #port: 61669
+  channels:
+  - '#channel'
+  #password: 'yourpassword'
+  nick: 'nick'
+  ssl:
+    use: true

data/config/plugins.yml.example

@@ -0,0 +1,2 @@
+3scale:
+  - hudson

data/config/redis.yml.example

@@ -0,0 +1,7 @@
+default: &default
+  host: localhost
+
+test:
+  <<: *default
+  namespace: test
+

data/lib/october.rb

@@ -0,0 +1,16 @@
+require 'active_support/core_ext'
+
+module October
+  autoload :Config, 'october/config'
+  autoload :Base, 'october/base'
+  autoload :Environment, 'october/environment'
+  autoload :Redis, 'october/redis'
+  autoload :Debugger, 'october/debugger'
+  autoload :Plugins, 'october/plugins'
+  autoload :Plugin, 'october/plugin'
+
+  def self.root
+    Pathname.new('.').expand_path
+  end
+end
+

data/lib/october/base.rb

@@ -0,0 +1,28 @@
+require 'cinch'
+
+module October
+  class Base < Cinch::Bot
+
+    def self.start
+      new.start
+    end
+
+    include Config
+    include Redis
+    include Plugins.initialize
+
+    def initialize
+      super do
+        load_config!
+
+        on :message, "hello" do |m|
+          m.reply "Hello, #{m.user.nick}"
+        end
+
+      end
+
+    end
+
+  end
+end
+

data/lib/october/config.rb

@@ -0,0 +1,23 @@
+module October
+  module Config
+    extend Environment
+    def load_config!
+      env = Config.configuration('irc.yml')
+      return unless env.present?
+
+      env.each_pair do |key, value|
+        # FIXME: make DRY
+        # FIXME: only one level - bad, only to support SSL nested values for now
+        if value.is_a? Hash
+          subconfig = config.send key.dup
+          value.each_pair do |key, value|
+            subconfig.send key.dup << '=', value
+          end
+        else
+          config.send key.dup << '=', value
+        end
+      end
+    end
+
+  end
+end

data/lib/october/debugger.rb

@@ -0,0 +1,51 @@
+gem 'pry'
+
+module October
+  module Debugger
+    extend ActiveSupport::Concern
+    ##
+    # Extends capabilities of Cinch::IRC to
+    # launch debugger after connecting and creating all threads
+    #
+
+    included do
+
+      self.class_eval do
+        if method_defined? :start
+          alias_pry(:start)
+        elsif method_defined? :connect
+          alias_pry(:connect)
+        else
+          raise 'Unsupported version of Cinch'
+        end
+      end
+
+    end
+
+    module InstanceMethods
+      def init_pry
+        Thread.new do
+          binding.pry
+          Thread.pass
+        end
+
+      end
+    end
+
+    module ClassMethods
+      def alias_pry(before)
+        class_eval %{
+
+          def #{before}_with_pry
+            init_pry
+            #{before}_without_pry
+          end
+
+          alias_method_chain :#{before}, :pry
+        }
+      end
+    end
+
+
+  end
+end

data/lib/october/environment.rb

@@ -0,0 +1,24 @@
+module October
+  module Environment
+    class NoSuchEnvironment < StandardError; end
+
+    def load_configuration(file)
+      config = File.join('config', file)
+      return {} unless File.exists?(config)
+      YAML.load_file( config ).with_indifferent_access
+    end
+
+    def environment
+       ENV['OCTOBER_ENV'].presence || 'default'
+    end
+
+    def configuration(file, env = environment)
+      load_configuration(file)[env.to_sym]
+    end
+
+    def configuration!(file, env = environment)
+      configuration(file, env) or raise NoSuchEnvironment.new("No environment #{env} in file #{file}")
+    end
+
+  end
+end

data/lib/october/plugin.rb

@@ -0,0 +1,26 @@
+require 'active_support/concern'
+require 'cinch'
+
+module October
+  module Plugin
+    autoload :Help, 'october/plugin/help'
+
+    extend ActiveSupport::Concern
+
+    included do
+      include Cinch::Plugin
+      extend Help
+    end
+
+    module ClassMethods
+      def name
+        to_s.underscore
+      end
+
+      def config
+        October::Plugins.config(name)
+      end
+    end
+
+  end
+end

data/lib/october/plugin/help.rb

@@ -0,0 +1,20 @@
+module October
+  module Plugin
+    module Help
+      @@help = {}
+
+      def self.extended(base)
+      end
+
+      def register_help command, description = nil
+        @@help[command] = description
+      end
+
+      def list_help
+        @@help.map do |command, description|
+          ["  !", [command, description].compact.join(' - ')].join
+        end.join("\n")
+      end
+    end
+  end
+end

data/lib/october/plugins.rb

@@ -0,0 +1,94 @@
+module October
+  class Plugins < Array
+    extend Environment
+
+    attr_reader :loaded
+
+    def initialize
+      @loaded = []
+      import Plugins.configuration('plugins.yml')
+    end
+
+    delegate :registered, :configure, :to => :'self.class'
+
+    def import plugins
+      return unless plugins.present?
+
+      plugins = Hash[ plugins.map {|plugin|
+        plugin.respond_to?(:to_a) ? plugin.to_a.flatten(1) : [plugin, {}]
+      }].with_indifferent_access
+
+      names = plugins.keys.map {|name| name.camelize }
+
+      diff = registered.keys & (names - self)
+      push *diff
+      load diff
+
+      self.class.configure(plugins)
+    end
+
+    def imported
+      self
+    end
+
+
+    def load new
+      @loaded.push *new.map{ |plugin|
+        require registered[plugin]
+        plugin.constantize
+      }
+    end
+
+    module PluginMethods
+      extend ActiveSupport::Concern
+
+      included do
+        attr_reader :plugin_module
+      end
+
+      def initialize
+        plugins = Plugins.new
+        super
+        # stupid, really, why so long?
+        self.config.plugins.plugins.push *plugins.loaded
+      end
+
+    end
+
+    class << self
+
+      @@plugins = {}
+      @@configs = {}.with_indifferent_access
+
+      def initialize
+        October.root.join('plugins').
+          each_child(false).
+            each do |file|
+              next unless file.to_s =~ /\.rb$/
+              name = file.basename('.rb').to_s.camelize
+              register name => file
+            end
+
+        PluginMethods
+      end
+
+      def register plugin
+        @@plugins.merge! plugin
+      end
+
+      def config(plugin)
+        @@configs.fetch(plugin, {})
+      end
+
+      def configure(plugin)
+        @@configs.merge! plugin
+      end
+
+      def registered
+        @@plugins
+      end
+
+    end
+
+  end
+end

data/lib/october/redis.rb

@@ -0,0 +1,20 @@
+require 'redis'
+require 'hiredis'
+require 'active_support/core_ext/hash/keys'
+
+module October
+  module Redis
+    extend Environment
+
+    def self.included(base)
+      return unless config = Redis.configuration('redis.yml')
+      # FIXME: parhaps more options, fetch from redis directly, or pass them all and let redis to handle it?
+      redis = ::Redis.new config.slice :host, :port, :path
+      if config.has_key? :namespace
+        redis = ::Redis::Namespace.new config[:namespace], :redis => redis
+      end
+      redis.incr 'launches'
+      $redis = redis
+    end
+  end
+end