dateslash 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7d6ced45484eb8ba6121b45c16f58e717ac99e59a8ad72143945247a92a475ac
+  data.tar.gz: 6ea460b24e004d82dfbaf96805e54019a28893a80f29ebe13ca2b87f3b0e86c2
+SHA512:
+  metadata.gz: fc1767583fa5c30dbc28f6eb2589e864e8fe51035b11e4714eacdee83cfb90c6ba03eeddc5b90e5b49c20640a5fae52e036221734bac26d27571425e43c2ec09
+  data.tar.gz: e41c0e4f8b6d104c47c99ebaa9a21c1bde75fdba20e8b536be6afa60b138354a8b9a32bf7eb124370e30648bdb43a59c65939c4cff5c164eb5a3660b2b6d968d

data/CHANGELOG.md

@@ -0,0 +1,8 @@
+## [Unreleased]
+
+- Interpret only valid three-term year/month/day expressions as dates
+- Preserve division behavior for invalid dates and expressions with four or more terms
+
+## [0.1.0] - 2026-08-18
+
+- Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,10 @@
+# Code of Conduct
+
+"dateslash" follows [The Ruby Community Conduct Guideline](https://www.ruby-lang.org/en/conduct) in all "collaborative space", which is defined as community communications channels (such as mailing lists, submitted patches, commit comments, etc.):
+
+* Participants will be tolerant of opposing views.
+* Participants must ensure that their language and actions are free of personal attacks and disparaging personal remarks.
+* When interpreting the words and actions of others, participants should always assume good intentions.
+* Behaviour which can be reasonably considered harassment will not be tolerated.
+
+If you have any concerns about behaviour within this project, please contact us at [Issue](https://github.com/t3tra-dev/dateslash/issues).

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 t3tra
+
+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,96 @@
+# DateSlash
+
+DateSlash adds a Ruby refinement that makes year/month/day expressions readable with `/`.
+
+```ruby
+using DateSlash
+
+2026 / 8
+# => 253
+
+2026 / 8 / 18
+# => #<Date: 2026-08-18 ...>
+```
+
+The first `/` returns an intermediate object that still behaves like the integer quotient of `year / month`. The second `/` converts that intermediate value into a `Date` only when the expression has exactly three terms and they form a valid calendar date.
+
+## Installation
+
+Add the gem to your application:
+
+```bash
+bundle add dateslash
+```
+
+Or install it directly:
+
+```bash
+gem install dateslash
+```
+
+## Usage
+
+Require the gem and enable the refinement in the scope where you want to use it.
+
+```ruby
+require "dateslash"
+
+using DateSlash
+
+date = 2026 / 8 / 18
+date.class
+# => Date
+
+prefix = 2026 / 8
+prefix.to_i
+# => 253
+```
+
+The refinement only applies when the left-hand side is a four-digit year, the month is from 1 to 12, and the complete date is valid. Invalid dates and expressions with four or more terms keep Ruby's normal division behavior.
+
+```ruby
+using DateSlash
+
+10 / 2
+# => 5
+
+2026 / 13
+# => 155
+
+2026 / 2 / 29
+# => 34
+
+2026 / 8 / 18 / 2
+# => 7
+```
+
+## Development
+
+After checking out the repo, run:
+
+```bash
+bin/setup
+bundle exec rake test
+```
+
+You can also use `bin/console` to try the refinement interactively.
+
+To install the gem locally:
+
+```bash
+bundle exec rake install
+```
+
+To release a new version, update [lib/dateslash/version.rb](lib/dateslash/version.rb) and run:
+
+```bash
+bundle exec rake release
+```
+
+## License
+
+The gem is available as open source under the terms of the MIT License.
+
+## Code of Conduct
+
+Everyone interacting in this project is expected to follow the code of conduct in [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+require "standard/rake"
+
+task default: %i[test standard]

data/lib/dateslash/version.rb

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

data/lib/dateslash.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "date"
+require_relative "dateslash/date_prefix"
+require_relative "dateslash/version"
+
+module DateSlash
+  class Error < StandardError; end
+
+  YEAR_RANGE = (1000..9999)
+  MONTH_RANGE = (1..12)
+  DAY_RANGE = (1..31)
+
+  refine Integer do
+    def /(other)
+      if DateSlash::YEAR_RANGE.cover?(self) &&
+          other.is_a?(Integer) &&
+          DateSlash::MONTH_RANGE.cover?(other)
+        DateSlash::DatePrefix.new(self, other, div(other))
+      else
+        quotient = super
+        DateSlash::DivisionResult.wrap(quotient)
+      end
+    end
+  end
+end

data/sig/dateslash.rbs

@@ -0,0 +1,33 @@
+module DateSlash
+  VERSION: String
+  YEAR_RANGE: Range[Integer]
+  MONTH_RANGE: Range[Integer]
+  DAY_RANGE: Range[Integer]
+
+  class DivisionValue < Numeric
+    def initialize: (Numeric quotient) -> void
+    def ==: (untyped other) -> bool
+    def <=>: (untyped other) -> Integer?
+    def coerce: (Numeric other) -> [Numeric, Numeric]
+    def inspect: () -> String
+    def to_s: () -> String
+    def to_i: () -> Integer
+    def to_int: () -> Integer
+    def to_f: () -> Float
+    def integer?: () -> bool
+  end
+
+  class DivisionResult < DivisionValue
+    def self.wrap: (Numeric quotient) -> Numeric
+    def /: (untyped other) -> Numeric
+  end
+
+  class DatePrefix
+    def initialize: (Integer year, Integer month, Integer quotient) -> void
+    def /: (untyped day) -> (Date | Numeric)
+    def inspect: () -> String
+    def to_s: () -> String
+    def to_i: () -> Integer
+    def to_int: () -> Integer
+  end
+end

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: dateslash
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- t3tra
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: DateSlash lets you write expressions like 2026 / 8 / 18 and get a Date
+  object while preserving normal integer division elsewhere.
+email:
+- t3tra-dev@users.noreply.github.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/dateslash.rb
+- lib/dateslash/version.rb
+- sig/dateslash.rbs
+homepage: https://github.com/t3tra-dev/dateslash
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/t3tra-dev/dateslash
+  source_code_uri: https://github.com/t3tra-dev/dateslash
+  changelog_uri: https://github.com/t3tra-dev/dateslash/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Readable year/month/day expressions via a Ruby refinement
+test_files: []