qwe 0.0.0 → 0.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2a6e78eee154ac187e57a6f648989edbeb98bb6d09ee98118a386148f04d24d
-  data.tar.gz: a65ced572c633210b481e3779dce21524858687c42fd3667e71727e4f165ceb9
+  metadata.gz: 47af0803616e55171f1a450977dd4b72b1b94d8175b89609902a504b5289b1e3
+  data.tar.gz: 74c203d62db281e90db12badbe71f61bc01e3048b8d823005e035adb61658084
 SHA512:
-  metadata.gz: 428a88b7fd3e63e9236931cc65d0a123f272e71e503bd7cbb0a309e23440b57d4d8421ac442cf6be993f088978f39ef57563f246c4f44ecc49828f8475ce11b9
-  data.tar.gz: d5536e2f23c54ae7aaa8c09384ed72f3d94f7af4224a93bdfca35d74a7b11d67807d8f13602758a0bcfe2d230167e7c41ab2af839afb94bc7419ccae2e5570e9
+  metadata.gz: 793f496b7be56bd4c51f0954a9a9755d079cf4d76be1bf4f9fba2de584abfd3c5fdaf32297652a95c5ce96eb3fd0686743e583bcec56989e42adbf903cfd9165
+  data.tar.gz: efb62e30e52a37ddaf36d0de164ab65be87e307115ac5325ad1ff6131e35ef31f3257512a4d57ce41ebe9675721e78fe4b9ef13a543651a2b5bb36c355b77f8b

data/DOCS.md

@@ -46,6 +46,8 @@ Configuration of server started from puma is done with `config/qwe.yml`. Valid c
 are last variants of cli argument names. For example, detach timeout can be set with
 `-s`, `--detach` and `--detach_timeout` cli options, or `detach_timeout` config key.
 
+`--watch` is not available in puma plugin.
+
 ## Production example
 
 config/puma.rb
@@ -219,7 +221,7 @@ multi-line, so it isn't equal to commits count.
 - `commit(str)` - write string to commits file. Attributes do that for you.
 - `object_at(line)` - returns historic object state, or wayback, by evaluating commits until `line` in context of initial object state.
 - `fork(line)` - same as object_at, but creates a new record. Returns newly created `Qwe::DB::Record`.
-- `archive!` - compress commits file with `zst`. Requires native `zstd` package, see [ruby zstd docs](https://github.com/andrew-aladev/ruby-zstds?tab=readme-ov-file#installation). If commit is written into archived record, file will get unpacked with a warning.
+- `archive!` - compress commits file with `zst`. If commit is written into archived record, file will get unpacked with a warning.
 - `dir` - path to the record directory in filesystem
 - `dump` - `Marshal.dump(object)`
 
@@ -266,7 +268,8 @@ attribute :zxc, init: -> { Time.now }
 attribute :qwe, min: 10
 attribute :asd, max: 20
 ```
-- `array` - `bool` - initializes attribute to `Qwe::Attribute::ArrayProxy`, which is like array, but commits changes, see [limitations](#Limitations) on why it matters.
+- `array` - `bool` - initializes attribute to `Qwe::Proxy::Array`, which is like array, but commits changes, see [limitations](#Limitations) on why it matters.
+- `hash` - `bool` - same as array, but for hashes. Attribute type is `Qwe::Proxy::Hash`.
 - `enum` - `Array` or any object responding to `include?` - raise on write if value is not included in provided enum.
 ```ruby
 attribute :weather, enum: [:hot, :cold, :normal]
@@ -433,7 +436,7 @@ As we expect, resulting `a.str` value would be "qxe". However, `sub!` modifies s
 a.str = a.str.sub "w", "x"
 ```
 
-For strings this is somewhat fine, but for large arrays things get worse. For arrays there is `Qwe::Attribute::ArrayProxy` class, which extends `Array` class and commits changes.
+For strings this is somewhat fine, but for large arrays things get worse. For arrays there is `Qwe::Proxy::Array` class, which extends `Array` class and commits changes.
 
 So the rule here is **don't use in-place modifications on attributes**, and if you need these - extend desired class and write committing logic. Be sure to benchmark results - sometimes replacing object entirely would be faster than doing complex checks.
 

data/README.md

@@ -5,6 +5,14 @@ as possible on the way you write code.
 
 [Full Documentation](DOCS.md)
 
+[Multiplayer paint example](https://gitlab.com/goose3228/qwe-paint)
+
+## Installation
+
+Qwe requires native [zstd](https://github.com/facebook/zstd) support.
+
+Otherwise it's regular `bundle add qwe` or `gem install qwe`
+
 ## Features
 
 ### Zero-config startup

data/exe/qwe

@@ -66,7 +66,7 @@ if args[:watch]
   begin
     require "listen"
   rescue LoadError
-    puts "Can't load 'listen' gem"
+    puts "'listen' gem is required to use -w/--watch option"
     exit 1
   end
   pid = spawn_server(args)

data/lib/qwe/attribute.rb

@@ -134,60 +134,19 @@ module Qwe
     end
 
     add(:array) do
-      writer.stage "value = Qwe::Attribute::ArrayProxy.from_array(self, :#{name}, value)"
+      writer.stage "value = Qwe::Proxy::Array.from_array(self, :#{name}, value)"
       klass.init.stage("self.#{name} = []") unless init
     end
 
+    add(:hash) do
+      writer.stage "value = Qwe::Proxy::Hash.from_hash(self, :#{name}, value)"
+      klass.init.stage("self.#{name} = {}") unless init
+    end
+
     add(:enum) do
       raise "#{klass}.#{name} - enum #{enum} doesn't respond to include?" unless enum.respond_to?(:include?)
       klass.class_variable_set(:"@@#{name}_enum", enum)
       writer.stage "raise \"Enum - unknown value \#{self}.#{name} = \#{value}\" unless @@#{name}_enum.include?(value)"
     end
-
-    class ArrayProxy < Array
-      attr_accessor :__qwe_thing
-      attr_accessor :__qwe_name
-
-      include DRb::DRbUndumped
-
-      undef _dump
-
-      def __qwe_commit(m, *a, **k)
-        __qwe_thing&.root&.record&.commit("#{__qwe_thing.to_rb}.#{__qwe_name}.method(:#{m}).super_method.call(*#{a.to_rb}, **#{k.to_rb})\n")
-      end
-
-      TRANSACTION_METHODS = [:<<, :[]=, :clear, :compact!, :concat, :delete_at, :flatten!, :insert, :pop, :push, :replace, :reverse!, :rotate!, :shift, :shuffle!, :slice!, :unshift]
-      REPLACE_METHODS = [:delete, :delete_if, :fill, :filter!, :select!, :keep_if, :map!, :reject!, :sort!, :sort_by!, :uniq!]
-
-      TRANSACTION_METHODS.each do |m|
-        define_method(m) do |*a, **k|
-          __qwe_commit(m, *a, **k)
-          super(*a, **k)
-        end
-      end
-
-      REPLACE_METHODS.each do |m|
-        define_method(m) do |*a, **k, &block|
-          r = super(*a, **k, &block)
-          if block
-            __qwe_thing&.root&.record&.commit "#{__qwe_thing.to_rb}.instance_variable_set(:@#{__qwe_name}, #{to_rb})\n"
-          else
-            __qwe_commit(m, *a, **k)
-          end
-          r
-        end
-      end
-
-      def self.from_array(thing, name, arr = [])
-        a = new(arr)
-        a.__qwe_thing = thing
-        a.__qwe_name = name
-        a
-      end
-
-      def to_rb
-        "Qwe::Attribute::ArrayProxy.from_array(#{__qwe_thing.to_rb}, :#{__qwe_name}, #{super})"
-      end
-    end
   end
 end

data/lib/qwe/proxy/array.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+class Qwe::Proxy::Array < Array
+  Qwe::Proxy.make self
+
+  Qwe::Proxy.transaction self,
+    :<<, :[]=, :clear, :compact!, :concat, :delete_at, :flatten!,
+    :insert, :pop, :push, :replace, :reverse!, :rotate!, :shift,
+    :shuffle!, :slice!, :unshift
+
+  Qwe::Proxy.block self,
+    :delete, :delete_if, :fill, :filter!, :select!, :keep_if,
+    :map!, :reject!, :sort!, :sort_by!, :uniq!
+
+  def self.from_array(thing, name, arr = [])
+    if arr.is_a?(Qwe::Proxy::Array)
+      arr
+    else
+      a = new(arr)
+      a.__qwe_thing = thing
+      a.__qwe_name = name
+      a
+    end
+  end
+
+  def to_rb
+    "Qwe::Proxy::Array.from_array(#{__qwe_thing.to_rb}, :#{__qwe_name}, #{super})"
+  end
+end

data/lib/qwe/proxy/hash.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+class Qwe::Proxy::Hash < Hash
+  Qwe::Proxy.make self
+
+  Qwe::Proxy.transaction self,
+    :[]=, :store, :clear, :compact!, :default=, :rehash, :replace, :shift
+
+  Qwe::Proxy.block self,
+    :delete, :delete_if, :filter!, :select!, :keep_if, :merge!,
+    :reject!, :transform_keys!, :transform_values!
+
+  def self.from_hash(thing, name, hash = {})
+    if hash.is_a?(Qwe::Proxy::Hash)
+      hash
+    else
+      h = new
+      h.replace(hash)
+      h.__qwe_thing = thing
+      h.__qwe_name = name
+      h
+    end
+  end
+
+  def to_rb
+    "Qwe::Proxy::Hash.from_hash(#{__qwe_thing.to_rb}, :#{__qwe_name}, #{super})"
+  end
+end

data/lib/qwe/proxy.rb

@@ -0,0 +1,43 @@
+module Qwe
+  module Proxy
+    def self.make(klass)
+      klass.module_exec do
+        attr_accessor :__qwe_thing, :__qwe_name
+
+        include DRb::DRbUndumped
+
+        undef _dump
+
+        def __qwe_commit(m, *a, **k)
+          __qwe_thing&.root&.record&.commit("#{__qwe_thing.to_rb}.#{__qwe_name}.method(:#{m}).super_method.call(*#{a.to_rb}, **#{k.to_rb})\n")
+        end
+      end
+    end
+
+    def self.transaction(klass, *methods)
+      methods.each do |m|
+        klass.define_method(m) do |*a, **k|
+          __qwe_commit(m, *a, **k)
+          super(*a, **k)
+        end
+      end
+    end
+
+    def self.block(klass, *methods)
+      methods.each do |m|
+        klass.define_method(m) do |*a, **k, &block|
+          r = super(*a, **k, &block)
+          if block
+            __qwe_thing&.root&.record&.commit "#{__qwe_thing.to_rb}.instance_variable_set(:@#{__qwe_name}, #{to_rb})\n"
+          else
+            __qwe_commit(m, *a, **k)
+          end
+          r
+        end
+      end
+    end
+  end
+end
+
+require_relative "proxy/array"
+require_relative "proxy/hash"

data/lib/qwe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Qwe
-  VERSION = "0.0.0"
+  VERSION = "0.0.1"
 end

data/lib/qwe.rb

@@ -9,6 +9,7 @@ require_relative "qwe/version"
 require_relative "qwe/mixins"
 require_relative "qwe/db"
 require_relative "qwe/function"
+require_relative "qwe/proxy"
 require_relative "qwe/attribute"
 
 module Qwe

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: qwe
 version: !ruby/object:Gem::Version
-  version: 0.0.0
+  version: 0.0.1
 platform: ruby
 authors:
 - goose3228
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-12-25 00:00:00.000000000 Z
+date: 2025-01-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: drb
@@ -68,6 +68,9 @@ files:
 - lib/qwe/mixins/process.rb
 - lib/qwe/mixins/root.rb
 - lib/qwe/mixins/thing.rb
+- lib/qwe/proxy.rb
+- lib/qwe/proxy/array.rb
+- lib/qwe/proxy/hash.rb
 - lib/qwe/version.rb
 - lib/spawn_worker.rb
 - qwe.gemspec