accessory 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1e6d18076731a0f1b3a28ce6ef77c75ef35dff6b7646f4880286b9bcf64ac393
-  data.tar.gz: '07918b78b0d0b1ae8097f22f36039a04fdefe9e59a10cae62758da84785fac4f'
+  metadata.gz: 6a3ac947a1bb5743f72e27fca953624b93a0fdab7c94a483e4f2577f3833ccb0
+  data.tar.gz: 4c8570697b002e4513d2ee117e0ec5290418186e2ea9ad2879a2ba14308b7c25
 SHA512:
-  metadata.gz: ccdb07d177f3b436c91303585b921494d64aac6baa30abc32debf6ebc7ee4a6ff032b3db48f51d3c7b5d6498daeb7a298bcfd75840682bdc842e8fd70581bcf0
-  data.tar.gz: 2183b4b3513781e43b99490b4b86617ee8f08624c5c71a1355100fb84199bae2f27865d6b17496802c29c5571d39699e239b4dfc163983e789e618c39daf898d
+  metadata.gz: 8dc468e225a4150d392727c30d2eb6104fedccc29bcbb22b18320d6b8b3b4afb311a74857540fcb9653d4ad1837f29d4bc1b20800d8d7179d7244c031da3177a
+  data.tar.gz: ae313d407b95a1079f93ad71adb8296a5c8b3c177bc001a5b9866ebe7945dbb2ac46b152c199d2648ac03afc2bb1609aff6190e6beeea170944ac1fe19d16628

data/lib/accessory.rb

@@ -7,8 +7,8 @@ require 'accessory/access'
 
 module Accessory
   refine ::Object do
-    def lens
-      ::Accessory::Lens.on(self)
+    def lens(...)
+      ::Accessory::Lens.on(self, ...)
     end
   end
 end

data/lib/accessory/accessor.rb

@@ -1,9 +1,27 @@
 module Accessory; end
 
 ##
-# @!visibility private
-class Accessory::Accessor
+# The parent class for accessors. Contains some shared behavior all accessors
+# can rely on.
+#
+# It doesn't make sense to instantiate this class directly. Instantiate specific
+# {Accessor} subclasses instead.
+#
+# == Implementing an Accessor
+#
+# To implement an {Accessor} subclass, you must define at minimum these two
+# methods (see the method docs of these methods for details):
+#
+# * {Accessor#get}
+# * {Accessor#get_and_update}
+#
+# You may also implement these two methods (again, see method docs for more
+# info):
+#
+# * {Accessor#traverse}
+# * {Accessor#default_data_constructor}
 
+class Accessory::Accessor
   # @!visibility private
   DEFAULT_NOT_SET_SENTINEL = :"98e47971-e708-42ca-bee7-0c62fe5e11c9"
 
@@ -13,7 +31,7 @@ class Accessory::Accessor
   # @!visibility private
   def initialize(default = nil)
     @default_value = default || DEFAULT_NOT_SET_SENTINEL
-    @make_default_fn = TERMINAL_DEFAULT_FN
+    @succ_default_data_constructor = TERMINAL_DEFAULT_FN
   end
 
   # @!visibility private
@@ -40,7 +58,9 @@ class Accessory::Accessor
   end
 
   # @!visibility private
-  HIDDEN_IVARS = [:@default_value, :@make_default_fn]
+  HIDDEN_IVARS = [:@default_value, :@succ_default_data_constructor]
+
+  # @!visibility private
   def inspect_args
     (instance_variables - HIDDEN_IVARS).map do |ivar_k|
       ivar_v = instance_variable_get(ivar_k)
@@ -49,19 +69,155 @@ class Accessory::Accessor
   end
 
   # @!visibility private
-  attr_accessor :make_default_fn
+  attr_accessor :succ_default_data_constructor
 
-  # @!visibility private
-  def value_or_default(data)
+  # @!group Helpers
+
+  # Safely traverses +data+, with useful defaults; simplifies implementations of
+  # {get} and {get_and_update}.
+  #
+  # Rather than writing redundant traversal logic into both methods, you can
+  # implement the callback method {traverse} to define your traversal, and then
+  # call <tt>traverse_or_default(data)</tt> within your implementation to safely
+  # get a traversal-result to operate on.
+  #
+  # This method will return +nil+ if the input-data is +nil+, _without_ calling
+  # your {traverse} callback. This means that accessors that use
+  # {traverse_or_default} will _forward_ +nil+ traversal-results along the chain
+  # without being confused by them.
+  #
+  # If your {traverse} callback returns <tt>:error</tt>, a default value will
+  # be used. This is either the +default+ passed to {initialize} by your
+  # implementation calling <tt>super(default)</tt>; or it's the result of
+  # calling {default_data_constructor} on the successor-accessor in the accessor
+  # chain.
+  def traverse_or_default(data)
     return nil if data.nil?
 
-    maybe_value = value_from(data)
-    return maybe_value unless maybe_value.nil?
+    case traverse(data)
+    in [:ok, traversal_result]
+      traversal_result
+    in :error
+      if DEFAULT_NOT_SET_SENTINEL.equal?(@default_value)
+        @succ_default_data_constructor.call
+      else
+        @default_value
+      end
+    end
+  end
+
+  # @!endgroup
 
-    if DEFAULT_NOT_SET_SENTINEL.equal?(@default_value)
-      @make_default_fn.call
-    else
-      @default_value
+  # Traverses +data+ in some way, and feeds the result of the traversal to the
+  # next step in the accessor chain by yielding the traversal-result to the
+  # passed-in block +succ+. The result from the yield is the result coming from
+  # the end of the accessor chain. Usually, it should be returned as-is.
+  #
+  # +succ+ can be yielded to multiple times, to run the rest of the accessor
+  # chain against multiple parts of +data+. In this case, the yield results
+  # should be gathered up into some container object to be returned together.
+  #
+  # The successor accessor will receive the yielded element as its +data+.
+  #
+  # After returning, the predecessor accessor will receive the result returned
+  # from {get} as the result of its own +yield+.
+  #
+  # @param data [Enumerable] the data yielded by the predecessor accessor.
+  # @param succ [Proc] a thunk to the successor accessor. When {get} is called
+  #   by a {LensPath}, this is passed implicitly.
+  # @return [Object] the data to pass back to the predecessor accessor as a
+  #   yield result.
+  def get(data, &succ)
+    raise NotImplementedError, "Accessor subclass #{self.class} must implement #get"
+  end
+
+  # Traverses +data+ in some way, and feeds the result of the traversal to the
+  # next step in the accessor chain by yielding the traversal-result to the
+  # passed-in block +succ+.
+  #
+  # The result of the yield will be a "modification command", one of these two:
+  # * an *update command* <tt>[get_result, new_value]</tt>
+  # * the symbol <tt>:pop</tt>
+  #
+  # In the *update command* case:
+  # * the +get_result+ should be returned as-is (or gathered together into
+  #   a container object if this accessor yields multiple times.) The data flow
+  #   of the +get_result+s should replicate the data flow of {get}.
+  # * the +new_value+ should be used to *replace* or *overwrite* the result of
+  #   this accessor's traversal within +data+. For example, in
+  #   {SubscriptAccessor}, <tt>data[key] = new_value</tt> is executed.
+  #
+  # In the <tt>:pop</tt> command case:
+  # * the result of the traversal (*before* the yield) should be returned. This
+  #   implies that any {get_and_update} implementation must capture its
+  #   traversal-results before feeding them into yield, in order to return them
+  #   here.
+  # * the traversal-result should be *removed* from +data+. For example, in
+  #   {SubscriptAccessor}, <tt>data.delete(key)</tt> is executed.
+  #
+  # The successor in the accessor chain will receive the yielded
+  # traversal-results as its own +data+.
+  #
+  # After returning, the predecessor accessor will receive the result returned
+  # from this method as the result of its own +yield+. This implies that
+  # this method should almost always be implemented to *return* an update
+  # command, looking like one of the following:
+  #
+  #   # given [get_result, new_value]
+  #   [get_result, data_after_update]
+  #
+  #   # given :pop
+  #   [traversal_result, data_after_removal]
+  #
+  # @param data [Enumerable] the data yielded by the predecessor accessor.
+  # @param succ [Proc] a thunk to the successor accessor. When {get} is called
+  #   by a {LensPath}, this is passed implicitly.
+  # @return [Object] the modification-command to pass back to the predecessor
+  #   accessor as a yield result.
+  def get_and_update(data, &succ)
+    raise NotImplementedError, "Accessor subclass #{self.class} must implement #get_and_update"
+  end
+
+  # @!group Callbacks
+
+  # Traverses +data+; called by {traverse_or_default}.
+  #
+  # This method should traverse +data+ however your accessor does that,
+  # producing either one traversal-result or a container-object of gathered
+  # traversal-results.
+  #
+  # This method can assume that +data+ is a valid receiver for the traversal
+  # it performs. {traverse_or_default} takes care of feeding in a default +data+ in
+  # the case where the predecessor passed invalid data.
+  #
+  # @param data [Object] the object to be traversed
+  # @return [Object]
+  #   * <tt>[:ok, traversal_results]</tt> if traversal succeeds
+  #   * +:error+ if traversal fails
+  def traverse(data)
+    raise NotImplementedError, "Accessor subclass #{self.class} must implement #traverse to use #traverse_or_default"
+  end
+
+  # Constructs a default value; called by {traverse_or_default}.
+  #
+  # Returns a default constructor Proc for the {traverse_or_default} call in
+  # the *predecessor* accessor to use.
+  #
+  # For example, if your accessor operates on +Enumerable+ values (like
+  # {AllAccessor}), then a useful default for the predecessor accessor to
+  # pass you as +data+ would be an Array.
+  #
+  # In that case, you can return `lambda{ Array.new }` here. This default
+  # constructor will be passed along the {LensPath} to the predecessor, which
+  # will then use it in {traverse_or_default} if it was not configured with
+  # an explicit default.
+  #
+  # @return [Proc] a Proc that, when called, produces a default traversal-result
+  def default_data_constructor
+    lambda do
+      raise NotImplementedError, "Accessor subclass #{self.class} must implement #default_data_constructor to allow chain-predecessor to use #traverse_or_default"
     end
   end
+
+  # @!endgroup
 end

data/lib/accessory/accessors/all_accessor.rb

@@ -17,7 +17,7 @@ require 'accessory/accessor'
 
 class Accessory::AllAccessor < Accessory::Accessor
   # @!visibility private
-  def default_fn_for_previous_step
+  def default_data_constructor
     lambda{ Array.new }
   end
 

data/lib/accessory/accessors/attribute_accessor.rb

@@ -47,7 +47,7 @@ class Accessory::AttributeAccessor < Accessory::Accessor
   end
 
   # @!visibility private
-  def default_fn_for_previous_step
+  def default_data_constructor
     lambda do
       require 'ostruct'
       OpenStruct.new
@@ -55,7 +55,7 @@ class Accessory::AttributeAccessor < Accessory::Accessor
   end
 
   # @!visibility private
-  def value_from(data)
+  def traverse(data)
     data.send(@getter_method_name)
   end
 

data/lib/accessory/accessors/between_each_accessor.rb

@@ -1,5 +1,5 @@
 require 'accessory/accessor'
-require 'accessory/array_cursor_position'
+require 'accessory/traversal_position/enumerable_before_offset'
 
 ##
 # Traverses the positions "between" the elements of an +Enumerable+, including
@@ -18,7 +18,7 @@ require 'accessory/array_cursor_position'
 
 class Accessory::BetweenEachAccessor < Accessory::Accessor
   # @!visibility private
-  def default_fn_for_previous_step
+  def default_data_constructor
     lambda{ Array.new }
   end
 
@@ -26,7 +26,7 @@ class Accessory::BetweenEachAccessor < Accessory::Accessor
   def inspect_args; nil; end
 
   # @!visibility private
-  def value_from(data)
+  def traverse(data)
     data_len = data.length
 
     positions = [
@@ -36,15 +36,15 @@ class Accessory::BetweenEachAccessor < Accessory::Accessor
     ]
 
     positions.transpose.map do |(i, b, a)|
-      Accessory::ArrayCursorPosition.new(i, b, a, is_first: i == 0, is_last: i == data_len)
+      Accessory::TraversalPosition::EnumerableBeforeOffset.new(i, b, a, is_first: i == 0, is_last: i == data_len)
     end
   end
 
-  # Feeds {ArrayCursorPosition}s representing the positions between the elements
-  # of +data+ down the accessor chain.
+  # Feeds {TraversalPosition::EnumerableBeforeOffset}s representing the
+  # positions between the elements of +data+ down the accessor chain.
   #
   # @param data [Enumerable] the +Enumerable+ to iterate through
-  # @return [Array] the generated {ArrayCursorPosition}s
+  # @return [Array] the generated {TraversalPosition::EnumerableBeforeOffset}s
   def get(data)
     positions = value_or_default(data || [])
 
@@ -55,8 +55,9 @@ class Accessory::BetweenEachAccessor < Accessory::Accessor
     end
   end
 
-  # Feeds {ArrayCursorPosition}s representing the positions between the elements
-  # of +data+ down the accessor chain, manipulating +data+ using the results.
+  # Feeds {TraversalPosition::EnumerableBeforeOffset}s representing the
+  # positions between the elements of +data+ down the accessor chain,
+  # manipulating +data+ using the results.
   #
   # If a new element is returned up the accessor chain, the element is inserted
   # between the existing elements.
@@ -64,7 +65,9 @@ class Accessory::BetweenEachAccessor < Accessory::Accessor
   # If +:pop+ is returned up the accessor chain, no new element is added.
   #
   # @param data [Enumerable] the +Enumerable+ to iterate through
-  # @return [Array] a two-element array containing 1. the {ArrayCursorPosition}s; and 2. the new {data}
+  # @return [Array] a two-element array containing
+  #   1. the {TraversalPosition::EnumerableBeforeOffset}s
+  #   2. the new {data}
   def get_and_update(data)
     results = []
     new_data = []

data/lib/accessory/accessors/betwixt_accessor.rb

@@ -1,5 +1,5 @@
 require 'accessory/accessor'
-require 'accessory/array_cursor_position'
+require 'accessory/traversal_position/enumerable_before_offset'
 
 ##
 # Traverses into a specified cursor-position "between" two elements of an
@@ -40,15 +40,15 @@ class Accessory::BetwixtAccessor < Accessory::Accessor
   end
 
   # @!visibility private
-  def default_fn_for_previous_step
+  def default_data_constructor
     lambda{ Array.new }
   end
 
   # @!visibility private
-  def value_from(data)
+  def traverse(data)
     data_len = data.length
 
-    Accessory::ArrayCursorPosition.new(
+    Accessory::TraversalPosition::EnumerableBeforeOffset.new(
       @offset,
       (@offset > 0) ? data[@offset - 1] : nil,
       (@offset < (data_len - 1)) ? data[@offset + 1] : nil,
@@ -57,11 +57,12 @@ class Accessory::BetwixtAccessor < Accessory::Accessor
     )
   end
 
-  # Feeds an {ArrayCursorPosition} representing the position between the
-  # elements of +data+ at +@offset+ down the accessor chain.
+  # Feeds a {TraversalPosition::EnumerableBeforeOffset} representing the
+  # position between the elements of +data+ at +@offset+ down the accessor
+  # chain.
   #
   # @param data [Enumerable] the +Enumerable+ to traverse into
-  # @return [Array] the generated {ArrayCursorPosition}
+  # @return [Array] the generated {TraversalPosition::EnumerableBeforeOffset}
   def get(data)
     pos = value_or_default(data || [])
 
@@ -72,9 +73,9 @@ class Accessory::BetwixtAccessor < Accessory::Accessor
     end
   end
 
-  # Feeds an {ArrayCursorPosition} representing the position between the
-  # elements of +data+ at +@offset+ down the accessor chain, manipulating
-  # +data+ using the result.
+  # Feeds a {TraversalPosition::EnumerableBeforeOffset} representing the
+  # position between the elements of +data+ at +@offset+ down the accessor
+  # chain, manipulating +data+ using the result.
   #
   # If a new element is returned up the accessor chain, the element is inserted
   # at the specified position, using <tt>data.insert(@offset, e)</tt>.
@@ -82,7 +83,9 @@ class Accessory::BetwixtAccessor < Accessory::Accessor
   # If +:pop+ is returned up the accessor chain, no new element is added.
   #
   # @param data [Enumerable] the +Enumerable+ to traverse into
-  # @return [Array] a two-element array containing 1. the generated {ArrayCursorPosition}; and 2. the new {data}
+  # @return [Array] a two-element array containing
+  #   1. the generated {TraversalPosition::EnumerableBeforeOffset}
+  #   2. the new {data}
   def get_and_update(data)
     pos = value_or_default(data || [])
 

data/lib/accessory/accessors/filter_accessor.rb

@@ -34,7 +34,7 @@ class Accessory::FilterAccessor < Accessory::Accessor
   end
 
   # @!visibility private
-  def default_fn_for_previous_step
+  def default_data_constructor
     lambda{ Array.new }
   end
 

data/lib/accessory/accessors/first_accessor.rb

@@ -17,7 +17,7 @@ require 'accessory/accessor'
 
 class Accessory::FirstAccessor < Accessory::Accessor
   # @!visibility private
-  def default_fn_for_previous_step
+  def default_data_constructor
     lambda{ Array.new }
   end
 
@@ -25,7 +25,7 @@ class Accessory::FirstAccessor < Accessory::Accessor
   def inspect_args; nil; end
 
   # @!visibility private
-  def value_from(data)
+  def traverse(data)
     data.first
   end
 

data/lib/accessory/accessors/instance_variable_accessor.rb

@@ -33,12 +33,12 @@ class Accessory::InstanceVariableAccessor < Accessory::Accessor
   end
 
   # @!visibility private
-  def default_fn_for_previous_step
+  def default_data_constructor
     lambda{ Object.new }
   end
 
   # @!visibility private
-  def value_from(data)
+  def traverse(data)
     data.instance_variable_get(@ivar_name)
   end
 

data/lib/accessory/accessors/last_accessor.rb

@@ -17,7 +17,7 @@ require 'accessory/accessor'
 
 class Accessory::LastAccessor < Accessory::Accessor
   # @!visibility private
-  def default_fn_for_previous_step
+  def default_data_constructor
     lambda{ Array.new }
   end
 
@@ -25,7 +25,7 @@ class Accessory::LastAccessor < Accessory::Accessor
   def inspect_args; nil; end
 
   # @!visibility private
-  def value_from(data)
+  def traverse(data)
     data.last
   end
 

data/lib/accessory/accessors/subscript_accessor.rb

@@ -53,12 +53,12 @@ class Accessory::SubscriptAccessor < Accessory::Accessor
   end
 
   # @!visibility private
-  def default_fn_for_previous_step
+  def default_data_constructor
     lambda{ Hash.new }
   end
 
   # @!visibility private
-  def value_from(data)
+  def traverse(data)
     data[@key]
   end
 

data/lib/accessory/lens.rb

@@ -3,11 +3,31 @@ module Accessory; end
 require 'accessory/lens_path'
 
 class Accessory::Lens
-  # Creates a Lens that will traverse +subject+ along +lens_path+.
-  # @param subject [Object] the data-structure this Lens will traverse
-  # @param lens_path [LensPath] the {LensPath} that will be used to traverse +subject+
-  def self.on(subject, lens_path: Accessory::LensPath.empty)
-    self.new(subject, path).freeze
+
+  # Creates a Lens that will traverse +subject+.
+  #
+  # @overload on(subject, lens_path)
+  #   Creates a Lens that will traverse +subject+ along +lens_path+.
+  #
+  #   @param subject [Object] the data-structure this Lens will traverse
+  #   @param lens_path [LensPath] the {LensPath} that will be used to
+  #     traverse +subject+
+  #
+  # @overload on(subject, *accessors)
+  #   Creates a Lens that will traverse +subject+ using an {LensPath} built
+  #   from +accessors+.
+  #
+  #   @param subject [Object] the data-structure this Lens will traverse
+  #   @param accessors [Array] the accessors for the new {LensPath}
+  def self.on(subject, *accessors)
+    lens_path =
+      if accessors.length == 1 && accessors[0].kind_of?(LensPath)
+        accessors[0]
+      else
+        LensPath[*accessors]
+      end
+
+    self.new(subject, lens_path).freeze
   end
 
   class << self
@@ -97,6 +117,6 @@ class Accessory::LensPath
   # @param subject [Object] the data-structure to traverse
   # @return [Lens] a new Lens that will traverse +subject+ using this LensPath
   def on(subject)
-    Accessory::Lens.on(subject, lens_path: self)
+    Accessory::Lens.on(subject, self)
   end
 end

data/lib/accessory/lens_path.rb

@@ -187,7 +187,7 @@ class Accessory::LensPath
       end
 
     unless @parts.empty?
-      @parts.last.make_default_fn = accessor.default_fn_for_previous_step
+      @parts.last.succ_default_data_constructor = accessor.default_data_constructor
     end
 
     @parts.push(accessor)

data/lib/accessory/traversal_position/enumerable_at_offset.rb

@@ -0,0 +1,28 @@
+module Accessory; end
+module Accessory::TraversalPosition; end
+
+##
+# Represents an element encountered during +#each+ traversal of an +Enumerable+.
+
+class Accessory::TraversalPosition::EnumerableAtOffset
+  ##
+  # @!visibility private
+  def initialize(offset, elem_at, is_first: false, is_last: false)
+    @offset = offset
+    @elem_at = elem_at
+    @is_first = is_first
+    @is_last = is_last
+  end
+
+  # @return [Integer] the offset of +elem_at+ in the Enumerable
+  attr_reader :offset
+
+  # @return [Object] the element under the cursor, if applicable
+  attr_reader :elem_at
+
+  # @return [Boolean] true when {#elem_at} is the first element of the +Enumerable+
+  def first?; @is_first; end
+
+  # @return [Boolean] true when {#elem_at} is the last element of the +Enumerable+
+  def last?; @is_last; end
+end

data/lib/accessory/traversal_position/enumerable_before_offset.rb

@@ -0,0 +1,55 @@
+module Accessory; end
+module Accessory::TraversalPosition; end
+
+##
+# Represents the empty intervals between and surrounding the elements of an
+# +Enumerable#each+ traversal.
+#
+# Examples to build intuition:
+#
+# * An +EnumerableBeforeOffset+ with an <tt>.offset</tt> of <tt>0</tt>
+#   represents the position directly before the first result from
+#   <tt>#each</tt>, i.e. "the beginning." Using {LensPath#put_in} at this position
+#   will _prepend_ to the +Enumerable+.
+#
+# * An +EnumerableBeforeOffset+ with an <tt>.offset</tt> equal to the
+#   <tt>#length</tt> of the +Enumerable+ (recognizable by
+#   <tt>EnumerableBeforeOffset#last?</tt> returning +true+) represents
+#   represents the position directly before the end of the enumeration,
+#   i.e. "the end" of the +Enumerable+. Using {LensPath#put_in} at this position
+#   will _append_ to the +Enumerable+.
+#
+# * In general, using {LensPath#put_in} with an +EnumerableBeforeOffset+ with an
+#   <tt>.offset</tt> of +n+ will insert an element _between_ elements
+#   <tt>n - 1</tt> and +n+ in the enumeration sequence.
+#
+# * Returning <tt>:pop</tt> from {LensPath#get_and_update_in} for an
+#   +EnumerableBeforeOffset+-terminated {LensPath} will have no effect, as
+#   you're removing an empty slice.
+
+class Accessory::TraversalPosition::EnumerableBeforeOffset
+  ##
+  # @!visibility private
+  def initialize(offset, elem_before, elem_after, is_first: false, is_last: false)
+    @offset = offset
+    @elem_before = elem_before
+    @elem_after = elem_after
+    @is_first = is_first
+    @is_last = is_last
+  end
+
+  # @return [Integer] the offset of +elem_after+ in the Enumerable
+  attr_reader :offset
+
+  # @return [Object] the element before the cursor, if applicable
+  attr_reader :elem_before
+
+  # @return [Object] the element after the cursor, if applicable
+  attr_reader :elem_after
+
+  # @return [Boolean] true when {#elem_after} is the first element of the +Enumerable+
+  def first?; @is_first; end
+
+  # @return [Boolean] true when {#elem_before} is the last element of the +Enumerable+
+  def last?; @is_last; end
+end

data/lib/accessory/version.rb

@@ -1,3 +1,3 @@
 module Accessory
-  VERSION = "0.1.4"
+  VERSION = "0.1.5"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: accessory
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - Levi Aul
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-01-11 00:00:00.000000000 Z
+date: 2021-01-12 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -29,9 +29,10 @@ files:
 - lib/accessory/accessors/instance_variable_accessor.rb
 - lib/accessory/accessors/last_accessor.rb
 - lib/accessory/accessors/subscript_accessor.rb
-- lib/accessory/array_cursor_position.rb
 - lib/accessory/lens.rb
 - lib/accessory/lens_path.rb
+- lib/accessory/traversal_position/enumerable_at_offset.rb
+- lib/accessory/traversal_position/enumerable_before_offset.rb
 - lib/accessory/version.rb
 homepage: https://github.com/tsutsu/accessory
 licenses:

data/lib/accessory/array_cursor_position.rb

@@ -1,32 +0,0 @@
-module Accessory; end
-
-##
-# Represents a cursor-position "between" two positions in an +Array+ or other
-# integer-indexed +Enumerable+.
-
-class Accessory::ArrayCursorPosition
-  ##
-  # @!visibility private
-  def initialize(offset, elem_before, elem_after, is_first: false, is_last: false)
-    @offset = offset
-    @elem_before = elem_before
-    @elem_after = elem_after
-    @is_first = is_first
-    @is_last = is_last
-  end
-
-  # @return [Integer] the offset of +elem_after+ in the Enumerable
-  attr_reader :offset
-
-  # @return [Object] the element before the cursor, if applicable
-  attr_reader :elem_before
-
-  # @return [Object] the element after the cursor, if applicable
-  attr_reader :elem_after
-
-  # @return [Object] true when {#elem_after} is the first element of the +Enumerable+
-  def first?; @is_first; end
-
-  # @return [Object] true when {#elem_before} is the last element of the +Enumerable+
-  def last?; @is_last; end
-end