amazing_tap 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c4b473b57dcf521b113674ad0431d7da96e3478588e1462ad237ff256e56288
-  data.tar.gz: 35a26f22961d7157a546875c1620b33dafd02204326cdc3617a09cf96bc22b08
+  metadata.gz: 6821009d02bc4f54d723c0ea41341744e0d488d88e42ca944fc0efb231095937
+  data.tar.gz: 5d1acaa2975285161576e00a15f7f01720662afe83822011cc9013296c4b27b7
 SHA512:
-  metadata.gz: d87b4f5bed0c1494deb79e5d3c587a92711ee3c955ea8ea054e0b0e3eacfe5a169c3d8d61e69311ebffb9b18cbebc0334ec26263a7a7b335b7f0dfb9ffa06a18
-  data.tar.gz: 3cafc6a035ef83800e4f5f8f8cd7f0092e6b8d04ca644418ef7fd09105114ba5dc4ab56e80e2e21074f2f26d3b7ba9738d7a787f0d2438830c4e80c4ee25919f
+  metadata.gz: 034defdbe3412e659b349cf92014a415f1e4668e2a32c06864df6749320fd8b00e6b164b2438cb61a5d839f5e7de716cab732c69e4d6506d041ab7a255fc73f1
+  data.tar.gz: a9bb676d9062c10690f9efa975d6926acde80a5439e98b876e418315e547218d24b1b69e26acf7c93f0b95ee3bf33ea4a6912570e140d0e21d6b04c7386f127a

data/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## [Unreleased]
 
+## [0.1.1] - 2026-08-08
+
+- README overhaul: typed hash intro example with real output, per-option outputs in Usage, link to colorized terminal screenshot
+
 ## [0.1.0] - 2026-08-08
 
 First release as `amazing_tap`, forked from [tap_amazing_print](https://github.com/shu0115/tap_amazing_print) 0.1.1.

data/README.md

@@ -2,6 +2,31 @@
 
 Labeled, chain-safe debugging built on [amazing_print](https://github.com/amazing-print/amazing_print). `tapp` pretty-prints the receiver with a label inferred from the variable it was called on, plus its class and optional caller frames, then returns the receiver unchanged. Native `Object#tap` is not touched.
 
+```ruby
+require "amazing_tap"
+
+user = {
+  id: 42,
+  name: "Ada Lovelace",
+  admin: true,
+  roles: [:owner, :editor]
+}
+
+user.tapp
+# user (Hash)
+# {
+#        id: 42,
+#      name: "Ada Lovelace",
+#     admin: true,
+#     roles: [
+#         [0] :owner,
+#         [1] :editor
+#     ]
+# }
+```
+
+Output is colorized in a terminal: [screenshot](https://github.com/dportalesr/amazing_tap/blob/main/.github/tapp-intro.png)
+
 Fork of [shu0115/tap_amazing_print](https://github.com/shu0115/tap_amazing_print).
 
 ## Installation
@@ -19,23 +44,58 @@ gem install amazing_tap
 
 ## Usage
 
+Examples below use:
+
 ```ruby
-require "amazing_tap"
+user = { id: 42, name: "Ada Lovelace" }
+```
 
-user = { id: 7, name: "Ada" }
+Chained receivers are inferred as written:
 
-user.tapp
-# user (Hash)
+```ruby
+account.owner.tapp
+# account.owner (Hash)
 # {
-#       :id => 7,
-#     :name => "Ada"
+#       id: 42,
+#     name: "Ada Lovelace"
 # }
+```
+
+Explicit label instead of inference:
+
+```ruby
+user.tapp(:after_update)
+# after_update (Hash)
+# { ... }
+```
+
+Label without the class:
+
+```ruby
+user.tapp(type: false)
+# user
+# { ... }
+```
 
-account.owner.tapp             # chains inferred as written: "account.owner (Hash)"
-user.tapp(:after_update)       # explicit label instead of inference
-user.tapp(type: false)         # label without the class
-user.tapp(backtrace: true)     # appends "  from <frame>" lines for the full caller
-user.tapp(backtrace: 3)        # first 3 frames only
+Append the full caller as `from` lines:
+
+```ruby
+user.tapp(backtrace: true)
+# user (Hash)
+# { ... }
+#   from app/services/sync.rb:17:in 'Object#refresh'
+#   from app/services/sync.rb:19:in '<main>'
+```
+
+Or only the first N frames:
+
+```ruby
+user.tapp(backtrace: 3)
+# user (Hash)
+# { ... }
+#   from app/services/sync.rb:22:in 'Object#persist'
+#   from app/services/sync.rb:26:in 'Object#sync'
+#   from app/services/sync.rb:28:in '<main>'
 ```
 
 Label inference reads the receiver expression at the call site. It covers local variables, `@ivars`, `$globals`, dotted chains, and index access. When the source is not inferable (literals, parenthesized calls, multiline chains, REPL/eval), the header falls back to the class alone:
@@ -43,7 +103,7 @@ Label inference reads the receiver expression at the call site. It covers local
 ```ruby
 { a: 1 }.tapp
 # (Hash)
-# { :a => 1 }
+# { a: 1 }
 ```
 
 Long output gets a closing marker so you can tell where each dump ends:

data/lib/amazing_tap/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: amazing_tap
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Daniel Portales Rosado
@@ -76,7 +76,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 4.0.18
 specification_version: 4
 summary: amazing_tap
 test_files: []