debuga_helper 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0f706cf1fcf05a868c9a42909b0942c280d3676a747237e351626e0fc8db5c4b
+  data.tar.gz: 3ca976ba6a0a766cf9e1e253541649e37527d1db42a740183408e1b412637990
+SHA512:
+  metadata.gz: af5eeb7d6f0e36edb0b9551750eafe189d24e70af7e81eaf242ffc1c1a8f058cd845c4a5b357118153c088b36450e11abe46c6f2d9cbfe48d0e04595f1c35c49
+  data.tar.gz: e7b10e9d53ddabc0d128d682d0e63bf440d99d50c4de35fe94f0cfa0e6d815833be4a7d2eaf02a234280c182a3b1530ccce6a4b9f022f2298ca174bee80df461

data/README.md

@@ -0,0 +1,35 @@
+# DebugaHelper
+
+A Ruby gem providing debugging helpers for Rails applications.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'debuga_helper'
+```
+
+And then execute:
+
+    $ bundle install
+
+## Usage
+
+Once installed, the helpers are automatically available in your controllers and views.
+
+### debuga(msg, title = nil, level = 'debug')
+
+Prints a debug message with caller information.
+
+- `msg`: The message to print.
+- `title`: Optional title.
+- `level`: Logging level ('debug', 'warning', 'notice', 'all').
+
+### debuga_shinny(title = nil, level = 'debug')
+
+Prints a shiny title for debugging.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/debuga_helper/railtie.rb

@@ -0,0 +1,18 @@
+require 'debuga_helper'
+require 'rails'
+
+module DebugaHelper
+  class Railtie < Rails::Railtie
+    initializer "debuga_helper.action_controller" do
+      ActiveSupport.on_load(:action_controller) do
+        include DebugHelper
+      end
+    end
+
+    initializer "debuga_helper.action_view" do
+      ActiveSupport.on_load(:action_view) do
+        include DebugHelper
+      end
+    end
+  end
+end

data/lib/debuga_helper/version.rb

@@ -0,0 +1,4 @@
+module DebugaHelper
+  VERSION = "0.1.0"
+end
+

data/lib/debuga_helper.rb

@@ -0,0 +1,62 @@
+require 'debuga_helper/version'
+require 'debuga_helper/railtie' if defined?(Rails)
+
+# A helper module for debugging purposes in Rails applications.
+module DebugHelper
+  # Prints a debug message with caller information.
+  # @param msg [String] The message to print.
+  # @param title [String, nil] Optional title for the debug output.
+  # @param level [String] The logging level. One of 'debug', 'warning', 'notice', or 'all'. Defaults to 'debug'.
+  # @return [void]
+  def debuga(msg, title = nil, level = 'debug')
+    if(title)
+      title = "T: #{"#{title}".bold}"
+    else
+      title = ''
+    end
+    caller_msg = "\n🔽🔽🔽\n> Caller: #{caller_locations(1,1)[0].label} :::"
+    if title.present?
+      caller_msg += "\n#{title}"
+    end
+    print_it(caller_msg, level)
+    print_it("#{msg}\n🔼🔼🔼\n", level)
+  end
+
+  # Prints a shiny title for debugging.
+  # @param title [String, nil] The title to display.
+  # @param level [String] The logging level. One of 'debug', 'warning', 'notice', or 'all'. Defaults to 'debug'.
+  # @return [void]
+  def debuga_shinny(title = nil, level = 'debug')
+    print_it("*****************************************************", level)
+    print_it("*****************************************************", level)
+    print_it("********************* #{"#{title}".bold}", level)
+    print_it("*****************************************************", level)
+    print_it("*****************************************************", level)
+  end
+
+  private
+
+  # Private method to handle printing based on level with colorization.
+  # @param msg [String] The message to print.
+  # @param level [String] The level ('debug', 'warning', 'notice', or 'all').
+  # @return [void]
+  def print_it(msg, level = 'debug')
+    color = case level
+    when 'debug' then :blue
+    when 'warning' then :yellow
+    when 'notice' then :green
+    else :white
+    end
+    colored_msg = msg.colorize(color)
+    levels_map = {
+      'debug' => :debug,
+      'warning' => :warn,
+      'notice' => :info
+    }
+    if levels_map[level]
+      Rails.logger.send(levels_map[level], colored_msg)
+    elsif level == 'all'
+      puts(colored_msg)
+    end
+  end
+end

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification
+name: debuga_helper
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- David Lyons Garcia
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-01-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+description: Provides debuga and debuga_shinny methods for logging debug messages
+  with caller info and shiny titles.
+email:
+- davidlyonsgarcia@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/debuga_helper.rb
+- lib/debuga_helper/railtie.rb
+- lib/debuga_helper/version.rb
+homepage: https://github.com/EhtuCom/debuga_helper
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/EhtuCom/debuga_helper
+  source_code_uri: https://github.com/EhtuCom/debuga_helper
+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.5.11
+signing_key:
+specification_version: 4
+summary: A helper module for debugging purposes in Rails applications.
+test_files: []