redijson_models 0.7.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: da409841ddb0e2d3251b356e3c8ec4323fde45d72ff59616c8b45a66321fec1f
+  data.tar.gz: f021b1e4ad6e756bc5901b81dff85f6eb58a73ff44b1fc0281faae37332ef750
+SHA512:
+  metadata.gz: 9754b0ba903cf06f031c59868eacdece3edd63a83b4715b4f91f2aec5692efae336cd40c9564a8be4df9794932c085c673abe1047daaf6c883d74fbd030a1ddb
+  data.tar.gz: b69e219eb00f1e5172a132a56ff208c987bd606c2728a57ab40ff4d406b7a4cadd7809694c538c3073afc2e3b8f040dc44af48d6131e9fb4e784db4da6b3560c

data/Rakefile

@@ -0,0 +1,6 @@
+desc "Spec"
+task :spec do
+  sh "bundle exec rspec"
+end
+
+task default: :spec

data/Readme.md

@@ -0,0 +1,81 @@
+# RediJsonModels
+
+Document-like ORM based on Redis key value store - uses Redis Re-JSON for full json manipulation
+
+### Requirements
+
+- Redis (v4+)
+- Re-JSON module installed
+
+### DB API
+
+```ruby
+Model.get 1 #=> returns an object instance (gets it from redis)
+
+Model.all #=> returns an array of Model object instances
+
+Model.create({}) #=> creates an entry in redis
+
+Model.update(1, {}) #=> updates a record in redis
+```
+
+### Model Definition and Instance API by Virtus
+
+#### Definition:
+
+```ruby
+class Document
+  extend  RediJsonModelLib
+  include RediJsonModelMixin
+  include Virtus.model
+
+  attribute :id,        Integer
+  attribute :name,      String
+  attribute :contents,  String
+
+  def antani
+    # "..."
+  end
+end
+```
+
+### Instance API:
+
+```ruby
+doc = Document.new name: "Foo", contents: "Bar123"
+puts doc.name      #=> "foo"
+puts doc.antani    #=> "..."
+doc.save # saves the record, gives an auto increment id (example: 1)
+
+doc = Document.get doc.id
+puts doc.name      #=> "foo"
+puts doc.antani    #=> "..."
+```
+
+### Run local Redis (+ Re-JSON module) locally via Docker:
+
+in this repo run:
+
+```
+docker-compose up
+```
+
+Which use the docker-compose.yml to start your redis.
+
+
+### Run specs
+
+(you need to run a local redis + rejson service - explained above)
+
+Run:
+
+```
+rake spec
+```
+
+
+---
+
+Enjoy!
+
+@makevoid

data/lib/env.rb

@@ -0,0 +1,14 @@
+# require 'bundler/setup'
+# Bundler.require :default
+require 'redis'
+require 'virtus'
+require 'oj'
+require 'dry-inflector'
+# require 'redis_rejson'
+require 'rejson'
+
+module RediJsonModels
+  REDIS_DB = ENV["REDIS_DB"]
+
+  R = Redis.new db: REDIS_DB || 0
+end

data/lib/redijson_models.rb

@@ -0,0 +1,101 @@
+require_relative 'env'
+
+module RediJsonModels
+
+  # low level API
+  class RJ
+    def self.configure(redis:)
+      @@redis = redis
+    end
+
+    def self.redis
+      @@redis
+    end
+
+    def self.[](key)
+      redis.json_get key, Rejson::Path.root_path
+    end
+
+    def self.[]=(key, val)
+      redis.json_set key, Rejson::Path.root_path, val
+    end
+  end
+
+  module RediJsonModelLib
+    INFLECTOR = Dry::Inflector.new
+
+    def all
+      1.upto(count).map do |entry_id|
+        get entry_id
+      end
+    end
+
+    def count
+      ( RJ["#{resource}:count"] || 0 ).to_i
+    end
+
+    def get(id)
+      data = RJ["#{resource}:#{id}"]
+      return unless data
+      data = Oj.load data
+      new data
+    end
+
+    def create(attrs)
+      id = incr
+      attrs.merge! id: id
+      obj  = new attrs
+      data = Oj.dump obj.attributes
+      RJ["#{resource}:#{id}"] = data
+      obj
+    end
+
+    def update(id, attrs)
+      resource = get id
+      resource.update attrs
+    end
+
+    def resource
+      INFLECTOR.pluralize model_name
+    end
+
+    private
+
+    # TODO: use incr
+    def incr
+      RJ["#{resource}:count"] = count + 1
+    end
+
+    def model_name
+      self.name.downcase
+    end
+
+  end
+
+  module RediJsonModelMixin
+
+    def update(attrs_new)
+      raise "Can't update a resource without an `id`" unless id
+      klass = self.class
+      model = klass.get id
+      attrs = model.attributes
+      attrs.merge! attrs_new
+      obj   = klass.new attrs
+      data  = Oj.dump obj.attributes
+      RJ["#{self.class.resource}:#{id}"] = data
+      obj
+    end
+
+    def save
+      klass = self.class
+      id = klass.send :incr
+      attrs = attributes
+      attrs.merge! id: id
+      data  = Oj.dump attrs
+      RJ["#{self.class.resource}:#{id}"] = data
+      self
+    end
+
+  end
+
+end

data/lib/version.rb

@@ -0,0 +1,3 @@
+module RediJsonModels
+  VERSION = 0.7.0
+end

metadata

@@ -0,0 +1,119 @@
+--- !ruby/object:Gem::Specification
+name: redijson_models
+version: !ruby/object:Gem::Version
+  version: 0.7.0
+platform: ruby
+authors:
+- makevoid
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-05-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: redis
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+- !ruby/object:Gem::Dependency
+  name: virtus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.5
+- !ruby/object:Gem::Dependency
+  name: oj
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.10.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.10.6
+- !ruby/object:Gem::Dependency
+  name: dry-inflector
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: rejson-rb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+description: Document-like ORM based on Redis key value store - uses Redis Re-JSON
+  for full json manipulation
+email:
+- makevoid@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Rakefile
+- Readme.md
+- lib/env.rb
+- lib/redijson_models.rb
+- lib/version.rb
+homepage: http://makevoid.com
+licenses:
+- Unlicense
+metadata: {}
+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.0.3
+signing_key: 
+specification_version: 4
+summary: Document-like ORM based on Redis key value store
+test_files: []