strftime 1.0.0

data/.gitignore

@@ -0,0 +1,3 @@
+pkg/*
+*.gem
+.bundle

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,21 @@
+== MIT License
+
+Copyright (c) 2010, Jim Gay, Saturn Flyer LLC.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README

@@ -0,0 +1,11 @@
+# strftime
+
+With strftime you'll have descriptions of time format directives at your fingertips in Ruby.
+
+`Strftime::Directives` contains a hash of details about these directives.
+
+Just use `Strftime::Directives['%M']` to get a description and example, or use the shorthand method `strfd('M')`
+
+    Strftime::Directives['%M'].description #=> 'Minute of the hour'
+
+This might be useful for you, or for users of a system which are able to specify string formats for dates and times.

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/lib/strftime.rb

@@ -0,0 +1,67 @@
+module Strftime
+  Directives = Hash.new do |hash, key|
+    mod = ('%' << key.to_s)
+    hash[mod] if hash.keys.include?(mod)
+  end
+  Directives.merge!({
+    '%a' => { :description => 'The abbreviated weekday name', :example => "Sun"},
+    '%A' => { :description => 'The  full  weekday  name', :example => "Sunday"},
+    '%b' => { :description => 'The abbreviated month name', :example => "Jan"},
+    '%B' => { :description => 'The  full  month  name', :example => "January"},
+    '%c' => { :description => 'The preferred local date and time representation'},
+    '%C' => { :description => 'Century (20 in 2009)'},
+    '%d' => { :description => 'Day of the month', :example => "01..31"},
+    '%D' => { :description => 'Date (%m/%d/%y)'},
+    '%e' => { :description => 'Day of the month, blank-padded', :example => "1..31"},
+    '%F' => { :description => 'Equivalent to %Y-%m-%d (the ISO 8601 date format)'},
+    '%h' => { :description => 'Equivalent to %b'},
+    '%H' => { :description => 'Hour of the day, 24-hour clock', :example => "00..23"},
+    '%I' => { :description => 'Hour of the day, 12-hour clock', :example => "01..12)"},
+    '%j' => { :description => 'Day of the year', :example => "001..366"},
+    '%k' => { :description => 'hour, 24-hour clock, blank-padded', :example => "0..23"},
+    '%l' => { :description => 'hour, 12-hour clock, blank-padded', :example => "0..12"},
+    '%L' => { :description => 'Millisecond of the second', :example => "000..999"},
+    '%m' => { :description => 'Month of the year', :example => "01..12"},
+    '%M' => { :description => 'Minute of the hour', :example => "00..59"},
+    '%n' => { :description => 'Newline (\n)'},
+    '%N' => { :description => 'Fractional seconds digits, default is 9 digits (nanosecond)
+            %3N  millisecond (3 digits)
+            %6N  microsecond (6 digits)
+            %9N  nanosecond (9 digits)'},
+    '%p' => { :description => 'Meridian indicator', :example => "(``AM''  or  ``PM'')"},
+    '%P' => { :description => 'Meridian indicator', :example => "(``am''  or  ``pm'')"},
+    '%r' => { :description => 'time, 12-hour', :example => "same as %I:%M:%S %p"},
+    '%R' => { :description => 'time, 24-hour', :example => "%H:%M"},
+    '%s' => { :description => 'Number of seconds since 1970-01-01 00:00:00 UTC.'},
+    '%S' => { :description => 'Second of the minute', :example => "00..60"},
+    '%t' => { :description => 'Tab character', :example => "\t"},
+    '%T' => { :description => 'time, 24-hour', :example => "%H:%M:%S"},
+    '%u' => { :description => 'Day of the week as a decimal, Monday being 1.', :example => "1..7"},
+    '%U' => { :description => 'Week  number  of the current year,
+            starting with the first Sunday as the first
+            day of the first week', :example => "00..53"},
+    '%v' => { :description => 'VMS date', :example => "%e-%b-%Y"},
+    '%V' => { :description => 'Week number of year according to ISO 8601', :example => "01..53"},
+    '%W' => { :description => 'Week  number  of the current year,
+            starting with the first Monday as the first
+            day of the first week', :example => "00..53"},
+    '%w' => { :description => 'Day of the week', :example => "Sunday is 0, 0..6"},
+    '%x' => { :description => 'Preferred representation for the date alone, no time'},
+    '%X' => { :description => 'Preferred representation for the time alone, no date'},
+    '%y' => { :description => 'Year without a century', :example => "00..99"},
+    '%Y' => { :description => 'Year with century'},
+    '%z' => { :description => 'Time zone as  hour offset from UTC (e.g. +0900)'},
+    '%Z' => { :description => 'Time zone name'},
+    '%%' => { :description => "Literal ``%'' character"}
+  })
+end
+
+class Object
+  def strfd(arg=nil)
+    if arg
+      Strftime::Directives[arg]
+    else
+      Strftime::Directives
+    end
+  end
+end

data/lib/strftime/version.rb

@@ -0,0 +1,3 @@
+module Strftime
+  VERSION = "1.0.0"
+end

data/strftime.gemspec

@@ -0,0 +1,33 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "strftime/version"
+
+Gem::Specification.new do |s|
+  s.name        = "strftime"
+  s.version     = Strftime::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Jim Gay"]
+  s.email       = ["jim@saturnflyer.com"]
+  s.homepage    = "http://rubygems.org/gems/strftime"
+  s.summary     = %q{Convenient list of strftime format directives}
+  s.description = %q{Convenient list of strftime format directives}
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  
+  s.post_install_message = %{
+  Thanks for installing strftime. You can use these methods to
+  better understand the formats used in Date and Time strftime
+  
+  Strftime::Directives       #=> a full hash of directives
+  Strftime::Directives['%y'] #=> a hash of description and 
+                             #   optional example value
+                             
+  Strftime::Directives['y']  #=> optionally exclude the %
+   
+  strfd                      #=> shorthand to get directives
+  strfd('y')                 #=> shorthand to get details
+  }
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification 
+name: strftime
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Jim Gay
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-04 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: Convenient list of strftime format directives
+email: 
+- jim@saturnflyer.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- LICENSE
+- README
+- Rakefile
+- lib/strftime.rb
+- lib/strftime/version.rb
+- strftime.gemspec
+has_rdoc: true
+homepage: http://rubygems.org/gems/strftime
+licenses: []
+
+post_install_message: "\n  Thanks for installing strftime. You can use these methods to\n  better understand the formats used in Date and Time strftime\n  \n  Strftime::Directives       #=> a full hash of directives\n  Strftime::Directives['%y'] #=> a hash of description and \n                             #   optional example value\n                             \n  Strftime::Directives['y']  #=> optionally exclude the %\n   \n  strfd                      #=> shorthand to get directives\n  strfd('y')                 #=> shorthand to get details\n  "
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Convenient list of strftime format directives
+test_files: []
+