activejsonmodel 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3b7eed61989b4be5a09f4d258b54c3d5cdda35c3b129f21596e6a33dbf82347
-  data.tar.gz: d62f8023f6e64689c4cf01998e8f1fed2b4acfc5654ecb5fed073e69bf1075aa
+  metadata.gz: 1f2bf815c387423461ead46e38e315eb8ad0c866f4745ae9d67882a36e7e0b0c
+  data.tar.gz: 59abf0fbc153f61787fd422962e5f23c74d69276de65d0483d82b3b8b1d618ac
 SHA512:
-  metadata.gz: 04c87f280772d42105d22547deb96d7920536469f4656fa1541c95a67145e95e7c210aa0b8054e3406058604ad303fd635732e6f560c56651d75fe9d40b57d66
-  data.tar.gz: 03fc5c92a441bc639c23e194eaaab53f86fe37a1d427d689c305aa898d7ec247a6f52db991961c9224cdfdeaa6f30ba55d7692e4ad8fefbea6f8c8a4e9527618
+  metadata.gz: db6f3794674d502cdc6ffc2b7c25e23e93685cb1255eba0c5a42fb3b431f170b6e70b874d630eaa3319a5a4f81660aa24ab4141b92f864f2a478f5931f67a660
+  data.tar.gz: 8ca90836a7bae3ef2cc78bfe10035486c3612fc3f6c8117568320de1082b0b447fb08d4cc909e23253328396b336e0a194b98db9c0d4a5c421737106186df42d

data/README.md

@@ -1,14 +1,17 @@
-# activejsonmodel
+# Active JSON Model
 
 [![Gem Version](https://badge.fury.io/rb/activejsonmodel.svg)](https://rubygems.org/gems/activejsonmodel)
-[![Circle](https://circleci.com/gh/rmorlok/activejsonmodel/tree/main.svg?style=shield)](https://app.circleci.com/pipelines/github/rmorlok/activejsonmodel?branch=main)
-[![Code Climate](https://codeclimate.com/github/rmorlok/activejsonmodel/badges/gpa.svg)](https://codeclimate.com/github/rmorlok/activejsonmodel)
+![Github Actions CI](https://github.com/rmorlok/activejsonmodel/actions/workflows/ci.yaml/badge.svg)
 
-TODO: Description of this gem goes here.
+A library for creating Active Models that can serialize/deserialize to JSON. This includes full support for validation
+and change detection through nested models.
+
+Active JSON Model can optionally be combined with Active Record to create nested child models via JSON/JSONB columns. 
 
 ---
 
 - [Quick start](#quick-start)
+- [Gem on RubyGems](https://rubygems.org/gems/activejsonmodel)
 - [Support](#support)
 - [License](#license)
 - [Code of conduct](#code-of-conduct)
@@ -16,14 +19,109 @@ TODO: Description of this gem goes here.
 
 ## Quick start
 
+Install the gem:
+
 ```
 $ gem install activejsonmodel
 ```
 
+If not using in an auto-loading context (i.e. Rails), import it:
+
 ```ruby
 require "active_json_model"
 ```
 
+define a model:
+
+```ruby
+class Point
+  include ActiveJsonModel::Model
+  
+  json_attribute :x, Integer
+  json_attribute :y, Integer
+end
+```
+
+create an instance of a model:
+
+```ruby
+origin = Point.new(x: 0, y:0)
+# => #<Point:0x00007f9f0d0e6538 @mutations_before_last_save=nil, @mutations_from_database=nil, @x=0, @x_is_default=false, @y=0, @y_is_default=false>
+```
+
+export it to a JSON-like hash:
+
+```ruby
+data = origin.dump_to_json
+# => {:x=>0, :y=>0}
+```
+
+encode it as JSON:
+
+```ruby
+JSON.dump(origin.dump_to_json)
+# => "{\"x\":0,\"y\":0}"
+```
+
+load data from a hash object:
+
+```ruby
+point2 = Point.load({x: 17, y:42})
+# => #<Point:0x00007f9f0d10d5c0 @_active_json_model_loaded=true, @mutations_before_last_save=nil, @mutations_from_database=nil, @x=17, @x_is_default=false, @y=42, @y_is_default=false>
+```
+
+load from a raw JSON string:
+
+```ruby
+point3 = Point.load("{\"x\":12,\"y\":19}")
+# => #<Point:0x00007fe9c0113c88 @_active_json_model_loaded=true, @mutations_before_last_save=nil, @mutations_from_database=nil, @x=12, @x_is_default=false, @y=19, @y_is_default=false>
+```
+
+nest models:
+
+```ruby
+class Rectangle
+  include ActiveJsonModel::Model
+
+  json_attribute :top_left, Point
+  json_attribute :bottom_right, Point
+  
+  def contains(point)
+    point.x >= top_left.x && 
+      point.x <= bottom_right.x &&
+      point.y <= top_left.y &&
+      point.y >= bottom_right.y
+  end
+end
+```
+
+If you are using Active Record, use the model as an attribute:
+
+```ruby
+# db/migrate/20220101000001_create_image_annotations.rb
+class CreateImageAnnotations < ActiveRecord::Migration[7.0]
+  def change
+    create_table :image_annotations do |t|
+      t.jsonb      :region_of_interest, null: false, default: {}
+      t.string     :note, null: false, default: ''
+    end
+  end
+end
+
+# app/models/image_annotation.rb
+class ImageAnnotation < ActiveRecord::Base 
+  attribute :region_of_interest, Rectangle.attribute_type
+end
+
+# use...
+rect = Rectangle.new(
+  top_left: Point.new(x: 10, y: 100),
+  bottom_right: Point.new(x: 110, y: 0)
+)
+ia = ImageAnnotation.new(region_of_interest: rect, note: "Check out this mistake")
+ia.save
+```
+
 ## Support
 
 If you want to report a bug, or have ideas, feedback or questions about the gem, [let me know via GitHub issues](https://github.com/rmorlok/activejsonmodel/issues/new) and I will do my best to provide a helpful answer. Happy hacking!
@@ -76,4 +174,53 @@ Active JSON Model uses [minitest](https://github.com/minitest/minitest). To run
 
 ```bash
 rake test
-```
+```
+
+### Building Gem Locally
+
+Build the gem to `pkg/activejsonmodel-x.x.x.gem`:
+
+```bash
+rake build
+```
+
+Install the gem locally and import it:
+
+```bash
+$ gem install ./pkg/activejsonmodel-x.x.x.gem
+Successfully installed activejsonmodel-x.x.x
+Parsing documentation for activejsonmodel-x.x.x
+Installing ri documentation for activejsonmodel-x.x.x
+Done installing documentation for activejsonmodel after 0 seconds
+1 gem installed
+
+$ irb
+irb(main):001:0> require 'active_json_model'
+=> true 
+```
+
+### Releasing a new version
+
+1. Update `lib/activejsonmodel/version.rb`
+
+```ruby
+module ActiveJsonModel
+  VERSION = "x.x.x".freeze
+end
+```
+
+2. Commit all changes
+3. Release the changes using rake:
+
+```bash
+$ rake release
+activejsonmodel x.x.x built to pkg/activejsonmodel-x.x.x.gem.
+Tagged vx.x.x.
+Pushed git commits and release tag.
+Pushing gem to https://rubygems.org...
+Successfully registered gem: activejsonmodel (x.x.x)
+Pushed activejsonmodel x.x.x to rubygems.org
+Don't forget to publish the release on GitHub!
+```
+
+Note that this pushes changes to github and creates a draft release on github. 

data/lib/activejsonmodel/model.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'active_support'
+require 'json'
 require_relative './json_attribute'
 require_relative './after_load_callback'
 
@@ -572,7 +573,7 @@ module ActiveJsonModel
         end
 
         # Get the data to a hash, regardless of the starting data type
-        data = json_data.is_a?(String) ? JSON.parse(json_data) : json_data
+        data = json_data.is_a?(String) ? ::JSON.parse(json_data) : json_data
 
         # Recursively make the value have indifferent access
         data = ::ActiveJsonModel::Utils.recursively_make_indifferent(data)

data/lib/activejsonmodel/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ActiveJsonModel
-  VERSION = "0.1.1".freeze
+  VERSION = "0.1.2".freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: activejsonmodel
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Ryan Morlok
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-08-21 00:00:00.000000000 Z
+date: 2022-08-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -85,7 +85,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.6.0
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="