twittbot 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 09e59460e2557a87718a9bad72b57d1b42c2a4c3
+  data.tar.gz: 179a82d6023f5b2900d54841538e1aeb1b673564
+SHA512:
+  metadata.gz: ed8bedb456e2ff5d26857f0758797e20f9ece05bca381e8125381807c0b91168fb20b90263cd162cb2cb6ce0560169c234743d0e07ff38e846df1bf0aa64dc84
+  data.tar.gz: fe77b02ea6703e0b22e8cf8004e10a05a6cae7381fca8120b29a95392cca7934ae4603ea8ab0a23e37a61162534c7da05e957d0345f307b301fb3527a134ebb7

data/.gitignore

@@ -0,0 +1,16 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/.idea/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+*.gem

data/.yardopts

@@ -0,0 +1,5 @@
+--exclude /templates/*
+
+*.rb lib/**/*.rb
+-
+*.md

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in twittbot.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Georg G.
+
+MIT License
+
+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,37 @@
+# Twittbot
+
+Twittbot is the next generation of my old Twitter bot, `twittbot-nd`.
+
+## Installation
+
+Installation is just as easy as installing the Rubygem:
+
+    $ gem install twittbot
+
+## Usage
+
+Create a new bot:
+
+    $ twittbot new bot-name
+    $ cd bot-name
+
+Authorize with Twitter:
+
+    $ twittbot auth
+
+Add a template, such as for a simple reply bot:
+
+    $ twittbot generate random-reply
+
+`random-reply` is a template that accepts a configuration.  You can configure
+it by editing `./etc/random_reply.yml` with a text editor of your choice.
+And, if you want to, you can also change its behaviour by editing
+`./lib/random_reply.rb`.
+
+To list available templates, try this:
+
+    $ twittbot list-templates
+
+Finally, run the bot:
+
+    $ twittbot start

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require 'yard'
+
+YARD::Rake::YardocTask.new do |t|
+  t.files = %w(*.rb lib/*.rb lib/**/*.rb - *.md)
+end

data/bin/twittbot

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'twittbot/cli'
+
+Twittbot::CLI.start

data/lib/twittbot.rb

@@ -0,0 +1,4 @@
+require "twittbot/defaults"
+
+module Twittbot
+end

data/lib/twittbot/bot.rb

@@ -0,0 +1,199 @@
+require 'fileutils'
+require 'yaml'
+require 'twitter'
+
+require 'twittbot/defaults'
+require 'twittbot/botpart'
+require 'twittbot/gem_ext/twitter'
+
+module Twittbot
+  # Class providing the streaming connections and callback logic for the bot.
+  class Bot
+
+    include Thor::Shell
+
+    def initialize(options = {})
+      @options = {
+          current_dir: FileUtils.pwd
+      }
+
+      $bot = {
+          callbacks: {},
+          config: YAML.load_file(File.expand_path("./#{Twittbot::CONFIG_FILE_NAME}", @options[:current_dir])),
+          periodic: []
+      }.merge!(options)
+
+      load_bot_code
+    end
+
+    # Authenticates an account with Twitter.
+    def auth
+      require 'oauth'
+      say "This will reset your current access tokens.", :red if already_authed?
+
+      # get the request token URL
+      callback = OAuth::OUT_OF_BAND
+      consumer = OAuth::Consumer.new $bot[:config][:consumer_key],
+                                     $bot[:config][:consumer_secret],
+                                     site: Twitter::REST::Client::BASE_URL,
+                                     scheme: :header
+      request_token = consumer.get_request_token(oauth_callback: callback)
+      url = request_token.authorize_url(oauth_callback: callback)
+
+      puts "Open this URL in a browser: #{url}"
+      pin = ''
+      until pin =~ /^\d+$/
+        print "Enter PIN =>"
+        pin = $stdin.gets.strip
+      end
+
+      access_token = request_token.get_access_token(oauth_verifier: pin)
+      $bot[:config][:access_token] = access_token.token
+      $bot[:config][:access_token_secret] = access_token.secret
+
+      # get the bot's user name (screen_name) and print it to the console
+      $bot[:config][:screen_name] = get_screen_name access_token
+      puts "Hello, #{$bot[:config][:screen_name]}!"
+
+      save_config
+    end
+
+    # Starts the bot.
+    def start
+      check_config
+      $bot[:client] ||= Twitter::REST::Client.new do |cfg|
+        cfg.consumer_key        = $bot[:config][:consumer_key]
+        cfg.consumer_secret     = $bot[:config][:consumer_secret]
+        cfg.access_token        = $bot[:config][:access_token]
+        cfg.access_token_secret = $bot[:config][:access_token_secret]
+      end
+
+      @streamer ||= Twitter::Streaming::Client.new do |cfg|
+        cfg.consumer_key        = $bot[:config][:consumer_key]
+        cfg.consumer_secret     = $bot[:config][:consumer_secret]
+        cfg.access_token        = $bot[:config][:access_token]
+        cfg.access_token_secret = $bot[:config][:access_token_secret]
+      end
+
+      @userstream_thread ||= Thread.new do
+        puts "connected to user stream"
+        @streamer.user do |obj|
+          handle_stream_object obj, :user
+        end
+        puts "lost user stream connection"
+      end
+
+      @tweetstream_thread ||= Thread.new do
+        puts "connected to tweet stream"
+        @streamer.filter track: $bot[:config][:track].join(",") do |obj|
+          handle_stream_object obj, :filter
+        end
+        puts "lost tweet stream connection"
+      end
+
+      @periodic_thread ||= Thread.new do
+        loop do
+          do_periodic
+          sleep 60
+        end
+      end
+
+      @userstream_thread.join
+      @tweetstream_thread.join
+      @periodic_thread.join
+    end
+
+    # Loads the bot's actual code which is stored in the bot's +lib+
+    # subdirectory.
+    def load_bot_code
+      files = Dir["#{File.expand_path('./lib', @options[:current_dir])}/**/*"]
+      files.each do |file|
+        require_relative file.sub(/\.rb$/, '') if file.end_with? '.rb'
+      end
+    end
+
+    # Saves the bot's config (i.e. not the botpart ones).
+    def save_config
+      config = $bot[:config].clone
+      config.delete :client
+      File.open "./#{Twittbot::CONFIG_FILE_NAME}", 'w' do |f|
+        f.write config.to_yaml
+      end
+    end
+
+    # Checks some configuration values, e.g. if the bot is already authenticated with Twitter
+    def check_config
+      unless already_authed?
+        say "Please authenticate using `twittbot auth' first.", :red
+        raise 'Not authenticated'
+      end
+    end
+
+    # Handles a object yielded from a Twitter::Streaming::Client.
+    # @param object [Object] The object yielded from a Twitter::Streaming::Client connection.
+    # @param type [Symbol] The type of the streamer.  Should be either :user or :filter.
+    def handle_stream_object(object, type)
+      opts = {
+          stream_type: type
+      }
+      case object
+        when Twitter::Streaming::FriendList
+          # object: Array with IDs
+          do_callbacks :friend_list, object
+        when Twitter::Tweet
+          # object: Twitter::Tweet
+          is_mention = (object.user.screen_name != $bot[:config][:screen_name] and object.text.include?("@" + $bot[:config][:screen_name]) and not object.retweet?)
+          do_callbacks :retweet, object, opts if object.retweet? and object.retweeted_tweet.user.screen_name == $bot[:config][:screen_name]
+          do_callbacks :mention, object, opts if is_mention
+          do_callbacks :tweet, object, opts.merge({ mention: is_mention, retweet: object.retweet? })
+        when Twitter::Streaming::Event
+          case object.name
+            when :follow, :favorite
+              # :follow   -- object: Twitter::Streaming::Event(name: :follow,   source: Twitter::User, target: Twitter::User)
+              # :favorite -- object: Twitter::Streaming::Event(name: :favorite, source: Twitter::User, target: Twitter::User, target_object: Twitter::Tweet)
+              do_callbacks object.name, object, opts
+            else
+              puts "no handler for #{object.class.to_s}/#{object.name}\n  -- object data:"
+              require 'pp'
+              pp object
+              do_callbacks object.name, object, opts
+          end
+        else
+          puts "no handler for #{object.class.to_s}\n  -- object data:"
+          require 'pp'
+          pp object
+      end
+    end
+
+    # Runs callbacks.
+    # @param callback_type [:Symbol] The callback type.
+    # @param object [Object] The object
+    def do_callbacks(callback_type, object, options = {})
+      $bot[:callbacks][callback_type][:block].call object, options unless $bot[:callbacks][callback_type].nil?
+    end
+
+    def do_periodic
+      $bot[:periodic].each_with_index do |h, i|
+        h[:remaining] = if h[:remaining] == 0
+                          h[:block].call
+                          h[:interval]
+                        else
+                          h[:remaining] - 1
+                        end
+        $bot[:periodic][i] = h
+      end
+    end
+
+    # @return [Boolean] whether the bot is already authenticated or not.
+    def already_authed?
+      !($bot[:config][:access_token].empty? or $bot[:config][:access_token_secret].empty?)
+    end
+
+    private
+
+    def get_screen_name(access_token)
+      oauth_response = access_token.get('/1.1/account/verify_credentials.json?skip_status=true')
+      oauth_response.body.match(/"screen_name"\s*:\s*"(.*?)"/).captures.first
+    end
+  end
+end

data/lib/twittbot/botpart.rb

@@ -0,0 +1,70 @@
+require 'twittbot/defaults'
+require 'pp'
+
+module Twittbot
+  class BotPart
+    # @param name [Symbol] The name of the botpart.  Should be the same as the file name without the extension.
+    def initialize(name, &block)
+      botpart_config_path = File.expand_path("./etc/#{name}.yml")
+      @config = $bot[:config].merge(if File.exist? botpart_config_path
+                                      YAML.load_file botpart_config_path
+                                    else
+                                      {}
+                                    end)
+      instance_eval &block
+    end
+
+    # Adds a new callback to +name+.
+    # @param name [Symbol] The callback type.
+    #   Can be (at least) one of:
+    #
+    #   * :tweet
+    #   * :mention
+    #   * :retweet
+    #   * :favorite
+    #   * :friend_list
+    def on(name, *args, &block)
+      $bot[:callbacks][name] ||= {
+          args: args,
+          block: block
+      }
+    end
+
+    # Runs +block+ every +interval+ +unit+(s).
+    # @param interval [Fixnum]
+    # @param unit [Symbol] the time unit.
+    #   Can be one of:
+    #
+    #   * :minute or :minutes
+    #   * :hour or :hours
+    # @param options [Hash] A customizable set of options.
+    # @option options [Boolean] :run_at_start (true) Run the code in +block+ when the bot finished starting.
+    def every(interval, unit = :minutes, options = {}, &block)
+      raise "Not a Fixnum: #{interval}" unless interval.is_a? Fixnum
+      raise "Interval less than 1" if interval < 1
+
+      opts = {
+          run_at_start: true
+      }.merge(options)
+
+      case unit
+        when :min, :mins, :minute, :minutes
+        when :hr, :hrs, :hour, :hours, :horse
+          interval *= 60
+        else
+          raise "Unknown unit: #{unit}"
+      end
+      $bot[:periodic] << {
+          interval: interval,
+          remaining: opts[:run_at_start] ? 0 : interval,
+          block: block
+      }
+    end
+
+    # @return [Twitter::REST::Client]
+    def client
+      $bot[:client]
+    end
+    alias bot client
+  end
+end

data/lib/twittbot/cli.rb

@@ -0,0 +1,43 @@
+require 'thor'
+
+require 'twittbot/defaults'
+
+module Twittbot
+  class CLI < Thor
+    desc 'new APP_NAME', 'Creates a new Twittbot application.'
+    method_option :template_dir, type: :string, aliases: '-t', desc: 'Specifies the template directory to use', default: Twittbot::TEMPLATE_DIR
+    def new(app_name)
+      require 'twittbot/generators/twittbot/app/app_generator'
+      generator = Twittbot::Generators::AppGenerator.new app_name, options
+      generator.create
+    end
+
+    desc 'auth', 'authorizes with Twitter'
+    def auth
+      require 'twittbot/bot'
+      bot = Twittbot::Bot.new
+      bot.auth
+    end
+
+    desc 'start', 'Starts the bot'
+    def start
+      require 'twittbot/bot'
+      bot = Twittbot::Bot.new
+      bot.start
+    end
+
+    desc 'generate TEMPLATE_NAME', 'Installs a template'
+    def generate(template_name)
+      require 'twittbot/generators/templates/template_generator'
+      generator = Twittbot::Generators::TemplateGenerator.new template_name, options
+      generator.create
+    end
+
+    desc 'list-templates', 'Lists all templates'
+    def list_templates
+      require 'twittbot/template_lister'
+      lister = Twittbot::TemplateLister.new options
+      lister.list
+    end
+  end
+end

data/lib/twittbot/defaults.rb

@@ -0,0 +1,21 @@
+module Twittbot
+  # The version of Twittbot.
+  VERSION = "0.0.1"
+
+  CONSUMER_KEY = 'FYRuQcDbPAXAyVjuPZMuw' # :nodoc:
+  CONSUMER_SECRET = 'KiLCYTftPdxNebl5DNcj7Ey2Y8YVZu7hfqiFRYkcg' # :nodoc:
+
+  # Contains the path to the initial bot template.
+  TEMPLATE_DIR = File.expand_path '../generators/twittbot/app/templates', __FILE__
+  # The name of the bot's config file.
+  CONFIG_FILE_NAME = 'config.yml'
+
+  # Hash containing the default bot configuration.
+  DEFAULT_BOT_CONFIG = {
+    consumer_key: Twittbot::CONSUMER_KEY,
+    consumer_secret: Twittbot::CONSUMER_SECRET,
+    access_token: '',
+    access_token_secret: '',
+    track: []
+  }
+end

data/lib/twittbot/gem_ext/twitter.rb

@@ -0,0 +1,2 @@
+require 'twittbot/gem_ext/twitter/tweet'
+require 'twittbot/gem_ext/twitter/rest/tweets'

data/lib/twittbot/gem_ext/twitter/rest/tweets.rb

@@ -0,0 +1,7 @@
+module Twitter
+  module REST
+    module Tweets
+      alias tweet update
+    end
+  end
+end

data/lib/twittbot/gem_ext/twitter/tweet.rb

@@ -0,0 +1,45 @@
+module Twitter
+  class Tweet
+    # Creates a reply to this tweet.
+    # @param tweet_text [:String] tweet text
+    # @param options [Hash] A customizable set of options.
+    # @option options [Boolean] :reply_all (false) Add all users mentioned in the tweet text to the reply.
+    def reply(tweet_text, options = {})
+      return if $bot.nil? or $bot[:client].nil?
+      opts = {
+        reply_all: false
+      }.merge(options)
+
+      mentions = self.mentioned_users(opts[:reply_all])
+
+      result = "@#{mentions.join(" @")} #{tweet_text}"[(0...140)]
+
+      $bot[:client].update result, in_reply_to_status_id: self.id
+    rescue Twitter::Error => e
+      puts "caught Twitter error while retweeting: #{e.message}"
+    end
+
+    # Retweets this tweet.
+    def retweet
+      return if $bot.nil? or $bot[:client].nil?
+      $bot[:client].retweet self.id
+    rescue Twitter::Error => e
+      puts "caught Twitter error while retweeting: #{e.message}"
+    end
+
+    # Scans the tweet text for screen names.
+    # @param reply_all [Boolean] Include all users in the reply.
+    # @param screen_name [String] The user's screen name (i.e. that one who clicked "Reply")
+    # @return [Array] An array of user names.
+    def mentioned_users(reply_all = true, screen_name = $bot[:config][:screen_name])
+      userlist = [ self.user.screen_name ]
+      if reply_all
+        self.text.scan /@([A-Za-z0-9_]{1,16})/ do |user_name|
+          user_name = user_name[0]
+          userlist << user_name unless userlist.include?(user_name) or screen_name == user_name
+        end
+      end
+      userlist
+    end
+  end
+end

data/lib/twittbot/generators/templates/followback/followback.rb

@@ -0,0 +1,7 @@
+Twittbot::BotPart.new :<%= @template_name %> do
+  on :follow do |obj|
+    if obj.target.screen_name == @config[:screen_name] # only follow source if the target was the bot
+      bot.follow(obj.source.id)
+    end
+  end
+end

data/lib/twittbot/generators/templates/random_reply/random_reply.rb

@@ -0,0 +1,21 @@
+<%
+  # This is the config for this botpart.
+  # It is a hash and will be serialized to YAML and saved to 'etc/template_name.yml'.
+  botpart_config = {
+    replies: [
+      "Yes.",
+      "No.",
+      "Absolutely.",
+      "I don't think so.",
+      "Maybe.",
+    ]
+  }
+%>
+Twittbot::BotPart.new :<%= @template_name %> do
+  # When someone mentions the bot...
+  on :mention do |tweet|
+    # ... reply to the tweet with a random entry of the :replies list that you
+    # configured and also include every person that was mentioned in the tweet.
+    tweet.reply @config[:replies].sample, reply_all: true
+  end
+end

data/lib/twittbot/generators/templates/random_tweet/random_tweet.rb

@@ -0,0 +1,20 @@
+<%
+  # This is the config for this botpart.
+  # It is a hash and will be serialized to YAML and saved to 'etc/template_name.yml'.
+  botpart_config = {
+    tweets: [
+      "I'm a bot!",
+      "Fun fact: I run on @nilsding's Twittbot.  https://github.com/nilsding/twittbot",
+      "My admin is too lazy to change the default values.",
+      "things to do when you're drunk:\n\n1. drink more\n2. repeat step 1",
+      "#{'fox ' * 25}"
+    ]
+  }
+%>
+Twittbot::BotPart.new :<%= @template_name %> do
+  # Every 15 minutes...
+  every 15, :minutes do
+    # ... tweet a random entry of the :tweets list that you configured
+    bot.tweet @config[:tweets].sample
+  end
+end

data/lib/twittbot/generators/templates/retweet_bot/retweet_bot.rb

@@ -0,0 +1,32 @@
+<%
+  # This is the config for this botpart.
+  # It is a hash and will be serialized to YAML and saved to 'etc/template_name.yml'.
+  botpart_config = {
+    tags: [
+      'twittbot',
+      '#nilsding'
+    ]
+  }
+
+  # Display a message after installation template installation
+  post_install_message <<-MSG
+Note: This botpart may require some changes to the bot's config:
+
+  If you want to include tweets from users other than those your bot follows,
+  add the same tags you have in your etc/#{@template_name}.yml to the ':track:'
+  section of your #{::Twittbot::CONFIG_FILE_NAME}.
+MSG
+%>
+Twittbot::BotPart.new :<%= @template_name %> do
+  # When there's a new tweet in the timeline...
+  on :tweet do |tweet, opts|
+    # ... check if the tweet text contains at least one of the tags defined in your config...
+    @config[:tags].each do |tag|
+      if tweet.text.downcase.include? tag.downcase
+        # ... and finally retweet it, if the tweet is not a retweet.
+        tweet.retweet unless opts[:retweet]
+        break
+      end
+    end
+  end
+end

data/lib/twittbot/generators/templates/template_generator.rb

@@ -0,0 +1,77 @@
+require 'fileutils'
+require 'erubis'
+require 'yaml'
+
+module Twittbot
+  module Generators
+    # Class to install a template to the bot.
+    class TemplateGenerator
+      include Thor::Shell
+
+      def initialize(template_name, options)
+        @template_name = template_name.gsub('-', '_')
+        @options = {
+            'template_options' => {}
+        }.merge!(options)
+        @options['template_dir'] = File.expand_path "../#{@template_name}", __FILE__
+        @post_install_messages = []
+      end
+
+      def create
+        files = Dir["#{@options['template_dir']}/**/*"]
+        files.each do |file|
+          real_filename = "lib/#{file.sub(/^#{@options['template_dir']}\//, '').sub(/^_/, '.')}"
+          real_path = File.expand_path "./#{real_filename}"
+
+          botpart_config = {}
+          erb = Erubis::Eruby.new File.read(file)
+          final_result = erb.result(binding)
+
+          if File.exist? real_path
+            say_status :exists, real_filename, :red
+          else
+            say_status :create, real_filename, :green
+            if File.directory? file
+              FileUtils.mkdir_p real_path
+            else
+              File.open real_path, 'w' do |f|
+                f.write final_result
+              end
+            end
+          end
+
+          save_config botpart_config, real_filename unless botpart_config.empty?
+        end
+        unless @post_install_messages.empty?
+          say "Post install messages:", :yellow
+          puts @post_install_messages
+        end
+      end
+
+      # Adds an optional post-install message.
+      # @param msg [String] message to display
+      def post_install_message(msg)
+        @post_install_messages << msg
+      end
+
+      private
+
+      def save_config(config, path)
+        path = "etc/#{path.sub(/^lib\//, '').sub(/\.rb$/, '.yml')}"
+        real_path = File.expand_path "./#{path}"
+
+        if File.exist? real_path
+          say_status :merge, path, :yellow
+          existing_config = YAML.load_file real_path
+          config.merge! existing_config
+        else
+          say_status :create, path, :green
+        end
+
+        File.open real_path, 'w' do |f|
+          f.write config.to_yaml
+        end
+      end
+    end
+  end
+end

data/lib/twittbot/generators/twittbot/app/app_generator.rb

@@ -0,0 +1,59 @@
+require 'fileutils'
+require 'erubis'
+require 'yaml'
+
+require 'twittbot/defaults'
+
+module Twittbot
+  module Generators
+    # Class to generate a new Twittbot bot.
+    class AppGenerator
+      include Thor::Shell
+
+      def initialize(app_name, options = {})
+        @options = {
+            'template_dir' => Twittbot::TEMPLATE_DIR
+        }.merge!(options)
+        @app_name = app_name
+        @options['template_dir'] = File.expand_path @options['template_dir']
+      end
+
+      # Creates the bot.
+      def create
+        path = File.expand_path "./#{@app_name}"
+        if File.exist?(@app_name)
+          say "#{File.directory?(@app_name) ? 'Directory' : 'File'} #{@app_name} already exists", :red
+          exit 1
+        end
+        FileUtils.mkdir_p(path)
+
+        # build the template
+        files = Dir["#{@options['template_dir']}/**/*"]
+        files.each do |file|
+          real_filename = file.sub(/^#{@options['template_dir']}\//, '').sub(/^_/, '.')
+          real_path = "#{path}/#{real_filename}"
+          say_status :create, real_filename, :green
+          if File.directory? file
+            FileUtils.mkdir_p real_path
+          else
+            erb = Erubis::Eruby.new File.read(file)
+            File.open real_path, 'w' do |f|
+              f.write erb.result(binding)
+            end
+          end
+        end
+        generate_config path
+      end
+
+      private
+
+      def generate_config(base_path)
+        say_status :create, Twittbot::CONFIG_FILE_NAME, :green
+
+        File.open "#{base_path}/#{Twittbot::CONFIG_FILE_NAME}", 'w' do |f|
+          f.write Twittbot::DEFAULT_BOT_CONFIG.to_yaml
+        end
+      end
+    end
+  end
+end

data/lib/twittbot/generators/twittbot/app/templates/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+gem 'twittbot'
+

data/lib/twittbot/generators/twittbot/app/templates/README.md

@@ -0,0 +1,20 @@
+# <%= @app_name %>
+
+<%= @app_name %> is a bot created using Twittbot <%= ::Twittbot::VERSION %>.
+
+See [nilsding/twittbot](https://github.com/nilsding/twittbot) to find out
+more about Twittbot.
+
+## Installation and usage
+
+Install this bot's dependencies:
+
+    $ bundle install
+
+Authorize with Twitter for the first time:
+
+    $ bundle exec twittbot auth
+
+And finally run the bot:
+
+    $ bundle exec twittbot start

data/lib/twittbot/generators/twittbot/app/templates/_gitignore

@@ -0,0 +1,2 @@
+# ignore the bot's config as its credentials are saved there
+config.yml

data/lib/twittbot/template_lister.rb

@@ -0,0 +1,22 @@
+module Twittbot
+  # Class to list available templates
+  class TemplateLister
+    include Thor::Shell
+
+    # @param options [Hash] The CLI options from Thor
+    def initialize(options)
+      @options = {}.merge(options)
+      @options['templates_dir'] = File.expand_path "../generators/templates", __FILE__
+    end
+
+    # Prints the available templates to stdout.
+    def list
+      dirs = Dir["#{@options['templates_dir']}/*"]
+      dirs.each do |dir|
+        if File.exist? dir and File.directory? dir
+          say File.basename(dir).gsub('_', '-')
+        end
+      end
+    end
+  end
+end

data/twittbot.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'twittbot/defaults'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'twittbot'
+  spec.version       = Twittbot::VERSION
+  spec.authors       = ['nilsding']
+  spec.email         = ['nilsding@nilsding.org']
+  spec.summary       = %q{An advanced Twitter bot.}
+  spec.description   = %q{Twittbot is an advanced Twitter bot.  See the README for more info.}
+  spec.homepage      = 'https://github.com/nilsding/twittbot'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'thor', '~> 0.19'
+  spec.add_dependency 'erubis', '~> 2.7', '>= 2.7.0'
+  spec.add_dependency 'oauth', '~> 0.4'
+  spec.add_dependency 'twitter', '~> 5.14'
+  spec.add_development_dependency 'yard', '~> 0.8'
+  spec.add_development_dependency 'bundler', '~> 1.7'
+  spec.add_development_dependency 'rake', '~> 10.0'
+end

metadata

@@ -0,0 +1,178 @@
+--- !ruby/object:Gem::Specification
+name: twittbot
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- nilsding
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-02-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.19'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.19'
+- !ruby/object:Gem::Dependency
+  name: erubis
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.7'
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 2.7.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.7'
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 2.7.0
+- !ruby/object:Gem::Dependency
+  name: oauth
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: twitter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '5.14'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '5.14'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: Twittbot is an advanced Twitter bot.  See the README for more info.
+email:
+- nilsding@nilsding.org
+executables:
+- twittbot
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .yardopts
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/twittbot
+- lib/twittbot.rb
+- lib/twittbot/bot.rb
+- lib/twittbot/botpart.rb
+- lib/twittbot/cli.rb
+- lib/twittbot/defaults.rb
+- lib/twittbot/gem_ext/twitter.rb
+- lib/twittbot/gem_ext/twitter/rest/tweets.rb
+- lib/twittbot/gem_ext/twitter/tweet.rb
+- lib/twittbot/generators/templates/followback/followback.rb
+- lib/twittbot/generators/templates/random_reply/random_reply.rb
+- lib/twittbot/generators/templates/random_tweet/random_tweet.rb
+- lib/twittbot/generators/templates/retweet_bot/retweet_bot.rb
+- lib/twittbot/generators/templates/template_generator.rb
+- lib/twittbot/generators/twittbot/app/app_generator.rb
+- lib/twittbot/generators/twittbot/app/templates/Gemfile
+- lib/twittbot/generators/twittbot/app/templates/README.md
+- lib/twittbot/generators/twittbot/app/templates/_gitignore
+- lib/twittbot/generators/twittbot/app/templates/etc/.keep
+- lib/twittbot/generators/twittbot/app/templates/lib/.keep
+- lib/twittbot/template_lister.rb
+- twittbot.gemspec
+homepage: https://github.com/nilsding/twittbot
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: An advanced Twitter bot.
+test_files: []
+has_rdoc: