oldness 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+.idea
+.bundle
+Gemfile.lock
+pkg

data/Gemfile

@@ -0,0 +1,4 @@
+source :rubygems
+
+gem 'rspec'
+gem 'thor'

data/bin/oldness

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift(File.expand_path(File.dirname(__FILE__)) + '/../lib/')
+
+require 'oldness'
+
+# todo: detect pluralization?
+Oldness::CLI.start
+

data/config.ru

@@ -0,0 +1,2 @@
+require './api'
+run Sinatra::Application

data/lib/oldness/cli.rb

@@ -0,0 +1,37 @@
+require 'thor'
+
+module Oldness
+
+  class CLI < Thor
+
+    desc "rate MEDIUM DATE", "give a star rating of oldness for a work in MEDIUM made on DATE"
+    def rate(medium, date)
+      print "#{get_class(medium).rate(date, :formatted => true)}\n"
+    end
+    map "rating" => "rate"
+
+    desc "ranges MEDIUM", "show what dates fall under what star ratings for a work in MEDIUM"
+    def ranges(medium)
+      print "#{get_class(medium).ranges(:formatted=>true)}\n"
+    end
+    map "range" => "ranges"
+
+    desc "first MEDIUM", "print the first work in MEDIUM"
+    def first(medium)
+      print "#{get_class(medium).first}\n"
+    end
+
+    desc "media", "List what mediums can be used in other commands"
+    def media
+      print Oldness::media.collect(&:to_s).sort.inject("") { |l, c| l + c.sub("Oldness::", "")+"\n"}.downcase
+    end
+    map "mediums" => "media"
+    map "list" => "media"
+
+    no_tasks do
+      def get_class(medium)
+        eval("Oldness::" + medium.split('-').collect(&:capitalize).inject(:+))
+      end
+    end
+  end
+end

data/lib/oldness/medium.rb

@@ -0,0 +1,119 @@
+require 'date'
+require 'oldness/work'
+
+module Oldness
+  def self.media
+    list = []
+    ObjectSpace.each_object(Class) do |c|
+      next unless c.superclass == Medium
+      list << c
+    end
+    list
+  end
+
+  class Medium
+    def self.ranges(args={})
+      current_date = args[:when] ? args[:when] : Date.today
+      span = (current_date-first.date)
+      unit = span/81
+      ranges = {5 => (first.date..current_date-27*unit),
+                4 => (current_date-27*unit..current_date-9*unit),
+                3 => (current_date-9*unit..current_date-3*unit),
+                2 => (current_date-3*unit..current_date-unit),
+                1 => (current_date-unit..current_date)}
+      if args[:formatted]
+        f_ranges = ""
+        ranges.each do |stars, range|
+          f_ranges += ("*" * stars) + (" " * (5-stars)) + ": #{range}\n"
+        end
+        f_ranges.chomp
+      else
+        ranges
+      end
+    end
+
+    def self.rate(work_date, args={})
+      work_date = parse_date(work_date)
+
+      formatted = args[:formatted]
+      args[:formatted] = nil
+      rating = ranges(args).find {|key, range| range.cover?(work_date)}[0]
+
+      if formatted
+        "*" * rating
+      else
+        rating
+      end
+    end
+
+    def self.began(date, args={})
+      @first = Work.new(date, :title => args[:with], :by => args[:by])
+      def self.first
+        @first
+      end
+    end
+
+    private
+    def self.parse_date(date)
+      begin
+        date_info = date.split("-")
+      rescue NoMethodError
+        return date
+      end
+
+      if date_info[0].downcase.end_with?('bc')
+        date_info[0][-2..-1] = ""
+        date_info[0].insert(0,'-')
+      end
+
+      Date.new(*date_info.map {|v| v.to_i})
+    end
+  end
+
+  class Literature < Medium
+    began Date.new(-1300), :with => "The Epic of Gilgamesh"
+  end
+
+  class Philosophy < Medium
+    began Date.new(-800), :with => "The Upanishads"
+  end
+  Religion = Philosophy # now that's what I call opinionated software
+
+  class SciFi < Medium
+    began Date.new(1620), :with => "Somnium", :by => "Johannes Kepler"
+  end
+
+  class Novel < Medium
+    began Date.new(1010), :with => "Tale of Genji", :by => "Murasaki Shikibu"
+  end
+  Book = Novel
+
+  class Film < Medium
+    began Date.new(1894, 2, 5), :by => "Jean Le Roy"
+  end
+  Movie = Film
+
+  class Comic < Medium
+    began Date.new(1837), :with => "Histoire de M. Vieux Bois", :by => "Rodolphe Topffer" # todo: Töpffer
+  end
+  Manga = Comic
+
+  class Videogame < Medium
+    began Date.new(1951, 5, 4), :with => "Nimrod", :by => "Ferranti International plc"
+  end
+
+  class History < Medium
+    began Date.new(-411), :with => "History of the Pelopnnesian War", :by => "Thucydides"
+  end
+
+  class Animation < Medium
+    began Date.new(1906, 4, 6), :with => "Humorous Phases of Funny Faces", :by => "J. Stuart Blackton"
+  end
+  Cartoon = Animation
+  Anime = Animation
+
+  class Rpg < Medium
+    began Date.new(1974), :with => "Dungeons & Dragons", :by => "Gary Gygax and David Arneson"
+  end
+
+end

data/lib/oldness/version.rb

@@ -0,0 +1,3 @@
+module Oldness
+  VERSION = "0.0.1"
+end

data/lib/oldness/work.rb

@@ -0,0 +1,32 @@
+module Oldness
+  class Work
+    def by
+      @by ? @by : "Unknown"
+    end
+    def title
+      @title ? @title : "Untitled"
+    end
+    attr_accessor :date
+    def initialize(date, args={})
+      @date, @title, @by = date, args[:title], args[:by]
+    end
+    def to_s
+      if date.yday == 1
+        if date.year < 0
+          f_date = (date.year * -1).to_s + "BC"
+        else
+          f_date = "#{date.year}"
+        end
+      elsif date.mday == 1
+        f_date = date.strftime("%B %Y")
+      else
+        f_date = date.strftime("%B %-d, %Y")
+      end
+      str = "#{title} (#{f_date})"
+      if @by
+        str += ", by #{@by}"
+      end
+      str
+    end
+  end
+end

data/lib/oldness.rb

@@ -0,0 +1,2 @@
+require_relative 'oldness/cli'
+require_relative 'oldness/medium'

data/oldness.gemspec

@@ -0,0 +1,29 @@
+$:.push File.expand_path("../lib", __FILE__)
+require 'oldness/version'
+
+Gem::Specification.new do |s|
+  s.name = 'oldness'
+  s.version = Oldness::VERSION
+  s.platform = Gem::Platform::RUBY
+  s.date = '2011-12-20'
+  s.authors = ['Nick Novitski']
+  s.email = 'nicknovitski@gmail.com'
+  s.homepage = 'http://github.com/njay/oldness'
+  s.summary = 'Instant historical perspective'
+  s.description = 'A library and shell command that rates the age of different types of things on a five-star system'
+
+  s.required_rubygems_version = '>= 1.3.7'
+  s.specification_version = 3
+
+  ignores = File.readlines(".gitignore").grep(/\S+/).map {|s| s.chomp }
+  dotfiles = [".gitignore"]
+
+  s.files = Dir["**/*"].reject {|f| File.directory?(f) || ignores.any? {|i| File.fnmatch(i, f) } } + dotfiles
+  s.test_files = s.files.grep(/^spec\//)
+  s.require_paths = ['lib']
+  s.executables = ['oldness']
+
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'bundler'
+  s.add_dependency 'thor', '~> 0.14'
+end

data/readme.markdown

@@ -0,0 +1,65 @@
+# oldness
+
+Oldness is a library and shell command that places the age of a published work on a semi-arbitrary five-star scale.
+
+## Installation
+
+     gem install oldness
+
+     require 'oldness'
+
+## Usage
+
+### CLI
+
+     $ oldness list
+     animation
+     comic
+     film
+     history
+     literature
+     novel
+     philosophy
+     rpg
+     scifi
+     videogame
+     $ oldness rate comic 1987-10
+     ****
+     $ oldness ranges movie
+     *****: 1894-02-05..1972-09-14
+     **** : 1972-09-14..1998-11-27
+     ***  : 1998-11-27..2007-08-22
+     **   : 2007-08-22..2010-07-21
+     *    : 2010-07-21..2012-01-04
+     $ oldness first philosophy
+     Tale of Genji (1010), by Murasaki Shikibu
+
+### Library
+
+Declaring the existence of a medium is easy; you don't need a national reputation as a culture critic or scholar.
+
+     class Rubies < Medium
+       began Date.new(1979)
+     end
+
+Although of course it would be better if you could point to a particular work that you saw as kicking things off.
+
+     class RockNRoll < Medium
+       began Date.new(1944), :with => "Strange Things Happen Every Day", :by => "Sister Rosetta Tharpe"
+     end
+
+Mediums know how to rate by date.
+
+    Rubies.rate(Date.new(2010, 8, 29)) # => 3
+    Rubies.rate("2012-1-4") # => 1
+
+They also know what dates fall under what ratings.
+
+    Rubies.ranges[5] #=> #<Date: 1979-01-01>..#<Date: 2001-01-02>
+
+And, if you've told them, they remember their roots.
+
+    RockNRoll.first.title #=> "Strange Things Happen Every Day"
+    Rubies.first.by #=> "Unknown"
+
+Just a reminder: mediums are timeless, so they never need to be instantiated.

data/spec/cli_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+
+module Oldness
+  describe "oldness" do
+    before :all do
+      Dir.chdir("../bin")
+    end
+
+    describe "rating" do
+      it "calls the rating method of the named Medium class with :formatted=>true"
+    end
+
+    describe "range" do
+      it "calls the range method of the named Medium class with :formatted=>true"
+    end
+
+    describe "first" do
+      it "prints the string formatting of the Work object stored under the first method of the appropriate Medium class"
+    end
+
+    describe "media" do
+      it "lists all subclasses of Medium in the object space" do
+        list = []
+        ObjectSpace.each_object(Class) do |c|
+          next unless c.superclass == Medium
+          list << c
+        end
+        `./oldness media`.should == list.collect(&:to_s).sort.inject("") { |l, c| l + c.downcase.sub("oldness::", "")+"\n" }
+      end
+    end
+  end
+end

data/spec/medium_spec.rb

@@ -0,0 +1,63 @@
+require 'spec_helper'
+
+module Oldness
+  describe Medium do
+    def ranges_for(start_date, current_date = Date.today)
+      span = (current_date-start_date)
+      unit = span/81
+      {5 => (start_date..current_date-27*unit),
+       4 => (current_date-27*unit..current_date-9*unit),
+       3 => (current_date-9*unit..current_date-3*unit),
+       2 => (current_date-3*unit..current_date-unit),
+       1 => (current_date-unit..current_date)}
+    end
+    def rating_for(start_date, work_date, current_date = Date.today)
+      ranges_for(start_date, current_date).find {|key, range| range.cover?(work_date)}[0]
+    end
+    before :all do
+      class RubyPrograms < Medium
+        began Date.new(1979), :with=>"Hello World", :by => "Matz"
+      end
+      @ruby_ranges = ranges_for(Date.new(1979))
+    end
+    describe ".ranges" do
+      it "returns a particular kind of hash" do
+        RubyPrograms.ranges.should == @ruby_ranges
+      end
+      it "can take an argument for a particular date" do
+        RubyPrograms.ranges(:when => Date.new(2009)).should == ranges_for(Date.new(1979), Date.new(2009))
+      end
+      it "can have formatted output instead" do
+        RubyPrograms.ranges(:formatted => true).should == "*****: #{@ruby_ranges[5]}\n**** : #{@ruby_ranges[4]}\n***  : #{@ruby_ranges[3]}\n**   : #{@ruby_ranges[2]}\n*    : #{@ruby_ranges[1]}"
+      end
+    end
+    describe ".rate" do
+      it "rates oldest possible things as fives" do
+        RubyPrograms.rate(Date.new(1979)).should == 5
+      end
+      it "rates newest possible things as ones" do
+        RubyPrograms.rate(Date.today).should == 1
+      end
+      it "rates everything else properly" do
+        [Date.new(2001), Date.new(2008), Date.new(2010)].each do |date|
+          RubyPrograms.rate(date).should == rating_for(Date.new(1979), date)
+        end
+      end
+      it "can take an argument for a particular date" do
+        RubyPrograms.rate(Date.new(2010), :when => Date.new(2050)).should == 5
+      end
+      it "can have formatted output instead" do
+        RubyPrograms.rate(Date.today, :formatted=>true).should == "*"
+        RubyPrograms.rate(Date.new(2010), :when => Date.new(2050), :formatted => true).should == "*****"
+      end
+    end
+    describe ".first" do
+      it "returns a Work object with the attributes passed to .began" do
+        RubyPrograms.first.title.should == "Hello World"
+        RubyPrograms.first.by.should == "Matz"
+        RubyPrograms.first.date.should == Date.new(1979)
+        RubyPrograms.first.to_s.should == "Hello World (1979), by Matz"
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,3 @@
+require 'rspec'
+require_relative '../lib/oldness'
+require 'date'

data/spec/work_spec.rb

@@ -0,0 +1,46 @@
+require 'spec_helper'
+
+module Oldness
+  describe Work do
+    context "BC, year only, no title, no credit" do
+      let(:w) {Work.new(Date.new(-1000))}
+      describe "#date" do
+        it "returns the date object" do
+          w.date.should == Date.new(-1000)
+        end
+      end
+      describe "#by" do
+        it "defaults to 'Unknown'" do
+          w.by.should == "Unknown"
+        end
+      end
+      describe "#title" do
+        it "defaults to 'Untitled'" do
+          w.title.should == "Untitled"
+        end
+      end
+      describe "#to_s" do
+        it "Uses 'BC' instead of negative years" do
+          "#{w}".should == "Untitled (1000BC)"
+        end
+      end
+    end
+    context "Year and Month, Title, no author" do
+      let(:w) {Work.new(Date.new(1974, 2), :title => "Dungeons and Dragons")}
+      describe "#to_s" do
+        it "formats the month as a word" do
+          "#{w}".should == "Dungeons and Dragons (February 1974)"
+        end
+      end
+    end
+    context "Year, month and day, title and author" do
+      let(:w) {Work.new(Date.new(1906, 4, 6), :title => "Humorous Phases of Funny Faces", :by => "J. Stuart Blackton")}
+      describe "#to_s" do
+        it "includes the day of the month" do
+          "#{w}".should == "#{w.title} (April 6, 1906), by #{w.by}"
+        end
+      end
+    end
+  end
+
+end

data/tasks.thor

@@ -0,0 +1,98 @@
+
+class Gems < Thor
+  desc "validate", "Test gemspec"
+  def validate
+    raise Exception unless gemspec.validate
+  end
+
+  desc "build", "Build gem locally"
+  def build
+    invoke :validate
+    system "gem build #{gemspec.name}.gemspec"
+    FileUtils.mkdir_p "pkg"
+    FileUtils.mv "#{gemspec.name}-#{gemspec.version}.gem", "pkg"
+  end
+
+  desc "clean", "Delete generated gem files"
+  def clean
+    FileUtils.rm_rf "pkg"
+  end
+
+  desc "install", "Build and install gem locally"
+  def install
+    invoke :build
+    system "gem install pkg/#{gemspec.name}-#{gemspec.version}"
+  end
+
+  no_tasks do
+    def gemspec
+      @gemspec ||= eval(File.read(Dir["*.gemspec"].first))
+    end
+  end
+end
+
+class VersionBump < Thor
+  desc "manual MAJOR MINOR PATCH", "Set version number to 'MAJOR.MINOR.PATCH'"
+  def manual(major, minor, patch)
+    version[0], version[1], version[2] = major, minor, patch
+    update_version
+  end
+
+  desc "major", "Bump by a major version"
+  def major
+    version[0] += 1
+    version[1] = 0
+    version[2] = 0
+    update_version
+  end
+  desc "minor", "Bump by a minor version"
+  def minor
+    version[1] += 1
+    version[2] = 0
+    update_version
+  end
+  desc "patch", "Bump by a patch version"
+  def patch
+    version[2] += 1
+    update_version
+  end
+  no_tasks do
+    def version
+      $:.push File.expand_path("../lib", __FILE__)
+      require 'oldness/version'
+      Oldness::VERSION =~ /(\d+)\.(\d+)\.(\d+)/
+      @version ||= [$1.to_i, $2.to_i, $3.to_i]
+    end
+    def update_version
+      path = File.expand_path("./lib/oldness/version.rb")
+      new_source = File.read(path).sub(/VERSION\s*=.*/, %Q{VERSION = "#{version.join('.')}"})
+      File.open(path, 'w') { |f| f.puts new_source }
+    end
+  end
+end
+
+class Publish < Thor
+  desc "github", "Push changes to github"
+  def github
+    system "git push origin : --tags"
+  end
+  desc "gem", "Build gem and push it to rubygems"
+  def gem
+    confirm = ask "This will push whatever's in the working directory to rubygems. Are you SURE? Y/N"
+    if confirm == "Y"
+      invoke "gems:build"
+      system "gem push pkg/#{gemspec.name}-#{gemspec.version}.gem"
+    end
+  end
+  desc "all", "Push to both github and rubygems"
+  def all
+    invoke :github
+    invoke :gem
+  end
+
+  no_tasks do
+    def gemspec
+      @gemspec ||= eval(File.read(Dir["*.gemspec"].first))
+    end
+  end
+end

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification 
+name: oldness
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Nick Novitski
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-12-20 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: thor
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "0.14"
+  type: :runtime
+  version_requirements: *id003
+description: A library and shell command that rates the age of different types of things on a five-star system
+email: nicknovitski@gmail.com
+executables: 
+- oldness
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- bin/oldness
+- config.ru
+- Gemfile
+- lib/oldness/cli.rb
+- lib/oldness/medium.rb
+- lib/oldness/version.rb
+- lib/oldness/work.rb
+- lib/oldness.rb
+- oldness.gemspec
+- pkg/oldness-0.0.1.gem
+- readme.markdown
+- spec/cli_spec.rb
+- spec/medium_spec.rb
+- spec/spec_helper.rb
+- spec/work_spec.rb
+- tasks.thor
+- .gitignore
+homepage: http://github.com/njay/oldness
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: 1.3.7
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: Instant historical perspective
+test_files: 
+- spec/cli_spec.rb
+- spec/medium_spec.rb
+- spec/spec_helper.rb
+- spec/work_spec.rb
+has_rdoc: