railsquest 0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in railsquest.gemspec
+gem 'rest-client'

data/Rakefile

@@ -0,0 +1,26 @@
+lib = File.expand_path('../lib/', __FILE__)
+$:.unshift lib unless $:.include?(lib)
+
+desc "Boot up railsquest"
+task :default do
+  exec "bundle exec bin/railsquest"
+end
+
+desc "Boot up just the web interface"
+task :web do
+  exec "bundle exec thin start -c #{File.dirname(__FILE__)}/sinatra -p 4567"
+end
+
+require "railsquest/version"
+version = Railsquest::VERSION
+gem_name = "railsquest-#{version}.gem"
+
+desc "Build #{gem_name}"
+task :build do
+  system "gem build railsquest.gemspec"
+end
+
+desc "Tag and push #{gem_name}"
+task :push => :build do
+  system "git tag #{version} && git push && git push --tags && gem push #{gem_name}"
+end

data/Readme.md

@@ -0,0 +1,134 @@
+Railsquest - Propose and pursue quests for Ruby programming glory!
+==================================================================
+
+Pursue fame and glory by discovering and completing Quests, or offer a Quest to challenge your friends!
+As you complete Quests, your trophy page will slowly fill up with your achievement badges.
+
+Railsquest brings the magic of Bonjour auto-discovery to find Quests and other Challengers in your network.
+
+Installation and usage
+----------------------
+
+Install it (from [gemcutter](http://gemcutter.org/)) via gems:
+
+    gem install railsquest
+
+(you might need to do a `gem sources -a http://gemcutter.org` beforehand!)
+
+Start it up:
+
+    railsquest
+
+Then fire up [http://localhost:9876/](http://localhost:9876/) to begin your quest for the holy (g)rails!
+
+Your name, as it will be seen by other people, is taken from your git global config setting.
+
+You will see a list of all current adventurers, and a list of all available quests.
+You can inspect the badges that have been won by other adventurers, and visit the quests to try them yourself.
+
+How to create a quest
+---------------------
+
+Your quest is a web application running on your machine.
+You can run it on any port you choose.
+To make the quest available to other adventurers, add it to your railsquests:
+
+railsquest add <port> "Name of your quest"
+
+Specify the correct port number, and the name of your quest.
+
+An adventurer will commence your quest by browsing from their Railsquest page.
+Your quest application will receive a GET request with a "host" parameter.
+The host is the computer hostname of the challenger (again from the git global config).
+(TODO: We also need to make the adventurer's personal name available)
+
+When you decide that an adventurer has completed your quest, you must notify
+your local Railsquest server of their success by posting two parameters to
+
+http://localhost:9876/submit
+
+The post must contain these two parameters:
+
+* The adventurer's "hostname"
+* The "quest_name"
+
+For example:
+
+  require 'rest-client'
+
+  RestClient.post 'http://localhost:9876/submit', :hostname => hostname, :quest_name => 'My Funky Quest'
+
+Or using JQuery:
+
+  $.post('http://localhost:9876/submit', {hostname: hostname, quest_name: 'My Funky Quest'});
+
+Railsquest will then sign these facts into an achievement badge that will be displayed on the adventurer's trophy page!
+
+Linux support
+-------------
+
+To install the dnssd gem on Linux you'll need [avahi](http://avahi.org/). For Ubunutu peeps this means:
+
+    sudo aptitude update
+
+    sudo aptitude install g++ ruby-dev \
+     libavahi-compat-libdnssd-dev avahi-discover avahi-utils
+
+and you'll need to set the domain-name:
+
+    sudo sed -i \
+     -e 's/#domain-name=local/domain-name=local/' \
+     /etc/avahi/avahi-daemon.conf
+
+    sudo service avahi-daemon restart
+
+You can debug whether or not Avahi can see Railsquest and git-daemon Bonjour statuses using the command 'avahi-browse'.  This command can be found in the package 'avahi-utils'.
+
+The following command will show you all of the Bonjour services running on your local network:
+
+    avahi-browse --all
+
+If you kill railsquest with kill -9 it doesn't get a chance to unregister the Bonjour services, and when it is restarted it will die with DNSSD::AlreadyRegisteredError.  Although not ideal, you can work around this my restarting avahi-daemon first.
+
+Note: You might have to restart the avahi-daemon sometimes if you are having problems seeing other railsquests.
+
+Developing
+----------
+
+    bundle install
+    rake -T
+
+Contributors
+------------
+
+* [Sam Dalton](http://github.com/samdalton/)
+* [Michael Dowse](http://michaeldowse.name/)
+* [Clifford Heath](http://dataconstellation.com/)
+* [Eaden McKee](@eadz)
+* [Cameron Walsh]
+
+With blithe cribbage from bananajour by...
+* [Tim Lucas](http://www.toolmantim.com)
+* [Carla Hackett](http://carlahackettdesign.com/) (logo)
+* [Nathan de Vries](http://github.com/atnan)
+* [Lachlan Hardy](http://github.com/lachlanhardy)
+* [Josh Bassett](http://github.com/nullobject)
+* [Myles Byrne](http://github.com/quackingduck)
+* [Ben Hoskings](http://github.com/benhoskings)
+* [Brett Goulder](http://github.com/brettgo1)
+* [Tony Issakov](https://github.com/tissak)
+* [Mark Bennett](http://github.com/MarkBennett)
+* [Travis Swicegood](http://github.com/tswicegood)
+* [Nate Haas](http://github.com/natehaas)
+* [James Sadler](http://github.com/freshtonic)
+* [Jason King](http://github.com/JasonKing)
+* [Michael Pope](http://github.com/map7)
+
+License
+-------
+
+All directories and files are MIT Licensed.
+
+Warning to all those who still believe secrecy will save their revenue stream
+-----------------------------------------------------------------------------
+Bananas were meant to be shared. There are no secret bananas.

data/bin/railsquest

@@ -0,0 +1,61 @@
+#!/usr/bin/env ruby
+
+lib = File.expand_path('../../lib/', __FILE__)
+$:.unshift lib unless $:.include?(lib)
+
+require 'railsquest'
+
+Thread.abort_on_exception = true
+
+Railsquest.setup! if !Railsquest.setup?
+
+parent_process_pid = Process.pid
+pids = []
+at_exit do 
+  if Process.pid == parent_process_pid
+    pids.each do |pid| 
+      Process.kill("TERM", pid) rescue nil
+      sleep 0.2
+    end
+  end
+end
+
+case ARGV.first
+
+when nil
+  pids << Railsquest.serve_web!
+  pids << Railsquest.advertise!
+  Process.waitall
+
+when "add", "init"
+  quest = Railsquest.add!(ARGV[1], ARGV[2])
+
+when "remove", "rm"
+  name = ARGV[1]
+
+  if !name || name.empty?
+    abort "You need to specify the name of the quest you'd like to remove:\n#{File.basename($0)} remove <path>"
+  elsif !(quest = Railsquest::Quest.for_name(name))
+    abort "#{name.inspect} is not a valid quest name"
+  end
+
+  quest.remove!
+
+when "help", "--help", "-h"
+  puts <<-HELP
+Usage: #{File.basename($0)} [<command>]
+
+Commands:
+  none               - Start the web, quest, and bonjour serving
+  add <port> <name>         - Add a quest running on server port with given name
+  remove <name>      - Remove a quest 
+  help
+  version
+HELP
+
+when "version", "--version", "-v"
+  puts "railsquest version #{Railsquest::VERSION}"
+
+else
+  abort "Say what? Try: #{File.basename($0)} help"
+end

data/development.log

@@ -0,0 +1 @@
+# Logfile created on 2011-03-19 00:36:04 +1300 by logger.rb/25413

data/lib/railsquest.rb

@@ -0,0 +1,119 @@
+libdir = File.dirname(__FILE__)
+$LOAD_PATH.unshift(libdir) unless $LOAD_PATH.include?(libdir)
+
+require 'railsquest/quest'
+require 'railsquest/badge'
+require 'railsquest/grit_extensions'
+require 'railsquest/version'
+require 'railsquest/bonjour'
+require 'railsquest/helpers'
+require 'railsquest/commands'
+
+require 'ostruct'
+require 'socket'
+require 'pathname'
+require 'rest-client'
+
+module Railsquest
+
+  class << self
+
+    include DateHelpers
+    include GravatarHelpers
+    include Commands
+
+    def setup?
+      quests_path.exist?
+      badges_path.exist?
+    end
+
+    def setup!
+      quests_path.mkpath
+      badges_path.mkpath
+    end
+
+    def path
+      Pathname("~/.railsquest").expand_path
+    end
+
+    def quests_path
+      path + "quests"
+    end
+
+    def badges_path
+      path + "badges"
+    end
+
+    def get_git_global_config(key)
+      `git config --global #{key}`.strip
+    end
+
+    def config
+      @config ||= begin
+        OpenStruct.new({
+          :name => get_git_global_config("user.name"),
+          :email => get_git_global_config("user.email")
+        })
+      end
+    end
+
+    def web_port
+      9876
+    end
+
+    def web_uri
+      "http://#{host_name}:#{web_port}/"
+    end
+
+    def host_name
+      hn = get_git_global_config("railsquest.hostname")
+      unless hn.nil? or hn.empty?
+        return hn
+      end
+
+      hn = Socket.gethostname
+
+      # if there is more than one period in the hostname then assume it's a FQDN
+      # and the user knows what they're doing
+      return hn if hn.count('.') > 1
+
+      if hn =~ /\.local$/
+        hn
+      else
+        hn + ".local"
+      end
+    end
+
+    def quest_uri
+      "http://#{host_name}/"
+    end
+
+    def quests
+      quests_path.children.reject{ |b| b.to_s =~ /DS_Store/}.map {|q| Quest.new(q)  }
+    end
+
+    def quest(name)
+      quests.find {|r| r.name == name}
+    end
+
+    def badges
+       badges_path.children.reject{ |b| b.to_s =~ /DS_Store/}.map {|b| Badge.new(b).to_hash }
+    end
+
+    def to_hash
+      {
+        "name" => config.name,
+        "email" => config.email,
+        "uri"  => web_uri,
+        "git-uri" => quest_uri,
+        "gravatar" => Railsquest.gravatar,
+        "version" => Railsquest::VERSION,
+        "quests" => quests.collect do |r|
+          {"name" => r.name, "uri" => r.uri}
+        end
+      }
+    end
+
+  end
+
+end

data/lib/railsquest/badge.rb

@@ -0,0 +1,84 @@
+require 'pathname'
+
+module Railsquest
+  class Badge
+
+    attr_accessor :name
+
+    def self.for_name(name)
+      n = name.gsub(' ', '_')
+      q = new(Railsquest.badges_path.join(n + ".badge"))
+      q.name = n
+      q
+    end
+
+    def self.html_id(name)
+      name.gsub(/[^A-Za-z-]+/, '').downcase
+    end
+
+    def initialize(path)
+      @path = Pathname(path)
+    end
+
+    def ==(other)
+      other.respond_to?(:path) && self.path == other.path
+    end
+
+    attr_reader :path
+
+    def exist?
+      path.exist?
+    end
+
+    def init!(signature, original_host)
+        contents =  '{\"signature\" : \"' + signature + '\", \"original_host\" : \"' + original_host +  '\"}'
+        Dir.chdir(Railsquest.badges_path) { `echo #{contents} >> #{path}` }
+    end
+
+    def uri
+      Railsquest.quest_uri.gsub(/\/$/, '') + ':' + File.open(path) { |f| f.gets }
+    end
+
+    def name
+      dirname.sub(".badge",'')
+    end
+
+    def html_id
+      self.class.html_id(name)
+    end
+
+    def dirname
+      path.split.last.to_s
+    end
+
+    def to_s
+      name
+    end
+
+    def web_uri
+      Railsquest.web_uri + "#" + html_id
+    end
+
+    def remove!
+      path.rmtree
+    end
+    
+    def verified?
+        contents = JSON.parse(File.read(path))
+        begin
+          RestClient.post 'http://' + contents['original_host'] + ':' + Railsquest.web_port.to_s + '/verify', { :signature => contents['signature'], :quest_name => name, :hostname => Railsquest.host_name }
+        rescue
+          false
+        end
+    end
+
+    def to_hash
+        contents = JSON.parse(File.read(path))
+      {
+          "original_host" => contents['original_host'],
+          "signature" => contents['signature'],
+        "name" => name
+      }
+    end
+  end
+end

data/lib/railsquest/bonjour.rb

@@ -0,0 +1,9 @@
+module Railsquest::Bonjour
+end
+
+require 'railsquest/bonjour/person'
+require 'railsquest/bonjour/quest'
+require 'railsquest/bonjour/browser'
+require 'railsquest/bonjour/quest_browser'
+require 'railsquest/bonjour/railsquest_browser'
+require 'railsquest/bonjour/advertiser'