Readme formatting updates

This commit is contained in:
Alex Dunae 2008-12-30 11:40:21 -08:00
parent 36cefe2d49
commit a63b4cacec
3 changed files with 149 additions and 227 deletions

View file

@ -1,79 +0,0 @@
# Ruby Holidays Gem
A set of functions to deal with holidays in Ruby.
Extends Ruby's built-in Date class and supports custom holiday definition lists.
### Installation
To install the gem from RubyForge:
gem install holidays
Or, download the source <tt>.tgz</tt> file from http://rubyforge.org/holidays and
extract it somewhere in your include path.
### Using the Holidays class
Get all holidays on April 25, 2008 in Australia.
date = Date.civil(2008,4,25)
Holidays.on(date, :au)
=> [{:name => 'ANZAC Day',...}]
Get holidays that are observed on July 2, 2007 in British Columbia, Canada.
date = Date.civil(2007,7,2)
Holidays.on(date, :ca_bc, :observed)
=> [{:name => 'Canada Day',...}]
Get all holidays in July, 2008 in Canada and the US.
from = Date.civil(2008,7,1)
to = Date.civil(2008,7,31)
Holidays.between(from, to, :ca, :us)
=> [{:name => 'Canada Day',...}
{:name => 'Independence Day',...}]
Get informal holidays in February.
from = Date.civil(2008,2,1)
to = Date.civil(2008,2,15)
Holidays.between(from, to)
=> [{:name => 'Valentine\'s Day',...}]
### Extending Ruby's Date class
Check which holidays occur in Iceland on January 1, 2008.
d = Date.civil(2008,7,1)
d.holidays(:is)
=> [{:name => 'Nýársdagur'}...]
Lookup Canada Day in different regions.
d = Date.civil(2008,7,1)
d.holiday?(:ca) # Canada
=> true
d.holiday?(:ca_bc) # British Columbia, Canada
=> true
d.holiday?(:fr) # France
=> false
### Credits and code
* Project page: http://code.dunae.ca/holidays
* Source: http://code.dunae.ca/svn/holidays
* Docs: http://code.dunae.ca/holidays/doc
By Alex Dunae (dunae.ca, e-mail 'code' at the same domain), 2007-08.
Made on Vancouver Island.

View file

@ -1,76 +1,77 @@
= Ruby Holidays Gem = Ruby Holidays Gem
A set of functions to deal with holidays in Ruby. A set of functions to deal with holidays in Ruby.
Extends Ruby's built-in Date class and supports custom holiday definition lists. Extends Ruby's built-in Date class and supports custom holiday definition lists.
=== Installation === Installation
To install the gem from RubyForge: To install the gem from GitHub:
gem install holidays gem sources -a http://gems.github.com
gem install holidays
Or, download the source <tt>.tgz</tt> file from http://rubyforge.org/holidays and
Or, download the source <tt>.tgz</tt> file from http://rubyforge.org/holidays and
extract it somewhere in your include path. extract it somewhere in your include path.
=== Examples === Examples
For more information, see the notes at the top of the Holidays module. For more information, see the notes at the top of the Holidays module.
==== Using the Holidays class ==== Using the Holidays class
Get all holidays on April 25, 2008 in Australia. Get all holidays on April 25, 2008 in Australia.
date = Date.civil(2008,4,25) date = Date.civil(2008,4,25)
Holidays.on(date, :au) Holidays.on(date, :au)
=> [{:name => 'ANZAC Day',...}] => [{:name => 'ANZAC Day',...}]
Get holidays that are observed on July 2, 2007 in British Columbia, Canada. Get holidays that are observed on July 2, 2007 in British Columbia, Canada.
date = Date.civil(2007,7,2) date = Date.civil(2007,7,2)
Holidays.on(date, :ca_bc, :observed) Holidays.on(date, :ca_bc, :observed)
=> [{:name => 'Canada Day',...}] => [{:name => 'Canada Day',...}]
Get all holidays in July, 2008 in Canada and the US. Get all holidays in July, 2008 in Canada and the US.
from = Date.civil(2008,7,1) from = Date.civil(2008,7,1)
to = Date.civil(2008,7,31) to = Date.civil(2008,7,31)
Holidays.between(from, to, :ca, :us) Holidays.between(from, to, :ca, :us)
=> [{:name => 'Canada Day',...} => [{:name => 'Canada Day',...}
{:name => 'Independence Day',...}] {:name => 'Independence Day',...}]
Get informal holidays in February. Get informal holidays in February.
from = Date.civil(2008,2,1) from = Date.civil(2008,2,1)
to = Date.civil(2008,2,15) to = Date.civil(2008,2,15)
Holidays.between(from, to) Holidays.between(from, to)
=> [{:name => 'Valentine\'s Day',...}] => [{:name => 'Valentine\'s Day',...}]
==== Extending Ruby's Date class ==== Extending Ruby's Date class
Check which holidays occur in Iceland on January 1, 2008. Check which holidays occur in Iceland on January 1, 2008.
d = Date.civil(2008,7,1) d = Date.civil(2008,7,1)
d.holidays(:is) d.holidays(:is)
=> [{:name => 'Nýársdagur'}...] => [{:name => 'Nýársdagur'}...]
Lookup Canada Day in different regions. Lookup Canada Day in different regions.
d = Date.civil(2008,7,1) d = Date.civil(2008,7,1)
d.holiday?(:ca) # Canada d.holiday?(:ca) # Canada
=> true => true
d.holiday?(:ca_bc) # British Columbia, Canada d.holiday?(:ca_bc) # British Columbia, Canada
=> true => true
d.holiday?(:fr) # France d.holiday?(:fr) # France
=> false => false
=== Credits and code === Credits and code
* Project page: http://code.dunae.ca/holidays * Project page: http://code.dunae.ca/holidays
* Source: http://code.dunae.ca/svn/holidays * Source: http://github.com/alexdunae/holidays
* Docs: http://code.dunae.ca/holidays/doc * Docs: http://code.dunae.ca/holidays/doc
By Alex Dunae (dunae.ca, e-mail 'code' at the same domain), 2007-08. By Alex Dunae (dunae.ca, e-mail 'code' at the same domain), 2007-08.
Made on Vancouver Island. Made on Vancouver Island.

View file

@ -1,113 +1,113 @@
require 'rake' require 'rake'
require 'rake/testtask' require 'rake/testtask'
require 'rake/rdoctask' require 'rake/rdoctask'
require 'rake/gempackagetask' require 'rake/gempackagetask'
require 'yaml' require 'yaml'
require 'fileutils' require 'fileutils'
require 'lib/holidays' require 'lib/holidays'
require 'data/build_defs' require 'data/build_defs'
desc 'Run all tests' desc 'Run all tests'
task :test => ["test:lib", "test:defs"] task :test => ["test:lib", "test:defs"]
namespace :test do namespace :test do
desc 'Run the unit tests.' desc 'Run the unit tests.'
Rake::TestTask.new(:lib) do |t| Rake::TestTask.new(:lib) do |t|
t.libs << 'lib' t.libs << 'lib'
t.test_files = FileList['test/defs/test*.rb'].exclude('test_helper.rb') t.test_files = FileList['test/defs/test*.rb'].exclude('test_helper.rb')
t.verbose = false t.verbose = false
end end
desc 'Run the definition tests.' desc 'Run the definition tests.'
Rake::TestTask.new(:defs) do |t| Rake::TestTask.new(:defs) do |t|
t.libs << 'lib' t.libs << 'lib'
t.test_files = FileList['test/test*.rb'].exclude('test_helper.rb') t.test_files = FileList['test/test*.rb'].exclude('test_helper.rb')
t.verbose = false t.verbose = false
end end
end end
task :doc => ["defs:manifest", :rdoc] task :doc => ["defs:manifest", :rdoc]
desc 'Generate documentation.' desc 'Generate documentation.'
Rake::RDocTask.new(:rdoc) do |rdoc| Rake::RDocTask.new(:rdoc) do |rdoc|
rdoc.rdoc_dir = 'doc' rdoc.rdoc_dir = 'doc'
rdoc.title = 'Ruby Holidays Gem' rdoc.title = 'Ruby Holidays Gem'
rdoc.options << '--all' << '--inline-source' << '--line-numbers' rdoc.options << '--all' << '--inline-source' << '--line-numbers'
rdoc.options << '--charset' << 'utf-8' rdoc.options << '--charset' << 'utf-8'
#rdoc.template = 'extras/rdoc_template.rb' #rdoc.template = 'extras/rdoc_template.rb'
rdoc.rdoc_files.include('README') rdoc.rdoc_files.include('README.rdoc')
rdoc.rdoc_files.include('data/SYNTAX') rdoc.rdoc_files.include('data/SYNTAX')
rdoc.rdoc_files.include('lib/holidays/MANIFEST') rdoc.rdoc_files.include('lib/holidays/MANIFEST')
rdoc.rdoc_files.include('REFERENCES') rdoc.rdoc_files.include('REFERENCES')
rdoc.rdoc_files.include('CHANGELOG') rdoc.rdoc_files.include('CHANGELOG')
rdoc.rdoc_files.include('LICENSE') rdoc.rdoc_files.include('LICENSE')
rdoc.rdoc_files.include('lib/*.rb') rdoc.rdoc_files.include('lib/*.rb')
end end
spec = Gem::Specification.new do |s| spec = Gem::Specification.new do |s|
s.name = 'holidays' s.name = 'holidays'
s.version = '0.9.3' s.version = '0.9.3'
s.author = 'Alex Dunae' s.author = 'Alex Dunae'
s.homepage = 'http://code.dunae.ca/holidays' s.homepage = 'http://code.dunae.ca/holidays'
s.platform = Gem::Platform::RUBY s.platform = Gem::Platform::RUBY
s.description = <<-EOF s.description = <<-EOF
A collection of Ruby methods to deal with statutory and other holidays. You deserve a holiday! A collection of Ruby methods to deal with statutory and other holidays. You deserve a holiday!
EOF EOF
s.summary = 'A collection of Ruby methods to deal with statutory and other holidays. You deserve a holiday!' s.summary = 'A collection of Ruby methods to deal with statutory and other holidays. You deserve a holiday!'
s.files = FileList["{lib}/**/*", "{data}/**/*", "*.rb"].to_a s.files = FileList["{lib}/**/*", "{data}/**/*", "*.rb"].to_a
s.test_files = FileList['test/defs/test*.rb'].exclude('test_helper.rb') s.test_files = FileList['test/defs/test*.rb'].exclude('test_helper.rb')
s.has_rdoc = true s.has_rdoc = true
s.extra_rdoc_files = ['README', 'data/SYNTAX', 'lib/holidays/MANIFEST', 'REFERENCES', 'CHANGELOG', 'LICENSE'] s.extra_rdoc_files = ['README.rdoc', 'data/SYNTAX', 'lib/holidays/MANIFEST', 'REFERENCES', 'CHANGELOG', 'LICENSE']
s.rdoc_options << '--all' << '--inline-source' << '--line-numbers' << '--charset' << 'utf-8' s.rdoc_options << '--all' << '--inline-source' << '--line-numbers' << '--charset' << 'utf-8'
end end
desc 'Build the gem.' desc 'Build the gem.'
Rake::GemPackageTask.new(spec) do |pkg| Rake::GemPackageTask.new(spec) do |pkg|
pkg.need_zip = true pkg.need_zip = true
pkg.need_tar = true pkg.need_tar = true
end end
desc 'Definition file tasks' desc 'Definition file tasks'
namespace :defs do namespace :defs do
DATA_PATH = 'data' DATA_PATH = 'data'
desc 'Build holiday definition files' desc 'Build holiday definition files'
task :build_all do task :build_all do
# load the index # load the index
def_index = YAML.load_file("#{DATA_PATH}/index.yaml") def_index = YAML.load_file("#{DATA_PATH}/index.yaml")
# create a dir for the generated tests # create a dir for the generated tests
FileUtils.mkdir_p('test/defs') FileUtils.mkdir_p('test/defs')
def_index['defs'].each do |region, files| def_index['defs'].each do |region, files|
puts "Building #{region} definition module:" puts "Building #{region} definition module:"
files = files.collect { |f| "#{DATA_PATH}/#{f}" } files = files.collect { |f| "#{DATA_PATH}/#{f}" }
files.uniq! files.uniq!
module_src, test_src = parse_holiday_defs(region, files) module_src, test_src = parse_holiday_defs(region, files)
File.open("lib/holidays/#{region.downcase.to_s}.rb","w") do |file| File.open("lib/holidays/#{region.downcase.to_s}.rb","w") do |file|
file.puts module_src file.puts module_src
end end
unless test_src.empty? unless test_src.empty?
File.open("test/defs/test_defs_#{region.downcase.to_s}.rb","w") do |file| File.open("test/defs/test_defs_#{region.downcase.to_s}.rb","w") do |file|
file.puts test_src file.puts test_src
end end
end end
puts "Done.\n\n" puts "Done.\n\n"
end end
end end
desc 'Build the definition manifest.' desc 'Build the definition manifest.'
task :manifest do task :manifest do
File.open("lib/holidays/MANIFEST","w") do |file| File.open("lib/holidays/MANIFEST","w") do |file|
file.puts <<-EOH file.puts <<-EOH
==== Regional definitions ==== Regional definitions
The following definition files are included in this installation: The following definition files are included in this installation:
EOH EOH
FileList.new('lib/holidays/*.rb').each do |str| FileList.new('lib/holidays/*.rb').each do |str|
file.puts('* ' + str.gsub(/^lib\/|\.rb$/, '')) file.puts('* ' + str.gsub(/^lib\/|\.rb$/, ''))
end end
end end
end end
end end