fileverse 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 573a4f8f540d7cdbd5bbdf4f512f140f72f1cdf446f43cc514ca41ae7017df0e
-  data.tar.gz: 5273cc14c2996fff2b767a2345fab8d311e18c237af069c75372c90d60b6d9b8
+  metadata.gz: f609f1f8013055b606d5202c6acadee64bf13e51b23d157a06d5ae86ead7a920
+  data.tar.gz: 691d5a36f90d9c06798ac40823f832134524997a4eaae936e33659abf0914d6a
 SHA512:
-  metadata.gz: '0980b59c9f3808f14da4b03ce101196a9f5e2246db4b64073e18c435fd63b765b79810cf82b0a7fa39ecee8c9bd592878808008ccd78df3558d39a8768d97cce'
-  data.tar.gz: 2030aa26e26b658eac85d65ec94f6719f137f06db41d011767e2ea07067d9dbbcb1645313c5cd8d0937dbbc8cfc26bb4453e7c7c5e75d1ba7297430906f48285
+  metadata.gz: 51aa99351f24296543e10893ca5977c07c9042e2d30b60e684637967e98a60ce2cbdb88870a2f2e49d0c2f5ca7b898d88ef0a05a757b756704ca2742e1fef93b
+  data.tar.gz: a5810560fe7c016d57c622afe108e54322e95caf658d95989a2c0db6dd57db192639329831216b7ecb4e3a9af7ae9747801b4094bd3c778bf7cb7a3eda1ae52a

data/README.md

@@ -12,14 +12,17 @@ A simple ruby cli tool for keeping different versions of a file.
 
 ## Commands / Shortcuts
     - snap                          {file_path}             (s)
-    - preview       --<<            {file_path}             (p)
-    - preview       -->>            {file_path}             (p)
+    - preview       --bwd           {file_path}             (p)
+    - preview       --fwd           {file_path}             (p)
     - preview       --name=""       {file_path}             (p)
     - preview       --index=0       {file_path}             (p)
     - reset                         {file_path}             (x)
-    - snapshots                     {file_path}             (c)
+    - summary                       {file_path}             (sm)
     - restore                       {file_path}             (r)
 
+## Sample
+![Sample](./sample.gif)
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/fileverse/cli.rb

@@ -6,22 +6,22 @@ module Fileverse
   # CLI class
   class CLI < Thor
     desc "snap file content", "store current file content"
+    options template: :boolean, name: :string
     def snap(path)
       setup path
       @parser.parse
-      @parser.add_snapshot(Files.read(@path))
+      @parser.add_snapshot(Files.read(@path), is_template: options[:template], template_name: options[:name])
       Files.write_content(@path)
       Files.write_content(@hidden_path, @parser.to_writable_lines)
     end
     map "s" => "snap"
 
     desc "restore content", "restore content in the current cursor"
+    options template: :boolean, name: :string
     def restore(path)
       setup path
       @parser.parse
-      Files.write_content(@path, @parser.cursor_content)
-      @parser.remove_cursor_snapshot
-      Files.write_content(@hidden_path, @parser.to_writable_lines)
+      options[:template] ? restore_template : restore_snapshot
     end
     map "r" => "restore"
 
@@ -49,15 +49,36 @@ module Fileverse
     end
     map "x" => "reset"
 
+    desc "summary", "return all the summary of snapshots"
+    def summary(path)
+      setup path
+      @parser.parse_head
+      puts @parser.summary
+    end
+    map "sm" => "summary"
+
     private
 
     def setup(path)
       @path = Files.expand_path(path)
       @hidden_path = Files.expand_hidden_path(path)
-      @parser = Parser::Header.new(@hidden_path)
+      @parser = Parser.new(@hidden_path)
       @previewer = Previewer.new(@path)
     end
 
+    def restore_snapshot
+      Files.write_content(@path, @parser.cursor_content)
+      @parser.remove_cursor_snapshot
+      Files.write_content(@hidden_path, @parser.to_writable_lines)
+    end
+
+    def restore_template
+      template_content = @parser.template_content(options[:name])
+      return if template_content.nil?
+
+      Files.write_content(@path, template_content)
+    end
+
     def update_preview_content
       if options[:bwd]
         @parser.decrement_cursor

data/lib/fileverse/parser.rb

@@ -1,260 +1,286 @@
 # frozen_string_literal: true
 
 module Fileverse
-  module Parser
-    # Fileverse::Parser::Header : is the main parser for the storage file.
-    # Lets take a storage file example:
-    #
-    # == Storage file Example content
-    #
-    # <######0
-    # template>shot> 6 ~> 9
-    # 9 ~> 12
-    # 12 ~> 15
-    # 15 ~> 18
-    # ######>
-    # // New file
-    # // Write here
-    # // When you can
-    # File 1
-    # Content 1 of file 1
-    # Content 2 of file 1
-    # File 2
-    # Content 1 of file 2
-    # Content 2 of file 2
-    # File 3
-    # Content 1 of file 3
-    # Content 2 of file 3
-    #
-    #
-    # == Example end
-    #
-    # It uses the head section which is what is between "<######{cursor}" and "######>".
-    # It starts with "templates" and then "files". Each has a range which is represented like "{start} ~> {stop}".
-    # templates are represented as "template>{name}>{range}". While files are just represented as "{range}".
-    # so the above example will parse as follows:
-    #
-    # - template>shot> 6 ~> 9
-    #
-    # =======================================
-    # |   // New file
-    # |   // Write here
-    # |   // When you can
-    # ======================================
-    #
-    # - 9 ~> 12
-    #
-    # =======================================
-    # |   File 1
-    # |   Content 1 of file 1
-    # |   Content 2 of file 1
-    # ======================================
-    #
-    # - 12 ~> 15
-    #
-    # =======================================
-    # |   File 2
-    # |   Content 1 of file 2
-    # |   Content 2 of file 2
-    # ======================================
-    #
-    # - 15 ~> 18
-    #
-    # =======================================
-    # |   File 3
-    # |   Content 1 of file 3
-    # |   Content 2 of file 3
-    # ======================================
-    #
-    class Header # rubocop:disable Metrics/ClassLength
-      START_TAG = "<######"
-      CLOSE_TAG = "######>"
-
-      attr_reader :path, :cursor, :line_index
-
-      def initialize(path)
-        @path = path
-        @iterator = File.foreach(path, chomp: true)
-        @line_index = 0
-        @cursor = -1
-        @snapshots = []
-        @templates = []
-      end
+  # Fileverse::Parser : is the main parser for the storage file.
+  # Lets take a storage file example:
+  #
+  # == Storage file Example content
+  #
+  # <######0
+  # template>shot> 6 ~> 9
+  # 9 ~> 12
+  # 12 ~> 15
+  # 15 ~> 18
+  # ######>
+  # // New file
+  # // Write here
+  # // When you can
+  # File 1
+  # Content 1 of file 1
+  # Content 2 of file 1
+  # File 2
+  # Content 1 of file 2
+  # Content 2 of file 2
+  # File 3
+  # Content 1 of file 3
+  # Content 2 of file 3
+  #
+  #
+  # == Example end
+  #
+  # It uses the head section which is what is between "<######{cursor}" and "######>".
+  # It starts with "templates" and then "files". Each has a range which is represented like "{start} ~> {stop}".
+  # templates are represented as "template>{name}>{range}". While files are just represented as "{range}".
+  # so the above example will parse as follows:
+  #
+  # - template>shot> 6 ~> 9
+  #
+  # =======================================
+  # |   // New file
+  # |   // Write here
+  # |   // When you can
+  # ======================================
+  #
+  # - 9 ~> 12
+  #
+  # =======================================
+  # |   File 1
+  # |   Content 1 of file 1
+  # |   Content 2 of file 1
+  # ======================================
+  #
+  # - 12 ~> 15
+  #
+  # =======================================
+  # |   File 2
+  # |   Content 1 of file 2
+  # |   Content 2 of file 2
+  # ======================================
+  #
+  # - 15 ~> 18
+  #
+  # =======================================
+  # |   File 3
+  # |   Content 1 of file 3
+  # |   Content 2 of file 3
+  # ======================================
+  #
+  class Parser # rubocop:disable Metrics/ClassLength
+    START_TAG = "<######"
+    CLOSE_TAG = "######>"
+
+    attr_reader :path, :cursor, :line_index
+
+    def initialize(path)
+      @path = path
+      @iterator = File.foreach(path, chomp: true)
+      @line_index = 0
+      @cursor = -1
+      @snapshots = []
+      @templates = []
+    end
 
-      def parse
-        return if peek_line.nil?
+    def parse
+      return unless File.exist?(@path) && !peek_line.nil?
 
-        verify_first_header
-        parse_header_template_lines
-        parse_header_snapshot_lines
-        parse_snapshots
+      verify_first_header
+      parse_header_template_lines
+      parse_header_snapshot_lines
+      parse_snapshots
 
-        raise CorruptFormat, " Content remains after parsing." unless peek_line.nil?
-      end
+      raise CorruptFormat, " Content remains after parsing." unless peek_line.nil?
+    end
 
-      def snapshot_count
-        @snapshots.length
-      end
+    def snapshot_count
+      @snapshots.length
+    end
 
-      def add_snapshot(content)
-        last_snapshot = @snapshots[-1]
-        start = last_snapshot&.stop || 3
-        snapshot = Snapshot.new(start, start + content.length)
-        snapshot.content = content
-        last_snapshot&.next_snapshot = snapshot
-        @snapshots.push(snapshot)
-        reset
-      end
+    def add_snapshot(content, is_template: false, template_name: nil)
+      prev_snapshot = last_snapshot is_template: is_template
+      start = prev_snapshot&.stop || 3
+      snapshot = Snapshot.new(start, start + content.length, template_name)
+      snapshot.content = content
+      prev_snapshot&.next_snapshot = snapshot
+      snapshot.next_snapshot = @snapshots[0] if is_template
+      (is_template ? @templates : @snapshots).push(snapshot)
+      reset
+    end
 
-      def cursor_content
-        @snapshots[@cursor]&.content || []
-      end
+    def cursor_content
+      raise InvalidCursorPointer if @cursor.negative? || @cursor > @snapshots.length
 
-      def remove_cursor_snapshot
-        snapshot = @snapshots[@cursor]
-        return unless snapshot
+      @snapshots[@cursor].content
+    end
 
-        snapshot_before = @snapshots[@cursor - 1]
-        snapshot_before.next_snapshot = snapshot.next_snapshot if snapshot_before
-        @snapshots = @snapshots[0, @cursor].concat(@snapshots[@cursor + 1..])
-        reset
-      end
+    def template_content(name)
+      @templates.find { |template| template.name == name }&.content
+    end
 
-      def to_writable_lines
-        [*head_lines, *template_lines, *snapshot_lines]
-      end
+    def remove_cursor_snapshot
+      snapshot = @snapshots[@cursor]
+      return unless snapshot
 
-      def increment_cursor
-        raise InvalidCursorPointer if @cursor + 1 >= @snapshots.length
+      snapshot_before = @snapshots[@cursor - 1]
+      snapshot_before.next_snapshot = snapshot.next_snapshot if snapshot_before
+      @snapshots = @snapshots[0, @cursor].concat(@snapshots[@cursor + 1..])
+      reset
+    end
 
-        @cursor += 1
-      end
+    def to_writable_lines
+      [*head_lines, *template_lines, *snapshot_lines]
+    end
 
-      def decrement_cursor
-        raise InvalidCursorPointer if (@cursor - 1).negative?
+    def increment_cursor
+      raise InvalidCursorPointer if @cursor + 1 >= @snapshots.length
 
-        @cursor -= 1
-      end
+      @cursor += 1
+    end
 
-      def cursor=(value)
-        raise InvalidCursorPointer if value.negative? || value > @snapshots.length
+    def decrement_cursor
+      raise InvalidCursorPointer if (@cursor - 1).negative?
 
-        @cursor = value
-      end
+      @cursor -= 1
+    end
 
-      def reset
-        @cursor = @snapshots.length - 1
-        @snapshots[0].update_start @snapshots.length + 2
-      end
+    def cursor=(value)
+      raise InvalidCursorPointer if value.negative? || value > @snapshots.length
 
-      private
+      @cursor = value
+    end
 
-      def verify_first_header
-        first_line = next_line
-        /\A<\#{6}(?<cursor>\d+)\z/ =~ first_line
-        raise CorruptFormat unless cursor
+    def reset
+      @cursor = @snapshots.length - 1
+      all_snapshots = [*@templates, *@snapshots]
+      all_snapshots[0]&.update_start all_snapshots.length + 2
+    end
 
-        @cursor = cursor.to_i
-      end
+    def parse_head
+      return unless File.exist?(@path) && !peek_line.nil?
 
-      def parse_header_template_lines
-        loop do
-          break unless /\A\s*template>(?<name>\w+)>\s*(?<start>\d+)\s*~>\s*(?<stop>\d+)\s*\z/ =~ peek_line
+      verify_first_header
+      parse_header_template_lines
+      parse_header_snapshot_lines
+    end
 
-          next_line
-          @templates.push(Snapshot.new(start.to_i, stop.to_i, name))
-        end
-      end
+    def summary
+      [
+        "#{@snapshots.length} snapshots",
+        "#{@templates.length} templates",
+        (@templates.length.positive? ? "template name:    #{@templates.map(&:name).join(",")}" : "").to_s
+      ]
+    end
 
-      def parse_header_snapshot_lines
-        loop do
-          line = next_line
-          unless /\A\s*(?<start>\d+)\s*~>\s*(?<stop>\d+)\s*\z/ =~ line
-            break if line == CLOSE_TAG
+    private
 
-            raise CorruptFormat
-          end
-          raise CorruptFormat if stop.to_i < start.to_i
+    def last_snapshot(is_template: false)
+      is_template ? @templates[-1] : @snapshots[-1] || @templates[-1]
+    end
 
-          @snapshots.push Snapshot.new(start.to_i, stop.to_i)
-        end
-      end
+    def verify_first_header
+      first_line = next_line
+      /\A<\#{6}(?<cursor>-?\d+)\z/ =~ first_line
+      raise CorruptFormat, " Error parsing header" unless cursor
 
-      def parse_snapshots
-        last_snap = nil
-        [*@templates, *@snapshots].each do |snap|
-          raise CorruptFormat, " Wrong indexing in header." if line_index != snap.start
+      @cursor = cursor.to_i
+    end
 
-          snap.content = parse_snap_content(snap)
+    def parse_header_template_lines
+      loop do
+        break unless /\A\s*template>(?<name>\w+)>\s*(?<start>\d+)\s*~>\s*(?<stop>\d+)\s*\z/ =~ peek_line
 
-          last_snap&.next_snapshot = snap
-          last_snap = snap
-        end
+        next_line
+        @templates.push(Snapshot.new(start.to_i, stop.to_i, name))
       end
+    end
 
-      def parse_snap_content(snap)
-        result = []
-        (snap.stop - snap.start).times { result.push next_line }
-        result
-      end
+    def parse_header_snapshot_lines
+      loop do
+        line = next_line
+        unless /\A\s*(?<start>\d+)\s*~>\s*(?<stop>\d+)\s*\z/ =~ line
+          break if line == CLOSE_TAG
 
-      def next_line
-        @line_index += 1
-        @iterator.next
-      rescue StopIteration
-        raise CorruptFormat, " No content to parse."
-      end
+          raise CorruptFormat
+        end
+        raise CorruptFormat if stop.to_i < start.to_i
 
-      def peek_line
-        @iterator.peek
-      rescue StopIteration
-        nil
+        @snapshots.push Snapshot.new(start.to_i, stop.to_i)
       end
+    end
 
-      def head_lines
-        [
-          "#{START_TAG}#{cursor}",
-          *@templates.map { |template| "template>#{template.name}> #{template.start} ~> #{template.stop}" },
-          *@snapshots.map { |snap| "#{snap.start} ~> #{snap.stop}" },
-          CLOSE_TAG
-        ]
-      end
+    def parse_snapshots
+      last_snap = nil
+      [*@templates, *@snapshots].each do |snap|
+        raise CorruptFormat, " Wrong indexing in header." if line_index != snap.start
 
-      def template_lines
-        @templates.map(&:content).flatten
-      end
+        snap.content = parse_snap_content(snap)
 
-      def snapshot_lines
-        @snapshots.map(&:content).flatten
+        last_snap&.next_snapshot = snap
+        last_snap = snap
       end
+    end
 
-      # Snapshot for each file
-      class Snapshot
-        attr_reader :start, :stop, :name, :content
-        attr_accessor :next_snapshot
+    def parse_snap_content(snap)
+      result = []
+      (snap.stop - snap.start).times { result.push next_line }
+      result
+    end
 
-        def initialize(start, stop, name = nil)
-          @start = start
-          @stop = stop
-          @name = name
-        end
+    def next_line
+      @line_index += 1
+      @iterator.next
+    rescue StopIteration
+      raise CorruptFormat, " No content to parse."
+    end
 
-        def content=(value)
-          @content = value
-          update_stop
-        end
+    def peek_line
+      @iterator.peek
+    rescue StopIteration
+      nil
+    end
 
-        def update_start(new_start)
-          @start = new_start
-          update_stop
-        end
+    def head_lines
+      [
+        "#{START_TAG}#{cursor}",
+        *@templates.map { |template| "template>#{template.name}> #{template.start} ~> #{template.stop}" },
+        *@snapshots.map { |snap| "#{snap.start} ~> #{snap.stop}" },
+        CLOSE_TAG
+      ]
+    end
 
-        private
+    def template_lines
+      @templates.map(&:content).flatten
+    end
 
-        def update_stop
-          @stop = start + content.length
-          next_snapshot&.update_start @stop
-        end
+    def snapshot_lines
+      @snapshots.map(&:content).flatten
+    end
+
+    # Snapshot for each file
+    class Snapshot
+      attr_reader :start, :stop, :name, :content
+      attr_accessor :next_snapshot
+
+      def initialize(start, stop, name = nil)
+        @start = start
+        @stop = stop
+        @name = name
+      end
+
+      def content=(value)
+        @content = value
+        update_stop
+      end
+
+      def update_start(new_start)
+        @start = new_start
+        update_stop
+      end
+
+      private
+
+      def update_stop
+        @stop = start + content.length
+        next_snapshot&.update_start @stop
       end
     end
   end

data/lib/fileverse/version.rb

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

data/lib/fileverse.rb

@@ -8,11 +8,6 @@ require_relative "fileverse/previewer"
 
 # Parent module
 module Fileverse
-  def self.create_hidden_file(path)
-    File.open(path, "w") do |writer|
-      writer.write(inital_header)
-    end
-  end
 end
 
 require_relative "fileverse/cli"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fileverse
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Unegbu Kingsley
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2025-04-02 00:00:00.000000000 Z
+date: 2025-04-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -49,6 +49,7 @@ files:
 - lib/fileverse/parser.rb
 - lib/fileverse/previewer.rb
 - lib/fileverse/version.rb
+- sample.gif
 - sig/fileverse.rbs
 homepage: https://github.com/urchmaney/fileverse
 licenses: