blackstack_commons 1.1.43 → 1.1.44

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: fea045fbb95c6711f478a1a55c0be53aa80358c5
-  data.tar.gz: ef7365454f7635ee90b2d0a222c6e2c6e40f5139
+  metadata.gz: af627626dd5cab004774299caee7665e952fb547
+  data.tar.gz: 2a9d96e2c05e971528015a01dfb53a1beeb038cf
 SHA512:
-  metadata.gz: a8e5d5254b58e2230a93ddd32b5ea42de658ebf075af6f91148e6035f640de5ad00aea96e63f68d02b08e21cbd4b9a20928bf0aa0b27aff667581287a3b78fcc
-  data.tar.gz: c6883e896e9805a3351be11370118170a9bb546b386edd3478d371f86e5469bcae2472eb6262a34f4381413eb126f65a7d379043ca3ae9e5b2ed520d4ccdfc36
+  metadata.gz: 9ff40e6c37b33d171adbf310779c55386f89105d2509d9fc6a9f87e7ec58e6f4bf06ef263fe6837c6c8a229e3631f6900dd3f27f996700b7207bc16dc1686fe0
+  data.tar.gz: 9e6f8aeff75ef5bb189dbb6da813b13c9c979d97fc7d411312f3d833c1ea3bcd3586405df18ce7326474040e0dad92b35f92b058e19b4d9df72ae17bd0b12c25

data/lib/blackstack_commons.rb

@@ -1,3 +1,4 @@
+require 'pry'
 require 'content_spinning'
 require 'uri'
 require 'json'

data/lib/functions.rb

@@ -1,6 +1,34 @@
 
 module BlackStack
 
+  # ----------------------------------------------------------------------------------------- 
+  # PRY Supporting Functions
+  # ----------------------------------------------------------------------------------------- 
+  module Debugging
+    @@allow_breakpoints = false
+    
+    # return true if breakpoints are allowed
+    def self.allow_breakpoints
+      @@allow_breakpoints
+    end
+
+    # set breakpoints allowed if the hash contains a key :allow_breakpoints with a value of true
+    def self.set(h)
+      @@allow_breakpoints = h[:allow_breakpoints] if h[:allow_breakpoints].is_a?(TrueClass)
+    end
+
+    # BlackStack::Debugging.breakpoint can be invoked in the middle of a running program. 
+    # It opens a Pry session at the point it's called and makes all program state at that point available. 
+    # When the session ends the program continues with any modifications you made to it.
+    #
+    # BlackStack::Debugging.breakpoint is just calling the Pry's `binding.pry` method, but only if the @@allow_breakpoints is true.
+    # 
+    def self.breakpoint()
+      # start a REPL session, if breakpoints are allowed
+      binding.pry if @@allow_breakpoints
+    end
+  end
+
   # ----------------------------------------------------------------------------------------- 
   # OCRA Supporting Functions
   # ----------------------------------------------------------------------------------------- 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: blackstack_commons
 version: !ruby/object:Gem::Version
-  version: 1.1.43
+  version: 1.1.44
 platform: ruby
 authors:
 - Leandro Daniel Sardi
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-05 00:00:00.000000000 Z
+date: 2021-10-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: content_spinning
@@ -50,6 +50,26 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.8.1
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.1
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.14.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.1
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.14.1
 description: 'THIS GEM IS STILL IN DEVELOPMENT STAGE. Find documentation here: https://github.com/leandrosardi/blackstack_commons.'
 email: leandro.sardi@expandedventure.com
 executables: []