activejsonmodel 0.1.0 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4bc1e18ab1cb9a6672dc6ab19a0a05340f4761b5cb51ef626d36800846f85a5c
-  data.tar.gz: 847077d254ef430b85ee5853f8d882e0df84f12b34494d1d47868aa32198989c
+  metadata.gz: f12f2a8c7d4739513ed25aa68753babdcee91046a61bbb853be921f6886d34ea
+  data.tar.gz: 977442b81243736fb2fe2ecec108d1e2abfcc4d24c5a2e0a0df24cad388a731e
 SHA512:
-  metadata.gz: 79b717de46de263cc15a03ca0bad9c636bf12458f037078c66b61bcf7c31fbead8106b4506b54731cf44d9a1a267a62e062f900ca37a0d30e79520f9b44e1ee3
-  data.tar.gz: 02cdb543f99326a32c4645898cc99bded4e3136a9b4b3e2d9b09f61792f6761db091ea52f6acf52ec8b4a8f0d1ad4575ddfa74e29ba6e561ea25251f3b1d4630
+  metadata.gz: be403bfb95151340f132ed221037c95f814c0c8b7ad056ed3bac3425b31034d76cc20ac798a29eb512d6eed5bdf7c2b755dc8341c553ba383ab7c760b75ff8e7
+  data.tar.gz: a8c6ffe2e5e4f67c0835e068a0b45355f2f76681e94e068f7123c5b684a8f4f7f7cefb764fc4b1a8806c1544a5091444efe04afb55c8d04e0656a93eb03a1ee7

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
+active_json_model x.x.x built to pkg/active_json_model-x.x.x.gem.
+Tagged vx.x.x.
+Pushed git commits and release tag.
+Pushing gem to https://rubygems.org...
+Successfully registered gem: active_json_model (x.x.x)
+Pushed active_json_model 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 → active_json_model}/array.rb

@@ -238,7 +238,7 @@ module ActiveJsonModel
         #
         # Note that this array_data would be stored as jsonb in the database
         def attribute_type
-          @attribute_type ||= ActiveModelJsonSerializableType.new(self)
+          @attribute_type ||= ActiveRecordType.new(self)
         end
 
         # Allow this model to be used as ActiveRecord attribute type in Rails 5+.
@@ -253,7 +253,7 @@ module ActiveJsonModel
         # Note that this array_data would be stored as a string in the database, encrypted using
         # a symmetric key at the application level.
         def encrypted_attribute_type
-          @encrypted_attribute_type ||= ActiveModelJsonSerializableEncryptedType.new(self)
+          @encrypted_attribute_type ||= ActiveRecordEncryptedType.new(self)
         end
       end
 

data/lib/{activejsonmodel → active_json_model}/model.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'active_support'
+require 'json'
 require_relative './json_attribute'
 require_relative './after_load_callback'
 
@@ -274,7 +275,7 @@ module ActiveJsonModel
         #
         # Note that this data would be stored as jsonb in the database
         def attribute_type
-          @attribute_type ||= ActiveModelJsonSerializableType.new(self)
+          @attribute_type ||= ActiveRecordType.new(self)
         end
 
         # Allow this model to be used as ActiveRecord attribute type in Rails 5+.
@@ -289,7 +290,7 @@ module ActiveJsonModel
         # Note that this data would be stored as a string in the database, encrypted using
         # a symmetric key at the application level.
         def encrypted_attribute_type
-          @encrypted_attribute_type ||= ActiveModelJsonSerializableEncryptedType.new(self)
+          @encrypted_attribute_type ||= ActiveRecordEncryptedType.new(self)
         end
       end
 
@@ -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 → active_json_model}/version.rb

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

data/lib/active_json_model.rb

@@ -1,8 +1,11 @@
 require 'active_model'
+require "active_support"
 
 module ActiveJsonModel
-  autoload :VERSION, "activejsonmodel/version"
-  autoload :Model, "activejsonmodel/model"
-  autoload :Array, "activejsonmodel/array"
-  autoload :Utils, "activejsonmodel/utils"
+  extend ActiveSupport::Autoload
+
+  autoload :VERSION, "active_json_model/version"
+  autoload :Model, "active_json_model/model"
+  autoload :Array, "active_json_model/array"
+  autoload :Utils, "active_json_model/utils"
 end

data/lib/activejsonmodel.rb

@@ -0,0 +1,4 @@
+# This file is here to make sure Rail's autoloading of gems works
+# When requiring manually, use:
+#   require 'active_json_model'
+require_relative './active_json_model'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: activejsonmodel
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.3
 platform: ruby
 authors:
 - Ryan Morlok
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-08-21 00:00:00.000000000 Z
+date: 2022-09-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -50,7 +50,12 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '7.1'
-description:
+description: |
+  A library for creating Active Models that can serialize/deserialize to JSON. This includes full support for validation
+  and change detection through nested models. You can write polymorphic models or arrays of models and get full support
+  for natural serialization.
+
+  Active JSON Model can optionally be combined with Active Record to create nested child models via JSON/JSONB columns.
 email:
 - ryan.morlok@morlok.com
 executables: []
@@ -60,14 +65,15 @@ files:
 - LICENSE.txt
 - README.md
 - lib/active_json_model.rb
-- lib/activejsonmodel/active_record_encrypted_type.rb
-- lib/activejsonmodel/active_record_type.rb
-- lib/activejsonmodel/after_load_callback.rb
-- lib/activejsonmodel/array.rb
-- lib/activejsonmodel/json_attribute.rb
-- lib/activejsonmodel/model.rb
-- lib/activejsonmodel/utils.rb
-- lib/activejsonmodel/version.rb
+- lib/active_json_model/active_record_encrypted_type.rb
+- lib/active_json_model/active_record_type.rb
+- lib/active_json_model/after_load_callback.rb
+- lib/active_json_model/array.rb
+- lib/active_json_model/json_attribute.rb
+- lib/active_json_model/model.rb
+- lib/active_json_model/utils.rb
+- lib/active_json_model/version.rb
+- lib/activejsonmodel.rb
 homepage: https://github.com/rmorlok/activejsonmodel
 licenses:
 - MIT
@@ -85,7 +91,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:
   - - ">="