puts_debuggerer 0.8.0 → 0.10.1

data/lib/puts_debuggerer/core_ext/kernel.rb

@@ -0,0 +1,6 @@
+module Kernel
+  def pd_inspect
+    pd self, printer: false, pd_inspect: true
+  end
+  alias pdi pd_inspect
+end

data/lib/puts_debuggerer/run_determiner.rb

@@ -0,0 +1,109 @@
+module PutsDebuggerer
+  module RunDeterminer
+    OBJECT_RUN_AT = {}
+
+    class << self
+      attr_reader :run_at_global_number
+  
+      def run_at_global_number=(value)
+        @run_at_global_number = value
+      end
+  
+      def init_run_at_global_number
+        @run_at_global_number = 1
+      end
+  
+      def increment_run_at_global_number
+        @run_at_global_number += 1
+      end
+  
+      def reset_run_at_global_number
+        @run_at_global_number = nil
+      end
+  
+      def run_at_number(object, run_at)
+        OBJECT_RUN_AT[[object,run_at]]
+      end
+  
+      def init_run_at_number(object, run_at)
+        OBJECT_RUN_AT[[object,run_at]] = 1
+      end
+  
+      def increment_run_at_number(object, run_at)
+        OBJECT_RUN_AT[[object,run_at]] += 1
+      end
+  
+      def reset_run_at_number(object, run_at)
+        OBJECT_RUN_AT.delete([object, run_at])
+      end
+  
+      def reset_run_at_numbers
+        OBJECT_RUN_AT.clear
+      end
+      
+      def run_number(object, run_at)
+        run_at_global_number || run_at_number(object, run_at)      
+      end            
+            
+      def run_pd?(object, run_at)
+        run_pd = false
+        if run_at.nil?
+          run_pd = true
+        else
+          run_number = determine_run_number(object, run_at) 
+          run_pd = determine_run_pd(run_at, run_number)
+        end
+        run_pd
+      end      
+      
+      def determine_run_number(object, run_at)
+        if PutsDebuggerer.run_at? # check if global option is set
+          determine_global_run_number
+        else
+          determine_local_run_number(object, run_at)
+        end
+      end
+      
+      def determine_global_run_number
+        if PutsDebuggerer::RunDeterminer.run_at_global_number.nil?
+          PutsDebuggerer::RunDeterminer.init_run_at_global_number
+        else
+          PutsDebuggerer::RunDeterminer.increment_run_at_global_number
+        end
+        PutsDebuggerer::RunDeterminer.run_at_global_number      
+      end
+      
+      def determine_local_run_number(object, run_at)
+        if PutsDebuggerer::RunDeterminer.run_at_number(object, run_at).nil?
+          PutsDebuggerer::RunDeterminer.init_run_at_number(object, run_at)
+        else
+          PutsDebuggerer::RunDeterminer.increment_run_at_number(object, run_at)
+        end
+        PutsDebuggerer::RunDeterminer.run_at_number(object, run_at)
+      end
+      
+      def determine_run_pd(run_at, run_number)
+        if run_at.is_a?(Integer)
+          determine_run_pd_integer(run_at, run_number)
+        elsif run_at.is_a?(Array)
+          determine_run_pd_array(run_at, run_number)
+        elsif run_at.is_a?(Range)
+          determine_run_pd_range(run_at, run_number)
+        end      
+      end
+      
+      def determine_run_pd_integer(run_at, run_number)
+        run_pd = true if run_at == run_number      
+      end
+      
+      def determine_run_pd_array(run_at, run_number)
+        run_pd = true if run_at.include?(run_number)
+      end
+      
+      def determine_run_pd_range(run_at, run_number)
+        run_pd = true if run_at.cover?(run_number) || (run_at.end == -1 && run_number >= run_at.begin)
+      end
+      
+    end
+  end
+end

data/lib/puts_debuggerer/source_file.rb

@@ -0,0 +1,31 @@
+module PutsDebuggerer
+  class SourceFile  
+    def initialize(file_path)
+      @file = File.new(file_path)
+    end
+    
+    def source(source_line_count, source_line_number)
+      @source = ''
+      # For Opal Ruby compatibility, skip source lines if file does not respond to readline (as in Opal)
+      lines = source_lines(source_line_count, source_line_number)
+      @source = lines.join(' '*5) if @file.respond_to?(:readline)
+      @source    
+    end
+    
+    def source_lines(source_line_count, source_line_number)
+      lines = []
+      begin
+        while @file.lineno < source_line_number + source_line_count
+          file_line_number = @file.lineno + 1
+          file_line = @file.readline
+          if file_line_number >= source_line_number && file_line_number < source_line_number + source_line_count
+            lines << file_line
+          end
+        end
+      rescue EOFError
+        # Done
+      end
+      lines
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: puts_debuggerer
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.10.1
 platform: ruby
 authors:
 - Andy Maleh
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2017-11-25 00:00:00.000000000 Z
+date: 2020-09-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: awesome_print
@@ -67,86 +67,129 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3.12'
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: jeweler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 2.3.9
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 2.3.9
 - !ruby/object:Gem::Dependency
-  name: jeweler
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.3.0
+        version: 2.1.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.3.0
+        version: 2.1.4
 - !ruby/object:Gem::Dependency
   name: coveralls
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.8.5
+        version: 0.8.23
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.8.5
+        version: 0.8.23
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.10.0
+        version: 0.16.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.16.1
+- !ruby/object:Gem::Dependency
+  name: simplecov-lcov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.10.0
+        version: 0.7.0
+- !ruby/object:Gem::Dependency
+  name: undercover
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.4
+- !ruby/object:Gem::Dependency
+  name: logging
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.3.0
 description: |
-  Yes, many of us avoid debuggers like the plague and clamp on to our puts statements like an umbrella in a stormy day. Why not make it official and have puts debugging become its own perfectly legitimate thing?!!
-
-  Enter puts_debuggerer. A guilt-free puts debugger Ruby gem FTW!
-
-  In other words, puts_debuggerer is a Ruby library for improved puts debugging, automatically displaying bonus useful information such as source line number and source code.
-
-  Partially inspired (only partially ;) by this blog post:
-  https://tenderlovemaking.com/2016/02/05/i-am-a-puts-debuggerer.html
-  (Credit to Tenderlove.)
+  Debuggers are great! They help us troubleshoot complicated programming problems by inspecting values produced by code, line by line. They are invaluable when trying to understand what is going on in a large application composed of thousands or millions of lines of code.
+  In day-to-day test-driven development and simple debugging though, a puts statement can be a lot quicker in revealing what is going on than halting execution completely just to inspect a single value or a few. This is certainly true when writing the simplest possible code that could possibly work, and running a test every few seconds or minutes. Problem is you need to locate puts statements in large output logs, know which methods were invoked, find out what variable names are being printed, and see nicely formatted output. Enter puts_debuggerer. A guilt-free puts debugging Ruby gem FTW that prints file names, line numbers, code statements, and formats output nicely courtesy of awesome_print.
+  Partially inspired by this blog post: https://tenderlovemaking.com/2016/02/05/i-am-a-puts-debuggerer.html (Credit to Tenderlove.)
 email: andy.am@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
+- CHANGELOG.md
 - LICENSE.txt
 - README.md
 files:
+- CHANGELOG.md
 - LICENSE.txt
 - README.md
+- VERSION
+- lib/pd.rb
 - lib/puts_debuggerer.rb
+- lib/puts_debuggerer/core_ext/kernel.rb
+- lib/puts_debuggerer/run_determiner.rb
+- lib/puts_debuggerer/source_file.rb
 homepage: http://github.com/AndyObtiva/puts_debuggerer
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -161,9 +204,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.10
-signing_key: 
+rubygems_version: 3.1.4
+signing_key:
 specification_version: 4
 summary: Ruby library for improved puts debugging, automatically displaying bonus
   useful information such as source line number and source code.