extraextra 0.1.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,19 @@
+.DS_Store
+
+*.tmproj
+tmtags
+
+*~
+<<<<<<< HEAD
+\#*
+.\#*
+
+*.swp
+
+coverage
+rdoc
+pkg
+=======
+.bundle/*
+*.swp
+>>>>>>> setting up rspec

data/Gemfile

@@ -0,0 +1,11 @@
+source "http://rubygems.org"
+
+# gem "candy" #not for now
+gem "mongo"
+gem "bson_ext"
+gem "jeweler"
+gem "rake"
+
+group :test do
+  gem "rspec"
+end

data/Gemfile.lock

@@ -0,0 +1,28 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    bson (1.0.7)
+    bson_ext (1.0.7)
+    gemcutter (0.6.1)
+    git (1.2.5)
+    jeweler (1.4.0)
+      gemcutter (>= 0.1.0)
+      git (>= 1.2.5)
+      rubyforge (>= 2.0.0)
+    json_pure (1.4.6)
+    mongo (1.0.8)
+      bson (>= 1.0.5)
+    rake (0.8.7)
+    rspec (1.3.0)
+    rubyforge (2.0.4)
+      json_pure (>= 1.1.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bson_ext
+  jeweler
+  mongo
+  rake
+  rspec

data/LICENSE

@@ -0,0 +1,13 @@
+           DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+                   Version 2, December 2004
+ 
+Copyright (C) 2010 Steve Klabnik, steve@steveklabnik.com
+Everyone is permitted to copy and distribute verbatim or modified
+copies of this license document, and changing it is allowed as long
+as the name is changed.
+ 
+           DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+  TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+ 
+ 0. You just DO WHAT THE FUCK YOU WANT TO.
+

data/README.md

@@ -0,0 +1,107 @@
+EXTRA! EXTRA! READ ALL ABOUT IT!
+================================
+
+Need to add a news feed to your application? EXTRA! EXTRA! is just the Gem 
+for you! This is a common need for many social applications. EXTRA! EXTRA! 
+uses MongoDB to give you super fast, super convenient feeds.
+
+## Quick Note ###############################################################
+
+Not all of this works yet. This is just a prerelease. README driven
+development FTW!
+
+## Install ##################################################################
+
+EXTRA! EXTRA! will be distributed via Rubygems, so just 
+
+    $ gem install extraextra
+
+and you'll be reading the news in no time!
+
+## Source ###################################################################
+
+The source of EXTRA! EXTRA! is on GitHub, and can be found here:
+
+    http://github.com/steveklabnik/extraextra
+
+It can be cloned via
+
+    $ git clone git://github.com/steveklabnik/extraextra.git
+
+## Requirements #############################################################
+
+* **Ruby 1.9** Sorry for you 1.8 people, 1.9 is the current version of Ruby.
+* **mongo** If you're going to use MongoDB...
+
+## Usage ####################################################################
+
+The first thing you'll need to do is configure EXTRA! EXTRA! to use your 
+MongoDB installation. 
+
+    Extra::Extra.source :host => "localhost", :port => "1337"
+
+To record something newsworthy, just do this:
+
+    $ Extra::Extra::! :breaking, user, "has just done something awesome!"
+
+To find out what interesting things a particular user has done:
+
+    $ Extra::Extra.read_all_about_it user
+
+or
+
+    $ Extra::Extra.the_scoop user
+
+This returns an array of Extra objects. To find out more about a particular
+ Extra:
+
+    $ extra = Extra::Extra::! :sports, user, "hit a home run!"
+
+    $ extra.who?
+     => #<User:0x0000010089ea80> 
+    $ extra.what?
+     => "hit a home run"
+    $ extra.where?
+     => nil # currently undecided
+    $ extra.when?
+     => 1283311813 
+    $ extra.how?
+     => nil # currently undecided
+    $ extra.to_s
+     => "Steve hit a home run"
+
+The name in to_s comes from user#username. If you use something else... 
+I'll provide a way to override this eventually.
+
+To only see breaking news:
+
+    $ user.breaking_news
+
+This will filter out only the news in the 'breaking' category.
+
+To find out what interesting things a users's friends have done:
+
+    $ user.scope_the_scene
+
+To define what who you're friends with, make a method on your user model
+named my_peeps. For a (hypothetical) example:
+
+    class User
+      def my_peeps
+        User.friends.collect(&:id)
+      end
+    end
+
+The my_peeps method should return an Array of ids. This method will be 
+called during scope_the_scene to determine what results get returned.
+
+## Contributing #############################################################
+
+Fork, commit, pull request. Bonus points for topic branches and great commit
+messages.
+
+In particular, I will accept most patches that add good aliases for methods.
+
+## This is just a cleverly named logging framework ##########################
+
+No, it's not. Shut up.

data/README.rdoc

@@ -0,0 +1,109 @@
+= EXTRA! EXTRA! READ ALL ABOUT IT!
+
+Need to add a news feed to your application? EXTRA! EXTRA! is just the Gem 
+for you! This is a common need for many social applications. EXTRA! EXTRA! 
+uses MongoDB to give you super fast, super convenient feeds.
+
+== Quick Note
+
+Not all of this works yet. This is just a prerelease. README driven
+development FTW!
+
+== Install
+
+EXTRA! EXTRA! will be distributed via Rubygems, so just 
+
+    $ gem install extraextra
+
+and you'll be reading the news in no time!
+
+== Source
+
+The source of EXTRA! EXTRA! is on GitHub, and can be found here:
+
+    http://github.com/steveklabnik/extraextra
+
+It can be cloned via
+
+    $ git clone git://github.com/steveklabnik/extraextra.git
+
+== Requirements
+
+* **Ruby 1.9** Sorry for you 1.8 people, 1.9 is the current version of Ruby.
+* **mongo** If you're going to use MongoDB...
+
+== Usage
+
+The first thing you'll need to do is configure EXTRA! EXTRA! to use your 
+MongoDB installation. 
+
+    Extra::Extra.source :host => "localhost", :port => "1337"
+
+To record something newsworthy, just do this:
+
+    $ Extra::Extra::! :breaking, user, "has just done something awesome!"
+
+To find out what interesting things a particular user has done:
+
+    $ Extra::Extra.read_all_about_it user
+
+or
+
+    $ Extra::Extra.the_scoop user
+
+This returns an array of Extra objects. To find out more about a particular
+ Extra:
+
+    $ extra = Extra::Extra::! :sports, user, "hit a home run!"
+
+    $ extra.who?
+     => #<User:0x0000010089ea80> 
+    $ extra.what?
+     => "hit a home run"
+    $ extra.where?
+     => nil # currently undecided
+    $ extra.when?
+     => 1283311813 
+    $ extra.how?
+     => nil # currently undecided
+    $ extra.to_s
+     => "Steve hit a home run"
+
+The name in to_s comes from user#username. If you use something else... 
+I'll provide a way to override this eventually.
+
+To only see breaking news:
+
+    $ user.breaking_news
+
+This will filter out only the news in the 'breaking' category.
+
+To find out what interesting things a users's friends have done:
+
+    $ user.scope_the_scene
+
+To define what who you're friends with, make a method on your user model
+named my_peeps. For a (hypothetical) example:
+
+    class User
+      def my_peeps
+        User.friends.collect(&:id)
+      end
+    end
+
+The my_peeps method should return an Array of ids. This method will be 
+called during scope_the_scene to determine what results get returned.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2010 Steve Klabnik. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,48 @@
+require "rubygems"
+require "bundler/setup"
+
+#require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "extraextra"
+    gem.summary = %Q{Super simple news feeds powered by MongoDB.}
+    gem.description = %Q{Need to add a news feed to your application? EXTRA! EXTRA! is just the Gem for you! This is a common need for many social applications. EXTRA! EXTRA! uses MongoDB to give you super fast, super convenient feeds.}
+    gem.email = "steve@steveklabnik.com"
+    gem.homepage = "http://github.com/steveklabnik/extraextra"
+    gem.authors = ["Steve Klabnik"]
+    gem.add_development_dependency "rspec", "=1.3.0"
+    gem.add_dependency "mongo", "=1.0.8"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "extraextra #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/extraextra.gemspec

@@ -0,0 +1,64 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{extraextra}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Steve Klabnik"]
+  s.date = %q{2010-09-01}
+  s.description = %q{Need to add a news feed to your application? EXTRA! EXTRA! is just the Gem for you! This is a common need for many social applications. EXTRA! EXTRA! uses MongoDB to give you super fast, super convenient feeds.}
+  s.email = %q{steve@steveklabnik.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.md",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "Gemfile",
+     "Gemfile.lock",
+     "LICENSE",
+     "README.md",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "extraextra.gemspec",
+     "lib/extra/extra.rb",
+     "lib/extraextra.rb",
+     "spec/extraextra_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb",
+     "test.rb"
+  ]
+  s.homepage = %q{http://github.com/steveklabnik/extraextra}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Super simple news feeds powered by MongoDB.}
+  s.test_files = [
+    "spec/extraextra_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, ["= 1.3.0"])
+      s.add_runtime_dependency(%q<mongo>, ["= 1.0.8"])
+    else
+      s.add_dependency(%q<rspec>, ["= 1.3.0"])
+      s.add_dependency(%q<mongo>, ["= 1.0.8"])
+    end
+  else
+    s.add_dependency(%q<rspec>, ["= 1.3.0"])
+    s.add_dependency(%q<mongo>, ["= 1.0.8"])
+  end
+end
+

data/lib/extra/extra.rb

@@ -0,0 +1,38 @@
+require 'mongo'
+include Mongo
+
+module Extra
+
+  class Extra
+
+
+    class << self
+      attr_accessor :db, :collection
+
+      def source opts={}
+        opts[:host] ||= "localhost"
+        opts[:port] ||= 27017
+        self.db = Mongo::Connection.new(opts[:host], opts[:port]).db("extraextra")
+        self.collection = db["extras"]
+      end
+
+      def !(category, user, text)
+        collection.insert category: category,
+                           who_id: user.id,
+                           who_name: user.username,
+                           who_class: user.class.to_s,
+                           what: text,
+                           when: Time.now.to_s
+      end
+
+      def read_all_about_it user
+        
+        collection.find(who_id: user.id,
+                        who_class: user.class.to_s
+                       ).to_a
+        
+      end
+    end
+
+  end
+end

data/spec/extraextra_spec.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Extraextra" do
+  it "fails" do
+    fail "hey buddy, you should probably rename this file and start specing for real"
+  end
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'extraextra'
+require 'spec'
+require 'spec/autorun'
+
+Spec::Runner.configure do |config|
+  
+end

data/test.rb

@@ -0,0 +1,19 @@
+require './lib/extra/extra.rb'
+
+class User
+	attr_accessor :id, :username
+end
+
+steve = User.new
+steve.id = 1
+steve.username = "steve"
+
+Extra::Extra.source
+
+Extra::Extra.! :breaking, steve, "won at everything!"
+
+extras = Extra::Extra.read_all_about_it(steve)
+
+extras.each do |extra|
+	puts extra.to_s
+end

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification 
+name: extraextra
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Steve Klabnik
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-09-01 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 3
+        - 0
+        version: 1.3.0
+  type: :development
+  prerelease: false
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: mongo
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 0
+        - 8
+        version: 1.0.8
+  type: :runtime
+  prerelease: false
+  version_requirements: *id002
+description: Need to add a news feed to your application? EXTRA! EXTRA! is just the Gem for you! This is a common need for many social applications. EXTRA! EXTRA! uses MongoDB to give you super fast, super convenient feeds.
+email: steve@steveklabnik.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.md
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- README.rdoc
+- Rakefile
+- VERSION
+- extraextra.gemspec
+- lib/extra/extra.rb
+- lib/extraextra.rb
+- spec/extraextra_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- test.rb
+has_rdoc: true
+homepage: http://github.com/steveklabnik/extraextra
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 4012342464942348992
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Super simple news feeds powered by MongoDB.
+test_files: 
+- spec/extraextra_spec.rb
+- spec/spec_helper.rb