put 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 833121595321bacc22e213e447580f40bbbe1500670d5072c582ae54624b468f
-  data.tar.gz: 07dd91f2ae928542e6d4ed42d046ed628fd6a28ef13978cba7ab811796128d92
+  metadata.gz: 946be21b2839e39c50fccfc55683ec69b8aa1d888a4030cd93aa3ff59f17ff18
+  data.tar.gz: 9cd544f2130f11a1285eaeeaff6b695ac3ca80513b721783836a4d7526b70178
 SHA512:
-  metadata.gz: 37a54ae5099e675f9819d4f53e754b481d9ed7b8ad10623ca1978a0277f94e61b6acbc4eac6b0949f1a8dd9ea1e780571f4a6e5b655f493f6ecf11f1687c26f9
-  data.tar.gz: 568dcf85f64510b6b8d8fedc70adc1740339893413a2dfad8a9f42d4f512a2dbbdf2b344356d0fcd38b4b320dbd09bb939a471e1d384b92078d4a74f37a3d631
+  metadata.gz: 057e1c3b3b7bcb4b8b79e9a98ec132f1c9d6faa03defb3095ae0d2fa5eaeed7b74e3d39d8bda3ab280d8b594e492b493008d1711349d1a11ddea6c1e95802eee
+  data.tar.gz: 2d093be68e236968499608dbd183ffbd99e7664cb6d3a929e0f15bbc904a0f86905a187f2f0046902bab0b055c5dd29399d1cf53a684e36f12a2e19e4bbcdf4b

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
-## [0.1.0] - 2022-09-21
+## [0.0.2] - 2022-09-21
+
+- Add support for Put.asc, Put.desc, and whether nils go first or last
+
+## [0.0.1] - 2022-09-21
 
 - Initial release

data/Gemfile

@@ -1,12 +1,8 @@
-# frozen_string_literal: true
-
 source "https://rubygems.org"
 
-# Specify your gem's dependencies in put.gemspec
 gemspec
 
-gem "rake", "~> 13.0"
-
-gem "minitest", "~> 5.0"
-
-gem "standard", "~> 1.3"
+gem "debug"
+gem "rake"
+gem "minitest"
+gem "standard"

data/Gemfile.lock

@@ -1,12 +1,18 @@
 PATH
   remote: .
   specs:
-    put (0.0.1)
+    put (0.0.2)
 
 GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.2)
+    debug (1.6.2)
+      irb (>= 1.3.6)
+      reline (>= 0.3.1)
+    io-console (0.5.11)
+    irb (1.4.1)
+      reline (>= 0.3.0)
     json (2.6.2)
     minitest (5.16.3)
     parallel (1.22.1)
@@ -15,6 +21,8 @@ GEM
     rainbow (3.1.1)
     rake (13.0.6)
     regexp_parser (2.5.0)
+    reline (0.3.1)
+      io-console (~> 0.5)
     rexml (3.2.5)
     rubocop (1.35.1)
       json (~> 2.3)
@@ -39,12 +47,14 @@ GEM
 
 PLATFORMS
   arm64-darwin-21
+  arm64-darwin-22
 
 DEPENDENCIES
-  minitest (~> 5.0)
+  debug
+  minitest
   put!
-  rake (~> 13.0)
-  standard (~> 1.3)
+  rake
+  standard
 
 BUNDLED WITH
    2.3.22

data/README.md

@@ -1,33 +1,17 @@
 # Put
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/put`. To experiment with that code, run `bin/console` for an interactive prompt.
+Put helps you put stuff in order when using
+[Enumerable#sort_by](https://ruby-doc.org/core-3.1.2/Enumerable.html#method-i-sort_by).
 
-TODO: Delete this and the text above, and describe your gem
+A neat trick when implementing complex sorting rules is to map them to an
+array of arrays of comparable elements in priority-order.
 
-## Installation
 
-Install the gem and add to the application's Gemfile by executing:
+## Code of Conduct
 
-    $ bundle add put
-
-If bundler is not being used to manage dependencies, install the gem by executing:
-
-    $ gem install put
-
-## Usage
-
-TODO: Write usage instructions here
-
-## Development
-
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
-
-## Contributing
-
-Bug reports and pull requests are welcome on GitHub at https://github.com/searls/put.
-
-## License
-
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+This project follows Test Double's [code of
+conduct](https://testdouble.com/code-of-conduct) for all community interactions,
+including (but not limited to) one-on-one communications, public posts/comments,
+code reviews, pull requests, and GitHub issues. If violations occur, Test Double
+will take any action they deem appropriate for the infraction, up to and
+including blocking a user from the organization's repositories.

data/Rakefile

@@ -1,12 +1,10 @@
-# frozen_string_literal: true
-
 require "bundler/gem_tasks"
 require "rake/testtask"
 
 Rake::TestTask.new(:test) do |t|
   t.libs << "test"
   t.libs << "lib"
-  t.test_files = FileList["test/**/test_*.rb"]
+  t.test_files = FileList["test/**/*_test.rb"]
 end
 
 require "standard/rake"

data/lib/put/nil_ext.rb

@@ -0,0 +1,12 @@
+module Put
+  module NilExtension
+    def <=>(other)
+      if ::Put::PutsThing === other
+        -(other <=> self)
+      else
+        super
+      end
+    end
+  end
+  ::NilClass.prepend(NilExtension)
+end

data/lib/put/puts_thing.rb

@@ -0,0 +1,65 @@
+module Put
+  class PutsThing
+    def <=>(other)
+      if value.nil? && (other.nil? || other&.value.nil?)
+        0
+      elsif value.nil?
+        nils_first? ? -1 : 1
+      elsif other.nil? || other&.value.nil?
+        nils_first? ? 1 : -1
+      elsif other && !other.reverse?
+        value <=> other.value
+      elsif other&.reverse?
+        other.value <=> value
+      else
+        value <=> 0
+      end
+    end
+
+    def reverse?
+      false
+    end
+
+    def nils_first?
+      false
+    end
+
+    class First < PutsThing
+      def value
+        -Float::INFINITY
+      end
+    end
+
+    class Last < PutsThing
+      def value
+        Float::INFINITY
+      end
+
+      def nils_first?
+        true
+      end
+    end
+
+    class InOrder < PutsThing
+      def initialize(value, nils_first:)
+        @value = value
+        @nils_first = nils_first
+      end
+
+      attr_reader :value
+
+      def nils_first?
+        @nils_first
+      end
+    end
+
+    class Ascending < InOrder
+    end
+
+    class Descending < InOrder
+      def reverse?
+        true
+      end
+    end
+  end
+end

data/lib/put/version.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
-class Put
-  VERSION = "0.0.1"
+module Put
+  VERSION = "0.0.2"
 end

data/lib/put.rb

@@ -1,38 +1,21 @@
 require_relative "put/version"
+require_relative "put/nil_ext"
+require_relative "put/puts_thing"
 
-class Put
+module Put
   def self.first
-    First
+    @@first ||= PutsThing::First.new.freeze
   end
 
   def self.last
-    Last
+    @@last ||= PutsThing::Last.new.freeze
   end
 
-  def initialize(value)
-    @value = value
+  def self.desc(value, nils_first: false)
+    PutsThing::Descending.new(value, nils_first: nils_first)
   end
 
-  First = new(-1).freeze
-  Last = new(1).freeze
-
-  def <=>(other)
-    @value <=> if other
-      other.value
-    else
-      0
-    end
-  end
-
-  module NilExtension
-    def <=>(other)
-      if ::Put === other
-        -(other <=> self)
-      else
-        super
-      end
-    end
+  def self.asc(value, nils_first: false)
+    PutsThing::Ascending.new(value, nils_first: nils_first)
   end
-
-  ::NilClass.prepend(NilExtension)
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: put
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Justin Searls
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-09-21 00:00:00.000000000 Z
+date: 2022-09-22 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -25,6 +25,8 @@ files:
 - README.md
 - Rakefile
 - lib/put.rb
+- lib/put/nil_ext.rb
+- lib/put/puts_thing.rb
 - lib/put/version.rb
 - put.gemspec
 - sig/put.rbs
@@ -50,7 +52,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.20
+rubygems_version: 3.3.7
 signing_key:
 specification_version: 4
 summary: Put helps you write prioritized, multi-variate sort_by blocks