fancy_buff 2.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 693126b181dc6a997dd15d46158a437d31e3957c88fd314edf557c16c905a36e
+  data.tar.gz: 5f88475a875d86e13192b397f35c7970cfcb11a12390315114dedfe38d82d13b
+SHA512:
+  metadata.gz: fd662a50783b6a3af23bdbd70f3065952a7d1faac12af6208a699ee53527d26d60f5958fcf9b045e6ba0fb196744db151a38395966332aee70ae8eb383d30828
+  data.tar.gz: befd4e7240600a0001697c647eaef1efef60a0635cc5db27988b580ad0930d3538de02d4f6a0390476c444753d29b12c63d47919d7d7ee0869933e42e37d274f

data/lib/fancy_buff.rb

@@ -0,0 +1,118 @@
+# a text buffer with marks, selections, and rudimentary editing
+class TinyBuff
+  attr_reader :length
+
+  # content: the starting content of the buffer as a String
+  def initialize(content='')
+    @content = content.lines.map(&:chomp)
+    @marks = {}
+    @selections = {}
+
+    @length = @content
+      .map{|l| l.length }
+      .sum
+  end
+
+  # returns the number of lines
+  def lines
+    @content.length
+  end
+
+  # line_range: the Range of lines to return (NOT line indexes numbers)
+  # max_len (optional): the maximum length of each line to return; useful when you want to
+  #   return a rectangular region of text for display, for example
+  def [](line_range, max_len=nil)
+    !!max_len ? @content[line_range] : @content[line_range].map{|l| l[..max_len] }
+  end
+
+  # col: starting column (zero-based)
+  # row: starting line (zero-based)
+  # wid: the number of characters per line
+  # hgt: the number of rows
+  def rect(col, row, wid, hgt)
+    @content[row..(row + hgt - 1)]
+      .map{|row| row.chomp.chars[col..(col + wid - 1)].join }
+  end
+
+  # set a mark, as in the Vim sense
+  #
+  # sym: the name of the mark
+  # char_num: the number of characters from the top of the buffer to set the
+  #   mark
+  def mark(sym, char_num)
+    @marks[sym] = char_num
+
+    nil
+  end
+
+  # selects a named range of characters 
+  #
+  # sym: the name of the range
+  # char_range: a Range representing the starting and ending byte of the
+  #   selection
+  def select(sym, char_range)
+    @selections[sym] = char_range
+
+    nil
+  end
+
+  # line: the line to insert
+  # index: the index to insert it at (NOT the 1-based line number)
+  def insert_line(line, index)
+    @content.insert(line, index)
+    @length += line.length
+  end
+
+  # str: the String to insert
+  # char_num: the char_num at which to start the insertion
+  def insert_text(str, char_num)
+    # TODO: this is tricky because if the string contains multiple lines then
+    # you're not just inserting in the middle of an existing line, you're
+    # inserting some text which may include multiple lines
+  end
+
+  # index: the indext of the line to delete (NOT the 1-based line number)
+  def delete_at(index)
+    @length -= @content[index].length
+    @content.delete_at(index)
+  end
+
+  # char_range: the range of characters to remove from this TinyBuff
+  def delete_range(char_range)
+    # TODO: this deletes the Range of characters, which may span multiple lines
+  end
+
+  # line: the line to add to the end of the buffer
+  def push(line)
+    @content << line
+    @length += line.length
+
+    nil
+  end
+  alias << push
+
+  # deletes and returns the last line of this buffer
+  def pop
+    @length -= (@content.pop).length
+
+    nil
+  end
+
+  # line: the line to be added to the beginning of the buffer
+  def unshift(line)
+    @content.unshift(line)
+    @length += line.length
+
+    nil
+  end
+  alias >> unshift
+
+  # deletes and returns the first line of the buffer
+  def shift
+    @length -= (@content.shift).length
+  end
+
+  def to_s
+    @content.join("\n")
+  end
+end

metadata

@@ -0,0 +1,45 @@
+--- !ruby/object:Gem::Specification
+name: fancy_buff
+version: !ruby/object:Gem::Version
+  version: 2.0.0
+platform: ruby
+authors:
+- Jeff Lunt
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2023-01-26 00:00:00.000000000 Z
+dependencies: []
+description: a text buffer with marks, selections, and simple insert/delete
+email: jefflunt@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/fancy_buff.rb
+homepage: https://github.com/jefflunt/fancy_buff
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: want to have a small line-based text buffer with named marks and selections,
+  very rudimentary editing, but absolutely nothing else? then this library is for
+  you.
+test_files: []