pakyow-ui 0.10.0

data/pakyow-ui/lib/pakyow-ui/ui_instructable.rb

@@ -0,0 +1,112 @@
+module Pakyow
+  module UI
+    # Helper methods for instructable objects.
+    #
+    # @api private
+    module Instructable
+      def self.included(klass)
+        (@instructables ||= []) << klass
+      end
+
+      def self.instructable?(object)
+        @instructables.select { |i|
+          object.is_a?(i)
+        }.any?
+      end
+
+      attr_reader :instructions
+      attr_accessor :root
+
+      def initialize
+        @instructions = []
+      end
+
+      def instruct(method, data)
+        @instructions << [clean_method(method), hashify(data)]
+        self
+      end
+
+      def nested_instruct(method, data, scope = nil)
+        view = nested_instruct_object(method, data, scope)
+        view.root = self
+
+        @instructions << [clean_method(method), hashify(data), view]
+        view
+      end
+
+      # Returns an instruction set for all view transformations.
+      #
+      # e.g. a value-less transformation:
+      # [[:remove, nil]]
+      #
+      # e.g. a transformation with a value:
+      # [[:text=, 'foo']]
+      #
+      # e.g. a nested transformation
+      # [[:scope, :post, [[:remove, nil]]]]
+      def finalize
+        @instructions.map { |instruction|
+          if Instructable.instructable?(instruction[2])
+            instruction[2] = instruction[2].finalize
+          end
+
+          instruction
+        }
+      end
+
+      private
+
+      def mixin_bindings(data, bindings = {})
+        data.map { |bindable|
+          datum = bindable.to_hash
+          Pakyow::Presenter::Binder.instance.bindings_for_scope(scoped_as, bindings).keys.each do |key|
+            result = Pakyow::Presenter::Binder.instance.value_for_scoped_prop(scoped_as, key, bindable, bindings, self)
+
+            if result.is_a?(Hash)
+              # we don't currently support view manipulations that occur in bindings
+              # TODO: look into what it would take to support this
+              result.delete(:view)
+
+              datum[key] = {
+                __content: result.delete(:content),
+                __attrs: Hash[*result.flat_map { |k, v|
+                  if v.respond_to?(:to_proc)
+                    attrs = UIAttrs.new
+                    v.call(attrs)
+                    [k, attrs.finalize]
+                  else
+                    [k, v]
+                  end
+                }]
+              }
+            else
+              datum[key] = result
+            end
+          end
+
+          datum
+        }
+      end
+
+      def hashify(data)
+        return hashify_datum(data) unless data.is_a?(Array)
+
+        data.map { |datum|
+          hashify_datum(datum)
+        }
+      end
+
+      def hashify_datum(datum)
+        if datum.respond_to?(:to_hash)
+          datum.to_hash
+        else
+          datum
+        end
+      end
+
+      def clean_method(method)
+        method.to_s.delete('=').to_sym
+      end
+    end
+  end
+end

data/pakyow-ui/lib/pakyow-ui/ui_view.rb

@@ -0,0 +1,179 @@
+require_relative 'ui_attrs'
+require_relative 'ui_instructable'
+
+module Pakyow
+  module UI
+    # Translates view transformations to instructions.
+    #
+    # @api private
+    class UIView
+      include Instructable
+
+      def initialize(scope)
+        super()
+        @scope = scope
+      end
+
+      def nested_instruct_object(_method, _data, scope)
+        UIView.new(scope || @scope)
+      end
+
+      def scoped_as
+        @scope
+      end
+
+      def attrs_instruct
+        attrs = UIAttrs.new
+        @instructions << [:attrs, nil, attrs]
+        attrs
+      end
+
+      ### view methods w/o args
+
+      %i(
+        remove
+        clear
+      ).each do |method|
+        define_method method do
+          instruct(method, nil)
+        end
+      end
+
+      ### view methods w/ args
+
+      %i(
+        title=
+        text=
+        html=
+        append
+        prepend
+        after
+        before
+        replace
+      ).each do |method|
+        define_method method do |value|
+          instruct(method, value.to_s)
+        end
+      end
+
+      ### misc view methods
+
+      def with(&block)
+        if block.arity == 0
+          instance_exec(&block)
+        else
+          yield(self)
+        end
+
+        self
+      end
+
+      def match(data)
+        instruct(:match, Array.ensure(data))
+      end
+
+      def scope(name)
+        nested_instruct(:scope, name.to_s, name)
+      end
+
+      def attrs
+        attrs_instruct
+      end
+
+      ### view methods that change context
+
+      %i(
+        prop
+        component
+      ).each do |method|
+        define_method method do |value|
+          nested_instruct(method, value.to_s)
+        end
+      end
+
+      ### view methods that continue into a new context
+
+      def for(data, &block)
+        nested = nested_instruct(:for, data)
+        Array.ensure(data).each do |datum|
+          sub = UIView.new(@scope)
+
+          if block.arity == 1
+            sub.instance_exec(datum, &block)
+          else
+            block.call(sub, datum)
+          end
+
+          nested.instructions << sub.finalize
+        end
+      end
+
+      def for_with_index(*args, &block)
+        self.for(*args, &block)
+      end
+
+      def repeat(data, &block)
+        nested = nested_instruct(:repeat, data)
+        Array.ensure(data).each do |datum|
+          sub = UIView.new(@scope)
+
+          if block.arity == 1
+            sub.instance_exec(datum, &block)
+          else
+            block.call(sub, datum)
+          end
+
+          nested.instructions << sub.finalize
+        end
+      end
+
+      def repeat_with_index(*args, &block)
+        repeat(*args, &block)
+      end
+
+      def bind(data, bindings: {}, context: nil, &block)
+        # TODO: handle context?
+
+        data = mixin_bindings(Array.ensure(data), bindings)
+        nested = nested_instruct(:bind, data)
+        return self unless block_given?
+
+        data.each do |datum|
+          sub = UIView.new(@scope)
+
+          if block.arity == 1
+            sub.instance_exec(datum, &block)
+          else
+            block.call(sub, datum)
+          end
+
+          nested.instructions << sub.finalize
+        end
+      end
+
+      def bind_with_index(*args, &block)
+        bind(*args, &block)
+      end
+
+      def apply(data, bindings: {}, context: nil, &block)
+        # TODO: handle context?
+
+        data = mixin_bindings(Array.ensure(data), bindings)
+        nested = nested_instruct(:apply, data)
+        return self unless block_given?
+
+        data.each do |datum|
+          sub = UIView.new(@scope)
+
+          if block.arity == 1
+            sub.instance_exec(datum, &block)
+          else
+            block.call(sub, datum)
+          end
+
+          nested.instructions << sub.finalize
+        end
+      end
+    end
+  end
+end

data/pakyow-ui/lib/pakyow-ui.rb

@@ -0,0 +1 @@
+require_relative 'pakyow-ui/base'

metadata

@@ -0,0 +1,154 @@
+--- !ruby/object:Gem::Specification
+name: pakyow-ui
+version: !ruby/object:Gem::Version
+  version: 0.10.0
+platform: ruby
+authors:
+- Bryan Powell
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-10-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pakyow-support
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+- !ruby/object:Gem::Dependency
+  name: pakyow-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+- !ruby/object:Gem::Dependency
+  name: pakyow-presenter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+- !ruby/object:Gem::Dependency
+  name: pakyow-realtime
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.6'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+description: Auto-Updating UIs for Pakyow
+email: bryan@metabahn.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- pakyow-ui/CHANGELOG.md
+- pakyow-ui/LICENSE
+- pakyow-ui/README.md
+- pakyow-ui/lib/pakyow-ui.rb
+- pakyow-ui/lib/pakyow-ui/base.rb
+- pakyow-ui/lib/pakyow-ui/channel_builder.rb
+- pakyow-ui/lib/pakyow-ui/config.rb
+- pakyow-ui/lib/pakyow-ui/ext/app.rb
+- pakyow-ui/lib/pakyow-ui/ext/app_context.rb
+- pakyow-ui/lib/pakyow-ui/ext/view_context.rb
+- pakyow-ui/lib/pakyow-ui/fetch_view_handler.rb
+- pakyow-ui/lib/pakyow-ui/helpers.rb
+- pakyow-ui/lib/pakyow-ui/mock_mutation_eval.rb
+- pakyow-ui/lib/pakyow-ui/mutable.rb
+- pakyow-ui/lib/pakyow-ui/mutable_data.rb
+- pakyow-ui/lib/pakyow-ui/mutate_context.rb
+- pakyow-ui/lib/pakyow-ui/mutation_set.rb
+- pakyow-ui/lib/pakyow-ui/mutation_store.rb
+- pakyow-ui/lib/pakyow-ui/mutator.rb
+- pakyow-ui/lib/pakyow-ui/no_op_view.rb
+- pakyow-ui/lib/pakyow-ui/registries/redis_mutation_registry.rb
+- pakyow-ui/lib/pakyow-ui/registries/simple_mutation_registry.rb
+- pakyow-ui/lib/pakyow-ui/ui.rb
+- pakyow-ui/lib/pakyow-ui/ui_attrs.rb
+- pakyow-ui/lib/pakyow-ui/ui_component.rb
+- pakyow-ui/lib/pakyow-ui/ui_instructable.rb
+- pakyow-ui/lib/pakyow-ui/ui_view.rb
+homepage: http://pakyow.org
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- pakyow-ui/lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Pakyow UI
+test_files: []