glimmer 2.0.1 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a2d51ad333d0d08344d21c90f6bec78ec0cd09b61cd2d86b5d79ecf8374b7f6
-  data.tar.gz: c85f1d8f57ec0556ca3042d49050714908c763dbea9e911f10cde85dc5405b75
+  metadata.gz: 912a0642f9a9a7a0811c8ba1fc41cd0cc1c0d0782bb358309bf2d2f70d5a187e
+  data.tar.gz: 3d35f07751808800467b9e267aab343a04e0609d71ca15048273b725c1525ce4
 SHA512:
-  metadata.gz: 26211cca1888df8245ea8c1c76b74effac9370038e42474cbf1e7fb4b905c54a0f5b972dfdb4413293898fb75fea155779bfd49e15f118e7560cba5ffb13b3da
-  data.tar.gz: d56fe91c1eaac6730ef3b706a3e4adf467251cdc48f1ead6f2ea9070e85145ac3e2b774813d2222dd86dbfac0a416dfab54232f0e840cf0e1a28dc2acf7cc2fc
+  metadata.gz: 0e185959434641f56cc0ce6b031a2444348cdb076681ec026d2fb78851602f069e79eed56f55b0abe50281bf6595555642aeff92cb721f236b49bc5dbf8101b2
+  data.tar.gz: a2be36ee355356c73217bed677f09eb4e1e54b5f7c473cf8fa2a5de8e17d8cd423164af7c9f5f10285dc365dcc4475216e75965c6f804c9b4fdc77e533224229

data/README.md

@@ -156,7 +156,8 @@ end
 ```
 
 An extra convenience expression module is included called `BindExpression`. It builds a `Glimmer::DataBinding::ModelBinding` object for [data-binding](#data-binding) purposes.
-You may learn more about it by looking at how [Glimmer DSL for SWT](https://github.com/AndyObtiva/glimmer-dsl-swt) uses it.
+Another convenience expression module is `ObserveExpression`, which enables a one-way `observe` operation.
+You may learn more about both by looking at how [Glimmer DSL for SWT](https://github.com/AndyObtiva/glimmer-dsl-swt) uses them.
 
 DSL expressions go into the `glimmer/dsl/{dsl_name}` namespace directory.
 
@@ -207,7 +208,7 @@ end
 ### Setup
 
 Follow these steps to author a [Glimmer](https://rubygems.org/gems/glimmer) DSL:
-- Add `gem 'glimmer', '~> 2.0.1'` to `Gemfile` and run `bundle` or run `gem install glimmer -v2.0.1` and add `require 'glimmer'`
+- Add `gem 'glimmer', '~> 2.1.0'` to `Gemfile` and run `bundle` or run `gem install glimmer -v2.1.0` and add `require 'glimmer'`
 - Create `glimmer/dsl/[dsl_name]/dsl.rb`, which requires and adds all dynamic expressions for the [dsl_name] Glimmer DSL module as per the code shown in the previous section (or [Official DSLs](#official-dsls) as examples)
 - Create `glimmer/dsl/[dsl_name]/[expresion_name]_expresion.rb` for every [expresion_name] expression needed, whether dynamic or static
 

data/VERSION

@@ -1 +1 @@
-2.0.1
+2.1.0

data/glimmer.gemspec

@@ -2,16 +2,16 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: glimmer 2.0.1 ruby lib
+# stub: glimmer 2.1.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "glimmer".freeze
-  s.version = "2.0.1"
+  s.version = "2.1.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
   s.authors = ["AndyMaleh".freeze]
-  s.date = "2021-07-24"
+  s.date = "2021-08-08"
   s.description = "Glimmer is a Ruby DSL Framework for Ruby GUI and More, consisting of a DSL Engine and an Observable/Observer/Data-Binding Library. Used in the Glimmer DSL for SWT (JRuby Desktop Development GUI Framework), the Glimmer DSL for Tk (Ruby Desktop Development GUI Library), the Glimmer DSL for Opal (Pure Ruby Web GUI and Auto-Webifier of Desktop Apps), the Glimmer DSL for XML (& HTML), and the Glimmer DSL for CSS.".freeze
   s.email = "andy.am@gmail.com".freeze
   s.extra_rdoc_files = [
@@ -39,6 +39,7 @@ Gem::Specification.new do |s|
     "lib/glimmer/dsl/engine.rb",
     "lib/glimmer/dsl/expression.rb",
     "lib/glimmer/dsl/expression_handler.rb",
+    "lib/glimmer/dsl/observe_expression.rb",
     "lib/glimmer/dsl/parent_expression.rb",
     "lib/glimmer/dsl/static_expression.rb",
     "lib/glimmer/dsl/top_level_expression.rb",

data/lib/glimmer/dsl/observe_expression.rb

@@ -0,0 +1,48 @@
+# Copyright (c) 2007-2021 Andy Maleh
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'glimmer/data_binding/observer'
+require 'glimmer/data_binding/model_binding'
+
+module Glimmer
+  module DSL
+    module ObserveExpression
+      REGEX_NESTED_OR_INDEXED_PROPERTY = /([^\[]+)(\[[^\]]+\])?/
+
+      def can_interpret?(parent, keyword, *args, &block)
+        keyword == 'observe' and
+          block_given? and
+          (args.size == 2) and
+          textual?(args[1])
+      end
+
+      def interpret(parent, keyword, *args, &block)
+        observer = DataBinding::Observer.proc(&block)
+        if args[1].to_s.match(REGEX_NESTED_OR_INDEXED_PROPERTY)
+          observer_registration = observer.observe(DataBinding::ModelBinding.new(args[0], args[1]))
+        else
+          observer_registration = observer.observe(args[0], args[1])
+        end
+        observer_registration
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glimmer
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.1.0
 platform: ruby
 authors:
 - AndyMaleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-07-24 00:00:00.000000000 Z
+date: 2021-08-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: array_include_methods
@@ -241,6 +241,7 @@ files:
 - lib/glimmer/dsl/engine.rb
 - lib/glimmer/dsl/expression.rb
 - lib/glimmer/dsl/expression_handler.rb
+- lib/glimmer/dsl/observe_expression.rb
 - lib/glimmer/dsl/parent_expression.rb
 - lib/glimmer/dsl/static_expression.rb
 - lib/glimmer/dsl/top_level_expression.rb