strftime_roulette 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: df16f96b9ea8bc378ea4094d15a9ec22a91ab8fd1d67864342200f2be9e7b2d4
+  data.tar.gz: 04a1b2eb67d44ad2183d5944e3baf94bec53cda17dc0280ca38a09d88c7e41f5
+SHA512:
+  metadata.gz: 130c25e1fb12a409d886b18ccb2361f6b925b96ecdf28cd7775abfa1bb9c75d67f8b5f3f3cedd8582c287f9b2de9baa2682ab0fbbd21079821430bebc68419ff
+  data.tar.gz: 0f7ff5956e539e188fb54c479469e94e1b65740d11ce5cced62ca1ecaf0ee01899980010446d003c2a98d8b0d57e66e1e54df015d5e40677ead712ab6949e8c6

data/.rspec

@@ -0,0 +1,2 @@
+--require spec_helper
+--format documentation

data/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,33 @@
+PATH
+  remote: .
+  specs:
+    strftime_roulette (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.6.2)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.7)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.6)
+
+PLATFORMS
+  arm64-darwin-24
+  ruby
+
+DEPENDENCIES
+  rspec (~> 3.0)
+  strftime_roulette!
+
+BUNDLED WITH
+   2.7.2

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Jesse Waites
+
+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.md

@@ -0,0 +1,121 @@
+# strftime_roulette
+
+![roulette](roulette.jpeg)
+
+Because consistent date formatting is boring.
+
+Ever looked at your app's date output and thought, "This is too predictable"? Yeah, me neither. But here we are.
+
+**strftime_roulette** adds a `strftime_roulette` method to Date and Time objects. Every call returns a randomly formatted string. That's it. That's the gem.
+
+## Why?
+
+No good reason. Sometimes you just want to write some code that makes you smile.
+
+## Installation
+
+```ruby
+gem 'strftime_roulette'
+```
+
+## How it Works
+
+```ruby
+require 'strftime_roulette'
+
+Date.today.strftime_roulette
+# => "2026-01-16 12:00:00"
+
+Date.today.strftime_roulette
+# => "January 16, 2026 12:00 AM"
+
+Date.today.strftime_roulette
+# => "01/16/2026 12:00:00"
+```
+
+Each call picks a random format. You never know what you're gonna get.
+
+## Filter by Category
+
+Want only date formats? Only time formats?
+
+```ruby
+Time.now.strftime_roulette(:time)
+# => "14:30:45"
+# => "2:30 PM"
+# => "14:30"
+
+Date.today.strftime_roulette(:date)
+# => "Thu Jan 16"
+# => "January 16, 2026"
+# => "01-16-2026"
+```
+
+## Go Atomic
+
+Pass `single: true` to get output from a single strftime directive:
+
+```ruby
+Date.today.strftime_roulette(:date, single: true)
+# => "Thursday"  # or "16" or "January" or "2026"
+
+Time.now.strftime_roulette(:time, single: true)
+# => "PM"  # or "45" or "14" or "UTC"
+```
+
+## Arguments
+
+| Argument | Values | Description |
+|----------|--------|-------------|
+| category | (none), `:date`, `:time` | Filter format type |
+| `single:` | `true`/`false` | Single directive vs compound pattern |
+
+## Practical Uses
+
+1. Annoying your coworkers
+2. Testing if your UI handles various date formats gracefully
+3. Adding chaos to your development environment
+4. Making QA question their sanity
+
+## Available Formats
+
+### Date Patterns
+- `%Y-%m-%d` → 2026-01-16
+- `%m/%d/%Y` → 01/16/2026
+- `%B %d, %Y` → January 16, 2026
+- `%a %b %e` → Thu Jan 16
+- `%d/%m/%Y` → 16/01/2026
+- `%b %d '%y` → Jan 16 '26
+- `%A, %B %d` → Thursday, January 16
+- `%m-%d-%Y` → 01-16-2026
+- `%e %b %Y` → 16 Jan 2026
+- `%D` → 01/16/26
+
+### Time Patterns
+- `%H:%M:%S` → 14:30:45
+- `%I:%M %p` → 02:30 PM
+- `%H:%M` → 14:30
+- `%I:%M:%S %p` → 02:30:45 PM
+- `%H:%M:%S %Z` → 14:30:45 UTC
+- `%l:%M %P` → 2:30 pm
+
+### Combined Patterns
+- `%Y-%m-%d %H:%M:%S` → 2026-01-16 14:30:45
+- `%D %H:%M` → 01/16/26 14:30
+- `%B %d, %Y %I:%M %p` → January 16, 2026 02:30 PM
+- `%a %b %e %H:%M` → Thu Jan 16 14:30
+- `%m/%d/%Y %H:%M:%S` → 01/16/2026 14:30:45
+
+### Single Directives
+
+**Date:** `%a` `%A` `%w` `%u` `%d` `%e` `%j` `%U` `%V` `%b` `%B` `%m` `%y` `%Y` `%C`
+
+**Time:** `%S` `%L` `%s` `%M` `%H` `%I` `%k` `%l` `%p` `%P` `%Z`
+
+## Disclaimer
+
+Please do not use this in production. Unless you want to. I'm not your boss.
+
+## License
+
+MIT

data/Rakefile

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/blog.md

@@ -0,0 +1,75 @@
+# Introducing strftime_roulette: Because Consistent Date Formatting is Boring
+
+Ever looked at your app's date output and thought, "This is too predictable"? Yeah, me neither. But here we are.
+
+I'm releasing **strftime_roulette**, a Ruby gem that adds a `strftime_roulette` method to Date and Time objects. Every call returns a randomly formatted string. That's it. That's the gem.
+
+## Why?
+
+No good reason. Sometimes you just want to write some code that makes you smile.
+
+## How it Works
+
+```ruby
+require 'strftime_roulette'
+
+Date.today.strftime_roulette
+# => "2026-01-16 12:00:00"
+
+Date.today.strftime_roulette
+# => "January 16, 2026 12:00 AM"
+
+Date.today.strftime_roulette
+# => "01/16/2026 12:00:00"
+```
+
+Each call picks a random format. You never know what you're gonna get.
+
+## Filter by Category
+
+Want only date formats? Only time formats? You can do that:
+
+```ruby
+Time.now.strftime_roulette(:time)
+# => "14:30:45"
+# => "2:30 PM"
+# => "14:30"
+
+Date.today.strftime_roulette(:date)
+# => "Thu Jan 16"
+# => "January 16, 2026"
+# => "01-16-2026"
+```
+
+## Go Atomic
+
+Pass `single: true` to get output from a single strftime directive:
+
+```ruby
+Date.today.strftime_roulette(:date, single: true)
+# => "Thursday"  # or "16" or "January" or "2026"
+
+Time.now.strftime_roulette(:time, single: true)
+# => "PM"  # or "45" or "14" or "UTC"
+```
+
+## Practical Uses
+
+1. Annoying your coworkers
+2. Testing if your UI handles various date formats gracefully
+3. Adding chaos to your development environment
+4. Making QA question their sanity
+
+## Installation
+
+```ruby
+gem 'strftime_roulette'
+```
+
+## Disclaimer
+
+Please do not use this in production. Unless you want to. I'm not your boss.
+
+---
+
+[GitHub](https://github.com/jessewaites/strftime_roulette) | MIT License

data/lib/strftime_roulette/core_ext.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require_relative "formats"
+
+module StrftimeRoulette
+  module CoreExt
+    def strftime_roulette(category = nil, single: false)
+      format = pick_format(category, single)
+      strftime(format)
+    rescue StandardError
+      to_s
+    end
+
+    private
+
+    def pick_format(category, single)
+      case category
+      when :time
+        single ? Formats::TIME_DIRECTIVES.sample : Formats::TIME_PATTERNS.sample
+      when :date
+        single ? Formats::DATE_DIRECTIVES.sample : Formats::DATE_PATTERNS.sample
+      else
+        Formats::COMBINED_PATTERNS.sample
+      end
+    end
+  end
+end
+
+class Date
+  include StrftimeRoulette::CoreExt
+end
+
+class Time
+  include StrftimeRoulette::CoreExt
+end

data/lib/strftime_roulette/formats.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module StrftimeRoulette
+  module Formats
+    TIME_DIRECTIVES = %w[%S %L %s %M %H %I %k %l %p %P %Z].freeze
+
+    DATE_DIRECTIVES = %w[%a %A %w %u %d %e %j %U %V %b %B %m %y %Y %C].freeze
+
+    TIME_PATTERNS = [
+      "%H:%M:%S",
+      "%I:%M %p",
+      "%H:%M",
+      "%I:%M:%S %p",
+      "%H:%M:%S %Z",
+      "%l:%M %P"
+    ].freeze
+
+    DATE_PATTERNS = [
+      "%Y-%m-%d",
+      "%m/%d/%Y",
+      "%B %d, %Y",
+      "%a %b %e",
+      "%d/%m/%Y",
+      "%b %d '%y",
+      "%A, %B %d",
+      "%m-%d-%Y",
+      "%e %b %Y",
+      "%D"
+    ].freeze
+
+    COMBINED_PATTERNS = [
+      "%Y-%m-%d %H:%M:%S",
+      "%D %H:%M",
+      "%B %d, %Y %I:%M %p",
+      "%a %b %e %H:%M",
+      "%m/%d/%Y %H:%M:%S"
+    ].freeze
+  end
+end

data/lib/strftime_roulette/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module StrftimeRoulette
+  VERSION = "0.1.0"
+end

data/lib/strftime_roulette.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require "date"
+require_relative "strftime_roulette/version"
+require_relative "strftime_roulette/formats"
+require_relative "strftime_roulette/core_ext"
+
+module StrftimeRoulette
+end

data/strftime_roulette.gemspec

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative "lib/strftime_roulette/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "strftime_roulette"
+  spec.version = StrftimeRoulette::VERSION
+  spec.authors = ["Jesse Waites"]
+  spec.email = ["jesse@example.com"]
+
+  spec.summary = "Random strftime formatting for Date and Time"
+  spec.description = "Adds strftime_roulette method to Date and Time classes, returning randomly formatted date/time strings"
+  spec.homepage = "https://github.com/jessewaites/strftime_roulette"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 2.7.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git .github])
+    end
+  end
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification
+name: strftime_roulette
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jesse Waites
+bindir: bin
+cert_chain: []
+date: 2026-01-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Adds strftime_roulette method to Date and Time classes, returning randomly
+  formatted date/time strings
+email:
+- jesse@example.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".DS_Store"
+- ".rspec"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- blog.md
+- lib/strftime_roulette.rb
+- lib/strftime_roulette/core_ext.rb
+- lib/strftime_roulette/formats.rb
+- lib/strftime_roulette/version.rb
+- roulette.jpeg
+- strftime_roulette.gemspec
+homepage: https://github.com/jessewaites/strftime_roulette
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/jessewaites/strftime_roulette
+  source_code_uri: https://github.com/jessewaites/strftime_roulette
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.6
+specification_version: 4
+summary: Random strftime formatting for Date and Time
+test_files: []