oort 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 59358b08ac7c205469cd32c017b73ab36846c520e6d066e67c577bfd4daaacad
-  data.tar.gz: 1c8ab9a97f89c45b7f1630198b2d810ceb6a877d7adbfd0641c92241e5aca425
+  metadata.gz: 9d13ddbadfac1d2c1ae4f77c6c81ebac6339ddfdb14b3e41a40da8ba93e62ae2
+  data.tar.gz: fae5d70f39bc682f322c16f6e969b64e01794f9fdd87ed50264fb44ce3beb54a
 SHA512:
-  metadata.gz: 819c6dce941d799a7497e88fe05bc104391e5bc0ce13e3f4ed0a96e388a1ccb3940f1e46de139a02fc742dc2fc26fa2b9643d5ce30995ae242fb2bf5132c4e44
-  data.tar.gz: 7763c120b0311b667159bf1adc48c464a8b43d3a770ac78af8bc9fcba7e616bbce11eef5564859c149b3ea09656e75e29bc2183f35d085fc6942d78a83b5fc58
+  metadata.gz: aa7621267ccc7d99735bd5548eb7dbdcce7c4b3e280540dd393d4cd45707b0b671f9213eb55c01023c42a710afed5f31163213eead118b0db35d22365cc9fac1
+  data.tar.gz: e0e6d7d5a3d2752ac7747439f28256aceb7183e773418836c05896b3f8ade18dbed010b41a54f05a08360f76c8039ac23c87e5900444867491e7405582552bd6

data/Gemfile.lock

@@ -69,6 +69,7 @@ GEM
 
 PLATFORMS
   x86_64-darwin-20
+  x86_64-darwin-22
 
 DEPENDENCIES
   activerecord (~> 7.0, >= 7.0.1)

data/README.md

@@ -17,7 +17,7 @@ Let's begin with a basic schema involving a User and a Post. You can substitute
 
 Firstly, you will also need the following migration to users (postgresql only for now):
 
-```
+```RUBY
   def change
     add_column(:users, :posts_ordering, :integer, array: true, default: [], using: 'ARRAY[benefit_type]::INTEGER[]')
 
@@ -31,7 +31,7 @@ This will store the ids of posts in an array on the user, and will only accept i
 
 Include the `Oort::Ordered` module in the parent object:
 
-```
+```RUBY
 class User < ActiveRecord::Base
   include Oort::Ordered
   handles_ordering_of :posts
@@ -52,7 +52,7 @@ This inclusion adds `update_posts_ordering` to the user model and `insert_at` to
 
 The following callbacks are also added to post:
 
-```
+```RUBY
 after_create_commit :insert_at
 after_destroy :remove_from_reorderable
 ```
@@ -66,7 +66,7 @@ To remove a post, simply call `post.remove_from_reorderable`
 ### Scope
 The `ordered_with` scope is also added to the post model. This allows a `user` object to have the following query:
 
-```
+```RUBY
 user.posts.ordered_with(user.posts_ordering)
 
 # or
@@ -74,6 +74,21 @@ user.posts.ordered_with(user.posts_ordering)
 Post.where(user_id: user.id).ordered_with(user.posts_ordering)
 ```
 
+### Customization
+
+`handles_ordering_of` can allow for new records to be the top of the order or the bottom of the order. By default it will push any new records to the top of the order, but you can specify the bottom of the order like so:
+
+```ruby
+
+class User < ActiveRecord::Base
+  include Oort::Ordered
+  handles_ordering_of :posts, default: :bottom
+
+  has_many :posts
+end
+
+```
+
 
 ## Installation
 

data/lib/oort/callbacks.rb

@@ -2,22 +2,24 @@
 
 module Oort
   class Callbacks
-    def self.call(association_class:, remove_from_method_name:, insert_method_name:, instance_name:)
+    def self.call(association_class:, remove_from_method_name:, insert_method_name:, instance_name:, default:)
       new(
         association_class: association_class,
         remove_from_method_name: remove_from_method_name,
         insert_method_name: insert_method_name,
-        instance_name: instance_name
+        instance_name: instance_name,
+        default: default
       ).call
     end
 
-    attr_reader :association_class, :remove_from_method_name, :insert_method_name, :instance_name
+    attr_reader :association_class, :remove_from_method_name, :insert_method_name, :instance_name, :default
 
-    def initialize(association_class:, remove_from_method_name:, insert_method_name:, instance_name:)
+    def initialize(association_class:, remove_from_method_name:, insert_method_name:, instance_name:, default:)
       @association_class = association_class
       @remove_from_method_name = remove_from_method_name
       @insert_method_name = insert_method_name
       @instance_name = instance_name
+      @default = default
     end
 
     def call
@@ -29,7 +31,7 @@ module Oort
 
     def add_callbacks
       association_class.class_eval do
-        after_create_commit :insert_at
+        after_create_commit :initial_insert_at
         after_destroy :remove_from_reorderable
       end
     end
@@ -45,9 +47,13 @@ module Oort
         #   public_send(:user).public_send(:remove_from_posts_ordering, id)
         # end
         <<-RUBY, __FILE__, __LINE__ + 1
-          def insert_at(position = 0)
+          def insert_at(position = 0, initial: nil)
             public_send(#{instance_name.inspect})
-              .public_send(#{insert_method_name.inspect}, insert: id, at: position)
+              .public_send(#{insert_method_name.inspect}, insert: id, at: position, initial: initial)
+          end
+
+          def initial_insert_at
+            insert_at(initial: #{default.inspect})
           end
 
           def remove_from_reorderable

data/lib/oort/inserts.rb

@@ -26,13 +26,22 @@ module Oort
         #   end
         # end
         <<-RUBY, __FILE__, __LINE__ + 1
-          def #{insert_method_name}(insert:, at: 0)
+          def #{insert_method_name}(insert:, at: 0, initial: nil)
             with_lock do
               current_values = public_send(#{stored_in.inspect})
-              current_index = current_values.find_index(insert)
-              insertable = current_index.blank? ? insert : current_values.delete_at(current_index)
-              current_values.insert(at, insertable)
-              update(#{stored_in.inspect} => current_values)
+
+              if initial == :top
+                current_values.unshift(insert)
+                save
+              elsif initial == :bottom
+                current_values << insert
+                save
+              else
+                current_index = current_values.find_index(insert)
+                insertable = current_index.blank? ? insert : current_values.delete_at(current_index)
+                current_values.insert(at, insertable)
+                update(#{stored_in.inspect} => current_values)
+              end
             end
           end
         RUBY

data/lib/oort/ordered.rb

@@ -14,20 +14,23 @@ module Oort
     end
 
     module ClassMethods
-      def handles_ordering_of(association)
+      def handles_ordering_of(association, default: :top)
         args = {
           stored_in: :"#{association}_ordering",
           insert_method_name: :"update_#{association}_ordering",
           remove_from_method_name: :"remove_from_#{association}_ordering",
           association_class: association.to_s.classify.constantize,
           instance_name: :"#{name.downcase}",
-          class_name: name.classify.constantize
+          class_name: name.classify.constantize,
+          default:
         }
 
         Inserts.call(**args.slice(:stored_in, :insert_method_name, :class_name))
         Removes.call(**args.slice(:stored_in, :remove_from_method_name, :class_name))
         Scopes.call(**args.slice(:association_class))
-        Callbacks.call(**args.slice(:association_class, :remove_from_method_name, :insert_method_name, :instance_name))
+        Callbacks.call(
+          **args.slice(:association_class, :remove_from_method_name, :insert_method_name, :instance_name, :default)
+        )
       end
     end
   end

data/lib/oort/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Oort
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

data/oort.gemspec

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative "lib/oort/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "oort"
+  spec.version = Oort::VERSION
+  spec.authors = ["tobyond"]
+  spec.homepage = "https://github.com/tobyond/oort"
+
+  spec.summary = "Oort to sort, order"
+  spec.description = "Rails sorting and ordering without deadlocks"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.2.0"
+
+  spec.metadata["source_code_uri"] = "https://github.com/tobyond/oort"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  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 .circleci appveyor])
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  # Uncomment to register a new dependency of your gem
+  # spec.add_dependency "rspec"
+
+  # For more information and examples about making a new gem, check out our
+  # guide at: https://bundler.io/guides/creating_gem.html
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: oort
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - tobyond
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-01-26 00:00:00.000000000 Z
+date: 2024-03-16 00:00:00.000000000 Z
 dependencies: []
 description: Rails sorting and ordering without deadlocks
 email:
@@ -40,6 +40,7 @@ files:
 - lib/oort/removes.rb
 - lib/oort/scopes.rb
 - lib/oort/version.rb
+- oort.gemspec
 - sig/oort.rbs
 homepage: https://github.com/tobyond/oort
 licenses:
@@ -61,7 +62,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.5.3
 signing_key:
 specification_version: 4
 summary: Oort to sort, order