yymmdd 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 696bd0a2bba0616dd2ff927d26a761f7735d97d0
+  data.tar.gz: 74c7a0ae9df8974c85baf80cb5f783571f095bc5
+SHA512:
+  metadata.gz: 595d8186269bd5d7b5ad799de0fe260e9b38a68fe5c8bc2c94d97a7946a4fea6dc6cc6568d767448d0f483287f7efc0510cd620040ad1bd6183271fd4bf5eee7
+  data.tar.gz: c30dee3c333a7912c872aa2aebe1ec62cac621eb40fb325049657bb5648c2a21ff3d9d51fc787c0ca72d9afc13e904eb3ced4d45a5aa302a67e4f002b8c1f7f1

data/README.md

@@ -0,0 +1,111 @@
+# YYMMDD
+
+[![Build Status](https://travis-ci.org/sshaw/yymmdd.png?branch=master)](https://travis-ci.org/sshaw/yymmdd)
+
+Tiny DSL for idiomatic date parsing and formatting.
+
+## Overview
+
+    require "yymmdd"
+
+    include YYMMDD
+
+    puts yy/mm              # 14/08 (i.e., today's date)
+    puts yyyy/mm            # 2014/08
+    date = ymd(411207)      # Date.new(1941, 12, 7)
+
+    date = Date.today
+    puts yyyy.mm.dd(date)   # 2014.08.09
+    puts dd/mm/yy(date)     # 08/09/14
+    puts ymd(date)          # 1489
+	puts yymmdd(date)       # 140809
+
+    date = yyyy.mm.dd("1941.12.07")  # Date.new(1941, 12, 7)
+    date = mm.dd.yy("11.22.63")      # Date.new(1963, 11, 22)
+    date = mm/dd/yy("11/21/99")      # ...
+    date = mm/dd/yyyy("11/21/1999")
+    date = mm-dd-yyyy("11-21-1999")
+    date = m-d-y("11-21-99")
+
+## Installation
+
+### Rubygems:
+
+    gem install yymmdd
+
+### Bundler:
+
+    gem "yymmdd"
+
+## Usage
+
+All functions are [`module_function`s](http://www.ruby-doc.org/core-2.1.2/Module.html#method-i-module_function)
+so you must `include YYMMDD` to use them.
+
+When given a `String` it will attempt to parse it as the specified format and return a `Date`.
+
+When given a `Date` it will return a `String` in the specified format.
+
+An `ArgumentError` is raised if the date can't be parsed or formatted.
+
+With no arguments it will return an instance of a `String`-like object (it overrides `to_s` and `to_str`) representing
+today's date in the specified format. In the most common cases you can treat it like a `String`:
+
+    date = yyyy/mm/dd
+	puts "Today's date: #{date}"
+    text = ["Dates: ", yy/mm, yyyy/mm].join(", ")
+	text = "A great date: " << date
+
+But in some instances you'll have to expilictly call `to_s`:
+
+    printf "Today's date: %s\n", date.to_s
+
+All the heavy lifting is done by `Date#strftime` and `Date.strptime`.
+
+### Format Specifiers
+
+The table below lists the available format specifiers. All of these can be separated by one of the supported
+delimiters: `"/"`, `"."`, or `"-"`.
+
+<table>
+  <thead>
+	<th>Name</th><th>Format</th>
+  </thead>
+  <tbody>
+	<tr>
+	  <td><code>d</code></td><td>day of the year, no 0 padding</td>
+	</tr>
+	<tr>
+	  <td><code>dd</code></td><td>day of the year</td>
+	</tr>
+	<tr>
+	  <td><code>m</code></td><td>day of the month, no 0 padding</td>
+	</tr>
+	<tr>
+	  <td><code>mm</code></td><td>day of the month</td>
+	</tr>
+	<tr>
+	  <td><code>y</code></td><td>2 digit year</td>
+	</tr>
+	<tr>
+	  <td><code>yy</code></td><td>2 digit year</td>
+	</tr>
+	<tr>
+	  <td><code>yyyy</code></td><td>4 digit year</td>
+	</tr>
+  </tbody>
+</table>
+
+There are also combined, delimiterless functions for all combinations of the above, e.g., `ymd`, `mdy`, `yymmdd`, etc...
+
+## Caveats
+
+Due to operator precedence you can't mix delimiters.
+
+## Author
+
+Skye Shaw [sshaw AT gmail.com]
+
+## License
+
+Released under the MIT License: www.opensource.org/licenses/MIT

data/lib/yymmdd.rb

@@ -0,0 +1,104 @@
+require "date"
+
+module YYMMDD
+  VERSION = "0.0.1"
+
+  FORMATS = %w[yyyy yy y mm m dd d]
+  FORMATS.each do |abbr|
+    define_method(abbr) { |date = nil| DatePart.new(abbr, date) }
+    module_function abbr
+  end
+
+  groups = FORMATS.group_by { |fmt| fmt[0] }
+  groups["y"].each do |y|
+    groups["m"].each do |m|
+      groups["d"].each do |d|
+        [y, m, d].permutation.each do |set|
+          name = set.join("")
+          module_eval(<<-YMD, __FILE__, __LINE__)
+            def #{name}(date = nil)
+              #{set[0]} << #{set[1]} << #{set[2]}(date)
+            end
+          YMD
+
+          module_function name
+        end
+      end
+    end
+  end
+
+  class DatePart # :nodoc:
+    # Output formats
+    STRFTIME = {
+      "y"    => "%y",
+      "yy"   => "%y",
+      "yyyy" => "%Y",
+      "m"    => "%-m",
+      "mm"   => "%m",
+      "d"    => "%-d",
+      "dd"   => "%d"
+    }.freeze
+
+    # Input formats, strptime() doesn't support "%-X" formats
+    STRPTIME = STRFTIME.merge("d" => "%d", "m" => "%m").freeze
+
+    attr :format
+    attr :date
+
+    def initialize(format, date)
+      @format = format
+      @date = date
+      @parts = [[self, ""]]
+    end
+
+    def /(date = nil)
+      process("/", date)
+    end
+
+    def -(date = nil)
+      process("-", date)
+    end
+
+    def << (date = nil)
+      process("", date)
+    end
+
+    FORMATS.each do |abbr|
+      define_method(abbr) { |date = nil| process(".", DatePart.new(abbr, date)) }
+    end
+
+    def to_s
+      build_date.to_s
+    end
+
+    def to_str
+      to_s
+    end
+
+    def inspect
+      to_s
+    end
+
+    private
+    def process(tok, part)
+      raise ArgumentError, "invalid format" unless part.is_a?(DatePart)
+
+      @parts << [part, tok]
+      return build_date if part.date
+      self
+    end
+
+    def build_date
+      date = @parts[-1][0].date || Date.today
+
+      if date.is_a?(Date)
+        fmt = @parts.map { |part, tok| sprintf("%s%s", tok, STRFTIME[part.format]) }.join("")
+        date.strftime(fmt)
+      else
+        fmt  = @parts.map { |part, tok| sprintf("%s%s", tok, STRPTIME[part.format]) }.join("")
+        date = date.to_s if date.is_a?(Fixnum)
+        Date.strptime(date, fmt)
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,61 @@
+--- !ruby/object:Gem::Specification
+name: yymmdd
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Skye Shaw
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-08-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: |2
+      Tiny DSL for idiomatic parsing and formatting of numeric date components.
+email: skye.shaw@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- README.md
+- lib/yymmdd.rb
+homepage: http://github.com/sshaw/yymmdd
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Tiny DSL for idiomatic date parsing and formatting
+test_files: []