fuzzy_time_ago 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: cbe2d9d7bd9fc1219b232362f7a650dc6ddcf505887a4b7f99d27313354a99d6
+  data.tar.gz: c4f890d09417ee589b2d902ad1eb13fea1b71e8a7e2b582392e8e7b7bc9149a0
+SHA512:
+  metadata.gz: f48fcdebc6762ec7170eeb85e66cd69702fe50f18af336200843bf6adf9342a0078a279c69fe4c767537a8dd117dba5e67e4e5c2a5a6f580a4ecd24b6d4f2050
+  data.tar.gz: e93ba5f89d5bc0402dea16e952f198dceb292fa11311a3dcce1878aae069f116c582326fdb4835bfa6551fae312fae054b725fb54d22fc985445d725304a393c

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,16 @@
+plugins: 
+- rubocop-rspec
+- rubocop-rake
+
+# Disable metrics. Although fuzzy_ago is long, it is in reality not complex at all
+Metrics:
+  Enabled: false
+
+RSpec/MultipleExpectations:
+  Enabled: false
+RSpec/ExampleLength:
+  Max: 10
+  
+AllCops:
+  Exclude:
+    - 'vendor/**/*'

data/Dockerfile

@@ -0,0 +1,33 @@
+# This image is (indirectly) based on the official ubuntu:jammy image, but includes git, curl, wget and some other stuff out of the box.
+FROM buildpack-deps:jammy
+
+ARG USERNAME=vagrant
+ARG UID=1000
+ARG GID=1000
+ARG KEYFILE=
+
+# Set up default user
+RUN groupadd -g $GID $USERNAME
+RUN useradd -m -u $UID -g $GID -s /bin/bash $USERNAME
+
+# This system has been minimized by removing packages and content that are required on a system that users do not log into.
+# unminimize restores content and packages that are found on a default server system in order to make this system more suitable for interactive use.
+RUN yes | unminimize 
+
+# Install sudo (which for some bizarre reason is missing, and not restored by unminimize) and an SSH server.
+RUN apt-get update && apt-get install -y sudo openssh-server
+# Allow the default user passwordless sudo
+RUN echo "$USERNAME      ALL = NOPASSWD: ALL" >> /etc/sudoers
+
+# Configure SSH access with the passed public key (KEYFILE)
+RUN mkdir /var/run/sshd
+RUN mkdir -p "/home/$USERNAME/.ssh"
+COPY $KEYFILE "/home/$USERNAME/.ssh/authorized_keys"
+RUN chown -R "$USERNAME":"$USERNAME" "/home/$USERNAME/.ssh"
+RUN echo "Host remotehost\n\tStrictHostKeyChecking no\n" >> "/home/$USERNAME/.ssh/config"
+
+# Open port for SSH
+EXPOSE 22
+
+# Run SSH server (daemonized)
+CMD ["/usr/sbin/sshd", "-D"]

data/Gemfile

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec
+
+group :ci do
+  gem 'rake'
+  gem 'rspec'
+  gem 'rubocop'
+  gem 'rubocop-rake'
+  gem 'rubocop-rspec'
+end
+
+group :development do
+  gem 'bump'
+end

data/Gemfile.lock

@@ -0,0 +1,78 @@
+PATH
+  remote: .
+  specs:
+    fuzzy_time_ago (1.0.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.3)
+    bump (0.10.0)
+    diff-lcs (1.6.2)
+    json (2.14.1)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    parallel (1.27.0)
+    parser (3.3.9.0)
+      ast (~> 2.4.1)
+      racc
+    prism (1.5.1)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.3.0)
+    regexp_parser (2.11.3)
+    rspec (3.13.1)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.5)
+      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.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.6)
+    rubocop (1.80.2)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.46.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.47.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-rake (0.7.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.72.1)
+    rubocop-rspec (3.7.0)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.72, >= 1.72.1)
+    ruby-progressbar (1.13.0)
+    timecop (0.9.10)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.1.0)
+
+PLATFORMS
+  ruby
+  x86_64-linux
+
+DEPENDENCIES
+  bump
+  fuzzy_time_ago!
+  rake
+  rspec
+  rubocop
+  rubocop-rake
+  rubocop-rspec
+  timecop
+
+BUNDLED WITH
+   2.7.2

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 BadIdeaException
+
+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,107 @@
+# FuzzyTimeAgo
+
+A Ruby gem that converts timestamps into fuzzy, human-friendly relative time strings like "less than a minute ago", "2 months ago", "over a year ago", etc. It is intended as a light-weight replacement to Rails' [`time-ago-in-words`](https://api.rubyonrails.org/classes/ActionView/Helpers/DateHelper.html#method-i-time_ago_in_words), albeit not an exact replacement (see section [Differences](#differences))
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'fuzzy_time_ago'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install fuzzy_time_ago
+
+## Usage
+
+```ruby
+require 'fuzzy_time_ago'
+
+# Basic usage with Time or Date objects
+FuzzyTimeAgo.fuzzy_ago(Time.now - 30)     # => "less than a minute ago"
+FuzzyTimeAgo.fuzzy_ago(Time.now - 3600)   # => "about an hour ago"
+FuzzyTimeAgo.fuzzy_ago(Date.today - 1)    # => "a day ago"
+
+# Convenience method on Time objects
+Time.now.fuzzy_ago                        # => "less than a minute ago"
+(Time.now - 86400).fuzzy_ago              # => "a day ago"
+```
+
+### Output Specification
+
+| Time Range | Output Format |
+|:-----------|:--------------|
+| 0-59 seconds | `"less than a minute ago"` |
+| 60-119 seconds | `"about a minute ago"` |
+| 2-59 minutes | `"X minutes ago"` |
+| 1-2 hours | `"about an hour ago"` |
+| 2-23 hours | `"about X hours ago"` |
+| 1 day | `"a day ago"` |
+| 2-6 days | `"X days ago"` |
+| 1 week | `"about a week ago"` |
+| 2+ weeks | `"about X weeks ago"` |
+| 1 month | `"about a month ago"` |
+| 2 months | `"about 2 months ago"` |
+| 3-11 months | `"X months ago"` |
+| 12 months - 15 months | `"about a year ago"` |
+| 15 months - 21 months | `"over a year ago"` |
+| 21 months - 2 years | `"almost 2 years ago"` |
+| 2+ years | "about/over/almost X years ago" |
+
+*Note: For periods longer than weeks, the gem uses calendar-based calculations rather than fixed day counts.*
+
+## Differences from Rails' `time_ago_in_words`
+
+### Output Format Differences
+
+| Time Period | FuzzyTimeAgo | Rails `time_ago_in_words` | Explanation |
+|:------------|:-------------|:--------------------------|:------------|
+| 1 day | `"a day"` | `"1 day"` | Uses "a" instead of "1" |
+| 1 week | `"about a week"` | `"7 days"` | Switches unit to weeks, while Rails continues to use days |
+| 1 month | `"about a month"` | `"about 1 month"` | Uses "a" instead of "1" |
+| 1 year | `"about a year"` | `"about 1 year"` | Uses "a" instead of "1" |
+
+### Calendar Arithmetic vs Fixed Duration
+
+**The most significant difference is in how longer periods are calculated:**
+
+- **FuzzyTimeAgo**: Uses true calendar arithmetic
+  - Calculates months by actual calendar months
+  - Adjusts for day-of-month differences
+  - Respects varying month lengths (28-31 days) and leap years
+
+- **Rails**: Uses fixed duration approximations
+  - Assumes all months are 30 days
+  - Assumes all years are 365 days
+  - Only accounts for leap years in final year calculation, not month calculations
+
+**Practical impact**: For periods longer than weeks, this gem will be more accurate for actual calendar dates, while Rails provides consistent duration-based approximations.
+
+## Development
+
+After checking out the repo, run `bundle install` to install dependencies. Then, run `rake spec` to run the tests.
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+For version management, this gem uses [`bump`](https://github.com/gregorym/bump):
+```
+bundle exec rake bump:major
+bundle exec rake bump:patch
+bundle exec rake bump:minor
+bundle exec rake bump:pre
+```
+Release and publishing are automated through a Github Actions workflow.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/BadIdeaException/fuzzy_time_ago.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+require 'bump/tasks'
+
+RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new(:lint)
+
+desc 'Run the specs'
+task default: :spec
+
+Bump.tag_by_default = true
+Rake::Task['bump:patch'].enhance(%w[lint spec])
+Rake::Task['bump:minor'].enhance(%w[lint spec])
+Rake::Task['bump:major'].enhance(%w[lint spec])

data/Vagrantfile

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+# All Vagrant configuration is done below. The "2" in Vagrant.configure
+# configures the configuration version (we support older styles for
+# backwards compatibility). Please don"t change it unless you know what
+# you"re doing.
+
+USERNAME = 'vagrant'
+
+Vagrant.configure('2') do |config|
+  config.vm.provider 'docker' do |docker|
+    # Create ssh keys unless they are already created
+    `ssh-keygen -f #{USERNAME}.key -t ed25519 -N ""` unless File.file?("#{USERNAME}.key")
+
+    docker.build_dir = '.'
+    docker.build_args = [
+      # Make default user inside the VM have the same UID and GID as the user running the vagrant command
+      # This makes it a lot easier working with shared code locations, because the user will own the files
+      '--build-arg', "USERNAME=#{USERNAME}",
+      '--build-arg', "UID=#{Process.uid}",
+      '--build-arg', "GID=#{Process.gid}",
+      '--build-arg', "KEYFILE=#{USERNAME}.key.pub"
+    ]
+    docker.has_ssh = true
+    docker.remains_running = true
+    # Use project"s directory name as name for the container.
+    # (Note that this will fail if such a container already exists.)
+    docker.name = File.dirname(__FILE__).split('/').last
+    # Use container name as hostname inside the container, as is the default behavior for other providers.
+    docker.create_args = ['--hostname', docker.name]
+  end
+
+  config.ssh.username = USERNAME
+  config.ssh.private_key_path = "#{USERNAME}.key"
+
+  # Expose port 9229 to allow debugging
+  config.vm.network :forwarded_port, guest: 9229, host: 9229
+
+  config.vm.provision 'shell', name: 'Install Ruby', env: { 'RUBY_VERSION' => '3.4.5' }, inline: <<-SHELL
+    echo "Building Ruby v${RUBY_VERSION} from source."
+    curl -L https://cache.ruby-lang.org/pub/ruby/${RUBY_VERSION%.*}/ruby-${RUBY_VERSION}.tar.gz | tar -xz -C /tmp
+    cd "/tmp/ruby-${RUBY_VERSION}"
+    ./configure
+    make
+    make install
+  SHELL
+  config.vm.provision 'shell', name: 'Install Bundler', privileged: false,
+                               inline: "gem install bundler && bundle config set --local path '/vagrant/vendor/bundle'"
+
+  config.vm.provision 'shell', name: 'Install aider', privileged: false,
+                               inline: <<-SHELL
+    sudo apt-get update && sudo apt-get install -y python3-pip
+    python3 -m pip install --user aider-install
+    /home/vagrant/.local/bin/aider-install
+                               SHELL
+
+  config.vm.provision 'file', source: '~/.aider.conf.yml',
+                              destination: '/home/vagrant/.aider.conf.yml'
+
+  config.ssh.extra_args = ['-t', 'cd /vagrant; bash --login']
+end
+# rubocop:enable Metrics

data/fuzzy_time_ago.gemspec

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require_relative 'lib/fuzzy_time_ago/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'fuzzy_time_ago'
+  spec.version = FuzzyTimeAgo::VERSION
+  spec.authors = ['BadIdeaException']
+
+  spec.summary = 'Create fuzzy, human-readable time ago strings'
+  spec.description = 'A Ruby gem that converts timestamps into fuzzy, human-friendly relative time strings ' \
+                     "like 'less than a minute ago', 'about 2 months ago', etc."
+  spec.homepage = 'https://github.com/BadIdeaException/fuzzy_time_ago'
+  spec.license = 'MIT'
+  spec.required_ruby_version = '>= 2.7.0'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/BadIdeaException/fuzzy_time_ago'
+
+  # Specify which files should be added to the gem when it is released.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z 2>/dev/null`.split("\x0").reject do |f|
+      f.match(%r{\A(?:(?:test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
+    end
+  end
+  spec.require_paths = ['lib']
+
+  # Development dependencies
+  spec.add_development_dependency 'timecop'
+end

data/fuzzy_time_ago.sublime-project

@@ -0,0 +1,8 @@
+{
+	"folders":
+	[
+		{
+			"path": "."
+		}
+	]
+}

data/lib/fuzzy_time_ago/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module FuzzyTimeAgo
+  VERSION = '1.0.0'
+end

data/lib/fuzzy_time_ago.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require_relative 'fuzzy_time_ago/version'
+
+# FuzzyTimeAgo provides a method to convert timestamps into fuzzy, human-readable
+# descriptions of the time elapsed relative to the current system time.
+module FuzzyTimeAgo
+  class Error < StandardError; end
+  Difference = Struct.new(:seconds, :minutes, :hours, :days, :weeks, :months, :years)
+
+  # Convert a timestamp into a fuzzy, human-readable string specifying the difference to current system time
+  def self.fuzzy_ago(target_time)
+    raise ArgumentError, 'Expected Time or Date object' unless target_time.is_a?(Time) || target_time.is_a?(Date)
+
+    target_time = target_time.to_time if target_time.is_a?(Date)
+
+    now = Time.now
+    delta = now.to_i - target_time.to_i
+
+    case delta
+    when 0...60 then return 'less than a minute ago'
+    when 60...120 then return 'about a minute ago'
+    when 120...3600 then return "#{(delta / 60).to_i} minutes ago"
+    when 3600...7200 then return 'about an hour ago'
+    when 7200...24 * 3600 then return "about #{(delta / 3600).to_i} hours ago"
+    when 24 * 3600...48 * 3600 then return 'a day ago'
+    when 48 * 3600...7 * 24 * 3600 then return "#{(delta / (24 * 3600)).to_i} days ago"
+    when 7 * 24 * 3600...14 * 24 * 3600 then return 'about a week ago'
+    end
+
+    months_ago = (now.month - target_time.month) + 12 * (now.year - target_time.year)
+    months_ago -= 1 if now.day < target_time.day
+    # binding.break
+    case months_ago
+    when 0 then return "about #{(delta / (7 * 24 * 3600)).to_i} weeks ago"
+    when 1 then return 'about a month ago'
+    when 2 then return 'about 2 months ago'
+    when 3...12 then return "#{months_ago} months ago"
+    when 12...15 then return 'about a year ago'
+    when 15...21 then return 'over a year ago'
+    end
+
+    years_ago = (months_ago / 12).to_i
+    months_ago %= 12
+    case months_ago
+    when 0...3 then "about #{years_ago} years ago"
+    when 3...9 then "over #{years_ago} years ago"
+    when 9...12 then "almost #{years_ago + 1} years ago"
+    end
+  end
+end
+
+# Add convenience method to Time class
+class Time
+  def fuzzy_ago
+    FuzzyTimeAgo.fuzzy_ago(self)
+  end
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification
+name: fuzzy_time_ago
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- BadIdeaException
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-09-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: timecop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A Ruby gem that converts timestamps into fuzzy, human-friendly relative
+  time strings like 'less than a minute ago', 'about 2 months ago', etc.
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- Dockerfile
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- Vagrantfile
+- fuzzy_time_ago.gemspec
+- fuzzy_time_ago.sublime-project
+- lib/fuzzy_time_ago.rb
+- lib/fuzzy_time_ago/version.rb
+homepage: https://github.com/BadIdeaException/fuzzy_time_ago
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/BadIdeaException/fuzzy_time_ago
+  source_code_uri: https://github.com/BadIdeaException/fuzzy_time_ago
+post_install_message:
+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.4.19
+signing_key:
+specification_version: 4
+summary: Create fuzzy, human-readable time ago strings
+test_files: []