molecule 0.2.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4f61bb41f5c639e0dcad823a22bbc34f4c9bfcf3ae4b45f9746b5d0c49a10077
+  data.tar.gz: 577575e585a397a50e167bf440280241c9cad00102fdeada6a163f13cf10f698
+SHA512:
+  metadata.gz: e10d10a9535c08cacbf495d564a2d7228e95e320f8183249e3aee5a317d885d0e41278fa692978278128cffee75e5bd3945b69393be1b4dceaddc100e76526ee
+  data.tar.gz: 4b9b98d18375da1c929aa9c67186b5cb75c750f40441e6e10d341450332a0f2e6a65ce45a02e6a7bdaef953ba9ae6fe4b6e478d111997b5fe99275adb5b2f2f7

data/LICENSE

@@ -0,0 +1,13 @@
+A modified MIT License (MIT)
+
+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.
+
+Neither the Software, nor any derivative product, shall be used to operate weapons
+
+Neither the Software, nor any derivative product, shall be used for any military use
+
+Neither the Software, nor any derivative product, shall be used for any use by intelligence agencies
+
+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.

data/README.md

@@ -0,0 +1,28 @@
+# MolecularRenderer
+Short description and motivation.
+
+## Usage
+How to use my plugin.
+
+## Installation
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'molecular_renderer'
+```
+
+And then execute:
+```bash
+$ bundle
+```
+
+Or install it yourself as:
+```bash
+$ gem install molecular_renderer
+```
+
+## Contributing
+Contribution directions go here.
+
+## License
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,27 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rdoc/task'
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Molecule'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.md')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+require 'bundler/gem_tasks'
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+task default: :test

data/bin/test

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+$: << File.expand_path("../test", __dir__)
+
+require "bundler/setup"
+require "rails/plugin/test"

data/lib/molecule/asset_group.rb

@@ -0,0 +1,19 @@
+
+module Molecule
+
+  class AssetGroup
+    attr_accessor :name, :type, :file_paths
+
+    def initialize name, type
+      @name = name
+      @type = type
+      @file_paths = []
+    end
+
+    def add_file_path file_path
+      @file_paths << file_path
+    end
+
+  end
+
+end

data/lib/molecule/asset_renderers/inline.rb

@@ -0,0 +1,14 @@
+
+module Molecule
+
+  module AssetRenderers
+
+    def molecule_inline_asset asset_type
+    end
+
+    def molecule_defer_asset asset_type
+    end
+
+  end
+
+end

data/lib/molecule/configuration.rb

@@ -0,0 +1,19 @@
+
+module Molecule
+  class Configuration
+    attr_accessor :verify_children
+
+    def initialize
+      reset_defaults!
+    end
+
+    def reset_defaults!
+      @verify_children = false
+    end
+
+    def verify_children?
+      !!@verify_children
+    end
+
+  end
+end

data/lib/molecule/controller.rb

@@ -0,0 +1,12 @@
+
+module Molecule
+
+  module Controller
+    extend ActiveSupport::Concern
+
+    included do
+      include Molecule::Renderers::Base
+    end
+  end
+
+end

data/lib/molecule/file.rb

@@ -0,0 +1,28 @@
+
+module Molecule
+
+  class File
+
+    attr_accessor :name
+
+    def initialize name
+      @name = name.to_s
+    end
+
+    def read
+      JSON.parse(read_file, symbolize_names: true)
+    end
+
+    def read_file
+      ::File.read(molecule_file_path)
+    rescue
+      '{}'
+    end
+
+    def molecule_file_path
+      Rails.root.join('app', 'molecules', @name, 'molecule.json').to_s
+    end
+
+  end
+
+end

data/lib/molecule/helper.rb

@@ -0,0 +1,80 @@
+module Molecule
+
+  module Helper
+
+    def molecule_inline_style molecule_name
+      content_tag(:style, molecule_asset_contents(molecule_name, 'inline', 'styles')).html_safe
+    end
+
+    def molecule_inline_script molecule_name
+      content_tag(:script, molecule_asset_contents(molecule_name, 'inline', 'scripts')).html_safe
+    end
+
+    def molecule_defer_style molecule_name
+      relative_link = molecule_relative_path(molecule_name, 'defer', 'styles')
+      content_tag(:noscript, class: 'defered-style') do
+        content_tag(:link, '', {rel: :stylesheet, type: 'text/css', href: relative_link}).html_safe
+      end.html_safe
+    end
+
+    def molecule_defer_script molecule_name
+      relative_link = molecule_relative_path(molecule_name, 'defer', 'scripts')
+      content_tag(:script, '', {defer: :defer, src: relative_link}).html_safe
+    end
+
+    def molecule_asset_contents molecule_name, asset_group, asset_type
+      ::File.read(abolute_asset_path(molecule_name, asset_group, asset_type)).html_safe
+    end
+
+    def molecule_relative_path molecule_name, asset_group, asset_type
+      suffix, asset = find_asset(molecule_name, asset_group, asset_type)
+      "/assets/#{suffix}/#{asset}"
+    end
+
+    def molecule_inline_sprite molecule_name
+      manifest_path = Rails.root.join('public', 'manifests', "#{molecule_name}/icons.json")
+      manifest = ::File.read(manifest_path)
+      json = JSON.parse(manifest);
+      asset_path = Rails.root.join('public', 'assets', 'svg', json["#{molecule_name}.svg"])
+      ::File.read(asset_path).html_safe
+    end
+
+
+    private
+
+
+    def find_asset molecule_name, asset_group, asset_type
+      config = load_manifest(molecule_name, asset_group, asset_type)
+      suffix = suffix_for_type(asset_type)
+      asset_slug = "#{molecule_name}-#{asset_group}.#{suffix}"
+      asset = config[asset_slug]
+      return suffix, asset
+    end
+
+    def abolute_asset_path molecule_name, asset_group, asset_type
+      suffix, asset = find_asset(molecule_name, asset_group, asset_type)
+      Rails.root.join('public', 'assets', suffix, asset)
+    end
+
+    def suffix_for_type asset_type
+      case asset_type
+        when 'scripts'
+          'js'
+        when 'styles'
+          'css'
+        else
+          raise "unknown asset type: #{asset_type}"
+      end
+    end
+
+    def load_manifest molecule_name, asset_group, asset_type
+      manifest = ::File.read(manifest_path(molecule_name, asset_group, asset_type))
+      JSON.parse(manifest);
+    end
+
+    def manifest_path molecule_name, asset_group, asset_type
+      Rails.root.join('public', 'manifests', "#{molecule_name}/#{asset_group}-#{asset_type}.json")
+    end
+  end
+
+end

data/lib/molecule/molecule.rb

@@ -0,0 +1,45 @@
+require 'molecule/file'
+
+module Molecule
+
+  class Molecule
+
+    attr_accessor :name, :version, :dependencies
+    @@cache = {}
+
+    def initialize name, version, dependencies
+      @name = name.to_s
+      @version = version
+      @dependencies = dependencies
+    end
+
+    def has_child? name
+      @dependencies.include?(name)
+    end
+
+    def self.read name
+      read_from_cache(name) || read_from_file(name)
+    end
+
+    def self.read_from_file name
+      molecule_config = ::Molecule::File.new(name).read
+
+      raise "invalid molecule name '#{name}' in:\n#{molecule_config.inspect}" if name.to_s != molecule_config[:name]
+
+      version = molecule_config[:version] || '0.1.0'
+      dependencies = molecule_config[:dependencies] || []
+
+      @@cache[name] = self.new name, version, dependencies
+    end
+
+    def self.read_from_cache name
+      @@cache[name]
+    end
+
+    def self.clear_cache
+      @@cache = {}
+    end
+
+  end
+
+end

data/lib/molecule/railtie.rb

@@ -0,0 +1,21 @@
+require 'molecule/controller'
+require 'molecule/helper'
+require 'molecule/renderer_extension'
+
+module MolecularRenderer
+
+  class Railtie < ::Rails::Railtie
+
+    initializer "molecule.view_helpers" do
+      ActiveSupport.on_load(:action_view) do
+        include Molecule::Helper
+
+        class ::ActionView::Renderer
+          prepend Molecule::RendererExtension
+        end
+      end
+    end
+
+  end
+
+end

data/lib/molecule/registry.rb

@@ -0,0 +1,50 @@
+require 'molecule/asset_group'
+require 'json'
+
+module Molecule
+
+  class Registry
+
+    attr_accessor :name, :molecules
+
+    def initialize name
+      @name = name
+      @molecules = {}
+    end
+
+    def register_molecule molecule_name
+      @molecules[molecule_name] = 1
+      nil
+    end
+
+    def dump_molecule_file
+      molecule = read_molecule_file || {}
+      molecule[:dependencies] = @molecules.keys
+      File.open(registry_file_path, 'w') do |file|
+        file.write(molecule_structure.to_json)
+      end
+    end
+
+    def read_molecule_file
+      JSON.parse(open_molecule_file, symbolize_names: true)
+    end
+
+    def open_molecule_file
+      File.read(registry_file_path)
+    rescue
+      '{}'
+    end
+
+    def registry_file_path
+      Rails.root.join('app', 'molecules', @name, 'Moleculefile')
+    end
+
+    def molecule_structure
+      {
+        dependencies: @molecules.keys.to_json
+      }
+    end
+
+  end
+
+end

data/lib/molecule/renderer.rb

@@ -0,0 +1,82 @@
+require 'molecule/molecule'
+require 'molecule/stack'
+
+module Molecule
+
+  class Renderer < ::ActionView::PartialRenderer
+
+    # narrow template lookup path to the provided molecule
+    def render context, options, &block
+      @@stack ||= ::Molecule::Stack.new
+      with_member_override(:view_paths, molecule_view_paths(options)) do
+        with_member_override(:prefixes, [molecule_prefix(options)]) do
+          with_dependency_check(options[:molecule]) do
+            with_new_molecule(options[:molecule]) do
+              result = super(context, options, block).body
+            end
+          end
+        end
+      end
+    end
+
+    # override a member of lookup_context
+    def with_member_override member, override, &block
+      old_value = @lookup_context.public_send(member)
+      molecule_force_set_member(@lookup_context, member, override)
+      yield
+    ensure
+      molecule_force_set_member(@lookup_context, member, old_value)
+    end
+
+    def with_dependency_check name, &block
+      if !@@stack.empty? && ::Molecule.config.verify_children?
+        unless @@stack.current_molecule.has_child?(name.to_s)
+          raise "requested molecule (#{name}) is not configured as a child of current molecule (#{@@stack.current_molecule.name})"
+        end
+      end
+      yield
+    end
+
+    def with_new_molecule name
+      @@stack.push(::Molecule::Molecule.read(name))
+      yield
+    ensure
+      @@stack.pop
+    end
+
+    def molecule_force_set_member object, member, value
+      if object.respond_to?("#{member}=")
+        object.public_send("#{member}=", value)
+      else
+        object.instance_variable_set("@#{member}", value)
+      end
+    end
+
+    # turn off partial renaming
+    def find_template(path, locals)
+      prefixes = path.include?(?/) ? [] : @lookup_context.prefixes
+      @lookup_context.find_template(path, prefixes, false, locals, @details)
+    end
+
+    def molecule_view_paths options
+      ::ActionView::PathSet.new([molecule_template_path(options)])
+    end
+
+    # molecules path
+    def molecule_template_path options
+      Rails.root.join('app', 'molecules')
+    end
+
+    # path for current molecule
+    def molecule_prefix options
+      "#{options[:molecule].to_s}/views"
+    end
+
+    # default template entrypoint
+    def partial_path object = nil, view = nil
+      'index'
+    end
+
+  end
+
+end

data/lib/molecule/renderer_extension.rb

@@ -0,0 +1,16 @@
+require 'molecule/renderer'
+
+module Molecule
+
+  module RendererExtension
+
+    def render(context, options)
+      if options.key?(:molecule)
+        ::Molecule::Renderer.new(@lookup_context).render(context, options)
+      else
+        super
+      end
+    end
+  end
+
+end

data/lib/molecule/renderers/base.rb

@@ -0,0 +1,26 @@
+
+module Molecule
+
+  module Renderers
+
+    module Base
+
+      def molecule_inline_asset options
+        raise options.inspect
+      end
+
+      def molecule_render name, options
+        Molecule.registry.verify_child if options[:verify_chilren]
+
+        render file: molecule_path(name).join('views', name)
+      end
+
+      def molecule_path name
+        Rails.root.join('app', 'molecules', name)
+      end
+
+    end
+
+  end
+
+end

data/lib/molecule/stack.rb

@@ -0,0 +1,30 @@
+
+module Molecule
+
+  class Stack
+
+    attr_accessor :molecules
+
+    def initialize
+      @molecules = []
+    end
+
+    def push molecule
+      @molecules.push(molecule)
+    end
+
+    def current_molecule
+      @molecules.last
+    end
+
+    def pop
+      @molecules.pop
+    end
+
+    def empty?
+      @molecules.empty?
+    end
+
+  end
+
+end

data/lib/molecule/templates/defer/_defer_loader.js.erb

@@ -0,0 +1 @@
+<script>function λ(){let a=document.getElementById("deferred-styles"),c=document.createElement("div");c.innerHTML=a.textContent;document.body.appendChild(c);a.parentElement.removeChild(a)}var d=window.requestAnimationFrame||window.mozRequestAnimationFrame||window.webkitRequestAnimationFrame||window.msRequestAnimationFrame;d?d(function(){window.setTimeout(λ,0)}):window.addEventListener("load",λ);</script>

data/lib/molecule/templates/defer/_script.html.erb

@@ -0,0 +1 @@
+<script defer="defer"><%= @content %></script>

data/lib/molecule/templates/defer/_style.html.erb

@@ -0,0 +1 @@
+<noscript id="defered-styles"><link rel="stylesheet" type="text/css" href="@link"/></noscript>

data/lib/molecule/templates/inline/_script.html.erb

@@ -0,0 +1 @@
+<script><%= @content %></script>

data/lib/molecule/templates/inline/_style.html.erb

@@ -0,0 +1 @@
+<style><%= @content %></style>

data/lib/molecule/version.rb

@@ -0,0 +1,3 @@
+module Molecule
+  VERSION = '0.2.4'
+end

data/lib/molecule.rb

@@ -0,0 +1,19 @@
+require "molecule/railtie"
+
+module Molecule
+
+  class << self
+    attr_accessor :registry
+  end
+
+  def self.config
+    @config ||= Configuration.new
+  end
+
+  def self.configure
+    yield config
+  end
+
+end
+
+require 'molecule/configuration'

data/lib/tasks/molecular_renderer_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :molecular_renderer do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification
+name: molecule
+version: !ruby/object:Gem::Version
+  version: 0.2.4
+platform: ruby
+authors:
+- Dirk Gustke
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-01-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6'
+description: provide and use template and assets in a self-contained way
+email:
+- code+molecule@asm68k.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- Rakefile
+- bin/test
+- lib/molecule.rb
+- lib/molecule/asset_group.rb
+- lib/molecule/asset_renderers/inline.rb
+- lib/molecule/configuration.rb
+- lib/molecule/controller.rb
+- lib/molecule/file.rb
+- lib/molecule/helper.rb
+- lib/molecule/molecule.rb
+- lib/molecule/railtie.rb
+- lib/molecule/registry.rb
+- lib/molecule/renderer.rb
+- lib/molecule/renderer_extension.rb
+- lib/molecule/renderers/base.rb
+- lib/molecule/stack.rb
+- lib/molecule/templates/defer/_defer_loader.js.erb
+- lib/molecule/templates/defer/_script.html.erb
+- lib/molecule/templates/defer/_style.html.erb
+- lib/molecule/templates/inline/_script.html.erb
+- lib/molecule/templates/inline/_style.html.erb
+- lib/molecule/version.rb
+- lib/tasks/molecular_renderer_tasks.rake
+homepage: https://github.com/scones/molecule
+licenses:
+- MIT
+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: provide and use template and assets in a self-contained way
+test_files: []