ruby-toon 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7f006a20c57bdd904663ccfd5294101e625934bc5a1df303a6f2cf471f3745df
-  data.tar.gz: 80e3c4cd371b9eca3c47855bc79fdf67102e6c04272c69c3c1f752957c240e5d
+  metadata.gz: e32d5758d404c58449d7d8100a0d40d445c0595997620832c48f45dfd36bff9c
+  data.tar.gz: cc942b447807a72d595e66bf76479c525545ac6ad8b2c3dd2686d04669075f89
 SHA512:
-  metadata.gz: 6c6ef31232a2209e64815eae5f25f9bf195caee071323777eeac4a4217b45ae3937c7a8cb937d5dd60bc46f4b6c3ca0b757b0e61de58d314e67454d03f3a5b9a
-  data.tar.gz: 1f7ee09ca1533d1ac7cb4ce3b7233f27dae0389ddfda99e9771b3087918c47e5528e858d83ddcfe69496973412a846107c80d01e6f3995a9953da8d658788870
+  metadata.gz: ca22d215cf9b70115a6e9da0d5ba29dbd1788c8d19d5c7ddbb579521bb8826604c1f3a53ad3322ea298101126cf826b31eec65265d0d55b5b4d9cc883c4ef3e4
+  data.tar.gz: bffb33b3605dccf8a0cb011ed7c3cf1c1c27bf0a41ef8d52f2d1d09e03ea038949b35fd8fab9848c857fc6335ec97573462df8619836d7e6bf8fe78869f186de

data/README.md

@@ -1,22 +1,22 @@
-````markdown
-# 🎋 Toon — Token-Oriented Object Notation for Ruby
+# **Toon** (Token-Oriented Object Notation for Ruby)
 
-`toon` is a Ruby implementation of **TOON (Token-Oriented Object Notation)** —
+`toon` is a Ruby implementation of **TOON (Token-Oriented Object Notation)**
 a compact, readable, indentation-based data format designed for humans *and* machines.
 
 This gem provides:
 
-- A **TOON encoder** (Ruby → TOON)
-- A **TOON decoder** (TOON → Ruby)
+- A **TOON encoder** (Ruby to TOON)
+- A **TOON decoder** (TOON to Ruby)
 - A **CLI** (`bin/toon`) for converting TOON ↔ JSON
 - Optional **ActiveSupport integration** (`Object#to_toon`)
+- Built-in `Hash#to_toon` / `Array#to_toon` plus lightweight `#to_json` helpers
 - Full RSpec test suite
 
 ---
 
-## ✨ Features
+## Features
 
-### ✔ Encode Ruby objects → TOON
+### Encode Ruby objects to TOON
 ```ruby
 Toon.generate({ "name" => "Alice", "age" => 30 })
 ````
@@ -28,7 +28,7 @@ name:Alice
 age:30
 ```
 
-### ✔ Decode TOON → Ruby
+### Decode TOON to Ruby
 
 ```ruby
 Toon.parse("name:Alice\nage:30")
@@ -42,7 +42,7 @@ Returns:
 
 ---
 
-## 🧩 Arrays
+## Arrays
 
 ### Nested arrays (encoder output)
 
@@ -67,7 +67,7 @@ Both decode correctly.
 
 ---
 
-## 📊 Tabular Arrays
+## Tabular Arrays
 
 ### Nested tabular (encoder output)
 
@@ -78,7 +78,7 @@ users:
     2,B
 ```
 
-→ numeric fields parsed (`id` becomes integer)
+numeric fields parsed (`id` becomes integer)
 
 ### Flat tabular (user input)
 
@@ -88,27 +88,49 @@ users[2]{id,name}:
   2,Bob
 ```
 
-→ fields remain **strings**
+fields remain **strings**
 
 ---
 
-## ⚙️ ActiveSupport Integration
+## ActiveSupport Integration
 
-If ActiveSupport is installed:
+If ActiveSupport (and by extension Rails/Active Record) is installed—regardless of whether it loads before or after `toon`—every object gains `#to_toon`.
 
 ```ruby
+require "toon"
 require "active_support"
+
+class User < ApplicationRecord; end
+
+User.first.to_toon
+# => "id:1\nname:Alice\n..."
+```
+
+- Automatically hooks in as soon as ActiveSupport finishes loading (thanks to a TracePoint watcher)
+- Falls back to `#as_json` when present, so Active Record / ActiveModel instances serialize their attributes instead of opaque object IDs
+
+## Core Extensions
+
+`toon` now provides handy helpers even without ActiveSupport:
+
+```ruby
 require "toon"
 
-{a: 1}.to_toon
-# => "a:1\n"
+{foo: "bar"}.to_toon
+# => "foo:bar"
+
+[1, 2, 3].to_toon
+# => "[3]:\n  1\n  2\n  3\n"
+
+{foo: "bar"}.to_json
+# => "{\"foo\":\"bar\"}"
 ```
 
-Adds `Object#to_toon` for convenience.
+Both `Hash` and `Array` gain `#to_toon` and `#to_json` implementations so you can round-trip data between TOON and JSON with a single method call.
 
 ---
 
-## 🚀 Installation
+## Installation
 
 Gem coming soon. For now:
 
@@ -126,15 +148,15 @@ require_relative "lib/toon"
 
 ---
 
-## 🧰 CLI Usage
+## CLI Usage
 
-### Encode JSON → TOON
+### Encode JSON to TOON
 
 ```bash
 echo '{"name":"Alice","age":30}' | bin/toon --encode
 ```
 
-### Decode TOON → JSON
+### Decode TOON to JSON
 
 ```bash
 echo "name:Alice\nage:30" | bin/toon --decode
@@ -148,7 +170,7 @@ bin/toon --encode < input.json
 
 ---
 
-## 🧪 Running Tests
+## Running Tests
 
 Ensure CLI is executable:
 
@@ -171,7 +193,7 @@ Tests include:
 
 ---
 
-## 📚 Supported TOON Grammar (Current)
+## Supported TOON Grammar (Current)
 
 ### Key-value
 
@@ -225,7 +247,7 @@ users[2]{id,name}:
 
 ---
 
-## ⚠️ Error Handling
+## Error Handling
 
 Malformed input (e.g., missing indentation):
 
@@ -237,7 +259,7 @@ Decoder stops with a friendly `Toon::Error`.
 
 ---
 
-## 🗺️ Roadmap
+## Roadmap
 
 * Multiline values
 * Quoted strings

data/lib/extensions/active_support.rb

@@ -1,12 +1,41 @@
-# Optional ActiveSupport integration
-begin
-  require 'active_support'
-  require 'active_support/core_ext/object'
-  class Object
-    def to_toon(**opts)
-      Toon.generate(self, **opts)
+module Toon
+  module Extensions
+    module ActiveSupport
+      module ObjectMethods
+        def to_toon(**opts)
+          payload = respond_to?(:as_json) ? as_json : self
+          Toon.generate(payload, **opts)
+        end
+      end
+
+      module_function
+
+      def install!
+        return if Object.method_defined?(:to_toon)
+        Object.include(ObjectMethods)
+      end
+
+      def ensure_installed!
+        return unless defined?(::ActiveSupport)
+        install!
+      end
+
+      def watch_for_active_support!
+        return if defined?(@tracepoint) && @tracepoint&.enabled?
+        @tracepoint = TracePoint.new(:end) do |tp|
+          next unless tp.self.is_a?(Module)
+          next unless tp.self.name == "ActiveSupport"
+          ensure_installed!
+          @tracepoint.disable
+        end
+        @tracepoint.enable
+      end
     end
   end
-rescue LoadError
-  # no activesupport available
+end
+
+if defined?(::ActiveSupport)
+  Toon::Extensions::ActiveSupport.ensure_installed!
+else
+  Toon::Extensions::ActiveSupport.watch_for_active_support!
 end

data/lib/extensions/core.rb

@@ -0,0 +1,49 @@
+require 'json'
+
+module Toon
+  module Extensions
+    module Core
+      module_function
+
+      def hash_to_toon(target, **opts)
+        Toon.generate(target, **opts)
+      end
+
+      def array_to_toon(target, **opts)
+        Toon.generate(target, **opts)
+      end
+
+      def to_json_payload(target, *args)
+        JSON.generate(target, *args)
+      end
+    end
+  end
+end
+
+class Hash
+  unless method_defined?(:to_toon)
+    def to_toon(**opts)
+      Toon::Extensions::Core.hash_to_toon(self, **opts)
+    end
+  end
+
+  unless method_defined?(:to_json)
+    def to_json(*args)
+      Toon::Extensions::Core.to_json_payload(self, *args)
+    end
+  end
+end
+
+class Array
+  unless method_defined?(:to_toon)
+    def to_toon(**opts)
+      Toon::Extensions::Core.array_to_toon(self, **opts)
+    end
+  end
+
+  unless method_defined?(:to_json)
+    def to_json(*args)
+      Toon::Extensions::Core.to_json_payload(self, *args)
+    end
+  end
+end

data/lib/toon/version.rb

@@ -1,3 +1,3 @@
 module Toon
-  VERSION = '0.1.0'
+  VERSION = '1.0.1'
 end

data/lib/toon.rb

@@ -1,6 +1,7 @@
 require_relative "toon/version"
 require_relative "toon/encoder"
 require_relative "toon/decoder"
+require_relative "extensions/core"
 require_relative "extensions/active_support"
 
 module Toon

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby-toon
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Anil Yanduri
@@ -49,6 +49,7 @@ files:
 - LICENSE
 - README.md
 - lib/extensions/active_support.rb
+- lib/extensions/core.rb
 - lib/toon.rb
 - lib/toon/decoder.rb
 - lib/toon/encoder.rb