month 0.1.1 → 0.1.2

data/Manifest.txt

@@ -0,0 +1,7 @@
+Manifest.txt
+README.txt
+changelog.txt
+install.rb
+lib/month.rb
+rakefile
+test/ts_month.rb

data/README.txt

@@ -0,0 +1,7 @@
+Ruby Month is a utility class for representing months in Ruby. It handles addition, previous and next months, end and start dates, month names (in English), and a few other handy things.
+
+http://rubyforge.org/projects/month/
+
+INSTALLATION:
+As root, run "./install.rb", which will copy the Ruby files into the right
+subdirectory. You can run "./install.rb --help" for information.

data/changelog.txt

@@ -0,0 +1,9 @@
+= 0.1.2 -- Nov 2 2007
+* added Month#succ.
+
+= 0.1.1 -- Jan 7 2007
+* added install.rb
+* added reference to Rubyforge project page to month.rb RDoc
+
+= 0.1.0 -- Jun 7 2005
+* Initial release.

data/install.rb

@@ -0,0 +1,164 @@
+#! /usr/bin/env ruby
+################################################################################
+#                                                                              #
+#  Name: install.rb                                                            #
+#  Author: Sean E Russell <ser@germane-software.com>                           #
+#  Version: $Id: install.rb,v 1.1 2007/01/08 01:46:57 francis Exp $
+#  Date: *2002-174                                                             #
+#  Description:                                                                #
+#    This is a generic installation script for pure ruby sources.  Features    #
+#          include:                                                            #
+#          * Clean uninstall                                                   #
+#          * Installation into an absolute path                                #
+#          * Installation into a temp path (useful for systems like Portage)   #
+#          * Noop mode, for testing                                            #
+#    To set for a different system, change the SRC directory to point to the   #
+#    package name / source directory for the project.                          #
+#                                                                              #
+################################################################################
+
+# CHANGE THIS
+SRC = 'lib'
+MODULE_NAME = 'month'
+BIN = 'bin'
+# CHANGE NOTHING BELOW THIS LINE
+
+if $0 == __FILE__
+	Dir.chdir ".." if Dir.pwd =~ /bin.?$/
+	
+	require 'getoptlong'
+	require 'rbconfig'
+	require 'ftools'
+	require 'find'
+	
+	opts = GetoptLong.new( [ '--uninstall',	'-u',		GetoptLong::NO_ARGUMENT],
+												[ '--destdir', '-d', GetoptLong::REQUIRED_ARGUMENT ],
+												[ '--target', '-t', GetoptLong::REQUIRED_ARGUMENT ],
+												[ '--help', '-h', GetoptLong::NO_ARGUMENT],
+												[ '--noop', '-n', GetoptLong::NO_ARGUMENT])
+	
+	
+	destdir = File.join Config::CONFIG['sitedir'], 
+		"#{Config::CONFIG['MAJOR']}.#{Config::CONFIG['MINOR']}"
+	bindir = '/usr/local/bin'
+	
+	uninstall = false
+	append = nil
+	opts.each do |opt,arg|
+		case opt
+			when '--destdir'
+				append = arg
+			when '--uninstall'
+				uninstall = true
+			when '--target'
+				destdir = arg
+			when '--help'
+				puts "Installs #{SRC}.\nUsage:\n\t#$0 [[-u] [-n] [-t <dir>|-d <dir>]|-h]"
+				puts "\t-u --uninstall\tUninstalls the package"
+				puts "\t-t --target\tInstalls the software at an absolute location, EG:"
+				puts "\t    #$0 -t /usr/local/lib/ruby"
+				puts "\t  will put the software directly underneath /usr/local/lib/ruby;"
+				puts "\t  IE, /usr/local/lib/ruby/#{SRC}"
+				puts "\t-d --destdir\tInstalls the software at a relative location, EG:"
+				puts "\t    #$0 -d /tmp"
+				puts "\t  will put the software under tmp, using your ruby environment."
+				puts "\t  IE, /tmp/#{destdir}/#{SRC}"
+				puts "\t-n --noop\tDon't actually do anything; just print out what it"
+				puts "\t  would do."
+				exit 0
+			when '--noop'
+				NOOP = true
+		end
+	end
+	
+	destdir = File.join append, destdir if append
+	
+	def get_install_base( file )
+		file_parts = file.split( File::SEPARATOR )
+		file_parts.shift
+		file_parts.join( File::SEPARATOR )
+	end
+	
+	def install destdir, bindir
+		puts "Installing in #{destdir}"
+		begin
+			Find.find(SRC) { |file|
+				next if file =~ /CVS|\.svn/
+				install_base = get_install_base( file )
+				dst = File.join( destdir, install_base )
+				if defined? NOOP
+					puts ">> #{dst}" if file =~ /\.rb$/
+				else
+					File.makedirs( File.dirname(dst) )
+					File.install(file, dst, 0644, true) if file =~ /\.rb$/
+				end
+			}
+		rescue
+			puts $!
+		end
+		puts "Installing binaries in #{ bindir }"
+		begin
+			Dir.entries( BIN ).each { |entry|
+				src = File.join( BIN, entry )
+				next unless FileTest.executable?( src ) && !FileTest.directory?( src )
+				dst = File.join( bindir, entry )
+				if defined? NOOP
+					puts ">> #{ dst }"
+				else
+					File.install( src, dst, 0755, true )
+				end
+			}
+		rescue
+			puts $!
+		end
+	end
+	
+	def uninstall destdir, bindir
+		puts "Uninstalling in #{destdir}"
+		begin
+			puts "Deleting:"
+			dirs = []
+			Find.find( destdir ) do |file|
+				if file =~ /^#{ destdir }#{ File::SEPARATOR }#{ MODULE_NAME }/
+					if defined? NOOP
+						puts "-- #{file}" if File.file? file
+					else
+						File.rm_f file,true if File.file? file
+					end
+					dirs << file if File.directory? file
+				end
+			end
+			dirs.sort { |x,y|
+				y.length <=> x.length 	
+			}.each { |d| 
+				if defined? NOOP
+					puts "-- #{d}"
+				else
+					puts d
+					Dir.delete d
+				end
+			}
+		rescue
+		end
+		puts "Uninstalling binaries in #{ bindir }"
+		begin
+			Dir.entries( BIN ).each { |entry|
+				orig = File.join( BIN, entry )
+				next unless FileTest.executable?( orig ) && !FileTest.directory?( orig )
+				to_uninstall = File.join( bindir, entry )
+				if defined? NOOP
+					puts "-- #{to_uninstall}" if File.file? to_uninstall
+				else
+					File.rm_f to_uninstall,true if File.file? to_uninstall
+				end
+			}
+		rescue
+		end
+	end
+	
+	if uninstall
+		uninstall destdir, bindir
+	else
+		install destdir, bindir
+	end
+end

data/lib/month.rb

@@ -5,7 +5,7 @@
 # The Rubyforge project page can be viewed at
 # http://rubyforge.org/projects/month.
 class Month
-	Version = '0.1.1'
+	Version = '0.1.2'
 	
 	# Returns an array of the full names of months (in English). Note that
 	# "January" is the 0th element, and "December" is the 11th element.
@@ -79,6 +79,8 @@ class Month
 		self + 1
 	end
 	
+	alias_method :succ, :next
+	
 	# Returns the previous Month.
 	def prev
 		self - 1

data/rakefile

@@ -0,0 +1,44 @@
+=begin
+$: << 'lib'
+require 'month'
+
+@@version_str = Month::Version
+
+def release_tag
+	( uber, major, minor ) = @@version_str.split( '.' ).collect! { |str|
+		str.to_i
+	}
+	"rel-#{ uber }-#{ major }-#{ minor }"
+end
+
+def release_dir_name
+	"month-#{ @@version_str }"
+end
+
+task :export_release do
+	Dir.chdir('../releases')
+	ext = "-d:ext:francis@rubyforge.org:/var/cvs/month"
+	`cvs #{ ext } export -r #{ release_tag } -d #{ release_dir_name } month`
+	`tar zcvf month-#{ @@version_str }.tar.gz #{ release_dir_name }`
+end
+
+task :update_docs do
+	Dir.chdir( 'lib' )
+	`rdoc --op ../docs/`
+end
+=end
+
+require 'hoe'
+$:.unshift 'lib'
+require 'month'
+
+Hoe.new("month", Month::Version) do |p|
+	p.rubyforge_name = "month"
+	p.author = 'Francis Hwang'
+	p.description = p.paragraphs_of( 'README.txt', 0 ).first
+	p.summary = p.paragraphs_of( 'README.txt', 0 ).first
+	p.email = 'sera@fhwang.net'
+	p.url = 'http://month.rubyforge.org/'
+	p.changes = p.paragraphs_of( 'changelog.txt', 0 ).first
+end
+

data/test/ts_month.rb

@@ -0,0 +1,68 @@
+$: << 'lib'
+require 'month'
+require 'test/unit'
+
+class TestMonth < Test::Unit::TestCase
+	def setup
+		@jan2000 = Month.new 2000, 1
+		@dec2000 = Month.new 2000, 12
+		@jan2001 = Month.new 2001, 1
+	end
+
+	def test_arithmetic
+		assert_equal( Month.new( 2000, 2 ), @jan2000 + 1 )
+		assert_equal( Month.new( 2001, 1 ), @jan2000 + 12 )
+		assert_equal( Month.new( 1999, 10 ), @jan2000 - 3 )
+		assert_equal( Month.new( 1999, 10 ), @jan2000 + -3 )
+	end
+	
+	def test_checks_month
+		caught = false
+		begin
+			Month.new 1, 2000
+		rescue
+			caught = true
+		end
+		assert caught
+		Month.new 2000, 1
+	end
+
+	def test_compare
+		assert @jan2000 < @jan2001
+	end
+
+	def test_default_init_to_current_month
+		month = Month.new
+		date = Date.today
+		assert_equal( date.mon, month.month )
+		assert_equal( date.year, month.year )
+	end
+	
+	def test_hashable
+		newJan2000 = Month.new( 2000, 1 )
+		assert_equal @jan2000, newJan2000
+		assert_equal @jan2000.hash, newJan2000.hash
+		assert( @jan2000.eql?( newJan2000 ) )
+		normalHash = {}
+		normalHash[@jan2000] = 'q'
+		assert_equal 'q', normalHash[newJan2000]
+	end
+
+	def test_prev_next_succ
+		assert_equal( @dec2000, @jan2001.prev )
+		assert_equal( @jan2001, @dec2000.next )
+		assert_equal( @jan2001, @dec2000.succ )
+		assert_equal( @jan2000, @jan2000.prev.next )
+		assert_equal( @jan2000, @jan2000.prev.succ )
+	end
+
+	def test_start_date_and_end_date
+		assert_equal( Date.new( 2000, 12, 1 ), @dec2000.start_date )
+		assert_equal( Date.new( 2000, 12, 31 ), @dec2000.end_date )
+		assert_equal( Date.new( 1999, 2, 28 ), Month.new( 1999, 2 ).end_date )
+	end
+
+	def test_to_s
+		assert_equal 'Jan 2000', @jan2000.to_s
+	end
+end

metadata

@@ -1,21 +1,21 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.8.11
+rubygems_version: 0.9.2
 specification_version: 1
 name: month
 version: !ruby/object:Gem::Version 
-  version: 0.1.1
-date: 2007-01-07 00:00:00 -05:00
-summary: Month is a utility class for representing months in Ruby.
+  version: 0.1.2
+date: 2007-11-02 00:00:00 -04:00
+summary: Ruby Month is a utility class for representing months in Ruby. It handles addition, previous and next months, end and start dates, month names (in English), and a few other handy things.
 require_paths: 
 - lib
 email: sera@fhwang.net
 homepage: http://month.rubyforge.org/
-rubyforge_project: 
+rubyforge_project: month
 description: Ruby Month is a utility class for representing months in Ruby. It handles addition, previous and next months, end and start dates, month names (in English), and a few other handy things.
-autorequire: month
+autorequire: 
 default_executable: 
 bindir: bin
-has_rdoc: false
+has_rdoc: true
 required_ruby_version: !ruby/object:Gem::Version::Requirement 
   requirements: 
   - - ">"
@@ -25,22 +25,39 @@ required_ruby_version: !ruby/object:Gem::Version::Requirement
 platform: ruby
 signing_key: 
 cert_chain: 
+post_install_message: 
 authors: 
 - Francis Hwang
 files: 
+- Manifest.txt
+- README.txt
+- changelog.txt
+- install.rb
 - lib/month.rb
-- lib/month.rb~
+- rakefile
+- test/ts_month.rb
 test_files: []
 
-rdoc_options: []
-
-extra_rdoc_files: []
-
+rdoc_options: 
+- --main
+- README.txt
+extra_rdoc_files: 
+- Manifest.txt
+- README.txt
+- changelog.txt
 executables: []
 
 extensions: []
 
 requirements: []
 
-dependencies: []
-
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.3.0
+    version: 

data/lib/month.rb~

@@ -1,93 +0,0 @@
-# Month represents a specific month in time. With the exception of
-# Month.month_names (which returns a zero-based array), every usage of the
-# month value assumes that 1 equals January and 12 equals December.
-class Month
-	Version = '0.1.0'
-	
-	# Returns an array of the full names of months (in English). Note that
-	# "January" is the 0th element, and "December" is the 11th element.
-	def Month.month_names
-		[ "January", "February", "March", "April", "May", "June", "July",
-			"August", "September", "October", "November", "December" ]
-	end
-
-	include Comparable
-
-	attr_reader :month, :year
-
-	# A new month can be set to a specific +month+ and +year+, or you can call 
-	# Month.new with no arguments to receive the current month.
-	def initialize( year = nil, month = nil )
-		require 'date'
-		if month.nil? || year.nil?
-			date = Date.today
-			month = date.mon unless month
-			year = date.year unless year
-		end
-		fail "invalid month" if month < 1 || month > 12
-		@month = month
-		@year = year
-	end
-
-	# Returns a new Month that is +amountToAdd+ months later.
-	def +( amountToAdd )
-		( fullYears, remainingMonths ) = amountToAdd.divmod( 12 )
-		resultYear = @year + fullYears
-		resultMonth = @month + remainingMonths
-		if resultMonth > 12
-			resultMonth -= 12
-			resultYear += 1
-		end
-		Month.new( resultYear, resultMonth )
-	end
-	
-	# Returns a new Month that is +amountToSubtract+ months earlier.
-	def -(amountToSubtract)
-		self + (-amountToSubtract)
-	end
-	
-	# Compare this Month to another Month.
-	def <=>(anOther)
-		if @year == anOther.year
-			@month <=> anOther.month
-		else
-			@year <=> anOther.year
-		end
-	end
-
-	# Returns the last Date of the month.
-	def end_date
-		self.next.start_date - 1
-	end
-
-	# Is this Month equal to +anOther+? +anOther+ must be another Month of the
-	# same value.
-	def eql?(anOther)
-		self == anOther
-	end
-	
-	# Calculate a hash value for this Month.
-	def hash
-		"#{@year}#{@month}".to_i
-	end
-
-	# Returns the next Month.
-	def next
-		self + 1
-	end
-	
-	# Returns the previous Month.
-	def prev
-		self - 1
-	end
-	
-	# Returns the first Date of the month.
-	def start_date
-		Date.new( @year, @month, 1 )
-	end
-	
-	# Returns a string of the format "January 2001".
-	def to_s
-		Month.month_names[@month-1][0..2] + " " + @year.to_s
-	end
-end