date-formatter 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c390fc86284148fbbd76384d5e0a2a81aa92db33
+  data.tar.gz: b0a78b8d0d1b342d99125b7b7b64a5cecc2265f3
+SHA512:
+  metadata.gz: 4b470f1e3b04ec4146175e488c1b210129799b3083188f9e21e1cc44c94b12303e5a47a535d740e187334026a38cfe8852cfe44774e125b1ad9cf46f4d8f370f
+  data.tar.gz: b751629fdfb1be81962c61a00d1ae28cb5754a4112b59a06c0861d2c763bd4b8a0dbceea14e9be61834e8977a8ac048e672308bc21f685e1675a529501977790

data/CHANGELOG.md

@@ -0,0 +1,4 @@
+
+### 0.0.1 / 2020-02-16
+
+* Everything is new. First release

data/Manifest.txt

@@ -0,0 +1,9 @@
+CHANGELOG.md
+Manifest.txt
+README.md
+Rakefile
+lib/date-formatter.rb
+lib/date-formatter/version.rb
+lib/date/formatter.rb
+test/helper.rb
+test/test_format.rb

data/README.md

@@ -0,0 +1,42 @@
+# date-formatter - date formatter by example; auto-builds the strftime format string from a example date
+
+
+* home  :: [github.com/feedreader/pluto](https://github.com/feedreader/pluto)
+* bugs  :: [github.com/feedreader/pluto/issues](https://github.com/feedreader/pluto/issues)
+* gem   :: [rubygems.org/gems/date-formatter](https://rubygems.org/gems/date-formatter)
+* rdoc  :: [rubydoc.info/gems/date-formatter](http://rubydoc.info/gems/date-formatter)
+* forum :: [groups.google.com/group/wwwmake](http://groups.google.com/group/wwwmake)
+
+
+
+
+## Usage
+
+
+
+Examples:
+
+| Date by Example         | => `strftime` Format |
+|-------------------------|----------------|
+| January 04, 2020        | => `%B %d, %Y` |
+| Fri, Jan 04             | => `%a, %b %d` |
+| 4 Jan 2020              | => `%-d %b %Y` |
+| Friday, January 4, 2020 | => `%A, %B %-d, %Y` |
+| Fri, Jan 04 8:00        | => `%a, %b %d %-H:%M` |
+| 4 Jan 2020 08:00        | => `%-d %b %Y %H:%M` |
+
+
+
+
+
+## License
+
+![](https://publicdomainworks.github.io/buttons/zero88x31.png)
+
+The `date-formatter` scripts are dedicated to the public domain.
+Use it as you please with no restrictions whatsoever.
+
+## Questions? Comments?
+
+Send them along to the [wwwmake Forum/Mailing List](http://groups.google.com/group/wwwmake).
+Thanks!

data/Rakefile

@@ -0,0 +1,28 @@
+require 'hoe'
+require './lib/date-formatter/version.rb'
+
+Hoe.spec 'date-formatter' do
+
+  self.version = DateByExample::VERSION
+
+  self.summary = "date-formatter - date formatter by example; auto-builds the strftime format string from a example date"
+  self.description = summary
+
+  self.urls    = ['https://github.com/feedreader/pluto']
+
+  self.author  = 'Gerald Bauer'
+  self.email   = 'wwwmake@googlegroups.com'
+
+  # switch extension to .markdown for gihub formatting
+  self.readme_file  = 'README.md'
+  self.history_file = 'CHANGELOG.md'
+
+  self.extra_deps = []
+
+  self.licenses = ['Public Domain']
+
+  self.spec_extras = {
+    required_ruby_version: '>= 2.2.2'
+  }
+
+end

data/lib/date-formatter.rb

@@ -0,0 +1,138 @@
+require 'pp'
+require 'time'
+require 'date'
+
+
+
+###
+# our own code
+require 'date-formatter/version' # let version always go first
+
+
+
+module DateByExample
+
+##
+## todo/fix: improve end of MONTH_RE
+##   do NOT use \b - also break on everything but a-z incl. numbers/digits - (double) check!!!
+
+  MONTH_NAME_ABBREV_RE = %r<
+     \b(
+        Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec
+       )\b
+    >x
+
+
+  ## note: May is turned into an abbreviated month name (%b)
+  MONTH_NAME_RE = %r<
+      \b(
+        January|February|March|
+        April|June|              ## note: May is "ambigious" and, thus, NOT included
+        July|August|September|
+        October|November|December
+        )\b
+    >x
+
+  DAY_NAME_ABBREV_RE = %r<
+     \b(
+       Mon|Tue|Wed|Thu|Fri|Sat|Sun
+       )\b
+    >x
+
+  DAY_NAME_RE = %r<
+     \b(Monday|Tuesday|Wednesday|Thursday|Friday|Saturday|Sunday)\b
+    >x
+
+  YEAR_RE = %r<
+     \b([12][0-9][0-9][0-9])\b
+    >x
+
+  DAY_WITH_ZERO_RE = %r<
+      \b(0[1-9])\b
+    >x
+
+  DAY_RE = %r<
+      \b([1-9]|[123][0-9])\b
+    >x
+
+  TIME_WITH_ZERO_RE = %r<
+       \b(0[0-9]:[0-9][0-9])\b
+    >x
+
+  TIME_RE = %r<
+    \b(([1-9]|[12][0-9]):[0-9][0-9])\b
+    >x
+
+
+  def self.to_strftime( spec )
+    spec = spec.gsub( MONTH_NAME_RE, '%B' )         # %B - The full month name ("January")
+    spec = spec.gsub( MONTH_NAME_ABBREV_RE, '%b')   # %b - The abbreviated month name ("Jan")
+    spec = spec.gsub( DAY_NAME_RE, '%A' )           # %A - The full weekday name ("Sunday")
+    spec = spec.gsub( DAY_NAME_ABBREV_RE, '%a')     # %a - The abbreviated weekday name ("Sun")
+
+    spec = spec.gsub( TIME_WITH_ZERO_RE, '%H:%M' )  # %H - Hour of the day, 24-hour clock (00..23)
+                                                    # %M - Minute of the hour (00..59)
+    spec = spec.gsub( TIME_RE, '%-H:%M' )
+
+    spec = spec.gsub( YEAR_RE, '%Y' )               # %Y - Year with century
+    spec = spec.gsub( DAY_WITH_ZERO_RE, '%d' )      # %d - Day of the month (01..31)
+    spec = spec.gsub( DAY_RE, '%-d' )               # %d - Day of the month without a leading zero (1..31)
+
+    ## add some "higher-level" symbolic format shortcuts too
+    spec = spec.gsub( 'YYYY', '%Y' )
+    spec = spec.gsub( 'YY',   '%y' )
+    spec = spec.gsub( 'MM',   '%m' )
+    spec = spec.gsub( 'DD',   '%d' )
+    spec = spec.gsub( 'D',    '%-d')
+
+    spec
+  end
+end
+
+
+###
+#  String#to_strfime
+#
+
+#  Date#format
+#  Time#format
+#  DateTime#format
+
+
+## test with
+#    January 04, 2010
+#    Fri, Jan 04
+#    4 Jan 2010
+#    Friday, January 4, 2010
+#    ...
+
+
+
+
+class String
+  def to_strftime() DateByExample.to_strftime( self ); end
+end
+
+class Date
+  def format( spec ) self.strftime( spec.to_strftime ); end
+end
+
+class DateTime
+  def format( spec ) self.strftime( spec.to_strftime ); end
+end
+
+class Time
+  def format( spec ) self.strftime( spec.to_strftime ); end
+end
+
+
+class NilClass
+  def format( spec ) ''; end
+end
+
+
+
+
+# say hello
+puts DateByExample.banner   if $DEBUG || (defined?($RUBYLIBS_DEBUG) && $RUBYLIBS_DEBUG)
+

data/lib/date-formatter/version.rb

@@ -0,0 +1,20 @@
+
+module DateByExample
+    MAJOR = 0    ## todo: namespace inside version or something - why? why not??
+    MINOR = 0
+    PATCH = 1
+    VERSION = [MAJOR,MINOR,PATCH].join('.')
+  
+    def self.version
+      VERSION
+    end
+  
+    def self.banner
+      "date-formatter/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}]"
+    end
+  
+    def self.root
+      File.expand_path( File.dirname(File.dirname(File.dirname(__FILE__))) )
+    end
+  end   # module DateByExample
+  

data/lib/date/formatter.rb

@@ -0,0 +1 @@
+require_relative '../date-formatter'     ##  note: allow require 'date/formatter' too (in addition to require 'date-formatter')

data/test/helper.rb

@@ -0,0 +1,7 @@
+## minitest setup
+require 'minitest/autorun'
+
+## our own code
+require 'date/formatter'     ## or require 'date-formatter'
+
+

data/test/test_format.rb

@@ -0,0 +1,55 @@
+###
+#  to run use
+#     ruby -I ./lib -I ./test test/test_format.rb
+
+
+require 'helper'
+
+class TestFormat < MiniTest::Test
+
+   def test_format
+     dates = { 'January 02, 2006'        => '%B %d, %Y',
+               'Mon, Jan 02'             => '%a, %b %d',
+               '2 Jan 2006'              => '%-d %b %Y',
+               'Monday, January 2, 2006' => '%A, %B %-d, %Y',
+    
+               'Mon, Jan 02 3:00'        => '%a, %b %d %-H:%M',
+               '2 Jan 2006 03:00'        => '%-d %b %Y %H:%M',
+               '2006'                    => '%Y',
+    
+               'YYYY-MM-DD' => ['%Y-%m-%d',  '2006-01-02'],
+               'YY-MM-DD'   => ['%y-%m-%d',  '06-01-02'],
+               'YY-MM-D'    => ['%y-%m-%-d', '06-01-2'],
+    
+               'YYYYMMDD'   => ['%Y%m%d',    '20060102'],
+               'YYMMDD'     => ['%y%m%d',    '060102'],
+               'YYMMD'      => ['%y%m%-d',   '06012'],
+               'YYYY'       => ['%Y',        '2006'], 
+            }
+ 
+      dates.each do |date, exp|
+         assert_format( date, exp )
+      end
+   end
+ 
+
+   def assert_format( spec, exp )
+      strf = DateByExample.to_strftime( spec )
+      now = Time.new( 2006, 1, 2, 3 )   ## Mon, Jan 2, 3:00 2006
+      str  = now.strftime( strf )
+
+      puts "#{spec}  =>  #{strf}  =>  #{str}"
+
+      if exp.is_a?( Array )
+        exp_strf = exp[0]
+        exp_str  = exp[1]
+      else
+        exp_strf = exp
+        exp_str  = spec   ## same as passed in format specifier/string
+      end
+      
+      assert_equal exp_strf, strf
+      assert_equal exp_str,  str
+   end
+           
+end  # class TestFormat

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification
+name: date-formatter
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Gerald Bauer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-02-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.16'
+description: date-formatter - date formatter by example; auto-builds the strftime
+  format string from a example date
+email: wwwmake@googlegroups.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+- Rakefile
+- lib/date-formatter.rb
+- lib/date-formatter/version.rb
+- lib/date/formatter.rb
+- test/helper.rb
+- test/test_format.rb
+homepage: https://github.com/feedreader/pluto
+licenses:
+- Public Domain
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--main"
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.2.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2
+signing_key: 
+specification_version: 4
+summary: date-formatter - date formatter by example; auto-builds the strftime format
+  string from a example date
+test_files: []